@interncom/diplomatic 0.20.0 → 0.22.0

package/dist/web/client.d.ts

@@ -20,8 +20,9 @@ export declare class SyncClient<Handle extends HostHandle> implements IClient<Ha
     private onScheduleSync?;
     connections: Map<string, DiplomaticClientAPI<Handle>>;
     /**
-     * Serializes local mutates + exec so concurrent drainApplyQueue / apply do
-     * not interleave markApplied (each job runs fully, in order).
+     * Serializes archive + markApplied so concurrent drainApplyQueue / apply
+     * do not interleave those IDB writes. Mem notify is kicked before this
+     * chain so a prior persist cannot delay the list.
      */
     private applyChain;
     /**
@@ -62,20 +63,20 @@ export declare class SyncClient<Handle extends HostHandle> implements IClient<Ha
      * Persist msgs (APLD_PENDING), exec into app state, then optionally enq upload.
      *
      * Order (do not invert — UI notify depends on it):
-     * 1) Kick off state.apply (CachedEntDB emits in the sync prefix of apply;
-     *    the returned Promise is durable EntDB + reconcile).
-     * 2) Durable archive (messages.add).
-     * 3) Await apply + mark APLD_APPLIED/APLD_ERROR.
-     * 4) Upload queue.
-     * Crash between 2–3 → drainApplyQueue recovers.
-     * Awaiting apply before archive makes the UI wait on EntDB IDB.
-     *
-     * Serialized on applyChain (with local mutates).
+     * 1) Kick state.apply *before* applyChain. CachedEntDB patches mem and
+     *    notifies after the next paint. A prior job's
+     *    archive / persist / markApplied must not delay the list.
+     * 2) Serialize archive (messages.add) + await apply + markApplied on
+     *    applyChain (crash between archive and mark → drainApplyQueue).
+     * 3) Upload queue.
+     * Awaiting apply before archive, or waiting on applyChain before kicking
+     * apply, makes the UI wait on IndexedDB.
      */
     private apply;
     /**
-     * Core apply without enqueue. Caller must already hold applyChain when
-     * composing makeUpdate + apply in one job.
+     * Archive + await a pre-kicked state.apply + markApplied.
+     * Caller must already hold applyChain. `applyP` is kicked first so mem
+     * notify is not serialized behind a prior job's IDB.
      */
     private doApply;
     private enqueueApplyJob;

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

