@velajs/storage 0.3.0 → 0.3.2

package/CHANGELOG.md

@@ -1,10 +1,15 @@
 # Changelog
 
+## 0.3.2
+
+### Patch Changes
+
+- cb3140a: Modernize the package build, validation, and release toolchain.
+
 ## 0.2.0 (2026-07-04)
 
 - Rebuilt on vela 1.11 `defineModule` + `lazyProvider` (hand-rolled forRoot/forRootAsync deleted; public API byte-identical). Requires `@velajs/vela >=1.11.0`.
 
-
 ## 0.1.0 (unreleased)
 
 - Initial release: edge-first, driver-based object/file storage for Vela.

package/dist/body-BMUcBeQ0.js

@@ -0,0 +1,93 @@
+//#region src/internal/body.ts
+const encoder = new TextEncoder();
+/** Byte length when known synchronously; `undefined` for unknown-length streams. */
+function byteLengthOf(body) {
+	if (typeof body === "string") return encoder.encode(body).byteLength;
+	if (body instanceof Blob) return body.size;
+	if (body instanceof ArrayBuffer) return body.byteLength;
+	if (ArrayBuffer.isView(body)) return body.byteLength;
+}
+/** True for the unknown-length stream case. */
+function isStream(body) {
+	return body instanceof ReadableStream;
+}
+/** Buffer any body into bytes (used for hashing / part chunking). */
+async function toBytes(body) {
+	if (typeof body === "string") return encoder.encode(body);
+	if (body instanceof Uint8Array) return body;
+	if (body instanceof ArrayBuffer) return new Uint8Array(body);
+	if (ArrayBuffer.isView(body)) {
+		const slice = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);
+		return new Uint8Array(slice);
+	}
+	if (body instanceof Blob) return new Uint8Array(await body.arrayBuffer());
+	return new Uint8Array(await new Response(body).arrayBuffer());
+}
+/** View any body as a byte stream without buffering when it already is one. */
+function toStream(body) {
+	if (body instanceof ReadableStream) return body;
+	return new Response(body).body ?? emptyStream();
+}
+function emptyStream() {
+	return new ReadableStream({ start(controller) {
+		controller.close();
+	} });
+}
+/** Wrap a stream so `onLoaded` is called with the cumulative byte count. */
+function countingStream(src, onLoaded) {
+	let loaded = 0;
+	const reader = src.getReader();
+	return new ReadableStream({
+		async pull(controller) {
+			const { done, value } = await reader.read();
+			if (done) {
+				controller.close();
+				return;
+			}
+			loaded += value.byteLength;
+			onLoaded(loaded);
+			controller.enqueue(value);
+		},
+		cancel(reason) {
+			return reader.cancel(reason);
+		}
+	});
+}
+/** Concatenate ordered byte chunks into one buffer. */
+function concatChunks(chunks) {
+	let total = 0;
+	for (const c of chunks) total += c.byteLength;
+	const out = new Uint8Array(total);
+	let offset = 0;
+	for (const c of chunks) {
+		out.set(c, offset);
+		offset += c.byteLength;
+	}
+	return out;
+}
+/**
+* Yield fixed-size (`partSize`) chunks from a byte stream, buffering only one
+* part at a time. The final chunk may be smaller. Empty input yields nothing.
+*/
+async function* chunkStream(src, partSize) {
+	const reader = src.getReader();
+	let buffer = /* @__PURE__ */ new Uint8Array(0);
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			buffer = buffer.length === 0 ? value : concatChunks([buffer, value]);
+			while (buffer.byteLength >= partSize) {
+				yield buffer.subarray(0, partSize);
+				buffer = buffer.subarray(partSize);
+			}
+		}
+		if (buffer.byteLength > 0) yield buffer;
+	} finally {
+		reader.releaseLock();
+	}
+}
+//#endregion
+export { isStream as a, countingStream as i, chunkStream as n, toBytes as o, concatChunks as r, toStream as s, byteLengthOf as t };
+
+//# sourceMappingURL=body-BMUcBeQ0.js.map

