@wovin/core 0.1.13 → 0.1.16

package/dist/chunk-TPV3JAXV.min.js

@@ -0,0 +1,112 @@
+import {
+  unchunkApplogsBlock
+} from "./chunk-C22YMCSL.min.js";
+import {
+  CID,
+  areCidsEqual,
+  decode,
+  g,
+  removeDuplicateAppLogs
+} from "./chunk-MPOFY7NX.min.js";
+
+// src/retrieve/update-thread.ts
+var { WARN, LOG, DEBUG, VERBOSE, ERROR } = g.setup(g.INFO);
+function createMemoryBlockStore() {
+  const blocks = /* @__PURE__ */ new Map();
+  return {
+    get(cid) {
+      return blocks.get(cid.toV1().toString());
+    },
+    put(cid, bytes) {
+      blocks.set(cid.toV1().toString(), bytes);
+    }
+  };
+}
+async function getDecodedBlock(blockStore, cid) {
+  const bytes = blockStore.get(cid);
+  if (!bytes) return null;
+  return decode(bytes);
+}
+async function updateThreadFromSnapshot(thread, cid, retriever, options) {
+  const { excludeSnapshotCID, maxDepth = 100 } = options ?? {};
+  DEBUG("[updateThreadFromSnapshot] starting from", cid.toString(), {
+    excludeSnapshotCID: excludeSnapshotCID?.toString(),
+    maxDepth
+  });
+  const blockStore = createMemoryBlockStore();
+  const visited = /* @__PURE__ */ new Set();
+  let currentCID = cid;
+  let snapshotCount = 0;
+  const allApplogs = [];
+  while (currentCID && snapshotCount < maxDepth) {
+    const cidStr = currentCID.toString();
+    if (visited.has(cidStr)) {
+      throw ERROR("[updateThreadFromSnapshot] snapshot chain has a loop", {
+        currentCID: cidStr,
+        visited: [...visited]
+      });
+    }
+    visited.add(cidStr);
+    if (excludeSnapshotCID && areCidsEqual(currentCID, excludeSnapshotCID)) {
+      DEBUG("[updateThreadFromSnapshot] reached excludeSnapshotCID, stopping", excludeSnapshotCID.toString());
+      break;
+    }
+    DEBUG("[updateThreadFromSnapshot] fetching root block", cidStr);
+    const rootBytes = await retriever.getBlock(currentCID);
+    blockStore.put(currentCID, rootBytes);
+    const root = decode(rootBytes);
+    DEBUG("[updateThreadFromSnapshot] fetching applogs", root.applogs.toString());
+    for await (const { cid: blockCid, bytes } of retriever.getDag(root.applogs)) {
+      blockStore.put(blockCid, bytes);
+    }
+    DEBUG("[updateThreadFromSnapshot] fetching info", root.info.toString());
+    for await (const { cid: blockCid, bytes } of retriever.getDag(root.info)) {
+      blockStore.put(blockCid, bytes);
+    }
+    const applogsBlock = await getDecodedBlock(blockStore, root.applogs);
+    if (!applogsBlock) {
+      throw ERROR("[updateThreadFromSnapshot] applogs block not found", { cid: root.applogs.toString() });
+    }
+    const applogCIDs = await unchunkApplogsBlock(applogsBlock, {
+      get: async (cid2) => blockStore.get(cid2)
+    });
+    for (const applogCID of applogCIDs) {
+      const applog = await getDecodedBlock(blockStore, applogCID);
+      if (!applog) {
+        WARN("[updateThreadFromSnapshot] applog not found:", applogCID.toString());
+        continue;
+      }
+      if (applog.pv instanceof CID) {
+        applog.pv = applog.pv.toV1().toString();
+      }
+      allApplogs.push({
+        ...applog,
+        cid: applogCID.toV1().toString()
+      });
+    }
+    snapshotCount++;
+    currentCID = root.prev;
+  }
+  DEBUG("[updateThreadFromSnapshot] fetched", {
+    snapshotCount,
+    applogCount: allApplogs.length,
+    rootCID: cid.toString()
+  });
+  const deduplicated = removeDuplicateAppLogs(allApplogs, "cleanup");
+  const inserted = thread.insertMissing(deduplicated, false);
+  DEBUG("[updateThreadFromSnapshot] inserted", {
+    insertedCount: inserted.length,
+    duplicateCount: deduplicated.length - inserted.length
+  });
+  return {
+    cid,
+    applogs: deduplicated,
+    insertedCount: inserted.length,
+    snapshotCount
+  };
+}
+
+export {
+  updateThreadFromSnapshot
+};
+//# sourceMappingURL=chunk-TPV3JAXV.min.js.map

