@buoy-gg/storage 7.0.41 → 7.0.42

package/lib/commonjs/storage/utils/AsyncStorageListener.web.js

@@ -1,89 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.addListener = addListener;
-exports.default = void 0;
-exports.getListenerCount = getListenerCount;
-exports.isListening = isListening;
-exports.isPaused = isPaused;
-exports.pauseCapture = pauseCapture;
-exports.removeAllListeners = removeAllListeners;
-exports.resumeCapture = resumeCapture;
-exports.startListening = startListening;
-exports.stopListening = stopListening;
-var _utils = require("@buoy-gg/shared-ui/utils");
-const listeners = new Set();
-let stop;
-let paused = false;
-const ignoredKeys = new Set(['@react_buoy_storage_event_filters', '@react_buoy_storage_key_filters', '@react_buoy_storage_is_monitoring', 'REACT_QUERY_OFFLINE_CACHE']);
-const ignored = key => [...ignoredKeys].some(prefix => key.startsWith(prefix));
-async function startListening() {
-  if (stop || typeof window === 'undefined') return;
-  stop = (0, _utils.subscribeToBrowserStorage)(change => {
-    if (paused || change.area !== 'localStorage' || change.key !== undefined && ignored(change.key)) return;
-    const {
-      area: _,
-      action,
-      ...data
-    } = change;
-    if (data.prevPairs) data.prevPairs = data.prevPairs.filter(([key]) => !ignored(key));
-    const event = {
-      action,
-      data,
-      timestamp: new Date()
-    };
-    for (const listener of [...listeners]) {
-      try {
-        listener(event);
-      } catch {/* Keep observing other consumers. */}
-    }
-  });
-}
-function stopListening() {
-  stop?.();
-  stop = undefined;
-}
-function addListener(listener) {
-  listeners.add(listener);
-  return () => {
-    listeners.delete(listener);
-  };
-}
-function removeAllListeners() {
-  listeners.clear();
-}
-function isListening() {
-  return !!stop;
-}
-function getListenerCount() {
-  return listeners.size;
-}
-function pauseCapture() {
-  paused = true;
-}
-function resumeCapture() {
-  paused = false;
-}
-function isPaused() {
-  return paused;
-}
-const asyncStorageListener = {
-  startListening,
-  stopListening,
-  addListener,
-  removeAllListeners,
-  pause: pauseCapture,
-  resume: resumeCapture,
-  get isActive() {
-    return isListening();
-  },
-  get listenerCount() {
-    return listeners.size;
-  },
-  get paused() {
-    return paused;
-  }
-};
-var _default = exports.default = asyncStorageListener;
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.addListener=addListener;exports.default=void 0;exports.getListenerCount=getListenerCount;exports.isListening=isListening;exports.isPaused=isPaused;exports.pauseCapture=pauseCapture;exports.removeAllListeners=removeAllListeners;exports.resumeCapture=resumeCapture;exports.startListening=startListening;exports.stopListening=stopListening;var _utils=require("@buoy-gg/shared-ui/utils");const listeners=new Set;let stop;let paused=false;const ignoredKeys=new Set(["@react_buoy_storage_event_filters","@react_buoy_storage_key_filters","@react_buoy_storage_is_monitoring","REACT_QUERY_OFFLINE_CACHE"]);const ignored=e=>[...ignoredKeys].some(s=>e.startsWith(s));async function startListening(){if(stop||typeof window==="undefined")return;stop=(0,_utils.subscribeToBrowserStorage)(e=>{if(paused||e.area!=="localStorage"||e.key!==void 0&&ignored(e.key))return;const{area:s,action:n,...t}=e;if(t.prevPairs)t.prevPairs=t.prevPairs.filter(([r])=>!ignored(r));const i={action:n,data:t,timestamp:new Date};for(const r of[...listeners]){try{r(i)}catch{}}})}function stopListening(){stop?.();stop=void 0}function addListener(e){listeners.add(e);return()=>{listeners.delete(e)}}function removeAllListeners(){listeners.clear()}function isListening(){return!!stop}function getListenerCount(){return listeners.size}function pauseCapture(){paused=true}function resumeCapture(){paused=false}function isPaused(){return paused}const asyncStorageListener={startListening,stopListening,addListener,removeAllListeners,pause:pauseCapture,resume:resumeCapture,get isActive(){return isListening()},get listenerCount(){return listeners.size},get paused(){return paused}};var _default=exports.default=asyncStorageListener;

