@masters-union/union-stack 0.3.16 → 0.3.17

package/dist/{chunk-GTE65IAM.cjs → chunk-TQDC5KIC.cjs}

@@ -8,6 +8,7 @@ function makeError(code, message, opts = {}) {
     message,
     status: opts.status,
     retryable: opts.retryable ?? defaultRetryable(code, opts.status),
+    docs: opts.docs,
     cause: opts.cause
   };
 }
@@ -20,39 +21,40 @@ function fromApiResponse(status, body) {
   const err = body?.error;
   const msg = err?.message || `Request failed with status ${status}`;
   const code = (err?.code || "").toUpperCase();
+  const docs = typeof err?.docs === "string" ? err.docs : void 0;
   if (status === 401) {
-    return makeError("AUTH", msg, { status, retryable: false });
+    return makeError("AUTH", msg, { status, retryable: false, docs });
   }
   if (status === 403) {
-    return makeError("AUTH", msg, { status, retryable: false });
+    return makeError("AUTH", msg, { status, retryable: false, docs });
   }
   if (status === 413) {
-    return makeError("VALIDATION", msg, { status, retryable: false });
+    return makeError("VALIDATION", msg, { status, retryable: false, docs });
   }
   if (status === 415) {
-    return makeError("VALIDATION", msg, { status, retryable: false });
+    return makeError("VALIDATION", msg, { status, retryable: false, docs });
   }
   if (status === 422) {
     if (code === "EMPTY_UPLOAD") {
-      return makeError("EMPTY_FILE", EMPTY_FILE_MESSAGE, { status, retryable: false });
+      return makeError("EMPTY_FILE", EMPTY_FILE_MESSAGE, { status, retryable: false, docs });
     }
-    return makeError("VALIDATION", msg, { status, retryable: false });
+    return makeError("VALIDATION", msg, { status, retryable: false, docs });
   }
   if (status === 426) {
-    return makeError("CONFIG", msg, { status, retryable: false });
+    return makeError("CONFIG", msg, { status, retryable: false, docs });
   }
   if (status === 429) {
     const isQuota = code === "QUOTA_EXCEEDED";
-    return makeError(isQuota ? "QUOTA" : "NETWORK", msg, { status, retryable: !isQuota });
+    return makeError(isQuota ? "QUOTA" : "NETWORK", msg, { status, retryable: !isQuota, docs });
   }
   if (status >= 500) {
-    return makeError("SERVER", msg, { status, retryable: true });
+    return makeError("SERVER", msg, { status, retryable: true, docs });
   }
-  return makeError("SERVER", msg, { status, retryable: false });
+  return makeError("SERVER", msg, { status, retryable: false, docs });
 }
 
 exports.EMPTY_FILE_MESSAGE = EMPTY_FILE_MESSAGE;
 exports.fromApiResponse = fromApiResponse;
 exports.makeError = makeError;
-//# sourceMappingURL=chunk-GTE65IAM.cjs.map
-//# sourceMappingURL=chunk-GTE65IAM.cjs.map
+//# sourceMappingURL=chunk-TQDC5KIC.cjs.map
+//# sourceMappingURL=chunk-TQDC5KIC.cjs.map

