@verdant-web/store 3.0.0-next.0 → 3.0.0

package/dist/cjs/entities/DocumentFamiliyCache.d.ts

@@ -1,96 +0,0 @@
-import { DocumentBaseline, EventSubscriber, ObjectIdentifier, Operation, StorageFieldSchema } from '@verdant-web/common';
-import { Entity } from './Entity.js';
-import type { EntityStore } from './EntityStore.js';
-import { Context } from '../context.js';
-import { TaggedOperation } from '../types.js';
-/**
- * Local operations: operations on this client that haven't
- * yet been synced and are only applied in-memory. These are
- * always applied after all other operations, they are conceptually
- * 'in the future' as they are not yet synced or stored.
- *
- * Confirmed operations: operations that have been synced and
- * stored in the database.
- *
- * Unconfirmed operations: operations received from sync which
- * have not been stored yet and are only in memory. These exist
- * because new incoming operations are synchronously applied to
- * cached entities while storage goes on async.
- */
-export declare class DocumentFamilyCache extends EventSubscriber<Record<`change:${string}`, () => void> & {
-    'change:*': (oid: ObjectIdentifier) => void;
-}> {
-    readonly oid: ObjectIdentifier;
-    private operationsMap;
-    private localOperationsMap;
-    private baselinesMap;
-    private entities;
-    private context;
-    private storeTools;
-    private _initialized;
-    get initializedPromise(): Promise<boolean>;
-    setInitialized: () => void;
-    constructor({ oid, store, context, }: {
-        oid: ObjectIdentifier;
-        store: EntityStore;
-        context: Context;
-    });
-    get weakRef(): <T extends object>(value: T) => WeakRef<T>;
-    insertLocalOperations: (operations: Operation[]) => void;
-    insertOperations: (operations: TaggedOperation[], info: {
-        isLocal: boolean;
-        affectedOids?: Set<ObjectIdentifier>;
-    }) => void;
-    /**
-     * Insert new baselines for objects in this family.
-     * Automatically drops operations before the new baseline.
-     */
-    insertBaselines: (baselines: DocumentBaseline[], { affectedOids, }: {
-        isLocal: boolean;
-        affectedOids?: Set<string> | undefined;
-    }) => void;
-    addData: ({ operations, baselines, reset, isLocal, }: {
-        operations: TaggedOperation[];
-        baselines: DocumentBaseline[];
-        reset?: boolean | undefined;
-        isLocal?: boolean | undefined;
-    }) => void;
-    private applyOperations;
-    computeView: (oid: ObjectIdentifier) => {
-        view: any;
-        deleted: boolean;
-        lastTimestamp: number | null;
-    };
-    computeConfirmedView: (oid: ObjectIdentifier) => {
-        view: any;
-        deleted: boolean;
-        empty: boolean;
-    };
-    getLastTimestamp: (oid: ObjectIdentifier) => number | null;
-    getEntity: ({ oid, fieldSchema: schema, parent, readonlyKeys, fieldKey, }: {
-        oid: ObjectIdentifier;
-        fieldSchema: StorageFieldSchema;
-        parent?: Entity<any, any, any> | undefined;
-        readonlyKeys?: string[] | undefined;
-        fieldKey?: string | undefined;
-    }) => Entity;
-    hasOid: (oid: ObjectIdentifier) => boolean;
-    dispose: () => void;
-    reset: ({ operations, baselines, dropExistingUnconfirmed: dropUnconfirmed, unconfirmedOperations, dropAll, }: {
-        operations: TaggedOperation[];
-        unconfirmedOperations?: Operation[] | undefined;
-        baselines: DocumentBaseline[];
-        /**
-         * Whether to drop operations which are only in-memory. Unconfirmed operations
-         * will not be restored from storage until they are persisted, so it's not advisable
-         * to use this unless the intention is to completely clear the entities.
-         */
-        dropExistingUnconfirmed?: boolean | undefined;
-        /**
-         * Drop unconfirmed and confirmed data before resetting to incoming data.
-         * This is dangerous due to race conditions. Only use when a full reset is
-         * required.
-         */
-        dropAll?: boolean | undefined;
-    }) => void;
-}

package/dist/cjs/entities/DocumentFamiliyCache.js

