@interncom/diplomatic 0.7.0 → 0.8.0

package/dist/web/client.d.ts

@@ -2,7 +2,7 @@ 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";
 export declare class SyncClient<Handle extends HostHandle> implements IClient<Handle> {
@@ -132,6 +132,36 @@ 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>;
+    /**
+     * 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";
@@ -9,9 +9,21 @@ export declare const typeGroupIndexName = "entity_type_group_id";
 export declare const typeParentIndexName = "entity_type_parent_id";
 /** multiEntry index on tags[]; query by tag then filter by type. */
 export declare const tagsIndexName = "entity_tags";
+/** Shared by main thread and sync worker — must stay in lockstep. */
+export declare const ENT_IDB_NAME = "db";
+/** v12: multiEntry tags index (entity_tags). */
+export declare const ENT_IDB_VERSION = 12;
 export declare class EntIDB implements IEntDB {
     db: IDBDatabase | undefined;
+    /** In-flight open; coalesces concurrent ensureDb / peer upgrade reopen. */
+    private opening;
     init(): Promise<void>;
+    /**
+     * Open (or reopen) the shared EntDB IDB connection.
+     * Main + worker both hold connections; on versionchange we must close so the
+     * peer's upgrade is not blocked forever (classic multi-connection hang).
+     */
+    private ensureDb;
     apply: (ops: IOp[]) => Promise<{
         stats: Status[];
         types: Set<string>;
@@ -28,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

@@ -22,6 +22,7 @@ import type { ApldState, Applier, IClient, IDiplomaticClientState, IHostRow, ISt
 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 { 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, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, OpenEntDBOptions, SyncProgressEvent, WorkerClientOptions, };