@masters-union/union-stack 0.1.2

package/dist/client-xFfk4uu4.d.ts

@@ -0,0 +1,188 @@
+type UploadErrorCode = 'NETWORK' | 'VALIDATION' | 'AUTH' | 'QUOTA' | 'ABORTED' | 'SERVER' | 'CONFIG' | 'PART_FAILED';
+interface UploadError {
+    code: UploadErrorCode;
+    message: string;
+    status?: number;
+    /** True if a retry has a reasonable chance of succeeding. */
+    retryable: boolean;
+    /** Raw error from fetch / server (debugging only — don't display). */
+    cause?: unknown;
+}
+interface PickedFile {
+    uploadId: string;
+    filename: string;
+    mimetype: string;
+    size: number;
+    source: 'local' | 'url' | 'camera' | 'drop';
+}
+interface UploadedFile extends PickedFile {
+    /** Server-side file id — also stored as `handle` for Filestack compatibility. */
+    handle: string;
+    fileId: string;
+    url: string;
+    /** Object key in R2 (debugging only). */
+    key?: string;
+    status: 'Stored';
+    etag?: string;
+    uploadTags?: Record<string, string>;
+}
+interface ProgressEvent {
+    totalBytes: number;
+    loaded: number;
+    totalPercent: number;
+}
+interface PickResponse {
+    filesUploaded: UploadedFile[];
+    filesFailed: Array<{
+        file: PickedFile;
+        error: UploadError;
+    }>;
+}
+interface UploadOptions {
+    /** Override filename. Defaults to `file.name` when uploading a File. */
+    filename?: string;
+    /** Override mimeType. Defaults to `file.type` when uploading a File. */
+    mimeType?: string;
+    /** Arbitrary tags forwarded to the server and stored on the file record. */
+    metadata?: Record<string, unknown>;
+    /** Cancel an in-flight upload. */
+    signal?: AbortSignal;
+    /** How many part PUTs run in parallel. Defaults to 3. */
+    concurrency?: number;
+    /** Max retries per part. Defaults to 3. */
+    maxRetriesPerPart?: number;
+    onFileUploadStarted?: (file: PickedFile) => void;
+    onFileUploadProgress?: (file: PickedFile, ev: ProgressEvent) => void;
+    onFileUploadFinished?: (file: UploadedFile) => void;
+    onFileUploadFailed?: (file: PickedFile, error: UploadError) => void;
+}
+interface BatchUploadOptions extends UploadOptions {
+    /** Called once at the start of the batch with the file list. */
+    onUploadStarted?: (files: PickedFile[]) => void;
+    /** Terminal success — fires once even if some files failed (see `filesFailed`). */
+    onUploadDone?: (result: PickResponse) => void;
+    /** Terminal failure for the batch itself (auth, no network, ...). */
+    onError?: (error: UploadError) => void;
+}
+interface ClientConfig {
+    /** UnionStack API key, e.g. `unionstack_live_xxx`. */
+    apiKey: string;
+    /** Base URL of the cdn-be API. e.g. `https://api.unionstack.com/cdn-api` */
+    apiBase: string;
+    /** Override the upload chunk size in bytes (server may still cap this). */
+    chunkSize?: number;
+    /** Custom fetch impl — useful for testing / non-browser environments. */
+    fetch?: typeof fetch;
+    /**
+     * Disable auto-fetch of the picker config (`branding` + `theme`) when init()
+     * runs. Use when you only call `upload()` and never open the picker.
+     */
+    skipConfigPrefetch?: boolean;
+}
+/** Server-managed picker chrome + upload constraints fetched on init(). */
+interface PickerConfig {
+    branding: {
+        logoUrl: string | null;
+        title: string | null;
+        hideFooter: boolean;
+        footerText: string | null;
+    };
+    theme: {
+        primary: string | null;
+        background: string | null;
+        foreground: string | null;
+        border: string | null;
+        radius: string | null;
+        mode: 'light' | 'dark' | null;
+    };
+    constraints: {
+        maxFileSizeBytes: number;
+        minFileSizeBytes: number;
+        maxFilesPerUpload: number;
+        chunkSizeBytes: number;
+        allowedMimeTypes: string[];
+    };
+    mode: 'live' | 'test';
+}
+type Source = PickedFile['source'];
+
+interface PickerTheme {
+    /** Primary accent color (buttons, progress bar, focus rings). */
+    primary?: string;
+    /** Modal background. */
+    background?: string;
+    /** Default text color. */
+    foreground?: string;
+    /** Muted text (filenames, hints). */
+    muted?: string;
+    /** Border color for dropzone + cards. */
+    border?: string;
+    /** Border radius — accepts any CSS length. */
+    radius?: string;
+    /** Color mode hint — used to pick contrast-friendly defaults. */
+    mode?: 'light' | 'dark';
+}
+interface PickerBranding {
+    /** URL of a small logo to show in the modal header. */
+    logoUrl?: string;
+    /** Header title. Default: "Upload". */
+    title?: string;
+    /** Hide "Powered by UnionStack" footer. */
+    hideFooter?: boolean;
+}
+interface PickerOptions extends Omit<BatchUploadOptions, 'signal'> {
+    /** Constrain selectable files (HTML accept syntax). */
+    accept?: string;
+    /** Cap on file count selected at once. */
+    maxFiles?: number;
+    /** Max file size in bytes — additional client-side check before init. */
+    maxFileSize?: number;
+    theme?: PickerTheme;
+    branding?: PickerBranding;
+    /** Where to mount the modal. Default: document.body. */
+    container?: HTMLElement;
+    onOpen?: () => void;
+    onClose?: () => void;
+    onCancel?: () => void;
+    onFileSelected?: (file: PickedFile) => void | PickedFile | Promise<PickedFile | void>;
+}
+interface PickerHandle {
+    open(): Promise<PickResponse>;
+    close(): void;
+    cancel(): void;
+}
+
+interface PickerHandleLike {
+    open(): Promise<PickResponse>;
+    close(): void;
+    cancel(): void;
+}
+declare class UnionStackClient {
+    private cfg;
+    private uploader;
+    /**
+     * Promise that resolves to the server-managed picker config. Pre-fetched on
+     * construction (unless `skipConfigPrefetch: true`) so the picker opens
+     * without a network hit. Fails silently — picker falls back to defaults.
+     */
+    pickerConfigPromise: Promise<PickerConfig | null>;
+    constructor(cfg: ClientConfig);
+    /** Upload a single file. Mirrors Filestack's `client.upload()`. */
+    upload(file: File | Blob, opts?: UploadOptions): Promise<UploadedFile>;
+    /**
+     * Upload multiple files concurrently. Mirrors Filestack's batch behavior:
+     * onUploadDone fires once even if some files failed — failures land in
+     * `filesFailed`, successes in `filesUploaded`. `onError` is reserved for
+     * batch-level failures (no files even started).
+     */
+    uploadMany(files: (File | Blob)[], opts?: BatchUploadOptions): Promise<PickResponse>;
+    /**
+     * Open the file picker modal. Lazy-loads the picker bundle so the core
+     * SDK stays small for callers that only use `upload()` directly.
+     */
+    picker(opts?: PickerOptions): PickerHandleLike;
+    /** Read-only accessor used by the React/picker packages. */
+    get config(): Readonly<ClientConfig>;
+}
+
+export { type BatchUploadOptions as B, type ClientConfig as C, type PickResponse as P, type Source as S, UnionStackClient as U, type PickedFile as a, type ProgressEvent as b, type UploadError as c, type UploadErrorCode as d, type UploadOptions as e, type UploadedFile as f, type PickerOptions as g, type PickerHandle as h, type PickerBranding as i, type PickerTheme as j };