package/dist/chunk-TPV3JAXV.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/retrieve/update-thread.ts"],"sourcesContent":["import { CarReader } from '@ipld/car'\nimport * as dagJson from '@ipld/dag-json'\nimport { Logger } from 'besonders-logger'\nimport { CID } from 'multiformats/cid'\nimport type { Applog } from '../applog/datom-types'\nimport { removeDuplicateAppLogs } from '../applog/applog-utils'\nimport type { SnapRootBlock, SnapBlockLogsOrChunks } from '../pubsub/pubsub-types'\nimport { unchunkApplogsBlock } from '../pubsub/snap-push'\nimport { areCidsEqual } from '../ipfs/ipfs-utils'\nimport type { WriteableThread } from '../thread/writeable'\n\nconst { WARN, LOG, DEBUG, VERBOSE, ERROR } = Logger.setup(Logger.INFO) // eslint-disable-line no-unused-vars\n\n/**\n * Block retrieval abstraction - fetch or get blocks.\n * Implemented by gateway retriever or local blockstore.\n */\nexport interface BlockRetriever {\n\t/** Get single block by CID */\n\tgetBlock(cid: CID): Promise<Uint8Array>\n\t/** Get all blocks in DAG rooted at CID (for applogs/info sub-DAGs) */\n\tgetDag(cid: CID): AsyncIterable<{ cid: CID; bytes: Uint8Array }>\n}\n\n/**\n * Options for updateThreadFromSnapshot\n */\nexport interface UpdateOptions {\n\t/** CID of last included snapshot - exclude this and older snapshots */\n\texcludeSnapshotCID?: CID\n\t/** Maximum number of snapshots to traverse (default: 100) */\n\tmaxDepth?: number\n}\n\n/**\n * Result from updateThreadFromSnapshot\n */\nexport interface UpdateResult {\n\t/** Root CID that was fetched */\n\tcid: CID\n\t/** All applogs decoded from the chain */\n\tapplogs: Applog[]\n\t/** Count of applogs actually inserted (not duplicates) */\n\tinsertedCount: number\n\t/** Number of snapshots traversed */\n\tsnapshotCount: number\n}\n\n/**\n * Simple in-memory block store used during snapshot chain fetch.\n */\ninterface MemoryBlockStore {\n\tget(cid: CID): Uint8Array | undefined\n\tput(cid: CID, bytes: Uint8Array): void\n}\n\nfunction createMemoryBlockStore(): MemoryBlockStore {\n\tconst blocks = new Map<string, Uint8Array>()\n\treturn {\n\t\tget(cid: CID) {\n\t\t\treturn blocks.get(cid.toV1().toString())\n\t\t},\n\t\tput(cid: CID, bytes: Uint8Array) {\n\t\t\tblocks.set(cid.toV1().toString(), bytes)\n\t\t},\n\t}\n}\n\nasync function getDecodedBlock<T>(blockStore: MemoryBlockStore, cid: CID): Promise<T | null> {\n\tconst bytes = blockStore.get(cid)\n\tif (!bytes) return null\n\treturn dagJson.decode(bytes) as T\n}\n\n/**\n * Fetch snapshot chain from CID using a BlockRetriever, decode applogs, insert into thread.\n * Stops before excludeSnapshotCID if provided (incremental update).\n *\n * @param thread - WriteableThread to insert applogs into\n * @param cid - Root CID of the snapshot to start from\n * @param retriever - BlockRetriever for fetching blocks\n * @param options - Optional configuration\n * @returns UpdateResult with applogs and counts\n */\nexport async function updateThreadFromSnapshot(\n\tthread: WriteableThread,\n\tcid: CID,\n\tretriever: BlockRetriever,\n\toptions?: UpdateOptions\n): Promise<UpdateResult> {\n\tconst { excludeSnapshotCID, maxDepth = 100 } = options ?? {}\n\n\tDEBUG('[updateThreadFromSnapshot] starting from', cid.toString(), {\n\t\texcludeSnapshotCID: excludeSnapshotCID?.toString(),\n\t\tmaxDepth,\n\t})\n\n\tconst blockStore = createMemoryBlockStore()\n\tconst visited = new Set<string>()\n\tlet currentCID: CID | undefined = cid\n\tlet snapshotCount = 0\n\tconst allApplogs: Applog[] = []\n\n\twhile (currentCID && snapshotCount < maxDepth) {\n\t\tconst cidStr = currentCID.toString()\n\n\t\t// Loop detection\n\t\tif (visited.has(cidStr)) {\n\t\t\tthrow ERROR('[updateThreadFromSnapshot] snapshot chain has a loop', {\n\t\t\t\tcurrentCID: cidStr,\n\t\t\t\tvisited: [...visited],\n\t\t\t})\n\t\t}\n\t\tvisited.add(cidStr)\n\n\t\t// Check stop condition BEFORE fetching content\n\t\tif (excludeSnapshotCID && areCidsEqual(currentCID, excludeSnapshotCID)) {\n\t\t\tDEBUG('[updateThreadFromSnapshot] reached excludeSnapshotCID, stopping', excludeSnapshotCID.toString())\n\t\t\tbreak\n\t\t}\n\n\t\t// 1. Fetch root block\n\t\tDEBUG('[updateThreadFromSnapshot] fetching root block', cidStr)\n\t\tconst rootBytes = await retriever.getBlock(currentCID)\n\t\tblockStore.put(currentCID, rootBytes)\n\n\t\t// Parse root to get applogs, info, prev CIDs\n\t\tconst root = dagJson.decode(rootBytes) as SnapRootBlock\n\n\t\t// 2. Fetch applogs DAG\n\t\tDEBUG('[updateThreadFromSnapshot] fetching applogs', root.applogs.toString())\n\t\tfor await (const { cid: blockCid, bytes } of retriever.getDag(root.applogs)) {\n\t\t\tblockStore.put(blockCid, bytes)\n\t\t}\n\n\t\t// 3. Fetch info DAG\n\t\tDEBUG('[updateThreadFromSnapshot] fetching info', root.info.toString())\n\t\tfor await (const { cid: blockCid, bytes } of retriever.getDag(root.info)) {\n\t\t\tblockStore.put(blockCid, bytes)\n\t\t}\n\n\t\t// Decode applogs from this snapshot\n\t\tconst applogsBlock = await getDecodedBlock<SnapBlockLogsOrChunks>(blockStore, root.applogs)\n\t\tif (!applogsBlock) {\n\t\t\tthrow ERROR('[updateThreadFromSnapshot] applogs block not found', { cid: root.applogs.toString() })\n\t\t}\n\n\t\t// Use the unchunk helper which handles both chunked and non-chunked formats\n\t\tconst applogCIDs = await unchunkApplogsBlock(applogsBlock, {\n\t\t\tget: async (cid: CID) => blockStore.get(cid)!,\n\t\t})\n\n\t\t// Resolve each applog CID to actual applog data\n\t\tfor (const applogCID of applogCIDs) {\n\t\t\tconst applog = await getDecodedBlock<Applog>(blockStore, applogCID)\n\t\t\tif (!applog) {\n\t\t\t\tWARN('[updateThreadFromSnapshot] applog not found:', applogCID.toString())\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\t// Normalize pv field if it's a CID instance\n\t\t\tif ((applog.pv as any) instanceof CID) {\n\t\t\t\tapplog.pv = (applog.pv as any as CID).toV1().toString()\n\t\t\t}\n\t\t\tallApplogs.push({\n\t\t\t\t...applog,\n\t\t\t\tcid: applogCID.toV1().toString(),\n\t\t\t})\n\t\t}\n\n\t\tsnapshotCount++\n\t\tcurrentCID = root.prev // Move to previous snapshot\n\t}\n\n\tDEBUG('[updateThreadFromSnapshot] fetched', {\n\t\tsnapshotCount,\n\t\tapplogCount: allApplogs.length,\n\t\trootCID: cid.toString(),\n\t})\n\n\t// Deduplicate applogs (in case of overlapping snapshots)\n\tconst deduplicated = removeDuplicateAppLogs(allApplogs, 'cleanup')\n\n\t// Insert into thread\n\tconst inserted = thread.insertMissing(deduplicated, false)\n\n\tDEBUG('[updateThreadFromSnapshot] inserted', {\n\t\tinsertedCount: inserted.length,\n\t\tduplicateCount: deduplicated.length - inserted.length,\n\t})\n\n\treturn {\n\t\tcid,\n\t\tapplogs: deduplicated,\n\t\tinsertedCount: inserted.length,\n\t\tsnapshotCount,\n\t}\n}\n"],"mappings":"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","names":["cid"]}

