@buoy-gg/storage 7.0.41 → 7.0.43

package/lib/module/index.js

@@ -1,114 +1 @@
-"use strict";
-
-/**
- * @buoy-gg/storage
- *
- * Storage monitoring tool for React Native DevTools.
- * Supports AsyncStorage and MMKV.
- *
- * PUBLIC API - Only these exports are supported for external use.
- * Internal listeners and capture controls are not exported to prevent
- * bypassing the tool's intended usage patterns.
- */
-
-// Side-effect: registers the Time Machine snapshot provider
-import "./storage/utils/snapshotProvider";
-
-// =============================================================================
-// PRESET (Primary entry point for users)
-// =============================================================================
-export { storageToolPreset, createStorageTool } from "./preset";
-
-// =============================================================================
-// COMPONENTS (For custom UI implementations)
-// =============================================================================
-export { StorageSection } from "./storage/components/StorageSection";
-// `StorageToolView` is the same tool rendered inline (header bar + body +
-// footer) instead of inside a JsModal — for hosts that show tools in a panel.
-export { StorageModalWithTabs, StorageToolView } from "./storage/components/StorageModalWithTabs";
-export { StorageKeyCard } from "./storage/components/StorageKeyCard";
-export { StorageKeyStatsSection } from "./storage/components/StorageKeyStats";
-export { StorageKeySection } from "./storage/components/StorageKeySection";
-export { StorageBrowserMode } from "./storage/components/StorageBrowserMode";
-// The backend filter, shared by the Keys and Events tabs.
-export { StorageTypeFilterBar, countByStorageType } from "./storage/components/StorageTypeFilterBar";
-export { StorageEventsSection } from "./storage/components/StorageEventsSection";
-// The five display operations a storage event collapses onto — semantics, not
-// presentation, so hosts can filter or group by the same vocabulary the UI uses.
-export { STORAGE_OPS, storageOpOf, storageOpDot, isInitialScan } from "./storage/utils/storageOps";
-export { StorageEventCard, getValueType } from "./storage/components/StorageEventCard";
-export { StorageEventDetailContent, StorageEventDetailFooter } from "./storage/components/StorageEventDetailContent";
-export { MMKVInstanceSelector } from "./storage/components/MMKVInstanceSelector";
-export { MMKVInstanceInfoPanel } from "./storage/components/MMKVInstanceInfoPanel";
-
-// =============================================================================
-// HOOKS (For consuming storage data in custom components)
-// =============================================================================
-export { useAsyncStorageKeys } from "./storage/hooks/useAsyncStorageKeys";
-export { useMMKVKeys, useMultiMMKVKeys } from "./storage/hooks/useMMKVKeys";
-export { useMMKVInstances, useMMKVInstance, useMMKVInstanceExists } from "./storage/hooks/useMMKVInstances";
-export { useStorageEvents } from "./storage/hooks/useStorageEvents";
-
-// =============================================================================
-// TYPES
-// =============================================================================
-
-// =============================================================================
-// UTILITIES (Public helpers only)
-// =============================================================================
-export { clearAllAppStorage } from "./storage/utils/clearAllStorage";
-// Writing a value back, with the per-backend type rules in one place. Exported
-// so a host with its own storage UI edits through the same path the tool does.
-export { setStorageValue, storageEditBlockedReason, validateStorageValue, storageValueToEditableText } from "./storage/utils/setStorageValue";
-export { isMMKVAvailable, getMMKVClass, getMMKVUnavailableMessage } from "./storage/utils/mmkvAvailability";
-export { detectMMKVType, formatMMKVValue, isTypeMatch } from "./storage/utils/mmkvTypeDetection";
-export { undoOperation, jumpToState, canUndo } from "./storage/utils/storageTimeTravelUtils";
-// =============================================================================
-// MMKV INSTANCE REGISTRATION (For users to register their MMKV instances)
-// =============================================================================
-export { registerMMKVInstance, unregisterMMKVInstance } from "./storage/utils/MMKVInstanceRegistry";
-
-// =============================================================================
-// SECURE STORE REGISTRATION (For users to register their expo-secure-store keys)
-// SecureStore has no key-enumeration API, so keys must be declared to appear.
-// =============================================================================
-export { registerSecureStoreKeys, unregisterSecureStoreKey } from "./storage/utils/SecureStoreRegistry";
-// =============================================================================
-// EXTERNAL SYNC (Adapter for @buoy-gg/external-sync's useExternalSync)
-// =============================================================================
-export { storageSyncAdapter } from "./storage/sync/storageSyncAdapter";
-
-// =============================================================================
-// INTERNAL EXPORTS (For @buoy-gg/* packages only - not part of public API)
-// =============================================================================
-/** @internal */
-export { storageEventStore,
-// Exported so remote mirrors (Buoy Desktop) can ask "did the device withhold
-// this value?" without re-deriving the wire contract — and, in the case of
-// `batchPairsOf`, without re-introducing the union-narrowing bug that reading
-// `pairs`/`prevPairs` off a StorageEvent invites.
-isValueOnDevice, batchPairsOf } from "./storage/stores/storageEventStore";
-/**
- * Tell a mounted storage browser to re-read every backend. Used by the desktop
- * dashboard, where local storage listeners are suppressed and device data
- * arrives as snapshots instead.
- * @internal
- */
-export { requestStorageBrowserRefresh } from "./storage/utils/storageBrowserRefresh";
-
-// =============================================================================
-// NOT EXPORTED (Internal capture controls)
-// =============================================================================
-// The following are intentionally NOT exported to prevent bypassing:
-// - subscribeToStorageEvents, onStorageEvent, getStorageEvents, clearStorageEvents
-// - isStorageCapturing
-// - startListening, stopListening, addListener, removeAllListeners (AsyncStorage)
-// - pauseCapture, resumeCapture, isPaused, isListening, getListenerCount
-// - asyncStorageListener instance
-// - addMMKVInstance, removeMMKVInstance, removeAllMMKVInstances (MMKV listener controls)
-// - addMMKVListener, removeAllMMKVListeners, isMMKVInstanceMonitored
-// - getMonitoredMMKVInstances, getMMKVInstanceCount, getMMKVListenerCount, isMMKVListening
-// - mmkvListener instance
-// - mmkvInstanceRegistry instance
-
-export { startBrowserStorageCapture } from './storage/utils/browserStorageLifecycle';
+"use strict";import"./storage/utils/snapshotProvider";export{storageToolPreset,createStorageTool}from"./preset";export{StorageSection}from"./storage/components/StorageSection";export{StorageModalWithTabs,StorageToolView}from"./storage/components/StorageModalWithTabs";export{StorageKeyCard}from"./storage/components/StorageKeyCard";export{StorageKeyStatsSection}from"./storage/components/StorageKeyStats";export{StorageKeySection}from"./storage/components/StorageKeySection";export{StorageBrowserMode}from"./storage/components/StorageBrowserMode";export{StorageTypeFilterBar,countByStorageType}from"./storage/components/StorageTypeFilterBar";export{StorageEventsSection}from"./storage/components/StorageEventsSection";export{STORAGE_OPS,storageOpOf,storageOpDot,isInitialScan}from"./storage/utils/storageOps";export{StorageEventCard,getValueType}from"./storage/components/StorageEventCard";export{StorageEventDetailContent,StorageEventDetailFooter}from"./storage/components/StorageEventDetailContent";export{MMKVInstanceSelector}from"./storage/components/MMKVInstanceSelector";export{MMKVInstanceInfoPanel}from"./storage/components/MMKVInstanceInfoPanel";export{useAsyncStorageKeys}from"./storage/hooks/useAsyncStorageKeys";export{useMMKVKeys,useMultiMMKVKeys}from"./storage/hooks/useMMKVKeys";export{useMMKVInstances,useMMKVInstance,useMMKVInstanceExists}from"./storage/hooks/useMMKVInstances";export{useStorageEvents}from"./storage/hooks/useStorageEvents";export{clearAllAppStorage}from"./storage/utils/clearAllStorage";export{setStorageValue,storageEditBlockedReason,validateStorageValue,storageValueToEditableText}from"./storage/utils/setStorageValue";export{isMMKVAvailable,getMMKVClass,getMMKVUnavailableMessage}from"./storage/utils/mmkvAvailability";export{detectMMKVType,formatMMKVValue,isTypeMatch}from"./storage/utils/mmkvTypeDetection";export{undoOperation,jumpToState,canUndo}from"./storage/utils/storageTimeTravelUtils";export{registerMMKVInstance,unregisterMMKVInstance}from"./storage/utils/MMKVInstanceRegistry";export{registerSecureStoreKeys,unregisterSecureStoreKey}from"./storage/utils/SecureStoreRegistry";export{storageSyncAdapter}from"./storage/sync/storageSyncAdapter";export{storageEventStore,isValueOnDevice,batchPairsOf}from"./storage/stores/storageEventStore";export{requestStorageBrowserRefresh}from"./storage/utils/storageBrowserRefresh";export{startBrowserStorageCapture}from"./storage/utils/browserStorageLifecycle";

