@buoy-gg/storage 7.0.35 → 7.0.38

package/README.md

@@ -2,9 +2,9 @@
 
 [![npm version](https://img.shields.io/npm/v/@buoy-gg/storage?style=flat-square&labelColor=1c1c1c&color=10B981)](https://www.npmjs.com/package/@buoy-gg/storage) [![npm downloads](https://img.shields.io/npm/dm/@buoy-gg/storage?style=flat-square&labelColor=1c1c1c&color=10B981)](https://www.npmjs.com/package/@buoy-gg/storage)
 
-**Browse and edit every key-value pair your React Native app persists — AsyncStorage, MMKV, and SecureStore in one explorer with real-time updates.**
+Browse and edit supported AsyncStorage, registered MMKV instances, and registered SecureStore keys inside your app.
 
-Part of [Buoy](https://github.com/Buoy-gg/buoy) — devtools that live inside your React Native app. Install it and it auto-appears in the floating menu from [`@buoy-gg/core`](https://www.npmjs.com/package/@buoy-gg/core).
+Part of [Buoy](https://github.com/Buoy-gg/buoy). Install the package, complete account setup, and follow the integration steps below.
 
 ![Storage Explorer demo](https://github.com/user-attachments/assets/80ef1c60-d20c-4d8b-97e6-f37b21b315ea)
 
@@ -14,6 +14,24 @@ Part of [Buoy](https://github.com/Buoy-gg/buoy) — devtools that live inside yo
 npm install @buoy-gg/core @buoy-gg/storage
 ```
 
+## Before you start
+
+Use a development build with `@buoy-gg/core` and a Free or Pro Buoy account key. From your app’s directory, sign in:
+
+```bash
+npx --package=@buoy-gg/core buoy login
+```
+
+For Expo, initialize Buoy before rendering the menu:
+
+```tsx
+import { Buoy } from "@buoy-gg/core";
+
+Buoy.init({ licenseKey: process.env.EXPO_PUBLIC_BUOY_KEY });
+```
+
+The login command writes the Expo key to `.env.local`. For React Native CLI, pass the key from your app’s environment configuration; React Native does not load `.env.local` automatically. Mount `FloatingDevTools` inside the same providers as your screens and restart the development server after installation. The [Quick Start](https://buoy.gg/buoy/latest/docs/quick-start) shows the complete root component setup.
+
 ## Quick start
 
 AsyncStorage works out of the box. Render the floating menu once — the Storage Explorer is auto-discovered as soon as this package is installed:
@@ -55,6 +73,10 @@ registerSecureStoreKeys(SecureStore, [
 ]);
 ```
 
+## Check the integration
+
+Use a disposable test key: read its value, edit it, read it from your app, then delete it. Register the MMKV instances your app actually uses and the SecureStore keys you want to inspect; those keys cannot be enumerated automatically.
+
 ## What you get
 
 - **Three backends, one explorer** — AsyncStorage, MMKV (multiple instances, including encrypted), and Expo SecureStore, with per-instance key counts and an instance switcher.
@@ -67,11 +89,11 @@ registerSecureStoreKeys(SecureStore, [
 
 ## Desktop & AI
 
-The same live session streams to [Buoy Desktop](https://github.com/Buoy-gg/Buoy-Desktop) (free, macOS/Windows/Linux) and to Claude Code or Cursor via the [Buoy MCP server](https://buoy.gg/buoy/latest/docs/mcp).
+To connect a React Native app to [Buoy Desktop](https://github.com/Buoy-gg/Buoy-Desktop) or MCP, install `@buoy-gg/external-sync` and follow the [Desktop connection guide](https://buoy.gg/buoy/latest/docs/desktop). Sign in to Desktop separately. [MCP setup](https://buoy.gg/buoy/latest/docs/mcp) also requires a process account and Pro access. Available remote actions depend on the tool and app integration.
 
-## Free vs Pro
+## Account and plan requirements
 
-Every tool is free. [Pro](https://buoy.gg/pricing) unlocks production builds, the MCP server, and unlimited capture. Every weekend, Pro features unlock free for anyone holding a key — including a free one (`npx buoy login`).
+Use a Free or Pro Buoy account. History limits and paid features vary by tool; see [pricing](https://buoy.gg/pricing). Production access requires Pro where supported. Development-only hooks and actions remain unavailable in release builds.
 
 ---
 

package/lib/commonjs/storage/components/StorageKeyCard.js

@@ -203,14 +203,8 @@ function StorageKeyCard({
         })]
       }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
         style: styles.cardHeaderRight,
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.TouchableOpacity, {
-          accessibilityLabel: "Expand",
-          accessibilityHint: "Expand storage key card",
-          "sentry-label": `ignore storage key card ${storageKey.key} expand`,
-          accessibilityRole: "button",
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
           style: styles.actionButton,
-          onPress: onToggle,
-          hitSlop: HIT_SLOP,
           children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.Eye, {
             size: 12,
             color: _sharedUi.night.color.textSecondary

package/lib/commonjs/storage/components/StorageKeyDetailScreen.js

@@ -88,7 +88,13 @@ function StorageKeyDetailScreen({
   }
   const baseValue = lastWrittenRef.current ? lastWrittenRef.current.value : propParsed;
   const write = (0, _react.useCallback)(next => {
-    const raw = JSON.stringify(next);
+    // A string is stored AS ITSELF. `JSON.stringify` on a string adds
+    // quotes the backend keeps (AsyncStorage) or shows natively (MMKV), and
+    // they compound on every edit: "hello" → "\"hello\"" → ... The old
+    // scalar editor had this rule (serializeScalar); the live editor must
+    // keep it, and it matches propRaw above, so an echo still reads as
+    // caught up.
+    const raw = typeof next === "string" ? next : JSON.stringify(next);
     lastWrittenRef.current = {
       raw,
       value: next
@@ -210,6 +216,7 @@ function StorageKeyDetailScreen({
                 children: "Storage:"
               }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_sharedUi.PillBadge, {
                 color: (0, _StorageKeyRow.getStorageTypeColor)(storageKey.storageType),
+                testID: `${DETAIL_ID}-backend`,
                 children: storageTypeLabel
               }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
                 style: styles.infoDim,

package/lib/module/storage/components/StorageKeyCard.js

@@ -200,14 +200,8 @@ export function StorageKeyCard({
         })]
       }), /*#__PURE__*/_jsx(View, {
         style: styles.cardHeaderRight,
-        children: /*#__PURE__*/_jsx(TouchableOpacity, {
-          accessibilityLabel: "Expand",
-          accessibilityHint: "Expand storage key card",
-          "sentry-label": `ignore storage key card ${storageKey.key} expand`,
-          accessibilityRole: "button",
+        children: /*#__PURE__*/_jsx(View, {
           style: styles.actionButton,
-          onPress: onToggle,
-          hitSlop: HIT_SLOP,
           children: /*#__PURE__*/_jsx(Eye, {
             size: 12,
             color: night.color.textSecondary

package/lib/module/storage/components/StorageKeyDetailScreen.js

@@ -86,7 +86,13 @@ export function StorageKeyDetailScreen({
   }
   const baseValue = lastWrittenRef.current ? lastWrittenRef.current.value : propParsed;
   const write = useCallback(next => {
-    const raw = JSON.stringify(next);
+    // A string is stored AS ITSELF. `JSON.stringify` on a string adds
+    // quotes the backend keeps (AsyncStorage) or shows natively (MMKV), and
+    // they compound on every edit: "hello" → "\"hello\"" → ... The old
+    // scalar editor had this rule (serializeScalar); the live editor must
+    // keep it, and it matches propRaw above, so an echo still reads as
+    // caught up.
+    const raw = typeof next === "string" ? next : JSON.stringify(next);
     lastWrittenRef.current = {
       raw,
       value: next
@@ -208,6 +214,7 @@ export function StorageKeyDetailScreen({
                 children: "Storage:"
               }), /*#__PURE__*/_jsx(PillBadge, {
                 color: getStorageTypeColor(storageKey.storageType),
+                testID: `${DETAIL_ID}-backend`,
                 children: storageTypeLabel
               }), /*#__PURE__*/_jsx(Text, {
                 style: styles.infoDim,

package/lib/typescript/storage/components/StorageKeyCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageKeyCard.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/StorageKeyCard.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA8B1C,UAAU,mBAAmB;IAC3B,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAiED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,UAAU,EACV,QAAQ,GACT,EAAE,mBAAmB,+BAiMrB"}
+{"version":3,"file":"StorageKeyCard.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/StorageKeyCard.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA8B1C,UAAU,mBAAmB;IAC3B,UAAU,EAAE,cAAc,CAAC;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAiED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAC7B,UAAU,EACV,UAAU,EACV,QAAQ,GACT,EAAE,mBAAmB,+BA4LrB"}

package/lib/typescript/storage/components/StorageKeyDetailScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageKeyDetailScreen.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/StorageKeyDetailScreen.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAgCH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAwC/C,UAAU,2BAA2B;IACnC,UAAU,EAAE,cAAc,CAAC;IAC3B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,EACrC,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,EAAE,2BAA2B,+BAyV7B"}
+{"version":3,"file":"StorageKeyDetailScreen.d.ts","sourceRoot":"","sources":["../../../../src/storage/components/StorageKeyDetailScreen.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAgCH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAwC/C,UAAU,2BAA2B;IACnC,UAAU,EAAE,cAAc,CAAC;IAC3B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;IACnD,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,cAAc,KAAK,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,4EAA4E;IAC5E,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CAAC,EACrC,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,MAAM,EACN,aAAa,EACb,WAAW,EACX,SAAS,EACT,QAAgB,EAChB,WAAW,EACX,kBAAkB,GACnB,EAAE,2BAA2B,+BAkW7B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@buoy-gg/storage",
-  "version": "7.0.35",
-  "description": "Browse & edit AsyncStorage, MMKV & SecureStore inside your React Native app, with change history. Part of Buoy devtools.",
+  "version": "7.0.38",
+  "description": "Inspect supported AsyncStorage data, registered MMKV instances and registered SecureStore keys in a React Native app.",
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
   "types": "lib/typescript/index.d.ts",
@@ -29,11 +29,11 @@
     "**/snapshotProvider.ts"
   ],
   "dependencies": {
-    "@buoy-gg/floating-tools-core": "^7.0.35",
-    "@buoy-gg/shared-ui": "^7.0.35"
+    "@buoy-gg/shared-ui": "^7.0.38",
+    "@buoy-gg/floating-tools-core": "^7.0.38"
   },
   "peerDependencies": {
-    "@buoy-gg/license": "7.0.35",
+    "@buoy-gg/license": "7.0.38",
     "@react-native-async-storage/async-storage": "^2.0.0 || ^3.1.0",
     "react": "*",
     "react-native": "*"
@@ -43,7 +43,7 @@
     "@types/react": "^19.1.0",
     "@types/react-native": "^0.73.0",
     "typescript": "~5.8.3",
-    "@buoy-gg/license": "^7.0.35"
+    "@buoy-gg/license": "^7.0.38"
   },
   "react-native-builder-bob": {
     "source": "src",