@interncom/diplomatic 0.7.1 → 0.8.1

package/dist/web/client.d.ts

@@ -2,9 +2,9 @@ import DiplomaticClientAPI from "./shared/client";
 import { IClock } from "./shared/clock";
 import { Status } from "./shared/consts";
 import { EncodedMessage } from "./shared/message";
-import { EntityID, HostHandle, ICrypto, IDeleteParams, IEntRev, IHostConnectionInfo, IInsertParams, IMessageHead, IStateManager, ITransport, IUpdateParams, MasterSeed } from "./shared/types";
+import { EntityID, Hash, HostHandle, ICrypto, IDeleteParams, IEntRev, IHostConnectionInfo, IInsertParams, IMessageHead, IStateManager, ITransport, IUpdateParams, MasterSeed } from "./shared/types";
 import { ValStat } from "./shared/valstat";
-import { IClient, IDiplomaticClientState, IDiplomaticClientXferState, IHostRow, IStateEmitter, IStore } from "./types";
+import { ApldState, IClient, IDiplomaticClientState, IDiplomaticClientXferState, IHostRow, IStateEmitter, IStore, IStoredMessage, ListMsgsOpts } from "./types";
 export declare class SyncClient<Handle extends HostHandle> implements IClient<Handle> {
     private clock;
     private state;
@@ -132,6 +132,43 @@ export declare class SyncClient<Handle extends HostHandle> implements IClient<Ha
      */
     sync(): Promise<Status>;
     private doSync;
+    /**
+     * Rebuild application state from the local message archive.
+     *
+     * By default, inventories each linked host from seq 0 (full header list),
+     * enqueues and pulls any bags missing from the archive, then clears EntDB
+     * (or other app state) and re-executes every archived msg. Use after a
+     * schema/applier change when derived ents diverge from the durable archive.
+     *
+     * Pass `{ checkHost: false }` to skip the host inventory (offline / local-only).
+     * Does not wipe the message archive, seed, or hosts.
+     */
+    rebuild(options?: {
+        checkHost?: boolean;
+    }): Promise<Status>;
+    /**
+     * Checksum of the local msg archive (set of head hashes).
+     * listKeys → raw bytes → sort → blake3(concat); empty → blake3(∅).
+     * Store key encoding is irrelevant; we always sort decoded (binary) hashes.
+     */
+    msgcheck(): Promise<Hash>;
+    /**
+     * List local archive rows (failed apply, pending drain, full dump).
+     * Bodies included by default; pass `body: false` for lighter listings.
+     */
+    listMsgs(opts?: ListMsgsOpts): Promise<IStoredMessage[]>;
+    /** Count archive rows; optional apld filter. Prefer over list+length. */
+    countMsgs(apld?: ApldState): Promise<number>;
+    /**
+     * Peek each host from seq 0 and pull any bags not already in the archive.
+     * Leaves open msgs as APLD_PENDING; does not exec (rebuild replays everything).
+     */
+    private repull;
+    /**
+     * Clear app state and re-exec every archived msg (HLC newest-first batches).
+     * Caller must hold applyChain.
+     */
+    private replay;
     wipe(): Promise<void>;
     import: (file: File, options?: {
         onProgress?: (index: number, total: number, status: Status) => void;

package/dist/web/entdb/cached.d.ts

@@ -1,5 +1,5 @@
 import { Status } from "../shared/consts";
-import { EntityID, IOp } from "../shared/types";
+import { EntityID, Hash, ICrypto, IOp } from "../shared/types";
 import { ValStat } from "../shared/valstat";
 import { EntitiesQuery, IEntDB, IEntity } from "./entdb";
 export type EntChangeListener = (types: Set<string>) => void;
@@ -59,4 +59,6 @@ export declare class CachedEntDB implements IEntDB {
     countEntities({ type }: {
         type: string;
     }): Promise<ValStat<number>>;
+    /** Durable authority — mem may be only partially warm. */
+    checksum(crypto: ICrypto): Promise<ValStat<Hash>>;
 }

package/dist/web/entdb/entdb.d.ts

@@ -1,6 +1,6 @@
 import { Status } from "../shared/consts";
 import { ValStat } from "../shared/valstat";
-import { EntityID, GroupID, IEntRev, IMessageHead, IMsgEntBody, IOp } from "../shared/types";
+import { EntityID, GroupID, Hash, ICrypto, IEntRev, IMessageHead, IMsgEntBody, IOp } from "../shared/types";
 export { entStateManager } from "./manager.ts";
 export interface IEntity<T = unknown> extends Omit<IMsgEntBody<T>, "body"> {
     eid: EntityID;
@@ -49,6 +49,11 @@ export interface IEntDB {
     countEntities({ type }: {
         type: string;
     }): Promise<ValStat<number>>;
+    /**
+     * Frontier checksum of live rows: eid + updatedAt + ctr per ent
+     * (see encodeEntRev / checksumEntRevs). Not a content hash of bodies.
+     */
+    checksum(crypto: ICrypto): Promise<ValStat<Hash>>;
 }
 /** Prior rev from a loaded entity (typical update/delete input). */
 export declare function revFromEntity(ent: IEntity): IEntRev;

package/dist/web/entdb/idb.d.ts

@@ -1,5 +1,5 @@
 import { Status } from "../shared/consts";
-import { EntityID, GroupID, IOp } from "../shared/types";
+import { EntityID, GroupID, Hash, ICrypto, IOp } from "../shared/types";
 import { ValStat } from "../shared/valstat.ts";
 import { EntitiesQuery, IEntDB, IEntity } from "./entdb";
 export declare const entityTableName = "entities";
@@ -40,6 +40,7 @@ export declare class EntIDB implements IEntDB {
     countEntities({ type }: {
         type: string;
     }): Promise<ValStat<number>>;
+    checksum(crypto: ICrypto): Promise<ValStat<Hash>>;
 }
 /** Durable IndexedDB EntDB. Internal-only. Apps use {@link openEntDB} instead. */
 export declare function openEntIDB(): Promise<EntIDB>;

package/dist/web/entdb/memory.d.ts

@@ -1,6 +1,6 @@
 import { IEntDB, IEntity } from "./entdb";
 import { Status } from "../shared/consts";
-import { EntityID, GroupID, IOp } from "../shared/types";
+import { EntityID, GroupID, Hash, ICrypto, IOp } from "../shared/types";
 import { ValStat } from "../shared/valstat.ts";
 interface IDateRange {
     start: Date;
@@ -53,5 +53,6 @@ export declare class EntDBMemory implements IEntDB {
     countEntities({ type }: {
         type: string;
     }): Promise<ValStat<number>>;
+    checksum(crypto: ICrypto): Promise<ValStat<Hash>>;
 }
 export {};

package/dist/web/index.d.ts

@@ -18,10 +18,11 @@ import { nullStateManager, StateManager } from "./state";
 import { IDBStore, openIDBStore } from "./stores/idb/store";
 import { MemoryStore } from "./stores/memory/store";
 import { SingletonStateManager } from "./shared/singleton";
-import type { ApldState, Applier, IClient, IDiplomaticClientState, IHostRow, IStore, IStoredMessage, IStoredMessageData, IStoredMessageWrite } from "./types";
+import type { ApldState, Applier, IClient, IDiplomaticClientState, IHostRow, IStore, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ListMsgsOpts } from "./types";
 import { APLD_APPLIED, APLD_ERROR, APLD_PENDING, apldFromStored, isApldState, isPendingApply, isTerminalApplyFailure, setApld } from "./types";
 import type { SyncProgressEvent } from "./progress";
 import { defaultPeekProgressEvery, idleProgress, shouldEmitItemProgress } from "./progress";
+import { checksumEntRevs, checksumSet, cmpBytes, encodeEntRev } from "./shared/checksum";
 import { openDiplomaticClient, type OpenDiplomaticClientMainOptions, type OpenDiplomaticClientOptions, type OpenDiplomaticClientWorkerOptions, type OpenedDiplomaticClient } from "./openClient";
 import { WorkerClient } from "./worker/client";
 import type { WorkerClientOptions } from "./worker/client";
@@ -29,5 +30,5 @@ export declare function genWebClient(stateMgr: IStateManager, url: URL): Promise
     client: SyncClient<URL>;
     setSeed: (seedHex: string) => Promise<void>;
 }>;
-export { APLD_APPLIED, APLD_ERROR, APLD_PENDING, apldFromStored, b64tob, btob64, btoh, CachedEntDB, Clock, crypto, Decoder, defaultPeekProgressEvery, eidCodec, Encoder, EntDBMemory, EntIDB, EntitiesQuery, EntityID, entStateManager, genSingletonEID, GroupID, hostHTTPTransport, htob, HTTPTransport, IDBStore, idleProgress, IEntDB, IEntity, isApldState, isPendingApply, isTerminalApplyFailure, IStore, MasterSeed, MemoryStore, normalizeTags, nullEntDB, nullStateManager, openDiplomaticClient, openEntDB, openIDBStore, revFromEntity, revFromHead, setApld, shouldEmitItemProgress, SingletonStateManager, StateManager, Status, SyncClient, TypedEventEmitter, useClient, useClientState, useClientXferState, useStateWatcher, useStateWatcherSuspense, useSyncOnResume, WorkerClient, };
-export type { ApldState, Applier, CachedEntDBOptions, EntDBMemoryOptions, HostHandle, IClient, ICrypto, IDeleteParams, IDiplomaticClientState, IEntRev, IHostConnectionInfo, IHostRow, IMessage, IMutateOp, IOp, IStateManager, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ITransport, IUpdateParams, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, OpenEntDBOptions, SyncProgressEvent, WorkerClientOptions, };
+export { APLD_APPLIED, APLD_ERROR, APLD_PENDING, apldFromStored, b64tob, btob64, btoh, CachedEntDB, checksumEntRevs, checksumSet, Clock, cmpBytes, crypto, Decoder, defaultPeekProgressEvery, eidCodec, encodeEntRev, Encoder, EntDBMemory, EntIDB, EntitiesQuery, EntityID, entStateManager, genSingletonEID, GroupID, hostHTTPTransport, htob, HTTPTransport, IDBStore, idleProgress, IEntDB, IEntity, isApldState, isPendingApply, isTerminalApplyFailure, IStore, MasterSeed, MemoryStore, normalizeTags, nullEntDB, nullStateManager, openDiplomaticClient, openEntDB, openIDBStore, revFromEntity, revFromHead, setApld, shouldEmitItemProgress, SingletonStateManager, StateManager, Status, SyncClient, TypedEventEmitter, useClient, useClientState, useClientXferState, useStateWatcher, useStateWatcherSuspense, useSyncOnResume, WorkerClient, };
+export type { ApldState, Applier, CachedEntDBOptions, EntDBMemoryOptions, HostHandle, IClient, ICrypto, IDeleteParams, IDiplomaticClientState, IEntRev, IHostConnectionInfo, IHostRow, IMessage, IMutateOp, IOp, IStateManager, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ITransport, IUpdateParams, ListMsgsOpts, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, OpenEntDBOptions, SyncProgressEvent, WorkerClientOptions, };