firebase-storage-kit 0.0.3 → 1.0.0

package/README.md

@@ -1,6 +1,6 @@
 # firebase-storage-kit
 
-Upload manager for Firebase Storage with progress, cancellation, batch uploads, and configurable concurrency.
+Storage manager for Firebase Storage with uploads, progress tracking, batch uploads, and file query helpers.
 
 ## Install
 
@@ -22,11 +22,11 @@ bun add firebase-storage-kit
 
 ```ts
 import { getStorage } from "firebase/storage";
-import { UploadManager } from "firebase-storage-kit";
+import { StorageManager } from "firebase-storage-kit";
 import { FirebaseStorageProvider } from "firebase-storage-kit/firebase";
 
 const storage = getStorage(app);
-const manager = new UploadManager(new FirebaseStorageProvider(storage));
+const manager = new StorageManager(new FirebaseStorageProvider(storage));
 
 const handle = manager.uploadFile(file, { path: `uploads/${file.name}` });
 
@@ -61,6 +61,22 @@ const unsubscribe = manager.subscribe((state) => {
 });
 ```
 
+### Querying files
+
+```ts
+const exists = await manager.exists("uploads/photo.jpg");
+
+if (exists) {
+  const meta = await manager.getMetadata("uploads/photo.jpg");
+  const url = await manager.getDownloadURL("uploads/photo.jpg");
+  console.log(meta.size, url);
+}
+
+await manager.delete("uploads/old.jpg");
+```
+
+`exists` returns `false` only when the object is not found. Permission and network errors are thrown.
+
 ## License
 
 MIT

package/dist/firebase.d.ts

@@ -1,10 +1,14 @@
 import { FirebaseStorage } from 'firebase/storage';
-import { S as StorageProvider, U as UploadOptions, P as ProviderUploadCallbacks, a as ProviderUploadTask } from './provider-DXcRr9uA.js';
+import { S as StorageProvider, U as UploadOptions, P as ProviderUploadCallbacks, a as ProviderUploadTask, F as FileMetadata } from './provider-B89iZO4q.js';
 
 declare class FirebaseStorageProvider implements StorageProvider {
     private storage;
     constructor(storage: FirebaseStorage);
     upload(file: File, options: UploadOptions, callbacks: ProviderUploadCallbacks): ProviderUploadTask;
+    exists(path: string): Promise<boolean>;
+    getMetadata(path: string): Promise<FileMetadata>;
+    getDownloadURL(path: string): Promise<string>;
+    delete(path: string): Promise<void>;
 }
 
 export { FirebaseStorageProvider };

package/dist/firebase.js

@@ -1,4 +1,4 @@
-import { ref, uploadBytesResumable, getDownloadURL } from 'firebase/storage';
+import { ref, uploadBytesResumable, getDownloadURL, getMetadata, deleteObject } from 'firebase/storage';
 
 // src/providers/firebase-provider.ts
 var FirebaseStorageProvider = class {
@@ -41,6 +41,34 @@ var FirebaseStorageProvider = class {
       }
     };
   }
+  async exists(path) {
+    try {
+      await getMetadata(ref(this.storage, path));
+      return true;
+    } catch (err) {
+      if (err.code === "storage/object-not-found") {
+        return false;
+      }
+      throw err;
+    }
+  }
+  async getMetadata(path) {
+    const meta = await getMetadata(ref(this.storage, path));
+    return {
+      path,
+      size: meta.size,
+      contentType: meta.contentType,
+      createdAt: new Date(meta.timeCreated),
+      updatedAt: new Date(meta.updated),
+      customMetadata: meta.customMetadata
+    };
+  }
+  getDownloadURL(path) {
+    return getDownloadURL(ref(this.storage, path));
+  }
+  async delete(path) {
+    await deleteObject(ref(this.storage, path));
+  }
 };
 
 export { FirebaseStorageProvider };

package/dist/firebase.js.map

