memorio 5.1.3 → 5.1.4

package/index.cjs

@@ -3324,19 +3324,39 @@ if (globalThis[STATE_INSTANCE_KEY]) {
         const initial = exports.store.get(key);
         if (initial !== void 0 && initial !== null) {
           let acc = exports.state;
+          let seedOk = true;
           for (let i = 0; i < segments.length - 1; i++) {
             const seg = segments[i];
-            if (acc[seg] === void 0 || acc[seg] === null) acc[seg] = {};
-            acc = acc[seg];
+            const existing = acc[seg];
+            if (existing === void 0 || existing === null) {
+              acc[seg] = {};
+              acc = acc[seg];
+            } else if (typeof existing === "object") {
+              acc = existing;
+            } else {
+              if (exports.DEV) {
+                console.warn(
+                  `[memorio state] state.persist('${normalized}') aborted seeding: '${seg}' already holds a primitive value (${typeof existing}), cannot nest '${segments.slice(i + 1).join(".")}' under it.`
+                );
+              }
+              seedOk = false;
+              break;
+            }
+          }
+          if (seedOk && acc) {
+            acc[segments[segments.length - 1]] = deepRaw(initial);
           }
-          if (acc) acc[segments[segments.length - 1]] = deepRaw(initial);
         }
         const handler = /* @__PURE__ */ __name(() => {
           let current = exports.state;
           for (const seg of segments) {
             current = current === void 0 || current === null ? void 0 : current[seg];
           }
-          exports.store.set(key, deepRaw(current));
+          if (current === void 0) {
+            exports.store.remove(key);
+          } else {
+            exports.store.set(key, deepRaw(current));
+          }
         }, "handler");
         const off = dispatch.listen(normalized, handler);
         return typeof off === "function" ? off : () => {
@@ -3756,8 +3776,7 @@ var observerFunction = /* @__PURE__ */ __name((s, cb = null, option = true) => {
   }
   if (s && cb) {
     const resolvedPath = resolvePath(s);
-    if (!resolvedPath) return;
-    if (typeof s !== "string" && !(s && typeof s === "object")) {
+    if (!resolvedPath) {
       console.error(`Observer Error: name of state need to be a 'string' like 'state.test' or a direct state value`);
       return;
     }
@@ -3807,7 +3826,7 @@ Object.defineProperties(
      * @returns void
      */
     removeAll: {
-      get: /* @__PURE__ */ __name(() => {
+      value: /* @__PURE__ */ __name(() => {
         const obs = globalThis.observer;
         const list = obs?.list;
         if (list) {
@@ -3816,7 +3835,7 @@ Object.defineProperties(
           });
         }
         return true;
-      }, "get")
+      }, "value")
     },
     ///
     /**
@@ -3846,40 +3865,58 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
   const unsubs = [];
   const depList = Array.isArray(deps) && !deps.__path ? deps : [deps];
   try {
-    depList.forEach((dep) => {
-      let t = "";
-      if (typeof dep === "function") {
-        const result = exports.propertyName(dep);
-        if (result) t = result;
-      } else if (typeof dep === "object" && dep !== null) {
-        t = dep.__path || (typeof dep.toString === "function" && dep.toString() !== "[object Object]" ? dep.toString() : "");
+    if (depList.length === 0) {
+      exports.internal.clearTrackedPaths();
+      exports.internal.tracking = true;
+      try {
+        func();
+      } catch (_) {
       }
-      if (t) {
-        t = t.replace(/^(\(\)\s*=>\s*)/, "").replace(/^globalThis\./, "").replace(/^state\./, "");
-        const path = t.startsWith("store.") || t.startsWith("state.") ? t : "state." + t;
+      exports.internal.tracking = false;
+      exports.internal.trackedPaths.forEach((path) => {
         if (!handlers.includes(path)) {
+          message_default(`useObserver: [Auto-Discovery] -> "${path}"`);
           handlers.push(path);
           const off = dispatch.listen(path, () => func());
           if (typeof off === "function") unsubs.push({ path, off });
         }
-      } else {
-        exports.internal.clearTrackedPaths();
-        exports.internal.tracking = true;
-        try {
-          func();
-        } catch (_) {
+      });
+    } else {
+      depList.forEach((dep) => {
+        let t = "";
+        if (typeof dep === "function") {
+          const result = exports.propertyName(dep);
+          if (result) t = result;
+        } else if (typeof dep === "object" && dep !== null) {
+          t = dep.__path || (typeof dep.toString === "function" && dep.toString() !== "[object Object]" ? dep.toString() : "");
         }
-        exports.internal.tracking = false;
-        exports.internal.trackedPaths.forEach((path) => {
+        if (t) {
+          t = t.replace(/^(\(\)\s*=>\s*)/, "").replace(/^globalThis\./, "").replace(/^state\./, "");
+          const path = t.startsWith("store.") || t.startsWith("state.") ? t : "state." + t;
           if (!handlers.includes(path)) {
-            message_default(`useObserver: [Auto-Discovery] -> "${path}"`);
             handlers.push(path);
             const off = dispatch.listen(path, () => func());
             if (typeof off === "function") unsubs.push({ path, off });
           }
-        });
-      }
-    });
+        } else {
+          exports.internal.clearTrackedPaths();
+          exports.internal.tracking = true;
+          try {
+            func();
+          } catch (_) {
+          }
+          exports.internal.tracking = false;
+          exports.internal.trackedPaths.forEach((path) => {
+            if (!handlers.includes(path)) {
+              message_default(`useObserver: [Auto-Discovery] -> "${path}"`);
+              handlers.push(path);
+              const off = dispatch.listen(path, () => func());
+              if (typeof off === "function") unsubs.push({ path, off });
+            }
+          });
+        }
+      });
+    }
     if (handlers.length > 0) {
       message_default(`useObserver: Monitoring ${handlers.length} paths.`);
     } else {
@@ -4805,7 +4842,7 @@ init_internal();
 
 // package.json
 var package_default = {
-  version: "5.1.3"};
+  version: "5.1.4"};
 
 // core/global.ts
 init_env();
@@ -5481,19 +5518,22 @@ var memory = {
   async patch(key, patches) {
     const entry = await this._getEntry(key);
     if (!entry) return;
+    const patchedValue = JSON.parse(JSON.stringify(entry.value ?? {}));
     let patched = false;
     for (const p of patches) {
+      const relativePath = p.path.replace(/^[^.]+\./, "");
       if (p.op === "set") {
-        setNestedPath({ [entry.key]: entry.value }, p.path.replace(/^[^.]+\./, ""), p.value);
+        setNestedPath(patchedValue, relativePath, p.value);
         patched = true;
       } else if (p.op === "delete") {
-        deleteNestedPath({ [entry.key]: entry.value }, p.path.replace(/^[^.]+\./, ""));
+        deleteNestedPath(patchedValue, relativePath);
         patched = true;
       }
     }
     if (!patched) return;
     const updated = {
       ...entry,
+      value: patchedValue,
       updatedAt: now(),
       lastConfirmedAt: now(),
       version: (entry.version ? entry.version : 0) + 1,

package/index.js

@@ -3321,19 +3321,39 @@ if (globalThis[STATE_INSTANCE_KEY]) {
         const initial = store.get(key);
         if (initial !== void 0 && initial !== null) {
           let acc = state2;
+          let seedOk = true;
           for (let i = 0; i < segments.length - 1; i++) {
             const seg = segments[i];
-            if (acc[seg] === void 0 || acc[seg] === null) acc[seg] = {};
-            acc = acc[seg];
+            const existing = acc[seg];
+            if (existing === void 0 || existing === null) {
+              acc[seg] = {};
+              acc = acc[seg];
+            } else if (typeof existing === "object") {
+              acc = existing;
+            } else {
+              if (DEV) {
+                console.warn(
+                  `[memorio state] state.persist('${normalized}') aborted seeding: '${seg}' already holds a primitive value (${typeof existing}), cannot nest '${segments.slice(i + 1).join(".")}' under it.`
+                );
+              }
+              seedOk = false;
+              break;
+            }
+          }
+          if (seedOk && acc) {
+            acc[segments[segments.length - 1]] = deepRaw(initial);
           }
-          if (acc) acc[segments[segments.length - 1]] = deepRaw(initial);
         }
         const handler = /* @__PURE__ */ __name(() => {
           let current = state2;
           for (const seg of segments) {
             current = current === void 0 || current === null ? void 0 : current[seg];
           }
-          store.set(key, deepRaw(current));
+          if (current === void 0) {
+            store.remove(key);
+          } else {
+            store.set(key, deepRaw(current));
+          }
         }, "handler");
         const off = dispatch.listen(normalized, handler);
         return typeof off === "function" ? off : () => {
@@ -3753,8 +3773,7 @@ var observerFunction = /* @__PURE__ */ __name((s, cb = null, option = true) => {
   }
   if (s && cb) {
     const resolvedPath = resolvePath(s);
-    if (!resolvedPath) return;
-    if (typeof s !== "string" && !(s && typeof s === "object")) {
+    if (!resolvedPath) {
       console.error(`Observer Error: name of state need to be a 'string' like 'state.test' or a direct state value`);
       return;
     }
@@ -3804,7 +3823,7 @@ Object.defineProperties(
      * @returns void
      */
     removeAll: {
-      get: /* @__PURE__ */ __name(() => {
+      value: /* @__PURE__ */ __name(() => {
         const obs = globalThis.observer;
         const list = obs?.list;
         if (list) {
@@ -3813,7 +3832,7 @@ Object.defineProperties(
           });
         }
         return true;
-      }, "get")
+      }, "value")
     },
     ///
     /**
@@ -3843,40 +3862,58 @@ var useObserver = /* @__PURE__ */ __name(((func, deps = []) => {
   const unsubs = [];
   const depList = Array.isArray(deps) && !deps.__path ? deps : [deps];
   try {
-    depList.forEach((dep) => {
-      let t = "";
-      if (typeof dep === "function") {
-        const result = propertyName(dep);
-        if (result) t = result;
-      } else if (typeof dep === "object" && dep !== null) {
-        t = dep.__path || (typeof dep.toString === "function" && dep.toString() !== "[object Object]" ? dep.toString() : "");
+    if (depList.length === 0) {
+      internal_default.clearTrackedPaths();
+      internal_default.tracking = true;
+      try {
+        func();
+      } catch (_) {
       }
-      if (t) {
-        t = t.replace(/^(\(\)\s*=>\s*)/, "").replace(/^globalThis\./, "").replace(/^state\./, "");
-        const path2 = t.startsWith("store.") || t.startsWith("state.") ? t : "state." + t;
+      internal_default.tracking = false;
+      internal_default.trackedPaths.forEach((path2) => {
         if (!handlers.includes(path2)) {
+          message_default(`useObserver: [Auto-Discovery] -> "${path2}"`);
           handlers.push(path2);
           const off = dispatch.listen(path2, () => func());
           if (typeof off === "function") unsubs.push({ path: path2, off });
         }
-      } else {
-        internal_default.clearTrackedPaths();
-        internal_default.tracking = true;
-        try {
-          func();
-        } catch (_) {
+      });
+    } else {
+      depList.forEach((dep) => {
+        let t = "";
+        if (typeof dep === "function") {
+          const result = propertyName(dep);
+          if (result) t = result;
+        } else if (typeof dep === "object" && dep !== null) {
+          t = dep.__path || (typeof dep.toString === "function" && dep.toString() !== "[object Object]" ? dep.toString() : "");
         }
-        internal_default.tracking = false;
-        internal_default.trackedPaths.forEach((path2) => {
+        if (t) {
+          t = t.replace(/^(\(\)\s*=>\s*)/, "").replace(/^globalThis\./, "").replace(/^state\./, "");
+          const path2 = t.startsWith("store.") || t.startsWith("state.") ? t : "state." + t;
           if (!handlers.includes(path2)) {
-            message_default(`useObserver: [Auto-Discovery] -> "${path2}"`);
             handlers.push(path2);
             const off = dispatch.listen(path2, () => func());
             if (typeof off === "function") unsubs.push({ path: path2, off });
           }
-        });
-      }
-    });
+        } else {
+          internal_default.clearTrackedPaths();
+          internal_default.tracking = true;
+          try {
+            func();
+          } catch (_) {
+          }
+          internal_default.tracking = false;
+          internal_default.trackedPaths.forEach((path2) => {
+            if (!handlers.includes(path2)) {
+              message_default(`useObserver: [Auto-Discovery] -> "${path2}"`);
+              handlers.push(path2);
+              const off = dispatch.listen(path2, () => func());
+              if (typeof off === "function") unsubs.push({ path: path2, off });
+            }
+          });
+        }
+      });
+    }
     if (handlers.length > 0) {
       message_default(`useObserver: Monitoring ${handlers.length} paths.`);
     } else {
@@ -4802,7 +4839,7 @@ init_internal();
 
 // package.json
 var package_default = {
-  version: "5.1.3"};
+  version: "5.1.4"};
 
 // core/global.ts
 init_env();
@@ -5478,19 +5515,22 @@ var memory = {
   async patch(key, patches) {
     const entry = await this._getEntry(key);
     if (!entry) return;
+    const patchedValue = JSON.parse(JSON.stringify(entry.value ?? {}));
     let patched = false;
     for (const p of patches) {
+      const relativePath = p.path.replace(/^[^.]+\./, "");
       if (p.op === "set") {
-        setNestedPath({ [entry.key]: entry.value }, p.path.replace(/^[^.]+\./, ""), p.value);
+        setNestedPath(patchedValue, relativePath, p.value);
         patched = true;
       } else if (p.op === "delete") {
-        deleteNestedPath({ [entry.key]: entry.value }, p.path.replace(/^[^.]+\./, ""));
+        deleteNestedPath(patchedValue, relativePath);
         patched = true;
       }
     }
     if (!patched) return;
     const updated = {
       ...entry,
+      value: patchedValue,
       updatedAt: now(),
       lastConfirmedAt: now(),
       version: (entry.version ? entry.version : 0) + 1,

package/llms.txt

@@ -91,6 +91,19 @@ These are materially different behaviors - confirm against the actual source whi
 - Automatic path tracking via `__path` property
 - Nested proxy support
 - Auto-dispatches events on changes
+- `state.persist(path)` mirrors state path to `store` and syncs writes (see "Getting Started" guide)
+
+#### `state.persist(path)`
+
+Creates a bidirectional mirror between `state` (live in-memory) and `store` (durable copy). Seeds the initial value from `store` if present, then every write to that path flows to `store` automatically.
+
+```javascript
+const stopPersisting = state.persist('state.user')
+state.user = { name: 'Sara' }
+// ... writes to state.user are mirrored to store
+
+stopPersisting() // stops mirroring; store value is preserved
+```
 
 ### `store` - localStorage Persistence
 

package/markdown/MEMORY.md

@@ -69,6 +69,33 @@ Permanently removes a memory.
 await memorio.memory.forget('user.temp')
 ```
 
+### `memorio.memory.patch(key, patches)`
+
+Apply a field-level JSON Patch to an existing memory entry's value. Supports `set` and `delete` operations.
+
+```ts
+await memorio.memory.remember('user', {
+  name: 'Mario',
+  profile: { theme: 'light', lang: 'en' }
+})
+
+// Set a nested value
+await memorio.memory.patch('user', [
+  { op: 'set', path: 'user.profile.theme', value: 'dark' }
+])
+
+// Delete a field
+await memorio.memory.patch('user', [
+  { op: 'delete', path: 'user.profile.lang' }
+])
+```
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `op` | `'set' \| 'delete'` | The patch operation type |
+| `path` | `string` | Dot-notation path relative to the entry value (e.g. `'user.profile.theme'`) |
+| `value` | `any` | The value to set (only for `op: 'set'`) |
+
 ### `memorio.memory.context(opts?)`
 
 Returns ranked, relevant memories. Uses recency × confidence × type/scope boost algorithm.

package/markdown/SQLITE.md

@@ -153,8 +153,8 @@ await sqlite.db.journal.checkpoint('app'); // manual checkpoint
 
 | Method | Parameters | Returns | Description |
 |--------|------------|---------|-------------|
-| `sqlite.config(opts)` | `opts: { loader?, locateFile?, wasmUrl?, persistence?, namespace? }` | `sqlite` | Configure the engine. `loader` fully replaces the initializer (default = CDN `<script>`); `locateFile` customizes wasm resolution; `wasmUrl` sets the wasm base directory; `persistence` toggles automatic db snapshots; `namespace` partitions persisted snapshots. Chainable. |
-| `sqlite.db.create(name, opts)` | `name: string, opts?: { data?, persistence? }` | `Database` | Opens/creates a named in-memory db. With `persistence: true` (or global config), a snapshot is restored if present and writes are auto-saved. |
+| `sqlite.config(opts)` | `opts: { loader?, locateFile?, wasmUrl?, persistence?, namespace? }` | `sqlite` | Configure the engine. `loader` fully replaces the initializer (default = CDN `<script>`); `locateFile` customizes wasm resolution; `wasmUrl` sets the wasm base directory; `persistence` toggles journal + checkpoint persistence; `namespace` partitions persisted data. Chainable. |
+| `sqlite.db.create(name, opts)` | `name: string, opts?: { data?, persistence? }` | `Database` | Opens/creates a named in-memory db. With `persistence: true` (or global config), the latest checkpoint is restored and pending journal entries are replayed for full crash recovery. |
 | `sqlite.db.persist(name)` | `name: string` | `Promise<boolean>` | Force an immediate checkpoint (full snapshot + journal clear) of a persisted database to `store`. Alias of `flush`. |
 | `sqlite.db.flush(name)` | `name: string` | `Promise<boolean>` | Force an immediate checkpoint (alias of `persist`). |
 | `sqlite.db.download(name, filename?)` | `name: string, filename?: string` | `Promise<boolean>` | Dev-only: trigger a browser download of the db as a `.sqlite` file. |

package/markdown/SYNC.md

@@ -71,7 +71,7 @@ the durable journal/value store when you opt in:
    snapshot the database to `store` (localStorage) and restore it on reopen.
  - Writes are journaled incrementally (append-only, HLC-timestamped) and
    checkpointed periodically (every 50 ops or 250 ms of idle). On reopen, the
-   last checkpoint is loaded and the journal is replayed — no writes are lost.
+   last checkpoint is loaded and the journal is replayed - no writes are lost.
  - `sqlite.db.persist(name)` / `sqlite.db.flush(name)` forces an immediate
    checkpoint; `sqlite.db.close(name)` checkpoints + closes;
    `sqlite.db.download(name, file?)` triggers a browser `.sqlite` download

package/modules/redux.cjs

@@ -2029,19 +2029,39 @@ if (globalThis[STATE_INSTANCE_KEY]) {
         const initial = store.get(key);
         if (initial !== void 0 && initial !== null) {
           let acc = state2;
+          let seedOk = true;
           for (let i = 0; i < segments.length - 1; i++) {
             const seg = segments[i];
-            if (acc[seg] === void 0 || acc[seg] === null) acc[seg] = {};
-            acc = acc[seg];
+            const existing = acc[seg];
+            if (existing === void 0 || existing === null) {
+              acc[seg] = {};
+              acc = acc[seg];
+            } else if (typeof existing === "object") {
+              acc = existing;
+            } else {
+              if (DEV) {
+                console.warn(
+                  `[memorio state] state.persist('${normalized}') aborted seeding: '${seg}' already holds a primitive value (${typeof existing}), cannot nest '${segments.slice(i + 1).join(".")}' under it.`
+                );
+              }
+              seedOk = false;
+              break;
+            }
+          }
+          if (seedOk && acc) {
+            acc[segments[segments.length - 1]] = deepRaw(initial);
           }
-          if (acc) acc[segments[segments.length - 1]] = deepRaw(initial);
         }
         const handler = /* @__PURE__ */ __name(() => {
           let current = state2;
           for (const seg of segments) {
             current = current === void 0 || current === null ? void 0 : current[seg];
           }
-          store.set(key, deepRaw(current));
+          if (current === void 0) {
+            store.remove(key);
+          } else {
+            store.set(key, deepRaw(current));
+          }
         }, "handler");
         const off = dispatch.listen(normalized, handler);
         return typeof off === "function" ? off : () => {
@@ -3031,19 +3051,22 @@ var memory = {
   async patch(key, patches) {
     const entry = await this._getEntry(key);
     if (!entry) return;
+    const patchedValue = JSON.parse(JSON.stringify(entry.value ?? {}));
     let patched = false;
     for (const p of patches) {
+      const relativePath = p.path.replace(/^[^.]+\./, "");
       if (p.op === "set") {
-        setNestedPath({ [entry.key]: entry.value }, p.path.replace(/^[^.]+\./, ""), p.value);
+        setNestedPath(patchedValue, relativePath, p.value);
         patched = true;
       } else if (p.op === "delete") {
-        deleteNestedPath({ [entry.key]: entry.value }, p.path.replace(/^[^.]+\./, ""));
+        deleteNestedPath(patchedValue, relativePath);
         patched = true;
       }
     }
     if (!patched) return;
     const updated = {
       ...entry,
+      value: patchedValue,
       updatedAt: now(),
       lastConfirmedAt: now(),
       version: (entry.version ? entry.version : 0) + 1,