@freqhole/reliquary 0.2.9 → 0.2.11

package/dist/blobs/db.d.ts

@@ -5,4 +5,26 @@ export declare function getRecordBySha256(dbName: string, sha256: string): Promi
 export declare function getRecordByBlake3(dbName: string, blake3: string): Promise<BlobRecord | null>;
 export declare function deleteRecord(dbName: string, blobId: string): Promise<void>;
 export declare function clearRecords(dbName: string): Promise<void>;
+export declare function addCanvasRef(dbName: string, blobId: string, canvasDocId: string): Promise<void>;
+export declare function removeCanvasRef(dbName: string, blobId: string, canvasDocId: string): Promise<void>;
+export declare function getCanvasRefs(dbName: string, blobId: string): Promise<string[]>;
+export declare function removeAllCanvasRefsForCanvas(dbName: string, canvasDocId: string): Promise<void>;
+export declare function clearCanvasRefs(dbName: string): Promise<void>;
+export interface ListBlobsOptions {
+    sort?: "size" | "filename" | "created_at";
+    direction?: "asc" | "desc";
+    /** filename substring filter, case-insensitive (matches sqlite's default
+     *  `LIKE` behavior on the rust/tauri side). */
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ListBlobsPage {
+    items: BlobRecord[];
+    /** rows matching `search` (or every row, if no `search`) - not just this page. */
+    totalCount: number;
+    /** bytes across every row matching `search` (or every row, if no `search`). */
+    totalSize: number;
+}
+export declare function listBlobs(dbName: string, options?: ListBlobsOptions): Promise<ListBlobsPage>;
 //# sourceMappingURL=db.d.ts.map

package/dist/blobs/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/blobs/db.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAkE7C,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjF;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAS1F;AAkBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAE5F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAE5F;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchF;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchE"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/blobs/db.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AA8F7C,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjF;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAS1F;AAkBD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAE5F;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAE5F;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchF;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAchE;AAQD,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcrG;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcxG;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAYrF;AAED,wBAAsB,4BAA4B,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBrG;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAcnE;AAaD,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IAC1C,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B;mDAC+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;CACnB;AAOD,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,aAAa,CAAC,CA8EtG"}

package/dist/blobs/db.js

@@ -8,19 +8,47 @@
 // rather than holding one long-lived connection open - simple, and avoids
 // a version-change block from another tab ever having anything to wait on.
 const STORE_NAME = "blobs";
-const DB_VERSION = 1;
+const REFS_STORE_NAME = "blob_canvas_refs";
+const DB_VERSION = 3;
 function openVersioned(dbName, version) {
     return new Promise((resolve, reject) => {
         const req = indexedDB.open(dbName, version);
         req.onupgradeneeded = () => {
             const db = req.result;
+            let store;
             if (!db.objectStoreNames.contains(STORE_NAME)) {
-                const store = db.createObjectStore(STORE_NAME, { keyPath: "blob_id" });
+                store = db.createObjectStore(STORE_NAME, { keyPath: "blob_id" });
                 store.createIndex("sha256", "sha256", { unique: false });
                 store.createIndex("blake3", "blake3", { unique: false });
                 store.createIndex("blob_type", "blob_type", { unique: false });
                 store.createIndex("parent_blob_id", "parent_blob_id", { unique: false });
             }
+            else {
+                // pre-existing store from an earlier DB_VERSION - new indexes can
+                // still be added via the in-flight version-change transaction
+                // (`req.transaction`), they just can't be added outside
+                // onupgradeneeded. without this branch a version bump would silently
+                // never add the index for anyone who already has a v1/v2 database.
+                store = req.transaction.objectStore(STORE_NAME);
+            }
+            // added in v3 - supports sorting the local-files list (filez tab 2)
+            // by size without a full-store scan.
+            if (!store.indexNames.contains("size")) {
+                store.createIndex("size", "size", { unique: false });
+            }
+            if (!store.indexNames.contains("created_at")) {
+                store.createIndex("created_at", "created_at", { unique: false });
+            }
+            if (!db.objectStoreNames.contains(REFS_STORE_NAME)) {
+                // tracks which canvas documents currently have a widget
+                // referencing a given blob - a widget-delete cleanup can check
+                // this before purging local bytes, instead of scanning every
+                // canvas. composite key so re-adding an existing ref is a no-op
+                // (put with the same key overwrites, add() would throw).
+                const refs = db.createObjectStore(REFS_STORE_NAME, { keyPath: ["blob_id", "canvas_doc_id"] });
+                refs.createIndex("blob_id", "blob_id", { unique: false });
+                refs.createIndex("canvas_doc_id", "canvas_doc_id", { unique: false });
+            }
         };
         req.onsuccess = () => resolve(req.result);
         req.onerror = () => reject(req.error);
@@ -59,7 +87,7 @@ async function openDb(dbName) {
             req.onerror = () => reject(req.error);
         });
         const currentVersion = probe.version;
-        const hasStore = probe.objectStoreNames.contains(STORE_NAME);
+        const hasStore = probe.objectStoreNames.contains(STORE_NAME) && probe.objectStoreNames.contains(REFS_STORE_NAME);
         probe.close();
         const targetVersion = hasStore ? currentVersion : currentVersion + 1;
         resolvedVersions.set(dbName, targetVersion);
@@ -139,3 +167,170 @@ export async function clearRecords(dbName) {
         };
     });
 }
