@asaidimu/utils-store 10.2.17 → 11.0.0

package/index.d.cts

@@ -527,6 +527,10 @@ interface DataStore<T extends object> {
    * Releases all resources held by the store and renders it unusable
    */
   dispose(): Promise<void>;
+  /**
+   * Checks whether the store has been disposed
+   */
+  disposed(): boolean;
 }
 /** Payload for the 'persistence:queued' event. */
 interface PersistenceQueuedPayload {
@@ -1336,6 +1340,13 @@ declare class SelectorManager<T extends object> {
   private pathBasedCache;
   /** Reverse lookup: Path -> Set of Selector IDs for O(1) update dispatch. */
   private dependencyMap;
+  /**
+   * WeakMap from selector function reference to its buildPaths result.
+   * Avoids re-running the proxy analysis on every re-render when the same
+   * function reference is reused (module-level selectors, useCallback, etc).
+   * Entries are GC'd automatically when the function is collected.
+   */
+  private buildPathsCache;
   private getState;
   private eventBus;
   private unsubscribeFromStore;

package/index.d.ts

@@ -404,6 +404,10 @@ interface DataStore<T extends object> {
    * Releases all resources held by the store and renders it unusable
    */
   dispose(): Promise<void>;
+  /**
+   * Checks whether the store has been disposed
+   */
+  disposed(): boolean;
 }
 /** Payload for the 'persistence:queued' event. */
 interface PersistenceQueuedPayload {
@@ -1132,6 +1136,13 @@ declare class SelectorManager<T extends object> {
   private pathBasedCache;
   /** Reverse lookup: Path -> Set of Selector IDs for O(1) update dispatch. */
   private dependencyMap;
+  /**
+   * WeakMap from selector function reference to its buildPaths result.
+   * Avoids re-running the proxy analysis on every re-render when the same
+   * function reference is reused (module-level selectors, useCallback, etc).
+   * Entries are GC'd automatically when the function is collected.
+   */
+  private buildPathsCache;
   private getState;
   private eventBus;
   private unsubscribeFromStore;

package/index.js

@@ -176,6 +176,13 @@ var SelectorManager = class {
 	pathBasedCache = /* @__PURE__ */ new Map();
 	/** Reverse lookup: Path -> Set of Selector IDs for O(1) update dispatch. */
 	dependencyMap = /* @__PURE__ */ new Map();
+	/**
+	* WeakMap from selector function reference to its buildPaths result.
+	* Avoids re-running the proxy analysis on every re-render when the same
+	* function reference is reused (module-level selectors, useCallback, etc).
+	* Entries are GC'd automatically when the function is collected.
+	*/
+	buildPathsCache = /* @__PURE__ */ new WeakMap();
 	getState;
 	eventBus;
 	unsubscribeFromStore;
@@ -187,7 +194,7 @@ var SelectorManager = class {
 	handleStoreUpdate = (payload) => {
 		const selectorsToEvaluate = /* @__PURE__ */ new Set();
 		const divider = ".";
-		for (const delta of payload.deltas) {
+		for (const delta of payload.deltas ?? []) {
 			const changedPath = delta.path;
 			for (const [registeredPath, dependents] of this.dependencyMap) if (registeredPath === changedPath || registeredPath.startsWith(changedPath + divider) || changedPath.startsWith(registeredPath + divider)) for (const id of dependents) selectorsToEvaluate.add(id);
 		}
@@ -217,8 +224,16 @@ var SelectorManager = class {
 		}
 	}
 	createReactiveSelector(selector) {
-		const accessedPaths = buildPaths(selector);
-		const pathCacheKey = [...accessedPaths].sort().join("|");
+		let cached = this.buildPathsCache.get(selector);
+		if (!cached) {
+			const paths = buildPaths(selector);
+			cached = {
+				paths,
+				key: [...paths].sort().join("|")
+			};
+			this.buildPathsCache.set(selector, cached);
+		}
+		const { key: pathCacheKey, paths: accessedPaths } = cached;
 		const cachedEntry = this.pathBasedCache.get(pathCacheKey);
 		if (cachedEntry) {
 			if (cachedEntry.cleanupTimer !== void 0) {
@@ -324,6 +339,7 @@ var SelectorManager = class {
 		this.reactiveSelectors.clear();
 		this.dependencyMap.clear();
 		this.pathBasedCache.clear();
+		this.buildPathsCache = /* @__PURE__ */ new WeakMap();
 	}
 };
 /**
@@ -403,7 +419,7 @@ function isEqual(a, b) {
 		if (length !== bKeys.length) return false;
 		for (i = length; i-- > 0;) {
 			const key = aKeys[i];
-			if (!Object.prototype.hasOwnProperty.call(b, key) || !isEqual(a[key], b[key])) return false;
+			if (!Object.hasOwn(b, key) || !isEqual(a[key], b[key])) return false;
 		}
 		return true;
 	}
@@ -834,6 +850,11 @@ var PersistenceHandler = class {
 	* picking up a retried task before its delay has passed.
 	*/
 	pendingRetries = /* @__PURE__ */ new Set();
+	/**
+	* Guards against the feedback loop where applying external state triggers
+	* persistence writes that trigger more external state applications.
+	*/
+	isSyncing = false;
 	logger;
 	constructor(eventBus, coreState, instanceID, options) {
 		this.eventBus = eventBus;
@@ -1018,15 +1039,13 @@ var PersistenceHandler = class {
 			this.setPersistenceReady();
 		}
 		this.persistence.subscribe(this.instanceID, async (state) => {
-			const changedPaths = this.coreState.applyChanges(state);
-			if (changedPaths.length > 0) this.emit(this.eventBus, {
-				name: "update:complete",
-				payload: {
-					changedPaths,
-					source: "external",
-					timestamp: Date.now()
-				}
-			});
+			if (this.isSyncing) return;
+			this.isSyncing = true;
+			try {
+				this.coreState.applyChanges(state);
+			} finally {
+				this.isSyncing = false;
+			}
 		});
 	}
 	/**
@@ -2100,7 +2119,10 @@ var StoreObserver = class {
 		const event = {
 			type,
 			timestamp: Date.now(),
-			data: structuredClone(data)
+			data: type === "update:complete" ? {
+				...data,
+				newState: void 0
+			} : structuredClone(data)
 		};
 		this.eventHistory.unshift(event);
 		if (this.eventHistory.length > this.maxEvents) this.eventHistory.pop();

package/index.mjs

@@ -175,6 +175,13 @@ var SelectorManager = class {
 	pathBasedCache = /* @__PURE__ */ new Map();
 	/** Reverse lookup: Path -> Set of Selector IDs for O(1) update dispatch. */
 	dependencyMap = /* @__PURE__ */ new Map();
+	/**
+	* WeakMap from selector function reference to its buildPaths result.
+	* Avoids re-running the proxy analysis on every re-render when the same
+	* function reference is reused (module-level selectors, useCallback, etc).
+	* Entries are GC'd automatically when the function is collected.
+	*/
+	buildPathsCache = /* @__PURE__ */ new WeakMap();
 	getState;
 	eventBus;
 	unsubscribeFromStore;
@@ -186,7 +193,7 @@ var SelectorManager = class {
 	handleStoreUpdate = (payload) => {
 		const selectorsToEvaluate = /* @__PURE__ */ new Set();
 		const divider = ".";
-		for (const delta of payload.deltas) {
+		for (const delta of payload.deltas ?? []) {
 			const changedPath = delta.path;
 			for (const [registeredPath, dependents] of this.dependencyMap) if (registeredPath === changedPath || registeredPath.startsWith(changedPath + divider) || changedPath.startsWith(registeredPath + divider)) for (const id of dependents) selectorsToEvaluate.add(id);
 		}
@@ -216,8 +223,16 @@ var SelectorManager = class {
 		}
 	}
 	createReactiveSelector(selector) {
-		const accessedPaths = buildPaths(selector);
-		const pathCacheKey = [...accessedPaths].sort().join("|");
+		let cached = this.buildPathsCache.get(selector);
+		if (!cached) {
+			const paths = buildPaths(selector);
+			cached = {
+				paths,
+				key: [...paths].sort().join("|")
+			};
+			this.buildPathsCache.set(selector, cached);
+		}
+		const { key: pathCacheKey, paths: accessedPaths } = cached;
 		const cachedEntry = this.pathBasedCache.get(pathCacheKey);
 		if (cachedEntry) {
 			if (cachedEntry.cleanupTimer !== void 0) {
@@ -323,6 +338,7 @@ var SelectorManager = class {
 		this.reactiveSelectors.clear();
 		this.dependencyMap.clear();
 		this.pathBasedCache.clear();
+		this.buildPathsCache = /* @__PURE__ */ new WeakMap();
 	}
 };
 /**
@@ -402,7 +418,7 @@ function isEqual(a, b) {
 		if (length !== bKeys.length) return false;
 		for (i = length; i-- > 0;) {
 			const key = aKeys[i];
-			if (!Object.prototype.hasOwnProperty.call(b, key) || !isEqual(a[key], b[key])) return false;
+			if (!Object.hasOwn(b, key) || !isEqual(a[key], b[key])) return false;
 		}
 		return true;
 	}
@@ -828,6 +844,11 @@ var PersistenceHandler = class {
 	* picking up a retried task before its delay has passed.
 	*/
 	pendingRetries = /* @__PURE__ */ new Set();
+	/**
+	* Guards against the feedback loop where applying external state triggers
+	* persistence writes that trigger more external state applications.
+	*/
+	isSyncing = false;
 	logger;
 	constructor(eventBus, coreState, instanceID, options) {
 		this.eventBus = eventBus;
@@ -1012,15 +1033,13 @@ var PersistenceHandler = class {
 			this.setPersistenceReady();
 		}
 		this.persistence.subscribe(this.instanceID, async (state) => {
-			const changedPaths = this.coreState.applyChanges(state);
-			if (changedPaths.length > 0) this.emit(this.eventBus, {
-				name: "update:complete",
-				payload: {
-					changedPaths,
-					source: "external",
-					timestamp: Date.now()
-				}
-			});
+			if (this.isSyncing) return;
+			this.isSyncing = true;
+			try {
+				this.coreState.applyChanges(state);
+			} finally {
+				this.isSyncing = false;
+			}
 		});
 	}
 	/**
@@ -2089,7 +2108,10 @@ var StoreObserver = class {
 		const event = {
 			type,
 			timestamp: Date.now(),
-			data: structuredClone(data)
+			data: type === "update:complete" ? {
+				...data,
+				newState: void 0
+			} : structuredClone(data)
 		};
 		this.eventHistory.unshift(event);
 		if (this.eventHistory.length > this.maxEvents) this.eventHistory.pop();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asaidimu/utils-store",
-  "version": "10.2.17",
+  "version": "11.0.0",
   "description": "A reactive data store",
   "main": "index.js",
   "module": "index.mjs",
@@ -29,11 +29,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@asaidimu/utils-events": "^1.2.9",
-    "@asaidimu/utils-logger": "^1.0.12",
+    "@asaidimu/utils-events": "^1.2.11",
+    "@asaidimu/utils-logger": "^1.0.14",
     "uuid": "^14.0.0",
-    "@asaidimu/utils-sync": "^2.3.8",
-    "@asaidimu/utils-persistence": "^6.1.20"
+    "@asaidimu/utils-sync": "^2.3.10",
+    "@asaidimu/utils-persistence": "^6.1.22"
   },
   "exports": {
     ".": {