@verdant-web/store 2.8.5 → 3.0.0

package/dist/esm/entities/EntityMetadata.js

@@ -0,0 +1,256 @@
+import { applyPatch, areOidsRelated, assert, assignOid, cloneDeep, compareTimestampSchemaVersions, getWallClockTime, } from '@verdant-web/common';
+export class EntityMetadata {
+    constructor({ oid, ctx, confirmedOperations, pendingOperations, baseline, }) {
+        this.baseline = null;
+        // these must be kept in timestamp order.
+        this.confirmedOperations = [];
+        this.pendingOperations = [];
+        /**
+         * Compute the current view of the entity.
+         */
+        this.computeView = (omitPending = false) => {
+            var _a, _b, _c, _d, _e, _f, _g;
+            const base = cloneDeep((_b = (_a = this.baseline) === null || _a === void 0 ? void 0 : _a.snapshot) !== null && _b !== void 0 ? _b : undefined);
+            const baselineTimestamp = (_d = (_c = this.baseline) === null || _c === void 0 ? void 0 : _c.timestamp) !== null && _d !== void 0 ? _d : null;
+            const confirmedResult = this.applyOperations(
+            // apply ops to baseline
+            base, 
+            // deleted if there's no baseline
+            !base, 
+            // we're applying confirmed ops first
+            this.confirmedOperations, 
+            // latest timestamp is the baseline timestamp, if any
+            baselineTimestamp, 
+            // only apply ops after the baseline timestamp
+            baselineTimestamp);
+            // now's the time to declare we saw the future if we did.
+            if (confirmedResult.futureSeen) {
+                this.ctx.globalEvents.emit('futureSeen', confirmedResult.futureSeen);
+            }
+            const pendingResult = omitPending
+                ? confirmedResult
+                : this.applyOperations(confirmedResult.view, confirmedResult.deleted, 
+                // now we're applying pending operations
+                this.pendingOperations, 
+                // keep our latest timestamp up to date
+                confirmedResult.latestTimestamp, 
+                // we don't use after for pending ops, they're all
+                // logically in the future
+                null);
+            // before letting this data out into the wild, we need
+            // to associate its oid
+            if (pendingResult.view) {
+                assignOid(pendingResult.view, this.oid);
+            }
+            // note whether confirmed data has an operation/baseline from the current
+            // schema or not.
+            const fromOlderVersion = !!confirmedResult.latestTimestamp &&
+                compareTimestampSchemaVersions(confirmedResult.latestTimestamp, this.ctx.getNow()) < 0;
+            const empty = !this.baseline &&
+                !this.pendingOperations.length &&
+                !this.confirmedOperations.length;
+            if (empty) {
+                this.ctx.log('warn', `Tried to load Entity ${this.oid} with no data`);
+            }
+            const updatedAtTimestamp = (_f = (_e = pendingResult.latestTimestamp) !== null && _e !== void 0 ? _e : confirmedResult.latestTimestamp) !== null && _f !== void 0 ? _f : baselineTimestamp;
+            const updatedAt = updatedAtTimestamp
+                ? getWallClockTime(updatedAtTimestamp)
+                : 0;
+            if (!pendingResult.view && !pendingResult.deleted && !empty) {
+                this.ctx.log('warn', `Entity ${this.oid} has no view, no deleted flag, and not empty`);
+                debugger;
+            }
+            return {
+                view: (_g = pendingResult.view) !== null && _g !== void 0 ? _g : undefined,
+                deleted: pendingResult.deleted,
+                empty,
+                fromOlderVersion,
+                updatedAt,
+            };
+        };
+        this.addBaseline = (baseline) => {
+            var _a;
+            // opt out if our baseline is newer
+            if (this.baseline && this.baseline.timestamp >= baseline.timestamp) {
+                return;
+            }
+            this.baseline = baseline;
+            // we can now drop any confirmed ops older than the baseline
+            while (((_a = this.confirmedOperations[0]) === null || _a === void 0 ? void 0 : _a.timestamp) < baseline.timestamp) {
+                this.confirmedOperations.shift();
+            }
+        };
+        /**
+         * @returns total number of new operations added
+         */
+        this.addConfirmedOperations = (operations) => {
+            let totalAdded = 0;
+            // the operations must be inserted in timestamp order
+            for (const op of operations) {
+                const index = this.confirmedOperations.findIndex((o) => o.timestamp >= op.timestamp);
+                if (index !== -1) {
+                    // ensure we don't have a duplicate
+                    if (this.confirmedOperations[index].timestamp !== op.timestamp) {
+                        // otherwise, insert at the right place
+                        this.confirmedOperations.splice(index, 0, op);
+                        totalAdded++;
+                    }
+                }
+                else {
+                    // otherwise, append
+                    this.confirmedOperations.push(op);
+                    totalAdded++;
+                }
+                // FIXME: seems inefficient
+                // remove this incoming op from pending if it's in there
+                const pendingPrior = this.pendingOperations.length;
+                this.pendingOperations = this.pendingOperations.filter((pendingOp) => op.timestamp !== pendingOp.timestamp);
+                totalAdded -= pendingPrior - this.pendingOperations.length;
+            }
+            return totalAdded;
+        };
+        this.addPendingOperation = (operation) => {
+            // we can assume pending ops are always newer
+            this.pendingOperations.push(operation);
+        };
+        this.applyOperations = (base, deleted, operations, latestTimestamp, after) => {
+            let futureSeen = undefined;
+            const now = this.ctx.getNow();
+            for (const op of operations) {
+                // ignore ops before our after cutoff
+                if (after && op.timestamp <= after) {
+                    continue;
+                }
+                // don't apply future ops
+                if (compareTimestampSchemaVersions(op.timestamp, now) > 0) {
+                    futureSeen = op.timestamp;
+                    continue;
+                }
+                // we don't actually delete the view when a delete op
+                // comes in. the view remains useful for calculating
+                // undo operations.
+                if (op.data.op === 'delete') {
+                    deleted = true;
+                }
+                else {
+                    base = applyPatch(base, op.data);
+                    if (op.data.op === 'initialize') {
+                        deleted = false;
+                    }
+                }
+                // track the latest timestamp
+                if (!latestTimestamp || op.timestamp > latestTimestamp) {
+                    latestTimestamp = op.timestamp;
+                }
+            }
+            return {
+                view: base,
+                latestTimestamp: latestTimestamp !== null && latestTimestamp !== void 0 ? latestTimestamp : null,
+                deleted,
+                futureSeen,
+            };
+        };
+        assert(oid, 'oid is required');
+        this.ctx = ctx;
+        this.oid = oid;
+        if (confirmedOperations) {
+            this.confirmedOperations = confirmedOperations;
+        }
+        if (pendingOperations) {
+            this.pendingOperations = pendingOperations;
+        }
+        if (baseline) {
+            this.baseline = baseline;
+        }
+    }
+}
+/**
+ * Represents the metadata for a group of entities underneath a Document.
+ * Metadata is separated out this way so that these classes can be
+ * garbage collected when the root Document goes out of scope.
+ */
+export class EntityFamilyMetadata {
+    constructor({ ctx, onPendingOperations, rootOid, }) {
+        this.entities = new Map();
+        this.get = (oid) => {
+            assert(oid, 'oid is required');
+            if (!this.entities.has(oid)) {
+                this.entities.set(oid, new EntityMetadata({ oid, ctx: this.ctx }));
+            }
+            return this.entities.get(oid);
+        };
+        this.getAllOids = () => {
+            return Array.from(this.entities.keys());
+        };
+        this.addConfirmedData = ({ baselines = [], operations = {}, isLocal = false, }) => {
+            var _a;
+            const changes = {};
+            for (const baseline of baselines) {
+                if (!areOidsRelated(this.rootOid, baseline.oid)) {
+                    throw new Error(`Invalid baseline for entity ${this.rootOid}: ` +
+                        JSON.stringify(baseline));
+                }
+                this.get(baseline.oid).addBaseline(baseline);
+            }
+            for (const [oid, ops] of Object.entries(operations)) {
+                if (!areOidsRelated(this.rootOid, oid)) {
+                    throw new Error(`Invalid operations for entity ${this.rootOid}: ` +
+                        JSON.stringify(ops));
+                }
+                const added = this.get(oid).addConfirmedOperations(ops);
+                if (added !== 0) {
+                    (_a = changes[oid]) !== null && _a !== void 0 ? _a : (changes[oid] = { oid, isLocal });
+                }
+            }
+            return Object.values(changes);
+        };
+        /**
+         * Adds local, unconfirmed operations to the system.
+         * The API is different here to streamline for the way
+         * local changes are usually handled, as a list.
+         */
+        this.addPendingData = (operations) => {
+            var _a;
+            var _b;
+            const changes = {};
+            for (const op of operations) {
+                this.get(op.oid).addPendingOperation(op);
+                (_a = changes[_b = op.oid]) !== null && _a !== void 0 ? _a : (changes[_b] = { oid: op.oid, isLocal: true });
+            }
+            this.onPendingOperations(operations);
+            return Object.values(changes);
+        };
+        this.replaceAllData = ({ operations = {}, baselines = [], }) => {
+            var _a, _b;
+            var _c;
+            const oids = Array.from(this.entities.keys());
+            this.entities.clear();
+            const changes = {};
+            // changes apply to all the entities we removed things from, too
+            for (const oid of oids) {
+                changes[oid] = { oid, isLocal: false };
+            }
+            for (const baseline of baselines) {
+                if (!areOidsRelated(this.rootOid, baseline.oid)) {
+                    throw new Error(`Invalid baseline for entity ${this.rootOid}: ` +
+                        JSON.stringify(baseline));
+                }
+                this.get(baseline.oid).addBaseline(baseline);
+                (_a = changes[_c = baseline.oid]) !== null && _a !== void 0 ? _a : (changes[_c] = { oid: baseline.oid, isLocal: false });
+            }
+            for (const [oid, ops] of Object.entries(operations)) {
+                if (!areOidsRelated(this.rootOid, oid)) {
+                    throw new Error(`Invalid operations for entity ${this.rootOid}: ` +
+                        JSON.stringify(ops));
+                }
+                this.get(oid).addConfirmedOperations(ops);
+                (_b = changes[oid]) !== null && _b !== void 0 ? _b : (changes[oid] = { oid, isLocal: false });
+            }
+            return Object.values(changes);
+        };
+        this.ctx = ctx;
+        this.rootOid = rootOid;
+        this.onPendingOperations = onPendingOperations;
+    }
+}
+//# sourceMappingURL=EntityMetadata.js.map