@@ -20,6 +20,11 @@ export type OpenEntDBOptions = {
      * Set false to notify only after durable commit. Ignored when `cache` is false.
      */
     optimistic?: boolean;
+    /**
+     * Timed `[dip]` traces for apply / list / persist (default false).
+     * Process-wide; also accepted on openDiplomaticClient / useClient.
+     */
+    verbose?: boolean;
 };
 export type CachedEntDBOptions = {
     /** Secondary mem indexes (default true). See {@link OpenEntDBOptions.indexes}. */
@@ -32,6 +37,7 @@ export type CachedEntDBOptions = {
  * Default: cached with mem indexes and optimistic notify.
  * Pass `{ cache: false }` for durable IDB only.
  * Pass `{ optimistic: false }` to notify only after durable commit.
+ * Pass `{ verbose: true }` for `[dip]` timings (apply, list, persist).
  */
 export declare function openEntDB(opts?: OpenEntDBOptions): Promise<IEntDB>;
 export declare class CachedEntDB implements IEntDB {
@@ -41,14 +47,18 @@ export declare class CachedEntDB implements IEntDB {
     private listeners;
     private chain;
     private optimistic;
+    /** Optimistic applies whose durable persist has not finished. */
+    private inflight;
+    /** In-flight warmType per type (not on the persist/ingest chain). */
+    private warmP;
     constructor(durable: IEntDB, init?: IEntity[], opts?: CachedEntDBOptions);
     /** UI / StateManager: fired when mem changes (immediate apply or durable ingest). */
     subscribe(listener: EntChangeListener): () => void;
     private emit;
     private run;
     /**
-     * Fan-out write: patch mem, queue durable, notify UI on a microtask,
-     * then reconcile. Not `async`: mem patch must run before any await.
+     * Fan-out write: patch mem, queue durable, notify UI after the next paint.
+     * Not `async`: mem patch must run before any await.
      * `{ optimistic: false }`: skip the mem prefix; notify after durable.
      */
     apply(ops: IOp[]): Promise<import("./entdb").ApplyResult>;
@@ -67,6 +77,13 @@ export declare class CachedEntDB implements IEntDB {
      */
     private pullEids;
     private warmType;
+    /**
+     * Load a type from durable into mem. Not on the persist/ingest chain —
+     * first UI list must not wait for dirty-eid pull after worker sync.
+     */
+    private beginWarm;
+    /** Background warm + notify. Does not block the caller. */
+    private ensureWarm;
     getRow<T>(eid: EntityID): Promise<ValStat<IEntRow<T> | undefined>>;
     getEnt<T>(eid: EntityID): Promise<ValStat<IEntity<T> | undefined>>;
     getEntities<T>(query: EntitiesQuery): Promise<ValStat<IEntity<T>[]>>;

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

@@ -3,8 +3,8 @@ import type { IEntDB } from "./entdb";
 /**
  * Build a StateManager for an EntDB.
  * When `edb` is a {@link CachedEntDB}, type notifies come from the cache
- * subscribe path (mem patch + microtask notify, then durable reconcile /
- * peer ingest). cacheDriven: StateManager.apply must not emit after the
- * applier Promise settles — that would delay UI until durable IDB.
+ * subscribe path (mem patch + notify after paint, then durable persist).
+ * cacheDriven: StateManager.apply must not emit after the applier Promise
+ * settles — that emit would wait until durable IDB.
  */
 export declare function entStateManager(edb: IEntDB): StateManager;

package/dist/web/index.d.ts

@@ -17,6 +17,7 @@ import { TypedEventEmitter } from "./shared/events";
 import { asSealedMasterKey, MASTER_SEED_LEN, SEALED_MASTER_KEY_LEN, type SealedMasterKey } from "./shared/seed";
 import { EntityID, HostHandle, ICrypto, IDeleteParams, IEntRev, IHostConnectionInfo, IMessage, IMutateOp, type IOp, IStateManager, ITransport, IUpdateParams } from "./shared/types";
 import { Enclave } from "./shared/crypto/enclave";
+import type { PairRequest } from "./shared/crypto/enclave";
 import { nullStateManager, StateManager } from "./state";
 import { IDBSeedStore } from "./stores/idb/seed";
 import { IDBStore, openIDBStore } from "./stores/idb/store";
@@ -33,7 +34,7 @@ import { KEYRING_MAX, keyringCredIds, keyringKind, keyringLabel, PrfSeedStore }
 import type { Keyring, KeyringEntry, KeyringRow, PersistKeyring, PrfSeedStoreOpts } from "./passkey/prf-store";
 import type { PasskeySeedStoreOpts } from "./passkey/seed";
 import { type BundleHost } from "./shared/codecs/bundleHost";
-import { asDHKEReq, asDHKEResp, PairRequest } from "./shared/crypto/pairing";
+import { asDHKEReq, asDHKEResp } from "./shared/crypto/pairing";
 import type { DHKEReq, DHKEResp } from "./shared/crypto/pairing";
 import { checksumEntRevs, checksumSet, cmpBytes, encodeEntRev } from "./shared/checksum";
 import { openDiplomaticClient, type OpenDiplomaticClientMainOptions, type OpenDiplomaticClientOptions, type OpenDiplomaticClientWorkerOptions, type OpenedDiplomaticClient } from "./openClient";
@@ -43,5 +44,5 @@ import type { WipeOpts } from "./types";
 /** Platform advertises largeBlob (not a guarantee the binding key has it). */
 export { largeBlobCapable } from "./shared/webauthn/largeBlob";
 export { webAuthnLastError } from "./shared/webauthn/common";
-export { APLD_APPLIED, APLD_ERROR, APLD_PENDING, apldFromStored, asDHKEReq, asDHKEResp, asSealedMasterKey, b64tob, b64urltob, btob64, btob64url, btoh, CachedEntDB, checksumEntRevs, checksumSet, Clock, cmpBytes, crypto, Decoder, DEFAULT_PRF_SALT, defaultPeekProgressEvery, defaultWebAuthnRpId, eidCodec, Enclave, encodeEntRev, Encoder, EntDBMemory, EntIDB, EntitiesQuery, EntityID, entStateManager, genSingletonEID, hostHTTPTransport, htob, HTTPTransport, IDBSeedStore, IDBStore, idleProgress, IEntDB, IEntity, isApldState, isLiveEnt, isPendingApply, isTerminalApplyFailure, isTombstone, IStore, KEYRING_MAX, keyringCredIds, keyringKind, keyringLabel, MASTER_SEED_LEN, MemoryStore, normalizeTags, nullEntDB, nullStateManager, openDiplomaticClient, openEntDB, openIDBStore, PairRequest, PasskeySeedStore, prfCapable, PrfSeedStore, revFromEntity, revFromHead, SEALED_MASTER_KEY_LEN, setApld, shouldEmitItemProgress, SingletonStateManager, StateManager, Status, SyncClient, TypedEventEmitter, useClient, useClientState, useClientXferState, useStateWatcher, useStateWatcherSuspense, useSyncOnResume, WorkerClient, };
-export type { ApldState, Applier, BundleHost, CachedEntDBOptions, DateSpec, DHKEReq, DHKEResp, EntDBMemoryOptions, HostHandle, HostStatsUpdate, IClient, ICrypto, IDateRange, IDeleteParams, IDiplomaticClientState, IEntRev, IEntRow, IHostConnectionInfo, IHostRow, IMessage, IMutateOp, IOp, IStateManager, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ITagRange, ITombstone, ITransport, IUpdateParams, Keyring, KeyringEntry, KeyringRow, ListMsgsOpts, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, OpenEntDBOptions, PasskeySeedStoreOpts, PersistKeyring, PrfRp, PrfSeedStoreOpts, ReconcileOpts, ReconcileReport, SealedMasterKey, SetSeedOpts, SyncProgressEvent, TagSpec, WipeOpts, WorkerClientOptions, };
+export { APLD_APPLIED, APLD_ERROR, APLD_PENDING, apldFromStored, asDHKEReq, asDHKEResp, asSealedMasterKey, b64tob, b64urltob, btob64, btob64url, btoh, CachedEntDB, checksumEntRevs, checksumSet, Clock, cmpBytes, crypto, Decoder, DEFAULT_PRF_SALT, defaultPeekProgressEvery, defaultWebAuthnRpId, eidCodec, Enclave, encodeEntRev, Encoder, EntDBMemory, EntIDB, EntitiesQuery, EntityID, entStateManager, genSingletonEID, hostHTTPTransport, htob, HTTPTransport, IDBSeedStore, IDBStore, idleProgress, IEntDB, IEntity, isApldState, isLiveEnt, isPendingApply, isTerminalApplyFailure, isTombstone, IStore, KEYRING_MAX, keyringCredIds, keyringKind, keyringLabel, MASTER_SEED_LEN, MemoryStore, normalizeTags, nullEntDB, nullStateManager, openDiplomaticClient, openEntDB, openIDBStore, PasskeySeedStore, prfCapable, PrfSeedStore, revFromEntity, revFromHead, SEALED_MASTER_KEY_LEN, setApld, shouldEmitItemProgress, SingletonStateManager, StateManager, Status, SyncClient, TypedEventEmitter, useClient, useClientState, useClientXferState, useStateWatcher, useStateWatcherSuspense, useSyncOnResume, WorkerClient, };
+export type { ApldState, Applier, BundleHost, CachedEntDBOptions, DateSpec, DHKEReq, DHKEResp, EntDBMemoryOptions, HostHandle, HostStatsUpdate, IClient, ICrypto, IDateRange, IDeleteParams, IDiplomaticClientState, IEntRev, IEntRow, IHostConnectionInfo, IHostRow, IMessage, IMutateOp, IOp, IStateManager, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ITagRange, ITombstone, ITransport, IUpdateParams, Keyring, KeyringEntry, KeyringRow, ListMsgsOpts, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, OpenEntDBOptions, PairRequest, PasskeySeedStoreOpts, PersistKeyring, PrfRp, PrfSeedStoreOpts, ReconcileOpts, ReconcileReport, SealedMasterKey, SetSeedOpts, SyncProgressEvent, TagSpec, WipeOpts, WorkerClientOptions, };