@gonvex/client 0.1.30 → 0.1.32

package/dist/kv-stores.js

@@ -0,0 +1,447 @@
+import { defaultQueryCacheMaxAgeMs, defaultQueryCacheMaxBytes, defaultQueryCacheMaxBytesPerScope, defaultQueryCacheMaxEntriesPerScope, defaultQueryCacheMaxEntryBytes, } from "./query-cache.js";
+import { defaultSyncStoreMaxBytes, } from "./sync-store.js";
+export const kvQueryCacheTable = "query_cache";
+export const kvSyncCollectionTable = "sync_collections";
+export const kvSyncDirectiveTable = "sync_directives";
+export const kvMutationOutboxTable = "mutation_outbox";
+/** An in-memory {@link GonvexKv} for tests and ephemeral sessions. */
+export function createMemoryGonvexKv() {
+    const tables = new Map();
+    const table = (name) => {
+        let rows = tables.get(name);
+        if (!rows) {
+            rows = new Map();
+            tables.set(name, rows);
+        }
+        return rows;
+    };
+    return {
+        async get(name, key) {
+            return table(name).get(key);
+        },
+        async set(name, key, value) {
+            table(name).set(key, value);
+        },
+        async delete(name, key) {
+            table(name).delete(key);
+        },
+        async list(name) {
+            return [...table(name).entries()].map(([key, value]) => ({ key, value }));
+        },
+        async clear(name, keyPrefix) {
+            const rows = table(name);
+            if (!keyPrefix) {
+                rows.clear();
+                return;
+            }
+            for (const key of [...rows.keys()]) {
+                if (key.startsWith(keyPrefix))
+                    rows.delete(key);
+            }
+        },
+    };
+}
+/**
+ * A {@link QueryCacheStore} over an injected {@link GonvexKv}. Records are
+ * keyed by `scope\u0000path\u0000stableArgs`, revision-guarded like the Dexie
+ * store, and LRU-evicted by `lastAccessedAt` against per-scope and global
+ * caps. A failing backend permanently disables the cache for the session;
+ * server data remains authoritative.
+ */
+export function createKvQueryCacheStore(kv, options = {}) {
+    const maxAgeMs = positive(options.maxAgeMs, defaultQueryCacheMaxAgeMs);
+    const maxEntryBytes = positive(options.maxEntryBytes, defaultQueryCacheMaxEntryBytes);
+    const limits = {
+        maxEntriesPerScope: positive(options.maxEntriesPerScope, defaultQueryCacheMaxEntriesPerScope),
+        maxBytesPerScope: positive(options.maxBytesPerScope, defaultQueryCacheMaxBytesPerScope),
+        maxBytes: positive(options.maxBytes, defaultQueryCacheMaxBytes),
+    };
+    const onScope = options.onScope;
+    let lastEmittedScope;
+    let readsEnabled = true;
+    let writesEnabled = true;
+    let disabledReason;
+    const disable = (reason) => {
+        readsEnabled = false;
+        writesEnabled = false;
+        disabledReason = reason;
+    };
+    return {
+        async read(scope, path, args, ageMs = maxAgeMs) {
+            if (!readsEnabled || !scope)
+                return undefined;
+            try {
+                const key = storageKey(scope, path, args);
+                const record = parseJson(await kv.get(kvQueryCacheTable, key));
+                if (!record)
+                    return undefined;
+                const now = Date.now();
+                if (now - record.writtenAt > Math.min(ageMs, maxAgeMs)) {
+                    await kv.delete(kvQueryCacheTable, key);
+                    return undefined;
+                }
+                record.lastAccessedAt = now;
+                await kv.set(kvQueryCacheTable, key, JSON.stringify(record));
+                return {
+                    result: record.result,
+                    revision: record.revision,
+                    writtenAt: record.writtenAt,
+                    ageMs: now - record.writtenAt,
+                };
+            }
+            catch (error) {
+                disable(errorReason(error, "kv-query-cache-read-failed"));
+                return undefined;
+            }
+        },
+        async write(value) {
+            if (!writesEnabled || !value.scope || !value.revision)
+                return "disabled";
+            try {
+                const sizeBytes = jsonSize(value.result);
+                if (sizeBytes > maxEntryBytes)
+                    return "oversize";
+                const key = storageKey(value.scope, value.path, value.args);
+                const existing = parseJson(await kv.get(kvQueryCacheTable, key));
+                if (existing && existing.revision >= value.revision)
+                    return "older";
+                const now = Date.now();
+                const record = {
+                    scope: value.scope,
+                    path: value.path,
+                    result: value.result,
+                    revision: value.revision,
+                    writtenAt: now,
+                    lastAccessedAt: now,
+                    sizeBytes,
+                };
+                await kv.set(kvQueryCacheTable, key, JSON.stringify(record));
+                await evictQueryCache(kv, limits);
+                if (onScope && lastEmittedScope !== value.scope) {
+                    lastEmittedScope = value.scope;
+                    await onScope(value.scope);
+                }
+                return "written";
+            }
+            catch (error) {
+                disable(errorReason(error, "kv-query-cache-write-failed"));
+                return "error";
+            }
+        },
+        async delete(scope, path, args) {
+            try {
+                await kv.delete(kvQueryCacheTable, storageKey(scope, path, args));
+            }
+            catch {
+                // Cache deletion is best-effort; server data remains authoritative.
+            }
+        },
+        async clear(scope) {
+            try {
+                await kv.clear(kvQueryCacheTable, scope ? `${scope}\u0000` : undefined);
+            }
+            catch {
+                // Clearing a disposable cache must not affect the application.
+            }
+        },
+        status() {
+            return {
+                enabled: readsEnabled || writesEnabled,
+                readsEnabled,
+                writesEnabled,
+                reason: disabledReason,
+            };
+        },
+        close() {
+            // The KV connection belongs to the host and outlives this store.
+        },
+    };
+}
+async function evictQueryCache(kv, limits) {
+    const rows = [];
+    const corrupt = [];
+    for (const { key, value } of await kv.list(kvQueryCacheTable)) {
+        const record = parseJson(value);
+        if (record)
+            rows.push({ key, record });
+        else
+            corrupt.push(key);
+    }
+    rows.sort((left, right) => left.record.lastAccessedAt - right.record.lastAccessedAt);
+    const byScope = new Map();
+    for (const row of rows) {
+        const list = byScope.get(row.record.scope) ?? [];
+        list.push(row);
+        byScope.set(row.record.scope, list);
+    }
+    const evict = new Set(corrupt);
+    let totalBytes = 0;
+    for (const list of byScope.values()) {
+        let scopeBytes = 0;
+        let scopeCount = 0;
+        // Newest first: eviction always drops the least recently used entries.
+        for (let index = list.length - 1; index >= 0; index -= 1) {
+            const row = list[index];
+            if (scopeCount >= limits.maxEntriesPerScope
+                || scopeBytes + row.record.sizeBytes > limits.maxBytesPerScope) {
+                evict.add(row.key);
+                continue;
+            }
+            scopeCount += 1;
+            scopeBytes += row.record.sizeBytes;
+            totalBytes += row.record.sizeBytes;
+        }
+    }
+    for (const row of rows) {
+        if (totalBytes <= limits.maxBytes)
+            break;
+        if (evict.has(row.key))
+            continue;
+        evict.add(row.key);
+        totalBytes -= row.record.sizeBytes;
+    }
+    for (const key of evict)
+        await kv.delete(kvQueryCacheTable, key);
+}
+/**
+ * A {@link SyncStore} over an injected {@link GonvexKv}. Each collection is
+ * one record holding its rows, cursor, and metadata; deltas are applied by
+ * key against the stored rows. Collections are LRU-evicted by
+ * `lastAccessedAt` once the table exceeds `maxBytes`. A failing backend
+ * permanently disables the store for the session.
+ */
+export function createKvSyncStore(kv, options = {}) {
+    const maxBytes = positive(options.maxBytes, defaultSyncStoreMaxBytes);
+    let disabled = false;
+    const loadRecord = async (key) => parseJson(await kv.get(kvSyncCollectionTable, key));
+    const persist = async (key, value) => {
+        const record = {
+            ...value,
+            rowsUnchanged: undefined,
+            lastAccessedAt: Date.now(),
+            sizeBytes: jsonSize(value.rows),
+        };
+        await kv.set(kvSyncCollectionTable, key, JSON.stringify(record));
+        await evictSyncCollections(kv, maxBytes);
+    };
+    return {
+        async load(scope, path, args) {
+            if (disabled || !scope)
+                return undefined;
+            try {
+                const key = storageKey(scope, path, args);
+                const record = await loadRecord(key);
+                if (!record)
+                    return undefined;
+                record.lastAccessedAt = Date.now();
+                await kv.set(kvSyncCollectionTable, key, JSON.stringify(record));
+                const { lastAccessedAt: _lastAccessedAt, sizeBytes: _sizeBytes, ...collection } = record;
+                return collection;
+            }
+            catch {
+                disabled = true;
+                return undefined;
+            }
+        },
+        async replace(scope, path, args, value) {
+            if (disabled || !scope)
+                return;
+            try {
+                const key = storageKey(scope, path, args);
+                if (value.rowsUnchanged) {
+                    const existing = await loadRecord(key);
+                    // The caller proved the rows are byte-identical, so only advance
+                    // the cursor/metadata. A missing record falls through to a full
+                    // write.
+                    if (existing) {
+                        await persist(key, {
+                            ...existing,
+                            cursor: value.cursor,
+                            keyField: value.keyField,
+                            mode: value.mode,
+                            truncated: value.truncated,
+                            orderBy: value.orderBy,
+                            orderDirection: value.orderDirection,
+                            maxRows: value.maxRows,
+                            maxBytes: value.maxBytes,
+                            hashes: value.hashes,
+                        });
+                        return;
+                    }
+                }
+                await persist(key, value);
+            }
+            catch {
+                disabled = true;
+            }
+        },
+        async applyDelta(scope, path, args, value) {
+            if (disabled || !scope)
+                return;
+            try {
+                const key = storageKey(scope, path, args);
+                const existing = await loadRecord(key);
+                const keyField = value.keyField || existing?.keyField || "_id";
+                const deleted = new Set(value.deleted.map(String));
+                const kept = (existing?.rows ?? []).filter((row) => !deleted.has(rowKey(row, keyField)));
+                const byKey = new Map(kept.map((row) => [rowKey(row, keyField), row]));
+                for (const upsert of value.upserts) {
+                    const id = rowKey(upsert, keyField);
+                    if (!id)
+                        continue;
+                    byKey.set(id, upsert);
+                }
+                await persist(key, {
+                    rows: [...byKey.values()],
+                    cursor: value.cursor,
+                    keyField,
+                    mode: value.mode ?? existing?.mode,
+                    truncated: value.truncated,
+                    orderBy: value.orderBy ?? existing?.orderBy,
+                    orderDirection: value.orderDirection ?? existing?.orderDirection,
+                    maxRows: value.maxRows ?? existing?.maxRows,
+                    maxBytes: value.maxBytes ?? existing?.maxBytes,
+                    hashes: value.hashes ?? existing?.hashes,
+                });
+            }
+            catch {
+                disabled = true;
+            }
+        },
+        async delete(scope, path, args) {
+            try {
+                await kv.delete(kvSyncCollectionTable, storageKey(scope, path, args));
+            }
+            catch {
+                // Disposable local data must never break the application.
+            }
+        },
+        async loadDirective(identity) {
+            if (!identity)
+                return undefined;
+            try {
+                return parseJson(await kv.get(kvSyncDirectiveTable, identity));
+            }
+            catch {
+                return undefined;
+            }
+        },
+        async saveDirective(identity, directive) {
+            if (!identity)
+                return;
+            try {
+                await kv.set(kvSyncDirectiveTable, identity, JSON.stringify(directive));
+            }
+            catch {
+                // Warm-start metadata is an optimization, never a request prerequisite.
+            }
+        },
+        async clear(scope) {
+            try {
+                await kv.clear(kvSyncCollectionTable, scope ? `${scope}\u0000` : undefined);
+                if (!scope)
+                    await kv.clear(kvSyncDirectiveTable);
+            }
+            catch {
+                // Disposable local data must never break the application.
+            }
+        },
+        close() {
+            // The KV connection belongs to the host and outlives this store.
+        },
+    };
+}
+async function evictSyncCollections(kv, maxBytes) {
+    const rows = [];
+    for (const { key, value } of await kv.list(kvSyncCollectionTable)) {
+        const record = parseJson(value);
+        if (record)
+            rows.push({ key, record });
+        else
+            await kv.delete(kvSyncCollectionTable, key);
+    }
+    rows.sort((left, right) => left.record.lastAccessedAt - right.record.lastAccessedAt);
+    let total = rows.reduce((sum, row) => sum + (row.record.sizeBytes || 0), 0);
+    for (const row of rows) {
+        if (total <= maxBytes)
+            break;
+        await kv.delete(kvSyncCollectionTable, row.key);
+        total -= row.record.sizeBytes || 0;
+    }
+}
+/**
+ * An {@link OutboxStore} over an injected {@link GonvexKv}. Entries are
+ * whole JSON records keyed by their queue id; ordering, causal barriers, and
+ * inflight recovery stay in {@link StoreMutationOutbox}.
+ */
+export function createKvOutboxStore(kv) {
+    return {
+        async load() {
+            const entries = [];
+            for (const { value } of await kv.list(kvMutationOutboxTable)) {
+                // A corrupt row must not strand every other queued mutation.
+                const entry = parseJson(value);
+                if (entry && typeof entry.id === "number")
+                    entries.push(entry);
+            }
+            return entries.sort((left, right) => left.id - right.id);
+        },
+        async put(entry) {
+            await kv.set(kvMutationOutboxTable, String(entry.id), JSON.stringify(entry));
+        },
+        async delete(id) {
+            await kv.delete(kvMutationOutboxTable, String(id));
+        },
+        async clear(scope) {
+            if (scope === undefined) {
+                await kv.clear(kvMutationOutboxTable);
+                return;
+            }
+            for (const { key, value } of await kv.list(kvMutationOutboxTable)) {
+                if (parseJson(value)?.scope === scope) {
+                    await kv.delete(kvMutationOutboxTable, key);
+                }
+            }
+        },
+    };
+}
+function storageKey(scope, path, args) {
+    return `${scope}\u0000${path}\u0000${stableStringify(args ?? {})}`;
+}
+function stableStringify(value) {
+    if (value === null || typeof value !== "object")
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(stableStringify).join(",")}]`;
+    const record = value;
+    return `{${Object.keys(record)
+        .sort()
+        .map((key) => `${JSON.stringify(key)}:${stableStringify(record[key])}`)
+        .join(",")}}`;
+}
+function parseJson(value) {
+    if (value === undefined)
+        return undefined;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function rowKey(row, keyField) {
+    if (!row || Array.isArray(row) || typeof row !== "object")
+        return "";
+    const candidate = row[keyField];
+    return typeof candidate === "string" || typeof candidate === "number" ? String(candidate) : "";
+}
+function jsonSize(value) {
+    return new TextEncoder().encode(JSON.stringify(value ?? null)).byteLength;
+}
+function errorReason(error, fallback) {
+    return error instanceof Error ? error.message || error.name : fallback;
+}
+function positive(value, fallback) {
+    return value !== undefined && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+//# sourceMappingURL=kv-stores.js.map

package/dist/kv-stores.js.map

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

package/dist/optimistic.d.ts

@@ -1,41 +1,73 @@
 export type Row = Record<string, unknown>;
+export type OptimisticProjection = {
+    entity: string;
+    key: string;
+    resultPath: readonly string[];
+};
+export type OptimisticMutationDefinition = {
+    entity: string;
+    rowIdPath: readonly string[];
+    fieldsPath: readonly string[];
+};
 type OptimisticRowPatch = {
-    collection: string;
+    /** Canonical entity/table name. `collection` remains a compatibility alias. */
+    entity?: string;
+    collection?: string;
     rowId: string;
     op: "patch" | "insert";
     fields: Record<string, unknown>;
 };
 type OptimisticDeletePatch = {
-    collection: string;
+    entity?: string;
+    collection?: string;
     rowId: string;
     op: "delete";
     fields?: never;
 };
 export type OptimisticPatch = OptimisticRowPatch | OptimisticDeletePatch;
 /**
- * An ordered, in-memory view of mutations that have not settled yet.
+ * Ordered pending entity mutations layered over immutable authoritative data.
  *
- * Authoritative sync rows remain untouched. Consumers materialize this overlay
- * at read time, so rejecting an entry simply reveals the current server state.
+ * A source is one concrete sync/query subscription (including its arguments).
+ * Successful mutations remain pending until every source that exposed the
+ * optimistic row reports that mutation id in an authoritative update. This
+ * prevents a fast RPC acknowledgement from revealing an older subscription
+ * snapshot while its invalidation is still in flight.
  */
 export declare class OptimisticOverlay {
     private readonly entries;
     private readonly listeners;
     private readonly cache;
     private version;
-    /** Append a mutation's patches after every currently pending mutation. */
-    add(mutationId: string, patches: OptimisticPatch[]): void;
-    /** Remove patches after a successful authoritative server result. */
+    private settling;
+    add(mutationId: string, patches: OptimisticPatch[], options?: {
+        accepted?: boolean;
+    }): void;
+    /** Reserve a live projection even when its first snapshot is still pending. */
+    expectSource(source: string, entity: string): void;
+    /** Mark the transport result successful without dropping visible optimism. */
+    accept(mutationId: string): string[];
+    /** Compatibility alias. Prefer accept followed by authoritative acknowledge. */
     settle(mutationId: string): void;
     /** Remove patches after a deterministic server rejection. */
     reject(mutationId: string): void;
-    /** Materialize one collection without mutating its authoritative rows. */
-    apply(collection: string, rows: readonly Row[], keyField: string): Row[];
-    /** Subscribe to collections whose materialized rows may have changed. */
-    subscribe(listener: (collection: string) => void): () => void;
-    /** Whether any pending mutation touches this collection row. */
-    pendingFor(collection: string, rowId: string): boolean;
+    /**
+     * Materialize entity rows for a concrete source. The three-argument overload
+     * preserves the original collection-path API by using the entity as source.
+     */
+    apply(entity: string, rows: readonly Row[], keyField: string): Row[];
+    apply(source: string, entity: string, rows: readonly Row[], keyField: string): Row[];
+    /** Record authoritative delivery for a source; returns fully reconciled ids. */
+    acknowledge(source: string, mutationIds: readonly string[] | undefined): string[];
+    /** Reconcile restored committed entries against an authoritative snapshot. */
+    acknowledgeMatching(source: string, entity: string, rows: readonly Row[], keyField: string): string[];
+    /** Stop waiting for a subscription that no longer exists. */
+    removeSource(source: string): string[];
+    subscribe(listener: (entity: string) => void): () => void;
+    pendingFor(entity: string, rowId: string): boolean;
+    private settleReadyEntries;
     private remove;
     private changed;
 }
+export declare function optimisticPatchesFromReference(definition: OptimisticMutationDefinition | undefined, args: unknown): OptimisticPatch[];
 export {};