@ai-matrx/media 0.8.0 → 0.9.0

package/dist/files/engine/cache/policy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/files/engine/cache/policy.ts"],"sourcesContent":["/**\n * features/files/cache/policy.ts\n *\n * Per-MIME size policy for the IndexedDB tier. The in-memory LRU caches\n * everything (it's session-scoped and bounded by total bytes); IDB only\n * persists what's worth re-loading across page reloads.\n *\n * The defaults are conservative: cache the large, expensive-to-re-fetch\n * artifacts (PDFs, video posters, audio) and the small text-y assets\n * (markdown, JSON, code) that previewers consult repeatedly.\n *\n * Returned `false` means \"do not write to IDB\". Memory LRU still caches.\n */\n\ninterface MimePolicy {\n  /** Match the entire mime prefix (e.g. `image/`, `application/`). */\n  prefix?: string;\n  /** Exact mime types to match (highest precedence). */\n  exact?: string[];\n  /** Max bytes per entry; oversize files skip IDB. */\n  maxBytes: number;\n}\n\nconst POLICIES: MimePolicy[] = [\n  { prefix: \"image/\", maxBytes: 50 * 1024 * 1024 },\n  { prefix: \"audio/\", maxBytes: 100 * 1024 * 1024 },\n  // Videos cache only up to 50 MB by default. Larger videos rely on\n  // native HTML5 streaming + server-side Range responses.\n  { prefix: \"video/\", maxBytes: 50 * 1024 * 1024 },\n  { exact: [\"application/pdf\"], maxBytes: 250 * 1024 * 1024 },\n  {\n    exact: [\n      \"application/zip\",\n      \"application/x-zip-compressed\",\n      \"application/x-tar\",\n      \"application/gzip\",\n    ],\n    maxBytes: 500 * 1024 * 1024,\n  },\n  {\n    prefix: \"text/\",\n    maxBytes: 10 * 1024 * 1024,\n  },\n  { exact: [\"application/json\", \"application/xml\"], maxBytes: 10 * 1024 * 1024 },\n];\n\nconst FALLBACK_MAX_BYTES = 25 * 1024 * 1024;\n\nexport function shouldPersistInIdb(\n  mimeType: string | null | undefined,\n  byteSize: number,\n): boolean {\n  if (!mimeType || byteSize <= 0) return false;\n  const normalized = mimeType.toLowerCase();\n  for (const policy of POLICIES) {\n    if (policy.exact?.includes(normalized)) {\n      return byteSize <= policy.maxBytes;\n    }\n    if (policy.prefix && normalized.startsWith(policy.prefix)) {\n      return byteSize <= policy.maxBytes;\n    }\n  }\n  return byteSize <= FALLBACK_MAX_BYTES;\n}\n"],"mappings":"AAuBA,MAAM,WAAyB;AAAA,EAC7B,EAAE,QAAQ,UAAU,UAAU,KAAK,OAAO,KAAK;AAAA,EAC/C,EAAE,QAAQ,UAAU,UAAU,MAAM,OAAO,KAAK;AAAA;AAAA;AAAA,EAGhD,EAAE,QAAQ,UAAU,UAAU,KAAK,OAAO,KAAK;AAAA,EAC/C,EAAE,OAAO,CAAC,iBAAiB,GAAG,UAAU,MAAM,OAAO,KAAK;AAAA,EAC1D;AAAA,IACE,OAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,IACA,UAAU,MAAM,OAAO;AAAA,EACzB;AAAA,EACA;AAAA,IACE,QAAQ;AAAA,IACR,UAAU,KAAK,OAAO;AAAA,EACxB;AAAA,EACA,EAAE,OAAO,CAAC,oBAAoB,iBAAiB,GAAG,UAAU,KAAK,OAAO,KAAK;AAC/E;AAEA,MAAM,qBAAqB,KAAK,OAAO;AAEhC,SAAS,mBACd,UACA,UACS;AACT,MAAI,CAAC,YAAY,YAAY,EAAG,QAAO;AACvC,QAAM,aAAa,SAAS,YAAY;AACxC,aAAW,UAAU,UAAU;AAC7B,QAAI,OAAO,OAAO,SAAS,UAAU,GAAG;AACtC,aAAO,YAAY,OAAO;AAAA,IAC5B;AACA,QAAI,OAAO,UAAU,WAAW,WAAW,OAAO,MAAM,GAAG;AACzD,aAAO,YAAY,OAAO;AAAA,IAC5B;AAAA,EACF;AACA,SAAO,YAAY;AACrB;","names":[]}

