@masters-union/union-stack 0.1.2

package/dist/react.cjs

@@ -0,0 +1,158 @@
+'use strict';
+
+var chunkQE2P5WH4_cjs = require('./chunk-QE2P5WH4.cjs');
+var React3 = require('react');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var React3__namespace = /*#__PURE__*/_interopNamespace(React3);
+
+var UnionStackContext = React3__namespace.createContext(null);
+function UnionStackProvider({ children, ...cfg }) {
+  const client = React3__namespace.useMemo(
+    () => new chunkQE2P5WH4_cjs.UnionStackClient(cfg),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [cfg.apiKey, cfg.apiBase, cfg.chunkSize]
+  );
+  return React3__namespace.createElement(UnionStackContext.Provider, { value: client }, children);
+}
+function useUnionStack() {
+  const ctx = React3__namespace.useContext(UnionStackContext);
+  if (!ctx) {
+    throw new Error(
+      "[union-stack] useUnionStack/useUploader must be used inside <UnionStackProvider>."
+    );
+  }
+  return ctx;
+}
+var INITIAL_STATE = {
+  isUploading: false,
+  progress: 0,
+  uploaded: [],
+  failed: [],
+  error: null
+};
+function useUploader(globalOpts = {}) {
+  const client = useUnionStack();
+  const [state, setState] = React3__namespace.useState(INITIAL_STATE);
+  const abortRef = React3__namespace.useRef(null);
+  const progressRef = React3__namespace.useRef(/* @__PURE__ */ new Map());
+  const updateAggregateProgress = React3__namespace.useCallback(() => {
+    let total = 0, loaded = 0;
+    progressRef.current.forEach((v) => {
+      total += v.totalBytes;
+      loaded += v.loaded;
+    });
+    const pct = total > 0 ? Math.min(100, Math.round(loaded / total * 100)) : 0;
+    setState((s) => ({ ...s, progress: pct }));
+  }, []);
+  const upload = React3__namespace.useCallback(async (input, opts = {}) => {
+    const files = Array.isArray(input) ? input : [input];
+    const ctrl = new AbortController();
+    abortRef.current = ctrl;
+    progressRef.current = /* @__PURE__ */ new Map();
+    setState({ ...INITIAL_STATE, isUploading: true });
+    const wrappedOpts = {
+      ...globalOpts,
+      ...opts,
+      signal: opts.signal ?? ctrl.signal,
+      onUploadStarted: (fs) => {
+        fs.forEach((f) => progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: 0 }));
+        opts.onUploadStarted?.(fs);
+        globalOpts.onUploadStarted?.(fs);
+      },
+      onFileUploadStarted: (f) => {
+        opts.onFileUploadStarted?.(f);
+        globalOpts.onFileUploadStarted?.(f);
+      },
+      onFileUploadProgress: (f, ev) => {
+        progressRef.current.set(f.uploadId, { totalBytes: ev.totalBytes, loaded: ev.loaded });
+        updateAggregateProgress();
+        opts.onFileUploadProgress?.(f, ev);
+        globalOpts.onFileUploadProgress?.(f, ev);
+      },
+      onFileUploadFinished: (f) => {
+        progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: f.size });
+        updateAggregateProgress();
+        setState((s) => ({ ...s, uploaded: [...s.uploaded, f] }));
+        opts.onFileUploadFinished?.(f);
+        globalOpts.onFileUploadFinished?.(f);
+      },
+      onFileUploadFailed: (f, error) => {
+        progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: f.size });
+        updateAggregateProgress();
+        setState((s) => ({ ...s, failed: [...s.failed, { file: f, error }] }));
+        opts.onFileUploadFailed?.(f, error);
+        globalOpts.onFileUploadFailed?.(f, error);
+      },
+      onUploadDone: (result) => {
+        setState((s) => ({ ...s, isUploading: false }));
+        opts.onUploadDone?.(result);
+        globalOpts.onUploadDone?.(result);
+      },
+      onError: (err) => {
+        setState((s) => ({ ...s, isUploading: false, error: err }));
+        opts.onError?.(err);
+      }
+    };
+    try {
+      return await client.uploadMany(files, wrappedOpts);
+    } catch (err) {
+      setState((s) => ({ ...s, isUploading: false, error: err }));
+      throw err;
+    }
+  }, [client, globalOpts, updateAggregateProgress]);
+  const cancel = React3__namespace.useCallback(() => {
+    abortRef.current?.abort();
+    setState((s) => ({ ...s, isUploading: false }));
+  }, []);
+  const reset = React3__namespace.useCallback(() => {
+    progressRef.current = /* @__PURE__ */ new Map();
+    setState(INITIAL_STATE);
+  }, []);
+  return { ...state, upload, cancel, reset };
+}
+function UnionStackPicker(props) {
+  const client = useUnionStack();
+  const handleRef = React3__namespace.useRef(null);
+  const optsRef = React3__namespace.useRef(props);
+  optsRef.current = props;
+  const open = React3__namespace.useCallback(async () => {
+    const { children: _children, ...opts } = optsRef.current;
+    handleRef.current = client.picker(opts);
+    await handleRef.current.open();
+  }, [client]);
+  const close = React3__namespace.useCallback(() => {
+    handleRef.current?.close();
+  }, []);
+  const cancel = React3__namespace.useCallback(() => {
+    handleRef.current?.cancel();
+  }, []);
+  React3__namespace.useEffect(() => () => {
+    handleRef.current?.close();
+  }, []);
+  return React3__namespace.createElement(React3__namespace.Fragment, null, props.children({ open, close, cancel }));
+}
+
+exports.UnionStackPicker = UnionStackPicker;
+exports.UnionStackProvider = UnionStackProvider;
+exports.useUnionStack = useUnionStack;
+exports.useUploader = useUploader;
+//# sourceMappingURL=react.cjs.map
+//# sourceMappingURL=react.cjs.map

