@buoy-gg/redux 7.0.16 → 7.0.17

package/lib/commonjs/index.js

@@ -213,6 +213,7 @@ Object.defineProperty(exports, "withBuoyDevTools", {
     return _buoyReduxMiddleware.withBuoyDevTools;
   }
 });
+require("./redux/utils/snapshotProvider");
 var _devtoolsHook = require("./redux/utils/devtoolsHook");
 var _preset = require("./preset");
 var _buoyReduxMiddleware = require("./redux/utils/buoyReduxMiddleware");

package/lib/commonjs/redux/utils/snapshotProvider.js

@@ -0,0 +1,123 @@
+"use strict";
+
+var _sharedUi = require("@buoy-gg/shared-ui");
+var _activeStoreRegistry = require("./activeStoreRegistry");
+var _buoyReduxMiddleware = require("./buoyReduxMiddleware");
+/**
+ * Time Machine snapshot provider for Redux.
+ *
+ * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
+ * consumed by @buoy-gg/time-machine.
+ *
+ * Restore rides the existing `@@buoy/JUMP_TO_STATE` full-state-replace action:
+ * - enhancer path: always handled (wrapReducer).
+ * - middleware path: handled ONLY when the app wrapped its root reducer in
+ *   `withBuoyDevTools()` — unverifiable statically, so restore verifies by
+ *   reference identity after dispatch (the wrapped reducer returns the payload
+ *   object itself).
+ * - patch path: never handled; restore is reported as unavailable up front.
+ */
+
+const ENABLE_HINT = "enable restore by using the Buoy enhancer or wrapping your root reducer in withBuoyDevTools()";
+function status() {
+  const {
+    mechanism,
+    hasStore,
+    diagnostic
+  } = (0, _activeStoreRegistry.getInstrumentationStatus)();
+  if (!hasStore) {
+    return {
+      canCapture: false,
+      canRestore: false,
+      detail: diagnostic === "no-react-redux" ? "react-redux not installed" : diagnostic === "no-provider" ? "No Redux <Provider> found" : "No Redux store instrumented"
+    };
+  }
+  if (mechanism === "patch") {
+    return {
+      canCapture: true,
+      canRestore: false,
+      detail: `Auto-instrumented store cannot be restored — ${ENABLE_HINT}`
+    };
+  }
+  return {
+    canCapture: true,
+    canRestore: true,
+    detail: mechanism === "middleware" ? "Restore requires withBuoyDevTools(rootReducer) — verified at restore time" : undefined
+  };
+}
+async function capture() {
+  const store = (0, _activeStoreRegistry.getActiveStore)();
+  if (!store) {
+    return {
+      data: null,
+      warnings: ["no Redux store instrumented"]
+    };
+  }
+  return {
+    data: {
+      state: store.getState()
+    },
+    warnings: []
+  };
+}
+async function restore(data) {
+  const snapshot = data;
+  const store = (0, _activeStoreRegistry.getActiveStore)();
+  if (!store || snapshot === undefined || snapshot === null) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [{
+        id: "redux",
+        reason: store ? "empty redux snapshot" : "no Redux store instrumented"
+      }],
+      warnings: []
+    };
+  }
+  const {
+    mechanism
+  } = (0, _activeStoreRegistry.getInstrumentationStatus)();
+  if (mechanism === "patch") {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [{
+        id: "redux",
+        reason: `restore unavailable on auto-instrumented stores — ${ENABLE_HINT}`
+      }],
+      warnings: []
+    };
+  }
+  const payload = snapshot.state;
+  store.dispatch({
+    type: _buoyReduxMiddleware.BUOY_JUMP_TO_STATE,
+    payload
+  });
+  // The wrapped reducer returns the payload object itself, so reference
+  // identity proves the jump was actually handled (and not silently ignored
+  // by an unwrapped middleware-path reducer).
+  if (store.getState() === payload) {
+    return {
+      ok: true,
+      applied: 1,
+      skipped: [],
+      warnings: []
+    };
+  }
+  return {
+    ok: false,
+    applied: 0,
+    skipped: [{
+      id: "redux",
+      reason: `store ignored the state jump — ${ENABLE_HINT}`
+    }],
+    warnings: []
+  };
+}
+(0, _sharedUi.registerStateSnapshotProvider)({
+  id: "redux",
+  label: "Redux",
+  status,
+  capture,
+  restore
+});

package/lib/module/index.js

