@gonvex/client 0.1.31 → 0.3.0

package/dist/indexeddb-replica.js

@@ -0,0 +1,193 @@
+import { Dexie } from "dexie";
+const defaultReplicaScope = "default";
+const replicaSchemaVersion = 3;
+/** Atomic normalized web persistence for the Gonvex Local Replica. */
+export class IndexedDBLocalReplicaStorage {
+    database;
+    initialized;
+    constructor(name = "gonvex-local-replica") {
+        this.database = new Dexie(name);
+        this.database.version(1).stores({ snapshots: "&key" });
+        this.database.version(2).stores({ snapshots: "&scope" }).upgrade(async (transaction) => {
+            await transaction.table("snapshots").toCollection().modify((record) => {
+                record.scope = defaultReplicaScope;
+                delete record.key;
+            });
+        });
+        this.database.version(replicaSchemaVersion).stores({
+            entities: "[scope+entity+id], scope, [scope+entity]",
+            windows: "[scope+signature], scope",
+            meta: "[scope+key], scope",
+            // Retain the old table only as a one-time upgrade source. It is never
+            // read after initialization and is removed from the active schema.
+            snapshots: "&scope",
+        }).upgrade(async (transaction) => {
+            const snapshots = await transaction.table("snapshots").toArray();
+            const entities = transaction.table("entities");
+            const windows = transaction.table("windows");
+            const meta = transaction.table("meta");
+            for (const record of snapshots) {
+                const scope = record.scope ?? defaultReplicaScope;
+                const snapshot = record.snapshot;
+                for (const [entity, rows] of Object.entries(snapshot.entities ?? {})) {
+                    for (const [id, value] of Object.entries(rows)) {
+                        await entities.put({ scope, entity, id, value: JSON.stringify(value) });
+                    }
+                }
+                for (const [signature, window] of Object.entries(snapshot.liveQueries ?? {})) {
+                    await windows.put({ scope, signature, value: JSON.stringify(window) });
+                }
+                if (snapshot.cursor) {
+                    await meta.put({ scope, key: "cursor", value: JSON.stringify(snapshot.cursor) });
+                }
+            }
+            // The upgrade transaction is atomic: only remove the legacy full
+            // snapshots after every entity/window/cursor has been copied into the
+            // normalized stores. Keeping the source rows would retain a second,
+            // row-bearing server-state store indefinitely.
+            await transaction.table("snapshots").clear();
+        });
+    }
+    initialize() {
+        return this.initialized ??= this.database.open().then(() => undefined);
+    }
+    async load(scope = defaultReplicaScope) {
+        await this.initialize();
+        const normalizedScope = normalizeScope(scope);
+        const [entityRecords, windowRecords, cursor] = await Promise.all([
+            this.database.entities.where("scope").equals(normalizedScope).toArray(),
+            this.database.windows.where("scope").equals(normalizedScope).toArray(),
+            this.database.meta.get([normalizedScope, "cursor"]),
+        ]);
+        if (entityRecords.length === 0 && windowRecords.length === 0 && !cursor)
+            return undefined;
+        const entities = {};
+        for (const record of entityRecords)
+            (entities[record.entity] ??= {})[record.id] = JSON.parse(record.value);
+        const liveQueries = {};
+        for (const record of windowRecords)
+            liveQueries[record.signature] = JSON.parse(record.value);
+        return {
+            cursor: cursor ? JSON.parse(cursor.value) : undefined,
+            entities,
+            liveQueries,
+        };
+    }
+    async applyTransaction(transaction, _snapshot, scope = defaultReplicaScope) {
+        await this.initialize();
+        const normalizedScope = normalizeScope(scope);
+        await this.database.transaction("rw", this.database.entities, this.database.windows, this.database.meta, async () => {
+            const previous = await this.database.meta.get([normalizedScope, "cursor"]);
+            if (previous && JSON.parse(previous.value).epoch !== transaction.cursor.epoch) {
+                await this.database.entities.where("scope").equals(normalizedScope).delete();
+                await this.database.windows.where("scope").equals(normalizedScope).delete();
+            }
+            for (const change of transaction.changes) {
+                if (change.operation === "delete") {
+                    await this.database.entities.delete([normalizedScope, change.entity, change.id]);
+                    const windows = await this.database.windows.where("scope").equals(normalizedScope).toArray();
+                    for (const record of windows) {
+                        const window = JSON.parse(record.value);
+                        if (!window.ids.includes(change.id))
+                            continue;
+                        window.ids = window.ids.filter((id) => id !== change.id);
+                        await this.database.windows.put({ ...record, value: JSON.stringify(window) });
+                    }
+                }
+                else if (change.newValue) {
+                    await this.database.entities.put({
+                        scope: normalizedScope,
+                        entity: change.entity,
+                        id: change.id,
+                        value: JSON.stringify(change.newValue),
+                    });
+                }
+            }
+            for (const membership of transaction.memberships ?? []) {
+                await this.database.windows.put({
+                    scope: normalizedScope,
+                    signature: membership.signature,
+                    value: JSON.stringify(normalizeWindow(membership)),
+                });
+            }
+            await this.database.meta.put({ scope: normalizedScope, key: "cursor", value: JSON.stringify(transaction.cursor) });
+        });
+    }
+    async replaceWindow(window, snapshot, scope = defaultReplicaScope) {
+        await this.initialize();
+        const normalizedScope = normalizeScope(scope);
+        await this.database.transaction("rw", this.database.entities, this.database.windows, this.database.meta, async () => {
+            for (const [entity, rows] of Object.entries(snapshot.entities)) {
+                for (const [id, value] of Object.entries(rows)) {
+                    await this.database.entities.put({ scope: normalizedScope, entity, id, value: JSON.stringify(value) });
+                }
+            }
+            await this.database.windows.put({ scope: normalizedScope, signature: window.signature, value: JSON.stringify(normalizeWindow(window)) });
+            if (snapshot.cursor)
+                await this.database.meta.put({ scope: normalizedScope, key: "cursor", value: JSON.stringify(snapshot.cursor) });
+        });
+    }
+    async applyWindowDelta(window, _delta, snapshot, scope = defaultReplicaScope) {
+        // The in-memory replica has already computed the normalized result. The
+        // storage transaction receives that result and persists it atomically;
+        // retaining unrelated entities is deliberate and conservative.
+        await this.replaceWindow(window, snapshot, scope);
+    }
+    async removeWindow(signature, snapshot, scope = defaultReplicaScope) {
+        await this.initialize();
+        const normalizedScope = normalizeScope(scope);
+        await this.database.transaction("rw", this.database.windows, this.database.meta, async () => {
+            await this.database.windows.delete([normalizedScope, signature]);
+            if (snapshot.cursor)
+                await this.database.meta.put({ scope: normalizedScope, key: "cursor", value: JSON.stringify(snapshot.cursor) });
+        });
+    }
+    async replaceSnapshot(snapshot, scope = defaultReplicaScope) {
+        await this.initialize();
+        const normalizedScope = normalizeScope(scope);
+        await this.database.transaction("rw", this.database.entities, this.database.windows, this.database.meta, async () => {
+            await this.database.entities.where("scope").equals(normalizedScope).delete();
+            await this.database.windows.where("scope").equals(normalizedScope).delete();
+            await this.database.meta.delete([normalizedScope, "cursor"]);
+            for (const [entity, rows] of Object.entries(snapshot.entities)) {
+                for (const [id, value] of Object.entries(rows)) {
+                    await this.database.entities.put({ scope: normalizedScope, entity, id, value: JSON.stringify(value) });
+                }
+            }
+            for (const [signature, window] of Object.entries(snapshot.liveQueries)) {
+                await this.database.windows.put({ scope: normalizedScope, signature, value: JSON.stringify(normalizeWindow(window)) });
+            }
+            if (snapshot.cursor)
+                await this.database.meta.put({ scope: normalizedScope, key: "cursor", value: JSON.stringify(snapshot.cursor) });
+        });
+    }
+    async clear(scope = defaultReplicaScope) {
+        await this.initialize();
+        const normalizedScope = normalizeScope(scope);
+        await this.database.transaction("rw", this.database.entities, this.database.windows, this.database.meta, async () => {
+            await this.database.entities.where("scope").equals(normalizedScope).delete();
+            await this.database.windows.where("scope").equals(normalizedScope).delete();
+            await this.database.meta.where("scope").equals(normalizedScope).delete();
+        });
+    }
+    close() {
+        this.database.close();
+    }
+}
+export function indexedDBLocalReplica(name) {
+    return new IndexedDBLocalReplicaStorage(name);
+}
+function normalizeScope(scope) {
+    return typeof scope === "string" && scope.trim() ? scope : defaultReplicaScope;
+}
+function normalizeWindow(value) {
+    return {
+        ...value,
+        kind: value.kind ?? "live",
+        key: value.key ?? "id",
+        ids: [...value.ids],
+        resultPath: value.resultPath ? [...value.resultPath] : undefined,
+        hashes: value.hashes ? { ...value.hashes } : undefined,
+    };
+}
+//# sourceMappingURL=indexeddb-replica.js.map

