memorio 5.0.0 → 5.1.0

package/markdown/CHANGELOG.md

@@ -1,243 +0,0 @@
-> **Status:** Published
-> **Date:** 2026-09-12
-> **Deciders:** Memorio 5.x Core Team, BigLogic
-> **Scope**: Project Documentation
-> **Standard**: Memorio Documentation Standard v5
->
----
-# Changelog - Memorio
-
-All notable changes to this project will be documented in this file.
-
----
-
-## Unreleased - Module Duplication Fix & Architecture Cleanup
-
-### 🐛 Bug Fixes
-
-- **Module duplication / state reset**: Fixed issue where importing memorio via different paths (ESM `dist/index.js`, CJS `index.cjs`, package name `memorio`, absolute file path) created separate module instances, each with its own empty proxy. This caused `globalThis.state` to be overwritten with a fresh empty proxy on second import, resetting all state data.
-  - All modules (`state`, `store`, `session`, `cache`) now use private `globalThis` singleton keys (`__memorio_state_instance__`, `__memorio_store_instance__`, `__memorio_session_instance__`, `__memorio_cache_instance__`) to guarantee a single shared instance across all import paths.
-  - `memorio.global()` in `core/global.ts` now guards with `if (!(key in globalThis))` to prevent overwriting existing dev globals - protecting against module duplication resetting state.
-- **Removed `__DEV__` build-time constant**: Replaced all bare `__DEV__` references with `DEV`/`PROD` from `core/env.ts` (runtime detection via `process.env.NODE_ENV`). Eliminates `ReferenceError: __DEV__ is not defined` in browser environments without bundler `define` config. Production builds now have **0** `__DEV__` references.
-
-### 🔧 Code Refactoring
-
-- **Script organization**: Moved debug/verification scripts from root to `tests/scripts/`:
-  - `check-dev-mode.mjs` → `tests/scripts/check-dev-mode.mjs`
-  - `update-node-modules-memorio.cjs` → `tests/scripts/update-node-modules-memorio.cjs`
-  - `test-state-persist.ts` → `tests/scripts/test-state-persist.ts`
-  - `tests/test-nav.mjs` → `tests/playwright/test-nav.mjs`
-
-### 📝 Documentation Updates
-
-- `docs/README.md`: Documented the singleton pattern and module deduplication strategy in the "How it works" section.
-
-### 🧹 Code Quality
-
-- **Removed dead code**: `serialize` function in `functions/memory/journal.ts` (unused)
-- **Fixed unused parameter**: `tick(incoming)` in `core/hlc.ts` renamed to `tick(_incoming)`
-- **Fixed regex escapes**: Removed unnecessary `\.` escapes in `functions/memory/index.ts` path regexes
-- **DevTools reliability**: Replaced `globalThis.state/store/session/cache` access with singleton instance keys (`__memorio_*_instance__`) to prevent `ReferenceError` in production and avoid circular imports
-- **Console consistency**: Changed `console.error` to `console.debug` in devtools error handling, removed emoji prefixes
-
-### 🔒 Security - Supply Chain
-
-- **Removed hardcoded CDN URL**: `functions/sqlite/tools/db.support.ts` no longer references `https://cdn.jsdelivr.net/npm/sql.js/dist/` hardcoded. SQLite now requires explicit loader configuration via `sqlite.config({ loader, scriptUrl })` or fails gracefully with a clear error message.
-- **Eliminated external script injection risk**: No external URL strings in the bundle - prevents socket.dev supply-chain warnings for "URL string literals"
-- **Added `browser` field** in `package.json` for explicit browser/Node resolution
-- **Added `.oxlintrc.json`**: Lint configuration with ignore patterns and rule overrides
-- **tsup config**: Disabled minification (`minifyWhitespace`, `minifyIdentifiers`, `minifySyntax` → `false`), enabled sourcemaps (`sourcemap: true`) and `keepNames: true` to produce readable bundles and eliminate socket.dev "minified code" false positives
-
----
-
-## v4.9.0 - 2026-09-06
-
-### 🐛 Bug Fixes
-
-- **Module duplication / state reset across import paths**: Fixed issue where importing memorio via different paths (ESM `dist/index.js`, CJS `index.cjs`, package name `memorio`, absolute file path) created separate module instances, each with its own empty proxy. This caused `globalThis.state` to be overwritten with a fresh empty proxy on second import, resetting all state data.
-  - All modules (`state`, `store`, `session`, `cache`) now use private `globalThis` singleton keys (`__memorio_state_instance__`, `__memorio_store_instance__`, `__memorio_session_instance__`, `__memorio_cache_instance__`) to guarantee a single shared instance across all import paths.
-  - `memorio.global()` in `core/global.ts` now guards with `if (!(key in globalThis))` to prevent overwriting existing dev globals - protecting against module duplication resetting state.
-
-### 🔧 Code Refactoring
-
-- **Removed `__DEV__` build-time constant**: Replaced all bare `__DEV__` references with `DEV`/`PROD` from `core/env.ts` (runtime detection via `process.env.NODE_ENV`). Eliminates `ReferenceError: __DEV__ is not defined` in browser environments without bundler `define` config. Production builds verified to have **0** `__DEV__` references in both ESM and CJS outputs.
-  - `core/env.ts`: Rewrote from `__DEV__`-based to pure runtime detection. `DEV` = `process.env.NODE_ENV !== 'production'` (or `true` in browser without `process` polyfill).
-  - All `if (__DEV__)` guards across `core/global.ts`, `functions/state/`, `functions/store/`, `functions/session/`, `functions/cache/`, `functions/idb/`, `functions/sqlite/`, `functions/observer/`, `functions/useObserver/`, `functions/message/`, `functions/logger/`, and `functions/devtools/` now use `if (DEV)` with an explicit `import { DEV } from '../../core/env'`.
-  - `core/global.ts`: `memorio.global()` auto-call is gated behind `if (isDev)` (sourced from `DEV`), not `if (__DEV__)`.
-  - `tsup.config.ts`: Removed `'__DEV__'` from `define`. Only `process.env.NODE_ENV` is defined.
-  - `vitest.config.ts`: Removed `__DEV__: true` define. Uses `'process.env.NODE_ENV': '"development"'` instead.
-  - `types/env.d.ts`: Removed `declare const __DEV__: boolean`. Documents runtime `DEV`/`PROD` imports from `core/env.ts`.
-
-### ✨ API Additions
-
-- **`memorio.env.isDev` / `memorio.env.isProd`**: Runtime environment detection properties on the `memorio` namespace. Returns `true`/`false` based on `process.env.NODE_ENV` - no build-time `__DEV__` define required.
-- **`memorio.global()` method**: Manually sets dev-only globals (`state`, `store`, `session`, `cache`, `idb`, `sqlite`, `observer`, `useObserver`) on `globalThis`. Auto-called in development; idempotent and safe to call multiple times.
-
-### 🆕 API - Typed Stores & Schema Validation
-
-- **Typed Stores**: `memorio.typed<T>()` returns the global `state` proxy cast to a TypeScript type `T`, providing compile-time type safety, IntelliSense autocomplete, and static property checking on state access and mutation. Zero runtime cost - the returned object is the exact same Proxy as `globalThis.state`.
-- **Schema Validation**: `memorio.registerSchema(path, schema)` registers runtime validators for state paths. Writes that violate a registered schema are rejected before storage. Supports type checking, required fields, min/max, regex patterns, enums, nested property schemas, and custom validator functions. Includes `memorio.validate(path, value)`, `memorio.unregisterSchema(path)`, and `memorio.listSchemas()`.
-
-### 📝 Documentation Updates
-
-- `docs/README.md`: Added "Typed Stores" and "Schema Validation" sections. Updated "Is this for you?" to reference the new type-safe options.
-- `docs/llms.txt`: Added typed stores and schema validation sections.
-- `docs/SUMMARY.md`: Added links to new doc pages.
-
----
-
-## v4.6.1 (Security Patch) - 2026-08-14 - CRITICAL Security Fix
-
-### 🔐 Security NOTICE (v4.6.0)
-
-**CRITICAL**: A Gitea Personal Access Token was accidentally committed to `.npmrc` in v4.6.0
-
-**Affected**: `v4.6.0` tag and all builds from that version
-
-**Action Required**:
-- **IMMEDIATE**: Revoke ALL tokens on Gitea Packages by admin access
-- **GENERATE**: Create new PAT with scope `write:package` only
-- **CONFIGURE**: Add as secret `PAT` in GitHub Actions or Gitea Actions
-- **UPGRADE**: Use v4.6.1 where the token is replaced with `${PAT}` environment variable
-
-The hardcoded token `2f398d5d7a734781e96108fdd0dbbabad41ef77a` has been removed in v4.6.1.
-
-### 🐛 Bug Fixes
-
-- **SECURITY**: Removed hardcoded Gitea PAT from `.npmrc` (exposed token remediated)
-- Replaced with environment variable `${PAT}` for secure authentication
-
-### 📝 Documentation Updates
-
-- `.npmrc`: Token replaced with environment variable reference
-- `.gitea/workflows/npm.yml`: Configured to use secrets `GITEA_USER` and `PAT`
-
----
-
-## v4.6.0 (Previous - SECURITY ISSUE) - 2026-08-13 - Refactoring & Documentation
-
-**⚠️ WARNING**: This version had a hardcoded PAT token that was later remediated in v4.6.1**
-
-### 🐛 Bug Fixes
-
-- Fixed circular import in `idb/index.ts` → `core/global`
-- Fixed dead `globalThis._propertyAccessLog` reference in `observer`
-- Fixed `dispatch.remove(f)` tuple bug in `functions/dispatch.ts`
-- Fixed `logger.isDebugEnabled` using wrong module reference
-- Removed dead `propertyAccessLog` / `pushPropertyAccess` from `core/internal.ts`
-- Removed duplicate path-tracking block in `state` get handler
-- Removed redundant `?? key` fallback in `state` set handler
-
-### 🔧 Code Refactoring
-
-- **Self-contained modules**: All modules now work independently without internal `globalThis.memorio.*` reads/writes
-- **Module-local state**: Created `core/internal.ts` for module-local singletons
-- **Bootstrap-only global**: `core/global.ts` now only publishes to `globalThis.memorio` at initialization
-- **Removed dead code**: `core/constructor.ts` deleted (unused)
-- **Extracted helpers**: `_read`/`_write`/`_remove` in `store` and `session` to eliminate duplication
-- **Fixed circular imports**: `dispatch` → `observer` via `globalThis.events`
-
-### 📝 Documentation Updates
-
-- `docs/README.md`: Added Classic `import { state } from 'memorio'` section, improved badges layout, enhanced "Why memorio?" comparison table
-- `docs/markdown/STORE.md`: Added classic import note
-- `docs/markdown/IMPORT.md`: New file for named export guide
-- `docs/SUMMARY.md`: Updated to include `IMPORT.md`
-- `README.md`: Badge corrections, header cleanup, removed unverified bundle size claims
-
-### 🆕 GitHub Actions / Gitea Workflows
-
-- Added `.gitea/workflows/npm.yml` for automatic npm package publishing to Gitea Packages on `v*` tags
-- Requires `GITEA_USER` and `PAT` secrets
-
-### 🧪 Tests
-
-- **Result: 9 suites · 101 passed · 4 skipped · 1 todo**
-- All lint and typecheck clean
-
----
-
-## v3.0.2 - 2026-05-19 - Bug Fix, Security & API Expansion
-
-### 🐛 Bug Fixes
-
-- Removed dead code: `buildPathTracker` from `functions/state/index.ts` (unused Proxy builder, exported nowhere)
-- Removed double `delete` in state `removeAll` handler (redundant null-check + delete on same key)
-- Removed unbound `globalThis.state` reference in state init (would throw `ReferenceError` in strict mode)
-- Removed `Object.freeze(observer)` referencing undeclared variable (`ReferenceError` on module load)
-- Removed `confirm()` synchronous blocking call from `idb.db.delete` (library must not block main thread)
-
-### 🔒 Security Improvements
-
-- Removed `esbuild-sass-plugin` and `esbuild-scss-modules-plugin` from `devDependencies` (unnecessary for a library with no styles)
-- Removed `injectStyle: true`, `sassPlugin()` and `.css` loader from `tsup.config.ts`
-- Deleted `tsup.plugin.injectCss.ts` (code injection vector completely removed from build pipeline)
-- `console.error`/`console.warn` → `console.debug` in `devtools` and `idb` error handlers (consistent debug-only logging policy)
-- `store.set()` now blocks function values instead of silently logging and continuing
-- All `PRIVATE License` headers in `functions/idb/` replaced with `MIT License`
-
-### 🔧 Code Quality
-
-- Added JSDoc to `observerFunction` in `functions/observer/index.ts`
-- Added JSDoc to `cache` global in `functions/cache/index.ts`
-- `lint` and `tsc` pass clean - 0 vulnerabilities from `npm audit`
-
-### 🆕 API - New in 3.0.2
-
-| Function | Description |
-|----------|-------------|
-| `memorio.isBrowser()` | Returns `true` when running in a browser |
-| `memorio.isNode()` | Returns `true` when running in Node.js |
-| `memorio.isDeno()` | Returns `true` when running in Deno |
-| `memorio.isEdge()` | Returns `true` in Cloudflare Workers, Vercel Edge, etc. |
-| `memorio.getCapabilities()` | Full capabilities object (`platform`, `hasLocalStorage`, `hasIndexedDB`, …) |
-| `memorio.createContext(name?)` | Create multi-tenant isolated context |
-| `memorio.listContexts()` | List all active isolated contexts |
-| `memorio.deleteContext(id)` | Delete isolated context by ID |
-| `memorio.isolate(name?)` | Shorthand alias for `createContext` |
-
-### 🧪 Tests
-- **Result: 8 suites · 95 passed · 3 skipped · 0 failed**
-
-### 🗑️ Dependency Changes
-
-| Removed | Reason |
-|---------|--------|
-| `esbuild-sass-plugin@3.7.0` | No SCSS in a library |
-| `esbuild-scss-modules-plugin@1.1.1` | No SCSS in a library |
-| 36 transitive packages | Removed from `node_modules` |
-
-### 📝 Documentation Updates
-
-- `docs/README.md`: replaced `console.debug` with `console.debug` in usage examples; fixed `esbuild` badge → `tsup`
-- `.github/CHANGELOG.md`: restructured with fix / security / changed sections
-- `.github/HISTORY.md`: complete rewrite through v3.0.2
-- `.github/SECURITY.md`: NIST/NSA standard + OWASP Top 10 mapping
-- `.github/CITATION.cff`: license PRIVATE → MIT to match `package.json`
-- `.project/*`: all context documents updated to v3.0.2
-
----
-
-## v2.9.0 - 2026-05-13
-
-### Added
-- DevTools - `memorio.devtools.inspect()`, `stats()`, `exportData()`
-- Logger with full history, stats and export
-- Platform detection (`isBrowser`, `isNode`, `isDeno`, `isEdge`, `getCapabilities`)
-- Session isolation via `crypto.randomUUID()`
-
-### Changed
-- Updated dependencies to latest versions
-- Improved cross-platform support (Deno, Edge Workers, Node.js)
-
-### Security
-- Secure random session IDs replaced `Math.random()`
-- Key validation (max 512 chars + character whitelist)
-
----
-
-## v2.5.0 - 2026-02-17
-
-- Initial release of memorio (state, store, session, cache, idb)
-- Observer pattern (`observer`)
-- `useObserver` React hook