package/dist/esm/entities/EntityMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityMetadata.js","sourceRoot":"","sources":["../../../src/entities/EntityMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAIN,UAAU,EACV,cAAc,EACd,MAAM,EACN,SAAS,EACT,SAAS,EACT,8BAA8B,EAC9B,gBAAgB,GAChB,MAAM,qBAAqB,CAAC;AAY7B,MAAM,OAAO,cAAc;IAQ1B,YAAY,EACX,GAAG,EACH,GAAG,EACH,mBAAmB,EACnB,iBAAiB,EACjB,QAAQ,GAOR;QAlBO,aAAQ,GAA4B,IAAI,CAAC;QACjD,yCAAyC;QACjC,wBAAmB,GAAgB,EAAE,CAAC;QACtC,sBAAiB,GAAgB,EAAE,CAAC;QA8B5C;;WAEG;QACH,gBAAW,GAAG,CAAC,WAAW,GAAG,KAAK,EAAsB,EAAE;;YACzD,MAAM,IAAI,GAAG,SAAS,CAAC,MAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,QAAQ,mCAAI,SAAS,CAAC,CAAC;YAC7D,MAAM,iBAAiB,GAAG,MAAA,MAAA,IAAI,CAAC,QAAQ,0CAAE,SAAS,mCAAI,IAAI,CAAC;YAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,eAAe;YAC3C,wBAAwB;YACxB,IAAI;YACJ,iCAAiC;YACjC,CAAC,IAAI;YACL,qCAAqC;YACrC,IAAI,CAAC,mBAAmB;YACxB,qDAAqD;YACrD,iBAAiB;YACjB,8CAA8C;YAC9C,iBAAiB,CACjB,CAAC;YACF,yDAAyD;YACzD,IAAI,eAAe,CAAC,UAAU,EAAE;gBAC/B,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;aACrE;YACD,MAAM,aAAa,GAAG,WAAW;gBAChC,CAAC,CAAC,eAAe;gBACjB,CAAC,CAAC,IAAI,CAAC,eAAe,CACpB,eAAe,CAAC,IAAI,EACpB,eAAe,CAAC,OAAO;gBACvB,wCAAwC;gBACxC,IAAI,CAAC,iBAAiB;gBACtB,uCAAuC;gBACvC,eAAe,CAAC,eAAe;gBAC/B,kDAAkD;gBAClD,0BAA0B;gBAC1B,IAAI,CACH,CAAC;YACL,sDAAsD;YACtD,uBAAuB;YACvB,IAAI,aAAa,CAAC,IAAI,EAAE;gBACvB,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;aACxC;YAED,yEAAyE;YACzE,iBAAiB;YACjB,MAAM,gBAAgB,GACrB,CAAC,CAAC,eAAe,CAAC,eAAe;gBACjC,8BAA8B,CAC7B,eAAe,CAAC,eAAe,EAC/B,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CACjB,GAAG,CAAC,CAAC;YAEP,MAAM,KAAK,GACV,CAAC,IAAI,CAAC,QAAQ;gBACd,CAAC,IAAI,CAAC,iBAAiB,CAAC,MAAM;gBAC9B,CAAC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC;YAClC,IAAI,KAAK,EAAE;gBACV,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,EAAE,wBAAwB,IAAI,CAAC,GAAG,eAAe,CAAC,CAAC;aACtE;YAED,MAAM,kBAAkB,GACvB,MAAA,MAAA,aAAa,CAAC,eAAe,mCAC7B,eAAe,CAAC,eAAe,mCAC/B,iBAAiB,CAAC;YACnB,MAAM,SAAS,GAAG,kBAAkB;gBACnC,CAAC,CAAC,gBAAgB,CAAC,kBAAkB,CAAC;gBACtC,CAAC,CAAC,CAAC,CAAC;YAEL,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,OAAO,IAAI,CAAC,KAAK,EAAE;gBAC5D,IAAI,CAAC,GAAG,CAAC,GAAG,CACX,MAAM,EACN,UAAU,IAAI,CAAC,GAAG,8CAA8C,CAChE,CAAC;gBACF,QAAQ,CAAC;aACT;YAED,OAAO;gBACN,IAAI,EAAE,MAAA,aAAa,CAAC,IAAI,mCAAI,SAAS;gBACrC,OAAO,EAAE,aAAa,CAAC,OAAO;gBAC9B,KAAK;gBACL,gBAAgB;gBAChB,SAAS;aACT,CAAC;QACH,CAAC,CAAC;QAEF,gBAAW,GAAG,CAAC,QAA0B,EAAQ,EAAE;;YAClD,mCAAmC;YACnC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,EAAE;gBACnE,OAAO;aACP;YACD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;YACzB,4DAA4D;YAC5D,OAAO,CAAA,MAAA,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,0CAAE,SAAS,IAAG,QAAQ,CAAC,SAAS,EAAE;gBACnE,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;aACjC;QACF,CAAC,CAAC;QAEF;;WAEG;QACH,2BAAsB,GAAG,CAAC,UAAuB,EAAU,EAAE;YAC5D,IAAI,UAAU,GAAG,CAAC,CAAC;YACnB,qDAAqD;YACrD,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE;gBAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAC/C,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,SAAS,CAClC,CAAC;gBACF,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE;oBACjB,mCAAmC;oBACnC,IAAI,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,KAAK,EAAE,CAAC,SAAS,EAAE;wBAC/D,uCAAuC;wBACvC,IAAI,CAAC,mBAAmB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;wBAC9C,UAAU,EAAE,CAAC;qBACb;iBACD;qBAAM;oBACN,oBAAoB;oBACpB,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBAClC,UAAU,EAAE,CAAC;iBACb;gBACD,2BAA2B;gBAC3B,wDAAwD;gBACxD,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;gBACnD,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CACrD,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS,CACnD,CAAC;gBACF,UAAU,IAAI,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC;aAC3D;YACD,OAAO,UAAU,CAAC;QACnB,CAAC,CAAC;QAEF,wBAAmB,GAAG,CAAC,SAAoB,EAAE,EAAE;YAC9C,6CAA6C;YAC7C,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC,CAAC;QAEM,oBAAe,GAAG,CACzB,IAAS,EACT,OAAgB,EAChB,UAAuB,EACvB,eAA8B,EAC9B,KAAoB,EAMnB,EAAE;YACH,IAAI,UAAU,GAAuB,SAAS,CAAC;YAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAC9B,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE;gBAC5B,qCAAqC;gBACrC,IAAI,KAAK,IAAI,EAAE,CAAC,SAAS,IAAI,KAAK,EAAE;oBACnC,SAAS;iBACT;gBACD,yBAAyB;gBACzB,IAAI,8BAA8B,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE;oBAC1D,UAAU,GAAG,EAAE,CAAC,SAAS,CAAC;oBAC1B,SAAS;iBACT;gBACD,qDAAqD;gBACrD,oDAAoD;gBACpD,mBAAmB;gBACnB,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,EAAE;oBAC5B,OAAO,GAAG,IAAI,CAAC;iBACf;qBAAM;oBACN,IAAI,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;oBACjC,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,YAAY,EAAE;wBAChC,OAAO,GAAG,KAAK,CAAC;qBAChB;iBACD;gBAED,6BAA6B;gBAC7B,IAAI,CAAC,eAAe,IAAI,EAAE,CAAC,SAAS,GAAG,eAAe,EAAE;oBACvD,eAAe,GAAG,EAAE,CAAC,SAAS,CAAC;iBAC/B;aACD;YACD,OAAO;gBACN,IAAI,EAAE,IAAI;gBACV,eAAe,EAAE,eAAe,aAAf,eAAe,cAAf,eAAe,GAAI,IAAI;gBACxC,OAAO;gBACP,UAAU;aACV,CAAC;QACH,CAAC,CAAC;QAlMD,MAAM,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;QAC/B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,mBAAmB,EAAE;YACxB,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;SAC/C;QACD,IAAI,iBAAiB,EAAE;YACtB,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;SAC3C;QACD,IAAI,QAAQ,EAAE;YACb,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;SACzB;IACF,CAAC;CAuLD;AAED;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAMhC,YAAY,EACX,GAAG,EACH,mBAAmB,EACnB,OAAO,GAKP;QAZO,aAAQ,GAA0C,IAAI,GAAG,EAAE,CAAC;QAkBpE,QAAG,GAAG,CAAC,GAAqB,EAAE,EAAE;YAC/B,MAAM,CAAC,GAAG,EAAE,iBAAiB,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;gBAC5B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,cAAc,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;aACnE;YACD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAChC,CAAC,CAAC;QAEF,eAAU,GAAG,GAAG,EAAE;YACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;QACzC,CAAC,CAAC;QAEF,qBAAgB,GAAG,CAAC,EACnB,SAAS,GAAG,EAAE,EACd,UAAU,GAAG,EAAE,EACf,OAAO,GAAG,KAAK,GAKf,EAAE,EAAE;;YACJ,MAAM,OAAO,GAA2C,EAAE,CAAC;YAC3D,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;gBACjC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;oBAChD,MAAM,IAAI,KAAK,CACd,+BAA+B,IAAI,CAAC,OAAO,IAAI;wBAC9C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CACzB,CAAC;iBACF;gBACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;aAC7C;YACD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;gBACpD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;oBACvC,MAAM,IAAI,KAAK,CACd,iCAAiC,IAAI,CAAC,OAAO,IAAI;wBAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CACpB,CAAC;iBACF;gBACD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;gBACxD,IAAI,KAAK,KAAK,CAAC,EAAE;oBAChB,MAAA,OAAO,CAAC,GAAG,qCAAX,OAAO,CAAC,GAAG,IAAM,EAAE,GAAG,EAAE,OAAO,EAAE,EAAC;iBAClC;aACD;YACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF;;;;WAIG;QACH,mBAAc,GAAG,CAAC,UAAuB,EAAE,EAAE;;;YAC5C,MAAM,OAAO,GAA2C,EAAE,CAAC;YAC3D,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE;gBAC5B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;gBACzC,MAAA,OAAO,MAAC,EAAE,CAAC,GAAG,qCAAd,OAAO,OAAa,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAC;aACnD;YACD,IAAI,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC;QAEF,mBAAc,GAAG,CAAC,EACjB,UAAU,GAAG,EAAE,EACf,SAAS,GAAG,EAAE,GAId,EAAE,EAAE;;;YACJ,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;YACtB,MAAM,OAAO,GAA2C,EAAE,CAAC;YAC3D,gEAAgE;YAChE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE;gBACvB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;aACvC;YACD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE;gBACjC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,CAAC,EAAE;oBAChD,MAAM,IAAI,KAAK,CACd,+BAA+B,IAAI,CAAC,OAAO,IAAI;wBAC9C,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CACzB,CAAC;iBACF;gBACD,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;gBAC7C,MAAA,OAAO,MAAC,QAAQ,CAAC,GAAG,qCAApB,OAAO,OAAmB,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAC;aAChE;YACD,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE;gBACpD,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE;oBACvC,MAAM,IAAI,KAAK,CACd,iCAAiC,IAAI,CAAC,OAAO,IAAI;wBAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CACpB,CAAC;iBACF;gBACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,sBAAsB,CAAC,GAAG,CAAC,CAAC;gBAC1C,MAAA,OAAO,CAAC,GAAG,qCAAX,OAAO,CAAC,GAAG,IAAM,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAC;aACzC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC,CAAC;QArGD,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,mBAAmB,GAAG,mBAAmB,CAAC;IAChD,CAAC;CAmGD"}

