@interncom/diplomatic 0.8.0 → 0.8.1

package/dist/web/stores/idb/msgs.d.ts

@@ -1,7 +1,7 @@
 import { Status } from "../../shared/consts";
 import { ICrypto } from "../../shared/types";
 import { EntityID, Hash } from "../../shared/types";
-import { ApldState, IMessageStore, IStorableMessage, IStoredMessage } from "../../types";
+import { ApldState, IMessageStore, IStorableMessage, IStoredMessage, ListMsgsOpts } from "../../types";
 export declare class IDBMessageStore implements IMessageStore {
     private crypto;
     db: IDBDatabase;
@@ -10,7 +10,8 @@ export declare class IDBMessageStore implements IMessageStore {
     del(keys: Iterable<Hash>): Promise<void>;
     get(key: Hash): Promise<IStoredMessage | undefined>;
     has(key: Hash): Promise<boolean>;
-    list(apld?: ApldState): Promise<IStoredMessage[]>;
+    list(opts?: ListMsgsOpts): Promise<IStoredMessage[]>;
+    count(apld?: ApldState): Promise<number>;
     listKeys(): Promise<Hash[]>;
     last(eid: EntityID): Promise<IStoredMessage | undefined>;
     markApplied(keys: Iterable<Hash>): Promise<void>;

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

@@ -1,6 +1,6 @@
 import { ICrypto } from "../../shared/types";
 import { EntityID, Hash } from "../../shared/types";
-import { ApldState, IMessageStore, IStorableMessage, IStoredMessage, IStoredMessageData } from "../../types";
+import { ApldState, IMessageStore, IStorableMessage, IStoredMessage, IStoredMessageData, ListMsgsOpts } from "../../types";
 import { Status } from "../../shared/consts";
 export declare class MemoryMessageStore implements IMessageStore {
     private crypto;
@@ -10,7 +10,8 @@ export declare class MemoryMessageStore implements IMessageStore {
     del(keys: Iterable<Hash>): Promise<void>;
     get(key: Hash): Promise<IStoredMessage | undefined>;
     has(key: Hash): Promise<boolean>;
-    list(apld?: ApldState): Promise<IStoredMessage[]>;
+    list(opts?: ListMsgsOpts): Promise<IStoredMessage[]>;
+    count(apld?: ApldState): Promise<number>;
     listKeys(): Promise<Hash[]>;
     last(eid: EntityID): Promise<IStoredMessage | undefined>;
     markApplied(keys: Iterable<Hash>): Promise<void>;

package/dist/web/types.d.ts

@@ -147,18 +147,35 @@ export declare function isTerminalApplyFailure(st: Status): boolean;
  * Clears `err` unless setting {@link APLD_ERROR}.
  */
 export declare function setApld(data: IStoredMessageData, apld: ApldState, err?: Status): void;
-export declare function toStoredMessage(hash: Hash, data: IStoredMessageData, crypto: ICrypto): Promise<IStoredMessage>;
+/**
+ * Options for archive list / client diagnostics.
+ * `body` defaults to **true**. Pass `body: false` for heads + apld + err only.
+ */
+export type ListMsgsOpts = {
+    /** Filter by apply lifecycle; omit for all archive rows. */
+    apld?: ApldState;
+    /**
+     * Include msg bodies and derive `head.hsh` from them.
+     * Default `true`. Pass `false` to omit body and `hsh` (cheaper diagnostics);
+     * `head.len` still reflects stored size.
+     */
+    body?: boolean;
+};
+export declare function toStoredMessage(hash: Hash, data: IStoredMessageData, crypto: ICrypto, opts?: {
+    body?: boolean;
+}): Promise<IStoredMessage>;
 export interface IMessageStore {
     add: (messages: IStorableMessage[]) => Promise<Status[]>;
     get: (key: Hash) => Promise<IStoredMessage | undefined>;
     has: (key: Hash) => Promise<boolean>;
     del: (keys: Iterable<Hash>) => Promise<void>;
     /**
-     * List archive rows. Pass {@link ApldState} to filter by apply lifecycle
-     * (e.g. {@link APLD_PENDING} for the apply queue, {@link APLD_ERROR} for
-     * diagnostics). Omit for all messages.
+     * List archive rows. Filter with `apld` (e.g. {@link APLD_ERROR}).
+     * Bodies included by default; pass `body: false` to omit.
      */
-    list: (apld?: ApldState) => Promise<IStoredMessage[]>;
+    list: (opts?: ListMsgsOpts) => Promise<IStoredMessage[]>;
+    /** Count archive rows; optional apld filter (IDB index when available). */
+    count: (apld?: ApldState) => Promise<number>;
     /** Archive keys only (head hashes). Prefer over {@link list} for checksums. */
     listKeys: () => Promise<Hash[]>;
     last: (eid: EntityID) => Promise<IStoredMessage | undefined>;
@@ -219,6 +236,16 @@ export interface IClient<Handle extends HostHandle> {
      * Key encoding (e.g. b64 in IDB) is independent of this definition.
      */
     msgcheck(): Promise<Hash>;
+    /**
+     * List local archive rows for diagnostics (failed apply, pending drain, dump).
+     * Bodies included by default; pass `body: false` for lighter listings.
+     */
+    listMsgs(opts?: ListMsgsOpts): Promise<IStoredMessage[]>;
+    /**
+     * Count archive rows; optional apld filter.
+     * Prefer over list+length for badges.
+     */
+    countMsgs(apld?: ApldState): Promise<number>;
     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 { IClient, IDiplomaticClientState, IDiplomaticClientXferState, IHostRow, IStateEmitter, IStore } from "../types";
+import type { ApldState, IClient, IDiplomaticClientState, IDiplomaticClientXferState, IHostRow, IStateEmitter, IStore, IStoredMessage, ListMsgsOpts } from "../types";
 /**
  * Options for attaching to an app-owned sync Worker.
  *
@@ -116,6 +116,9 @@ export declare class WorkerClient implements IClient<URL> {
     rebuild(options?: {
         checkHost?: boolean;
     }): Promise<Status>;
+    /** Shared message IDB on main — no worker RPC. */
+    listMsgs(opts?: ListMsgsOpts): Promise<IStoredMessage[]>;
+    countMsgs(apld?: ApldState): Promise<number>;
     /** Archive checksum via worker (listKeys + sort + blake3 off main). */
     msgcheck(): Promise<Hash>;
     /**