@masters-union/union-stack 0.3.8 → 0.3.9

package/dist/node.cjs

@@ -0,0 +1,244 @@
+'use strict';
+
+var chunkZOOUTUWU_cjs = require('./chunk-ZOOUTUWU.cjs');
+var path = require('path');
+var promises = require('fs/promises');
+var fs = require('fs');
+
+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 fs__namespace = /*#__PURE__*/_interopNamespace(fs);
+
+var EXT_TO_MIME = {
+  // images
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  avif: "image/avif",
+  svg: "image/svg+xml",
+  bmp: "image/bmp",
+  ico: "image/x-icon",
+  heic: "image/heic",
+  tiff: "image/tiff",
+  tif: "image/tiff",
+  // documents
+  pdf: "application/pdf",
+  txt: "text/plain",
+  csv: "text/csv",
+  md: "text/markdown",
+  json: "application/json",
+  xml: "application/xml",
+  html: "text/html",
+  htm: "text/html",
+  // office
+  doc: "application/msword",
+  docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  xls: "application/vnd.ms-excel",
+  xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  ppt: "application/vnd.ms-powerpoint",
+  pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  // media
+  mp4: "video/mp4",
+  webm: "video/webm",
+  mov: "video/quicktime",
+  mkv: "video/x-matroska",
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  m4a: "audio/mp4",
+  // archives
+  zip: "application/zip",
+  gz: "application/gzip",
+  tar: "application/x-tar"
+};
+function mimeFromName(name) {
+  const ext = path.extname(name).slice(1).toLowerCase();
+  return EXT_TO_MIME[ext] || "application/octet-stream";
+}
+var openAsBlob2 = fs__namespace.openAsBlob;
+function toBlobPart(data) {
+  return data;
+}
+function isReadable(x) {
+  return !!x && typeof x.pipe === "function" && typeof x.read === "function";
+}
+async function streamToBuffer(stream) {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(
+      Buffer.isBuffer(chunk) ? chunk : typeof chunk === "string" ? Buffer.from(chunk) : Buffer.from(chunk)
+    );
+  }
+  return Buffer.concat(chunks);
+}
+async function resolveSource(source, opts = {}) {
+  if (typeof source === "string") {
+    const filename = opts.filename || path.basename(source) || "untitled";
+    const mimetype = opts.mimeType || mimeFromName(filename);
+    try {
+      const blob = openAsBlob2 ? await openAsBlob2(source, { type: mimetype }) : new Blob([toBlobPart(await promises.readFile(source))], { type: mimetype });
+      return { blob, filename, mimetype };
+    } catch (cause) {
+      throw chunkZOOUTUWU_cjs.makeError("VALIDATION", `Could not read file at "${source}".`, {
+        retryable: false,
+        cause
+      });
+    }
+  }
+  if (typeof Blob !== "undefined" && source instanceof Blob) {
+    const filename = opts.filename || source.name || "untitled";
+    const mimetype = opts.mimeType || source.type || mimeFromName(filename);
+    const blob = opts.mimeType && opts.mimeType !== source.type ? new Blob([source], { type: opts.mimeType }) : source;
+    return { blob, filename, mimetype };
+  }
+  if (isReadable(source)) {
+    const filename = opts.filename || "untitled";
+    const mimetype = opts.mimeType || mimeFromName(filename);
+    const buf = await streamToBuffer(source);
+    return { blob: new Blob([toBlobPart(buf)], { type: mimetype }), filename, mimetype };
+  }
+  if (source instanceof ArrayBuffer || ArrayBuffer.isView(source)) {
+    const filename = opts.filename || "untitled";
+    const mimetype = opts.mimeType || mimeFromName(filename);
+    return { blob: new Blob([toBlobPart(source)], { type: mimetype }), filename, mimetype };
+  }
+  throw chunkZOOUTUWU_cjs.makeError(
+    "VALIDATION",
+    "Unsupported upload source. Pass a file path, Buffer, Uint8Array, ArrayBuffer, Blob, or Readable stream.",
+    { retryable: false }
+  );
+}
+
+// src/node/index.ts
+var API_BASE = "https://api.unionstack.link/v1";
+var DEFAULT_FILE_CONCURRENCY = 5;
+var UnionStackNodeClient = class {
+  constructor(cfg) {
+    if (!cfg?.apiKey) {
+      throw chunkZOOUTUWU_cjs.makeError("CONFIG", 'apiKey is required. Pass { apiKey: "unionstack_live_\u2026" }.', {
+        retryable: false
+      });
+    }
+    this.cfg = {
+      ...cfg,
+      apiBase: API_BASE,
+      // No picker on the server — never prefetch the picker config.
+      skipConfigPrefetch: true,
+      // Tag the traffic as server-to-server ("node/…") so cdn-be can tell it
+      // apart from browser SDK calls ("js/…").
+      sdkHeader: chunkZOOUTUWU_cjs.NODE_SDK_VERSION_HEADER
+    };
+    this.uploader = new chunkZOOUTUWU_cjs.Uploader(this.cfg);
+  }
+  /**
+   * Upload one file. Accepts a path on disk, a Buffer/Uint8Array/ArrayBuffer, a
+   * Blob/File, or a Readable stream. Returns the stored file (with its public
+   * `url`). Rejects with an {@link UploadError}.
+   */
+  async upload(source, opts = {}) {
+    const resolved = await resolveSource(source, { filename: opts.filename, mimeType: opts.mimeType });
+    return this.uploader.upload(resolved.blob, {
+      ...opts,
+      filename: resolved.filename,
+      mimeType: resolved.mimetype
+    });
+  }
+  /**
+   * Upload many files. Runs up to {@link DEFAULT_FILE_CONCURRENCY} files at once
+   * and never rejects on a single file's failure — successes and failures come
+   * back separately so a partial failure doesn't drop the whole batch.
+   */
+  async uploadMany(sources, opts = {}) {
+    if (!Array.isArray(sources) || sources.length === 0) {
+      const err = chunkZOOUTUWU_cjs.makeError("VALIDATION", "uploadMany requires a non-empty array of sources.", {
+        retryable: false
+      });
+      opts.onError?.(err);
+      throw err;
+    }
+    const filesUploaded = [];
+    const filesFailed = [];
+    let cursor = 0;
+    const worker = async () => {
+      while (true) {
+        const i = cursor++;
+        if (i >= sources.length) return;
+        let resolved;
+        try {
+          resolved = await resolveSource(sources[i], {
+            filename: opts.filename,
+            mimeType: opts.mimeType
+          });
+        } catch (err) {
+          filesFailed.push({ file: describeUnresolved(sources[i], i, opts), error: err });
+          continue;
+        }
+        const picked = {
+          uploadId: String(i),
+          filename: resolved.filename,
+          mimetype: resolved.mimetype,
+          size: resolved.blob.size,
+          source: "local"
+        };
+        try {
+          const uploaded = await this.uploader.upload(resolved.blob, {
+            ...opts,
+            filename: resolved.filename,
+            mimeType: resolved.mimetype
+          });
+          uploaded.uploadId = picked.uploadId;
+          filesUploaded.push(uploaded);
+        } catch (err) {
+          filesFailed.push({ file: picked, error: err });
+        }
+      }
+    };
+    const pool = Math.max(1, Math.min(DEFAULT_FILE_CONCURRENCY, sources.length));
+    await Promise.all(Array.from({ length: pool }, worker));
+    const result = { filesUploaded, filesFailed };
+    opts.onUploadDone?.(result);
+    return result;
+  }
+  /** Read-only view of the resolved config. */
+  get config() {
+    return this.cfg;
+  }
+};
+function describeUnresolved(source, index, opts) {
+  return {
+    uploadId: String(index),
+    filename: opts.filename || (typeof source === "string" ? path.basename(source) : "untitled"),
+    mimetype: opts.mimeType || "application/octet-stream",
+    size: 0,
+    source: "local"
+  };
+}
+var UnionStack = {
+  /** Create a server-side client. `cfg.apiKey` is required. */
+  init(cfg) {
+    return new UnionStackNodeClient(cfg);
+  }
+};
+
+exports.UnionStack = UnionStack;
+exports.UnionStackNodeClient = UnionStackNodeClient;
+//# sourceMappingURL=node.cjs.map
+//# sourceMappingURL=node.cjs.map

