@opendatalabs/personal-server-ts-core 0.0.1-canary.01ca694 → 0.0.1-canary.052d47e

package/dist/storage/adapters/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CACJ,IAAI,EAAE,IAAI,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC;AACD,MAAM,MAAM,yBAAyB,GAAG,MAAM,kBAAkB,CAAC;AAEjE,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,kBAAkB,GAAG,yBAAyB,GAChE,cAAc,CAsChB"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,kBAAkB;IACjC,MAAM,CACJ,IAAI,EAAE,IAAI,EACV,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACvC;AACD,MAAM,MAAM,yBAAyB,GAAG,MAAM,kBAAkB,CAAC;AAEjE,MAAM,WAAW,wBAAwB;IACvC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,CAAC;CACrC;AAED,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,kBAAkB,GAAG,yBAAyB,EACjE,OAAO,CAAC,EAAE,wBAAwB,GACjC,cAAc,CAmDhB"}

package/dist/storage/adapters/sdk.js

@@ -1,5 +1,6 @@
-export function createSdkStorageAdapter(providerOrFactory) {
+export function createSdkStorageAdapter(providerOrFactory, options) {
     let cachedProvider;
+    const urlForKey = options?.urlForKey ?? ((key) => key);
     function provider() {
         if (typeof providerOrFactory === "function") {
             cachedProvider ??= providerOrFactory();
@@ -12,6 +13,7 @@ export function createSdkStorageAdapter(providerOrFactory) {
             const result = await provider().upload(new Blob([copyBytes(data)], { type: "application/octet-stream" }), key);
             return result.url;
         },
+        urlForKey,
         async download(storageUrl) {
             const blob = await provider().download(storageUrl);
             return new Uint8Array(await blob.arrayBuffer());
@@ -20,16 +22,49 @@ export function createSdkStorageAdapter(providerOrFactory) {
             return provider().delete(storageUrl);
         },
         async exists(storageUrl) {
+            // The SDK provider interface has no HEAD/metadata call, so existence is
+            // probed with a full download (follow-up: add a HEAD to the vana
+            // provider). Only a definitive not-found may report "absent" — a
+            // transient error (network, 5xx, auth blip) must throw instead, so the
+            // caller retries next cycle rather than acting on a false "missing"
+            // (e.g. the upload worker's blob heal overwriting a blob that is
+            // actually there).
             try {
                 await provider().download(storageUrl);
                 return true;
             }
-            catch {
-                return false;
+            catch (err) {
+                if (isDefinitiveNotFound(err)) {
+                    return false;
+                }
+                throw err;
             }
         },
     };
 }
+// Prefer a numeric status property when the error carries one; today the
+// SDK's StorageError does NOT (the HTTP status lives only in its message —
+// "vana-storage download failed: 404 Not Found"), so fall back to that
+// stable message shape (also matches R2's "R2 download failed: 404 ...").
+// Providers with other message shapes (ipfs, pinata, dropbox) match
+// neither and so surface as errors — safe, never a false "missing". When
+// vana-sdk grows a status field on StorageError, the property check takes
+// over and the regex becomes dead fallback.
+function isDefinitiveNotFound(err) {
+    const status = numericProperty(err, "status") ?? numericProperty(err, "statusCode");
+    if (status !== undefined) {
+        return status === 404 || status === 410;
+    }
+    const message = err instanceof Error ? err.message : String(err);
+    return /download failed: (404|410)\b/.test(message);
+}
+function numericProperty(value, key) {
+    if (typeof value !== "object" || value === null || !(key in value)) {
+        return undefined;
+    }
+    const property = value[key];
+    return typeof property === "number" ? property : undefined;
+}
 function copyBytes(data) {
     const copy = new Uint8Array(data.byteLength);
     copy.set(data);

package/dist/storage/adapters/sdk.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/storage/adapters/sdk.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,uBAAuB,CACrC,iBAAiE;IAEjE,IAAI,cAA8C,CAAC;IAEnD,SAAS,QAAQ;QACf,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC5C,cAAc,KAAK,iBAAiB,EAAE,CAAC;YACvC,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI;YACpB,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC,MAAM,CACpC,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,EACjE,GAAG,CACJ,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,QAAQ,CAAC,UAAU;YACvB,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACnD,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,UAAU;YACrB,OAAO,QAAQ,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,UAAU;YACrB,IAAI,CAAC;gBACH,MAAM,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACtC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB;IACjC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC"}
+{"version":3,"file":"sdk.js","sourceRoot":"","sources":["../../../src/storage/adapters/sdk.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,uBAAuB,CACrC,iBAAiE,EACjE,OAAkC;IAElC,IAAI,cAA8C,CAAC;IACnD,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC;IAE/D,SAAS,QAAQ;QACf,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC5C,cAAc,KAAK,iBAAiB,EAAE,CAAC;YACvC,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI;YACpB,MAAM,MAAM,GAAG,MAAM,QAAQ,EAAE,CAAC,MAAM,CACpC,IAAI,IAAI,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,EACjE,GAAG,CACJ,CAAC;YACF,OAAO,MAAM,CAAC,GAAG,CAAC;QACpB,CAAC;QAED,SAAS;QAET,KAAK,CAAC,QAAQ,CAAC,UAAU;YACvB,MAAM,IAAI,GAAG,MAAM,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;YACnD,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QAClD,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,UAAU;YACrB,OAAO,QAAQ,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,UAAU;YACrB,wEAAwE;YACxE,iEAAiE;YACjE,iEAAiE;YACjE,uEAAuE;YACvE,oEAAoE;YACpE,iEAAiE;YACjE,mBAAmB;YACnB,IAAI,CAAC;gBACH,MAAM,QAAQ,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACtC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,oBAAoB,CAAC,GAAG,CAAC,EAAE,CAAC;oBAC9B,OAAO,KAAK,CAAC;gBACf,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AAED,yEAAyE;AACzE,2EAA2E;AAC3E,uEAAuE;AACvE,0EAA0E;AAC1E,oEAAoE;AACpE,yEAAyE;AACzE,0EAA0E;AAC1E,4CAA4C;AAC5C,SAAS,oBAAoB,CAAC,GAAY;IACxC,MAAM,MAAM,GACV,eAAe,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,eAAe,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACvE,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC;IAC1C,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,eAAe,CAAC,KAAc,EAAE,GAAW;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,EAAE,CAAC;QACnE,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,QAAQ,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;IACzD,OAAO,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,IAAgB;IACjC,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACf,OAAO,IAAI,CAAC,MAAM,CAAC;AACrB,CAAC"}

package/dist/storage/adapters/vana.d.ts

@@ -1,9 +1,12 @@
 import type { ServerConfig } from "../../schemas/server-config.js";
 import type { ServerAccount } from "../../keys/server-account.js";
 import type { StorageAdapter } from "./interface.js";
+/** Storage base URL the sync adapter targets (config override or SDK default). */
+export declare function resolveVanaStorageEndpoint(config: ServerConfig): string;
 export declare function createVanaSyncStorageAdapter(params: {
     config: ServerConfig;
     serverOwner: `0x${string}`;
     serverAccount: ServerAccount;
+    reads?: "signed" | "public";
 }): StorageAdapter;
 //# sourceMappingURL=vana.d.ts.map

package/dist/storage/adapters/vana.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vana.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/vana.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGrD,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;CAC9B,GAAG,cAAc,CAYjB"}
+{"version":3,"file":"vana.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters/vana.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAarD,kFAAkF;AAClF,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAIvE;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE;IACnD,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;IAC3B,aAAa,EAAE,aAAa,CAAC;IAC7B,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC7B,GAAG,cAAc,CAgDjB"}

package/dist/storage/adapters/vana.js

@@ -1,13 +1,106 @@
 import { createVanaStorageProvider } from "@opendatalabs/vana-sdk/browser";
+import { StorageError } from "@opendatalabs/vana-sdk/storage/index";
+import { ServerSigningUnavailableError } from "../../errors/catalog.js";
 import { createSdkStorageAdapter } from "./sdk.js";
+// Default endpoint baked into the SDK's vana-storage provider; mirrored here
+// so urlForKey resolves to the same host the provider uploads to when no
+// explicit apiUrl is configured.
+const DEFAULT_VANA_STORAGE_ENDPOINT = "https://storage.vana.org";
+const GET_METHOD = "GET";
+const PUBLIC_READS = "public";
+const DOWNLOAD_ERROR = "DOWNLOAD_ERROR";
+const DOWNLOAD_FAILED = "DOWNLOAD_FAILED";
+const VANA_STORAGE = "vana-storage";
+/** Storage base URL the sync adapter targets (config override or SDK default). */
+export function resolveVanaStorageEndpoint(config) {
+    return (config.storage.config.vana?.apiUrl ?? DEFAULT_VANA_STORAGE_ENDPOINT).replace(/\/+$/, "");
+}
 export function createVanaSyncStorageAdapter(params) {
+    const endpoint = resolveVanaStorageEndpoint(params.config);
+    // The SDK's vana-storage provider lowercases the owner before building the
+    // blob path (and its URL validator compares against the lowercased form),
+    // so urlForKey MUST lowercase too or the reconstructed download URL won't
+    // match the uploaded blob's key.
+    // serverOwner is already a 0x-hex address; lowercasing preserves that, but
+    // .toLowerCase() widens to string. vana-sdk 3.14.0 types the provider's
+    // ownerAddress as `0x${string}`, so re-narrow to the known-hex form.
+    const owner = params.serverOwner.toLowerCase();
+    // Storage blob paths are scoped by the protocol chain id so data for the same
+    // owner/scope/version never collides across networks. The chain id is the
+    // gateway's — it is never inferred from the storage host (apiUrl), which
+    // selects the product host independently.
+    const chainId = params.config.gateway.chainId;
+    // enclave sandbox --> public blob GET ----------> vana-storage
+    // desktop/cloud ---> signed PUT / GET / DELETE -> vana-storage
+    if (params.reads === PUBLIC_READS) {
+        // TODO(decision): blob reads stay public (architecture, resolved 2026-09-02); revisit if storage adds read auth.
+        return createPublicReadAdapter({ endpoint, chainId, owner });
+    }
     return createSdkStorageAdapter(createVanaStorageProvider({
         endpoint: params.config.storage.config.vana?.apiUrl,
-        ownerAddress: params.serverOwner,
+        chainId,
+        ownerAddress: owner,
         signer: {
             address: params.serverAccount.address,
             signMessage: (message) => params.serverAccount.signMessage(message),
         },
-    }));
+    }), {
+        // Mirror the provider's keying: PUT/GET target
+        // `${endpoint}/v1/chains/${chainId}/blobs/${owner}/${encodeURIComponent-per-segment(key)}`.
+        // The download worker hands us `{scope}/{version}` and we rebuild the
+        // exact URL the provider's pathFromUrl() validator accepts.
+        urlForKey: (key) => {
+            const subpath = key
+                .split("/")
+                .map((segment) => encodeURIComponent(segment))
+                .join("/");
+            return `${endpoint}/v1/chains/${chainId}/blobs/${owner}/${subpath}`;
+        },
+    });
+}
+function createPublicReadAdapter(options) {
+    const blobPrefix = `${options.endpoint}/v1/chains/${options.chainId}/blobs/${options.owner}/`;
+    function invalidBlobUrl() {
+        return new StorageError("Public blob URL does not match the configured storage namespace", DOWNLOAD_FAILED, VANA_STORAGE);
+    }
+    return createSdkStorageAdapter({
+        async upload() {
+            throw new ServerSigningUnavailableError();
+        },
+        async download(storageUrl) {
+            let requestUrl;
+            try {
+                requestUrl = new URL(storageUrl).href;
+            }
+            catch {
+                throw invalidBlobUrl();
+            }
+            if (!requestUrl.startsWith(blobPrefix)) {
+                throw invalidBlobUrl();
+            }
+            let response;
+            try {
+                response = await fetch(requestUrl, { method: GET_METHOD });
+            }
+            catch (cause) {
+                throw new StorageError("vana-storage public download network error", DOWNLOAD_ERROR, VANA_STORAGE, { cause: cause instanceof Error ? cause : undefined });
+            }
+            if (!response.ok) {
+                throw new StorageError(`vana-storage download failed: ${response.status} ${response.statusText}`, DOWNLOAD_FAILED, VANA_STORAGE);
+            }
+            return response.blob();
+        },
+        async delete() {
+            throw new ServerSigningUnavailableError();
+        },
+    }, {
+        urlForKey(key) {
+            const subpath = key
+                .split("/")
+                .map((segment) => encodeURIComponent(segment))
+                .join("/");
+            return `${blobPrefix}${subpath}`;
+        },
+    });
 }
 //# sourceMappingURL=vana.js.map

package/dist/storage/adapters/vana.js.map

@@ -1 +1 @@
-{"version":3,"file":"vana.js","sourceRoot":"","sources":["../../../src/storage/adapters/vana.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAI3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEnD,MAAM,UAAU,4BAA4B,CAAC,MAI5C;IACC,OAAO,uBAAuB,CAC5B,yBAAyB,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM;QACnD,YAAY,EAAE,MAAM,CAAC,WAAW;QAChC,MAAM,EAAE;YACN,OAAO,EAAE,MAAM,CAAC,aAAa,CAAC,OAAO;YACrC,WAAW,EAAE,CAAC,OAAe,EAAE,EAAE,CAC/B,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC;SAC5C;KACF,CAAC,CACH,CAAC;AACJ,CAAC"}
+{"version":3,"file":"vana.js","sourceRoot":"","sources":["../../../src/storage/adapters/vana.ts"],"names":[],"mappings":"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"}

package/dist/storage/blocks/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/storage/blocks/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GACjC,0BAA0B,GAC1B,yBAAyB,GACzB,gBAAgB,CAAC;AAErB,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,IAAI,EAAE,yBAAyB;gBAA/B,IAAI,EAAE,yBAAyB,EAC/C,OAAO,EAAE,MAAM;CAKlB"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/storage/blocks/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,yBAAyB,GACnC,0BAA0B,GAAG,yBAAyB,GAAG,gBAAgB,CAAC;AAE5E,qBAAa,qBAAsB,SAAQ,KAAK;aAE5B,IAAI,EAAE,yBAAyB;gBAA/B,IAAI,EAAE,yBAAyB,EAC/C,OAAO,EAAE,MAAM;CAKlB"}

package/dist/storage/blocks/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/storage/blocks/errors.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE5B;IADlB,YACkB,IAA+B,EAC/C,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAA2B;QAI/C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/storage/blocks/errors.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAE5B;IADlB,YACkB,IAA+B,EAC/C,OAAe;QAEf,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAA2B;QAI/C,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF"}

package/dist/storage/blocks/index.d.ts

@@ -1,4 +1,6 @@
 export type { ContentKind, DataBlockManifest, DataBlockRef, DataBlockWarning, DataScopeBlock, ReadScopeBlocksRequest, ReadScopeBlocksResponse, } from "./types.js";
 export { decodeDataBlockCursor, encodeDataBlockCursor, validateDataBlockCursor, type DataBlockCursor, type DataBlockCursorError, type DataBlockCursorErrorCode, type DecodeDataBlockCursorResult, type EncodeDataBlockCursorInput, type ValidateDataBlockCursorResult, } from "./cursor.js";
+export { buildDataBlocksAsync } from "./build.js";
+export { MAX_SELECTED_BLOCK_IDS, selectScopeBlocksByIds, type SelectScopeBlocksResult, } from "./select.js";
 export { DataBlockStorageError, type DataBlockStorageErrorCode, } from "./errors.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/blocks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/blocks/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,GACnC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/storage/blocks/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,sBAAsB,EACtB,uBAAuB,GACxB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,wBAAwB,EAC7B,KAAK,2BAA2B,EAChC,KAAK,0BAA0B,EAC/B,KAAK,6BAA6B,GACnC,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,uBAAuB,GAC7B,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,qBAAqB,EACrB,KAAK,yBAAyB,GAC/B,MAAM,aAAa,CAAC"}

package/dist/storage/blocks/index.js

@@ -1,3 +1,5 @@
 export { decodeDataBlockCursor, encodeDataBlockCursor, validateDataBlockCursor, } from "./cursor.js";
+export { buildDataBlocksAsync } from "./build.js";
+export { MAX_SELECTED_BLOCK_IDS, selectScopeBlocksByIds, } from "./select.js";
 export { DataBlockStorageError, } from "./errors.js";
 //# sourceMappingURL=index.js.map

package/dist/storage/blocks/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/blocks/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GAOxB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,qBAAqB,GAEtB,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/storage/blocks/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,GAOxB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GAEvB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,qBAAqB,GAEtB,MAAM,aAAa,CAAC"}

package/dist/storage/blocks/select.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Block-addressed selection: read exactly the blocks a caller names.
+ *
+ * Search returns a `blockRef` per hit and the manifest is a table of contents,
+ * but without this path a client still has to walk `nextCursor` from the start
+ * of the scope to reach a block it already knows the id of. Every storage
+ * implementation pages the manifest identically, so the selection loop lives
+ * here instead of being copied into each of them.
+ */
+import type { DataBlockManifest, DataBlockWarning, DataScopeBlock } from "./types.js";
+/** Upper bound on block ids honoured in a single block-addressed read. */
+export declare const MAX_SELECTED_BLOCK_IDS = 50;
+export interface SelectScopeBlocksResult {
+    blocks: DataScopeBlock[];
+    warnings: DataBlockWarning[];
+}
+/**
+ * Return the requested blocks in the order they were asked for, bounded by
+ * `maxBytes`. Ids that are not in the manifest, ids dropped by the id cap, and
+ * ids left out because the byte budget ran out are reported as warnings rather
+ * than errors — a partially answered selection is still useful.
+ *
+ * No cursor is produced: the selection order is the caller's, not the
+ * manifest's, so a manifest-index cursor could not resume it.
+ */
+export declare function selectScopeBlocksByIds(manifest: DataBlockManifest, blockIds: readonly string[], options: {
+    maxBytes: number;
+}, loadBlock: (blockId: string) => Promise<DataScopeBlock | null>): Promise<SelectScopeBlocksResult>;
+//# sourceMappingURL=select.d.ts.map

package/dist/storage/blocks/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../../src/storage/blocks/select.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,0EAA0E;AAC1E,eAAO,MAAM,sBAAsB,KAAK,CAAC;AASzC,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAsB,sBAAsB,CAC1C,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC7B,SAAS,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,GAC7D,OAAO,CAAC,uBAAuB,CAAC,CAsElC"}

package/dist/storage/blocks/select.js

@@ -0,0 +1,120 @@
+/**
+ * Block-addressed selection: read exactly the blocks a caller names.
+ *
+ * Search returns a `blockRef` per hit and the manifest is a table of contents,
+ * but without this path a client still has to walk `nextCursor` from the start
+ * of the scope to reach a block it already knows the id of. Every storage
+ * implementation pages the manifest identically, so the selection loop lives
+ * here instead of being copied into each of them.
+ */
+/** Upper bound on block ids honoured in a single block-addressed read. */
+export const MAX_SELECTED_BLOCK_IDS = 50;
+/** Ids listed inline in a warning message before it is summarized by count. */
+const WARNING_ID_SAMPLE = 10;
+const TEXT_PAGE_MEDIA_TYPE = "text/plain; charset=utf-8";
+const textEncoder = new TextEncoder();
+const textDecoder = new TextDecoder();
+/**
+ * Return the requested blocks in the order they were asked for, bounded by
+ * `maxBytes`. Ids that are not in the manifest, ids dropped by the id cap, and
+ * ids left out because the byte budget ran out are reported as warnings rather
+ * than errors — a partially answered selection is still useful.
+ *
+ * No cursor is produced: the selection order is the caller's, not the
+ * manifest's, so a manifest-index cursor could not resume it.
+ */
+export async function selectScopeBlocksByIds(manifest, blockIds, options, loadBlock) {
+    const maxBytes = Math.max(1, options.maxBytes);
+    const refById = new Map(manifest.blocks.map((ref) => [ref.id, ref]));
+    const requested = [];
+    const seen = new Set();
+    let cappedIds = 0;
+    for (const blockId of blockIds) {
+        if (typeof blockId !== "string" || !blockId || seen.has(blockId))
+            continue;
+        seen.add(blockId);
+        if (requested.length >= MAX_SELECTED_BLOCK_IDS) {
+            cappedIds += 1;
+            continue;
+        }
+        requested.push(blockId);
+    }
+    const blocks = [];
+    const missingIds = [];
+    const skippedIds = [];
+    const warnings = [];
+    let bytes = 0;
+    for (let index = 0; index < requested.length; index += 1) {
+        const blockId = requested[index];
+        const ref = refById.get(blockId);
+        if (!ref) {
+            missingIds.push(blockId);
+            continue;
+        }
+        // Mirrors the cursor path: a block that does not fit whole is only sliced
+        // when it is the first one in the page, so a caller always makes progress.
+        if (blocks.length > 0 && bytes + ref.sizeBytes > maxBytes) {
+            skippedIds.push(...requested.slice(index));
+            break;
+        }
+        const block = await loadBlock(blockId);
+        if (!block) {
+            missingIds.push(blockId);
+            continue;
+        }
+        const page = pageBlock(block, maxBytes - bytes);
+        blocks.push(page.block);
+        bytes += page.block.sizeBytes;
+        if (page.truncated) {
+            skippedIds.push(...requested.slice(index + 1));
+            break;
+        }
+    }
+    if (cappedIds > 0) {
+        warnings.push({
+            code: "block_selection_capped",
+            message: `${cappedIds} block ids beyond the ${MAX_SELECTED_BLOCK_IDS} id limit were ignored`,
+        });
+    }
+    if (missingIds.length > 0) {
+        warnings.push({
+            code: "block_not_found",
+            message: `${missingIds.length} requested block ids are not in this scope: ${summarizeIds(missingIds)}`,
+        });
+    }
+    if (skippedIds.length > 0) {
+        warnings.push({
+            code: "block_selection_truncated",
+            message: `maxBytes reached; ${skippedIds.length} requested blocks were not returned: ${summarizeIds(skippedIds)}. Request them in a follow-up read.`,
+        });
+    }
+    return { blocks, warnings };
+}
+function summarizeIds(ids) {
+    const sample = ids.slice(0, WARNING_ID_SAMPLE).join(", ");
+    return ids.length > WARNING_ID_SAMPLE
+        ? `${sample}, ...(${ids.length - WARNING_ID_SAMPLE} more)`
+        : sample;
+}
+function pageBlock(block, maxBytes) {
+    const text = typeof block.value === "string" ? block.value : JSON.stringify(block.value);
+    const bytes = textEncoder.encode(text);
+    if (bytes.length <= maxBytes) {
+        return { block, truncated: false };
+    }
+    const end = Math.max(1, maxBytes);
+    return {
+        block: {
+            ...block,
+            path: `${block.path}[bytes 0:${end}]`,
+            mediaType: block.mediaType.startsWith("text/")
+                ? block.mediaType
+                : TEXT_PAGE_MEDIA_TYPE,
+            value: textDecoder.decode(bytes.slice(0, end)),
+            sizeBytes: end,
+            truncated: true,
+        },
+        truncated: true,
+    };
+}
+//# sourceMappingURL=select.js.map

package/dist/storage/blocks/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","sourceRoot":"","sources":["../../../src/storage/blocks/select.ts"],"names":[],"mappings":"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"}

package/dist/storage/blocks/types.d.ts

@@ -28,6 +28,13 @@ export interface ReadScopeBlocksRequest {
     collectedAt?: string;
     cursor?: string;
     maxBytes?: number;
+    /**
+     * Read only these blocks, in this order, instead of paging the scope from
+     * `cursor`. Ids come from a manifest listing or from a search hit's
+     * `blockRef`. When set, `cursor` is ignored and no `nextCursor` is returned;
+     * `maxBytes` still bounds the response.
+     */
+    blockIds?: string[];
 }
 export interface ReadScopeBlocksResponse {
     scope: string;

package/dist/storage/blocks/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/blocks/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,MAAM,GACN,KAAK,GACL,MAAM,GACN,QAAQ,GACR,aAAa,CAAC;AAElB,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/blocks/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GACrB,eAAe,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,aAAa,CAAC;AAEvE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB"}

package/dist/storage/index/manager.d.ts

@@ -6,6 +6,12 @@ export interface IndexManager {
     findLatestByScope(scope: string): IndexEntry | undefined;
     countByScope(scope: string): number;
     deleteByPath(path: string): boolean;
+    /**
+     * Delete a row by path ONLY if it is still unsynced (`dataPointId` null).
+     * Atomic guard so a row that raced to synced after selection keeps its
+     * metadata. Returns true only when an unsynced row was actually removed.
+     */
+    deleteUnsyncedByPath(path: string): boolean;
     listDistinctScopes(options?: {
         scopePrefix?: string;
         limit?: number;
@@ -16,9 +22,12 @@ export interface IndexManager {
     };
     findClosestByScope(scope: string, at: string): IndexEntry | undefined;
     findByFileId(fileId: string): IndexEntry | undefined;
+    /** Find an index entry by its DPv2 data-point id (download dedup). */
+    findByDataPointId(dataPointId: string): IndexEntry | undefined;
     /**
-     * Find all index entries where fileId is null (not yet synced to storage backend).
-     * Returns entries ordered by created_at ASC (oldest first).
+     * Find all index entries where dataPointId is null (not yet synced /
+     * registered on-chain). Returns entries ordered by created_at ASC (oldest
+     * first).
      */
     findUnsynced(options?: {
         limit?: number;
@@ -28,6 +37,25 @@ export interface IndexManager {
      * @returns true if row was updated, false if path not found
      */
     updateFileId(path: string, fileId: string): boolean;
+    /**
+     * Returns the highest stored `version` for a scope, or 0 if none. Used by
+     * `insert` to derive the next expectedVersion for DPv2 AddData.
+     */
+    findLatestVersionByScope(scope: string): number;
+    /**
+     * Update the dataPointId for an index entry (after successful DPv2
+     * registerDataPoint). Sync-worker step that runs alongside fileId update.
+     * @returns true if row was updated, false if path not found
+     */
+    updateDataPointId(path: string, dataPointId: string): boolean;
+    /**
+     * Update the DPv2 `version` for an index entry. Used by the upload worker
+     * when a registration is rebased onto the registry's live version after a
+     * stale-expectedVersion conflict (the blob key embeds the version, so the
+     * local row must follow).
+     * @returns true if row was updated, false if path not found
+     */
+    updateVersion(path: string, version: number): boolean;
     /** Deletes all index entries for a scope. Returns count of deleted rows. */
     deleteByScope(scope: string): number;
     close(): void;

package/dist/storage/index/manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/storage/index/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC;IACzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACjD,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,EAAE,CAAC;IACrD,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACzD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG;QAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACtE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACrD;;;OAGG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,EAAE,CAAC;IACzD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD,4EAA4E;IAC5E,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,KAAK,IAAI,IAAI,CAAC;CACf"}
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/storage/index/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,KAAK,EAAE,aAAa,GAAG,UAAU,CAAC;IACzC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACjD,WAAW,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,EAAE,CAAC;IACrD,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACzD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACpC;;;;OAIG;IACH,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5C,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG;QAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACtE,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IACrD,sEAAsE;IACtE,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/D;;;;OAIG;IACH,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,UAAU,EAAE,CAAC;IACzD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACpD;;;OAGG;IACH,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChD;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9D;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;IACtD,4EAA4E;IAC5E,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,KAAK,IAAI,IAAI,CAAC;CACf"}

package/dist/storage/index/schema.d.ts

@@ -1,2 +1,2 @@
-export declare const INDEX_SCHEMA_VERSION = 2;
+export declare const INDEX_SCHEMA_VERSION = 3;
 //# sourceMappingURL=schema.d.ts.map

package/dist/storage/index/schema.js

@@ -1,2 +1,2 @@
-export const INDEX_SCHEMA_VERSION = 2;
+export const INDEX_SCHEMA_VERSION = 3;
 //# sourceMappingURL=schema.js.map

package/dist/storage/index/types.d.ts

@@ -7,9 +7,14 @@ export interface IndexEntry {
     collectedAt: string;
     createdAt: string;
     sizeBytes: number;
+    version: number;
+    dataPointId: string | null;
+    afterTombstoneVersion?: number | null;
 }
-export type NewIndexEntry = Omit<IndexEntry, "id" | "createdAt" | "schemaId"> & {
+export type NewIndexEntry = Omit<IndexEntry, "id" | "createdAt" | "schemaId" | "version" | "dataPointId"> & {
     schemaId?: string | null;
+    version?: number;
+    dataPointId?: string | null;
 };
 export interface IndexListOptions {
     scope?: string;

package/dist/storage/index/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/index/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,UAAU,EACV,IAAI,GAAG,WAAW,GAAG,UAAU,CAChC,GAAG;IACF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAClC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/storage/index/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAIlB,OAAO,EAAE,MAAM,CAAC;IAGhB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAO3B,qBAAqB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,UAAU,EACV,IAAI,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,aAAa,CAC5D,GAAG;IACF,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAIzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAClC,iDAAiD;IACjD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/sync/data-point-feed.d.ts

@@ -0,0 +1,35 @@
+import type { DataPointFeedListOptions, DataPointFeedPort } from "../ports/index.js";
+export interface GatewayDataPointFeedOptions {
+    /** Gateway base URL, e.g. https://dp-rpc.vana.org */
+    gatewayUrl: string;
+    /** Test seam; defaults to the global fetch. */
+    fetch?: typeof fetch;
+    /** Test seam for the fallback `deletedAt` when a 410 body carries none. */
+    now?: () => Date;
+}
+/**
+ * Deletion-aware gateway feed over the same REST endpoints the SDK client
+ * uses, plus the `includeDeleted=true` query the SDK does not expose:
+ *
+ *   GET {gateway}/v1/data?user={owner}&includeDeleted=true[&cursor=..][&since=..][&limit=..]
+ *   GET {gateway}/v1/data/{dataPointId}?includeDeleted=true
+ *
+ * Rows come back with `deletedAt` (null while live). A gateway that answers
+ * the single lookup of a tombstoned point with 410 instead of a row is
+ * normalised into a deleted record so callers never have to catch a 410.
+ */
+export declare function createGatewayDataPointFeed(options: GatewayDataPointFeedOptions): DataPointFeedPort;
+/**
+ * Adapter from the SDK `GatewayClient` listing to the feed shape. Used when a
+ * host wires no dedicated feed: deletions are only visible if the gateway
+ * happens to include `deletedAt` without being asked, so this is a
+ * degraded mode. Prefer `createGatewayDataPointFeed`.
+ */
+export declare function feedFromGatewayClient(gateway: {
+    listDataPointsByOwner(owner: string, cursor: string | null, options?: DataPointFeedListOptions): Promise<{
+        dataPoints: unknown[];
+        cursor: string | null;
+    }>;
+    getDataPoint(dataPointId: string): Promise<unknown | null>;
+}): DataPointFeedPort;
+//# sourceMappingURL=data-point-feed.d.ts.map

package/dist/sync/data-point-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-point-feed.d.ts","sourceRoot":"","sources":["../../src/sync/data-point-feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EAExB,iBAAiB,EAElB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,2BAA2B;IAC1C,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,2EAA2E;IAC3E,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAClB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,2BAA2B,GACnC,iBAAiB,CAuEnB;AA8BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,qBAAqB,CACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,OAAO,CAAC,EAAE,wBAAwB,GACjC,OAAO,CAAC;QAAE,UAAU,EAAE,OAAO,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC7D,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;CAC5D,GAAG,iBAAiB,CAqBpB"}