@interncom/diplomatic 0.4.5 → 0.6.0

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

@@ -1,7 +1,7 @@
 import { Status } from "../shared/consts";
 import { ValStat } from "../shared/valstat";
-import { EntityID, GroupID, IMsgEntBody, IOp } from "../shared/types";
-import { StateManager } from "../state.ts";
+import { EntityID, GroupID, IEntRev, IMessageHead, IMsgEntBody, IOp } from "../shared/types";
+export { entStateManager } from "./manager.ts";
 export interface IEntity<T = unknown> extends Omit<IMsgEntBody<T>, "body"> {
     eid: EntityID;
     updatedAt: Date;
@@ -25,11 +25,16 @@ export type EntitiesQuery = {
     type: string;
     updatedBetween: IDateRange;
 };
+/** Result of applying ops to EntDB. */
+export type ApplyResult = {
+    stats: Status[];
+    /** Types whose rendered state may have changed (for app list invalidation). */
+    types: Set<string>;
+    /** Eids that successfully applied (for granular cache ingest). */
+    eids: EntityID[];
+};
 export interface IEntDB {
-    apply: (ops: IOp[]) => Promise<{
-        stats: Status[];
-        types: Set<string>;
-    }>;
+    apply: (ops: IOp[]) => Promise<ApplyResult>;
     clear: () => Promise<Status>;
     getEnt<T>(eid: EntityID): Promise<ValStat<IEntity<T> | undefined>>;
     getEntities<T>(query: EntitiesQuery): Promise<ValStat<IEntity<T>[]>>;
@@ -37,6 +42,9 @@ export interface IEntDB {
         type: string;
     }): Promise<ValStat<number>>;
 }
-export declare function entStateManager(edb: IEntDB): StateManager;
+/** Prior rev from a loaded entity (typical update/delete input). */
+export declare function revFromEntity(ent: IEntity): IEntRev;
+/** Prior rev from a msg head returned by insert/update/delete. */
+export declare function revFromHead(head: IMessageHead): ValStat<IEntRev>;
 export declare function applyOp(curr: IEntity | undefined, op: IOp): ValStat<IEntity | undefined>;
 export declare const nullEntDB: IEntDB;

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

@@ -13,6 +13,7 @@ export declare class EntIDB implements IEntDB {
     apply: (ops: IOp[]) => Promise<{
         stats: Status[];
         types: Set<string>;
+        eids: EntityID[];
     }>;
     clear(): Promise<Status>;
     getEnt<T>(eid: EntityID): Promise<ValStat<IEntity<T> | undefined>>;
@@ -25,4 +26,5 @@ export declare class EntIDB implements IEntDB {
         type: string;
     }): Promise<ValStat<number>>;
 }
+/** Durable IndexedDB EntDB. Internal-only. Apps use {@link openEntDB} instead. */
 export declare function openEntIDB(): Promise<EntIDB>;

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

@@ -0,0 +1,8 @@
+import { StateManager } from "../state";
+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).
+ */
+export declare function entStateManager(edb: IEntDB): StateManager;

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

@@ -18,6 +18,7 @@ export declare class EntDBMemory implements IEntDB {
     apply(ops: IOp[]): Promise<{
         stats: Status[];
         types: Set<string>;
+        eids: EntityID[];
     }>;
     clear(): Promise<Status>;
     getEnt<T>(eid: EntityID): Promise<ValStat<IEntity<T> | undefined>>;

package/dist/web/index.d.ts

@@ -1,7 +1,8 @@
 import { SyncClient } from "./client";
 import crypto from "./crypto";
-import { EntitiesQuery, entStateManager, IEntDB, IEntity, nullEntDB } from "./entdb/entdb";
-import { EntIDB, openEntIDB } from "./entdb/idb";
+import { CachedEntDB, openEntDB, type OpenEntDBOptions } from "./entdb/cached";
+import { EntitiesQuery, entStateManager, IEntDB, IEntity, nullEntDB, revFromEntity, revFromHead } from "./entdb/entdb";
+import { EntIDB } from "./entdb/idb";
 import { EntDBMemory } from "./entdb/memory";
 import { useClient, useClientState, useClientXferState, useSyncOnResume } from "./react/useClient";
 import useStateWatcher, { useStateWatcherSuspense } from "./react/useStateWatcher";
@@ -12,13 +13,13 @@ import { eidCodec, genSingletonEID } from "./shared/codecs/eid";
 import { Status } from "./shared/consts";
 import { hostHTTPTransport, HTTPTransport } from "./shared/http";
 import { TypedEventEmitter } from "./shared/events";
-import { EntityID, GroupID, HostHandle, ICrypto, IHostConnectionInfo, IMessage, IMutateOp, type IOp, IStateManager, ITransport, MasterSeed } from "./shared/types";
+import { EntityID, GroupID, HostHandle, ICrypto, IDeleteParams, IEntRev, IHostConnectionInfo, IMessage, IMutateOp, type IOp, IStateManager, ITransport, IUpdateParams, MasterSeed } from "./shared/types";
 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 { Applier, IClient, IDiplomaticClientState, IHostRow, IStore, IStoredMessage, IStoredMessageData, IStoredMessageWrite } from "./types";
-import { isPendingApply, normalizeStoredMessageData } from "./types";
+import type { ApldState, Applier, IClient, IDiplomaticClientState, IHostRow, IStore, IStoredMessage, IStoredMessageData, IStoredMessageWrite } 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 { openDiplomaticClient, type OpenDiplomaticClientMainOptions, type OpenDiplomaticClientOptions, type OpenDiplomaticClientWorkerOptions, type OpenedDiplomaticClient } from "./openClient";
@@ -28,5 +29,5 @@ export declare function genWebClient(stateMgr: IStateManager, url: URL): Promise
     client: SyncClient<URL>;
     setSeed: (seedHex: string) => Promise<void>;
 }>;
-export { btoh, Clock, crypto, Decoder, defaultPeekProgressEvery, eidCodec, Encoder, EntDBMemory, EntIDB, EntitiesQuery, EntityID, entStateManager, genSingletonEID, GroupID, hostHTTPTransport, htob, HTTPTransport, IDBStore, idleProgress, IEntDB, IEntity, isPendingApply, IStore, MasterSeed, MemoryStore, normalizeStoredMessageData, nullEntDB, nullStateManager, openDiplomaticClient, openEntIDB, openIDBStore, shouldEmitItemProgress, SingletonStateManager, StateManager, Status, SyncClient, TypedEventEmitter, useClient, useClientState, useClientXferState, useStateWatcher, useStateWatcherSuspense, useSyncOnResume, WorkerClient, };
-export type { Applier, HostHandle, IClient, ICrypto, IDiplomaticClientState, IHostConnectionInfo, IHostRow, IMessage, IMutateOp, IOp, IStateManager, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ITransport, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, SyncProgressEvent, WorkerClientOptions, };
+export { APLD_APPLIED, APLD_ERROR, APLD_PENDING, apldFromStored, 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, 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, HostHandle, IClient, ICrypto, IDeleteParams, IDiplomaticClientState, IEntRev, IHostConnectionInfo, IHostRow, IMessage, IMutateOp, IOp, IStateManager, IStoredMessage, IStoredMessageData, IStoredMessageWrite, ITransport, IUpdateParams, OpenDiplomaticClientMainOptions, OpenDiplomaticClientOptions, OpenDiplomaticClientWorkerOptions, OpenedDiplomaticClient, OpenEntDBOptions, SyncProgressEvent, WorkerClientOptions, };