+// ---------------------------------------------------------------------------
+// blob/canvas reference index - which canvas docs currently have a widget
+// referencing a given blob, so a widget-delete cleanup can check this
+// before purging local bytes instead of scanning every canvas.
+// ---------------------------------------------------------------------------
+export async function addCanvasRef(dbName, blobId, canvasDocId) {
+    const db = await openDb(dbName);
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(REFS_STORE_NAME, "readwrite");
+        tx.objectStore(REFS_STORE_NAME).put({ blob_id: blobId, canvas_doc_id: canvasDocId });
+        tx.oncomplete = () => {
+            db.close();
+            resolve();
+        };
+        tx.onerror = () => {
+            db.close();
+            reject(tx.error);
+        };
+    });
+}
+export async function removeCanvasRef(dbName, blobId, canvasDocId) {
+    const db = await openDb(dbName);
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(REFS_STORE_NAME, "readwrite");
+        tx.objectStore(REFS_STORE_NAME).delete([blobId, canvasDocId]);
+        tx.oncomplete = () => {
+            db.close();
+            resolve();
+        };
+        tx.onerror = () => {
+            db.close();
+            reject(tx.error);
+        };
+    });
+}
+export async function getCanvasRefs(dbName, blobId) {
+    const db = await openDb(dbName);
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(REFS_STORE_NAME, "readonly");
+        const req = tx.objectStore(REFS_STORE_NAME).index("blob_id").getAll(blobId);
+        req.onsuccess = () => {
+            const rows = req.result ?? [];
+            resolve(rows.map((r) => r.canvas_doc_id));
+        };
+        req.onerror = () => reject(req.error);
+        tx.oncomplete = () => db.close();
+    });
+}
+export async function removeAllCanvasRefsForCanvas(dbName, canvasDocId) {
+    const db = await openDb(dbName);
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(REFS_STORE_NAME, "readwrite");
+        const store = tx.objectStore(REFS_STORE_NAME);
+        const req = store.index("canvas_doc_id").openCursor(IDBKeyRange.only(canvasDocId));
+        req.onsuccess = () => {
+            const cursor = req.result;
+            if (cursor) {
+                cursor.delete();
+                cursor.continue();
+            }
+        };
+        req.onerror = () => reject(req.error);
+        tx.oncomplete = () => {
+            db.close();
+            resolve();
+        };
+        tx.onerror = () => {
+            db.close();
+            reject(tx.error);
+        };
+    });
+}
+export async function clearCanvasRefs(dbName) {
+    const db = await openDb(dbName);
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(REFS_STORE_NAME, "readwrite");
+        tx.objectStore(REFS_STORE_NAME).clear();
+        tx.oncomplete = () => {
+            db.close();
+            resolve();
+        };
+        tx.onerror = () => {
+            db.close();
+            reject(tx.error);
+        };
+    });
+}
+function matchesSearch(record, search) {
+    if (!search)
+        return true;
+    return (record.filename ?? "").toLowerCase().includes(search.toLowerCase());
+}
+export async function listBlobs(dbName, options = {}) {
+    const { sort = "created_at", direction = "desc", search, limit = 50, offset = 0 } = options;
+    const db = await openDb(dbName);
+    return new Promise((resolve, reject) => {
+        const tx = db.transaction(STORE_NAME, "readonly");
+        const store = tx.objectStore(STORE_NAME);
+        let totalCount = 0;
+        let totalSize = 0;
+        const items = [];
+        tx.oncomplete = () => {
+            db.close();
+            resolve({ items, totalCount, totalSize });
+        };
+        tx.onerror = () => {
+            db.close();
+            reject(tx.error);
+        };
+        // aggregate pass, always a full scan (see module doc comment above).
+        const aggReq = store.openCursor();
+        aggReq.onsuccess = () => {
+            const cursor = aggReq.result;
+            if (!cursor) {
+                collectPage();
+                return;
+            }
+            const record = cursor.value;
+            if (matchesSearch(record, search)) {
+                totalCount += 1;
+                totalSize += record.size ?? 0;
+            }
+            cursor.continue();
+        };
+        aggReq.onerror = () => reject(aggReq.error);
+        function collectPage() {
+            const useIndex = (sort === "size" || sort === "created_at") && store.indexNames.contains(sort);
+            const cursorDirection = direction === "asc" ? "next" : "prev";
+            if (useIndex) {
+                let skipped = 0;
+                const req = store.index(sort).openCursor(null, cursorDirection);
+                req.onsuccess = () => {
+                    const cursor = req.result;
+                    // no `cursor.continue()` here on either branch below intentionally
+                    // stops iteration once the page is full - the transaction then
+                    // auto-completes since nothing else is pending.
+                    if (!cursor || items.length >= limit)
+                        return;
+                    const record = cursor.value;
+                    if (matchesSearch(record, search)) {
+                        if (skipped < offset) {
+                            skipped += 1;
+                        }
+                        else {
+                            items.push(record);
+                        }
+                    }
+                    cursor.continue();
+                };
+                req.onerror = () => reject(req.error);
+                return;
+            }
+            // filename sort: no index to stream off, fetch/filter/sort/slice.
+            const req = store.getAll();
+            req.onsuccess = () => {
+                const all = req.result.filter((r) => matchesSearch(r, search));
+                all.sort((a, b) => {
+                    const av = (a.filename ?? "").toLowerCase();
+                    const bv = (b.filename ?? "").toLowerCase();
+                    return direction === "asc" ? av.localeCompare(bv) : bv.localeCompare(av);
+                });
+                items.push(...all.slice(offset, offset + limit));
+            };
+            req.onerror = () => reject(req.error);
+        }
+    });
+}

