@verdant-web/store 2.0.1 → 2.0.2

package/dist/cjs/client/Client.js

@@ -1,227 +1,227 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Client = void 0;
-const common_1 = require("@verdant-web/common");
-const DocumentManager_js_1 = require("../DocumentManager.js");
-const FileManager_js_1 = require("../files/FileManager.js");
-const idb_js_1 = require("../idb.js");
-const openDocumentDatabase_js_1 = require("../openDocumentDatabase.js");
-const EntityStore_js_1 = require("../reactives/EntityStore.js");
-const Sync_js_1 = require("../sync/Sync.js");
-const CollectionQueries_js_1 = require("../queries2/CollectionQueries.js");
-const QueryCache_js_1 = require("../queries2/QueryCache.js");
-class Client {
-    get sync() {
-        return this._sync;
-    }
-    get entities() {
-        return this._entities;
-    }
-    get documentManager() {
-        return this._documentManager;
-    }
-    constructor(config, context, components) {
-        var _a;
-        this.config = config;
-        this.context = context;
-        this.addData = (data) => {
-            return this._entities.addData(data);
-        };
-        this.stats = async () => {
-            const collectionNames = Object.keys(this.schema.collections);
-            let collections = {};
-            for (const collectionName of collectionNames) {
-                collections[collectionName] = await (0, idb_js_1.getSizeOfObjectStore)(this.documentDb, collectionName);
-            }
-            const meta = await this.meta.stats();
-            const storage = typeof navigator !== 'undefined' &&
-                typeof navigator.storage !== 'undefined' &&
-                'estimate' in navigator.storage
-                ? await navigator.storage.estimate()
-                : undefined;
-            // determine data:metadata ratio for total size of all collections vs metadata
-            const totalCollectionsSize = Object.values(collections).reduce((acc, { size }) => acc + size, 0);
-            const totalMetaSize = meta.baselinesSize.size + meta.operationsSize.size;
-            const metaToDataRatio = totalMetaSize / totalCollectionsSize;
-            return {
-                collections,
-                meta,
-                storage,
-                totalMetaSize,
-                totalCollectionsSize,
-                metaToDataRatio,
-                quotaUsage: (storage === null || storage === void 0 ? void 0 : storage.usage) && (storage === null || storage === void 0 ? void 0 : storage.quota)
-                    ? storage.usage / storage.quota
-                    : undefined,
-            };
-        };
-        this.close = async () => {
-            var _a, _b;
-            await this.entities.flushPatches();
-            this.sync.stop();
-            this.sync.dispose();
-            this.meta.close();
-            this._entities.destroy();
-            await (0, idb_js_1.closeDatabase)(this.documentDb);
-            await (0, idb_js_1.closeDatabase)(this.metaDb);
-            (_b = (_a = this.context).log) === null || _b === void 0 ? void 0 : _b.call(_a, 'Client closed');
-        };
-        this.__dangerous__resetLocal = async () => {
-            this.sync.stop();
-            const req1 = indexedDB.deleteDatabase([this.namespace, 'meta'].join('_'));
-            const req2 = indexedDB.deleteDatabase([this.namespace, 'collections'].join('_'));
-            await Promise.all([
-                new Promise((resolve, reject) => {
-                    req1.onsuccess = resolve;
-                    req1.onerror = reject;
-                }),
-                new Promise((resolve, reject) => {
-                    req2.onsuccess = resolve;
-                    req2.onerror = reject;
-                }),
-            ]);
-            window.location.reload();
-        };
-        this.export = async () => {
-            const metaExport = await this.meta.export();
-            return Buffer.from(JSON.stringify(metaExport));
-        };
-        this.import = async (buffer) => {
-            this.context.log('Importing data...');
-            // close the document DB
-            await (0, idb_js_1.closeDatabase)(this.context.documentDb);
-            const metaExport = JSON.parse(buffer.toString());
-            await this.meta.resetFrom(metaExport);
-            // now reset the document DB to the specified version
-            // and run migrations to get it to the latest version
-            const version = metaExport.schema.version;
-            const deleteReq = indexedDB.deleteDatabase([this.namespace, 'collections'].join('_'));
-            await new Promise((resolve, reject) => {
-                deleteReq.onsuccess = resolve;
-                deleteReq.onerror = reject;
-            });
-            // reset our context to the imported schema for now
-            const currentSchema = this.context.schema;
-            this.context.schema = metaExport.schema;
-            // now open the document DB empty at the specified version
-            // and initialize it from the meta DB
-            this.context.documentDb = await (0, openDocumentDatabase_js_1.openDocumentDatabase)({
-                meta: this.meta,
-                migrations: this.config.migrations,
-                context: this.context,
-                version,
-            });
-            // re-initialize data
-            this.context.log('Re-initializing data from imported data...');
-            await this._entities.addData({
-                operations: metaExport.operations,
-                baselines: metaExport.baselines,
-                reset: true,
-            });
-            // close the database and reopen to latest version, applying
-            // migrations
-            await (0, idb_js_1.closeDatabase)(this.context.documentDb);
-            this.context.log('Migrating up to latest schema...');
-            // put the schema back
-            this.context.schema = currentSchema;
-            this.context.documentDb = await (0, openDocumentDatabase_js_1.openDocumentDatabase)({
-                meta: this.meta,
-                migrations: this.config.migrations,
-                context: this.context,
-                version: currentSchema.version,
-            });
-        };
-        this.meta = components.meta;
-        this.collectionNames = Object.keys(context.schema.collections);
-        this._sync = this.config.syncConfig
-            ? new Sync_js_1.ServerSync(this.config.syncConfig, {
-                meta: this.meta,
-                onData: this.addData,
-                log: this.context.log,
-            })
-            : new Sync_js_1.NoSync();
-        this._fileManager = new FileManager_js_1.FileManager({
-            db: this.metaDb,
-            sync: this.sync,
-            context: this.context,
-            config: this.config.files,
-            meta: this.meta,
-        });
-        this._entities = new EntityStore_js_1.EntityStore({
-            context: this.context,
-            meta: this.meta,
-            files: this._fileManager,
-        });
-        this._queryCache = new QueryCache_js_1.QueryCache({
-            context,
-        });
-        this._documentManager = new DocumentManager_js_1.DocumentManager(this.meta, this.schema, this._entities);
-        this.documentDb.addEventListener('versionchange', () => {
-            var _a, _b;
-            (_b = (_a = this.context).log) === null || _b === void 0 ? void 0 : _b.call(_a, `Another tab has requested a version change for ${this.namespace}`);
-            this.documentDb.close();
-            if (typeof window !== 'undefined') {
-                window.location.reload();
-            }
-        });
-        this.metaDb.addEventListener('versionchange', () => {
-            var _a, _b;
-            (_b = (_a = this.context).log) === null || _b === void 0 ? void 0 : _b.call(_a, `Another tab has requested a version change for ${this.namespace}`);
-            this.metaDb.close();
-            if (typeof window !== 'undefined') {
-                window.location.reload();
-            }
-        });
-        // self-assign collection shortcuts. these are not typed
-        // here but are typed in the generated code...
-        for (const [name, _collection] of Object.entries(context.schema.collections)) {
-            const collection = _collection;
-            const collectionName = (_a = collection.pluralName) !== null && _a !== void 0 ? _a : collection.name + 's';
-            // TODO: untangle this requirement
-            (0, common_1.assert)(collectionName === name, `The key of the collection in the schema must be the plural of the name (expected: "${collectionName}")`);
-            this[collectionName] = new CollectionQueries_js_1.CollectionQueries({
-                collection: collectionName,
-                cache: this._queryCache,
-                context: this.context,
-                entities: this.entities,
-                documentManager: this.documentManager,
-            });
-        }
-    }
-    get documentDb() {
-        return this.context.documentDb;
-    }
-    get metaDb() {
-        return this.context.metaDb;
-    }
-    get schema() {
-        return this.context.schema;
-    }
-    get namespace() {
-        return this.context.namespace;
-    }
-    get undoHistory() {
-        return this.context.undoHistory;
-    }
-    /**
-     * @deprecated - use client.sync.presence instead
-     */
-    get presence() {
-        return this.sync.presence;
-    }
-    /**
-     * Batch multiple operations together to be executed in a single transaction.
-     * The changes made will not be included in the same undo history step as
-     * any other changes made outside of the batch. You can also disable undo
-     * for your batch to omit changes from undo history.
-     *
-     * Provide a batch name to apply multiple changes to the same batch
-     * across different invocations. Batches will automatically flush after
-     * a short delay or if they reach a maximum size.
-     */
-    get batch() {
-        return this.entities.batch;
-    }
-}
-exports.Client = Client;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Client = void 0;
+const common_1 = require("@verdant-web/common");
+const DocumentManager_js_1 = require("../DocumentManager.js");
+const FileManager_js_1 = require("../files/FileManager.js");
+const idb_js_1 = require("../idb.js");
+const openDocumentDatabase_js_1 = require("../openDocumentDatabase.js");
+const EntityStore_js_1 = require("../reactives/EntityStore.js");
+const Sync_js_1 = require("../sync/Sync.js");
+const CollectionQueries_js_1 = require("../queries2/CollectionQueries.js");
+const QueryCache_js_1 = require("../queries2/QueryCache.js");
+class Client {
+    get sync() {
+        return this._sync;
+    }
+    get entities() {
+        return this._entities;
+    }
+    get documentManager() {
+        return this._documentManager;
+    }
+    constructor(config, context, components) {
+        var _a;
+        this.config = config;
+        this.context = context;
+        this.addData = (data) => {
+            return this._entities.addData(data);
+        };
+        this.stats = async () => {
+            const collectionNames = Object.keys(this.schema.collections);
+            let collections = {};
+            for (const collectionName of collectionNames) {
+                collections[collectionName] = await (0, idb_js_1.getSizeOfObjectStore)(this.documentDb, collectionName);
+            }
+            const meta = await this.meta.stats();
+            const storage = typeof navigator !== 'undefined' &&
+                typeof navigator.storage !== 'undefined' &&
+                'estimate' in navigator.storage
+                ? await navigator.storage.estimate()
+                : undefined;
+            // determine data:metadata ratio for total size of all collections vs metadata
+            const totalCollectionsSize = Object.values(collections).reduce((acc, { size }) => acc + size, 0);
+            const totalMetaSize = meta.baselinesSize.size + meta.operationsSize.size;
+            const metaToDataRatio = totalMetaSize / totalCollectionsSize;
+            return {
+                collections,
+                meta,
+                storage,
+                totalMetaSize,
+                totalCollectionsSize,
+                metaToDataRatio,
+                quotaUsage: (storage === null || storage === void 0 ? void 0 : storage.usage) && (storage === null || storage === void 0 ? void 0 : storage.quota)
+                    ? storage.usage / storage.quota
+                    : undefined,
+            };
+        };
+        this.close = async () => {
+            var _a, _b;
+            await this.entities.flushPatches();
+            this.sync.stop();
+            this.sync.dispose();
+            this.meta.close();
+            this._entities.destroy();
+            await (0, idb_js_1.closeDatabase)(this.documentDb);
+            await (0, idb_js_1.closeDatabase)(this.metaDb);
+            (_b = (_a = this.context).log) === null || _b === void 0 ? void 0 : _b.call(_a, 'Client closed');
+        };
+        this.__dangerous__resetLocal = async () => {
+            this.sync.stop();
+            const req1 = indexedDB.deleteDatabase([this.namespace, 'meta'].join('_'));
+            const req2 = indexedDB.deleteDatabase([this.namespace, 'collections'].join('_'));
+            await Promise.all([
+                new Promise((resolve, reject) => {
+                    req1.onsuccess = resolve;
+                    req1.onerror = reject;
+                }),
+                new Promise((resolve, reject) => {
+                    req2.onsuccess = resolve;
+                    req2.onerror = reject;
+                }),
+            ]);
+            window.location.reload();
+        };
+        this.export = async () => {
+            const metaExport = await this.meta.export();
+            return Buffer.from(JSON.stringify(metaExport));
+        };
+        this.import = async (buffer) => {
+            this.context.log('Importing data...');
+            // close the document DB
+            await (0, idb_js_1.closeDatabase)(this.context.documentDb);
+            const metaExport = JSON.parse(buffer.toString());
+            await this.meta.resetFrom(metaExport);
+            // now reset the document DB to the specified version
+            // and run migrations to get it to the latest version
+            const version = metaExport.schema.version;
+            const deleteReq = indexedDB.deleteDatabase([this.namespace, 'collections'].join('_'));
+            await new Promise((resolve, reject) => {
+                deleteReq.onsuccess = resolve;
+                deleteReq.onerror = reject;
+            });
+            // reset our context to the imported schema for now
+            const currentSchema = this.context.schema;
+            this.context.schema = metaExport.schema;
+            // now open the document DB empty at the specified version
+            // and initialize it from the meta DB
+            this.context.documentDb = await (0, openDocumentDatabase_js_1.openDocumentDatabase)({
+                meta: this.meta,
+                migrations: this.config.migrations,
+                context: this.context,
+                version,
+            });
+            // re-initialize data
+            this.context.log('Re-initializing data from imported data...');
+            await this._entities.addData({
+                operations: metaExport.operations,
+                baselines: metaExport.baselines,
+                reset: true,
+            });
+            // close the database and reopen to latest version, applying
+            // migrations
+            await (0, idb_js_1.closeDatabase)(this.context.documentDb);
+            this.context.log('Migrating up to latest schema...');
+            // put the schema back
+            this.context.schema = currentSchema;
+            this.context.documentDb = await (0, openDocumentDatabase_js_1.openDocumentDatabase)({
+                meta: this.meta,
+                migrations: this.config.migrations,
+                context: this.context,
+                version: currentSchema.version,
+            });
+        };
+        this.meta = components.meta;
+        this.collectionNames = Object.keys(context.schema.collections);
+        this._sync = this.config.syncConfig
+            ? new Sync_js_1.ServerSync(this.config.syncConfig, {
+                meta: this.meta,
+                onData: this.addData,
+                log: this.context.log,
+            })
+            : new Sync_js_1.NoSync();
+        this._fileManager = new FileManager_js_1.FileManager({
+            db: this.metaDb,
+            sync: this.sync,
+            context: this.context,
+            config: this.config.files,
+            meta: this.meta,
+        });
+        this._entities = new EntityStore_js_1.EntityStore({
+            context: this.context,
+            meta: this.meta,
+            files: this._fileManager,
+        });
+        this._queryCache = new QueryCache_js_1.QueryCache({
+            context,
+        });
+        this._documentManager = new DocumentManager_js_1.DocumentManager(this.meta, this.schema, this._entities);
+        this.documentDb.addEventListener('versionchange', () => {
+            var _a, _b;
+            (_b = (_a = this.context).log) === null || _b === void 0 ? void 0 : _b.call(_a, `Another tab has requested a version change for ${this.namespace}`);
+            this.documentDb.close();
+            if (typeof window !== 'undefined') {
+                window.location.reload();
+            }
+        });
+        this.metaDb.addEventListener('versionchange', () => {
+            var _a, _b;
+            (_b = (_a = this.context).log) === null || _b === void 0 ? void 0 : _b.call(_a, `Another tab has requested a version change for ${this.namespace}`);
+            this.metaDb.close();
+            if (typeof window !== 'undefined') {
+                window.location.reload();
+            }
+        });
+        // self-assign collection shortcuts. these are not typed
+        // here but are typed in the generated code...
+        for (const [name, _collection] of Object.entries(context.schema.collections)) {
+            const collection = _collection;
+            const collectionName = (_a = collection.pluralName) !== null && _a !== void 0 ? _a : collection.name + 's';
+            // TODO: untangle this requirement
+            (0, common_1.assert)(collectionName === name, `The key of the collection in the schema must be the plural of the name (expected: "${collectionName}")`);
+            this[collectionName] = new CollectionQueries_js_1.CollectionQueries({
+                collection: collectionName,
+                cache: this._queryCache,
+                context: this.context,
+                entities: this.entities,
+                documentManager: this.documentManager,
+            });
+        }
+    }
+    get documentDb() {
+        return this.context.documentDb;
+    }
+    get metaDb() {
+        return this.context.metaDb;
+    }
+    get schema() {
+        return this.context.schema;
+    }
+    get namespace() {
+        return this.context.namespace;
+    }
+    get undoHistory() {
+        return this.context.undoHistory;
+    }
+    /**
+     * @deprecated - use client.sync.presence instead
+     */
+    get presence() {
+        return this.sync.presence;
+    }
+    /**
+     * Batch multiple operations together to be executed in a single transaction.
+     * The changes made will not be included in the same undo history step as
+     * any other changes made outside of the batch. You can also disable undo
+     * for your batch to omit changes from undo history.
+     *
+     * Provide a batch name to apply multiple changes to the same batch
+     * across different invocations. Batches will automatically flush after
+     * a short delay or if they reach a maximum size.
+     */
+    get batch() {
+        return this.entities.batch;
+    }
+}
+exports.Client = Client;
 //# sourceMappingURL=Client.js.map

