memorio 4.9.8 → 4.9.10

package/README.md

@@ -285,6 +285,18 @@ memorio.registerSchema('user', {
 state.user = { name: 'Sara' }   // rejected — missing required "email"
 ```
 
+Array item validation is supported per-element with the `items` schema field:
+
+```ts
+memorio.registerSchema('tags', {
+  type: 'array',
+  items: { type: 'string' },
+})
+
+state.tags = ['a', 'b']   // accepted
+state.tags = [1, 2, 3]    // rejected — items must be strings
+```
+
 ## Local-first sync
 
 The local application owns its data; the cloud is optional transport.
@@ -302,7 +314,9 @@ memorio.memory.configure({
 })
 ```
 
-Conflict resolution defaults to *higher confidence wins, then more recent `lastConfirmedAt`* — override it when you need a different rule:
+When `replay()` pulls remote operations, entries are ordered causally by HLC timestamp. For
+*concurrent* writes to the same key (an HLC tie) the **remote entry wins by default**; provide a
+`resolveConflict` to override:
 
 ```ts
 memorio.memory.configure({
@@ -313,7 +327,9 @@ memorio.memory.configure({
 })
 ```
 
-This resolver only settles *client-side* divergence between what memorio has seen locally — the provider is still responsible for the final server-side policy.
+When no resolver is supplied, Memorio logs a warn (dev only) and applies the remote entry on a
+tie. The resolver only settles *client-side* divergence between what memorio has seen locally —
+the provider is still responsible for the final server-side policy.
 
 ## Cross-platform support
 

package/index.cjs

@@ -1820,6 +1820,14 @@ var _validateValue = /* @__PURE__ */ __name((value, schema2, path) => {
       }
     }
   }
+  if (schema2.type === "array" && Array.isArray(value) && schema2.items) {
+    for (let i = 0; i < value.length; i++) {
+      const itemResult = _validateValue(value[i], schema2.items, `${path}[${i}]`);
+      if (!itemResult.valid) {
+        errors.push(...itemResult.errors || []);
+      }
+    }
+  }
   return errors.length === 0 ? { valid: true } : { valid: false, errors };
 }, "_validateValue");
 var validate = /* @__PURE__ */ __name((path, value) => {
@@ -1880,7 +1888,8 @@ var buildProxy = /* @__PURE__ */ __name((obj, callback, tree = []) => {
   const event = /* @__PURE__ */ __name((name) => {
     try {
       dispatch.set(name, { detail: { name } });
-    } catch (_) {
+    } catch (err) {
+      if (exports.DEV) console.warn("[memorio state] event dispatch failed:", err);
     }
     return;
   }, "event");
@@ -1899,7 +1908,7 @@ var buildProxy = /* @__PURE__ */ __name((obj, callback, tree = []) => {
         }
         if (prop === "list") {
           message_default('Some state could be hidden when you use "state.list". Use "state" to see the complete list ');
-          return JSON.parse(JSON.stringify(target));
+          return deepRaw(target, /* @__PURE__ */ new WeakSet());
         }
         if (typeof prop === "string") {
           const path = tree.length > 0 ? "state." + tree.concat(prop).join(".") : "state." + prop;
@@ -2035,7 +2044,8 @@ var buildProxy = /* @__PURE__ */ __name((obj, callback, tree = []) => {
                     message_default(`State '${key}' is now unlocked.`);
                   }, "value")
                 });
-              } catch (_) {
+              } catch (err) {
+                if (exports.DEV) console.warn("[memorio state] lock/unlock defineProperty failed:", err);
               }
             }
           }
@@ -3263,7 +3273,7 @@ init_internal();
 
 // package.json
 var package_default = {
-  version: "4.9.8"};
+  version: "4.9.10"};
 
 // core/global.ts
 init_env();
@@ -3282,20 +3292,20 @@ __name(typed, "typed");
 // functions/history/index.ts
 init_cjs_shims();
 init_internal();