package/markdown/PROJECT.md

@@ -1,311 +0,0 @@
-> **Status:** Published
-> **Date:** 2026-09-12
-> **Deciders:** Memorio 5.x Core Team, BigLogic
-> **Scope**: Project Documentation
-> **Standard**: Memorio Documentation Standard v5
->
----
-# Memorio - NPM Package
-
-## Versione
-
-**4.9.5** - Current: `4.9.5` branch
-
-## Chi Siamo
-
-- **Jo**: AI assistant, amico di Dario, professionale e diretto
-- **Dario Passariello**: CTO e fondatore di BigLogic
-- **BigLogic**: Azienda specializzata in soluzioni SaaS artigianali, AI e design ad alta precisione
-
-## Progetto Attuale
-
-**Memorio** è un NPM package leggero e semplice per piccoli progetti dove servono soluzioni veloci senza complessità enterprise:
-
-- **State** - memoria volatile reattiva (Proxy-based)
-- **Store** - localStorage persistenza
-- **Session** - sessionStorage
-- **IDB** - IndexedDB storage strutturato
-- **Cache** - in-memory cache
-- **Observer** - pattern observer per vanilla JS
-- **UseObserver** - React hook per observer
-- **DevTools** - Browser console debugging tools
-- **Logger** - utility di logging
-- **Dispatch** - vanilla JS event system
-- **Schema** - runtime validation per state paths
-- **Typed** - compile-time type safety su state proxy
-- **History** - time-travel (undo/redo/snapshot/diff/trace)
-- **Inspect** - introspection utilities
-- **Memory** - AI memory system con persistence e TTL
-
-**Target**: Progetti piccoli/medi
-**Confronto**: @Biglogic/rgs = enterprise, Memorio = piccoli progetti
-
-## Stack Tecnologico
-
-- TypeScript 6.0.3 (strict mode)
-- tsup 8.5.1 per build (ESM + CJS)
-- ES2022 target
-- ESM (`"type": "module"`)
-- vitest per test (browser + node)
-- Playwright per test end-to-end
-- Peer dependencies: React >=16.8.0 (opzionale)
-- Nessuna UI (è una libreria)
-- Production: dependency-free (zero runtime dependencies)
-
-## Struttura File
-
-```
-memorio/
-├── index.ts                  # Entry point (named exports + memorio namespace)
-├── core/                     # Core modules (bootstrap, platform, internal)
-│   ├── global.ts             # Bootstrap: publishes to globalThis
-│   ├── env.ts                # Runtime DEV/PROD detection
-│   ├── internal.ts           # Module-local internal state singleton
-│   ├── platform.ts           # Browser/Node/Deno/Edge detection
-│   ├── dispatch.ts           # Event dispatch system
-│   ├── hlc.ts                # Hybrid Logical Clock
-│   └── fractional.ts         # Fractional indexing
-├── types/                    # TypeScript declarations
-│   └── memorio.d.ts
-├── functions/                # Feature modules
-│   ├── state/                # Reactive state (Proxy)
-│   ├── store/                # LocalStorage
-│   ├── session/              # SessionStorage
-│   ├── cache/                # In-memory cache
-│   ├── idb/                  # IndexedDB (browser)
-│   ├── sqlite/               # SQLite (sql.js, optional)
-│   ├── observer/             # Observer pattern
-│   ├── useObserver/          # React hook
-│   ├── logger/               # Logging
-│   ├── devtools/             # DevTools (dev-only)
-│   ├── schema/               # Runtime validation
-│   ├── typed/                # Type-safe state views
-│   ├── history/              # Time-travel undo/redo
-│   ├── inspect/              # Introspection
-│   ├── memory/               # AI memory system
-│   ├── message/              # User messages
-│   └── dispatch/             # Event dispatch
-├── tests/                    # Vitest + Playwright tests
-│   ├── vitest/               # Vitest config + test files
-│   └── playwright/           # E2E test specs
-├── .project/markdown/        # Project context & documentation
-│   ├── CHANGELOG.md
-│   ├── PROJECT.md
-│   └── ... (module docs)
-├── docs/                     # Published documentation
-├── package.json
-├── tsconfig.json
-├── tsup.config.ts
-└── .kilo/                    # Kilo AI agent memory
-```
-
-## API Pubbliche
-
-### Core Namespace
-
-```typescript
-import memorio, { state, store, session, cache, idb, sqlite, observer, useObserver, dispatch, message } from 'memorio'
-// or for global access:
-// import 'memorio/global'
-
-// Runtime environment detection
-memorio.env.isDev   // true in development, false in production
-memorio.env.isProd  // inverse of isDev
-
-// Global API (opt-in via memorio/global entry)
-memorio.global()    // Force-expose dev globals on globalThis (idempotent)
-```
-
-### State
-
-```typescript
-// Via named import (or global entrypoint if opted in)
-state.key = 'value'          // Set
-state.key                    // Get (reactive)
-state.remove('key')          // Delete
-state.removeAll()            // Clear all
-state.lock()                 // Lock all modifications
-state.unlock()               // Unlock
-state.list                   // Deep clone of all state
-state.typed<T>()             // Type-safe view
-```
-
-### Store (localStorage)
-
-```typescript
-store.set('key', { value: 42 })
-store.get('key')              // { value: 42 }
-store.remove('key')
-store.removeAll()
-store.isPersistent           // boolean
-store.size()                  // character count
-store.quota()                 // [used, quota]
-store.list()                  // all memorio keys
-```
-
-### Session (sessionStorage)
-
-```typescript
-session.set('key', 'value')
-session.get('key')
-session.remove('key')
-session.removeAll()
-session.isPersistent
-```
-
-### Cache (in-memory)
-
-```typescript
-cache.set('key', 'value')
-cache.get('key')
-cache.remove('key')
-cache.list()                  // all cached items
-cache.clear()                 // alias for removeAll
-```
-
-### Schema Validation
-
-```typescript
-memorio.registerSchema('user.name', {
-  type: 'string',
-  required: true,
-  min: 1,
-  pattern: /^[a-zA-Z]+$/
-})
-
-memorio.validate('user.name', 'Jo')     // { valid: true, errors: [] }
-memorio.listSchemas()                   // registered paths
-memorio.unregisterSchema('user.name')
-```
-
-### History / Time Travel
-
-```typescript
-memorio.enableHistory()      // Start tracking mutations
-const snap = memorio.snapshot()  // Deep clone of state
-memorio.undo()              // Revert last mutation
-memorio.redo()              // Re-apply
-memorio.canUndo()           // boolean
-memorio.canRedo()           // boolean
-memorio.rollback(snap)      // Restore to snapshot
-memorio.trace()             // List all mutations
-memorio.clearHistory()      // Clear undo/redo/trace
-```
-
-### Platform Detection
-
-```typescript
-memorio.isBrowser()          // boolean
-memorio.isNode()             // boolean
-memorio.isDeno()             // boolean
-memorio.isEdge()             // boolean
-memorio.getCapabilities()    // { platform, hasLocalStorage, hasIndexedDB, ... }
-```
-
-### Context (multi-tenant)
-
-```typescript
-memorio.createContext('tenant-name')  // Isolate state by context
-memorio.listContexts()                 // List all contexts
-memorio.deleteContext('context-id')    // Delete a context
-memorio.isolate('tenant-name')         // Shorthand for createContext
-```
-
-## NPM Scripts
-
-| Comando | Descrizione |
-|---------|-------------|
-| `npm run build` | Build con tsup (ESM + CJS) |
-| `npm run watch` | Watch mode con tsup |
-| `npm test` | Esegui vitest test suite |
-| `npm run lint` | Lint con oxlint |
-| `npm run tsc` | TypeScript type check |
-
-## Test Suite
-
-| Suite | Tests | Stato |
-|-------|-------|-------|
-| State | 24 | ✅ |
-| Store | 17 | ✅ |
-| Session | 12 | ✅ |
-| Cache | 5 | ✅ |
-| Observer | 12 | ✅ |
-| useObserver | 12 | ✅ |
-| DevTools | 8 | ✅ |
-| Schema | 10 | ✅ |
-| History | 8 | ✅ |
-| Inspect | 6 | ✅ |
-| ID | 3 | ✅ |
-| Dispatch | 5 | ✅ |
-| Message | 4 | ✅ |
-| Logger | 3 | ✅ |
-| Memory | 5 | ✅ |
-| **Totale** | **~120+** | ✅ |
-
-## Regole Importanti
-
-1. Documentazione in `.project/markdown/`, non nella root
-2. Usare `console.debug()` per il debugging
-   - Nei blocchi `catch` e codice di gestione errori operativi è consentito `console.error()` e `console.warn`
-3. Arrow functions obbligatorie
-4. JSDoc obbligatorio su tutte le funzioni pubbliche
-5. Peer dependency React >=16.8.0 opzionale
-6. Nessuno stile CSS/SCSS (è una libreria)
-7. Nessun database embedded
-8. Tutti i moduli usano singleton keys su `globalThis` per prevenire module duplication
-
-## Dipendenze
-
-### Produzione
-- Nessuna (dependency-free)
-
-### Sviluppo
-- `typescript: 6.0.3`
-- `tsup: 8.5.1`
-- `vitest: 5.0.0`
-- `playwright: chromium`
-- `@types/node: ^25.9.1`
-- `react: ^19.2.6` (peer)
-- `react-dom: ^19.2.6` (peer)
-
-### Peer
-- `react: >=16.8.0` (opzionale)
-- `react-dom: >=16.8.0` (opzionale)
-
-## Module Duplication Strategy
-
-Memorio can be imported via multiple paths (ESM `dist/index.js`, CJS `dist/index.cjs`, package name `memorio`). Each path may resolve to a separate module instance in the bundler. To prevent duplicate proxies:
-
-| Module | Singleton Key |
-|--------|--------------|
-| `state` | `__memorio_state_instance__` |
-| `store` | `__memorio_store_instance__` |
-| `session` | `__memorio_session_instance__` |
-| `cache` | `__memorio_cache_instance__` |
-| internal state | `__memorio_internal_state` |
-
-The first import path to execute creates the instance and stores it on `globalThis`. Subsequent imports find the existing instance and reuse it - guaranteeing all named exports point to the **same** proxy object.
-
-## Valutazione Attuale
-
-### Punti di Forza
-
-- Struttura NPM corretta
-- Build con tsup moderno (ESM + CJS)
-- Testing setup (vitest + Playwright)
-- Auto-detection React per reattività
-- Multi-storage support (state, store, session, idb, cache, sqlite, devtools, logger)
-- Totalmente dependency-free in produzione
-- Cross-platform: Browser, Node.js, Deno, Edge Workers
-- Session isolation e Context system per multi-tenant
-- Module duplication protection via singleton keys
-- Schema validation e typed stores per type safety
-
-### Critica
-
-- Coverage test non verificato
-- Socket.dev Supply Chain Security da monitorare
-
----
-
-*Ultimo aggiornamento: 2026-09-06*