@spoosh/core 0.14.0 → 0.14.1

package/dist/index.d.mts

@@ -210,6 +210,7 @@ type EventEmitter = {
 declare function createEventEmitter(): EventEmitter;
 
 type Subscriber = () => void;
+type DataChangeCallback = (key: string, oldData: unknown, newData: unknown) => void;
 type CacheEntryWithKey<TData = unknown, TError = unknown> = {
     key: string;
     entry: CacheEntry<TData, TError>;
@@ -241,6 +242,11 @@ type StateManager = {
     setPendingPromise: (key: string, promise: Promise<unknown> | undefined) => void;
     /** Get a pending promise for a query key */
     getPendingPromise: (key: string) => Promise<unknown> | undefined;
+    /**
+     * Register a callback to be invoked when cache data changes.
+     * @returns Unsubscribe function
+     */
+    onDataChange: (callback: DataChangeCallback) => () => void;
     clear: () => void;
 };
 declare function createStateManager(): StateManager;

package/dist/index.d.ts

@@ -210,6 +210,7 @@ type EventEmitter = {
 declare function createEventEmitter(): EventEmitter;
 
 type Subscriber = () => void;
+type DataChangeCallback = (key: string, oldData: unknown, newData: unknown) => void;
 type CacheEntryWithKey<TData = unknown, TError = unknown> = {
     key: string;
     entry: CacheEntry<TData, TError>;
@@ -241,6 +242,11 @@ type StateManager = {
     setPendingPromise: (key: string, promise: Promise<unknown> | undefined) => void;
     /** Get a pending promise for a query key */
     getPendingPromise: (key: string) => Promise<unknown> | undefined;
+    /**
+     * Register a callback to be invoked when cache data changes.
+     * @returns Unsubscribe function
+     */
+    onDataChange: (callback: DataChangeCallback) => () => void;
     clear: () => void;
 };
 declare function createStateManager(): StateManager;

package/dist/index.js

@@ -767,6 +767,7 @@ function createStateManager() {
   const cache = /* @__PURE__ */ new Map();
   const subscribers = /* @__PURE__ */ new Map();
   const pendingPromises = /* @__PURE__ */ new Map();
+  const dataChangeCallbacks = /* @__PURE__ */ new Set();
   const notifySubscribers = (key) => {
     const subs = subscribers.get(key);
     subs?.forEach((cb) => cb());
@@ -786,6 +787,7 @@ function createStateManager() {
     },
     setCache(key, entry) {
       const existing = cache.get(key);
+      const oldData = existing?.state.data;
       if (existing) {
         existing.state = { ...existing.state, ...entry.state };
         if (entry.tags) {
@@ -798,6 +800,10 @@ function createStateManager() {
           existing.stale = entry.stale;
         }
         notifySubscribers(key);
+        const newData = existing.state.data;
+        if (oldData !== newData) {
+          dataChangeCallbacks.forEach((cb) => cb(key, oldData, newData));
+        }
       } else {
         const newEntry = {
           state: entry.state ?? createInitialState(),
@@ -809,6 +815,10 @@ function createStateManager() {
         };
         cache.set(key, newEntry);
         notifySubscribers(key);
+        const newData = newEntry.state.data;
+        if (oldData !== newData) {
+          dataChangeCallbacks.forEach((cb) => cb(key, oldData, newData));
+        }
       }
     },
     deleteCache(key) {
@@ -913,10 +923,17 @@ function createStateManager() {
     getPendingPromise(key) {
       return pendingPromises.get(key);
     },
+    onDataChange(callback) {
+      dataChangeCallbacks.add(callback);
+      return () => {
+        dataChangeCallbacks.delete(callback);
+      };
+    },
     clear() {
       cache.clear();
       subscribers.clear();
       pendingPromises.clear();
+      dataChangeCallbacks.clear();
     }
   };
 }

package/dist/index.mjs

@@ -698,6 +698,7 @@ function createStateManager() {
   const cache = /* @__PURE__ */ new Map();
   const subscribers = /* @__PURE__ */ new Map();
   const pendingPromises = /* @__PURE__ */ new Map();
+  const dataChangeCallbacks = /* @__PURE__ */ new Set();
   const notifySubscribers = (key) => {
     const subs = subscribers.get(key);
     subs?.forEach((cb) => cb());
@@ -717,6 +718,7 @@ function createStateManager() {
     },
     setCache(key, entry) {
       const existing = cache.get(key);
+      const oldData = existing?.state.data;
       if (existing) {
         existing.state = { ...existing.state, ...entry.state };
         if (entry.tags) {
@@ -729,6 +731,10 @@ function createStateManager() {
           existing.stale = entry.stale;
         }
         notifySubscribers(key);
+        const newData = existing.state.data;
+        if (oldData !== newData) {
+          dataChangeCallbacks.forEach((cb) => cb(key, oldData, newData));
+        }
       } else {
         const newEntry = {
           state: entry.state ?? createInitialState(),
@@ -740,6 +746,10 @@ function createStateManager() {
         };
         cache.set(key, newEntry);
         notifySubscribers(key);
+        const newData = newEntry.state.data;
+        if (oldData !== newData) {
+          dataChangeCallbacks.forEach((cb) => cb(key, oldData, newData));
+        }
       }
     },
     deleteCache(key) {
@@ -844,10 +854,17 @@ function createStateManager() {
     getPendingPromise(key) {
       return pendingPromises.get(key);
     },
+    onDataChange(callback) {
+      dataChangeCallbacks.add(callback);
+      return () => {
+        dataChangeCallbacks.delete(callback);
+      };
+    },
     clear() {
       cache.clear();
       subscribers.clear();
       pendingPromises.clear();
+      dataChangeCallbacks.clear();
     }
   };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoosh/core",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "license": "MIT",
   "description": "Type-safe API toolkit with plugin middleware system",
   "keywords": [