@wovin/core 0.1.36 → 0.2.0

package/dist/thread/mapped.d.ts

@@ -1,27 +1,56 @@
-import { Applog, ApplogForInsert } from '../applog/datom-types';
-import { Thread, ThreadEvent } from './basic';
-export type ApplogEventMapper = (this: MappedThread, event: ThreadEvent, sourceThread: Thread) => ThreadEvent;
+import { Applog, ApplogForInsert } from '../applog/datom-types.ts';
+import { Thread, ThreadEvent } from './basic.ts';
+/** Delta event — only incremental changes (no init) */
+export type DeltaEvent = {
+    added: readonly Applog[];
+    removed: readonly Applog[] | null;
+};
+/** Context passed to mapDelta — explicit deps, no `this` needed */
+export interface DeltaContext {
+    /** The parent thread that emitted the delta */
+    source: Thread;
+    /** All current parent threads */
+    parents: readonly Thread[];
+    /** The mapped thread's output before this delta is applied */
+    state: readonly Applog[];
+}
+/**
+ * Derivation for a MappedThread — separates full recomputation from incremental updates.
+ *
+ * - `compute` produces full state from parents (construction, reset, parent reinit)
+ * - `mapDelta` transforms a parent's incremental delta (optional — falls back to compute)
+ */
+export interface ThreadDerivation {
+    /** Compute full state from parents. Called at construction, triggerRemap, and parent reinit. */
+    compute(parents: readonly Thread[]): Applog[];
+    /**
+     * Transform an incremental delta from a parent.
+     * Return null to fall back to full recompute via compute().
+     * Optional — if omitted, every parent change triggers compute().
+     */
+    mapDelta?: (delta: DeltaEvent, ctx: DeltaContext) => DeltaEvent | null;
+}
 export type ApplogWriteMapper = (this: MappedThread, applogs: Applog[] | ApplogForInsert[]) => Applog[] | ApplogForInsert[] | null;
 export declare class MappedThread extends Thread {
     readonly name: string;
-    readonly _initialLogs: Applog[];
-    private _eventMapper;
+    private _derivation;
     private _writeMapper;
     private _readOnly?;
     static mapWrites(parent: Thread, name: string, mapper: ApplogWriteMapper): MappedThread;
     static asReadOnly(parent: Thread): Thread;
     private _parentSubscriptions;
-    constructor(name: string, parents: Thread | readonly Thread[], filters: readonly string[], _initialLogs: Applog[], _eventMapper: ApplogEventMapper | null, _writeMapper?: ApplogWriteMapper, _readOnly?: boolean);
+    constructor(name: string, parents: Thread | readonly Thread[], filters: readonly string[], _derivation: ThreadDerivation | null, _writeMapper?: ApplogWriteMapper, _readOnly?: boolean);
     insert(appLogsToInsert: ApplogForInsert[]): void;
     insertRaw(appLogsToInsert: Applog[]): void;
     private subscribeToParents;
+    /** Tear down parent subscriptions and clear internal state */
+    dispose(): void;
+    /** Swap parents at runtime — re-subscribes and recomputes applogs, notifying downstream */
+    setParents(newParents: readonly Thread[]): void;
     subscribe(callback: (event: ThreadEvent) => void, type?: 'derived' | 'reaction'): () => void;
-    /**
-     * // HACK to trigger remap on pattern change in rollingFilter
-     * should not be used lightly
-     */
+    /** Recompute full state from parents via compute() */
     triggerRemap(): void;
-    protected onParentUpdate(thread: Thread, event: ThreadEvent): void;
+    protected onParentUpdate(sourceThread: Thread, event: ThreadEvent): void;
     get readOnly(): boolean;
 }
 //# sourceMappingURL=mapped.d.ts.map

