memorio - npm Package Compare versions

Comparing version 2.5.2 to 2.5.3

docs/CACHE.md

+# Cache - Memorio
+
+Cache provides in-memory storage with a simple API. Data is lost on page refresh.
+
+## Installation
+
+```bash
+npm install memorio
+```
+
+```javascript
+import 'memorio';
+```
+
+---
+
+## Quick Examples
+
+### Example 1: Basic Usage
+
+```javascript
+// Save data
+cache.set('username', 'Mario');
+cache.set('score', 1500);
+
+// Read data
+console.log(cache.get('username')); // "Mario"
+console.log(cache.get('score'));    // 1500
+```
+
+### Example 2: Intermediate
+
+```javascript
+// Store objects
+cache.set('user', { name: 'Luigi', level: 5 });
+const user = cache.get('user');
+console.log(user.name); // "Luigi"
+
+// Remove single item
+cache.remove('username');
+
+// Clear all cache
+cache.removeAll();
+```
+
+---
+
+## API Reference
+
+### Methods
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `cache.get(name)` | `name: string` | `any` | Get value from cache |
+| `cache.set(name, value)` | `name: string, value: any` | `void` | Save value to cache |
+| `cache.remove(name)` | `name: string` | `boolean` | Remove single item |
+| `cache.removeAll()` | `none` | `boolean` | Clear all cache |
+
+---
+
+## Storage Comparison
+
+| Feature | Cache | Store | Session | IDB |
+|---------|-------|-------|---------|-----|
+| Storage | Memory | localStorage | sessionStorage | IndexedDB |
+| Lifetime | Until refresh | Forever | Until tab closes | Forever |
+| Capacity | Unlimited | ~5-10 MB | ~5-10 MB | 50+ MB |
+| Use case | Temporary data | User preferences | Auth tokens | Large data |
+
+---
+
+## Best Practices
+
+1. Use for temporary data that doesn't need persistence
+2. Great for computed values or API response caching
+3. Data is lost on page refresh - don't use for important data
+4. Clear with `cache.removeAll()` when no longer needed

docs/DEVTOOLS.md

+# Memorio DevTools
+
+Browser console debugging tools for inspecting and managing Memorio state.
+
+## Quick Start
+
+```javascript
+// Load memorio first
+import 'memorio'
+```
+
+## Available Methods
+
+### inspect()
+
+Inspect all Memorio modules in the console.
+
+```javascript
+memorio.devtools.inspect()
+```
+
+### stats()
+
+Get statistics about all modules.
+
+```javascript
+memorio.devtools.stats()
+// Returns: { stateKeys, storeKeys, sessionKeys, cacheKeys, idbDatabases, lastUpdate }
+```
+
+### clear(module)
+
+Clear data from a specific module.
+
+```javascript
+memorio.devtools.clear('state')
+memorio.devtools.clear('store')
+memorio.devtools.clear('session')
+memorio.devtools.clear('cache')
+```
+
+### clearAll()
+
+Clear all Memorio data.
+
+```javascript
+memorio.devtools.clearAll()
+```
+
+### watch(module, path)
+
+Watch a specific path for changes.
+
+```javascript
+memorio.devtools.watch('state', 'user.name')
+```
+
+### exportData()
+
+Export all data as JSON.
+
+```javascript
+const json = memorio.devtools.exportData()
+console.log(json)
+```
+
+### importData(jsonString)
+
+Import data from JSON.
+
+```javascript
+memorio.devtools.importData('{"state":{"key":"value"}}')
+```
+
+### help()
+
+Show help information.
+
+```javascript
+memorio.devtools.help()
+```
+
+## Console Shortcuts
+
+Memorio provides global shortcuts for quick access:
+
+```javascript
+$state    // globalThis.state
+$store    // globalThis.store
+$session  // globalThis.session
+$cache    // globalThis.cache
+```
+
+## Examples
+
+### Inspect current state
+
+```javascript
+memorio.devtools.inspect()
+```
+
+### Export and restore state
+
+```javascript
+// Export
+const backup = memorio.devtools.exportData()
+
+// Later... import
+memorio.devtools.importData(backup)
+```
+
+### Monitor changes
+
+```javascript
+// Watch a specific path
+memorio.devtools.watch('state', 'counter')
+
+// Now changes will be logged to console
+state.counter = 42 // Console shows: 👁 Change: state.counter = 42
+```

docs/IDB.md

+# IDB - Memorio
+
+IDB provides access to browser IndexedDB for large data storage. Unlike localStorage, IDB can store large amounts of structured data.
+
+## Installation
+
+```bash
+npm install memorio
+```
+
+```javascript
+import 'memorio';
+```
+
+---
+
+## Quick Examples
+
+### Example 1: Basic Usage
+
+```javascript
+// Create a database
+idb.db.create('myApp');
+
+// Add data
+idb.data.set('myApp', 'users', { id: 1, name: 'Mario' });
+
+// Get data
+const user = idb.data.get('myApp', 'users', 1);
+console.log(user.name); // "Mario"
+```
+
+### Example 2: Intermediate
+
+```javascript
+// Create database with tables
+idb.db.create('store');
+idb.table.create('store', 'products');
+
+// Add multiple records
+idb.data.set('store', 'products', { id: 1, name: 'Apple', price: 1.5 });
+idb.data.set('store', 'products', { id: 2, name: 'Banana', price: 0.8 });
+
+// List databases
+const databases = idb.db.list();
+console.log(databases); // ['myApp', 'store']
+```
+
+### Example 3: Advanced
+
+```javascript
+// Check database support
+if (idb.db.support()) {
+  // Use IDB
+}
+
+// Get database info
+const version = idb.db.version('store');
+const size = idb.db.size('store');
+
+// Delete database
+idb.db.delete('store');
+
+// Handle quota
+const quota = idb.db.quota();
+console.log(`Using ${quota.used} of ${quota.total} bytes`);
+```
+
+---
+
+## API Reference
+
+### Database Methods
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `idb.db.create(name)` | `name: string` | `void` | Create database |
+| `idb.db.delete(name)` | `name: string` | `void` | Delete database |
+| `idb.db.list()` | none | `string[]` | List all databases |
+| `idb.db.exist(name)` | `name: string` | `boolean` | Check if exists |
+| `idb.db.size(name)` | `name: string` | `number` | Get database size |
+| `idb.db.version(name)` | `name: string` | `number` | Get version |
+| `idb.db.support()` | none | `boolean` | Check browser support |
+| `idb.db.quota()` | none | `object` | Get storage quota |
+
+### Table Methods
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `idb.table.create(db, table)` | `db: string, table: string` | `void` | Create table |
+| `idb.table.size(db, table)` | `db: string, table: string` | `number` | Get table size |
+
+### Data Methods
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `idb.data.get(db, table, id)` | `db, table, id` | `any` | Get single record |
+| `idb.data.set(db, table, data)` | `db, table, data` | `void` | Set record |
+| `idb.data.delete(db, table, id)` | `db, table, id` | `void` | Delete record |
+
+---
+
+## Data Structure
+
+Each record needs an `id` field:
+
+```javascript
+idb.data.set('myDB', 'users', {
+  id: 1,           // Required!
+  name: 'Mario',
+  email: '[e-mail]'
+});
+```
+
+---
+
+## Storage Limits
+
+- **Desktop browsers**: 50+ MB (often unlimited)
+- **Mobile browsers**: 50-100 MB
+- **More than localStorage**: Much higher limits
+
+---
+
+## Best Practices
+
+1. Always include `id` in records
+2. Use for large data: images, caches, offline data
+3. Check support: `idb.db.support()`
+4. Clean up: `idb.db.delete('tempDB')`
+
+---
+
+## Use Cases
+
+### Offline Data
+
+```javascript
+// Cache API response
+idb.data.set('cache', 'apiResponse', {
+  id: 'users',
+  data: usersArray,
+  timestamp: Date.now()
+});
+```
+
+### Large User Data
+
+```javascript
+// Store user-generated content
+idb.data.set('app', 'uploads', {
+  id: Date.now(),
+  file: fileData,
+  userId: currentUser.id
+});
+```

docs/LOGGER.md

+# Memorio Logger
+
+Automatic logging middleware for tracking all state changes in Memorio.
+
+## Overview
+
+The logger automatically tracks all operations (set, delete, clear) across all modules:
+- State
+- Store
+- Session
+- Cache
+
+## Configuration
+
+### configure(options)
+
+Configure the logger.
+
+```javascript
+memorio.logger.configure({
+  enabled: true,           // Enable/disable logging
+  logToConsole: true,     // Log to browser console
+  customHandler: function(entry) { ... }, // Custom handler
+  modules: ['state', 'store', 'session', 'cache'], // Modules to log
+  maxEntries: 1000        // Maximum log history size
+})
+```
+
+### enable()
+
+Enable logging.
+
+```javascript
+memorio.logger.enable()
+```
+
+### disable()
+
+Disable logging.
+
+```javascript
+memorio.logger.disable()
+```
+
+## Methods
+
+### getHistory()
+
+Get all log entries.
+
+```javascript
+const history = memorio.logger.getHistory()
+// Returns array of LogEntry objects
+```
+
+### getStats()
+
+Get statistics about logged operations.
+
+```javascript
+const stats = memorio.logger.getStats()
+// Returns: { total, state, store, session, cache, set, get, delete, clear }
+```
+
+### clearHistory()
+
+Clear log history.
+
+```javascript
+memorio.logger.clearHistory()
+```
+
+### exportLogs()
+
+Export logs as JSON string.
+
+```javascript
+const json = memorio.logger.exportLogs()
+```
+
+## Log Entry Structure
+
+```javascript
+{
+  timestamp: "2026-02-18T12:00:00.000Z",
+  module: "state",
+  action: "set",
+  path: "user.name",
+  value: "John",
+  previousValue: "Jane"
+}
+```
+
+## Examples
+
+### Basic usage
+
+```javascript
+// Logging is enabled by default
+state.user = { name: 'John' }
+// Console: [Memorio:STATE] set user → value: { name: 'John' }
+```
+
+### Get statistics
+
+```javascript
+const stats = memorio.logger.getStats()
+console.log(stats)
+// { total: 15, state: 5, store: 3, session: 2, cache: 5, set: 10, get: 0, delete: 3, clear: 2 }
+```
+
+### Disable specific modules
+
+```javascript
+memorio.logger.configure({
+  modules: ['state'] // Only log state changes
+})
+```
+
+### Custom handler
+
+```javascript
+memorio.logger.configure({
+  customHandler: (entry) => {
+    // Send to analytics
+    analytics.track('memorio_change', entry)
+  }
+})
+```
+
+### Export and analyze
+
+```javascript
+// Get all logs
+const logs = memorio.logger.getHistory()
+
+// Filter by module
+const stateLogs = logs.filter(l => l.module === 'state')
+
+// Filter by action
+const setOperations = logs.filter(l => l.action === 'set')
+
+// Export for debugging
+console.log(memorio.logger.exportLogs())
+```

docs/OBSERVER.md

+# Observer - Memorio
+
+> ⚠️ **DEPRECATED**: This function is deprecated and will be removed in future versions. Please use [`useObserver`](USEOBSERVER.md) instead.
+
+Observer lets you react to state changes. When a state key changes, your callback function runs.
+
+## Installation
+
+```bash
+npm install memorio
+```
+
+```javascript
+import 'memorio';
+```
+
+---
+
+## Quick Examples
+
+### Example 1: Basic Usage
+
+```javascript
+// Simple observer (DEPRECATED - use useObserver instead)
+console.warn('observer() is deprecated. Please use useObserver() for React or memorio.dispatch for vanilla JS.');
+
+observer('state.counter', (newValue) => {
+  console.log('Counter is now:', newValue);
+});
+
+state.counter = 1;
+// Output: "Counter is now: 1"
+
+state.counter = 5;
+// Output: "Counter is now: 5"
+```
+
+> **Note**: For new projects, use [`useObserver`](USEOBSERVER.md) for React or [`memorio.dispatch`](SUMMARY.md) for vanilla JS.
+
+### Example 2: Intermediate
+
+```javascript
+// Observer with old value
+observer('state.user', (newValue, oldValue) => {
+  console.log(`User changed from ${oldValue?.name} to ${newValue?.name}`);
+});
+
+state.user = { name: 'Mario' };
+// Output: "User changed from undefined to Mario"
+
+state.user = { name: 'Luigi' };
+// Output: "User changed from Mario to Luigi"
+```
+
+### Example 3: Advanced
+
+```javascript
+// Multiple observers
+const obs1 = observer('state.data', handler1);
+const obs2 = observer('state.data', handler2);
+
+// List all observers
+console.log(observer.list);
+// Output: [{ name: 'state.data', id: '...' }, ...]
+
+// Remove specific observer
+observer.remove('state.data');
+
+// Remove all observers
+observer.removeAll();
+```
+
+---
+
+## API Reference
+
+### observer(path, callback)
+
+| Parameter | Type | Description |
+|-----------|------|-------------|
+| `path` | `string` | State path to watch (e.g., `'state.counter'`) |
+| `callback` | `function` | Function called on change |
+
+### Callback Parameters
+
+```javascript
+observer('state.key', (newValue, oldValue) => {
+  // newValue: the new value
+  // oldValue: the previous value
+});
+```
+
+### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `observer.list` | `Array` | Get all active observers |
+
+### Methods
+
+| Method | Parameters | Description |
+|--------|------------|-------------|
+| `observer.remove(name)` | `string` | Remove observer for specific path |
+| `observer.removeAll()` | none | Remove all observers |
+
+---
+
+## React Integration
+
+### With useState
+
+```javascript
+const [count, setCount] = useState(0);
+
+observer('state.counter', () => {
+  setCount(state.counter);
+});
+```
+
+### With useEffect
+
+```javascript
+useEffect(() => {
+  const handleChange = (newVal) => {
+    console.log('Changed:', newVal);
+  };
+
+  observer('state.data', handleChange);
+
+  // Cleanup
+  return () => observer.remove('state.data');
+}, []);
+```
+
+---
+
+## How It Works
+
+Observer subscribes to state changes via the Proxy's set trap. When `state.key = value` is called:
+1. The Proxy intercepts the set
+2. Fires all callbacks registered for that path
+3. Callbacks receive newValue and oldValue
+
+---
+
+## Best Practices
+
+1. Clean up observers in React `useEffect` return
+2. Use specific paths: `'state.user.name'` not `'state'`
+3. Remove observers when components unmount
+4. Use `observer.removeAll()` on page navigation
+
+---
+
+## Common Patterns
+
+### Form Validation
+
+```javascript
+observer('state.form.email', (email) => {
+  const isValid = email.includes('@');
+  state.form.isValid = isValid;
+});
+```
+
+### Analytics
+
+```javascript
+observer('state.page', (page) => {
+  analytics.track('page_view', { page });
+});
+```
+
+### Auto-save
+
+```javascript
+observer('state.draft', (content) => {
+  store.set('autosave', content);
+});
+```

docs/SESSION.md

