@wovin/core 0.0.17 → 0.0.19

package/dist/{chunk-FIOA3FZW.min.js → chunk-VDYG5VHX.min.js}

@@ -2,7 +2,7 @@ import {
   cyrb53hash,
   ensureTsPvAndFinalizeApplog,
   g
-} from "./chunk-NPCVLBCM.min.js";
+} from "./chunk-UZBCM3UI.min.js";
 
 // src/pubsub/pub-pull.ts
 var { WARN, LOG, DEBUG, VERBOSE, ERROR } = g.setup(g.INFO);
@@ -21,7 +21,7 @@ function integratePub({ targetThread, agentHash, subID, pubData }) {
 }
 
 // src/pubsub/pubsub-types.ts
-function isPublication(obj) {
+function isShare(obj) {
   return obj?.pk !== void 0 && obj?.lastPush !== void 0;
 }
 function isSubscription(obj) {
@@ -33,8 +33,8 @@ function agentToShortHash(agentString) {
 
 export {
   integratePub,
-  isPublication,
+  isShare,
   isSubscription,
   agentToShortHash
 };
-//# sourceMappingURL=chunk-FIOA3FZW.min.js.map
+//# sourceMappingURL=chunk-VDYG5VHX.min.js.map

package/dist/{chunk-FIOA3FZW.min.js.map → chunk-VDYG5VHX.min.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/pubsub/pub-pull.ts","../src/pubsub/pubsub-types.ts"],"sourcesContent":["import { Logger } from 'besonders-logger'\nimport { CID } from 'multiformats'\nimport { ensureTsPvAndFinalizeApplog } from '../applog/applog-helpers'\nimport { EntityID } from '../applog/datom-types'\nimport { Thread } from '../thread'\n\nconst { WARN, LOG, DEBUG, VERBOSE, ERROR } = Logger.setup(Logger.INFO) // eslint-disable-line no-unused-vars\n\nexport type PubPullData = {\n\tcid: CID\n\tthread: Thread\n}\n\nexport function integratePub({ targetThread, agentHash, subID, pubData }: {\n\ttargetThread: Thread\n\tagentHash: EntityID\n\tpubData: PubPullData\n\tsubID?: EntityID\n}) {\n\tconst newLogs = pubData.thread.applogs.filter(log => !targetThread.hasApplog(log, false))\n\tDEBUG(`[integratePub] integrating ${newLogs.length} logs`, { targetThread, subID, pubData })\n\tlet toInsert = newLogs\n\tif (subID) {\n\t\ttoInsert = toInsert.concat(ensureTsPvAndFinalizeApplog(\n\t\t\t{ en: subID, at: 'subscription/cid', vl: pubData.cid.toString(), ag: agentHash },\n\t\t\ttargetThread,\n\t\t))\n\t}\n\ttargetThread.insertRaw(toInsert)\n\treturn newLogs\n}\n","import { CID } from 'multiformats/cid'\nimport { cyrb53hash } from './../applog/applog-utils'\nimport { AgentHash, AgentID, CidString } from '../applog/datom-types'\nimport { Tagged } from '../types'\n\ntype AgentString = Tagged<string, 'AgentString'>\ntype DIDString = Tagged<string, 'DID'>\nexport type { AgentHash, AgentString, DIDString }\n\nexport interface AppAgent {\n\tag: AgentHash\n\tagentString: AgentString\n\tdid: DIDString\n\tsign(data: Uint8Array): Promise<Uint8Array>\n}\nexport interface AppAgentForWorker {\n\tag: AgentHash\n\tagentString: AgentString\n\tdid: DIDString\n\tsignerSecret?: Uint8Array\n\tsign?: (data: Uint8Array)=> Promise<Uint8Array>\n}\nexport interface PubBlockRoot {\n\tapplogs: CID\n\tapplogsSignature: Uint8Array\n\tinfo: CID\n\tinfoSignature: Uint8Array\n\tprev?: CID\n}\nexport interface PubBlockLogs {\n\tlogs: CID[]\n}\nexport interface PubBlockChunks {\n\tchunks: CID[]\n}\nexport type PubBlockLogsOrChunks = PubBlockLogs | PubBlockChunks\n\n// HACK: this is actually note3 types, not wovin\nexport interface IPublication {\n\tid?: string // string hash of pub (used as unique id in IDB) `W3Name.create().toString()` starts with k51qzi5uqu5d\n\tcreatedAt: string // ISO timestamp of creation\n\tname: string // nick name for the pub\n\tisDeleted?: boolean\n\tpurgeBeforePush?: boolean\n\n\tpk: Uint8Array // exported privatekey - needed to create WritableName for publishing //TODO: store as non-extractable / encrypted?\n\n\tautopush: boolean\n\tlastPush: string | null\n\tlastCID?: string\n\tlatestLogTs?: string\n\tpubCounter?: number\n\n\tpublishedBy: string // local user appAgent\n\tselectors?: string[] // to be used as a filter for which applogs to pub\n\tencryptedFor?: string | null // short agentHash\n\tencryptedWith?: CryptoKey | null // AES-GCM derived key from ECDH keys (local private and remote public)\n\n\t// HACK WIP #39 - shared encryption\n\tsharedKey?: CryptoKey | null // AES-GCM derived key from ECDH keys (local private and ipns public)\n\tsharedAgents?: AgentID[] | null // array of string EntityIDs for the chosen agents (we need public jwkd atoms for each of them)\n\tsharedKeyMap?: Map<AgentID, string> | null // uses public key from each agent to derive an aes key that is used to encrypt and btoa the sharedKey that is actually used to encrypt and decrypt the applogs\n}\nexport interface ISubscription {\n\tid: string // string hash of pub (used as unique id in IDB) `W3Name.create().toString()` starts with k51qzi5uqu5d\n\tcreatedAt: string // ISO timestamp of creation\n\tname: string // nick name for the pub\n\tisDeleted: boolean\n\n\tlastPull?: string | null\n\tlastPullAttempt?: string | null\n\tautopull: boolean\n\tlastCID?: string // ? why not CidString\n\tlastApplogCID?: string\n\tpublishedBy?: string // remote publisher short agentHash\n\tencryptedFor?: string | undefined // short agentHash\n\tencryptedWith?: CryptoKey | undefined // AES-GCM derived key from ECDH keys (local private and remote public)\n}\nexport function isPublication(obj: any): obj is IPublication {\n\treturn obj?.pk !== undefined && obj?.lastPush !== undefined\n}\nexport function isSubscription(obj: any): obj is ISubscription {\n\treturn obj?.lastPull !== undefined\n}\n\nexport type TSubPub = IPublication | ISubscription\n\nexport function agentToShortHash(agentString: string) {\n\treturn cyrb53hash(agentString, 31, 7) as string\n}\n"],"mappings":";;;;;;;AAMA,IAAM,EAAE,MAAM,KAAK,OAAO,SAAS,MAAM,IAAI,EAAO,MAAM,EAAO,IAAI;AAO9D,SAAS,aAAa,EAAE,cAAc,WAAW,OAAO,QAAQ,GAKpE;AACF,QAAM,UAAU,QAAQ,OAAO,QAAQ,OAAO,SAAO,CAAC,aAAa,UAAU,KAAK,KAAK,CAAC;AACxF,QAAM,8BAA8B,QAAQ,MAAM,SAAS,EAAE,cAAc,OAAO,QAAQ,CAAC;AAC3F,MAAI,WAAW;AACf,MAAI,OAAO;AACV,eAAW,SAAS,OAAO;AAAA,MAC1B,EAAE,IAAI,OAAO,IAAI,oBAAoB,IAAI,QAAQ,IAAI,SAAS,GAAG,IAAI,UAAU;AAAA,MAC/E;AAAA,IACD,CAAC;AAAA,EACF;AACA,eAAa,UAAU,QAAQ;AAC/B,SAAO;AACR;;;ACgDO,SAAS,cAAc,KAA+B;AAC5D,SAAO,KAAK,OAAO,UAAa,KAAK,aAAa;AACnD;AACO,SAAS,eAAe,KAAgC;AAC9D,SAAO,KAAK,aAAa;AAC1B;AAIO,SAAS,iBAAiB,aAAqB;AACrD,SAAO,WAAW,aAAa,IAAI,CAAC;AACrC;","names":[]}
+{"version":3,"sources":["../src/pubsub/pub-pull.ts","../src/pubsub/pubsub-types.ts"],"sourcesContent":["import { Logger } from 'besonders-logger'\nimport { CID } from 'multiformats'\nimport { ensureTsPvAndFinalizeApplog } from '../applog/applog-helpers'\nimport { EntityID } from '../applog/datom-types'\nimport { Thread } from '../thread'\n\nconst { WARN, LOG, DEBUG, VERBOSE, ERROR } = Logger.setup(Logger.INFO) // eslint-disable-line no-unused-vars\n\nexport type PubPullData = {\n\tcid: CID\n\tthread: Thread\n}\n\nexport function integratePub({ targetThread, agentHash, subID, pubData }: {\n\ttargetThread: Thread\n\tagentHash: EntityID\n\tpubData: PubPullData\n\tsubID?: EntityID\n}) {\n\tconst newLogs = pubData.thread.applogs.filter(log => !targetThread.hasApplog(log, false))\n\tDEBUG(`[integratePub] integrating ${newLogs.length} logs`, { targetThread, subID, pubData })\n\tlet toInsert = newLogs\n\tif (subID) {\n\t\ttoInsert = toInsert.concat(ensureTsPvAndFinalizeApplog(\n\t\t\t{ en: subID, at: 'subscription/cid', vl: pubData.cid.toString(), ag: agentHash },\n\t\t\ttargetThread,\n\t\t))\n\t}\n\ttargetThread.insertRaw(toInsert)\n\treturn newLogs\n}\n","import { CID } from 'multiformats/cid'\nimport { cyrb53hash } from './../applog/applog-utils'\nimport { AgentHash, AgentID, CidString } from '../applog/datom-types'\nimport { Tagged } from '../types'\n\ntype AgentString = Tagged<string, 'AgentString'>\ntype DIDString = Tagged<string, 'DID'>\nexport type { AgentHash, AgentString, DIDString }\n\nexport interface AppAgent {\n\tag: AgentHash\n\tagentString: AgentString\n\tdid: DIDString\n\tsign(data: Uint8Array): Promise<Uint8Array>\n}\nexport interface AppAgentForWorker {\n\tag: AgentHash\n\tagentString: AgentString\n\tdid: DIDString\n\tsignerSecret?: Uint8Array\n\tsign?: (data: Uint8Array)=> Promise<Uint8Array>\n}\nexport interface SnapRootBlock {\n\tapplogs: CID\n\tapplogsSignature: Uint8Array\n\tinfo: CID\n\tinfoSignature: Uint8Array\n\tprev?: CID\n}\nexport interface SnapBlockLogs {\n\tlogs: CID[]\n}\nexport interface SnapBlockChunks {\n\tchunks: CID[]\n}\nexport type SnapBlockLogsOrChunks = SnapBlockLogs | SnapBlockChunks\n\n// HACK: this is actually note3 types, not wovin\nexport interface IShare {\n\tid?: string // string hash of pub (used as unique id in IDB) `W3Name.create().toString()` starts with k51qzi5uqu5d\n\tcreatedAt: string // ISO timestamp of creation\n\tname: string // nick name for the pub\n\tisDeleted?: boolean\n\tpurgeBeforePush?: boolean\n\n\tpk: Uint8Array // exported privatekey - needed to create WritableName for publishing //TODO: store as non-extractable / encrypted?\n\n\tautopush: boolean\n\tlastPush: string | null\n\tlastCID?: string\n\tlatestLogTs?: string\n\tpubCounter?: number\n\n\tpublishedBy: string // local user appAgent\n\tselectors?: string[] // to be used as a filter for which applogs to pub\n\tencryptedFor?: string | null // short agentHash\n\tencryptedWith?: CryptoKey | null // AES-GCM derived key from ECDH keys (local private and remote public)\n\n\t// HACK WIP #39 - shared encryption\n\tsharedKey?: CryptoKey | null // AES-GCM derived key from ECDH keys (local private and ipns public)\n\tsharedAgents?: AgentID[] | null // array of string EntityIDs for the chosen agents (we need public jwkd atoms for each of them)\n\tsharedKeyMap?: Map<AgentID, string> | null // uses public key from each agent to derive an aes key that is used to encrypt and btoa the sharedKey that is actually used to encrypt and decrypt the applogs\n}\nexport interface ISubscription {\n\tid: string // string hash of pub (used as unique id in IDB) `W3Name.create().toString()` starts with k51qzi5uqu5d\n\tcreatedAt: string // ISO timestamp of creation\n\tname: string // nick name for the pub\n\tisDeleted: boolean\n\n\tlastPull?: string | null\n\tlastPullAttempt?: string | null\n\tautopull: boolean\n\tlastCID?: string // ? why not CidString\n\tlastApplogCID?: string\n\tpublishedBy?: string // remote publisher short agentHash\n\tencryptedFor?: string | undefined // short agentHash\n\tencryptedWith?: CryptoKey | undefined // AES-GCM derived key from ECDH keys (local private and remote public)\n}\nexport function isShare(obj: any): obj is IShare {\n\treturn obj?.pk !== undefined && obj?.lastPush !== undefined\n}\nexport function isSubscription(obj: any): obj is ISubscription {\n\treturn obj?.lastPull !== undefined\n}\n\nexport type TShareSub = IShare | ISubscription\n\nexport function agentToShortHash(agentString: string) {\n\treturn cyrb53hash(agentString, 31, 7) as string\n}\n"],"mappings":";;;;;;;AAMA,IAAM,EAAE,MAAM,KAAK,OAAO,SAAS,MAAM,IAAI,EAAO,MAAM,EAAO,IAAI;AAO9D,SAAS,aAAa,EAAE,cAAc,WAAW,OAAO,QAAQ,GAKpE;AACF,QAAM,UAAU,QAAQ,OAAO,QAAQ,OAAO,SAAO,CAAC,aAAa,UAAU,KAAK,KAAK,CAAC;AACxF,QAAM,8BAA8B,QAAQ,MAAM,SAAS,EAAE,cAAc,OAAO,QAAQ,CAAC;AAC3F,MAAI,WAAW;AACf,MAAI,OAAO;AACV,eAAW,SAAS,OAAO;AAAA,MAC1B,EAAE,IAAI,OAAO,IAAI,oBAAoB,IAAI,QAAQ,IAAI,SAAS,GAAG,IAAI,UAAU;AAAA,MAC/E;AAAA,IACD,CAAC;AAAA,EACF;AACA,eAAa,UAAU,QAAQ;AAC/B,SAAO;AACR;;;ACgDO,SAAS,QAAQ,KAAyB;AAChD,SAAO,KAAK,OAAO,UAAa,KAAK,aAAa;AACnD;AACO,SAAS,eAAe,KAAgC;AAC9D,SAAO,KAAK,aAAa;AAC1B;AAIO,SAAS,iBAAiB,aAAqB;AACrD,SAAO,WAAW,aAAa,IAAI,CAAC;AACrC;","names":[]}

package/dist/index.min.js

@@ -1,33 +1,35 @@
 import "./chunk-7IDQIMQO.min.js";
-import "./chunk-RPPZKO5L.min.js";
+import {
+  fetchSnapshotChainUntil
+} from "./chunk-IHGAJTEQ.min.js";
 import {
   agentToShortHash,
   integratePub,
-  isPublication,
+  isShare,
   isSubscription
-} from "./chunk-FIOA3FZW.min.js";
+} from "./chunk-VDYG5VHX.min.js";
 import {
   carFromBlob,
   chunkApplogs,
   decodePubFromBlocks,
   decodePubFromCar,
-  encodeApplogsAsCar,
-  encodePubAsCar,
+  encodeSnapshotApplogsAsCar,
+  encodeSnapshotAsCar,
   getBlocksOfCar,
   getDecodedBlock,
-  isPubBlockChunks,
+  isSnapBlockChunks,
   makeCarBlob,
   makeCarOut,
-  preparePubForPush,
+  prepareSnapshotForPush,
   streamReaderToIterable,
   unchunkApplogsBlock
-} from "./chunk-JEOQUHTK.min.js";
+} from "./chunk-SIIQEX77.min.js";
 import "./chunk-QPGEBDMJ.min.js";
 import {
   includedIn,
   includes,
   queryDivergencesByPrev
-} from "./chunk-TEQ4SIKN.min.js";
+} from "./chunk-E4BAQ5JJ.min.js";
 import {
   QueryNode,
   QueryResult,
@@ -54,7 +56,7 @@ import {
   throwOnTimeout,
   withTimeout,
   withoutDeleted
-} from "./chunk-OBMVNVJR.min.js";
+} from "./chunk-KVPEUWWR.min.js";
 import {
   AppLogNoCidTB,
   AppLogNoCidTBC,
@@ -152,7 +154,7 @@ import {
   variableNameWithoutQuestionmark,
   withPvFrom,
   withTs
-} from "./chunk-NPCVLBCM.min.js";
+} from "./chunk-UZBCM3UI.min.js";
 import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-5MMGBK2U.min.js";
 import {
@@ -227,10 +229,10 @@ export {
   decodePubFromCar,
   encodeApplog,
   encodeApplogAndGetCid,
-  encodeApplogsAsCar,
   encodeBlock,
   encodeBlockOriginal,
-  encodePubAsCar,
+  encodeSnapshotApplogsAsCar,
+  encodeSnapshotAsCar,
   ensureTsPvAndFinalizeApplog,
   ensureTsPvAndFinalizeApplogs,
   ensureValidCIDinstance,
@@ -238,6 +240,7 @@ export {
   entityOverlap,
   entityOverlapCount,
   entityOverlapMap,
+  fetchSnapshotChainUntil,
   filterAndMap,
   finalizeApplogForInsert,
   getAgents,
@@ -261,8 +264,8 @@ export {
   isEncryptedApplog,
   isInitEvent,
   isIpnsKeyCid,
-  isPubBlockChunks,
-  isPublication,
+  isShare,
+  isSnapBlockChunks,
   isStaticPattern,
   isSubscription,
   isTsBefore,
@@ -288,7 +291,7 @@ export {
   prefixAt,
   prefixAttrs,
   prepareForPub,
-  preparePubForPush,
+  prepareSnapshotForPush,
   prettifyThreadName,
   query,
   queryAndMap,

package/dist/ipfs/car.d.ts

@@ -27,7 +27,8 @@ export declare function decodePubFromCar(car: CarReader): Promise<{
     applogsCID: CID<unknown, number, number, import("multiformats").Version>;
     applogs: ApplogArrayMaybeEncrypted;
 }>;
-export declare function decodePubFromBlocks({ rootCID, blockStore }: DecodedCar, recursionTrace?: CID[]): Promise<{
+export declare function decodePubFromBlocks({ rootCID, blockStore }: DecodedCar, _recursionTrace?: CID[], // DEPRECATED: kept for API compat, unused in iterative version
+stopAtCID?: CID): Promise<{
     cid: CID<unknown, number, number, import("multiformats").Version>;
     info: {
         logs: {

package/dist/ipfs/car.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"car.d.ts","sourceRoot":"","sources":["../../src/ipfs/car.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAGhD,OAAO,EAAa,GAAG,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAU,yBAAyB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAOpF,MAAM,MAAM,SAAS,GAAG,GAAG,CAAA;AAC3B,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEzD,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,GAAG,CAAA;IAEZ,UAAU,EAAE,aAAa,CAAA;CACzB;AAED,0CAA0C;AAC1C,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,SAAS;;;;;;;;;;;;;;;GAGpD;AAED,wBAAsB,mBAAmB,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,cAAc,GAAE,GAAG,EAAO;;;;;;;;;;;;;;;GA6DxG;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS;;;;;GAmBlD;AACD,wBAAsB,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,oBAYxE;AAGD,wBAAsB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,uDASvE,CAAC,iEAAiE;AAWnE,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,iBAQxE;AACD,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAEvE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAWrH"}
+{"version":3,"file":"car.d.ts","sourceRoot":"","sources":["../../src/ipfs/car.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAGhD,OAAO,EAAa,GAAG,EAAE,MAAM,cAAc,CAAA;AAE7C,OAAO,EAAU,yBAAyB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAOpF,MAAM,MAAM,SAAS,GAAG,GAAG,CAAA;AAC3B,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAEzD,MAAM,WAAW,aAAa;IAC7B,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW,CAAC,UAAU,CAAC,CAAA;CACtC;AAED,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,GAAG,CAAA;IAEZ,UAAU,EAAE,aAAa,CAAA;CACzB;AAED,0CAA0C;AAC1C,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,SAAS;;;;;;;;;;;;;;;GAGpD;AAED,wBAAsB,mBAAmB,CACxC,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,UAAU,EACnC,eAAe,GAAE,GAAG,EAAO,EAAG,+DAA+D;AAC7F,SAAS,CAAC,EAAE,GAAG;;;;;;;;;;;;;;;GAgHf;AAED,wBAAsB,cAAc,CAAC,GAAG,EAAE,SAAS;;;;;GAmBlD;AACD,wBAAsB,eAAe,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG,EAAE,GAAG,oBAYxE;AAGD,wBAAsB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,uDASvE,CAAC,iEAAiE;AAWnE,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,iBAQxE;AACD,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,CAEvE;AAED,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,2BAA2B,CAAC,UAAU,CAAC,GAAG,aAAa,CAAC,UAAU,CAAC,CAWrH"}

package/dist/ipfs/fetch-snapshot-chain.d.ts

@@ -0,0 +1,27 @@
+import { CarReader } from '@ipld/car';
+import { CID } from 'multiformats/cid';
+export interface BlockStoreForFetch {
+    get(cid: CID): Promise<Uint8Array | undefined>;
+    put(cid: CID, bytes: Uint8Array): Promise<void>;
+}
+export interface FetchChainOptions {
+    rootCID: CID;
+    stopAtCID?: CID;
+    fetchBlock: (cid: CID) => Promise<CarReader>;
+    fetchAll: (cid: CID) => Promise<CarReader>;
+    maxDepth?: number;
+}
+export interface FetchChainResult {
+    rootCID: CID;
+    blockStore: BlockStoreForFetch;
+    /** Serializable blocks array for worker boundary crossing */
+    blocks: [string, Uint8Array][];
+    snapshotCount: number;
+}
+/**
+ * Fetches a snapshot chain iteratively, stopping at stopAtCID.
+ * Uses 3 requests per snapshot: root(block), applogs(all), info(all).
+ * This avoids the gateway's dag-scope=all following prev links recursively.
+ */
+export declare function fetchSnapshotChainUntil(options: FetchChainOptions): Promise<FetchChainResult>;
+//# sourceMappingURL=fetch-snapshot-chain.d.ts.map

package/dist/ipfs/fetch-snapshot-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-snapshot-chain.d.ts","sourceRoot":"","sources":["../../src/ipfs/fetch-snapshot-chain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AAGrC,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAMtC,MAAM,WAAW,kBAAkB;IAC/B,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAAA;IAC9C,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,iBAAiB;IAC9B,OAAO,EAAE,GAAG,CAAA;IACZ,SAAS,CAAC,EAAE,GAAG,CAAA;IACf,UAAU,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IAC5C,QAAQ,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,SAAS,CAAC,CAAA;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,GAAG,CAAA;IACZ,UAAU,EAAE,kBAAkB,CAAA;IAC9B,6DAA6D;IAC7D,MAAM,EAAE,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAA;IAC9B,aAAa,EAAE,MAAM,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkDnG"}

package/dist/ipfs.d.ts

@@ -1,3 +1,4 @@
 export * from './ipfs/car';
 export * from './ipfs/ipfs-utils';
+export * from './ipfs/fetch-snapshot-chain';
 //# sourceMappingURL=ipfs.d.ts.map

package/dist/ipfs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ipfs.d.ts","sourceRoot":"","sources":["../src/ipfs.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"ipfs.d.ts","sourceRoot":"","sources":["../src/ipfs.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,6BAA6B,CAAA"}

package/dist/ipfs.min.js

@@ -1,4 +1,6 @@
-import "./chunk-RPPZKO5L.min.js";
+import {
+  fetchSnapshotChainUntil
+} from "./chunk-IHGAJTEQ.min.js";
 import {
   carFromBlob,
   decodePubFromBlocks,
@@ -8,9 +10,9 @@ import {
   makeCarBlob,
   makeCarOut,
   streamReaderToIterable
-} from "./chunk-JEOQUHTK.min.js";
+} from "./chunk-SIIQEX77.min.js";
 import "./chunk-QPGEBDMJ.min.js";
-import "./chunk-OBMVNVJR.min.js";
+import "./chunk-KVPEUWWR.min.js";
 import {
   MULTICODEC_IPNS_KEY,
   areCidsEqual,
@@ -26,7 +28,7 @@ import {
   prepareForPub,
   toIpnsString,
   tryParseCID
-} from "./chunk-NPCVLBCM.min.js";
+} from "./chunk-UZBCM3UI.min.js";
 import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-HYMC7W6S.min.js";
 import "./chunk-PHITDXZT.min.js";
@@ -43,6 +45,7 @@ export {
   encodeBlock,
   encodeBlockOriginal,
   ensureValidCIDinstance,
+  fetchSnapshotChainUntil,
   getBlocksOfCar,
   getCidSync,
   getDecodedBlock,

package/dist/pubsub/pubsub-types.d.ts

@@ -17,21 +17,21 @@ export interface AppAgentForWorker {
     signerSecret?: Uint8Array;
     sign?: (data: Uint8Array) => Promise<Uint8Array>;
 }
-export interface PubBlockRoot {
+export interface SnapRootBlock {
     applogs: CID;
     applogsSignature: Uint8Array;
     info: CID;
     infoSignature: Uint8Array;
     prev?: CID;
 }
-export interface PubBlockLogs {
+export interface SnapBlockLogs {
     logs: CID[];
 }
-export interface PubBlockChunks {
+export interface SnapBlockChunks {
     chunks: CID[];
 }
-export type PubBlockLogsOrChunks = PubBlockLogs | PubBlockChunks;
-export interface IPublication {
+export type SnapBlockLogsOrChunks = SnapBlockLogs | SnapBlockChunks;
+export interface IShare {
     id?: string;
     createdAt: string;
     name: string;
@@ -65,8 +65,8 @@ export interface ISubscription {
     encryptedFor?: string | undefined;
     encryptedWith?: CryptoKey | undefined;
 }
-export declare function isPublication(obj: any): obj is IPublication;
+export declare function isShare(obj: any): obj is IShare;
 export declare function isSubscription(obj: any): obj is ISubscription;
-export type TSubPub = IPublication | ISubscription;
+export type TShareSub = IShare | ISubscription;
 export declare function agentToShortHash(agentString: string): string;
 //# sourceMappingURL=pubsub-types.d.ts.map

package/dist/pubsub/pubsub-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pubsub-types.d.ts","sourceRoot":"","sources":["../../src/pubsub/pubsub-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pubsub-types.d.ts","sourceRoot":"","sources":["../../src/pubsub/pubsub-types.ts"],"names":[],"mappings":"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"}

package/dist/pubsub/{pub-push.d.ts → snap-push.d.ts}

@@ -2,8 +2,8 @@ import { CID } from 'multiformats/cid';
 import type { Applog, ApplogArrayMaybeEncryptedRO, ApplogArrayNoCIDMaybeEncryptedRO } from '../applog/datom-types';
 import { BlockStoreish } from '../ipfs/car';
 import { ApplogsOrThread, Thread } from '../thread';
-import type { AppAgent, IPublication, PubBlockChunks, PubBlockLogsOrChunks } from './pubsub-types';
-export declare function preparePubForPush(agent: AppAgent, appThread: Thread, threadToPublish: ApplogsOrThread, publication: IPublication, prevPubCID: CID | null): Promise<{
+import type { AppAgent, IShare, SnapBlockChunks, SnapBlockLogsOrChunks } from './pubsub-types';
+export declare function prepareSnapshotForPush(agent: AppAgent, appThread: Thread, threadToPublish: ApplogsOrThread, share: IShare, prevSnapCID: CID | null): Promise<{
     cid: CID<any, 297, 18, 1>;
     blob: Blob;
     blocks: import("multiformats").BlockView<any, 297, 18, 1>[];
@@ -14,7 +14,7 @@ export declare function preparePubForPush(agent: AppAgent, appThread: Thread, th
  * @param applogs Encrypted or plain applogs
  * @returns Car file
  */
-export declare function encodePubAsCar(agent: AppAgent, applogs: ApplogArrayNoCIDMaybeEncryptedRO, infoLogs: readonly Applog[], prevPubCID: CID | null): Promise<{
+export declare function encodeSnapshotAsCar(agent: AppAgent, applogs: ApplogArrayNoCIDMaybeEncryptedRO, infoLogs: readonly Applog[], prevSnapCID: CID | null): Promise<{
     cid: CID<any, 297, 18, 1>;
     blob: Blob;
     blocks: import("multiformats").BlockView<any, 297, 18, 1>[];
@@ -31,11 +31,11 @@ export declare function chunkApplogs(applogCids: CID<unknown, 297, 18, 1>[], siz
     blocks: any[];
     chunks: any[];
 }>;
-export declare function unchunkApplogsBlock(block: PubBlockLogsOrChunks, blockStore: BlockStoreish): Promise<CID[]>;
-export declare function isPubBlockChunks(block: PubBlockLogsOrChunks): block is PubBlockChunks;
+export declare function unchunkApplogsBlock(block: SnapBlockLogsOrChunks, blockStore: BlockStoreish): Promise<CID[]>;
+export declare function isSnapBlockChunks(block: SnapBlockLogsOrChunks): block is SnapBlockChunks;
 /**
  * @param applogs Encrypted or plain applogs
  * @returns Car file
  */
-export declare function encodeApplogsAsCar(applogs: ApplogArrayMaybeEncryptedRO): Promise<Blob>;
-//# sourceMappingURL=pub-push.d.ts.map
+export declare function encodeSnapshotApplogsAsCar(applogs: ApplogArrayMaybeEncryptedRO): Promise<Blob>;
+//# sourceMappingURL=snap-push.d.ts.map

package/dist/pubsub/snap-push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snap-push.d.ts","sourceRoot":"","sources":["../../src/pubsub/snap-push.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAA;AAGtC,OAAO,KAAK,EACX,MAAM,EAEN,2BAA2B,EAC3B,gCAAgC,EAIhC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAA4C,MAAM,aAAa,CAAA;AAGrF,OAAO,EAAE,eAAe,EAAqB,MAAM,EAAE,MAAM,WAAW,CAAA;AAGtE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAiB,qBAAqB,EAAE,MAAM,gBAAgB,CAAA;AAe7G,wBAAsB,sBAAsB,CAC3C,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,MAAM,EACjB,eAAe,EAAE,eAAe,EAChC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,GAAG,GAAG,IAAI;;;;;;GA+HvB;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACxC,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,gCAAgC,EACzC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAC3B,WAAW,EAAE,GAAG,GAAG,IAAI;;;;;;GAgCvB;AAED,uEAAuE;AACvE,wBAAsB,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,SAAQ;;;;;;;;GAatF;AACD,wBAAsB,mBAAmB,CAAC,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAYjH;AACD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,GAAG,KAAK,IAAI,eAAe,CAExF;AACD;;;GAGG;AACH,wBAAsB,0BAA0B,CAC/C,OAAO,EAAE,2BAA2B,iBAUpC"}

package/dist/pubsub.d.ts

@@ -1,5 +1,5 @@
 export * from './pubsub/connector';
 export * from './pubsub/pub-pull';
-export * from './pubsub/pub-push';
+export * from './pubsub/snap-push';
 export * from './pubsub/pubsub-types';
 //# sourceMappingURL=pubsub.d.ts.map

package/dist/pubsub.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../src/pubsub.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,uBAAuB,CAAA"}
+{"version":3,"file":"pubsub.d.ts","sourceRoot":"","sources":["../src/pubsub.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,mBAAmB,CAAA;AACjC,cAAc,oBAAoB,CAAA;AAClC,cAAc,uBAAuB,CAAA"}

package/dist/pubsub.min.js

@@ -1,33 +1,33 @@
 import {
   agentToShortHash,
   integratePub,
-  isPublication,
+  isShare,
   isSubscription
-} from "./chunk-FIOA3FZW.min.js";
+} from "./chunk-VDYG5VHX.min.js";
 import {
   chunkApplogs,
-  encodeApplogsAsCar,
-  encodePubAsCar,
-  isPubBlockChunks,
-  preparePubForPush,
+  encodeSnapshotApplogsAsCar,
+  encodeSnapshotAsCar,
+  isSnapBlockChunks,
+  prepareSnapshotForPush,
   unchunkApplogsBlock
-} from "./chunk-JEOQUHTK.min.js";
+} from "./chunk-SIIQEX77.min.js";
 import "./chunk-QPGEBDMJ.min.js";
-import "./chunk-OBMVNVJR.min.js";
-import "./chunk-NPCVLBCM.min.js";
+import "./chunk-KVPEUWWR.min.js";
+import "./chunk-UZBCM3UI.min.js";
 import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-HYMC7W6S.min.js";
 import "./chunk-PHITDXZT.min.js";
 export {
   agentToShortHash,
   chunkApplogs,
-  encodeApplogsAsCar,
-  encodePubAsCar,
+  encodeSnapshotApplogsAsCar,
+  encodeSnapshotAsCar,
   integratePub,
-  isPubBlockChunks,
-  isPublication,
+  isShare,
+  isSnapBlockChunks,
   isSubscription,
-  preparePubForPush,
+  prepareSnapshotForPush,
   unchunkApplogsBlock
 };
 //# sourceMappingURL=pubsub.min.js.map

package/dist/query/situations.d.ts

@@ -1,2 +1,79 @@
+import { Applog, query } from '@wovin/core';
+/**
+ * Situations are meant to flag and possibly autocorrect or autosuggest solutions
+ *
+ * Types of Situations:
+ * Divergences = leaf nodes that are based on different previous versions/contexts
+ * Conflicts/Disagreement = different agents setting the same attribute (based on same previous)
+ * Overwrite = one agent's action implicitly overrides another's without explicit confirmation
+ * Conscious Disagreement = agents explicitly acknowledge and accept conflicting changes
+ * Suggestions = recommendations for improvements or alternatives
+ */
+interface Situation {
+    name: string;
+    desc: string;
+    intensity: number;
+    type: typeof SituationTypes[keyof typeof SituationTypes];
+    query: typeof query;
+    resolutionOptions: Resolution[];
+    metadata?: {
+        agentId?: string;
+        timestamp?: number;
+        context?: Record<string, any>;
+    };
+}
+interface QueryResultWithSituations {
+    result: any;
+    situations: Situation[];
+    threadView?: ThreadView;
+}
+interface ThreadView {
+    id: string;
+    situations: SituatedMessage[];
+    resolutionState: ResolutionState;
+}
+interface SituatedMessage {
+    id: string;
+    situation: Situation;
+    message: string;
+    resolutions: ResolutionAction[];
+    timestamp: number;
+    agentId?: string;
+}
+interface ResolutionState {
+    pending: string[];
+    resolved: string[];
+    ignored: string[];
+}
+interface ResolutionAction {
+    name: string;
+    applied: boolean;
+    appliedAt?: number;
+    appliedBy?: string;
+}
+declare const SituationTypes: {
+    readonly divergence: "divergence";
+    readonly disagreement: "disagreement";
+    readonly overwrite: "overwrite";
+    readonly consciousDisagreement: "consciousDisagreement";
+    readonly suggestion: "suggestion";
+};
+interface Resolution {
+    name: string;
+    desc: string;
+    assertion: () => Applog[];
+}
+/**
+ * Creates a thread view for situations detected in query results
+ */
+export declare function createThreadForSituations(result: any, situations: Situation[], options?: {
+    threadId?: string;
+    groupByType?: boolean;
+    sortByIntensity?: boolean;
+}): QueryResultWithSituations;
+/**
+ * Applies a resolution action to a situation in a thread
+ */
+export declare function applyResolution(threadView: ThreadView, messageId: string, resolutionName: string, appliedBy: string): ThreadView;
 export {};
 //# sourceMappingURL=situations.d.ts.map

package/dist/query/situations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"situations.d.ts","sourceRoot":"","sources":["../../src/query/situations.ts"],"names":[],"mappings":""}
+{"version":3,"file":"situations.d.ts","sourceRoot":"","sources":["../../src/query/situations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAa,MAAM,aAAa,CAAA;AAKtD;;;;;;;;;GASG;AACH,UAAU,SAAS;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,OAAO,cAAc,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;IACxD,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,iBAAiB,EAAE,UAAU,EAAE,CAAA;IAC/B,QAAQ,CAAC,EAAE;QACV,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAC7B,CAAA;CACD;AAED,UAAU,yBAAyB;IAClC,MAAM,EAAE,GAAG,CAAA;IACX,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,UAAU,CAAC,EAAE,UAAU,CAAA;CACvB;AAED,UAAU,UAAU;IACnB,EAAE,EAAE,MAAM,CAAA;IACV,UAAU,EAAE,eAAe,EAAE,CAAA;IAC7B,eAAe,EAAE,eAAe,CAAA;CAChC;AAED,UAAU,eAAe;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,SAAS,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,gBAAgB,EAAE,CAAA;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,UAAU,eAAe;IACxB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE,MAAM,EAAE,CAAA;CACjB;AAED,UAAU,gBAAgB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,QAAA,MAAM,cAAc;;;;;;CAMV,CAAA;AACV,UAAU,UAAU;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,EAAE,MAAM,MAAM,EAAE,CAAA;CACzB;AA2ED;;GAEG;AACH,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,GAAG,EACX,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,GAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,OAAO,CAAA;CACpB,GACJ,yBAAyB,CAqC3B;AAkBD;;GAEG;AACH,wBAAgB,eAAe,CAC9B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,GACf,UAAU,CAmCZ"}

package/dist/query.min.js

@@ -2,7 +2,7 @@ import {
   includedIn,
   includes,
   queryDivergencesByPrev
-} from "./chunk-TEQ4SIKN.min.js";
+} from "./chunk-E4BAQ5JJ.min.js";
 import {
   QueryNode,
   QueryResult,
@@ -29,7 +29,7 @@ import {
   throwOnTimeout,
   withTimeout,
   withoutDeleted
-} from "./chunk-OBMVNVJR.min.js";
+} from "./chunk-KVPEUWWR.min.js";
 import {
   applogThreadComparer,
   autorunButAlsoImmediately,
@@ -45,7 +45,7 @@ import {
   prettifyThreadName,
   queryNodesComparer,
   rootsQueries
-} from "./chunk-NPCVLBCM.min.js";
+} from "./chunk-UZBCM3UI.min.js";
 import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-HYMC7W6S.min.js";
 import "./chunk-PHITDXZT.min.js";

package/dist/thread.min.js

@@ -21,7 +21,7 @@ import {
   rollingFilter,
   rollingMapper,
   simpleApplogMapper
-} from "./chunk-NPCVLBCM.min.js";
+} from "./chunk-UZBCM3UI.min.js";
 import "./chunk-KEHU7HGZ.min.js";
 import "./chunk-HYMC7W6S.min.js";
 import "./chunk-PHITDXZT.min.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wovin/core",
-  "version": "0.0.17",
+  "version": "0.0.19",
   "type": "module",
   "main": "./dist/index.min.js",
   "module": "./dist/index.min.js",