package/dist/index.d.ts

@@ -2,6 +2,7 @@ export * from './applog';
 export * from './ipfs';
 export * from './pubsub';
 export * from './query';
+export * from './retrieve';
 export * from './thread';
 export * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,QAAQ,CAAA;AACtB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,YAAY,CAAA;AAC1B,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA"}

package/dist/index.min.js

@@ -1,13 +1,22 @@
+import "./chunk-5MMGBK2U.min.js";
 import "./chunk-7IDQIMQO.min.js";
 import {
   fetchSnapshotChainUntil
-} from "./chunk-L5ONTLHW.min.js";
+} from "./chunk-I73T6OVV.min.js";
 import {
   agentToShortHash,
   integratePub,
   isShare,
   isSubscription
-} from "./chunk-5LVRXH2F.min.js";
+} from "./chunk-DUAUQKBV.min.js";
+import {
+  includedIn,
+  includes,
+  queryDivergencesByPrev
+} from "./chunk-IFB3AKYA.min.js";
+import {
+  updateThreadFromSnapshot
+} from "./chunk-TPV3JAXV.min.js";
 import {
   carFromBlob,
   chunkApplogs,
@@ -23,13 +32,8 @@ import {
   prepareSnapshotForPush,
   streamReaderToIterable,
   unchunkApplogsBlock
-} from "./chunk-ULDVYEPF.min.js";
+} from "./chunk-C22YMCSL.min.js";
 import "./chunk-QPGEBDMJ.min.js";
