@ttt-productions/upload-core 0.7.4 → 0.7.5

package/dist/storage/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/storage/upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAMrF,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,cAAc,EAEpB,MAAM,kBAAkB,CAAC;AAM1B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,gBAAgB,CA4JnB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG;IAC7D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;;;;;;OASG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GACA,OAAO,CAAC,yBAAyB,CAAC,CAwBpC"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/storage/upload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAMrF,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,cAAc,EAEpB,MAAM,kBAAkB,CAAC;AAU1B,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,eAAe,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,UAAU,CAAC,EAAE,uBAAuB,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GAAG,gBAAgB,CAqKnB;AAED,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG;IAC7D,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ;;;;;;;;;OASG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC,GACA,OAAO,CAAC,yBAAyB,CAAC,CAwBpC"}

package/dist/storage/upload.js

@@ -2,10 +2,13 @@ import { getFileSize } from "../utils/file-size.js";
 import { upsertUploadSession } from "../utils/upload-store.js";
 import { NEUTRAL_CONTENT_TYPE } from "@ttt-productions/media-schemas";
 import { UploadError, isValidMediaContentType } from "./upload-error.js";
-import { getDownloadURL, ref, uploadBytesResumable, } from "firebase/storage";
+import { ref, uploadBytesResumable, } from "firebase/storage";
 function isAbortError(e) {
     return e instanceof DOMException && e.name === "AbortError";
 }
+function isStorageCanceledError(e) {
+    return typeof e === "object" && e !== null && e.code === "storage/canceled";
+}
 export function startResumableUpload(args) {
     const { id, storage, path, file, metadata, onProgress, signal } = args;
     const r = ref(storage, path);
@@ -28,11 +31,23 @@ export function startResumableUpload(args) {
         resolveDone = res;
         rejectDone = rej;
     });
