@gullabs/google 0.8.3 → 0.9.0

package/dist/index.d.cts

@@ -562,6 +562,22 @@ interface GeminiFilesClientLike {
         name: string;
     }): Promise<void>;
 }
+/**
+ * Options for {@link GoogleFileStore.delete} / {@link GoogleFileStore.deleteAll}.
+ *
+ * Default is fail-open (P5 side-effect style). Pass `failClosed: true` when
+ * the host gates durable state on known delete success. Shape matches
+ * `@gullabs/xai` `FileDeleteOptions` by convention.
+ */
+interface FileDeleteOptions {
+    signal?: AbortSignal;
+    /**
+     * When true, non-not-found failures throw typed `LlmError`.
+     * When false/omitted, failures invoke `onDeleteError` and resolve.
+     * Not-found is success in both modes (idempotent).
+     */
+    failClosed?: boolean;
+}
 interface GoogleFileStoreOptions {
     auth: AuthMaterial;
     /** Injectable client for tests; skips SDK import when provided. */
@@ -617,15 +633,23 @@ declare class GoogleFileStore {
         signal?: AbortSignal;
     }): Promise<GoogleFileHandle>;
     /**
-     * Delete a single uploaded file.
-     * Errors are forwarded to `onDeleteError` and NOT rethrown.
+     * Delete a single uploaded file. Idempotent: not-found → success.
+     *
+     * Default (`failClosed` omitted/false): errors go to `onDeleteError` and
+     * resolve (P5 fail-open). With `failClosed: true`, non-not-found errors
+     * throw typed `LlmError` and `onDeleteError` is not called.
+     *
+     * Empty/blank `handle.name` always throws `bad_request`.
      */
-    delete(handle: GoogleFileHandle): Promise<void>;
+    delete(handle: GoogleFileHandle, opts?: FileDeleteOptions): Promise<void>;
     /**
      * Delete multiple files.
-     * Each failure is individually forwarded to `onDeleteError`; none are thrown.
+     *
+     * Fail-open (default): `Promise.allSettled` per handle.
+     * Fail-closed: `Promise.all` — first throw rejects; in-flight siblings are
+     * not cancelled. Prefer per-handle delete when gating durable release state.
      */
-    deleteAll(handles: GoogleFileHandle[]): Promise<void>;
+    deleteAll(handles: GoogleFileHandle[], opts?: FileDeleteOptions): Promise<void>;
 }
 
 /**
@@ -937,4 +961,4 @@ interface GeminiContentToMessagesResult {
  */
 declare function geminiContentToMessages(input: GeminiContentToMessagesInput): GeminiContentToMessagesResult;
 
-export { type CacheKey, type Citation, FLEX_DEFAULT_TIMEOUT_MS, GEMINI_PRICING, type GeminiAdapterOptions, type GeminiCachesClientLike, type GeminiClientLike, type GeminiContentToMessagesInput, type GeminiContentToMessagesResult, type GeminiCountTokensParams, type GeminiCountTokensResponseShape, type GeminiFilesClientLike, type GoogleCacheHandle, GoogleCacheStore, type GoogleCacheStoreOptions, type GoogleFileHandle, GoogleFileStore, type GoogleFileStoreOptions, type GoogleProviderOptions, type GoogleSafetySetting, type GoogleSearchTool, STANDARD_DEFAULT_TIMEOUT_MS, TIER_FACTOR, TRANSPORT_TIMEOUT_BUFFER_MS, buildGoogleClient, defaultGeminiRegistry, geminiAdapter, geminiContentToMessages, geminiModelDescriptors, geminiPricingSource, gemmaModelDescriptors, googleProvider, isGeminiCapacityError, normalizeGroundingCitations, pricingVersion, requireApiKey };
+export { type CacheKey, type Citation, FLEX_DEFAULT_TIMEOUT_MS, type FileDeleteOptions, GEMINI_PRICING, type GeminiAdapterOptions, type GeminiCachesClientLike, type GeminiClientLike, type GeminiContentToMessagesInput, type GeminiContentToMessagesResult, type GeminiCountTokensParams, type GeminiCountTokensResponseShape, type GeminiFilesClientLike, type GoogleCacheHandle, GoogleCacheStore, type GoogleCacheStoreOptions, type GoogleFileHandle, GoogleFileStore, type GoogleFileStoreOptions, type GoogleProviderOptions, type GoogleSafetySetting, type GoogleSearchTool, STANDARD_DEFAULT_TIMEOUT_MS, TIER_FACTOR, TRANSPORT_TIMEOUT_BUFFER_MS, buildGoogleClient, defaultGeminiRegistry, geminiAdapter, geminiContentToMessages, geminiModelDescriptors, geminiPricingSource, gemmaModelDescriptors, googleProvider, isGeminiCapacityError, normalizeGroundingCitations, pricingVersion, requireApiKey };

