@moltzap/client 2026.411.0 → 2026.413.0

package/dist/test-utils/channel-service-fixture.d.ts

@@ -0,0 +1,43 @@
+/** Test fixture factory for ChannelService-shaped objects. */
+import type { Message } from "@moltzap/protocol";
+import type { ChannelService, CrossConversationEntry } from "../index.js";
+interface FixtureConversationMeta {
+    type: string;
+    name?: string;
+    participants: string[];
+}
+/** Fire events on the fixture service. */
+export interface ChannelServiceEmit {
+    message(msg: Message): void;
+    disconnect(): void;
+    reconnect(): void;
+}
+export interface ChannelServiceState {
+    setConversation(id: string, meta: FixtureConversationMeta): void;
+    setAgentName(id: string, name: string): void;
+    setContextEntries(currentConvId: string, entries: CrossConversationEntry[]): void;
+    setResolveAgentNameFailure(agentId: string, err: Error): void;
+    setConnectResult(result: unknown): void;
+    readonly sent: ReadonlyArray<{
+        convId: string;
+        text: string;
+    }>;
+    readonly connectCalls: {
+        count: number;
+    };
+    readonly closeCalls: {
+        count: number;
+    };
+    resolveAgentNameCallCount(agentId: string): number;
+}
+export interface FakeChannelService {
+    service: ChannelService;
+    emit: ChannelServiceEmit;
+    state: ChannelServiceState;
+}
+export interface CreateFakeChannelServiceOptions {
+    ownAgentId?: string;
+}
+export declare function createFakeChannelService(opts?: CreateFakeChannelServiceOptions): FakeChannelService;
+export {};
+//# sourceMappingURL=channel-service-fixture.d.ts.map

package/dist/test-utils/channel-service-fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-service-fixture.d.ts","sourceRoot":"","sources":["../../src/test-utils/channel-service-fixture.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAK1E,UAAU,uBAAuB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,0CAA0C;AAC1C,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAC5B,UAAU,IAAI,IAAI,CAAC;IACnB,SAAS,IAAI,IAAI,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACjE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,iBAAiB,CACf,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,sBAAsB,EAAE,GAChC,IAAI,CAAC;IACR,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC;IAC9D,gBAAgB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/D,QAAQ,CAAC,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;CACpD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,cAAc,CAAC;IACxB,IAAI,EAAE,kBAAkB,CAAC;IACzB,KAAK,EAAE,mBAAmB,CAAC;CAC5B;AAED,MAAM,WAAW,+BAA+B;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,wBAAwB,CACtC,IAAI,GAAE,+BAAoC,GACzC,kBAAkB,CAgHpB"}

package/dist/test-utils/channel-service-fixture.js

