@opendatalabs/personal-server-ts-core 0.0.1-canary.016adf9 → 0.0.1-canary.052d47e

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

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

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

@@ -1,4 +1,2 @@
-import Database from "better-sqlite3";
-/** Open/create SQLite database, run CREATE TABLE IF NOT EXISTS, set WAL mode */
-export declare function initializeDatabase(dbPath: string): Database.Database;
+export declare const INDEX_SCHEMA_VERSION = 3;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAmBtC,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAWpE"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,IAAI,CAAC"}

package/dist/storage/index/schema.js

@@ -1,27 +1,2 @@
-import Database from "better-sqlite3";
-const CREATE_TABLE_SQL = `
-CREATE TABLE IF NOT EXISTS data_files (
-  id INTEGER PRIMARY KEY AUTOINCREMENT,
-  file_id TEXT,
-  path TEXT NOT NULL UNIQUE,
-  scope TEXT NOT NULL,
-  collected_at TEXT NOT NULL,
-  created_at TEXT NOT NULL DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now')),
-  size_bytes INTEGER NOT NULL DEFAULT 0
-)`;
-const CREATE_INDEXES_SQL = [
-    "CREATE INDEX IF NOT EXISTS idx_data_files_scope ON data_files (scope)",
-    "CREATE INDEX IF NOT EXISTS idx_data_files_collected_at ON data_files (collected_at)",
-    "CREATE INDEX IF NOT EXISTS idx_data_files_file_id ON data_files (file_id)",
-];
-/** Open/create SQLite database, run CREATE TABLE IF NOT EXISTS, set WAL mode */
-export function initializeDatabase(dbPath) {
-    const db = new Database(dbPath);
-    db.pragma("journal_mode = WAL");
-    db.exec(CREATE_TABLE_SQL);
-    for (const sql of CREATE_INDEXES_SQL) {
-        db.exec(sql);
-    }
-    return db;
-}
+export const INDEX_SCHEMA_VERSION = 3;
 //# sourceMappingURL=schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,gBAAgB,GAAG;;;;;;;;;EASvB,CAAC;AAEH,MAAM,kBAAkB,GAAG;IACzB,uEAAuE;IACvE,qFAAqF;IACrF,2EAA2E;CAC5E,CAAC;AAEF,gFAAgF;AAChF,MAAM,UAAU,kBAAkB,CAAC,MAAc;IAC/C,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAC1B,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;QACrC,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/storage/index/schema.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC"}

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

@@ -1,12 +1,21 @@
 export interface IndexEntry {
     id: number;
     fileId: string | null;
+    schemaId: string | null;
     path: string;
     scope: string;
     collectedAt: string;
     createdAt: string;
     sizeBytes: number;
+    version: number;
+    dataPointId: string | null;
+    afterTombstoneVersion?: number | null;
 }