package/dist/body-BMUcBeQ0.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-BMUcBeQ0.js","names":[],"sources":["../src/internal/body.ts"],"sourcesContent":["import type { Body } from '../storage.types';\n\nconst encoder = new TextEncoder();\n\n/** Byte length when known synchronously; `undefined` for unknown-length streams. */\nexport function byteLengthOf(body: Body): number | undefined {\n  if (typeof body === 'string') return encoder.encode(body).byteLength;\n  if (body instanceof Blob) return body.size; // File extends Blob\n  if (body instanceof ArrayBuffer) return body.byteLength;\n  if (ArrayBuffer.isView(body)) return body.byteLength;\n  return undefined; // ReadableStream\n}\n\n/** True for the unknown-length stream case. */\nexport function isStream(body: Body): body is ReadableStream<Uint8Array> {\n  return body instanceof ReadableStream;\n}\n\n/** Buffer any body into bytes (used for hashing / part chunking). */\nexport async function toBytes(body: Body): Promise<Uint8Array> {\n  if (typeof body === 'string') return encoder.encode(body);\n  if (body instanceof Uint8Array) return body;\n  if (body instanceof ArrayBuffer) return new Uint8Array(body);\n  if (ArrayBuffer.isView(body)) {\n    // Copy into a fresh ArrayBuffer-backed view (the source buffer is\n    // ArrayBufferLike, which may be a SharedArrayBuffer).\n    const slice = body.buffer.slice(body.byteOffset, body.byteOffset + body.byteLength);\n    return new Uint8Array(slice as ArrayBuffer);\n  }\n  if (body instanceof Blob) return new Uint8Array(await body.arrayBuffer());\n  return new Uint8Array(await new Response(body).arrayBuffer()); // ReadableStream\n}\n\n/** View any body as a byte stream without buffering when it already is one. */\nexport function toStream(body: Body): ReadableStream<Uint8Array> {\n  if (body instanceof ReadableStream) return body;\n  const res = new Response(body as BodyInit);\n  return res.body ?? emptyStream();\n}\n\nfunction emptyStream(): ReadableStream<Uint8Array> {\n  return new ReadableStream<Uint8Array>({\n    start(controller) {\n      controller.close();\n    },\n  });\n}\n\n/** Wrap a stream so `onLoaded` is called with the cumulative byte count. */\nexport function countingStream(\n  src: ReadableStream<Uint8Array>,\n  onLoaded: (loaded: number) => void,\n): ReadableStream<Uint8Array> {\n  let loaded = 0;\n  const reader = src.getReader();\n  return new ReadableStream<Uint8Array>({\n    async pull(controller) {\n      const { done, value } = await reader.read();\n      if (done) {\n        controller.close();\n        return;\n      }\n      loaded += value.byteLength;\n      onLoaded(loaded);\n      controller.enqueue(value);\n    },\n    cancel(reason) {\n      return reader.cancel(reason);\n    },\n  });\n}\n\n/** Concatenate ordered byte chunks into one buffer. */\nexport function concatChunks(chunks: Uint8Array[]): Uint8Array {\n  let total = 0;\n  for (const c of chunks) total += c.byteLength;\n  const out = new Uint8Array(total);\n  let offset = 0;\n  for (const c of chunks) {\n    out.set(c, offset);\n    offset += c.byteLength;\n  }\n  return out;\n}\n\n/**\n * Yield fixed-size (`partSize`) chunks from a byte stream, buffering only one\n * part at a time. The final chunk may be smaller. Empty input yields nothing.\n */\nexport async function* chunkStream(\n  src: ReadableStream<Uint8Array>,\n  partSize: number,\n): AsyncGenerator<Uint8Array> {\n  const reader = src.getReader();\n  let buffer: Uint8Array = new Uint8Array(0);\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      buffer = buffer.length === 0 ? value : concatChunks([buffer, value]);\n      while (buffer.byteLength >= partSize) {\n        yield buffer.subarray(0, partSize);\n        buffer = buffer.subarray(partSize);\n      }\n    }\n    if (buffer.byteLength > 0) yield buffer;\n  } finally {\n    reader.releaseLock();\n  }\n}\n"],"mappings":";AAEA,MAAM,UAAU,IAAI,YAAY;;AAGhC,SAAgB,aAAa,MAAgC;CAC3D,IAAI,OAAO,SAAS,UAAU,OAAO,QAAQ,OAAO,IAAI,CAAC,CAAC;CAC1D,IAAI,gBAAgB,MAAM,OAAO,KAAK;CACtC,IAAI,gBAAgB,aAAa,OAAO,KAAK;CAC7C,IAAI,YAAY,OAAO,IAAI,GAAG,OAAO,KAAK;AAE5C;;AAGA,SAAgB,SAAS,MAAgD;CACvE,OAAO,gBAAgB;AACzB;;AAGA,eAAsB,QAAQ,MAAiC;CAC7D,IAAI,OAAO,SAAS,UAAU,OAAO,QAAQ,OAAO,IAAI;CACxD,IAAI,gBAAgB,YAAY,OAAO;CACvC,IAAI,gBAAgB,aAAa,OAAO,IAAI,WAAW,IAAI;CAC3D,IAAI,YAAY,OAAO,IAAI,GAAG;EAG5B,MAAM,QAAQ,KAAK,OAAO,MAAM,KAAK,YAAY,KAAK,aAAa,KAAK,UAAU;EAClF,OAAO,IAAI,WAAW,KAAoB;CAC5C;CACA,IAAI,gBAAgB,MAAM,OAAO,IAAI,WAAW,MAAM,KAAK,YAAY,CAAC;CACxE,OAAO,IAAI,WAAW,MAAM,IAAI,SAAS,IAAI,CAAC,CAAC,YAAY,CAAC;AAC9D;;AAGA,SAAgB,SAAS,MAAwC;CAC/D,IAAI,gBAAgB,gBAAgB,OAAO;CAE3C,OAAO,IADS,SAAS,IAChB,CAAC,CAAC,QAAQ,YAAY;AACjC;AAEA,SAAS,cAA0C;CACjD,OAAO,IAAI,eAA2B,EACpC,MAAM,YAAY;EAChB,WAAW,MAAM;CACnB,EACF,CAAC;AACH;;AAGA,SAAgB,eACd,KACA,UAC4B;CAC5B,IAAI,SAAS;CACb,MAAM,SAAS,IAAI,UAAU;CAC7B,OAAO,IAAI,eAA2B;EACpC,MAAM,KAAK,YAAY;GACrB,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAC1C,IAAI,MAAM;IACR,WAAW,MAAM;IACjB;GACF;GACA,UAAU,MAAM;GAChB,SAAS,MAAM;GACf,WAAW,QAAQ,KAAK;EAC1B;EACA,OAAO,QAAQ;GACb,OAAO,OAAO,OAAO,MAAM;EAC7B;CACF,CAAC;AACH;;AAGA,SAAgB,aAAa,QAAkC;CAC7D,IAAI,QAAQ;CACZ,KAAK,MAAM,KAAK,QAAQ,SAAS,EAAE;CACnC,MAAM,MAAM,IAAI,WAAW,KAAK;CAChC,IAAI,SAAS;CACb,KAAK,MAAM,KAAK,QAAQ;EACtB,IAAI,IAAI,GAAG,MAAM;EACjB,UAAU,EAAE;CACd;CACA,OAAO;AACT;;;;;AAMA,gBAAuB,YACrB,KACA,UAC4B;CAC5B,MAAM,SAAS,IAAI,UAAU;CAC7B,IAAI,yBAAqB,IAAI,WAAW,CAAC;CACzC,IAAI;EACF,SAAS;GACP,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,KAAK;GAC1C,IAAI,MAAM;GACV,SAAS,OAAO,WAAW,IAAI,QAAQ,aAAa,CAAC,QAAQ,KAAK,CAAC;GACnE,OAAO,OAAO,cAAc,UAAU;IACpC,MAAM,OAAO,SAAS,GAAG,QAAQ;IACjC,SAAS,OAAO,SAAS,QAAQ;GACnC;EACF;EACA,IAAI,OAAO,aAAa,GAAG,MAAM;CACnC,UAAU;EACR,OAAO,YAAY;CACrB;AACF"}

package/dist/client/index.d.ts

@@ -1,50 +1,53 @@
-import type { UploadResult } from '../storage.types';
-import type { ListResponse } from '../http/protocol.types';
-import type { DeleteManyResult } from '../storage.types';
-export interface StorageClientOptions {
-    /** Base URL of the mounted controller, e.g. `/api/storage`. */
-    baseUrl: string;
-    /** Per-request headers (auth token/cookie). */
-    headers?: () => Record<string, string> | Promise<Record<string, string>>;
-    /** Override fetch (SSR/tests). */
-    fetch?: typeof fetch;
-    /** Files larger than this switch to multipart. Default 16 MiB. */
-    multipartThreshold?: number;
+import { A as UploadResult, o as DeleteManyResult } from "../storage.types-BJN7Yp1J.js";
+import { n as ListResponse } from "../protocol.types-C5PPBD12.js";
+//#region src/client/index.d.ts
+interface StorageClientOptions {
+  /** Base URL of the mounted controller, e.g. `/api/storage`. */
+  baseUrl: string;
+  /** Per-request headers (auth token/cookie). */
+  headers?: () => Record<string, string> | Promise<Record<string, string>>;
+  /** Override fetch (SSR/tests). */
+  fetch?: typeof fetch;
+  /** Files larger than this switch to multipart. Default 16 MiB. */
+  multipartThreshold?: number;
 }
-export interface ClientUploadOptions {
-    /** Object key. Defaults to the file's name. The server may override it. */
-    key?: string;
-    contentType?: string;
-    metadata?: Record<string, string>;
-    multipart?: boolean | {
-        partSize?: number;
-        concurrency?: number;
-    };
-    onProgress?: (p: {
-        loaded: number;
-        total: number;
-    }) => void;
-    signal?: AbortSignal;
-    /** Stable id enabling resume across reloads (multipart only). */
-    resumeKey?: string;
+interface ClientUploadOptions {
+  /** Object key. Defaults to the file's name. The server may override it. */
+  key?: string;
+  contentType?: string;
+  metadata?: Record<string, string>;
+  multipart?: boolean | {
+    partSize?: number;
+    concurrency?: number;
+  };
+  onProgress?: (p: {
+    loaded: number;
+    total: number;
+  }) => void;
+  signal?: AbortSignal;
+  /** Stable id enabling resume across reloads (multipart only). */
+  resumeKey?: string;
 }
-export declare class StorageClientError extends Error {
-    readonly code: string;
-    readonly status: number;
-    constructor(code: string, message: string, status: number);
-    static from(res: Response): Promise<StorageClientError>;
+declare class StorageClientError extends Error {
+  readonly code: string;
+  readonly status: number;
+  constructor(code: string, message: string, status: number);
+  static from(res: Response): Promise<StorageClientError>;
 }
-export declare class StorageClient {
-    #private;
-    private readonly options;
-    constructor(options: StorageClientOptions);
-    upload(file: File | Blob, opts?: ClientUploadOptions): Promise<UploadResult>;
-    list(query?: {
-        prefix?: string;
-        cursor?: string;
-        limit?: number;
-        delimiter?: string;
-    }): Promise<ListResponse>;
-    delete(keys: string[]): Promise<DeleteManyResult>;
-    downloadUrl(key: string): Promise<string>;
+declare class StorageClient {
+  #private;
+  private readonly options;
+  constructor(options: StorageClientOptions);
+  upload(file: File | Blob, opts?: ClientUploadOptions): Promise<UploadResult>;
+  list(query?: {
+    prefix?: string;
+    cursor?: string;
+    limit?: number;
+    delimiter?: string;
+  }): Promise<ListResponse>;
+  delete(keys: string[]): Promise<DeleteManyResult>;
+  downloadUrl(key: string): Promise<string>;
 }
+//#endregion
+export { ClientUploadOptions, StorageClient, StorageClientError, StorageClientOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.js

@@ -1,243 +1,222 @@
-// Browser upload client for @velajs/storage. Framework-agnostic, zero-dep.
-// Ships from the `./client` subpath (DOM code, not edge code). Talks to the
-// StorageController's JSON control-plane over fetch, and uploads bytes DIRECTLY
-// to the bucket via presigned URLs (XHR for progress; fetch has no upload
-// progress event). Wire types are imported type-only.
-const DEFAULT_MULTIPART_THRESHOLD = 16 * 1024 * 1024; // 16 MiB
+//#region src/client/index.ts
+const DEFAULT_MULTIPART_THRESHOLD = 16 * 1024 * 1024;
 const DEFAULT_CONCURRENCY = 4;
-export class StorageClientError extends Error {
-    code;
-    status;
-    constructor(code, message, status){
-        super(message), this.code = code, this.status = status;
-        this.name = 'StorageClientError';
-    }
-    static async from(res) {
-        let code = 'upstream_error';
-        let message = `request failed: ${res.status}`;
-        try {
-            const body = await res.json();
-            if (body?.error) {
-                code = body.error.code;
-                message = body.error.message;
-            }
-        } catch  {
-        /* non-JSON body */ }
-        return new StorageClientError(code, message, res.status);
-    }
-}
+var StorageClientError = class StorageClientError extends Error {
+	code;
+	status;
+	constructor(code, message, status) {
+		super(message);
+		this.code = code;
+		this.status = status;
+		this.name = "StorageClientError";
+	}
+	static async from(res) {
+		let code = "upstream_error";
+		let message = `request failed: ${res.status}`;
+		try {
+			const body = await res.json();
+			if (body?.error) {
+				code = body.error.code;
+				message = body.error.message;
+			}
+		} catch {}
+		return new StorageClientError(code, message, res.status);
+	}
+};
 async function pool(items, limit, worker) {
-    let i = 0;
-    const run = async ()=>{
-        while(i < items.length){
-            const index = i++;
-            await worker(items[index], index);
-        }
-    };
-    await Promise.all(Array.from({
-        length: Math.min(Math.max(1, limit), items.length || 1)
-    }, run));
+	let i = 0;
+	const run = async () => {
+		while (i < items.length) {
+			const index = i++;
+			await worker(items[index], index);
+		}
+	};
+	await Promise.all(Array.from({ length: Math.min(Math.max(1, limit), items.length || 1) }, run));
 }
 function xhrSend(o) {
-    return new Promise((resolve, reject)=>{
-        const xhr = new XMLHttpRequest();
-        xhr.open(o.method, o.url, true);
-        for (const [k, v] of Object.entries(o.headers ?? {}))xhr.setRequestHeader(k, v);
-        if (o.onProgress) {
-            xhr.upload.onprogress = (e)=>o.onProgress({
-                    loaded: e.loaded,
-                    total: e.total
-                });
-        }
-        xhr.onload = ()=>xhr.status >= 200 && xhr.status < 300 ? resolve({
-                status: xhr.status,
-                getHeader: (n)=>xhr.getResponseHeader(n)
-            }) : reject(new StorageClientError('upstream_error', `upload failed: ${xhr.status}`, xhr.status));
-        xhr.onerror = ()=>reject(new StorageClientError('upstream_error', 'network error', 0));
-        o.signal?.addEventListener('abort', ()=>xhr.abort(), {
-            once: true
-        });
-        xhr.send(o.body);
-    });
+	return new Promise((resolve, reject) => {
+		const xhr = new XMLHttpRequest();
+		xhr.open(o.method, o.url, true);
+		for (const [k, v] of Object.entries(o.headers ?? {})) xhr.setRequestHeader(k, v);
+		if (o.onProgress) xhr.upload.onprogress = (e) => o.onProgress({
+			loaded: e.loaded,
+			total: e.total
+		});
+		xhr.onload = () => xhr.status >= 200 && xhr.status < 300 ? resolve({
+			status: xhr.status,
+			getHeader: (n) => xhr.getResponseHeader(n)
+		}) : reject(new StorageClientError("upstream_error", `upload failed: ${xhr.status}`, xhr.status));
+		xhr.onerror = () => reject(new StorageClientError("upstream_error", "network error", 0));
+		o.signal?.addEventListener("abort", () => xhr.abort(), { once: true });
+		xhr.send(o.body);
+	});
 }
 function loadSession(resumeKey, fingerprint) {
-    if (!resumeKey || typeof localStorage === 'undefined') return undefined;
-    try {
-        const raw = localStorage.getItem(`vela.storage.resume:${resumeKey}`);
-        if (!raw) return undefined;
-        const s = JSON.parse(raw);
-        return s.fingerprint === fingerprint ? s : undefined;
-    } catch  {
-        return undefined;
-    }
+	if (!resumeKey || typeof localStorage === "undefined") return void 0;
+	try {
+		const raw = localStorage.getItem(`vela.storage.resume:${resumeKey}`);
+		if (!raw) return void 0;
+		const s = JSON.parse(raw);
+		return s.fingerprint === fingerprint ? s : void 0;
+	} catch {
+		return;
+	}
 }
 function saveSession(resumeKey, fingerprint, s) {
-    if (!resumeKey || typeof localStorage === 'undefined') return;
-    try {
-        localStorage.setItem(`vela.storage.resume:${resumeKey}`, JSON.stringify({
-            ...s,
-            fingerprint
-        }));
-    } catch  {
-    /* quota / private mode — resume is best-effort */ }
+	if (!resumeKey || typeof localStorage === "undefined") return;
+	try {
+		localStorage.setItem(`vela.storage.resume:${resumeKey}`, JSON.stringify({
+			...s,
+			fingerprint
+		}));
+	} catch {}
 }
 function clearSession(resumeKey) {
-    if (!resumeKey || typeof localStorage === 'undefined') return;
-    try {
-        localStorage.removeItem(`vela.storage.resume:${resumeKey}`);
-    } catch  {
-    /* ignore */ }
-}
-export class StorageClient {
-    options;
-    constructor(options){
-        this.options = options;
-    }
-    async upload(file, opts = {}) {
-        const threshold = this.options.multipartThreshold ?? DEFAULT_MULTIPART_THRESHOLD;
-        const multipart = opts.multipart === true || opts.multipart !== false && file.size > threshold;
-        return multipart ? this.#multipartUpload(file, opts) : this.#simpleUpload(file, opts);
-    }
-    list(query = {}) {
-        const qs = new URLSearchParams();
-        for (const [k, v] of Object.entries(query))if (v != null) qs.set(k, String(v));
-        return this.#json('GET', `/list?${qs.toString()}`);
-    }
-    delete(keys) {
-        return this.#json('POST', '/delete', {
-            keys
-        });
-    }
-    async downloadUrl(key) {
-        const r = await this.#json('POST', '/sign-download', {
-            key
-        });
-        return r.url;
-    }
-    // ---- internals ----
-    async #simpleUpload(file, opts) {
-        const key = opts.key ?? fileName(file);
-        const { upload } = await this.#json('POST', '/sign-upload', {
-            key,
-            contentType: opts.contentType ?? (file.type || undefined),
-            size: file.size,
-            metadata: opts.metadata
-        });
-        if (upload.method === 'PUT') {
-            await xhrSend({
-                method: 'PUT',
-                url: upload.url,
-                body: file,
-                headers: {
-                    'content-type': file.type || 'application/octet-stream',
-                    ...upload.headers
-                },
-                signal: opts.signal,
-                onProgress: opts.onProgress
-            });
-        } else {
-            const form = new FormData();
-            for (const [k, v] of Object.entries(upload.fields))form.append(k, v);
-            form.append('file', file); // 'file' must be last for an S3/R2 POST policy
-            await xhrSend({
-                method: 'POST',
-                url: upload.url,
-                body: form,
-                signal: opts.signal,
-                onProgress: opts.onProgress
-            });
-        }
-        return {
-            key,
-            size: file.size,
-            contentType: opts.contentType ?? (file.type || 'application/octet-stream')
-        };
-    }
-    async #multipartUpload(file, opts) {
-        const key = opts.key ?? fileName(file);
-        const fingerprint = `${fileName(file)}:${file.size}`;
-        const concurrency = typeof opts.multipart === 'object' && opts.multipart.concurrency || DEFAULT_CONCURRENCY;
-        let session = loadSession(opts.resumeKey, fingerprint);
-        if (!session) {
-            const created = await this.#json('POST', '/multipart/create', {
-                key,
-                contentType: opts.contentType ?? (file.type || undefined),
-                metadata: opts.metadata,
-                partSize: typeof opts.multipart === 'object' ? opts.multipart.partSize : undefined
-            });
-            session = {
-                key: created.key,
-                uploadId: created.uploadId,
-                partSize: created.partSize,
-                uploaded: {}
-            };
-        }
-        const partSize = session.partSize;
-        const count = Math.ceil(file.size / partSize) || 1;
-        const loaded = new Array(count + 1).fill(0);
-        for (const n of Object.keys(session.uploaded))loaded[Number(n)] = partBytes(Number(n), partSize, file.size);
-        const report = ()=>opts.onProgress?.({
-                loaded: loaded.reduce((a, b)=>a + b, 0),
-                total: file.size
-            });
-        const todo = Array.from({
-            length: count
-        }, (_, i)=>i + 1).filter((n)=>!session.uploaded[n]);
-        await pool(todo, concurrency, async (n)=>{
-            const blob = file.slice((n - 1) * partSize, Math.min(n * partSize, file.size));
-            const signed = await this.#json('POST', '/multipart/sign-part', {
-                key: session.key,
-                uploadId: session.uploadId,
-                partNumber: n
-            });
-            const res = await xhrSend({
-                method: 'PUT',
-                url: signed.url,
-                body: blob,
-                headers: signed.headers,
-                signal: opts.signal,
-                onProgress: (p)=>{
-                    loaded[n] = p.loaded;
-                    report();
-                }
-            });
-            const etag = res.getHeader('ETag') ?? res.getHeader('etag');
-            if (!etag) {
-                throw new StorageClientError('invalid_request', 'missing ETag on part upload (check bucket CORS ExposeHeaders: ETag)', res.status);
-            }
-            session.uploaded[n] = etag;
-            saveSession(opts.resumeKey, fingerprint, session);
-        });
-        const parts = Object.entries(session.uploaded).map(([n, etag])=>({
-                partNumber: Number(n),
-                etag
-            })).sort((a, b)=>a.partNumber - b.partNumber);
-        const result = await this.#json('POST', '/multipart/complete', {
-            key: session.key,
-            uploadId: session.uploadId,
-            parts
-        });
-        clearSession(opts.resumeKey);
-        return result;
-    }
-    async #json(method, path, body) {
-        const fetchImpl = this.options.fetch ?? fetch;
-        const res = await fetchImpl(this.options.baseUrl + path, {
-            method,
-            headers: {
-                'content-type': 'application/json',
-                ...await this.options.headers?.() ?? {}
-            },
-            body: body !== undefined ? JSON.stringify(body) : undefined
-        });
-        if (!res.ok) throw await StorageClientError.from(res);
-        return await res.json();
-    }
+	if (!resumeKey || typeof localStorage === "undefined") return;
+	try {
+		localStorage.removeItem(`vela.storage.resume:${resumeKey}`);
+	} catch {}
 }
+var StorageClient = class {
+	options;
+	constructor(options) {
+		this.options = options;
+	}
+	async upload(file, opts = {}) {
+		const threshold = this.options.multipartThreshold ?? DEFAULT_MULTIPART_THRESHOLD;
+		return opts.multipart === true || opts.multipart !== false && file.size > threshold ? this.#multipartUpload(file, opts) : this.#simpleUpload(file, opts);
+	}
+	list(query = {}) {
+		const qs = new URLSearchParams();
+		for (const [k, v] of Object.entries(query)) if (v != null) qs.set(k, String(v));
+		return this.#json("GET", `/list?${qs.toString()}`);
+	}
+	delete(keys) {
+		return this.#json("POST", "/delete", { keys });
+	}
+	async downloadUrl(key) {
+		return (await this.#json("POST", "/sign-download", { key })).url;
+	}
+	async #simpleUpload(file, opts) {
+		const key = opts.key ?? fileName(file);
+		const { upload } = await this.#json("POST", "/sign-upload", {
+			key,
+			contentType: opts.contentType ?? (file.type || void 0),
+			size: file.size,
+			metadata: opts.metadata
+		});
+		if (upload.method === "PUT") await xhrSend({
+			method: "PUT",
+			url: upload.url,
+			body: file,
+			headers: {
+				"content-type": file.type || "application/octet-stream",
+				...upload.headers
+			},
+			signal: opts.signal,
+			onProgress: opts.onProgress
+		});
+		else {
+			const form = new FormData();
+			for (const [k, v] of Object.entries(upload.fields)) form.append(k, v);
+			form.append("file", file);
+			await xhrSend({
+				method: "POST",
+				url: upload.url,
+				body: form,
+				signal: opts.signal,
+				onProgress: opts.onProgress
+			});
+		}
+		return {
+			key,
+			size: file.size,
+			contentType: opts.contentType ?? (file.type || "application/octet-stream")
+		};
+	}
+	async #multipartUpload(file, opts) {
+		const key = opts.key ?? fileName(file);
+		const fingerprint = `${fileName(file)}:${file.size}`;
+		const concurrency = typeof opts.multipart === "object" && opts.multipart.concurrency || DEFAULT_CONCURRENCY;
+		let session = loadSession(opts.resumeKey, fingerprint);
+		if (!session) {
+			const created = await this.#json("POST", "/multipart/create", {
+				key,
+				contentType: opts.contentType ?? (file.type || void 0),
+				metadata: opts.metadata,
+				partSize: typeof opts.multipart === "object" ? opts.multipart.partSize : void 0
+			});
+			session = {
+				key: created.key,
+				uploadId: created.uploadId,
+				partSize: created.partSize,
+				uploaded: {}
+			};
+		}
+		const partSize = session.partSize;
+		const count = Math.ceil(file.size / partSize) || 1;
+		const loaded = new Array(count + 1).fill(0);
+		for (const n of Object.keys(session.uploaded)) loaded[Number(n)] = partBytes(Number(n), partSize, file.size);
+		const report = () => opts.onProgress?.({
+			loaded: loaded.reduce((a, b) => a + b, 0),
+			total: file.size
+		});
+		await pool(Array.from({ length: count }, (_, i) => i + 1).filter((n) => !session.uploaded[n]), concurrency, async (n) => {
+			const blob = file.slice((n - 1) * partSize, Math.min(n * partSize, file.size));
+			const signed = await this.#json("POST", "/multipart/sign-part", {
+				key: session.key,
+				uploadId: session.uploadId,
+				partNumber: n
+			});
+			const res = await xhrSend({
+				method: "PUT",
+				url: signed.url,
+				body: blob,
+				headers: signed.headers,
+				signal: opts.signal,
+				onProgress: (p) => {
+					loaded[n] = p.loaded;
+					report();
+				}
+			});
+			const etag = res.getHeader("ETag") ?? res.getHeader("etag");
+			if (!etag) throw new StorageClientError("invalid_request", "missing ETag on part upload (check bucket CORS ExposeHeaders: ETag)", res.status);
+			session.uploaded[n] = etag;
+			saveSession(opts.resumeKey, fingerprint, session);
+		});
+		const parts = Object.entries(session.uploaded).map(([n, etag]) => ({
+			partNumber: Number(n),
+			etag
+		})).sort((a, b) => a.partNumber - b.partNumber);
+		const result = await this.#json("POST", "/multipart/complete", {
+			key: session.key,
+			uploadId: session.uploadId,
+			parts
+		});
+		clearSession(opts.resumeKey);
+		return result;
+	}
+	async #json(method, path, body) {
+		const res = await (this.options.fetch ?? fetch)(this.options.baseUrl + path, {
+			method,
+			headers: {
+				"content-type": "application/json",
+				...await this.options.headers?.() ?? {}
+			},
+			body: body !== void 0 ? JSON.stringify(body) : void 0
+		});
+		if (!res.ok) throw await StorageClientError.from(res);
+		return await res.json();
+	}
+};
 function fileName(file) {
-    return 'name' in file && typeof file.name === 'string' && file.name ? file.name : 'upload.bin';
+	return "name" in file && typeof file.name === "string" && file.name ? file.name : "upload.bin";
 }
 function partBytes(partNumber, partSize, total) {
-    const start = (partNumber - 1) * partSize;
-    return Math.max(0, Math.min(partSize, total - start));
+	const start = (partNumber - 1) * partSize;
+	return Math.max(0, Math.min(partSize, total - start));
 }
+//#endregion
+export { StorageClient, StorageClientError };
+
+//# sourceMappingURL=index.js.map