@wovin/core 0.1.13 → 0.1.15

package/dist/applog.min.js

@@ -46,9 +46,9 @@ import {
   variableNameWithoutQuestionmark,
   withPvFrom,
   withTs
-} from "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
+} from "./chunk-3Y5KUHV5.min.js";
 import "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   AppLogNoCidTB,

package/dist/chunk-3EVHRFPN.min.js

@@ -0,0 +1,112 @@
+import {
+  unchunkApplogsBlock
+} from "./chunk-GH2FXZ3U.min.js";
+import {
+  CID,
+  areCidsEqual,
+  decode,
+  g,
+  removeDuplicateAppLogs
+} from "./chunk-3Y5KUHV5.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-3EVHRFPN.min.js.map

package/dist/chunk-3EVHRFPN.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/{chunk-CMYPWG2N.min.js → chunk-3Y5KUHV5.min.js}

@@ -1,3 +1,7 @@
+import {
+  arrayIfSingle,
+  require_typebox
+} from "./chunk-HYMC7W6S.min.js";
 import {
   Reaction,
   action,
@@ -21,10 +25,6 @@ import {
   trace,
   untracked
 } from "./chunk-KEHU7HGZ.min.js";
-import {
-  arrayIfSingle,
-  require_typebox
-} from "./chunk-HYMC7W6S.min.js";
 import {
   __commonJS,
   __export,
@@ -11253,4 +11253,4 @@ lodash-es/lodash.js:
 @noble/hashes/utils.js:
   (*! noble-hashes - MIT License (c) 2022 Paul Miller (paulmillr.com) *)
 */
-//# sourceMappingURL=chunk-CMYPWG2N.min.js.map
+//# sourceMappingURL=chunk-3Y5KUHV5.min.js.map

package/dist/{chunk-5LVRXH2F.min.js → chunk-6KONUEQB.min.js}

@@ -2,7 +2,7 @@ import {
   cyrb53hash,
   ensureTsPvAndFinalizeApplog,
   g
-} from "./chunk-CMYPWG2N.min.js";
+} from "./chunk-3Y5KUHV5.min.js";
 
 // src/pubsub/pub-pull.ts
 var { WARN, LOG, DEBUG, VERBOSE, ERROR } = g.setup(g.INFO);
@@ -37,4 +37,4 @@ export {
   isSubscription,
   agentToShortHash
 };
-//# sourceMappingURL=chunk-5LVRXH2F.min.js.map
+//# sourceMappingURL=chunk-6KONUEQB.min.js.map

package/dist/{chunk-MSRY6NTA.min.js → chunk-6XE4TT2P.min.js}

@@ -4,7 +4,7 @@ import {
   createDebugName,
   g,
   observableArrayMap
-} from "./chunk-CMYPWG2N.min.js";
+} from "./chunk-3Y5KUHV5.min.js";
 import {
   autorun,
   comparer,
@@ -62,4 +62,4 @@ export {
   includes,
   includedIn
 };
-//# sourceMappingURL=chunk-MSRY6NTA.min.js.map
+//# sourceMappingURL=chunk-6XE4TT2P.min.js.map

package/dist/{chunk-ULDVYEPF.min.js → chunk-GH2FXZ3U.min.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-QPGEBDMJ.min.js";
 import {
   lastWriteWins
-} from "./chunk-5T5HSBRE.min.js";
+} from "./chunk-SFDNH2ID.min.js";
 import {
   CID,
   areCidsEqual,
@@ -16,7 +16,7 @@ import {
   rollingFilter,
   src_exports,
   wrapper_default
-} from "./chunk-CMYPWG2N.min.js";
+} from "./chunk-3Y5KUHV5.min.js";
 import {
   __commonJS,
   __toESM
@@ -4119,4 +4119,4 @@ export {
   carFromBlob,
   streamReaderToIterable
 };
-//# sourceMappingURL=chunk-ULDVYEPF.min.js.map
+//# sourceMappingURL=chunk-GH2FXZ3U.min.js.map

package/dist/{chunk-5T5HSBRE.min.js → chunk-SFDNH2ID.min.js}

@@ -16,7 +16,7 @@ import {
   rollingMapper,
   sortApplogsByTs,
   wrapper_default
-} from "./chunk-CMYPWG2N.min.js";
+} from "./chunk-3Y5KUHV5.min.js";
 import {
   action,
   autorun,
@@ -507,4 +507,4 @@ export {
   withTimeout,
   throwOnTimeout
 };
-//# sourceMappingURL=chunk-5T5HSBRE.min.js.map
+//# sourceMappingURL=chunk-SFDNH2ID.min.js.map

package/dist/{chunk-L5ONTLHW.min.js → chunk-XR2SGDQV.min.js}

@@ -3,7 +3,7 @@ import {
   areCidsEqual,
   decode,
   g
-} from "./chunk-CMYPWG2N.min.js";
+} from "./chunk-3Y5KUHV5.min.js";
 
 // src/ipfs/fetch-snapshot-chain.ts
 var { WARN, LOG, DEBUG, VERBOSE, ERROR } = g.setup(g.INFO);
@@ -67,4 +67,4 @@ function createMemoryBlockStore() {
 export {
   fetchSnapshotChainUntil
 };
-//# sourceMappingURL=chunk-L5ONTLHW.min.js.map
+//# sourceMappingURL=chunk-XR2SGDQV.min.js.map

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-XR2SGDQV.min.js";
 import {
   agentToShortHash,
   integratePub,
   isShare,
   isSubscription
-} from "./chunk-5LVRXH2F.min.js";
+} from "./chunk-6KONUEQB.min.js";
+import {
+  includedIn,
+  includes,
+  queryDivergencesByPrev
+} from "./chunk-6XE4TT2P.min.js";
+import {
+  updateThreadFromSnapshot
+} from "./chunk-3EVHRFPN.min.js";
 import {
   carFromBlob,
   chunkApplogs,
@@ -23,13 +32,8 @@ import {
   prepareSnapshotForPush,
   streamReaderToIterable,
   unchunkApplogsBlock
-} from "./chunk-ULDVYEPF.min.js";
+} from "./chunk-GH2FXZ3U.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-SFDNH2ID.min.js";
 import {
   AppLogNoCidTB,
   AppLogNoCidTBC,
@@ -155,9 +159,7 @@ import {
   variableNameWithoutQuestionmark,
   withPvFrom,
   withTs
-} from "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
-import "./chunk-5MMGBK2U.min.js";
+} from "./chunk-3Y5KUHV5.min.js";
 import {
   BOOL,
   Bool,
@@ -170,6 +172,7 @@ import {
   arrayIfSingle,
   checkParityTB
 } from "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   AppLogNoCidTB,
@@ -321,6 +324,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-XR2SGDQV.min.js";
 import {
   carFromBlob,
   decodePubFromBlocks,
@@ -10,9 +10,9 @@ import {
   makeCarBlob,
   makeCarOut,
   streamReaderToIterable
-} from "./chunk-ULDVYEPF.min.js";
+} from "./chunk-GH2FXZ3U.min.js";
 import "./chunk-QPGEBDMJ.min.js";
-import "./chunk-5T5HSBRE.min.js";
+import "./chunk-SFDNH2ID.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-3Y5KUHV5.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-6KONUEQB.min.js";
 import {
   chunkApplogs,
   encodeSnapshotApplogsAsCar,
@@ -11,12 +11,12 @@ import {
   isSnapBlockChunks,
   prepareSnapshotForPush,
   unchunkApplogsBlock
-} from "./chunk-ULDVYEPF.min.js";
+} from "./chunk-GH2FXZ3U.min.js";
 import "./chunk-QPGEBDMJ.min.js";
-import "./chunk-5T5HSBRE.min.js";
-import "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
+import "./chunk-SFDNH2ID.min.js";
+import "./chunk-3Y5KUHV5.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-6XE4TT2P.min.js";
 import {
   QueryNode,
   QueryResult,
@@ -29,7 +29,7 @@ import {
   throwOnTimeout,
   withTimeout,
   withoutDeleted
-} from "./chunk-5T5HSBRE.min.js";
+} from "./chunk-SFDNH2ID.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-3Y5KUHV5.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-3EVHRFPN.min.js";
+import "./chunk-GH2FXZ3U.min.js";
+import "./chunk-QPGEBDMJ.min.js";
+import "./chunk-SFDNH2ID.min.js";
+import "./chunk-3Y5KUHV5.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.min.js

@@ -22,9 +22,9 @@ import {
   rollingFilter,
   rollingMapper,
   simpleApplogMapper
-} from "./chunk-CMYPWG2N.min.js";
-import "./chunk-KEHU7HGZ.min.js";
+} from "./chunk-3Y5KUHV5.min.js";
 import "./chunk-HYMC7W6S.min.js";
+import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   MappedThread,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wovin/core",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "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"