@the_library/public 1.0.0 → 2.0.1

package/dist/downloader/file-worker-v2.js

@@ -1,258 +1,2 @@
-// src/downloader/fetcher.ts
-var DEFAULT_GATEWAYS = [
-  "https://arweave.net",
-  "https://permagate.io",
-  "https://ar-io.dev"
-];
-function trackProgress(response, onProgress) {
-  const reader = response.body.getReader();
-  const total = response.headers.get("content-length") ? parseInt(response.headers.get("content-length"), 10) : void 0;
-  let loaded = 0;
-  const stream = new ReadableStream({
-    async pull(controller) {
-      const { done, value } = await reader.read();
-      if (done) {
-        controller.close();
-        return;
-      }
-      loaded += value.byteLength;
-      onProgress(loaded, total);
-      controller.enqueue(value);
-    },
-    cancel(reason) {
-      return reader.cancel(reason);
-    }
-  });
-  return new Response(stream, response);
-}
-async function fetchFromGateways(txId, gateways2, onProgress) {
-  let lastError;
-  for (const gw of gateways2) {
-    try {
-      const url = `${gw}/${txId}`;
-      const resp = await fetch(url, { mode: "cors" });
-      if (resp.type === "opaque") {
-        throw new Error(`[downloader_v2] opaque response for ${txId} \u2014 CORS not granted`);
-      }
-      if (!resp.ok) {
-        throw new Error(`[downloader_v2] HTTP ${resp.status} from ${gw}`);
-      }
-      const tracked = trackProgress(resp, onProgress);
-      const reader = tracked.body.getReader();
-      const { done, value } = await reader.read();
-      let finalStream;
-      if (!value) {
-        finalStream = new ReadableStream({
-          start(controller) {
-            controller.close();
-          }
-        });
-      } else {
-        const isGzip = value.length >= 2 && value[0] === 31 && value[1] === 139;
-        const combinedStream = new ReadableStream({
-          start(controller) {
-            controller.enqueue(value);
-          },
-          async pull(controller) {
-            const { done: done2, value: chunk } = await reader.read();
-            if (done2) {
-              controller.close();
-            } else {
-              controller.enqueue(chunk);
-            }
-          },
-          cancel(reason) {
-            return reader.cancel(reason);
-          }
-        });
-        finalStream = isGzip ? combinedStream.pipeThrough(new DecompressionStream("gzip")) : combinedStream;
-      }
-      const headers = new Headers(tracked.headers);
-      headers.set("X-DL2-Stored", (/* @__PURE__ */ new Date()).toISOString());
-      headers.delete("content-length");
-      headers.delete("content-encoding");
-      return new Response(finalStream, { status: tracked.status, statusText: tracked.statusText, headers });
-    } catch (err) {
-      lastError = err;
-    }
-  }
-  throw lastError ?? new Error(`[downloader_v2] all gateways failed for ${txId}`);
-}
-
-// src/downloader/keys.ts
-var CACHE_VERSION = 1;
-var CACHES = {
-  pdf: `dl2-pdf-v${CACHE_VERSION}`,
-  preview: `dl2-preview-v${CACHE_VERSION}`,
-  pages: `dl2-pages-v${CACHE_VERSION}`
-};
-var arKey = (txId) => `/ar/${txId}`;
-var pdfKey = arKey;
-var previewKey = arKey;
-
-// src/downloader/cache-store.ts
-var openPdfCache = () => caches.open(CACHES.pdf);
-var openPreviewCache = () => caches.open(CACHES.preview);
-var putPdf = async (txId, response) => {
-  const c = await openPdfCache();
-  await c.put(pdfKey(txId), response);
-};
-var putPreview = async (txId, response) => {
-  const c = await openPreviewCache();
-  await c.put(previewKey(txId), response);
-};
-var deletePdf = async (txId) => {
-  const c = await openPdfCache();
-  return c.delete(pdfKey(txId));
-};
-
-// src/downloader/meta-db.ts
-var DB_NAME = "dl2_meta";
-var DB_VERSION = 1;
-var _db = null;
-var openMetaDb = () => {
-  if (_db) return Promise.resolve(_db);
-  return new Promise((resolve, reject) => {
-    const req = indexedDB.open(DB_NAME, DB_VERSION);
-    req.onupgradeneeded = (e) => {
-      const db = e.target.result;
-      if (!db.objectStoreNames.contains("book_data")) {
-        db.createObjectStore("book_data", { keyPath: "txId" });
-      }
-      if (!db.objectStoreNames.contains("downloads")) {
-        db.createObjectStore("downloads", { keyPath: "txId" });
-      }
-      if (!db.objectStoreNames.contains("migration_checkpoints")) {
-        db.createObjectStore("migration_checkpoints", { keyPath: "cacheName" });
-      }
-    };
-    req.onsuccess = (e) => {
-      _db = e.target.result;
-      resolve(_db);
-    };
-    req.onerror = () => reject(req.error);
-  });
-};
-var idbPut = (store, value) => openMetaDb().then((db) => new Promise((resolve, reject) => {
-  const tx = db.transaction(store, "readwrite");
-  const req = tx.objectStore(store).put(value);
-  req.onsuccess = () => resolve();
-  req.onerror = () => reject(req.error);
-}));
-var idbDelete = (store, key) => openMetaDb().then((db) => new Promise((resolve, reject) => {
-  const tx = db.transaction(store, "readwrite");
-  const req = tx.objectStore(store).delete(key);
-  req.onsuccess = () => resolve();
-  req.onerror = () => reject(req.error);
-}));
-var idbGetAll = (store) => openMetaDb().then((db) => new Promise((resolve, reject) => {
-  const tx = db.transaction(store, "readonly");
-  const req = tx.objectStore(store).getAll();
-  req.onsuccess = () => resolve(req.result);
-  req.onerror = () => reject(req.error);
-}));
-var deleteBookData = (txId) => idbDelete("book_data", txId);
-var putDownloadRecord = (record) => idbPut("downloads", record);
-var getAllDownloadRecords = () => idbGetAll("downloads");
-var deleteDownloadRecord = (txId) => idbDelete("downloads", txId);
-
-// src/downloader/lru.ts
-var PRUNE_THRESHOLD = 0.8;
-var PRUNE_TARGET = 0.65;
-async function runLruPrune(onStart) {
-  const estimate = await navigator.storage.estimate();
-  const usage = estimate.usage ?? 0;
-  const quota = estimate.quota ?? Infinity;
-  if (usage / quota <= PRUNE_THRESHOLD) return null;
-  const targetFree = usage - quota * PRUNE_TARGET;
-  onStart?.(targetFree);
-  const records = await getAllDownloadRecords();
-  const pdfs = records.filter((r) => r.fileType === "pdf").sort((a, b) => a.lastAccessedAt - b.lastAccessedAt);
-  let freedBytes = 0;
-  let removed = 0;
-  const prunedTxIds = [];
-  for (const record of pdfs) {
-    if (freedBytes >= targetFree) break;
-    await deletePdf(record.txId);
-    await deleteDownloadRecord(record.txId);
-    await deleteBookData(record.txId);
-    await prunePagesByTxId(record.txId);
-    freedBytes += record.sizeBytes;
-    removed++;
-    prunedTxIds.push(record.txId);
-  }
-  return { removed, freedBytes, prunedTxIds };
-}
-async function runLruPruneAndEmit(postMsg) {
-  const estimate = await navigator.storage.estimate();
-  const usage = estimate.usage ?? 0;
-  const quota = estimate.quota ?? Infinity;
-  if (usage / quota <= PRUNE_THRESHOLD) return;
-  const targetFree = usage - quota * PRUNE_TARGET;
-  postMsg({ type: "StoragePruneStarted", targetFreeBytes: targetFree });
-  const result = await runLruPrune();
-  if (result) {
-    postMsg({
-      type: "StoragePruned",
-      removed: result.removed,
-      freedBytes: result.freedBytes,
-      prunedTxIds: result.prunedTxIds
-    });
-  }
-}
-async function prunePagesByTxId(txId) {
-  const cache = await caches.open(CACHES.pages);
-  const keys = await cache.keys();
-  const prefix = `/pages/${encodeURIComponent(txId)}/`;
-  await Promise.all(
-    keys.filter((r) => r.url.includes(prefix)).map((r) => cache.delete(r))
-  );
-}
-
-// src/downloader/worker/file-worker.ts
-var gateways = DEFAULT_GATEWAYS;
-function post(msg) {
-  self.postMessage(msg);
-}
-async function handleGetFile(txId, mime) {
-  try {
-    const response = await fetchFromGateways(txId, gateways, (loaded, total) => {
-      post({ type: "DownloadProgress", txId, loaded, total });
-    });
-    const ct = mime === "pdf" ? "application/pdf" : response.headers.get("content-type") || "application/octet-stream";
-    const buffer = await response.arrayBuffer();
-    const sizeBytes = buffer.byteLength;
-    const headers = new Headers(response.headers);
-    headers.set("Content-Type", ct);
-    headers.set("Content-Length", String(sizeBytes));
-    headers.set("X-DL2-Stored", (/* @__PURE__ */ new Date()).toISOString());
-    const cloned = new Response(buffer, { status: response.status, headers });
-    if (mime === "pdf") {
-      await putPdf(txId, cloned);
-    } else {
-      await putPreview(txId, cloned);
-    }
-    await putDownloadRecord({
-      txId,
-      fileType: mime,
-      sizeBytes,
-      downloadedAt: Date.now(),
-      lastAccessedAt: Date.now()
-    });
-    post({ type: "DownloadFinished", txId, key: txId, mime });
-    post({ type: "FileRpcResponse", ok: true, key: `${txId}:${mime}` });
-    await runLruPruneAndEmit(post);
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    post({ type: "DownloadError", txId, error: msg, retryable: true });
-    post({ type: "FileRpcResponse", ok: false, key: `${txId}:${mime}`, error: msg });
-  }
-}
-self.onmessage = (e) => {
-  const cmd = e.data;
-  if (cmd.type === "GetFile") {
-    handleGetFile(cmd.txId, cmd.mime);
-  } else if (cmd.type === "CancelDownload") {
-  }
-};
+var b=["https://arweave.net","https://permagate.io","https://ar-io.dev"];function M(e,t){let o=e.body.getReader(),n=e.headers.get("content-length")?parseInt(e.headers.get("content-length"),10):void 0,r=0,c=new ReadableStream({async pull(s){let{done:i,value:d}=await o.read();if(i){s.close();return}r+=d.byteLength,t(r,n),s.enqueue(d)},cancel(s){return o.cancel(s)}});return new Response(c,e)}async function k(e,t,o){let n;for(let r of t)try{let c=`${r}/${e}`,s=await fetch(c,{mode:"cors"});if(s.type==="opaque")throw new Error(`[downloader_v2] opaque response for ${e} \u2014 CORS not granted`);if(!s.ok)throw new Error(`[downloader_v2] HTTP ${s.status} from ${r}`);let i=M(s,o),d=i.body.getReader(),{done:u,value:a}=await d.read(),m;if(!a)m=new ReadableStream({start(y){y.close()}});else{let y=a.length>=2&&a[0]===31&&a[1]===139,P=new ReadableStream({start(p){p.enqueue(a)},async pull(p){let{done:F,value:L}=await d.read();F?p.close():p.enqueue(L)},cancel(p){return d.cancel(p)}});m=y?P.pipeThrough(new DecompressionStream("gzip")):P}let w=new Headers(i.headers);return w.set("X-DL2-Stored",new Date().toISOString()),w.delete("content-length"),w.delete("content-encoding"),new Response(m,{status:i.status,statusText:i.statusText,headers:w})}catch(c){n=c}throw n??new Error(`[downloader_v2] all gateways failed for ${e}`)}var g={pdf:"dl2-pdf-v1",preview:"dl2-preview-v1",pages:"dl2-pages-v1"};var R=e=>`/ar/${e}`,x=R,D=R;var v=()=>caches.open(g.pdf),H=()=>caches.open(g.preview);var S=async(e,t)=>{await(await v()).put(x(e),t)},E=async(e,t)=>{await(await H()).put(D(e),t)};var _=async e=>(await v()).delete(x(e));var W="dl2_meta";var f=null,h=()=>f?Promise.resolve(f):new Promise((e,t)=>{let o=indexedDB.open(W,1);o.onupgradeneeded=n=>{let r=n.target.result;r.objectStoreNames.contains("book_data")||r.createObjectStore("book_data",{keyPath:"txId"}),r.objectStoreNames.contains("downloads")||r.createObjectStore("downloads",{keyPath:"txId"}),r.objectStoreNames.contains("migration_checkpoints")||r.createObjectStore("migration_checkpoints",{keyPath:"cacheName"})},o.onsuccess=n=>{f=n.target.result,e(f)},o.onerror=()=>t(o.error)});var K=(e,t)=>h().then(o=>new Promise((n,r)=>{let s=o.transaction(e,"readwrite").objectStore(e).put(t);s.onsuccess=()=>n(),s.onerror=()=>r(s.error)})),A=(e,t)=>h().then(o=>new Promise((n,r)=>{let s=o.transaction(e,"readwrite").objectStore(e).delete(t);s.onsuccess=()=>n(),s.onerror=()=>r(s.error)})),j=e=>h().then(t=>new Promise((o,n)=>{let c=t.transaction(e,"readonly").objectStore(e).getAll();c.onsuccess=()=>o(c.result),c.onerror=()=>n(c.error)}));var I=e=>A("book_data",e);var B=e=>K("downloads",e),T=()=>j("downloads"),C=e=>A("downloads",e);var G=.8,U=.65,q=new Set;function N(e){q=new Set(e)}async function V(e){let t=await navigator.storage.estimate(),o=t.usage??0,n=t.quota??1/0;if(o/n<=G)return null;let r=o-n*U;e?.(r);let s=(await T()).filter(a=>a.fileType==="pdf"&&!q.has(a.txId)).sort((a,m)=>a.lastAccessedAt-m.lastAccessedAt),i=0,d=0,u=[];for(let a of s){if(i>=r)break;await _(a.txId),await C(a.txId),await I(a.txId),await z(a.txId),i+=a.sizeBytes,d++,u.push(a.txId)}return{removed:d,freedBytes:i,prunedTxIds:u}}async function O(e){let t=await V(o=>{e({type:"StoragePruneStarted",targetFreeBytes:o})});t&&e({type:"StoragePruned",removed:t.removed,freedBytes:t.freedBytes,prunedTxIds:t.prunedTxIds})}async function z(e){let t=await caches.open(g.pages),o=await t.keys(),n=`/pages/${encodeURIComponent(e)}/`;await Promise.all(o.filter(r=>r.url.includes(n)).map(r=>t.delete(r)))}var $=b;function l(e){self.postMessage(e)}async function X(e,t){try{let o=await k(e,$,(d,u)=>{l({type:"DownloadProgress",txId:e,loaded:d,total:u})}),n=t==="pdf"?"application/pdf":o.headers.get("content-type")||"application/octet-stream",r=await o.arrayBuffer(),c=r.byteLength,s=new Headers(o.headers);s.set("Content-Type",n),s.set("Content-Length",String(c)),s.set("X-DL2-Stored",new Date().toISOString());let i=new Response(r,{status:o.status,headers:s});t==="pdf"?await S(e,i):await E(e,i),await B({txId:e,fileType:t,sizeBytes:c,downloadedAt:Date.now(),lastAccessedAt:Date.now()}),l({type:"DownloadFinished",txId:e,key:e,mime:t}),l({type:"FileRpcResponse",ok:!0,key:`${e}:${t}`}),await O(l)}catch(o){let n=o instanceof Error?o.message:String(o),r=o instanceof DOMException&&o.name==="QuotaExceededError";l({type:"DownloadError",txId:e,error:n,retryable:!r,quotaExceeded:r}),l({type:"FileRpcResponse",ok:!1,key:`${e}:${t}`,error:n,quotaExceeded:r})}}self.onmessage=e=>{let t=e.data;t.type==="FileInit"?t.gateways.length>0&&($=t.gateways):t.type==="PinTxIds"?N(t.txIds):t.type==="GetFile"?X(t.txId,t.mime):t.type};
 //# sourceMappingURL=file-worker-v2.js.map

