memorio 3.0.0 → 3.0.2

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

@@ -156,6 +156,11 @@ function Cart() {
         </div>
       ))}
       <strong>Total: ${total}</strong>
+      <div style={{ marginTop: '1rem' }}>
+        <AddToCartButton
+          product={{ id: 1, name: 'Sample Product', price: 9.99 }}
+        />
+      </div>
     </div>
   )
 }
@@ -217,7 +222,7 @@ function Notifications() {
 // Settings Component
 // ------------------------------
 function Settings() {
-  const [theme, setTheme] = useState(state.theme)
+  const [theme] = useState(state.theme)
   const [savedSettings, setSavedSettings] = useState<any>(null)
 
   // Load saved settings from store
@@ -281,7 +286,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 +339,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:

package/examples/session-advanced.ts

@@ -13,13 +13,13 @@ import 'memorio'
 // CHECK PERSISTENCE
 // ============================================
 
-console.log('=== Session Persistence Check ===')
-console.log('Is persistent (survives tab close):', session.isPersistent)
+console.debug('=== Session Persistence Check ===')
+console.debug('Is persistent (survives tab close):', session.isPersistent)
 // In browser: true (sessionStorage)
 // In Node.js/Deno: false (memory fallback)
 
 if (!session.isPersistent) {
-  console.log('⚠️ Warning: Using in-memory storage. Data will be lost on process restart!')
+  console.debug('⚠️ Warning: Using in-memory storage. Data will be lost on process restart!')
 }
 
 // ============================================
@@ -33,7 +33,7 @@ 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) + '...')
+  console.debug('User is logged in, token:', token.substring(0, 20) + '...')
 }
 
 // ============================================
@@ -50,7 +50,7 @@ session.set('formDraft', {
 // Restore on page refresh
 const draft = session.get('formDraft')
 if (draft) {
-  console.log('Restored draft:', draft)
+  console.debug('Restored draft:', draft)
 }
 
 // ============================================
@@ -66,14 +66,14 @@ session.set('cart', [
 // Calculate total
 const cart = session.get('cart') || []
 const total = cart.reduce((sum, item) => sum + (item.price * item.qty), 0)
-console.log('Cart total:', total)
+console.debug('Cart total:', total)
 
 // ============================================
 // SESSION SIZE
 // ============================================
 
 // Get session storage size
-console.log('Session size:', session.size(), 'bytes')
+console.debug('Session size:', session.size(), 'bytes')
 
 // ============================================
 // CLEANUP
@@ -88,4 +88,4 @@ session.remove('formDraft')
 // Or use alias
 // session.clearAll()
 
-console.log('Session advanced example complete!')
+console.debug('Session advanced example complete!')

package/examples/state-advanced.ts

@@ -25,9 +25,9 @@ state.user = {
 }
 
 // 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)
+console.debug('User name:', state.user.name)
+console.debug('Email:', state.user.profile.email)
+console.debug('Theme:', state.user.profile.settings.theme)
 
 // ============================================
 // ARRAYS
@@ -36,14 +36,14 @@ console.log('Theme:', state.user.profile.settings.theme)
 // State arrays work like regular arrays
 state.items = [1, 2, 3]
 state.items.push(4)
-console.log('Items:', state.items) // [1, 2, 3, 4]
+console.debug('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)
+console.debug('Users:', state.users)
 
 // ============================================
 // LOCKING STATE
@@ -56,25 +56,25 @@ state.config.lock()
 // This will fail:
 // state.config.maxUsers = 200 // Error: state 'config' is locked
 
-console.log('Config locked:', state.config)
+console.debug('Config locked:', state.config)
 
 // ============================================
 // PATH TRACKING
 // ============================================
 
 // Get path information
-console.log('Path:', state.user.__path) // "state.user"
+console.debug('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"
+console.debug('Profile path:', path.email.toString()) // "state.user.profile.email"
 
 // ============================================
 // LIST ALL STATES
 // ============================================
 
 // Get all current state keys
-console.log('All states:', state.list)
+console.debug('All states:', state.list)
 
 // ============================================
 // REMOVE STATE
@@ -86,4 +86,4 @@ state.remove('items')
 // Remove all states
 // state.removeAll()
 
-console.log('State advanced example complete!')
+console.debug('State advanced example complete!')