package/dist/esm/entities/EntityStore.d.ts

@@ -1,85 +1,80 @@
 import { DocumentBaseline, ObjectIdentifier, Operation } from '@verdant-web/common';
 import { Context } from '../context.js';
-import { FileManager } from '../files/FileManager.js';
 import { Metadata } from '../metadata/Metadata.js';
-export interface OperationBatch {
-    run: (fn: () => void) => this;
-    flush: () => Promise<void>;
-    discard: () => void;
-}
-export declare class EntityStore {
-    private documentFamilyCaches;
-    meta: Metadata;
-    private operationBatcher;
-    files: FileManager;
-    private context;
-    private unsubscribes;
-    private _disposed;
-    private get log();
-    private get db();
-    private get undoHistory();
-    private get schema();
-    private currentBatchKey;
-    private defaultBatchTimeout;
-    constructor({ context, meta, batchTimeout, files, }: {
-        context: Context;
+import { Entity } from './Entity.js';
+import { Disposable } from '../utils/Disposable.js';
+import { FileManager } from '../files/FileManager.js';
+import { WeakEvent } from 'weak-event';
+import { abort } from 'process';
+export type EntityStoreEventData = {
+    oid: ObjectIdentifier;
+    operations?: Record<string, Operation[]>;
+    baselines?: DocumentBaseline[];
+    isLocal: boolean;
+};
+export type EntityStoreEvents = {
+    add: WeakEvent<EntityStore, EntityStoreEventData>;
+    replace: WeakEvent<EntityStore, EntityStoreEventData>;
+    resetAll: WeakEvent<EntityStore, void>;
+};
+type IncomingData = {
+    operations?: Operation[];
+    baselines?: DocumentBaseline[];
+    reset?: boolean;
+    isLocal?: boolean;
+};
+export declare class EntityStore extends Disposable {
+    private ctx;
+    private meta;
+    private files;
+    private batcher;
+    private queryableStorage;
+    private events;
+    private cache;
+    private pendingEntityPromises;
+    private abortDataQueueController;
+    private ongoingResetPromise;
+    private entityFinalizationRegistry;
+    constructor({ ctx, meta, files, }: {
+        ctx: Context;
         meta: Metadata;
         files: FileManager;
-        batchTimeout?: number;
     });
-    setContext: (context: Context) => void;
-    private getDocumentSchema;
-    private refreshFamilyCache;
-    private openFamilyCache;
-    private onEntityChange;
-    private writeDocumentToStorage;
-    get: (oid: ObjectIdentifier) => Promise<import("./Entity.js").Entity<any, any, any> | null>;
-    /**
-     * Advanced usage!
-     * Immediately returns an entity if it exists in the memory cache. An
-     * entity would be cached if it has been retrieved by a live query.
-     */
-    getCached: (oid: ObjectIdentifier) => import("./Entity.js").Entity<any, any, any> | null;
-    /**
-     * Creates a new document and returns an Entity for it. The created
-     * document is submitted to storage and sync.
-     */
-    create: (initial: any, oid: ObjectIdentifier, options: {
-        undoable?: boolean;
-    }) => Promise<import("./Entity.js").Entity<any, any, any>>;
-    private addOperationsToOpenCaches;
-    private addBaselinesToOpenCaches;
-    private addDataToOpenCaches;
-    addData: ({ operations, baselines, reset, }: {
-        operations: Operation[];
-        baselines: DocumentBaseline[];
-        reset?: boolean | undefined;
-    }) => Promise<void>;
-    addLocalOperations: (operations: Operation[]) => Promise<void>;
-    batch: ({ undoable, batchName, max, timeout, }?: {
+    get batch(): ({ undoable, batchName, max, timeout, }?: {
         undoable?: boolean | undefined;
         batchName?: string | undefined;
         max?: number | null | undefined;
         timeout?: number | null | undefined;
-    }) => OperationBatch;
+    }) => import("./OperationBatcher.js").OperationBatch;
+    get flushAllBatches(): () => Promise<any[]>;
+    addData: (data: IncomingData) => Promise<void>;
+    private resetData;
+    private processData;
+    hydrate: (oid: string, opts?: {
+        abort: AbortSignal;
+    }) => Promise<Entity | null>;
+    destroy: () => Promise<void>;
     /**
-     * @deprecated use `batch` instead
+     * Creates a new Entity with the given initial data.
      */
-    flushPatches: () => Promise<void>;
-    flushAllBatches: () => Promise<void>;
-    private flushOperations;
-    private submitOperations;
-    private getInverseOperations;
-    private createUndo;
-    delete: (oid: ObjectIdentifier, options?: {
+    create: (initial: any, oid: ObjectIdentifier, { undoable }?: {
+        undoable?: boolean | undefined;
+    }) => Promise<Entity<any, any, any>>;
+    deleteAll: (oids: ObjectIdentifier[], options?: {
         undoable?: boolean;
     }) => Promise<void>;
-    deleteAll: (oids: ObjectIdentifier[], options?: {
+    delete: (oid: ObjectIdentifier, options?: {
         undoable?: boolean;
     }) => Promise<void>;
-    reset: () => Promise<void>;
-    destroy: () => Promise<void>;
-    private handleRebase;
-    private resetStoredDocuments;
-    private refreshAllCaches;
+    private getCollectionSchema;
+    /**
+     * Constructs an entity from an OID, but does not load it.
+     */
+    private constructEntity;
+    private onPendingOperations;
+    /**
+     * Loads initial Entity data from storage
+     */
+    private loadEntity;
 }
+export {};