+init_env();
 init_message();
 function _clone(value) {
   if (value === null || typeof value !== "object") return value;
-  const ctor = value.constructor?.name;
-  if (ctor !== "Object" && ctor !== "Array") return value;
   try {
-    return JSON.parse(JSON.stringify(value));
-  } catch {
+    return deepRaw(value, /* @__PURE__ */ new WeakSet());
+  } catch (err) {
+    if (exports.DEV) console.warn("[memorio history] deep clone failed:", err);
     return value;
   }
 }
 __name(_clone, "_clone");
 var snapshot = /* @__PURE__ */ __name(() => {
-  return _clone(deepRaw(exports.state));
+  return deepRaw(exports.state, /* @__PURE__ */ new WeakSet());
 }, "snapshot");
 var diff = /* @__PURE__ */ __name((snap) => {
   const changes = [];
@@ -3445,9 +3455,11 @@ var clearRedo = /* @__PURE__ */ __name(() => {
 init_cjs_shims();
 init_store();
 init_idb();
+init_env();
 
 // functions/memory/journal.ts
 init_cjs_shims();
+init_env();
 init_store();
 var g2 = globalThis;
 function namespace() {
@@ -3468,7 +3480,8 @@ function parseEntry(raw) {
   try {
     if (typeof raw === "string") return JSON.parse(raw);
     return raw;
-  } catch {
+  } catch (err) {
+    if (exports.DEV) console.warn("[memorio memory] failed to parse journal entry:", err);
     return null;
   }
 }
@@ -3552,10 +3565,12 @@ var journal = {
    * local operations, then optionally pulls newer remote operations and applies
    * them. No-op (empty ack) when no provider is configured.
    *
-   * When pulling remote entries, HLC timestamps are used to order operations
-   * causally. Concurrent writes to the same key are resolved via the provider's
-   * `resolveConflict` method (if provided), falling back to HLC timestamp
-   * comparison.
+    * When pulling remote entries, HLC timestamps are used to order operations
+    * causally. Concurrent writes to the same key (HLC tie) are resolved via the
+    * provider's `resolveConflict` method (if provided), otherwise the REMOTE
+    * entry wins by default (logged at warn level in dev). Provide a resolver on
+    * the sync provider to override this behaviour and prevent silent local data
+    * loss.
    */
   async replay() {
     const ack = { synced: [], resolved: [] };
@@ -3591,7 +3606,11 @@ var journal = {
             if (ha && hb) {
               const cmp = hlc.compare(ha, hb);
               if (cmp === 0) {
-                const resolution = typeof provider.resolveConflict === "function" ? await provider.resolveConflict(localEntry, e) : "remote";
+                const hasResolver = typeof provider.resolveConflict === "function";
+                const resolution = hasResolver ? await provider.resolveConflict(localEntry, e) : "remote";
+                if (!hasResolver && exports.DEV) {
+                  console.warn(`[memorio memory] replay() conflict for "${e.id}": no resolveConflict handler provided, defaulting to remote-wins`);
+                }
                 ack.resolved?.push({ id: e.id, resolution });
                 if (resolution === "local") continue;
               } else if (cmp > 0) {
@@ -3602,7 +3621,8 @@ var journal = {
           await this.append(e, e.operation || "confirm");
           await this.markSynced([e.id]);
         }
-      } catch (_) {
+      } catch (err) {
+        if (exports.DEV) console.warn("[memorio memory] sync pull failed:", err);
       }
     }
     return ack;
@@ -3641,7 +3661,8 @@ async function recordJournal(entry, operation) {
   if (entry.scope === "hot") return;
   try {
     await journal_default.append(entry, operation);
-  } catch (_) {
+  } catch (err) {
+    if (exports.DEV) console.warn("[memorio memory] journal append failed:", err);
   }
 }
 __name(recordJournal, "recordJournal");
@@ -3804,7 +3825,8 @@ async function loadFromScope(id, scope, isSuperseded = false) {
     const entry = JSON.parse(raw);
     entry.id = entry.id || id;
     return entry;
-  } catch {
+  } catch (err) {
+    if (exports.DEV) console.warn("[memorio memory] failed to parse memory entry:", err);
     return null;
   }
 }
@@ -3850,7 +3872,8 @@ async function getAllIndexes() {
     const raw = exports.store.get(MEMORY_INDEX_KEY);
     if (!raw) return {};
     return JSON.parse(raw);
-  } catch {
+  } catch (err) {
+    if (exports.DEV) console.warn("[memorio memory] failed to parse memory index:", err);
     return {};
   }
 }
@@ -4121,6 +4144,7 @@ var memory = {
 
 // functions/inspect/index.ts
 init_cjs_shims();
+init_env();
 var stateKeys = /* @__PURE__ */ __name(() => {
   const raw = deepRaw(exports.state);
   return Object.keys(raw).filter(
@@ -4187,11 +4211,10 @@ function _getValue(path) {
 __name(_getValue, "_getValue");
 function _clone2(value) {
   if (value === null || typeof value !== "object") return value;
-  const ctor = value.constructor?.name;
-  if (ctor !== "Object" && ctor !== "Array") return value;
   try {
-    return JSON.parse(JSON.stringify(value));
-  } catch {
+    return deepRaw(value, /* @__PURE__ */ new WeakSet());
+  } catch (err) {
+    if (exports.DEV) console.warn("[memorio inspect] deep clone failed:", err);
     return value;
   }
 }
@@ -4218,15 +4241,18 @@ if (!("memorio" in globalThis)) {
       enumerable: false
     }
   );
-  Object.defineProperty(
-    globalThis,
-    "events",
-    {
-      value: {},
-      writable: true,
-      enumerable: false
-    }
-  );
+  if (!("events" in globalThis)) {
+    Object.defineProperty(
+      globalThis,
+      "events",
+      {
+        value: {},
+        writable: true,
+        enumerable: false,
+        configurable: true
+      }
+    );
+  }
   if (typeof globalThis.addEventListener === "function") {
     dispatch.listen("memorio:memory:cleanup", async () => memory.forgetExpired?.());
   }

package/index.js

@@ -1817,6 +1817,14 @@ var _validateValue = /* @__PURE__ */ __name((value, schema2, path2) => {
       }
     }
   }
+  if (schema2.type === "array" && Array.isArray(value) && schema2.items) {
+    for (let i = 0; i < value.length; i++) {
+      const itemResult = _validateValue(value[i], schema2.items, `${path2}[${i}]`);
+      if (!itemResult.valid) {
+        errors.push(...itemResult.errors || []);
+      }
+    }
+  }
   return errors.length === 0 ? { valid: true } : { valid: false, errors };
 }, "_validateValue");
 var validate = /* @__PURE__ */ __name((path2, value) => {
@@ -1877,7 +1885,8 @@ var buildProxy = /* @__PURE__ */ __name((obj, callback, tree = []) => {
   const event = /* @__PURE__ */ __name((name) => {
     try {
       dispatch.set(name, { detail: { name } });
-    } catch (_) {
+    } catch (err) {
+      if (DEV) console.warn("[memorio state] event dispatch failed:", err);
     }
     return;
   }, "event");
@@ -1896,7 +1905,7 @@ var buildProxy = /* @__PURE__ */ __name((obj, callback, tree = []) => {
         }
         if (prop === "list") {
           message_default('Some state could be hidden when you use "state.list". Use "state" to see the complete list ');
-          return JSON.parse(JSON.stringify(target));
+          return deepRaw(target, /* @__PURE__ */ new WeakSet());
         }
         if (typeof prop === "string") {
           const path2 = tree.length > 0 ? "state." + tree.concat(prop).join(".") : "state." + prop;
@@ -2032,7 +2041,8 @@ var buildProxy = /* @__PURE__ */ __name((obj, callback, tree = []) => {
                     message_default(`State '${key}' is now unlocked.`);
                   }, "value")
                 });
-              } catch (_) {
+              } catch (err) {
+                if (DEV) console.warn("[memorio state] lock/unlock defineProperty failed:", err);
               }
             }
           }
@@ -3260,7 +3270,7 @@ init_internal();
 
 // package.json
 var package_default = {
-  version: "4.9.8"};
+  version: "4.9.10"};
 
 // core/global.ts
 init_env();
@@ -3279,20 +3289,20 @@ __name(typed, "typed");
 // functions/history/index.ts
 init_esm_shims();
 init_internal();
+init_env();
 init_message();
 function _clone(value) {
   if (value === null || typeof value !== "object") return value;
-  const ctor = value.constructor?.name;
-  if (ctor !== "Object" && ctor !== "Array") return value;
   try {
-    return JSON.parse(JSON.stringify(value));
-  } catch {
+    return deepRaw(value, /* @__PURE__ */ new WeakSet());
+  } catch (err) {
+    if (DEV) console.warn("[memorio history] deep clone failed:", err);
     return value;
   }
 }
 __name(_clone, "_clone");
 var snapshot = /* @__PURE__ */ __name(() => {
-  return _clone(deepRaw(state2));
+  return deepRaw(state2, /* @__PURE__ */ new WeakSet());
 }, "snapshot");
 var diff = /* @__PURE__ */ __name((snap) => {
   const changes = [];
@@ -3442,9 +3452,11 @@ var clearRedo = /* @__PURE__ */ __name(() => {
 init_esm_shims();
 init_store();
 init_idb();
+init_env();
 
 // functions/memory/journal.ts
 init_esm_shims();
+init_env();
 init_store();
 var g2 = globalThis;
 function namespace() {
@@ -3465,7 +3477,8 @@ function parseEntry(raw) {
   try {
     if (typeof raw === "string") return JSON.parse(raw);
     return raw;
-  } catch {
+  } catch (err) {
+    if (DEV) console.warn("[memorio memory] failed to parse journal entry:", err);
     return null;
   }
 }
@@ -3549,10 +3562,12 @@ var journal = {
    * local operations, then optionally pulls newer remote operations and applies
    * them. No-op (empty ack) when no provider is configured.
    *
-   * When pulling remote entries, HLC timestamps are used to order operations
-   * causally. Concurrent writes to the same key are resolved via the provider's
-   * `resolveConflict` method (if provided), falling back to HLC timestamp
-   * comparison.
+    * When pulling remote entries, HLC timestamps are used to order operations
+    * causally. Concurrent writes to the same key (HLC tie) are resolved via the
+    * provider's `resolveConflict` method (if provided), otherwise the REMOTE
+    * entry wins by default (logged at warn level in dev). Provide a resolver on
+    * the sync provider to override this behaviour and prevent silent local data
+    * loss.
    */
   async replay() {
     const ack = { synced: [], resolved: [] };
@@ -3588,7 +3603,11 @@ var journal = {
             if (ha && hb) {
               const cmp = hlc.compare(ha, hb);
               if (cmp === 0) {
-                const resolution = typeof provider.resolveConflict === "function" ? await provider.resolveConflict(localEntry, e) : "remote";
+                const hasResolver = typeof provider.resolveConflict === "function";
+                const resolution = hasResolver ? await provider.resolveConflict(localEntry, e) : "remote";
+                if (!hasResolver && DEV) {
+                  console.warn(`[memorio memory] replay() conflict for "${e.id}": no resolveConflict handler provided, defaulting to remote-wins`);
+                }
                 ack.resolved?.push({ id: e.id, resolution });
                 if (resolution === "local") continue;
               } else if (cmp > 0) {
@@ -3599,7 +3618,8 @@ var journal = {
           await this.append(e, e.operation || "confirm");
           await this.markSynced([e.id]);
         }
-      } catch (_) {
+      } catch (err) {
+        if (DEV) console.warn("[memorio memory] sync pull failed:", err);
       }
     }
     return ack;
@@ -3638,7 +3658,8 @@ async function recordJournal(entry, operation) {
   if (entry.scope === "hot") return;
   try {
     await journal_default.append(entry, operation);
-  } catch (_) {
+  } catch (err) {
+    if (DEV) console.warn("[memorio memory] journal append failed:", err);
   }
 }
 __name(recordJournal, "recordJournal");
@@ -3801,7 +3822,8 @@ async function loadFromScope(id, scope, isSuperseded = false) {
     const entry = JSON.parse(raw);
     entry.id = entry.id || id;
     return entry;
-  } catch {
+  } catch (err) {
+    if (DEV) console.warn("[memorio memory] failed to parse memory entry:", err);
     return null;
   }
 }
@@ -3847,7 +3869,8 @@ async function getAllIndexes() {
     const raw = store.get(MEMORY_INDEX_KEY);
     if (!raw) return {};
     return JSON.parse(raw);
-  } catch {
+  } catch (err) {
+    if (DEV) console.warn("[memorio memory] failed to parse memory index:", err);
     return {};
   }
 }
@@ -4118,6 +4141,7 @@ var memory = {
 
 // functions/inspect/index.ts
 init_esm_shims();
+init_env();
 var stateKeys = /* @__PURE__ */ __name(() => {
   const raw = deepRaw(state2);
   return Object.keys(raw).filter(
@@ -4184,11 +4208,10 @@ function _getValue(path2) {
 __name(_getValue, "_getValue");
 function _clone2(value) {
   if (value === null || typeof value !== "object") return value;
-  const ctor = value.constructor?.name;
-  if (ctor !== "Object" && ctor !== "Array") return value;
   try {
-    return JSON.parse(JSON.stringify(value));
-  } catch {
+    return deepRaw(value, /* @__PURE__ */ new WeakSet());
+  } catch (err) {
+    if (DEV) console.warn("[memorio inspect] deep clone failed:", err);
     return value;
   }
 }
@@ -4215,15 +4238,18 @@ if (!("memorio" in globalThis)) {
       enumerable: false
     }
   );
-  Object.defineProperty(
-    globalThis,
-    "events",
-    {
-      value: {},
-      writable: true,
-      enumerable: false
-    }
-  );
+  if (!("events" in globalThis)) {
+    Object.defineProperty(
+      globalThis,
+      "events",
+      {
+        value: {},
+        writable: true,
+        enumerable: false,
+        configurable: true
+      }
+    );
+  }
   if (typeof globalThis.addEventListener === "function") {
     dispatch.listen("memorio:memory:cleanup", async () => memory.forgetExpired?.());
   }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "memorio",
   "codeName": "memorio",
-  "version": "4.9.8",
+  "version": "4.9.10",
   "description": "Memorio, State + Observer, Store and iDB for an easy life - Cross-platform compatible",
   "main": "./index.cjs",
   "browser": {