package/dist/cjs/client/ClientDescriptor.d.ts

@@ -1,62 +1,62 @@
-import { Migration, StorageSchema } from '@verdant-web/common';
-import { FileManagerConfig } from '../files/FileManager.js';
-import { ServerSyncOptions } from '../sync/Sync.js';
-import { UndoHistory } from '../UndoHistory.js';
-import { Client } from './Client.js';
-export interface ClientDescriptorOptions<Presence = any, Profile = any> {
-    /** The schema used to create this client */
-    schema: StorageSchema<any>;
-    /** Migrations, in order, to upgrade to each successive version of the schema */
-    migrations: Migration<any>[];
-    /** Provide a sync config to turn on synchronization with a server */
-    sync?: ServerSyncOptions<Profile, Presence>;
-    /** Optionally override the IndexedDB implementation */
-    indexedDb?: IDBFactory;
-    /**
-     * Namespaces are used to separate data from different clients in IndexedDB.
-     */
-    namespace: string;
-    /**
-     * Provide your own UndoHistory to have a unified undo system across multiple
-     * clients if you so desire.
-     */
-    undoHistory?: UndoHistory;
-    /**
-     * Provide a log function to log internal debug messages
-     */
-    log?: (...args: any[]) => void;
-    disableRebasing?: boolean;
-    /**
-     * Provide a specific schema number to override the schema version
-     * in the database. This is useful for testing migrations or recovering
-     * from a mistakenly deployed incorrect schema. A specific version is required
-     * so that you don't leave this on accidentally for all new schemas.
-     */
-    overrideSchemaConflict?: number;
-    /**
-     * Configuration for file management
-     */
-    files?: FileManagerConfig;
-}
-/**
- * Since storage initialization is async, this class wraps the core
- * Storage creation promise and exposes some metadata which can
- * be useful immediately.
- */
-export declare class ClientDescriptor<Presence = any, Profile = any> {
-    private readonly init;
-    private readonly _readyPromise;
-    private resolveReady;
-    private rejectReady;
-    private _resolvedValue;
-    private _initializing;
-    private _namespace;
-    get namespace(): string;
-    constructor(init: ClientDescriptorOptions<Presence, Profile>);
-    private initialize;
-    get current(): Client | undefined;
-    get readyPromise(): Promise<Client>;
-    get schema(): StorageSchema<any>;
-    open: () => Promise<Client>;
-    close: () => Promise<void>;
-}
+import { Migration, StorageSchema } from '@verdant-web/common';
+import { FileManagerConfig } from '../files/FileManager.js';
+import { ServerSyncOptions } from '../sync/Sync.js';
+import { UndoHistory } from '../UndoHistory.js';
+import { Client } from './Client.js';
+export interface ClientDescriptorOptions<Presence = any, Profile = any> {
+    /** The schema used to create this client */
+    schema: StorageSchema<any>;
+    /** Migrations, in order, to upgrade to each successive version of the schema */
+    migrations: Migration<any>[];
+    /** Provide a sync config to turn on synchronization with a server */
+    sync?: ServerSyncOptions<Profile, Presence>;
+    /** Optionally override the IndexedDB implementation */
+    indexedDb?: IDBFactory;
+    /**
+     * Namespaces are used to separate data from different clients in IndexedDB.
+     */
+    namespace: string;
+    /**
+     * Provide your own UndoHistory to have a unified undo system across multiple
+     * clients if you so desire.
+     */
+    undoHistory?: UndoHistory;
+    /**
+     * Provide a log function to log internal debug messages
+     */
+    log?: (...args: any[]) => void;
+    disableRebasing?: boolean;
+    /**
+     * Provide a specific schema number to override the schema version
+     * in the database. This is useful for testing migrations or recovering
+     * from a mistakenly deployed incorrect schema. A specific version is required
+     * so that you don't leave this on accidentally for all new schemas.
+     */
+    overrideSchemaConflict?: number;
+    /**
+     * Configuration for file management
+     */
+    files?: FileManagerConfig;
+}
+/**
+ * Since storage initialization is async, this class wraps the core
+ * Storage creation promise and exposes some metadata which can
+ * be useful immediately.
+ */
+export declare class ClientDescriptor<Presence = any, Profile = any> {
+    private readonly init;
+    private readonly _readyPromise;
+    private resolveReady;
+    private rejectReady;
+    private _resolvedValue;
+    private _initializing;
+    private _namespace;
+    get namespace(): string;
+    constructor(init: ClientDescriptorOptions<Presence, Profile>);
+    private initialize;
+    get current(): Client | undefined;
+    get readyPromise(): Promise<Client>;
+    get schema(): StorageSchema<any>;
+    open: () => Promise<Client>;
+    close: () => Promise<void>;
+}