package/dist/thread/mapped.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapped.d.ts","sourceRoot":"","sources":["../../src/thread/mapped.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAe,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAI1D,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,KAAK,WAAW,CAAA;AAE7G,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,KAAK,MAAM,EAAE,GAAG,eAAe,EAAE,GAAG,IAAI,CAAA;AAElI,qBAAa,YAAa,SAAQ,MAAM;IA4BtC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAGrB,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE;IAC/B,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,SAAS,CAAC;IAjCnB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB;IAWxE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM;IAahC,OAAO,CAAC,oBAAoB,CAAkC;gBAGpD,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACnC,OAAO,EAAE,SAAS,MAAM,EAAE,EACjB,YAAY,EAAE,MAAM,EAAE,EACvB,YAAY,EAAE,iBAAiB,GAAG,IAAI,EACtC,YAAY,GAAE,iBAAwB,EACtC,SAAS,CAAC,EAAE,OAAO;IAsBrB,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE;IAMzC,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE;IAO1C,OAAO,CAAC,kBAAkB;IA6C1B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU;IAQ/E;;;OAGG;IACH,YAAY;IAWZ,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAgC3D,IAAI,QAAQ,YAEX;CACD"}
+{"version":3,"file":"mapped.d.ts","sourceRoot":"","sources":["../../src/thread/mapped.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAElE,OAAO,EAAe,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAM7D,uDAAuD;AACvD,MAAM,MAAM,UAAU,GAAG;IAAE,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAA;CAAE,CAAA;AAExF,mEAAmE;AACnE,MAAM,WAAW,YAAY;IAC5B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1B,8DAA8D;IAC9D,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAChC,gGAAgG;IAChG,OAAO,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAAA;IAE7C;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,YAAY,KAAK,UAAU,GAAG,IAAI,CAAA;CACtE;AAKD,MAAM,MAAM,iBAAiB,GAAG,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,eAAe,EAAE,KAAK,MAAM,EAAE,GAAG,eAAe,EAAE,GAAG,IAAI,CAAA;AAIlI,qBAAa,YAAa,SAAQ,MAAM;IAwBtC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAGrB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,SAAS,CAAC;IA5BnB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB;IASxE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM;IAWhC,OAAO,CAAC,oBAAoB,CAAkC;gBAGpD,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EACnC,OAAO,EAAE,SAAS,MAAM,EAAE,EAClB,WAAW,EAAE,gBAAgB,GAAG,IAAI,EACpC,YAAY,GAAE,iBAAwB,EACtC,SAAS,CAAC,EAAE,OAAO;IAwBrB,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE;IAMzC,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE;IAO1C,OAAO,CAAC,kBAAkB;IAe1B,8DAA8D;IAC9D,OAAO;IASP,2FAA2F;IAC3F,UAAU,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE;IAOxC,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU;IAO/E,sDAAsD;IACtD,YAAY;IASZ,SAAS,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IA0DjE,IAAI,QAAQ,YAEX;CACD"}

package/dist/thread/utils.d.ts

@@ -1,8 +1,8 @@
 import { CID } from 'multiformats';
-import { compareApplogsByEnAt } from '../applog/applog-utils';
-import { Applog, ApplogForInsert, CidString } from '../applog/datom-types';
-import { Thread } from './basic';
-import { MappedThread } from './mapped';
+import { compareApplogsByEnAt } from '../applog/applog-utils.ts';
+import { Applog, ApplogForInsert, CidString } from '../applog/datom-types.ts';
+import { Thread } from './basic.ts';
+import { MappedThread } from './mapped.ts';
 export declare function entityCount(thread: Thread): number;
 export declare function allEntityIDs(thread: Thread): Set<string>;
 export declare function debounceWrites(thread: Thread, wait?: number, removeDuplicatesWith?: (objA: object, objB: object) => boolean): MappedThread;
@@ -14,7 +14,7 @@ export declare function holdTillFirstWrite(thread: Thread, applogsToHold: Applog
     deduplicateHoldItemsWith?: typeof compareApplogsByEnAt;
     onFirstWrite: (heldLogsToInsert: Applog[]) => Applog[] | undefined;
 }): MappedThread;