+# Session - Memorio
+
+Session provides temporary storage using browser sessionStorage. Data persists until the tab or window is closed.
+
+## Installation
+
+```bash
+npm install memorio
+```
+
+```javascript
+import 'memorio';
+```
+
+---
+
+## Quick Examples
+
+### Example 1: Basic Usage
+
+```javascript
+// Save session data
+session.set('token', 'abc123');
+session.set('userId', 42);
+
+// Read session data
+console.log(session.get('token')); // "abc123"
+```
+
+### Example 2: Intermediate
+
+```javascript
+// Store objects
+session.set('user', { name: 'Mario', role: 'admin' });
+
+// Remove specific item
+session.remove('token');
+
+// Clear all session data
+session.removeAll();
+```
+
+### Example 3: Advanced
+
+```javascript
+// Check if session has data
+if (session.get('authToken')) {
+  // User is logged in
+}
+
+// Get storage quota (returns Promise<[usage, quota]> in KB)
+const [used, total] = await session.quota();
+console.log(`Using ${used} out of ${total} KB`);
+
+// Get total size in characters
+const size = session.size();
+console.log(`${size} bytes`);
+
+// Handle session expiry
+window.addEventListener('storage', (e) => {
+  if (e.key === 'session' && !e.newValue) {
+    // Session cleared
+    redirectToLogin();
+  }
+});
+```
+
+---
+
+## API Reference
+
+### Methods
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `session.get(name)` | `name: string` | `any` | Get value from session |
+| `session.set(name, value)` | `name: string, value: any` | `void` | Save value to session |
+| `session.remove(name)` | `name: string` | `boolean` | Remove single item |
+| `session.delete(name)` | `name: string` | `boolean` | Alias for remove |
+| `session.removeAll()` | `none` | `boolean` | Clear all session data |
+| `session.clearAll()` | `none` | `boolean` | Alias for removeAll |
+| `session.size()` | `none` | `number` | Get total size in characters |
+| `session.quota()` | `none` | `Promise<[number, number]>` | Get storage usage/quota in KB |
+
+---
+
+## Store vs Session
+
+| Feature | Store | Session |
+|---------|-------|---------|
+| Storage | localStorage | sessionStorage |
+| Lifetime | Forever | Until tab closes |
+| Use case | User preferences | Temporary auth |
+| Shared across tabs | Yes | No |
+
+---
+
+## Best Practices
+
+1. Use for auth tokens: `session.set('token', jwt)`
+2. Clear on logout: `session.removeAll()`
+3. Don't use for persistent data
+4. Check for null: `session.get('key') || defaultValue`
+
+---
+
+## Common Use Cases
+
+### Authentication
+
+```javascript
+// Login
+session.set('authToken', response.token);
+session.set('user', response.user);
+
+// Logout
+session.removeAll();
+router.push('/login');
+```
+
+### Form Progress
+
+```javascript
+// Save form draft
+session.set('formDraft', formData);
+
+// Restore on page refresh
+const draft = session.get('formDraft');
+if (draft) restoreForm(draft);

docs/STATE.md

+# State - Memorio
+
+State is a reactive global state manager using JavaScript Proxies. It's simple, powerful, and requires no setup. Data persists only in memory during the session.
+
+## Installation
+
+```bash
+npm install memorio
+```
+
+```javascript
+import 'memorio';
+```
+
+That's it. `state` is now global.
+
+---
+
+## Quick Examples
+
+### Example 1: Basic Usage
+
+```javascript
+// Set a value
+state.name = 'Mario';
+state.age = 25;
+
+// Get a value
+console.log(state.name); // "Mario"
+
+// Simple object
+state.user = { name: 'Luigi', level: 1 };
+```
+
+### Example 2: Intermediate
+
+```javascript
+// Array operations
+state.items = [1, 2, 3];
+state.items.push(4);
+console.log(state.items); // [1, 2, 3, 4]
+
+// Nested objects
+state.config = { theme: 'dark', lang: 'en' };
+state.config.theme = 'light';
+
+// List all states
+console.log(state.list);
+```
+
+### Example 3: Advanced
+
+```javascript
+// Lock state to prevent modifications
+state.frozenConfig = { maxUsers: 100 };
+state.frozenConfig.lock();
+// Now state.frozenConfig cannot be modified
+
+// Path tracking
+const path = state.user.path;
+console.log(path.name); // "user"
+console.log(path.profile.name); // "user.profile"
+
+// Get full path as string
+console.log(state.user.__path); // "state.user"
+
+// Protected keys (internal use)
+console.log(protect); // Array of protected keys
+```
+
+---
+
+## API Reference
+
+### Properties
+
+| Property | Type | Description |
+|----------|------|-------------|
+| `state.list` | Array | Get all current state keys (deep copy) |
+| `state.path` | Object | Get path tracker for current location |
+| `state.__path` | string | Get full path as string |
+
+### Methods
+
+| Method | Parameters | Description |
+|--------|------------|-------------|
+| `state.remove(key)` | `key: string` | Remove a specific state |
+| `state.removeAll()` | none | Clear all states |
+
+### Lock
+
+```javascript
+// Lock an object or array
+state.myArray = [1, 2, 3];
+state.myArray.lock();
+
+// Now any modification will fail
+state.myArray.push(4); // Error: state 'myArray' is locked
+```
+
+---
+
+## How It Works
+
+Memorio uses JavaScript `Proxy` to intercept get/set operations on the global `state` object. This allows:
+
+1. **Reactivity** - Any change can trigger observers
+2. **Nested objects** - Deep path tracking
+3. **Type safety** - Full TypeScript support
+
+---
+
+## Best Practices
+
+1. Use descriptive keys: `state.userProfile` not `state.up`
+2. Group related data: `state.cart.items` not `state.cartItems`
+3. Lock static config: `state.appConfig.lock()`
+4. Clean up on logout: `state.removeAll()`
+5. Use path tracking for debugging: `state.myData.__path`
+
+---
+
+## Common Errors
+
+```javascript
+// Error: protected key
+state._internal = 'value';
+// Output: "key _internal is protected"
+
+// Error: locked state
+state.locked = { x: 1 };
+state.locked.lock();
+state.locked.x = 2;
+// Output: "Error: state 'locked' is locked"
+```

docs/STORE.md

+# Store - Memorio
+
+Store provides persistent localStorage management with a simple API. Data survives page refreshes and browser restarts.
+
+## Installation
+
+```bash
+npm install memorio
+```
+
+```javascript
+import 'memorio';
+```
+
+---
+
+## Quick Examples
+
+### Example 1: Basic Usage
+
+```javascript
+// Save data
+store.set('username', 'Mario');
+store.set('score', 1500);
+
+// Read data
+console.log(store.get('username')); // "Mario"
+console.log(store.get('score'));    // 1500
+```
+
+### Example 2: Intermediate
+
+```javascript
+// Store objects
+store.set('user', { name: 'Luigi', level: 5 });
+const user = store.get('user');
+console.log(user.name); // "Luigi"
+
+// Remove single item
+store.remove('username');
+
+// Check size
+const totalSize = store.size();
+console.log(`${totalSize} bytes`);
+```
+
+### Example 3: Advanced
+
+```javascript
+// Get storage quota (returns Promise<[usage, quota]> in KB)
+const [used, total] = await store.quota();
+console.log(`Using ${used} out of ${total} KB`);
+
+// Get total size in characters
+const size = store.size();
+console.log(`${size} bytes`);
+
+// Clear all data
+store.removeAll();
+// or use alias
+store.clearAll();
+
+// Handle errors gracefully
+try {
+  store.set('largeData', hugeObject);
+} catch (err) {
+  console.error('Storage full:', err);
+}
+```
+
+---
+
+## API Reference
+
+### Methods
+
+| Method | Parameters | Returns | Description |
+|--------|------------|---------|-------------|
+| `store.get(name)` | `name: string` | `any` | Get value from storage |
+| `store.set(name, value)` | `name: string, value: any` | `void` | Save value to storage |
+| `store.remove(name)` | `name: string` | `boolean` | Remove single item |
+| `store.delete(name)` | `name: string` | `boolean` | Alias for remove |
+| `store.removeAll()` | none | `boolean` | Clear all storage |
+| `store.clearAll()` | none | `boolean` | Alias for removeAll |
+| `store.size()` | none | `number` | Get total size in characters |
+| `store.quota()` | none | `Promise<[number, number]>` | Get storage usage/quota in KB |
+
+### Supported Types
+
+```javascript
+// All JSON-serializable types work
+store.set('string', 'hello');
+store.set('number', 42);
+store.set('boolean', true);
+store.set('array', [1, 2, 3]);
+store.set('object', { key: 'value' });
+store.set('null', null);
+store.set('undefined', null); // converted to null
+```
+
+### Not Supported
+
+```javascript
+// Functions will log an error
+store.set('myFunc', () => {});
+// Output: "It's not secure to store functions."
+```
+
+---
+
+## How It Works
+
+Store wraps the browser's `localStorage` API with:
+
+- Automatic JSON serialization/deserialization
+- Error handling for parse failures
+- Size calculation
+- Quota monitoring
+
+---
+
+## Storage Limits
+
+- **Chrome/Safari**: ~5-10 MB
+- **Firefox**: ~10 MB
+- **Edge**: ~5-10 MB
+
+Use `store.quota()` to monitor usage.
+
+---
+
+## Best Practices
+
+1. Prefix keys: `store.set('app_username', '...')`
+2. Check before set: `if (store.get('key')) { ... }`
+3. Handle quota: Try/catch around large data
+4. Clean up: `store.removeAll()` on logout

docs/SUMMARY.md

+# Table of contents
+
+* [README](../README.md)
+
+## Core Modules
+
+* [State](STATE.md) - Reactive global state management
+* [Observer](OBSERVER.md) - ⚠️ Deprecated (use useObserver)
+* [useObserver](USEOBSERVER.md) - React hook for state observation
+* [Cache](CACHE.md) - In-memory caching (lost on refresh)
+* [Store](STORE.md) - Persistent localStorage management
+* [Session](SESSION.md) - Temporary sessionStorage management
+* [IDB](IDB.md) - IndexedDB for large data storage
+
+## Additional Resources
+
+* [License](../LICENSE.md)
+* [Contributing](../CONTRIBUTING.md)
+* [Code of Conduct](../CODE_OF_CONDUCT.md)
+* [Security](../SECURITY.md)
+
+## Changelog
+
+* [Changelog](../CHANGELOG.md)
+* [History](../HISTORY.md)

docs/USEOBSERVER.md

+# useObserver - Memorio
+
+useObserver is a React hook for observing state changes. It automatically subscribes to state changes and includes powerful auto-discovery features.
+
+## Installation
+
+```bash
+npm install memorio
+```
+
+```javascript
+import 'memorio';
+```
+
+---
+
+## Quick Examples
+
+### Example 1: Basic Usage
+
+```javascript
+import { useObserver } from 'memorio';
+
+function Counter() {
+  useObserver(() => {
+    console.debug('Counter changed:', state.counter);
+  }, [state.counter]);
+
+  return <div>{state.counter}</div>;
+}
+```
+
+### Auto-Discovery (Magic Mode)
+
+```javascript
+// Pass your callback WITHOUT dependencies - it auto-discovers!
+function MyComponent() {
+  useObserver(() => {
+    // This will automatically track ALL state properties used inside
+    console.debug('Something changed:', state.user.name, state.items.length);
+  });
+
+  return <div>{state.user.name}</div>;
+}
+```
+
+### Example 2: Intermediate
+
+```javascript
+function UserProfile() {
+  const [localState, setLocalState] = useState(null);
+
+  useObserver(() => {
+    setLocalState(state.user);
+  }, [state.user]);
+
+  return <div>{localState?.name}</div>;
+}
+```
+
+### Example 3: Advanced
+
+```javascript
+// Multiple watchers with array
+function MultiWatch() {
+  useObserver(() => {
+    console.debug('A or B changed:', state.a, state.b);
+  }, [state.a, state.b]);
+
+  return <div>{state.a} - {state.b}</div>;
+}
+```
+// With string path (for store)
+function StoreWatcher() {
+  useObserver(() => {
+    console.debug('Store changed');
+  }, 'store.userPreferences');
+
+  return <div />;
+}
+```
+
+---
+
+## API Reference
+
+### useObserver(callback, deps)
+
+| Parameter | Type | Description |
+| --------- | ---- | ----------- |
+| `callback` | `function` | Function to run on change |
+| `deps` | `function \| string \| array` | State path(s) to watch |
+
+### Callback Parameters
+
+```javascript
+useObserver((newValue, oldValue) => {
+  console.debug('Changed:', newValue);
+}, [state.key]);
+```
+
+### Auto-Discovery Mode
+
+When `deps` is omitted, useObserver automatically discovers all state properties accessed inside the callback:
+
+```javascript
+// No deps needed - magic auto-discovery!
+useObserver(() => {
+  // Automatically tracks state.user, state.items, state.counter
+  console.log(state.user.name, state.items.length, state.counter);
+});
+```
+
+Returns a cleanup function:
+
+## useObserver vs observer
+
+| Feature | observer | useObserver |
+| ------- | -------- | ----------- |
+| Framework | Vanilla JS | React |
+| Auto-cleanup | Manual | Auto |
+| React lifecycle | No | Yes |
+
+---
+
+## Common Patterns
+
+### Sync with useState
+
+```javascript
+function MyComponent() {
+  const [data, setData] = useState(null);
+
+  useObserver((newVal) => {
+    setData(newVal);
+  }, [state.data]);
+
+  return <div>{data}</div>;
+}
+```
+
+### Multiple Watchers
+
+```javascript
+}, [state.a, state.b]);
+```
+
+---
+
+## Best Practices
+
+1. Always use in React components
+2. Use auto-discovery for simpler code: `useObserver(() => { ... })`
+3. No manual cleanup needed - returns cleanup function automatically
+4. Use with state for reactive UI
+5. Check console for auto-discovery logs

examples/basic.ts

+/**
+ * Memorio Basic Example
+ *
+ * This example shows the fundamental features of Memorio:
+ * - State management
+ * - Store (localStorage)
+ * - Session storage
+ *
+ * Run: npx ts-node examples/basic.ts
+ */
+
+import '../index'
+
+// ============================================
+// STATE - In-memory reactive state
+// ============================================
+
+// Set some state values
+state.name = 'Mario'
+state.age = 30
+state.isActive = true
+state.profile = {
+  email: '[e-mail]',
+  avatar: 'https://example.com/mario.png'
+}
+
+// Get state values
+console.log('Name:', state.name)
+console.log('Age:', state.age)
+console.log('Profile:', state.profile)
+
+// List all states
+console.log('All states:', state.list)
+
+// ============================================
+// STORE - Persistent localStorage
+// ============================================
+
+// Save to localStorage
+store.set('username', 'mario')
+store.set('preferences', { theme: 'dark', language: 'en' })
+store.set('lastLogin', Date.now())
+
+// Read from localStorage
+console.log('Username:', store.get('username'))
+console.log('Preferences:', store.get('preferences'))
+
+// Get storage size
+console.log('Storage size:', store.size(), 'bytes')
+
+// ============================================
+// SESSION - Temporary session storage
+// ============================================
+
+// Save session data (cleared when tab closes)
+session.set('token', 'abc123xyz')
+session.set('userId', 42)
+
+// Read session data
+console.log('Token:', session.get('token'))
+console.log('User ID:', session.get('userId'))
+
+// ============================================
+// CLEANUP
+// ============================================
+
+// Clear specific items
+store.remove('username')
+session.remove('token')
+
+// Clear all
+store.removeAll()
+session.removeAll()
+
+console.log('Example complete!')

