@interncom/diplomatic 0.8.3 → 0.9.0

package/dist/web/stores/memory/hosts.d.ts

@@ -3,8 +3,6 @@ import { HostHandle, IHostConnectionInfo, IHostMetadata } from "../../shared/typ
 import type { HostStatsUpdate, IHostRow, IHostStore } from "../../types";
 export declare class MemoryHostStore<Handle extends HostHandle> implements IHostStore<Handle> {
     hosts: Map<string, IHostRow<Handle>>;
-    /** Serializes recordStats so concurrent peeks do not drop bag/dupe deltas. */
-    private statsChain;
     add(info: IHostConnectionInfo<Handle>): Promise<void>;
     touch(label: string, seq: number): Promise<void>;
     recordStats(label: string, u: HostStatsUpdate): Promise<void>;

package/dist/web/sync.d.ts

@@ -83,10 +83,10 @@ export declare function msg2StoredMsgData({ head, body }: IMsgParts): IStoredMes
  */
 export declare function handleNotif<Handle extends HostHandle>(bytes: Uint8Array, { conn, store, enclave, host, crypto, onProgress, }: ISyncParams<Handle>, scheduleSync: () => void): Promise<void>;
 /**
- * Full host inventory (PEEK from seq 0): set absolute numBags/numDupes/lastSeq,
- * and optionally enqueue downloads (msgs on host missing locally) and/or
- * uploads (local msgs missing on host). Does not pull/push network beyond
- * peek — caller should sync() to drain queues.
+ * Full host inventory (PEEK from seq 0): set lastSeq; optionally enqueue
+ * downloads (msgs on host missing locally) and/or uploads (local msgs missing
+ * on host). Returns ephemeral bag tallies + msgcheck (not persisted). Does not
+ * pull/push beyond peek — caller should sync() to drain queues.
  *
  * lastSeq is set to the max bag seq in the inventory (0 if empty), including
  * rewind when the host has fewer bags than a prior cursor believed.

package/dist/web/types.d.ts

@@ -36,38 +36,16 @@ export interface ISeedStore {
 }
 export interface IHostRow<Handle extends HostHandle> extends IHostConnectionInfo<Handle>, Partial<IHostMetadata> {
     lastSeq: number;
-    /**
-     * Bags known on this host (full reconcile sets absolute; incremental peek
-     * adds newly seen seqs).
-     */
-    numBags: number;
-    /**
-     * Extra bags beyond one per msg (`Σ max(0, bags_for_msg − 1)`). Absolute on
-     * reconcile; +delta on peek when a new duplicate bag for a known msg is seen.
-     */
-    numDupes: number;
 }
 /**
- * Atomic host cursor + bag/dupe stats update (one store transaction).
- * Absolute fields replace; deltas add. `lastSeq` only advances; use
- * `setLastSeq` for a full-inventory absolute cursor (reconcile).
+ * Host row cursor write (one store transaction).
+ * `lastSeq` only advances unless `setLastSeq` is set.
  */
 export type HostStatsUpdate = {
     /** New lastSeq if greater than current (incremental peek/push). */
     lastSeq?: number;
     /** Absolute lastSeq, including rewind (full inventory). */
     setLastSeq?: number;
-    /** Absolute bag count (full inventory). */
-    numBags?: number;
-    /** Absolute dupe count (full inventory). */
-    numDupes?: number;
-    /** Count of newly peeked bags to add to numBags. */
-    bagDelta?: number;
-    /**
-     * Count of newly seen extra bags for a msg already on the host (duplicate
-     * bags for the same msg) to add to numDupes.
-     */
-    dupeDelta?: number;
 };
 export interface IHostStore<Handle extends HostHandle> {
     add: (host: IHostConnectionInfo<Handle>) => Promise<void>;
@@ -77,10 +55,7 @@ export interface IHostStore<Handle extends HostHandle> {
     list: () => Promise<Iterable<IHostRow<Handle>>>;
     wipe: () => Promise<void>;
     touch: (label: string, seq: number) => Promise<void>;
-    /**
-     * Apply lastSeq / numBags / numDupes in one transaction so counts do not
-     * drift vs the cursor under concurrent peek/push.
-     */
+    /** Apply lastSeq updates in one transaction. */
     recordStats: (label: string, u: HostStatsUpdate) => Promise<void>;
 }
 /** Options for {@link IClient.reconcile}. */
@@ -91,21 +66,26 @@ export type ReconcileOpts = {
     push?: boolean;
     /**
      * After inventory, run {@link IClient.sync} to drain upload/download queues.
-     * Default true. Pass false for inventory-only (counts + checksum).
+     * Default true. Pass false for inventory-only.
      */
     sync?: boolean;
 };
-/** Internal result of a full host inventory (not the public client API). */
-export type ReconcileResult = {
-    /**
-     * Set-checksum of distinct msgs on the host (archive keys; same construction
-     * as {@link IClient.msgcheck}). Ephemeral — not stored on the host row.
-     */
+/**
+ * Result of {@link IClient.reconcile}: host msg checksum and bag tallies from
+ * the (post-drain) full inventory. Ephemeral — not persisted.
+ */
+export type ReconcileReport = {
+    /** Distinct msgs on host (same construction as {@link IClient.msgcheck}). */
     msgcheck: Hash;
-    bagCount: number;
-    /** Distinct msgs among bags (dup bags for the same msg count once). */
-    uniqueMsgs: number;
+    /** Total bags on host (includes duplicate bags for the same msg). */
+    numBags: number;
+    /** Extra bags beyond one per msg. */
     numDupes: number;
+};
+/** Full inventory details (internal; includes set-diff counts). */
+export type ReconcileResult = ReconcileReport & {
+    /** Distinct msgs among bags. */
+    uniqueMsgs: number;
     /** Msgs on host not in local archive. */
     missingLocal: number;
     /** Local archive msgs not seen on host. */
@@ -312,13 +292,12 @@ export interface IClient<Handle extends HostHandle> {
      */
     countMsgs(apld?: ApldState): Promise<number>;
     /**
-     * Full host inventory (peek from seq 0): set numBags/numDupes/lastSeq;
-     * optionally enqueue downloads (`pull`) and/or uploads (`push`). Default
-     * drains via {@link sync}, then re-inventories so the returned host msg
-     * checksum matches post-drain host state (same construction as
-     * {@link msgcheck}). Read counts via {@link hosts}.
+     * Full host inventory (peek from seq 0); optionally enqueue pull/push.
+     * Default drains via {@link sync}, then re-inventories. Returns ephemeral
+     * host msgcheck + numBags + numDupes (not persisted). Advances lastSeq only
+     * on the host row.
      */
-    reconcile(hostLabel: string, opts?: ReconcileOpts): Promise<ValStat<Hash>>;
+    reconcile(hostLabel: string, opts?: ReconcileOpts): Promise<ValStat<ReconcileReport>>;
     wipe(): Promise<void>;
     import(file: File): Promise<Status>;
     export(filename: string, extension?: string): Promise<Status>;

package/dist/web/worker/client.d.ts

@@ -2,7 +2,7 @@ import { IClock } from "../shared/clock";
 import { Status } from "../shared/consts";
 import type { EntityID, Hash, IDeleteParams, IEntRev, IHostConnectionInfo, IInsertParams, IMessageHead, IStateManager, IUpdateParams, MasterSeed, SerializedContent } from "../shared/types";
 import { type ValStat } from "../shared/valstat";
-import type { ApldState, IClient, IDiplomaticClientState, IDiplomaticClientXferState, IHostRow, IStateEmitter, IStore, IStoredMessage, ListMsgsOpts, ReconcileOpts } from "../types";
+import type { ApldState, IClient, IDiplomaticClientState, IDiplomaticClientXferState, IHostRow, IStateEmitter, IStore, IStoredMessage, ListMsgsOpts, ReconcileOpts, ReconcileReport } from "../types";
 /**
  * Options for attaching to an app-owned sync Worker.
  *
@@ -121,9 +121,9 @@ export declare class WorkerClient implements IClient<URL> {
     countMsgs(apld?: ApldState): Promise<number>;
     /**
      * Full host inventory on the worker (network + crypto off main).
-     * Returns ephemeral host msg checksum; host row stats in shared IDB.
+     * Returns ephemeral msgcheck + bag counts (not persisted).
      */
-    reconcile(hostLabel: string, opts?: ReconcileOpts): Promise<ValStat<Hash>>;
+    reconcile(hostLabel: string, opts?: ReconcileOpts): Promise<ValStat<ReconcileReport>>;
     /** Archive checksum via worker (listKeys + sort + blake3 off main). */
     msgcheck(): Promise<Hash>;
     /**