package/dist/react.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/provider.tsx","../src/react/useUploader.ts","../src/react/UnionStackPicker.tsx"],"names":["React","UnionStackClient","React2","React3"],"mappings":"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","file":"react.cjs","sourcesContent":["import * as React from 'react';\nimport { UnionStackClient } from '../client.js';\nimport type { ClientConfig } from '../types.js';\n\nconst UnionStackContext = React.createContext<UnionStackClient | null>(null);\n\nexport interface UnionStackProviderProps extends ClientConfig {\n  children: React.ReactNode;\n}\n\n/**\n * Provide an SDK client to the React tree.\n *\n *     <UnionStackProvider apiKey=\"unionstack_live_…\" apiBase=\"…\">\n *       <App />\n *     </UnionStackProvider>\n */\nexport function UnionStackProvider({ children, ...cfg }: UnionStackProviderProps) {\n  // Re-create the client when apiKey or apiBase changes; otherwise keep stable.\n  const client = React.useMemo(\n    () => new UnionStackClient(cfg),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [cfg.apiKey, cfg.apiBase, cfg.chunkSize],\n  );\n  return React.createElement(UnionStackContext.Provider, { value: client }, children);\n}\n\nexport function useUnionStack(): UnionStackClient {\n  const ctx = React.useContext(UnionStackContext);\n  if (!ctx) {\n    throw new Error(\n      '[union-stack] useUnionStack/useUploader must be used inside <UnionStackProvider>.',\n    );\n  }\n  return ctx;\n}\n","import * as React from 'react';\nimport { useUnionStack } from './provider.js';\nimport type {\n  BatchUploadOptions,\n  PickedFile,\n  PickResponse,\n  ProgressEvent as USProgressEvent,\n  UploadError,\n  UploadedFile,\n} from '../types.js';\n\nexport interface UseUploaderState {\n  /** True between `upload()` start and its terminal callback. */\n  isUploading: boolean;\n  /** 0-100, averaged across files in a batch. */\n  progress: number;\n  /** Files that successfully uploaded — populated as each completes. */\n  uploaded: UploadedFile[];\n  /** Files that failed — populated as each fails. */\n  failed: Array<{ file: PickedFile; error: UploadError }>;\n  /** Terminal error for the *batch* (auth fail etc.). Per-file errors land in `failed`. */\n  error: UploadError | null;\n}\n\nexport interface UseUploaderResult extends UseUploaderState {\n  /** Upload one or more files. Returns the same PickResponse shape as the SDK. */\n  upload: (files: File | Blob | (File | Blob)[], opts?: BatchUploadOptions) => Promise<PickResponse>;\n  /** Cancel any in-flight uploads from this hook. */\n  cancel: () => void;\n  /** Reset state to initial. */\n  reset: () => void;\n}\n\nconst INITIAL_STATE: UseUploaderState = {\n  isUploading: false,\n  progress: 0,\n  uploaded: [],\n  failed: [],\n  error: null,\n};\n\n/**\n * React hook wrapping `client.uploadMany`. Tracks aggregate progress,\n * accumulates uploaded/failed lists, and exposes a cancel handle.\n *\n *     const { upload, isUploading, progress, uploaded } = useUploader();\n *     <input type=\"file\" onChange={(e) => upload(e.target.files![0])} />\n */\nexport function useUploader(globalOpts: BatchUploadOptions = {}): UseUploaderResult {\n  const client = useUnionStack();\n  const [state, setState] = React.useState<UseUploaderState>(INITIAL_STATE);\n  const abortRef = React.useRef<AbortController | null>(null);\n\n  // Track in-flight progress per file so we can compute an aggregate.\n  const progressRef = React.useRef<Map<string, { totalBytes: number; loaded: number }>>(new Map());\n\n  const updateAggregateProgress = React.useCallback(() => {\n    let total = 0, loaded = 0;\n    progressRef.current.forEach(v => { total += v.totalBytes; loaded += v.loaded; });\n    const pct = total > 0 ? Math.min(100, Math.round((loaded / total) * 100)) : 0;\n    setState(s => ({ ...s, progress: pct }));\n  }, []);\n\n  const upload = React.useCallback(async (\n    input: File | Blob | (File | Blob)[],\n    opts: BatchUploadOptions = {},\n  ): Promise<PickResponse> => {\n    const files = Array.isArray(input) ? input : [input];\n    const ctrl = new AbortController();\n    abortRef.current = ctrl;\n    progressRef.current = new Map();\n    setState({ ...INITIAL_STATE, isUploading: true });\n\n    const wrappedOpts: BatchUploadOptions = {\n      ...globalOpts,\n      ...opts,\n      signal: opts.signal ?? ctrl.signal,\n      onUploadStarted: (fs) => {\n        fs.forEach(f => progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: 0 }));\n        opts.onUploadStarted?.(fs);\n        globalOpts.onUploadStarted?.(fs);\n      },\n      onFileUploadStarted: (f) => {\n        opts.onFileUploadStarted?.(f);\n        globalOpts.onFileUploadStarted?.(f);\n      },\n      onFileUploadProgress: (f, ev: USProgressEvent) => {\n        progressRef.current.set(f.uploadId, { totalBytes: ev.totalBytes, loaded: ev.loaded });\n        updateAggregateProgress();\n        opts.onFileUploadProgress?.(f, ev);\n        globalOpts.onFileUploadProgress?.(f, ev);\n      },\n      onFileUploadFinished: (f) => {\n        progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: f.size });\n        updateAggregateProgress();\n        setState(s => ({ ...s, uploaded: [...s.uploaded, f] }));\n        opts.onFileUploadFinished?.(f);\n        globalOpts.onFileUploadFinished?.(f);\n      },\n      onFileUploadFailed: (f, error) => {\n        // Treat failed bytes as \"fully accounted for\" so aggregate progress completes.\n        progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: f.size });\n        updateAggregateProgress();\n        setState(s => ({ ...s, failed: [...s.failed, { file: f, error }] }));\n        opts.onFileUploadFailed?.(f, error);\n        globalOpts.onFileUploadFailed?.(f, error);\n      },\n      onUploadDone: (result) => {\n        setState(s => ({ ...s, isUploading: false }));\n        opts.onUploadDone?.(result);\n        globalOpts.onUploadDone?.(result);\n      },\n      onError: (err) => {\n        setState(s => ({ ...s, isUploading: false, error: err }));\n        opts.onError?.(err);\n      },\n    };\n\n    try {\n      return await client.uploadMany(files, wrappedOpts);\n    } catch (err) {\n      setState(s => ({ ...s, isUploading: false, error: err as UploadError }));\n      throw err;\n    }\n  }, [client, globalOpts, updateAggregateProgress]);\n\n  const cancel = React.useCallback(() => {\n    abortRef.current?.abort();\n    setState(s => ({ ...s, isUploading: false }));\n  }, []);\n\n  const reset = React.useCallback(() => {\n    progressRef.current = new Map();\n    setState(INITIAL_STATE);\n  }, []);\n\n  return { ...state, upload, cancel, reset };\n}\n","import * as React from 'react';\nimport { useUnionStack } from './provider.js';\nimport type { PickerOptions, PickerHandle } from '../picker/types.js';\n\nexport interface UnionStackPickerProps extends PickerOptions {\n  /**\n   * Render-prop receives an `open()` function the caller wires to a button\n   * or any other trigger.\n   *\n   *     <UnionStackPicker onUploadDone={…}>\n   *       {({ open }) => <button onClick={open}>Upload</button>}\n   *     </UnionStackPicker>\n   */\n  children: (api: { open: () => Promise<void>; close: () => void; cancel: () => void }) => React.ReactNode;\n}\n\n/**\n * React wrapper around `client.picker()`. The picker bundle is lazy-loaded\n * the first time `open()` is called — the component itself is just a\n * render-prop and doesn't pull in the modal code at import time.\n */\nexport function UnionStackPicker(props: UnionStackPickerProps): React.ReactElement {\n  const client = useUnionStack();\n  const handleRef = React.useRef<PickerHandle | null>(null);\n\n  // Stabilize the latest options without re-creating the handle on every render.\n  const optsRef = React.useRef(props);\n  optsRef.current = props;\n\n  const open = React.useCallback(async () => {\n    const { children: _children, ...opts } = optsRef.current;\n    handleRef.current = client.picker(opts) as PickerHandle;\n    await handleRef.current.open();\n  }, [client]);\n\n  const close = React.useCallback(() => { handleRef.current?.close(); }, []);\n  const cancel = React.useCallback(() => { handleRef.current?.cancel(); }, []);\n\n  // Make sure we tear down the modal if the component unmounts mid-upload.\n  React.useEffect(() => () => { handleRef.current?.close(); }, []);\n\n  return React.createElement(React.Fragment, null, props.children({ open, close, cancel }));\n}\n"]}

package/dist/react.d.cts

@@ -0,0 +1,72 @@
+import * as React from 'react';
+import { C as ClientConfig, U as UnionStackClient, f as UploadedFile, a as PickedFile, c as UploadError, B as BatchUploadOptions, P as PickResponse, g as PickerOptions } from './client-xFfk4uu4.cjs';
+export { i as PickerBranding, h as PickerHandle, j as PickerTheme, b as ProgressEvent, d as UploadErrorCode, e as UploadOptions } from './client-xFfk4uu4.cjs';
+
+interface UnionStackProviderProps extends ClientConfig {
+    children: React.ReactNode;
+}
+/**
+ * Provide an SDK client to the React tree.
+ *
+ *     <UnionStackProvider apiKey="unionstack_live_…" apiBase="…">
+ *       <App />
+ *     </UnionStackProvider>
+ */
+declare function UnionStackProvider({ children, ...cfg }: UnionStackProviderProps): React.FunctionComponentElement<React.ProviderProps<UnionStackClient | null>>;
+declare function useUnionStack(): UnionStackClient;
+
+interface UseUploaderState {
+    /** True between `upload()` start and its terminal callback. */
+    isUploading: boolean;
+    /** 0-100, averaged across files in a batch. */
+    progress: number;
+    /** Files that successfully uploaded — populated as each completes. */
+    uploaded: UploadedFile[];
+    /** Files that failed — populated as each fails. */
+    failed: Array<{
+        file: PickedFile;
+        error: UploadError;
+    }>;
+    /** Terminal error for the *batch* (auth fail etc.). Per-file errors land in `failed`. */
+    error: UploadError | null;
+}
+interface UseUploaderResult extends UseUploaderState {
+    /** Upload one or more files. Returns the same PickResponse shape as the SDK. */
+    upload: (files: File | Blob | (File | Blob)[], opts?: BatchUploadOptions) => Promise<PickResponse>;
+    /** Cancel any in-flight uploads from this hook. */
+    cancel: () => void;
+    /** Reset state to initial. */
+    reset: () => void;
+}
+/**
+ * React hook wrapping `client.uploadMany`. Tracks aggregate progress,
+ * accumulates uploaded/failed lists, and exposes a cancel handle.
+ *
+ *     const { upload, isUploading, progress, uploaded } = useUploader();
+ *     <input type="file" onChange={(e) => upload(e.target.files![0])} />
+ */
+declare function useUploader(globalOpts?: BatchUploadOptions): UseUploaderResult;
+
+interface UnionStackPickerProps extends PickerOptions {
+    /**
+     * Render-prop receives an `open()` function the caller wires to a button
+     * or any other trigger.
+     *
+     *     <UnionStackPicker onUploadDone={…}>
+     *       {({ open }) => <button onClick={open}>Upload</button>}
+     *     </UnionStackPicker>
+     */
+    children: (api: {
+        open: () => Promise<void>;
+        close: () => void;
+        cancel: () => void;
+    }) => React.ReactNode;
+}
+/**
+ * React wrapper around `client.picker()`. The picker bundle is lazy-loaded
+ * the first time `open()` is called — the component itself is just a
+ * render-prop and doesn't pull in the modal code at import time.
+ */
+declare function UnionStackPicker(props: UnionStackPickerProps): React.ReactElement;
+
+export { BatchUploadOptions, ClientConfig, PickResponse, PickedFile, PickerOptions, UnionStackPicker, type UnionStackPickerProps, UnionStackProvider, UploadError, UploadedFile, type UseUploaderResult, type UseUploaderState, useUnionStack, useUploader };

package/dist/react.d.ts

@@ -0,0 +1,72 @@
+import * as React from 'react';
+import { C as ClientConfig, U as UnionStackClient, f as UploadedFile, a as PickedFile, c as UploadError, B as BatchUploadOptions, P as PickResponse, g as PickerOptions } from './client-xFfk4uu4.js';
+export { i as PickerBranding, h as PickerHandle, j as PickerTheme, b as ProgressEvent, d as UploadErrorCode, e as UploadOptions } from './client-xFfk4uu4.js';
+
+interface UnionStackProviderProps extends ClientConfig {
+    children: React.ReactNode;
+}
+/**
+ * Provide an SDK client to the React tree.
+ *
+ *     <UnionStackProvider apiKey="unionstack_live_…" apiBase="…">
+ *       <App />
+ *     </UnionStackProvider>
+ */
+declare function UnionStackProvider({ children, ...cfg }: UnionStackProviderProps): React.FunctionComponentElement<React.ProviderProps<UnionStackClient | null>>;
+declare function useUnionStack(): UnionStackClient;
+
+interface UseUploaderState {
+    /** True between `upload()` start and its terminal callback. */
+    isUploading: boolean;
+    /** 0-100, averaged across files in a batch. */
+    progress: number;
+    /** Files that successfully uploaded — populated as each completes. */
+    uploaded: UploadedFile[];
+    /** Files that failed — populated as each fails. */
+    failed: Array<{
+        file: PickedFile;
+        error: UploadError;
+    }>;
+    /** Terminal error for the *batch* (auth fail etc.). Per-file errors land in `failed`. */
+    error: UploadError | null;
+}
+interface UseUploaderResult extends UseUploaderState {
+    /** Upload one or more files. Returns the same PickResponse shape as the SDK. */
+    upload: (files: File | Blob | (File | Blob)[], opts?: BatchUploadOptions) => Promise<PickResponse>;
+    /** Cancel any in-flight uploads from this hook. */
+    cancel: () => void;
+    /** Reset state to initial. */
+    reset: () => void;
+}
+/**
+ * React hook wrapping `client.uploadMany`. Tracks aggregate progress,
+ * accumulates uploaded/failed lists, and exposes a cancel handle.
+ *
+ *     const { upload, isUploading, progress, uploaded } = useUploader();
+ *     <input type="file" onChange={(e) => upload(e.target.files![0])} />
+ */
+declare function useUploader(globalOpts?: BatchUploadOptions): UseUploaderResult;
+
+interface UnionStackPickerProps extends PickerOptions {
+    /**
+     * Render-prop receives an `open()` function the caller wires to a button
+     * or any other trigger.
+     *
+     *     <UnionStackPicker onUploadDone={…}>
+     *       {({ open }) => <button onClick={open}>Upload</button>}
+     *     </UnionStackPicker>
+     */
+    children: (api: {
+        open: () => Promise<void>;
+        close: () => void;
+        cancel: () => void;
+    }) => React.ReactNode;
+}
+/**
+ * React wrapper around `client.picker()`. The picker bundle is lazy-loaded
+ * the first time `open()` is called — the component itself is just a
+ * render-prop and doesn't pull in the modal code at import time.
+ */
+declare function UnionStackPicker(props: UnionStackPickerProps): React.ReactElement;
+
+export { BatchUploadOptions, ClientConfig, PickResponse, PickedFile, PickerOptions, UnionStackPicker, type UnionStackPickerProps, UnionStackProvider, UploadError, UploadedFile, type UseUploaderResult, type UseUploaderState, useUnionStack, useUploader };

package/dist/react.js

@@ -0,0 +1,133 @@
+import { UnionStackClient } from './chunk-5Q2UADFS.js';
+import * as React3 from 'react';
+
+var UnionStackContext = React3.createContext(null);
+function UnionStackProvider({ children, ...cfg }) {
+  const client = React3.useMemo(
+    () => new UnionStackClient(cfg),
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+    [cfg.apiKey, cfg.apiBase, cfg.chunkSize]
+  );
+  return React3.createElement(UnionStackContext.Provider, { value: client }, children);
+}
+function useUnionStack() {
+  const ctx = React3.useContext(UnionStackContext);
+  if (!ctx) {
+    throw new Error(
+      "[union-stack] useUnionStack/useUploader must be used inside <UnionStackProvider>."
+    );
+  }
+  return ctx;
+}
+var INITIAL_STATE = {
+  isUploading: false,
+  progress: 0,
+  uploaded: [],
+  failed: [],
+  error: null
+};
+function useUploader(globalOpts = {}) {
+  const client = useUnionStack();
+  const [state, setState] = React3.useState(INITIAL_STATE);
+  const abortRef = React3.useRef(null);
+  const progressRef = React3.useRef(/* @__PURE__ */ new Map());
+  const updateAggregateProgress = React3.useCallback(() => {
+    let total = 0, loaded = 0;
+    progressRef.current.forEach((v) => {
+      total += v.totalBytes;
+      loaded += v.loaded;
+    });
+    const pct = total > 0 ? Math.min(100, Math.round(loaded / total * 100)) : 0;
+    setState((s) => ({ ...s, progress: pct }));
+  }, []);
+  const upload = React3.useCallback(async (input, opts = {}) => {
+    const files = Array.isArray(input) ? input : [input];
+    const ctrl = new AbortController();
+    abortRef.current = ctrl;
+    progressRef.current = /* @__PURE__ */ new Map();
+    setState({ ...INITIAL_STATE, isUploading: true });
+    const wrappedOpts = {
+      ...globalOpts,
+      ...opts,
+      signal: opts.signal ?? ctrl.signal,
+      onUploadStarted: (fs) => {
+        fs.forEach((f) => progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: 0 }));
+        opts.onUploadStarted?.(fs);
+        globalOpts.onUploadStarted?.(fs);
+      },
+      onFileUploadStarted: (f) => {
+        opts.onFileUploadStarted?.(f);
+        globalOpts.onFileUploadStarted?.(f);
+      },
+      onFileUploadProgress: (f, ev) => {
+        progressRef.current.set(f.uploadId, { totalBytes: ev.totalBytes, loaded: ev.loaded });
+        updateAggregateProgress();
+        opts.onFileUploadProgress?.(f, ev);
+        globalOpts.onFileUploadProgress?.(f, ev);
+      },
+      onFileUploadFinished: (f) => {
+        progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: f.size });
+        updateAggregateProgress();
+        setState((s) => ({ ...s, uploaded: [...s.uploaded, f] }));
+        opts.onFileUploadFinished?.(f);
+        globalOpts.onFileUploadFinished?.(f);
+      },
+      onFileUploadFailed: (f, error) => {
+        progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: f.size });
+        updateAggregateProgress();
+        setState((s) => ({ ...s, failed: [...s.failed, { file: f, error }] }));
+        opts.onFileUploadFailed?.(f, error);
+        globalOpts.onFileUploadFailed?.(f, error);
+      },
+      onUploadDone: (result) => {
+        setState((s) => ({ ...s, isUploading: false }));
+        opts.onUploadDone?.(result);
+        globalOpts.onUploadDone?.(result);
+      },
+      onError: (err) => {
+        setState((s) => ({ ...s, isUploading: false, error: err }));
+        opts.onError?.(err);
+      }
+    };
+    try {
+      return await client.uploadMany(files, wrappedOpts);
+    } catch (err) {
+      setState((s) => ({ ...s, isUploading: false, error: err }));
+      throw err;
+    }
+  }, [client, globalOpts, updateAggregateProgress]);
+  const cancel = React3.useCallback(() => {
+    abortRef.current?.abort();
+    setState((s) => ({ ...s, isUploading: false }));
+  }, []);
+  const reset = React3.useCallback(() => {
+    progressRef.current = /* @__PURE__ */ new Map();
+    setState(INITIAL_STATE);
+  }, []);
+  return { ...state, upload, cancel, reset };
+}
+function UnionStackPicker(props) {
+  const client = useUnionStack();
+  const handleRef = React3.useRef(null);
+  const optsRef = React3.useRef(props);
+  optsRef.current = props;
+  const open = React3.useCallback(async () => {
+    const { children: _children, ...opts } = optsRef.current;
+    handleRef.current = client.picker(opts);
+    await handleRef.current.open();
+  }, [client]);
+  const close = React3.useCallback(() => {
+    handleRef.current?.close();
+  }, []);
+  const cancel = React3.useCallback(() => {
+    handleRef.current?.cancel();
+  }, []);
+  React3.useEffect(() => () => {
+    handleRef.current?.close();
+  }, []);
+  return React3.createElement(React3.Fragment, null, props.children({ open, close, cancel }));
+}
+
+export { UnionStackPicker, UnionStackProvider, useUnionStack, useUploader };
+//# sourceMappingURL=react.js.map
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react/provider.tsx","../src/react/useUploader.ts","../src/react/UnionStackPicker.tsx"],"names":["React","React2"],"mappings":"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","file":"react.js","sourcesContent":["import * as React from 'react';\nimport { UnionStackClient } from '../client.js';\nimport type { ClientConfig } from '../types.js';\n\nconst UnionStackContext = React.createContext<UnionStackClient | null>(null);\n\nexport interface UnionStackProviderProps extends ClientConfig {\n  children: React.ReactNode;\n}\n\n/**\n * Provide an SDK client to the React tree.\n *\n *     <UnionStackProvider apiKey=\"unionstack_live_…\" apiBase=\"…\">\n *       <App />\n *     </UnionStackProvider>\n */\nexport function UnionStackProvider({ children, ...cfg }: UnionStackProviderProps) {\n  // Re-create the client when apiKey or apiBase changes; otherwise keep stable.\n  const client = React.useMemo(\n    () => new UnionStackClient(cfg),\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [cfg.apiKey, cfg.apiBase, cfg.chunkSize],\n  );\n  return React.createElement(UnionStackContext.Provider, { value: client }, children);\n}\n\nexport function useUnionStack(): UnionStackClient {\n  const ctx = React.useContext(UnionStackContext);\n  if (!ctx) {\n    throw new Error(\n      '[union-stack] useUnionStack/useUploader must be used inside <UnionStackProvider>.',\n    );\n  }\n  return ctx;\n}\n","import * as React from 'react';\nimport { useUnionStack } from './provider.js';\nimport type {\n  BatchUploadOptions,\n  PickedFile,\n  PickResponse,\n  ProgressEvent as USProgressEvent,\n  UploadError,\n  UploadedFile,\n} from '../types.js';\n\nexport interface UseUploaderState {\n  /** True between `upload()` start and its terminal callback. */\n  isUploading: boolean;\n  /** 0-100, averaged across files in a batch. */\n  progress: number;\n  /** Files that successfully uploaded — populated as each completes. */\n  uploaded: UploadedFile[];\n  /** Files that failed — populated as each fails. */\n  failed: Array<{ file: PickedFile; error: UploadError }>;\n  /** Terminal error for the *batch* (auth fail etc.). Per-file errors land in `failed`. */\n  error: UploadError | null;\n}\n\nexport interface UseUploaderResult extends UseUploaderState {\n  /** Upload one or more files. Returns the same PickResponse shape as the SDK. */\n  upload: (files: File | Blob | (File | Blob)[], opts?: BatchUploadOptions) => Promise<PickResponse>;\n  /** Cancel any in-flight uploads from this hook. */\n  cancel: () => void;\n  /** Reset state to initial. */\n  reset: () => void;\n}\n\nconst INITIAL_STATE: UseUploaderState = {\n  isUploading: false,\n  progress: 0,\n  uploaded: [],\n  failed: [],\n  error: null,\n};\n\n/**\n * React hook wrapping `client.uploadMany`. Tracks aggregate progress,\n * accumulates uploaded/failed lists, and exposes a cancel handle.\n *\n *     const { upload, isUploading, progress, uploaded } = useUploader();\n *     <input type=\"file\" onChange={(e) => upload(e.target.files![0])} />\n */\nexport function useUploader(globalOpts: BatchUploadOptions = {}): UseUploaderResult {\n  const client = useUnionStack();\n  const [state, setState] = React.useState<UseUploaderState>(INITIAL_STATE);\n  const abortRef = React.useRef<AbortController | null>(null);\n\n  // Track in-flight progress per file so we can compute an aggregate.\n  const progressRef = React.useRef<Map<string, { totalBytes: number; loaded: number }>>(new Map());\n\n  const updateAggregateProgress = React.useCallback(() => {\n    let total = 0, loaded = 0;\n    progressRef.current.forEach(v => { total += v.totalBytes; loaded += v.loaded; });\n    const pct = total > 0 ? Math.min(100, Math.round((loaded / total) * 100)) : 0;\n    setState(s => ({ ...s, progress: pct }));\n  }, []);\n\n  const upload = React.useCallback(async (\n    input: File | Blob | (File | Blob)[],\n    opts: BatchUploadOptions = {},\n  ): Promise<PickResponse> => {\n    const files = Array.isArray(input) ? input : [input];\n    const ctrl = new AbortController();\n    abortRef.current = ctrl;\n    progressRef.current = new Map();\n    setState({ ...INITIAL_STATE, isUploading: true });\n\n    const wrappedOpts: BatchUploadOptions = {\n      ...globalOpts,\n      ...opts,\n      signal: opts.signal ?? ctrl.signal,\n      onUploadStarted: (fs) => {\n        fs.forEach(f => progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: 0 }));\n        opts.onUploadStarted?.(fs);\n        globalOpts.onUploadStarted?.(fs);\n      },\n      onFileUploadStarted: (f) => {\n        opts.onFileUploadStarted?.(f);\n        globalOpts.onFileUploadStarted?.(f);\n      },\n      onFileUploadProgress: (f, ev: USProgressEvent) => {\n        progressRef.current.set(f.uploadId, { totalBytes: ev.totalBytes, loaded: ev.loaded });\n        updateAggregateProgress();\n        opts.onFileUploadProgress?.(f, ev);\n        globalOpts.onFileUploadProgress?.(f, ev);\n      },\n      onFileUploadFinished: (f) => {\n        progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: f.size });\n        updateAggregateProgress();\n        setState(s => ({ ...s, uploaded: [...s.uploaded, f] }));\n        opts.onFileUploadFinished?.(f);\n        globalOpts.onFileUploadFinished?.(f);\n      },\n      onFileUploadFailed: (f, error) => {\n        // Treat failed bytes as \"fully accounted for\" so aggregate progress completes.\n        progressRef.current.set(f.uploadId, { totalBytes: f.size, loaded: f.size });\n        updateAggregateProgress();\n        setState(s => ({ ...s, failed: [...s.failed, { file: f, error }] }));\n        opts.onFileUploadFailed?.(f, error);\n        globalOpts.onFileUploadFailed?.(f, error);\n      },\n      onUploadDone: (result) => {\n        setState(s => ({ ...s, isUploading: false }));\n        opts.onUploadDone?.(result);\n        globalOpts.onUploadDone?.(result);\n      },\n      onError: (err) => {\n        setState(s => ({ ...s, isUploading: false, error: err }));\n        opts.onError?.(err);\n      },\n    };\n\n    try {\n      return await client.uploadMany(files, wrappedOpts);\n    } catch (err) {\n      setState(s => ({ ...s, isUploading: false, error: err as UploadError }));\n      throw err;\n    }\n  }, [client, globalOpts, updateAggregateProgress]);\n\n  const cancel = React.useCallback(() => {\n    abortRef.current?.abort();\n    setState(s => ({ ...s, isUploading: false }));\n  }, []);\n\n  const reset = React.useCallback(() => {\n    progressRef.current = new Map();\n    setState(INITIAL_STATE);\n  }, []);\n\n  return { ...state, upload, cancel, reset };\n}\n","import * as React from 'react';\nimport { useUnionStack } from './provider.js';\nimport type { PickerOptions, PickerHandle } from '../picker/types.js';\n\nexport interface UnionStackPickerProps extends PickerOptions {\n  /**\n   * Render-prop receives an `open()` function the caller wires to a button\n   * or any other trigger.\n   *\n   *     <UnionStackPicker onUploadDone={…}>\n   *       {({ open }) => <button onClick={open}>Upload</button>}\n   *     </UnionStackPicker>\n   */\n  children: (api: { open: () => Promise<void>; close: () => void; cancel: () => void }) => React.ReactNode;\n}\n\n/**\n * React wrapper around `client.picker()`. The picker bundle is lazy-loaded\n * the first time `open()` is called — the component itself is just a\n * render-prop and doesn't pull in the modal code at import time.\n */\nexport function UnionStackPicker(props: UnionStackPickerProps): React.ReactElement {\n  const client = useUnionStack();\n  const handleRef = React.useRef<PickerHandle | null>(null);\n\n  // Stabilize the latest options without re-creating the handle on every render.\n  const optsRef = React.useRef(props);\n  optsRef.current = props;\n\n  const open = React.useCallback(async () => {\n    const { children: _children, ...opts } = optsRef.current;\n    handleRef.current = client.picker(opts) as PickerHandle;\n    await handleRef.current.open();\n  }, [client]);\n\n  const close = React.useCallback(() => { handleRef.current?.close(); }, []);\n  const cancel = React.useCallback(() => { handleRef.current?.cancel(); }, []);\n\n  // Make sure we tear down the modal if the component unmounts mid-upload.\n  React.useEffect(() => () => { handleRef.current?.close(); }, []);\n\n  return React.createElement(React.Fragment, null, props.children({ open, close, cancel }));\n}\n"]}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "@masters-union/union-stack",
+  "version": "0.1.2",
+  "description": "UnionStack — file upload SDK. Direct-to-R2 multipart uploads with a small client surface.",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js",
+      "require": "./dist/react.cjs"
+    },
+    "./picker": {
+      "types": "./dist/picker.d.ts",
+      "import": "./dist/picker.js",
+      "require": "./dist/picker.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run typecheck && npm run build",
+    "publish-cdn": "node scripts/publish-cdn.mjs",
+    "deploy": "npm run deploy:patch",
+    "deploy:patch": "npm version patch -m 'release: v%s' && git push --follow-tags",
+    "deploy:minor": "npm version minor -m 'release: v%s' && git push --follow-tags",
+    "deploy:major": "npm version major -m 'release: v%s' && git push --follow-tags"
+  },
+  "keywords": [
+    "upload",
+    "file-upload",
+    "multipart",
+    "r2",
+    "cloudflare",
+    "cdn",
+    "unionstack"
+  ],
+  "author": "Masters Union",
+  "license": "MIT",
+  "devDependencies": {
+    "@aws-sdk/client-s3": "^3.1063.0",
+    "@types/react": "^18.3.31",
+    "@types/react-dom": "^18.3.7",
+    "dotenv": "^17.4.2",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}