@gonvex/client 0.5.2-staging.2 → 0.5.2-staging.21

package/dist/indexeddb-read-view.d.ts

@@ -0,0 +1,24 @@
+import { type Table, type IndexableType } from 'dexie';
+import type { DataScalar, JsonObject } from '@gonvex/module-sdk';
+import type { ReducerReadView } from '@gonvex/local-runtime/portable';
+export type EntityRecord = {
+    scope: string;
+    entity: string;
+    id: string;
+    value: string;
+    lookupKeys?: IndexableType[];
+    authority?: import('./replica-record.js').ReplicaRecordVersion;
+    sequence?: number;
+    deleted?: boolean;
+};
+import { type ReadCoverage } from '@gonvex/local-runtime/read-view';
+export type { ReadCoverage } from '@gonvex/local-runtime/read-view';
+export declare const encodeReadKey: (value: DataScalar) => [number, string | number];
+/** Secondary keys live on disk alongside the record, not in another row cache.
+ * Large text/JSON stays unindexed; a residual predicate can still examine it.
+ */
+export declare function entityRecord(scope: string, entity: string, id: string, row: JsonObject): EntityRecord;
+/** Must be used inside the storage adapter's transaction. Cursor iteration keeps
+ * unrelated records off the JS heap; bounded reads retain at most limit rows.
+ */
+export declare function indexedDBReadView(entities: Table<EntityRecord, [string, string, string]>, scope: string, coverage: ReadCoverage): ReducerReadView;

package/dist/indexeddb-read-view.js