package/dist/indexeddb-replica.js.map

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

package/dist/kv-stores.d.ts

@@ -0,0 +1,15 @@
+import type { OutboxStore } from "./outbox.js";
+/** Minimal host persistence boundary used by the reducer outbox and adapters. */
+export type GonvexKv = {
+    get(table: string, key: string): Promise<string | undefined>;
+    set(table: string, key: string, value: string): Promise<void>;
+    delete(table: string, key: string): Promise<void>;
+    list(table: string): Promise<Array<{
+        key: string;
+        value: string;
+    }>>;
+    clear(table: string, keyPrefix?: string): Promise<void>;
+};
+export declare const kvReducerOutboxTable = "reducer_outbox";
+export declare function createMemoryGonvexKv(): GonvexKv;
+export declare function createKvOutboxStore(kv: GonvexKv): OutboxStore;

package/dist/kv-stores.js

@@ -0,0 +1,60 @@
+export const kvReducerOutboxTable = "reducer_outbox";
+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)].map(([key, value]) => ({ key, value })); },
+        async clear(name, prefix) {
+            const rows = table(name);
+            if (!prefix) {
+                rows.clear();
+                return;
+            }
+            for (const key of rows.keys())
+                if (key.startsWith(prefix))
+                    rows.delete(key);
+        },
+    };
+}
+export function createKvOutboxStore(kv) {
+    return {
+        async load() {
+            const entries = [];
+            for (const { value } of await kv.list(kvReducerOutboxTable)) {
+                try {
+                    const entry = JSON.parse(value);
+                    if (entry && typeof entry.id === "number")
+                        entries.push(entry);
+                }
+                catch { /* ignore corrupt disposable rows */ }
+            }
+            return entries.sort((left, right) => left.id - right.id);
+        },
+        async put(entry) { await kv.set(kvReducerOutboxTable, String(entry.id), JSON.stringify(entry)); },
+        async delete(id) { await kv.delete(kvReducerOutboxTable, String(id)); },
+        async clear(scope) {
+            if (scope === undefined) {
+                await kv.clear(kvReducerOutboxTable);
+                return;
+            }
+            for (const { key, value } of await kv.list(kvReducerOutboxTable)) {
+                try {
+                    if (JSON.parse(value)?.scope === scope)
+                        await kv.delete(kvReducerOutboxTable, key);
+                }
+                catch { /* ignore */ }
+            }
+        },
+    };
+}
+//# 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/local-replica.d.ts

