@verdant-web/store 2.0.1

package/dist/cjs/reactives/DocumentFamiliyCache.js

@@ -0,0 +1,211 @@
+"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 FakeWeakRef_js_1 = require("./FakeWeakRef.js");
+class DocumentFamilyCache extends common_1.EventSubscriber {
+    constructor({ oid, store, context, }) {
+        super();
+        this.entities = new Map();
+        this.insertUnconfirmedOperations = (operations) => {
+            const oidSet = new Set();
+            for (const operation of operations) {
+                const { oid } = operation;
+                oidSet.add(oid);
+                const existingOperations = this.unconfirmedOperationsMap.get(oid) || [];
+                existingOperations.push(operation);
+                this.unconfirmedOperationsMap.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.unconfirmedOperationsMap.get(oid);
+                if (unconfirmedOperations) {
+                    this.unconfirmedOperationsMap.set(oid, unconfirmedOperations.filter((op) => op.timestamp !== operation.timestamp));
+                }
+            }
+        };
+        this.insertBaselines = (baselines, { affectedOids, }) => {
+            var _a;
+            for (const baseline of baselines) {
+                const { oid } = baseline;
+                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.addConfirmedData = ({ 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) => {
+            for (const operation of operations) {
+                if (after && operation.timestamp <= after) {
+                    continue;
+                }
+                if (operation.data.op === 'delete') {
+                    deleted = true;
+                }
+                else {
+                    view = (0, common_1.applyPatch)(view, operation.data);
+                    if (operation.data.op === 'initialize') {
+                        deleted = false;
+                    }
+                }
+            }
+            return { view, deleted };
+        };
+        this.computeView = (oid) => {
+            const confirmed = this.computeConfirmedView(oid);
+            const unconfirmedOperations = this.unconfirmedOperationsMap.get(oid) || [];
+            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) || [];
+            let view = (0, common_1.cloneDeep)((baseline === null || baseline === void 0 ? void 0 : baseline.snapshot) || undefined);
+            view = this.applyOperations(view, !view, operations, baseline === null || baseline === void 0 ? void 0 : baseline.timestamp);
+            if (view) {
+                (0, common_1.assignOid)(view, oid);
+            }
+            if (!baseline && !operations.length) {
+                this.context.log('debug', `Entity ${oid} accessed with no confirmed data`);
+            }
+            return view;
+        };
+        this.getLastTimestamp = (oid) => {
+            var _a, _b, _c;
+            let operations = this.unconfirmedOperationsMap.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, schema, parent) => {
+            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,
+                });
+                // immediately add to cache and queue a removal if nobody subscribed
+                this.entities.set(oid, new FakeWeakRef_js_1.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) => {
+            const info = { isLocal: false, affectedOids: new Set() };
+            this.baselinesMap = new Map(baselines.map((baseline) => [baseline.oid, baseline]));
+            this.operationsMap = new Map();
+            this.insertOperations(operations, info);
+            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.unconfirmedOperationsMap = 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,
+        };
+        this.context = context;
+    }
+}
+exports.DocumentFamilyCache = DocumentFamilyCache;
+//# sourceMappingURL=DocumentFamiliyCache.js.map

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

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

package/dist/cjs/reactives/Entity.d.ts

@@ -0,0 +1,191 @@
+import { EventSubscriber, FileData, ObjectIdentifier, Operation, PatchCreator, StorageFieldSchema, StorageFieldsSchema, TimestampProvider } from '@verdant-web/common';
+import { EntityFile } from '../files/EntityFile.js';
+import { WeakRef } from './FakeWeakRef.js';
+export declare const ADD_OPERATIONS = "@@addOperations";
+export declare const DELETE = "@@delete";
+export declare const REBASE = "@@rebase";
+declare const REFRESH = "@@refresh";
+export declare const DEEP_CHANGE = "@@deepChange";
+export interface CacheTools {
+    computeView(oid: ObjectIdentifier): {
+        view: any;
+        deleted: boolean;
+        lastTimestamp: number | null;
+    };
+    getEntity(oid: ObjectIdentifier, schema: StorageFieldSchema, parent?: Entity): Entity;
+    hasOid(oid: ObjectIdentifier): boolean;
+}
+export interface StoreTools {
+    addLocalOperations(operations: Operation[]): void;
+    patchCreator: PatchCreator;
+    addFile: (file: FileData) => void;
+    getFile: (id: string) => EntityFile;
+    time: TimestampProvider;
+}
+export type AccessibleEntityProperty<T> = T extends Array<any> ? number : T extends object ? keyof T : never;
+type DataFromInit<Init> = Init extends {
+    [key: string]: any;
+} ? {
+    [Key in keyof Init]: Init[Key];
+} : Init extends Array<any> ? Init : any;
+export type EntityShape<E extends Entity<any, any>> = E extends Entity<infer Value, any> ? Value : never;
+type DeletableKeys<T> = keyof {
+    [Key in keyof T as IfNullableThen<T[Key], Key>]: Key;
+};
+type IfNullableThen<T, Out> = undefined extends T ? Out : null extends T ? Out : never;
+export declare function refreshEntity(entity: Entity<any, any>, info: EntityChangeInfo): void;
+export interface EntityChangeInfo {
+    isLocal?: boolean;
+}
+type EntityEvents = {
+    change: (info: EntityChangeInfo) => void;
+    changeDeep: (target: Entity<any, any>, info: EntityChangeInfo) => void;
+    delete: (info: EntityChangeInfo) => void;
+    restore: (info: EntityChangeInfo) => void;
+};
+type BaseEntityValue = {
+    [Key: string]: any;
+} | any[];
+export declare class Entity<Init = any, KeyValue extends BaseEntityValue = any, Snapshot extends any = DataFromInit<Init>> implements ObjectEntity<Init, KeyValue, Snapshot>, ListEntity<Init, KeyValue, Snapshot> {
+    protected _current: any | null;
+    readonly oid: ObjectIdentifier;
+    readonly collection: string;
+    protected readonly store: StoreTools;
+    protected readonly fieldSchema: StorageFieldSchema | StorageFieldsSchema;
+    protected readonly keyPath: import("@verdant-web/common").KeyPath;
+    protected readonly cache: CacheTools;
+    protected _deleted: boolean;
+    protected parent: WeakRef<Entity<any, any>> | undefined;
+    private cachedSnapshot;
+    private cachedDestructure;
+    private cachedDeepUpdatedAt;
+    private _updatedAt;
+    protected events: EventSubscriber<EntityEvents>;
+    protected hasSubscribersToDeepChanges(): boolean;
+    get hasSubscribers(): boolean;
+    get deleted(): boolean;
+    protected get value(): any;
+    get isList(): any;
+    get updatedAt(): number | null;
+    get deepUpdatedAt(): number | null;
+    get uid(): string;
+    constructor({ oid, store, fieldSchema, cache, parent, }: {
+        oid: ObjectIdentifier;
+        store: StoreTools;
+        fieldSchema: StorageFieldSchema | StorageFieldsSchema;
+        cache: CacheTools;
+        parent?: Entity<any, any>;
+    });
+    private [REFRESH];
+    private [DEEP_CHANGE];
+    protected getChildFieldSchema: (key: any) => any;
+    dispose: () => void;
+    subscribe: <EventName extends keyof EntityEvents>(event: EventName, callback: EntityEvents[EventName]) => () => void;
+    protected addPatches: (patches: Operation[]) => void;
+    protected cloneCurrent: () => any;
+    protected getSubObject: (oid: ObjectIdentifier, key: any) => Entity<any, any>;
+    protected wrapValue: <Key extends keyof KeyValue>(value: any, key: Key) => KeyValue[Key];
+    protected processInputValue: (value: any, key: any) => any;
+    get: <Key extends keyof KeyValue>(key: Key) => KeyValue[Key];
+    getAll: () => KeyValue;
+    /**
+     * Returns a copy of the entity and all sub-objects as
+     * a plain object or array.
+     */
+    getSnapshot: () => any;
+    /**
+     * Object methods
+     */
+    keys: () => string[];
+    entries: () => [string, any][];
+    values: () => any[];
+    set: <Key extends keyof Init>(key: Key, value: Init[Key]) => void;
+    delete: (key: any) => void;
+    private getDeleteMode;
+    /** @deprecated - renamed to delete */
+    remove: (key: any) => void;
+    update: (value: Partial<Snapshot>, { replaceSubObjects, merge, }?: {
+        replaceSubObjects?: boolean | undefined;
+        merge?: boolean | undefined;
+    }) => void;
+    /**
+     * List methods
+     */
+    /**
+     * 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;
+    get length(): any;
+    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;
+    removeAll: (item: ListItemValue<KeyValue>) => void;
+    removeFirst: (item: ListItemValue<KeyValue>) => void;
+    removeLast: (item: ListItemValue<KeyValue>) => void;
+    add: (item: ListItemValue<KeyValue>) => void;
+    has: (item: ListItemValue<KeyValue>) => any;
+    [Symbol.iterator](): {
+        next: () => {
+            readonly value: ListItemValue<KeyValue>;
+            readonly done: false;
+        } | {
+            readonly value: undefined;
+            readonly done: true;
+        };
+    };
+    private getAsWrapped;
+    map: <U>(callback: (value: ListItemValue<KeyValue>, index: number) => U) => U[];
+    filter: (callback: (value: ListItemValue<KeyValue>, index: number) => boolean) => ListItemValue<KeyValue>[];
+    forEach: (callback: (value: ListItemValue<KeyValue>, index: number) => void) => void;
+}
+export interface BaseEntity<Init, Value extends BaseEntityValue, Snapshot = DataFromInit<Init>> {
+    dispose: () => void;
+    subscribe<EventName extends keyof EntityEvents>(event: EventName, callback: EntityEvents[EventName]): () => void;
+    get<Key extends keyof Value>(key: Key): Value[Key];
+    getAll(): Value;
+    getSnapshot(): Snapshot;
+    readonly deleted: boolean;
+    readonly hasSubscribers: boolean;
+}
+export interface ObjectEntity<Init, Value extends BaseEntityValue, Snapshot = DataFromInit<Init>> extends BaseEntity<Init, Value, Snapshot> {
+    keys(): string[];
+    entries(): [string, Exclude<Value[keyof Value], undefined>][];
+    values(): Exclude<Value[keyof Value], undefined>[];
+    set<Key extends keyof Init>(key: Key, value: Init[Key]): void;
+    delete(key: DeletableKeys<Value>): void;
+    update(value: Partial<Snapshot>, options?: {
+        replaceSubObjects?: boolean;
+        merge?: boolean;
+    }): void;
+    readonly isList: false;
+}
+export interface ListEntity<Init, Value extends BaseEntityValue, Snapshot = DataFromInit<Init>> extends Iterable<ListItemValue<Value>>, BaseEntity<Init, Value, Snapshot> {
+    readonly isList: true;
+    readonly length: number;
+    push(value: ListItemInit<Init>): void;
+    insert(index: number, value: ListItemInit<Init>): void;
+    move(from: number, to: number): void;
+    moveItem(item: ListItemValue<Value>, to: number): void;
+    /**
+     * A Set operation which adds a value if an equivalent value is not already present.
+     * Object values are never the same.
+     */
+    add(value: ListItemValue<Value>): void;
+    removeAll(item: ListItemValue<Value>): void;
+    removeFirst(item: ListItemValue<Value>): void;
+    removeLast(item: ListItemValue<Value>): void;
+    map<U>(callback: (value: ListItemValue<Value>, index: number) => U): U[];
+    filter(callback: (value: ListItemValue<Value>, index: number) => boolean): ListItemValue<Value>[];
+    delete(index: number): void;
+    has(value: ListItemValue<Value>): boolean;
+    forEach(callback: (value: ListItemValue<Value>, index: number) => void): void;
+}
+export type AnyEntity<Init, KeyValue extends BaseEntityValue, Snapshot extends any> = ListEntity<Init, KeyValue, Snapshot> | ObjectEntity<Init, KeyValue, Snapshot>;
+type ListItemValue<KeyValue> = KeyValue extends Array<infer T> ? T : never;
+type ListItemInit<Init> = Init extends Array<infer T> ? T : never;
+export type EntityDestructured<T extends AnyEntity<any, any, any> | null> = (T extends ListEntity<any, infer KeyValue, any> ? KeyValue : T extends ObjectEntity<any, infer KeyValue, any> ? KeyValue : never) | (T extends null ? null : never);
+export {};