@@ -0,0 +1,164 @@
+import { compileDataRead, orderedDataRead, matchesDataPredicate } from '@gonvex/module-sdk';
+import { primaryReadKeys, readIsCovered } from '@gonvex/local-runtime/read-view';
+export const encodeReadKey = (value) => {
+    if (value === null)
+        return [0, 0];
+    if (typeof value === 'boolean')
+        return [1, Number(value)];
+    if (typeof value === 'number')
+        return [2, value];
+    return [3, value];
+};
+/** Secondary keys live on disk alongside the record, not in another row cache.
+ * Large text/JSON stays unindexed; a residual predicate can still examine it.
+ */
+export function entityRecord(scope, entity, id, row) {
+    const lookupKeys = [];
+    // Avoid temporary entry, flatMap and spread arrays for every column of each
+    // persisted row. Keep the same on-disk index encoding and residual reads.
+    for (const column of Object.keys(row)) {
+        const value = row[column];
+        let type;
+        let key;
+        // SQL equality never selects NULL; isNull reads already use a residual scan.
+        // Indexing every absent optional field only duplicates disk/native allocations.
+        if (typeof value === 'boolean') {
+            type = 1;
+            key = Number(value);
+        }
+        else if (typeof value === 'number' && Number.isFinite(value)) {
+            type = 2;
+            key = value;
+        }
+        else if (typeof value === 'string' && value.length <= 256) {
+            type = 3;
+            key = value;
+        }
+        else
+            continue;
+        lookupKeys.push([scope, entity, column, type, key]);
+    }
+    return { scope, entity, id, value: JSON.stringify(row), lookupKeys };
+}
+function equality(predicate) {
+    if (!predicate)
+        return;
+    if ('and' in predicate)
+        return predicate.and.map(equality).find(Boolean);
+    if ('or' in predicate)
+        return;
+    if (predicate.transform)
+        return;
+    if (predicate.op === 'eq' && (typeof predicate.value !== 'string' || predicate.value.length <= 256))
+        return { column: predicate.column, op: 'eq', value: predicate.value };
+    if (predicate.op === 'in' && predicate.values.every(value => typeof value !== 'string' || value.length <= 256))
+        return predicate;
+}
+function compare(read, a, b) {
+    for (const order of read.orderBy ?? []) {
+        const sortValue = (row) => {
+            const value = row[order.column];
+            if (order.transform !== 'numericSuffix' || value == null)
+                return value;
+            if (typeof value !== 'string')
+                throw new Error('Numeric suffix requires text');
+            const suffix = value.match(/[0-9]+$/)?.[0];
+            return suffix === undefined ? null : BigInt(suffix);
+        };
+        const left = sortValue(a), right = sortValue(b);
+        if (left === right)
+            continue;
+        const direction = order.direction === 'desc' ? -1 : 1;
+        const nullFirst = (order.nulls ?? (direction === 1 ? 'last' : 'first')) === 'first';
+        if (left == null)
+            return nullFirst ? -1 : 1;
+        if (right == null)
+            return nullFirst ? 1 : -1;
+        if (typeof left !== typeof right || typeof left === 'object')
+            throw new Error(`Incompatible ordering for ${order.column}`);
+        return (left < right ? -1 : 1) * direction;
+    }
+    return 0;
+}
+/** Must be used inside the storage adapter's transaction. Cursor iteration keeps
+ * unrelated records off the JS heap; bounded reads retain at most limit rows.
+ */
+export function indexedDBReadView(entities, scope, coverage) {
+    return {
+        async select(read, excludedRowIds = []) {
+            read = orderedDataRead({ ...read, key: read.key ?? coverage[read.table]?.key });
+            compileDataRead(read);
+            const known = coverage[read.table];
+            const excluded = new Set(excludedRowIds);
+            const key = known?.key ?? '_id';
+            const restriction = equality(read.where);
+            let candidates;
+            const primaryKeys = primaryReadKeys(read, key);
+            const exactKey = restriction?.op === 'eq' && restriction.column === key && typeof restriction.value === 'string';
+            if (exactKey) {
+                candidates = entities.where('[scope+entity+id]').equals([scope, read.table, String(restriction.value)]);
+            }
+            else if (primaryKeys) {
+                candidates = entities.where('[scope+entity+id]').anyOf(primaryKeys.map(id => [scope, read.table, id]));
+            }
+            else if (restriction) {
+                const values = restriction.op === 'eq' ? [restriction.value] : restriction.values;
+                const keys = values.filter(value => value !== null).map(value => [scope, read.table, restriction.column, ...encodeReadKey(value)]);
+                candidates = entities.where('lookupKeys').anyOf(keys).distinct();
+            }
+            else
+                candidates = entities.where('[scope+entity]').equals([scope, read.table]);
+            const result = [];
+            const foundPrimary = new Set();
+            let fieldsComplete = true;
+            const required = new Set(read.columns ?? known?.columns ?? []);
+            const requirePredicate = (predicate) => {
+                if ('and' in predicate)
+                    predicate.and.forEach(requirePredicate);
+                else if ('or' in predicate)
+                    predicate.or.forEach(requirePredicate);
+                else
+                    required.add(predicate.column);
+            };
+            if (read.where)
+                requirePredicate(read.where);
+            for (const order of read.orderBy ?? [])
+                required.add(order.column);
+            if (read.limit !== 0)
+                await candidates.until(() => !read.orderBy?.length && read.limit !== undefined && result.length >= read.limit).each(record => {
+                    if (record.deleted || excluded.has(record.id))
+                        return;
+                    const row = JSON.parse(record.value);
+                    if (primaryKeys)
+                        foundPrimary.add(record.id);
+                    if ([...required].some(column => !Object.hasOwn(row, column)))
+                        fieldsComplete = false;
+                    if (read.where && !matchesDataPredicate(row, read.where))
+                        return;
+                    if (read.orderBy?.length && read.limit !== undefined) {
+                        // Retain a bounded ordered candidate set, never sort a full collection.
+                        let low = 0, high = result.length;
+                        while (low < high) {
+                            const mid = (low + high) >>> 1;
+                            if (compare(read, result[mid], row) <= 0)
+                                low = mid + 1;
+                            else
+                                high = mid;
+                        }
+                        if (low < read.limit) {
+                            result.splice(low, 0, row);
+                            if (result.length > read.limit)
+                                result.pop();
+                        }
+                    }
+                    else
+                        result.push(row);
+                });
+            if (read.orderBy?.length && read.limit === undefined)
+                result.sort((a, b) => compare(read, a, b));
+            const complete = read.limit === 0 || fieldsComplete && (readIsCovered(known, read) || (primaryKeys !== undefined && primaryKeys.every(id => excluded.has(id) || foundPrimary.has(id))));
+            return { rows: read.columns ? result.map(row => Object.fromEntries(read.columns.map(column => [column, row[column] ?? null]))) : result, complete };
+        },
+    };
+}
+//# sourceMappingURL=indexeddb-read-view.js.map