package/lib/commonjs/storage/utils/MMKVInstanceRegistry.js

@@ -1,203 +1 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.mmkvInstanceRegistry = void 0;
-exports.registerMMKVInstance = registerMMKVInstance;
-exports.unregisterMMKVInstance = unregisterMMKVInstance;
-var _MMKVListener = require("./MMKVListener");
-/**
- * MMKV Instance Registry
- *
- * Centralized registry for tracking all MMKV instances in the application.
- * Provides a singleton pattern to manage multiple MMKV instances and their metadata.
- *
- * @module MMKVInstanceRegistry
- * @since 1.0.0
- */
-
-// Static ESM import. This was previously a dynamic `require('./MMKVListener')`
-// inside register/unregister "to avoid a circular dependency" — but MMKVListener
-// imports only ./mmkvTypeDetection, never this file, so there is no cycle. The
-// require() form threw `ReferenceError: require is not defined` when this source
-// is bundled as ESM (the desktop dashboard imports it through Vite), crashing on
-// StorageInline unmount. A static import behaves identically on Metro and Vite.
-
-/**
- * Type-safe representation of an MMKV instance.
- * Uses conditional typing to avoid hard dependency on react-native-mmkv.
- *
- * @public
- */
-
-/**
- * Metadata about a registered MMKV instance
- *
- * @public
- */
-
-/**
- * Configuration options for registering an MMKV instance
- *
- * @public
- */
-
-class MMKVInstanceRegistry {
-  instances = new Map();
-
-  /**
-   * Register an MMKV instance for monitoring
-   *
-   * @param id - Unique identifier for this instance
-   * @param instance - The MMKV instance to register
-   * @param config - Optional configuration (e.g., encrypted flag)
-   */
-  register(id, instance, config) {
-    const instanceInfo = {
-      id,
-      instance,
-      encrypted: config?.encrypted ?? false,
-      readOnly: instance.isReadOnly ?? false
-    };
-    this.instances.set(id, instanceInfo);
-  }
-
-  /**
-   * Unregister an MMKV instance
-   */
-  unregister(id) {
-    this.instances.delete(id);
-  }
-
-  /**
-   * Get a specific instance by ID
-   */
-  get(id) {
-    return this.instances.get(id);
-  }
-
-  /**
-   * Get all registered instances
-   */
-  getAll() {
-    return Array.from(this.instances.values());
-  }
-
-  /**
-   * Check if an instance is registered
-   */
-  has(id) {
-    return this.instances.has(id);
-  }
-
-  /**
-   * Get count of registered instances
-   */
-  count() {
-    return this.instances.size;
-  }
-}
-
-// Singleton instance
-const mmkvInstanceRegistry = exports.mmkvInstanceRegistry = new MMKVInstanceRegistry();
-
-/**
- * Register an MMKV instance with React Buoy DevTools for monitoring and debugging.
- *
- * **⚠️ REQUIRED**: Manual registration is required for `react-native-mmkv` v4.
- * Auto-detection is not possible due to Metro bundler and ES6 module limitations.
- *
- * Call this function immediately after creating each MMKV instance you want to monitor.
- * The DevTools will then be able to:
- * - Display all keys and values
- * - Show real-time updates when data changes
- * - Allow editing values directly from the DevTools
- * - Track storage size and performance
- *
- * @param id - Unique identifier for this MMKV instance. Should match the `id` you used when creating the instance.
- * @param instance - The MMKV instance returned from `createMMKV()`
- * @param config - Optional configuration
- * @param config.encrypted - Set to `true` if this instance uses encryption (has an `encryptionKey`)
- *
- * @example
- * **Basic usage:**
- * ```typescript
- * import { createMMKV } from 'react-native-mmkv';
- * import { registerMMKVInstance } from '@buoy-gg/storage';
- *
- * // Create and register default instance
- * export const storage = createMMKV({ id: 'mmkv.default' });
- * registerMMKVInstance('mmkv.default', storage);
- * ```
- *
- * @example
- * **With encryption:**
- * ```typescript
- * import { createMMKV } from 'react-native-mmkv';
- * import { registerMMKVInstance } from '@buoy-gg/storage';
- *
- * // Create encrypted instance
- * export const secureStorage = createMMKV({
- *   id: 'secure-storage',
- *   encryptionKey: 'my-encryption-key'
- * });
- *
- * // Register with encrypted flag
- * registerMMKVInstance('secure-storage', secureStorage, { encrypted: true });
- * ```
- *
- * @example
- * **Multiple instances:**
- * ```typescript
- * import { createMMKV } from 'react-native-mmkv';
- * import { registerMMKVInstance } from '@buoy-gg/storage';
- *
- * // User preferences
- * export const userPrefs = createMMKV({ id: 'user-prefs' });
- * registerMMKVInstance('user-prefs', userPrefs);
- *
- * // Cache
- * export const cache = createMMKV({ id: 'cache' });
- * registerMMKVInstance('cache', cache);
- *
- * // Auth (encrypted)
- * export const auth = createMMKV({ id: 'auth', encryptionKey: 'key' });
- * registerMMKVInstance('auth', auth, { encrypted: true });
- * ```
- *
- * @public
- * @since 1.0.0
- */
-function registerMMKVInstance(id, instance, config) {
-  // Register in registry
-  mmkvInstanceRegistry.register(id, instance, config);
-
-  // Add listener for real-time monitoring (CRITICAL: enables event emission)
-  // v4: Use ONLY native listener (addOnValueChangedListener), skip method wrapping
-  _MMKVListener.mmkvListener.addInstance(instance, id);
-}
-
-/**
- * Unregister an MMKV instance from DevTools monitoring.
- *
- * This stops the DevTools from tracking changes to this instance.
- * Typically not needed unless you're dynamically creating/destroying instances.
- *
- * @param id - The instance ID to unregister
- *
- * @example
- * ```typescript
- * unregisterMMKVInstance('cache');
- * ```
- *
- * @public
- * @since 1.0.0
- */
-function unregisterMMKVInstance(id) {
-  // Remove listener first
-  _MMKVListener.mmkvListener.removeInstance(id);
-
-  // Then remove from registry
-  mmkvInstanceRegistry.unregister(id);
-}
+"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.mmkvInstanceRegistry=void 0;exports.registerMMKVInstance=registerMMKVInstance;exports.unregisterMMKVInstance=unregisterMMKVInstance;var _MMKVListener=require("./MMKVListener");class MMKVInstanceRegistry{instances=new Map;register(e,t,n){const r={id:e,instance:t,encrypted:n?.encrypted??false,readOnly:t.isReadOnly??false};this.instances.set(e,r)}unregister(e){this.instances.delete(e)}get(e){return this.instances.get(e)}getAll(){return Array.from(this.instances.values())}has(e){return this.instances.has(e)}count(){return this.instances.size}}const mmkvInstanceRegistry=exports.mmkvInstanceRegistry=new MMKVInstanceRegistry;function registerMMKVInstance(s,e,t){mmkvInstanceRegistry.register(s,e,t);_MMKVListener.mmkvListener.addInstance(e,s)}function unregisterMMKVInstance(s){_MMKVListener.mmkvListener.removeInstance(s);mmkvInstanceRegistry.unregister(s)}