-import {
-  includedIn,
-  includes,
-  queryDivergencesByPrev
-} from "./chunk-MSRY6NTA.min.js";
 import {
   QueryNode,
   QueryResult,
@@ -56,7 +60,7 @@ import {
   throwOnTimeout,
   withTimeout,
   withoutDeleted
-} from "./chunk-5T5HSBRE.min.js";
+} from "./chunk-AIITTHC6.min.js";
 import {
   AppLogNoCidTB,
   AppLogNoCidTBC,
@@ -80,6 +84,7 @@ import {
   areCidsEqual,
   arrStats,
   arraysContainSameElements,
+  asReadOnly,
   assertOnlyCurrent,
   assertRaw,
   autorunButAlsoImmediately,
@@ -155,9 +160,7 @@ import {
   variableNameWithoutQuestionmark,
   withPvFrom,
   withTs
-} from "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
-import "./chunk-5MMGBK2U.min.js";
+} from "./chunk-MPOFY7NX.min.js";
 import {
   BOOL,
   Bool,
@@ -170,6 +173,7 @@ import {
   arrayIfSingle,
   checkParityTB
 } from "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   AppLogNoCidTB,
@@ -207,6 +211,7 @@ export {
   arrStats,
   arrayIfSingle,
   arraysContainSameElements,
+  asReadOnly,
   assertOnlyCurrent,
   assertRaw,
   autorunButAlsoImmediately,
@@ -321,6 +326,7 @@ export {
   tsNearlySame,
   unchunkApplogsBlock,
   uniqueEnFromAppLogs,
+  updateThreadFromSnapshot,
   variableNameWithoutQuestionmark,
   withPvFrom,
   withTimeout,

package/dist/ipfs.min.js

@@ -1,6 +1,6 @@
 import {
   fetchSnapshotChainUntil
-} from "./chunk-L5ONTLHW.min.js";
+} from "./chunk-I73T6OVV.min.js";
 import {
   carFromBlob,
   decodePubFromBlocks,
@@ -10,9 +10,9 @@ import {
   makeCarBlob,
   makeCarOut,
   streamReaderToIterable
-} from "./chunk-ULDVYEPF.min.js";
+} from "./chunk-C22YMCSL.min.js";
 import "./chunk-QPGEBDMJ.min.js";
-import "./chunk-5T5HSBRE.min.js";
+import "./chunk-AIITTHC6.min.js";
 import {
   MULTICODEC_IPNS_KEY,
   areCidsEqual,
@@ -28,9 +28,9 @@ import {
   prepareForPub,
   toIpnsString,
   tryParseCID
-} from "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
+} from "./chunk-MPOFY7NX.min.js";
 import "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   MULTICODEC_IPNS_KEY,

package/dist/pubsub.min.js

@@ -3,7 +3,7 @@ import {
   integratePub,
   isShare,
   isSubscription
-} from "./chunk-5LVRXH2F.min.js";
+} from "./chunk-DUAUQKBV.min.js";
 import {
   chunkApplogs,
   encodeSnapshotApplogsAsCar,
@@ -11,12 +11,12 @@ import {
   isSnapBlockChunks,
   prepareSnapshotForPush,
   unchunkApplogsBlock
-} from "./chunk-ULDVYEPF.min.js";
+} from "./chunk-C22YMCSL.min.js";
 import "./chunk-QPGEBDMJ.min.js";
-import "./chunk-5T5HSBRE.min.js";
-import "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
+import "./chunk-AIITTHC6.min.js";
+import "./chunk-MPOFY7NX.min.js";
 import "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   agentToShortHash,

package/dist/query.min.js

@@ -2,7 +2,7 @@ import {
   includedIn,
   includes,
   queryDivergencesByPrev
-} from "./chunk-MSRY6NTA.min.js";
+} from "./chunk-IFB3AKYA.min.js";
 import {
   QueryNode,
   QueryResult,
@@ -29,7 +29,7 @@ import {
   throwOnTimeout,
   withTimeout,
   withoutDeleted
-} from "./chunk-5T5HSBRE.min.js";
+} from "./chunk-AIITTHC6.min.js";
 import {
   applogThreadComparer,
   autorunButAlsoImmediately,
@@ -45,9 +45,9 @@ import {
   prettifyThreadName,
   queryNodesComparer,
   rootsQueries
-} from "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
+} from "./chunk-MPOFY7NX.min.js";
 import "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   QueryNode,

package/dist/retrieve/index.d.ts

@@ -0,0 +1,2 @@
+export * from './update-thread';
+//# sourceMappingURL=index.d.ts.map

package/dist/retrieve/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/retrieve/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA"}

package/dist/retrieve/update-thread.d.ts

@@ -0,0 +1,50 @@
+import { CID } from 'multiformats/cid';
+import type { Applog } from '../applog/datom-types';
+import type { WriteableThread } from '../thread/writeable';
+/**
+ * Block retrieval abstraction - fetch or get blocks.
+ * Implemented by gateway retriever or local blockstore.
+ */
+export interface BlockRetriever {
+    /** Get single block by CID */
+    getBlock(cid: CID): Promise<Uint8Array>;
+    /** Get all blocks in DAG rooted at CID (for applogs/info sub-DAGs) */
+    getDag(cid: CID): AsyncIterable<{
+        cid: CID;
+        bytes: Uint8Array;
+    }>;
+}
+/**
+ * Options for updateThreadFromSnapshot
+ */
+export interface UpdateOptions {
+    /** CID of last included snapshot - exclude this and older snapshots */
+    excludeSnapshotCID?: CID;
+    /** Maximum number of snapshots to traverse (default: 100) */
+    maxDepth?: number;
+}
+/**
+ * Result from updateThreadFromSnapshot
+ */
+export interface UpdateResult {
+    /** Root CID that was fetched */
+    cid: CID;
+    /** All applogs decoded from the chain */
+    applogs: Applog[];
+    /** Count of applogs actually inserted (not duplicates) */
+    insertedCount: number;
+    /** Number of snapshots traversed */
+    snapshotCount: number;
+}
+/**
+ * Fetch snapshot chain from CID using a BlockRetriever, decode applogs, insert into thread.
+ * Stops before excludeSnapshotCID if provided (incremental update).
+ *
+ * @param thread - WriteableThread to insert applogs into
+ * @param cid - Root CID of the snapshot to start from
+ * @param retriever - BlockRetriever for fetching blocks
+ * @param options - Optional configuration
+ * @returns UpdateResult with applogs and counts
+ */
+export declare function updateThreadFromSnapshot(thread: WriteableThread, cid: CID, retriever: BlockRetriever, options?: UpdateOptions): Promise<UpdateResult>;
+//# sourceMappingURL=update-thread.d.ts.map

package/dist/retrieve/update-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-thread.d.ts","sourceRoot":"","sources":["../../src/retrieve/update-thread.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAKnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAI1D;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC9B,8BAA8B;IAC9B,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IACvC,sEAAsE;IACtE,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,aAAa,CAAC;QAAE,GAAG,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAC,CAAA;CAChE;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,uEAAuE;IACvE,kBAAkB,CAAC,EAAE,GAAG,CAAA;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,gCAAgC;IAChC,GAAG,EAAE,GAAG,CAAA;IACR,yCAAyC;IACzC,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,0DAA0D;IAC1D,aAAa,EAAE,MAAM,CAAA;IACrB,oCAAoC;IACpC,aAAa,EAAE,MAAM,CAAA;CACrB;AA4BD;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC7C,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,GAAG,EACR,SAAS,EAAE,cAAc,EACzB,OAAO,CAAC,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CA2GvB"}

package/dist/retrieve.d.ts

@@ -0,0 +1,2 @@
+export * from './retrieve/update-thread';
+//# sourceMappingURL=retrieve.d.ts.map

package/dist/retrieve.d.ts.map

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

package/dist/retrieve.min.js

@@ -0,0 +1,14 @@
+import {
+  updateThreadFromSnapshot
+} from "./chunk-TPV3JAXV.min.js";
+import "./chunk-C22YMCSL.min.js";
+import "./chunk-QPGEBDMJ.min.js";
+import "./chunk-AIITTHC6.min.js";
+import "./chunk-MPOFY7NX.min.js";
+import "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
+import "./chunk-PHITDXZT.min.js";
+export {
+  updateThreadFromSnapshot
+};
+//# sourceMappingURL=retrieve.min.js.map

package/dist/retrieve.min.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/thread/filters.d.ts

@@ -39,6 +39,8 @@ export type ThreadOnlyCurrentNoDeleted = ThreadWithFilter<'lastWriteWins' | 'wit
 export type ThreadWithoutFilters = Thread & {
     filters: [];
 };
+/** Re-export for convenience */
+export declare const asReadOnly: typeof MappedThread.asReadOnly;
 export type ApplogMapper = (log: Applog, sourceThread: Thread) => ApplogForInsert;
 export declare const simpleApplogMapper: (thread: Thread, logMapper: ApplogMapper, opts?: {
     name?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/thread/filters.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,gBAAgB,EAEhB,aAAa,EACb,aAAa,EAKb,MAAM,MAAM,CAAA;AAIb,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAkB,MAAM,uBAAuB,CAAA;AAE5H,OAAO,EAAe,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAI1D,eAAO,MAAM,aAAa,WACjB,MAAM,WACL,mBAAmB,SACtB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,iBAmEhD,CAAA;AAEF,eAAO,MAAM,aAAa,WACjB,MAAM,eACD,iBAAiB,SACxB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,iBAmBhD,CAAA;AAEF,eAAO,MAAM,UAAU,GAEF,GAAG,SAAS,gBAAgB,GAAG,aAAa,GAAG,aAAa,UACvE,MAAM,OACT,GAAG,eACK,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,SAC7C;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,QAYxB,CAAA;AAwBD,eAAO,MAAM,mBAAmB,GAC/B,SAAS,mBAAmB;;CAS5B,CAAA;AACD,wBAAgB,UAAU,CACzB,OAAO,EAAE,mBAAmB,IAED,MAAM,SAAS,MAAM,EAAE,cAclD;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACrC,QAAQ,MAAM,EACd,SAAS,mBAAmB,EAC5B,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,aAK5B,CAAA;AAKD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG;IACzD,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;CACrB,CAAA;AACD,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEpG;AACD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAItB,oBAAoB,CACrC;AACD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM;;;;EAM/C;AACD,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAA;AACjE,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;AAChE,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAA;AAC7F,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,EAAE,CAAA;CAAE,CAAA;AAM3D,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,eAAe,CAAA;AACjF,eAAO,MAAM,kBAAkB,GAC9B,QAAQ,MAAM,EACd,WAAW,YAAY,EACvB,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,iBAwDtD,CAAA"}
+{"version":3,"file":"filters.d.ts","sourceRoot":"","sources":["../../src/thread/filters.ts"],"names":[],"mappings":"AACA,OAAO,EAGN,gBAAgB,EAEhB,aAAa,EACb,aAAa,EAKb,MAAM,MAAM,CAAA;AAIb,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,WAAW,EAAE,SAAS,EAAE,mBAAmB,EAAkB,MAAM,uBAAuB,CAAA;AAE5H,OAAO,EAAe,MAAM,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC1D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAI1D,eAAO,MAAM,aAAa,WACjB,MAAM,WACL,mBAAmB,SACtB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,iBAmEhD,CAAA;AAEF,eAAO,MAAM,aAAa,WACjB,MAAM,eACD,iBAAiB,SACxB;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,iBAmBhD,CAAA;AAEF,eAAO,MAAM,UAAU,GAEF,GAAG,SAAS,gBAAgB,GAAG,aAAa,GAAG,aAAa,UACvE,MAAM,OACT,GAAG,eACK,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,SAC7C;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,QAYxB,CAAA;AAwBD,eAAO,MAAM,mBAAmB,GAC/B,SAAS,mBAAmB;;CAS5B,CAAA;AACD,wBAAgB,UAAU,CACzB,OAAO,EAAE,mBAAmB,IAED,MAAM,SAAS,MAAM,EAAE,cAclD;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB,GACrC,QAAQ,MAAM,EACd,SAAS,mBAAmB,EAC5B,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,aAK5B,CAAA;AAKD,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,MAAM,GAAG;IACzD,OAAO,EAAE,SAAS,CAAC,EAAE,CAAA;CACrB,CAAA;AACD,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,MAAM,IAAI,gBAAgB,CAAC,CAAC,CAAC,CAEpG;AACD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAItB,oBAAoB,CACrC;AACD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM;;;;EAM/C;AACD,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,eAAe,CAAC,CAAA;AACjE,MAAM,MAAM,eAAe,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;AAChE,MAAM,MAAM,0BAA0B,GAAG,gBAAgB,CAAC,eAAe,GAAG,gBAAgB,CAAC,CAAA;AAC7F,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,EAAE,CAAA;CAAE,CAAA;AAE3D,gCAAgC;AAChC,eAAO,MAAM,UAAU,gCAA0B,CAAA;AAMjD,MAAM,MAAM,YAAY,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,eAAe,CAAA;AACjF,eAAO,MAAM,kBAAkB,GAC9B,QAAQ,MAAM,EACd,WAAW,YAAY,EACvB,OAAM;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAO,iBAwDtD,CAAA"}

package/dist/thread/mapped.d.ts

@@ -7,9 +7,11 @@ export declare class MappedThread extends Thread {
     readonly _initialLogs: Applog[];
     private _eventMapper;
     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);
+    constructor(name: string, parents: Thread | readonly Thread[], filters: readonly string[], _initialLogs: Applog[], _eventMapper: ApplogEventMapper | null, _writeMapper?: ApplogWriteMapper, _readOnly?: boolean);
     insert(appLogsToInsert: ApplogForInsert[]): void;
     insertRaw(appLogsToInsert: Applog[]): void;
     private subscribeToParents;

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;IAetC,QAAQ,CAAC,IAAI,EAAE,MAAM;IAGrB,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE;IAC/B,OAAO,CAAC,YAAY;IACpB,OAAO,CAAC,YAAY;IAnBrB,MAAM,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB;IAWxE,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;IAsBxC,MAAM,CAAC,eAAe,EAAE,eAAe,EAAE;IAKzC,SAAS,CAAC,eAAe,EAAE,MAAM,EAAE;IAM1C,OAAO,CAAC,kBAAkB;IA0C1B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAQhD;;;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":"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;IA0C1B,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI;IAQhD;;;OAGG;IACH,YAAY;IAWZ,SAAS,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW;IAgC3D,IAAI,QAAQ,YAEX;CACD"}

package/dist/thread.min.js

@@ -5,6 +5,7 @@ import {
   ThreadInMemory,
   WriteableThread,
   allEntityIDs,
+  asReadOnly,
   assertOnlyCurrent,
   assertRaw,
   debounceWrites,
@@ -22,9 +23,9 @@ import {
   rollingFilter,
   rollingMapper,
   simpleApplogMapper
-} from "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
+} from "./chunk-MPOFY7NX.min.js";
 import "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   MappedThread,
@@ -33,6 +34,7 @@ export {
   ThreadInMemory,
   WriteableThread,
   allEntityIDs,
+  asReadOnly,
   assertOnlyCurrent,
   assertRaw,
   debounceWrites,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wovin/core",
-  "version": "0.1.13",
+  "version": "0.1.16",
   "type": "module",
   "main": "./dist/index.min.js",
   "module": "./dist/index.min.js",
@@ -27,6 +27,10 @@
       "import": "./dist/query.min.js",
       "types": "./dist/query.d.ts"
     },
+    "./retrieve": {
+      "import": "./dist/retrieve.min.js",
+      "types": "./dist/retrieve.d.ts"
+    },
     "./thread": {
       "import": "./dist/thread.min.js",
       "types": "./dist/thread.d.ts"