@prestizni-software/server-dem 0.7.3 → 0.7.5

package/expo-test/scripts/reset-project.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * This script is used to reset the project to a blank state.
+ * It deletes or moves the /app, /components, /hooks, /scripts, and /constants directories to /app-example based on user input and creates a new /app directory with an index.tsx and _layout.tsx file.
+ * You can remove the `reset-project` script from package.json and safely delete this file after running it.
+ */
+const fs = require("fs");
+const path = require("path");
+const readline = require("readline");
+const root = process.cwd();
+const oldDirs = ["app", "components", "hooks", "constants", "scripts"];
+const exampleDir = "app-example";
+const newAppDir = "app";
+const exampleDirPath = path.join(root, exampleDir);
+const indexContent = `import { Text, View } from "react-native";
+
+export default function Index() {
+  return (
+    <View
+      style={{
+        flex: 1,
+        justifyContent: "center",
+        alignItems: "center",
+      }}
+    >
+      <Text>Edit app/index.tsx to edit this screen.</Text>
+    </View>
+  );
+}
+`;
+const layoutContent = `import { Stack } from "expo-router";
+
+export default function RootLayout() {
+  return <Stack />;
+}
+`;
+const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+});
+const moveDirectories = async (userInput) => {
+    try {
+        if (userInput === "y") {
+            // Create the app-example directory
+            await fs.promises.mkdir(exampleDirPath, { recursive: true });
+            console.log(`📁 /${exampleDir} directory created.`);
+        }
+        // Move old directories to new app-example directory or delete them
+        for (const dir of oldDirs) {
+            const oldDirPath = path.join(root, dir);
+            if (fs.existsSync(oldDirPath)) {
+                if (userInput === "y") {
+                    const newDirPath = path.join(root, exampleDir, dir);
+                    await fs.promises.rename(oldDirPath, newDirPath);
+                    console.log(`➡️ /${dir} moved to /${exampleDir}/${dir}.`);
+                }
+                else {
+                    await fs.promises.rm(oldDirPath, { recursive: true, force: true });
+                    console.log(`❌ /${dir} deleted.`);
+                }
+            }
+            else {
+                console.log(`➡️ /${dir} does not exist, skipping.`);
+            }
+        }
+        // Create new /app directory
+        const newAppDirPath = path.join(root, newAppDir);
+        await fs.promises.mkdir(newAppDirPath, { recursive: true });
+        console.log("\n📁 New /app directory created.");
+        // Create index.tsx
+        const indexPath = path.join(newAppDirPath, "index.tsx");
+        await fs.promises.writeFile(indexPath, indexContent);
+        console.log("📄 app/index.tsx created.");
+        // Create _layout.tsx
+        const layoutPath = path.join(newAppDirPath, "_layout.tsx");
+        await fs.promises.writeFile(layoutPath, layoutContent);
+        console.log("📄 app/_layout.tsx created.");
+        console.log("\n✅ Project reset complete. Next steps:");
+        console.log(`1. Run \`npx expo start\` to start a development server.\n2. Edit app/index.tsx to edit the main screen.${userInput === "y"
+            ? `\n3. Delete the /${exampleDir} directory when you're done referencing it.`
+            : ""}`);
+    }
+    catch (error) {
+        console.error(`❌ Error during script execution: ${error.message}`);
+    }
+};
+rl.question("Do you want to move existing files to /app-example instead of deleting them? (Y/n): ", (answer) => {
+    const userInput = answer.trim().toLowerCase() || "y";
+    if (userInput === "y" || userInput === "n") {
+        moveDirectories(userInput).finally(() => rl.close());
+    }
+    else {
+        console.log("❌ Invalid input. Please enter 'Y' or 'N'.");
+        rl.close();
+    }
+});
+//# sourceMappingURL=reset-project.js.map

package/expo-test/scripts/reset-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset-project.js","sourceRoot":"","sources":["../../../expo-test/scripts/reset-project.js"],"names":[],"mappings":"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"}

package/index.d.ts

@@ -0,0 +1,4 @@
+export * as client from "./client.js";
+export * as server from "./server.js";
+export * from "./client.js";
+export * from "./server.js";

package/index.js

@@ -0,0 +1,5 @@
+export * as client from "./client.js";
+export * as server from "./server.js";
+export * from "./client.js";
+export * from "./server.js";
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAC;AACtC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/jest.config.d.ts

@@ -0,0 +1,3 @@
+import type { JestConfigWithTsJest } from 'ts-jest';
+declare const config: JestConfigWithTsJest;
+export default config;

package/jest.config.js

@@ -0,0 +1,17 @@
+const config = {
+    globals: {
+        "ts-jest": {
+            useESM: true
+        }
+    },
+    transform: { '\\.[jt]s?$': ['ts-jest', { tsconfig: { allowJs: true } }] },
+    preset: 'ts-jest/presets/default-esm',
+    roots: ["tests/"],
+    modulePathIgnorePatterns: [
+        "node_modules/"
+    ], moduleNameMapper: {
+        '^(\\.{1,2}/.*)\\.[jt]s$': '$1',
+    },
+};
+export default config;
+//# sourceMappingURL=jest.config.js.map

package/jest.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jest.config.js","sourceRoot":"","sources":["../jest.config.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,GAAyB;IACjC,OAAO,EAAE;QACL,SAAS,EAAE;YACP,MAAM,EAAE,IAAI;SACf;KACJ;IACD,SAAS,EAAE,EAAE,YAAY,EAAE,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE;IACzE,MAAM,EAAE,6BAA6B;IACrC,KAAK,EAAE,CAAC,QAAQ,CAAC;IACjB,wBAAwB,EAAE;QACtB,eAAe;KAClB,EAAE,gBAAgB,EAAE;QACrB,yBAAyB,EAAE,IAAI;KAChC;CACF,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/package.json

@@ -1,42 +1,23 @@
-{
-  "name": "@prestizni-software/server-dem",
-  "version": "0.7.3",
-  "description": "An solution for when making http requests is not a good solution",
-  "keywords": [
-    "websockets"
-  ],
-  "license": "ISC",
-  "author": "xx0055",
-  "type": "module",
-  "main": "./dist/server.js",
-  "module": "./dist/server.mjs",
-  "types": "./dist/server.d.ts",
-  "files": [
-    "dist"
-  ],
-  "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
-  },
-  "scripts": {
-    "build": "npx tsc",
-    "release": "git pull && npm i && npm run build && npx standard-version && git push --follow-tags && npm publish --access public",
-    "release:patch": "git pull && npm i && npm run build && npx standard-version --release-as patch && git push --follow-tags && npm publish --access public",
-    "release:minor": "git pull && npm i && npm run build && npx standard-version --release-as minor && git push --follow-tags && npm publish --access public",
-    "release:major": "git pull && npm i && npm run build && npx standard-version --release-as major && git push --follow-tags && npm publish --access public"
-  },
-  "dependencies": {
-    "@typegoose/typegoose": "^13.3.0",
-    "bson": "^7.2.0",
-    "eventemitter3": "5.0.4",
-    "lodash": "^4.17.23",
-    "node-machine-id": "^1.1.12",
-    "reflect-metadata": "^0.2.2",
-    "socket.io": "^4.8.3",
-    "socket.io-client": "^4.8.3",
-    "string-similarity-js": "^2.1.4"
-  },
-  "devDependencies": {
-    "@types/lodash": "^4.17.24"
-  }
-}
+{
+  "name": "@prestizni-software/server-dem",
+  "version": "0.7.5",
+  "description": "Real-time server synchronization library for DEM",
+  "type": "module",
+  "main": "./server.js",
+  "types": "./server.d.ts",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@typegoose/typegoose": "^13.3.0",
+    "bson": "^7.2.0",
+    "eventemitter3": "^5.0.4",
+    "lodash": "^4.17.23",
+    "node-machine-id": "^1.1.12",
+    "reflect-metadata": "^0.2.2",
+    "socket.io": "^4.8.3",
+    "socket.io-client": "^4.8.3",
+    "string-similarity-js": "^2.1.4"
+  }
+}

package/server.d.ts

@@ -0,0 +1,8 @@
+export * as AutoUpdatedServerObjectClass from "./AutoUpdatedServerObjectClass.js";
+export * as AutoUpdatedClientObjectClass from "./AutoUpdatedClientObjectClass.js";
+export * as AutoUpdateManagerClass from "./AutoUpdateManagerClass.js";
+export * as AutoUpdateServerManagerClass from "./AutoUpdateServerManagerClass.js";
+export * as CommonTypes from "./CommonTypes.js";
+export * as CommonTypes_server from "./CommonTypes_server.js";
+export * as sync from "./sync/index.js";
+export * from "./DEMErrors.js";

package/server.js

@@ -0,0 +1,9 @@
+export * as AutoUpdatedServerObjectClass from "./AutoUpdatedServerObjectClass.js";
+export * as AutoUpdatedClientObjectClass from "./AutoUpdatedClientObjectClass.js";
+export * as AutoUpdateManagerClass from "./AutoUpdateManagerClass.js";
+export * as AutoUpdateServerManagerClass from "./AutoUpdateServerManagerClass.js";
+export * as CommonTypes from "./CommonTypes.js";
+export * as CommonTypes_server from "./CommonTypes_server.js";
+export * as sync from "./sync/index.js";
+export * from "./DEMErrors.js";
+//# sourceMappingURL=server.js.map

package/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,4BAA4B,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,4BAA4B,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,sBAAsB,MAAM,6BAA6B,CAAC;AACtE,OAAO,KAAK,4BAA4B,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,KAAK,kBAAkB,MAAM,yBAAyB,CAAC;AAC9D,OAAO,KAAK,IAAI,MAAM,iBAAiB,CAAC;AACxC,cAAc,gBAAgB,CAAC"}

package/{dist/sync → sync}/ClientStateReconciler.d.ts

@@ -23,6 +23,10 @@ export interface ReconcilableClientManager<T extends IAutoUpdatedClientObjectBas
 export declare class ClientStateReconciler {
     /**
      * Restores client manager objects in-memory from a persistent storage adapter.
+     *
+     * @param manager - Reconcilable client manager instance.
+     * @param storageAdapter - Storage adapter implementing IClientStorageAdapter.
+     * @returns Object indicating restoration success, stored revision, and restored entity count.
      */
     static restoreFromStorage<T extends IAutoUpdatedClientObjectBase>(manager: ReconcilableClientManager<T>, storageAdapter: IClientStorageAdapter): Promise<{
         restored: boolean;
@@ -31,11 +35,27 @@ export declare class ClientStateReconciler {
     }>;
     /**
      * Persists current manager in-memory state to storage adapter.
+     *
+     * @param manager - Reconcilable client manager instance.
+     * @param revision - Monotonic revision number to record with the snapshot.
+     * @param storageAdapter - Storage adapter to receive the persisted state.
      */
     static persistToStorage<T extends IAutoUpdatedClientObjectBase>(manager: ReconcilableClientManager<T>, revision: number, storageAdapter: IClientStorageAdapter): Promise<void>;
     /**
      * Applies a delta changes payload to the in-memory client manager.
+     * Handles creates, updates, and deletes with callback dispatch and local state persistence.
+     *
+     * @param manager - Reconcilable client manager instance.
+     * @param payload - Delta sync payload containing status, revision, and changes array.
+     * @param storageAdapter - Optional storage adapter to persist reconciled state.
      */
     static applyDelta<T extends IAutoUpdatedClientObjectBase>(manager: ReconcilableClientManager<T>, payload: DeltaSyncPayload<any>, storageAdapter?: IClientStorageAdapter): Promise<void>;
+    /**
+     * Patches changed fields onto an existing client object instance and triggers update callback.
+     *
+     * @param targetObj - Target client object to patch.
+     * @param patchData - Key-value map of properties to apply.
+     * @param callbacks - Optional manager callbacks interface.
+     */
     private static patchObjectProperties;
 }

package/{dist/sync → sync}/ClientStateReconciler.js

@@ -2,6 +2,10 @@ import { globalCache } from "../CommonTypes.js";
 export class ClientStateReconciler {
     /**
      * Restores client manager objects in-memory from a persistent storage adapter.
+     *
+     * @param manager - Reconcilable client manager instance.
+     * @param storageAdapter - Storage adapter implementing IClientStorageAdapter.
+     * @returns Object indicating restoration success, stored revision, and restored entity count.
      */
     static async restoreFromStorage(manager, storageAdapter) {
         try {
@@ -50,6 +54,10 @@ export class ClientStateReconciler {
     }
     /**
      * Persists current manager in-memory state to storage adapter.
+     *
+     * @param manager - Reconcilable client manager instance.
+     * @param revision - Monotonic revision number to record with the snapshot.
+     * @param storageAdapter - Storage adapter to receive the persisted state.
      */
     static async persistToStorage(manager, revision, storageAdapter) {
         try {
@@ -77,6 +85,11 @@ export class ClientStateReconciler {
     }
     /**
      * Applies a delta changes payload to the in-memory client manager.
+     * Handles creates, updates, and deletes with callback dispatch and local state persistence.
+     *
+     * @param manager - Reconcilable client manager instance.
+     * @param payload - Delta sync payload containing status, revision, and changes array.
+     * @param storageAdapter - Optional storage adapter to persist reconciled state.
      */
     static async applyDelta(manager, payload, storageAdapter) {
         const changes = payload.changes ?? [];
@@ -141,6 +154,13 @@ export class ClientStateReconciler {
             await this.persistToStorage(manager, payload.revision, storageAdapter);
         }
     }
+    /**
+     * Patches changed fields onto an existing client object instance and triggers update callback.
+     *
+     * @param targetObj - Target client object to patch.
+     * @param patchData - Key-value map of properties to apply.
+     * @param callbacks - Optional manager callbacks interface.
+     */
     static async patchObjectProperties(targetObj, patchData, callbacks) {
         for (const key of Object.keys(patchData)) {
             if (key === "_id")

package/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 → sync}/ServerChangeTracker.d.ts

@@ -1,6 +1,9 @@
 import { ChangeEntry, ChangeLogOptions, ChangeType, PruneMode } from "./types.js";
 /**
  * Calculates a fast approximation of the memory/JSON byte footprint of a JavaScript object/value.
+ *
+ * @param obj - The value or object to estimate.
+ * @returns Estimated size in bytes.
  */
 export declare function estimateObjectSizeBytes(obj: unknown): number;
 export declare class ServerChangeTracker<T = unknown> {
@@ -13,27 +16,70 @@ export declare class ServerChangeTracker<T = unknown> {
     maxSizeBytes?: number;
     maxEntries?: number;
     pruneMode: PruneMode;
+    /**
+     * Initializes a new ServerChangeTracker instance.
+     *
+     * @param className - Managed entity class name.
+     * @param options - Pruning options such as maxAgeMs, maxSizeBytes, maxEntries, and pruneMode.
+     */
     constructor(className: string, options?: ChangeLogOptions);
     /**
      * Dynamically updates limits (MB size, TTL age, entries, pruneMode) mid-run and triggers pruning.
+     *
+     * @param options - Partial set of options to overwrite.
      */
     updateOptions(options: Partial<ChangeLogOptions>): void;
+    /**
+     * Retrieves the current monotonic revision number.
+     *
+     * @returns Latest revision counter.
+     */
     getCurrentRevision(): number;
+    /**
+     * Retrieves the lowest revision number retained in the mutation log.
+     *
+     * @returns Oldest retained revision number.
+     */
     getLowestRetainedRevision(): number;
+    /**
+     * Retrieves the estimated total memory usage of all retained entries in bytes.
+     *
+     * @returns Total bytes consumed by retained entries.
+     */
     getEstimatedSizeBytes(): number;
+    /**
+     * Retrieves the total count of currently retained change entries.
+     *
+     * @returns Number of retained mutation entries.
+     */
     getEntryCount(): number;
     /**
      * Records a mutation and assigns a new monotonic revision number.
+     *
+     * @param type - Mutation type ('create', 'update', or 'delete').
+     * @param id - String identifier of mutated entity.
+     * @param data - Optional mutated property payload.
+     * @returns Assigned monotonic revision number.
      */
     recordChange(type: ChangeType, id: string, data?: Partial<T>): number;
     /**
      * Records a mutation with an explicit timestamp (useful for testing or replay).
+     *
+     * @param type - Mutation type ('create', 'update', or 'delete').
+     * @param id - String identifier of mutated entity.
+     * @param data - Optional mutated property payload.
+     * @param timestamp - Explicit Unix timestamp in milliseconds.
+     * @returns Assigned monotonic revision number.
      */
     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.
+     *
+     * @param clientRevision - The last revision known by the client.
+     * @param allowedIds - Optional Set of allowed IDs for permission filtering.
+     * @returns Object containing isExpired flag and array of change entries.
      */
     getChangesSince(clientRevision: number, allowedIds?: Set<string>): {
         isExpired: boolean;

package/{dist/sync → sync}/ServerChangeTracker.js

@@ -1,5 +1,8 @@
 /**
  * Calculates a fast approximation of the memory/JSON byte footprint of a JavaScript object/value.
+ *
+ * @param obj - The value or object to estimate.
+ * @returns Estimated size in bytes.
  */
 export function estimateObjectSizeBytes(obj) {
     if (obj === null || obj === undefined)
@@ -39,6 +42,12 @@ export class ServerChangeTracker {
     maxSizeBytes;
     maxEntries;
     pruneMode;
+    /**
+     * Initializes a new ServerChangeTracker instance.
+     *
+     * @param className - Managed entity class name.
+     * @param options - Pruning options such as maxAgeMs, maxSizeBytes, maxEntries, and pruneMode.
+     */
     constructor(className, options) {
         this.className = className;
         this.maxAgeMs = options?.maxAgeMs;
@@ -48,6 +57,8 @@ export class ServerChangeTracker {
     }
     /**
      * Dynamically updates limits (MB size, TTL age, entries, pruneMode) mid-run and triggers pruning.
+     *
+     * @param options - Partial set of options to overwrite.
      */
     updateOptions(options) {
         if (options.maxAgeMs !== undefined)
@@ -60,26 +71,57 @@ export class ServerChangeTracker {
             this.pruneMode = options.pruneMode;
         this.prune();
     }
+    /**
+     * Retrieves the current monotonic revision number.
+     *
+     * @returns Latest revision counter.
+     */
     getCurrentRevision() {
         return this.currentRevision;
     }
+    /**
+     * Retrieves the lowest revision number retained in the mutation log.
+     *
+     * @returns Oldest retained revision number.
+     */
     getLowestRetainedRevision() {
         return this.lowestRetainedRevision;
     }
+    /**
+     * Retrieves the estimated total memory usage of all retained entries in bytes.
+     *
+     * @returns Total bytes consumed by retained entries.
+     */
     getEstimatedSizeBytes() {
         return this.totalEstimatedBytes;
     }
+    /**
+     * Retrieves the total count of currently retained change entries.
+     *
+     * @returns Number of retained mutation entries.
+     */
     getEntryCount() {
         return this.entries.length;
     }
     /**
      * Records a mutation and assigns a new monotonic revision number.
+     *
+     * @param type - Mutation type ('create', 'update', or 'delete').
+     * @param id - String identifier of mutated entity.
+     * @param data - Optional mutated property payload.
+     * @returns Assigned 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).
+     *
+     * @param type - Mutation type ('create', 'update', or 'delete').
+     * @param id - String identifier of mutated entity.
+     * @param data - Optional mutated property payload.
+     * @param timestamp - Explicit Unix timestamp in milliseconds.
+     * @returns Assigned monotonic revision number.
      */
     recordChangeWithTimestamp(type, id, data, timestamp) {
         this.currentRevision += 1;
@@ -104,6 +146,10 @@ export class ServerChangeTracker {
      * 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.
+     *
+     * @param clientRevision - The last revision known by the client.
+     * @param allowedIds - Optional Set of allowed IDs for permission filtering.
+     * @returns Object containing isExpired flag and array of change entries.
      */
     getChangesSince(clientRevision, allowedIds) {
         if (clientRevision >= this.currentRevision) {

package/sync/ServerChangeTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServerChangeTracker.js","sourceRoot":"","sources":["../../sync/ServerChangeTracker.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CAAC,GAAY;IAClD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC;IACxB,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC;IACjC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IAChC,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAQ,GAAc,CAAC,MAAM,GAAG,CAAC,CAAC;IACzD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACpC,IAAI,IAAI,uBAAuB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;gBACtB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;oBACnD,IAAI,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,GAAG,uBAAuB,CAAE,GAA+B,CAAC,GAAG,CAAC,CAAC,CAAC;gBAC1F,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,OAAO,mBAAmB;IAkBZ;IAjBV,eAAe,GAAG,CAAC,CAAC;IACpB,sBAAsB,GAAG,CAAC,CAAC;IAC3B,OAAO,GAAqB,EAAE,CAAC;IAC/B,mBAAmB,GAAG,CAAC,CAAC;IAEzB,QAAQ,CAAU;IAClB,YAAY,CAAU;IACtB,UAAU,CAAU;IACpB,SAAS,CAAY;IAE5B;;;;;OAKG;IACH,YACkB,SAAiB,EACjC,OAA0B;QADV,cAAS,GAAT,SAAS,CAAQ;QAGjC,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,CAAC;QAClC,IAAI,CAAC,YAAY,GAAG,OAAO,EAAE,YAAY,CAAC;QAC1C,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,QAAQ,CAAC;IAClD,CAAC;IAED;;;;OAIG;IACI,aAAa,CAAC,OAAkC;QACrD,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACrE,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;YAAE,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACjF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS;YAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QAC3E,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACxE,IAAI,CAAC,KAAK,EAAE,CAAC;IACf,CAAC;IAED;;;;OAIG;IACI,kBAAkB;QACvB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACI,yBAAyB;QAC9B,OAAO,IAAI,CAAC,sBAAsB,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACI,qBAAqB;QAC1B,OAAO,IAAI,CAAC,mBAAmB,CAAC;IAClC,CAAC;IAED;;;;OAIG;IACI,aAAa;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;;;;;;OAOG;IACI,YAAY,CACjB,IAAgB,EAChB,EAAU,EACV,IAAiB;QAEjB,OAAO,IAAI,CAAC,yBAAyB,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;;;;;;;OAQG;IACI,yBAAyB,CAC9B,IAAgB,EAChB,EAAU,EACV,IAA4B,EAC5B,SAAiB;QAEjB,IAAI,CAAC,eAAe,IAAI,CAAC,CAAC;QAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC;QAEjC,MAAM,cAAc,GAClB,EAAE,GAAG,oDAAoD;YACzD,EAAE,CAAC,MAAM,GAAG,CAAC;YACb,CAAC,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE7C,MAAM,KAAK,GAAmB;YAC5B,QAAQ,EAAE,GAAG;YACb,IAAI;YACJ,EAAE;YACF,IAAI;YACJ,SAAS;YACT,cAAc;SACf,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,mBAAmB,IAAI,cAAc,CAAC;QAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;OAQG;IACI,eAAe,CACpB,cAAsB,EACtB,UAAwB;QAExB,IAAI,cAAc,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAC3C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC3C,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,cAAc,GAAG,IAAI,CAAC,sBAAsB,GAAG,CAAC,EAAE,CAAC;YAClF,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;QAC1C,CAAC;QAED,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,cAAc,CAAC,CAAC;QAEvE,IAAI,UAAU,EAAE,CAAC;YACf,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,OAAO,EAAE,QAAQ;SAClB,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEtC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,WAAW,GAAG,CAAC,CAAC;QAEpB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC;YACrF,MAAM,cAAc,GAClB,IAAI,CAAC,YAAY,IAAI,IAAI,IAAI,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC;YAC5E,MAAM,eAAe,GACnB,IAAI,CAAC,UAAU,IAAI,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC;YAEjF,IAAI,WAAW,GAAG,KAAK,CAAC;YAExB,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;gBAC9B,MAAM,gBAAgB,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC;gBAC/C,MAAM,iBAAiB,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC;gBAEpD,IAAI,gBAAgB,IAAI,iBAAiB,EAAE,CAAC;oBAC1C,WAAW,GAAG,CAAC,aAAa,IAAI,cAAc,CAAC,IAAI,eAAe,CAAC;gBACrE,CAAC;qBAAM,CAAC;oBACN,WAAW,GAAG,aAAa,IAAI,cAAc,IAAI,eAAe,CAAC;gBACnE,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,gBAAgB;gBAChB,WAAW,GAAG,aAAa,IAAI,cAAc,IAAI,eAAe,CAAC;YACnE,CAAC;YAED,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC,mBAAmB,IAAI,KAAK,CAAC,cAAc,CAAC;gBACjD,WAAW,EAAE,CAAC;YAChB,CAAC;iBAAM,CAAC;gBACN,MAAM;YACR,CAAC;QACH,CAAC;QAED,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;YACzD,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;gBACvD,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,sBAAsB,GAAG,CAAC,CAAC;IAClC,CAAC;CACF"}

package/sync/storage/IndexedDbStorageAdapter.d.ts

@@ -0,0 +1,53 @@
+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;
+    /**
+     * Initializes an IndexedDbStorageAdapter instance.
+     *
+     * @param options - Configuration options for database name, store name, and IDBFactory.
+     */
+    constructor(options?: IndexedDbStorageAdapterOptions);
+    /**
+     * Retrieves or initializes the underlying IDBDatabase connection.
+     *
+     * @returns A promise resolving to the IDBDatabase instance.
+     * @throws {DEMError} Throws DEMErrorCode.STORAGE_NOT_SUPPORTED when IndexedDB is unavailable.
+     */
+    private getDb;
+    /**
+     * Persists manager state record to IndexedDB object store.
+     *
+     * @param className - The name identifier of the manager class.
+     * @param state - Complete snapshot of the manager state.
+     */
+    saveManagerState<T = unknown>(className: string, state: StoredManagerState<T>): Promise<void>;
+    /**
+     * Retrieves stored manager state from IndexedDB store.
+     *
+     * @param className - The name identifier of the manager class.
+     * @returns Parsed state object or null if absent.
+     */
+    loadManagerState<T = unknown>(className: string): Promise<StoredManagerState<T> | null>;
+    /**
+     * Removes saved manager state for given class name from IndexedDB.
+     *
+     * @param className - The name identifier of the manager class.
+     */
+    clearManagerState(className: string): Promise<void>;
+    /**
+     * Purges all stored records in the IndexedDB object store.
+     */
+    clearAll(): Promise<void>;
+}