package/dist/node.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node/source.ts","../src/node/index.ts"],"names":["extname","openAsBlob","fs","basename","readFile","makeError","NODE_SDK_VERSION_HEADER","Uploader"],"mappings":"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","file":"node.cjs","sourcesContent":["import { basename, extname } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport * as fs from 'node:fs';\nimport { Readable } from 'node:stream';\nimport { makeError } from '../errors.js';\n\n/**\n * Anything the Node client knows how to turn into an upload.\n *\n *  • `string`            — path to a file on disk (absolute or relative to cwd)\n *  • `Buffer` / typed arr — raw bytes already in memory\n *  • `ArrayBuffer`        — raw bytes\n *  • `Blob` / `File`      — Web file objects (Node 18+ has `Blob`, 20+ has `File`)\n *  • `Readable`           — a Node stream (buffered in full before upload, since\n *                           the multipart protocol needs the total size up front)\n */\nexport type NodeUploadSource =\n  | string\n  | Buffer\n  | Uint8Array\n  | ArrayBuffer\n  | Blob\n  | Readable;\n\nexport interface ResolvedSource {\n  /** A Web `Blob` the core Uploader can `.slice()` into multipart chunks. */\n  blob: Blob;\n  filename: string;\n  mimetype: string;\n}\n\n// Smallest map that covers the bulk of real-world server uploads. Anything not\n// listed falls back to application/octet-stream — callers can always override\n// via `{ mimeType }`. Kept deliberately short; this is not a full mime database.\nconst EXT_TO_MIME: Record<string, string> = {\n  // images\n  png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif',\n  webp: 'image/webp', avif: 'image/avif', svg: 'image/svg+xml', bmp: 'image/bmp',\n  ico: 'image/x-icon', heic: 'image/heic', tiff: 'image/tiff', tif: 'image/tiff',\n  // documents\n  pdf: 'application/pdf', txt: 'text/plain', csv: 'text/csv', md: 'text/markdown',\n  json: 'application/json', xml: 'application/xml', html: 'text/html', htm: 'text/html',\n  // office\n  doc: 'application/msword',\n  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  xls: 'application/vnd.ms-excel',\n  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  ppt: 'application/vnd.ms-powerpoint',\n  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n  // media\n  mp4: 'video/mp4', webm: 'video/webm', mov: 'video/quicktime', mkv: 'video/x-matroska',\n  mp3: 'audio/mpeg', wav: 'audio/wav', ogg: 'audio/ogg', m4a: 'audio/mp4',\n  // archives\n  zip: 'application/zip', gz: 'application/gzip', tar: 'application/x-tar',\n};\n\nfunction mimeFromName(name: string): string {\n  const ext = extname(name).slice(1).toLowerCase();\n  return EXT_TO_MIME[ext] || 'application/octet-stream';\n}\n\n// `fs.openAsBlob` (Node 19.8+/20+) hands back a Blob backed by the file on disk,\n// so slicing it into parts streams lazily instead of loading the whole file into\n// memory. Typed locally — the global DOM `Blob` is what the Uploader wants, and\n// not every @types/node version exposes openAsBlob.\ntype OpenAsBlob = (path: string, options?: { type?: string }) => Promise<Blob>;\nconst openAsBlob = (fs as unknown as { openAsBlob?: OpenAsBlob }).openAsBlob;\n\n// Node's `Buffer<ArrayBufferLike>` and the DOM lib's `BlobPart`\n// (`ArrayBufferView<ArrayBuffer>`) don't line up under recent @types/node, even\n// though every value passed here is a valid Blob part at runtime. Cast once.\nfunction toBlobPart(data: ArrayBuffer | ArrayBufferView): BlobPart {\n  return data as unknown as BlobPart;\n}\n\nfunction isReadable(x: unknown): x is Readable {\n  return (\n    !!x &&\n    typeof (x as Readable).pipe === 'function' &&\n    typeof (x as { read?: unknown }).read === 'function'\n  );\n}\n\nasync function streamToBuffer(stream: Readable): Promise<Buffer> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of stream) {\n    chunks.push(\n      Buffer.isBuffer(chunk)\n        ? chunk\n        : typeof chunk === 'string'\n          ? Buffer.from(chunk)\n          : Buffer.from(chunk as Uint8Array),\n    );\n  }\n  return Buffer.concat(chunks);\n}\n\n/**\n * Normalize any {@link NodeUploadSource} into a `{ blob, filename, mimetype }`\n * the core Uploader can consume. Caller-supplied `filename` / `mimeType` always\n * win over what we infer from the path or the blob.\n */\nexport async function resolveSource(\n  source: NodeUploadSource,\n  opts: { filename?: string; mimeType?: string } = {},\n): Promise<ResolvedSource> {\n  // 1. File path on disk.\n  if (typeof source === 'string') {\n    const filename = opts.filename || basename(source) || 'untitled';\n    const mimetype = opts.mimeType || mimeFromName(filename);\n    try {\n      const blob = openAsBlob\n        ? await openAsBlob(source, { type: mimetype })\n        : new Blob([toBlobPart(await readFile(source))], { type: mimetype });\n      return { blob, filename, mimetype };\n    } catch (cause) {\n      throw makeError('VALIDATION', `Could not read file at \"${source}\".`, {\n        retryable: false,\n        cause,\n      });\n    }\n  }\n\n  // 2. Already a Blob / File.\n  if (typeof Blob !== 'undefined' && source instanceof Blob) {\n    const filename = opts.filename || (source as Blob & { name?: string }).name || 'untitled';\n    const mimetype = opts.mimeType || source.type || mimeFromName(filename);\n    // Only re-wrap when we need to stamp a type the blob doesn't already carry.\n    const blob =\n      opts.mimeType && opts.mimeType !== source.type\n        ? new Blob([source], { type: opts.mimeType })\n        : source;\n    return { blob, filename, mimetype };\n  }\n\n  // 3. Node Readable stream — buffer it fully; multipart needs the size up front.\n  if (isReadable(source)) {\n    const filename = opts.filename || 'untitled';\n    const mimetype = opts.mimeType || mimeFromName(filename);\n    const buf = await streamToBuffer(source);\n    return { blob: new Blob([toBlobPart(buf)], { type: mimetype }), filename, mimetype };\n  }\n\n  // 4. Buffer / Uint8Array / ArrayBuffer (Buffer is an ArrayBuffer view).\n  if (source instanceof ArrayBuffer || ArrayBuffer.isView(source)) {\n    const filename = opts.filename || 'untitled';\n    const mimetype = opts.mimeType || mimeFromName(filename);\n    return { blob: new Blob([toBlobPart(source)], { type: mimetype }), filename, mimetype };\n  }\n\n  throw makeError(\n    'VALIDATION',\n    'Unsupported upload source. Pass a file path, Buffer, Uint8Array, ArrayBuffer, Blob, or Readable stream.',\n    { retryable: false },\n  );\n}\n","import { basename } from 'node:path';\nimport { Uploader } from '../uploader.js';\nimport { makeError } from '../errors.js';\nimport { NODE_SDK_VERSION_HEADER } from '../version.js';\nimport { resolveSource, type NodeUploadSource } from './source.js';\nimport type {\n  ClientConfig,\n  ResolvedClientConfig,\n  UploadOptions,\n  BatchUploadOptions,\n  UploadedFile,\n  PickedFile,\n  PickResponse,\n  UploadError,\n} from '../types.js';\n\n/**\n * UnionStack API URL baked into the SDK. Consumers never see or set this — we\n * ship a new SDK version if the URL ever changes. (Same constant as the browser\n * client; kept independent so the Node entry doesn't pull in client.ts.)\n */\nconst API_BASE = 'https://api.unionstack.link/v1';\n\n// File-level fan-out for uploadMany. Each file still runs its own part-level\n// concurrency (opts.concurrency), so this caps how many files upload at once —\n// keeps a 10k-file batch from opening 10k sockets / file handles simultaneously.\nconst DEFAULT_FILE_CONCURRENCY = 5;\n\n/**\n * Server-side UnionStack client for Node.js. Uploads files straight to your\n * UnionStack bucket from a backend — no browser, no picker, no DOM.\n *\n * Use an API key whose allowed origins include `*` (server-to-server requests\n * carry no `Origin` header). Create the key and add `*` from your dashboard.\n *\n * ```ts\n * import { UnionStack } from '@masters-union/union-stack/node';\n *\n * const client = UnionStack.init({ apiKey: process.env.UNIONSTACK_API_KEY! });\n * const file = await client.upload('./invoice.pdf');\n * console.log(file.url);\n * ```\n */\nexport class UnionStackNodeClient {\n  private uploader: Uploader;\n  private cfg: ResolvedClientConfig;\n\n  constructor(cfg: ClientConfig) {\n    // A server SDK can throw on misconfiguration — unlike the browser client,\n    // there's no render path to crash.\n    if (!cfg?.apiKey) {\n      throw makeError('CONFIG', 'apiKey is required. Pass { apiKey: \"unionstack_live_…\" }.', {\n        retryable: false,\n      });\n    }\n    this.cfg = {\n      ...cfg,\n      apiBase: API_BASE,\n      // No picker on the server — never prefetch the picker config.\n      skipConfigPrefetch: true,\n      // Tag the traffic as server-to-server (\"node/…\") so cdn-be can tell it\n      // apart from browser SDK calls (\"js/…\").\n      sdkHeader: NODE_SDK_VERSION_HEADER,\n    };\n    this.uploader = new Uploader(this.cfg);\n  }\n\n  /**\n   * Upload one file. Accepts a path on disk, a Buffer/Uint8Array/ArrayBuffer, a\n   * Blob/File, or a Readable stream. Returns the stored file (with its public\n   * `url`). Rejects with an {@link UploadError}.\n   */\n  async upload(source: NodeUploadSource, opts: UploadOptions = {}): Promise<UploadedFile> {\n    const resolved = await resolveSource(source, { filename: opts.filename, mimeType: opts.mimeType });\n    return this.uploader.upload(resolved.blob, {\n      ...opts,\n      filename: resolved.filename,\n      mimeType: resolved.mimetype,\n    });\n  }\n\n  /**\n   * Upload many files. Runs up to {@link DEFAULT_FILE_CONCURRENCY} files at once\n   * and never rejects on a single file's failure — successes and failures come\n   * back separately so a partial failure doesn't drop the whole batch.\n   */\n  async uploadMany(sources: NodeUploadSource[], opts: BatchUploadOptions = {}): Promise<PickResponse> {\n    if (!Array.isArray(sources) || sources.length === 0) {\n      const err = makeError('VALIDATION', 'uploadMany requires a non-empty array of sources.', {\n        retryable: false,\n      });\n      opts.onError?.(err);\n      throw err;\n    }\n\n    const filesUploaded: UploadedFile[] = [];\n    const filesFailed: Array<{ file: PickedFile; error: UploadError }> = [];\n\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (true) {\n        const i = cursor++;\n        if (i >= sources.length) return;\n\n        let resolved;\n        try {\n          resolved = await resolveSource(sources[i], {\n            filename: opts.filename,\n            mimeType: opts.mimeType,\n          });\n        } catch (err) {\n          filesFailed.push({ file: describeUnresolved(sources[i], i, opts), error: err as UploadError });\n          continue;\n        }\n\n        const picked: PickedFile = {\n          uploadId: String(i),\n          filename: resolved.filename,\n          mimetype: resolved.mimetype,\n          size: resolved.blob.size,\n          source: 'local',\n        };\n        try {\n          const uploaded = await this.uploader.upload(resolved.blob, {\n            ...opts,\n            filename: resolved.filename,\n            mimeType: resolved.mimetype,\n          });\n          uploaded.uploadId = picked.uploadId;\n          filesUploaded.push(uploaded);\n        } catch (err) {\n          filesFailed.push({ file: picked, error: err as UploadError });\n        }\n      }\n    };\n\n    const pool = Math.max(1, Math.min(DEFAULT_FILE_CONCURRENCY, sources.length));\n    await Promise.all(Array.from({ length: pool }, worker));\n\n    const result: PickResponse = { filesUploaded, filesFailed };\n    opts.onUploadDone?.(result);\n    return result;\n  }\n\n  /** Read-only view of the resolved config. */\n  get config(): Readonly<ResolvedClientConfig> {\n    return this.cfg;\n  }\n}\n\n/** Best-effort descriptor for a file that failed before we could read it. */\nfunction describeUnresolved(\n  source: NodeUploadSource,\n  index: number,\n  opts: BatchUploadOptions,\n): PickedFile {\n  return {\n    uploadId: String(index),\n    filename: opts.filename || (typeof source === 'string' ? basename(source) : 'untitled'),\n    mimetype: opts.mimeType || 'application/octet-stream',\n    size: 0,\n    source: 'local',\n  };\n}\n\nexport const UnionStack = {\n  /** Create a server-side client. `cfg.apiKey` is required. */\n  init(cfg: ClientConfig): UnionStackNodeClient {\n    return new UnionStackNodeClient(cfg);\n  },\n};\n\nexport type { NodeUploadSource } from './source.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/node.d.cts