package/dist/blobs/db.test.js

@@ -3,7 +3,7 @@
 import "fake-indexeddb/auto";
 import { IDBFactory } from "fake-indexeddb";
 import { beforeEach, describe, expect, it } from "vitest";
-import { clearRecords, deleteRecord, getRecord, getRecordByBlake3, getRecordBySha256, putRecord, } from "./db.js";
+import { addCanvasRef, clearCanvasRefs, clearRecords, deleteRecord, getCanvasRefs, getRecord, getRecordByBlake3, getRecordBySha256, listBlobs, putRecord, removeAllCanvasRefsForCanvas, removeCanvasRef, } from "./db.js";
 const DB_NAME = "blobs-db-test";
 beforeEach(() => {
     globalThis.indexedDB = new IDBFactory();
@@ -91,6 +91,37 @@ describe("db name isolation", () => {
         expect(await getRecord("db-one", "blake3-aaa")).not.toBeNull();
     });
 });
+describe("canvas ref index", () => {
+    it("tracks refs per blob and de-dupes re-adding the same ref", async () => {
+        await addCanvasRef(DB_NAME, "blob-a", "canvas-1");
+        await addCanvasRef(DB_NAME, "blob-a", "canvas-2");
+        await addCanvasRef(DB_NAME, "blob-a", "canvas-1");
+        const refs = (await getCanvasRefs(DB_NAME, "blob-a")).sort();
+        expect(refs).toEqual(["canvas-1", "canvas-2"]);
+    });
+    it("removeCanvasRef removes only the targeted ref", async () => {
+        await addCanvasRef(DB_NAME, "blob-b", "canvas-1");
+        await addCanvasRef(DB_NAME, "blob-b", "canvas-2");
+        await removeCanvasRef(DB_NAME, "blob-b", "canvas-1");
+        expect(await getCanvasRefs(DB_NAME, "blob-b")).toEqual(["canvas-2"]);
+    });
+    it("removeCanvasRef on a ref that never existed is a no-op", async () => {
+        await expect(removeCanvasRef(DB_NAME, "blob-c", "canvas-1")).resolves.toBeUndefined();
+    });
+    it("removeAllCanvasRefsForCanvas clears that canvas's refs across every blob", async () => {
+        await addCanvasRef(DB_NAME, "blob-d", "canvas-x");
+        await addCanvasRef(DB_NAME, "blob-e", "canvas-x");
+        await addCanvasRef(DB_NAME, "blob-d", "canvas-y");
+        await removeAllCanvasRefsForCanvas(DB_NAME, "canvas-x");
+        expect(await getCanvasRefs(DB_NAME, "blob-d")).toEqual(["canvas-y"]);
+        expect(await getCanvasRefs(DB_NAME, "blob-e")).toEqual([]);
+    });
+    it("clearCanvasRefs empties the whole ref index", async () => {
+        await addCanvasRef(DB_NAME, "blob-f", "canvas-1");
+        await clearCanvasRefs(DB_NAME);
+        expect(await getCanvasRefs(DB_NAME, "blob-f")).toEqual([]);
+    });
+});
 describe("pre-existing database at a higher version", () => {
     it("still reads and writes when dbName already exists at a version above DB_VERSION", async () => {
         // simulates an app's pre-existing database (this module's whole
@@ -118,3 +149,55 @@ describe("pre-existing database at a higher version", () => {
         expect(await getRecordByBlake3(dbName, record.blake3)).toEqual(record);
     });
 });
+describe("listBlobs", () => {
+    async function seedThree() {
+        await putRecord(DB_NAME, makeRecord({ blob_id: "a", blake3: "a", filename: "apple.txt", size: 1, created_at: 1 }));
+        await putRecord(DB_NAME, makeRecord({ blob_id: "b", blake3: "b", filename: "banana.txt", size: 5, created_at: 2 }));
+        await putRecord(DB_NAME, makeRecord({ blob_id: "c", blake3: "c", filename: "cherry.txt", size: 3, created_at: 3 }));
+    }
+    it("defaults to created_at desc", async () => {
+        await seedThree();
+        const page = await listBlobs(DB_NAME, {});
+        expect(page.items.map((r) => r.blob_id)).toEqual(["c", "b", "a"]);
+        expect(page.totalCount).toBe(3);
+        expect(page.totalSize).toBe(9);
+    });
+    it("sorts by size ascending via the size index", async () => {
+        await seedThree();
+        const page = await listBlobs(DB_NAME, { sort: "size", direction: "asc" });
+        expect(page.items.map((r) => r.blob_id)).toEqual(["a", "c", "b"]);
+    });
+    it("sorts by size descending", async () => {
+        await seedThree();
+        const page = await listBlobs(DB_NAME, { sort: "size", direction: "desc" });
+        expect(page.items.map((r) => r.blob_id)).toEqual(["b", "c", "a"]);
+    });
+    it("sorts by filename via the in-memory fallback (no index)", async () => {
+        await seedThree();
+        const page = await listBlobs(DB_NAME, { sort: "filename", direction: "asc" });
+        expect(page.items.map((r) => r.blob_id)).toEqual(["a", "b", "c"]);
+    });
+    it("paginates with limit/offset while preserving totals across the whole filter", async () => {
+        await seedThree();
+        const page1 = await listBlobs(DB_NAME, { sort: "size", direction: "asc", limit: 2, offset: 0 });
+        expect(page1.items.map((r) => r.blob_id)).toEqual(["a", "c"]);
+        expect(page1.totalCount).toBe(3);
+        const page2 = await listBlobs(DB_NAME, { sort: "size", direction: "asc", limit: 2, offset: 2 });
+        expect(page2.items.map((r) => r.blob_id)).toEqual(["b"]);
+        expect(page2.totalCount).toBe(3);
+    });
+    it("filters by a case-insensitive filename substring", async () => {
+        await seedThree();
+        const page = await listBlobs(DB_NAME, { search: "AN" });
+        expect(page.items.map((r) => r.blob_id)).toEqual(["b"]);
+        expect(page.totalCount).toBe(1);
+        expect(page.totalSize).toBe(5);
+    });
+    it("returns an empty page with zero totals when nothing matches", async () => {
+        await seedThree();
+        const page = await listBlobs(DB_NAME, { search: "nope" });
+        expect(page.items).toEqual([]);
+        expect(page.totalCount).toBe(0);
+        expect(page.totalSize).toBe(0);
+    });
+});

package/dist/blobs/index.d.ts

@@ -1,5 +1,6 @@
 export { createBlobStore, isOPFSSupported, DEFAULT_DB_NAME, writeThroughChain, readThroughChain, hasBytesInChain, removeFromChain, } from "./store.js";
 export type { BlobStore, BlobStoreOptions, StoreBlobFromFileOptions, BytesBackend, } from "./store.js";
+export type { ListBlobsOptions, ListBlobsPage } from "./db.js";
 export type { BlobLocalityInfo, BlobLocalityMetadata, BlobRecord, BlobType, BytesBackendName, NewBlobMeta, } from "./types.js";
 export { createOpfsBackend, createCacheBackend, defaultBytesChain } from "./bytes-backend.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,wBAAwB,EACxB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blobs/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,wBAAwB,EACxB,YAAY,GACb,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,YAAY,EACV,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,QAAQ,EACR,gBAAgB,EAChB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/blobs/store.d.ts

@@ -1,6 +1,8 @@
+import { type ListBlobsOptions, type ListBlobsPage } from "./db.js";
 import type { BlobLocalityInfo, BlobRecord, NewBlobMeta } from "./types.js";
 export { isOPFSSupported } from "./bytes-backend.js";
 export type { BlobLocalityInfo, BlobLocalityMetadata, BlobRecord, BlobType, BytesBackendName, NewBlobMeta } from "./types.js";
+export type { ListBlobsOptions, ListBlobsPage } from "./db.js";
 /** default IndexedDB database name for apps that don't need to preserve an
  *  existing one. */
 export declare const DEFAULT_DB_NAME = "reliquary-blobs";
@@ -38,6 +40,17 @@ export interface BlobStore {
     checkBlobLocality(blobId: string, blake3?: string): Promise<BlobLocalityInfo>;
     deleteBlob(blobId: string): Promise<void>;
     clearAll(): Promise<void>;
+    /** record that `canvasDocId` currently has a widget referencing `blobId`. */
+    addCanvasRef(blobId: string, canvasDocId: string): Promise<void>;
+    /** remove a single canvas/blob reference (widget deleted or reassigned). */
+    removeCanvasRef(blobId: string, canvasDocId: string): Promise<void>;
+    /** every canvas doc id currently referencing `blobId`. */
+    getCanvasRefs(blobId: string): Promise<string[]>;
+    /** remove every ref row for `canvasDocId` (the whole canvas was deleted). */
+    removeAllCanvasRefsForCanvas(canvasDocId: string): Promise<void>;
+    /** paginated/sortable/searchable local listing - backs the filez widget's
+     *  local-files tab. see `db.ts`'s `listBlobs` doc comment for perf notes. */
+    listBlobs(options?: ListBlobsOptions): Promise<ListBlobsPage>;
 }
 /** create a blob store instance. each instance owns its own object-url
  *  cache; construct one per app (not per component/request). */

package/dist/blobs/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/blobs/store.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE5E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9H;oBACoB;AACpB,eAAO,MAAM,eAAe,oBAAoB,CAAC;AAOjD,MAAM,WAAW,gBAAgB;IAC/B;;gEAE4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;4BAMwB;IACxB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACrE,iBAAiB,CACf,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,EAC3B,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC1D,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAClE,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAClE,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACzE,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC7E,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC1E,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;IAC/D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1E,iBAAiB,IAAI,IAAI,CAAC;IAC1B,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC9E,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;gEACgE;AAChE,wBAAgB,eAAe,CAAC,OAAO,GAAE,gBAAqB,GAAG,SAAS,CAiPzE;AAKD,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3G,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/blobs/store.ts"],"names":[],"mappings":"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"}

package/dist/blobs/store.js

@@ -20,7 +20,7 @@
 // blake3 and shared at the origin regardless of which app wrote it, so it
 // is not parameterized per store instance - see `bytes-backend.ts`.
 import { hashBlake3, hashSha256, streamFileToOpfs } from "../worker/index.js";
-import { clearRecords, deleteRecord, getRecord, getRecordByBlake3, getRecordBySha256, putRecord, } from "./db.js";
+import { addCanvasRef, clearCanvasRefs, clearRecords, deleteRecord, getCanvasRefs, getRecord, getRecordByBlake3, getRecordBySha256, listBlobs, putRecord, removeAllCanvasRefsForCanvas, removeCanvasRef, } from "./db.js";
 import { createOpfsBackend, defaultBytesChain, hasBytesInChain, readThroughChain, removeFromChain, writeThroughChain, } from "./bytes-backend.js";
 export { isOPFSSupported } from "./bytes-backend.js";
 /** default IndexedDB database name for apps that don't need to preserve an
@@ -237,6 +237,7 @@ export function createBlobStore(options = {}) {
     async function clearAll() {
         clearBlobUrlCache();
         await clearRecords(dbName);
+        await clearCanvasRefs(dbName);
         await Promise.all(chain.map((backend) => backend.clear()));
     }
     return {
@@ -255,6 +256,11 @@ export function createBlobStore(options = {}) {
         checkBlobLocality,
         deleteBlob,
         clearAll,
+        addCanvasRef: (blobId, canvasDocId) => addCanvasRef(dbName, blobId, canvasDocId),
+        removeCanvasRef: (blobId, canvasDocId) => removeCanvasRef(dbName, blobId, canvasDocId),
+        getCanvasRefs: (blobId) => getCanvasRefs(dbName, blobId),
+        removeAllCanvasRefsForCanvas: (canvasDocId) => removeAllCanvasRefsForCanvas(dbName, canvasDocId),
+        listBlobs: (options) => listBlobs(dbName, options),
     };
 }
 // low-level building blocks re-exported for callers that need to compose

package/dist/transfer/index.d.ts

@@ -1,6 +1,6 @@
 export type { BlobCapableNode, DiskSnatchResult, SnatchInfo, SnatchOptions, SnatchResult, } from "./types.js";
 export { DOWNLOAD_CANCELLED_MESSAGE, isCancelledError } from "./cancellation.js";
-export { discardPausedDownload, pauseSnatchDownload, snatchBlob, snatchBlobToDisk, } from "./snatch.js";
+export { discardPausedDownload, pauseSnatchDownload, pauseSnatchDownloadByBlake3, snatchBlob, snatchBlobToDisk, } from "./snatch.js";
 export { BlobServer, DEFAULT_RELEASE_AFTER_MS, serveBlobRequest, } from "./serve.js";
 export type { BlobServerOptions, ServedBlobInfo } from "./serve.js";
 export { createPrefetcher, Prefetcher } from "./prefetch.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transfer/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,EACV,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/transfer/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,0BAA0B,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAEjF,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,2BAA2B,EAC3B,UAAU,EACV,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,UAAU,EACV,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/transfer/index.js

@@ -1,4 +1,4 @@
 export { DOWNLOAD_CANCELLED_MESSAGE, isCancelledError } from "./cancellation.js";
-export { discardPausedDownload, pauseSnatchDownload, snatchBlob, snatchBlobToDisk, } from "./snatch.js";
+export { discardPausedDownload, pauseSnatchDownload, pauseSnatchDownloadByBlake3, snatchBlob, snatchBlobToDisk, } from "./snatch.js";
 export { BlobServer, DEFAULT_RELEASE_AFTER_MS, serveBlobRequest, } from "./serve.js";
 export { createPrefetcher, Prefetcher } from "./prefetch.js";

package/dist/transfer/snatch.d.ts

@@ -29,6 +29,14 @@ export declare function snatchBlobToDisk(node: BlobCapableNode, peerNodeIds: str
  * `download_cancel` or the download already settled.
  */
 export declare function pauseSnatchDownload(node: BlobCapableNode, downloadId: string): Promise<boolean>;
+/**
+ * pause every in-flight snatch of this blake3 hash, without needing the
+ * `downloadId` the original caller registered (e.g. cleaning up after a
+ * caller - a deleted widget - that no longer has its own download state).
+ * returns false when `node` has no `download_cancel_by_blake3` or nothing
+ * was in flight for this hash.
+ */
+export declare function pauseSnatchDownloadByBlake3(node: BlobCapableNode, blake3Hash: string): Promise<boolean>;
 /**
  * discard a paused partial: releases the gc pin a paused download left
  * behind so the transport can reclaim it. call when the user cancels for

package/dist/transfer/snatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snatch.d.ts","sourceRoot":"","sources":["../../src/transfer/snatch.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AA0KpB;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAwBvB;AAiDD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,4BAA4B,EACtC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAsD3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAOf"}
+{"version":3,"file":"snatch.d.ts","sourceRoot":"","sources":["../../src/transfer/snatch.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AA0KpB;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,UAAU,EAChB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CAwBvB;AAiDD;;;;;;;;;;;GAWG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,EAAE,EACrB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,4BAA4B,EACtC,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,gBAAgB,CAAC,CAsD3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;;GAMG;AACH,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,eAAe,EACrB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/transfer/snatch.js

@@ -271,6 +271,18 @@ export async function pauseSnatchDownload(node, downloadId) {
         return false;
     return (await node.download_cancel(downloadId)) === true;
 }
+/**
+ * pause every in-flight snatch of this blake3 hash, without needing the
+ * `downloadId` the original caller registered (e.g. cleaning up after a
+ * caller - a deleted widget - that no longer has its own download state).
+ * returns false when `node` has no `download_cancel_by_blake3` or nothing
+ * was in flight for this hash.
+ */
+export async function pauseSnatchDownloadByBlake3(node, blake3Hash) {
+    if (!node.download_cancel_by_blake3)
+        return false;
+    return (await node.download_cancel_by_blake3(blake3Hash)) > 0;
+}
 /**
  * discard a paused partial: releases the gc pin a paused download left
  * behind so the transport can reclaim it. call when the user cancels for

package/dist/transfer/snatch.test.js

@@ -3,7 +3,7 @@ vi.mock("../worker/index.js", () => ({
     hashBlake3: vi.fn(async (bytes) => `hash-of-${bytes.length}-bytes`),
 }));
 import { hashBlake3 } from "../worker/index.js";
-import { discardPausedDownload, pauseSnatchDownload, snatchBlob, snatchBlobToDisk, } from "./snatch.js";
+import { discardPausedDownload, pauseSnatchDownload, pauseSnatchDownloadByBlake3, snatchBlob, snatchBlobToDisk, } from "./snatch.js";
 afterEach(() => {
     vi.clearAllMocks();
 });
@@ -320,6 +320,25 @@ describe("pauseSnatchDownload / discardPausedDownload", () => {
         const node = { node_id: () => "me" };
         await expect(pauseSnatchDownload(node, "dl-1")).resolves.toBe(false);
     });
+    it("pauseSnatchDownloadByBlake3 pauses via download_cancel_by_blake3 and reports true when at least one was flagged", async () => {
+        const node = {
+            node_id: () => "me",
+            download_cancel_by_blake3: vi.fn(async () => 2),
+        };
+        await expect(pauseSnatchDownloadByBlake3(node, BLAKE3)).resolves.toBe(true);
+        expect(node.download_cancel_by_blake3).toHaveBeenCalledWith(BLAKE3);
+    });
+    it("pauseSnatchDownloadByBlake3 returns false when nothing was in flight", async () => {
+        const node = {
+            node_id: () => "me",
+            download_cancel_by_blake3: vi.fn(async () => 0),
+        };
+        await expect(pauseSnatchDownloadByBlake3(node, BLAKE3)).resolves.toBe(false);
+    });
+    it("pauseSnatchDownloadByBlake3 returns false when the node has no download_cancel_by_blake3", async () => {
+        const node = { node_id: () => "me" };
+        await expect(pauseSnatchDownloadByBlake3(node, BLAKE3)).resolves.toBe(false);
+    });
     it("discards a paused download via unprotect_blob, swallowing errors", async () => {
         const node = {
             node_id: () => "me",

package/dist/transfer/types.d.ts

@@ -28,6 +28,11 @@ export interface BlobCapableNode {
     /** pause/cancel an in-flight download by the id passed to it. returns
      *  false when the download already settled. */
     download_cancel?(downloadId: string): Promise<boolean>;
+    /** pause/cancel every in-flight download for this blake3 hash, without
+     *  needing the per-attempt downloadId (e.g. a caller that no longer has
+     *  its own download state, such as a widget being torn down). returns
+     *  how many were flagged - 0 means none were in flight. */
+    download_cancel_by_blake3?(blake3Hash: string): Promise<number>;
     /** release a gc pin held by a paused/cancelled download, letting the
      *  partial be reclaimed. */
     unprotect_blob?(blake3Hash: string): Promise<void>;

package/dist/transfer/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transfer/types.ts"],"names":[],"mappings":"AAeA,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,MAAM,CAAC;IAElB;;iEAE6D;IAC7D,sCAAsC,CAAC,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;;;;gBASY;IACZ,uCAAuC,CAAC,CACtC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EACjE,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;2EAIuE;IACvE,aAAa,CAAC,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE7C;mDAC+C;IAC/C,eAAe,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvD;gCAC4B;IAC5B,cAAc,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;iEAC6D;IAC7D,WAAW,CAAC,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhD;wCACoC;IACpC,YAAY,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzD;AAED,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB;;oDAEgD;IAChD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;2EACuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;uEACmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;mDAE+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;6DACyD;IACzD,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B;;;sCAGkC;IAClC,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/transfer/types.ts"],"names":[],"mappings":"AAeA,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,OAAO,IAAI,MAAM,CAAC;IAElB;;iEAE6D;IAC7D,sCAAsC,CAAC,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAAC;IAEvB;;;;;;;;;gBASY;IACZ,uCAAuC,CAAC,CACtC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EACjE,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC;IAEnB;;;;2EAIuE;IACvE,aAAa,CAAC,CACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAE7C;mDAC+C;IAC/C,eAAe,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvD;;;+DAG2D;IAC3D,yBAAyB,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhE;gCAC4B;IAC5B,cAAc,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD;iEAC6D;IAC7D,WAAW,CAAC,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEhD;wCACoC;IACpC,YAAY,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACzD;AAED,gEAAgE;AAChE,MAAM,WAAW,UAAU;IACzB;;oDAEgD;IAChD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC;2EACuE;IACvE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;uEACmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;mDAE+C;IAC/C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;6DACyD;IACzD,SAAS,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B;;;sCAGkC;IAClC,kBAAkB,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC3E;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf"}

package/dist/worker/midden-worker-client.d.ts

@@ -92,6 +92,9 @@ export declare class WorkerMiddenNode {
      *  stays in the persistent store, pinned against gc - a later download
      *  of the same hash resumes from the persisted bitfield. */
     download_cancel(downloadId: string): Promise<boolean>;
+    /** pause/cancel every in-flight download for this blake3 hash, without
+     *  needing the per-attempt downloadId. returns how many were flagged. */
+    download_cancel_by_blake3(blake3Hash: string): Promise<number>;
     /** pin a hash against gc (keep a paused partial alive). */
     protect_blob(blake3Hash: string): Promise<void>;
     /** remove a gc pin added by protect_blob or a cancelled download. */

package/dist/worker/midden-worker-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"midden-worker-client.d.ts","sourceRoot":"","sources":["../../src/worker/midden-worker-client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"midden-worker-client.d.ts","sourceRoot":"","sources":["../../src/worker/midden-worker-client.ts"],"names":[],"mappings":"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"}

package/dist/worker/midden-worker-client.js

@@ -233,6 +233,11 @@ export class WorkerMiddenNode {
     async download_cancel(downloadId) {
         return this.api.downloadCancel(downloadId);
     }
+    /** pause/cancel every in-flight download for this blake3 hash, without
+     *  needing the per-attempt downloadId. returns how many were flagged. */
+    async download_cancel_by_blake3(blake3Hash) {
+        return this.api.downloadCancelByBlake3(blake3Hash);
+    }
     /** pin a hash against gc (keep a paused partial alive). */
     async protect_blob(blake3Hash) {
         return this.api.protectBlob(blake3Hash);

package/dist/worker/midden-worker-client.test.js

@@ -42,6 +42,7 @@ function makeFakeApi(overrides = {}) {
         downloadVerifiedByIdProgress: vi.fn(),
         downloadVerifiedStreamingWithEnsure: vi.fn(),
         downloadCancel: vi.fn(),
+        downloadCancelByBlake3: vi.fn(),
         protectBlob: vi.fn(),
         unprotectBlob: vi.fn(),
         computeBlake3: vi.fn(),

package/dist/worker/midden-worker-contract.d.ts

@@ -76,6 +76,11 @@ export interface MiddenWorkerApi {
      *  stays in the store, pinned against gc - a later download of the same
      *  hash resumes from the persisted bitfield. */
     downloadCancel(downloadId: string): Promise<boolean>;
+    /** pause/cancel every in-flight download for this blake3 hash, without
+     *  needing the per-attempt downloadId (e.g. cleaning up after a caller
+     *  that no longer has its own download state). returns how many were
+     *  flagged - 0 means none were in flight. */
+    downloadCancelByBlake3(blake3Hash: string): Promise<number>;
     /** pin a hash against gc (keep a paused partial download alive). */
     protectBlob(blake3Hash: string): Promise<void>;
     /** remove a gc pin added by protectBlob or a cancelled download. */

package/dist/worker/midden-worker-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"midden-worker-contract.d.ts","sourceRoot":"","sources":["../../src/worker/midden-worker-contract.ts"],"names":[],"mappings":"AAqBA;mEACmE;AACnE,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;uEACuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,UAAU,CAAC;CACvB;AAED;;+EAE+E;AAC/E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC9B,0EAA0E;IAC1E,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAGlE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5D;2BACuB;IACvB,MAAM,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACrC,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAChE,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtE,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACxE,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,wEAAwE;IACxE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG7C,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,sBAAsB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,UAAU,CAAA;KAAE,CAAC,CAAC;IACrF,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpE,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD;;8BAE0B;IAC1B,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACtD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9E,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD;yEACqE;IACrE,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAGtD,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC/B,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAG9C,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACtF,kCAAkC,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,UAAU,CAAC,CAAC;IACvB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACtF,4BAA4B,CAC1B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,GACrC,OAAO,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;IACjC,mCAAmC,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,EACpD,UAAU,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,EACtC,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB;;;oDAGgD;IAChD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,oEAAoE;IACpE,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,oEAAoE;IACpE,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAGxE,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GAAG,IAAI,GAClB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC9C;AAED;;;;qCAIqC;AACrC,eAAO,MAAM,2BAA2B,wBAAwB,CAAC;AAEjE;;wEAEwE;AACxE,eAAO,MAAM,8BAA8B,QAAS,CAAC"}
+{"version":3,"file":"midden-worker-contract.d.ts","sourceRoot":"","sources":["../../src/worker/midden-worker-contract.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@freqhole/reliquary",
-    "version": "0.2.9",
+    "version": "0.2.11",
     "private": false,
     "type": "module",
     "description": "freqhole media blob storage domain: content-addressed blobs, transfer, worker, solid helpers",