-    const onAbort = () => {
+    // The Storage SDK rejects a cancelled task with its own `storage/canceled` error.
+    // When this upload asked for the cancel (its signal aborted, or its controller's
+    // cancel() ran), that rejection becomes the canonical AbortError every consumer
+    // already treats as a user cancel; a `storage/canceled` nobody here asked for
+    // stays a real failure.
+    let canceledLocally = false;
+    const cancelTask = () => {
+        canceledLocally = true;
         try {
-            task.cancel();
+            return task.cancel();
+        }
+        catch {
+            return false;
         }
-        catch { }
+    };
+    const onAbort = () => {
+        cancelTask();
     };
     if (signal) {
         if (signal.aborted)
@@ -62,16 +77,20 @@ export function startResumableUpload(args) {
             signal.removeEventListener("abort", onAbort);
         if (unsub)
             unsub();
-        // normalize aborts as "canceled" (not "error")
-        if (isAbortError(err)) {
+        const cancelError = isAbortError(err)
+            ? err
+            : canceledLocally && isStorageCanceledError(err)
+                ? new DOMException("Aborted", "AbortError")
+                : null;
+        if (cancelError) {
             upsertUploadSession({
                 id,
                 status: "canceled",
                 path,
                 updatedAt: Date.now(),
-                error: err,
+                error: cancelError,
             });
-            return rejectDone(err);
+            return rejectDone(cancelError);
         }
         upsertUploadSession({
             id,
@@ -83,11 +102,9 @@ export function startResumableUpload(args) {
         rejectDone(err);
     }, async () => {
         try {
-            const downloadURL = await getDownloadURL(task.snapshot.ref);
             const contentType = task.snapshot.metadata?.contentType ?? null;
             const size = task.snapshot.totalBytes ?? getFileSize(file);
             const result = {
-                downloadURL,
                 fullPath: task.snapshot.ref.fullPath,
                 contentType,
                 size,
@@ -140,14 +157,7 @@ export function startResumableUpload(args) {
                 return false;
             }
         },
-        cancel: () => {
-            try {
-                return task.cancel();
-            }
-            catch {
-                return false;
-            }
-        },
+        cancel: cancelTask,
         done,
     };
 }

package/dist/storage/upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/storage/upload.ts"],"names":[],"mappings":"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","sourcesContent":["import type { UploadFileResumableResult } from \"../types.js\";\nimport type { UploadFileResumableArgs, UploadController } from \"../browser/types.js\";\nimport { getFileSize } from \"../utils/file-size.js\";\nimport { upsertUploadSession } from \"../utils/upload-store.js\";\nimport { NEUTRAL_CONTENT_TYPE } from \"@ttt-productions/media-schemas\";\nimport { UploadError, isValidMediaContentType } from \"./upload-error.js\";\n\nimport {\n  getDownloadURL,\n  ref,\n  uploadBytesResumable,\n  type FirebaseStorage,\n  type UploadMetadata,\n  type UploadTaskSnapshot,\n} from \"firebase/storage\";\n\nfunction isAbortError(e: unknown) {\n  return e instanceof DOMException && e.name === \"AbortError\";\n}\n\nexport function startResumableUpload(args: {\n  id: string;\n  storage: FirebaseStorage;\n  path: string;\n  file: Blob;\n  metadata?: UploadMetadata;\n  onProgress?: UploadFileResumableArgs[\"onProgress\"];\n  signal?: AbortSignal;\n}): UploadController {\n  const { id, storage, path, file, metadata, onProgress, signal } = args;\n\n  const r = ref(storage, path);\n  const task = uploadBytesResumable(r, file, metadata);\n\n  const startedAt = Date.now();\n\n  upsertUploadSession({\n    id,\n    status: \"uploading\",\n    path,\n    transferred: 0,\n    total: getFileSize(file),\n    percent: 0,\n    startedAt,\n    updatedAt: startedAt,\n  });\n\n  let unsub: (() => void) | null = null;\n\n  let resolveDone!: (v: UploadFileResumableResult) => void;\n  let rejectDone!: (e: unknown) => void;\n  const done = new Promise<UploadFileResumableResult>((res, rej) => {\n    resolveDone = res;\n    rejectDone = rej;\n  });\n\n  const onAbort = () => {\n    try {\n      task.cancel();\n    } catch {}\n  };\n\n  if (signal) {\n    if (signal.aborted) onAbort();\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n  }\n\n  unsub = task.on(\n    \"state_changed\",\n    (snap: UploadTaskSnapshot) => {\n      const transferred = snap.bytesTransferred ?? 0;\n      const total = snap.totalBytes ?? getFileSize(file);\n      const percent = total > 0 ? (transferred / total) * 100 : 0;\n\n      upsertUploadSession({\n        id,\n        status:\n          snap.state === \"paused\"\n            ? \"paused\"\n            : snap.state === \"running\"\n            ? \"uploading\"\n            : \"uploading\",\n        path,\n        transferred,\n        total,\n        percent,\n        updatedAt: Date.now(),\n      });\n\n      onProgress?.({ transferred, total, percent, snapshot: snap });\n    },\n    async (err) => {\n      if (signal) signal.removeEventListener(\"abort\", onAbort);\n      if (unsub) unsub();\n\n      // normalize aborts as \"canceled\" (not \"error\")\n      if (isAbortError(err)) {\n        upsertUploadSession({\n          id,\n          status: \"canceled\",\n          path,\n          updatedAt: Date.now(),\n          error: err,\n        });\n        return rejectDone(err);\n      }\n\n      upsertUploadSession({\n        id,\n        status: \"error\",\n        path,\n        updatedAt: Date.now(),\n        error: err,\n      });\n\n      rejectDone(err);\n    },\n    async () => {\n      try {\n        const downloadURL = await getDownloadURL(task.snapshot.ref);\n        const contentType = task.snapshot.metadata?.contentType ?? null;\n        const size = task.snapshot.totalBytes ?? getFileSize(file);\n\n        const result: UploadFileResumableResult = {\n          downloadURL,\n          fullPath: task.snapshot.ref.fullPath,\n          contentType,\n          size,\n        };\n\n        upsertUploadSession({\n          id,\n          status: \"success\",\n          path,\n          transferred: size,\n          total: size,\n          percent: 100,\n          updatedAt: Date.now(),\n          result,\n        });\n\n        resolveDone(result);\n      } catch (e) {\n        upsertUploadSession({\n          id,\n          status: \"error\",\n          path,\n          updatedAt: Date.now(),\n          error: e,\n        });\n        rejectDone(e);\n      } finally {\n        if (signal) signal.removeEventListener(\"abort\", onAbort);\n        if (unsub) unsub();\n      }\n    }\n  );\n\n  return {\n    id,\n    task,\n    pause: () => {\n      try {\n        return task.pause();\n      } catch {\n        return false;\n      }\n    },\n    resume: () => {\n      try {\n        return task.resume();\n      } catch {\n        return false;\n      }\n    },\n    cancel: () => {\n      try {\n        return task.cancel();\n      } catch {\n        return false;\n      }\n    },\n    done,\n  };\n}\n\nexport async function uploadFileResumable(\n  args: Omit<Parameters<typeof startResumableUpload>[0], \"id\"> & {\n    id?: string;\n    /**\n     * EXPLICIT opt-in for the NEUTRAL content type (canonical-upload-content-\n     * classification, 2026-07-31): a picker file with unknown browser metadata\n     * must reach the server AS unknown (`application/octet-stream`) so the\n     * server-side byte inspector — the only classification authority — sees it\n     * unrewritten. Default false preserves the historical media-only gate for\n     * every other consumer. A concrete media MIME is still validated either\n     * way; this flag never permits arbitrary declared types, only the one\n     * neutral value.\n     */\n    allowNeutralContentType?: boolean;\n  }\n): Promise<UploadFileResumableResult> {\n  // Defense-in-depth: reject missing or invalid contentType before any bytes are sent.\n  // file-input should already guarantee a valid or explicitly-neutral MIME, but this\n  // is the last gate before Firebase Storage.\n  const ct = args.metadata?.contentType;\n  if (!ct) {\n    throw new UploadError(\n      'missing_content_type',\n      'Upload rejected: contentType metadata is required. Ensure file.type is set before uploading.'\n    );\n  }\n  const neutralAllowed =\n    args.allowNeutralContentType === true && ct.toLowerCase().trim() === NEUTRAL_CONTENT_TYPE;\n  if (!neutralAllowed && !isValidMediaContentType(ct)) {\n    throw new UploadError(\n      'invalid_content_type',\n      `Upload rejected: contentType \"${ct}\" is not a supported media MIME (expected image/*, video/*, or audio/*).`\n    );\n  }\n\n  const { allowNeutralContentType: _allowNeutral, ...rest } = args;\n  const id = args.id ?? `upl_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;\n  const c = startResumableUpload({ ...rest, id });\n  return c.done;\n}\n"]}
+{"version":3,"file":"upload.js","sourceRoot":"","sources":["../../src/storage/upload.ts"],"names":[],"mappings":"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","sourcesContent":["import type { UploadFileResumableResult } from \"../types.js\";\nimport type { UploadFileResumableArgs, UploadController } from \"../browser/types.js\";\nimport { getFileSize } from \"../utils/file-size.js\";\nimport { upsertUploadSession } from \"../utils/upload-store.js\";\nimport { NEUTRAL_CONTENT_TYPE } from \"@ttt-productions/media-schemas\";\nimport { UploadError, isValidMediaContentType } from \"./upload-error.js\";\n\nimport {\n  ref,\n  uploadBytesResumable,\n  type FirebaseStorage,\n  type UploadMetadata,\n  type UploadTaskSnapshot,\n} from \"firebase/storage\";\n\nfunction isAbortError(e: unknown) {\n  return e instanceof DOMException && e.name === \"AbortError\";\n}\n\nfunction isStorageCanceledError(e: unknown) {\n  return typeof e === \"object\" && e !== null && (e as { code?: unknown }).code === \"storage/canceled\";\n}\n\nexport function startResumableUpload(args: {\n  id: string;\n  storage: FirebaseStorage;\n  path: string;\n  file: Blob;\n  metadata?: UploadMetadata;\n  onProgress?: UploadFileResumableArgs[\"onProgress\"];\n  signal?: AbortSignal;\n}): UploadController {\n  const { id, storage, path, file, metadata, onProgress, signal } = args;\n\n  const r = ref(storage, path);\n  const task = uploadBytesResumable(r, file, metadata);\n\n  const startedAt = Date.now();\n\n  upsertUploadSession({\n    id,\n    status: \"uploading\",\n    path,\n    transferred: 0,\n    total: getFileSize(file),\n    percent: 0,\n    startedAt,\n    updatedAt: startedAt,\n  });\n\n  let unsub: (() => void) | null = null;\n\n  let resolveDone!: (v: UploadFileResumableResult) => void;\n  let rejectDone!: (e: unknown) => void;\n  const done = new Promise<UploadFileResumableResult>((res, rej) => {\n    resolveDone = res;\n    rejectDone = rej;\n  });\n\n  // The Storage SDK rejects a cancelled task with its own `storage/canceled` error.\n  // When this upload asked for the cancel (its signal aborted, or its controller's\n  // cancel() ran), that rejection becomes the canonical AbortError every consumer\n  // already treats as a user cancel; a `storage/canceled` nobody here asked for\n  // stays a real failure.\n  let canceledLocally = false;\n  const cancelTask = () => {\n    canceledLocally = true;\n    try {\n      return task.cancel();\n    } catch {\n      return false;\n    }\n  };\n\n  const onAbort = () => {\n    cancelTask();\n  };\n\n  if (signal) {\n    if (signal.aborted) onAbort();\n    signal.addEventListener(\"abort\", onAbort, { once: true });\n  }\n\n  unsub = task.on(\n    \"state_changed\",\n    (snap: UploadTaskSnapshot) => {\n      const transferred = snap.bytesTransferred ?? 0;\n      const total = snap.totalBytes ?? getFileSize(file);\n      const percent = total > 0 ? (transferred / total) * 100 : 0;\n\n      upsertUploadSession({\n        id,\n        status:\n          snap.state === \"paused\"\n            ? \"paused\"\n            : snap.state === \"running\"\n            ? \"uploading\"\n            : \"uploading\",\n        path,\n        transferred,\n        total,\n        percent,\n        updatedAt: Date.now(),\n      });\n\n      onProgress?.({ transferred, total, percent, snapshot: snap });\n    },\n    async (err) => {\n      if (signal) signal.removeEventListener(\"abort\", onAbort);\n      if (unsub) unsub();\n\n      const cancelError = isAbortError(err)\n        ? err\n        : canceledLocally && isStorageCanceledError(err)\n        ? new DOMException(\"Aborted\", \"AbortError\")\n        : null;\n      if (cancelError) {\n        upsertUploadSession({\n          id,\n          status: \"canceled\",\n          path,\n          updatedAt: Date.now(),\n          error: cancelError,\n        });\n        return rejectDone(cancelError);\n      }\n\n      upsertUploadSession({\n        id,\n        status: \"error\",\n        path,\n        updatedAt: Date.now(),\n        error: err,\n      });\n\n      rejectDone(err);\n    },\n    async () => {\n      try {\n        const contentType = task.snapshot.metadata?.contentType ?? null;\n        const size = task.snapshot.totalBytes ?? getFileSize(file);\n\n        const result: UploadFileResumableResult = {\n          fullPath: task.snapshot.ref.fullPath,\n          contentType,\n          size,\n        };\n\n        upsertUploadSession({\n          id,\n          status: \"success\",\n          path,\n          transferred: size,\n          total: size,\n          percent: 100,\n          updatedAt: Date.now(),\n          result,\n        });\n\n        resolveDone(result);\n      } catch (e) {\n        upsertUploadSession({\n          id,\n          status: \"error\",\n          path,\n          updatedAt: Date.now(),\n          error: e,\n        });\n        rejectDone(e);\n      } finally {\n        if (signal) signal.removeEventListener(\"abort\", onAbort);\n        if (unsub) unsub();\n      }\n    }\n  );\n\n  return {\n    id,\n    task,\n    pause: () => {\n      try {\n        return task.pause();\n      } catch {\n        return false;\n      }\n    },\n    resume: () => {\n      try {\n        return task.resume();\n      } catch {\n        return false;\n      }\n    },\n    cancel: cancelTask,\n    done,\n  };\n}\n\nexport async function uploadFileResumable(\n  args: Omit<Parameters<typeof startResumableUpload>[0], \"id\"> & {\n    id?: string;\n    /**\n     * EXPLICIT opt-in for the NEUTRAL content type (canonical-upload-content-\n     * classification, 2026-07-31): a picker file with unknown browser metadata\n     * must reach the server AS unknown (`application/octet-stream`) so the\n     * server-side byte inspector — the only classification authority — sees it\n     * unrewritten. Default false preserves the historical media-only gate for\n     * every other consumer. A concrete media MIME is still validated either\n     * way; this flag never permits arbitrary declared types, only the one\n     * neutral value.\n     */\n    allowNeutralContentType?: boolean;\n  }\n): Promise<UploadFileResumableResult> {\n  // Defense-in-depth: reject missing or invalid contentType before any bytes are sent.\n  // file-input should already guarantee a valid or explicitly-neutral MIME, but this\n  // is the last gate before Firebase Storage.\n  const ct = args.metadata?.contentType;\n  if (!ct) {\n    throw new UploadError(\n      'missing_content_type',\n      'Upload rejected: contentType metadata is required. Ensure file.type is set before uploading.'\n    );\n  }\n  const neutralAllowed =\n    args.allowNeutralContentType === true && ct.toLowerCase().trim() === NEUTRAL_CONTENT_TYPE;\n  if (!neutralAllowed && !isValidMediaContentType(ct)) {\n    throw new UploadError(\n      'invalid_content_type',\n      `Upload rejected: contentType \"${ct}\" is not a supported media MIME (expected image/*, video/*, or audio/*).`\n    );\n  }\n\n  const { allowNeutralContentType: _allowNeutral, ...rest } = args;\n  const id = args.id ?? `upl_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;\n  const c = startResumableUpload({ ...rest, id });\n  return c.done;\n}\n"]}

package/dist/types.d.ts

@@ -1,5 +1,8 @@
+/**
+ * What a finished upload reports: where the bytes landed, their stored content type, and
+ * their size. No download URL is minted — a staged upload is read only by the backend.
+ */
 export interface UploadFileResumableResult {
-    downloadURL: string;
     fullPath: string;
     contentType: string | null;
     size: number;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,+BAA+B;IAC9C,+CAA+C;IAC/C,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;IAC5C,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,kBAAkB,GAAG,IAAI,CAAC;IACpF,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,CAAC,EAAE,+BAA+B,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,SAAS,GACT,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,+BAA+B;IAC9C,+CAA+C;IAC/C,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC;IAC5C,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,GAAG,kBAAkB,GAAG,IAAI,CAAC;IACpF,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrE,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9C;AAED,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,WAAW,CAAC,EAAE,+BAA+B,CAAC;CAC/C;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,mBAAmB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAEhB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAElB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC;AAED,MAAM,WAAW,wBAAwB;IACvC,6BAA6B;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["export interface UploadFileResumableResult {\n  downloadURL: string;\n  fullPath: string;\n  contentType: string | null;\n  size: number;\n}\n\nexport type UploadSessionStatus =\n  | \"idle\"\n  | \"queued\"\n  | \"uploading\"\n  | \"paused\"\n  | \"success\"\n  | \"error\"\n  | \"canceled\";\n\nexport interface UploadSessionPersistenceAdapter {\n  /** Return all session ids currently stored. */\n  listIds: () => Promise<string[]> | string[];\n  get: (id: string) => Promise<UploadSessionState | null> | UploadSessionState | null;\n  set: (id: string, state: UploadSessionState) => Promise<void> | void;\n  remove: (id: string) => Promise<void> | void;\n}\n\nexport interface UploadQueueOptions {\n  /** Maximum concurrent uploads. Default: 3 */\n  concurrency?: number;\n  /** Optional persistence adapter for session state. */\n  persistence?: UploadSessionPersistenceAdapter;\n}\n\nexport interface UploadSessionState {\n  id: string;\n  status: UploadSessionStatus;\n  path: string;\n\n  /** Monotonic version counter for state updates. */\n  version: number;\n\n  transferred: number;\n  total: number;\n  percent: number; // 0..100\n\n  startedAt: number;\n  updatedAt: number;\n\n  error?: unknown;\n  result?: UploadFileResumableResult;\n}\n\nexport interface DisposeUploadSessionArgs {\n  /** Session id to dispose. */\n  id: string;\n  /** If true, cancel any active upload task before disposal. Default true. */\n  cancel?: boolean;\n  /** If true, remove session state from the in-memory store. Default true. */\n  remove?: boolean;\n}\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["/**\n * What a finished upload reports: where the bytes landed, their stored content type, and\n * their size. No download URL is minted — a staged upload is read only by the backend.\n */\nexport interface UploadFileResumableResult {\n  fullPath: string;\n  contentType: string | null;\n  size: number;\n}\n\nexport type UploadSessionStatus =\n  | \"idle\"\n  | \"queued\"\n  | \"uploading\"\n  | \"paused\"\n  | \"success\"\n  | \"error\"\n  | \"canceled\";\n\nexport interface UploadSessionPersistenceAdapter {\n  /** Return all session ids currently stored. */\n  listIds: () => Promise<string[]> | string[];\n  get: (id: string) => Promise<UploadSessionState | null> | UploadSessionState | null;\n  set: (id: string, state: UploadSessionState) => Promise<void> | void;\n  remove: (id: string) => Promise<void> | void;\n}\n\nexport interface UploadQueueOptions {\n  /** Maximum concurrent uploads. Default: 3 */\n  concurrency?: number;\n  /** Optional persistence adapter for session state. */\n  persistence?: UploadSessionPersistenceAdapter;\n}\n\nexport interface UploadSessionState {\n  id: string;\n  status: UploadSessionStatus;\n  path: string;\n\n  /** Monotonic version counter for state updates. */\n  version: number;\n\n  transferred: number;\n  total: number;\n  percent: number; // 0..100\n\n  startedAt: number;\n  updatedAt: number;\n\n  error?: unknown;\n  result?: UploadFileResumableResult;\n}\n\nexport interface DisposeUploadSessionArgs {\n  /** Session id to dispose. */\n  id: string;\n  /** If true, cancel any active upload task before disposal. Default true. */\n  cancel?: boolean;\n  /** If true, remove session state from the in-memory store. Default true. */\n  remove?: boolean;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/upload-core",
-  "version": "0.7.4",
+  "version": "0.7.5",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -32,7 +32,7 @@
   },
   "dependencies": {
     "@ttt-productions/firebase-helpers": "^0.12.9",
-    "@ttt-productions/media-schemas": "^0.14.6"
+    "@ttt-productions/media-schemas": "^0.14.8"
   },
   "peerDependencies": {
     "firebase": ">=12.0.0"
@@ -42,9 +42,6 @@
       "optional": true
     }
   },
-  "devDependencies": {
-    "typescript": "^5.8.3"
-  },
   "author": "DJ (TTT Productions)",
   "license": "MIT"
 }