@nlabs/arkhamjs-storage-native 3.29.2 → 3.30.0

package/README.md

@@ -1,5 +1,7 @@
 # @nlabs/arkhamjs-storage-native
 
+> **React Native Storage Integration for ArkhamJS** - Seamless AsyncStorage persistence with automatic state synchronization, compression, and encryption support for React Native applications.
+
 [![npm version](https://img.shields.io/npm/v/@nlabs/arkhamjs-storage-native.svg?style=flat-square)](https://www.npmjs.com/package/@nlabs/arkhamjs-storage-native)
 [![npm downloads](https://img.shields.io/npm/dm/@nlabs/arkhamjs-storage-native.svg?style=flat-square)](https://www.npmjs.com/package/@nlabs/arkhamjs-storage-native)
 [![Travis](https://img.shields.io/travis/nitrogenlabs/arkhamjs.svg?style=flat-square)](https://travis-ci.org/nitrogenlabs/arkhamjs)
@@ -8,14 +10,441 @@
 [![MIT license](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](http://opensource.org/licenses/MIT)
 [![Chat](https://img.shields.io/discord/446122412715802649.svg)](https://discord.gg/Ttgev58)
 
-## Installation
+## 🚀 Features
+
+- **📱 React Native Optimized** - Built specifically for React Native AsyncStorage
+- **💾 Automatic Persistence** - State automatically persists across app sessions
+- **🔄 Real-Time Sync** - State changes are immediately saved to AsyncStorage
+- **🎯 Selective Persistence** - Choose which parts of state to persist
+- **⚡ Performance Optimized** - Debounced writes and efficient serialization
+- **🔒 Encryption Support** - Optional encryption for sensitive data
+- **🗜️ Compression** - Automatic compression for large state objects
+- **🔧 Configurable** - Extensive options for customization
+- **🌲 Tree-shakable** - Only include what you need
+
+## 📦 Installation
+
+```bash
+npm install @nlabs/arkhamjs-storage-native
+```
+
+**Peer Dependencies:**
+
+- `react-native` (any version)
+- `@react-native-async-storage/async-storage` (for React Native 0.60+)
+
+## 🎯 Quick Start
+
+### **Basic Setup**
+
+```js
+import { Flux } from '@nlabs/arkhamjs';
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+// Initialize Flux with native storage
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore, CartStore],
+  storage: NativeStorage, // Enable AsyncStorage persistence
+  storageWait: 300 // Debounce storage updates by 300ms
+});
+
+// State will automatically persist across app sessions
+Flux.dispatch({ type: 'ADD_USER', user: { name: 'John' } });
+// User data is now saved to AsyncStorage
+```
+
+### **Storage Types**
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+// Use AsyncStorage (persists across app sessions)
+const asyncStorage = NativeStorage.async;
+
+// Use custom storage implementation
+const customStorage = NativeStorage.create({
+  getItem: (key) => customGet(key),
+  setItem: (key, value) => customSet(key, value),
+  removeItem: (key) => customRemove(key)
+});
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  storage: asyncStorage, // or customStorage
+});
+```
+
+## 🔧 Configuration Options
+
+### **Basic Configuration**
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  storage: NativeStorage,
+
+  // Storage options
+  storageWait: 300,              // Debounce storage updates (ms)
+  storageDebounce: true,         // Enable debouncing
+  storageThrottle: false,        // Use throttling instead of debouncing
+
+  // Persistence options
+  storagePersist: true,          // Enable persistence
+  storageRestore: true,          // Restore state on initialization
+  storageClear: false,           // Clear storage on initialization
+
+  // Data options
+  storageSerialize: true,        // Serialize data before storage
+  storageCompress: false,        // Compress data before storage
+  storageEncrypt: false,         // Encrypt data before storage
+
+  // Key options
+  storageKey: 'arkhamjs-state',  // Storage key prefix
+  storageNamespace: 'my-app',    // Namespace for storage keys
+});
+```
+
+### **Advanced Configuration**
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  storage: NativeStorage,
+
+  // Selective persistence
+  storagePaths: [
+    'user.current',    // Only persist current user
+    'user.preferences', // Only persist user preferences
+    'cart.items'       // Only persist cart items
+  ],
+
+  // Exclude sensitive data
+  storageExclude: [
+    'user.password',   // Don't persist passwords
+    'auth.token',      // Don't persist auth tokens
+    'temp.*'           // Don't persist temporary data
+  ],
+
+  // Custom serialization
+  storageSerialize: (state) => {
+    // Custom serialization logic
+    return JSON.stringify(state, (key, value) => {
+      if (key === 'password') return undefined; // Remove passwords
+      if (key === 'token') return undefined;    // Remove tokens
+      return value;
+    });
+  },
+
+  // Custom deserialization
+  storageDeserialize: (data) => {
+    // Custom deserialization logic
+    const state = JSON.parse(data);
+    // Add default values or transform data
+    return state;
+  },
+
+  // Storage events
+  storageEvents: {
+    onSave: (key, value) => {
+      console.log(`Saved to AsyncStorage: ${key}`);
+    },
+    onLoad: (key, value) => {
+      console.log(`Loaded from AsyncStorage: ${key}`);
+    },
+    onError: (error) => {
+      console.error('Storage error:', error);
+    }
+  }
+});
+```
+
+## 🎨 Storage Features
+
+### **Automatic State Persistence**
+
+State automatically persists across app sessions:
+
+```js
+// User logs in
+Flux.dispatch({ type: 'USER_LOGIN', user: { id: 1, name: 'John' } });
+
+// User closes app and reopens
+// State is automatically restored from AsyncStorage
+const user = Flux.getState('user.current'); // { id: 1, name: 'John' }
+```
+
+### **Selective Persistence**
+
+Choose which parts of state to persist:
+
+```js
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  storage: NativeStorage,
+
+  // Only persist specific paths
+  storagePaths: [
+    'user.current',      // Persist current user
+    'user.preferences',  // Persist user preferences
+    'cart.items',        // Persist cart items
+    'ui.theme'           // Persist UI theme
+  ],
+
+  // Exclude sensitive or temporary data
+  storageExclude: [
+    'user.password',     // Don't persist passwords
+    'auth.token',        // Don't persist auth tokens
+    'temp.*',            // Don't persist temporary data
+    'ui.loading'         // Don't persist loading states
+  ]
+});
+```
+
+### **Data Compression**
+
+Compress large state objects to save storage space:
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  storage: NativeStorage,
 
-Using [npm](https://www.npmjs.com/):
+  // Enable compression for large state objects
+  storageCompress: true,
+  storageCompressThreshold: 1024, // Compress if >1KB
 
-```shell
-npm install --save @nlabs/arkhamjs-storage-native
+  // Custom compression
+  storageCompress: (data) => {
+    // Use custom compression library
+    return customCompress(data);
+  },
+
+  // Custom decompression
+  storageDecompress: (data) => {
+    // Use custom decompression library
+    return customDecompress(data);
+  }
+});
+```
+
+### **Data Encryption**
+
+Encrypt sensitive data before storage:
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  storage: NativeStorage,
+
+  // Enable encryption
+  storageEncrypt: true,
+  storageEncryptKey: 'your-secret-key',
+
+  // Custom encryption
+  storageEncrypt: (data, key) => {
+    // Use custom encryption library
+    return customEncrypt(data, key);
+  },
+
+  // Custom decryption
+  storageDecrypt: (data, key) => {
+    // Use custom decryption library
+    return customDecrypt(data, key);
+  }
+});
 ```
 
-## Documentation
+## 🔍 Advanced Usage
+
+### **Custom Storage Implementation**
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+import AsyncStorage from '@react-native-async-storage/async-storage';
+
+// Create custom storage adapter
+const customStorage = NativeStorage.create({
+  // Required methods
+  getItem: async (key) => {
+    // Custom get implementation
+    return await AsyncStorage.getItem(key);
+  },
+
+  setItem: async (key, value) => {
+    // Custom set implementation
+    await AsyncStorage.setItem(key, value);
+  },
+
+  removeItem: async (key) => {
+    // Custom remove implementation
+    await AsyncStorage.removeItem(key);
+  },
+
+  // Optional methods
+  clear: async () => {
+    // Custom clear implementation
+    await AsyncStorage.clear();
+  },
+
+  getAllKeys: async () => {
+    // Custom getAllKeys implementation
+    return await AsyncStorage.getAllKeys();
+  }
+});
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  storage: customStorage
+});
+```
+
+### **Storage Migration**
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore],
+  storage: NativeStorage,
+
+  // Storage migration
+  storageMigrate: (oldData, newData) => {
+    // Migrate from old format to new format
+    if (oldData.version === 1) {
+      return {
+        ...newData,
+        user: {
+          ...newData.user,
+          // Migrate old user format
+          current: oldData.user ? { ...oldData.user, id: oldData.user.id || 1 } : null
+        }
+      };
+    }
+    return newData;
+  },
+
+  // Version tracking
+  storageVersion: 2,
+
+  // Migration events
+  storageEvents: {
+    onMigrate: (oldVersion, newVersion) => {
+      console.log(`Migrated from v${oldVersion} to v${newVersion}`);
+    }
+  }
+});
+```
+
+## 🎯 Use Cases
+
+### **User Preferences Persistence**
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+Flux.init({
+  name: 'my-app',
+  stores: [UserStore, PreferencesStore],
+  storage: NativeStorage,
+
+  // Only persist user preferences
+  storagePaths: [
+    'user.preferences.theme',
+    'user.preferences.language',
+    'user.preferences.notifications',
+    'ui.sidebar.collapsed'
+  ]
+});
+
+// User preferences will persist across app sessions
+Flux.dispatch({ type: 'SET_THEME', theme: 'dark' });
+// Theme preference is automatically saved
+```
+
+### **Shopping Cart Persistence**
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+Flux.init({
+  name: 'my-app',
+  stores: [CartStore],
+  storage: NativeStorage,
+
+  // Persist cart items
+  storagePaths: ['cart.items', 'cart.total'],
+
+  // Don't persist temporary cart state
+  storageExclude: ['cart.loading', 'cart.error']
+});
+
+// Cart items persist if user closes app
+Flux.dispatch({ type: 'CART_ADD', item: { id: 1, name: 'Product' } });
+// Cart is automatically saved
+```
+
+### **Form Data Persistence**
+
+```js
+import { NativeStorage } from '@nlabs/arkhamjs-storage-native';
+
+Flux.init({
+  name: 'my-app',
+  stores: [FormStore],
+  storage: NativeStorage,
+
+  // Persist form data with short debounce
+  storageWait: 100,
+  storagePaths: ['form.draft'],
+
+  // Clear form data on successful submission
+  storageEvents: {
+    onAction: (action) => {
+      if (action.type === 'FORM_SUBMIT_SUCCESS') {
+        // Clear draft data
+        AsyncStorage.removeItem('arkhamjs-state-form.draft');
+      }
+    }
+  }
+});
+
+// Form data is automatically saved as user types
+// Prevents data loss if user accidentally closes app
+```
+
+## 🔗 Related Packages
+
+- **[@nlabs/arkhamjs](./arkhamjs/README.md)** - Core Flux framework
+- **[@nlabs/arkhamjs-storage-browser](./arkhamjs-storage-browser/README.md)** - Browser storage
+- **[@nlabs/arkhamjs-storage-node](./arkhamjs-storage-node/README.md)** - Node.js storage
+
+## 📚 Documentation
+
+For detailed documentation and examples, visit [arkhamjs.io](https://arkhamjs.io).
+
+## 🤝 Community & Support
+
+- **💬 [Discord Community](https://discord.gg/Ttgev58)** - Chat with other developers
+- **🐛 [GitHub Issues](https://github.com/nitrogenlabs/arkhamjs/issues)** - Report bugs and request features
+- **📖 [Documentation](https://arkhamjs.io)** - Complete API reference
+
+## 📄 License
 
-For detailed [Documentation](https://arkhamjs.io) and additional options.
+MIT License - see [LICENSE](../LICENSE) file for details.

package/lib/NativeStorage/NativeStorage.d.ts

@@ -0,0 +1,10 @@
+import { NativeStorageOptions } from './NativeStorage.types';
+export declare class NativeStorage {
+    private options;
+    constructor(options?: NativeStorageOptions);
+    static delAsyncData(key: string): Promise<boolean>;
+    static getAsyncData(key: string): Promise<any>;
+    static setAsyncData(key: string, value: any): Promise<boolean>;
+    getStorageData(key: string): Promise<any>;
+    setStorageData(key: string, value: any): Promise<boolean>;
+}

package/lib/NativeStorage/NativeStorage.js

@@ -0,0 +1,2 @@
+var l=Object.create;var o=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var m=Object.getOwnPropertyNames;var u=Object.getPrototypeOf,h=Object.prototype.hasOwnProperty;var p=(r,t)=>{for(var e in t)o(r,e,{get:t[e],enumerable:!0})},c=(r,t,e,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let s of m(t))!h.call(r,s)&&s!==e&&o(r,s,{get:()=>t[s],enumerable:!(a=g(t,s))||a.enumerable});return r};var y=(r,t,e)=>(e=r!=null?l(u(r)):{},c(t||!r||!r.__esModule?o(e,"default",{value:r,enumerable:!0}):e,r)),P=r=>c(o({},"__esModule",{value:!0}),r);var d={};p(d,{NativeStorage:()=>i});module.exports=P(d);var n=y(require("@react-native-async-storage/async-storage"),1);class i{constructor(t={}){this.options={};this.getStorageData=this.getStorageData.bind(this),this.setStorageData=this.setStorageData.bind(this),this.options={...this.options,...t}}static delAsyncData(t){try{return n.default.removeItem(t).then(()=>Promise.resolve(!0)).catch(()=>Promise.resolve(!1))}catch{return Promise.resolve(!1)}}static getAsyncData(t){try{return n.default.getItem(t).then(e=>e?JSON.parse(e):null).catch(()=>Promise.resolve(null))}catch{return Promise.resolve(null)}}static setAsyncData(t,e){const a=e!==void 0&&JSON.stringify(e);try{return n.default.setItem(t,a).then(()=>!0).catch(()=>Promise.resolve(!1))}catch{return Promise.resolve(!1)}}getStorageData(t){return i.getAsyncData(t)}setStorageData(t,e){return i.setAsyncData(t,e)}}0&&(module.exports={NativeStorage});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vc3JjL05hdGl2ZVN0b3JhZ2UvTmF0aXZlU3RvcmFnZS50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiLyoqXG4gKiBDb3B5cmlnaHQgKGMpIDIwMTgtUHJlc2VudCwgTml0cm9nZW4gTGFicywgSW5jLlxuICogQ29weXJpZ2h0cyBsaWNlbnNlZCB1bmRlciB0aGUgTUlUIExpY2Vuc2UuIFNlZSB0aGUgYWNjb21wYW55aW5nIExJQ0VOU0UgZmlsZSBmb3IgdGVybXMuXG4gKi9cbmltcG9ydCBBc3luY1N0b3JhZ2UgZnJvbSAnQHJlYWN0LW5hdGl2ZS1hc3luYy1zdG9yYWdlL2FzeW5jLXN0b3JhZ2UnO1xuXG5pbXBvcnQge05hdGl2ZVN0b3JhZ2VPcHRpb25zfSBmcm9tICcuL05hdGl2ZVN0b3JhZ2UudHlwZXMnO1xuXG5leHBvcnQgY2xhc3MgTmF0aXZlU3RvcmFnZSB7XG4gIHByaXZhdGUgb3B0aW9uczogTmF0aXZlU3RvcmFnZU9wdGlvbnMgPSB7fTtcblxuICBjb25zdHJ1Y3RvcihvcHRpb25zOiBOYXRpdmVTdG9yYWdlT3B0aW9ucyA9IHt9KSB7XG4gICAgLy8gTWV0aG9kc1xuICAgIHRoaXMuZ2V0U3RvcmFnZURhdGEgPSB0aGlzLmdldFN0b3JhZ2VEYXRhLmJpbmQodGhpcyk7XG4gICAgdGhpcy5zZXRTdG9yYWdlRGF0YSA9IHRoaXMuc2V0U3RvcmFnZURhdGEuYmluZCh0aGlzKTtcblxuICAgIC8vIENvbmZpZ3VyYXRpb25cbiAgICB0aGlzLm9wdGlvbnMgPSB7Li4udGhpcy5vcHRpb25zLCAuLi5vcHRpb25zfTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZW1vdmVzIGEga2V5IGZyb20gQXN5bmNTdG9yYWdlLlxuICAgKlxuICAgKiBAcGFyYW0ge3N0cmluZ30ga2V5IEtleSBhc3NvY2lhdGVkIHdpdGggdGhlIGRhdGEgdG8gcmVtb3ZlLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxib29sZWFuPn0gV2hldGhlciBkYXRhIHdhcyBzdWNjZXNzZnVsbHkgcmVtb3ZlZC5cbiAgICovXG4gIHN0YXRpYyBkZWxBc3luY0RhdGEoa2V5OiBzdHJpbmcpOiBQcm9taXNlPGJvb2xlYW4+IHtcbiAgICB0cnkge1xuICAgICAgcmV0dXJuIEFzeW5jU3RvcmFnZS5yZW1vdmVJdGVtKGtleSlcbiAgICAgICAgLnRoZW4oKCkgPT4gUHJvbWlzZS5yZXNvbHZlKHRydWUpKVxuICAgICAgICAuY2F0Y2goKCkgPT4gUHJvbWlzZS5yZXNvbHZlKGZhbHNlKSk7XG4gICAgfSBjYXRjaChlcnJvcikge1xuICAgICAgcmV0dXJuIFByb21pc2UucmVzb2x2ZShmYWxzZSk7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIEdldCBhIGtleSB2YWx1ZSBmcm9tIEFzeW5jU3RvcmFnZS5cbiAgICpcbiAgICogQHBhcmFtIHtzdHJpbmd9IGtleSBUaGUga2V5IGZvciBkYXRhLlxuICAgKiBAcmV0dXJucyB7UHJvbWlzZTxhbnk+fSB0aGUgZGF0YSBvYmplY3QgYXNzb2NpYXRlZCB3aXRoIHRoZSBrZXkuXG4gICAqL1xuICBzdGF0aWMgZ2V0QXN5bmNEYXRhKGtleTogc3RyaW5nKTogUHJvbWlzZTxhbnk+IHtcbiAgICB0cnkge1xuICAgICAgcmV0dXJuIEFzeW5jU3RvcmFnZS5nZXRJdGVtKGtleSlcbiAgICAgICAgLnRoZW4oKHZhbHVlOiBzdHJpbmcpID0+IHtcbiAgICAgICAgICBjb25zdCB1cGRhdGVkVmFsdWUgPSB2YWx1ZSA/IEpTT04ucGFyc2UodmFsdWUpIDogbnVsbDtcbiAgICAgICAgICByZXR1cm4gdXBkYXRlZFZhbHVlO1xuICAgICAgICB9KVxuICAgICAgICAuY2F0Y2goKCkgPT4gUHJvbWlzZS5yZXNvbHZlKG51bGwpKTtcbiAgICB9IGNhdGNoKGVycm9yKSB7XG4gICAgICByZXR1cm4gUHJvbWlzZS5yZXNvbHZlKG51bGwpO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBTYXZlcyBkYXRhIHRvIEFzeW5jU3RvcmFnZS5cbiAgICpcbiAgICogQHBhcmFtIHtzdHJpbmd9IGtleSBLZXkgdG8gc3RvcmUgZGF0YS5cbiAgICogQHBhcmFtIHthbnl9IHZhbHVlIERhdGEgdG8gc3RvcmUuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPGJvb2xlYW4+fSBXaGV0aGVyIGRhdGEgd2FzIHN1Y2Nlc3NmdWxseSBzYXZlZC5cbiAgICovXG4gIHN0YXRpYyBzZXRBc3luY0RhdGEoa2V5OiBzdHJpbmcsIHZhbHVlKTogUHJvbWlzZTxib29sZWFuPiB7XG4gICAgY29uc3QgdXBkYXRlZFZhbHVlID0gdmFsdWUgIT09IHVuZGVmaW5lZCAmJiBKU09OLnN0cmluZ2lmeSh2YWx1ZSk7XG5cbiAgICB0cnkge1xuICAgICAgcmV0dXJuIEFzeW5jU3RvcmFnZS5zZXRJdGVtKGtleSwgdXBkYXRlZFZhbHVlKVxuICAgICAgICAudGhlbigoKSA9PiB0cnVlKVxuICAgICAgICAuY2F0Y2goKCkgPT4gUHJvbWlzZS5yZXNvbHZlKGZhbHNlKSk7XG4gICAgfSBjYXRjaChlcnJvcikge1xuICAgICAgcmV0dXJuIFByb21pc2UucmVzb2x2ZShmYWxzZSk7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIEdldCBhIGtleSB2YWx1ZSBmcm9tIHN0b3JhZ2UuXG4gICAqXG4gICAqIEBwYXJhbSB7c3RyaW5nfSBrZXkgVGhlIGtleSBmb3IgZGF0YS5cbiAgICogQHJldHVybnMge1Byb21pc2U8YW55Pn0gdGhlIGRhdGEgb2JqZWN0IGFzc29jaWF0ZWQgd2l0aCB0aGUga2V5LlxuICAgKi9cbiAgZ2V0U3RvcmFnZURhdGEoa2V5OiBzdHJpbmcpOiBQcm9taXNlPGFueT4ge1xuICAgIHJldHVybiBOYXRpdmVTdG9yYWdlLmdldEFzeW5jRGF0YShrZXkpO1xuICB9XG5cbiAgLyoqXG4gICAqIFNhdmVzIGRhdGEgdG8gc3RvcmFnZS5cbiAgICpcbiAgICogQHBhcmFtIHtzdHJpbmd9IGtleSBLZXkgdG8gc3RvcmUgZGF0YS5cbiAgICogQHBhcmFtIHthbnl9IHZhbHVlIERhdGEgdG8gc3RvcmUuXG4gICAqIEByZXR1cm5zIHtQcm9taXNlPGJvb2xlYW4+fSBXaGV0aGVyIGRhdGEgd2FzIHN1Y2Nlc3NmdWxseSBzYXZlZC5cbiAgICovXG4gIHNldFN0b3JhZ2VEYXRhKGtleTogc3RyaW5nLCB2YWx1ZSk6IFByb21pc2U8Ym9vbGVhbj4ge1xuICAgIHJldHVybiBOYXRpdmVTdG9yYWdlLnNldEFzeW5jRGF0YShrZXksIHZhbHVlKTtcbiAgfVxufVxuIl0sCiAgIm1hcHBpbmdzIjogIjZpQkFBQSxJQUFBQSxFQUFBLEdBQUFDLEVBQUFELEVBQUEsbUJBQUFFLElBQUEsZUFBQUMsRUFBQUgsR0FJQSxJQUFBSSxFQUF5QiwwREFJbEIsTUFBTUYsQ0FBYyxDQUd6QixZQUFZRyxFQUFnQyxDQUFDLEVBQUcsQ0FGaEQsS0FBUSxRQUFnQyxDQUFDLEVBSXZDLEtBQUssZUFBaUIsS0FBSyxlQUFlLEtBQUssSUFBSSxFQUNuRCxLQUFLLGVBQWlCLEtBQUssZUFBZSxLQUFLLElBQUksRUFHbkQsS0FBSyxRQUFVLENBQUMsR0FBRyxLQUFLLFFBQVMsR0FBR0EsQ0FBTyxDQUM3QyxDQVFBLE9BQU8sYUFBYUMsRUFBK0IsQ0FDakQsR0FBSSxDQUNGLE9BQU8sRUFBQUMsUUFBYSxXQUFXRCxDQUFHLEVBQy9CLEtBQUssSUFBTSxRQUFRLFFBQVEsRUFBSSxDQUFDLEVBQ2hDLE1BQU0sSUFBTSxRQUFRLFFBQVEsRUFBSyxDQUFDLENBQ3ZDLE1BQWUsQ0FDYixPQUFPLFFBQVEsUUFBUSxFQUFLLENBQzlCLENBQ0YsQ0FRQSxPQUFPLGFBQWFBLEVBQTJCLENBQzdDLEdBQUksQ0FDRixPQUFPLEVBQUFDLFFBQWEsUUFBUUQsQ0FBRyxFQUM1QixLQUFNRSxHQUNnQkEsRUFBUSxLQUFLLE1BQU1BLENBQUssRUFBSSxJQUVsRCxFQUNBLE1BQU0sSUFBTSxRQUFRLFFBQVEsSUFBSSxDQUFDLENBQ3RDLE1BQWUsQ0FDYixPQUFPLFFBQVEsUUFBUSxJQUFJLENBQzdCLENBQ0YsQ0FTQSxPQUFPLGFBQWFGLEVBQWFFLEVBQXlCLENBQ3hELE1BQU1DLEVBQWVELElBQVUsUUFBYSxLQUFLLFVBQVVBLENBQUssRUFFaEUsR0FBSSxDQUNGLE9BQU8sRUFBQUQsUUFBYSxRQUFRRCxFQUFLRyxDQUFZLEVBQzFDLEtBQUssSUFBTSxFQUFJLEVBQ2YsTUFBTSxJQUFNLFFBQVEsUUFBUSxFQUFLLENBQUMsQ0FDdkMsTUFBZSxDQUNiLE9BQU8sUUFBUSxRQUFRLEVBQUssQ0FDOUIsQ0FDRixDQVFBLGVBQWVILEVBQTJCLENBQ3hDLE9BQU9KLEVBQWMsYUFBYUksQ0FBRyxDQUN2QyxDQVNBLGVBQWVBLEVBQWFFLEVBQXlCLENBQ25ELE9BQU9OLEVBQWMsYUFBYUksRUFBS0UsQ0FBSyxDQUM5QyxDQUNGIiwKICAibmFtZXMiOiBbIk5hdGl2ZVN0b3JhZ2VfZXhwb3J0cyIsICJfX2V4cG9ydCIsICJOYXRpdmVTdG9yYWdlIiwgIl9fdG9Db21tb25KUyIsICJpbXBvcnRfYXN5bmNfc3RvcmFnZSIsICJvcHRpb25zIiwgImtleSIsICJBc3luY1N0b3JhZ2UiLCAidmFsdWUiLCAidXBkYXRlZFZhbHVlIl0KfQo=

package/lib/NativeStorage/NativeStorage.types.d.ts

@@ -0,0 +1,2 @@
+export interface NativeStorageOptions {
+}

package/lib/NativeStorage/NativeStorage.types.js

@@ -0,0 +1,2 @@
+var o=Object.defineProperty;var n=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var c=Object.prototype.hasOwnProperty;var f=(t,e,r,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let a of p(e))!c.call(t,a)&&a!==r&&o(t,a,{get:()=>e[a],enumerable:!(i=n(e,a))||i.enumerable});return t};var g=t=>f(o({},"__esModule",{value:!0}),t);var s={};module.exports=g(s);
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vLi4vc3JjL05hdGl2ZVN0b3JhZ2UvTmF0aXZlU3RvcmFnZS50eXBlcy50cyJdLAogICJzb3VyY2VzQ29udGVudCI6IFsiZXhwb3J0IGludGVyZmFjZSBOYXRpdmVTdG9yYWdlT3B0aW9ucyB7fVxuIl0sCiAgIm1hcHBpbmdzIjogImtXQUFBLElBQUFBLEVBQUEsa0JBQUFDLEVBQUFEIiwKICAibmFtZXMiOiBbIk5hdGl2ZVN0b3JhZ2VfdHlwZXNfZXhwb3J0cyIsICJfX3RvQ29tbW9uSlMiXQp9Cg==

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+import { NativeStorage } from './NativeStorage/NativeStorage';
+export * from './NativeStorage/NativeStorage.types';
+export { NativeStorage };

package/lib/index.js

@@ -0,0 +1,2 @@
+var f=Object.defineProperty;var g=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var N=Object.prototype.hasOwnProperty;var S=(r,o)=>{for(var t in o)f(r,t,{get:o[t],enumerable:!0})},a=(r,o,t,i)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of v(o))!N.call(r,e)&&e!==t&&f(r,e,{get:()=>o[e],enumerable:!(i=g(o,e))||i.enumerable});return r},p=(r,o,t)=>(a(r,o,"default"),t&&a(t,o,"default"));var b=r=>a(f({},"__esModule",{value:!0}),r);var m={};S(m,{NativeStorage:()=>x.NativeStorage});module.exports=b(m);var x=require("./NativeStorage/NativeStorage");p(m,require("./NativeStorage/NativeStorage.types"),module.exports);0&&(module.exports={NativeStorage,...require("./NativeStorage/NativeStorage.types")});
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFsiLi4vc3JjL2luZGV4LnRzIl0sCiAgInNvdXJjZXNDb250ZW50IjogWyIvKipcbiAqIENvcHlyaWdodCAoYykgMjAxOC1QcmVzZW50LCBOaXRyb2dlbiBMYWJzLCBJbmMuXG4gKiBDb3B5cmlnaHRzIGxpY2Vuc2VkIHVuZGVyIHRoZSBNSVQgTGljZW5zZS4gU2VlIHRoZSBhY2NvbXBhbnlpbmcgTElDRU5TRSBmaWxlIGZvciB0ZXJtcy5cbiAqL1xuaW1wb3J0IHtOYXRpdmVTdG9yYWdlfSBmcm9tICcuL05hdGl2ZVN0b3JhZ2UvTmF0aXZlU3RvcmFnZSc7XG5cblxuLy8gU3RvcmFnZVxuZXhwb3J0ICogZnJvbSAnLi9OYXRpdmVTdG9yYWdlL05hdGl2ZVN0b3JhZ2UudHlwZXMnO1xuXG5leHBvcnQge05hdGl2ZVN0b3JhZ2V9O1xuIl0sCiAgIm1hcHBpbmdzIjogIjhjQUFBLElBQUFBLEVBQUEsR0FBQUMsRUFBQUQsRUFBQSxvREFBQUUsRUFBQUYsR0FJQSxJQUFBRyxFQUE0Qix5Q0FJNUJDLEVBQUFKLEVBQWMsK0NBUmQiLAogICJuYW1lcyI6IFsiaW5kZXhfZXhwb3J0cyIsICJfX2V4cG9ydCIsICJfX3RvQ29tbW9uSlMiLCAiaW1wb3J0X05hdGl2ZVN0b3JhZ2UiLCAiX19yZUV4cG9ydCJdCn0K

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nlabs/arkhamjs-storage-native",
-  "version": "3.29.2",
+  "version": "3.30.0",
   "publishConfig": {
     "access": "public"
   },
@@ -31,33 +31,39 @@
     "url": "https://github.com/nitrogenlabs/arkhamjs/issues"
   },
   "scripts": {
-    "build": "lex compile",
+    "build": "lex compile --remove",
     "clean": "lex clean",
     "deploy": "lex build --remove && s3-deploy './lib/static/**' --cwd './lib/static/' --region us-east-1 --bucket arkhamjs.io/versions --gzip",
-    "lint": "eslint ./src --ext .ts,.tsx",
+    "lint": "lex lint --fix",
     "prepublishOnly": "npm run build",
     "publish:major": "npm version major && npm publish",
     "publish:minor": "npm version minor && npm publish",
     "publish:patch": "npm version patch && npm publish",
     "pretest": "npm run lint",
     "test": "lex test",
-    "update": "npm-check-updates --interactive"
+    "update": "lex update --interactive"
   },
   "peerDependencies": {
     "@nlabs/arkhamjs": "^3.26.0",
-    "react": "^18.0.0 || ^19.0.0"
+    "react": "*"
+  },
+  "dependencies": {
+    "@react-native-async-storage/async-storage": "^2.2.0"
   },
   "devDependencies": {
     "@nlabs/arkhamjs": "*",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^22.13.1",
-    "eslint": "^9.19.0",
-    "eslint-config-styleguidejs": "^3.2.1",
-    "lodash": "^4.17.21",
-    "typescript": "^5.7.3"
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.0.10",
+    "typescript": "^5.8.3"
   },
+  "files": [
+    "lib",
+    "index.js",
+    "index.d.ts",
+    "LICENSE",
+    "package.json",
+    "README.md"
+  ],
   "gitHead": "fc371e1e28fe0ae35d40d29a217d5f0e990ec32a",
-  "dependencies": {
-    "@react-native-async-storage/async-storage": "^2.1.1"
-  }
+  "type": "module"
 }