package/dist/downloader/file-worker-v2.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/downloader/fetcher.ts","../../src/downloader/keys.ts","../../src/downloader/cache-store.ts","../../src/downloader/meta-db.ts","../../src/downloader/lru.ts","../../src/downloader/worker/file-worker.ts"],"mappings":"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","names":["gateways","done"]}
+{"version":3,"sources":["../../src/downloader/fetcher.ts","../../src/downloader/keys.ts","../../src/downloader/cache-store.ts","../../src/downloader/meta-db.ts","../../src/downloader/lru.ts","../../src/downloader/worker/file-worker.ts"],"mappings":"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","names":["DEFAULT_GATEWAYS","trackProgress","response","onProgress","reader","total","loaded","stream","controller","done","value","reason","fetchFromGateways","txId","gateways","lastError","gw","url","resp","tracked","finalStream","isGzip","combinedStream","chunk","headers","err","CACHES","arKey","txId","pdfKey","previewKey","openPdfCache","CACHES","openPreviewCache","putPdf","txId","response","openPdfCache","pdfKey","putPreview","openPreviewCache","previewKey","deletePdf","txId","openPdfCache","pdfKey","DB_NAME","_db","openMetaDb","resolve","reject","req","DB_NAME","e","db","idbPut","store","value","openMetaDb","db","resolve","reject","req","idbDelete","key","idbGetAll","deleteBookData","txId","idbDelete","putDownloadRecord","record","idbPut","getAllDownloadRecords","idbGetAll","deleteDownloadRecord","txId","idbDelete","PRUNE_THRESHOLD","PRUNE_TARGET","_pinnedTxIds","setPinnedTxIds","txIds","runLruPrune","onStart","estimate","usage","quota","targetFree","pdfs","getAllDownloadRecords","r","b","freedBytes","removed","prunedTxIds","record","deletePdf","deleteDownloadRecord","deleteBookData","prunePagesByTxId","runLruPruneAndEmit","postMsg","result","txId","cache","CACHES","keys","prefix","gateways","DEFAULT_GATEWAYS","post","msg","handleGetFile","txId","mime","response","fetchFromGateways","loaded","total","ct","buffer","sizeBytes","headers","cloned","putPdf","putPreview","putDownloadRecord","runLruPruneAndEmit","err","quotaExceeded","cmd","setPinnedTxIds"]}