package/dist/index.d.ts

@@ -562,6 +562,22 @@ interface GeminiFilesClientLike {
         name: string;
     }): Promise<void>;
 }
+/**
+ * Options for {@link GoogleFileStore.delete} / {@link GoogleFileStore.deleteAll}.
+ *
+ * Default is fail-open (P5 side-effect style). Pass `failClosed: true` when
+ * the host gates durable state on known delete success. Shape matches
+ * `@gullabs/xai` `FileDeleteOptions` by convention.
+ */
+interface FileDeleteOptions {
+    signal?: AbortSignal;
+    /**
+     * When true, non-not-found failures throw typed `LlmError`.
+     * When false/omitted, failures invoke `onDeleteError` and resolve.
+     * Not-found is success in both modes (idempotent).
+     */
+    failClosed?: boolean;
+}
 interface GoogleFileStoreOptions {
     auth: AuthMaterial;
     /** Injectable client for tests; skips SDK import when provided. */
@@ -617,15 +633,23 @@ declare class GoogleFileStore {
         signal?: AbortSignal;
     }): Promise<GoogleFileHandle>;
     /**
-     * Delete a single uploaded file.
-     * Errors are forwarded to `onDeleteError` and NOT rethrown.
+     * Delete a single uploaded file. Idempotent: not-found → success.
+     *
+     * Default (`failClosed` omitted/false): errors go to `onDeleteError` and
+     * resolve (P5 fail-open). With `failClosed: true`, non-not-found errors
+     * throw typed `LlmError` and `onDeleteError` is not called.
+     *
+     * Empty/blank `handle.name` always throws `bad_request`.
      */
-    delete(handle: GoogleFileHandle): Promise<void>;
+    delete(handle: GoogleFileHandle, opts?: FileDeleteOptions): Promise<void>;
     /**
      * Delete multiple files.
-     * Each failure is individually forwarded to `onDeleteError`; none are thrown.
+     *
+     * Fail-open (default): `Promise.allSettled` per handle.
+     * Fail-closed: `Promise.all` — first throw rejects; in-flight siblings are
+     * not cancelled. Prefer per-handle delete when gating durable release state.
      */
-    deleteAll(handles: GoogleFileHandle[]): Promise<void>;
+    deleteAll(handles: GoogleFileHandle[], opts?: FileDeleteOptions): Promise<void>;
 }
 
 /**
@@ -937,4 +961,4 @@ interface GeminiContentToMessagesResult {
  */
 declare function geminiContentToMessages(input: GeminiContentToMessagesInput): GeminiContentToMessagesResult;
 
-export { type CacheKey, type Citation, FLEX_DEFAULT_TIMEOUT_MS, GEMINI_PRICING, type GeminiAdapterOptions, type GeminiCachesClientLike, type GeminiClientLike, type GeminiContentToMessagesInput, type GeminiContentToMessagesResult, type GeminiCountTokensParams, type GeminiCountTokensResponseShape, type GeminiFilesClientLike, type GoogleCacheHandle, GoogleCacheStore, type GoogleCacheStoreOptions, type GoogleFileHandle, GoogleFileStore, type GoogleFileStoreOptions, type GoogleProviderOptions, type GoogleSafetySetting, type GoogleSearchTool, STANDARD_DEFAULT_TIMEOUT_MS, TIER_FACTOR, TRANSPORT_TIMEOUT_BUFFER_MS, buildGoogleClient, defaultGeminiRegistry, geminiAdapter, geminiContentToMessages, geminiModelDescriptors, geminiPricingSource, gemmaModelDescriptors, googleProvider, isGeminiCapacityError, normalizeGroundingCitations, pricingVersion, requireApiKey };
+export { type CacheKey, type Citation, FLEX_DEFAULT_TIMEOUT_MS, type FileDeleteOptions, GEMINI_PRICING, type GeminiAdapterOptions, type GeminiCachesClientLike, type GeminiClientLike, type GeminiContentToMessagesInput, type GeminiContentToMessagesResult, type GeminiCountTokensParams, type GeminiCountTokensResponseShape, type GeminiFilesClientLike, type GoogleCacheHandle, GoogleCacheStore, type GoogleCacheStoreOptions, type GoogleFileHandle, GoogleFileStore, type GoogleFileStoreOptions, type GoogleProviderOptions, type GoogleSafetySetting, type GoogleSearchTool, STANDARD_DEFAULT_TIMEOUT_MS, TIER_FACTOR, TRANSPORT_TIMEOUT_BUFFER_MS, buildGoogleClient, defaultGeminiRegistry, geminiAdapter, geminiContentToMessages, geminiModelDescriptors, geminiPricingSource, gemmaModelDescriptors, googleProvider, isGeminiCapacityError, normalizeGroundingCitations, pricingVersion, requireApiKey };