package/lib/module/preset.js

@@ -1,82 +1 @@
-"use strict";
-
-/**
- * Pre-configured AsyncStorage browser tool for FloatingDevTools
- *
- * This preset provides a zero-config way to add AsyncStorage inspection to your dev tools.
- * Just import and add it to your apps array!
- *
- * @example
- * ```tsx
- * import { storageToolPreset } from '@buoy-gg/storage';
- *
- * const installedApps = [
- *   storageToolPreset, // That's it!
- *   // ...other tools
- * ];
- * ```
- */
-
-import { StorageIcon } from "@buoy-gg/floating-tools-core";
-import { createToolFactory, defineToolPreset } from "@buoy-gg/shared-ui";
-import { StorageModalWithTabs } from "./storage/components/StorageModalWithTabs";
-import { setToolRequiredStorageKeys } from "./storage/sync/storageSyncAdapter";
-
-/**
- * Pre-configured AsyncStorage browser tool for FloatingDevTools.
- * Includes:
- * - Browse all AsyncStorage keys and values
- * - Edit, delete, and add storage items
- * - Live storage event monitoring
- * - Required key validation
- */
-import { jsx as _jsx } from "react/jsx-runtime";
-export const storageToolPreset = defineToolPreset({
-  id: "storage",
-  name: "STORAGE",
-  description: "AsyncStorage browser",
-  slot: "both",
-  icon: ({
-    size
-  }) => /*#__PURE__*/_jsx(StorageIcon, {
-    size: size
-  }),
-  component: StorageModalWithTabs,
-  props: {
-    requiredStorageKeys: [],
-    enableSharedModalDimensions: false
-  }
-});
-
-/**
- * Create a custom AsyncStorage browser tool configuration.
- * Use this if you want to override default settings or provide required storage keys.
- *
- * @example
- * ```tsx
- * import { createStorageTool } from '@buoy-gg/storage';
- *
- * const requiredStorageKeys = [
- *   {
- *     key: "@app/session",
- *     expectedType: "string",
- *     description: "User session token",
- *     storageType: "async",
- *   },
- * ];
- *
- * const myStorageTool = createStorageTool({
- *   requiredStorageKeys,
- *   colorPreset: "purple",
- *   enableSharedModalDimensions: true,
- * });
- * ```
- */
-export const createStorageTool = createToolFactory(storageToolPreset, options => {
-  // Shared with the sync adapter so the desktop panel checks the same keys.
-  setToolRequiredStorageKeys(options.requiredStorageKeys || []);
-  return {
-    requiredStorageKeys: options.requiredStorageKeys || [],
-    enableSharedModalDimensions: options.enableSharedModalDimensions ?? false
-  };
-});
+"use strict";import{StorageIcon as o}from"@buoy-gg/floating-tools-core";import{createToolFactory as r,defineToolPreset as t}from"@buoy-gg/shared-ui";import{StorageModalWithTabs as s}from"./storage/components/StorageModalWithTabs";import{setToolRequiredStorageKeys as a}from"./storage/sync/storageSyncAdapter";import{jsx as i}from"react/jsx-runtime";export const storageToolPreset=t({id:"storage",name:"STORAGE",description:"AsyncStorage browser",slot:"both",icon:({size:e})=>i(o,{size:e}),component:s,props:{requiredStorageKeys:[],enableSharedModalDimensions:false}});export const createStorageTool=r(storageToolPreset,e=>{a(e.requiredStorageKeys||[]);return{requiredStorageKeys:e.requiredStorageKeys||[],enableSharedModalDimensions:e.enableSharedModalDimensions??false}});