package/dist/files/engine/cache/register-service-worker.d.ts

@@ -0,0 +1,57 @@
+/**
+ * features/files/cache/register-service-worker.ts
+ *
+ * Register the blob-cache Service Worker (`/blob-sw.js`) and push the
+ * current backend URL + signed-in user id into it. The SW intercepts
+ * cloud-files byte fetches (and registered CDN / share-link URLs) and
+ * serves them from IndexedDB when present, falling through to the
+ * network otherwise.
+ *
+ * Called from `app/DeferredSingletons.tsx` (a Client Component) on idle
+ * after auth boot, so SSR is unaffected and registration doesn't block
+ * the first paint.
+ *
+ * Dev-mode guards:
+ *   - Disabled by default in development (`NODE_ENV !== 'production'`)
+ *     to avoid HMR interference with Next's RSC cache.
+ *   - Opt-in via `localStorage.matrx_dev_sw = '1'` for local testing.
+ *
+ * iOS Safari / private-browsing failure modes are tolerated silently —
+ * if `navigator.serviceWorker` is undefined or `register()` rejects,
+ * the app continues to function with just the in-memory LRU + IDB tiers
+ * (no transparent `<img src>` interception).
+ */
+/**
+ * Register the SW and (when ready) send the initial `set-config` message
+ * with the backend URL and signed-in user id. Returns the registration
+ * (or null when SW isn't supported / registration failed).
+ *
+ * Idempotent — subsequent calls reuse the in-flight promise.
+ */
+export declare function registerBlobCacheServiceWorker(args: {
+    backendUrl: string;
+    userId: string | null;
+    /** When true, force-register even in dev. */
+    force?: boolean;
+}): Promise<ServiceWorkerRegistration | null>;
+/**
+ * Imperative invalidation. Drops every cached version of a fileId in the
+ * SW's IDB tier. Called from invalidate() in features/files/hooks/blob-cache.ts.
+ */
+export declare function postBlobCacheInvalidate(fileId: string): Promise<void>;
+/**
+ * Per-user wipe. Called from sign-out.
+ */
+export declare function postBlobCacheClearUser(userId: string): Promise<void>;
+/**
+ * Register a (canonical-URL → fileId+version+checksum) mapping so the SW
+ * can recognize a public CDN URL or other byte URL the page has issued
+ * and serve it from the same cache entry as the canonical
+ * `/files/{id}/download` URL.
+ */
+export declare function postBlobCacheRegisterUrlMapping(args: {
+    url: string;
+    fileId: string;
+    version: number | null;
+    checksum: string | null;
+}): Promise<void>;

package/dist/files/engine/cache/register-service-worker.js