@@ -0,0 +1,240 @@
+import type { JsonValue, ReplicaCursor, SubscriptionRevision } from "@gonvex/protocol";
+import type { OptimisticPatch } from "./optimistic.js";
+export type ReplicaRow = Record<string, JsonValue>;
+export type ReplicaChange = {
+    entity: string;
+    id: string;
+    operation: "insert" | "update" | "delete";
+    oldValue?: ReplicaRow;
+    newValue?: ReplicaRow;
+    changedColumns?: string[];
+};
+export type ReplicaWindow = {
+    signature: string;
+    kind: "live" | "replica";
+    entity: string;
+    key: string;
+    ids: string[];
+    cursor?: ReplicaCursor;
+    completeness: "complete" | "partial";
+    source: "server" | "cache";
+    resultSkeleton?: JsonValue;
+    resultPath?: string[];
+    scalar?: JsonValue;
+    windowRevision?: string;
+    subscriptionRevision?: SubscriptionRevision;
+    mode?: "eager" | "progressive";
+    truncated?: boolean;
+    orderBy?: string;
+    orderDirection?: "asc" | "desc";
+    maxRows?: number;
+    maxBytes?: number;
+    hashes?: Record<string, string>;
+};
+export type ReplicaTransaction = {
+    cursor: ReplicaCursor;
+    originCommandId?: string;
+    changes: ReplicaChange[];
+    memberships?: ReplicaWindow[];
+};
+export type ReplicaSnapshot = {
+    cursor?: ReplicaCursor;
+    entities: Record<string, Record<string, ReplicaRow>>;
+    liveQueries: Record<string, ReplicaWindow>;
+};
+/** Opaque persistence namespace for one deployment/project/tenant identity. */
+export type ReplicaScope = string;
+/**
+ * Storage implementations must persist the complete transaction atomically.
+ * The SQLite adapter maps this call to BEGIN/apply/cursor/COMMIT; IndexedDB
+ * implementations use one readwrite transaction over the same stores.
+ */
+export interface LocalReplicaStorage {
+    load(scope?: ReplicaScope): Promise<ReplicaSnapshot | undefined>;
+    applyTransaction(transaction: ReplicaTransaction, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    /** Persist a normalized Query/Collection materialization atomically. */
+    replaceSnapshot?(snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    replaceWindow?(window: ReplicaWindow, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    applyWindowDelta?(window: ReplicaWindow, delta: {
+        upserts: ReplicaRow[];
+        deleted: string[];
+    }, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    removeWindow?(signature: string, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    clear?(scope?: ReplicaScope): Promise<void>;
+}
+export type ReplicaFreshness = "current" | "verifying" | "offline";
+export type LiveQueryResult<T extends ReplicaRow = ReplicaRow> = {
+    rows: T[];
+    /** Ordered normalized entity IDs owned by the retained query window. */
+    ids: string[];
+    total?: number;
+    offset?: number;
+    limit?: number;
+    source: "server" | "cache";
+    completeness: "complete" | "partial";
+    freshness: ReplicaFreshness;
+    supported?: boolean;
+    unsupportedOperator?: string;
+};
+export type ReplicaCollectionState<T extends ReplicaRow = ReplicaRow> = LiveQueryResult<T> & {
+    truncated: boolean;
+    computedRevision: number;
+};
+/**
+ * Read-only view of the normalized Local Replica exposed to application code.
+ *
+ * Mutations are deliberately absent from this interface. The Gonvex client
+ * applies committed transactions, optimistic reducer effects, scope changes,
+ * and cache/window updates internally so application code cannot create a
+ * second state-management path or advance the local replica by hand.
+ */
+export interface LocalReplicaView {
+    cursor(): ReplicaCursor | undefined;
+    freshness(): ReplicaFreshness;
+    version(): number;
+    subscribe(listener: () => void): () => void;
+    hasPendingCommand(commandId: string): boolean;
+    getWindow(signature: string): ReplicaWindow | undefined;
+    listWindows(): ReplicaWindow[];
+    windowRows<T extends ReplicaRow = ReplicaRow>(signature: string): T[];
+    entity<T extends ReplicaRow = ReplicaRow>(entity: string, id: string): T | undefined;
+    entityBatch<T extends ReplicaRow = ReplicaRow>(entity: string, ids: readonly string[]): Array<T | undefined>;
+    entityRows<T extends ReplicaRow = ReplicaRow>(entity: string): T[];
+    entityCompleteness(entity: string): "complete" | "partial";
+    liveQuery<T extends ReplicaRow = ReplicaRow>(signature: string): LiveQueryResult<T>;
+    collectionState<T extends ReplicaRow = ReplicaRow>(signature: string): ReplicaCollectionState<T>;
+    hasLiveQuery(signature: string): boolean;
+    snapshot(): ReplicaSnapshot;
+}
+export declare class LocalReplica implements LocalReplicaView {
+    private readonly storage?;
+    private cursorValue?;
+    private entities;
+    private liveQueries;
+    /** Rows introduced by a materialized window may be reclaimed conservatively. */
+    private readonly windowOwned;
+    private pendingCommands;
+    private listeners;
+    private persistence;
+    private application;
+    private hydration?;
+    private freshnessValue;
+    private versionValue;
+    private scopeValue;
+    private scopeLoaded;
+    private scopeActivation?;
+    private scopeActivationName?;
+    private scopeActivationGeneration;
+    constructor(storage?: LocalReplicaStorage | undefined);
+    hydrate(): Promise<void>;
+    /**
+     * Atomically switch the authoritative store to an opaque persistence scope.
+     * A newer request supersedes an older one even if the older storage read is
+     * slow (or resolves after auth has already changed again).
+     */
+    activateScope(scope?: ReplicaScope, forceReload?: boolean): Promise<void>;
+    cursor(): {
+        epoch: string;
+        revision: number;
+    } | undefined;
+    freshness(): ReplicaFreshness;
+    version(): number;
+    setFreshness(freshness: ReplicaFreshness): void;
+    subscribe(listener: () => void): () => boolean;
+    applyOptimistic(commandId: string, patches: OptimisticPatch[]): void;
+    acknowledgeCommand(commandId: string, committedRevision?: number): void;
+    rejectCommand(commandId: string): void;
+    /** True while an optimistic command still contributes visible patches. */
+    hasPendingCommand(commandId: string): boolean;
+    applyTransaction(transaction: ReplicaTransaction, scope?: ReplicaScope): Promise<void>;
+    materializeWindow(input: {
+        signature: string;
+        kind?: "live" | "replica";
+        entity: string;
+        key: string;
+        rows: ReplicaRow[];
+        completeness: "complete" | "partial";
+        source: "server" | "cache";
+        cursor?: ReplicaCursor;
+        resultSkeleton?: JsonValue;
+        resultPath?: string[];
+        scalar?: JsonValue;
+        windowRevision?: string;
+        subscriptionRevision?: SubscriptionRevision;
+        mode?: "eager" | "progressive";
+        truncated?: boolean;
+        orderBy?: string;
+        orderDirection?: "asc" | "desc";
+        maxRows?: number;
+        maxBytes?: number;
+        hashes?: Record<string, string>;
+        removedIDs?: string[];
+        scope?: ReplicaScope;
+    }): Promise<void>;
+    /** Replace one server/cache window while retaining shared normalized entities. */
+    replaceWindow(input: Parameters<LocalReplica["materializeWindow"]>[0]): Promise<void>;
+    /** Apply a bounded window delta and persist it in the same transaction. */
+    applyWindowDelta(input: {
+        signature: string;
+        kind?: "live" | "replica";
+        entity: string;
+        key: string;
+        upserts: ReplicaRow[];
+        deleted: string[];
+        completeness?: "complete" | "partial";
+        source?: "server" | "cache";
+        cursor?: ReplicaCursor;
+        resultSkeleton?: JsonValue;
+        resultPath?: string[];
+        scalar?: JsonValue;
+        windowRevision?: string;
+        subscriptionRevision?: SubscriptionRevision;
+        mode?: "eager" | "progressive";
+        truncated?: boolean;
+        orderBy?: string;
+        orderDirection?: "asc" | "desc";
+        maxRows?: number;
+        maxBytes?: number;
+        hashes?: Record<string, string>;
+        removedIDs?: string[];
+        scope?: ReplicaScope;
+    }): Promise<void>;
+    getWindow(signature: string): ReplicaWindow | undefined;
+    listWindows(): ReplicaWindow[];
+    windowRows<T extends ReplicaRow = ReplicaRow>(signature: string): T[];
+    removeWindow(signature: string, scope?: ReplicaScope): Promise<void>;
+    clear(scope?: ReplicaScope): Promise<void>;
+    private materializeWindowNow;
+    private applyTransactionNow;
+    entity<T extends ReplicaRow = ReplicaRow>(entity: string, id: string): T | undefined;
+    /** Resolve several IDs from one atomic Local Replica version. */
+    entityBatch<T extends ReplicaRow = ReplicaRow>(entity: string, ids: readonly string[]): Array<T | undefined>;
+    /** All cached rows for one normalized entity, including optimistic overlays. */
+    entityRows<T extends ReplicaRow = ReplicaRow>(entity: string): T[];
+    /** Exact only when an authoritative, non-truncated Replica Collection covers the entity. */
+    entityCompleteness(entity: string): "complete" | "partial";
+    liveQuery<T extends ReplicaRow = ReplicaRow>(signature: string): LiveQueryResult<T>;
+    /** Rows and protocol-owned completeness for one Replica Collection window. */
+    collectionState<T extends ReplicaRow = ReplicaRow>(signature: string): ReplicaCollectionState<T>;
+    hasLiveQuery(signature: string): boolean;
+    snapshot(): ReplicaSnapshot;
+    private reconcileCommands;
+    private persist;
+    private notify;
+    private trackWindowOwnership;
+    private pruneOwnedEntities;
+    private pruneOwnedEntitiesAfterRemoval;
+}
+export declare class MemoryLocalReplicaStorage implements LocalReplicaStorage {
+    private readonly values;
+    load(scope?: ReplicaScope): Promise<ReplicaSnapshot | undefined>;
+    applyTransaction(_transaction: ReplicaTransaction, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    replaceSnapshot(snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    replaceWindow(_window: ReplicaWindow, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    applyWindowDelta(_window: ReplicaWindow, _delta: {
+        upserts: ReplicaRow[];
+        deleted: string[];
+    }, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    removeWindow(_signature: string, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
+    clear(scope?: ReplicaScope): Promise<void>;
+}