@prestizni-software/server-dem 0.6.5 → 0.6.7

package/dist/sync/ClientStateReconciler.js

@@ -0,0 +1,162 @@
+import { globalCache } from "../CommonTypes.js";
+export class ClientStateReconciler {
+    /**
+     * Restores client manager objects in-memory from a persistent storage adapter.
+     */
+    static async restoreFromStorage(manager, storageAdapter) {
+        try {
+            const state = await storageAdapter.loadManagerState(manager.className);
+            if (!state || !Array.isArray(state.ids) || state.ids.length === 0) {
+                return { restored: false, revision: state?.revision ?? 0, count: 0 };
+            }
+            // Clear existing in-memory objects for this manager
+            for (const oldId of Object.keys(manager.objects_)) {
+                delete globalCache.objects[oldId];
+            }
+            manager.objects_ = {};
+            const objectMap = new Map();
+            if (state.objects) {
+                for (const objData of state.objects) {
+                    if (objData?._id) {
+                        objectMap.set(objData._id.toString(), objData);
+                    }
+                }
+            }
+            for (const id of state.ids) {
+                const objData = objectMap.get(id);
+                const instance = new manager.classParam(manager.classParam, manager.socket, objData || id, manager.loggers, manager.className, manager, manager.callbacks, manager.emitter);
+                manager.objects_[id] = instance;
+                globalCache.objects[id] = {
+                    className: manager.className,
+                    object: instance,
+                };
+            }
+            manager.totalObjects = state.ids.length;
+            manager.loadedObjects = state.ids.length;
+            manager.isLoaded_ = true;
+            if ("_cachedObjectsArray" in manager) {
+                manager._cachedObjectsArray = null;
+            }
+            return {
+                restored: true,
+                revision: state.revision,
+                count: state.ids.length,
+            };
+        }
+        catch (err) {
+            manager.loggers?.warn?.(`Failed to restore ${manager.className} from storage: ${err instanceof Error ? err.message : String(err)}`);
+            return { restored: false, revision: 0, count: 0 };
+        }
+    }
+    /**
+     * Persists current manager in-memory state to storage adapter.
+     */
+    static async persistToStorage(manager, revision, storageAdapter) {
+        try {
+            const objectsAsArray = manager.objectsAsArray;
+            const ids = objectsAsArray.map((o) => (o._id ? o._id.toString() : o.data?._id?.toString())).filter(Boolean);
+            const objects = objectsAsArray.map((o) => {
+                if (typeof o.extractedData !== "undefined") {
+                    return o.extractedData;
+                }
+                return o.data || { _id: o._id ? o._id.toString() : "unknown" };
+            });
+            const state = {
+                className: manager.className,
+                revision,
+                ids,
+                objects,
+                properties: manager.properties || [],
+                savedAt: Date.now(),
+            };
+            await storageAdapter.saveManagerState(manager.className, state);
+        }
+        catch (err) {
+            manager.loggers?.warn?.(`Failed to persist ${manager.className} to storage: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    /**
+     * Applies a delta changes payload to the in-memory client manager.
+     */
+    static async applyDelta(manager, payload, storageAdapter) {
+        const changes = payload.changes ?? [];
+        for (const change of changes) {
+            const id = change.id;
+            if (change.type === "delete") {
+                const existing = manager.getObject(id);
+                if (existing) {
+                    await manager.deleteObject(id);
+                    manager.totalObjects = Math.max(0, manager.totalObjects - 1);
+                    manager.loadedObjects = Math.max(0, manager.loadedObjects - 1);
+                    if ("_cachedObjectsArray" in manager) {
+                        manager._cachedObjectsArray = null;
+                    }
+                    manager.callbacks?.delete?.(existing);
+                }
+            }
+            else if (change.type === "create") {
+                let existing = manager.getObject(id);
+                if (!existing) {
+                    const instance = new manager.classParam(manager.classParam, manager.socket, change.data || id, manager.loggers, manager.className, manager, manager.callbacks, manager.emitter);
+                    manager.objects_[id] = instance;
+                    if ("_cachedObjectsArray" in manager) {
+                        manager._cachedObjectsArray = null;
+                    }
+                    globalCache.objects[id] = {
+                        className: manager.className,
+                        object: instance,
+                    };
+                    manager.totalObjects += 1;
+                    manager.loadedObjects += 1;
+                    manager.callbacks?.new?.(instance);
+                }
+                else if (change.data) {
+                    // Object already exists, apply properties
+                    await this.patchObjectProperties(existing, change.data, manager.callbacks);
+                }
+            }
+            else if (change.type === "update") {
+                let existing = manager.getObject(id);
+                if (existing && change.data) {
+                    await this.patchObjectProperties(existing, change.data, manager.callbacks);
+                }
+                else if (!existing && change.data) {
+                    // Object was updated but client did not have it, create it
+                    const instance = new manager.classParam(manager.classParam, manager.socket, change.data, manager.loggers, manager.className, manager, manager.callbacks, manager.emitter);
+                    manager.objects_[id] = instance;
+                    if ("_cachedObjectsArray" in manager) {
+                        manager._cachedObjectsArray = null;
+                    }
+                    globalCache.objects[id] = {
+                        className: manager.className,
+                        object: instance,
+                    };
+                    manager.totalObjects += 1;
+                    manager.loadedObjects += 1;
+                    manager.callbacks?.new?.(instance);
+                }
+            }
+        }
+        if (storageAdapter) {
+            await this.persistToStorage(manager, payload.revision, storageAdapter);
+        }
+    }
+    static async patchObjectProperties(targetObj, patchData, callbacks) {
+        for (const key of Object.keys(patchData)) {
+            if (key === "_id")
+                continue;
+            const val = patchData[key];
+            if (targetObj.data) {
+                targetObj.data[key] = val;
+            }
+            if (typeof targetObj.setValue__ === "function") {
+                await targetObj.setValue__(key, val, true);
+            }
+            else {
+                targetObj[key] = val;
+            }
+            callbacks?.update?.(targetObj, key);
+        }
+    }
+}
+//# sourceMappingURL=ClientStateReconciler.js.map

package/dist/sync/ClientStateReconciler.js.map

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

package/dist/sync/ServerChangeTracker.d.ts

@@ -0,0 +1,50 @@
+import { ChangeEntry, ChangeLogOptions, ChangeType, PruneMode } from "./types.js";
+/**
+ * Calculates a fast approximation of the memory/JSON byte footprint of a JavaScript object/value.
+ */
+export declare function estimateObjectSizeBytes(obj: unknown): number;
+export declare class ServerChangeTracker<T = unknown> {
+    readonly className: string;
+    private currentRevision;
+    private lowestRetainedRevision;
+    private entries;
+    private totalEstimatedBytes;
+    maxAgeMs?: number;
+    maxSizeBytes?: number;
+    maxEntries?: number;
+    pruneMode: PruneMode;
+    constructor(className: string, options?: ChangeLogOptions);
+    /**
+     * Dynamically updates limits (MB size, TTL age, entries, pruneMode) mid-run and triggers pruning.
+     */
+    updateOptions(options: Partial<ChangeLogOptions>): void;
+    getCurrentRevision(): number;
+    getLowestRetainedRevision(): number;
+    getEstimatedSizeBytes(): number;
+    getEntryCount(): number;
+    /**
+     * Records a mutation and assigns a new monotonic revision number.
+     */
+    recordChange(type: ChangeType, id: string, data?: Partial<T>): number;
+    /**
+     * Records a mutation with an explicit timestamp (useful for testing or replay).
+     */
+    recordChangeWithTimestamp(type: ChangeType, id: string, data: Partial<T> | undefined, timestamp: number): number;
+    /**
+     * Retrieves all mutations occurring strictly after `clientRevision`.
+     * If `clientRevision` is older than the lowest retained revision in history,
+     * returns `isExpired: true` indicating a full sync is necessary.
+     */
+    getChangesSince(clientRevision: number, allowedIds?: Set<string>): {
+        isExpired: boolean;
+        changes: ChangeEntry<T>[];
+    };
+    /**
+     * Prunes entries based on configured maxAgeMs, maxSizeBytes, maxEntries, and pruneMode.
+     */
+    prune(): void;
+    /**
+     * Clears all recorded entries and resets tracking state.
+     */
+    clear(): void;
+}

package/dist/sync/ServerChangeTracker.js

@@ -0,0 +1,181 @@
+/**
+ * Calculates a fast approximation of the memory/JSON byte footprint of a JavaScript object/value.
+ */
+export function estimateObjectSizeBytes(obj) {
+    if (obj === null || obj === undefined)
+        return 8;
+    const type = typeof obj;
+    if (type === "boolean")
+        return 4;
+    if (type === "number")
+        return 8;
+    if (type === "string")
+        return obj.length * 2;
+    if (type === "object") {
+        let size = 16;
+        if (Array.isArray(obj)) {
+            for (let i = 0; i < obj.length; i++) {
+                size += estimateObjectSizeBytes(obj[i]);
+            }
+        }
+        else {
+            for (const key in obj) {
+                if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                    size += key.length * 2 + estimateObjectSizeBytes(obj[key]);
+                }
+            }
+        }
+        return size;
+    }
+    return 16;
+}
+export class ServerChangeTracker {
+    className;
+    currentRevision = 0;
+    lowestRetainedRevision = 1;
+    entries = [];
+    totalEstimatedBytes = 0;
+    maxAgeMs;
+    maxSizeBytes;
+    maxEntries;
+    pruneMode;
+    constructor(className, options) {
+        this.className = className;
+        this.maxAgeMs = options?.maxAgeMs;
+        this.maxSizeBytes = options?.maxSizeBytes;
+        this.maxEntries = options?.maxEntries;
+        this.pruneMode = options?.pruneMode ?? "either";
+    }
+    /**
+     * Dynamically updates limits (MB size, TTL age, entries, pruneMode) mid-run and triggers pruning.
+     */
+    updateOptions(options) {
+        if (options.maxAgeMs !== undefined)
+            this.maxAgeMs = options.maxAgeMs;
+        if (options.maxSizeBytes !== undefined)
+            this.maxSizeBytes = options.maxSizeBytes;
+        if (options.maxEntries !== undefined)
+            this.maxEntries = options.maxEntries;
+        if (options.pruneMode !== undefined)
+            this.pruneMode = options.pruneMode;
+        this.prune();
+    }
+    getCurrentRevision() {
+        return this.currentRevision;
+    }
+    getLowestRetainedRevision() {
+        return this.lowestRetainedRevision;
+    }
+    getEstimatedSizeBytes() {
+        return this.totalEstimatedBytes;
+    }
+    getEntryCount() {
+        return this.entries.length;
+    }
+    /**
+     * Records a mutation and assigns a new monotonic revision number.
+     */
+    recordChange(type, id, data) {
+        return this.recordChangeWithTimestamp(type, id, data, Date.now());
+    }
+    /**
+     * Records a mutation with an explicit timestamp (useful for testing or replay).
+     */
+    recordChangeWithTimestamp(type, id, data, timestamp) {
+        this.currentRevision += 1;
+        const rev = this.currentRevision;
+        const estimatedBytes = 40 + // metadata overhead (revision, type, id, timestamp)
+            id.length * 2 +
+            (data ? estimateObjectSizeBytes(data) : 0);
+        const entry = {
+            revision: rev,
+            type,
+            id,
+            data,
+            timestamp,
+            estimatedBytes,
+        };
+        this.entries.push(entry);
+        this.totalEstimatedBytes += estimatedBytes;
+        this.prune();
+        return rev;
+    }
+    /**
+     * Retrieves all mutations occurring strictly after `clientRevision`.
+     * If `clientRevision` is older than the lowest retained revision in history,
+     * returns `isExpired: true` indicating a full sync is necessary.
+     */
+    getChangesSince(clientRevision, allowedIds) {
+        if (clientRevision >= this.currentRevision) {
+            return { isExpired: false, changes: [] };
+        }
+        if (this.entries.length === 0 || clientRevision < this.lowestRetainedRevision - 1) {
+            return { isExpired: true, changes: [] };
+        }
+        let filtered = this.entries.filter((e) => e.revision > clientRevision);
+        if (allowedIds) {
+            filtered = filtered.filter((e) => allowedIds.has(e.id));
+        }
+        return {
+            isExpired: false,
+            changes: filtered,
+        };
+    }
+    /**
+     * Prunes entries based on configured maxAgeMs, maxSizeBytes, maxEntries, and pruneMode.
+     */
+    prune() {
+        if (this.entries.length === 0)
+            return;
+        const now = Date.now();
+        let deleteCount = 0;
+        for (let i = 0; i < this.entries.length; i++) {
+            const entry = this.entries[i];
+            const isAgeViolated = this.maxAgeMs != null && now - entry.timestamp > this.maxAgeMs;
+            const isSizeViolated = this.maxSizeBytes != null && this.totalEstimatedBytes > this.maxSizeBytes;
+            const isCountViolated = this.maxEntries != null && this.entries.length - deleteCount > this.maxEntries;
+            let shouldPrune = false;
+            if (this.pruneMode === "both") {
+                const hasAgeConstraint = this.maxAgeMs != null;
+                const hasSizeConstraint = this.maxSizeBytes != null;
+                if (hasAgeConstraint && hasSizeConstraint) {
+                    shouldPrune = (isAgeViolated && isSizeViolated) || isCountViolated;
+                }
+                else {
+                    shouldPrune = isAgeViolated || isSizeViolated || isCountViolated;
+                }
+            }
+            else {
+                // "either" mode
+                shouldPrune = isAgeViolated || isSizeViolated || isCountViolated;
+            }
+            if (shouldPrune) {
+                this.totalEstimatedBytes -= entry.estimatedBytes;
+                deleteCount++;
+            }
+            else {
+                break;
+            }
+        }
+        if (deleteCount > 0) {
+            this.entries.splice(0, deleteCount);
+            if (this.entries.length > 0) {
+                this.lowestRetainedRevision = this.entries[0].revision;
+            }
+            else {
+                this.lowestRetainedRevision = this.currentRevision + 1;
+                this.totalEstimatedBytes = 0;
+            }
+        }
+    }
+    /**
+     * Clears all recorded entries and resets tracking state.
+     */
+    clear() {
+        this.entries = [];
+        this.totalEstimatedBytes = 0;
+        this.currentRevision = 0;
+        this.lowestRetainedRevision = 1;
+    }
+}
+//# sourceMappingURL=ServerChangeTracker.js.map

package/dist/sync/ServerChangeTracker.js.map

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

package/dist/sync/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./types.js";
+export * from "./ServerChangeTracker.js";
+export * from "./ClientStateReconciler.js";
+export * from "./storage/IClientStorageAdapter.js";
+export * from "./storage/MemoryStorageAdapter.js";
+export * from "./storage/LocalStorageAdapter.js";
+export * from "./storage/IndexedDbStorageAdapter.js";

package/dist/sync/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export * from "./ServerChangeTracker.js";
+export * from "./ClientStateReconciler.js";
+export * from "./storage/IClientStorageAdapter.js";
+export * from "./storage/MemoryStorageAdapter.js";
+export * from "./storage/LocalStorageAdapter.js";
+export * from "./storage/IndexedDbStorageAdapter.js";
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../sync/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oCAAoC,CAAC;AACnD,cAAc,mCAAmC,CAAC;AAClD,cAAc,kCAAkC,CAAC;AACjD,cAAc,sCAAsC,CAAC"}

package/dist/sync/storage/IClientStorageAdapter.d.ts

@@ -0,0 +1,23 @@
+import { StoredManagerState } from "../types.js";
+/**
+ * Interface for pluggable client-side persistent storage adapters in DEM.
+ */
+export interface IClientStorageAdapter {
+    /**
+     * Save complete manager state to persistent storage.
+     */
+    saveManagerState<T = unknown>(className: string, state: StoredManagerState<T>): Promise<void>;
+    /**
+     * Retrieve saved manager state from storage.
+     * Returns null if no state exists or if stored data is corrupted.
+     */
+    loadManagerState<T = unknown>(className: string): Promise<StoredManagerState<T> | null>;
+    /**
+     * Clear saved state for a specific manager class.
+     */
+    clearManagerState(className: string): Promise<void>;
+    /**
+     * Clear all stored DEM manager states across all classes.
+     */
+    clearAll(): Promise<void>;
+}

package/dist/sync/storage/IClientStorageAdapter.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=IClientStorageAdapter.js.map

package/dist/sync/storage/IClientStorageAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IClientStorageAdapter.js","sourceRoot":"","sources":["../../../sync/storage/IClientStorageAdapter.ts"],"names":[],"mappings":""}

package/dist/sync/storage/IndexedDbStorageAdapter.d.ts

@@ -0,0 +1,22 @@
+import { StoredManagerState } from "../types.js";
+import { IClientStorageAdapter } from "./IClientStorageAdapter.js";
+export interface IndexedDbStorageAdapterOptions {
+    dbName?: string;
+    storeName?: string;
+    idbFactory?: IDBFactory;
+}
+/**
+ * IndexedDB storage adapter for client-side DEM caching in browsers.
+ */
+export declare class IndexedDbStorageAdapter implements IClientStorageAdapter {
+    private dbName;
+    private storeName;
+    private idbFactory;
+    private dbPromise;
+    constructor(options?: IndexedDbStorageAdapterOptions);
+    private getDb;
+    saveManagerState<T = unknown>(className: string, state: StoredManagerState<T>): Promise<void>;
+    loadManagerState<T = unknown>(className: string): Promise<StoredManagerState<T> | null>;
+    clearManagerState(className: string): Promise<void>;
+    clearAll(): Promise<void>;
+}

package/dist/sync/storage/IndexedDbStorageAdapter.js

@@ -0,0 +1,125 @@
+/**
+ * IndexedDB storage adapter for client-side DEM caching in browsers.
+ */
+export class IndexedDbStorageAdapter {
+    dbName;
+    storeName;
+    idbFactory = null;
+    dbPromise = null;
+    constructor(options) {
+        this.dbName = options?.dbName ?? "dem_offline_store";
+        this.storeName = options?.storeName ?? "manager_states";
+        if (options?.idbFactory) {
+            this.idbFactory = options.idbFactory;
+        }
+        else if (typeof indexedDB !== "undefined") {
+            this.idbFactory = indexedDB;
+        }
+        else if (typeof window !== "undefined" && window.indexedDB) {
+            this.idbFactory = window.indexedDB;
+        }
+        else if (typeof globalThis !== "undefined" && globalThis.indexedDB) {
+            this.idbFactory = globalThis.indexedDB;
+        }
+    }
+    async getDb() {
+        if (this.dbPromise)
+            return this.dbPromise;
+        if (!this.idbFactory) {
+            throw new Error("IndexedDB is not supported in the current environment.");
+        }
+        this.dbPromise = new Promise((resolve, reject) => {
+            const request = this.idbFactory.open(this.dbName, 1);
+            request.onupgradeneeded = () => {
+                const db = request.result;
+                if (!db.objectStoreNames.contains(this.storeName)) {
+                    db.createObjectStore(this.storeName, { keyPath: "className" });
+                }
+            };
+            request.onsuccess = () => {
+                resolve(request.result);
+            };
+            request.onerror = () => {
+                reject(request.error || new Error("Failed to open IndexedDB"));
+            };
+        });
+        return this.dbPromise;
+    }
+    async saveManagerState(className, state) {
+        if (!this.idbFactory)
+            return;
+        try {
+            const db = await this.getDb();
+            return new Promise((resolve, reject) => {
+                const tx = db.transaction(this.storeName, "readwrite");
+                const store = tx.objectStore(this.storeName);
+                const record = { ...state, className };
+                const req = store.put(record);
+                req.onsuccess = () => resolve();
+                req.onerror = () => reject(req.error);
+            });
+        }
+        catch {
+            // Graceful error fallback
+        }
+    }
+    async loadManagerState(className) {
+        if (!this.idbFactory)
+            return null;
+        try {
+            const db = await this.getDb();
+            return new Promise((resolve, reject) => {
+                const tx = db.transaction(this.storeName, "readonly");
+                const store = tx.objectStore(this.storeName);
+                const req = store.get(className);
+                req.onsuccess = () => {
+                    if (req.result && typeof req.result.revision === "number") {
+                        resolve(req.result);
+                    }
+                    else {
+                        resolve(null);
+                    }
+                };
+                req.onerror = () => reject(req.error);
+            });
+        }
+        catch {
+            return null;
+        }
+    }
+    async clearManagerState(className) {
+        if (!this.idbFactory)
+            return;
+        try {
+            const db = await this.getDb();
+            return new Promise((resolve, reject) => {
+                const tx = db.transaction(this.storeName, "readwrite");
+                const store = tx.objectStore(this.storeName);
+                const req = store.delete(className);
+                req.onsuccess = () => resolve();
+                req.onerror = () => reject(req.error);
+            });
+        }
+        catch {
+            // Ignore
+        }
+    }
+    async clearAll() {
+        if (!this.idbFactory)
+            return;
+        try {
+            const db = await this.getDb();
+            return new Promise((resolve, reject) => {
+                const tx = db.transaction(this.storeName, "readwrite");
+                const store = tx.objectStore(this.storeName);
+                const req = store.clear();
+                req.onsuccess = () => resolve();
+                req.onerror = () => reject(req.error);
+            });
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+//# sourceMappingURL=IndexedDbStorageAdapter.js.map

package/dist/sync/storage/IndexedDbStorageAdapter.js.map

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

package/dist/sync/storage/LocalStorageAdapter.d.ts

@@ -0,0 +1,27 @@
+import { StoredManagerState } from "../types.js";
+import { IClientStorageAdapter } from "./IClientStorageAdapter.js";
+export interface LocalStorageAdapterOptions {
+    prefix?: string;
+    storage?: {
+        getItem(key: string): string | null;
+        setItem(key: string, value: string): void;
+        removeItem(key: string): void;
+        clear?(): void;
+        key?(index: number): string | null;
+        length?: number;
+    };
+}
+/**
+ * LocalStorage client storage adapter.
+ * Works with browser window.localStorage or mock storage in tests/Node.js.
+ */
+export declare class LocalStorageAdapter implements IClientStorageAdapter {
+    private prefix;
+    private storageBackend;
+    constructor(options?: LocalStorageAdapterOptions);
+    private getKey;
+    saveManagerState<T = unknown>(className: string, state: StoredManagerState<T>): Promise<void>;
+    loadManagerState<T = unknown>(className: string): Promise<StoredManagerState<T> | null>;
+    clearManagerState(className: string): Promise<void>;
+    clearAll(): Promise<void>;
+}