memorio 4.6.6 → 4.6.8

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorio",
   "codeName": "memorio",
-  "version": "4.6.6",
+  "version": "4.6.8",
   "description": "Memorio, State + Observer, Store and iDB for an easy life - Cross-platform compatible",
   "main": "./index.cjs",
   "browser": "./index.js",
@@ -49,7 +49,8 @@
     "node": ">=18.0.0"
   },
   "files": [
-    "**/*"
+    "dist/",
+    "types/"
   ],
   "publishConfig": {
     "access": "public"

package/types/cache.d.ts

@@ -2,7 +2,7 @@
   Memorio
   Copyright (c) 2019 Dario Passariello <dariopassariello@gmail.com>
   Licensed under MIT License, see
-  https://dario.passariello.ca
+  dario.passariello.ca
 */
 
 interface _cache {

package/types/idb.d.ts

@@ -2,7 +2,7 @@
   memorio
   Copyright (c) 2019 Dario Passariello <dariopassariello@gmail.com>
   Licensed under MIT License, see
-  https://dario.passariello.ca
+  dario.passariello.ca
 */
 
 interface _idb {

package/types/observer.d.ts

@@ -3,7 +3,7 @@
   memorio
   Copyright (c) 2025 Dario Passariello <dariopassariello@gmail.com>
   Licensed under MIT License, see
-  https://dario.passariello.ca
+  dario.passariello.ca
  */
 
 /**

package/types/useObserver.d.ts

@@ -3,7 +3,7 @@
   memorio
   Copyright (c) 2025 Dario Passariello <dariopassariello@gmail.com>
   Licensed under MIT License, see
-  https://dario.passariello.ca
+  dario.passariello.ca
  */
 
 /**

package/COPYRIGHT.md

@@ -1,6 +0,0 @@
-# Copyright
-
-Copyright (c) 2025, 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.

package/SECURITY.md

@@ -1,48 +0,0 @@
-# Security
-
-Memorio follows NIST and NSA security standards at the enterprise level.
-
-## Security Standards
-
-- **NIST Guidelines**: Follows NIST SP 800-53 security controls and NIST Cybersecurity Framework
-- **NSA Standards**: Defense-grade security practices; considers nation-state level threats in risk assessment
-
-## Supply Chain Security
-
-- **Socket.dev**: Minimum target score 90%; all alarms must be resolved before release
-- **Dependency Management**: Zero production dependencies (fully dependency-free); dev dependencies audited regularly
-- **Prohibited**: No `eval()` usage, no encrypted/obfuscated code in builds, no hardcoded secrets
-
-## Code Security
-
-- No hardcoded credentials or API keys
-- Secure random session ID generation (`crypto.randomUUID` → `crypto.getRandomValues` → fallback)
-- Input validation on all public APIs
-- XSS prevention on DevTools data export
-- Property-based access control on global objects (`Object.defineProperty` with `enumerable: false`)
-
-## OWASP Compliance
-
-Addresses OWASP Top 10 (2021):
-- A01:2021 — Broken Access Control (global object protection, property locks)
-- A02:2021 — Cryptographic Failures (crypto.randomUUID for session IDs)
-- A03:2021 — Injection (CSS sanitization in devtools)
-- A05:2021 — Security Misconfiguration (minimal surface area, no bundled secrets)
-- A06:2021 — Vulnerable and Outdated Components (regular npm audit, Socket.dev)
-- A07:2021 — Identification and Authentication Failures (N/A — library, no auth)
-- A08:2021 — Software and Data Integrity Failures (strict tsconfig, lock files)
-- A09:2021 — Security Logging and Monitoring Failures (DevTools inspect, Logger module)
-- A10:2021 — Server-Side Request Forgery (N/A — no network requests)
-
-## Reporting Security Issues
-
-If you find a security vulnerability:
-
-1. Email [Dario Passariello](mailto:dariopassarielloa@gmail.com)
-2. Or visit https://dario.passariello.ca/contact/
-
-Do not open public issues for security vulnerabilities.
-
----
-*Document version: 2.0 — Last updated: 2026-05-19*
-*Owner: BigLogic Security Team*

package/SUMMARY.md

@@ -1,28 +0,0 @@
-# Table of contents
-
-* [README](README.md)
-
-## Core Modules
-
-* [State](markdown/STATE.md) - Reactive global state management
-* [Observer](markdown/OBSERVER.md) - Object observation pattern
-* [useObserver](markdown/USEOBSERVER.md) - React hook for state observation
-* [Dispatch](markdown/DISPATCH.md) - Event system for vanilla JS applications
-* [Cache](markdown/CACHE.md) - In-memory caching (lost on refresh)
-* [Store](markdown/STORE.md) - Persistent localStorage management
-* [Session](markdown/SESSION.md) - Temporary sessionStorage management
-* [IDB](markdown/IDB.md) - IndexedDB for large data storage
-
-## Platform & Compatibility
-
-* [Platform & Context Isolation](markdown/PLATFORM.md) - Cross-platform support, session isolation
-* [Security](markdown/SECURITY.md) - Security measures, vulnerability prevention
-* [Changelog](markdown/CHANGELOG.md) - Version history and migration guide
-* [Classic Import](markdown/IMPORT.md) - Named export guide for `import { state } from 'memorio'`
-
-## Additional Resources
-
-* [License](../LICENSE.md)
-* [Contributing](../CONTRIBUTING.md)
-* [Code of Conduct](../CODE_OF_CONDUCT.md)
-* [Security](../SECURITY.md)

package/examples/basic.ts

@@ -1,115 +0,0 @@
-/**
- * Memorio Basic Example
- *
- * This example shows the fundamental features of Memorio:
- * - State management
- * - Store (localStorage)
- * - Session storage
- * - Platform detection
- *
- * Run: npx ts-node examples/basic.ts
- */
-
-import 'memorio'
-
-// ============================================
-// PLATFORM DETECTION
-// ============================================
-
-console.debug('=== Platform Detection ===')
-console.debug('Memorio version:', memorio.version)
-
-// Check platform
-if (memorio.isBrowser()) {
-  console.debug('Platform: Browser')
-} else if (memorio.isNode()) {
-  console.debug('Platform: Node.js')
-} else if (memorio.isDeno()) {
-  console.debug('Platform: Deno')
-} else if (memorio.isEdge()) {
-  console.debug('Platform: Edge Worker')
-}
-
-// Get capabilities
-const caps = memorio.getCapabilities()
-console.debug('Capabilities:', {
-  platform: caps.platform,
-  hasLocalStorage: caps.hasLocalStorage,
-  hasSessionStorage: caps.hasSessionStorage,
-  hasIndexedDB: caps.hasIndexedDB
-})
-
-// ============================================
-// STATE - In-memory reactive state
-// ============================================
-
-console.debug('\n=== State Management ===')
-
-// Set some state values
-state.name = 'Mario'
-state.age = 30
-state.isActive = true
-state.profile = {
-  email: 'mario@example.com',
-  avatar: 'https://example.com/mario.png'
-}
-
-// Get state values
-console.debug('Name:', state.name)
-console.debug('Age:', state.age)
-console.debug('Profile:', state.profile)
-
-// List all states
-console.debug('All states:', state.list)
-
-// ============================================
-// STORE - Persistent localStorage
-// ============================================
-
-console.debug('\n=== Store (Persistent Storage) ===')
-
-// Check persistence
-console.debug('Is persistent:', store.isPersistent) // true in browser, false in Node.js/Deno
-
-// Save to localStorage
-store.set('username', 'mario')
-store.set('preferences', { theme: 'dark', language: 'en' })
-store.set('lastLogin', Date.now())
-
-// Read from localStorage
-console.debug('Username:', store.get('username'))
-console.debug('Preferences:', store.get('preferences'))
-
-// Get storage size
-console.debug('Storage size:', store.size(), 'bytes')
-
-// ============================================
-// SESSION - Temporary session storage
-// ============================================
-
-console.debug('\n=== Session (Temporary Storage) ===')
-
-// Check persistence
-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.debug('Token:', session.get('token'))
-console.debug('User ID:', session.get('userId'))
-
-// ============================================
-// CLEANUP
-// ============================================
-
-// Clear specific items
-store.remove('username')
-session.remove('token')
-
-// Clear all
-store.removeAll()
-session.removeAll()
-
-console.debug('\nExample complete!')

package/examples/browser-vanilla.html

@@ -1,358 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-
-<head>
-  <meta charset="UTF-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1.0">
-  <title>Memorio Vanilla JS Example</title>
-  <style>
-    /* Simple CSS */
-    body {
-      font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
-      max-width: 800px;
-      margin: 0 auto;
-      padding: 20px;
-      background: #f5f5f5;
-    }
-
-    .card {
-      background: white;
-      border-radius: 8px;
-      padding: 20px;
-      margin-bottom: 20px;
-      box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
-    }
-
-    h1 {
-      color: #333;
-    }
-
-    h2 {
-      color: #666;
-      margin-top: 0;
-    }
-
-    button {
-      background: #007bff;
-      color: white;
-      border: none;
-      padding: 10px 20px;
-      border-radius: 4px;
-      cursor: pointer;
-      margin: 5px;
-    }
-
-    button:hover {
-      background: #0056b3;
-    }
-
-    button.danger {
-      background: #dc3545;
-    }
-
-    button.danger:hover {
-      background: #c82333;
-    }
-
-    button.success {
-      background: #28a745;
-    }
-
-    button.success:hover {
-      background: #218838;
-    }
-
-    input,
-    select {
-      padding: 8px;
-      border: 1px solid #ddd;
-      border-radius: 4px;
-      margin: 5px;
-    }
-
-    pre {
-      background: #f8f9fa;
-      padding: 10px;
-      border-radius: 4px;
-      overflow-x: auto;
-    }
-
-    .output {
-      background: #e9ecef;
-      padding: 10px;
-      border-radius: 4px;
-      font-family: monospace;
-      white-space: pre-wrap;
-    }
-
-    .grid {
-      display: grid;
-      grid-template-columns: repeat(auto-fit, minmax(200px, 1fr));
-      gap: 10px;
-    }
-
-    .stat {
-      background: #e7f3ff;
-      padding: 10px;
-      border-radius: 4px;
-      text-align: center;
-    }
-
-    .stat-value {
-      font-size: 24px;
-      font-weight: bold;
-      color: #007bff;
-    }
-
-    .stat-label {
-      font-size: 12px;
-      color: #666;
-    }
-  </style>
-</head>
-
-<body>
-  <h1>🧠 Memorio Vanilla JS Demo</h1>
-
-  <!-- State Section -->
-  <div class="card">
-    <h2>1. State (Reactive)</h2>
-    <p>Global reactive state - changes trigger UI updates automatically</p>
-
-    <div class="grid">
-      <div class="stat">
-        <div class="stat-value" id="counter">0</div>
-        <div class="stat-label">Counter</div>
-      </div>
-      <div class="stat">
-        <div class="stat-value" id="username">-</div>
-        <div class="stat-label">Username</div>
-      </div>
-      <div class="stat">
-        <div class="stat-value" id="theme">light</div>
-        <div class="stat-label">Theme</div>
-      </div>
-    </div>
-
-    <br>
-    <button onclick="state.counter++">Increment Counter</button>
-    <button onclick="state.counter--">Decrement</button>
-    <button onclick="state.counter = 0">Reset</button>
-
-    <h3>Set Username:</h3>
-    <input type="text" id="nameInput" placeholder="Enter name">
-    <button onclick="state.username = document.getElementById('nameInput').value">Set</button>
-
-    <h3>Theme:</h3>
-    <button onclick="state.theme = 'light'">Light</button>
-    <button onclick="state.theme = 'dark'">Dark</button>
-
-    <h3>All State:</h3>
-    <pre id="stateOutput" class="output"></pre>
-  </div>
-
-  <!-- Store Section -->
-  <div class="card">
-    <h2>2. Store (localStorage)</h2>
-    <p>Permanent storage - survives page refresh</p>
-    <p>Persistent: <span id="storePersistent">checking...</span></p>
-
-    <input type="text" id="storeKey" placeholder="Key">
-    <input type="text" id="storeValue" placeholder="Value">
-    <button
-      onclick="store.set(document.getElementById('storeKey').value, document.getElementById('storeValue').value)">Save</button>
-    <button
-      onclick="document.getElementById('storeOutput').textContent = JSON.stringify(store.get(document.getElementById('storeKey').value), null, 2)">Get</button>
-    <button class="danger" onclick="store.remove(document.getElementById('storeKey').value)">Delete</button>
-
-    <h3>All Store Data:</h3>
-    <pre id="storeOutput" class="output"></pre>
-  </div>
-
-  <!-- Session Section -->
-  <div class="card">
-    <h2>3. Session (sessionStorage)</h2>
-    <p>Temporary storage - cleared when tab closes</p>
-    <p>Persistent: <span id="sessionPersistent">checking...</span></p>
-
-    <input type="text" id="sessionKey" placeholder="Key">
-    <input type="text" id="sessionValue" placeholder="Value">
-    <button
-      onclick="session.set(document.getElementById('sessionKey').value, document.getElementById('sessionValue').value)">Save</button>
-    <button
-      onclick="document.getElementById('sessionOutput').textContent = JSON.stringify(session.get(document.getElementById('sessionKey').value), null, 2)">Get</button>
-    <button class="danger" onclick="session.remove(document.getElementById('sessionKey').value)">Delete</button>
-
-    <h3>All Session Data:</h3>
-    <pre id="sessionOutput" class="output"></pre>
-  </div>
-
-  <!-- Cache Section -->
-  <div class="card">
-    <h2>4. Cache (In-Memory)</h2>
-    <p>Temporary cache - cleared on refresh</p>
-
-    <input type="text" id="cacheKey" placeholder="Key">
-    <input type="text" id="cacheValue" placeholder="Value">
-    <button
-      onclick="cache.set(document.getElementById('cacheKey').value, document.getElementById('cacheValue').value)">Save</button>
-    <button
-      onclick="document.getElementById('cacheOutput').textContent = JSON.stringify(cache.get(document.getElementById('cacheKey').value), null, 2)">Get</button>
-    <button class="danger" onclick="cache.remove(document.getElementById('cacheKey').value)">Delete</button>
-
-    <h3>All Cache Data:</h3>
-    <pre id="cacheOutput" class="output"></pre>
-  </div>
-
-  <!-- Observer Section -->
-  <div class="card">
-    <h2>5. Observer (Auto-Reactive)</h2>
-    <p>Watch for state changes automatically</p>
-
-    <button class="success" id="startObserver">Start Observer</button>
-    <button class="danger" id="stopObserver">Stop Observer</button>
-    <button onclick="state.testValue = Math.random()">Trigger Change</button>
-
-    <h3>Observer Log:</h3>
-    <pre id="observerLog" class="output"></pre>
-  </div>
-
-  <!-- Platform Info -->
-  <div class="card">
-    <h2>6. Platform Info</h2>
-    <div id="platformInfo" class="output"></div>
-  </div>
-
-  <!-- Load Memorio -->
-  <script src="https://cdn.jsdelivr.net/npm/memorio/index.cjs"></script>
-
-  <script>
-    // ============================================
-    // MEMORIO VANILLA JS EXAMPLE
-    // ============================================
-
-    // 1. REACTIVE STATE
-    // -----------------
-
-    // Initialize state
-    state.counter = 0
-    state.username = 'Guest'
-    state.theme = 'light'
-    state.testValue = 0
-
-    // Update UI when state changes
-    function updateStateUI() {
-      document.getElementById('counter').textContent = state.counter
-      document.getElementById('username').textContent = state.username
-      document.getElementById('theme').textContent = state.theme
-      document.getElementById('stateOutput').textContent = JSON.stringify({
-        counter: state.counter,
-        username: state.username,
-        theme: state.theme,
-        testValue: state.testValue
-      }, null, 2)
-    }
-
-    // Use observer to react to changes
-    useObserver(() => {
-      updateStateUI()
-      document.body.className = state.theme
-    }, [state.counter, state.username, state.theme, state.testValue])
-
-    // 2. PERSISTENT STORE
-    // -------------------
-
-    // Check persistence
-    document.getElementById('storePersistent').textContent = store.isPersistent ? '✅ Yes (localStorage)' : '❌ No (memory)'
-
-    // Save sample data
-    store.set('visits', '0')
-    store.set('lastVisit', new Date().toISOString())
-
-    function updateStoreUI() {
-      document.getElementById('storeOutput').textContent = 'Visits: ' + store.get('visits') + '\nLast Visit: ' + store.get('lastVisit')
-    }
-    updateStoreUI()
-
-    // Increment visits
-    let visits = parseInt(store.get('visits') || '0')
-    store.set('visits', (visits + 1).toString())
-
-    // 3. SESSION STORAGE
-    // ------------------
-
-    document.getElementById('sessionPersistent').textContent = session.isPersistent ? '✅ Yes (sessionStorage)' : '❌ No (memory)'
-
-    session.set('pageViews', '0')
-
-    function updateSessionUI() {
-      document.getElementById('sessionOutput').textContent = 'Page Views: ' + session.get('pageViews')
-    }
-    updateSessionUI()
-
-    // Increment page views
-    let pageViews = parseInt(session.get('pageViews') || '0')
-    session.set('pageViews', (pageViews + 1).toString())
-
-    // 4. CACHE (In-Memory)
-    // --------------------
-
-    cache.set('tempData', { computed: true, timestamp: Date.now() })
-
-    function updateCacheUI() {
-      document.getElementById('cacheOutput').textContent = JSON.stringify(cache.get('tempData'), null, 2)
-    }
-    updateCacheUI()
-
-    // 5. OBSERVER
-    // -----------
-
-    let observerActive = false
-    const logEl = document.getElementById('observerLog')
-
-    document.getElementById('startObserver').onclick = () => {
-      observerActive = true
-      logEl.textContent += 'Observer started!\n'
-    }
-
-    document.getElementById('stopObserver').onclick = () => {
-      observerActive = false
-      logEl.textContent += 'Observer stopped!\n'
-    }
-
-    // This creates a persistent observer
-    useObserver((newVal, oldVal) => {
-      if (observerActive) {
-        logEl.textContent += `Changed: ${oldVal} → ${newVal}\n`
-        logEl.scrollTop = logEl.scrollHeight
-      }
-    }, [state.testValue])
-
-    // 6. PLATFORM INFO
-    // ----------------
-
-    const platformInfo = document.getElementById('platformInfo')
-    platformInfo.textContent = `
-Platform Detection:
------------------
-Browser: ${memorio.isBrowser() ? '✅' : '❌'}
-Node.js: ${memorio.isNode() ? '✅' : '❌'}
-Deno: ${memorio.isDeno() ? '✅' : '❌'}
-Edge: ${memorio.isEdge() ? '✅' : '❌'}
-
-Capabilities:
--------------
-localStorage: ${memorio.getCapabilities().hasLocalStorage ? '✅' : '❌'}
-sessionStorage: ${memorio.getCapabilities().hasSessionStorage ? '✅' : '❌'}
-IndexedDB: ${memorio.getCapabilities().hasIndexedDB ? '✅' : '❌'}
-
-Session ID: ${memorio.getCapabilities().sessionId.substring(0, 8)}...
-    `.trim()
-
-    // Log welcome
-    console.debug('🧠 Memorio loaded!')
-    console.debug('Platform:', memorio.getCapabilities().platform)
-  </script>
-</body>
-
-</html>

package/examples/cache.ts

@@ -1,72 +0,0 @@
-/**
- * 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 'memorio'
-
-// ============================================
-// BASIC CACHE OPERATIONS
-// ============================================
-
-// Set values
-cache.set('username', 'Mario')
-cache.set('score', 1500)
-cache.set('player', { name: 'Mario', level: 5 })
-
-// Get values
-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.debug('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.debug('Game level:', gameState?.level)
-console.debug('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.debug('Cache keys:', Object.keys(cache))
-
-// ============================================
-// CLEANUP
-// ============================================
-
-// Remove single item
-cache.remove('username')
-
-// Clear all cache
-cache.removeAll()
-
-// Or use clearAll alias
-// cache.clearAll()
-
-console.debug('Cache after clear:', cache.get('score'))
-
-console.debug('Cache example complete!')