package/dist/downloader/index.d.ts

@@ -1,4 +1,4 @@
-export { B as BookData, a as FilePhase, F as FileState, H as HydratePayload, P as PruningState, R as RenderState, W as WorkerCommand, b as WorkerMessage, d as downloadState } from '../state-BTsp-E4v.js';
+export { B as BookData, a as FilePhase, F as FileState, H as HydratePayload, P as PruningState, R as RenderState, W as WorkerCommand, b as WorkerMessage, d as downloadState } from '../state-CkYavOSt.js';
 
 interface InitOptions {
     gateways?: string[];
@@ -12,10 +12,13 @@ interface InitOptions {
 }
 declare function preloadWorkersV2(): void;
 declare const InitDownloaderV2: (opts?: InitOptions) => Promise<void>;
+/** Replace the app-controlled pin set (the auto-pinned open book is kept in addition). */
+declare const SetPinnedPdfs: (txIds: string[]) => void;
 declare const GetPdf: (txId: string) => Promise<Response>;
 declare const GetImage: (txId: string) => Promise<Response>;
 declare const EnsurePageImage: (txId: string, page: number) => Promise<Response>;
 declare const EnsurePdf: (txId: string) => Promise<void>;
+declare const EnsurePageCount: (txId: string) => Promise<number>;
 declare const DownloadPdfToDisk: (txId: string, filename: string) => Promise<void>;
 declare const GetObjectUrl: (resp: Response) => Promise<string>;
 declare const revokeObjectUrl: (url: string) => void;
@@ -31,6 +34,31 @@ interface BookData {
 }
 declare const getBookData: (txId: string) => Promise<BookData | undefined>;
 
+/**
+ * Thrown by EnsurePdf()/EnsureGetPdf() (via the orchestrator) when a download
+ * failed because Cache Storage rejected the write with QuotaExceededError.
+ * Distinguishes "disk is full" from any other download failure (network,
+ * decrypt, gateway 404) so callers can react differently — e.g. stop
+ * retrying and prompt the user to free space, instead of treating it as a
+ * one-off per-book fetch error.
+ */
+declare class DownloadQuotaExceededError extends Error {
+    readonly txId: string;
+    constructor(txId: string, message?: string);
+}
+
+/** `detail` of the window `ARWEAVE_DOWNLOAD_PROGRESS` event — listeners type their handler with it. */
+interface DownloadProgressDetail {
+    txId: string;
+    loaded: number;
+    total?: number;
+}
+/** `detail` of the window `ARWEAVE_DOWNLOAD_DONE` event. */
+interface DownloadDoneDetail {
+    txId: string;
+    mime: 'pdf' | 'preview';
+}
+
 declare const CACHE_VERSION = 1;
 declare const CACHES: {
     readonly pdf: "dl2-pdf-v1";
@@ -42,4 +70,4 @@ declare const pdfKey: (txId: string) => string;
 declare const previewKey: (txId: string) => string;
 declare const pageKey: (txId: string, n: number) => string;
 
-export { CACHES, CACHE_VERSION, DL2_SW_VERSION, DownloadPdfToDisk, EnsurePageImage, EnsurePdf, GetImage, GetObjectUrl, GetPdf, InitDownloaderV2, type InitOptions, getBookData, pageKey, pdfKey, preloadWorkersV2, previewKey, revokeObjectUrl, storageEstimate };
+export { CACHES, CACHE_VERSION, DL2_SW_VERSION, type DownloadDoneDetail, DownloadPdfToDisk, type DownloadProgressDetail, DownloadQuotaExceededError, EnsurePageCount, EnsurePageImage, EnsurePdf, GetImage, GetObjectUrl, GetPdf, InitDownloaderV2, type InitOptions, SetPinnedPdfs, getBookData, pageKey, pdfKey, preloadWorkersV2, previewKey, revokeObjectUrl, storageEstimate };