@wovin/core 0.2.0 → 0.3.0

package/dist/{chunk-L5EEEGE6.js → chunk-2OXLPZQI.js}

@@ -3,265 +3,645 @@ import {
 } from "./chunk-ZAADLBSB.js";
 
 // src/thread/basic.ts
-import { Logger } from "besonders-logger";
+import { Logger as Logger2 } from "besonders-logger";
 
-// src/query/subscribable.ts
-var SubscribableImpl = class {
-  _value;
-  _derivedSubscribers = [];
-  _subscribers = [];
-  _upstreamActive = false;
-  _activateUpstream;
-  _deactivateUpstream = null;
-  _equals;
-  constructor(initialValue, activateUpstream, opts) {
-    this._value = initialValue;
-    this._activateUpstream = activateUpstream ?? null;
-    this._equals = opts?.equals === false ? () => false : opts?.equals ?? ((a, b) => a === b);
+// src/applog/applog-utils.ts
+import { Logger } from "besonders-logger";
+import { isBefore } from "date-fns";
+import { partial, pick } from "lodash-es";
+import { isEqual } from "lodash-es";
+import stringify from "safe-stable-stringify";
+var { WARN, LOG, DEBUG, VERBOSE, ERROR } = Logger.setup(Logger.INFO);
+var isoDateStrCompare = (strA, strB, dir = "asc") => dir === "asc" ? strA.localeCompare(strB, "en-US") : strB.localeCompare(strA, "en-US");
+var objEqualByKeys = (keys, objA, objB) => {
+  return isEqual(pick(objA, keys), pick(objB, keys));
+};
+var valueEq = (a, b) => isEqual(a, b);
+var valueKey = (vl) => {
+  switch (typeof vl) {
+    case "string":
+    case "number":
+    case "boolean":
+      return vl;
+    default:
+      return vl === null ? null : "\0obj:" + stringify(vl);
   }
-  get value() {
-    return this._value;
+};
+var compareApplogsByTs = (logA, logB, dir = "asc") => {
+  const tsCmp = isoDateStrCompare(logA.ts, logB.ts, dir);
+  if (tsCmp !== 0) return tsCmp;
+  return dir === "asc" ? logA.cid.localeCompare(logB.cid) : logB.cid.localeCompare(logA.cid);
+};
+var compareApplogsByEnAt = partial(objEqualByKeys, ["en", "at"]);
+function isLaterByTsAndPv(a, b) {
+  const tsCmp = isoDateStrCompare(a.ts, b.ts);
+  if (tsCmp !== 0) return tsCmp > 0;
+  if (a.en === b.en && a.at === b.at) {
+    if (a.pv === b.cid) return true;
+    if (b.pv === a.cid) return false;
   }
-  subscribe(cb, type) {
-    if (!this._upstreamActive && this._activateUpstream) {
-      this._deactivateUpstream = this._activateUpstream();
-      this._upstreamActive = true;
-    }
-    const list = type === "derived" ? this._derivedSubscribers : this._subscribers;
-    list.push(cb);
-    return () => {
-      const idx = list.indexOf(cb);
-      if (idx >= 0) list.splice(idx, 1);
-      if (this._derivedSubscribers.length === 0 && this._subscribers.length === 0 && this._upstreamActive) {
-        this._deactivateUpstream?.();
-        this._deactivateUpstream = null;
-        this._upstreamActive = false;
-      }
-    };
+  return a.cid.localeCompare(b.cid) > 0;
+}
+function sortApplogsByTs(appLogArray, dir = "asc") {
+  appLogArray.sort((a, b) => compareApplogsByTs(a, b, dir));
+  let i = 0;
+  while (i < appLogArray.length) {
+    let j = i + 1;
+    while (j < appLogArray.length && appLogArray[j].ts === appLogArray[i].ts) j++;
+    if (j - i > 1) chainStabilizeCluster(appLogArray, i, j, dir);
+    i = j;
   }
-  /** Update value and notify subscribers (skips if equals check passes) */
-  _set(value) {
-    if (this._equals(value, this._value)) return;
-    this._value = value;
-    this._notify();
+  return appLogArray;
+}
+function chainStabilizeCluster(applogs, from, to, dir) {
+  const groups = /* @__PURE__ */ new Map();
+  for (let k = from; k < to; k++) {
+    const log = applogs[k];
+    const key = log.en + "|" + log.at;
+    const existing = groups.get(key);
+    if (existing) existing.push(log);
+    else groups.set(key, [log]);
   }
-  _notify() {
-    const derived = [...this._derivedSubscribers];
-    for (const sub of derived) sub();
-    const subs = [...this._subscribers];
-    for (const sub of subs) sub();
+  if (groups.size === to - from) return;
+  const orderedByGroup = /* @__PURE__ */ new Map();
+  for (const [key, logs] of groups) {
+    orderedByGroup.set(key, logs.length === 1 ? logs : topoSortByPv(logs, dir));
   }
-  dispose() {
-    this._deactivateUpstream?.();
-    this._deactivateUpstream = null;
-    this._derivedSubscribers.length = 0;
-    this._subscribers.length = 0;
-    this._upstreamActive = false;
+  const cursors = /* @__PURE__ */ new Map();
+  for (let k = from; k < to; k++) {
+    const key = applogs[k].en + "|" + applogs[k].at;
+    const cursor = cursors.get(key) ?? 0;
+    applogs[k] = orderedByGroup.get(key)[cursor];
+    cursors.set(key, cursor + 1);
   }
-};
-function isArrayInitEvent(event) {
-  return event.init !== void 0;
 }
-var SubscribableArrayImpl = class {
-  _items;
-  _derivedSubscribers = [];
-  _subscribers = [];
-  _upstreamActive = false;
-  _activateUpstream;
-  _deactivateUpstream = null;
-  constructor(initialItems, activateUpstream) {
-    this._items = initialItems;
-    this._activateUpstream = activateUpstream ?? null;
+function topoSortByPv(logs, dir) {
+  const cidSet = new Set(logs.map((l) => l.cid));
+  const childrenByPv = /* @__PURE__ */ new Map();
+  const roots = [];
+  for (const log of logs) {
+    if (log.pv && cidSet.has(log.pv)) {
+      const children = childrenByPv.get(log.pv);
+      if (children) children.push(log);
+      else childrenByPv.set(log.pv, [log]);
+    } else {
+      roots.push(log);
+    }
   }
-  get items() {
-    return this._items;
+  const lexCmp = (a, b) => a.cid.localeCompare(b.cid);
+  roots.sort(lexCmp);
+  for (const children of childrenByPv.values()) children.sort(lexCmp);
+  const result = [];
+  const visited = /* @__PURE__ */ new Set();
+  const stack = [...roots].reverse();
+  while (stack.length > 0) {
+    const log = stack.pop();
+    if (visited.has(log.cid)) continue;
+    visited.add(log.cid);
+    result.push(log);
+    const children = childrenByPv.get(log.cid);
+    if (children) for (let i = children.length - 1; i >= 0; i--) stack.push(children[i]);
   }
-  get length() {
-    return this._items.length;
+  if (result.length < logs.length) {
+    for (const log of logs) if (!visited.has(log.cid)) result.push(log);
   }
-  subscribe(cb, type) {
-    if (!this._upstreamActive && this._activateUpstream) {
-      this._deactivateUpstream = this._activateUpstream();
-      this._upstreamActive = true;
+  return dir === "desc" ? result.reverse() : result;
+}
+var isTsBefore = (log, logToCompare) => isBefore(new Date(log.ts), new Date(logToCompare.ts));
+var uniqueEnFromAppLogs = (appLogArray) => [...new Set(appLogArray.map((eachLog) => eachLog.en))];
+var areApplogsEqual = (logA, logB) => isEqual(logA, logB);
+var warnMissingRemoveDuplicateMode = () => {
+  WARN(`[removeDuplicateAppLogs] mode not set; pass 'safety' or 'cleanup' for optimal behavior`);
+};
+var removeDuplicateAppLogsCleanup = (appLogArray) => {
+  const logMap = /* @__PURE__ */ new Map();
+  const verboseEnabled = VERBOSE.isEnabled;
+  for (const eachLog of appLogArray) {
+    if (!eachLog) {
+      ERROR(`falsy entry in applogs`, appLogArray);
+      throw new Error(`falsy entry in applogs`);
     }
-    const list = type === "derived" ? this._derivedSubscribers : this._subscribers;
-    list.push(cb);
-    return () => {
-      const idx = list.indexOf(cb);
-      if (idx >= 0) list.splice(idx, 1);
-      if (this._derivedSubscribers.length === 0 && this._subscribers.length === 0 && this._upstreamActive) {
-        this._deactivateUpstream?.();
-        this._deactivateUpstream = null;
-        this._upstreamActive = false;
-      }
-    };
-  }
-  /** Push items and notify subscribers */
-  _push(...items) {
-    this._items.push(...items);
-    this._notify({ added: items, removed: null });
-  }
-  /** Remove items and notify subscribers */
-  _remove(items) {
-    for (const item of items) {
-      const idx = this._items.indexOf(item);
-      if (idx >= 0) this._items.splice(idx, 1);
+    if (!eachLog.cid) {
+      ERROR(`applog with missing CID`, eachLog);
+      throw new Error(`applog with missing CID`);
+    }
+    const key = eachLog.cid;
+    const existing = logMap.get(key);
+    if (existing) {
+      if (verboseEnabled) VERBOSE(`Skipping duplicate applog:`, [existing, eachLog]);
+    } else {
+      logMap.set(key, eachLog);
     }
-    this._notify({ added: [], removed: items });
-  }
-  /** Full reset — replace all items */
-  _reset(items) {
-    this._items = items;
-    this._notify({ init: [...this._items] });
-  }
-  _notify(event) {
-    const derived = [...this._derivedSubscribers];
-    for (const sub of derived) sub(event);
-    const subs = [...this._subscribers];
-    for (const sub of subs) sub(event);
-  }
-  dispose() {
-    this._deactivateUpstream?.();
-    this._deactivateUpstream = null;
-    this._derivedSubscribers.length = 0;
-    this._subscribers.length = 0;
-    this._upstreamActive = false;
   }
+  return Array.from(logMap.values());
 };
-
-// src/utils/debug-name.ts
-import stringify from "safe-stable-stringify";
-var createDebugName = ({ caller, thread, pattern, args }) => {
-  args = args || pattern;
-  const str = `${!Array.isArray(thread) && thread?.name ? thread.name + " | " : ""}${caller ?? "caller?"}${args ? `{${typeof args === "string" ? args : stringify(args)}}` : ""}`;
-  return str;
+var removeDuplicateAppLogsSafety = (appLogArray) => {
+  const seen = /* @__PURE__ */ new Set();
+  const verboseEnabled = VERBOSE.isEnabled;
+  const existingByCid = verboseEnabled ? /* @__PURE__ */ new Map() : null;
+  let result = null;
+  let index = 0;
+  for (const eachLog of appLogArray) {
+    if (!eachLog) {
+      ERROR(`falsy entry in applogs`, appLogArray);
+      throw new Error(`falsy entry in applogs`);
+    }
+    if (!eachLog.cid) {
+      ERROR(`applog with missing CID`, eachLog);
+      throw new Error(`applog with missing CID`);
+    }
+    const key = eachLog.cid;
+    if (seen.has(key)) {
+      if (!result) {
+        result = appLogArray.slice(0, index);
+      }
+      if (verboseEnabled) VERBOSE(`Skipping duplicate applog:`, [existingByCid?.get(key), eachLog]);
+    } else {
+      seen.add(key);
+      if (existingByCid) existingByCid.set(key, eachLog);
+      if (result) result.push(eachLog);
+    }
+    index++;
+  }
+  return result ?? appLogArray;
 };
-var createDebugNameObj = (args) => {
-  return { name: createDebugName(args) };
+var removeDuplicateAppLogs = (appLogArray, mode) => {
+  if (!mode) {
+    warnMissingRemoveDuplicateMode();
+    return removeDuplicateAppLogsCleanup(appLogArray);
+  }
+  return mode === "safety" ? removeDuplicateAppLogsSafety(appLogArray) : removeDuplicateAppLogsCleanup(appLogArray);
 };
-function prettifyThreadName(input) {
-  let depth = 0;
-  let result = "";
-  let insideCurlyBraces = 0;
-  for (let i = 0; i < input.length; i++) {
-    const char = input[i];
-    if (char === "(") {
-      result += char + "\n" + "	".repeat(++depth);
-    } else if (char === ")") {
-      result += "\n" + "	".repeat(--depth) + char;
-    } else if (char === "," && insideCurlyBraces === 0) {
-      result += char + "\n" + "	".repeat(depth);
-    } else if (char === "{" && insideCurlyBraces === 0) {
-      insideCurlyBraces++;
-      result += char + "\n" + "	".repeat(depth + 1);
-    } else if (char === "}" && insideCurlyBraces === 1) {
-      insideCurlyBraces--;
-      result += "\n" + "	".repeat(depth) + char;
-    } else if (char === "{" && insideCurlyBraces > 0) {
-      insideCurlyBraces++;
-      result += char;
-    } else if (char === "}" && insideCurlyBraces > 1) {
-      insideCurlyBraces--;
-      result += char;
+var getHashID = (stringifiable, lngth = 8) => cyrb53hash(stringify(stringifiable), 31, lngth);
+function isVariable(x) {
+  return typeof x === "string" && x.startsWith("?");
+}
+function variableNameWithoutQuestionmark(str) {
+  return str.slice(1);
+}
+function isStaticPattern(x) {
+  if (!["string", "boolean", "number", "function"].includes(typeof x)) WARN(`Unhandled pattern value type:`, typeof x, x);
+  return !isVariable(x) && ["string", "boolean", "number"].includes(typeof x);
+}
+function resolveOrRemoveVariables(pattern, candidate) {
+  let variablesToFill = {};
+  const newPattern = {};
+  for (const [patternKey, patternValue] of Object.entries(pattern)) {
+    if (isVariable(patternValue)) {
+      const varName = variableNameWithoutQuestionmark(patternValue);
+      const candidateValue = candidate[varName];
+      if (candidateValue) {
+        newPattern[patternKey] = candidateValue;
+      } else {
+        variablesToFill[patternKey] = varName;
+      }
     } else {
-      result += char;
+      newPattern[patternKey] = patternValue;
     }
   }
-  return result;
+  return [newPattern, variablesToFill];
 }
-
-// src/thread/basic.ts
-var { WARN, LOG, DEBUG, VERBOSE, ERROR } = Logger.setup(Logger.INFO, { prefix: "[thread]" });
-var isInitEvent = isArrayInitEvent;
-var Thread = class {
-  constructor(name, parents, filters, _applogs = []) {
-    this.name = name;
-    this._applogs = _applogs;
-    this.parents = parents === null ? null : arrayIfSingle(parents);
-    this.filters = filters;
-    if (this.parents?.length === 0) {
-      WARN(`[Thread] empty parents array`, name);
-    }
-  }
-  filters;
-  parents;
-  _derivedSubscribers = [];
-  _subscribers = [];
-  /** Monotonic counter incremented on every mutation. Used by memoizedFn to invalidate caches. */
-  _version = 0;
-  get readOnly() {
-    if (this.parents.length !== 1) return true;
-    return this.parents[0].readOnly;
+function matchVariable(variable, triplePart, context) {
+  if (context.hasOwnProperty(variable)) {
+    const bound = context[variable];
+    const match = matchPart(bound, triplePart, context);
+    return match;
   }
-  insert(appLogsToInsert) {
-    if (this.readOnly) throw ERROR(`[Thread] insert() called on read-only thread:`, this.nameAndSizeUntracked);
-    if (!this.parents) throw ERROR(`[Thread] insert() called on non-writable thread without parents:`, this.nameAndSizeUntracked);
-    if (this.parents?.length !== 1) throw ERROR(`[Thread] insert() called on thread with multiple parents:`, this.nameAndSizeUntracked);
-    return this.parents[0].insert(appLogsToInsert);
+  return { ...context, [variable]: triplePart };
+}
+function matchPartStatic(field, patternPart, atomPart) {
+  let result;
+  if (patternPart) {
+    const typ = typeof patternPart;
+    if (typ === "string") {
+      result = patternPart === atomPart;
+    } else if (typ === "function") {
+      result = patternPart(atomPart);
+    } else if (Array.isArray(patternPart)) {
+      throw ERROR(
+        `[matchPartStatic] a bare array is not a valid matcher for field '${field}'. Use anyOf(...) for set-membership, or a predicate (v) => isEqual(v, [...]) to match a literal array value.`,
+        patternPart
+      );
+    } else if (typeof patternPart.has === "function") {
+      result = patternPart.has(atomPart);
+    } else {
+      result = valueEq(patternPart, atomPart);
+    }
+  } else {
+    result = patternPart === atomPart;
   }
-  insertRaw(appLogsToInsert) {
-    if (this.readOnly) throw ERROR(`[Thread] insertRaw() called on read-only thread:`, this.nameAndSizeUntracked);
-    if (!this.parents) throw ERROR(`[Thread] insertRaw() called on non-writable thread without parents:`, this.nameAndSizeUntracked);
-    if (this.parents?.length !== 1) throw ERROR(`[Thread] insertRaw() called on thread with multiple parents:`, this.nameAndSizeUntracked);
-    return this.parents[0].insertRaw(appLogsToInsert);
+  if (field.charAt(0) === "!") {
+    return !result;
+  } else {
+    return result;
   }
-  subscribe(callback, type) {
-    const list = type === "derived" ? this._derivedSubscribers : this._subscribers;
-    list.push(callback);
-    return () => {
-      const idx = list.indexOf(callback);
-      if (idx >= 0) list.splice(idx, 1);
-    };
+}
+function matchPart(patternPart, atomPart, context) {
+  if (!context) {
+    return null;
   }
-  notifySubscribers(event) {
-    this._version++;
-    DEBUG(`[thread: ${this.name}] notifying`, this._derivedSubscribers.length, "derived +", this._subscribers.length, "subscribers of", { ...event, subs: this._subscribers });
-    const derived = [...this._derivedSubscribers];
-    for (const subscriber of derived) {
-      subscriber(event);
-    }
-    const subs = [...this._subscribers];
-    for (const subscriber of subs) {
-      subscriber(event);
+  if (typeof patternPart === "string") {
+    if (isVariable(patternPart)) {
+      return matchVariable(patternPart, atomPart, context);
     }
   }
-  // ── SubscribableArray<Applog> ──
-  get items() {
-    return this._applogs;
-  }
-  dispose() {
-    this._derivedSubscribers.length = 0;
-    this._subscribers.length = 0;
+  if (typeof patternPart === "function") {
+    return patternPart(atomPart) ? context : null;
   }
-  get applogs() {
-    return this._applogs;
+  if (Array.isArray(patternPart)) {
+    throw ERROR(
+      `[matchPart] a bare array is not a valid matcher. Use anyOf(...) for set-membership, or a predicate to match a literal array value.`,
+      patternPart
+    );
   }
-  get applogsCids() {
-    return this._applogs.map((l) => l.cid);
+  if (patternPart && typeof patternPart.has === "function") {
+    return patternPart.has(atomPart) ? context : null;
   }
-  get applogsCidSet() {
-    return new Set(this._applogs.map((l) => l.cid));
+  return valueEq(patternPart, atomPart) ? context : null;
+}
+function matchPattern(pattern, applog, context) {
+  return Object.entries(pattern).reduce((context2, [field, patternValue]) => {
+    const applogValue = applog[field];
+    const patternValT = patternValue;
+    return matchPart(patternValT, applogValue, context2);
+  }, context);
+}
+function actualize(context, find) {
+  return Object.fromEntries(find.map((findField) => {
+    if (context === null) {
+      throw new Error(`actualize context is null ${find}`);
+    }
+    return [
+      isVariable(findField) ? findField.replace(/^\?/, "") : findField,
+      isVariable(findField) ? context[findField] : findField
+    ];
+  }));
+}
+var sum = function sum2(array) {
+  var num = 0;
+  for (var i = 0, l = array.length; i < l; i++) num += array[i];
+  return num;
+};
+var mean = function mean2(array) {
+  return sum(array) / array.length;
+};
+var arrStats = {
+  max: function(array) {
+    return Math.max.apply(null, array);
+  },
+  min: function(array) {
+    return Math.min.apply(null, array);
+  },
+  range: function(array) {
+    return arrStats.max(array) - arrStats.min(array);
+  },
+  midrange: function(array) {
+    return arrStats.range(array) / 2;
+  },
+  sum,
+  mean,
+  average: mean,
+  median: function(array) {
+    array.sort(function(a, b) {
+      return a - b;
+    });
+    var mid = array.length / 2;
+    return mid % 1 ? array[mid - 0.5] : (array[mid - 1] + array[mid]) / 2;
+  },
+  modes: function(array) {
+    if (!array.length) return [];
+    var modeMap = {}, maxCount = 0, modes = [];
+    array.forEach(function(val) {
+      if (!modeMap[val]) modeMap[val] = 1;
+      else modeMap[val]++;
+      if (modeMap[val] > maxCount) {
+        modes = [val];
+        maxCount = modeMap[val];
+      } else if (modeMap[val] === maxCount) {
+        modes.push(val);
+        maxCount = modeMap[val];
+      }
+    });
+    return modes;
+  },
+  variance: function(array) {
+    var mean3 = arrStats.mean(array);
+    return arrStats.mean(array.map(function(num) {
+      return Math.pow(num - mean3, 2);
+    }));
+  },
+  standardDeviation: function(array) {
+    return Math.sqrt(arrStats.variance(array));
+  },
+  meanAbsoluteDeviation: function(array) {
+    var mean3 = arrStats.mean(array);
+    return arrStats.mean(array.map(function(num) {
+      return Math.abs(num - mean3);
+    }));
+  },
+  zScores: function(array) {
+    var mean3 = arrStats.mean(array);
+    var standardDeviation = arrStats.standardDeviation(array);
+    return array.map(function(num) {
+      return (num - mean3) / standardDeviation;
+    });
   }
-  map(fn) {
-    return this.applogs.map(fn);
+};
+arrStats.average = arrStats.mean;
+var tsNearlySame = (timeA, timeB) => timeB.startsWith(timeA.slice(0, timeA.length - 4));
+var cyrb53hash = function(str, seed = 13, strLength) {
+  if (!str?.length) {
+    throw new Error(`Empty string: ${str}`);
   }
-  get findLast() {
-    return this.applogs.findLast.bind(this.applogs);
+  let h1 = 3735928559 ^ seed;
+  let h2 = 1103547991 ^ seed;
+  for (let i = 0, ch; i < str.length; i++) {
+    ch = str.charCodeAt(i);
+    h1 = Math.imul(h1 ^ ch, 2654435761);
+    h2 = Math.imul(h2 ^ ch, 1597334677);
   }
-  get findFirst() {
-    return this.applogs.find.bind(this.applogs);
+  h1 = Math.imul(h1 ^ h1 >>> 16, 2246822507) ^ Math.imul(h2 ^ h2 >>> 13, 3266489909);
+  h2 = Math.imul(h2 ^ h2 >>> 16, 2246822507) ^ Math.imul(h1 ^ h1 >>> 13, 3266489909);
+  const asHex = (4294967296 * (2097151 & h2) + (h1 >>> 0)).toString(16);
+  return asHex.slice(-strLength).padStart(strLength, "0");
+};
+function arraysContainSameElements(arr1, arr2) {
+  if (arr1.length !== arr2.length) {
+    return false;
   }
-  get firstLog() {
-    return this.applogs[0];
+  const sortedArr1 = [...arr1].sort();
+  const sortedArr2 = [...arr2].sort();
+  for (let i = 0; i < sortedArr1.length; i++) {
+    if (sortedArr1[i] !== sortedArr2[i]) {
+      return false;
+    }
   }
-  get latestLog() {
+  return true;
+}
+function dateNowIso() {
+  const now = /* @__PURE__ */ new Date();
+  return now.toISOString();
+}
+
+// src/query/subscribable.ts
+var SubscribableImpl = class {
+  _value;
+  _derivedSubscribers = [];
+  _subscribers = [];
+  _upstreamActive = false;
+  _activateUpstream;
+  _deactivateUpstream = null;
+  _equals;
+  constructor(initialValue, activateUpstream, opts) {
+    this._value = initialValue;
+    this._activateUpstream = activateUpstream ?? null;
+    this._equals = opts?.equals === false ? () => false : opts?.equals ?? ((a, b) => a === b);
+  }
+  get value() {
+    return this._value;
+  }
+  subscribe(cb, type) {
+    if (!this._upstreamActive && this._activateUpstream) {
+      this._deactivateUpstream = this._activateUpstream();
+      this._upstreamActive = true;
+    }
+    const list = type === "derived" ? this._derivedSubscribers : this._subscribers;
+    list.push(cb);
+    return () => {
+      const idx = list.indexOf(cb);
+      if (idx >= 0) list.splice(idx, 1);
+      if (this._derivedSubscribers.length === 0 && this._subscribers.length === 0 && this._upstreamActive) {
+        this._deactivateUpstream?.();
+        this._deactivateUpstream = null;
+        this._upstreamActive = false;
+      }
+    };
+  }
+  /** Update value and notify subscribers (skips if equals check passes) */
+  _set(value) {
+    if (this._equals(value, this._value)) return;
+    this._value = value;
+    this._notify();
+  }
+  _notify() {
+    const derived = [...this._derivedSubscribers];
+    for (const sub of derived) sub();
+    const subs = [...this._subscribers];
+    for (const sub of subs) sub();
+  }
+  dispose() {
+    this._deactivateUpstream?.();
+    this._deactivateUpstream = null;
+    this._derivedSubscribers.length = 0;
+    this._subscribers.length = 0;
+    this._upstreamActive = false;
+  }
+};
+function isArrayInitEvent(event) {
+  return event.init !== void 0;
+}
+var SubscribableArrayImpl = class {
+  _items;
+  _derivedSubscribers = [];
+  _subscribers = [];
+  _upstreamActive = false;
+  _activateUpstream;
+  _deactivateUpstream = null;
+  constructor(initialItems, activateUpstream) {
+    this._items = initialItems;
+    this._activateUpstream = activateUpstream ?? null;
+  }
+  get items() {
+    return this._items;
+  }
+  get length() {
+    return this._items.length;
+  }
+  subscribe(cb, type) {
+    if (!this._upstreamActive && this._activateUpstream) {
+      this._deactivateUpstream = this._activateUpstream();
+      this._upstreamActive = true;
+    }
+    const list = type === "derived" ? this._derivedSubscribers : this._subscribers;
+    list.push(cb);
+    return () => {
+      const idx = list.indexOf(cb);
+      if (idx >= 0) list.splice(idx, 1);
+      if (this._derivedSubscribers.length === 0 && this._subscribers.length === 0 && this._upstreamActive) {
+        this._deactivateUpstream?.();
+        this._deactivateUpstream = null;
+        this._upstreamActive = false;
+      }
+    };
+  }
+  /** Push items and notify subscribers */
+  _push(...items) {
+    this._items.push(...items);
+    this._notify({ added: items, removed: null });
+  }
+  /** Remove items and notify subscribers */
+  _remove(items) {
+    for (const item of items) {
+      const idx = this._items.indexOf(item);
+      if (idx >= 0) this._items.splice(idx, 1);
+    }
+    this._notify({ added: [], removed: items });
+  }
+  /** Full reset — replace all items */
+  _reset(items) {
+    this._items = items;
+    this._notify({ init: [...this._items] });
+  }
+  _notify(event) {
+    const derived = [...this._derivedSubscribers];
+    for (const sub of derived) sub(event);
+    const subs = [...this._subscribers];
+    for (const sub of subs) sub(event);
+  }
+  dispose() {
+    this._deactivateUpstream?.();
+    this._deactivateUpstream = null;
+    this._derivedSubscribers.length = 0;
+    this._subscribers.length = 0;
+    this._upstreamActive = false;
+  }
+};
+
+// src/utils/debug-name.ts
+import stringify2 from "safe-stable-stringify";
+var createDebugName = ({ caller, thread, pattern, args }) => {
+  args = args || pattern;
+  const str = `${!Array.isArray(thread) && thread?.name ? thread.name + " | " : ""}${caller ?? "caller?"}${args ? `{${typeof args === "string" ? args : stringify2(args)}}` : ""}`;
+  return str;
+};
+var createDebugNameObj = (args) => {
+  return { name: createDebugName(args) };
+};
+function prettifyThreadName(input) {
+  let depth = 0;
+  let result = "";
+  let insideCurlyBraces = 0;
+  for (let i = 0; i < input.length; i++) {
+    const char = input[i];
+    if (char === "(") {
+      result += char + "\n" + "	".repeat(++depth);
+    } else if (char === ")") {
+      result += "\n" + "	".repeat(--depth) + char;
+    } else if (char === "," && insideCurlyBraces === 0) {
+      result += char + "\n" + "	".repeat(depth);
+    } else if (char === "{" && insideCurlyBraces === 0) {
+      insideCurlyBraces++;
+      result += char + "\n" + "	".repeat(depth + 1);
+    } else if (char === "}" && insideCurlyBraces === 1) {
+      insideCurlyBraces--;
+      result += "\n" + "	".repeat(depth) + char;
+    } else if (char === "{" && insideCurlyBraces > 0) {
+      insideCurlyBraces++;
+      result += char;
+    } else if (char === "}" && insideCurlyBraces > 1) {
+      insideCurlyBraces--;
+      result += char;
+    } else {
+      result += char;
+    }
+  }
+  return result;
+}
+
+// src/thread/basic.ts
+var { WARN: WARN2, LOG: LOG2, DEBUG: DEBUG2, VERBOSE: VERBOSE2, ERROR: ERROR2 } = Logger2.setup(Logger2.INFO, { prefix: "[thread]" });
+var isInitEvent = isArrayInitEvent;
+var Thread = class {
+  constructor(name, parents, filters, _applogs = []) {
+    this.name = name;
+    this._applogs = _applogs;
+    this.parents = parents === null ? null : arrayIfSingle(parents);
+    this.filters = filters;
+    if (this.parents?.length === 0) {
+      WARN2(`[Thread] empty parents array`, name);
+    }
+  }
+  name;
+  _applogs;
+  filters;
+  parents;
+  _derivedSubscribers = [];
+  _subscribers = [];
+  /** Monotonic counter incremented on every mutation. Used by memoizedFn to invalidate caches. */
+  _version = 0;
+  get readOnly() {
+    if (this.parents.length !== 1) return true;
+    return this.parents[0].readOnly;
+  }
+  insert(appLogsToInsert) {
+    if (this.readOnly) throw ERROR2(`[Thread] insert() called on read-only thread:`, this.nameAndSizeUntracked);
+    if (!this.parents) throw ERROR2(`[Thread] insert() called on non-writable thread without parents:`, this.nameAndSizeUntracked);
+    if (this.parents?.length !== 1) throw ERROR2(`[Thread] insert() called on thread with multiple parents:`, this.nameAndSizeUntracked);
+    return this.parents[0].insert(appLogsToInsert);
+  }
+  insertRaw(appLogsToInsert) {
+    if (this.readOnly) throw ERROR2(`[Thread] insertRaw() called on read-only thread:`, this.nameAndSizeUntracked);
+    if (!this.parents) throw ERROR2(`[Thread] insertRaw() called on non-writable thread without parents:`, this.nameAndSizeUntracked);
+    if (this.parents?.length !== 1) throw ERROR2(`[Thread] insertRaw() called on thread with multiple parents:`, this.nameAndSizeUntracked);
+    return this.parents[0].insertRaw(appLogsToInsert);
+  }
+  subscribe(callback, type) {
+    const list = type === "derived" ? this._derivedSubscribers : this._subscribers;
+    list.push(callback);
+    return () => {
+      const idx = list.indexOf(callback);
+      if (idx >= 0) list.splice(idx, 1);
+    };
+  }
+  notifySubscribers(event) {
+    this._version++;
+    DEBUG2(`[thread: ${this.name}] notifying`, this._derivedSubscribers.length, "derived +", this._subscribers.length, "subscribers of", { ...event, subs: this._subscribers });
+    const derived = [...this._derivedSubscribers];
+    for (const subscriber of derived) {
+      subscriber(event);
+    }
+    const subs = [...this._subscribers];
+    for (const subscriber of subs) {
+      subscriber(event);
+    }
+  }
+  // ── SubscribableArray<Applog> ──
+  get items() {
+    return this._applogs;
+  }
+  dispose() {
+    this._derivedSubscribers.length = 0;
+    this._subscribers.length = 0;
+  }
+  get applogs() {
+    return this._applogs;
+  }
+  get applogsCids() {
+    return this._applogs.map((l) => l.cid);
+  }
+  get applogsCidSet() {
+    return new Set(this._applogs.map((l) => l.cid));
+  }
+  map(fn) {
+    return this.applogs.map(fn);
+  }
+  get findLast() {
+    return this.applogs.findLast.bind(this.applogs);
+  }
+  get findFirst() {
+    return this.applogs.find.bind(this.applogs);
+  }
+  get firstLog() {
+    return this.applogs[0];
+  }
+  get latestLog() {
     return this.applogs[this.applogs.length - 1];
   }
   hasApplog(applog, byRef) {
     if (byRef) {
       return this.applogs.includes(applog);
     } else {
-      if (!applog.cid) throw ERROR(`[hasApplogs] applog without CID:`, applog);
+      if (!applog.cid) throw ERROR2(`[hasApplogs] applog without CID:`, applog);
       return this.hasApplogCid(applog.cid);
     }
   }
@@ -275,7 +655,7 @@ var Thread = class {
     return this.applogsByCid.get(cid.toString());
   }
   hasApplogWithDiffTs(applog) {
-    return this.applogs.find((existing) => existing.en === applog.en && existing.at === applog.at && existing.vl === applog.vl && existing.ag === applog.ag);
+    return this.applogs.find((existing) => existing.en === applog.en && existing.at === applog.at && valueEq(existing.vl, applog.vl) && existing.ag === applog.ag);
   }
   // get stateHash() {
   // 	blakeHasher.init()
@@ -329,7 +709,7 @@ import { Logger as Logger4 } from "besonders-logger";
 // src/ipfs/ipfs-utils.ts
 import * as dagJson from "@ipld/dag-json";
 import { sha256 } from "@noble/hashes/sha2.js";
-import { Logger as Logger2 } from "besonders-logger";
+import { Logger as Logger3 } from "besonders-logger";
 import { CID, digest as Digest } from "multiformats";
 import { encode as multiformatsEncode } from "multiformats/block";
 
@@ -344,17 +724,27 @@ FormatRegistry.Set("EntityID", (value) => !!value.match(isShortHash) || !!value.
 var EntityID = Type.String();
 var isEncryptedApplog = (l) => l?.enc instanceof Uint8Array;
 FormatRegistry.Set("CID", (value) => !!value.match(isCID));
-var CIDTB = Type.String({ format: "CID" });
+var CIDTB = Type.String({ pattern: isCID.source });
 var isURL = /^http([s]?):\/\/.*\..*/;
 FormatRegistry.Set("URL", (value) => !!value.match(isURL));
-var URL = Type.String({ format: "URL" });
+var URL = Type.String({ pattern: isURL.source });
+var JsonValueTB = Type.Recursive(
+  (This) => Type.Union([
+    Type.String(),
+    Type.Number(),
+    Type.Boolean(),
+    Type.Null(),
+    Type.Array(This),
+    Type.Record(Type.String(), This)
+  ])
+);
 var AppLogNoCidTB = Type.Object({
   en: EntityID,
   // EntityID
   at: Type.String(),
   // Attribute
-  vl: Nullable(Type.Union([Type.String(), Type.Boolean(), Type.Number()])),
-  // TODO refactor to semantic typesafe ApplogValue
+  vl: JsonValueTB,
+  // ApplogValue (JSON-serializable: primitives, arrays, objects)
   ts: Type.String(),
   // Timestamp
   ag: Type.String(),
@@ -378,466 +768,111 @@ var isValidApplog = AppLogTBC.Check.bind(AppLogTBC);
 // src/ipfs/ipfs-utils.ts
 import { base36 } from "multiformats/bases/base36";
 import { sha256 as sha265Hasher } from "multiformats/hashes/sha2";
-var { WARN: WARN2, LOG: LOG2, DEBUG: DEBUG2, VERBOSE: VERBOSE2, ERROR: ERROR2 } = Logger2.setup(Logger2.INFO);
+var { WARN: WARN3, LOG: LOG3, DEBUG: DEBUG3, VERBOSE: VERBOSE3, ERROR: ERROR3 } = Logger3.setup(Logger3.INFO);
 var MULTICODEC_IPNS_KEY = 114;
 function prepareForPub(log, without = ["cid"]) {
-  if (!log) throw ERROR2("falsy log", log);
+  if (!log) throw ERROR3("falsy log", log);
   let cid = log.cid;
   if (isEncryptedApplog(log)) {
     if (!cid) cid = getCidSync(encodeBlock(log).bytes).toString();
-    WARN2("preparing an encrypted applog - really?");
-    return { log, cid };
-  }
-  const logWithout = {};
-  for (let [key, val] of Object.entries(log)) {
-    if (val === void 0) {
-      WARN2(`log.${key} is undefined, which is not allowed - encoding as null`, log);
-      val = null;
-    }
-    if (!without.includes(key)) {
-      logWithout[key] = val;
-    } else {
-      VERBOSE2("excluding app log", { key, val });
-    }
-  }
-  return { log: logWithout, cid };
-}
-function encodeApplogAndGetCid(log) {
-  return getCidSync(encodeApplog(log).bytes);
-}
-function encodeApplog(log) {
-  return encodeBlock(prepareForPub(log)?.log);
-}
-function getCidSync(bytes) {
-  const hash = sha256(bytes);
-  const digest = Digest.create(sha265Hasher.code, hash);
-  const cid = CID.create(1, dagJson.code, digest);
-  VERBOSE2(`[getCidSync]`, { bytes, hash, digest, cid });
-  return cid;
-}
-function encodeBlock(jsonObject) {
-  DEBUG2("[encodeBlock]", jsonObject);
-  try {
-    const byteView = dagJson.encode(jsonObject);
-    return { bytes: byteView, cid: getCidSync(byteView) };
-  } catch (err) {
-    throw ERROR2("[encodeBlock] failed to encode:", jsonObject, err);
-  }
-}
-async function encodeBlockOriginal(jsonObject) {
-  const encoded = await multiformatsEncode({ value: jsonObject, codec: dagJson, hasher: sha265Hasher });
-  const syncVariant = encodeBlock(jsonObject);
-  if (syncVariant.cid.toString() !== encoded.cid.toString()) {
-    ERROR2(`[encodeBlockOriginal] sync cid mismatch`, { jsonObject, encoded, syncVariant });
-  }
-  return encoded;
-}
-function tryParseCID(cidString) {
-  let cid = null;
-  let errors = [];
-  try {
-    cid = CID.parse(cidString);
-  } catch (err) {
-    VERBOSE2(`[retrieveThread] couldn't parse pubID with default base`);
-    errors.push(err);
-  }
-  if (!cid) {
-    try {
-      cid = CID.parse(cidString, base36);
-    } catch (err) {
-      VERBOSE2(`[retrieveThread] couldn't parse pubID with base36`);
-      errors.push(err);
-    }
-  }
-  return {
-    cid,
-    errors: cid ? null : errors,
-    // we only care about errors if we failed to parse
-    isIpns: cid && isIpnsKeyCid(cid)
-  };
-}
-function isIpnsKeyCid(cid) {
-  return cid.code === MULTICODEC_IPNS_KEY;
-}
-function cidToString(cid) {
-  if (cid.code == MULTICODEC_IPNS_KEY) {
-    return toIpnsString(cid);
-  } else {
-    return cid.toString();
-  }
-}
-function toIpnsString(cid) {
-  if (cid.code !== MULTICODEC_IPNS_KEY) throw ERROR2(`Not an IPNS cid (${cid.code}):`, cid.toString());
-  return cid.toString(base36);
-}
-function ensureValidCIDinstance(cidOrStringA) {
-  return typeof cidOrStringA === "string" ? CID.parse(cidOrStringA) : typeof cidOrStringA.toV1 != "function" ? CID.decode(cidOrStringA.bytes) : cidOrStringA;
-}
-function areCidsEqual(cidOrStringA, cidOrStringB) {
-  if (!cidOrStringA || !cidOrStringB) throw new Error(`[areCidsEqual] invalid params: ${cidOrStringA}, ${cidOrStringB}`);
-  if (cidOrStringA === cidOrStringB) return true;
-  const cidA = ensureValidCIDinstance(cidOrStringA);
-  const cidB = ensureValidCIDinstance(cidOrStringB);
-  return cidA.toV1().toString() === cidB.toV1().toString();
-}
-function containsCid(list, needle) {
-  if (list instanceof Set) return list.has(typeof needle === "string" ? needle : needle.toV1().toString());
-  return list.some((cidOrString) => areCidsEqual(cidOrString, needle));
-}
-
-// src/applog/applog-utils.ts
-import { Logger as Logger3 } from "besonders-logger";
-import { isBefore } from "date-fns";
-import { partial, pick } from "lodash-es";
-import { isEqual } from "lodash-es";
-import stringify2 from "safe-stable-stringify";
-var { WARN: WARN3, LOG: LOG3, DEBUG: DEBUG3, VERBOSE: VERBOSE3, ERROR: ERROR3 } = Logger3.setup(Logger3.INFO);
-var isoDateStrCompare = (strA, strB, dir = "asc") => dir === "asc" ? strA.localeCompare(strB, "en-US") : strB.localeCompare(strA, "en-US");
-var objEqualByKeys = (keys, objA, objB) => {
-  return isEqual(pick(objA, keys), pick(objB, keys));
-};
-var compareApplogsByTs = (logA, logB, dir = "asc") => {
-  const tsCmp = isoDateStrCompare(logA.ts, logB.ts, dir);
-  if (tsCmp !== 0) return tsCmp;
-  return dir === "asc" ? logA.cid.localeCompare(logB.cid) : logB.cid.localeCompare(logA.cid);
-};
-var compareApplogsByEnAt = partial(objEqualByKeys, ["en", "at"]);
-function isLaterByTsAndPv(a, b) {
-  const tsCmp = isoDateStrCompare(a.ts, b.ts);
-  if (tsCmp !== 0) return tsCmp > 0;
-  if (a.en === b.en && a.at === b.at) {
-    if (a.pv === b.cid) return true;
-    if (b.pv === a.cid) return false;
-  }
-  return a.cid.localeCompare(b.cid) > 0;
-}
-function sortApplogsByTs(appLogArray, dir = "asc") {
-  appLogArray.sort((a, b) => compareApplogsByTs(a, b, dir));
-  let i = 0;
-  while (i < appLogArray.length) {
-    let j = i + 1;
-    while (j < appLogArray.length && appLogArray[j].ts === appLogArray[i].ts) j++;
-    if (j - i > 1) chainStabilizeCluster(appLogArray, i, j, dir);
-    i = j;
-  }
-  return appLogArray;
-}
-function chainStabilizeCluster(applogs, from, to, dir) {
-  const groups = /* @__PURE__ */ new Map();
-  for (let k = from; k < to; k++) {
-    const log = applogs[k];
-    const key = log.en + "|" + log.at;
-    const existing = groups.get(key);
-    if (existing) existing.push(log);
-    else groups.set(key, [log]);
-  }
-  if (groups.size === to - from) return;
-  const orderedByGroup = /* @__PURE__ */ new Map();
-  for (const [key, logs] of groups) {
-    orderedByGroup.set(key, logs.length === 1 ? logs : topoSortByPv(logs, dir));
-  }
-  const cursors = /* @__PURE__ */ new Map();
-  for (let k = from; k < to; k++) {
-    const key = applogs[k].en + "|" + applogs[k].at;
-    const cursor = cursors.get(key) ?? 0;
-    applogs[k] = orderedByGroup.get(key)[cursor];
-    cursors.set(key, cursor + 1);
-  }
-}
-function topoSortByPv(logs, dir) {
-  const cidSet = new Set(logs.map((l) => l.cid));
-  const childrenByPv = /* @__PURE__ */ new Map();
-  const roots = [];
-  for (const log of logs) {
-    if (log.pv && cidSet.has(log.pv)) {
-      const children = childrenByPv.get(log.pv);
-      if (children) children.push(log);
-      else childrenByPv.set(log.pv, [log]);
-    } else {
-      roots.push(log);
-    }
-  }
-  const lexCmp = (a, b) => a.cid.localeCompare(b.cid);
-  roots.sort(lexCmp);
-  for (const children of childrenByPv.values()) children.sort(lexCmp);
-  const result = [];
-  const visited = /* @__PURE__ */ new Set();
-  const stack = [...roots].reverse();
-  while (stack.length > 0) {
-    const log = stack.pop();
-    if (visited.has(log.cid)) continue;
-    visited.add(log.cid);
-    result.push(log);
-    const children = childrenByPv.get(log.cid);
-    if (children) for (let i = children.length - 1; i >= 0; i--) stack.push(children[i]);
-  }
-  if (result.length < logs.length) {
-    for (const log of logs) if (!visited.has(log.cid)) result.push(log);
-  }
-  return dir === "desc" ? result.reverse() : result;
-}
-var isTsBefore = (log, logToCompare) => isBefore(new Date(log.ts), new Date(logToCompare.ts));
-var uniqueEnFromAppLogs = (appLogArray) => [...new Set(appLogArray.map((eachLog) => eachLog.en))];
-var areApplogsEqual = (logA, logB) => isEqual(logA, logB);
-var warnMissingRemoveDuplicateMode = () => {
-  WARN3(`[removeDuplicateAppLogs] mode not set; pass 'safety' or 'cleanup' for optimal behavior`);
-};
-var removeDuplicateAppLogsCleanup = (appLogArray) => {
-  const logMap = /* @__PURE__ */ new Map();
-  const verboseEnabled = VERBOSE3.isEnabled;
-  for (const eachLog of appLogArray) {
-    if (!eachLog) {
-      ERROR3(`falsy entry in applogs`, appLogArray);
-      throw new Error(`falsy entry in applogs`);
-    }
-    if (!eachLog.cid) {
-      ERROR3(`applog with missing CID`, eachLog);
-      throw new Error(`applog with missing CID`);
-    }
-    const key = eachLog.cid;
-    const existing = logMap.get(key);
-    if (existing) {
-      if (verboseEnabled) VERBOSE3(`Skipping duplicate applog:`, [existing, eachLog]);
-    } else {
-      logMap.set(key, eachLog);
-    }
-  }
-  return Array.from(logMap.values());
-};
-var removeDuplicateAppLogsSafety = (appLogArray) => {
-  const seen = /* @__PURE__ */ new Set();
-  const verboseEnabled = VERBOSE3.isEnabled;
-  const existingByCid = verboseEnabled ? /* @__PURE__ */ new Map() : null;
-  let result = null;
-  let index = 0;
-  for (const eachLog of appLogArray) {
-    if (!eachLog) {
-      ERROR3(`falsy entry in applogs`, appLogArray);
-      throw new Error(`falsy entry in applogs`);
-    }
-    if (!eachLog.cid) {
-      ERROR3(`applog with missing CID`, eachLog);
-      throw new Error(`applog with missing CID`);
-    }
-    const key = eachLog.cid;
-    if (seen.has(key)) {
-      if (!result) {
-        result = appLogArray.slice(0, index);
-      }
-      if (verboseEnabled) VERBOSE3(`Skipping duplicate applog:`, [existingByCid?.get(key), eachLog]);
-    } else {
-      seen.add(key);
-      if (existingByCid) existingByCid.set(key, eachLog);
-      if (result) result.push(eachLog);
-    }
-    index++;
-  }
-  return result ?? appLogArray;
-};
-var removeDuplicateAppLogs = (appLogArray, mode) => {
-  if (!mode) {
-    warnMissingRemoveDuplicateMode();
-    return removeDuplicateAppLogsCleanup(appLogArray);
-  }
-  return mode === "safety" ? removeDuplicateAppLogsSafety(appLogArray) : removeDuplicateAppLogsCleanup(appLogArray);
-};
-var getHashID = (stringifiable, lngth = 8) => cyrb53hash(stringify2(stringifiable), 31, lngth);
-function isVariable(x) {
-  return typeof x === "string" && x.startsWith("?");
-}
-function variableNameWithoutQuestionmark(str) {
-  return str.slice(1);
-}
-function isStaticPattern(x) {
-  if (!["string", "boolean", "number", "function"].includes(typeof x)) WARN3(`Unhandled pattern value type:`, typeof x, x);
-  return !isVariable(x) && ["string", "boolean", "number"].includes(typeof x);
-}
-function resolveOrRemoveVariables(pattern, candidate) {
-  let variablesToFill = {};
-  const newPattern = {};
-  for (const [patternKey, patternValue] of Object.entries(pattern)) {
-    if (isVariable(patternValue)) {
-      const varName = variableNameWithoutQuestionmark(patternValue);
-      const candidateValue = candidate[varName];
-      if (candidateValue) {
-        newPattern[patternKey] = candidateValue;
-      } else {
-        variablesToFill[patternKey] = varName;
-      }
+    WARN3("preparing an encrypted applog - really?");
+    return { log, cid };
+  }
+  const logWithout = {};
+  for (let [key, val] of Object.entries(log)) {
+    if (val === void 0) {
+      WARN3(`log.${key} is undefined, which is not allowed - encoding as null`, log);
+      val = null;
+    }
+    if (!without.includes(key)) {
+      logWithout[key] = val;
     } else {
-      newPattern[patternKey] = patternValue;
+      VERBOSE3("excluding app log", { key, val });
     }
   }
-  return [newPattern, variablesToFill];
+  return { log: logWithout, cid };
 }
-function matchVariable(variable, triplePart, context) {
-  if (context.hasOwnProperty(variable)) {
-    const bound = context[variable];
-    const match = matchPart(bound, triplePart, context);
-    return match;
-  }
-  return { ...context, [variable]: triplePart };
+function encodeApplogAndGetCid(log) {
+  return getCidSync(encodeApplog(log).bytes);
 }
-function matchPartStatic(field, patternPart, atomPart) {
-  let result;
-  if (patternPart) {
-    const typ = typeof patternPart;
-    if (typ === "string") {
-      result = patternPart === atomPart;
-    } else if (typ === "function") {
-      result = patternPart(atomPart);
-    } else if (typeof patternPart.has === "function") {
-      result = patternPart.has(atomPart);
-    } else if (Array.isArray(patternPart) && !Array.isArray(atomPart)) {
-      result = patternPart.includes(atomPart);
-    } else {
-      result = patternPart === atomPart;
-    }
-  } else {
-    result = patternPart === atomPart;
+function encodeApplog(log) {
+  return encodeBlock(prepareForPub(log)?.log);
+}
+function getCidSync(bytes) {
+  const hash = sha256(bytes);
+  const digest = Digest.create(sha265Hasher.code, hash);
+  const cid = CID.create(1, dagJson.code, digest);
+  VERBOSE3(`[getCidSync]`, { bytes, hash, digest, cid });
+  return cid;
+}
+function encodeBlock(jsonObject) {
+  DEBUG3("[encodeBlock]", jsonObject);
+  try {
+    const byteView = dagJson.encode(jsonObject);
+    return { bytes: byteView, cid: getCidSync(byteView) };
+  } catch (err) {
+    throw ERROR3("[encodeBlock] failed to encode:", jsonObject, err);
   }
-  if (field.charAt(0) === "!") {
-    return !result;
-  } else {
-    return result;
+}
+async function encodeBlockOriginal(jsonObject) {
+  const encoded = await multiformatsEncode({ value: jsonObject, codec: dagJson, hasher: sha265Hasher });
+  const syncVariant = encodeBlock(jsonObject);
+  if (syncVariant.cid.toString() !== encoded.cid.toString()) {
+    ERROR3(`[encodeBlockOriginal] sync cid mismatch`, { jsonObject, encoded, syncVariant });
   }
+  return encoded;
 }
-function matchPart(patternPart, atomPart, context) {
-  if (!context) {
-    return null;
+function tryParseCID(cidString) {
+  let cid = null;
+  let errors = [];
+  try {
+    cid = CID.parse(cidString);
+  } catch (err) {
+    VERBOSE3(`[retrieveThread] couldn't parse pubID with default base`);
+    errors.push(err);
   }
-  if (typeof patternPart === "string") {
-    if (isVariable(patternPart)) {
-      return matchVariable(patternPart, atomPart, context);
+  if (!cid) {
+    try {
+      cid = CID.parse(cidString, base36);
+    } catch (err) {
+      VERBOSE3(`[retrieveThread] couldn't parse pubID with base36`);
+      errors.push(err);
     }
   }
-  if (typeof patternPart === "function") {
-    return patternPart(atomPart) ? context : null;
+  return {
+    cid,
+    errors: cid ? null : errors,
+    // we only care about errors if we failed to parse
+    isIpns: cid && isIpnsKeyCid(cid)
+  };
+}
+function isIpnsKeyCid(cid) {
+  return cid.code === MULTICODEC_IPNS_KEY;
+}
+function cidToString(cid) {
+  if (cid.code == MULTICODEC_IPNS_KEY) {
+    return toIpnsString(cid);
+  } else {
+    return cid.toString();
   }
-  return patternPart === atomPart ? context : null;
 }
-function matchPattern(pattern, applog, context) {
-  return Object.entries(pattern).reduce((context2, [field, patternValue]) => {
-    const applogValue = applog[field];
-    const patternValT = patternValue;
-    return matchPart(patternValT, applogValue, context2);
-  }, context);
+function toIpnsString(cid) {
+  if (cid.code !== MULTICODEC_IPNS_KEY) throw ERROR3(`Not an IPNS cid (${cid.code}):`, cid.toString());
+  return cid.toString(base36);
 }
-function actualize(context, find) {
-  return Object.fromEntries(find.map((findField) => {
-    if (context === null) {
-      throw new Error(`actualize context is null ${find}`);
-    }
-    return [
-      isVariable(findField) ? findField.replace(/^\?/, "") : findField,
-      isVariable(findField) ? context[findField] : findField
-    ];
-  }));
+function ensureValidCIDinstance(cidOrStringA) {
+  return typeof cidOrStringA === "string" ? CID.parse(cidOrStringA) : typeof cidOrStringA.toV1 != "function" ? CID.decode(cidOrStringA.bytes) : cidOrStringA;
 }
-var sum = function sum2(array) {
-  var num = 0;
-  for (var i = 0, l = array.length; i < l; i++) num += array[i];
-  return num;
-};
-var mean = function mean2(array) {
-  return sum(array) / array.length;
-};
-var arrStats = {
-  max: function(array) {
-    return Math.max.apply(null, array);
-  },
-  min: function(array) {
-    return Math.min.apply(null, array);
-  },
-  range: function(array) {
-    return arrStats.max(array) - arrStats.min(array);
-  },
-  midrange: function(array) {
-    return arrStats.range(array) / 2;
-  },
-  sum,
-  mean,
-  average: mean,
-  median: function(array) {
-    array.sort(function(a, b) {
-      return a - b;
-    });
-    var mid = array.length / 2;
-    return mid % 1 ? array[mid - 0.5] : (array[mid - 1] + array[mid]) / 2;
-  },
-  modes: function(array) {
-    if (!array.length) return [];
-    var modeMap = {}, maxCount = 0, modes = [];
-    array.forEach(function(val) {
-      if (!modeMap[val]) modeMap[val] = 1;
-      else modeMap[val]++;
-      if (modeMap[val] > maxCount) {
-        modes = [val];
-        maxCount = modeMap[val];
-      } else if (modeMap[val] === maxCount) {
-        modes.push(val);
-        maxCount = modeMap[val];
-      }
-    });
-    return modes;
-  },
-  variance: function(array) {
-    var mean3 = arrStats.mean(array);
-    return arrStats.mean(array.map(function(num) {
-      return Math.pow(num - mean3, 2);
-    }));
-  },
-  standardDeviation: function(array) {
-    return Math.sqrt(arrStats.variance(array));
-  },
-  meanAbsoluteDeviation: function(array) {
-    var mean3 = arrStats.mean(array);
-    return arrStats.mean(array.map(function(num) {
-      return Math.abs(num - mean3);
-    }));
-  },
-  zScores: function(array) {
-    var mean3 = arrStats.mean(array);
-    var standardDeviation = arrStats.standardDeviation(array);
-    return array.map(function(num) {
-      return (num - mean3) / standardDeviation;
-    });
-  }
-};
-arrStats.average = arrStats.mean;
-var tsNearlySame = (timeA, timeB) => timeB.startsWith(timeA.slice(0, timeA.length - 4));
-var cyrb53hash = function(str, seed = 13, strLength) {
-  if (!str?.length) {
-    throw new Error(`Empty string: ${str}`);
-  }
-  let h1 = 3735928559 ^ seed;
-  let h2 = 1103547991 ^ seed;
-  for (let i = 0, ch; i < str.length; i++) {
-    ch = str.charCodeAt(i);
-    h1 = Math.imul(h1 ^ ch, 2654435761);
-    h2 = Math.imul(h2 ^ ch, 1597334677);
-  }
-  h1 = Math.imul(h1 ^ h1 >>> 16, 2246822507) ^ Math.imul(h2 ^ h2 >>> 13, 3266489909);
-  h2 = Math.imul(h2 ^ h2 >>> 16, 2246822507) ^ Math.imul(h1 ^ h1 >>> 13, 3266489909);
-  const asHex = (4294967296 * (2097151 & h2) + (h1 >>> 0)).toString(16);
-  return asHex.slice(-strLength).padStart(strLength, "0");
-};
-function arraysContainSameElements(arr1, arr2) {
-  if (arr1.length !== arr2.length) {
-    return false;
-  }
-  const sortedArr1 = [...arr1].sort();
-  const sortedArr2 = [...arr2].sort();
-  for (let i = 0; i < sortedArr1.length; i++) {
-    if (sortedArr1[i] !== sortedArr2[i]) {
-      return false;
-    }
-  }
-  return true;
+function areCidsEqual(cidOrStringA, cidOrStringB) {
+  if (!cidOrStringA || !cidOrStringB) throw new Error(`[areCidsEqual] invalid params: ${cidOrStringA}, ${cidOrStringB}`);
+  if (cidOrStringA === cidOrStringB) return true;
+  const cidA = ensureValidCIDinstance(cidOrStringA);
+  const cidB = ensureValidCIDinstance(cidOrStringB);
+  return cidA.toV1().toString() === cidB.toV1().toString();
 }
-function dateNowIso() {
-  const now = /* @__PURE__ */ new Date();
-  return now.toISOString();
+function containsCid(list, needle) {
+  if (list instanceof Set) return list.has(typeof needle === "string" ? needle : needle.toV1().toString());
+  return list.some((cidOrString) => areCidsEqual(cidOrString, needle));
 }
 
 // src/applog/applog-helpers.ts
@@ -1066,6 +1101,10 @@ var MappedThread = class _MappedThread extends Thread {
       this.subscribeToParents();
     }
   }
+  name;
+  _derivation;
+  _writeMapper;
+  _readOnly;
   static mapWrites(parent, name, mapper) {
     return new _MappedThread(
       `${name}<${parent.nameAndSizeUntracked}>`,
@@ -1363,6 +1402,26 @@ var simpleApplogMapper = function simpleApplogMapper2(thread, logMapper, opts =
 
 // src/thread/indexes.ts
 import { Logger as Logger7 } from "besonders-logger";
+
+// src/query/matchers.ts
+function includes(str) {
+  return (vl) => vl?.includes?.(str);
+}
+function includedIn(arr) {
+  return (vl) => arr?.includes?.(vl);
+}
+function anyOf(...vals) {
+  for (const v of vals) {
+    if (v !== null && typeof v === "object") {
+      throw new Error(
+        `[anyOf] object/array members are not supported (referential Set membership would silently never match). Use a predicate matcher instead, e.g. (v) => members.some(m => isEqual(v, m)).`
+      );
+    }
+  }
+  return new Set(vals);
+}
+
+// src/thread/indexes.ts
 var { WARN: WARN7, LOG: LOG7, DEBUG: DEBUG7, VERBOSE: VERBOSE7, ERROR: ERROR7 } = Logger7.setup(Logger7.INFO);
 var applogsByEntity = memoizedFn(
   "applogsByEntity",
@@ -1401,19 +1460,21 @@ var applogsByAttrValue = memoizedFn(
   function applogsByAttrValue2(thread, attr) {
     const map = /* @__PURE__ */ new Map();
     const add = (log) => {
-      let arr = map.get(log.vl);
+      const key = valueKey(log.vl);
+      let arr = map.get(key);
       if (!arr) {
         arr = [];
-        map.set(log.vl, arr);
+        map.set(key, arr);
       }
       arr.push(log);
     };
     const remove = (log) => {
-      const arr = map.get(log.vl);
+      const key = valueKey(log.vl);
+      const arr = map.get(key);
       if (!arr) return;
       const idx = arr.indexOf(log);
       if (idx >= 0) arr.splice(idx, 1);
-      if (arr.length === 0) map.delete(log.vl);
+      if (arr.length === 0) map.delete(key);
     };
     const filtered = rollingFilter2(thread, { at: attr });
     for (const log of filtered.applogs) add(log);
@@ -1509,7 +1570,7 @@ var entityLinkIndex = memoizedFn(
       bByLink.clear();
       for (const log of applogs) processLog(log);
     }
-    const filtered = rollingFilter2(thread, { at: [attrA, attrB] });
+    const filtered = rollingFilter2(thread, { at: anyOf(attrA, attrB) });
     buildFull(filtered.applogs);
     const value = { byA, byB };
     const result = new SubscribableImpl(
@@ -1641,6 +1702,7 @@ var ThreadInMemory = class _ThreadInMemory extends WriteableThread {
     super(name, applogs, filters);
     this._readOnly = _readOnly;
   }
+  _readOnly;
   static empty(name) {
     return _ThreadInMemory.fromArray([], name ?? "empty in-memory", false);
   }
@@ -1767,6 +1829,7 @@ export {
   isEncryptedApplog,
   CIDTB,
   URL,
+  JsonValueTB,
   AppLogNoCidTB,
   AppLogNoCidTBC,
   getApplogNoCidTypeErrors,
@@ -1789,18 +1852,10 @@ export {
   ensureValidCIDinstance,
   areCidsEqual,
   containsCid,
-  SubscribableImpl,
-  isArrayInitEvent,
-  SubscribableArrayImpl,
-  createDebugName,
-  createDebugNameObj,
-  prettifyThreadName,
-  isInitEvent,
-  Thread,
-  getLogsFromThread,
-  StaticThread,
   isoDateStrCompare,
   objEqualByKeys,
+  valueEq,
+  valueKey,
   compareApplogsByTs,
   compareApplogsByEnAt,
   isLaterByTsAndPv,
@@ -1823,6 +1878,16 @@ export {
   cyrb53hash,
   arraysContainSameElements,
   dateNowIso,
+  SubscribableImpl,
+  isArrayInitEvent,
+  SubscribableArrayImpl,
+  createDebugName,
+  createDebugNameObj,
+  prettifyThreadName,
+  isInitEvent,
+  Thread,
+  getLogsFromThread,
+  StaticThread,
   memoizedFn,
   refCountedMemoizedFn,
   MappedThread,
@@ -1837,6 +1902,9 @@ export {
   assertOnlyCurrent,
   asReadOnly,
   simpleApplogMapper,
+  includes,
+  includedIn,
+  anyOf,
   applogsByEntity,
   applogsByAttrValue,
   entityLinkIndex,
@@ -1859,4 +1927,4 @@ export {
   withPvFrom,
   joinThreads
 };
-//# sourceMappingURL=chunk-L5EEEGE6.js.map
+//# sourceMappingURL=chunk-2OXLPZQI.js.map