package/dist/index.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+var chunkQE2P5WH4_cjs = require('./chunk-QE2P5WH4.cjs');
+
+// src/index.ts
+var UnionStack = {
+  init(cfg) {
+    return new chunkQE2P5WH4_cjs.UnionStackClient(cfg);
+  }
+};
+
+Object.defineProperty(exports, "UnionStackClient", {
+  enumerable: true,
+  get: function () { return chunkQE2P5WH4_cjs.UnionStackClient; }
+});
+exports.UnionStack = UnionStack;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["UnionStackClient"],"mappings":";;;;;AAaO,IAAM,UAAA,GAAa;AAAA,EACxB,KAAK,GAAA,EAAqC;AACxC,IAAA,OAAO,IAAIA,mCAAiB,GAAG,CAAA;AAAA,EACjC;AACF","file":"index.cjs","sourcesContent":["import { UnionStackClient } from './client.js';\nimport type { ClientConfig } from './types.js';\n\n/**\n * UnionStack — file upload SDK.\n *\n *     import { UnionStack } from '@masters-union/union-stack';\n *     const client = UnionStack.init({\n *       apiKey: 'unionstack_live_…',\n *       apiBase: 'https://api.unionstack.com/cdn-api',\n *     });\n *     const uploaded = await client.upload(file, { onFileUploadProgress: … });\n */\nexport const UnionStack = {\n  init(cfg: ClientConfig): UnionStackClient {\n    return new UnionStackClient(cfg);\n  },\n};\n\nexport { UnionStackClient } from './client.js';\nexport type {\n  ClientConfig,\n  UploadOptions,\n  BatchUploadOptions,\n  PickedFile,\n  UploadedFile,\n  ProgressEvent,\n  PickResponse,\n  UploadError,\n  UploadErrorCode,\n  Source,\n} from './types.js';\n"]}

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+import { C as ClientConfig, U as UnionStackClient } from './client-xFfk4uu4.cjs';
+export { B as BatchUploadOptions, P as PickResponse, a as PickedFile, b as ProgressEvent, S as Source, c as UploadError, d as UploadErrorCode, e as UploadOptions, f as UploadedFile } from './client-xFfk4uu4.cjs';
+
+/**
+ * UnionStack — file upload SDK.
+ *
+ *     import { UnionStack } from '@masters-union/union-stack';
+ *     const client = UnionStack.init({
+ *       apiKey: 'unionstack_live_…',
+ *       apiBase: 'https://api.unionstack.com/cdn-api',
+ *     });
+ *     const uploaded = await client.upload(file, { onFileUploadProgress: … });
+ */
+declare const UnionStack: {
+    init(cfg: ClientConfig): UnionStackClient;
+};
+
+export { ClientConfig, UnionStack, UnionStackClient };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import { C as ClientConfig, U as UnionStackClient } from './client-xFfk4uu4.js';
+export { B as BatchUploadOptions, P as PickResponse, a as PickedFile, b as ProgressEvent, S as Source, c as UploadError, d as UploadErrorCode, e as UploadOptions, f as UploadedFile } from './client-xFfk4uu4.js';
+
+/**
+ * UnionStack — file upload SDK.
+ *
+ *     import { UnionStack } from '@masters-union/union-stack';
+ *     const client = UnionStack.init({
+ *       apiKey: 'unionstack_live_…',
+ *       apiBase: 'https://api.unionstack.com/cdn-api',
+ *     });
+ *     const uploaded = await client.upload(file, { onFileUploadProgress: … });
+ */
+declare const UnionStack: {
+    init(cfg: ClientConfig): UnionStackClient;
+};
+
+export { ClientConfig, UnionStack, UnionStackClient };

