memorio 2.9.1 → 3.0.1

package/examples/basic.ts

@@ -16,23 +16,23 @@ import 'memorio'
 // PLATFORM DETECTION
 // ============================================
 
-console.log('=== Platform Detection ===')
-console.log('Memorio version:', memorio.version)
+console.debug('=== Platform Detection ===')
+console.debug('Memorio version:', memorio.version)
 
 // Check platform
 if (memorio.isBrowser()) {
-  console.log('Platform: Browser')
+  console.debug('Platform: Browser')
 } else if (memorio.isNode()) {
-  console.log('Platform: Node.js')
+  console.debug('Platform: Node.js')
 } else if (memorio.isDeno()) {
-  console.log('Platform: Deno')
+  console.debug('Platform: Deno')
 } else if (memorio.isEdge()) {
-  console.log('Platform: Edge Worker')
+  console.debug('Platform: Edge Worker')
 }
 
 // Get capabilities
 const caps = memorio.getCapabilities()
-console.log('Capabilities:', {
+console.debug('Capabilities:', {
   platform: caps.platform,
   hasLocalStorage: caps.hasLocalStorage,
   hasSessionStorage: caps.hasSessionStorage,
@@ -43,7 +43,7 @@ console.log('Capabilities:', {
 // STATE - In-memory reactive state
 // ============================================
 
-console.log('\n=== State Management ===')
+console.debug('\n=== State Management ===')
 
 // Set some state values
 state.name = 'Mario'
@@ -55,21 +55,21 @@ state.profile = {
 }
 
 // Get state values
-console.log('Name:', state.name)
-console.log('Age:', state.age)
-console.log('Profile:', state.profile)
+console.debug('Name:', state.name)
+console.debug('Age:', state.age)
+console.debug('Profile:', state.profile)
 
 // List all states
-console.log('All states:', state.list)
+console.debug('All states:', state.list)
 
 // ============================================
 // STORE - Persistent localStorage
 // ============================================
 
-console.log('\n=== Store (Persistent Storage) ===')
+console.debug('\n=== Store (Persistent Storage) ===')
 
 // Check persistence
-console.log('Is persistent:', store.isPersistent) // true in browser, false in Node.js/Deno
+console.debug('Is persistent:', store.isPersistent) // true in browser, false in Node.js/Deno
 
 // Save to localStorage
 store.set('username', 'mario')
@@ -77,28 +77,28 @@ 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'))
+console.debug('Username:', store.get('username'))
+console.debug('Preferences:', store.get('preferences'))
 
 // Get storage size
-console.log('Storage size:', store.size(), 'bytes')
+console.debug('Storage size:', store.size(), 'bytes')
 
 // ============================================
 // SESSION - Temporary session storage
 // ============================================
 
-console.log('\n=== Session (Temporary Storage) ===')
+console.debug('\n=== Session (Temporary Storage) ===')
 
 // Check persistence
-console.log('Is persistent:', session.isPersistent) // true in browser, false in Node.js/Deno
+console.debug('Is persistent:', session.isPersistent) // true in browser, false in Node.js/Deno
 
 // 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'))
+console.debug('Token:', session.get('token'))
+console.debug('User ID:', session.get('userId'))
 
 // ============================================
 // CLEANUP
@@ -112,4 +112,4 @@ session.remove('token')
 store.removeAll()
 session.removeAll()
 
-console.log('\nExample complete!')
+console.debug('\nExample complete!')

package/examples/browser-vanilla.html

@@ -350,8 +350,8 @@ Session ID: ${memorio.getCapabilities().sessionId.substring(0, 8)}...
     `.trim()
 
     // Log welcome
-    console.log('🧠 Memorio loaded!')
-    console.log('Platform:', memorio.getCapabilities().platform)
+    console.debug('🧠 Memorio loaded!')
+    console.debug('Platform:', memorio.getCapabilities().platform)
   </script>
 </body>
 

package/examples/cache.ts

@@ -19,13 +19,13 @@ 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'))
+console.debug('Username:', cache.get('username'))
+console.debug('Score:', cache.get('score'))
+console.debug('Player:', cache.get('player'))
 
 // Direct property access
 cache.tempData = 'Hello'
-console.log('Temp data:', cache.tempData)
+console.debug('Temp data:', cache.tempData)
 
 // ============================================
 // CACHE WITH OBJECTS
@@ -40,8 +40,8 @@ cache.set('gameState', {
 })
 
 const gameState = cache.get('gameState')
-console.log('Game level:', gameState?.level)
-console.log('Inventory:', gameState?.inventory)
+console.debug('Game level:', gameState?.level)
+console.debug('Inventory:', gameState?.inventory)
 
 // ============================================
 // CACHE SIZE
@@ -52,7 +52,7 @@ for (let i = 0; i < 10; i++) {
   cache.set(`item_${i}`, { id: i, data: `item-${i}` })
 }
 
-console.log('Cache keys:', Object.keys(cache))
+console.debug('Cache keys:', Object.keys(cache))
 
 // ============================================
 // CLEANUP
@@ -67,6 +67,6 @@ cache.removeAll()
 // Or use clearAll alias
 // cache.clearAll()
 
-console.log('Cache after clear:', cache.get('score'))
+console.debug('Cache after clear:', cache.get('score'))
 
-console.log('Cache example complete!')
+console.debug('Cache example complete!')

package/examples/idb.ts

@@ -14,7 +14,7 @@ import 'memorio'
 // ============================================
 
 if (!idb.db.support()) {
-  console.log('IndexedDB not supported')
+  console.debug('IndexedDB not supported')
   process.exit(0)
 }
 
@@ -68,10 +68,10 @@ idb.data.set('myApp', 'products', {
 // ============================================
 
 const user1 = idb.data.get('myApp', 'users', 1)
-console.log('User 1:', user1)
+console.debug('User 1:', user1)
 
 const product1 = idb.data.get('myApp', 'products', 1)
-console.log('Product 1:', product1)
+console.debug('Product 1:', product1)
 
 // ============================================
 // DATABASE INFO
@@ -79,19 +79,19 @@ console.log('Product 1:', product1)
 
 // List all databases
 const databases = idb.db.list()
-console.log('Databases:', databases)
+console.debug('Databases:', databases)
 
 // Check if database exists
 const exists = idb.db.exist('myApp')
-console.log('myApp exists:', exists)
+console.debug('myApp exists:', exists)
 
 // Get database version
 const version = idb.db.version('myApp')
-console.log('myApp version:', version)
+console.debug('myApp version:', version)
 
 // Get database size
 const size = idb.db.size('myApp')
-console.log('myApp size:', size, 'bytes')
+console.debug('myApp size:', size, 'bytes')
 
 // ============================================
 // DELETE DATA
@@ -106,4 +106,4 @@ idb.data.delete('myApp', 'users', 1)
 // Delete entire database
 // idb.db.delete('myApp');
 
-console.log('IDB example complete!')
+console.debug('IDB example complete!')

package/examples/node-server.ts

@@ -13,14 +13,14 @@ import 'memorio'
 // 1. BASIC USAGE
 // ============================================
 
-console.log('=== 1. Basic Node.js Usage ===')
+console.debug('=== 1. Basic Node.js Usage ===')
 
 // Check platform
-console.log('Platform:', memorio.isNode() ? 'Node.js ✅' : 'Other')
+console.debug('Platform:', memorio.isNode() ? 'Node.js ✅' : 'Other')
 
 // Check persistence (false in Node.js - uses memory fallback)
-console.log('Store persistent:', store.isPersistent)  // false
-console.log('Session persistent:', session.isPersistent)  // false
+console.debug('Store persistent:', store.isPersistent)  // false
+console.debug('Session persistent:', session.isPersistent)  // false
 
 // State works exactly like in browser
 state.appName = 'My Server App'
@@ -30,21 +30,21 @@ state.config = {
   env: 'production'
 }
 
-console.log('App name:', state.appName)
-console.log('Config:', state.config)
+console.debug('App name:', state.appName)
+console.debug('Config:', state.config)
 
 // ============================================
 // 2. CACHE (In-Memory - Perfect for Server)
 // ============================================
 
-console.log('\n=== 2. Cache (In-Memory) ===')
+console.debug('\n=== 2. Cache (In-Memory) ===')
 
 // Cache is perfect for temporary server data
 cache.set('apiResponse', { data: 'cached value' })
 cache.set('userCount', 42)
 
-console.log('Cached API response:', cache.get('apiResponse'))
-console.log('User count:', cache.get('userCount'))
+console.debug('Cached API response:', cache.get('apiResponse'))
+console.debug('User count:', cache.get('userCount'))
 
 // Clear cache when needed
 cache.remove('apiResponse')
@@ -54,14 +54,14 @@ cache.remove('apiResponse')
 // 3. STORE & SESSION (Memory Fallback in Node.js)
 // ============================================
 
-console.log('\n=== 3. Store & Session (Memory Fallback) ===')
+console.debug('\n=== 3. Store & Session (Memory Fallback) ===')
 
 // Store and session work but don't persist (no localStorage in Node.js)
 store.set('serverConfig', { debug: true })
 session.set('requestData', { path: '/api/users' })
 
-console.log('Server config:', store.get('serverConfig'))
-console.log('Request data:', session.get('requestData'))
+console.debug('Server config:', store.get('serverConfig'))
+console.debug('Request data:', session.get('requestData'))
 
 // ⚠️ Data is lost on process restart!
 // For persistence in Node.js, use a database
@@ -70,7 +70,7 @@ console.log('Request data:', session.get('requestData'))
 // 4. CONTEXT ISOLATION (Multi-Tenant)
 // ============================================
 
-console.log('\n=== 4. Context Isolation (Multi-Tenant) ===')
+console.debug('\n=== 4. Context Isolation (Multi-Tenant) ===')
 
 // Create isolated contexts for different tenants/requests
 const userAContext = memorio.createContext('tenant-A')
@@ -86,19 +86,19 @@ userBContext.state.secret = 'Bob secret data'
 userBContext.cache.set('temp', 'B temp data')
 
 // Verify isolation
-console.log('User A name:', userAContext.state.user.name)  // Alice
-console.log('User B name:', userBContext.state.user.name)  // Bob
+console.debug('User A name:', userAContext.state.user.name)  // Alice
+console.debug('User B name:', userBContext.state.user.name)  // Bob
 
 // Global state is separate
-console.log('Global state:', state.appName)  // 'My Server App'
-console.log('User A global secret:', userAContext.state.secret)  // 'Alice secret data'
-console.log('User B global secret:', userBContext.state.secret)  // 'Bob secret data'
+console.debug('Global state:', state.appName)  // 'My Server App'
+console.debug('User A global secret:', userAContext.state.secret)  // 'Alice secret data'
+console.debug('User B global secret:', userBContext.state.secret)  // 'Bob secret data'
 
 // ============================================
 // 5. EXPRESS.JS MIDDLEWARE EXAMPLE
 // ============================================
 
-console.log('\n=== 5. Express.js Middleware Example ===')
+console.debug('\n=== 5. Express.js Middleware Example ===')
 
 /*
 // In a real Express app:
@@ -146,13 +146,13 @@ app.get('/api/user', (req, res) => {
 app.listen(3000)
 */
 
-console.log('See code comments for Express.js integration')
+console.debug('See code comments for Express.js integration')
 
 // ============================================
 // 6. WEBSOCKET EXAMPLE
 // ============================================
 
-console.log('\n=== 6. WebSocket Example ===')
+console.debug('\n=== 6. WebSocket Example ===')
 
 /*
 // For WebSocket connections:
@@ -185,13 +185,13 @@ function handleConnection(ws, userId) {
 }
 */
 
-console.log('See code comments for WebSocket integration')
+console.debug('See code comments for WebSocket integration')
 
 // ============================================
 // 7. JOB QUEUE / WORKER EXAMPLE
 // ============================================
 
-console.log('\n=== 7. Job Queue Example ===')
+console.debug('\n=== 7. Job Queue Example ===')
 
 /*
 // For background jobs:
@@ -230,13 +230,13 @@ async function processJob(jobId, jobData) {
 }
 */
 
-console.log('See code comments for Job Queue integration')
+console.debug('See code comments for Job Queue integration')
 
 // ============================================
 // 8. CLI APPLICATION EXAMPLE
 // ============================================
 
-console.log('\n=== 8. CLI Application ===')
+console.debug('\n=== 8. CLI Application ===')
 
 // Memorio works great in CLI apps too
 state.command = 'build'
@@ -245,43 +245,43 @@ state.options = {
   sourceMap: false
 }
 
-console.log('Command:', state.command)
-console.log('Options:', state.options)
+console.debug('Command:', state.command)
+console.debug('Options:', state.options)
 
 // ============================================
 // 9. PLATFORM DETECTION
 // ============================================
 
-console.log('\n=== 9. Platform Detection ===')
+console.debug('\n=== 9. Platform Detection ===')
 
 const caps = memorio.getCapabilities()
-console.log('Platform:', caps.platform)
-console.log('localStorage:', caps.hasLocalStorage ? '✅' : '❌')
-console.log('sessionStorage:', caps.hasSessionStorage ? '✅' : '❌')
-console.log('IndexedDB:', caps.hasIndexedDB ? '✅' : '❌')
-console.log('Session ID:', caps.sessionId.substring(0, 8) + '...')
+console.debug('Platform:', caps.platform)
+console.debug('localStorage:', caps.hasLocalStorage ? '✅' : '❌')
+console.debug('sessionStorage:', caps.hasSessionStorage ? '✅' : '❌')
+console.debug('IndexedDB:', caps.hasIndexedDB ? '✅' : '❌')
+console.debug('Session ID:', caps.sessionId.substring(0, 8) + '...')
 
 // ============================================
 // 10. CLEANUP
 // ============================================
 
-console.log('\n=== 10. Cleanup ===')
+console.debug('\n=== 10. Cleanup ===')
 
 // List all contexts
-console.log('Active contexts:', memorio.listContexts())
+console.debug('Active contexts:', memorio.listContexts())
 
 // Clean up when done
 memorio.deleteContext('tenant-A')
 memorio.deleteContext('tenant-B')
 
-console.log('After cleanup:', memorio.listContexts())
+console.debug('After cleanup:', memorio.listContexts())
 
 // ============================================
 // SUMMARY
 // ============================================
 
-console.log('\n=== Summary ===')
-console.log(`
+console.debug('\n=== Summary ===')
+console.debug(`
 MEMORIO NODE.JS USAGE:
 
 ✅ WORKS:
@@ -305,4 +305,4 @@ MEMORIO NODE.JS USAGE:
    5. Check isPersistent before relying on persistence
 `)
 
-console.log('\nNode.js example complete!')
+console.debug('\nNode.js example complete!')

package/examples/observer.ts

@@ -15,7 +15,7 @@ import 'memorio'
 
 // Watch a single value
 observer('state.counter', (newValue, oldValue) => {
-  console.log(`Counter: ${oldValue} → ${newValue}`)
+  console.debug(`Counter: ${oldValue} → ${newValue}`)
 })
 
 state.counter = 0
@@ -28,7 +28,7 @@ state.counter = 2
 
 // Watch entire objects
 observer('state.user', (newUser, oldUser) => {
-  console.log(`User changed: ${oldUser?.name} → ${newUser?.name}`)
+  console.debug(`User changed: ${oldUser?.name} → ${newUser?.name}`)
 })
 
 state.user = { name: 'Mario', level: 1 }
@@ -40,11 +40,11 @@ state.user = { name: 'Luigi', level: 2 }
 
 // Multiple observers on same path
 observer('state.notifications', (count) => {
-  console.log(`New notification count: ${count}`)
+  console.debug(`New notification count: ${count}`)
 })
 
 // List all observers
-console.log('Active observers:', observer.list)
+console.debug('Active observers:', observer.list)
 
 // ============================================
 // CLEANUP
@@ -57,4 +57,4 @@ observer.remove('state.counter')
 // observer.remove('state.counter')
 // observer.remove('state.notifications')
 
-console.log('Observer example complete!')
+console.debug('Observer example complete!')

package/examples/platform.ts

@@ -15,43 +15,43 @@ import 'memorio'
 // PLATFORM DETECTION
 // ============================================
 
-console.log('=== Platform Detection ===')
-console.log('Memorio version:', memorio.version)
+console.debug('=== Platform Detection ===')
+console.debug('Memorio version:', memorio.version)
 
 // Check which platform we're on
 if (memorio.isBrowser()) {
-  console.log('Running in: Browser')
-  console.log('store.isPersistent:', store.isPersistent) // true
-  console.log('session.isPersistent:', session.isPersistent) // true
+  console.debug('Running in: Browser')
+  console.debug('store.isPersistent:', store.isPersistent) // true
+  console.debug('session.isPersistent:', session.isPersistent) // true
 } else if (memorio.isNode()) {
-  console.log('Running in: Node.js')
-  console.log('store.isPersistent:', store.isPersistent) // false (memory fallback)
-  console.log('session.isPersistent:', session.isPersistent) // false (memory fallback)
+  console.debug('Running in: Node.js')
+  console.debug('store.isPersistent:', store.isPersistent) // false (memory fallback)
+  console.debug('session.isPersistent:', session.isPersistent) // false (memory fallback)
 } else if (memorio.isDeno()) {
-  console.log('Running in: Deno')
-  console.log('store.isPersistent:', store.isPersistent) // false (memory fallback)
-  console.log('session.isPersistent:', session.isPersistent) // false (memory fallback)
+  console.debug('Running in: Deno')
+  console.debug('store.isPersistent:', store.isPersistent) // false (memory fallback)
+  console.debug('session.isPersistent:', session.isPersistent) // false (memory fallback)
 } else if (memorio.isEdge()) {
-  console.log('Running in: Edge Worker')
-  console.log('store.isPersistent:', store.isPersistent) // true
-  console.log('session.isPersistent:', session.isPersistent) // true
+  console.debug('Running in: Edge Worker')
+  console.debug('store.isPersistent:', store.isPersistent) // true
+  console.debug('session.isPersistent:', session.isPersistent) // true
 }
 
 // Get detailed capabilities
 const caps = memorio.getCapabilities()
-console.log('\nCapabilities:')
-console.log('  Platform:', caps.platform)
-console.log('  localStorage:', caps.hasLocalStorage ? '✅' : '❌')
-console.log('  sessionStorage:', caps.hasSessionStorage ? '✅' : '❌')
-console.log('  IndexedDB:', caps.hasIndexedDB ? '✅' : '❌')
-console.log('  Session ID:', caps.sessionId)
+console.debug('\nCapabilities:')
+console.debug('  Platform:', caps.platform)
+console.debug('  localStorage:', caps.hasLocalStorage ? '✅' : '❌')
+console.debug('  sessionStorage:', caps.hasSessionStorage ? '✅' : '❌')
+console.debug('  IndexedDB:', caps.hasIndexedDB ? '✅' : '❌')
+console.debug('  Session ID:', caps.sessionId)
 
 // ============================================
 // CONTEXT ISOLATION (Server-Side)
 // ============================================
 
-console.log('\n=== Context Isolation ===')
-console.log('Use memorio.createContext() for multi-tenant server applications')
+console.debug('\n=== Context Isolation ===')
+console.debug('Use memorio.createContext() for multi-tenant server applications')
 
 // Example: Simulating different users/requests
 // In a real app, you'd create a context per HTTP request
@@ -69,33 +69,33 @@ userBContext.store.set('preferences', { theme: 'light' })
 userBContext.session.set('token', 'user-B-token')
 
 // Verify isolation - each context has its own data
-console.log('\nUser A context:')
-console.log('  state.name:', userAContext.state.name) // 'Mario'
-console.log('  store.preferences:', userAContext.store.get('preferences')) // { theme: 'dark' }
-console.log('  session.token:', userAContext.session.get('token')) // 'user-A-token'
+console.debug('\nUser A context:')
+console.debug('  state.name:', userAContext.state.name) // 'Mario'
+console.debug('  store.preferences:', userAContext.store.get('preferences')) // { theme: 'dark' }
+console.debug('  session.token:', userAContext.session.get('token')) // 'user-A-token'
 
-console.log('\nUser B context:')
-console.log('  state.name:', userBContext.state.name) // 'Luigi'
-console.log('  store.preferences:', userBContext.store.get('preferences')) // { theme: 'light' }
-console.log('  session.token:', userBContext.session.get('token')) // 'user-B-token'
+console.debug('\nUser B context:')
+console.debug('  state.name:', userBContext.state.name) // 'Luigi'
+console.debug('  store.preferences:', userBContext.store.get('preferences')) // { theme: 'light' }
+console.debug('  session.token:', userBContext.session.get('token')) // 'user-B-token'
 
 // Global state is separate from contexts
-console.log('\nGlobal state (not affected by contexts):')
-console.log('  state.name:', state.name) // undefined
+console.debug('\nGlobal state (not affected by contexts):')
+console.debug('  state.name:', state.name) // undefined
 
 // List all contexts
-console.log('\nActive contexts:', memorio.listContexts()) // ['user-A', 'user-B']
+console.debug('\nActive contexts:', memorio.listContexts()) // ['user-A', 'user-B']
 
 // Cleanup - delete a context when done
 memorio.deleteContext('user-A')
-console.log('After deleting user-A:', memorio.listContexts()) // ['user-B']
+console.debug('After deleting user-A:', memorio.listContexts()) // ['user-B']
 
 // ============================================
 // USE CASE: EXPRESS/FASTIFY MIDDLEWARE EXAMPLE
 // ============================================
 
-console.log('\n=== Server Use Case ===')
-console.log(`
+console.debug('\n=== Server Use Case ===')
+console.debug(`
 // Example: Express middleware for request isolation
 app.use((req, res, next) => {
   // Create isolated context per request
@@ -112,4 +112,4 @@ app.get('/user', (req, res) => {
 })
 `)
 
-console.log('\nPlatform & Context example complete!')
+console.debug('\nPlatform & Context example complete!')

package/examples/react-app.tsx

@@ -281,7 +281,7 @@ function App() {
     // Check for returning user
     const lastUser = store.get('lastUser')
     if (lastUser) {
-      console.log('Welcome back,', lastUser)
+      console.debug('Welcome back,', lastUser)
     }
   }, [])
 
@@ -334,12 +334,12 @@ MEMORIO REACT USAGE GUIDE:
 
 4. REACT TO CHANGES:
    useObserver(() => {
-     console.log('State changed!')
+     console.debug('State changed!')
    }, [state.user])
 
 5. AUTO-DISCOVERY (watch all):
    useObserver(() => {
-     console.log(state.user, state.theme)
+     console.debug(state.user, state.theme)
    })
 
 6. PERSIST DATA: