firebase-storage-kit 0.0.1

package/README.md

@@ -0,0 +1,63 @@
+# firebase-storage-kit
+
+If you've built a file picker on top of Firebase Storage, you've probably wired the same things again: progress updates, error handling, cancellation, and some limit on parallel uploads when someone selects a whole folder. This library is a thin layer for that, a single upload manager with progress updates and batched uploads with configurable concurrency.
+
+## Install
+
+```bash
+npm install firebase-storage-kit
+```
+
+## Quick start
+
+```ts
+import { getStorage } from "firebase/storage";
+import { UploadManager } from "firebase-storage-kit";
+import { FirebaseStorageProvider } from "firebase-storage-kit/firebase";
+
+const storage = getStorage(app);
+const manager = new UploadManager(new FirebaseStorageProvider(storage));
+
+const handle = manager.uploadFile(file, { path: `uploads/${file.name}` });
+
+handle.on("progress", (upload) => {
+  console.log(upload.progress);
+});
+
+handle.on("success", (upload) => {
+  console.log(upload.downloadURL);
+});
+```
+
+### Batch uploads
+
+```ts
+const batch = manager.uploadFiles(
+  files,
+  (file) => ({ path: `uploads/${file.name}` }),
+  { concurrency: 3, continueOnError: true },
+);
+
+batch.on("success", (snapshot) => {
+  console.log(snapshot.completedCount, snapshot.failedCount);
+});
+```
+
+### Subscriptions (manager state)
+
+```ts
+const unsubscribe = manager.subscribe((state) => {
+  console.log(state.uploads, state.batches);
+});
+```
+
+## Entry points
+
+| Import                          | Use                                                   |
+| ------------------------------- | ----------------------------------------------------- |
+| `firebase-storage-kit`          | `UploadManager`, `UploadHandle`, `BatchHandle`, types |
+| `firebase-storage-kit/firebase` | `FirebaseStorageProvider`                             |
+
+## License
+
+MIT

package/dist/firebase.d.ts

@@ -0,0 +1,10 @@
+import { FirebaseStorage } from 'firebase/storage';
+import { S as StorageProvider, U as UploadOptions, P as ProviderUploadCallbacks, a as ProviderUploadTask } from './provider-xU7lonvB.js';
+
+declare class FirebaseStorageProvider implements StorageProvider {
+    private storage;
+    constructor(storage: FirebaseStorage);
+    upload(file: File, options: UploadOptions, callbacks: ProviderUploadCallbacks): ProviderUploadTask;
+}
+
+export { FirebaseStorageProvider };

package/dist/firebase.js

@@ -0,0 +1,48 @@
+import { ref, uploadBytesResumable, getDownloadURL } from 'firebase/storage';
+
+// src/providers/firebase-provider.ts
+var FirebaseStorageProvider = class {
+  constructor(storage) {
+    this.storage = storage;
+  }
+  storage;
+  upload(file, options, callbacks) {
+    const storageRef = ref(this.storage, options.path);
+    const task = uploadBytesResumable(storageRef, file);
+    task.on(
+      "state_changed",
+      (snapshot) => {
+        callbacks.onProgress(
+          snapshot.bytesTransferred,
+          snapshot.totalBytes
+        );
+      },
+      (error) => {
+        callbacks.onError(error);
+      },
+      async () => {
+        try {
+          const downloadURL = await getDownloadURL(storageRef);
+          callbacks.onSuccess(downloadURL);
+        } catch (error) {
+          callbacks.onError(error);
+        }
+      }
+    );
+    return {
+      cancel: () => {
+        task.cancel();
+      },
+      pause: () => {
+        task.pause();
+      },
+      resume: () => {
+        task.resume();
+      }
+    };
+  }
+};
+
+export { FirebaseStorageProvider };
+//# sourceMappingURL=firebase.js.map
+//# sourceMappingURL=firebase.js.map

package/dist/firebase.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/providers/firebase-provider.ts"],"names":[],"mappings":";;;AAcO,IAAM,0BAAN,MAAyD;AAAA,EAC9D,YAAoB,OAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AAAA,EAA2B;AAAA,EAA3B,OAAA;AAAA,EAEpB,MAAA,CACE,IAAA,EAEA,OAAA,EAEA,SAAA,EACoB;AACpB,IAAA,MAAM,UAAA,GAAa,GAAA,CAAI,IAAA,CAAK,OAAA,EAAS,QAAQ,IAAI,CAAA;AAEjD,IAAA,MAAM,IAAA,GAAO,oBAAA,CAAqB,UAAA,EAAY,IAAI,CAAA;AAElD,IAAA,IAAA,CAAK,EAAA;AAAA,MACH,eAAA;AAAA,MAEA,CAAC,QAAA,KAAa;AACZ,QAAA,SAAA,CAAU,UAAA;AAAA,UACR,QAAA,CAAS,gBAAA;AAAA,UAET,QAAA,CAAS;AAAA,SACX;AAAA,MACF,CAAA;AAAA,MAEA,CAAC,KAAA,KAAU;AACT,QAAA,SAAA,CAAU,QAAQ,KAAK,CAAA;AAAA,MACzB,CAAA;AAAA,MAEA,YAAY;AACV,QAAA,IAAI;AACF,UAAA,MAAM,WAAA,GAAc,MAAM,cAAA,CAAe,UAAU,CAAA;AAEnD,UAAA,SAAA,CAAU,UAAU,WAAW,CAAA;AAAA,QACjC,SAAS,KAAA,EAAO;AACd,UAAA,SAAA,CAAU,QAAQ,KAAc,CAAA;AAAA,QAClC;AAAA,MACF;AAAA,KACF;AAEA,IAAA,OAAO;AAAA,MACL,QAAQ,MAAM;AACZ,QAAA,IAAA,CAAK,MAAA,EAAO;AAAA,MACd,CAAA;AAAA,MAEA,OAAO,MAAM;AACX,QAAA,IAAA,CAAK,KAAA,EAAM;AAAA,MACb,CAAA;AAAA,MAEA,QAAQ,MAAM;AACZ,QAAA,IAAA,CAAK,MAAA,EAAO;AAAA,MACd;AAAA,KACF;AAAA,EACF;AACF","file":"firebase.js","sourcesContent":["import {\n  getDownloadURL,\n  ref,\n  uploadBytesResumable,\n  type FirebaseStorage,\n} from \"firebase/storage\";\n\nimport type { StorageProvider } from \"./provider\";\nimport type {\n  ProviderUploadCallbacks,\n  ProviderUploadTask,\n  UploadOptions,\n} from \"../types/provider\";\n\nexport class FirebaseStorageProvider implements StorageProvider {\n  constructor(private storage: FirebaseStorage) {}\n\n  upload(\n    file: File,\n\n    options: UploadOptions,\n\n    callbacks: ProviderUploadCallbacks,\n  ): ProviderUploadTask {\n    const storageRef = ref(this.storage, options.path);\n\n    const task = uploadBytesResumable(storageRef, file);\n\n    task.on(\n      \"state_changed\",\n\n      (snapshot) => {\n        callbacks.onProgress(\n          snapshot.bytesTransferred,\n\n          snapshot.totalBytes,\n        );\n      },\n\n      (error) => {\n        callbacks.onError(error);\n      },\n\n      async () => {\n        try {\n          const downloadURL = await getDownloadURL(storageRef);\n\n          callbacks.onSuccess(downloadURL);\n        } catch (error) {\n          callbacks.onError(error as Error);\n        }\n      },\n    );\n\n    return {\n      cancel: () => {\n        task.cancel();\n      },\n\n      pause: () => {\n        task.pause();\n      },\n\n      resume: () => {\n        task.resume();\n      },\n    };\n  }\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,129 @@
+import { S as StorageProvider, U as UploadOptions } from './provider-xU7lonvB.js';
+export { P as ProviderUploadCallbacks, a as ProviderUploadTask } from './provider-xU7lonvB.js';
+
+interface UploadState {
+    uploads: UploadItem[];
+    batches: UploadBatch[];
+}
+type UploadStatus = "queued" | "uploading" | "paused" | "success" | "error" | "canceled";
+interface UploadItem {
+    id: string;
+    file: File;
+    progress: number;
+    bytesTransferred: number;
+    totalBytes: number;
+    status: UploadStatus;
+    downloadURL?: string;
+    error?: Error;
+    batchId?: string;
+}
+interface UploadBatch {
+    id: string;
+    uploads: UploadItem[];
+    totalProgress: number;
+    completedCount: number;
+    failedCount: number;
+}
+
+type Listener<TPayload> = (payload: TPayload) => void;
+declare class Emitter<TEvents extends Record<string, unknown>> {
+    private listeners;
+    on<K extends keyof TEvents>(event: K, listener: Listener<TEvents[K]>): () => void;
+    protected emit<K extends keyof TEvents>(event: K, payload: TEvents[K]): void;
+}
+
+type UploadHandleEvents = {
+    progress: UploadItem;
+    success: UploadItem;
+    error: UploadItem;
+    canceled: UploadItem;
+    statusChange: UploadItem;
+};
+declare class UploadHandle extends Emitter<UploadHandleEvents> {
+    readonly upload: UploadItem;
+    private task;
+    private onChange;
+    private terminated;
+    constructor(upload: UploadItem, onChange: () => void);
+    cancel(): void;
+    pause(): void;
+    resume(): void;
+}
+
+type BatchHandleEvents = {
+    progress: UploadBatch;
+    uploadSuccess: UploadItem;
+    uploadError: UploadItem;
+    success: UploadBatch;
+    error: UploadBatch;
+    change: UploadBatch;
+};
+interface BatchOptions {
+    /** Maximum number of uploads in-flight at the same time. Defaults to 3. */
+    concurrency?: number;
+    /**
+     * When true (default), a failing upload does not affect siblings; the batch
+     * still emits `success` once all children have settled and callers inspect
+     * individual `UploadItem` errors.
+     *
+     * When false, the first failure cancels all queued and in-flight siblings
+     * and the batch emits `error`.
+     */
+    continueOnError?: boolean;
+}
+interface BatchHandleInit {
+    id: string;
+    uploads: UploadHandle[];
+    options: BatchOptions;
+    startNext: (handle: UploadHandle) => void;
+    onChange: () => void;
+}
+declare class BatchHandle extends Emitter<BatchHandleEvents> {
+    readonly id: string;
+    readonly uploads: UploadHandle[];
+    private concurrency;
+    private continueOnError;
+    private startNext;
+    private onChange;
+    private running;
+    private nextIdx;
+    private settledCount;
+    private succeededCount;
+    private failedCount;
+    private failedFast;
+    private canceled;
+    private paused;
+    private terminalEmitted;
+    private readonly uploadsView;
+    private aggregateBytesTransferred;
+    private aggregateTotalBytes;
+    private readonly lastBytes;
+    private readonly lastTotal;
+    constructor(init: BatchHandleInit);
+    cancel(): void;
+    pause(): void;
+    resume(): void;
+    snapshot(): UploadBatch;
+    private updateAggregate;
+    private fillSlots;
+    private handleChildProgress;
+    private handleChildSettled;
+}
+
+declare class UploadManager {
+    private provider;
+    private uploadHandles;
+    private batches;
+    private changeListeners;
+    private cachedState;
+    constructor(provider: StorageProvider);
+    getState: () => UploadState;
+    subscribe: (listener: (state: UploadState) => void) => (() => void);
+    uploadFile(file: File, options: UploadOptions): UploadHandle;
+    uploadFiles(files: File[], optionsFor: (file: File, index: number) => UploadOptions, batchOptions?: BatchOptions): BatchHandle;
+    private createHandle;
+    private startUpload;
+    private notifyChange;
+}
+
+export { BatchHandle, type BatchHandleEvents, type BatchHandleInit, type BatchOptions, type UploadBatch, UploadHandle, type UploadHandleEvents, type UploadItem, UploadManager, UploadOptions, type UploadState, type UploadStatus };

package/dist/index.js

@@ -0,0 +1,347 @@
+// src/core/emitter.ts
+var Emitter = class {
+  listeners = /* @__PURE__ */ new Map();
+  on(event, listener) {
+    if (!this.listeners.has(event)) {
+      this.listeners.set(event, /* @__PURE__ */ new Set());
+    }
+    this.listeners.get(event)?.add(listener);
+    return () => {
+      this.listeners.get(event)?.delete(listener);
+    };
+  }
+  emit(event, payload) {
+    const listeners = this.listeners.get(event);
+    if (!listeners) {
+      return;
+    }
+    for (const listener of listeners) {
+      listener(payload);
+    }
+  }
+};
+
+// src/core/batch-handle.ts
+var BatchHandle = class extends Emitter {
+  id;
+  uploads;
+  concurrency;
+  continueOnError;
+  startNext;
+  onChange;
+  running = 0;
+  nextIdx = 0;
+  settledCount = 0;
+  succeededCount = 0;
+  failedCount = 0;
+  failedFast = false;
+  canceled = false;
+  paused = false;
+  terminalEmitted = false;
+  // Stable view of UploadItems; the items themselves mutate in place, but the
+  // array reference never changes, so we allocate it once instead of rebuilding
+  // it on every snapshot.
+  uploadsView;
+  // Running aggregates updated incrementally on each child event so snapshot()
+  // is O(1) instead of O(n) per progress tick.
+  aggregateBytesTransferred = 0;
+  aggregateTotalBytes = 0;
+  lastBytes;
+  lastTotal;
+  constructor(init) {
+    super();
+    this.id = init.id;
+    this.uploads = init.uploads;
+    this.concurrency = Math.max(1, init.options.concurrency ?? 3);
+    this.continueOnError = init.options.continueOnError ?? true;
+    this.startNext = init.startNext;
+    this.onChange = init.onChange;
+    this.uploadsView = init.uploads.map((h) => h.upload);
+    this.lastBytes = new Array(init.uploads.length).fill(0);
+    this.lastTotal = new Array(init.uploads.length).fill(0);
+    for (let i = 0; i < this.uploadsView.length; i++) {
+      const u = this.uploadsView[i];
+      this.lastBytes[i] = u.bytesTransferred;
+      this.lastTotal[i] = u.totalBytes;
+      this.aggregateBytesTransferred += u.bytesTransferred;
+      this.aggregateTotalBytes += u.totalBytes;
+    }
+    this.uploads.forEach((child, idx) => {
+      child.on("progress", (u) => this.handleChildProgress(idx, u));
+      child.on("success", (u) => this.handleChildSettled(idx, u, "success"));
+      child.on("error", (u) => this.handleChildSettled(idx, u, "error"));
+      child.on("canceled", (u) => this.handleChildSettled(idx, u, "canceled"));
+    });
+  }
+  /** @internal */
+  _start() {
+    this.fillSlots();
+  }
+  cancel() {
+    if (this.canceled || this.terminalEmitted) return;
+    this.canceled = true;
+    for (const h of this.uploads) {
+      const s = h.upload.status;
+      if (s === "queued" || s === "uploading" || s === "paused") {
+        h.cancel();
+      }
+    }
+    this.onChange();
+  }
+  pause() {
+    if (this.paused || this.canceled || this.terminalEmitted) return;
+    this.paused = true;
+    for (const h of this.uploads) {
+      if (h.upload.status === "uploading") h.pause();
+    }
+    this.onChange();
+  }
+  resume() {
+    if (!this.paused || this.canceled || this.terminalEmitted) return;
+    this.paused = false;
+    for (const h of this.uploads) {
+      if (h.upload.status === "paused") h.resume();
+    }
+    this.fillSlots();
+    this.onChange();
+  }
+  snapshot() {
+    const totalProgress = this.aggregateTotalBytes > 0 ? this.aggregateBytesTransferred / this.aggregateTotalBytes * 100 : 0;
+    return {
+      id: this.id,
+      uploads: this.uploadsView,
+      totalProgress,
+      completedCount: this.succeededCount,
+      failedCount: this.failedCount
+    };
+  }
+  updateAggregate(idx, u) {
+    const prevBytes = this.lastBytes[idx] ?? 0;
+    const prevTotal = this.lastTotal[idx] ?? 0;
+    this.aggregateBytesTransferred += u.bytesTransferred - prevBytes;
+    this.aggregateTotalBytes += u.totalBytes - prevTotal;
+    this.lastBytes[idx] = u.bytesTransferred;
+    this.lastTotal[idx] = u.totalBytes;
+  }
+  fillSlots() {
+    while (!this.canceled && !this.paused && !this.failedFast && this.running < this.concurrency && this.nextIdx < this.uploads.length) {
+      const handle = this.uploads[this.nextIdx++];
+      if (!handle) continue;
+      this.running++;
+      this.startNext(handle);
+    }
+  }
+  handleChildProgress(idx, upload) {
+    this.updateAggregate(idx, upload);
+    const snap = this.snapshot();
+    this.emit("progress", snap);
+    this.emit("change", snap);
+  }
+  handleChildSettled(idx, upload, kind) {
+    this.updateAggregate(idx, upload);
+    this.running = Math.max(0, this.running - 1);
+    this.settledCount++;
+    if (kind === "success") {
+      this.succeededCount++;
+      this.emit("uploadSuccess", upload);
+    } else if (kind === "error") {
+      this.failedCount++;
+      this.emit("uploadError", upload);
+    }
+    const snap = this.snapshot();
+    this.emit("change", snap);
+    if (kind === "error" && !this.continueOnError && !this.failedFast && !this.canceled) {
+      this.failedFast = true;
+      for (const h of this.uploads) {
+        if (h.upload.id === upload.id) continue;
+        const s = h.upload.status;
+        if (s === "queued" || s === "uploading" || s === "paused") {
+          h.cancel();
+        }
+      }
+      this.terminalEmitted = true;
+      this.emit("error", snap);
+      this.onChange();
+      return;
+    }
+    if (this.failedFast || this.canceled) {
+      this.onChange();
+      return;
+    }
+    this.fillSlots();
+    if (this.settledCount >= this.uploads.length && !this.terminalEmitted) {
+      this.terminalEmitted = true;
+      this.emit("success", snap);
+    }
+    this.onChange();
+  }
+};
+
+// src/core/upload-handle.ts
+var UploadHandle = class extends Emitter {
+  upload;
+  task = null;
+  onChange;
+  terminated = false;
+  constructor(upload, onChange) {
+    super();
+    this.upload = upload;
+    this.onChange = onChange;
+  }
+  /** @internal */
+  _attachTask(task) {
+    this.task = task;
+  }
+  /** @internal */
+  _setStatus(status) {
+    if (this.upload.status === status) return;
+    this.upload.status = status;
+    this.emit("statusChange", this.upload);
+  }
+  /** @internal */
+  _reportProgress(bytesTransferred, totalBytes) {
+    if (this.terminated) return;
+    this.upload.bytesTransferred = bytesTransferred;
+    this.upload.totalBytes = totalBytes;
+    this.upload.progress = totalBytes > 0 ? bytesTransferred / totalBytes * 100 : 0;
+    if (this.upload.status !== "uploading") {
+      this._setStatus("uploading");
+    }
+    this.emit("progress", this.upload);
+    this.onChange();
+  }
+  /** @internal */
+  _reportSuccess(downloadURL) {
+    if (this.terminated) return;
+    this.terminated = true;
+    this.upload.downloadURL = downloadURL;
+    this.upload.progress = 100;
+    this._setStatus("success");
+    this.emit("success", this.upload);
+    this.onChange();
+  }
+  /** @internal */
+  _reportError(error) {
+    if (this.terminated) return;
+    this.terminated = true;
+    this.upload.error = error;
+    this._setStatus("error");
+    this.emit("error", this.upload);
+    this.onChange();
+  }
+  cancel() {
+    if (this.terminated) return;
+    this.terminated = true;
+    this.task?.cancel();
+    this._setStatus("canceled");
+    this.emit("canceled", this.upload);
+    this.onChange();
+  }
+  pause() {
+    if (this.terminated) return;
+    if (this.upload.status !== "uploading") return;
+    this.task?.pause?.();
+    this._setStatus("paused");
+    this.onChange();
+  }
+  resume() {
+    if (this.terminated) return;
+    if (this.upload.status !== "paused") return;
+    this.task?.resume?.();
+    this._setStatus("uploading");
+    this.onChange();
+  }
+};
+
+// src/core/upload-manager.ts
+var UploadManager = class {
+  provider;
+  uploadHandles = [];
+  batches = [];
+  changeListeners = /* @__PURE__ */ new Set();
+  cachedState = null;
+  constructor(provider) {
+    this.provider = provider;
+  }
+  getState = () => {
+    if (this.cachedState === null) {
+      this.cachedState = {
+        uploads: this.uploadHandles.map((h) => h.upload),
+        batches: this.batches.map((b) => b.snapshot())
+      };
+    }
+    return this.cachedState;
+  };
+  subscribe = (listener) => {
+    this.changeListeners.add(listener);
+    return () => {
+      this.changeListeners.delete(listener);
+    };
+  };
+  uploadFile(file, options) {
+    const handle = this.createHandle(file);
+    this.uploadHandles.push(handle);
+    this.notifyChange();
+    this.startUpload(handle, options);
+    return handle;
+  }
+  uploadFiles(files, optionsFor, batchOptions = {}) {
+    const id = crypto.randomUUID();
+    const handles = files.map((file) => this.createHandle(file, id));
+    const optionsByUploadId = /* @__PURE__ */ new Map();
+    handles.forEach((h, i) => {
+      const file = files[i];
+      if (!file) return;
+      optionsByUploadId.set(h.upload.id, optionsFor(file, i));
+    });
+    this.uploadHandles.push(...handles);
+    const batch = new BatchHandle({
+      id,
+      uploads: handles,
+      options: batchOptions,
+      startNext: (handle) => {
+        const opts = optionsByUploadId.get(handle.upload.id);
+        if (!opts) return;
+        this.startUpload(handle, opts);
+      },
+      onChange: () => this.notifyChange()
+    });
+    this.batches.push(batch);
+    this.notifyChange();
+    batch._start();
+    return batch;
+  }
+  createHandle(file, batchId) {
+    const upload = {
+      id: crypto.randomUUID(),
+      file,
+      progress: 0,
+      bytesTransferred: 0,
+      totalBytes: file.size,
+      status: "queued",
+      ...batchId !== void 0 ? { batchId } : {}
+    };
+    return new UploadHandle(upload, () => this.notifyChange());
+  }
+  startUpload(handle, options) {
+    handle._setStatus("uploading");
+    const task = this.provider.upload(handle.upload.file, options, {
+      onProgress: (bytesTransferred, totalBytes) => handle._reportProgress(bytesTransferred, totalBytes),
+      onError: (error) => handle._reportError(error),
+      onSuccess: (downloadURL) => handle._reportSuccess(downloadURL)
+    });
+    handle._attachTask(task);
+    this.notifyChange();
+  }
+  notifyChange() {
+    this.cachedState = null;
+    const state = this.getState();
+    for (const listener of this.changeListeners) {
+      listener(state);
+    }
+  }
+};
+
+export { BatchHandle, UploadHandle, UploadManager };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/emitter.ts","../src/core/batch-handle.ts","../src/core/upload-handle.ts","../src/core/upload-manager.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["type Listener<TPayload> = (payload: TPayload) => void;\n\nexport class Emitter<TEvents extends Record<string, unknown>> {\n  private listeners = new Map<keyof TEvents, Set<Listener<any>>>();\n\n  on<K extends keyof TEvents>(event: K, listener: Listener<TEvents[K]>) {\n    if (!this.listeners.has(event)) {\n      this.listeners.set(event, new Set());\n    }\n\n    this.listeners.get(event)?.add(listener);\n\n    return () => {\n      this.listeners.get(event)?.delete(listener);\n    };\n  }\n\n  protected emit<K extends keyof TEvents>(event: K, payload: TEvents[K]) {\n    const listeners = this.listeners.get(event);\n\n    if (!listeners) {\n      return;\n    }\n\n    for (const listener of listeners) {\n      listener(payload);\n    }\n  }\n}\n","import type { UploadBatch, UploadItem } from \"../types/upload\";\nimport { Emitter } from \"./emitter\";\nimport type { UploadHandle } from \"./upload-handle\";\n\nexport type BatchHandleEvents = {\n  progress: UploadBatch;\n  uploadSuccess: UploadItem;\n  uploadError: UploadItem;\n  success: UploadBatch;\n  error: UploadBatch;\n  change: UploadBatch;\n};\n\nexport interface BatchOptions {\n  /** Maximum number of uploads in-flight at the same time. Defaults to 3. */\n  concurrency?: number;\n  /**\n   * When true (default), a failing upload does not affect siblings; the batch\n   * still emits `success` once all children have settled and callers inspect\n   * individual `UploadItem` errors.\n   *\n   * When false, the first failure cancels all queued and in-flight siblings\n   * and the batch emits `error`.\n   */\n  continueOnError?: boolean;\n}\n\nexport interface BatchHandleInit {\n  id: string;\n  uploads: UploadHandle[];\n  options: BatchOptions;\n  startNext: (handle: UploadHandle) => void;\n  onChange: () => void;\n}\n\nexport class BatchHandle extends Emitter<BatchHandleEvents> {\n  public readonly id: string;\n  public readonly uploads: UploadHandle[];\n\n  private concurrency: number;\n  private continueOnError: boolean;\n  private startNext: (handle: UploadHandle) => void;\n  private onChange: () => void;\n\n  private running = 0;\n  private nextIdx = 0;\n  private settledCount = 0;\n  private succeededCount = 0;\n  private failedCount = 0;\n  private failedFast = false;\n  private canceled = false;\n  private paused = false;\n  private terminalEmitted = false;\n\n  // Stable view of UploadItems; the items themselves mutate in place, but the\n  // array reference never changes, so we allocate it once instead of rebuilding\n  // it on every snapshot.\n  private readonly uploadsView: UploadItem[];\n\n  // Running aggregates updated incrementally on each child event so snapshot()\n  // is O(1) instead of O(n) per progress tick.\n  private aggregateBytesTransferred = 0;\n  private aggregateTotalBytes = 0;\n  private readonly lastBytes: number[];\n  private readonly lastTotal: number[];\n\n  constructor(init: BatchHandleInit) {\n    super();\n    this.id = init.id;\n    this.uploads = init.uploads;\n    this.concurrency = Math.max(1, init.options.concurrency ?? 3);\n    this.continueOnError = init.options.continueOnError ?? true;\n    this.startNext = init.startNext;\n    this.onChange = init.onChange;\n\n    this.uploadsView = init.uploads.map((h) => h.upload);\n    this.lastBytes = new Array(init.uploads.length).fill(0);\n    this.lastTotal = new Array(init.uploads.length).fill(0);\n    for (let i = 0; i < this.uploadsView.length; i++) {\n      const u = this.uploadsView[i]!;\n      this.lastBytes[i] = u.bytesTransferred;\n      this.lastTotal[i] = u.totalBytes;\n      this.aggregateBytesTransferred += u.bytesTransferred;\n      this.aggregateTotalBytes += u.totalBytes;\n    }\n\n    this.uploads.forEach((child, idx) => {\n      child.on(\"progress\", (u) => this.handleChildProgress(idx, u));\n      child.on(\"success\", (u) => this.handleChildSettled(idx, u, \"success\"));\n      child.on(\"error\", (u) => this.handleChildSettled(idx, u, \"error\"));\n      child.on(\"canceled\", (u) => this.handleChildSettled(idx, u, \"canceled\"));\n    });\n  }\n\n  /** @internal */\n  _start(): void {\n    this.fillSlots();\n  }\n\n  cancel(): void {\n    if (this.canceled || this.terminalEmitted) return;\n    this.canceled = true;\n    for (const h of this.uploads) {\n      const s = h.upload.status;\n      if (s === \"queued\" || s === \"uploading\" || s === \"paused\") {\n        h.cancel();\n      }\n    }\n    this.onChange();\n  }\n\n  pause(): void {\n    if (this.paused || this.canceled || this.terminalEmitted) return;\n    this.paused = true;\n    for (const h of this.uploads) {\n      if (h.upload.status === \"uploading\") h.pause();\n    }\n    this.onChange();\n  }\n\n  resume(): void {\n    if (!this.paused || this.canceled || this.terminalEmitted) return;\n    this.paused = false;\n    for (const h of this.uploads) {\n      if (h.upload.status === \"paused\") h.resume();\n    }\n    this.fillSlots();\n    this.onChange();\n  }\n\n  snapshot(): UploadBatch {\n    const totalProgress =\n      this.aggregateTotalBytes > 0\n        ? (this.aggregateBytesTransferred / this.aggregateTotalBytes) * 100\n        : 0;\n    return {\n      id: this.id,\n      uploads: this.uploadsView,\n      totalProgress,\n      completedCount: this.succeededCount,\n      failedCount: this.failedCount,\n    };\n  }\n\n  private updateAggregate(idx: number, u: UploadItem): void {\n    const prevBytes = this.lastBytes[idx] ?? 0;\n    const prevTotal = this.lastTotal[idx] ?? 0;\n    this.aggregateBytesTransferred += u.bytesTransferred - prevBytes;\n    this.aggregateTotalBytes += u.totalBytes - prevTotal;\n    this.lastBytes[idx] = u.bytesTransferred;\n    this.lastTotal[idx] = u.totalBytes;\n  }\n\n  private fillSlots(): void {\n    while (\n      !this.canceled &&\n      !this.paused &&\n      !this.failedFast &&\n      this.running < this.concurrency &&\n      this.nextIdx < this.uploads.length\n    ) {\n      const handle = this.uploads[this.nextIdx++];\n      if (!handle) continue;\n      this.running++;\n      this.startNext(handle);\n    }\n  }\n\n  private handleChildProgress(idx: number, upload: UploadItem): void {\n    this.updateAggregate(idx, upload);\n    const snap = this.snapshot();\n    this.emit(\"progress\", snap);\n    this.emit(\"change\", snap);\n  }\n\n  private handleChildSettled(\n    idx: number,\n    upload: UploadItem,\n    kind: \"success\" | \"error\" | \"canceled\",\n  ): void {\n    this.updateAggregate(idx, upload);\n    this.running = Math.max(0, this.running - 1);\n    this.settledCount++;\n\n    if (kind === \"success\") {\n      this.succeededCount++;\n      this.emit(\"uploadSuccess\", upload);\n    } else if (kind === \"error\") {\n      this.failedCount++;\n      this.emit(\"uploadError\", upload);\n    }\n\n    const snap = this.snapshot();\n    this.emit(\"change\", snap);\n\n    if (\n      kind === \"error\" &&\n      !this.continueOnError &&\n      !this.failedFast &&\n      !this.canceled\n    ) {\n      this.failedFast = true;\n      for (const h of this.uploads) {\n        if (h.upload.id === upload.id) continue;\n        const s = h.upload.status;\n        if (s === \"queued\" || s === \"uploading\" || s === \"paused\") {\n          h.cancel();\n        }\n      }\n      this.terminalEmitted = true;\n      this.emit(\"error\", snap);\n      this.onChange();\n      return;\n    }\n\n    if (this.failedFast || this.canceled) {\n      // we call this because a task can canceled as seen above\n      // by h.cancel(). Which then triggers the handelchildSettled call above.\n      this.onChange();\n      return;\n    }\n\n    this.fillSlots();\n\n    if (this.settledCount >= this.uploads.length && !this.terminalEmitted) {\n      this.terminalEmitted = true;\n      this.emit(\"success\", snap);\n    }\n\n    this.onChange();\n  }\n}\n","import { Emitter } from \"./emitter\";\n\nimport type { ProviderUploadTask } from \"../types/provider\";\nimport type { UploadItem, UploadStatus } from \"../types/upload\";\n\nexport type UploadHandleEvents = {\n  progress: UploadItem;\n  success: UploadItem;\n  error: UploadItem;\n  canceled: UploadItem;\n  statusChange: UploadItem;\n};\n\nexport class UploadHandle extends Emitter<UploadHandleEvents> {\n  public readonly upload: UploadItem;\n\n  private task: ProviderUploadTask | null = null;\n  private onChange: () => void;\n  private terminated = false;\n\n  constructor(upload: UploadItem, onChange: () => void) {\n    super();\n    this.upload = upload;\n    this.onChange = onChange;\n  }\n\n  /** @internal */\n  _attachTask(task: ProviderUploadTask): void {\n    this.task = task;\n  }\n\n  /** @internal */\n  _setStatus(status: UploadStatus): void {\n    if (this.upload.status === status) return;\n    this.upload.status = status;\n    this.emit(\"statusChange\", this.upload);\n  }\n\n  /** @internal */\n  _reportProgress(bytesTransferred: number, totalBytes: number): void {\n    if (this.terminated) return;\n    this.upload.bytesTransferred = bytesTransferred;\n    this.upload.totalBytes = totalBytes;\n    this.upload.progress =\n      totalBytes > 0 ? (bytesTransferred / totalBytes) * 100 : 0;\n    if (this.upload.status !== \"uploading\") {\n      this._setStatus(\"uploading\");\n    }\n    this.emit(\"progress\", this.upload);\n    this.onChange();\n  }\n\n  /** @internal */\n  _reportSuccess(downloadURL: string): void {\n    if (this.terminated) return;\n    this.terminated = true;\n    this.upload.downloadURL = downloadURL;\n    this.upload.progress = 100;\n    this._setStatus(\"success\");\n    this.emit(\"success\", this.upload);\n    this.onChange();\n  }\n\n  /** @internal */\n  _reportError(error: Error): void {\n    if (this.terminated) return;\n    this.terminated = true;\n    this.upload.error = error;\n    this._setStatus(\"error\");\n    this.emit(\"error\", this.upload);\n    this.onChange();\n  }\n\n  cancel(): void {\n    if (this.terminated) return;\n    this.terminated = true;\n    this.task?.cancel();\n    this._setStatus(\"canceled\");\n    this.emit(\"canceled\", this.upload);\n    this.onChange();\n  }\n\n  pause(): void {\n    if (this.terminated) return;\n    if (this.upload.status !== \"uploading\") return;\n    this.task?.pause?.();\n    this._setStatus(\"paused\");\n    this.onChange();\n  }\n\n  resume(): void {\n    if (this.terminated) return;\n    if (this.upload.status !== \"paused\") return;\n    this.task?.resume?.();\n    this._setStatus(\"uploading\");\n    this.onChange();\n  }\n}\n","import { BatchHandle, type BatchOptions } from \"./batch-handle\";\nimport { UploadHandle } from \"./upload-handle\";\n\nimport type { StorageProvider } from \"../providers/provider\";\nimport type { UploadOptions } from \"../types/provider\";\nimport type { UploadItem, UploadState } from \"../types/upload\";\n\nexport class UploadManager {\n  private provider: StorageProvider;\n  private uploadHandles: UploadHandle[] = [];\n  private batches: BatchHandle[] = [];\n  private changeListeners = new Set<(state: UploadState) => void>();\n  private cachedState: UploadState | null = null;\n\n  constructor(provider: StorageProvider) {\n    this.provider = provider;\n  }\n\n  getState = (): UploadState => {\n    if (this.cachedState === null) {\n      this.cachedState = {\n        uploads: this.uploadHandles.map((h) => h.upload),\n        batches: this.batches.map((b) => b.snapshot()),\n      };\n    }\n    return this.cachedState;\n  };\n\n  subscribe = (listener: (state: UploadState) => void): (() => void) => {\n    this.changeListeners.add(listener);\n    return () => {\n      this.changeListeners.delete(listener);\n    };\n  };\n\n  uploadFile(file: File, options: UploadOptions): UploadHandle {\n    const handle = this.createHandle(file);\n    this.uploadHandles.push(handle);\n    this.notifyChange();\n    this.startUpload(handle, options);\n    return handle;\n  }\n\n  uploadFiles(\n    files: File[],\n    optionsFor: (file: File, index: number) => UploadOptions,\n    batchOptions: BatchOptions = {},\n  ): BatchHandle {\n    const id = crypto.randomUUID();\n    const handles = files.map((file) => this.createHandle(file, id));\n    const optionsByUploadId = new Map<string, UploadOptions>();\n    handles.forEach((h, i) => {\n      const file = files[i];\n      if (!file) return;\n      optionsByUploadId.set(h.upload.id, optionsFor(file, i));\n    });\n\n    this.uploadHandles.push(...handles);\n\n    const batch = new BatchHandle({\n      id,\n      uploads: handles,\n      options: batchOptions,\n      startNext: (handle) => {\n        const opts = optionsByUploadId.get(handle.upload.id);\n        if (!opts) return;\n        this.startUpload(handle, opts);\n      },\n      onChange: () => this.notifyChange(),\n    });\n\n    this.batches.push(batch);\n    this.notifyChange();\n    batch._start();\n    return batch;\n  }\n\n  private createHandle(file: File, batchId?: string): UploadHandle {\n    const upload: UploadItem = {\n      id: crypto.randomUUID(),\n      file,\n      progress: 0,\n      bytesTransferred: 0,\n      totalBytes: file.size,\n      status: \"queued\",\n      ...(batchId !== undefined ? { batchId } : {}),\n    };\n    return new UploadHandle(upload, () => this.notifyChange());\n  }\n\n  private startUpload(handle: UploadHandle, options: UploadOptions): void {\n    handle._setStatus(\"uploading\");\n    const task = this.provider.upload(handle.upload.file, options, {\n      onProgress: (bytesTransferred, totalBytes) =>\n        handle._reportProgress(bytesTransferred, totalBytes),\n      onError: (error) => handle._reportError(error),\n      onSuccess: (downloadURL) => handle._reportSuccess(downloadURL),\n    });\n    handle._attachTask(task);\n    this.notifyChange();\n  }\n\n  private notifyChange(): void {\n    this.cachedState = null;\n    const state = this.getState();\n    for (const listener of this.changeListeners) {\n      listener(state);\n    }\n  }\n}\n"]}

package/dist/provider-xU7lonvB.d.ts

@@ -0,0 +1,19 @@
+interface ProviderUploadTask {
+    cancel(): void;
+    pause?(): void;
+    resume?(): void;
+}
+interface ProviderUploadCallbacks {
+    onProgress: (bytesTransferred: number, totalBytes: number) => void;
+    onError: (error: Error) => void;
+    onSuccess: (downloadURL: string) => void;
+}
+interface UploadOptions {
+    path: string;
+}
+
+interface StorageProvider {
+    upload(file: File, options: UploadOptions, callbacks: ProviderUploadCallbacks): ProviderUploadTask;
+}
+
+export type { ProviderUploadCallbacks as P, StorageProvider as S, UploadOptions as U, ProviderUploadTask as a };

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "firebase-storage-kit",
+  "version": "0.0.1",
+  "description": "Browser upload manager for Firebase Storage with batches, concurrency, and pause/resume.",
+  "keywords": [
+    "firebase",
+    "firebase-storage",
+    "upload",
+    "resumable",
+    "browser",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "marknesh (https://github.com/marknesh)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marknesh/firebase-storage-kit.git",
+    "directory": "packages/firebase-storage-kit"
+  },
+  "bugs": {
+    "url": "https://github.com/marknesh/firebase-storage-kit/issues"
+  },
+  "homepage": "https://github.com/marknesh/firebase-storage-kit/tree/main/packages/firebase-storage-kit#readme",
+  "type": "module",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./firebase": {
+      "types": "./dist/firebase.d.ts",
+      "import": "./dist/firebase.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "firebase": "^12.13.0"
+  },
+  "peerDependenciesMeta": {
+    "firebase": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "firebase": "^12.13.0"
+  }
+}