@@ -0,0 +1,56 @@
+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-50o0pbff.cjs';
+export { a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode } from './types-50o0pbff.cjs';
+
+/**
+ * Anything the Node client knows how to turn into an upload.
+ *
+ *  • `string`            — path to a file on disk (absolute or relative to cwd)
+ *  • `Buffer` / typed arr — raw bytes already in memory
+ *  • `ArrayBuffer`        — raw bytes
+ *  • `Blob` / `File`      — Web file objects (Node 18+ has `Blob`, 20+ has `File`)
+ *  • `Readable`           — a Node stream (buffered in full before upload, since
+ *                           the multipart protocol needs the total size up front)
+ */
+type NodeUploadSource = string | Buffer | Uint8Array | ArrayBuffer | Blob | Readable;
+
+/**
+ * Server-side UnionStack client for Node.js. Uploads files straight to your
+ * UnionStack bucket from a backend — no browser, no picker, no DOM.
+ *
+ * Use an API key whose allowed origins include `*` (server-to-server requests
+ * carry no `Origin` header). Create the key and add `*` from your dashboard.
+ *
+ * ```ts
+ * import { UnionStack } from '@masters-union/union-stack/node';
+ *
+ * const client = UnionStack.init({ apiKey: process.env.UNIONSTACK_API_KEY! });
+ * const file = await client.upload('./invoice.pdf');
+ * console.log(file.url);
+ * ```
+ */
+declare class UnionStackNodeClient {
+    private uploader;
+    private cfg;
+    constructor(cfg: ClientConfig);
+    /**
+     * Upload one file. Accepts a path on disk, a Buffer/Uint8Array/ArrayBuffer, a
+     * Blob/File, or a Readable stream. Returns the stored file (with its public
+     * `url`). Rejects with an {@link UploadError}.
+     */
+    upload(source: NodeUploadSource, opts?: UploadOptions): Promise<UploadedFile>;
+    /**
+     * Upload many files. Runs up to {@link DEFAULT_FILE_CONCURRENCY} files at once
+     * and never rejects on a single file's failure — successes and failures come
+     * back separately so a partial failure doesn't drop the whole batch.
+     */
+    uploadMany(sources: NodeUploadSource[], opts?: BatchUploadOptions): Promise<PickResponse>;
+    /** Read-only view of the resolved config. */
+    get config(): Readonly<ResolvedClientConfig>;
+}
+declare const UnionStack: {
+    /** Create a server-side client. `cfg.apiKey` is required. */
+    init(cfg: ClientConfig): UnionStackNodeClient;
+};
+
+export { BatchUploadOptions, ClientConfig, type NodeUploadSource, PickResponse, UnionStack, UnionStackNodeClient, UploadOptions, UploadedFile };