@@ -1 +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 {\n  ProviderUploadCallbacks,\n  ProviderUploadTask,\n  UploadOptions,\n} from \"../types/provider\";\nimport type { StorageProvider } from \"./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"]}
+{"version":3,"sources":["../src/providers/firebase-provider.ts"],"names":[],"mappings":";;;AAkBO,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;AAAA,EAEA,MAAM,OAAO,IAAA,EAAgC;AAC3C,IAAA,IAAI;AACF,MAAA,MAAM,WAAA,CAAY,GAAA,CAAI,IAAA,CAAK,OAAA,EAAS,IAAI,CAAC,CAAA;AACzC,MAAA,OAAO,IAAA;AAAA,IACT,SAAS,GAAA,EAAK;AACZ,MAAA,IAAK,GAAA,CAAqB,SAAS,0BAAA,EAA4B;AAC7D,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,MAAM,GAAA;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAM,YAAY,IAAA,EAAqC;AACrD,IAAA,MAAM,OAAO,MAAM,WAAA,CAAY,IAAI,IAAA,CAAK,OAAA,EAAS,IAAI,CAAC,CAAA;AACtD,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,MAAM,IAAA,CAAK,IAAA;AAAA,MACX,aAAa,IAAA,CAAK,WAAA;AAAA,MAClB,SAAA,EAAW,IAAI,IAAA,CAAK,IAAA,CAAK,WAAW,CAAA;AAAA,MACpC,SAAA,EAAW,IAAI,IAAA,CAAK,IAAA,CAAK,OAAO,CAAA;AAAA,MAChC,gBAAgB,IAAA,CAAK;AAAA,KACvB;AAAA,EACF;AAAA,EAEA,eAAe,IAAA,EAA+B;AAC5C,IAAA,OAAO,cAAA,CAAe,GAAA,CAAI,IAAA,CAAK,OAAA,EAAS,IAAI,CAAC,CAAA;AAAA,EAC/C;AAAA,EAEA,MAAM,OAAO,IAAA,EAA6B;AACxC,IAAA,MAAM,YAAA,CAAa,GAAA,CAAI,IAAA,CAAK,OAAA,EAAS,IAAI,CAAC,CAAA;AAAA,EAC5C;AACF","file":"firebase.js","sourcesContent":["import {\n  deleteObject,\n  getDownloadURL,\n  getMetadata,\n  ref,\n  uploadBytesResumable,\n  type FirebaseStorage,\n  type StorageError,\n} from \"firebase/storage\";\n\nimport type {\n  ProviderUploadCallbacks,\n  ProviderUploadTask,\n  UploadOptions,\n} from \"../types/provider\";\nimport type { FileMetadata } from \"../types/metadata\";\nimport type { StorageProvider } from \"./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  async exists(path: string): Promise<boolean> {\n    try {\n      await getMetadata(ref(this.storage, path));\n      return true;\n    } catch (err) {\n      if ((err as StorageError).code === \"storage/object-not-found\") {\n        return false;\n      }\n      throw err;\n    }\n  }\n\n  async getMetadata(path: string): Promise<FileMetadata> {\n    const meta = await getMetadata(ref(this.storage, path));\n    return {\n      path,\n      size: meta.size,\n      contentType: meta.contentType,\n      createdAt: new Date(meta.timeCreated),\n      updatedAt: new Date(meta.updated),\n      customMetadata: meta.customMetadata,\n    };\n  }\n\n  getDownloadURL(path: string): Promise<string> {\n    return getDownloadURL(ref(this.storage, path));\n  }\n\n  async delete(path: string): Promise<void> {\n    await deleteObject(ref(this.storage, path));\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { S as StorageProvider, U as UploadOptions } from './provider-DXcRr9uA.js';
-export { P as ProviderUploadCallbacks, a as ProviderUploadTask } from './provider-DXcRr9uA.js';
+import { S as StorageProvider, F as FileMetadata, U as UploadOptions } from './provider-B89iZO4q.js';
+export { P as ProviderUploadCallbacks, a as ProviderUploadTask } from './provider-B89iZO4q.js';
 
-/** The current state of the upload manager. */
-interface UploadState {
+/** The current state of the storage manager. */
+interface StorageState {
     uploads: UploadItem[];
     batches: UploadBatch[];
 }
@@ -67,7 +67,7 @@ declare class UploadHandle extends Emitter<UploadHandleEvents> {
 }
 
 /**
- * Events on a batch from {@link UploadManager.uploadFiles}. `progress` / `change` carry a {@link UploadBatch} snapshot.
+ * Events on a batch from {@link StorageManager.uploadFiles}. `progress` / `change` carry a {@link UploadBatch} snapshot.
  * `uploadSuccess` and `uploadError` fire once per child. When all children are done: `success` (normal end) or `error` (only if `continueOnError` was `false` and one failed).
  */
 type BatchHandleEvents = {
@@ -78,7 +78,7 @@ type BatchHandleEvents = {
     error: UploadBatch;
     change: UploadBatch;
 };
-/** Settings for {@link UploadManager.uploadFiles} (third argument). */
+/** Settings for {@link StorageManager.uploadFiles} (third argument). */
 interface BatchOptions {
     /** How many files upload at the same time. Default is 3. */
     concurrency?: number;
@@ -97,7 +97,7 @@ interface BatchHandleInit {
     onChange: () => void;
 }
 /**
- * A group of files from {@link UploadManager.uploadFiles}. Use `.on(...)` like a single {@link UploadHandle}, plus `snapshot()` for totals.
+ * A group of files from {@link StorageManager.uploadFiles}. Use `.on(...)` like a single {@link UploadHandle}, plus `snapshot()` for totals.
  */
 declare class BatchHandle extends Emitter<BatchHandleEvents> {
     readonly id: string;
@@ -132,13 +132,13 @@ declare class BatchHandle extends Emitter<BatchHandleEvents> {
 }
 
 /**
- * Uploads files and tracks each upload or batch.
+ * Manages file uploads and storage queries.
  *
  * You can react in two ways: call `.on(...)` on each {@link UploadHandle} / {@link BatchHandle}, **or** call `subscribe` to get the same lists
- * that {@link UploadManager.getState} returns whenever anything changes (call the returned function to stop listening).
+ * that {@link StorageManager.getState} returns whenever anything changes (call the returned function to stop listening).
  *
  */
-declare class UploadManager {
+declare class StorageManager {
     private provider;
     private uploadHandles;
     private batches;
@@ -146,9 +146,17 @@ declare class UploadManager {
     private cachedState;
     constructor(provider: StorageProvider);
     /** Current `uploads` and `batches` state. */
-    getState: () => UploadState;
+    getState: () => StorageState;
     /** Runs `listener` after each change; returns a function — call it to unsubscribe. */
-    subscribe: (listener: (state: UploadState) => void) => (() => void);
+    subscribe: (listener: (state: StorageState) => void) => (() => void);
+    /** Returns `true` if the object exists. Returns `false` only for not-found; other errors are thrown. */
+    exists(path: string): Promise<boolean>;
+    /** Returns metadata for the object at `path`. Throws if the object does not exist. */
+    getMetadata(path: string): Promise<FileMetadata>;
+    /** Returns a download URL for the object at `path`. */
+    getDownloadURL(path: string): Promise<string>;
+    /** Deletes the object at `path`. */
+    delete(path: string): Promise<void>;
     /** Starts the file upload.`options.path` is the object path in storage (see {@link UploadOptions}).
      *
      * @returns An {@link UploadHandle} to control the upload: `pause`, `resume`, `cancel`, and listen for progress with `.on`.
@@ -170,4 +178,4 @@ declare class UploadManager {
     private notifyChange;
 }
 
-export { BatchHandle, type BatchHandleEvents, type BatchHandleInit, type BatchOptions, type UploadBatch, UploadHandle, type UploadHandleEvents, type UploadItem, UploadManager, UploadOptions, type UploadState, type UploadStatus };
+export { BatchHandle, type BatchHandleEvents, type BatchHandleInit, type BatchOptions, FileMetadata, StorageManager, type StorageState, type UploadBatch, UploadHandle, type UploadHandleEvents, type UploadItem, UploadOptions, type UploadStatus };

package/dist/index.js

@@ -262,8 +262,8 @@ var UploadHandle = class extends Emitter {
   }
 };
 
-// src/core/upload-manager.ts
-var UploadManager = class {
+// src/core/storage-manager.ts
+var StorageManager = class {
   provider;
   uploadHandles = [];
   batches = [];
@@ -289,6 +289,22 @@ var UploadManager = class {
       this.changeListeners.delete(listener);
     };
   };
+  /** Returns `true` if the object exists. Returns `false` only for not-found; other errors are thrown. */
+  exists(path) {
+    return this.provider.exists(path);
+  }
+  /** Returns metadata for the object at `path`. Throws if the object does not exist. */
+  getMetadata(path) {
+    return this.provider.getMetadata(path);
+  }
+  /** Returns a download URL for the object at `path`. */
+  getDownloadURL(path) {
+    return this.provider.getDownloadURL(path);
+  }
+  /** Deletes the object at `path`. */
+  delete(path) {
+    return this.provider.delete(path);
+  }
   /** Starts the file upload.`options.path` is the object path in storage (see {@link UploadOptions}).
    *
    * @returns An {@link UploadHandle} to control the upload: `pause`, `resume`, `cancel`, and listen for progress with `.on`.
@@ -367,6 +383,6 @@ var UploadManager = class {
   }
 };
 
-export { BatchHandle, UploadHandle, UploadManager };
+export { BatchHandle, StorageManager, UploadHandle };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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  /**\n   * @param event The event to listen for.\n   * @param listener The function to call when the event is emitted.\n   * @returns A function to unsubscribe from the event.\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  /**\n   * @param event The event to emit.\n   * @param payload The payload to emit.\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\n/**\n * Events on a batch from {@link UploadManager.uploadFiles}. `progress` / `change` carry a {@link UploadBatch} snapshot.\n * `uploadSuccess` and `uploadError` fire once per child. When all children are done: `success` (normal end) or `error` (only if `continueOnError` was `false` and one failed).\n */\nexport type BatchHandleEvents = {\n  progress: UploadBatch;\n  uploadSuccess: UploadItem;\n  uploadError: UploadItem;\n  success: UploadBatch;\n  error: UploadBatch;\n  change: UploadBatch;\n};\n\n/** Settings for {@link UploadManager.uploadFiles} (third argument). */\nexport interface BatchOptions {\n  /** How many files upload at the same time. Default is 3. */\n  concurrency?: number;\n  /**\n   * `true` (default): if one file fails, the others keep going. When every file has finished, the batch fires `success` — look at each upload for errors.\n   *\n   * `false`: the first failure stops the other files and the batch fires `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\n/**\n * A group of files from {@link UploadManager.uploadFiles}. Use `.on(...)` like a single {@link UploadHandle}, plus `snapshot()` for totals.\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\n/** Controls file upload and tracks its progress.\n *\n * @param upload The upload item to control.\n * @param onChange A function to call when the upload status changes.\n * @returns An {@link UploadHandle} to control the upload: `pause`, `resume`, `cancel`, and listen for progress with `.on`.\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\n/**\n * Uploads files and tracks each upload or batch.\n *\n * You can react in two ways: call `.on(...)` on each {@link UploadHandle} / {@link BatchHandle}, **or** call `subscribe` to get the same lists\n * that {@link UploadManager.getState} returns whenever anything changes (call the returned function to stop listening).\n *\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  /** Current `uploads` and `batches` state. */\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  /** Runs `listener` after each change; returns a function — call it to unsubscribe. */\n  subscribe = (listener: (state: UploadState) => void): (() => void) => {\n    this.changeListeners.add(listener);\n    return () => {\n      this.changeListeners.delete(listener);\n    };\n  };\n\n  /** Starts the file upload.`options.path` is the object path in storage (see {@link UploadOptions}).\n   *\n   * @returns An {@link UploadHandle} to control the upload: `pause`, `resume`, `cancel`, and listen for progress with `.on`.\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  /**\n   * Upload several files as one batch. The optional third argument sets how many run at once\n   * and what happens when one file fails — see {@link BatchOptions}.\n   *\n   * @remarks\n   * `optionsFor` picks storage options per file (same as `uploadFile`); index matches `files` order.\n   * If `continueOnError` is `false`, the first failure cancels the other files and the batch fires `error`.\n   * If it stays `true` (default), other files keep going; when every file has finished, the batch fires `success`.\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"]}
+{"version":3,"sources":["../src/core/emitter.ts","../src/core/batch-handle.ts","../src/core/upload-handle.ts","../src/core/storage-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  /**\n   * @param event The event to listen for.\n   * @param listener The function to call when the event is emitted.\n   * @returns A function to unsubscribe from the event.\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  /**\n   * @param event The event to emit.\n   * @param payload The payload to emit.\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\n/**\n * Events on a batch from {@link StorageManager.uploadFiles}. `progress` / `change` carry a {@link UploadBatch} snapshot.\n * `uploadSuccess` and `uploadError` fire once per child. When all children are done: `success` (normal end) or `error` (only if `continueOnError` was `false` and one failed).\n */\nexport type BatchHandleEvents = {\n  progress: UploadBatch;\n  uploadSuccess: UploadItem;\n  uploadError: UploadItem;\n  success: UploadBatch;\n  error: UploadBatch;\n  change: UploadBatch;\n};\n\n/** Settings for {@link StorageManager.uploadFiles} (third argument). */\nexport interface BatchOptions {\n  /** How many files upload at the same time. Default is 3. */\n  concurrency?: number;\n  /**\n   * `true` (default): if one file fails, the others keep going. When every file has finished, the batch fires `success` — look at each upload for errors.\n   *\n   * `false`: the first failure stops the other files and the batch fires `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\n/**\n * A group of files from {@link StorageManager.uploadFiles}. Use `.on(...)` like a single {@link UploadHandle}, plus `snapshot()` for totals.\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\n/** Controls file upload and tracks its progress.\n *\n * @param upload The upload item to control.\n * @param onChange A function to call when the upload status changes.\n * @returns An {@link UploadHandle} to control the upload: `pause`, `resume`, `cancel`, and listen for progress with `.on`.\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 { FileMetadata } from \"../types/metadata\";\nimport type { UploadOptions } from \"../types/provider\";\nimport type { StorageState, UploadItem } from \"../types/upload\";\n\n/**\n * Manages file uploads and storage queries.\n *\n * You can react in two ways: call `.on(...)` on each {@link UploadHandle} / {@link BatchHandle}, **or** call `subscribe` to get the same lists\n * that {@link StorageManager.getState} returns whenever anything changes (call the returned function to stop listening).\n *\n */\nexport class StorageManager {\n  private provider: StorageProvider;\n  private uploadHandles: UploadHandle[] = [];\n  private batches: BatchHandle[] = [];\n  private changeListeners = new Set<(state: StorageState) => void>();\n  private cachedState: StorageState | null = null;\n\n  constructor(provider: StorageProvider) {\n    this.provider = provider;\n  }\n\n  /** Current `uploads` and `batches` state. */\n  getState = (): StorageState => {\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  /** Runs `listener` after each change; returns a function — call it to unsubscribe. */\n  subscribe = (listener: (state: StorageState) => void): (() => void) => {\n    this.changeListeners.add(listener);\n    return () => {\n      this.changeListeners.delete(listener);\n    };\n  };\n\n  /** Returns `true` if the object exists. Returns `false` only for not-found; other errors are thrown. */\n  exists(path: string): Promise<boolean> {\n    return this.provider.exists(path);\n  }\n\n  /** Returns metadata for the object at `path`. Throws if the object does not exist. */\n  getMetadata(path: string): Promise<FileMetadata> {\n    return this.provider.getMetadata(path);\n  }\n\n  /** Returns a download URL for the object at `path`. */\n  getDownloadURL(path: string): Promise<string> {\n    return this.provider.getDownloadURL(path);\n  }\n\n  /** Deletes the object at `path`. */\n  delete(path: string): Promise<void> {\n    return this.provider.delete(path);\n  }\n\n  /** Starts the file upload.`options.path` is the object path in storage (see {@link UploadOptions}).\n   *\n   * @returns An {@link UploadHandle} to control the upload: `pause`, `resume`, `cancel`, and listen for progress with `.on`.\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  /**\n   * Upload several files as one batch. The optional third argument sets how many run at once\n   * and what happens when one file fails — see {@link BatchOptions}.\n   *\n   * @remarks\n   * `optionsFor` picks storage options per file (same as `uploadFile`); index matches `files` order.\n   * If `continueOnError` is `false`, the first failure cancels the other files and the batch fires `error`.\n   * If it stays `true` (default), other files keep going; when every file has finished, the batch fires `success`.\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-DXcRr9uA.d.ts → provider-B89iZO4q.d.ts}

@@ -13,8 +13,21 @@ interface UploadOptions {
     path: string;
 }
 
+interface FileMetadata {
+    path: string;
+    size: number;
+    contentType?: string;
+    createdAt: Date;
+    updatedAt: Date;
+    customMetadata?: Record<string, string>;
+}
+
 interface StorageProvider {
     upload(file: File, options: UploadOptions, callbacks: ProviderUploadCallbacks): ProviderUploadTask;
+    exists(path: string): Promise<boolean>;
+    getMetadata(path: string): Promise<FileMetadata>;
+    getDownloadURL(path: string): Promise<string>;
+    delete(path: string): Promise<void>;
 }
 
-export type { ProviderUploadCallbacks as P, StorageProvider as S, UploadOptions as U, ProviderUploadTask as a };
+export type { FileMetadata as F, ProviderUploadCallbacks as P, StorageProvider as S, UploadOptions as U, ProviderUploadTask as a };

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "firebase-storage-kit",
-  "version": "0.0.3",
-  "description": "Upload manager for Firebase Storage with progress, cancellation, batch uploads, and configurable concurrency.",
+  "version": "1.0.0",
+  "description": "Storage manager for Firebase Storage with uploads, progress tracking, batch uploads, and file query helpers.",
   "keywords": [
     "firebase",
     "firebase-storage",
+    "storage",
     "upload",
     "resumable",
     "browser",