@gullabs/xai 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -338,6 +338,21 @@ interface XaiFileListResult {
     files: XaiFileHandle[];
     paginationToken?: string;
 }
+/**
+ * Options for {@link XaiFileStore.delete} / {@link XaiFileStore.deleteAll}.
+ *
+ * Default is fail-open (P5 side-effect style). Pass `failClosed: true` when
+ * the host gates durable state (e.g. `released_at`) on known delete success.
+ */
+interface FileDeleteOptions {
+    signal?: AbortSignal;
+    /**
+     * When true, non-404 failures throw typed `LlmError`.
+     * When false/omitted, non-404 failures invoke `onDeleteError` and resolve.
+     * HTTP 404 is success in both modes (idempotent).
+     */
+    failClosed?: boolean;
+}
 interface XaiFileStoreOptions {
     auth: AuthMaterial;
     /** Default {@link XAI_FILES_DEFAULT_BASE_URL}. */
@@ -381,13 +396,23 @@ declare class XaiFileStore {
     list(opts?: XaiFileListOptions, signal?: AbortSignal): Promise<XaiFileListResult>;
     /**
      * Delete a file. Idempotent: HTTP 404 → success.
-     * Other errors are forwarded to `onDeleteError` and **not** rethrown (P5).
+     *
+     * Default (`failClosed` omitted/false): non-404 errors go to `onDeleteError`
+     * and resolve (P5 fail-open). With `failClosed: true`, non-404 errors throw
+     * typed `LlmError` and `onDeleteError` is not called.
+     *
+     * Empty/blank ids always throw `bad_request` (caller fault).
      */
-    delete(fileIdOrHandle: string | Pick<XaiFileHandle, 'id'>, signal?: AbortSignal): Promise<void>;
+    delete(fileIdOrHandle: string | Pick<XaiFileHandle, 'id'>, opts?: FileDeleteOptions): Promise<void>;
     /**
-     * Delete many files. Each failure is individually fail-open; none are thrown.
+     * Delete many files.
+     *
+     * Fail-open (default): `Promise.allSettled` — each failure → `onDeleteError`.
+     * Fail-closed: `Promise.all` — first throw rejects; in-flight siblings are
+     * not cancelled (partial deletes may already have succeeded at the provider).
+     * Prefer per-id delete + host DB mark when gating durable release state.
      */
-    deleteAll(ids: ReadonlyArray<string | Pick<XaiFileHandle, 'id'>>, signal?: AbortSignal): Promise<void>;
+    deleteAll(ids: ReadonlyArray<string | Pick<XaiFileHandle, 'id'>>, opts?: FileDeleteOptions): Promise<void>;
     /** Download raw file bytes. */
     getContent(fileId: string, signal?: AbortSignal): Promise<Uint8Array>;
 }
@@ -566,4 +591,4 @@ declare function xaiPricingSource(): PricingSource;
  */
 declare function xaiProvider(opts?: XaiAdapterOptions): ProviderPlugin;
 
-export { Grok45ConfigSchema, XAI_FILES_DEFAULT_BASE_URL, XAI_FILE_MAX_BYTES, XAI_FILE_TTL_MAX_SECONDS, XAI_FILE_TTL_MIN_SECONDS, XAI_PRICING, type XaiAdapterOptions, type XaiClientLike, type XaiFileHandle, type XaiFileListOptions, type XaiFileListResult, XaiFileStore, type XaiFileStoreOptions, type XaiFileUploadInput, type XaiInputContentPart, type XaiInputFilePart, type XaiInputImagePart, type XaiInputItem, type XaiInputTextPart, type XaiMessageOutputItem, type XaiModelRates, type XaiOutputItem, type XaiOutputTextPart, type XaiProviderOptions, type XaiReasoningOutputItem, type XaiReasoningSummaryPart, type XaiResponseCreateParams, type XaiResponseShape, type XaiTextFormat, type XaiUsageShape, buildXaiClient, classifyXaiError, computeXaiCost, grok45ModelDescriptor, requireApiKey, xaiAdapter, xaiModelDescriptors, xaiPricingSource, xaiPricingVersion, xaiProvider, xaiRegistry };
+export { type FileDeleteOptions, Grok45ConfigSchema, XAI_FILES_DEFAULT_BASE_URL, XAI_FILE_MAX_BYTES, XAI_FILE_TTL_MAX_SECONDS, XAI_FILE_TTL_MIN_SECONDS, XAI_PRICING, type XaiAdapterOptions, type XaiClientLike, type XaiFileHandle, type XaiFileListOptions, type XaiFileListResult, XaiFileStore, type XaiFileStoreOptions, type XaiFileUploadInput, type XaiInputContentPart, type XaiInputFilePart, type XaiInputImagePart, type XaiInputItem, type XaiInputTextPart, type XaiMessageOutputItem, type XaiModelRates, type XaiOutputItem, type XaiOutputTextPart, type XaiProviderOptions, type XaiReasoningOutputItem, type XaiReasoningSummaryPart, type XaiResponseCreateParams, type XaiResponseShape, type XaiTextFormat, type XaiUsageShape, buildXaiClient, classifyXaiError, computeXaiCost, grok45ModelDescriptor, requireApiKey, xaiAdapter, xaiModelDescriptors, xaiPricingSource, xaiPricingVersion, xaiProvider, xaiRegistry };

package/dist/index.js

@@ -737,35 +737,25 @@ var XaiFileStore = class {
   }
   /**
    * Delete a file. Idempotent: HTTP 404 → success.
-   * Other errors are forwarded to `onDeleteError` and **not** rethrown (P5).
+   *
+   * Default (`failClosed` omitted/false): non-404 errors go to `onDeleteError`
+   * and resolve (P5 fail-open). With `failClosed: true`, non-404 errors throw
+   * typed `LlmError` and `onDeleteError` is not called.
+   *
+   * Empty/blank ids always throw `bad_request` (caller fault).
    */
-  async delete(fileIdOrHandle, signal) {
+  async delete(fileIdOrHandle, opts) {
     const fileId = resolveFileId(fileIdOrHandle);
     if (typeof fileId !== "string" || fileId.trim() === "") {
-      this.onDeleteError(String(fileId), badRequest("fileId must be a non-empty string."));
-      return;
+      throw badRequest("fileId must be a non-empty string.");
     }
+    const failClosed = opts?.failClosed === true;
+    const signal = opts?.signal;
     try {
-      let res;
-      try {
-        res = await this.fetchImpl(
-          this.filesUrl(fileId),
-          this.requestInit("DELETE", signal !== void 0 ? { signal } : {})
-        );
-      } catch (e) {
-        if (signal?.aborted === true) {
-          this.onDeleteError(
-            fileId,
-            new LlmError("xAI file delete aborted", {
-              kind: "aborted",
-              retryable: false,
-              provider: "xai"
-            })
-          );
-          return;
-        }
-        throw e;
-      }
+      const res = await this.fetchImpl(
+        this.filesUrl(fileId),
+        this.requestInit("DELETE", signal !== void 0 ? { signal } : {})
+      );
       if (res.status === 404) {
         return;
       }
@@ -776,14 +766,32 @@ var XaiFileStore = class {
       if (isNotFoundError(err)) {
         return;
       }
-      this.onDeleteError(fileId, classifyStoreError(err));
+      const classified = signal?.aborted === true && !(err instanceof LlmError) ? new LlmError("xAI file delete aborted", {
+        kind: "aborted",
+        retryable: false,
+        provider: "xai",
+        cause: err
+      }) : classifyStoreError(err);
+      if (failClosed) {
+        throw classified;
+      }
+      this.onDeleteError(fileId, classified);
     }
   }
   /**
-   * Delete many files. Each failure is individually fail-open; none are thrown.
+   * Delete many files.
+   *
+   * Fail-open (default): `Promise.allSettled` — each failure → `onDeleteError`.
+   * Fail-closed: `Promise.all` — first throw rejects; in-flight siblings are
+   * not cancelled (partial deletes may already have succeeded at the provider).
+   * Prefer per-id delete + host DB mark when gating durable release state.
    */
-  async deleteAll(ids, signal) {
-    await Promise.allSettled(ids.map((id) => this.delete(id, signal)));
+  async deleteAll(ids, opts) {
+    if (opts?.failClosed === true) {
+      await Promise.all(ids.map((id) => this.delete(id, opts)));
+      return;
+    }
+    await Promise.allSettled(ids.map((id) => this.delete(id, opts)));
   }
   /** Download raw file bytes. */
   async getContent(fileId, signal) {