examples/cache.ts

+/**
+ * Memorio Cache Example
+ *
+ * This example demonstrates the cache module for in-memory storage.
+ * Cache is perfect for temporary data that doesn't need persistence.
+ *
+ * Run: npx ts-node examples/cache.ts
+ */
+
+import '../index'
+
+// ============================================
+// BASIC CACHE OPERATIONS
+// ============================================
+
+// Set values
+cache.set('username', 'Mario')
+cache.set('score', 1500)
+cache.set('player', { name: 'Mario', level: 5 })
+
+// Get values
+console.log('Username:', cache.get('username'))
+console.log('Score:', cache.get('score'))
+console.log('Player:', cache.get('player'))
+
+// Direct property access
+cache.tempData = 'Hello'
+console.log('Temp data:', cache.tempData)
+
+// ============================================
+// CACHE WITH OBJECTS
+// ============================================
+
+// Store complex objects
+cache.set('gameState', {
+  level: 3,
+  score: 2500,
+  inventory: ['sword', 'shield', 'potion'],
+  position: { x: 100, y: 200 }
+})
+
+const gameState = cache.get('gameState')
+console.log('Game level:', gameState?.level)
+console.log('Inventory:', gameState?.inventory)
+
+// ============================================
+// CACHE SIZE
+// ============================================
+
+// Add multiple items
+for (let i = 0; i < 10; i++) {
+  cache.set(`item_${i}`, { id: i, data: `item-${i}` })
+}
+
+console.log('Cache keys:', Object.keys(cache))
+
+// ============================================
+// CLEANUP
+// ============================================
+
+// Remove single item
+cache.remove('username')
+
+// Clear all cache
+cache.removeAll()
+
+// Or use clearAll alias
+// cache.clearAll()
+
+console.log('Cache after clear:', cache.get('score'))
+
+console.log('Cache example complete!')

examples/idb.ts

+/**
+ * Memorio IDB Example
+ *
+ * This example shows how to use IndexedDB for large data storage.
+ * IDB is perfect for caching, offline data, and large datasets.
+ *
+ * Run: npx ts-node examples/idb.ts
+ */
+
+import '../index'
+
+// ============================================
+// CHECK SUPPORT
+// ============================================
+
+if (!idb.db.support()) {
+  console.log('IndexedDB not supported')
+  process.exit(0)
+}
+
+// ============================================
+// CREATE DATABASE
+// ============================================
+
+// Create a new database
+idb.db.create('myApp')
+
+// Create tables (stores)
+idb.table.create('myApp', 'users')
+idb.table.create('myApp', 'products')
+
+// ============================================
+// ADD DATA
+// ============================================
+
+// Add user records
+idb.data.set('myApp', 'users', {
+  id: 1,
+  name: 'Mario',
+  email: '[e-mail]',
+  role: 'admin'
+})
+
+idb.data.set('myApp', 'users', {
+  id: 2,
+  name: 'Luigi',
+  email: '[e-mail]',
+  role: 'user'
+})
+
+// Add product records
+idb.data.set('myApp', 'products', {
+  id: 1,
+  name: 'Super Mushroom',
+  price: 99,
+  inStock: true
+})
+
+idb.data.set('myApp', 'products', {
+  id: 2,
+  name: 'Fire Flower',
+  price: 199,
+  inStock: true
+})
+
+// ============================================
+// READ DATA
+// ============================================
+
+const user1 = idb.data.get('myApp', 'users', 1)
+console.log('User 1:', user1)
+
+const product1 = idb.data.get('myApp', 'products', 1)
+console.log('Product 1:', product1)
+
+// ============================================
+// DATABASE INFO
+// ============================================
+
+// List all databases
+const databases = idb.db.list()
+console.log('Databases:', databases)
+
+// Check if database exists
+const exists = idb.db.exist('myApp')
+console.log('myApp exists:', exists)
+
+// Get database version
+const version = idb.db.version('myApp')
+console.log('myApp version:', version)
+
+// Get database size
+const size = idb.db.size('myApp')
+console.log('myApp size:', size, 'bytes')
+
+// ============================================
+// DELETE DATA
+// ============================================
+
+// Delete a record
+idb.data.delete('myApp', 'users', 1)
+
+// Delete entire table
+// idb.table.delete('myApp', 'users');
+
+// Delete entire database
+// idb.db.delete('myApp');
+
+console.log('IDB example complete!')

examples/observer.ts

+/**
+ * Memorio Observer Example
+ *
+ * This example demonstrates the observer pattern for reactive state changes.
+ * Perfect for logging, analytics, auto-save, and UI updates.
+ *
+ * Run: npx ts-node examples/observer.ts
+ */
+
+import '../index'
+
+// ============================================
+// SIMPLE OBSERVER
+// ============================================
+
+// Watch a single value
+observer('state.counter', (newValue, oldValue) => {
+  console.log(`Counter: ${oldValue} → ${newValue}`)
+})
+
+state.counter = 0
+state.counter = 1
+state.counter = 2
+
+// ============================================
+// OBJECT OBSERVER
+// ============================================
+
+// Watch entire objects
+observer('state.user', (newUser, oldUser) => {
+  console.log(`User changed: ${oldUser?.name} → ${newUser?.name}`)
+})
+
+state.user = { name: 'Mario', level: 1 }
+state.user = { name: 'Luigi', level: 2 }
+
+// ============================================
+// MULTIPLE OBSERVERS
+// ============================================
+
+// Multiple observers on same path
+observer('state.notifications', (count) => {
+  console.log(`New notification count: ${count}`)
+})
+
+// List all observers
+console.log('Active observers:', observer.list)
+
+// ============================================
+// CLEANUP
+// ============================================
+
+// Remove specific observer
+observer.remove('state.counter')
+
+// Remove all observers - call remove for each path
+// observer.remove('state.counter')
+// observer.remove('state.notifications')
+
+console.log('Observer example complete!')

examples/session-advanced.ts

