@prestizni-software/server-dem 0.6.5 → 0.6.7

package/dist/sync/storage/LocalStorageAdapter.js

@@ -0,0 +1,85 @@
+/**
+ * LocalStorage client storage adapter.
+ * Works with browser window.localStorage or mock storage in tests/Node.js.
+ */
+export class LocalStorageAdapter {
+    prefix;
+    storageBackend = null;
+    constructor(options) {
+        this.prefix = options?.prefix ?? "dem_state_";
+        if (options?.storage) {
+            this.storageBackend = options.storage;
+        }
+        else if (typeof window !== "undefined" && window.localStorage) {
+            this.storageBackend = window.localStorage;
+        }
+        else if (typeof globalThis !== "undefined" && globalThis.localStorage) {
+            this.storageBackend = globalThis.localStorage;
+        }
+    }
+    getKey(className) {
+        return `${this.prefix}${className}`;
+    }
+    async saveManagerState(className, state) {
+        if (!this.storageBackend) {
+            return;
+        }
+        try {
+            const serialized = JSON.stringify(state);
+            this.storageBackend.setItem(this.getKey(className), serialized);
+        }
+        catch {
+            // Ignore quota exceeded or storage failure gracefully
+        }
+    }
+    async loadManagerState(className) {
+        if (!this.storageBackend) {
+            return null;
+        }
+        try {
+            const raw = this.storageBackend.getItem(this.getKey(className));
+            if (!raw)
+                return null;
+            const parsed = JSON.parse(raw);
+            if (parsed && typeof parsed.revision === "number" && Array.isArray(parsed.ids)) {
+                return parsed;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    async clearManagerState(className) {
+        if (!this.storageBackend)
+            return;
+        try {
+            this.storageBackend.removeItem(this.getKey(className));
+        }
+        catch {
+            // Ignore
+        }
+    }
+    async clearAll() {
+        if (!this.storageBackend)
+            return;
+        try {
+            if (typeof this.storageBackend.length === "number" && typeof this.storageBackend.key === "function") {
+                const keysToRemove = [];
+                for (let i = 0; i < this.storageBackend.length; i++) {
+                    const key = this.storageBackend.key(i);
+                    if (key && key.startsWith(this.prefix)) {
+                        keysToRemove.push(key);
+                    }
+                }
+                for (const key of keysToRemove) {
+                    this.storageBackend.removeItem(key);
+                }
+            }
+        }
+        catch {
+            // Ignore
+        }
+    }
+}
+//# sourceMappingURL=LocalStorageAdapter.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { StoredManagerState } from "../types.js";
+import { IClientStorageAdapter } from "./IClientStorageAdapter.js";
+/**
+ * In-memory client storage adapter.
+ * Useful for keeping state between socket reconnections in Node.js or short-lived sessions.
+ */
+export declare class MemoryStorageAdapter implements IClientStorageAdapter {
+    private store;
+    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/MemoryStorageAdapter.js

@@ -0,0 +1,25 @@
+/**
+ * In-memory client storage adapter.
+ * Useful for keeping state between socket reconnections in Node.js or short-lived sessions.
+ */
+export class MemoryStorageAdapter {
+    store = new Map();
+    async saveManagerState(className, state) {
+        // Clone state to prevent external mutations from modifying stored snapshot
+        const cloned = JSON.parse(JSON.stringify(state));
+        this.store.set(className, cloned);
+    }
+    async loadManagerState(className) {
+        const state = this.store.get(className);
+        if (!state)
+            return null;
+        return JSON.parse(JSON.stringify(state));
+    }
+    async clearManagerState(className) {
+        this.store.delete(className);
+    }
+    async clearAll() {
+        this.store.clear();
+    }
+}
+//# sourceMappingURL=MemoryStorageAdapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryStorageAdapter.js","sourceRoot":"","sources":["../../../sync/storage/MemoryStorageAdapter.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,OAAO,oBAAoB;IACvB,KAAK,GAAG,IAAI,GAAG,EAAmC,CAAC;IAEpD,KAAK,CAAC,gBAAgB,CAC3B,SAAiB,EACjB,KAA4B;QAE5B,2EAA2E;QAC3E,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;IAEM,KAAK,CAAC,gBAAgB,CAC3B,SAAiB;QAEjB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK;YAAE,OAAO,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAA0B,CAAC;IACpE,CAAC;IAEM,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAC9C,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,QAAQ;QACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/dist/sync/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Core types and interfaces for DEM Delta Synchronization & Change Tracking.
+ */
+export type ChangeType = "create" | "update" | "delete";
+export interface ChangeEntry<T = unknown> {
+    revision: number;
+    type: ChangeType;
+    id: string;
+    data?: Partial<T>;
+    timestamp: number;
+    estimatedBytes: number;
+}
+export type PruneMode = "either" | "both";
+export interface ChangeLogOptions {
+    /**
+     * Maximum age of entries in milliseconds (TTL).
+     * E.g. 7 * 24 * 60 * 60 * 1000 for 7 days.
+     */
+    maxAgeMs?: number;
+    /**
+     * Maximum estimated size of all entries combined in bytes.
+     * E.g. 10 * 1024 * 1024 for 10 MB.
+     */
+    maxSizeBytes?: number;
+    /**
+     * Maximum number of entries to retain.
+     */
+    maxEntries?: number;
+    /**
+     * Pruning policy when both conditions are specified:
+     * - 'either': prune if entry exceeds maxAge OR total size exceeds maxSizeBytes (default)
+     * - 'both': prune only if BOTH conditions are violated
+     */
+    pruneMode?: PruneMode;
+}
+export interface DeltaSyncPayload<T = unknown> {
+    status: "up-to-date" | "delta" | "full";
+    revision: number;
+    changes?: ChangeEntry<T>[];
+    ids?: string[];
+    objects?: T[];
+    properties?: string[];
+}
+export interface StoredManagerState<T = unknown> {
+    className: string;
+    revision: number;
+    ids: string[];
+    objects: T[];
+    properties: string[];
+    savedAt: number;
+}
+export interface ClientDeltaSyncOptions {
+    /**
+     * The storage adapter instance to use for client caching and offline persistence.
+     */
+    storage?: import("./storage/IClientStorageAdapter.js").IClientStorageAdapter;
+    /**
+     * Optional custom identifier for cache namespace.
+     */
+    cacheKeyPrefix?: string;
+}
+export interface ServerDeltaSyncOptions extends ChangeLogOptions {
+    /**
+     * Set to false to disable change tracking on the server manager.
+     */
+    enabled?: boolean;
+}

package/dist/sync/types.js

@@ -0,0 +1,5 @@
+/**
+ * Core types and interfaces for DEM Delta Synchronization & Change Tracking.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sync/types.js.map

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