package/dist/chunk-TQDC5KIC.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":"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","file":"chunk-TQDC5KIC.cjs","sourcesContent":["import type { UploadError, UploadErrorCode } from './types.js';\n\n// Single source of truth for the 0-byte message. Used by the client-side guard\n// (uploader), the picker UI, and the server-side reject (mapped from a 422\n// EMPTY_UPLOAD), so the end user sees the same actionable text no matter where\n// the empty file was caught.\nexport const EMPTY_FILE_MESSAGE =\n  \"This file is empty (0 bytes) and can't be uploaded. If it's stored in iCloud, \" +\n  'OneDrive, or Google Drive, open it once to download it to this device, then try again.';\n\nexport function makeError(\n  code: UploadErrorCode,\n  message: string,\n  opts: { status?: number; retryable?: boolean; docs?: string; cause?: unknown } = {}\n): UploadError {\n  return {\n    code,\n    message,\n    status: opts.status,\n    retryable: opts.retryable ?? defaultRetryable(code, opts.status),\n    docs: opts.docs,\n    cause: opts.cause,\n  };\n}\n\nfunction defaultRetryable(code: UploadErrorCode, status?: number): boolean {\n  if (code === 'NETWORK' || code === 'PART_FAILED') return true;\n  if (code === 'SERVER' && status && status >= 500) return true;\n  return false;\n}\n\n/** Map an HTTP error response from the cdn-be API to an UploadError. */\nexport function fromApiResponse(status: number, body: unknown): UploadError {\n  const err = (body as { error?: { code?: string; message?: string; docs?: string } } | null)?.error;\n  const msg = err?.message || `Request failed with status ${status}`;\n  const code = (err?.code || '').toUpperCase();\n  // Docs deep-link the API attaches to some errors (e.g. ORIGIN_NOT_ALLOWED).\n  // Passed through on every mapping so callers can surface a \"learn more\" link.\n  const docs = typeof err?.docs === 'string' ? err.docs : undefined;\n\n  if (status === 401) {\n    return makeError('AUTH', msg, { status, retryable: false, docs });\n  }\n  if (status === 403) {\n    return makeError('AUTH', msg, { status, retryable: false, docs });\n  }\n  if (status === 413) {\n    return makeError('VALIDATION', msg, { status, retryable: false, docs });\n  }\n  if (status === 415) {\n    return makeError('VALIDATION', msg, { status, retryable: false, docs });\n  }\n  if (status === 422) {\n    // Server rejected the assembled object. EMPTY_UPLOAD (0 bytes landed) gets\n    // the dedicated code + canonical message so it reads the same as a\n    // client-side empty catch; other 422s fall back to VALIDATION. Either way,\n    // retrying the same source file won't help, so it's not retryable.\n    if (code === 'EMPTY_UPLOAD') {\n      return makeError('EMPTY_FILE', EMPTY_FILE_MESSAGE, { status, retryable: false, docs });\n    }\n    return makeError('VALIDATION', msg, { status, retryable: false, docs });\n  }\n  if (status === 426) {\n    // Server-enforced minimum SDK version. Not retryable — the integrator\n    // must upgrade the package (or reload, for script-loader users).\n    return makeError('CONFIG', msg, { status, retryable: false, docs });\n  }\n  if (status === 429) {\n    const isQuota = code === 'QUOTA_EXCEEDED';\n    return makeError(isQuota ? 'QUOTA' : 'NETWORK', msg, { status, retryable: !isQuota, docs });\n  }\n  if (status >= 500) {\n    return makeError('SERVER', msg, { status, retryable: true, docs });\n  }\n  return makeError('SERVER', msg, { status, retryable: false, docs });\n}\n"]}

package/dist/{client-BCLIIiX2.d.ts → client-BofkorBV.d.ts}