@@ -0,0 +1,106 @@
+/** Test fixture factory for ChannelService-shaped objects. */
+export function createFakeChannelService(opts = {}) {
+    const messageHandlers = [];
+    const disconnectHandlers = [];
+    const reconnectHandlers = [];
+    const conversations = new Map();
+    const agentNames = new Map();
+    const contextEntriesByConv = new Map();
+    const resolveFailures = new Map();
+    const resolveCalls = [];
+    const sent = [];
+    const connectCalls = { count: 0 };
+    const closeCalls = { count: 0 };
+    let connectResult = {};
+    let ownAgentId = opts.ownAgentId;
+    const service = {
+        get ownAgentId() {
+            return ownAgentId;
+        },
+        on(event, handler) {
+            if (event === "message") {
+                messageHandlers.push(handler);
+            }
+            else if (event === "disconnect") {
+                disconnectHandlers.push(handler);
+            }
+            else if (event === "reconnect") {
+                reconnectHandlers.push(handler);
+            }
+        },
+        async connect() {
+            connectCalls.count++;
+            return connectResult;
+        },
+        close() {
+            closeCalls.count++;
+        },
+        async send(conversationId, text) {
+            sent.push({ convId: conversationId, text });
+        },
+        getConversation(convId) {
+            const m = conversations.get(convId);
+            if (!m)
+                return undefined;
+            return { type: m.type, name: m.name, participants: m.participants };
+        },
+        getAgentName(agentId) {
+            return agentNames.get(agentId);
+        },
+        async resolveAgentName(agentId) {
+            resolveCalls.push(agentId);
+            const failure = resolveFailures.get(agentId);
+            if (failure)
+                throw failure;
+            return agentNames.get(agentId) ?? agentId;
+        },
+        peekContextEntries(currentConvId) {
+            const entries = contextEntriesByConv.get(currentConvId) ?? [];
+            const commit = () => {
+                contextEntriesByConv.set(currentConvId, []);
+            };
+            return { entries, commit };
+        },
+    };
+    const emit = {
+        message(msg) {
+            for (const h of messageHandlers)
+                h(msg);
+        },
+        disconnect() {
+            for (const h of disconnectHandlers)
+                h();
+        },
+        reconnect() {
+            for (const h of reconnectHandlers)
+                h();
+        },
+    };
+    const state = {
+        setConversation(id, meta) {
+            conversations.set(id, meta);
+        },
+        setAgentName(id, name) {
+            agentNames.set(id, name);
+        },
+        setContextEntries(currentConvId, entries) {
+            contextEntriesByConv.set(currentConvId, entries);
+        },
+        setResolveAgentNameFailure(agentId, err) {
+            resolveFailures.set(agentId, err);
+        },
+        setConnectResult(result) {
+            connectResult = result;
+        },
+        get sent() {
+            return sent;
+        },
+        connectCalls,
+        closeCalls,
+        resolveAgentNameCallCount(agentId) {
+            return resolveCalls.filter((id) => id === agentId).length;
+        },
+    };
+    return { service, emit, state };
+}
+//# sourceMappingURL=channel-service-fixture.js.map

package/dist/test-utils/channel-service-fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel-service-fixture.js","sourceRoot":"","sources":["../../src/test-utils/channel-service-fixture.ts"],"names":[],"mappings":"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"}

package/dist/test-utils/index.d.ts

@@ -0,0 +1,5 @@
+export { createFakeChannelService, type ChannelServiceEmit, type ChannelServiceState, type CreateFakeChannelServiceOptions, type FakeChannelService, } from "./channel-service-fixture.js";
+import type { Message } from "@moltzap/protocol";
+export declare function buildMessage(overrides?: Partial<Message>): Message;
+export declare function flushDispatchChain(): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/test-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,+BAA+B,EACpC,KAAK,kBAAkB,GACxB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD,wBAAgB,YAAY,CAAC,SAAS,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO,CAUtE;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIxD"}

package/dist/test-utils/index.js

@@ -0,0 +1,18 @@
+export { createFakeChannelService, } from "./channel-service-fixture.js";
+export function buildMessage(overrides = {}) {
+    return {
+        id: "msg-1",
+        conversationId: "conv-1",
+        sender: { type: "agent", id: "agent-alice" },
+        seq: 1,
+        parts: [{ type: "text", text: "hello" }],
+        createdAt: "2026-04-10T12:00:00.000Z",
+        ...overrides,
+    };
+}
+export async function flushDispatchChain() {
+    for (let i = 0; i < 20; i++) {
+        await Promise.resolve();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/test-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,GAKzB,MAAM,8BAA8B,CAAC;AAItC,MAAM,UAAU,YAAY,CAAC,YAA8B,EAAE;IAC3D,OAAO;QACL,EAAE,EAAE,OAAO;QACX,cAAc,EAAE,QAAQ;QACxB,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,aAAa,EAAE;QAC5C,GAAG,EAAE,CAAC;QACN,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QACxC,SAAS,EAAE,0BAA0B;QACrC,GAAG,SAAS;KACF,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moltzap/client",
-  "version": "2026.411.0",
+  "version": "2026.413.0",
   "description": "MoltZap client service — connection, conversation state, and cross-conversation context",
   "license": "MIT",
   "repository": {
@@ -20,6 +20,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./test-utils": {
+      "types": "./dist/test-utils/index.d.ts",
+      "import": "./dist/test-utils/index.js"
     }
   },
   "dependencies": {