@@ -0,0 +1,80 @@
+const SW_URL = "/blob-sw.js";
+let registrationPromise = null;
+function registerBlobCacheServiceWorker(args) {
+  if (registrationPromise) {
+    void postSetConfig(args).catch(() => void 0);
+    return registrationPromise;
+  }
+  registrationPromise = (async () => {
+    if (typeof window === "undefined" || !("serviceWorker" in navigator)) {
+      return null;
+    }
+    const isProd = false;
+    const devOptIn = typeof window !== "undefined" && window.localStorage?.getItem("matrx_dev_sw") === "1";
+    if (!isProd && !devOptIn && !args.force) {
+      return null;
+    }
+    try {
+      const reg = await navigator.serviceWorker.register(SW_URL, {
+        scope: "/"
+      });
+      void postSetConfig(args);
+      navigator.serviceWorker.addEventListener("controllerchange", () => {
+        void postSetConfig(args);
+      });
+      return reg;
+    } catch (err) {
+      console.warn("[blob-cache-sw] registration failed", err);
+      return null;
+    }
+  })();
+  return registrationPromise;
+}
+async function postSetConfig(args) {
+  const target = navigator.serviceWorker.controller ?? await navigator.serviceWorker.ready.then((r) => r.active);
+  if (!target) return;
+  const filesUrl = process.env.NEXT_PUBLIC_FILES_URL || void 0;
+  target.postMessage({
+    kind: "set-config",
+    backendUrl: args.backendUrl.replace(/\/$/, ""),
+    filesUrl: filesUrl ? filesUrl.replace(/\/$/, "") : void 0,
+    userId: args.userId
+  });
+}
+async function postBlobCacheInvalidate(fileId) {
+  if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) {
+    return;
+  }
+  const ctrl = navigator.serviceWorker.controller;
+  if (!ctrl) return;
+  ctrl.postMessage({ kind: "invalidate", fileId });
+}
+async function postBlobCacheClearUser(userId) {
+  if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) {
+    return;
+  }
+  const ctrl = navigator.serviceWorker.controller;
+  if (!ctrl) return;
+  ctrl.postMessage({ kind: "clear-user", userId });
+}
+async function postBlobCacheRegisterUrlMapping(args) {
+  if (typeof navigator === "undefined" || !("serviceWorker" in navigator)) {
+    return;
+  }
+  const ctrl = navigator.serviceWorker.controller;
+  if (!ctrl) return;
+  ctrl.postMessage({
+    kind: "register-url-mapping",
+    url: args.url,
+    fileId: args.fileId,
+    version: args.version,
+    checksum: args.checksum
+  });
+}
+export {
+  postBlobCacheClearUser,
+  postBlobCacheInvalidate,
+  postBlobCacheRegisterUrlMapping,
+  registerBlobCacheServiceWorker
+};
+//# sourceMappingURL=register-service-worker.js.map