+/**
+ * Memorio Session Advanced Example
+ *
+ * This example shows advanced session (sessionStorage) operations.
+ * Session data is cleared when the browser tab closes.
+ *
+ * Run: npx ts-node examples/session-advanced.ts
+ */
+
+import '../index'
+
+// ============================================
+// AUTHENTICATION
+// ============================================
+
+// Store auth token (temporary - cleared when tab closes)
+session.set('authToken', 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...')
+session.set('userId', 12345)
+
+// Check if user is logged in
+const token = session.get('authToken')
+if (token) {
+  console.log('User is logged in, token:', token.substring(0, 20) + '...')
+}
+
+// ============================================
+// FORM PROGRESS
+// ============================================
+
+// Save form draft
+session.set('formDraft', {
+  name: 'Mario',
+  email: '[e-mail]',
+  message: 'Hello world!'
+})
+
+// Restore on page refresh
+const draft = session.get('formDraft')
+if (draft) {
+  console.log('Restored draft:', draft)
+}
+
+// ============================================
+// SHOPPING CART
+// ============================================
+
+// Store cart items (temporary)
+session.set('cart', [
+  { id: 1, name: 'Super Mushroom', price: 99, qty: 2 },
+  { id: 2, name: 'Fire Flower', price: 199, qty: 1 }
+])
+
+// Calculate total
+const cart = session.get('cart') || []
+const total = cart.reduce((sum, item) => sum + (item.price * item.qty), 0)
+console.log('Cart total:', total)
+
+// ============================================
+// SESSION SIZE
+// ============================================
+
+// Get session storage size
+console.log('Session size:', session.size(), 'bytes')
+
+// ============================================
+// CLEANUP
+// ============================================
+
+// Remove specific item
+session.remove('formDraft')
+
+// Clear all session data (logout)
+// session.removeAll()
+
+// Or use alias
+// session.clearAll()
+
+console.log('Session advanced example complete!')

examples/state-advanced.ts

+/**
+ * Memorio State Advanced Example
+ *
+ * This example shows advanced state features: locking, path tracking, and nesting.
+ *
+ * Run: npx ts-node examples/state-advanced.ts
+ */
+
+import '../index'
+
+// ============================================
+// NESTED OBJECTS
+// ============================================
+
+// Create nested state
+state.user = {
+  name: 'Mario',
+  profile: {
+    email: '[e-mail]',
+    settings: {
+      theme: 'dark',
+      notifications: true
+    }
+  }
+}
+
+// Access nested values
+console.log('User name:', state.user.name)
+console.log('Email:', state.user.profile.email)
+console.log('Theme:', state.user.profile.settings.theme)
+
+// ============================================
+// ARRAYS
+// ============================================
+
+// State arrays work like regular arrays
+state.items = [1, 2, 3]
+state.items.push(4)
+console.log('Items:', state.items) // [1, 2, 3, 4]
+
+state.users = [
+  { name: 'Mario', id: 1 },
+  { name: 'Luigi', id: 2 }
+]
+state.users.push({ name: 'Peach', id: 3 })
+console.log('Users:', state.users)
+
+// ============================================
+// LOCKING STATE
+// ============================================
+
+// Lock a value to prevent modifications
+state.config = { maxUsers: 100, timeout: 30 }
+state.config.lock()
+
+// This will fail:
+// state.config.maxUsers = 200 // Error: state 'config' is locked
+
+console.log('Config locked:', state.config)
+
+// ============================================
+// PATH TRACKING
+// ============================================
+
+// Get path information
+console.log('Path:', state.user.__path) // "state.user"
+
+// Use path tracker for debugging
+const path = state.user.profile
+console.log('Profile path:', path.email.toString()) // "state.user.profile.email"
+
+// ============================================
+// LIST ALL STATES
+// ============================================
+
+// Get all current state keys
+console.log('All states:', state.list)
+
+// ============================================
+// REMOVE STATE
+// ============================================
+
+// Remove specific state
+state.remove('items')
+
+// Remove all states
+// state.removeAll()
+
+console.log('State advanced example complete!')

examples/store-advanced.ts

+/**
+ * Memorio Store Advanced Example
+ *
+ * This example shows advanced store (localStorage) operations.
+ *
+ * Run: npx ts-node examples/store-advanced.ts
+ */
+
+import '../index'
+
+// ============================================
+// PERSIST USER PREFERENCES
+// ============================================
+
+// Save user preferences
+store.set('preferences', {
+  theme: 'dark',
+  language: 'en',
+  notifications: true,
+  fontSize: 16
+})
+
+// ============================================
+// CHECK AND LOAD PREFERENCES
+// ============================================
+
+const savedPrefs = store.get('preferences')
+if (savedPrefs) {
+  console.log('Loaded preferences:', savedPrefs)
+} else {
+  console.log('No preferences found, using defaults')
+  store.set('preferences', { theme: 'light', language: 'en' })
+}
+
+// ============================================
+// STORAGE QUOTA
+// ============================================
+
+// Get storage size
+const currentSize = store.size()
+console.log('Current storage size:', currentSize, 'bytes')
+
+// ============================================
+// ALIAS METHODS
+// ============================================
+
+// store.delete() is alias for store.remove()
+store.set('temp', 'value')
+store.delete('temp')
+
+// store.clearAll() is alias for store.removeAll()
+// store.clearAll()
+
+// ============================================
+// ERROR HANDLING
+// ============================================
+
+// Try-catch for large data
+try {
+  // Store large data
+  const largeData = {
+    items: Array(1000).fill(null).map((_, i) => ({ id: i, data: 'x'.repeat(100) }))
+  }
+  store.set('largeData', largeData)
+  console.log('Large data stored successfully')
+} catch (error) {
+  console.error('Storage full:', error)
+}
+
+// ============================================
+// DATA SERIALIZATION
+// ============================================
+
+// Store supports all JSON-serializable types
+store.set('string', 'hello')
+store.set('number', 42)
+store.set('boolean', true)
+store.set('array', [1, 2, 3])
+store.set('object', { nested: { value: 'deep' } })
+store.set('null', null)
+
+// Functions are not supported (logged as error)
+store.set('function', () => { }) // logs: "It's not secure to store functions."
+
+// ============================================
+// PRACTICAL EXAMPLE: APP STATE
+// ============================================
+
+// Save app state
+const appState = {
+  lastPage: '/dashboard',
+  sidebarOpen: true,
+  recentFiles: ['file1.txt', 'file2.pdf'],
+  lastSaved: Date.now()
+}
+store.set('appState', appState)
+
+// Load on next visit
+const restored = store.get('appState')
+if (restored) {
+  console.log('Restored app state:', restored.lastPage)
+}
+
+console.log('Store advanced example complete!')

examples/useObserver.ts

+/**
+ * Memorio useObserver Example
+ *
+ * This example demonstrates the useObserver hook for React.
+ * useObserver automatically tracks state changes and triggers re-renders.
+ *
+ * Note: This example requires React to be present in the environment.
+ * Run in a React environment.
+ */
+
+import '../index'
+
+// ============================================
+// BASIC USEOBSERVER
+// ============================================
+
+// Example 1: Watch single value
+useObserver(callback, [state.value])
+
+function Counter() {
+  useObserver(() => {
+    console.debug('Count changed:', state.count)
+  }, [state.count])
+
+  return <div>{ state.count } </div>
+}
+
+// ============================================
+// MULTIPLE DEPENDENCIES
+// ============================================
+
+// Example 2: Watch multiple values
+function UserProfile() {
+  useObserver(() => {
+    console.debug('User or theme changed')
+  }, [state.user, state.theme])
+
+  return <div>{ state.user.name } </div>
+}
+
+// ============================================
+// AUTO-DISCOVERY
+// ============================================
+
+// Example 3: No dependencies - auto-discovers all state access
+function AutoDiscovery() {
+  useObserver(() => {
+    // Automatically tracks state.user, state.items, state.count
+    console.debug('Changed:', state.user.name, state.items.length, state.count)
+  })
+
+  return <div>{ state.user.name } </div>
+}
+
+// ============================================
+// SYNC WITH USESTATE
+// ============================================
+
+// Example 4: Sync with useState
+function SyncedComponent() {
+  const [localData, setLocalData] = useState(null)
+
+  useObserver((newValue) => {
+    setLocalData(newValue)
+  }, [state.data])
+
+  return <div>{ localData } </div>
+}
+
+// ============================================
+// PRACTICAL EXAMPLE
+// ============================================
+
+// Real-world React component example:
+import { useObserver } from 'memorio'
+
+function TodoApp() {
+  // Track todos
+  useObserver(() => {
+    console.debug('Todos updated:', state.todos)
+    // Optionally save to store
+    store.set('todos', state.todos)
+  }, [state.todos])
+
+  // Track filter
+  useObserver(() => {
+    console.debug('Filter changed:', state.filter)
+  }, [state.filter])
+
+  const addTodo = (text) => {
+    state.todos = [...(state.todos || []), { text, done: false }]
+  }
+
+  const toggleTodo = (index) => {
+    const todos = [...state.todos]
+    todos[index].done = !todos[index].done
+    state.todos = todos
+  }
+
+  const filteredTodos = (state.todos || []).filter(t =>
+    state.filter === 'all' ||
+    (state.filter === 'done' && t.done) ||
+    (state.filter === 'todo' && !t.done)
+  )
+
+  return (
+    <div>
+    <select
+        value= { state.filter }
+  onChange = { e => state.filter = e.target.value }
+    >
+    <option value="all" > All </option>
+      < option value = "done" > Done </option>
+        < option value = "todo" > Todo </option>
+          </select>
+          <ul>
+  {
+    filteredTodos.map((todo, i) => (
+      <li
+            key= { i }
+            onClick = {() => toggleTodo(i)}
+  style = {{ textDecoration: todo.done ? 'line-through' : 'none' }
+}
+          >
+  { todo.text }
+  </li>
+        ))}
+</ul>
+  < input
+onKeyDown = { e => {
+  if (e.key === 'Enter') {
+    addTodo(e.target.value)
+    e.target.value = ''
+  }
+}}
+      />
+  </div>
+  )
+}
+
+console.log('useObserver example - run in React environment!')

index.js

@@ -1,1 +0,1 @@
-var l=(e,r)=>()=>(e&&(r=e(e=0)),r);var p,h=l(()=>{p={name:"memorio",version:"2.5.2",type:"module",private:!1,main:"index.js",license:"MIT",typings:"./types/*",description:"Memorio, State + Observer and Store for an easy life",copyright:"Copyright (c) 2025 Dario Passariello",homepage:"https://a51.gitbook.io/memorio",author:{name:"Dario Passariello",url:"https://dario.passariello.ca/",email:"[e-mail]"},support:{name:"Dario Passariello",url:"https://github.com/passariello/",email:"[e-mail]"},contributors:[{name:"Dario Passariello",email:"[e-mail]"},{name:"Valeria Cala Scaglitta",email:"[e-mail]"}],keywords:["biglogic","a51","memorio","state","store","observer","useObserver","dario","passariello"],funding:[{type:"patreon",url:"https://www.patreon.com/passariello"}],typing:["types/*"],exports:{".":{types:"./types/index.d.ts",import:"./index.js",default:"./index.js"},"./types/*":"./types/*"},scripts:{build:"node ./esbuild.config.mjs",watch:'nodemon --watch * --exec "npm run build "',"npm:publish":"npm run build && npm publish ./dist",test:"cd tests && npm run test",lint:"cd tests && npm run lint",tsc:"tsc --noEmit"},devDependencies:{"@types/node":"25.3.3",esbuild:"0.27.3","esbuild-node-externals":"1.20.1","esbuild-plugin-alias":"0.2.1","esbuild-plugin-copy":"2.1.1",typescript:"5.9.3"}}});var y,m=l(()=>{"use strict";a();h();Object.defineProperty(globalThis,"memorio",{value:{},writable:!1,configurable:!0,enumerable:!1});Object.defineProperty(globalThis,"events",{value:{},writable:!0,enumerable:!1});Object.defineProperty(memorio,"version",{writable:!1,enumerable:!1,value:p.version});y=["list","state","store","idb","observer","useObserver","remove","removeAll"]});var v=l(()=>{"use strict";a();Object.defineProperty(memorio,"dispatch",{writable:!1,enumerable:!1,value:{set:(e,r={})=>{globalThis.dispatchEvent(new CustomEvent(String(e),r))},listen:(e,r=null,o=!1)=>{globalThis.observer?.list?.[e]?.length>0&&globalThis.observer?.remove?.(e);let i=r?t=>setTimeout(()=>r(t),1):void 0;i&&globalThis.addEventListener(e,i),i&&(globalThis.events[e]=i)},remove:e=>{let r=globalThis.events?.[e];r&&(globalThis.removeEventListener(e,r),delete globalThis.events[e])}}})});var T=l(()=>{"use strict";a();memorio.propertyName=(e,r)=>String(r).replace("() => ","")});var P,O=l(()=>{"use strict";a();m();Object.defineProperty(memorio,"objPath",{writable:!1,enumerable:!1,value:(e,r,o=".")=>{let i=r.concat(e).join(o);return globalThis.memorio._tracking&&globalThis.memorio._trackedPaths?.add("state."+i),i}});globalThis.memorio._tracking=!1;globalThis.memorio._trackedPaths=new Set;globalThis.memorio._locked=!1;P=(e,r,o=[])=>{let i=t=>{try{globalThis.memorio?.dispatch?.set?.(t,{detail:{name:t}})}catch{}};return new Proxy(e,{get(t,s){if(s==="__path")return o.length>0?"state."+o.join("."):"state";if(s==="list")return console.debug('Some state could be hidden when you use "state.list". Use "state" to see the complete list '),JSON.parse(JSON.stringify(globalThis.state));if(globalThis.memorio._tracking&&typeof s=="string"){let n=o.length>0?"state."+o.concat(s).join("."):"state."+s;globalThis.memorio._trackedPaths?.add(n)}if(s==="remove")return n=>(delete t[n],!0);if(s==="removeAll")return()=>{try{for(let n in t)typeof t[n]!="function"&&!["list","remove","removeAll"].includes(n)&&(Object.isFrozen(t[n])||delete t[n],delete t[n])}catch(n){console.debug(n)}};if(Object.isFrozen(t[s]))return t[s];if(s==="lock"||s==="unlock"){let n=Reflect.get(t,s);if(n)return n}try{let n=Reflect.get(t,s);return n&&typeof n=="object"&&["Array","Object"].includes(n.constructor.name)?P(n,r,o.concat(s)):n}catch(n){console.error("Error: ",n);return}},set(t,s,n){if(globalThis.memorio._locked)return console.error("Error: state is locked. Use state.unlock() to enable modifications."),!1;if(y.includes(s))return console.error("key "+s+" is protected"),!1;if(t[s]&&typeof t[s]=="object"&&Object.isFrozen(t[s]))return console.error(`Error: state '${s}' is locked`),!1;if(t[s]&&typeof t[s]=="object"&&t[s].__locked)return console.error(`Error: state '${s}' is locked. Use state.${s}.unlock() to enable modifications.`),!1;try{let u=globalThis.memorio.objPath?.(s,o)??s;if(r({action:"set",path:u,target:t,newValue:n,previousValue:Reflect.get(t,s)}),i("state."+u),Reflect.set(t,s,n),t[s]&&typeof t[s]=="object"){let b=t[s];if(b&&typeof b=="object")try{Object.defineProperty(b,"__locked",{writable:!0,enumerable:!1,configurable:!1,value:!1}),Object.defineProperty(b,"lock",{writable:!1,enumerable:!1,configurable:!1,value:()=>{Object.defineProperty(b,"__locked",{writable:!0,enumerable:!1,configurable:!1,value:!0}),console.info(`State '${s}' is now locked.`)}}),Object.defineProperty(b,"unlock",{writable:!1,enumerable:!1,configurable:!1,value:()=>{Object.defineProperty(b,"__locked",{writable:!0,enumerable:!1,configurable:!1,value:!1}),console.info(`State '${s}' is now unlocked.`)}})}catch{}}return!0}catch(u){return console.error("Error in set trap:",u),!1}},deleteProperty(t,s){try{let n=globalThis.memorio.objPath?.(s,o);return r({action:"delete",path:n,target:t}),Reflect.deleteProperty(t,s)}catch(n){return console.error("Error in deleteProperty trap:",n),!1}},ownKeys(t){return Reflect.ownKeys(t)},getOwnPropertyDescriptor(t,s){return Reflect.getOwnPropertyDescriptor(t,s)}})};globalThis?.state?globalThis.state=state:globalThis.state=P({},()=>{});globalThis.state.lock=()=>{globalThis.memorio._locked=!0,console.info("State is now locked. All modifications are blocked.")};globalThis.state.unlock=()=>{globalThis.memorio._locked=!1,console.info("State is now unlocked. Modifications are allowed.")};Object.defineProperty(globalThis,"state",{enumerable:!1,configurable:!0})});var F,S=l(()=>{"use strict";a();globalThis.observer||(globalThis.observer=null);Object.defineProperty(globalThis,"observer",{enumerable:!1,configurable:!0});F=(e,r=null,o=!0)=>{console.warn('DEPRECATED: "observer" is deprecated and will be removed in future versions. Please use "useObserver" instead.');try{if(!(t=>t.split(".")[0]!=="state"?(console.error(`Observer Error: You need to declare 'state.' or 'store.'. The '${t}' string is incorrect!`),!1):!0)(e))return}catch(i){console.error(i);return}if(!e&&!r){console.error("Observer Error: You need to setup observer correctly, Some parameters are missed!");return}if(!e&&r){console.error("Observer Error: You need to declare what state need to be monitored as string like 'state.test'.");return}if(e&&!r){let i=(String(e),{detail:{name:String(e)}}),t=globalThis.observer;t?.list?.[e]&&globalThis.memorio.dispatch.remove(i),t?.list?.[e]||globalThis.memorio.dispatch.listen(i),console.debug("called: ",e);return}if(e&&r){if(typeof e!="string"||typeof r!="function"){console.error("Observer Error: name of state need to be a 'string' like 'state.test' and the callback need to be a 'function'");return}let i=globalThis.observer;i?.list?.[e]&&globalThis.memorio.dispatch.remove(e,r,o),i?.list?.[e]||globalThis.memorio.dispatch.listen(e,r,o);return}};globalThis.observer=F;Object.defineProperties(globalThis.observer,{list:{get:()=>globalThis.events},remove:{value:e=>{e&&(globalThis.memorio.dispatch.remove(e),delete globalThis.events[e])}},removeAll:{get:()=>{let e=globalThis.observer,r=e?.list;return r&&Object.keys(r).forEach(o=>{e?.remove?.(o)}),!0}}});Object.freeze(observer)});var w=l(()=>{"use strict";a();globalThis.useObserver||(globalThis.useObserver=null);Object.defineProperty(globalThis,"useObserver",{value:null,writable:!0,enumerable:!1,configurable:!0});globalThis.useObserver=((e,r)=>{if(!r||typeof e!="function")return()=>{};let o=[],i=Array.isArray(r)&&!r.__path?r:[r];try{return i.forEach(t=>{let s="";if(typeof t=="function"){let n=globalThis.memorio.propertyName;if(typeof n=="function"){let u=n(globalThis.state,t);u&&(s=u)}}else typeof t=="object"&&t!==null?s=t.__path||(typeof t.toString=="function"&&t.toString()!=="[object Object]"?t.toString():""):typeof t=="string"&&(t.startsWith("state.")||t.startsWith("store."))&&(s=t);if(s){s=s.replace(/^(\(\)\s*=>\s*)/,"").replace(/^globalThis\./,"").replace(/^state\./,"");let n=s.startsWith("store.")||s.startsWith("state.")?s:"state."+s;globalThis.memorio.dispatch.listen(n,()=>e()),o.push(n)}else{globalThis.memorio._trackedPaths?.clear(),globalThis.memorio._tracking=!0;try{e()}catch{}globalThis.memorio._tracking=!1,globalThis.memorio._trackedPaths?.forEach(n=>{o.includes(n)||(console.info(`useObserver: [Auto-Discovery] -> "${n}"`),globalThis.memorio.dispatch.listen(n,()=>e()),o.push(n))})}}),o.length>0?console.info(`useObserver: Monitoring ${o.length} paths.`):console.warn("useObserver: No paths resolved for monitoring. Check your dependencies!"),()=>{o.forEach(t=>{globalThis.memorio.dispatch&&typeof globalThis.memorio.dispatch.remove=="function"&&(globalThis.memorio.dispatch.remove(t),console.debug(`useObserver: Stopped monitoring "${t}"`))})}}catch(t){return console.debug("useObserver Error:",t),()=>{}}});Object.freeze(globalThis.useObserver)});var j=l(()=>{"use strict";a();Object.defineProperty(globalThis,"store",{value:new Proxy({},{}),enumerable:!1,configurable:!0});Object.defineProperties(store,{get:{value:e=>{if(e){try{let r=globalThis.localStorage.getItem(e);return r&&JSON.parse(r)}catch(r){console.debug(`Error parsing store item '${e}':`,r)}return null}}},set:{value:(e,r)=>{if(e){try{r==null?globalThis.localStorage.setItem(e,JSON.stringify(null)):typeof r=="object"||typeof r=="number"||typeof r=="boolean"||typeof r=="string"?globalThis.localStorage.setItem(e,JSON.stringify(r)):typeof r=="function"&&console.debug("It's not secure to store functions.")}catch(o){console.debug(`Error setting store item '${e}':`,o)}return null}}},remove:{value:e=>{if(e)return globalThis.localStorage.getItem(e)?(globalThis.localStorage.removeItem(e),!0):!1}},delete:{value:e=>(store.remove(e),!0)},removeAll:{value:()=>(globalThis.localStorage.clear(),!0)},clearAll:{value:()=>(store.removeAll(),!0)},quota:{value:async()=>globalThis.navigator&&"storage"in globalThis.navigator&&"estimate"in globalThis.navigator.storage?globalThis.navigator.storage.estimate().then(({usage:e,quota:r})=>{let o=e??0,i=r??0;return o&&i&&console.debug(`Using ${o/1024} out of ${i/1024} Mb.`),[o/1024,i/1024]}).catch(e=>(console.debug("Error estimating quota:",e),[0,0])):[0,0]},size:{value:()=>{let e=0;return Object.keys(globalThis.localStorage).forEach(r=>{let o=globalThis.localStorage.getItem(r);o&&(e+=o.length)}),e}}});Object.freeze(store)});var x=l(()=>{"use strict";a();Object.defineProperty(globalThis,"session",{value:new Proxy({},{}),enumerable:!1,configurable:!0});Object.defineProperties(session,{get:{value:e=>{if(e)try{let r=globalThis.sessionStorage.getItem(e);return r&&JSON.parse(r)}catch(r){console.debug(`Error parsing session item '${e}':`,r)}}},set:{value:(e,r)=>{if(e)try{r==null?globalThis.sessionStorage.setItem(e,JSON.stringify(null)):typeof r=="object"||typeof r=="number"||typeof r=="boolean"||typeof r=="string"?globalThis.sessionStorage.setItem(e,JSON.stringify(r)):typeof r=="function"&&console.debug("It's not secure to session functions.")}catch(o){console.debug(`Error setting session item '${e}':`,o)}}},remove:{value:e=>{if(e&&globalThis.sessionStorage.getItem(e))return globalThis.sessionStorage.removeItem(e),!0}},delete:{value:e=>(session.remove(e),!0)},removeAll:{value:()=>(globalThis.sessionStorage.clear(),!0)},clearAll:{value:()=>(session.removeAll(),!0)},quota:{value:async()=>globalThis.navigator&&"storage"in globalThis.navigator&&"estimate"in globalThis.navigator.storage?globalThis.navigator.storage.estimate().then(({usage:e,quota:r})=>{let o=e??0,i=r??0;return o&&i&&console.debug(`Using ${o/1024} out of ${i/1024} Mb.`),[o/1024,i/1024]}).catch(e=>(console.debug("Error estimating quota:",e),[0,0])):[0,0]},size:{value:()=>{let e=0;return Object.keys(globalThis.sessionStorage).forEach(r=>{let o=globalThis.sessionStorage.getItem(r);o&&(e+=o.length)}),e}}});Object.freeze(session)});var d,E=l(()=>{"use strict";a();d={};Object.defineProperty(globalThis,"cache",{value:new Proxy({},{get(e,r){let o=r;return o==="get"?i=>d[i]:o==="set"?(i,t)=>{d[i]=t}:o==="remove"?i=>(delete d[i],!0):o==="removeAll"?()=>(Object.keys(d).forEach(i=>delete d[i]),!0):o==="clear"?()=>(Object.keys(d).forEach(i=>delete d[i]),!0):d[o]},set(e,r,o){return d[r]=o,!0},deleteProperty(e,r){return delete d[r],!0}}),enumerable:!1,configurable:!0});Object.freeze(cache)});var U={};var D=l(()=>{"use strict";a();idb.db.create=(e,r=1)=>new Promise((o,i)=>{if(!idb.db.support())return i(new Error("IndexedDB not supported"));let t=globalThis.indexedDB.open(e,r);t.onerror=()=>{console.debug(`IndexedDB error: ${t.error?.message}`),i(t.error)},t.onsuccess=()=>{console.debug(`Database ${e} connected successfully`),idb.db.list(),o(t.result)},t.onupgradeneeded=()=>{console.debug(`Database ${e} upgrade/creation initiated`)}})});var W={};var $=l(()=>{"use strict";a();idb.db.list=async()=>{if(!("indexedDB"in globalThis)||!indexedDB.databases)return[];try{let e=await indexedDB.databases();return globalThis.idbases=e||[],await idb.db.size(),globalThis.idbases}catch(e){return console.error("Error listing databases:",e),[]}};idb.db.list()});var Y={};var k=l(()=>{"use strict";a();idb.db.exist=e=>idbases?.some(r=>r.name===e)});var L={};var _=l(()=>{"use strict";a();idb.db.quota=()=>navigator.storage.estimate()});var K={};var I=l(()=>{"use strict";a();idb.db.delete=e=>new Promise((r,o)=>{console.debug(`Removing database ${e}...`);let i=()=>{let t=indexedDB.deleteDatabase(e);t.onsuccess=()=>{console.debug(`${e} database removed successfully`),idb.db.list(),r()},t.onerror=()=>{console.error(`Error removing ${e}:`,t.error),o(t.error)},t.onblocked=()=>{console.warn(`Deletion of ${e} is blocked. Please close other tabs.`)}};confirm(`Are you sure you want to remove the "${e}" database?`)?i():(console.debug("Database deletion cancelled by user."),r())})});var G={};var q=l(()=>{"use strict";a();idb.db.size=async()=>{if(!(!idbases||idbases.length===0))for(let e=0;e<idbases.length;e++){let r=idbases[e];try{let o=await idb.db.create(r.name,r.version),i=Array.from(o.objectStoreNames),t=0;for(let s of i){let n=await idb.table.size(o,s);t+=n}r.size=t,o.close()}catch(o){console.debug(`Could not calculate size for ${r.name}:`,o)}}}});var H={};var z=l(()=>{"use strict";a();idb.db.version=e=>{let r=0;for(let o of idbases){o.name===e&&(r=o.version);break}return r}});var Q={};var A=l(()=>{"use strict";a();idb.db.support=()=>{let e="indexedDB"in globalThis;return e||console.debug("Your environment doesn't support IndexedDB"),e}});var X={};var B=l(()=>{"use strict";a();idb.table.create=(e,r)=>new Promise(async(o,i)=>{try{let s=(Number(idb.db.version(e))||0)+1,n=indexedDB.open(e,s);n.onupgradeneeded=u=>{let b=u.target.result;if(!b.objectStoreNames.contains(r)){let c=b.createObjectStore(r,{keyPath:"id",autoIncrement:!0});c.createIndex("id","id",{unique:!0}),c.createIndex("data","data",{unique:!1}),console.debug(`Table ${r} created in ${e}`)}},n.onsuccess=()=>{n.result.close(),idb.db.list(),o()},n.onerror=()=>{console.error(`Error creating table ${r}:`,n.error),i(n.error)}}catch(t){console.error("Critical error in table.create:",t),i(t)}})});var Z={};var R=l(()=>{"use strict";a();idb.table.size=(e,r)=>new Promise((o,i)=>{if(!e)return i(new Error("Database instance is required"));if(!e.objectStoreNames.contains(r))return o(0);let t=0,s=0,b=e.transaction([r],"readonly").objectStore(r).openCursor();b.onsuccess=async c=>{let g=c.target.result;if(g){try{let f=g.value;t+=JSON.stringify(f).length}catch(f){console.debug("Error stringifying IDB value tracking size:",f)}s++,s%200===0&&await new Promise(f=>setTimeout(f,0)),g.continue()}else o(t)},b.onerror=()=>{i(b.error)}})});var ee={};var N=l(()=>{"use strict";a();idb.data.delete=(e,r,o)=>new Promise((i,t)=>{let s=indexedDB.open(e);s.onsuccess=()=>{let n=s.result;if(!n.objectStoreNames.contains(r))return n.close(),t(new Error(`Table ${r} not found`));let c=n.transaction(r,"readwrite").objectStore(r).delete(o);c.onsuccess=()=>{n.close(),console.debug(`Record ${o} deleted from ${r}`),i()},c.onerror=()=>{n.close(),t(c.error)}},s.onerror=()=>t(s.error)});idb.data.delete.all=(e,r)=>new Promise((o,i)=>{let t=indexedDB.open(e);t.onsuccess=s=>{let n=s.target.result;if(!n.objectStoreNames.contains(r))return n.close(),i(new Error(`Table ${r} not found`));let c=n.transaction(r,"readwrite").objectStore(r).clear();c.onsuccess=()=>{n.close(),console.debug(`All data cleared from ${r}`),o()},c.onerror=()=>{n.close(),i(c.error)}},t.onerror=()=>i(t.error)})});var re={};var C=l(()=>{"use strict";a();idb.data.set=(e,r,o)=>new Promise((i,t)=>{let s=indexedDB.open(e);s.onsuccess=()=>{let n=s.result;if(!n.objectStoreNames.contains(r))return n.close(),t(new Error(`Table ${r} does not exist in ${e}`));let c=n.transaction(r,"readwrite").objectStore(r).put(o);c.onsuccess=()=>{n.close(),console.debug(`Data saved in ${e}.${r}`),i(c.result)},c.onerror=g=>{n.close(),console.debug(`Database insert error: ${c.error?.message}`),t(c.error)}},s.onerror=()=>{t(s.error)}})});var te={};var J=l(()=>{"use strict";a();idb.data.get=(e,r,o)=>new Promise((i,t)=>{let s=indexedDB.open(e);s.onsuccess=n=>{let u=n.target.result;if(!u.objectStoreNames.contains(r))return u.close(),t(new Error(`Table ${r} not found in ${e}`));let g=u.transaction(r,"readonly").objectStore(r).get(o);g.onsuccess=()=>{u.close(),i(g.result)},g.onerror=()=>{u.close(),t(g.error)}},s.onerror=()=>{t(s.error)}})});var V=l(()=>{"use strict";a();(async()=>(Object.defineProperty(globalThis,"idb",{value:{db:{},table:{},data:{}},writable:!0,configurable:!0,enumerable:!1}),Object.defineProperty(globalThis,"idbases",{value:[],writable:!0,configurable:!0,enumerable:!1}),await Promise.all([Promise.resolve().then(()=>(D(),U)),Promise.resolve().then(()=>($(),W)),Promise.resolve().then(()=>(k(),Y)),Promise.resolve().then(()=>(_(),L)),Promise.resolve().then(()=>(I(),K)),Promise.resolve().then(()=>(q(),G)),Promise.resolve().then(()=>(z(),H)),Promise.resolve().then(()=>(A(),Q)),Promise.resolve().then(()=>(B(),X)),Promise.resolve().then(()=>(R(),Z)),Promise.resolve().then(()=>(N(),ee)),Promise.resolve().then(()=>(C(),re)),Promise.resolve().then(()=>(J(),te))]),Object.preventExtensions(idb),Object.seal(idb),Object.freeze(idb)))()});var a=l(()=>{m();v();T();O();S();w();j();x();E();V()});a();
+var l=(e,r)=>()=>(e&&(r=e(e=0)),r);var p,h=l(()=>{p={name:"memorio",version:"2.5.3",type:"module",private:!1,main:"index.js",license:"MIT",typings:"./types/*",description:"Memorio, State + Observer and Store for an easy life",copyright:"Copyright (c) 2025 Dario Passariello",homepage:"https://a51.gitbook.io/memorio",author:{name:"Dario Passariello",url:"https://dario.passariello.ca/",email:"[e-mail]"},support:{name:"Dario Passariello",url:"https://github.com/passariello/",email:"[e-mail]"},contributors:[{name:"Dario Passariello",email:"[e-mail]"},{name:"Valeria Cala Scaglitta",email:"[e-mail]"}],keywords:["biglogic","a51","memorio","state","store","observer","useObserver","dario","passariello"],funding:[{type:"patreon",url:"https://www.patreon.com/passariello"}],typing:["types/*"],exports:{".":{types:"./types/index.d.ts",import:"./index.js",default:"./index.js"},"./types/*":"./types/*"},scripts:{build:"rimraf dist && node ./esbuild.config.mjs",watch:'rimraf dist && nodemon --watch * --exec "npm run build "',"npm:publish":"npm run build && npm publish ./dist",test:"cd tests && npm run test",lint:"cd tests && npm run lint",tsc:"tsc --noEmit"},devDependencies:{"@types/node":"25.3.3",esbuild:"0.27.3","esbuild-node-externals":"1.20.1","esbuild-plugin-alias":"0.2.1","esbuild-plugin-copy":"2.1.1",rimraf:"6.1.3",typescript:"5.9.3"}}});var y,m=l(()=>{"use strict";a();h();Object.defineProperty(globalThis,"memorio",{value:{},writable:!1,configurable:!0,enumerable:!1});Object.defineProperty(globalThis,"events",{value:{},writable:!0,enumerable:!1});Object.defineProperty(memorio,"version",{writable:!1,enumerable:!1,value:p.version});y=["list","state","store","idb","observer","useObserver","remove","removeAll"]});var v=l(()=>{"use strict";a();Object.defineProperty(memorio,"dispatch",{writable:!1,enumerable:!1,value:{set:(e,r={})=>{globalThis.dispatchEvent(new CustomEvent(String(e),r))},listen:(e,r=null,o=!1)=>{globalThis.observer?.list?.[e]?.length>0&&globalThis.observer?.remove?.(e);let i=r?t=>setTimeout(()=>r(t),1):void 0;i&&globalThis.addEventListener(e,i),i&&(globalThis.events[e]=i)},remove:e=>{let r=globalThis.events?.[e];r&&(globalThis.removeEventListener(e,r),delete globalThis.events[e])}}})});var T=l(()=>{"use strict";a();memorio.propertyName=(e,r)=>String(r).replace("() => ","")});var P,O=l(()=>{"use strict";a();m();Object.defineProperty(memorio,"objPath",{writable:!1,enumerable:!1,value:(e,r,o=".")=>{let i=r.concat(e).join(o);return globalThis.memorio._tracking&&globalThis.memorio._trackedPaths?.add("state."+i),i}});globalThis.memorio._tracking=!1;globalThis.memorio._trackedPaths=new Set;globalThis.memorio._locked=!1;P=(e,r,o=[])=>{let i=t=>{try{globalThis.memorio?.dispatch?.set?.(t,{detail:{name:t}})}catch{}};return new Proxy(e,{get(t,s){if(s==="__path")return o.length>0?"state."+o.join("."):"state";if(s==="list")return console.debug('Some state could be hidden when you use "state.list". Use "state" to see the complete list '),JSON.parse(JSON.stringify(globalThis.state));if(globalThis.memorio._tracking&&typeof s=="string"){let n=o.length>0?"state."+o.concat(s).join("."):"state."+s;globalThis.memorio._trackedPaths?.add(n)}if(s==="remove")return n=>(delete t[n],!0);if(s==="removeAll")return()=>{try{for(let n in t)typeof t[n]!="function"&&!["list","remove","removeAll"].includes(n)&&(Object.isFrozen(t[n])||delete t[n],delete t[n])}catch(n){console.debug(n)}};if(Object.isFrozen(t[s]))return t[s];if(s==="lock"||s==="unlock"){let n=Reflect.get(t,s);if(n)return n}try{let n=Reflect.get(t,s);return n&&typeof n=="object"&&["Array","Object"].includes(n.constructor.name)?P(n,r,o.concat(s)):n}catch(n){console.error("Error: ",n);return}},set(t,s,n){if(globalThis.memorio._locked)return console.error("Error: state is locked. Use state.unlock() to enable modifications."),!1;if(y.includes(s))return console.error("key "+s+" is protected"),!1;if(t[s]&&typeof t[s]=="object"&&Object.isFrozen(t[s]))return console.error(`Error: state '${s}' is locked`),!1;if(t[s]&&typeof t[s]=="object"&&t[s].__locked)return console.error(`Error: state '${s}' is locked. Use state.${s}.unlock() to enable modifications.`),!1;try{let u=globalThis.memorio.objPath?.(s,o)??s;if(r({action:"set",path:u,target:t,newValue:n,previousValue:Reflect.get(t,s)}),i("state."+u),Reflect.set(t,s,n),t[s]&&typeof t[s]=="object"){let b=t[s];if(b&&typeof b=="object")try{Object.defineProperty(b,"__locked",{writable:!0,enumerable:!1,configurable:!1,value:!1}),Object.defineProperty(b,"lock",{writable:!1,enumerable:!1,configurable:!1,value:()=>{Object.defineProperty(b,"__locked",{writable:!0,enumerable:!1,configurable:!1,value:!0}),console.info(`State '${s}' is now locked.`)}}),Object.defineProperty(b,"unlock",{writable:!1,enumerable:!1,configurable:!1,value:()=>{Object.defineProperty(b,"__locked",{writable:!0,enumerable:!1,configurable:!1,value:!1}),console.info(`State '${s}' is now unlocked.`)}})}catch{}}return!0}catch(u){return console.error("Error in set trap:",u),!1}},deleteProperty(t,s){try{let n=globalThis.memorio.objPath?.(s,o);return r({action:"delete",path:n,target:t}),Reflect.deleteProperty(t,s)}catch(n){return console.error("Error in deleteProperty trap:",n),!1}},ownKeys(t){return Reflect.ownKeys(t)},getOwnPropertyDescriptor(t,s){return Reflect.getOwnPropertyDescriptor(t,s)}})};globalThis?.state?globalThis.state=state:globalThis.state=P({},()=>{});globalThis.state.lock=()=>{globalThis.memorio._locked=!0,console.info("State is now locked. All modifications are blocked.")};globalThis.state.unlock=()=>{globalThis.memorio._locked=!1,console.info("State is now unlocked. Modifications are allowed.")};Object.defineProperty(globalThis,"state",{enumerable:!1,configurable:!0})});var F,S=l(()=>{"use strict";a();globalThis.observer||(globalThis.observer=null);Object.defineProperty(globalThis,"observer",{enumerable:!1,configurable:!0});F=(e,r=null,o=!0)=>{console.warn('DEPRECATED: "observer" is deprecated and will be removed in future versions. Please use "useObserver" instead.');try{if(!(t=>t.split(".")[0]!=="state"?(console.error(`Observer Error: You need to declare 'state.' or 'store.'. The '${t}' string is incorrect!`),!1):!0)(e))return}catch(i){console.error(i);return}if(!e&&!r){console.error("Observer Error: You need to setup observer correctly, Some parameters are missed!");return}if(!e&&r){console.error("Observer Error: You need to declare what state need to be monitored as string like 'state.test'.");return}if(e&&!r){let i=(String(e),{detail:{name:String(e)}}),t=globalThis.observer;t?.list?.[e]&&globalThis.memorio.dispatch.remove(i),t?.list?.[e]||globalThis.memorio.dispatch.listen(i),console.debug("called: ",e);return}if(e&&r){if(typeof e!="string"||typeof r!="function"){console.error("Observer Error: name of state need to be a 'string' like 'state.test' and the callback need to be a 'function'");return}let i=globalThis.observer;i?.list?.[e]&&globalThis.memorio.dispatch.remove(e,r,o),i?.list?.[e]||globalThis.memorio.dispatch.listen(e,r,o);return}};globalThis.observer=F;Object.defineProperties(globalThis.observer,{list:{get:()=>globalThis.events},remove:{value:e=>{e&&(globalThis.memorio.dispatch.remove(e),delete globalThis.events[e])}},removeAll:{get:()=>{let e=globalThis.observer,r=e?.list;return r&&Object.keys(r).forEach(o=>{e?.remove?.(o)}),!0}}});Object.freeze(observer)});var w=l(()=>{"use strict";a();globalThis.useObserver||(globalThis.useObserver=null);Object.defineProperty(globalThis,"useObserver",{value:null,writable:!0,enumerable:!1,configurable:!0});globalThis.useObserver=((e,r)=>{if(!r||typeof e!="function")return()=>{};let o=[],i=Array.isArray(r)&&!r.__path?r:[r];try{return i.forEach(t=>{let s="";if(typeof t=="function"){let n=globalThis.memorio.propertyName;if(typeof n=="function"){let u=n(globalThis.state,t);u&&(s=u)}}else typeof t=="object"&&t!==null?s=t.__path||(typeof t.toString=="function"&&t.toString()!=="[object Object]"?t.toString():""):typeof t=="string"&&(t.startsWith("state.")||t.startsWith("store."))&&(s=t);if(s){s=s.replace(/^(\(\)\s*=>\s*)/,"").replace(/^globalThis\./,"").replace(/^state\./,"");let n=s.startsWith("store.")||s.startsWith("state.")?s:"state."+s;globalThis.memorio.dispatch.listen(n,()=>e()),o.push(n)}else{globalThis.memorio._trackedPaths?.clear(),globalThis.memorio._tracking=!0;try{e()}catch{}globalThis.memorio._tracking=!1,globalThis.memorio._trackedPaths?.forEach(n=>{o.includes(n)||(console.info(`useObserver: [Auto-Discovery] -> "${n}"`),globalThis.memorio.dispatch.listen(n,()=>e()),o.push(n))})}}),o.length>0?console.info(`useObserver: Monitoring ${o.length} paths.`):console.warn("useObserver: No paths resolved for monitoring. Check your dependencies!"),()=>{o.forEach(t=>{globalThis.memorio.dispatch&&typeof globalThis.memorio.dispatch.remove=="function"&&(globalThis.memorio.dispatch.remove(t),console.debug(`useObserver: Stopped monitoring "${t}"`))})}}catch(t){return console.debug("useObserver Error:",t),()=>{}}});Object.freeze(globalThis.useObserver)});var j=l(()=>{"use strict";a();Object.defineProperty(globalThis,"store",{value:new Proxy({},{}),enumerable:!1,configurable:!0});Object.defineProperties(store,{get:{value:e=>{if(e){try{let r=globalThis.localStorage.getItem(e);return r&&JSON.parse(r)}catch(r){console.debug(`Error parsing store item '${e}':`,r)}return null}}},set:{value:(e,r)=>{if(e){try{r==null?globalThis.localStorage.setItem(e,JSON.stringify(null)):typeof r=="object"||typeof r=="number"||typeof r=="boolean"||typeof r=="string"?globalThis.localStorage.setItem(e,JSON.stringify(r)):typeof r=="function"&&console.debug("It's not secure to store functions.")}catch(o){console.debug(`Error setting store item '${e}':`,o)}return null}}},remove:{value:e=>{if(e)return globalThis.localStorage.getItem(e)?(globalThis.localStorage.removeItem(e),!0):!1}},delete:{value:e=>(store.remove(e),!0)},removeAll:{value:()=>(globalThis.localStorage.clear(),!0)},clearAll:{value:()=>(store.removeAll(),!0)},quota:{value:async()=>globalThis.navigator&&"storage"in globalThis.navigator&&"estimate"in globalThis.navigator.storage?globalThis.navigator.storage.estimate().then(({usage:e,quota:r})=>{let o=e??0,i=r??0;return o&&i&&console.debug(`Using ${o/1024} out of ${i/1024} Mb.`),[o/1024,i/1024]}).catch(e=>(console.debug("Error estimating quota:",e),[0,0])):[0,0]},size:{value:()=>{let e=0;return Object.keys(globalThis.localStorage).forEach(r=>{let o=globalThis.localStorage.getItem(r);o&&(e+=o.length)}),e}}});Object.freeze(store)});var x=l(()=>{"use strict";a();Object.defineProperty(globalThis,"session",{value:new Proxy({},{}),enumerable:!1,configurable:!0});Object.defineProperties(session,{get:{value:e=>{if(e)try{let r=globalThis.sessionStorage.getItem(e);return r&&JSON.parse(r)}catch(r){console.debug(`Error parsing session item '${e}':`,r)}}},set:{value:(e,r)=>{if(e)try{r==null?globalThis.sessionStorage.setItem(e,JSON.stringify(null)):typeof r=="object"||typeof r=="number"||typeof r=="boolean"||typeof r=="string"?globalThis.sessionStorage.setItem(e,JSON.stringify(r)):typeof r=="function"&&console.debug("It's not secure to session functions.")}catch(o){console.debug(`Error setting session item '${e}':`,o)}}},remove:{value:e=>{if(e&&globalThis.sessionStorage.getItem(e))return globalThis.sessionStorage.removeItem(e),!0}},delete:{value:e=>(session.remove(e),!0)},removeAll:{value:()=>(globalThis.sessionStorage.clear(),!0)},clearAll:{value:()=>(session.removeAll(),!0)},quota:{value:async()=>globalThis.navigator&&"storage"in globalThis.navigator&&"estimate"in globalThis.navigator.storage?globalThis.navigator.storage.estimate().then(({usage:e,quota:r})=>{let o=e??0,i=r??0;return o&&i&&console.debug(`Using ${o/1024} out of ${i/1024} Mb.`),[o/1024,i/1024]}).catch(e=>(console.debug("Error estimating quota:",e),[0,0])):[0,0]},size:{value:()=>{let e=0;return Object.keys(globalThis.sessionStorage).forEach(r=>{let o=globalThis.sessionStorage.getItem(r);o&&(e+=o.length)}),e}}});Object.freeze(session)});var d,E=l(()=>{"use strict";a();d={};Object.defineProperty(globalThis,"cache",{value:new Proxy({},{get(e,r){let o=r;return o==="get"?i=>d[i]:o==="set"?(i,t)=>{d[i]=t}:o==="remove"?i=>(delete d[i],!0):o==="removeAll"?()=>(Object.keys(d).forEach(i=>delete d[i]),!0):o==="clear"?()=>(Object.keys(d).forEach(i=>delete d[i]),!0):d[o]},set(e,r,o){return d[r]=o,!0},deleteProperty(e,r){return delete d[r],!0}}),enumerable:!1,configurable:!0});Object.freeze(cache)});var U={};var D=l(()=>{"use strict";a();idb.db.create=(e,r=1)=>new Promise((o,i)=>{if(!idb.db.support())return i(new Error("IndexedDB not supported"));let t=globalThis.indexedDB.open(e,r);t.onerror=()=>{console.debug(`IndexedDB error: ${t.error?.message}`),i(t.error)},t.onsuccess=()=>{console.debug(`Database ${e} connected successfully`),idb.db.list(),o(t.result)},t.onupgradeneeded=()=>{console.debug(`Database ${e} upgrade/creation initiated`)}})});var W={};var $=l(()=>{"use strict";a();idb.db.list=async()=>{if(!("indexedDB"in globalThis)||!indexedDB.databases)return[];try{let e=await indexedDB.databases();return globalThis.idbases=e||[],await idb.db.size(),globalThis.idbases}catch(e){return console.error("Error listing databases:",e),[]}};idb.db.list()});var Y={};var k=l(()=>{"use strict";a();idb.db.exist=e=>idbases?.some(r=>r.name===e)});var L={};var _=l(()=>{"use strict";a();idb.db.quota=()=>navigator.storage.estimate()});var K={};var I=l(()=>{"use strict";a();idb.db.delete=e=>new Promise((r,o)=>{console.debug(`Removing database ${e}...`);let i=()=>{let t=indexedDB.deleteDatabase(e);t.onsuccess=()=>{console.debug(`${e} database removed successfully`),idb.db.list(),r()},t.onerror=()=>{console.error(`Error removing ${e}:`,t.error),o(t.error)},t.onblocked=()=>{console.warn(`Deletion of ${e} is blocked. Please close other tabs.`)}};confirm(`Are you sure you want to remove the "${e}" database?`)?i():(console.debug("Database deletion cancelled by user."),r())})});var G={};var q=l(()=>{"use strict";a();idb.db.size=async()=>{if(!(!idbases||idbases.length===0))for(let e=0;e<idbases.length;e++){let r=idbases[e];try{let o=await idb.db.create(r.name,r.version),i=Array.from(o.objectStoreNames),t=0;for(let s of i){let n=await idb.table.size(o,s);t+=n}r.size=t,o.close()}catch(o){console.debug(`Could not calculate size for ${r.name}:`,o)}}}});var H={};var z=l(()=>{"use strict";a();idb.db.version=e=>{let r=0;for(let o of idbases){o.name===e&&(r=o.version);break}return r}});var Q={};var A=l(()=>{"use strict";a();idb.db.support=()=>{let e="indexedDB"in globalThis;return e||console.debug("Your environment doesn't support IndexedDB"),e}});var X={};var B=l(()=>{"use strict";a();idb.table.create=(e,r)=>new Promise(async(o,i)=>{try{let s=(Number(idb.db.version(e))||0)+1,n=indexedDB.open(e,s);n.onupgradeneeded=u=>{let b=u.target.result;if(!b.objectStoreNames.contains(r)){let c=b.createObjectStore(r,{keyPath:"id",autoIncrement:!0});c.createIndex("id","id",{unique:!0}),c.createIndex("data","data",{unique:!1}),console.debug(`Table ${r} created in ${e}`)}},n.onsuccess=()=>{n.result.close(),idb.db.list(),o()},n.onerror=()=>{console.error(`Error creating table ${r}:`,n.error),i(n.error)}}catch(t){console.error("Critical error in table.create:",t),i(t)}})});var Z={};var R=l(()=>{"use strict";a();idb.table.size=(e,r)=>new Promise((o,i)=>{if(!e)return i(new Error("Database instance is required"));if(!e.objectStoreNames.contains(r))return o(0);let t=0,s=0,b=e.transaction([r],"readonly").objectStore(r).openCursor();b.onsuccess=async c=>{let g=c.target.result;if(g){try{let f=g.value;t+=JSON.stringify(f).length}catch(f){console.debug("Error stringifying IDB value tracking size:",f)}s++,s%200===0&&await new Promise(f=>setTimeout(f,0)),g.continue()}else o(t)},b.onerror=()=>{i(b.error)}})});var ee={};var N=l(()=>{"use strict";a();idb.data.delete=(e,r,o)=>new Promise((i,t)=>{let s=indexedDB.open(e);s.onsuccess=()=>{let n=s.result;if(!n.objectStoreNames.contains(r))return n.close(),t(new Error(`Table ${r} not found`));let c=n.transaction(r,"readwrite").objectStore(r).delete(o);c.onsuccess=()=>{n.close(),console.debug(`Record ${o} deleted from ${r}`),i()},c.onerror=()=>{n.close(),t(c.error)}},s.onerror=()=>t(s.error)});idb.data.delete.all=(e,r)=>new Promise((o,i)=>{let t=indexedDB.open(e);t.onsuccess=s=>{let n=s.target.result;if(!n.objectStoreNames.contains(r))return n.close(),i(new Error(`Table ${r} not found`));let c=n.transaction(r,"readwrite").objectStore(r).clear();c.onsuccess=()=>{n.close(),console.debug(`All data cleared from ${r}`),o()},c.onerror=()=>{n.close(),i(c.error)}},t.onerror=()=>i(t.error)})});var re={};var C=l(()=>{"use strict";a();idb.data.set=(e,r,o)=>new Promise((i,t)=>{let s=indexedDB.open(e);s.onsuccess=()=>{let n=s.result;if(!n.objectStoreNames.contains(r))return n.close(),t(new Error(`Table ${r} does not exist in ${e}`));let c=n.transaction(r,"readwrite").objectStore(r).put(o);c.onsuccess=()=>{n.close(),console.debug(`Data saved in ${e}.${r}`),i(c.result)},c.onerror=g=>{n.close(),console.debug(`Database insert error: ${c.error?.message}`),t(c.error)}},s.onerror=()=>{t(s.error)}})});var te={};var J=l(()=>{"use strict";a();idb.data.get=(e,r,o)=>new Promise((i,t)=>{let s=indexedDB.open(e);s.onsuccess=n=>{let u=n.target.result;if(!u.objectStoreNames.contains(r))return u.close(),t(new Error(`Table ${r} not found in ${e}`));let g=u.transaction(r,"readonly").objectStore(r).get(o);g.onsuccess=()=>{u.close(),i(g.result)},g.onerror=()=>{u.close(),t(g.error)}},s.onerror=()=>{t(s.error)}})});var V=l(()=>{"use strict";a();(async()=>(Object.defineProperty(globalThis,"idb",{value:{db:{},table:{},data:{}},writable:!0,configurable:!0,enumerable:!1}),Object.defineProperty(globalThis,"idbases",{value:[],writable:!0,configurable:!0,enumerable:!1}),await Promise.all([Promise.resolve().then(()=>(D(),U)),Promise.resolve().then(()=>($(),W)),Promise.resolve().then(()=>(k(),Y)),Promise.resolve().then(()=>(_(),L)),Promise.resolve().then(()=>(I(),K)),Promise.resolve().then(()=>(q(),G)),Promise.resolve().then(()=>(z(),H)),Promise.resolve().then(()=>(A(),Q)),Promise.resolve().then(()=>(B(),X)),Promise.resolve().then(()=>(R(),Z)),Promise.resolve().then(()=>(N(),ee)),Promise.resolve().then(()=>(C(),re)),Promise.resolve().then(()=>(J(),te))]),Object.preventExtensions(idb),Object.seal(idb),Object.freeze(idb)))()});var a=l(()=>{m();v();T();O();S();w();j();x();E();V()});a();

package.json

 {
   "name": "memorio",
-  "version": "2.5.2",
+  "version": "2.5.3",
   "type": "module",
@@ -61,4 +61,4 @@ "private": false,
   "scripts": {
-    "build": "node ./esbuild.config.mjs",
-    "watch": "nodemon --watch * --exec \"npm run build \"",
+    "build": "rimraf dist && node ./esbuild.config.mjs",
+    "watch": "rimraf dist && nodemon --watch * --exec \"npm run build \"",
     "npm:publish": "npm run build && npm publish ./dist",
@@ -75,4 +75,5 @@ "test": "cd tests && npm run test",
     "esbuild-plugin-copy": "2.1.1",
+    "rimraf": "6.1.3",
     "typescript": "5.9.3"
   }
-}
+}