package/lib/module/storage/components/DiffViewer/TreeDiffViewer.js

@@ -1,32 +1 @@
-"use strict";
-
-import { View, StyleSheet } from "react-native";
-import { night } from "@buoy-gg/shared-ui";
-import { TreeDiffViewer as SharedTreeDiffViewer } from "@buoy-gg/shared-ui/dataViewer";
-import { jsx as _jsx } from "react/jsx-runtime";
-export function TreeDiffViewer({
-  oldValue,
-  newValue,
-  scrollEnabled = true
-}) {
-  return /*#__PURE__*/_jsx(View, {
-    style: scrollEnabled ? styles.container : styles.containerInline,
-    children: /*#__PURE__*/_jsx(SharedTreeDiffViewer, {
-      oldValue: oldValue,
-      newValue: newValue,
-      theme: "dark",
-      scrollEnabled: scrollEnabled
-    })
-  });
-}
-const styles = StyleSheet.create({
-  container: {
-    flex: 1,
-    backgroundColor: night.color.bg
-  },
-  // Inline: size to the tree so the page scroll reveals it, rather than
-  // stretching to the pane and clipping the rows.
-  containerInline: {
-    backgroundColor: night.color.bg
-  }
-});
+"use strict";import{View as l,StyleSheet as a}from"react-native";import{night as r}from"@buoy-gg/shared-ui";import{TreeDiffViewer as c}from"@buoy-gg/shared-ui/dataViewer";import{jsx as o}from"react/jsx-runtime";export function TreeDiffViewer({oldValue:i,newValue:n,scrollEnabled:e=true}){return o(l,{style:e?t.container:t.containerInline,children:o(c,{oldValue:i,newValue:n,theme:"dark",scrollEnabled:e})})}const t=a.create({container:{flex:1,backgroundColor:r.color.bg},containerInline:{backgroundColor:r.color.bg}});

package/lib/module/storage/components/DiffViewer/modes/ThemedSplitView.js

@@ -1,9 +1 @@
-"use strict";
-
-/**
- * Re-export shim — ThemedSplitView now lives in @buoy-gg/shared-ui/dataViewer
- * (promoted so redux/zustand/jotai/time-machine share one copy; this used to
- * be the only fork with folding + virtualization, and fixes had to be made
- * twice). Keep importing from here inside the storage package.
- */
-export { ThemedSplitView } from "@buoy-gg/shared-ui/dataViewer";
+"use strict";export{ThemedSplitView}from"@buoy-gg/shared-ui/dataViewer";

package/lib/module/storage/components/DiffViewer/themes/diffThemes.js

@@ -1,10 +1 @@
-"use strict";
-
-/**
- * Re-export shim — the diff theme system now lives in
- * @buoy-gg/shared-ui/dataViewer (this used to be a byte-for-byte fork, and
- * the night-theme pass had to be made twice before it was collapsed; same
- * story as ../modes/ThemedSplitView). Keep importing from here inside the
- * storage package.
- */
-export { diffThemes, gitClassicTheme, devToolsDefaultTheme } from "@buoy-gg/shared-ui/dataViewer";
+"use strict";export{diffThemes,gitClassicTheme,devToolsDefaultTheme}from"@buoy-gg/shared-ui/dataViewer";