feat: Added createCachedContents standalone function

PiperOrigin-RevId: 747527721

Author: IvanLH

api-report/genai-node.api.md

@@ -235,6 +235,9 @@ export class CountTokensResponse {
     totalTokens?: number;
 }
 
+// @public
+export function createCachedContent(apiClient: ApiClient, params: types.CreateCachedContentParameters): Promise<types.CachedContent>;
+
 // @public
 export interface CreateCachedContentConfig {
     contents?: ContentListUnion;

api-report/genai-web.api.md

@@ -235,6 +235,9 @@ export class CountTokensResponse {
     totalTokens?: number;
 }
 
+// @public
+export function createCachedContent(apiClient: ApiClient, params: types.CreateCachedContentParameters): Promise<types.CachedContent>;
+
 // @public
 export interface CreateCachedContentConfig {
     contents?: ContentListUnion;

api-report/genai.api.md

@@ -235,6 +235,9 @@ export class CountTokensResponse {
     totalTokens?: number;
 }
 
+// @public
+export function createCachedContent(apiClient: ApiClient, params: types.CreateCachedContentParameters): Promise<types.CachedContent>;
+
 // @public
 export interface CreateCachedContentConfig {
     contents?: ContentListUnion;

src/caches.ts

@@ -13,6 +13,107 @@ import * as converters from './converters/_caches_converters';
 import {PagedItem, Pager} from './pagers';
 import * as types from './types';
 
+/**
+ * Creates a cached contents resource.
+ *
+ * @remarks
+ * Context caching is only supported for specific models. See [Gemini
+ * Developer API reference](https://ai.google.dev/gemini-api/docs/caching?lang=node/context-cac)
+ * and [Vertex AI reference](https://cloud.google.com/vertex-ai/generative-ai/docs/context-cache/context-cache-overview#supported_models)
+ * for more information.
+ *
+ * @param apiClient - The API client to use.
+ * @param params - The parameters for the create request.
+ * @return The created cached content.
+ *
+ * @example
+ * ```ts
+ * import {createCachedContent} from '@google/genai'
+ *
+ * const contents = ...; // Initialize the content to cache.
+ * const response = await createCachedContent(apiClient, {
+ *   model: 'gemini-1.5-flash',
+ *   config: {
+ *    'contents': contents,
+ *    'displayName': 'test cache',
+ *    'systemInstruction': 'What is the sum of the two pdfs?',
+ *    'ttl': '86400s',
+ *  }
+ * });
+ * ```
+ */
+export async function createCachedContent(
+  apiClient: ApiClient,
+  params: types.CreateCachedContentParameters,
+): Promise<types.CachedContent> {
+  let response: Promise<types.CachedContent>;
+  let path: string = '';
+  let queryParams: Record<string, string> = {};
+  if (apiClient.isVertexAI()) {
+    const body = converters.createCachedContentParametersToVertex(
+      apiClient,
+      params,
+    );
+    path = common.formatMap(
+      'cachedContents',
+      body['_url'] as Record<string, unknown>,
+    );
+    queryParams = body['_query'] as Record<string, string>;
+    delete body['config'];
+    delete body['_url'];
+    delete body['_query'];
+
+    response = apiClient
+      .request({
+        path: path,
+        queryParams: queryParams,
+        body: JSON.stringify(body),
+        httpMethod: 'POST',
+        httpOptions: params.config?.httpOptions,
+      })
+      .then((httpResponse) => {
+        return httpResponse.json();
+      }) as Promise<types.CachedContent>;
+
+    return response.then((apiResponse) => {
+      const resp = converters.cachedContentFromVertex(apiClient, apiResponse);
+
+      return resp as types.CachedContent;
+    });
+  } else {
+    const body = converters.createCachedContentParametersToMldev(
+      apiClient,
+      params,
+    );
+    path = common.formatMap(
+      'cachedContents',
+      body['_url'] as Record<string, unknown>,
+    );
+    queryParams = body['_query'] as Record<string, string>;
+    delete body['config'];
+    delete body['_url'];
+    delete body['_query'];
+
+    response = apiClient
+      .request({
+        path: path,
+        queryParams: queryParams,
+        body: JSON.stringify(body),
+        httpMethod: 'POST',
+        httpOptions: params.config?.httpOptions,
+      })
+      .then((httpResponse) => {
+        return httpResponse.json();
+      }) as Promise<types.CachedContent>;
+
+    return response.then((apiResponse) => {
+      const resp = converters.cachedContentFromMldev(apiClient, apiResponse);
+
+      return resp as types.CachedContent;
+    });
+  }
+}
+
 export class Caches extends BaseModule {
   constructor(private readonly apiClient: ApiClient) {
     super();
@@ -72,78 +173,7 @@ export class Caches extends BaseModule {
   async create(
     params: types.CreateCachedContentParameters,
   ): Promise<types.CachedContent> {
-    let response: Promise<types.CachedContent>;
-    let path: string = '';
-    let queryParams: Record<string, string> = {};
-    if (this.apiClient.isVertexAI()) {
-      const body = converters.createCachedContentParametersToVertex(
-        this.apiClient,
-        params,
-      );
-      path = common.formatMap(
-        'cachedContents',
-        body['_url'] as Record<string, unknown>,
-      );
-      queryParams = body['_query'] as Record<string, string>;
-      delete body['config'];
-      delete body['_url'];
-      delete body['_query'];
-
-      response = this.apiClient
-        .request({
-          path: path,
-          queryParams: queryParams,
-          body: JSON.stringify(body),
-          httpMethod: 'POST',
-          httpOptions: params.config?.httpOptions,
-        })
-        .then((httpResponse) => {
-          return httpResponse.json();
-        }) as Promise<types.CachedContent>;
-
-      return response.then((apiResponse) => {
-        const resp = converters.cachedContentFromVertex(
-          this.apiClient,
-          apiResponse,
-        );
-
-        return resp as types.CachedContent;
-      });
-    } else {
-      const body = converters.createCachedContentParametersToMldev(
-        this.apiClient,
-        params,
-      );
-      path = common.formatMap(
-        'cachedContents',
-        body['_url'] as Record<string, unknown>,
-      );
-      queryParams = body['_query'] as Record<string, string>;
-      delete body['config'];
-      delete body['_url'];
-      delete body['_query'];
-
-      response = this.apiClient
-        .request({
-          path: path,
-          queryParams: queryParams,
-          body: JSON.stringify(body),
-          httpMethod: 'POST',
-          httpOptions: params.config?.httpOptions,
-        })
-        .then((httpResponse) => {
-          return httpResponse.json();
-        }) as Promise<types.CachedContent>;
-
-      return response.then((apiResponse) => {
-        const resp = converters.cachedContentFromMldev(
-          this.apiClient,
-          apiResponse,
-        );
-
-        return resp as types.CachedContent;
-      });
-    }
+    return createCachedContent(this.apiClient, params);
   }
 
   /**