package/dist/indexeddb-read-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb-read-view.js","sourceRoot":"","sources":["../src/indexeddb-read-view.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAK5F,OAAO,EAAE,eAAe,EAAE,aAAa,EAAqB,MAAM,iCAAiC,CAAC;AAEpG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAiB,EAA6B,EAAE;IAC5E,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACjD,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AACpB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,MAAc,EAAE,EAAU,EAAE,GAAe;IACrF,MAAM,UAAU,GAAoB,EAAE,CAAC;IACvC,4EAA4E;IAC5E,0EAA0E;IAC1E,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1B,IAAI,IAAY,CAAC;QACjB,IAAI,GAAoB,CAAC;QACzB,6EAA6E;QAC7E,gFAAgF;QAChF,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YAAC,IAAI,GAAG,CAAC,CAAC;YAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAAC,CAAC;aAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAAC,IAAI,GAAG,CAAC,CAAC;YAAC,GAAG,GAAG,KAAK,CAAC;QAAC,CAAC;aACnF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;YAAC,IAAI,GAAG,CAAC,CAAC;YAAC,GAAG,GAAG,KAAK,CAAC;QAAC,CAAC;;YAChF,SAAS;QACd,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,CAAC;AACvE,CAAC;AAGD,SAAS,QAAQ,CAAC,SAAoC;IACpD,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,IAAI,KAAK,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzE,IAAI,IAAI,IAAI,SAAS;QAAE,OAAO;IAC9B,IAAG,SAAS,CAAC,SAAS;QAAE,OAAO;IAC/B,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI,IAAI,CAAC,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,IAAI,SAAS,CAAC,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,CAAC;IAC3K,IAAI,SAAS,CAAC,EAAE,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;AACnI,CAAC;AAED,SAAS,OAAO,CAAC,IAAc,EAAE,CAAa,EAAE,CAAa;IAC3D,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,CAAC,GAAe,EAAE,EAAE;YACpC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,KAAK,CAAC,SAAS,KAAK,eAAe,IAAI,KAAK,IAAI,IAAI;gBAAE,OAAO,KAAK,CAAC;YACvE,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAC/E,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAC3C,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,IAAI,KAAK,KAAK;YAAE,SAAS;QAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACtD,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC;QACpF,IAAI,IAAI,IAAI,IAAI;YAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,IAAI,KAAK,IAAI,IAAI;YAAE,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,OAAO,IAAI,KAAK,OAAO,KAAK,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAC3H,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAC7C,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAuD,EAAE,KAAa,EAAE,QAAsB;IAC9H,OAAO;QACL,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,EAAE;YACpC,IAAI,GAAC,eAAe,CAAC,EAAC,GAAG,IAAI,EAAC,GAAG,EAAC,IAAI,CAAC,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,EAAC,CAAC,CAAC;YAC1E,eAAe,CAAC,IAAI,CAAC,CAAC;YACtB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC;YACzC,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,IAAI,KAAK,CAAC;YAChC,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzC,IAAI,UAA8D,CAAC;YACnE,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC/C,MAAM,QAAQ,GAAG,WAAW,EAAE,EAAE,KAAK,IAAI,IAAI,WAAW,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,WAAW,CAAC,KAAK,KAAK,QAAQ,CAAC;YACjH,IAAI,QAAQ,EAAE,CAAC;gBACb,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC1G,CAAC;iBAAM,IAAI,WAAW,EAAE,CAAC;gBACvB,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YACzG,CAAC;iBAAM,IAAI,WAAW,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,WAAW,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;gBAClF,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;gBACnI,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YACnE,CAAC;;gBAAM,UAAU,GAAG,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACjF,MAAM,MAAM,GAAiB,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;YACvC,IAAI,cAAc,GAAC,IAAI,CAAC;YACxB,MAAM,QAAQ,GAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,gBAAgB,GAAC,CAAC,SAAuB,EAAM,EAAE;gBACrD,IAAG,KAAK,IAAI,SAAS;oBAAE,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;qBAC1D,IAAG,IAAI,IAAI,SAAS;oBAAE,SAAS,CAAC,EAAE,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;;oBAC7D,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACtC,CAAC,CAAC;YACF,IAAG,IAAI,CAAC,KAAK;gBAAE,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5C,KAAI,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAClE,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC;gBAAE,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE;oBACjJ,IAAI,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;wBAAE,OAAO;oBACtD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAe,CAAC;oBACnD,IAAI,WAAW;wBAAE,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAC7C,IAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA,EAAE,CAAA,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAC,MAAM,CAAC,CAAC;wBAAE,cAAc,GAAC,KAAK,CAAC;oBAChF,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC;wBAAE,OAAO;oBACjE,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;wBACrD,wEAAwE;wBACxE,IAAI,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC;wBAClC,OAAO,GAAG,GAAG,IAAI,EAAE,CAAC;4BAAC,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;4BAAC,IAAI,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAE,EAAE,GAAG,CAAC,IAAI,CAAC;gCAAE,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;;gCAAM,IAAI,GAAG,GAAG,CAAC;wBAAC,CAAC;wBACjI,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;4BAAC,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;4BAAC,IAAI,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK;gCAAE,MAAM,CAAC,GAAG,EAAE,CAAC;wBAAC,CAAC;oBACrG,CAAC;;wBAAM,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBAC1B,CAAC,CAAC,CAAC;YACH,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;gBAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACjG,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,cAAc,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,WAAW,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACxL,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,OAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;QACvJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/indexeddb-replica.d.ts

