@interncom/diplomatic 0.18.3 → 0.19.1

package/dist/cli/shared/types.d.ts

@@ -8,14 +8,12 @@ import type { ValStat } from "./valstat.ts";
 /** Identity seed brands — defined in seed.ts; re-exported for convenience. */
 export type { MasterSeed, SealedMasterKey } from "./seed.ts";
 export { asSealedMasterKey, MASTER_SEED_LEN, SEALED_MASTER_KEY_LEN, } from "./seed.ts";
-export type GroupID = string;
 declare const entityIDSymbol: unique symbol;
 export type EntityID = Uint8Array & {
     readonly [entityIDSymbol]: true;
 };
 export type SerializedContent = Uint8Array;
 export interface IMsgEntBody<T = unknown> {
-    gid?: GroupID;
     pid?: EntityID;
     /**
      * Optional multi-value tags for reverse multi-ref / label lookup (multiEntry-indexed).

package/dist/web/client.d.ts

@@ -61,10 +61,14 @@ export declare class SyncClient<Handle extends HostHandle> implements IClient<Ha
     /**
      * Persist msgs (APLD_PENDING), exec into app state, then optionally enq upload.
      *
-     * Order (crash-safe):
-     * 1) durable archive  2) exec + APLD_APPLIED/APLD_ERROR  3) upload queue
-     * Exec is where the app validates the msg; only successes are pushed.
-     * Crash between 1–2 → drainApplyQueue / exec stage recovers.
+     * 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).
      */
@@ -95,6 +99,8 @@ export declare class SyncClient<Handle extends HostHandle> implements IClient<Ha
      * without validating length alignment.
      */
     private applyStored;
+    /** Mark archive rows APPLIED / ERROR from apply stats (aligned with keys). */
+    private markApplyStats;
     insertRaw(bod: EncodedMessage): Promise<ValStat<IMessageHead>>;
     /**
      * Build the next update/delete msg from prior. Pure: no archive I/O.

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

@@ -10,19 +10,28 @@ export type OpenEntDBOptions = {
      */
     cache?: boolean;
     /**
-     * Secondary type/pid/gid/tag indexes on the in-memory layer (default true).
+     * Secondary type/pid/tag indexes on the in-memory layer (default true).
      * Speeds up getEntities list queries after a type is warm.
      * Ignored when `cache` is false.
      */
     indexes?: boolean;
+    /**
+     * Notify UI as soon as mem is patched, before durable IDB (default true).
+     * Set false to notify only after durable commit. Ignored when `cache` is false.
+     */
+    optimistic?: boolean;
 };
 export type CachedEntDBOptions = {
     /** Secondary mem indexes (default true). See {@link OpenEntDBOptions.indexes}. */
     indexes?: boolean;
+    /** Immediate mem notify (default true). See {@link OpenEntDBOptions.optimistic}. */
+    optimistic?: boolean;
 };
 /**
  * Open EntDB for the app (or worker). Single entry point.
- * Default: cached with mem indexes. Pass `{ cache: false }` for durable IDB only.
+ * Default: cached with mem indexes and optimistic notify.
+ * Pass `{ cache: false }` for durable IDB only.
+ * Pass `{ optimistic: false }` to notify only after durable commit.
  */
 export declare function openEntDB(opts?: OpenEntDBOptions): Promise<IEntDB>;
 export declare class CachedEntDB implements IEntDB {
@@ -31,6 +40,7 @@ export declare class CachedEntDB implements IEntDB {
     private warmed;
     private listeners;
     private chain;
+    private optimistic;
     constructor(durable: IEntDB, init?: IEntity[], opts?: CachedEntDBOptions);
     /** UI / StateManager: fired when mem changes (immediate apply or durable ingest). */
     subscribe(listener: EntChangeListener): () => void;
@@ -39,8 +49,8 @@ export declare class CachedEntDB implements IEntDB {
     /**
      * Fan-out write: mem (immediate notify) + durable, then reconcile mem
      * from durable for the ops' eids (second notify only if something moved).
-     * Mem patch+emit is synchronous so notify does not wait on IDB (new insert
-     * included). Persist stays on the write chain.
+     * Not `async`: the mem patch+emit below must run before any await.
+     * `{ optimistic: false }`: skip the sync prefix; notify after durable.
      */
     apply(ops: IOp[]): Promise<import("./entdb").ApplyResult>;
     clear(): Promise<Status>;
@@ -52,8 +62,9 @@ export declare class CachedEntDB implements IEntDB {
     /**
      * Install durable truth for each eid into mem (live or tombstone).
      * When `snap` is set (post-apply reconcile), skip eids whose mem stamp
-     * moved — a later apply owns them. Without snap (ingest), do not clobber
-     * a newer in-flight mem row.
+     * moved — a later apply owns them. Always skip if mem is newer than
+     * durable (overlapping optimistic apply). Never replace a newer in-flight
+     * mem row with older durable truth.
      */
     private pullEids;
     private warmType;

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

@@ -1,6 +1,6 @@
 import { Status } from "../shared/consts";
 import { ValStat } from "../shared/valstat";
-import { EntityID, GroupID, Hash, ICrypto, IEntRev, IMessageHead, IMsgEntBody, IOp } from "../shared/types";
+import { EntityID, 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;
@@ -52,9 +52,6 @@ export type TagSpec = string | {
 };
 export type EntitiesQuery = {
     type: string;
-} | {
-    type: string;
-    gid: GroupID;
 } | {
     type: string;
     pid: EntityID;

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

@@ -1,18 +1,17 @@
 import { Status } from "../shared/consts";
-import { EntityID, GroupID, Hash, ICrypto, IOp } from "../shared/types";
+import { EntityID, Hash, ICrypto, IOp } from "../shared/types";
 import { ValStat } from "../shared/valstat.ts";
 import { EntitiesQuery, IEntDB, IEntity, IEntRow, TagSpec } from "./entdb";
 export declare const entityTableName = "entities";
 export declare const typeIndexName = "entity_type_created_at";
 export declare const typeUpdatedAtIndexName = "entity_type_updated_at";
-export declare const typeGroupIndexName = "entity_type_group_id";
 export declare const typeParentIndexName = "entity_type_parent_id";
 /** multiEntry index on tgs[]; 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";
-/** v13: stored field tags → tgs (3-letter keys); multiEntry on tgs. */
-export declare const ENT_IDB_VERSION = 13;
+/** v14: drop [`typ`,`gid`] index (gid superseded by tags). */
+export declare const ENT_IDB_VERSION = 14;
 export declare class EntIDB implements IEntDB {
     db: IDBDatabase | undefined;
     /** In-flight open; coalesces concurrent ensureDb / peer upgrade reopen. */
@@ -34,7 +33,6 @@ export declare class EntIDB implements IEntDB {
     getEnt<T>(eid: EntityID): Promise<ValStat<IEntity<T> | undefined>>;
     /** List live ents of type matching an updatedAt spec. */
     private getByUpdatedAt;
-    getGroupMembers<T>(opType: string, gid: GroupID): Promise<ValStat<IEntity<T>[]>>;
     getAllOfType<T>(opType: string): Promise<ValStat<IEntity<T>[]>>;
     getByTag<T>(opType: string, spec: TagSpec): Promise<ValStat<IEntity<T>[]>>;
     private getAllEntities;

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

@@ -3,6 +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
- * (immediate apply + durable reconcile / peer ingest).
+ * subscribe path (optimistic apply + durable reconcile / peer ingest).
+ * cacheDriven: StateManager.apply must not emit after the applier Promise
+ * settles — that would delay UI until durable IDB. Subscribe is the notify.
  */
 export declare function entStateManager(edb: IEntDB): StateManager;

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

@@ -5,7 +5,7 @@ import { ValStat } from "../shared/valstat.ts";
 /** Options for {@link EntDBMemory}. */
 export type EntDBMemoryOptions = {
     /**
-     * Secondary type / type+pid / type+gid / type+tag indexes for list queries.
+     * Secondary type / type+pid / type+tag indexes for list queries.
      * Default true. Disable only if you need to save the index memory.
      */
     indexes?: boolean;
@@ -18,8 +18,6 @@ export declare class EntDBMemory implements IEntDB {
     private byType;
     /** type → pidKey → eidKey → ent */
     private byTypePid;
-    /** type → gid → eidKey → ent */
-    private byTypeGid;
     /** type → tag → eidKey → ent */
     private byTypeTag;
     constructor(initEnts?: IEntity[], opts?: EntDBMemoryOptions);

package/dist/web/index.d.ts

@@ -15,7 +15,7 @@ import { Status } from "./shared/consts";
 import { hostHTTPTransport, HTTPTransport } from "./shared/http";
 import { TypedEventEmitter } from "./shared/events";
 import { asSealedMasterKey, MASTER_SEED_LEN, SEALED_MASTER_KEY_LEN, type SealedMasterKey } from "./shared/seed";
-import { EntityID, GroupID, HostHandle, ICrypto, IDeleteParams, IEntRev, IHostConnectionInfo, IMessage, IMutateOp, type IOp, IStateManager, ITransport, IUpdateParams } from "./shared/types";
+import { EntityID, HostHandle, ICrypto, IDeleteParams, IEntRev, IHostConnectionInfo, IMessage, IMutateOp, type IOp, IStateManager, ITransport, IUpdateParams } from "./shared/types";
 import { Enclave } from "./shared/crypto/enclave";
 import { nullStateManager, StateManager } from "./state";
 import { IDBSeedStore } from "./stores/idb/seed";
@@ -43,5 +43,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, GroupID, 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 { 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, };