@yiin/reactive-proxy-state 1.0.35 → 1.0.37

package/dist/index.cjs

@@ -4030,7 +4030,7 @@ function markRaw(obj) {
 var import_vue = require("vue");
 var import_reactivity = __toESM(require_reactivity_cjs(), 1);
 function trackVueReactiveEvents(vueState, emit, options = {}) {
-  const { emitInitialReplace = true } = options;
+  const { emitInitialReplace = true, onDiffError } = options;
   if (emitInitialReplace) {
     try {
       emit({ action: "replace", path: [], newValue: deepClone(vueState) });
@@ -4039,6 +4039,7 @@ function trackVueReactiveEvents(vueState, emit, options = {}) {
   const prev = {};
   const pathStack = [];
   const keyStops = new Map;
+  let rootStop = null;
   for (const k of Object.keys(vueState)) {
     prev[k] = deepClone(vueState[k]);
   }
@@ -4054,50 +4055,75 @@ function trackVueReactiveEvents(vueState, emit, options = {}) {
           prev[k] = result;
         }
       } catch (e) {
-        console.error("[trackVueReactiveEvents] diffAndClone threw for key", k, e);
+        const errorPath = pathStack.slice();
         pathStack.length = 0;
         prev[k] = deepClone(vueState[k]);
+        if (onDiffError) {
+          onDiffError({ key: k, path: errorPath, error: e });
+        }
         return;
       }
       pathStack.pop();
     }, { flush: "sync" });
     keyStops.set(k, stop);
   }
-  for (const k of Object.keys(prev)) {
-    createKeyEffect(k);
-  }
-  const stopRoot = import_vue.watchEffect(() => {
-    const currKeys = Object.keys(vueState);
-    const currKeySet = new Set(currKeys);
-    const prevKeySet = new Set(Object.keys(prev));
-    for (const k of currKeys) {
-      if (!prevKeySet.has(k)) {
-        import_reactivity.pauseTracking();
-        const cloned = deepClone(vueState[k]);
-        import_reactivity.resetTracking();
-        pathStack.push(k);
-        emit({ action: "set", path: pathStack.slice(), newValue: cloned });
-        pathStack.pop();
-        prev[k] = cloned;
-        createKeyEffect(k);
-      }
-    }
-    for (const k of prevKeySet) {
-      if (!currKeySet.has(k)) {
-        pathStack.push(k);
-        emit({ action: "delete", path: pathStack.slice(), oldValue: prev[k] });
-        pathStack.pop();
-        delete prev[k];
-        keyStops.get(k)?.();
-        keyStops.delete(k);
-      }
-    }
-  }, { flush: "sync" });
-  return () => {
-    stopRoot();
+  function createRootEffect() {
+    rootStop = import_vue.watchEffect(() => {
+      const currKeys = Object.keys(vueState);
+      const currKeySet = new Set(currKeys);
+      const prevKeySet = new Set(Object.keys(prev));
+      for (const k of currKeys) {
+        if (!prevKeySet.has(k)) {
+          import_reactivity.pauseTracking();
+          const cloned = deepClone(vueState[k]);
+          import_reactivity.resetTracking();
+          pathStack.push(k);
+          emit({ action: "set", path: pathStack.slice(), newValue: cloned });
+          pathStack.pop();
+          prev[k] = cloned;
+          createKeyEffect(k);
+        }
+      }
+      for (const k of prevKeySet) {
+        if (!currKeySet.has(k)) {
+          pathStack.push(k);
+          emit({ action: "delete", path: pathStack.slice(), oldValue: prev[k] });
+          pathStack.pop();
+          delete prev[k];
+          keyStops.get(k)?.();
+          keyStops.delete(k);
+        }
+      }
+    }, { flush: "sync" });
+  }
+  function stopAll() {
+    rootStop?.();
+    rootStop = null;
     for (const stop of keyStops.values())
       stop();
     keyStops.clear();
+  }
+  function startAll() {
+    for (const k of Object.keys(prev)) {
+      createKeyEffect(k);
+    }
+    createRootEffect();
+  }
+  startAll();
+  return {
+    stop: stopAll,
+    pause: stopAll,
+    resume() {
+      const currentKeys = new Set(Object.keys(vueState));
+      for (const k of Object.keys(prev)) {
+        if (!currentKeys.has(k))
+          delete prev[k];
+      }
+      for (const k of currentKeys) {
+        prev[k] = deepClone(vueState[k]);
+      }
+      startAll();
+    }
   };
 }
 function typeTag(v) {

package/dist/index.js

@@ -3970,7 +3970,7 @@ function markRaw(obj) {
 var import_reactivity = __toESM(require_reactivity_cjs(), 1);
 import { watchEffect as watchEffect2 } from "vue";
 function trackVueReactiveEvents(vueState, emit, options = {}) {
-  const { emitInitialReplace = true } = options;
+  const { emitInitialReplace = true, onDiffError } = options;
   if (emitInitialReplace) {
     try {
       emit({ action: "replace", path: [], newValue: deepClone(vueState) });
@@ -3979,6 +3979,7 @@ function trackVueReactiveEvents(vueState, emit, options = {}) {
   const prev = {};
   const pathStack = [];
   const keyStops = new Map;
+  let rootStop = null;
   for (const k of Object.keys(vueState)) {
     prev[k] = deepClone(vueState[k]);
   }
@@ -3994,50 +3995,75 @@ function trackVueReactiveEvents(vueState, emit, options = {}) {
           prev[k] = result;
         }
       } catch (e) {
-        console.error("[trackVueReactiveEvents] diffAndClone threw for key", k, e);
+        const errorPath = pathStack.slice();
         pathStack.length = 0;
         prev[k] = deepClone(vueState[k]);
+        if (onDiffError) {
+          onDiffError({ key: k, path: errorPath, error: e });
+        }
         return;
       }
       pathStack.pop();
     }, { flush: "sync" });
     keyStops.set(k, stop);
   }
-  for (const k of Object.keys(prev)) {
-    createKeyEffect(k);
-  }
-  const stopRoot = watchEffect2(() => {
-    const currKeys = Object.keys(vueState);
-    const currKeySet = new Set(currKeys);
-    const prevKeySet = new Set(Object.keys(prev));
-    for (const k of currKeys) {
-      if (!prevKeySet.has(k)) {
-        import_reactivity.pauseTracking();
-        const cloned = deepClone(vueState[k]);
-        import_reactivity.resetTracking();
-        pathStack.push(k);
-        emit({ action: "set", path: pathStack.slice(), newValue: cloned });
-        pathStack.pop();
-        prev[k] = cloned;
-        createKeyEffect(k);
-      }
-    }
-    for (const k of prevKeySet) {
-      if (!currKeySet.has(k)) {
-        pathStack.push(k);
-        emit({ action: "delete", path: pathStack.slice(), oldValue: prev[k] });
-        pathStack.pop();
-        delete prev[k];
-        keyStops.get(k)?.();
-        keyStops.delete(k);
-      }
-    }
-  }, { flush: "sync" });
-  return () => {
-    stopRoot();
+  function createRootEffect() {
+    rootStop = watchEffect2(() => {
+      const currKeys = Object.keys(vueState);
+      const currKeySet = new Set(currKeys);
+      const prevKeySet = new Set(Object.keys(prev));
+      for (const k of currKeys) {
+        if (!prevKeySet.has(k)) {
+          import_reactivity.pauseTracking();
+          const cloned = deepClone(vueState[k]);
+          import_reactivity.resetTracking();
+          pathStack.push(k);
+          emit({ action: "set", path: pathStack.slice(), newValue: cloned });
+          pathStack.pop();
+          prev[k] = cloned;
+          createKeyEffect(k);
+        }
+      }
+      for (const k of prevKeySet) {
+        if (!currKeySet.has(k)) {
+          pathStack.push(k);
+          emit({ action: "delete", path: pathStack.slice(), oldValue: prev[k] });
+          pathStack.pop();
+          delete prev[k];
+          keyStops.get(k)?.();
+          keyStops.delete(k);
+        }
+      }
+    }, { flush: "sync" });
+  }
+  function stopAll() {
+    rootStop?.();
+    rootStop = null;
     for (const stop of keyStops.values())
       stop();
     keyStops.clear();
+  }
+  function startAll() {
+    for (const k of Object.keys(prev)) {
+      createKeyEffect(k);
+    }
+    createRootEffect();
+  }
+  startAll();
+  return {
+    stop: stopAll,
+    pause: stopAll,
+    resume() {
+      const currentKeys = new Set(Object.keys(vueState));
+      for (const k of Object.keys(prev)) {
+        if (!currentKeys.has(k))
+          delete prev[k];
+      }
+      for (const k of currentKeys) {
+        prev[k] = deepClone(vueState[k]);
+      }
+      startAll();
+    }
   };
 }
 function typeTag(v) {

package/dist/integrations/vue3.d.ts

@@ -1,6 +1,20 @@
 import type { StateEvent } from "../types";
+export type DiffErrorContext = {
+    key: string;
+    path: (string | number | symbol)[];
+    error: unknown;
+};
 export type TrackVueReactiveEventsOptions = {
     emitInitialReplace?: boolean;
+    onDiffError?: (ctx: DiffErrorContext) => void;
+};
+export type VueTrackingControl = {
+    /** Stop all effects permanently. */
+    stop: () => void;
+    /** Stop all effects temporarily. No diffing overhead while paused. */
+    pause: () => void;
+    /** Rebuild snapshots from current state and re-create effects. */
+    resume: () => void;
 };
 /**
  * Observe a Vue 3 reactive object and emit RPS-compatible StateEvents
@@ -10,6 +24,7 @@ export type TrackVueReactiveEventsOptions = {
  * only the affected subtree is diffed on mutation. A root structural effect
  * tracks Object.keys() for key add/delete at the top level.
  *
- * Returns a stop() function to tear down all effects.
+ * Returns a control object with stop/pause/resume. Use pause/resume to
+ * suppress diffing while applying external mutations (e.g. server events).
  */
-export declare function trackVueReactiveEvents<T extends object>(vueState: T, emit: (event: StateEvent) => void, options?: TrackVueReactiveEventsOptions): () => void;
+export declare function trackVueReactiveEvents<T extends object>(vueState: T, emit: (event: StateEvent) => void, options?: TrackVueReactiveEventsOptions): VueTrackingControl;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yiin/reactive-proxy-state",
-  "version": "1.0.35",
+  "version": "1.0.37",
   "author": "Yiin <stanislovas@yiin.lt>",
   "repository": {
     "type": "git",