@@ -1,15 +1,53 @@
-import type { LocalReplicaStorage, ReplicaScope, ReplicaSnapshot, ReplicaTransaction, ReplicaWindow, ReplicaRow } from "./local-replica.js";
+import { type ReadCoverage } from './indexeddb-read-view.js';
+import type { ReducerReadView } from '@gonvex/local-runtime/portable';
+import type { LocalReplicaStorage, ReplicaScope, ReplicaSnapshot, ReplicaTransaction, ReplicaWindow, ReplicaRow, ReplicaStorageChanges } from "./local-replica.js";
 /** Atomic normalized web persistence for the Gonvex Local Replica. */
 export declare class IndexedDBLocalReplicaStorage implements LocalReplicaStorage {
     private readonly database;
     private initialized?;
+    private readonly channel?;
+    private readonly peers;
     constructor(name?: string);
+    subscribePeer(listener: (scope: string) => void): () => void;
+    private nextSequence;
+    private versionedRecord;
+    private writeEntity;
+    private writeRows;
+    private writeRowEntries;
+    private writeWindows;
+    private saveCursor;
+    private acceptEpoch;
+    private pruneRows;
+    readChanges(scope: string, afterSequence: number, interest?: {
+        rows: Record<string, string[]>;
+        windows: string[];
+        availableRows: number;
+        availableBytes: number;
+        maxRows: number;
+        maxBytes: number;
+    }): Promise<ReplicaStorageChanges>;
     private initialize;
+    withReadView<T>(scope: string, coverage: ReadCoverage, run: (view: ReducerReadView) => Promise<T>): Promise<T>;
+    listScopes(): Promise<string[]>;
+    loadSession(scope: string): Promise<import("./local-replica.js").LocalReplicaSession | undefined>;
+    saveSession(scope: string, session: import("./local-replica.js").LocalReplicaSession | undefined): Promise<void>;
     load(scope?: ReplicaScope): Promise<ReplicaSnapshot | undefined>;
+    loadWorkingSet(scope: string, budget: {
+        maxRows: number;
+        maxBytes: number;
+    }): Promise<ReplicaSnapshot | undefined>;
+    loadEntityRows(scope: string, entity: string, ids: readonly string[]): Promise<Array<{
+        id: string;
+        row: ReplicaRow;
+    }>>;
+    loadWindowRows(scope: string, signature: string): Promise<{
+        window: ReplicaWindow;
+        rows: ReplicaRow[];
+    } | undefined>;
     applyTransaction(transaction: ReplicaTransaction, _snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
     advanceWatermark(windows: readonly ReplicaWindow[], cursor: ReplicaSnapshot["cursor"], scope?: ReplicaScope): Promise<void>;
-    replaceWindow(window: ReplicaWindow, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;
-    applyWindowDelta(window: ReplicaWindow, _delta: {
+    replaceWindow(window: ReplicaWindow, snapshot: ReplicaSnapshot, scope?: ReplicaScope, projection?: readonly ReplicaRow[]): Promise<void>;
+    applyWindowDelta(window: ReplicaWindow, delta: {
         upserts: ReplicaRow[];
         deleted: string[];
     }, snapshot: ReplicaSnapshot, scope?: ReplicaScope): Promise<void>;