memorio 4.9.35 → 5.0.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorio",
   "codeName": "memorio",
-  "version": "4.9.35",
+  "version": "5.0.0",
   "description": "Memorio, State + Observer, Store and iDB for an easy life - Cross-platform compatible",
   "main": "./index.cjs",
   "browser": {
@@ -56,18 +56,23 @@
     "markdown/**/*",
     "types/**/*",
     "examples/**/*",
+    "modules/**/*",
+    "adr/**/*",
     "AGENTS.md",
     "COPYRIGHT.md",
     "README.md",
     "FUNDING.yml",
     "SECURITY.md",
+    "SECURITY-HARDENING.md",
     "SUMMARY.md",
     "LICENSE.md",
     "index.d.ts",
+    "global.d.ts",
+    "global.cjs",
+    "global.js",
     "index.cjs",
     "index.js",
-    "llms.txt",
-    "modules/**/*"
+    "llms.txt"
   ],
   "publishConfig": {
     "access": "public"
@@ -89,6 +94,11 @@
       "require": "./index.cjs",
       "types": "./index.d.ts"
     },
+    "./global": {
+      "import": "./global.js",
+      "require": "./global.cjs",
+      "types": "./global.d.ts"
+    },
     "./types/*": "./types/*",
     "./redux": {
       "import": "./modules/redux.js",

package/types/env.d.ts

@@ -1,9 +1,19 @@
-/**
- * Runtime environment detection.
- *
- * `DEV` and `PROD` are derived at runtime from `process.env.NODE_ENV`
- * (polyfilled by Vite/Webpack in browsers). No build-time environment
- * constant is required. Import from `core/env.ts`:
- *
- *   import { DEV, PROD } from './core/env'
- */
+/**
+ * Runtime environment detection.
+ *
+ * `DEV` and `PROD` are derived from a build-time `__DEV__` constant
+ * (injected by tsup/esbuild via `define`) when available, falling back
+ * to `process.env.NODE_ENV` for raw source imports in Node.js, and
+ * defaulting to `true` for raw browser environments.
+ * Import from `core/env.ts`:
+ *
+ *   import { DEV, PROD } from './core/env'
+ */
+
+/**
+ * Build-time constant injected by tsup/esbuild. When present, it's a
+ * boolean literal that enables dead-code elimination of dev-only blocks
+ * (devtools, introspection, etc.). Not defined for raw source imports
+ * (no build step) - falls back to runtime detection.
+ */
+declare const __DEV__: boolean | undefined

package/types/exports.d.ts

@@ -10,6 +10,7 @@
 
 /// <reference path="./schema.d.ts" />
 /// <reference path="./history.d.ts" />
+/// <reference path="./mutation.d.ts" />
 /// <reference path="./inspect.d.ts" />
 /// <reference path="./memorio.d.ts" />
 /// <reference path="./state.d.ts" />
@@ -110,6 +111,25 @@ export const enableHistory: (enabled?: boolean) => void
 export const clearHistory: () => void
 export const clearRedo: () => void
 
+// ── Mutation Engine (Memorio 5) ───────────────────────────────────────
+export const createMutation: (path: string, operation: _operation, before: any, after: any, opts?: { context?: string; source?: string; transactionId?: string }) => _mutation
+export const recordMutation: (mutation: _mutation) => void
+export const toPatch: (mutation: _mutation) => _patch | null
+export const mutate: (path: string, value: any, opts?: { source?: string; transactionId?: string }) => _mutation
+export const beginTransaction: (source?: string, message?: string, metadata?: Record<string, any>) => _transaction
+export const transaction: (source?: string, message?: string, metadata?: Record<string, any>) => _transaction
+export const commitTransaction: () => _transaction | null
+export const abortTransaction: () => _transaction | null
+export const currentTransaction: () => _transaction | null
+export const listTransactions: () => _transaction[]
+export const generateMutationId: () => string
+export const generateTransactionId: () => string
+export const generateCommitId: () => string
+export const mutationToPatch: (mutation: _mutation) => _patch | null
+export const diffToPatch: (path: string, before: any, after: any) => _patch | null
+export const canMerge: (p1: _patch, p2: _patch) => boolean
+export const mergePatches: (p1: _patch, p2: _patch) => _patch
+
 // ── Introspection (development-only) ─────────────────────────────────
 export const stateKeys: () => string[]
 export const pathExists: (path: string) => boolean

package/types/history.d.ts

@@ -2,7 +2,7 @@
 /// Ambient declarations for the snapshot / undo / redo / trace API.
 
 ///
-// A single recorded state mutation.
+// A single recorded state mutation (extended for Memorio 5).
 ///
 interface _mutationRecord {
   /** Dotted state path (e.g. 'user.name'). */
@@ -15,6 +15,18 @@ interface _mutationRecord {
   previousValue: any
   /** Epoch timestamp (ms) when the mutation occurred. */
   timestamp: number
+  /** Unique mutation ID (Memorio 5). */
+  id?: string
+  /** Normalized operation type (Memorio 5). */
+  operation?: 'set' | 'delete' | 'insert' | 'remove' | 'replace' | 'length'
+  /** HLC timestamp string for causal ordering (Memorio 5). */
+  hlc?: string
+  /** Context ID for server-side isolation (Memorio 5). */
+  context?: string
+  /** Source attribution (Memorio 5). */
+  source?: string
+  /** Transaction group ID (Memorio 5). */
+  transactionId?: string
 }
 
 ///

package/types/memorio.d.ts

@@ -20,7 +20,7 @@ import type {
 
 interface _dispatch {
   set: (name: string, value?: any) => void
-   listen: (name: string, cb?: ((e: Event) => void) | null, flag?: boolean) => (() => void) | void
+  listen: (name: string, cb?: ((e: Event) => void) | null, flag?: boolean) => (() => void) | void
   remove: (name: string, cb?: any, flag?: boolean) => void
 }
 
@@ -71,9 +71,9 @@ interface _memorio {
     session: any
     cache: any
   }
-   help?: () => void
-   global?: () => void
-   env?: { isDev: boolean; isProd: boolean }
+  help?: () => void
+  global?: () => void
+  env?: { isDev: boolean; isProd: boolean }
   // Schema validation
   registerSchema?: (path: string, schema: any) => void
   validate?: (path: string, value: any) => { valid: boolean; errors?: string[] }
@@ -92,7 +92,16 @@ interface _memorio {
   trace?: () => _mutationRecord[]
   enableHistory?: (enabled?: boolean) => void
   clearHistory?: () => void
-  clearRedo?: () => void
+   clearRedo?: () => void
+   // Mutation Engine (Memorio 5)
+   mutate?: (path: string, value: any, opts?: { source?: string; transactionId?: string }) => _mutation
+   createMutation?: (path: string, operation: _operation, before: any, after: any, opts?: { context?: string; source?: string; transactionId?: string }) => _mutation
+   recordMutation?: (mutation: _mutation) => void
+   toPatch?: (mutation: _mutation) => _patch | null
+   transaction?: (source?: string, message?: string, metadata?: Record<string, any>) => _transaction
+   commitTransaction?: () => _transaction | null
+   abortTransaction?: () => _transaction | null
+   currentTransaction?: () => _transaction | null
   // Introspection
   stateKeys?: () => string[]
   pathExists?: (path: string) => boolean
@@ -166,4 +175,7 @@ interface globalThis {
   [key: string]: any
 }
 
+declare var memorio: memorio
+type memorio = memorio
+
 export { }

package/types/mutation.d.ts

@@ -0,0 +1,75 @@
+/// MEMORIO MUTATION ENGINE TYPES
+/// Ambient declarations for the Memorio 5 mutation pipeline.
+
+///
+// Normalized mutation operations.
+///
+type _operation = 'set' | 'delete' | 'insert' | 'remove' | 'replace' | 'length'
+
+///
+// RFC 6902 patch operations.
+///
+type _patchOp = 'replace' | 'remove' | 'add' | 'test'
+
+///
+// A single mutation as recorded by the engine (extends MutationRecord).
+///
+interface _mutation {
+  id: string
+  path: string
+  operation: _operation
+  after: any
+  before: any
+  timestamp: number
+  hlc: string
+  context?: string
+  source?: string
+  transactionId?: string
+  action?: 'set' | 'delete'
+  newValue?: any
+  previousValue?: any
+}
+
+///
+// Compact patch representation.
+///
+interface _patch {
+  op: _patchOp
+  path: string
+  value?: any
+  oldValue?: any
+}
+
+///
+// A transaction grouping related mutations.
+///
+interface _transaction {
+  id: string
+  mutations: string[]
+  startedAt: string
+  committedAt?: string
+  source?: string
+  message?: string
+  metadata?: Record<string, any>
+}
+
+///
+// A commit - immutable record of a logical state change.
+///
+interface _commit {
+  id: string
+  parent: string | null
+  timestamp: string
+  patches: _patch[]
+  source?: string
+  message?: string
+  metadata?: Record<string, any>
+}
+
+///
+// Options for explicit mutation.
+///
+interface _mutateOptions {
+  source?: string
+  transactionId?: string
+}