COPYRIGHT.md

-# Copyright
-
-Copyright (c) 2026, Dario Passariello. All rights reserved.
-<https://dario.passariello.ca>
-
-This software is provided "as is", without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose and noninfringement. In no event shall the authors or copyright holders be liable for any claim, damages or other liability, whether in an action of contract, tort or otherwise, arising from, out of or in connection with the software or the use or other dealings in the software.

FUNDING.yml

-# These are supported funding model platforms
-
-github: passariello
-patreon: passariello
-ko_fi: passariello
-liberapay: passariello
-issuehunt: passariello
-custom:
- [
-  "https://dario.passariello.ca",
-  "https://www.indiegogo.com/individuals/28513718",
- ]

index.mjs

-var a=(e,o)=>()=>(e&&(o=e(e=0)),o);var $e={};var N=a(()=>{"use strict";idb.db.create=(e,o=1)=>{idb.db.support();let t=indexedDB.open(e,o);t.onerror=()=>{console.error(`IndexedDB error: ${t.errorCode}`)},t.onsuccess=()=>{console.debug("Successful database connection")},t.onupgradeneeded=()=>{console.debug("Database created")},idb.db.list()}});var ze={};var q=a(()=>{"use strict";idb.db.list=()=>(indexedDB.databases().then(e=>e).then(e=>{e&&(idbases=e)}).catch(e=>{console.error(e)}),idb.db.size(),idbases);setInterval(()=>{idb.db.list()},1e3)});var Re={};var G=a(()=>{"use strict";idb.db.exist=e=>idbases?.find(o=>o.name===e)!==void 0});var Ae={};var H=a(()=>{"use strict";idb.db.quota=()=>navigator.storage.estimate()});var Fe={};var K=a(()=>{"use strict";idb.db.delete=e=>{if(globalThis.memorio?.debug&&console.debug(`Remove ${e}...`),!!idb.db.exist(e))if(typeof globalThis.layerpro=="function"){confirm(`Are you sure to remove "${e}" database?`,()=>{setTimeout(()=>{indexedDB.deleteDatabase(e),console.debug(`${e} removed`),idb.db.list()},1e3)},()=>alert("Operation cancelled."));return}else{confirm(`Are you sure to remove "${e}" database?`)?setTimeout(()=>{indexedDB.deleteDatabase(e),console.debug(`${e} removed`),idb.db.list()},1e3):alert("Operation cancelled.");return}}});var Je={};var U=a(()=>{"use strict";idb.db.size=()=>{idbases?.map(e=>{if(!idb.db.exist(e))return null;let o=dphelper.array.findindex(idbases,e.name),t=indexedDB?.open(e.name,idb.db.version(e.name));return t.onerror=n=>console.error("Error on IndexedDB"),t.onsuccess=n=>{let r=n.target.result,s=[...r.objectStoreNames];((l,u)=>{let m=l.reduce((d,D)=>(d.push(idb.table.size(u,D)),d),[]);m.map(d=>{let D=d.reduce((te,re)=>te+re,0);return Number.parseInt(dphelper.dev.byteSize(D))||0}),idbases[o].size=m.length>0?m:0})(s,r)},null})}});var Be={};var V=a(()=>{"use strict";idb.db.version=e=>{let o=0;for(let t of idbases){t.name===e&&(o=t.version);break}return o}});var Me={};var k=a(()=>{"use strict";idb.db.support=()=>{if("indexedDB"in window)return!0;console.error("Your browser doesn't support IndexedBD")}});var Le={};var _=a(()=>{"use strict";idb.table.create=(e,o)=>{try{let t=Number(idb.db.version(e))+1,n=indexedDB.open(e,t);try{n.onupgradeneeded=r=>{let s=r.target,i=s.result,l=i.createObjectStore(o,{keyPath:"id",unique:!0,autoincrement:!0});l.createIndex("id","id"),l.createIndex("data","data"),i.close(),n?.result?.close(),n=void 0,idb.db.list()}}catch(r){console.error(">>",r);return}}catch(t){console.error(">>>",t);return}return!1}});var Ne={};var W=a(()=>{"use strict";idb.table.size=(e,o)=>(idb.db.list(),new Promise((t,n)=>{if(e==null)return n();let r=event,s=0;e=r.target.result;let i=e.transaction([o]).objectStore(o).openCursor();i.onsuccess=(l=>{let u=l.target.result;if(u){let m=u.value,d=JSON.stringify(m);s+=d.length,u.continue()}else t(s)}),i.onerror=l=>n(`error in ${o}: ${l}`)}))});var qe={};var Y=a(()=>{"use strict";idb.data.delete=(e,o,t)=>{if(!idb.db.exist(e))return;let n=indexedDB.open(e,idb.db.version(e));n.onsuccess=()=>{let r=n.result,s=r.transaction(o,"readwrite");s.objectStore(o).put(t),n.onerror=l=>{console.debug(l,`Database insert error: ${l.target.errorCode}`)},s.onerror=l=>{console.debug(event,`Database insert error: ${l.target.errorCode}`)},r.close(),idb.db.list(),console.debug("Store inserted"),globalThis.memorioIdbTrigger&&globalThis.memorioIdbTrigger()}};idb.data.delete.all=(e,o)=>{idb.db.list();let t=indexedDB.open(e);t.onsuccess=n=>{let s=n.target.result.transaction(o).objectStore(o).set({});s.onsuccess=i=>{globalThis.memorio?.debug&&console.debug(i)}}}});var Ge={};var Q=a(()=>{"use strict";idb.data.set=(e,o,t)=>{if(!idb.db?.exist(e))return;let n=indexedDB.open(e,idb.version(e));n.onsuccess=()=>{let r=n.result,s=r.transaction(o,"readwrite");s.objectStore(o).put(t),n.onerror=l=>{console.debug(l,`Database insert error: ${l.target.errorCode}`)},s.onerror=l=>{console.debug(event,`Database insert error: ${l.target.errorCode}`)},r.close(),idb.databases(),console.debug("IndexDB inserted"),globalThis.memorioIdbTrigger&&globalThis.memorioIdbTrigger()}}});var He={};var X,Z=a(()=>{"use strict";idb.data.get=(e,o,t)=>{idb.db.list();let n=indexedDB.open(e);return n.onsuccess=r=>{let s=r.target.result,i=s.transaction(o).objectStore(o).get(t);i.onsuccess=l=>(X=i.result,i.result)},X}});var F={name:"memorio",version:"3.0.0",type:"module",main:"dist/index.js",module:"dist/index.mjs",license:"MIT",types:"./index.d.ts",typings:"./types/*",description:"Memorio, State + Store for an easy life - Lightweight storage for small projects",copyright:"Copyright (c) 2026 Dario Passariello",homepage:"https://a51.gitbook.io/memorio",author:"Dario Passariello <[e-mail]>",support:{name:"Dario Passariello",url:"https://github.com/passariello/",email:"[e-mail]"},bugs:{url:"https://github.com/passariello/"},contributors:[{name:"Dario Passariello",email:"[e-mail]"},{name:"Valeria Cala Scaglitta",email:"[e-mail]"}],keywords:["biglogic","a51","memorio","state","store"],funding:[{type:"patreon",url:"https://www.patreon.com/passariello"}],typing:["types/*"],exports:{".":{types:"./types/index.d.ts",import:"./dist/index.mjs",default:"./dist/index.js"},"./types/*":"./types/*"},scripts:{build:"rimraf dist && node esbuild.config.mjs",dev:"node esbuild.config.mjs --watch-and-serve","npm:pack":"npm run build && cd dist && npm pack","npm:publish":"npm run build && npm publish ./dist",test:"cd tests && npm run test",lint:"cd tests && npm run lint",tsc:"cd tests && tsc --noEmit"},devDependencies:{"@types/node":"25.3.0",esbuild:"0.27.3","esbuild-node-externals":"1.20.1","esbuild-plugin-alias":"0.2.1","esbuild-plugin-copy":"2.1.1","esbuild-sass-plugin":"3.6.0","esbuild-scss-modules-plugin":"1.1.1","jest-util":"30.2.0",rimraf:"6.1.3","ts-jest":"29.4.6",tsx:"^4.21.0",typescript:"5.9.3"}};var ne=globalThis.memorio||{},y=ne.globals;function ie(e){return y===!1?!1:y&&typeof y=="object"?y[e]!==!1:!0}var le=Symbol("memorio-undefined");globalThis.memorioUNDEFINED=le;ie("memorio")&&(Object.defineProperty(globalThis,"memorio",{value:{},writable:!1,configurable:!0,enumerable:!1}),Object.defineProperty(globalThis,"events",{value:{},writable:!0,enumerable:!1}),Object.defineProperty(memorio,"version",{writable:!1,enumerable:!1,value:F.version}),Object.defineProperty(memorio,"debug",{writable:!0,enumerable:!0,value:!1}));var J=["list","state","store","idb","remove","removeAll"];Object.defineProperty(memorio,"dispatch",{writable:!1,enumerable:!1,value:{set:(e,o={})=>{dispatchEvent(new CustomEvent(String(e),o))},listen:(e,o=null,t=!1)=>{let n=r=>o?setTimeout(()=>o(r),1):null;globalThis.addEventListener(e,n),globalThis.events=globalThis.events||{},globalThis.events[e]=n},remove:e=>{let o=globalThis.events||{};globalThis.removeEventListener(e,o[e]),delete o[e]}}});memorio.propertyName=function(e,o){return String(o).replace("() => ","")};var ae={enabled:!0,logToConsole:!0,modules:["state","store","session","cache","idb"],maxEntries:1e3};function ce(){return globalThis.memorio?.debug===!0}var c={...ae},g=[],ue=e=>{c={...c,...e}},ge=()=>{c.enabled=!0},be=()=>{c.enabled=!1},B=e=>c.enabled&&c.modules.includes(e),de=(e,o,t,n,r)=>{if(!B(e))return;let s={timestamp:new Date().toISOString(),module:e,action:o,path:t,value:n,previousValue:r};if(g.push(s),g.length>c.maxEntries&&g.shift(),c.logToConsole&&ce()){let i=`[Memorio:${e.toUpperCase()}]`,l=fe(e);console.debug(`%c${i}%c ${o} ${t}`,`color: ${l}; font-weight: bold`,"color: inherit"),n!==void 0&&console.debug("  \u2192 value:",n),r!==void 0&&console.debug("  \u2190 previous:",r)}c.customHandler&&c.customHandler(s)},fe=e=>({state:"#4CAF50",store:"#2196F3",session:"#FF9800",cache:"#9C27B0",idb:"#F44336"})[e]||"#888888",me=()=>[...g],pe=()=>{g.length=0},he=()=>{let e={total:g.length,state:0,store:0,session:0,cache:0,idb:0,set:0,get:0,delete:0,clear:0};return g.forEach(o=>{e[o.module]++,e[o.action]++}),e},ye=()=>JSON.stringify(g,null,2);typeof globalThis.memorio<"u"&&Object.defineProperty(globalThis.memorio,"logger",{enumerable:!1,configurable:!0,value:{configure:ue,enable:ge,disable:be,isEnabled:B,log:de,getHistory:me,clearHistory:pe,getStats:he,exportLogs:ye}});var Te=globalThis.memorio||{},T=Te.globals;function ve(e){return T===!1?!1:T&&typeof T=="object"?T[e]!==!1:!0}var v=new Set;function Se(e){return v.add(e),()=>v.delete(e)}var xe=0;var I=Se;function je(){xe++,v.forEach(e=>e())}Object.defineProperty(memorio,"objPath",{writable:!1,enumerable:!1,value:(e,o,t=".")=>o.concat(e).join(t)});var M=(e,o,t=[])=>{let n=r=>{let s=r.split(".");s.forEach((i,l)=>{let u=s.slice(0,l+1).join(".");globalThis.memorio.dispatch.set(u,{detail:{name:u}})})};return new Proxy(e,{get(r,s){if(s==="list")return globalThis.memorio?.debug&&console.debug('Some state could be hidden when you use "state.list". Use "state" to see the complete list '),JSON.parse(JSON.stringify(r));if(s==="remove")return function(i){return delete r[i],!0};if(s==="removeAll")return function(){try{for(let i in r)typeof r[i]!="function"&&!["list","remove","removeAll"].includes(i)&&(Object.isFrozen(r[i])||delete r[i],delete r[i])}catch(i){console.error(i)}};if(Object.isFrozen(r[s]))return r[s];try{let i=Reflect.get(r,s);return i&&typeof i=="object"&&["Array","Object"].includes(i.constructor.name)?M(i,o,t.concat(s)):i}catch(i){console.error("Error: ",i);return}},set(r,s,i){if(J.includes(s))return console.error("key "+s+" is protected"),!1;if(r[s]&&typeof r[s]=="object"&&Object.isFrozen(r[s]))return console.error(`Error: state '${s}' is locked`),!1;try{let l=globalThis.memorio.objPath(s,t);return o({action:"set",path:l,target:r,newValue:i,previousValue:Reflect.get(r,s)}),n("state."+l),v.size>0&&je(),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("state","set",l,i,Reflect.get(r,s)),i===void 0?r[s]=globalThis.memorio:Reflect.set(r,s,i),r[s]&&typeof r[s]=="object"&&Reflect.defineProperty(r[s],"lock",{value(){Object.defineProperty(r,s,{writable:!1,enumerable:!1}),Object.freeze(r[s])}}),!0}catch(l){return console.error("Error in set trap:",l),!1}},deleteProperty(r,s){try{let i=globalThis.memorio.objPath(s,t);return o({action:"delete",path:i,target:r}),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("state","delete",i,void 0,Reflect.get(r,s)),Reflect.deleteProperty(r,s)}catch(i){return console.error("Error in deleteProperty trap:",i),!1}}})},b=M({},()=>{});ve("state")&&(globalThis.state=b,Object.defineProperty(globalThis,"state",{enumerable:!1,configurable:!0}));var Oe=globalThis.memorio||{},S=Oe.globals;function Ce(e){return S===!1?!1:S&&typeof S=="object"?S[e]!==!1:!0}var x=b.subscribers||new Set;function $(){x.forEach(e=>e())}var p=new Proxy({},{});Ce("store")&&Object.defineProperty(globalThis,"store",{value:p,enumerable:!1,configurable:!0});Object.defineProperties(p,{get:{value(e){if(e){try{let o=localStorage.getItem(e);return o&&JSON.parse(o)}catch(o){console.error(`Error parsing store item '${e}':`,o)}return null}}},set:{value(e,o){if(e){try{if(o==null?localStorage.setItem(e,JSON.stringify(null)):typeof o=="object"||typeof o=="number"||typeof o=="boolean"||typeof o=="string"?localStorage.setItem(e,JSON.stringify(o)):typeof o=="function"&&console.error("It's not secure to store functions."),x.size>0&&$(),typeof globalThis.memorio?.logger?.log=="function"){let t=localStorage.getItem(e);globalThis.memorio.logger.log("store","set",e,o,t?JSON.parse(t):void 0)}}catch(t){console.error(`Error setting store item '${e}':`,t)}return null}}},remove:{value(e){if(e){if(localStorage.getItem(e)){let o=localStorage.getItem(e);return localStorage.removeItem(e),x.size>0&&$(),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("store","delete",e,void 0,o?JSON.parse(o):void 0),!0}return!1}}},delete:{value(e){return p.remove(e),!0}},removeAll:{value(){return localStorage.clear(),x.size>0&&$(),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("store","clear","*"),!0}},clearAll:{value(){return p.removeAll(),!0}},quota:{value(){"storage"in navigator&&"estimate"in navigator.storage&&navigator.storage.estimate().then(({usage:e,quota:o})=>{if(e&&o)return console.debug(`Using ${e/1024} out of ${o/1024} Mb.`),[e/1024,o/1024]}).catch(e=>{console.error("Error estimating quota:",e)})}},size:{value(){let e=0;for(let o in localStorage)if(Object.prototype.hasOwnProperty.call(localStorage,o)){let t=localStorage.getItem(o);t&&(e+=t.length)}return e}},list:{value(){let e={};for(let o in localStorage)if(Object.prototype.hasOwnProperty.call(localStorage,o))try{e[o]=JSON.parse(localStorage.getItem(o)||"null")}catch{e[o]=localStorage.getItem(o)}return e}}});Object.freeze(p);var we=globalThis.memorio||{},j=we.globals;function Ee(e){return j===!1?!1:j&&typeof j=="object"?j[e]!==!1:!0}var O=b.subscribers||new Set;function z(){O.forEach(e=>e())}var L=new Proxy({},{});Ee("session")&&Object.defineProperty(globalThis,"session",{value:L,enumerable:!1,configurable:!0});Object.defineProperties(L,{get:{value(e){if(e)try{let o=sessionStorage.getItem(e);return o&&JSON.parse(o)}catch(o){console.error(`Error parsing session item '${e}':`,o)}}},set:{value(e,o){if(e)try{if(o==null?sessionStorage.setItem(e,JSON.stringify(null)):typeof o=="object"||typeof o=="number"||typeof o=="boolean"||typeof o=="string"?sessionStorage.setItem(e,JSON.stringify(o)):typeof o=="function"&&console.error("It's not secure to session functions."),O.size>0&&z(),typeof globalThis.memorio?.logger?.log=="function"){let t=sessionStorage.getItem(e);globalThis.memorio.logger.log("session","set",e,o,t?JSON.parse(t):void 0)}}catch(t){console.error(`Error setting session item '${e}':`,t)}}},remove:{value(e){if(e&&sessionStorage.getItem(e)){let o=sessionStorage.getItem(e);return sessionStorage.removeItem(e),O.size>0&&z(),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("session","delete",e,void 0,o?JSON.parse(o):void 0),!0}}},delete:{value(e){return session.remove(e),!0}},removeAll:{value(){return sessionStorage.clear(),O.size>0&&z(),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("session","clear","*"),!0}},clearAll:{value(){return session.removeAll(),!0}},quota:{value(){"storage"in navigator&&"estimate"in navigator.storage&&navigator.storage.estimate().then(({usage:e,quota:o})=>{e&&o&&console.debug(`Using ${e/1024} out of ${o/1024} Mb.`)}).catch(e=>{console.error("Error estimating quota:",e)})}},size:{value(){let e=0;for(let o in sessionStorage)if(Object.prototype.hasOwnProperty.call(sessionStorage,o)){let t=sessionStorage.getItem(o);t&&(e+=t.length)}return e}},list:{value(){let e={};for(let o in sessionStorage)if(Object.prototype.hasOwnProperty.call(sessionStorage,o))try{e[o]=JSON.parse(sessionStorage.getItem(o)||"null")}catch{e[o]=sessionStorage.getItem(o)}return e}}});Object.freeze(session);var Pe=globalThis.memorio||{},C=Pe.globals;function De(e){return C===!1?!1:C&&typeof C=="object"?C[e]!==!1:!0}var w=b.subscribers||new Set;function R(){w.forEach(e=>e())}var Ie=new Proxy({},{set(e,o,t){let n=e[o];return e[o]=t,w.size>0&&R(),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("cache","set",String(o),t,n),!0},deleteProperty(e,o){let t=e[o];return delete e[o],w.size>0&&R(),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("cache","delete",String(o),void 0,t),!0},get(e,o){return o==="clear"?()=>{Object.keys(e).forEach(t=>{delete e[t]}),w.size>0&&R(),typeof globalThis.memorio?.logger?.log=="function"&&globalThis.memorio.logger.log("cache","clear","*")}:e[o]}});De("cache")&&Object.defineProperty(globalThis,"cache",{value:Ie,enumerable:!1,configurable:!0});var Ke=globalThis.memorio||{},E=Ke.globals;function ee(e){return E===!1?!1:E&&typeof E=="object"?E[e]!==!1:!0}var oe=(()=>{let e=null,o=0;if(typeof globalThis.useEffect<"u")try{let t=globalThis.React;if(t&&t.useState){let[,n]=t.useState(0);e=()=>{o++,n(o)}}}catch{}return e})();globalThis.memorioIdbTrigger=()=>{oe&&oe()};(()=>{ee("idb")&&(Object.defineProperty(window,"idb",{value:{db:{},table:{},data:{}},writable:!0,configurable:!0,enumerable:!1}),Object.defineProperty(window,"idbases",{value:[],writable:!0,configurable:!0,enumerable:!1}));let e={db:{},table:{},data:{}};Promise.resolve().then(()=>N()),Promise.resolve().then(()=>q()),Promise.resolve().then(()=>G()),Promise.resolve().then(()=>H()),Promise.resolve().then(()=>K()),Promise.resolve().then(()=>U()),Promise.resolve().then(()=>V()),Promise.resolve().then(()=>k()),Promise.resolve().then(()=>_()),Promise.resolve().then(()=>W()),Promise.resolve().then(()=>Y()),Promise.resolve().then(()=>Q()),Promise.resolve().then(()=>Z()),ee("idb")&&(Object.preventExtensions(e),Object.seal(e),Object.freeze(e))})();var Ue=globalThis.memorio||{},P=Ue.globals;function Ve(e){return P===!1?!1:P&&typeof P=="object"?P[e]!==!1:!0}function f(){return globalThis.memorio?.debug===!0}var ke=()=>{f()&&(console.debug("%c\u{1F9E0} Memorio State Inspector","font-size: 16px; font-weight: bold; color: #4CAF50"),console.debug(""),globalThis.state&&(console.debug("%c\u{1F4E6} STATE","color: #4CAF50; font-weight: bold"),console.table(globalThis.state.list?globalThis.state.list():globalThis.state),console.debug("")),globalThis.store&&(console.debug("%c\u{1F3EA} STORE","color: #2196F3; font-weight: bold"),console.table(globalThis.store.list?globalThis.store.list():globalThis.store),console.debug("")),globalThis.session&&(console.debug("%c\u{1F510} SESSION","color: #FF9800; font-weight: bold"),console.table(globalThis.session.list?globalThis.session.list():globalThis.session),console.debug("")),globalThis.cache&&(console.debug("%c\u26A1 CACHE","color: #9C27B0; font-weight: bold"),console.table(globalThis.cache.list?globalThis.cache.list():globalThis.cache),console.debug("")))},_e=()=>{let e=o=>{if(!o)return 0;if(typeof o.list=="function"){let t=o.list();return Object.keys(t).length}return Object.keys(o).length};return{stateKeys:e(globalThis.state),storeKeys:e(globalThis.store),sessionKeys:e(globalThis.session),cacheKeys:e(globalThis.cache),idbDatabases:0,lastUpdate:new Date().toISOString()}},h=e=>{globalThis[e]&&typeof globalThis[e].clear=="function"?(globalThis[e].clear(),f()&&console.debug(`%c\u2713 Cleared ${e}`,"color: #4CAF50")):console.error(`Module ${e} not found or does not support clear()`)},We=()=>{h("state"),h("store"),h("session"),h("cache"),f()&&console.debug("%c\u2713 Cleared all Memorio modules","color: #4CAF50; font-weight: bold")},Ye=(e,o)=>{if(!f())return;console.debug(`%c\u{1F441} Watching ${e}.${o}`,"color: #FF9800");let t=globalThis[e];if(t){let n=t[o];n!==void 0&&Object.defineProperty(t,o,{get:function(){return console.debug(`%c\u{1F441} Access: ${e}.${o}`,"color: #FF9800"),n},set:function(r){return console.debug(`%c\u{1F441} Change: ${e}.${o} =`,"color: #FF9800",r),r}})}},Qe=()=>{let e={state:globalThis.state?.list?globalThis.state.list():globalThis.state,store:globalThis.store?.list?globalThis.store.list():globalThis.store,session:globalThis.session?.list?globalThis.session.list():globalThis.session,cache:globalThis.cache?.list?globalThis.cache.list():globalThis.cache,exportedAt:new Date().toISOString()};return JSON.stringify(e,null,2)},Xe=e=>{try{let o=JSON.parse(e);o.state&&Object.entries(o.state).forEach(([t,n])=>{globalThis.state&&(globalThis.state[t]=n)}),o.store&&Object.entries(o.store).forEach(([t,n])=>{globalThis.store&&(globalThis.store[t]=n)}),o.session&&Object.entries(o.session).forEach(([t,n])=>{globalThis.session&&(globalThis.session[t]=n)}),o.cache&&Object.entries(o.cache).forEach(([t,n])=>{globalThis.cache&&(globalThis.cache[t]=n)}),f()&&console.debug("%c\u2713 Data imported successfully","color: #4CAF50")}catch(o){console.error("%c\u2717 Import failed:","color: #F44336",o)}},Ze=()=>{f()&&console.debug(`
-%c\u{1F9E0} Memorio DevTools Help
-
-Available commands:
-  memorio.devtools.inspect()     - Inspect all state modules
-  memorio.devtools.stats()       - Show statistics
-  memorio.devtools.clear('module') - Clear specific module
-  memorio.devtools.clearAll()   - Clear all modules
-  memorio.devtools.watch('module', 'path') - Watch a path
-  memorio.devtools.exportData() - Export all data as JSON
-  memorio.devtools.importData(json) - Import data from JSON
-  memorio.devtools.help()       - Show this help
-
-Shortcuts:
-  state    - globalThis.state
-  store    - globalThis.store
-  session  - globalThis.session
-  cache    - globalThis.cache
-
-Shortcuts are also available in console as:
-  $state, $store, $session, $cache
-`,"font-family: monospace; font-size: 12px")};typeof globalThis.memorio<"u"&&Object.defineProperty(globalThis.memorio,"devtools",{enumerable:!1,configurable:!0,value:{inspect:ke,stats:_e,clear:h,clearAll:We,watch:Ye,exportData:Qe,importData:Xe,help:Ze}});Ve("devtools")&&(Object.defineProperty(globalThis,"$state",{get:()=>globalThis.state,configurable:!0}),Object.defineProperty(globalThis,"$store",{get:()=>globalThis.store,configurable:!0}),Object.defineProperty(globalThis,"$session",{get:()=>globalThis.session,configurable:!0}),Object.defineProperty(globalThis,"$cache",{get:()=>globalThis.cache,configurable:!0}),globalThis.memorio?.debug&&console.debug("%c\u{1F9E0} Memorio DevTools loaded. Type memorio.devtools.help() for info.","color: #4CAF50; font-weight: bold"));function A(){let e=globalThis.React;if(!e)throw new Error("React not found. Make sure React is installed and memorio is imported in a React app.");return e}function eo(){return A().createContext(null)}function oo({children:e}){let o=A(),[,t]=o.useState(0);o.useEffect(()=>I(()=>{t(s=>s+1)}),[]);let n=eo();return o.createElement(n.Provider,{value:!0},e)}function to(){let e=A(),[,o]=e.useState(0);e.useEffect(()=>I(()=>{o(n=>n+1)}),[])}function ro(){return globalThis.state}export{oo as MemorioProvider,ro as useMemorio,to as useMemorioState};
-//# sourceMappingURL=index.mjs.map

SECURITY.md

-# Security
-
-Please email [@passariello](https://github.com/passariello) or see https://dario.passariello.ca/contact/ if you have a potential security vulnerability to report.

New alerts

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Fixed alerts

Long strings

Supply chain risk

Contains long string literals, which may be a sign of obfuscated or packed code.

Found 1 instance in 1 package

Minified code

Quality

This package contains minified code. This may be harmless in some cases where minified code is included in packaged libraries, however packages on npm should not minify code.

Found 1 instance in 1 package

URL strings

Supply chain risk

Package contains fragments of external URLs or IP addresses, which the package may be accessing at runtime.

Found 1 instance in 1 package

Improved metrics

Number of package files

31

63.16%

Lines of code

1076

79.93%

Number of low quality alerts

1

-50%

Number of low supply chain risk alerts

3

-50%

Worsened metrics

Total package byte prevSize

84684

-64.57%

Dev dependency count

7

16.67%

No dependency changes