package/dist/files/engine/cache/register-service-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/files/engine/cache/register-service-worker.ts"],"sourcesContent":["/**\n * features/files/cache/register-service-worker.ts\n *\n * Register the blob-cache Service Worker (`/blob-sw.js`) and push the\n * current backend URL + signed-in user id into it. The SW intercepts\n * cloud-files byte fetches (and registered CDN / share-link URLs) and\n * serves them from IndexedDB when present, falling through to the\n * network otherwise.\n *\n * Called from `app/DeferredSingletons.tsx` (a Client Component) on idle\n * after auth boot, so SSR is unaffected and registration doesn't block\n * the first paint.\n *\n * Dev-mode guards:\n *   - Disabled by default in development (`NODE_ENV !== 'production'`)\n *     to avoid HMR interference with Next's RSC cache.\n *   - Opt-in via `localStorage.matrx_dev_sw = '1'` for local testing.\n *\n * iOS Safari / private-browsing failure modes are tolerated silently —\n * if `navigator.serviceWorker` is undefined or `register()` rejects,\n * the app continues to function with just the in-memory LRU + IDB tiers\n * (no transparent `<img src>` interception).\n */\n\nconst SW_URL = \"/blob-sw.js\";\n\nlet registrationPromise: Promise<ServiceWorkerRegistration | null> | null = null;\n\n/**\n * Register the SW and (when ready) send the initial `set-config` message\n * with the backend URL and signed-in user id. Returns the registration\n * (or null when SW isn't supported / registration failed).\n *\n * Idempotent — subsequent calls reuse the in-flight promise.\n */\nexport function registerBlobCacheServiceWorker(args: {\n  backendUrl: string;\n  userId: string | null;\n  /** When true, force-register even in dev. */\n  force?: boolean;\n}): Promise<ServiceWorkerRegistration | null> {\n  if (registrationPromise) {\n    void postSetConfig(args).catch(() => undefined);\n    return registrationPromise;\n  }\n  registrationPromise = (async () => {\n    if (typeof window === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n      return null;\n    }\n    const isProd = process.env.NODE_ENV === \"production\";\n    const devOptIn =\n      typeof window !== \"undefined\" &&\n      window.localStorage?.getItem(\"matrx_dev_sw\") === \"1\";\n    if (!isProd && !devOptIn && !args.force) {\n      return null;\n    }\n    try {\n      const reg = await navigator.serviceWorker.register(SW_URL, {\n        scope: \"/\",\n      });\n      // Push config as soon as we have a controller — covers fresh\n      // registrations (where the controller may not be set yet) by also\n      // listening on `controllerchange`.\n      void postSetConfig(args);\n      navigator.serviceWorker.addEventListener(\"controllerchange\", () => {\n        void postSetConfig(args);\n      });\n      return reg;\n    } catch (err) {\n      // eslint-disable-next-line no-console\n      console.warn(\"[blob-cache-sw] registration failed\", err);\n      return null;\n    }\n  })();\n  return registrationPromise;\n}\n\nasync function postSetConfig(args: {\n  backendUrl: string;\n  userId: string | null;\n}): Promise<void> {\n  const target =\n    navigator.serviceWorker.controller ??\n    (await navigator.serviceWorker.ready.then((r) => r.active));\n  if (!target) return;\n  // NEXT_PUBLIC_FILES_URL: when set, file/share downloads go to the standalone\n  // matrx-files service; tell the SW so it caches those the same as backend\n  // downloads. Read from env here so no call site needs to thread it through.\n  const filesUrl = (process.env.NEXT_PUBLIC_FILES_URL as string | undefined) || undefined;\n  target.postMessage({\n    kind: \"set-config\",\n    backendUrl: args.backendUrl.replace(/\\/$/, \"\"),\n    filesUrl: filesUrl ? filesUrl.replace(/\\/$/, \"\") : undefined,\n    userId: args.userId,\n  });\n}\n\n/**\n * Imperative invalidation. Drops every cached version of a fileId in the\n * SW's IDB tier. Called from invalidate() in features/files/hooks/blob-cache.ts.\n */\nexport async function postBlobCacheInvalidate(fileId: string): Promise<void> {\n  if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n    return;\n  }\n  const ctrl = navigator.serviceWorker.controller;\n  if (!ctrl) return;\n  ctrl.postMessage({ kind: \"invalidate\", fileId });\n}\n\n/**\n * Per-user wipe. Called from sign-out.\n */\nexport async function postBlobCacheClearUser(userId: string): Promise<void> {\n  if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n    return;\n  }\n  const ctrl = navigator.serviceWorker.controller;\n  if (!ctrl) return;\n  ctrl.postMessage({ kind: \"clear-user\", userId });\n}\n\n/**\n * Register a (canonical-URL → fileId+version+checksum) mapping so the SW\n * can recognize a public CDN URL or other byte URL the page has issued\n * and serve it from the same cache entry as the canonical\n * `/files/{id}/download` URL.\n */\nexport async function postBlobCacheRegisterUrlMapping(args: {\n  url: string;\n  fileId: string;\n  version: number | null;\n  checksum: string | null;\n}): Promise<void> {\n  if (typeof navigator === \"undefined\" || !(\"serviceWorker\" in navigator)) {\n    return;\n  }\n  const ctrl = navigator.serviceWorker.controller;\n  if (!ctrl) return;\n  ctrl.postMessage({\n    kind: \"register-url-mapping\",\n    url: args.url,\n    fileId: args.fileId,\n    version: args.version,\n    checksum: args.checksum,\n  });\n}\n"],"mappings":"AAwBA,MAAM,SAAS;AAEf,IAAI,sBAAwE;AASrE,SAAS,+BAA+B,MAKD;AAC5C,MAAI,qBAAqB;AACvB,SAAK,cAAc,IAAI,EAAE,MAAM,MAAM,MAAS;AAC9C,WAAO;AAAA,EACT;AACA,yBAAuB,YAAY;AACjC,QAAI,OAAO,WAAW,eAAe,EAAE,mBAAmB,YAAY;AACpE,aAAO;AAAA,IACT;AACA,UAAM,SAAS;AACf,UAAM,WACJ,OAAO,WAAW,eAClB,OAAO,cAAc,QAAQ,cAAc,MAAM;AACnD,QAAI,CAAC,UAAU,CAAC,YAAY,CAAC,KAAK,OAAO;AACvC,aAAO;AAAA,IACT;AACA,QAAI;AACF,YAAM,MAAM,MAAM,UAAU,cAAc,SAAS,QAAQ;AAAA,QACzD,OAAO;AAAA,MACT,CAAC;AAID,WAAK,cAAc,IAAI;AACvB,gBAAU,cAAc,iBAAiB,oBAAoB,MAAM;AACjE,aAAK,cAAc,IAAI;AAAA,MACzB,CAAC;AACD,aAAO;AAAA,IACT,SAAS,KAAK;AAEZ,cAAQ,KAAK,uCAAuC,GAAG;AACvD,aAAO;AAAA,IACT;AAAA,EACF,GAAG;AACH,SAAO;AACT;AAEA,eAAe,cAAc,MAGX;AAChB,QAAM,SACJ,UAAU,cAAc,cACvB,MAAM,UAAU,cAAc,MAAM,KAAK,CAAC,MAAM,EAAE,MAAM;AAC3D,MAAI,CAAC,OAAQ;AAIb,QAAM,WAAY,QAAQ,IAAI,yBAAgD;AAC9E,SAAO,YAAY;AAAA,IACjB,MAAM;AAAA,IACN,YAAY,KAAK,WAAW,QAAQ,OAAO,EAAE;AAAA,IAC7C,UAAU,WAAW,SAAS,QAAQ,OAAO,EAAE,IAAI;AAAA,IACnD,QAAQ,KAAK;AAAA,EACf,CAAC;AACH;AAMA,eAAsB,wBAAwB,QAA+B;AAC3E,MAAI,OAAO,cAAc,eAAe,EAAE,mBAAmB,YAAY;AACvE;AAAA,EACF;AACA,QAAM,OAAO,UAAU,cAAc;AACrC,MAAI,CAAC,KAAM;AACX,OAAK,YAAY,EAAE,MAAM,cAAc,OAAO,CAAC;AACjD;AAKA,eAAsB,uBAAuB,QAA+B;AAC1E,MAAI,OAAO,cAAc,eAAe,EAAE,mBAAmB,YAAY;AACvE;AAAA,EACF;AACA,QAAM,OAAO,UAAU,cAAc;AACrC,MAAI,CAAC,KAAM;AACX,OAAK,YAAY,EAAE,MAAM,cAAc,OAAO,CAAC;AACjD;AAQA,eAAsB,gCAAgC,MAKpC;AAChB,MAAI,OAAO,cAAc,eAAe,EAAE,mBAAmB,YAAY;AACvE;AAAA,EACF;AACA,QAAM,OAAO,UAAU,cAAc;AACrC,MAAI,CAAC,KAAM;AACX,OAAK,YAAY;AAAA,IACf,MAAM;AAAA,IACN,KAAK,KAAK;AAAA,IACV,QAAQ,KAAK;AAAA,IACb,SAAS,KAAK;AAAA,IACd,UAAU,KAAK;AAAA,EACjB,CAAC;AACH;","names":[]}