package/dist/node.d.ts

@@ -0,0 +1,56 @@
+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-50o0pbff.js';
+export { a as PickedFile, b as ProgressEvent, S as Source, U as UploadError, c as UploadErrorCode } from './types-50o0pbff.js';
+
+/**
+ * Anything the Node client knows how to turn into an upload.
+ *
+ *  • `string`            — path to a file on disk (absolute or relative to cwd)
+ *  • `Buffer` / typed arr — raw bytes already in memory
+ *  • `ArrayBuffer`        — raw bytes
+ *  • `Blob` / `File`      — Web file objects (Node 18+ has `Blob`, 20+ has `File`)
+ *  • `Readable`           — a Node stream (buffered in full before upload, since
+ *                           the multipart protocol needs the total size up front)
+ */
+type NodeUploadSource = string | Buffer | Uint8Array | ArrayBuffer | Blob | Readable;
+
+/**
+ * Server-side UnionStack client for Node.js. Uploads files straight to your
+ * UnionStack bucket from a backend — no browser, no picker, no DOM.
+ *
+ * Use an API key whose allowed origins include `*` (server-to-server requests
+ * carry no `Origin` header). Create the key and add `*` from your dashboard.
+ *
+ * ```ts
+ * import { UnionStack } from '@masters-union/union-stack/node';
+ *
+ * const client = UnionStack.init({ apiKey: process.env.UNIONSTACK_API_KEY! });
+ * const file = await client.upload('./invoice.pdf');
+ * console.log(file.url);
+ * ```
+ */
+declare class UnionStackNodeClient {
+    private uploader;
+    private cfg;
+    constructor(cfg: ClientConfig);
+    /**
+     * Upload one file. Accepts a path on disk, a Buffer/Uint8Array/ArrayBuffer, a
+     * Blob/File, or a Readable stream. Returns the stored file (with its public
+     * `url`). Rejects with an {@link UploadError}.
+     */
+    upload(source: NodeUploadSource, opts?: UploadOptions): Promise<UploadedFile>;
+    /**
+     * Upload many files. Runs up to {@link DEFAULT_FILE_CONCURRENCY} files at once
+     * and never rejects on a single file's failure — successes and failures come
+     * back separately so a partial failure doesn't drop the whole batch.
+     */
+    uploadMany(sources: NodeUploadSource[], opts?: BatchUploadOptions): Promise<PickResponse>;
+    /** Read-only view of the resolved config. */
+    get config(): Readonly<ResolvedClientConfig>;
+}
+declare const UnionStack: {
+    /** Create a server-side client. `cfg.apiKey` is required. */
+    init(cfg: ClientConfig): UnionStackNodeClient;
+};
+
+export { BatchUploadOptions, ClientConfig, type NodeUploadSource, PickResponse, UnionStack, UnionStackNodeClient, UploadOptions, UploadedFile };

package/dist/node.js