-export declare function getAgents(thread: Thread): import("..").AgentHash[];
+export declare function getAgents(thread: Thread): import("../applog.ts").AgentHash[];
 /**
  * Returns applogs NOT contained in the exclusion set.
  * Uses CID-based comparison (consistent with removeDuplicateAppLogs).

package/dist/thread/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/thread/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,OAAO,EAAE,oBAAoB,EAAsC,MAAM,wBAAwB,CAAA;AACjG,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAY,MAAM,uBAAuB,CAAA;AACpF,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAChC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAKvC,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,UAEzC;AACD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,eAE1C;AAcD,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,SAAM,EACV,oBAAoB,0CAAuB,gBA4B3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,eAAe,EAAE,EAChC,IAAI,EAAE;IACL,wBAAwB,CAAC,EAAE,OAAO,oBAAoB,CAAA;IACtD,YAAY,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,SAAS,CAAA;CAClE,gBA8CD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,4BAEvC;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACrC,SAAS,SAAS,MAAM,EAAE,EAC1B,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,KACxD,MAAM,EAcR,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/thread/utils.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAElC,OAAO,EAAE,oBAAoB,EAAsC,MAAM,2BAA2B,CAAA;AACpG,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,SAAS,EAAY,MAAM,0BAA0B,CAAA;AACvF,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAK1C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,UAEzC;AACD,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,eAE1C;AAcD,wBAAgB,cAAc,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,SAAM,EACV,oBAAoB,0CAAuB,gBA4B3C;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,eAAe,EAAE,EAChC,IAAI,EAAE;IACL,wBAAwB,CAAC,EAAE,OAAO,oBAAoB,CAAA;IACtD,YAAY,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,GAAG,SAAS,CAAA;CAClE,gBAyCD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,sCAEvC;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,GACrC,SAAS,SAAS,MAAM,EAAE,EAC1B,SAAS,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,GAAG,SAAS,CAAC,KACxD,MAAM,EAcR,CAAA"}

package/dist/thread/writeable.d.ts

@@ -1,5 +1,5 @@
-import { type Applog, ApplogForInsert, CidString } from '../applog/datom-types';
-import { Thread } from './basic';
+import { type Applog, ApplogForInsert, CidString } from '../applog/datom-types.ts';
+import { Thread } from './basic.ts';
 export declare abstract class WriteableThread extends Thread {
     constructor(name: string, applogs: Applog[], filters: readonly string[]);
     purge(cidsToPurge: CidString[]): number;

package/dist/thread/writeable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeable.d.ts","sourceRoot":"","sources":["../../src/thread/writeable.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,KAAK,MAAM,EAAE,eAAe,EAAE,SAAS,EAAiB,MAAM,uBAAuB,CAAA;AAC9F,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAIhC,8BAAsB,eAAgB,SAAQ,MAAM;gBAElD,IAAI,EAAE,MAAM,EAEZ,OAAO,EAAE,MAAM,EAAO,EACtB,OAAO,EAAE,SAAS,MAAM,EAAE;IAWpB,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE;IAM9B,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE;IAWhD;;;;OAIG;IACI,aAAa,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,UAAQ,GAAG,MAAM,EAAE;IASjF;;;;;;;;;;;;;;OAcG;IACI,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE;IA6D1C,IAAI,QAAQ,YAEX;IAED,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CACzD;AACD,qBAAa,cAAe,SAAQ,eAAe;IAgBjD,QAAQ,CAAC,SAAS,EAAE,OAAO;IAf5B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM;IAG1B,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ;IAGnE,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM;gBAMjE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,SAAS,MAAM,EAAE,EACjB,SAAS,EAAE,OAAO;IAU5B,IAAI,QAAQ,YAEX;cAEe,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE;CAMtC"}
+{"version":3,"file":"writeable.d.ts","sourceRoot":"","sources":["../../src/thread/writeable.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,KAAK,MAAM,EAAE,eAAe,EAAE,SAAS,EAAiB,MAAM,0BAA0B,CAAA;AACjG,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAInC,8BAAsB,eAAgB,SAAQ,MAAM;gBAElD,IAAI,EAAE,MAAM,EAEZ,OAAO,EAAE,MAAM,EAAO,EACtB,OAAO,EAAE,SAAS,MAAM,EAAE;IAKpB,KAAK,CAAC,WAAW,EAAE,SAAS,EAAE;IAM9B,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE;IAWhD;;;;OAIG;IACI,aAAa,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,EAAE,KAAK,UAAQ,GAAG,MAAM,EAAE;IASjF;;;;;;;;;;;;;;OAcG;IACI,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE;IA6D1C,IAAI,QAAQ,YAEX;IAED,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CACzD;AACD,qBAAa,cAAe,SAAQ,eAAe;IAgBjD,QAAQ,CAAC,SAAS,EAAE,OAAO;IAf5B,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM;IAG1B,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,UAAQ;IAGnE,MAAM,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM;gBAMjE,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EAAE,EACjB,OAAO,EAAE,SAAS,MAAM,EAAE,EACjB,SAAS,EAAE,OAAO;IAK5B,IAAI,QAAQ,YAEX;cAEe,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE;CAMtC"}

package/dist/thread.d.ts

@@ -1,6 +1,7 @@
-export * from './thread/basic';
-export * from './thread/filters';
-export * from './thread/mapped';
-export * from './thread/writeable';
-export * from './thread/utils';
+export * from './thread/basic.ts';
+export * from './thread/filters.ts';
+export * from './thread/indexes.ts';
+export * from './thread/mapped.ts';
+export * from './thread/writeable.ts';
+export * from './thread/utils.ts';
 //# sourceMappingURL=thread.d.ts.map

package/dist/thread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../src/thread.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA"}
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../src/thread.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA"}

package/dist/{thread.min.js → thread.js}

@@ -5,11 +5,14 @@ import {
   ThreadInMemory,
   WriteableThread,
   allEntityIDs,
+  applogsByAttrValue,
+  applogsByEntity,
   asReadOnly,
   assertOnlyCurrent,
   assertRaw,
   debounceWrites,
   entityCount,
+  entityLinkIndex,
   excludeApplogsContainedIn,
   getAgents,
   getLogsFromThread,
@@ -23,11 +26,8 @@ import {
   rollingFilter,
   rollingMapper,
   simpleApplogMapper
-} from "./chunk-GDX2OO7L.min.js";
-import "./chunk-HYMC7W6S.min.js";
-import "./chunk-QO2KMGDN.min.js";
-import "./chunk-KEHU7HGZ.min.js";
-import "./chunk-PHITDXZT.min.js";
+} from "./chunk-L5EEEGE6.js";
+import "./chunk-ZAADLBSB.js";
 export {
   MappedThread,
   StaticThread,
@@ -35,11 +35,14 @@ export {
   ThreadInMemory,
   WriteableThread,
   allEntityIDs,
+  applogsByAttrValue,
+  applogsByEntity,
   asReadOnly,
   assertOnlyCurrent,
   assertRaw,
   debounceWrites,
   entityCount,
+  entityLinkIndex,
   excludeApplogsContainedIn,
   getAgents,
   getLogsFromThread,
@@ -54,4 +57,4 @@ export {
   rollingMapper,
   simpleApplogMapper
 };
-//# sourceMappingURL=thread.min.js.map
+//# sourceMappingURL=thread.js.map

package/dist/types/typescript-utils.d.ts

@@ -1,6 +1,10 @@
 import { Type as T } from '@sinclair/typebox';
-import { IObservableArray, ObservableSet } from 'mobx';
-declare const StringTB: (options?: import("@sinclair/typebox").StringOptions) => import("@sinclair/typebox").TString, OptionalTB: <T extends import("@sinclair/typebox").TSchema>(schema: T) => import("@sinclair/typebox").TOptional<T>, BooleanTB: (options?: import("@sinclair/typebox").SchemaOptions) => import("@sinclair/typebox").TBoolean, ObjectTB: <T extends import("@sinclair/typebox").TProperties>(properties: T, options?: import("@sinclair/typebox").ObjectOptions) => import("@sinclair/typebox").TObject<T>, NumberTB: (options?: import("@sinclair/typebox").NumericOptions<number>) => import("@sinclair/typebox").TNumber;
+declare const StringTB: (options?: import("@sinclair/typebox").StringOptions) => import("@sinclair/typebox").TString, OptionalTB: {
+    <Type extends import("@sinclair/typebox").TMappedResult, Flag extends boolean>(type: Type, enable: Flag): import("@sinclair/typebox").TOptionalFromMappedResult<Type, Flag>;
+    <Type extends import("@sinclair/typebox").TSchema, Flag extends boolean>(type: Type, enable: Flag): import("@sinclair/typebox").TOptionalWithFlag<Type, Flag>;
+    <Type extends import("@sinclair/typebox").TMappedResult>(type: Type): import("@sinclair/typebox").TOptionalFromMappedResult<Type, true>;
+    <Type extends import("@sinclair/typebox").TSchema>(type: Type): import("@sinclair/typebox").TOptionalWithFlag<Type, true>;
+}, BooleanTB: (options?: import("@sinclair/typebox").SchemaOptions) => import("@sinclair/typebox").TBoolean, ObjectTB: <T extends import("@sinclair/typebox").TProperties>(properties: T, options?: import("@sinclair/typebox").ObjectOptions) => import("@sinclair/typebox").TObject<T>, NumberTB: (options?: import("@sinclair/typebox").NumberOptions) => import("@sinclair/typebox").TNumber;
 export declare const Str: typeof StringTB;
 export declare const Num: typeof NumberTB;
 export declare const Obj: typeof ObjectTB;
@@ -28,9 +32,6 @@ export type ArrayOrSingle<T> = T | T[] | readonly T[];
 export declare function arrayIfSingle<T>(arrOrSingle: ArrayOrSingle<T>): readonly T[];
 export type ArrayType<T> = T extends (infer U)[] ? U : T;
 export type ArrayElementType<T> = T extends readonly (infer U)[] ? Extract<U, string> : never;
-export type X<T> = ArrayType<IObservableArray<T>>;
-export type ReadonlyObservableArray<T> = ReadonlyArray<T>;
-export type ReadonlyObservableSet<T> = ObservableSet<T>;
 export type ConstructorType<T, S = {}> = {
     new (...args: any[]): T;
 } & S;

package/dist/types/typescript-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typescript-utils.d.ts","sourceRoot":"","sources":["../../src/types/typescript-utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"typescript-utils.d.ts","sourceRoot":"","sources":["../../src/types/typescript-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,mBAAmB,CAAA;AAO7C,QAAA,MAAgB,QAAQ,gGAAY,UAAU;;;;;GAAW,SAAS,iGAAU,QAAQ,qKAAU,QAAQ,8FAAM,CAAA;AAC5G,eAAO,MAAM,GAAG,EAAE,OAAO,QAA2B,CAAA;AACpD,eAAO,MAAM,GAAG,EAAE,OAAO,QAA2B,CAAA;AACpD,eAAO,MAAM,GAAG,EAAE,OAAO,QAA2B,CAAA;AACpD,eAAO,MAAM,GAAG,EAAE,OAAO,UAA+B,CAAA;AACxD,eAAO,MAAM,IAAI,EAAE,OAAO,SAA6B,CAAA;AAEvD,eAAO,MAAM,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAS,CAAA;AACrD,eAAO,MAAM,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,CAAS,CAAA;AACrD,eAAO,MAAM,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,OAAO,CAAU,CAAA;AAExD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;AAC/C,MAAM,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AACrE,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;AAC9E,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;AAExF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GAAG,CAAC,GAAG,KAAK,CAAA;AAE5D;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,CAAA;AAU9C,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,SAAS,OAAO,EAAE,IAAI,CAAC,SAAS,SAAS,CAAC,GAAG,OAAO,EAAE,EAAE,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,CAAA;AAEtH,wBAAgB,aAAa,SAS5B;AAED,uEAAuE;AACvE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,CAAA;AAEpD,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAA;AACrD,wBAAgB,aAAa,CAAC,CAAC,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAG5E;AACD,MAAM,MAAM,SAAS,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;AACxD,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,KAAK,CAAA;AAC7F,MAAM,MAAM,eAAe,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI;IACxC,KAAI,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;CACtB,GAAG,CAAC,CAAA"}

package/dist/types.d.ts

@@ -1,2 +1,2 @@
-export * from './types/typescript-utils';
+export * from './types/typescript-utils.ts';
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAA"}

package/dist/{types.min.js → types.js}

@@ -1,4 +1,4 @@
-import "./chunk-5MMGBK2U.min.js";
+import "./chunk-E46VTKTZ.js";
 import {
   BOOL,
   Bool,
@@ -10,8 +10,7 @@ import {
   Str,
   arrayIfSingle,
   checkParityTB
-} from "./chunk-HYMC7W6S.min.js";
-import "./chunk-PHITDXZT.min.js";
+} from "./chunk-ZAADLBSB.js";
 export {
   BOOL,
   Bool,
@@ -24,4 +23,4 @@ export {
   arrayIfSingle,
   checkParityTB
 };
-//# sourceMappingURL=types.min.js.map
+//# sourceMappingURL=types.js.map

package/dist/utils/debug-name.d.ts

@@ -0,0 +1,13 @@
+import type { Applog, DatalogQueryPattern } from '../applog/datom-types.ts';
+import type { Thread } from '../thread/basic.ts';
+export declare const createDebugName: ({ caller, thread, pattern, args }: {
+    caller?: string;
+    thread?: Thread | Applog[];
+    pattern?: DatalogQueryPattern | DatalogQueryPattern[] | string;
+    args?: any;
+}) => string;
+export declare const createDebugNameObj: (args: Parameters<typeof createDebugName>[0]) => {
+    readonly name: string;
+};
+export declare function prettifyThreadName(input: string): string;
+//# sourceMappingURL=debug-name.d.ts.map

package/dist/utils/debug-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug-name.d.ts","sourceRoot":"","sources":["../../src/utils/debug-name.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAC3E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,eAAO,MAAM,eAAe,GAAI,mCAAmC;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,OAAO,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,GAAG,MAAM,CAAA;IAC9D,IAAI,CAAC,EAAE,GAAG,CAAA;CACV,WAMA,CAAA;AAED,eAAO,MAAM,kBAAkB,GAAI,MAAM,UAAU,CAAC,OAAO,eAAe,CAAC,CAAC,CAAC,CAAC;;CAE7E,CAAA;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAgCxD"}

package/dist/utils.d.ts

@@ -1,4 +1,4 @@
-import { Applog, ApplogEncNoCid } from './applog/datom-types';
+import { Applog, ApplogEncNoCid } from './applog/datom-types.ts';
 export declare const isTruthy: (l: Applog | ApplogEncNoCid) => boolean;
 export declare const keepTruthy: (arr: readonly any[]) => any[];
 //# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE7D,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,GAAG,cAAc,KAAG,OAAc,CAAA;AACpE,eAAO,MAAM,UAAU,GAAI,KAAK,SAAS,GAAG,EAAE,KAAG,GAAG,EAA0B,CAAA"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAEhE,eAAO,MAAM,QAAQ,GAAI,GAAG,MAAM,GAAG,cAAc,KAAG,OAAc,CAAA;AACpE,eAAO,MAAM,UAAU,GAAI,KAAK,SAAS,GAAG,EAAE,KAAG,GAAG,EAA0B,CAAA"}

package/dist/utils.js

@@ -0,0 +1,9 @@
+import {
+  isTruthy,
+  keepTruthy
+} from "./chunk-YDAKBU6Q.js";
+export {
+  isTruthy,
+  keepTruthy
+};
+//# sourceMappingURL=utils.js.map

package/package.json

@@ -1,70 +1,78 @@
 {
   "name": "@wovin/core",
-  "version": "0.1.36",
+  "version": "0.2.0",
   "type": "module",
-  "main": "./dist/index.min.js",
-  "module": "./dist/index.min.js",
-  "browser": "./dist/index.min.js",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "browser": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "import": "./dist/index.min.js",
+      "source": "./src/index.ts",
+      "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
     "./applog": {
-      "import": "./dist/applog.min.js",
+      "source": "./src/applog.ts",
+      "import": "./dist/applog.js",
       "types": "./dist/applog.d.ts"
     },
     "./blockstore": {
-      "import": "./dist/blockstore.min.js",
+      "source": "./src/blockstore.ts",
+      "import": "./dist/blockstore.js",
       "types": "./dist/blockstore.d.ts"
     },
     "./ipfs": {
-      "import": "./dist/ipfs.min.js",
+      "source": "./src/ipfs.ts",
+      "import": "./dist/ipfs.js",
       "types": "./dist/ipfs.d.ts"
     },
     "./pubsub": {
-      "import": "./dist/pubsub.min.js",
+      "source": "./src/pubsub.ts",
+      "import": "./dist/pubsub.js",
       "types": "./dist/pubsub.d.ts"
     },
     "./query": {
-      "import": "./dist/query.min.js",
+      "source": "./src/query.ts",
+      "import": "./dist/query.js",
       "types": "./dist/query.d.ts"
     },
     "./retrieve": {
-      "import": "./dist/retrieve.min.js",
+      "source": "./src/retrieve.ts",
+      "import": "./dist/retrieve.js",
       "types": "./dist/retrieve.d.ts"
     },
     "./thread": {
-      "import": "./dist/thread.min.js",
+      "source": "./src/thread.ts",
+      "import": "./dist/thread.js",
       "types": "./dist/thread.d.ts"
     },
     "./types": {
-      "import": "./dist/types.min.js",
+      "source": "./src/types.ts",
+      "import": "./dist/types.js",
       "types": "./dist/types.d.ts"
     },
     "./utils": {
-      "import": "./dist/utils.min.js",
+      "source": "./src/utils.ts",
+      "import": "./dist/utils.js",
       "types": "./dist/utils.d.ts"
     },
-    "./mobx": {
-      "import": "./dist/mobx.min.js",
-      "types": "./dist/mobx.d.ts"
-    },
     "./ipns": {
-      "import": "./dist/ipns.min.js",
+      "source": "./src/ipns.ts",
+      "import": "./dist/ipns.js",
       "types": "./dist/ipns.d.ts"
     }
   },
   "files": [
-    "./dist/"
+    "./dist/",
+    "./src/"
   ],
   "packageManager": "pnpm",
   "esm.sh": {
     "bundle": false
   },
   "peerDependencies": {
-    "@sinclair/typebox": "^0.31.28"
+    "@sinclair/typebox": ">=0.31.28 <1"
   },
   "dependencies": {
     "@ipld/car": "^5.4.2",
@@ -78,8 +86,6 @@
     "iso-signatures": "^0.5.1",
     "iso-ucan": "^0.4.2",
     "lodash-es": "^4.17.21",
-    "mobx": "^6.13.7",
-    "mobx-utils": "^6.1.1",
     "@libp2p/crypto": "^5.0.0",
     "ipns": "^10.1.2",
     "multiformats": "^13.4.1",
@@ -93,6 +99,7 @@
     "tsup": "^8.5.0",
     "typescript": "^5.9.2",
     "vite": "^7.1.7",
+    "vitest": "^3.1.3",
     "tsupconfig": "^0.0.0"
   },
   "repository": {
@@ -109,6 +116,8 @@
     "dev:code": "tsup --watch",
     "dev:types": "tsc --emitDeclarationOnly --declaration --watch",
     "lint": "eslint .",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
     "pub": "npm publish --tag latest --access=public"
   }

package/src/applog/applog-helpers.ts

@@ -0,0 +1,155 @@
+import { Logger } from 'besonders-logger'
+import { encodeApplogAndGetCid } from '../ipfs/ipfs-utils.ts'
+import { lastWriteWins } from '../query/basic.ts'
+import { MappedThread, rollingFilter, Thread, ThreadOnlyCurrent, type ThreadDerivation } from '../thread.ts'
+import { PartialBy } from '../types/typescript-utils.ts'
+import { dateNowIso, objEqualByKeys, removeDuplicateAppLogs, sortApplogsByTs } from './applog-utils.ts'
+import {
+	Applog,
+	ApplogForInsert,
+	ApplogForInsertOptionalAgent,
+	ApplogNoCid,
+	AgentHash,
+	CidString,
+	getApplogTypeErrors,
+	isValidApplog,
+	Timestamp,
+} from './datom-types.ts'
+
+const { WARN, LOG, DEBUG, VERBOSE, ERROR } = Logger.setup(Logger.INFO) // eslint-disable-line no-unused-vars
+
+export function ensureTsPvAndFinalizeApplogs(appLogsToInsert: ApplogForInsert[], threadForPv: Thread) {
+	DEBUG(`[ensureTsPvAndFinalizeApplogs] ENTER - ${appLogsToInsert.length} applogs, thread size=${threadForPv.size}`)
+	const ts = dateNowIso()
+	// const currentThread = lastWriteWins(threadForPv, { tolerateAlreadyFiltered: true }) // HACK to get `pv` from last write
+	const currentThread = threadForPv // HACK to not do un-cached lastWriteWins
+
+	// Within-batch (en, at) duplicates produce same-ts logs whose `pv` all point to the
+	// pre-batch tail (not to each other) — chain order is then ambiguous and the second
+	// insert is at the mercy of cid lex tie-break. Caller bug; warn so it's findable.
+	const seenInBatch = new Set<string>()
+	for (const log of appLogsToInsert) {
+		const key = log.en + '|' + log.at
+		if (seenInBatch.has(key)) {
+			WARN(
+				`[ensureTsPvAndFinalizeApplogs] within-batch duplicate (en, at)=(${log.en}, ${log.at}) — chain-pv won't link these; consider separate insert calls`,
+				{ log },
+			)
+			break // one warning per batch is plenty
+		}
+		seenInBatch.add(key)
+	}
+
+	DEBUG(`[ensureTsPvAndFinalizeApplogs] About to map over applogs`)
+	const mapped = appLogsToInsert.map((log, idx) => {
+		DEBUG(`[ensureTsPvAndFinalizeApplogs] Processing applog ${idx + 1}/${appLogsToInsert.length}`)
+		const result = finalizeApplogForInsert(log, { ts, threadForPv: currentThread })
+		DEBUG(`[ensureTsPvAndFinalizeApplogs] Finalized applog ${idx + 1}/${appLogsToInsert.length}`)
+		return result
+	})
+	DEBUG(`[ensureTsPvAndFinalizeApplogs] EXIT - mapped ${mapped.length} applogs`)
+	return mapped
+}
+export function ensureTsPvAndFinalizeApplog(applogToInsert: ApplogForInsert, threadForPv: Thread) {
+	return ensureTsPvAndFinalizeApplogs([applogToInsert], threadForPv)[0]
+}
+
+export function finalizeApplogForInsert(
+	log: ApplogForInsert,
+	{ ts, threadForPv }: { ts?: string; threadForPv?: Thread /*OnlyCurrent*/ } = {},
+) {
+	DEBUG(`[finalizeApplogForInsert] ENTER - en=${log.en}, at=${log.at}`)
+	DEBUG(`[finalizeApplogForInsert] About to call withTs`)
+	const logWithTs = withTs(log, ts ?? dateNowIso())
+	DEBUG(`[finalizeApplogForInsert] About to call withPvFrom (thread size=${threadForPv?.size ?? 'null'})`)
+	const logWithPv = withPvFrom(logWithTs, threadForPv)
+	DEBUG(`[finalizeApplogForInsert] About to call encodeApplogAndGetCid`)
+	const cid = encodeApplogAndGetCid(logWithPv).toString() as CidString
+	DEBUG(`[finalizeApplogForInsert] CID created: ${cid}`)
+	if ((log as Applog).cid && (log as Applog).cid !== cid) WARN(`[finalizeApplogForInsert] overwriting wrong CID`, { log, cid, logWithPv })
+	const logWithCid = { ...logWithPv, cid } satisfies Applog
+	DEBUG(`[finalizeApplogForInsert] About to validate applog`)
+	if (!isValidApplog(logWithCid)) {
+		throw ERROR(`Bogus Applog ${JSON.stringify(logWithCid)}`, getApplogTypeErrors(logWithCid))
+	}
+	DEBUG(`[finalizeApplogForInsert] EXIT - CID=${cid}`)
+	return Object.freeze(logWithCid)
+}
+
+export function hasAg(log: ApplogForInsertOptionalAgent): log is ApplogForInsert {
+	return !!log.ag
+}
+export function hasTs(log: ApplogForInsert): log is Omit<ApplogForInsert, 'ts'> & { ts: Timestamp } {
+	return !!log.ts
+}
+export function hasPv(log: ApplogForInsert): log is ApplogForInsert & { pv: string } {
+	return !!log.pv
+}
+
+export function withTs(log: ApplogForInsert, ts: Timestamp) {
+	return hasTs(log) ? log : { ...log, ts }
+}
+export function withAg(log: ApplogForInsertOptionalAgent, ag: AgentHash) {
+	return hasAg(log) ? log : { ...log, ag }
+}
+export function withPvFrom(log: PartialBy<ApplogNoCid, 'pv'>, thread: Thread /*OnlyCurrent*/ | null) {
+	DEBUG(`[withPvFrom] ENTER - en=${log.en}, at=${log.at}, hasPv=${log.pv !== undefined}`)
+	if (log.pv !== undefined) {
+		DEBUG(`[withPvFrom] EXIT early - pv already set`)
+		return log as ApplogNoCid // TODO: ? devMode WARN if it's different for catching bugs)
+	}
+	if (!thread) {
+		if (!hasPv(log)) throw ERROR(`[withPvFrom] no thread and no pv:`, log)
+		DEBUG(`[withPvFrom] EXIT - no thread, returning log with existing pv`)
+		return log // satisfies Pick<Applog, 'pv'>
+	} else {
+		const { en, at } = log
+		DEBUG(`[withPvFrom] About to call thread.findLast for en=${en}, at=${at}, thread.size=${thread.size}`)
+		const prevLog = thread.findLast(l => l.en == en && l.at == at) // HACK to not do lastWriteWins calc
+		DEBUG(`[withPvFrom] findLast completed, found=${!!prevLog}`)
+		// const prevLogs = rollingFilter(thread, { en, at }) // ? use some non-reactive filter here?
+		// if (prevLogs.size > 1) throw ERROR(`[withPvFrom] unexpected previous count:`, prevLogs.size, { log, prevLogs, thread }) // `thread` arg must be only current
+		// let prevLog = prevLogs.isEmpty ? null : prevLogs.applogs[0]
+		// const isMatchingPv = prevLog?.cid === log.pv
+		DEBUG(`[withPvFrom] About to check equality`)
+		if (objEqualByKeys(['en', 'at', 'vl', 'ts', 'ag'], log, prevLog)) {
+			throw ERROR(`[withPvFrom] Same as previous:`, { log, pv: prevLog, thread }) // bug catcher
+		}
+		// if (log.pv && !isMatchingPv) { // ineffective bc. shortcut in the beginning of this func
+		// 	WARN(`[withPvFrom] different than pre-set pv:`, { queriedPv: prevLog, logPv: log.pv })
+		// }
+		const prevLogCid = (log.pv !== undefined ? log.pv : prevLog?.cid) ?? null
+		DEBUG(`[withPvFrom] EXIT - prevLogCid=${prevLogCid}`)
+		return { ...log, pv: prevLogCid }
+	}
+}
+export function joinThreads(threads: ReadonlyArray<Thread>) {
+	const derivation: ThreadDerivation = {
+		compute(parents) {
+			if (parents.length < 2) DEBUG(`joinThreads with count=${parents.length}`) // ? EmptyThread
+			return sortApplogsByTs(
+				removeDuplicateAppLogs(parents.flatMap(s => {
+					const logs = s.applogs
+					if (!logs) {
+						ERROR(`falsy applogs of thread`, s)
+						throw new Error(`falsy applogs of thread`)
+					}
+					return logs
+				}), 'cleanup'),
+			)
+		},
+		mapDelta: (delta, { source, parents, state }) => ({
+			added: delta.added.filter(log => !state.includes(log)),
+			removed: delta.removed?.filter(log =>
+				state.includes(log) &&
+				!parents.some(p => p !== source && p.hasApplog(log, true))
+			),
+		}),
+	}
+	return new MappedThread(
+		`join(~ ${threads.map(s => s.name).join(', ')})`,
+		threads,
+		['?'], // HACK this basically says "we're not sure what filters are applied"
+		derivation,
+	)
+}