+export type NewIndexEntry = Omit<IndexEntry, "id" | "createdAt" | "schemaId" | "version" | "dataPointId"> & {
+    schemaId?: string | null;
+    version?: number;
+    dataPointId?: string | null;
+};
 export interface IndexListOptions {
     scope?: string;
     limit?: number;
@@ -16,5 +25,13 @@ export interface ScopeSummary {
     scope: string;
     latestCollectedAt: string;
     versionCount: number;
+    /**
+     * Whether bounded block reads for the latest local version are ready.
+     * Existing data can appear in the index before the block sidecar finishes
+     * indexing; MCP reads require the sidecar.
+     */
+    dataStatus?: "ready" | "indexing";
+    /** Size in bytes of the latest local version. */
+    sizeBytes?: number;
 }
 //# sourceMappingURL=types.d.ts.map

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,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,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;CACtB"}
+{"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/storage/preview.d.ts

@@ -0,0 +1,12 @@
+export interface EnvelopePreview {
+    text: string;
+    truncated: boolean;
+}
+export declare function previewEnvelopeValue(envelope: unknown, maxBytes: number, options?: {
+    nodeBudget?: number;
+}): EnvelopePreview;
+export declare function previewJsonEnvelopePrefix(jsonText: string, maxBytes: number, options?: {
+    sourceTruncated?: boolean;
+    nodeBudget?: number;
+}): EnvelopePreview;
+//# sourceMappingURL=preview.d.ts.map

package/dist/storage/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../../src/storage/preview.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;CACpB;AAoED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GACpC,eAAe,CAwDjB;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,eAAe,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,eAAe,CAiDjB"}

package/dist/storage/preview.js

@@ -0,0 +1,239 @@
+const DEFAULT_PREVIEW_NODE_BUDGET = 15_000;
+const textEncoder = new TextEncoder();
+function utf8Length(text) {
+    return textEncoder.encode(text).byteLength;
+}
+function clipToUtf8Bytes(text, maxBytes) {
+    if (maxBytes <= 0)
+        return "";
+    if (utf8Length(text) <= maxBytes)
+        return text;
+    let low = 0;
+    let high = text.length;
+    while (low < high) {
+        const mid = Math.ceil((low + high) / 2);
+        if (utf8Length(text.slice(0, mid)) <= maxBytes) {
+            low = mid;
+        }
+        else {
+            high = mid - 1;
+        }
+    }
+    let clipped = text.slice(0, low);
+    const last = clipped.charCodeAt(clipped.length - 1);
+    if (last >= 0xd800 && last <= 0xdbff) {
+        clipped = clipped.slice(0, -1);
+    }
+    return clipped;
+}
+function appendPreviewToken(chunks, token, maxBytes, state) {
+    if (!token)
+        return true;
+    const text = chunks.length > 0 ? `\n${token}` : token;
+    const remaining = maxBytes - state.bytes;
+    if (remaining <= 0) {
+        state.truncated = true;
+        return false;
+    }
+    const encodedBytes = utf8Length(text);
+    if (encodedBytes <= remaining) {
+        chunks.push(text);
+        state.bytes += encodedBytes;
+        return true;
+    }
+    const clipped = clipToUtf8Bytes(text, remaining);
+    if (clipped) {
+        chunks.push(clipped);
+        state.bytes += utf8Length(clipped);
+    }
+    state.truncated = true;
+    return false;
+}
+export function previewEnvelopeValue(envelope, maxBytes, options = {}) {
+    const chunks = [];
+    const stack = [envelope];
+    const state = { bytes: 0, truncated: false };
+    const seen = new WeakSet();
+    const nodeBudget = options.nodeBudget ?? DEFAULT_PREVIEW_NODE_BUDGET;
+    let nodes = 0;
+    while (stack.length > 0) {
+        if (nodes >= nodeBudget) {
+            state.truncated = true;
+            break;
+        }
+        const current = stack.pop();
+        nodes += 1;
+        if (typeof current === "string") {
+            if (!appendPreviewToken(chunks, current, maxBytes, state))
+                break;
+            continue;
+        }
+        if (typeof current === "number" ||
+            typeof current === "boolean" ||
+            typeof current === "bigint") {
+            if (!appendPreviewToken(chunks, String(current), maxBytes, state))
+                break;
+            continue;
+        }
+        if (Array.isArray(current)) {
+            if (seen.has(current))
+                continue;
+            seen.add(current);
+            for (let index = current.length - 1; index >= 0; index -= 1) {
+                stack.push(current[index]);
+            }
+            continue;
+        }
+        if (typeof current === "object" && current !== null) {
+            if (seen.has(current))
+                continue;
+            seen.add(current);
+            const entries = Object.entries(current);
+            for (let index = entries.length - 1; index >= 0; index -= 1) {
+                const [key, value] = entries[index];
+                stack.push(value);
+                stack.push(key);
+            }
+        }
+    }
+    return {
+        text: chunks.join(""),
+        truncated: state.truncated,
+    };
+}
+export function previewJsonEnvelopePrefix(jsonText, maxBytes, options = {}) {
+    const chunks = [];
+    const state = {
+        bytes: 0,
+        truncated: options.sourceTruncated ?? false,
+    };
+    const nodeBudget = options.nodeBudget ?? DEFAULT_PREVIEW_NODE_BUDGET;
+    let nodes = 0;
+    let index = 0;
+    while (index < jsonText.length) {
+        if (nodes >= nodeBudget) {
+            state.truncated = true;
+            break;
+        }
+        const char = jsonText[index];
+        if (char === '"') {
+            const token = readJsonStringToken(jsonText, index + 1);
+            nodes += 1;
+            if (!appendPreviewToken(chunks, token.value, maxBytes, state))
+                break;
+            state.truncated = state.truncated || token.truncated;
+            index = token.nextIndex;
+            continue;
+        }
+        if (char && /[-0-9]/u.test(char)) {
+            const token = readJsonNumberToken(jsonText, index);
+            nodes += 1;
+            if (!appendPreviewToken(chunks, token.value, maxBytes, state))
+                break;
+            index = token.nextIndex;
+            continue;
+        }
+        const literal = readJsonLiteralToken(jsonText, index);
+        if (literal) {
+            nodes += 1;
+            if (!appendPreviewToken(chunks, literal.value, maxBytes, state))
+                break;
+            index = literal.nextIndex;
+            continue;
+        }
+        index += 1;
+    }
+    return {
+        text: chunks.join(""),
+        truncated: state.truncated,
+    };
+}
+function readJsonStringToken(text, startIndex) {
+    let value = "";
+    let index = startIndex;
+    let truncated = true;
+    while (index < text.length) {
+        const char = text[index];
+        if (char === '"') {
+            truncated = false;
+            index += 1;
+            break;
+        }
+        if (char !== "\\") {
+            value += char;
+            index += 1;
+            continue;
+        }
+        const escaped = text[index + 1];
+        if (!escaped) {
+            index = text.length;
+            break;
+        }
+        switch (escaped) {
+            case '"':
+            case "\\":
+            case "/":
+                value += escaped;
+                index += 2;
+                break;
+            case "b":
+                value += "\b";
+                index += 2;
+                break;
+            case "f":
+                value += "\f";
+                index += 2;
+                break;
+            case "n":
+                value += "\n";
+                index += 2;
+                break;
+            case "r":
+                value += "\r";
+                index += 2;
+                break;
+            case "t":
+                value += "\t";
+                index += 2;
+                break;
+            case "u": {
+                const hex = text.slice(index + 2, index + 6);
+                if (!/^[0-9a-fA-F]{4}$/u.test(hex)) {
+                    index = text.length;
+                    break;
+                }
+                value += String.fromCharCode(Number.parseInt(hex, 16));
+                index += 6;
+                break;
+            }
+            default:
+                value += escaped;
+                index += 2;
+                break;
+        }
+    }
+    return { value, nextIndex: index, truncated };
+}
+function readJsonNumberToken(text, startIndex) {
+    let index = startIndex;
+    while (index < text.length && /[-+0-9.eE]/u.test(text[index])) {
+        index += 1;
+    }
+    return {
+        value: text.slice(startIndex, index),
+        nextIndex: index,
+    };
+}
+function readJsonLiteralToken(text, startIndex) {
+    if (text.startsWith("true", startIndex)) {
+        return { value: "true", nextIndex: startIndex + 4 };
+    }
+    if (text.startsWith("false", startIndex)) {
+        return { value: "false", nextIndex: startIndex + 5 };
+    }
+    if (text.startsWith("null", startIndex)) {
+        return { value: "null", nextIndex: startIndex + 4 };
+    }
+    return null;
+}
+//# sourceMappingURL=preview.js.map

package/dist/storage/preview.js.map

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

package/dist/sync/cursor.d.ts

@@ -1,12 +1,10 @@
 export interface SyncCursor {
-    /** Read the lastProcessedTimestamp from config.json */
+    /** Read the lastProcessedTimestamp from cursor state. */
     read(): Promise<string | null>;
-    /** Write the lastProcessedTimestamp to config.json */
+    /** Write the lastProcessedTimestamp to cursor state. */
     write(timestamp: string): Promise<void>;
 }
-/**
- * Creates a cursor that reads/writes sync.lastProcessedTimestamp in config.json.
- * Uses loadConfig/saveConfig to preserve other config fields.
- */
-export declare function createSyncCursor(configPath: string): SyncCursor;
+export interface SyncCursorOptions {
+    legacyConfigPath?: string;
+}
 //# sourceMappingURL=cursor.d.ts.map

package/dist/sync/cursor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,uDAAuD;IACvD,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/B,sDAAsD;IACtD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAa/D"}
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,yDAAyD;IACzD,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE/B,wDAAwD;IACxD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/sync/cursor.js

@@ -1,19 +1,2 @@
-import { loadConfig, saveConfig } from "../config/index.js";
-/**
- * Creates a cursor that reads/writes sync.lastProcessedTimestamp in config.json.
- * Uses loadConfig/saveConfig to preserve other config fields.
- */
-export function createSyncCursor(configPath) {
-    return {
-        async read() {
-            const config = await loadConfig({ configPath });
-            return config.sync.lastProcessedTimestamp;
-        },
-        async write(timestamp) {
-            const config = await loadConfig({ configPath });
-            config.sync.lastProcessedTimestamp = timestamp;
-            await saveConfig(config, { configPath });
-        },
-    };
-}
+export {};
 //# sourceMappingURL=cursor.js.map

package/dist/sync/cursor.js.map

@@ -1 +1 @@
-{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAU5D;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,OAAO;QACL,KAAK,CAAC,IAAI;YACR,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAChD,OAAO,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC;QAC5C,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,SAAS;YACnB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAChD,MAAM,CAAC,IAAI,CAAC,sBAAsB,GAAG,SAAS,CAAC;YAC/C,MAAM,UAAU,CAAC,MAAM,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC;QAC3C,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/sync/cursor.ts"],"names":[],"mappings":""}

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"}

package/dist/sync/data-point-feed.js

@@ -0,0 +1,122 @@
+import { computeDataPointId } from "./data-point-id.js";
+import { TOMBSTONE_DATA_HASH, TOMBSTONE_METADATA_HASH } from "./tombstone.js";
+/**
+ * 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 function createGatewayDataPointFeed(options) {
+    const base = options.gatewayUrl.replace(/\/+$/, "");
+    const fetchImpl = options.fetch ?? globalThis.fetch;
+    const now = options.now ?? (() => new Date());
+    return {
+        async listDataPointsByOwner(owner, cursor, listOptions) {
+            const params = new URLSearchParams({ user: owner });
+            if (cursor !== null)
+                params.set("cursor", cursor);
+            if (listOptions?.since)
+                params.set("since", listOptions.since);
+            if (listOptions?.limit !== undefined) {
+                params.set("limit", String(listOptions.limit));
+            }
+            if (listOptions?.includeDeleted)
+                params.set("includeDeleted", "true");
+            const res = await fetchImpl(`${base}/v1/data?${params.toString()}`);
+            if (!res.ok) {
+                throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+            }
+            const envelope = (await res.json());
+            const nextCursor = envelope.pagination?.hasMore === false
+                ? null
+                : (envelope.pagination?.nextCursor ?? null);
+            const rows = envelope.data?.dataPoints ?? [];
+            return {
+                dataPoints: rows.map((row) => normalizeRecord(row)),
+                cursor: nextCursor,
+            };
+        },
+        async getDataPoint(input) {
+            const dataPointId = computeDataPointId(input.ownerAddress, input.scope);
+            const res = await fetchImpl(`${base}/v1/data/${dataPointId}?includeDeleted=true`);
+            if (res.status === 404)
+                return null;
+            if (res.status === 410) {
+                // Tombstoned. Prefer the row the gateway echoes in the 410 body;
+                // otherwise synthesise the minimum a caller needs to treat the point
+                // as deleted "at or before now".
+                const body = await res.json().catch(() => null);
+                const echoed = unwrap(body);
+                const deletedAt = stringField(echoed, "deletedAt") ?? now().toISOString();
+                return {
+                    id: dataPointId,
+                    ownerAddress: input.ownerAddress,
+                    scope: input.scope,
+                    dataHash: stringField(echoed, "dataHash") ?? TOMBSTONE_DATA_HASH,
+                    metadataHash: stringField(echoed, "metadataHash") ?? TOMBSTONE_METADATA_HASH,
+                    expectedVersion: stringField(echoed, "expectedVersion") ?? "0",
+                    addedAt: stringField(echoed, "addedAt") ?? deletedAt,
+                    deletedAt,
+                };
+            }
+            if (!res.ok) {
+                throw new Error(`Gateway error: ${res.status} ${res.statusText}`);
+            }
+            const body = await res.json();
+            return normalizeRecord(unwrap(body));
+        },
+    };
+}
+// The gateway wraps single-resource responses as `{ data: {...} }` (the SDK's
+// unwrapEnvelope); tolerate a bare object too.
+function unwrap(body) {
+    if (typeof body !== "object" || body === null)
+        return null;
+    const record = body;
+    if (typeof record.data === "object" && record.data !== null) {
+        return record.data;
+    }
+    return record;
+}
+function stringField(record, key) {
+    const value = record?.[key];
+    return typeof value === "string" ? value : undefined;
+}
+function normalizeRecord(row) {
+    const record = (row ?? {});
+    const deletedAt = record.deletedAt;
+    return {
+        ...record,
+        deletedAt: typeof deletedAt === "string" ? deletedAt : null,
+    };
+}
+/**
+ * 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 function feedFromGatewayClient(gateway) {
+    return {
+        async listDataPointsByOwner(owner, cursor, listOptions) {
+            const { includeDeleted: _includeDeleted, ...sdkOptions } = listOptions ?? {};
+            const result = Object.keys(sdkOptions).length > 0
+                ? await gateway.listDataPointsByOwner(owner, cursor, sdkOptions)
+                : await gateway.listDataPointsByOwner(owner, cursor);
+            return {
+                dataPoints: result.dataPoints.map((row) => normalizeRecord(row)),
+                cursor: result.cursor,
+            };
+        },
+        async getDataPoint(input) {
+            const row = await gateway.getDataPoint(computeDataPointId(input.ownerAddress, input.scope));
+            return row === null ? null : normalizeRecord(row);
+        },
+    };
+}
+//# sourceMappingURL=data-point-feed.js.map

package/dist/sync/data-point-feed.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Deterministic DPv2 data-point id: `keccak256(abi.encode(owner, scope))`,
+ * the same primary key DataRegistryV2 and the gateway use. Every version of
+ * a scope shares this id; the registry row carries the current version.
+ */
+export declare function computeDataPointId(ownerAddress: string, scope: string): `0x${string}`;
+//# sourceMappingURL=data-point-id.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"data-point-id.d.ts","sourceRoot":"","sources":["../../src/sync/data-point-id.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,GACZ,KAAK,MAAM,EAAE,CAaf"}

package/dist/sync/data-point-id.js

@@ -0,0 +1,16 @@
+import { encodeAbiParameters, keccak256 } from "viem";
+/**
+ * Deterministic DPv2 data-point id: `keccak256(abi.encode(owner, scope))`,
+ * the same primary key DataRegistryV2 and the gateway use. Every version of
+ * a scope shares this id; the registry row carries the current version.
+ */
+export function computeDataPointId(ownerAddress, scope) {
+    // ABI-encoding an address is checksum-insensitive (same bytes either way),
+    // but viem rejects mixed-case strings that fail checksum validation;
+    // normalize so config-sourced owner strings can't trip it.
+    return keccak256(encodeAbiParameters([
+        { name: "ownerAddress", type: "address" },
+        { name: "scope", type: "string" },
+    ], [ownerAddress.toLowerCase(), scope]));
+}
+//# sourceMappingURL=data-point-id.js.map

package/dist/sync/data-point-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-point-id.js","sourceRoot":"","sources":["../../src/sync/data-point-id.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAChC,YAAoB,EACpB,KAAa;IAEb,2EAA2E;IAC3E,qEAAqE;IACrE,2DAA2D;IAC3D,OAAO,SAAS,CACd,mBAAmB,CACjB;QACE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,SAAS,EAAE;QACzC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE;KAClC,EACD,CAAC,YAAY,CAAC,WAAW,EAAmB,EAAE,KAAK,CAAC,CACrD,CACF,CAAC;AACJ,CAAC"}