@@ -0,0 +1,221 @@
+import { makeError, NODE_SDK_VERSION_HEADER, Uploader } from './chunk-YNWENXR2.js';
+import { basename, extname } from 'path';
+import { readFile } from 'fs/promises';
+import * as fs from 'fs';
+
+var EXT_TO_MIME = {
+  // images
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp",
+  avif: "image/avif",
+  svg: "image/svg+xml",
+  bmp: "image/bmp",
+  ico: "image/x-icon",
+  heic: "image/heic",
+  tiff: "image/tiff",
+  tif: "image/tiff",
+  // documents
+  pdf: "application/pdf",
+  txt: "text/plain",
+  csv: "text/csv",
+  md: "text/markdown",
+  json: "application/json",
+  xml: "application/xml",
+  html: "text/html",
+  htm: "text/html",
+  // office
+  doc: "application/msword",
+  docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+  xls: "application/vnd.ms-excel",
+  xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+  ppt: "application/vnd.ms-powerpoint",
+  pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+  // media
+  mp4: "video/mp4",
+  webm: "video/webm",
+  mov: "video/quicktime",
+  mkv: "video/x-matroska",
+  mp3: "audio/mpeg",
+  wav: "audio/wav",
+  ogg: "audio/ogg",
+  m4a: "audio/mp4",
+  // archives
+  zip: "application/zip",
+  gz: "application/gzip",
+  tar: "application/x-tar"
+};
+function mimeFromName(name) {
+  const ext = extname(name).slice(1).toLowerCase();
+  return EXT_TO_MIME[ext] || "application/octet-stream";
+}
+var openAsBlob2 = fs.openAsBlob;
+function toBlobPart(data) {
+  return data;
+}
+function isReadable(x) {
+  return !!x && typeof x.pipe === "function" && typeof x.read === "function";
+}
+async function streamToBuffer(stream) {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(
+      Buffer.isBuffer(chunk) ? chunk : typeof chunk === "string" ? Buffer.from(chunk) : Buffer.from(chunk)
+    );
+  }
+  return Buffer.concat(chunks);
+}
+async function resolveSource(source, opts = {}) {
+  if (typeof source === "string") {
+    const filename = opts.filename || basename(source) || "untitled";
+    const mimetype = opts.mimeType || mimeFromName(filename);
+    try {
+      const blob = openAsBlob2 ? await openAsBlob2(source, { type: mimetype }) : new Blob([toBlobPart(await readFile(source))], { type: mimetype });
+      return { blob, filename, mimetype };
+    } catch (cause) {
+      throw makeError("VALIDATION", `Could not read file at "${source}".`, {
+        retryable: false,
+        cause
+      });
+    }
+  }
+  if (typeof Blob !== "undefined" && source instanceof Blob) {
+    const filename = opts.filename || source.name || "untitled";
+    const mimetype = opts.mimeType || source.type || mimeFromName(filename);
+    const blob = opts.mimeType && opts.mimeType !== source.type ? new Blob([source], { type: opts.mimeType }) : source;
+    return { blob, filename, mimetype };
+  }
+  if (isReadable(source)) {
+    const filename = opts.filename || "untitled";
+    const mimetype = opts.mimeType || mimeFromName(filename);
+    const buf = await streamToBuffer(source);
+    return { blob: new Blob([toBlobPart(buf)], { type: mimetype }), filename, mimetype };
+  }
+  if (source instanceof ArrayBuffer || ArrayBuffer.isView(source)) {
+    const filename = opts.filename || "untitled";
+    const mimetype = opts.mimeType || mimeFromName(filename);
+    return { blob: new Blob([toBlobPart(source)], { type: mimetype }), filename, mimetype };
+  }
+  throw makeError(
+    "VALIDATION",
+    "Unsupported upload source. Pass a file path, Buffer, Uint8Array, ArrayBuffer, Blob, or Readable stream.",
+    { retryable: false }
+  );
+}
+
+// src/node/index.ts
+var API_BASE = "https://api.unionstack.link/v1";
+var DEFAULT_FILE_CONCURRENCY = 5;
+var UnionStackNodeClient = class {
+  constructor(cfg) {
+    if (!cfg?.apiKey) {
+      throw makeError("CONFIG", 'apiKey is required. Pass { apiKey: "unionstack_live_\u2026" }.', {
+        retryable: false
+      });
+    }
+    this.cfg = {
+      ...cfg,
+      apiBase: API_BASE,
+      // No picker on the server — never prefetch the picker config.
+      skipConfigPrefetch: true,
+      // Tag the traffic as server-to-server ("node/…") so cdn-be can tell it
+      // apart from browser SDK calls ("js/…").
+      sdkHeader: NODE_SDK_VERSION_HEADER
+    };
+    this.uploader = new Uploader(this.cfg);
+  }
+  /**
+   * Upload one file. Accepts a path on disk, a Buffer/Uint8Array/ArrayBuffer, a
+   * Blob/File, or a Readable stream. Returns the stored file (with its public
+   * `url`). Rejects with an {@link UploadError}.
+   */
+  async upload(source, opts = {}) {
+    const resolved = await resolveSource(source, { filename: opts.filename, mimeType: opts.mimeType });
+    return this.uploader.upload(resolved.blob, {
+      ...opts,
+      filename: resolved.filename,
+      mimeType: resolved.mimetype
+    });
+  }
+  /**
+   * Upload many files. Runs up to {@link DEFAULT_FILE_CONCURRENCY} files at once
+   * and never rejects on a single file's failure — successes and failures come
+   * back separately so a partial failure doesn't drop the whole batch.
+   */
+  async uploadMany(sources, opts = {}) {
+    if (!Array.isArray(sources) || sources.length === 0) {
+      const err = makeError("VALIDATION", "uploadMany requires a non-empty array of sources.", {
+        retryable: false
+      });
+      opts.onError?.(err);
+      throw err;
+    }
+    const filesUploaded = [];
+    const filesFailed = [];
+    let cursor = 0;
+    const worker = async () => {
+      while (true) {
+        const i = cursor++;
+        if (i >= sources.length) return;
+        let resolved;
+        try {
+          resolved = await resolveSource(sources[i], {
+            filename: opts.filename,
+            mimeType: opts.mimeType
+          });
+        } catch (err) {
+          filesFailed.push({ file: describeUnresolved(sources[i], i, opts), error: err });
+          continue;
+        }
+        const picked = {
+          uploadId: String(i),
+          filename: resolved.filename,
+          mimetype: resolved.mimetype,
+          size: resolved.blob.size,
+          source: "local"
+        };
+        try {
+          const uploaded = await this.uploader.upload(resolved.blob, {
+            ...opts,
+            filename: resolved.filename,
+            mimeType: resolved.mimetype
+          });
+          uploaded.uploadId = picked.uploadId;
+          filesUploaded.push(uploaded);
+        } catch (err) {
+          filesFailed.push({ file: picked, error: err });
+        }
+      }
+    };
+    const pool = Math.max(1, Math.min(DEFAULT_FILE_CONCURRENCY, sources.length));
+    await Promise.all(Array.from({ length: pool }, worker));
+    const result = { filesUploaded, filesFailed };
+    opts.onUploadDone?.(result);
+    return result;
+  }
+  /** Read-only view of the resolved config. */
+  get config() {
+    return this.cfg;
+  }
+};
+function describeUnresolved(source, index, opts) {
+  return {
+    uploadId: String(index),
+    filename: opts.filename || (typeof source === "string" ? basename(source) : "untitled"),
+    mimetype: opts.mimeType || "application/octet-stream",
+    size: 0,
+    source: "local"
+  };
+}
+var UnionStack = {
+  /** Create a server-side client. `cfg.apiKey` is required. */
+  init(cfg) {
+    return new UnionStackNodeClient(cfg);
+  }
+};
+
+export { UnionStack, UnionStackNodeClient };
+//# sourceMappingURL=node.js.map
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/node/source.ts","../src/node/index.ts"],"names":["openAsBlob","basename"],"mappings":";;;;;AAkCA,IAAM,WAAA,GAAsC;AAAA;AAAA,EAE1C,GAAA,EAAK,WAAA;AAAA,EAAa,GAAA,EAAK,YAAA;AAAA,EAAc,IAAA,EAAM,YAAA;AAAA,EAAc,GAAA,EAAK,WAAA;AAAA,EAC9D,IAAA,EAAM,YAAA;AAAA,EAAc,IAAA,EAAM,YAAA;AAAA,EAAc,GAAA,EAAK,eAAA;AAAA,EAAiB,GAAA,EAAK,WAAA;AAAA,EACnE,GAAA,EAAK,cAAA;AAAA,EAAgB,IAAA,EAAM,YAAA;AAAA,EAAc,IAAA,EAAM,YAAA;AAAA,EAAc,GAAA,EAAK,YAAA;AAAA;AAAA,EAElE,GAAA,EAAK,iBAAA;AAAA,EAAmB,GAAA,EAAK,YAAA;AAAA,EAAc,GAAA,EAAK,UAAA;AAAA,EAAY,EAAA,EAAI,eAAA;AAAA,EAChE,IAAA,EAAM,kBAAA;AAAA,EAAoB,GAAA,EAAK,iBAAA;AAAA,EAAmB,IAAA,EAAM,WAAA;AAAA,EAAa,GAAA,EAAK,WAAA;AAAA;AAAA,EAE1E,GAAA,EAAK,oBAAA;AAAA,EACL,IAAA,EAAM,yEAAA;AAAA,EACN,GAAA,EAAK,0BAAA;AAAA,EACL,IAAA,EAAM,mEAAA;AAAA,EACN,GAAA,EAAK,+BAAA;AAAA,EACL,IAAA,EAAM,2EAAA;AAAA;AAAA,EAEN,GAAA,EAAK,WAAA;AAAA,EAAa,IAAA,EAAM,YAAA;AAAA,EAAc,GAAA,EAAK,iBAAA;AAAA,EAAmB,GAAA,EAAK,kBAAA;AAAA,EACnE,GAAA,EAAK,YAAA;AAAA,EAAc,GAAA,EAAK,WAAA;AAAA,EAAa,GAAA,EAAK,WAAA;AAAA,EAAa,GAAA,EAAK,WAAA;AAAA;AAAA,EAE5D,GAAA,EAAK,iBAAA;AAAA,EAAmB,EAAA,EAAI,kBAAA;AAAA,EAAoB,GAAA,EAAK;AACvD,CAAA;AAEA,SAAS,aAAa,IAAA,EAAsB;AAC1C,EAAA,MAAM,MAAM,OAAA,CAAQ,IAAI,EAAE,KAAA,CAAM,CAAC,EAAE,WAAA,EAAY;AAC/C,EAAA,OAAO,WAAA,CAAY,GAAG,CAAA,IAAK,0BAAA;AAC7B;AAOA,IAAMA,WAAAA,GAA4D,EAAA,CAAA,UAAA;AAKlE,SAAS,WAAW,IAAA,EAA+C;AACjE,EAAA,OAAO,IAAA;AACT;AAEA,SAAS,WAAW,CAAA,EAA2B;AAC7C,EAAA,OACE,CAAC,CAAC,CAAA,IACF,OAAQ,EAAe,IAAA,KAAS,UAAA,IAChC,OAAQ,CAAA,CAAyB,IAAA,KAAS,UAAA;AAE9C;AAEA,eAAe,eAAe,MAAA,EAAmC;AAC/D,EAAA,MAAM,SAAmB,EAAC;AAC1B,EAAA,WAAA,MAAiB,SAAS,MAAA,EAAQ;AAChC,IAAA,MAAA,CAAO,IAAA;AAAA,MACL,MAAA,CAAO,QAAA,CAAS,KAAK,CAAA,GACjB,QACA,OAAO,KAAA,KAAU,QAAA,GACf,MAAA,CAAO,IAAA,CAAK,KAAK,CAAA,GACjB,MAAA,CAAO,KAAK,KAAmB;AAAA,KACvC;AAAA,EACF;AACA,EAAA,OAAO,MAAA,CAAO,OAAO,MAAM,CAAA;AAC7B;AAOA,eAAsB,aAAA,CACpB,MAAA,EACA,IAAA,GAAiD,EAAC,EACzB;AAEzB,EAAA,IAAI,OAAO,WAAW,QAAA,EAAU;AAC9B,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAY,QAAA,CAAS,MAAM,CAAA,IAAK,UAAA;AACtD,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAY,YAAA,CAAa,QAAQ,CAAA;AACvD,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,GAAOA,cACT,MAAMA,WAAAA,CAAW,QAAQ,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA,GAC3C,IAAI,KAAK,CAAC,UAAA,CAAW,MAAM,QAAA,CAAS,MAAM,CAAC,CAAC,CAAA,EAAG,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA;AACrE,MAAA,OAAO,EAAE,IAAA,EAAM,QAAA,EAAU,QAAA,EAAS;AAAA,IACpC,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,SAAA,CAAU,YAAA,EAAc,CAAA,wBAAA,EAA2B,MAAM,CAAA,EAAA,CAAA,EAAM;AAAA,QACnE,SAAA,EAAW,KAAA;AAAA,QACX;AAAA,OACD,CAAA;AAAA,IACH;AAAA,EACF;AAGA,EAAA,IAAI,OAAO,IAAA,KAAS,WAAA,IAAe,MAAA,YAAkB,IAAA,EAAM;AACzD,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAa,MAAA,CAAoC,IAAA,IAAQ,UAAA;AAC/E,IAAA,MAAM,WAAW,IAAA,CAAK,QAAA,IAAY,MAAA,CAAO,IAAA,IAAQ,aAAa,QAAQ,CAAA;AAEtE,IAAA,MAAM,OACJ,IAAA,CAAK,QAAA,IAAY,IAAA,CAAK,QAAA,KAAa,OAAO,IAAA,GACtC,IAAI,IAAA,CAAK,CAAC,MAAM,CAAA,EAAG,EAAE,MAAM,IAAA,CAAK,QAAA,EAAU,CAAA,GAC1C,MAAA;AACN,IAAA,OAAO,EAAE,IAAA,EAAM,QAAA,EAAU,QAAA,EAAS;AAAA,EACpC;AAGA,EAAA,IAAI,UAAA,CAAW,MAAM,CAAA,EAAG;AACtB,IAAA,MAAM,QAAA,GAAW,KAAK,QAAA,IAAY,UAAA;AAClC,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAY,YAAA,CAAa,QAAQ,CAAA;AACvD,IAAA,MAAM,GAAA,GAAM,MAAM,cAAA,CAAe,MAAM,CAAA;AACvC,IAAA,OAAO,EAAE,IAAA,EAAM,IAAI,IAAA,CAAK,CAAC,UAAA,CAAW,GAAG,CAAC,CAAA,EAAG,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA,EAAG,UAAU,QAAA,EAAS;AAAA,EACrF;AAGA,EAAA,IAAI,MAAA,YAAkB,WAAA,IAAe,WAAA,CAAY,MAAA,CAAO,MAAM,CAAA,EAAG;AAC/D,IAAA,MAAM,QAAA,GAAW,KAAK,QAAA,IAAY,UAAA;AAClC,IAAA,MAAM,QAAA,GAAW,IAAA,CAAK,QAAA,IAAY,YAAA,CAAa,QAAQ,CAAA;AACvD,IAAA,OAAO,EAAE,IAAA,EAAM,IAAI,IAAA,CAAK,CAAC,UAAA,CAAW,MAAM,CAAC,CAAA,EAAG,EAAE,IAAA,EAAM,QAAA,EAAU,CAAA,EAAG,UAAU,QAAA,EAAS;AAAA,EACxF;AAEA,EAAA,MAAM,SAAA;AAAA,IACJ,YAAA;AAAA,IACA,yGAAA;AAAA,IACA,EAAE,WAAW,KAAA;AAAM,GACrB;AACF;;;ACtIA,IAAM,QAAA,GAAW,gCAAA;AAKjB,IAAM,wBAAA,GAA2B,CAAA;AAiB1B,IAAM,uBAAN,MAA2B;AAAA,EAIhC,YAAY,GAAA,EAAmB;AAG7B,IAAA,IAAI,CAAC,KAAK,MAAA,EAAQ;AAChB,MAAA,MAAM,SAAA,CAAU,UAAU,gEAAA,EAA6D;AAAA,QACrF,SAAA,EAAW;AAAA,OACZ,CAAA;AAAA,IACH;AACA,IAAA,IAAA,CAAK,GAAA,GAAM;AAAA,MACT,GAAG,GAAA;AAAA,MACH,OAAA,EAAS,QAAA;AAAA;AAAA,MAET,kBAAA,EAAoB,IAAA;AAAA;AAAA;AAAA,MAGpB,SAAA,EAAW;AAAA,KACb;AACA,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,QAAA,CAAS,IAAA,CAAK,GAAG,CAAA;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,MAAA,CAAO,MAAA,EAA0B,IAAA,GAAsB,EAAC,EAA0B;AACtF,IAAA,MAAM,QAAA,GAAW,MAAM,aAAA,CAAc,MAAA,EAAQ,EAAE,QAAA,EAAU,IAAA,CAAK,QAAA,EAAU,QAAA,EAAU,IAAA,CAAK,QAAA,EAAU,CAAA;AACjG,IAAA,OAAO,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,QAAA,CAAS,IAAA,EAAM;AAAA,MACzC,GAAG,IAAA;AAAA,MACH,UAAU,QAAA,CAAS,QAAA;AAAA,MACnB,UAAU,QAAA,CAAS;AAAA,KACpB,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAA,CAAW,OAAA,EAA6B,IAAA,GAA2B,EAAC,EAA0B;AAClG,IAAA,IAAI,CAAC,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,IAAK,OAAA,CAAQ,WAAW,CAAA,EAAG;AACnD,MAAA,MAAM,GAAA,GAAM,SAAA,CAAU,YAAA,EAAc,mDAAA,EAAqD;AAAA,QACvF,SAAA,EAAW;AAAA,OACZ,CAAA;AACD,MAAA,IAAA,CAAK,UAAU,GAAG,CAAA;AAClB,MAAA,MAAM,GAAA;AAAA,IACR;AAEA,IAAA,MAAM,gBAAgC,EAAC;AACvC,IAAA,MAAM,cAA+D,EAAC;AAEtE,IAAA,IAAI,MAAA,GAAS,CAAA;AACb,IAAA,MAAM,SAAS,YAA2B;AACxC,MAAA,OAAO,IAAA,EAAM;AACX,QAAA,MAAM,CAAA,GAAI,MAAA,EAAA;AACV,QAAA,IAAI,CAAA,IAAK,QAAQ,MAAA,EAAQ;AAEzB,QAAA,IAAI,QAAA;AACJ,QAAA,IAAI;AACF,UAAA,QAAA,GAAW,MAAM,aAAA,CAAc,OAAA,CAAQ,CAAC,CAAA,EAAG;AAAA,YACzC,UAAU,IAAA,CAAK,QAAA;AAAA,YACf,UAAU,IAAA,CAAK;AAAA,WAChB,CAAA;AAAA,QACH,SAAS,GAAA,EAAK;AACZ,UAAA,WAAA,CAAY,IAAA,CAAK,EAAE,IAAA,EAAM,kBAAA,CAAmB,OAAA,CAAQ,CAAC,CAAA,EAAG,CAAA,EAAG,IAAI,CAAA,EAAG,KAAA,EAAO,GAAA,EAAoB,CAAA;AAC7F,UAAA;AAAA,QACF;AAEA,QAAA,MAAM,MAAA,GAAqB;AAAA,UACzB,QAAA,EAAU,OAAO,CAAC,CAAA;AAAA,UAClB,UAAU,QAAA,CAAS,QAAA;AAAA,UACnB,UAAU,QAAA,CAAS,QAAA;AAAA,UACnB,IAAA,EAAM,SAAS,IAAA,CAAK,IAAA;AAAA,UACpB,MAAA,EAAQ;AAAA,SACV;AACA,QAAA,IAAI;AACF,UAAA,MAAM,WAAW,MAAM,IAAA,CAAK,QAAA,CAAS,MAAA,CAAO,SAAS,IAAA,EAAM;AAAA,YACzD,GAAG,IAAA;AAAA,YACH,UAAU,QAAA,CAAS,QAAA;AAAA,YACnB,UAAU,QAAA,CAAS;AAAA,WACpB,CAAA;AACD,UAAA,QAAA,CAAS,WAAW,MAAA,CAAO,QAAA;AAC3B,UAAA,aAAA,CAAc,KAAK,QAAQ,CAAA;AAAA,QAC7B,SAAS,GAAA,EAAK;AACZ,UAAA,WAAA,CAAY,KAAK,EAAE,IAAA,EAAM,MAAA,EAAQ,KAAA,EAAO,KAAoB,CAAA;AAAA,QAC9D;AAAA,MACF;AAAA,IACF,CAAA;AAEA,IAAA,MAAM,IAAA,GAAO,KAAK,GAAA,CAAI,CAAA,EAAG,KAAK,GAAA,CAAI,wBAAA,EAA0B,OAAA,CAAQ,MAAM,CAAC,CAAA;AAC3E,IAAA,MAAM,OAAA,CAAQ,IAAI,KAAA,CAAM,IAAA,CAAK,EAAE,MAAA,EAAQ,IAAA,EAAK,EAAG,MAAM,CAAC,CAAA;AAEtD,IAAA,MAAM,MAAA,GAAuB,EAAE,aAAA,EAAe,WAAA,EAAY;AAC1D,IAAA,IAAA,CAAK,eAAe,MAAM,CAAA;AAC1B,IAAA,OAAO,MAAA;AAAA,EACT;AAAA;AAAA,EAGA,IAAI,MAAA,GAAyC;AAC3C,IAAA,OAAO,IAAA,CAAK,GAAA;AAAA,EACd;AACF;AAGA,SAAS,kBAAA,CACP,MAAA,EACA,KAAA,EACA,IAAA,EACY;AACZ,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,OAAO,KAAK,CAAA;AAAA,IACtB,QAAA,EAAU,KAAK,QAAA,KAAa,OAAO,WAAW,QAAA,GAAWC,QAAAA,CAAS,MAAM,CAAA,GAAI,UAAA,CAAA;AAAA,IAC5E,QAAA,EAAU,KAAK,QAAA,IAAY,0BAAA;AAAA,IAC3B,IAAA,EAAM,CAAA;AAAA,IACN,MAAA,EAAQ;AAAA,GACV;AACF;AAEO,IAAM,UAAA,GAAa;AAAA;AAAA,EAExB,KAAK,GAAA,EAAyC;AAC5C,IAAA,OAAO,IAAI,qBAAqB,GAAG,CAAA;AAAA,EACrC;AACF","file":"node.js","sourcesContent":["import { basename, extname } from 'node:path';\nimport { readFile } from 'node:fs/promises';\nimport * as fs from 'node:fs';\nimport { Readable } from 'node:stream';\nimport { makeError } from '../errors.js';\n\n/**\n * Anything the Node client knows how to turn into an upload.\n *\n *  • `string`            — path to a file on disk (absolute or relative to cwd)\n *  • `Buffer` / typed arr — raw bytes already in memory\n *  • `ArrayBuffer`        — raw bytes\n *  • `Blob` / `File`      — Web file objects (Node 18+ has `Blob`, 20+ has `File`)\n *  • `Readable`           — a Node stream (buffered in full before upload, since\n *                           the multipart protocol needs the total size up front)\n */\nexport type NodeUploadSource =\n  | string\n  | Buffer\n  | Uint8Array\n  | ArrayBuffer\n  | Blob\n  | Readable;\n\nexport interface ResolvedSource {\n  /** A Web `Blob` the core Uploader can `.slice()` into multipart chunks. */\n  blob: Blob;\n  filename: string;\n  mimetype: string;\n}\n\n// Smallest map that covers the bulk of real-world server uploads. Anything not\n// listed falls back to application/octet-stream — callers can always override\n// via `{ mimeType }`. Kept deliberately short; this is not a full mime database.\nconst EXT_TO_MIME: Record<string, string> = {\n  // images\n  png: 'image/png', jpg: 'image/jpeg', jpeg: 'image/jpeg', gif: 'image/gif',\n  webp: 'image/webp', avif: 'image/avif', svg: 'image/svg+xml', bmp: 'image/bmp',\n  ico: 'image/x-icon', heic: 'image/heic', tiff: 'image/tiff', tif: 'image/tiff',\n  // documents\n  pdf: 'application/pdf', txt: 'text/plain', csv: 'text/csv', md: 'text/markdown',\n  json: 'application/json', xml: 'application/xml', html: 'text/html', htm: 'text/html',\n  // office\n  doc: 'application/msword',\n  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  xls: 'application/vnd.ms-excel',\n  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  ppt: 'application/vnd.ms-powerpoint',\n  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n  // media\n  mp4: 'video/mp4', webm: 'video/webm', mov: 'video/quicktime', mkv: 'video/x-matroska',\n  mp3: 'audio/mpeg', wav: 'audio/wav', ogg: 'audio/ogg', m4a: 'audio/mp4',\n  // archives\n  zip: 'application/zip', gz: 'application/gzip', tar: 'application/x-tar',\n};\n\nfunction mimeFromName(name: string): string {\n  const ext = extname(name).slice(1).toLowerCase();\n  return EXT_TO_MIME[ext] || 'application/octet-stream';\n}\n\n// `fs.openAsBlob` (Node 19.8+/20+) hands back a Blob backed by the file on disk,\n// so slicing it into parts streams lazily instead of loading the whole file into\n// memory. Typed locally — the global DOM `Blob` is what the Uploader wants, and\n// not every @types/node version exposes openAsBlob.\ntype OpenAsBlob = (path: string, options?: { type?: string }) => Promise<Blob>;\nconst openAsBlob = (fs as unknown as { openAsBlob?: OpenAsBlob }).openAsBlob;\n\n// Node's `Buffer<ArrayBufferLike>` and the DOM lib's `BlobPart`\n// (`ArrayBufferView<ArrayBuffer>`) don't line up under recent @types/node, even\n// though every value passed here is a valid Blob part at runtime. Cast once.\nfunction toBlobPart(data: ArrayBuffer | ArrayBufferView): BlobPart {\n  return data as unknown as BlobPart;\n}\n\nfunction isReadable(x: unknown): x is Readable {\n  return (\n    !!x &&\n    typeof (x as Readable).pipe === 'function' &&\n    typeof (x as { read?: unknown }).read === 'function'\n  );\n}\n\nasync function streamToBuffer(stream: Readable): Promise<Buffer> {\n  const chunks: Buffer[] = [];\n  for await (const chunk of stream) {\n    chunks.push(\n      Buffer.isBuffer(chunk)\n        ? chunk\n        : typeof chunk === 'string'\n          ? Buffer.from(chunk)\n          : Buffer.from(chunk as Uint8Array),\n    );\n  }\n  return Buffer.concat(chunks);\n}\n\n/**\n * Normalize any {@link NodeUploadSource} into a `{ blob, filename, mimetype }`\n * the core Uploader can consume. Caller-supplied `filename` / `mimeType` always\n * win over what we infer from the path or the blob.\n */\nexport async function resolveSource(\n  source: NodeUploadSource,\n  opts: { filename?: string; mimeType?: string } = {},\n): Promise<ResolvedSource> {\n  // 1. File path on disk.\n  if (typeof source === 'string') {\n    const filename = opts.filename || basename(source) || 'untitled';\n    const mimetype = opts.mimeType || mimeFromName(filename);\n    try {\n      const blob = openAsBlob\n        ? await openAsBlob(source, { type: mimetype })\n        : new Blob([toBlobPart(await readFile(source))], { type: mimetype });\n      return { blob, filename, mimetype };\n    } catch (cause) {\n      throw makeError('VALIDATION', `Could not read file at \"${source}\".`, {\n        retryable: false,\n        cause,\n      });\n    }\n  }\n\n  // 2. Already a Blob / File.\n  if (typeof Blob !== 'undefined' && source instanceof Blob) {\n    const filename = opts.filename || (source as Blob & { name?: string }).name || 'untitled';\n    const mimetype = opts.mimeType || source.type || mimeFromName(filename);\n    // Only re-wrap when we need to stamp a type the blob doesn't already carry.\n    const blob =\n      opts.mimeType && opts.mimeType !== source.type\n        ? new Blob([source], { type: opts.mimeType })\n        : source;\n    return { blob, filename, mimetype };\n  }\n\n  // 3. Node Readable stream — buffer it fully; multipart needs the size up front.\n  if (isReadable(source)) {\n    const filename = opts.filename || 'untitled';\n    const mimetype = opts.mimeType || mimeFromName(filename);\n    const buf = await streamToBuffer(source);\n    return { blob: new Blob([toBlobPart(buf)], { type: mimetype }), filename, mimetype };\n  }\n\n  // 4. Buffer / Uint8Array / ArrayBuffer (Buffer is an ArrayBuffer view).\n  if (source instanceof ArrayBuffer || ArrayBuffer.isView(source)) {\n    const filename = opts.filename || 'untitled';\n    const mimetype = opts.mimeType || mimeFromName(filename);\n    return { blob: new Blob([toBlobPart(source)], { type: mimetype }), filename, mimetype };\n  }\n\n  throw makeError(\n    'VALIDATION',\n    'Unsupported upload source. Pass a file path, Buffer, Uint8Array, ArrayBuffer, Blob, or Readable stream.',\n    { retryable: false },\n  );\n}\n","import { basename } from 'node:path';\nimport { Uploader } from '../uploader.js';\nimport { makeError } from '../errors.js';\nimport { NODE_SDK_VERSION_HEADER } from '../version.js';\nimport { resolveSource, type NodeUploadSource } from './source.js';\nimport type {\n  ClientConfig,\n  ResolvedClientConfig,\n  UploadOptions,\n  BatchUploadOptions,\n  UploadedFile,\n  PickedFile,\n  PickResponse,\n  UploadError,\n} from '../types.js';\n\n/**\n * UnionStack API URL baked into the SDK. Consumers never see or set this — we\n * ship a new SDK version if the URL ever changes. (Same constant as the browser\n * client; kept independent so the Node entry doesn't pull in client.ts.)\n */\nconst API_BASE = 'https://api.unionstack.link/v1';\n\n// File-level fan-out for uploadMany. Each file still runs its own part-level\n// concurrency (opts.concurrency), so this caps how many files upload at once —\n// keeps a 10k-file batch from opening 10k sockets / file handles simultaneously.\nconst DEFAULT_FILE_CONCURRENCY = 5;\n\n/**\n * Server-side UnionStack client for Node.js. Uploads files straight to your\n * UnionStack bucket from a backend — no browser, no picker, no DOM.\n *\n * Use an API key whose allowed origins include `*` (server-to-server requests\n * carry no `Origin` header). Create the key and add `*` from your dashboard.\n *\n * ```ts\n * import { UnionStack } from '@masters-union/union-stack/node';\n *\n * const client = UnionStack.init({ apiKey: process.env.UNIONSTACK_API_KEY! });\n * const file = await client.upload('./invoice.pdf');\n * console.log(file.url);\n * ```\n */\nexport class UnionStackNodeClient {\n  private uploader: Uploader;\n  private cfg: ResolvedClientConfig;\n\n  constructor(cfg: ClientConfig) {\n    // A server SDK can throw on misconfiguration — unlike the browser client,\n    // there's no render path to crash.\n    if (!cfg?.apiKey) {\n      throw makeError('CONFIG', 'apiKey is required. Pass { apiKey: \"unionstack_live_…\" }.', {\n        retryable: false,\n      });\n    }\n    this.cfg = {\n      ...cfg,\n      apiBase: API_BASE,\n      // No picker on the server — never prefetch the picker config.\n      skipConfigPrefetch: true,\n      // Tag the traffic as server-to-server (\"node/…\") so cdn-be can tell it\n      // apart from browser SDK calls (\"js/…\").\n      sdkHeader: NODE_SDK_VERSION_HEADER,\n    };\n    this.uploader = new Uploader(this.cfg);\n  }\n\n  /**\n   * Upload one file. Accepts a path on disk, a Buffer/Uint8Array/ArrayBuffer, a\n   * Blob/File, or a Readable stream. Returns the stored file (with its public\n   * `url`). Rejects with an {@link UploadError}.\n   */\n  async upload(source: NodeUploadSource, opts: UploadOptions = {}): Promise<UploadedFile> {\n    const resolved = await resolveSource(source, { filename: opts.filename, mimeType: opts.mimeType });\n    return this.uploader.upload(resolved.blob, {\n      ...opts,\n      filename: resolved.filename,\n      mimeType: resolved.mimetype,\n    });\n  }\n\n  /**\n   * Upload many files. Runs up to {@link DEFAULT_FILE_CONCURRENCY} files at once\n   * and never rejects on a single file's failure — successes and failures come\n   * back separately so a partial failure doesn't drop the whole batch.\n   */\n  async uploadMany(sources: NodeUploadSource[], opts: BatchUploadOptions = {}): Promise<PickResponse> {\n    if (!Array.isArray(sources) || sources.length === 0) {\n      const err = makeError('VALIDATION', 'uploadMany requires a non-empty array of sources.', {\n        retryable: false,\n      });\n      opts.onError?.(err);\n      throw err;\n    }\n\n    const filesUploaded: UploadedFile[] = [];\n    const filesFailed: Array<{ file: PickedFile; error: UploadError }> = [];\n\n    let cursor = 0;\n    const worker = async (): Promise<void> => {\n      while (true) {\n        const i = cursor++;\n        if (i >= sources.length) return;\n\n        let resolved;\n        try {\n          resolved = await resolveSource(sources[i], {\n            filename: opts.filename,\n            mimeType: opts.mimeType,\n          });\n        } catch (err) {\n          filesFailed.push({ file: describeUnresolved(sources[i], i, opts), error: err as UploadError });\n          continue;\n        }\n\n        const picked: PickedFile = {\n          uploadId: String(i),\n          filename: resolved.filename,\n          mimetype: resolved.mimetype,\n          size: resolved.blob.size,\n          source: 'local',\n        };\n        try {\n          const uploaded = await this.uploader.upload(resolved.blob, {\n            ...opts,\n            filename: resolved.filename,\n            mimeType: resolved.mimetype,\n          });\n          uploaded.uploadId = picked.uploadId;\n          filesUploaded.push(uploaded);\n        } catch (err) {\n          filesFailed.push({ file: picked, error: err as UploadError });\n        }\n      }\n    };\n\n    const pool = Math.max(1, Math.min(DEFAULT_FILE_CONCURRENCY, sources.length));\n    await Promise.all(Array.from({ length: pool }, worker));\n\n    const result: PickResponse = { filesUploaded, filesFailed };\n    opts.onUploadDone?.(result);\n    return result;\n  }\n\n  /** Read-only view of the resolved config. */\n  get config(): Readonly<ResolvedClientConfig> {\n    return this.cfg;\n  }\n}\n\n/** Best-effort descriptor for a file that failed before we could read it. */\nfunction describeUnresolved(\n  source: NodeUploadSource,\n  index: number,\n  opts: BatchUploadOptions,\n): PickedFile {\n  return {\n    uploadId: String(index),\n    filename: opts.filename || (typeof source === 'string' ? basename(source) : 'untitled'),\n    mimetype: opts.mimeType || 'application/octet-stream',\n    size: 0,\n    source: 'local',\n  };\n}\n\nexport const UnionStack = {\n  /** Create a server-side client. `cfg.apiKey` is required. */\n  init(cfg: ClientConfig): UnionStackNodeClient {\n    return new UnionStackNodeClient(cfg);\n  },\n};\n\nexport type { NodeUploadSource } from './source.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"]}