package/dist/index.js

@@ -409,6 +409,11 @@ function mapPart(p) {
         ...p.mediaResolution !== void 0 ? { mediaResolution: { level: mapMediaResolution(p.mediaResolution) } } : {}
       };
     }
+    case "file-ref":
+      throw new LlmError(
+        "Google Gemini expects FileUriPart with a Files API uri; got file-ref (provider file id). Upload via GoogleFileStore and pass the returned uri.",
+        { kind: "bad_request", retryable: false, provider: "google" }
+      );
     default:
       return assertNever(p);
   }
@@ -2866,25 +2871,88 @@ var GoogleFileStore = class {
     }
   }
   /**
-   * Delete a single uploaded file.
-   * Errors are forwarded to `onDeleteError` and NOT rethrown.
+   * Delete a single uploaded file. Idempotent: not-found → success.
+   *
+   * Default (`failClosed` omitted/false): errors go to `onDeleteError` and
+   * resolve (P5 fail-open). With `failClosed: true`, non-not-found errors
+   * throw typed `LlmError` and `onDeleteError` is not called.
+   *
+   * Empty/blank `handle.name` always throws `bad_request`.
    */
-  async delete(handle) {
+  async delete(handle, opts) {
+    const name = handle.name;
+    if (typeof name !== "string" || name.trim() === "") {
+      throw new LlmError("GoogleFileHandle.name must be a non-empty string.", {
+        kind: "bad_request",
+        retryable: false,
+        provider: "google"
+      });
+    }
+    const failClosed = opts?.failClosed === true;
     try {
+      if (opts?.signal?.aborted === true) {
+        throw new LlmError("Google file delete aborted", {
+          kind: "aborted",
+          retryable: false,
+          provider: "google"
+        });
+      }
       const client = await this.getClient();
-      await client.delete({ name: handle.name });
+      await client.delete({ name });
     } catch (err) {
-      this.onDeleteError(handle.name, err);
+      if (isGoogleNotFoundError(err)) {
+        return;
+      }
+      const classified = err instanceof LlmError ? err : classifyError(err);
+      const withProvider = classified.provider === void 0 ? new LlmError(classified.message, {
+        kind: classified.kind,
+        retryable: classified.retryable,
+        ...classified.httpStatus !== void 0 ? { httpStatus: classified.httpStatus } : {},
+        ...classified.retryAfterMs !== void 0 ? { retryAfterMs: classified.retryAfterMs } : {},
+        provider: "google",
+        cause: classified.cause ?? err
+      }) : classified;
+      if (failClosed) {
+        throw withProvider;
+      }
+      this.onDeleteError(name, withProvider);
     }
   }
   /**
    * Delete multiple files.
-   * Each failure is individually forwarded to `onDeleteError`; none are thrown.
+   *
+   * Fail-open (default): `Promise.allSettled` per handle.
+   * Fail-closed: `Promise.all` — first throw rejects; in-flight siblings are
+   * not cancelled. Prefer per-handle delete when gating durable release state.
    */
-  async deleteAll(handles) {
-    await Promise.allSettled(handles.map((h) => this.delete(h)));
+  async deleteAll(handles, opts) {
+    if (opts?.failClosed === true) {
+      await Promise.all(handles.map((h) => this.delete(h, opts)));
+      return;
+    }
+    await Promise.allSettled(handles.map((h) => this.delete(h, opts)));
   }
 };
+function isGoogleNotFoundError(err) {
+  if (err instanceof LlmError && err.httpStatus === 404) {
+    return true;
+  }
+  if (typeof err !== "object" || err === null) {
+    return false;
+  }
+  const obj = err;
+  if (obj["status"] === 404 || obj["httpStatus"] === 404 || obj["code"] === 404) {
+    return true;
+  }
+  if (obj["status"] === "NOT_FOUND" || obj["code"] === "NOT_FOUND") {
+    return true;
+  }
+  const msg = typeof obj["message"] === "string" ? obj["message"] : "";
+  if (/not\s*found|404/i.test(msg) && /file/i.test(msg)) {
+    return true;
+  }
+  return false;
+}
 var DEFAULT_SKEW_SECONDS = 30;
 var DEFAULT_EXTENSION_SECONDS = 3600;
 async function buildCachesClient(auth) {