package/dist/index.js

@@ -0,0 +1,13 @@
+import { UnionStackClient } from './chunk-5Q2UADFS.js';
+export { UnionStackClient } from './chunk-5Q2UADFS.js';
+
+// src/index.ts
+var UnionStack = {
+  init(cfg) {
+    return new UnionStackClient(cfg);
+  }
+};
+
+export { UnionStack };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;AAaO,IAAM,UAAA,GAAa;AAAA,EACxB,KAAK,GAAA,EAAqC;AACxC,IAAA,OAAO,IAAI,iBAAiB,GAAG,CAAA;AAAA,EACjC;AACF","file":"index.js","sourcesContent":["import { UnionStackClient } from './client.js';\nimport type { ClientConfig } from './types.js';\n\n/**\n * UnionStack — file upload SDK.\n *\n *     import { UnionStack } from '@masters-union/union-stack';\n *     const client = UnionStack.init({\n *       apiKey: 'unionstack_live_…',\n *       apiBase: 'https://api.unionstack.com/cdn-api',\n *     });\n *     const uploaded = await client.upload(file, { onFileUploadProgress: … });\n */\nexport const UnionStack = {\n  init(cfg: ClientConfig): UnionStackClient {\n    return new UnionStackClient(cfg);\n  },\n};\n\nexport { UnionStackClient } from './client.js';\nexport type {\n  ClientConfig,\n  UploadOptions,\n  BatchUploadOptions,\n  PickedFile,\n  UploadedFile,\n  ProgressEvent,\n  PickResponse,\n  UploadError,\n  UploadErrorCode,\n  Source,\n} from './types.js';\n"]}