@@ -1,4 +1,4 @@
-import { B as BatchUploadOptions, a as PickedFile, P as PickResponse, f as PickerConfig, C as ClientConfig, d as UploadOptions, e as UploadedFile, R as ResolvedClientConfig } from './types-BWs1slkL.js';
+import { B as BatchUploadOptions, a as PickedFile, P as PickResponse, f as PickerConfig, C as ClientConfig, d as UploadOptions, e as UploadedFile, R as ResolvedClientConfig } from './types-BsGu9Oi3.js';
 
 interface PickerTheme {
     /** Primary accent color (buttons, progress bar, focus rings). */

package/dist/{client-CSZ-4GVl.d.cts → client-C_pEvbZS.d.cts}

@@ -1,4 +1,4 @@
-import { B as BatchUploadOptions, a as PickedFile, P as PickResponse, f as PickerConfig, C as ClientConfig, d as UploadOptions, e as UploadedFile, R as ResolvedClientConfig } from './types-BWs1slkL.cjs';
+import { B as BatchUploadOptions, a as PickedFile, P as PickResponse, f as PickerConfig, C as ClientConfig, d as UploadOptions, e as UploadedFile, R as ResolvedClientConfig } from './types-BsGu9Oi3.cjs';
 
 interface PickerTheme {
     /** Primary accent color (buttons, progress bar, focus rings). */

package/dist/index.cjs

@@ -1,19 +1,19 @@
 'use strict';
 
-var chunk3FCZBKNN_cjs = require('./chunk-3FCZBKNN.cjs');
-require('./chunk-EBE7EIOZ.cjs');
-require('./chunk-GTE65IAM.cjs');
+var chunk4645KBSE_cjs = require('./chunk-4645KBSE.cjs');
+require('./chunk-PVM2ZX45.cjs');
+require('./chunk-TQDC5KIC.cjs');
 
 // src/index.ts
 var UnionStack = {
   init(cfg) {
-    return new chunk3FCZBKNN_cjs.UnionStackClient(cfg);
+    return new chunk4645KBSE_cjs.UnionStackClient(cfg);
   }
 };
 
 Object.defineProperty(exports, "UnionStackClient", {
   enumerable: true,
-  get: function () { return chunk3FCZBKNN_cjs.UnionStackClient; }
+  get: function () { return chunk4645KBSE_cjs.UnionStackClient; }
 });
 exports.UnionStack = UnionStack;
 //# sourceMappingURL=index.cjs.map

package/dist/index.d.cts

@@ -1,6 +1,6 @@
-import { U as UnionStackClient } from './client-CSZ-4GVl.cjs';
-import { C as ClientConfig } from './types-BWs1slkL.cjs';
-export { B as BatchUploadOptions, P as PickResponse, a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode, d as UploadOptions, e as UploadedFile } from './types-BWs1slkL.cjs';
+import { U as UnionStackClient } from './client-C_pEvbZS.cjs';
+import { C as ClientConfig } from './types-BsGu9Oi3.cjs';
+export { B as BatchUploadOptions, P as PickResponse, a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode, d as UploadOptions, e as UploadedFile } from './types-BsGu9Oi3.cjs';
 
 declare const UnionStack: {
     init(cfg: ClientConfig): UnionStackClient;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { U as UnionStackClient } from './client-BCLIIiX2.js';
-import { C as ClientConfig } from './types-BWs1slkL.js';
-export { B as BatchUploadOptions, P as PickResponse, a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode, d as UploadOptions, e as UploadedFile } from './types-BWs1slkL.js';
+import { U as UnionStackClient } from './client-BofkorBV.js';
+import { C as ClientConfig } from './types-BsGu9Oi3.js';
+export { B as BatchUploadOptions, P as PickResponse, a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode, d as UploadOptions, e as UploadedFile } from './types-BsGu9Oi3.js';
 
 declare const UnionStack: {
     init(cfg: ClientConfig): UnionStackClient;

package/dist/index.js

@@ -1,7 +1,7 @@
-import { UnionStackClient } from './chunk-OZGVTEMZ.js';
-export { UnionStackClient } from './chunk-OZGVTEMZ.js';
-import './chunk-7NJTA5ZD.js';
-import './chunk-XBQENFBZ.js';
+import { UnionStackClient } from './chunk-QQFNG3ZF.js';
+export { UnionStackClient } from './chunk-QQFNG3ZF.js';
+import './chunk-RYS4MXXL.js';
+import './chunk-G2H5WZDV.js';
 
 // src/index.ts
 var UnionStack = {

package/dist/node.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkEBE7EIOZ_cjs = require('./chunk-EBE7EIOZ.cjs');
-var chunkGTE65IAM_cjs = require('./chunk-GTE65IAM.cjs');
+var chunkPVM2ZX45_cjs = require('./chunk-PVM2ZX45.cjs');
+var chunkTQDC5KIC_cjs = require('./chunk-TQDC5KIC.cjs');
 var path = require('path');
 var promises = require('fs/promises');
 var fs = require('fs');
@@ -98,7 +98,7 @@ async function resolveSource(source, opts = {}) {
       const blob = openAsBlob2 ? await openAsBlob2(source, { type: mimetype }) : new Blob([toBlobPart(await promises.readFile(source))], { type: mimetype });
       return { blob, filename, mimetype };
     } catch (cause) {
-      throw chunkGTE65IAM_cjs.makeError("VALIDATION", `Could not read file at "${source}".`, {
+      throw chunkTQDC5KIC_cjs.makeError("VALIDATION", `Could not read file at "${source}".`, {
         retryable: false,
         cause
       });
@@ -121,7 +121,7 @@ async function resolveSource(source, opts = {}) {
     const mimetype = opts.mimeType || mimeFromName(filename);
     return { blob: new Blob([toBlobPart(source)], { type: mimetype }), filename, mimetype };
   }
-  throw chunkGTE65IAM_cjs.makeError(
+  throw chunkTQDC5KIC_cjs.makeError(
     "VALIDATION",
     "Unsupported upload source. Pass a file path, Buffer, Uint8Array, ArrayBuffer, Blob, or Readable stream.",
     { retryable: false }
@@ -134,7 +134,7 @@ var DEFAULT_FILE_CONCURRENCY = 5;
 var UnionStackNodeClient = class {
   constructor(cfg) {
     if (!cfg?.apiKey) {
-      throw chunkGTE65IAM_cjs.makeError("CONFIG", 'apiKey is required. Pass { apiKey: "unionstack_live_\u2026" }.', {
+      throw chunkTQDC5KIC_cjs.makeError("CONFIG", 'apiKey is required. Pass { apiKey: "unionstack_live_\u2026" }.', {
         retryable: false
       });
     }
@@ -145,9 +145,9 @@ var UnionStackNodeClient = class {
       skipConfigPrefetch: true,
       // Tag the traffic as server-to-server ("node/…") so cdn-be can tell it
       // apart from browser SDK calls ("js/…").
-      sdkHeader: chunkEBE7EIOZ_cjs.NODE_SDK_VERSION_HEADER
+      sdkHeader: chunkPVM2ZX45_cjs.NODE_SDK_VERSION_HEADER
     };
-    this.uploader = new chunkEBE7EIOZ_cjs.Uploader(this.cfg);
+    this.uploader = new chunkPVM2ZX45_cjs.Uploader(this.cfg);
   }
   /**
    * Upload one file. Accepts a path on disk, a Buffer/Uint8Array/ArrayBuffer, a
@@ -169,7 +169,7 @@ var UnionStackNodeClient = class {
    */
   async uploadMany(sources, opts = {}) {
     if (!Array.isArray(sources) || sources.length === 0) {
-      const err = chunkGTE65IAM_cjs.makeError("VALIDATION", "uploadMany requires a non-empty array of sources.", {
+      const err = chunkTQDC5KIC_cjs.makeError("VALIDATION", "uploadMany requires a non-empty array of sources.", {
         retryable: false
       });
       opts.onError?.(err);

package/dist/node.d.cts

@@ -1,6 +1,6 @@
 import { Readable } from 'node:stream';
-import { C as ClientConfig, d as UploadOptions, e as UploadedFile, B as BatchUploadOptions, P as PickResponse, R as ResolvedClientConfig } from './types-BWs1slkL.cjs';
-export { a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode } from './types-BWs1slkL.cjs';
+import { C as ClientConfig, d as UploadOptions, e as UploadedFile, B as BatchUploadOptions, P as PickResponse, R as ResolvedClientConfig } from './types-BsGu9Oi3.cjs';
+export { a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode } from './types-BsGu9Oi3.cjs';
 
 /**
  * Anything the Node client knows how to turn into an upload.

package/dist/node.d.ts

@@ -1,6 +1,6 @@
 import { Readable } from 'node:stream';
-import { C as ClientConfig, d as UploadOptions, e as UploadedFile, B as BatchUploadOptions, P as PickResponse, R as ResolvedClientConfig } from './types-BWs1slkL.js';
-export { a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode } from './types-BWs1slkL.js';
+import { C as ClientConfig, d as UploadOptions, e as UploadedFile, B as BatchUploadOptions, P as PickResponse, R as ResolvedClientConfig } from './types-BsGu9Oi3.js';
+export { a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode } from './types-BsGu9Oi3.js';
 
 /**
  * Anything the Node client knows how to turn into an upload.

package/dist/node.js

@@ -1,5 +1,5 @@
-import { NODE_SDK_VERSION_HEADER, Uploader } from './chunk-7NJTA5ZD.js';
-import { makeError } from './chunk-XBQENFBZ.js';
+import { NODE_SDK_VERSION_HEADER, Uploader } from './chunk-RYS4MXXL.js';
+import { makeError } from './chunk-G2H5WZDV.js';
 import { basename, extname } from 'path';
 import { readFile } from 'fs/promises';
 import * as fs from 'fs';

package/dist/picker.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkGTE65IAM_cjs = require('./chunk-GTE65IAM.cjs');
+var chunkTQDC5KIC_cjs = require('./chunk-TQDC5KIC.cjs');
 
 // src/picker/styles.ts
 var STYLE_ID = "unionstack-picker-styles";
@@ -1713,7 +1713,7 @@ var Picker = class {
           edited: false,
           state: "failed",
           progress: 0,
-          error: chunkGTE65IAM_cjs.EMPTY_FILE_MESSAGE,
+          error: chunkTQDC5KIC_cjs.EMPTY_FILE_MESSAGE,
           errorCode: "EMPTY_FILE"
         };
         this.items.push(item2);
@@ -2114,7 +2114,7 @@ var Picker = class {
             item.errorCode = err.code;
             this.setItemState(item, "failed");
           }
-          if (err.code === "EMPTY_FILE") this.flashNotice(chunkGTE65IAM_cjs.EMPTY_FILE_MESSAGE);
+          if (err.code === "EMPTY_FILE") this.flashNotice(chunkTQDC5KIC_cjs.EMPTY_FILE_MESSAGE);
           this.opts.onFileUploadFailed?.(p, err);
         },
         onUploadDone: (r) => {

package/dist/picker.d.cts

@@ -1,6 +1,6 @@
-import { U as UnionStackClient, P as PickerOptions, a as PickerHandle } from './client-CSZ-4GVl.cjs';
-export { b as PickerBranding, c as PickerTheme } from './client-CSZ-4GVl.cjs';
-import { P as PickResponse } from './types-BWs1slkL.cjs';
+import { U as UnionStackClient, P as PickerOptions, a as PickerHandle } from './client-C_pEvbZS.cjs';
+export { b as PickerBranding, c as PickerTheme } from './client-C_pEvbZS.cjs';
+import { P as PickResponse } from './types-BsGu9Oi3.cjs';
 
 /**
  * Single-shot file picker modal. Built imperatively (no framework) so it can

package/dist/picker.d.ts

@@ -1,6 +1,6 @@
-import { U as UnionStackClient, P as PickerOptions, a as PickerHandle } from './client-BCLIIiX2.js';
-export { b as PickerBranding, c as PickerTheme } from './client-BCLIIiX2.js';
-import { P as PickResponse } from './types-BWs1slkL.js';
+import { U as UnionStackClient, P as PickerOptions, a as PickerHandle } from './client-BofkorBV.js';
+export { b as PickerBranding, c as PickerTheme } from './client-BofkorBV.js';
+import { P as PickResponse } from './types-BsGu9Oi3.js';
 
 /**
  * Single-shot file picker modal. Built imperatively (no framework) so it can

package/dist/picker.js

@@ -1,4 +1,4 @@
-import { EMPTY_FILE_MESSAGE } from './chunk-XBQENFBZ.js';
+import { EMPTY_FILE_MESSAGE } from './chunk-G2H5WZDV.js';
 
 // src/picker/styles.ts
 var STYLE_ID = "unionstack-picker-styles";

package/dist/react.cjs

@@ -1,8 +1,8 @@
 'use strict';
 
-var chunk3FCZBKNN_cjs = require('./chunk-3FCZBKNN.cjs');
-require('./chunk-EBE7EIOZ.cjs');
-require('./chunk-GTE65IAM.cjs');
+var chunk4645KBSE_cjs = require('./chunk-4645KBSE.cjs');
+require('./chunk-PVM2ZX45.cjs');
+require('./chunk-TQDC5KIC.cjs');
 var React3 = require('react');
 
 function _interopNamespace(e) {
@@ -28,7 +28,7 @@ var React3__namespace = /*#__PURE__*/_interopNamespace(React3);
 var UnionStackContext = React3__namespace.createContext(null);
 function UnionStackProvider({ children, ...cfg }) {
   const client = React3__namespace.useMemo(
-    () => new chunk3FCZBKNN_cjs.UnionStackClient(cfg),
+    () => new chunk4645KBSE_cjs.UnionStackClient(cfg),
     // eslint-disable-next-line react-hooks/exhaustive-deps
     [cfg.apiKey, cfg.chunkSize]
   );

package/dist/react.d.cts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import { U as UnionStackClient, P as PickerOptions } from './client-CSZ-4GVl.cjs';
-export { b as PickerBranding, a as PickerHandle, c as PickerTheme } from './client-CSZ-4GVl.cjs';
-import { C as ClientConfig, e as UploadedFile, a as PickedFile, U as UploadError, B as BatchUploadOptions, P as PickResponse } from './types-BWs1slkL.cjs';
-export { b as ProgressEvent, c as UploadErrorCode, d as UploadOptions } from './types-BWs1slkL.cjs';
+import { U as UnionStackClient, P as PickerOptions } from './client-C_pEvbZS.cjs';
+export { b as PickerBranding, a as PickerHandle, c as PickerTheme } from './client-C_pEvbZS.cjs';
+import { C as ClientConfig, e as UploadedFile, a as PickedFile, U as UploadError, B as BatchUploadOptions, P as PickResponse } from './types-BsGu9Oi3.cjs';
+export { b as ProgressEvent, c as UploadErrorCode, d as UploadOptions } from './types-BsGu9Oi3.cjs';
 
 interface UnionStackProviderProps extends ClientConfig {
     children: React.ReactNode;

package/dist/react.d.ts

@@ -1,8 +1,8 @@
 import * as React from 'react';
-import { U as UnionStackClient, P as PickerOptions } from './client-BCLIIiX2.js';
-export { b as PickerBranding, a as PickerHandle, c as PickerTheme } from './client-BCLIIiX2.js';
-import { C as ClientConfig, e as UploadedFile, a as PickedFile, U as UploadError, B as BatchUploadOptions, P as PickResponse } from './types-BWs1slkL.js';
-export { b as ProgressEvent, c as UploadErrorCode, d as UploadOptions } from './types-BWs1slkL.js';
+import { U as UnionStackClient, P as PickerOptions } from './client-BofkorBV.js';
+export { b as PickerBranding, a as PickerHandle, c as PickerTheme } from './client-BofkorBV.js';
+import { C as ClientConfig, e as UploadedFile, a as PickedFile, U as UploadError, B as BatchUploadOptions, P as PickResponse } from './types-BsGu9Oi3.js';
+export { b as ProgressEvent, c as UploadErrorCode, d as UploadOptions } from './types-BsGu9Oi3.js';
 
 interface UnionStackProviderProps extends ClientConfig {
     children: React.ReactNode;

package/dist/react.js

@@ -1,6 +1,6 @@
-import { UnionStackClient } from './chunk-OZGVTEMZ.js';
-import './chunk-7NJTA5ZD.js';
-import './chunk-XBQENFBZ.js';
+import { UnionStackClient } from './chunk-QQFNG3ZF.js';
+import './chunk-RYS4MXXL.js';
+import './chunk-G2H5WZDV.js';
 import * as React3 from 'react';
 
 var UnionStackContext = React3.createContext(null);

package/dist/{types-BWs1slkL.d.cts → types-BsGu9Oi3.d.cts}

@@ -5,6 +5,8 @@ interface UploadError {
     status?: number;
     /** True if a retry has a reasonable chance of succeeding. */
     retryable: boolean;
+    /** Docs deep-link to the fix for this error, when the API provides one. */
+    docs?: string;
     /** Raw error from fetch / server (debugging only — don't display). */
     cause?: unknown;
 }

package/dist/{types-BWs1slkL.d.ts → types-BsGu9Oi3.d.ts}

@@ -5,6 +5,8 @@ interface UploadError {
     status?: number;
     /** True if a retry has a reasonable chance of succeeding. */
     retryable: boolean;
+    /** Docs deep-link to the fix for this error, when the API provides one. */
+    docs?: string;
     /** Raw error from fetch / server (debugging only — don't display). */
     cause?: unknown;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masters-union/union-stack",
-  "version": "0.3.16",
+  "version": "0.3.17",
   "description": "UnionStack — file upload SDK. Direct-to-R2 multipart uploads with a small client surface.",
   "type": "module",
   "main": "./dist/index.cjs",

package/dist/chunk-GTE65IAM.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":";;;AAMO,IAAM,kBAAA,GACX;AAGK,SAAS,SAAA,CACd,IAAA,EACA,OAAA,EACA,IAAA,GAAkE,EAAC,EACtD;AACb,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAQ,IAAA,CAAK,MAAA;AAAA,IACb,WAAW,IAAA,CAAK,SAAA,IAAa,gBAAA,CAAiB,IAAA,EAAM,KAAK,MAAM,CAAA;AAAA,IAC/D,OAAO,IAAA,CAAK;AAAA,GACd;AACF;AAEA,SAAS,gBAAA,CAAiB,MAAuB,MAAA,EAA0B;AACzE,EAAA,IAAI,IAAA,KAAS,SAAA,IAAa,IAAA,KAAS,aAAA,EAAe,OAAO,IAAA;AACzD,EAAA,IAAI,IAAA,KAAS,QAAA,IAAY,MAAA,IAAU,MAAA,IAAU,KAAK,OAAO,IAAA;AACzD,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,eAAA,CAAgB,QAAgB,IAAA,EAA4B;AAC1E,EAAA,MAAM,MAAO,IAAA,EAAiE,KAAA;AAC9E,EAAA,MAAM,GAAA,GAAM,GAAA,EAAK,OAAA,IAAW,CAAA,2BAAA,EAA8B,MAAM,CAAA,CAAA;AAChE,EAAA,MAAM,IAAA,GAAA,CAAQ,GAAA,EAAK,IAAA,IAAQ,EAAA,EAAI,WAAA,EAAY;AAE3C,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,UAAU,MAAA,EAAQ,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAC5D;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,UAAU,MAAA,EAAQ,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAC5D;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,UAAU,YAAA,EAAc,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAClE;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,UAAU,YAAA,EAAc,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAClE;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAKlB,IAAA,IAAI,SAAS,cAAA,EAAgB;AAC3B,MAAA,OAAO,UAAU,YAAA,EAAc,kBAAA,EAAoB,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,IACjF;AACA,IAAA,OAAO,UAAU,YAAA,EAAc,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAClE;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAGlB,IAAA,OAAO,UAAU,QAAA,EAAU,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAC9D;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,MAAM,UAAU,IAAA,KAAS,gBAAA;AACzB,IAAA,OAAO,SAAA,CAAU,OAAA,GAAU,OAAA,GAAU,SAAA,EAAW,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,CAAC,OAAA,EAAS,CAAA;AAAA,EACtF;AACA,EAAA,IAAI,UAAU,GAAA,EAAK;AACjB,IAAA,OAAO,UAAU,QAAA,EAAU,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,MAAM,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,UAAU,QAAA,EAAU,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAC9D","file":"chunk-GTE65IAM.cjs","sourcesContent":["import type { UploadError, UploadErrorCode } from './types.js';\n\n// Single source of truth for the 0-byte message. Used by the client-side guard\n// (uploader), the picker UI, and the server-side reject (mapped from a 422\n// EMPTY_UPLOAD), so the end user sees the same actionable text no matter where\n// the empty file was caught.\nexport const EMPTY_FILE_MESSAGE =\n  \"This file is empty (0 bytes) and can't be uploaded. If it's stored in iCloud, \" +\n  'OneDrive, or Google Drive, open it once to download it to this device, then try again.';\n\nexport function makeError(\n  code: UploadErrorCode,\n  message: string,\n  opts: { status?: number; retryable?: boolean; cause?: unknown } = {}\n): UploadError {\n  return {\n    code,\n    message,\n    status: opts.status,\n    retryable: opts.retryable ?? defaultRetryable(code, opts.status),\n    cause: opts.cause,\n  };\n}\n\nfunction defaultRetryable(code: UploadErrorCode, status?: number): boolean {\n  if (code === 'NETWORK' || code === 'PART_FAILED') return true;\n  if (code === 'SERVER' && status && status >= 500) return true;\n  return false;\n}\n\n/** Map an HTTP error response from the cdn-be API to an UploadError. */\nexport function fromApiResponse(status: number, body: unknown): UploadError {\n  const err = (body as { error?: { code?: string; message?: string } } | null)?.error;\n  const msg = err?.message || `Request failed with status ${status}`;\n  const code = (err?.code || '').toUpperCase();\n\n  if (status === 401) {\n    return makeError('AUTH', msg, { status, retryable: false });\n  }\n  if (status === 403) {\n    return makeError('AUTH', msg, { status, retryable: false });\n  }\n  if (status === 413) {\n    return makeError('VALIDATION', msg, { status, retryable: false });\n  }\n  if (status === 415) {\n    return makeError('VALIDATION', msg, { status, retryable: false });\n  }\n  if (status === 422) {\n    // Server rejected the assembled object. EMPTY_UPLOAD (0 bytes landed) gets\n    // the dedicated code + canonical message so it reads the same as a\n    // client-side empty catch; other 422s fall back to VALIDATION. Either way,\n    // retrying the same source file won't help, so it's not retryable.\n    if (code === 'EMPTY_UPLOAD') {\n      return makeError('EMPTY_FILE', EMPTY_FILE_MESSAGE, { status, retryable: false });\n    }\n    return makeError('VALIDATION', msg, { status, retryable: false });\n  }\n  if (status === 426) {\n    // Server-enforced minimum SDK version. Not retryable — the integrator\n    // must upgrade the package (or reload, for script-loader users).\n    return makeError('CONFIG', msg, { status, retryable: false });\n  }\n  if (status === 429) {\n    const isQuota = code === 'QUOTA_EXCEEDED';\n    return makeError(isQuota ? 'QUOTA' : 'NETWORK', msg, { status, retryable: !isQuota });\n  }\n  if (status >= 500) {\n    return makeError('SERVER', msg, { status, retryable: true });\n  }\n  return makeError('SERVER', msg, { status, retryable: false });\n}\n"]}

package/dist/chunk-XBQENFBZ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/errors.ts"],"names":[],"mappings":";AAMO,IAAM,kBAAA,GACX;AAGK,SAAS,SAAA,CACd,IAAA,EACA,OAAA,EACA,IAAA,GAAkE,EAAC,EACtD;AACb,EAAA,OAAO;AAAA,IACL,IAAA;AAAA,IACA,OAAA;AAAA,IACA,QAAQ,IAAA,CAAK,MAAA;AAAA,IACb,WAAW,IAAA,CAAK,SAAA,IAAa,gBAAA,CAAiB,IAAA,EAAM,KAAK,MAAM,CAAA;AAAA,IAC/D,OAAO,IAAA,CAAK;AAAA,GACd;AACF;AAEA,SAAS,gBAAA,CAAiB,MAAuB,MAAA,EAA0B;AACzE,EAAA,IAAI,IAAA,KAAS,SAAA,IAAa,IAAA,KAAS,aAAA,EAAe,OAAO,IAAA;AACzD,EAAA,IAAI,IAAA,KAAS,QAAA,IAAY,MAAA,IAAU,MAAA,IAAU,KAAK,OAAO,IAAA;AACzD,EAAA,OAAO,KAAA;AACT;AAGO,SAAS,eAAA,CAAgB,QAAgB,IAAA,EAA4B;AAC1E,EAAA,MAAM,MAAO,IAAA,EAAiE,KAAA;AAC9E,EAAA,MAAM,GAAA,GAAM,GAAA,EAAK,OAAA,IAAW,CAAA,2BAAA,EAA8B,MAAM,CAAA,CAAA;AAChE,EAAA,MAAM,IAAA,GAAA,CAAQ,GAAA,EAAK,IAAA,IAAQ,EAAA,EAAI,WAAA,EAAY;AAE3C,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,UAAU,MAAA,EAAQ,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAC5D;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,UAAU,MAAA,EAAQ,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAC5D;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,UAAU,YAAA,EAAc,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAClE;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,OAAO,UAAU,YAAA,EAAc,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAClE;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAKlB,IAAA,IAAI,SAAS,cAAA,EAAgB;AAC3B,MAAA,OAAO,UAAU,YAAA,EAAc,kBAAA,EAAoB,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,IACjF;AACA,IAAA,OAAO,UAAU,YAAA,EAAc,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAClE;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAGlB,IAAA,OAAO,UAAU,QAAA,EAAU,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAAA,EAC9D;AACA,EAAA,IAAI,WAAW,GAAA,EAAK;AAClB,IAAA,MAAM,UAAU,IAAA,KAAS,gBAAA;AACzB,IAAA,OAAO,SAAA,CAAU,OAAA,GAAU,OAAA,GAAU,SAAA,EAAW,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,CAAC,OAAA,EAAS,CAAA;AAAA,EACtF;AACA,EAAA,IAAI,UAAU,GAAA,EAAK;AACjB,IAAA,OAAO,UAAU,QAAA,EAAU,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,MAAM,CAAA;AAAA,EAC7D;AACA,EAAA,OAAO,UAAU,QAAA,EAAU,GAAA,EAAK,EAAE,MAAA,EAAQ,SAAA,EAAW,OAAO,CAAA;AAC9D","file":"chunk-XBQENFBZ.js","sourcesContent":["import type { UploadError, UploadErrorCode } from './types.js';\n\n// Single source of truth for the 0-byte message. Used by the client-side guard\n// (uploader), the picker UI, and the server-side reject (mapped from a 422\n// EMPTY_UPLOAD), so the end user sees the same actionable text no matter where\n// the empty file was caught.\nexport const EMPTY_FILE_MESSAGE =\n  \"This file is empty (0 bytes) and can't be uploaded. If it's stored in iCloud, \" +\n  'OneDrive, or Google Drive, open it once to download it to this device, then try again.';\n\nexport function makeError(\n  code: UploadErrorCode,\n  message: string,\n  opts: { status?: number; retryable?: boolean; cause?: unknown } = {}\n): UploadError {\n  return {\n    code,\n    message,\n    status: opts.status,\n    retryable: opts.retryable ?? defaultRetryable(code, opts.status),\n    cause: opts.cause,\n  };\n}\n\nfunction defaultRetryable(code: UploadErrorCode, status?: number): boolean {\n  if (code === 'NETWORK' || code === 'PART_FAILED') return true;\n  if (code === 'SERVER' && status && status >= 500) return true;\n  return false;\n}\n\n/** Map an HTTP error response from the cdn-be API to an UploadError. */\nexport function fromApiResponse(status: number, body: unknown): UploadError {\n  const err = (body as { error?: { code?: string; message?: string } } | null)?.error;\n  const msg = err?.message || `Request failed with status ${status}`;\n  const code = (err?.code || '').toUpperCase();\n\n  if (status === 401) {\n    return makeError('AUTH', msg, { status, retryable: false });\n  }\n  if (status === 403) {\n    return makeError('AUTH', msg, { status, retryable: false });\n  }\n  if (status === 413) {\n    return makeError('VALIDATION', msg, { status, retryable: false });\n  }\n  if (status === 415) {\n    return makeError('VALIDATION', msg, { status, retryable: false });\n  }\n  if (status === 422) {\n    // Server rejected the assembled object. EMPTY_UPLOAD (0 bytes landed) gets\n    // the dedicated code + canonical message so it reads the same as a\n    // client-side empty catch; other 422s fall back to VALIDATION. Either way,\n    // retrying the same source file won't help, so it's not retryable.\n    if (code === 'EMPTY_UPLOAD') {\n      return makeError('EMPTY_FILE', EMPTY_FILE_MESSAGE, { status, retryable: false });\n    }\n    return makeError('VALIDATION', msg, { status, retryable: false });\n  }\n  if (status === 426) {\n    // Server-enforced minimum SDK version. Not retryable — the integrator\n    // must upgrade the package (or reload, for script-loader users).\n    return makeError('CONFIG', msg, { status, retryable: false });\n  }\n  if (status === 429) {\n    const isQuota = code === 'QUOTA_EXCEEDED';\n    return makeError(isQuota ? 'QUOTA' : 'NETWORK', msg, { status, retryable: !isQuota });\n  }\n  if (status >= 500) {\n    return makeError('SERVER', msg, { status, retryable: true });\n  }\n  return makeError('SERVER', msg, { status, retryable: false });\n}\n"]}