@@ -1,287 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentFamilyCache = void 0;
-const common_1 = require("@verdant-web/common");
-const Entity_js_1 = require("./Entity.js");
-const Resolvable_js_1 = require("../utils/Resolvable.js");
-/**
- * Local operations: operations on this client that haven't
- * yet been synced and are only applied in-memory. These are
- * always applied after all other operations, they are conceptually
- * 'in the future' as they are not yet synced or stored.
- *
- * Confirmed operations: operations that have been synced and
- * stored in the database.
- *
- * Unconfirmed operations: operations received from sync which
- * have not been stored yet and are only in memory. These exist
- * because new incoming operations are synchronously applied to
- * cached entities while storage goes on async.
- */
-class DocumentFamilyCache extends common_1.EventSubscriber {
-    get initializedPromise() {
-        return this._initialized.promise;
-    }
-    constructor({ oid, store, context, }) {
-        super();
-        this.entities = new Map();
-        this._initialized = new Resolvable_js_1.Resolvable();
-        this.setInitialized = () => {
-            this._initialized.resolve(true);
-        };
-        this.insertLocalOperations = (operations) => {
-            const oidSet = new Set();
-            for (const operation of operations) {
-                const { oid } = operation;
-                oidSet.add(oid);
-                const existingOperations = this.localOperationsMap.get(oid) || [];
-                existingOperations.push(operation);
-                this.localOperationsMap.set(oid, existingOperations);
-            }
-            for (const oid of oidSet) {
-                const entityRef = this.entities.get(oid);
-                const entity = entityRef === null || entityRef === void 0 ? void 0 : entityRef.deref();
-                if (entity) {
-                    (0, Entity_js_1.refreshEntity)(entity, { isLocal: true });
-                    this.emit(`change:${oid}`);
-                    this.emit('change:*', oid);
-                }
-            }
-        };
-        this.insertOperations = (operations, info) => {
-            var _a;
-            for (const operation of operations) {
-                const { oid } = operation;
-                (_a = info.affectedOids) === null || _a === void 0 ? void 0 : _a.add(oid);
-                const existingOperations = this.operationsMap.get(oid) || [];
-                // insert in order of timestamp
-                const index = existingOperations.findIndex((op) => op.timestamp >= operation.timestamp);
-                // ensure the operation doesn't already exist in this position
-                if (index !== -1) {
-                    if (existingOperations[index].timestamp === operation.timestamp) {
-                        continue;
-                    }
-                    existingOperations.splice(index, 0, operation);
-                }
-                else {
-                    existingOperations.push(operation);
-                }
-                this.operationsMap.set(oid, existingOperations);
-                // FIXME: seems inefficient
-                const unconfirmedOperations = this.localOperationsMap.get(oid);
-                if (unconfirmedOperations) {
-                    this.localOperationsMap.set(oid, unconfirmedOperations.filter((op) => op.timestamp !== operation.timestamp));
-                }
-            }
-        };
-        /**
-         * Insert new baselines for objects in this family.
-         * Automatically drops operations before the new baseline.
-         */
-        this.insertBaselines = (baselines, { affectedOids, }) => {
-            var _a;
-            for (const baseline of baselines) {
-                const { oid } = baseline;
-                // opt out if our baseline is newer.
-                const existing = this.baselinesMap.get(oid);
-                if ((existing === null || existing === void 0 ? void 0 : existing.timestamp) && existing.timestamp >= baseline.timestamp) {
-                    continue;
-                }
-                affectedOids === null || affectedOids === void 0 ? void 0 : affectedOids.add(oid);
-                this.baselinesMap.set(oid, baseline);
-                // drop operations before the baseline
-                const ops = this.operationsMap.get(oid) || [];
-                while (((_a = ops[0]) === null || _a === void 0 ? void 0 : _a.timestamp) < baseline.timestamp) {
-                    ops.shift();
-                }
-            }
-        };
-        this.addData = ({ operations, baselines, reset, isLocal, }) => {
-            if (reset) {
-                this.operationsMap.clear();
-                this.baselinesMap.clear();
-            }
-            const info = {
-                isLocal: isLocal || false,
-                affectedOids: new Set(),
-            };
-            this.insertBaselines(baselines, info);
-            // for reset scenario, don't immediately update entities;
-            // we will update all of them in one go.
-            this.insertOperations(operations, info);
-            if (reset) {
-                for (const entityRef of this.entities.values()) {
-                    const entity = entityRef.deref();
-                    if (entity) {
-                        (0, Entity_js_1.refreshEntity)(entity, info);
-                    }
-                }
-            }
-            else {
-                for (const oid of info.affectedOids) {
-                    const entityRef = this.entities.get(oid);
-                    const entity = entityRef === null || entityRef === void 0 ? void 0 : entityRef.deref();
-                    if (entity) {
-                        (0, Entity_js_1.refreshEntity)(entity, info);
-                        this.emit(`change:${oid}`);
-                        this.emit('change:*', oid);
-                    }
-                }
-            }
-        };
-        this.applyOperations = (view, deleted, operations, after) => {
-            let futureSeen = undefined;
-            const now = this.storeTools.now;
-            for (const operation of operations) {
-                if (after && operation.timestamp <= after) {
-                    continue;
-                }
-                if ((0, common_1.compareTimestampSchemaVersions)(operation.timestamp, now) > 0) {
-                    // we don't apply patches from future versions
-                    futureSeen = operation.timestamp;
-                    continue;
-                }
-                if (operation.data.op === 'delete') {
-                    deleted = true;
-                }
-                else {
-                    view = (0, common_1.applyPatch)(view, operation.data);
-                    if (operation.data.op === 'initialize') {
-                        deleted = false;
-                    }
-                }
-            }
-            if (futureSeen) {
-                this.context.globalEvents.emit('futureSeen', futureSeen);
-            }
-            return { view, deleted, empty: !view && !operations.length };
-        };
-        this.computeView = (oid) => {
-            if (this.baselinesMap.size === 0 &&
-                this.operationsMap.size === 0 &&
-                this.localOperationsMap.size === 0) {
-                this.context.log('debug', `Entity ${oid} accessed with no data at all`);
-                return { view: null, deleted: true, lastTimestamp: null };
-            }
-            const confirmed = this.computeConfirmedView(oid);
-            const unconfirmedOperations = this.localOperationsMap.get(oid) || [];
-            if (confirmed.empty && !unconfirmedOperations.length) {
-                this.context.log('debug', `Entity ${oid} accessed with no local data at all`);
-                return { view: null, deleted: true, lastTimestamp: null };
-            }
-            let { view, deleted } = this.applyOperations(confirmed.view, confirmed.deleted, unconfirmedOperations);
-            if (view) {
-                (0, common_1.assignOid)(view, oid);
-            }
-            return { view, deleted, lastTimestamp: this.getLastTimestamp(oid) };
-        };
-        this.computeConfirmedView = (oid) => {
-            const baseline = this.baselinesMap.get(oid);
-            const operations = this.operationsMap.get(oid) || [];
-            const snapshot = (0, common_1.cloneDeep)((baseline === null || baseline === void 0 ? void 0 : baseline.snapshot) || undefined);
-            const result = this.applyOperations(snapshot, !snapshot, operations, baseline === null || baseline === void 0 ? void 0 : baseline.timestamp);
-            if (result.view) {
-                (0, common_1.assignOid)(result.view, oid);
-            }
-            if (result.empty) {
-                this.context.log('debug', `Entity ${oid} accessed with no confirmed data`);
-            }
-            return result;
-        };
-        this.getLastTimestamp = (oid) => {
-            var _a, _b, _c;
-            let operations = this.localOperationsMap.get(oid);
-            if (!(operations === null || operations === void 0 ? void 0 : operations.length)) {
-                operations = this.operationsMap.get(oid) || [];
-            }
-            let logicalTimestamp = null;
-            if (operations.length) {
-                logicalTimestamp = (_a = operations[operations.length - 1]) === null || _a === void 0 ? void 0 : _a.timestamp;
-            }
-            else {
-                logicalTimestamp = (_c = (_b = this.baselinesMap.get(oid)) === null || _b === void 0 ? void 0 : _b.timestamp) !== null && _c !== void 0 ? _c : null;
-            }
-            if (!logicalTimestamp)
-                return null;
-            return this.storeTools.time.getWallClockTime(logicalTimestamp);
-        };
-        this.getEntity = ({ oid, fieldSchema: schema, parent, readonlyKeys, fieldKey, }) => {
-            var _a;
-            let entityRef = this.entities.get(oid);
-            let entity = entityRef === null || entityRef === void 0 ? void 0 : entityRef.deref();
-            if (!entity) {
-                entity = new Entity_js_1.Entity({
-                    oid,
-                    cache: this,
-                    fieldSchema: schema,
-                    store: this.storeTools,
-                    parent,
-                    readonlyKeys,
-                    fieldPath: fieldKey
-                        ? [...((_a = parent === null || parent === void 0 ? void 0 : parent.fieldPath) !== null && _a !== void 0 ? _a : []), fieldKey]
-                        : undefined,
-                });
-                // immediately add to cache and queue a removal if nobody subscribed
-                this.entities.set(oid, this.context.weakRef(entity));
-            }
-            return entity;
-        };
-        this.hasOid = (oid) => {
-            return this.operationsMap.has(oid) || this.baselinesMap.has(oid);
-        };
-        this.dispose = () => {
-            this.entities.forEach((entity) => { var _a; return (_a = entity.deref()) === null || _a === void 0 ? void 0 : _a.dispose(); });
-            this.entities.clear();
-        };
-        this.reset = ({ operations, baselines, dropExistingUnconfirmed: dropUnconfirmed = false, unconfirmedOperations, dropAll, }) => {
-            this.context.log('debug', `Resetting cache for ${this.oid} with ${operations.length} ops and ${baselines.length} baselines, dropUnconfirmed=${dropUnconfirmed}`);
-            const info = { isLocal: false, affectedOids: new Set() };
-            // NOTE: not clearing these maps... there are even more
-            // race conditions where we begin opening a cache, queue up a
-            // reset, then receive incoming operations before the reset
-            // actually hits this function, so those incoming ops are
-            // dropped.
-            // FIXME: include this in a future refactor of this
-            // whole system.
-            if (dropAll)
-                this.baselinesMap.clear();
-            this.insertBaselines(baselines, info);
-            if (dropAll)
-                this.operationsMap.clear();
-            this.insertOperations(operations, info);
-            if (unconfirmedOperations || dropUnconfirmed) {
-                this.localOperationsMap.clear();
-                if (unconfirmedOperations) {
-                    this.insertLocalOperations(unconfirmedOperations);
-                }
-            }
-            for (const oid of this.entities.keys()) {
-                const entityRef = this.entities.get(oid);
-                const entity = entityRef === null || entityRef === void 0 ? void 0 : entityRef.deref();
-                if (entity) {
-                    (0, Entity_js_1.refreshEntity)(entity, info);
-                    this.emit(`change:${oid}`);
-                    this.emit('change:*', oid);
-                }
-            }
-        };
-        this.oid = oid;
-        this.operationsMap = new Map();
-        this.localOperationsMap = new Map();
-        this.baselinesMap = new Map();
-        this.storeTools = {
-            addLocalOperations: store.addLocalOperations,
-            patchCreator: store.meta.patchCreator,
-            addFile: store.files.add,
-            getFile: store.files.get,
-            time: store.meta.time,
-            now: store.meta.now,
-        };
-        this.context = context;
-    }
-    get weakRef() {
-        return this.context.weakRef;
-    }
-}
-exports.DocumentFamilyCache = DocumentFamilyCache;
-//# sourceMappingURL=DocumentFamiliyCache.js.map