@@ -53,6 +53,9 @@
  * ```
  */
 
+// Side-effect: registers the Time Machine snapshot provider
+import "./redux/utils/snapshotProvider";
+
 // SIDE EFFECT (must stay first): claim the Redux DevTools global so stores
 // created after this module loads get the full-capture enhancer. Dev-only,
 // never overrides an existing claimant. See ./redux/utils/devtoolsHook.ts.

package/lib/module/redux/utils/snapshotProvider.js

@@ -0,0 +1,122 @@
+"use strict";
+
+/**
+ * Time Machine snapshot provider for Redux.
+ *
+ * Registered into @buoy-gg/shared-ui's stateSnapshotRegistry at module init;
+ * consumed by @buoy-gg/time-machine.
+ *
+ * Restore rides the existing `@@buoy/JUMP_TO_STATE` full-state-replace action:
+ * - enhancer path: always handled (wrapReducer).
+ * - middleware path: handled ONLY when the app wrapped its root reducer in
+ *   `withBuoyDevTools()` — unverifiable statically, so restore verifies by
+ *   reference identity after dispatch (the wrapped reducer returns the payload
+ *   object itself).
+ * - patch path: never handled; restore is reported as unavailable up front.
+ */
+import { registerStateSnapshotProvider } from "@buoy-gg/shared-ui";
+import { getActiveStore, getInstrumentationStatus } from "./activeStoreRegistry";
+import { BUOY_JUMP_TO_STATE } from "./buoyReduxMiddleware";
+const ENABLE_HINT = "enable restore by using the Buoy enhancer or wrapping your root reducer in withBuoyDevTools()";
+function status() {
+  const {
+    mechanism,
+    hasStore,
+    diagnostic
+  } = getInstrumentationStatus();
+  if (!hasStore) {
+    return {
+      canCapture: false,
+      canRestore: false,
+      detail: diagnostic === "no-react-redux" ? "react-redux not installed" : diagnostic === "no-provider" ? "No Redux <Provider> found" : "No Redux store instrumented"
+    };
+  }
+  if (mechanism === "patch") {
+    return {
+      canCapture: true,
+      canRestore: false,
+      detail: `Auto-instrumented store cannot be restored — ${ENABLE_HINT}`
+    };
+  }
+  return {
+    canCapture: true,
+    canRestore: true,
+    detail: mechanism === "middleware" ? "Restore requires withBuoyDevTools(rootReducer) — verified at restore time" : undefined
+  };
+}
+async function capture() {
+  const store = getActiveStore();
+  if (!store) {
+    return {
+      data: null,
+      warnings: ["no Redux store instrumented"]
+    };
+  }
+  return {
+    data: {
+      state: store.getState()
+    },
+    warnings: []
+  };
+}
+async function restore(data) {
+  const snapshot = data;
+  const store = getActiveStore();
+  if (!store || snapshot === undefined || snapshot === null) {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [{
+        id: "redux",
+        reason: store ? "empty redux snapshot" : "no Redux store instrumented"
+      }],
+      warnings: []
+    };
+  }
+  const {
+    mechanism
+  } = getInstrumentationStatus();
+  if (mechanism === "patch") {
+    return {
+      ok: false,
+      applied: 0,
+      skipped: [{
+        id: "redux",
+        reason: `restore unavailable on auto-instrumented stores — ${ENABLE_HINT}`
+      }],
+      warnings: []
+    };
+  }
+  const payload = snapshot.state;
+  store.dispatch({
+    type: BUOY_JUMP_TO_STATE,
+    payload
+  });
+  // The wrapped reducer returns the payload object itself, so reference
+  // identity proves the jump was actually handled (and not silently ignored
+  // by an unwrapped middleware-path reducer).
+  if (store.getState() === payload) {
+    return {
+      ok: true,
+      applied: 1,
+      skipped: [],
+      warnings: []
+    };
+  }
+  return {
+    ok: false,
+    applied: 0,
+    skipped: [{
+      id: "redux",
+      reason: `store ignored the state jump — ${ENABLE_HINT}`
+    }],
+    warnings: []
+  };
+}
+registerStateSnapshotProvider({
+  id: "redux",
+  label: "Redux",
+  status,
+  capture,
+  restore
+});

package/lib/typescript/index.d.ts

@@ -50,6 +50,7 @@
  * });
  * ```
  */
+import "./redux/utils/snapshotProvider";
 import "./redux/utils/devtoolsHook";
 export { reduxToolPreset, createReduxTool } from "./preset";
 export { buoyReduxMiddleware, createBuoyReduxMiddleware, withBuoyDevTools, jumpToState, replayAction, BUOY_JUMP_TO_STATE, BUOY_REPLAY_ACTION, } from "./redux/utils/buoyReduxMiddleware";

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAKH,OAAO,4BAA4B,CAAC;AAKpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAK5D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AAKjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAO9C,OAAO,EACL,UAAU,EACV,aAAa,EACb,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAK7E,YAAY,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAKvB,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAGH,OAAO,gCAAgC,CAAC;AAKxC,OAAO,4BAA4B,CAAC;AAKpC,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAK5D,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,EACL,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,sBAAsB,EACtB,cAAc,EACd,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACL,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,GACtB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EACL,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,yCAAyC,CAAC;AAKjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAKjE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAG3E,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,sCAAsC,CAAC;AAC9C,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAO9C,OAAO,EACL,UAAU,EACV,aAAa,EACb,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,0CAA0C,CAAC;AACjF,OAAO,EACL,wBAAwB,EACxB,uBAAuB,GACxB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAGzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC;AAK7E,YAAY,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,eAAe,CAAC;AAKvB,gBAAgB;AAChB,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/lib/typescript/redux/utils/snapshotProvider.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=snapshotProvider.d.ts.map

package/lib/typescript/redux/utils/snapshotProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshotProvider.d.ts","sourceRoot":"","sources":["../../../../src/redux/utils/snapshotProvider.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buoy-gg/redux",
-  "version": "7.0.16",
+  "version": "7.0.17",
   "description": "Redux DevTools inside your React Native app — action log, state diffs & time travel with zero store changes. Part of Buoy devtools.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
@@ -26,12 +26,14 @@
   ],
   "sideEffects": [
     "**/devtoolsHook.js",
-    "**/devtoolsHook.ts"
+    "**/devtoolsHook.ts",
+    "**/snapshotProvider.js",
+    "**/snapshotProvider.ts"
   ],
   "dependencies": {
-    "@buoy-gg/shared-ui": "^7.0.16",
-    "@buoy-gg/floating-tools-core": "^7.0.16",
-    "@buoy-gg/license": "^7.0.16"
+    "@buoy-gg/shared-ui": "^7.0.17",
+    "@buoy-gg/license": "^7.0.17",
+    "@buoy-gg/floating-tools-core": "^7.0.17"
   },
   "peerDependencies": {
     "@reduxjs/toolkit": ">=1.9.0",