@ttt-productions/media-processing-core 0.8.15 → 0.8.16

package/dist/server/download-token.d.ts

@@ -0,0 +1,14 @@
+/** The one method of a Storage object handle this module uses. */
+export interface DownloadTokenWritable {
+    setMetadata(update: {
+        metadata: Record<string, string | null>;
+    }): Promise<unknown>;
+}
+/** True when the object's stored metadata still carries a download token. */
+export declare function hasDownloadToken(objectMetadata: Readonly<Record<string, unknown>> | undefined): boolean;
+/**
+ * Remove the object's download token and nothing else: a null custom-metadata value deletes that
+ * one key, leaving every other entry. A no-op write when the object has none.
+ */
+export declare function removeDownloadToken(file: DownloadTokenWritable): Promise<void>;
+//# sourceMappingURL=download-token.d.ts.map

package/dist/server/download-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-token.d.ts","sourceRoot":"","sources":["../../src/server/download-token.ts"],"names":[],"mappings":"AAKA,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpF;AAKD,6EAA6E;AAC7E,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,GAAG,OAAO,CAGvG;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF"}

package/dist/server/download-token.js

@@ -0,0 +1,19 @@
+// The one remover of a Storage object's Firebase download token. The Firebase Storage client gives
+// every object it uploads a `firebaseStorageDownloadTokens` metadata entry: a never-expiring link
+// that reads the object signed out, around the Storage rules. An app that serves no object through
+// one removes it as soon as the server takes the object over.
+/** The custom-metadata key the Firebase Storage client writes on upload. */
+const DOWNLOAD_TOKENS_KEY = "firebaseStorageDownloadTokens";
+/** True when the object's stored metadata still carries a download token. */
+export function hasDownloadToken(objectMetadata) {
+    const custom = objectMetadata?.["metadata"];
+    return typeof custom === "object" && custom !== null && DOWNLOAD_TOKENS_KEY in custom;
+}
+/**
+ * Remove the object's download token and nothing else: a null custom-metadata value deletes that
+ * one key, leaving every other entry. A no-op write when the object has none.
+ */
+export async function removeDownloadToken(file) {
+    await file.setMetadata({ metadata: { [DOWNLOAD_TOKENS_KEY]: null } });
+}
+//# sourceMappingURL=download-token.js.map

package/dist/server/download-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-token.js","sourceRoot":"","sources":["../../src/server/download-token.ts"],"names":[],"mappings":"AAAA,mGAAmG;AACnG,kGAAkG;AAClG,mGAAmG;AACnG,8DAA8D;AAO9D,4EAA4E;AAC5E,MAAM,mBAAmB,GAAG,+BAA+B,CAAC;AAE5D,6EAA6E;AAC7E,MAAM,UAAU,gBAAgB,CAAC,cAA6D;IAC5F,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,mBAAmB,IAAI,MAAM,CAAC;AACxF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,IAA2B;IACnE,MAAM,IAAI,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;AACxE,CAAC","sourcesContent":["// The one remover of a Storage object's Firebase download token. The Firebase Storage client gives\n// every object it uploads a `firebaseStorageDownloadTokens` metadata entry: a never-expiring link\n// that reads the object signed out, around the Storage rules. An app that serves no object through\n// one removes it as soon as the server takes the object over.\n\n/** The one method of a Storage object handle this module uses. */\nexport interface DownloadTokenWritable {\n  setMetadata(update: { metadata: Record<string, string | null> }): Promise<unknown>;\n}\n\n/** The custom-metadata key the Firebase Storage client writes on upload. */\nconst DOWNLOAD_TOKENS_KEY = \"firebaseStorageDownloadTokens\";\n\n/** True when the object's stored metadata still carries a download token. */\nexport function hasDownloadToken(objectMetadata: Readonly<Record<string, unknown>> | undefined): boolean {\n  const custom = objectMetadata?.[\"metadata\"];\n  return typeof custom === \"object\" && custom !== null && DOWNLOAD_TOKENS_KEY in custom;\n}\n\n/**\n * Remove the object's download token and nothing else: a null custom-metadata value deletes that\n * one key, leaving every other entry. A no-op write when the object has none.\n */\nexport async function removeDownloadToken(file: DownloadTokenWritable): Promise<void> {\n  await file.setMetadata({ metadata: { [DOWNLOAD_TOKENS_KEY]: null } });\n}\n"]}

package/dist/server/index.d.ts

@@ -3,4 +3,5 @@ export * from "./firebase-media-io.js";
 export * from "./pending-media.js";
 export * from "./staged-object.js";
 export * from "./gcs-errors.js";
+export * from "./download-token.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC"}

package/dist/server/index.js

@@ -3,4 +3,5 @@ export * from "./firebase-media-io.js";
 export * from "./pending-media.js";
 export * from "./staged-object.js";
 export * from "./gcs-errors.js";
+export * from "./download-token.js";
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC","sourcesContent":["export * from \"./storage-ops.js\";\nexport * from \"./firebase-media-io.js\";\nexport * from \"./pending-media.js\";\nexport * from \"./staged-object.js\";\nexport * from \"./gcs-errors.js\";\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC","sourcesContent":["export * from \"./storage-ops.js\";\nexport * from \"./firebase-media-io.js\";\nexport * from \"./pending-media.js\";\nexport * from \"./staged-object.js\";\nexport * from \"./gcs-errors.js\";\nexport * from \"./download-token.js\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/media-processing-core",
-  "version": "0.8.15",
+  "version": "0.8.16",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -31,7 +31,7 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@ttt-productions/media-schemas": "^0.14.9",
+    "@ttt-productions/media-schemas": "^0.14.10",
     "aws4fetch": "^1.0.20",
     "sharp": "^0.35.3",
     "zod": "^4.4.3"