package/dist/cjs/entities/DocumentFamiliyCache.js.map

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

package/dist/cjs/entities/FakeWeakRef.d.ts

@@ -1,11 +0,0 @@
-/**
- * This module exists since I'm a little anxious about using WeakRef in production
- * and want to be able to roll it back quickly to debug issues. Basically by adding
- * import { WeakRef } from 'FakeWeakRef' to the top of the file, we can switch back
- * to using a simple object reference.
- */
-export declare class WeakRef<T> {
-    constructor(value: T);
-    value: T;
-    deref(): T | undefined;
-}

package/dist/cjs/entities/FakeWeakRef.js

@@ -1,19 +0,0 @@
-"use strict";
-/**
- * This module exists since I'm a little anxious about using WeakRef in production
- * and want to be able to roll it back quickly to debug issues. Basically by adding
- * import { WeakRef } from 'FakeWeakRef' to the top of the file, we can switch back
- * to using a simple object reference.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WeakRef = void 0;
-class WeakRef {
-    constructor(value) {
-        this.value = value;
-    }
-    deref() {
-        return this.value;
-    }
-}
-exports.WeakRef = WeakRef;
-//# sourceMappingURL=FakeWeakRef.js.map

package/dist/cjs/entities/FakeWeakRef.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FakeWeakRef.js","sourceRoot":"","sources":["../../../src/entities/FakeWeakRef.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,MAAa,OAAO;IACnB,YAAY,KAAQ;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAID,KAAK;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;CACD;AAVD,0BAUC"}

package/dist/cjs/indexes.d.ts

@@ -1,3 +0,0 @@
-import { StorageCollectionSchema } from '@verdant-web/common';
-export declare function computeSynthetics(schema: StorageCollectionSchema, obj: any): Record<string, any>;
-export declare function computeCompoundIndices(schema: StorageCollectionSchema<any, any, any>, doc: any): any;

package/dist/cjs/indexes.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.computeCompoundIndices = exports.computeSynthetics = void 0;
-const common_1 = require("@verdant-web/common");
-function computeSynthetics(schema, obj) {
-    const result = {};
-    for (const [name, property] of Object.entries(schema.synthetics || {})) {
-        result[name] = property.compute(obj);
-    }
-    return result;
-}
-exports.computeSynthetics = computeSynthetics;
-function computeCompoundIndices(schema, doc) {
-    return Object.entries(schema.compounds || {}).reduce((acc, [indexKey, index]) => {
-        acc[indexKey] = (0, common_1.createCompoundIndexValue)(...index.of.map((key) => doc[key]));
-        return acc;
-    }, {});
-}
-exports.computeCompoundIndices = computeCompoundIndices;
-//# sourceMappingURL=indexes.js.map

package/dist/cjs/indexes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"indexes.js","sourceRoot":"","sources":["../../src/indexes.ts"],"names":[],"mappings":";;;AAAA,gDAM6B;AAE7B,SAAgB,iBAAiB,CAAC,MAA+B,EAAE,GAAQ;IAC1E,MAAM,MAAM,GAAwB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE;QACvE,MAAM,CAAC,IAAI,CAAC,GAAI,QAA6C,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;KAC3E;IACD,OAAO,MAAM,CAAC;AACf,CAAC;AAND,8CAMC;AAED,SAAgB,sBAAsB,CACrC,MAA8C,EAC9C,GAAQ;IAER,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,MAAM,CAElD,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,EAAE;QAC5B,GAAG,CAAC,QAAQ,CAAC,GAAG,IAAA,iCAAwB,EACvC,GAAI,KAA2C,CAAC,EAAE,CAAC,GAAG,CACrD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,CAAoB,CACpC,CACD,CAAC;QACF,OAAO,GAAG,CAAC;IACZ,CAAC,EAAE,EAAwC,CAAC,CAAC;AAC9C,CAAC;AAdD,wDAcC"}

package/dist/esm/entities/2/Entity.d.ts

@@ -1,148 +0,0 @@
-import { EntityValidationProblem, EventSubscriber, ObjectIdentifier, PatchCreator, StorageFieldSchema } from '@verdant-web/common';
-import { Context } from '../../context.js';
-import { FileManager } from '../../files/FileManager.js';
-import { EntityCache } from './EntityCache.js';
-import { EntityFamilyMetadata, EntityMetadataView } from './EntityMetadata.js';
-import { BaseEntityValue, DataFromInit, DeepPartial, EntityChange, EntityEvents, ListEntity, ListItemInit, ListItemValue, ObjectEntity } from './types.js';
-import { EntityStoreEvents } from './EntityStore.js';
-export interface EntityInit {
-    oid: ObjectIdentifier;
-    schema: StorageFieldSchema;
-    entityFamily?: EntityCache;
-    metadataFamily: EntityFamilyMetadata;
-    parent?: Entity;
-    ctx: Context;
-    files: FileManager;
-    readonlyKeys?: string[];
-    fieldPath?: (string | number)[];
-    patchCreator: PatchCreator;
-    events: EntityStoreEvents;
-}
-export declare class Entity<Init = any, KeyValue extends BaseEntityValue = any, Snapshot extends any = DataFromInit<Init>> extends EventSubscriber<EntityEvents> implements ObjectEntity<Init, KeyValue, Snapshot>, ListEntity<Init, KeyValue, Snapshot> {
-    readonly oid: ObjectIdentifier;
-    private readonlyKeys;
-    private fieldPath;
-    private entityFamily;
-    private metadataFamily;
-    private schema;
-    private parent;
-    private ctx;
-    private files;
-    private patchCreator;
-    private events;
-    private _viewData;
-    private validationError;
-    private cachedDeepUpdatedAt;
-    private wasDeletedLastChange;
-    private cachedView;
-    constructor({ oid, schema, entityFamily: childCache, parent, ctx, metadataFamily, readonlyKeys, files, patchCreator, events, }: EntityInit);
-    private onAdd;
-    private onReplace;
-    private onResetAll;
-    private get metadata();
-    /**
-     * The view of this Entity, not including nested
-     * entities (that's the snapshot - see #getSnapshot())
-     *
-     * Nested entities are represented by refs.
-     */
-    private get viewData();
-    /** convenience getter for viewData.view */
-    private get rawView();
-    /**
-     * An Entity's View includes the rendering of its underlying data,
-     * connecting of children where refs were, and validation
-     * and pruning according to schema.
-     */
-    private get view();
-    private childIsNull;
-    get uid(): string;
-    get deleted(): boolean;
-    get invalid(): boolean;
-    get isList(): any;
-    get updatedAt(): number;
-    get deepUpdatedAt(): number;
-    /**
-     * @internal - this is relevant to Verdant's system, not users.
-     *
-     * Indicates whether this document is from an outdated version
-     * of the schema - which means it cannot be used until it is upgraded.
-     */
-    get isOutdatedVersion(): boolean;
-    /**
-     * Pruning - when entities have invalid children, we 'prune' that
-     * data up to the nearest prunable point - a nullable field,
-     * or a list.
-     */
-    protected validate: (...args: unknown[]) => EntityValidationProblem | undefined;
-    private viewWithMappedChildren;
-    /**
-     * A current snapshot of this Entity's data, including nested
-     * Entities.
-     */
-    getSnapshot: () => any;
-    private addPendingOperations;
-    private addConfirmedData;
-    private replaceAllData;
-    private resetAllData;
-    private change;
-    protected deepChange: (target: Entity, ev: EntityChange) => void;
-    private getChild;
-    /**
-     * Gets a value from this Entity. If the value
-     * is an object, it will be wrapped in another
-     * Entity.
-     */
-    get: <Key extends keyof KeyValue>(key: Key) => KeyValue[Key];
-    private processInputValue;
-    private getDeleteMode;
-    /**
-     * Returns the referent value of an item in the list, used for
-     * operations which act on items. if the item is an object,
-     * it will attempt to create an OID reference to it. If it
-     * is a primitive, it will return the primitive.
-     */
-    private getItemRefValue;
-    set: <Key extends keyof Init>(key: Key, value: Init[Key]) => void;
-    /**
-     * Returns a destructured version of this Entity, where child
-     * Entities are accessible at their respective keys.
-     */
-    getAll: () => KeyValue;
-    delete: (key: any) => void;
-    keys: () => string[];
-    entries: () => [string, Exclude<KeyValue[keyof KeyValue], undefined>][];
-    values: () => Exclude<KeyValue[keyof KeyValue], undefined>[];
-    update: (data: DeepPartial<Init>, { merge, replaceSubObjects, }?: {
-        replaceSubObjects?: boolean | undefined;
-        merge?: boolean | undefined;
-    }) => void;
-    get length(): number;
-    push: (value: ListItemInit<Init>) => void;
-    insert: (index: number, value: ListItemInit<Init>) => void;
-    move: (from: number, to: number) => void;
-    moveItem: (item: ListItemValue<KeyValue>, to: number) => void;
-    add: (value: ListItemValue<KeyValue>) => void;
-    removeAll: (item: ListItemValue<KeyValue>) => void;
-    removeFirst: (item: ListItemValue<KeyValue>) => void;
-    removeLast: (item: ListItemValue<KeyValue>) => void;
-    [Symbol.iterator](): {
-        next: () => {
-            readonly value: ListItemValue<KeyValue>;
-            readonly done: false;
-        } | {
-            readonly value: undefined;
-            readonly done: true;
-        };
-    };
-    map: <U>(callback: (value: ListItemValue<KeyValue>, index: number) => U) => U[];
-    filter: (callback: (value: ListItemValue<KeyValue>, index: number) => boolean) => ListItemValue<KeyValue>[];
-    has: (value: ListItemValue<KeyValue>) => boolean;
-    forEach: (callback: (value: ListItemValue<KeyValue>, index: number) => void) => void;
-    some: (predicate: (value: ListItemValue<KeyValue>) => boolean) => boolean;
-    every: (predicate: (value: ListItemValue<KeyValue>) => boolean) => boolean;
-    find: (predicate: (value: ListItemValue<KeyValue>) => boolean) => ListItemValue<KeyValue> | undefined;
-    includes: (value: ListItemValue<KeyValue>) => boolean;
-    __getViewData__: (oid: ObjectIdentifier, type: 'confirmed' | 'pending') => EntityMetadataView;
-    __getFamilyOids__: () => string[];
-}