@masters-union/union-stack 0.3.16 → 0.3.18

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 chunk7LKSR4EY_cjs = require('./chunk-7LKSR4EY.cjs');
+require('./chunk-4DBTQE3U.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 chunk7LKSR4EY_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-KFGLJY75.js';
+import './chunk-VDOTBC6Y.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.18",
   "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"]}