test(agents): add unit tests for agents module

Covers conversations CRUD, addMessage, and connect URL
generation for both WhatsApp and Telegram channels.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: yoavf

tests/unit/agents.test.ts

@@ -0,0 +1,101 @@
+import { describe, test, expect, beforeEach, afterEach } from "vitest";
+import nock from "nock";
+import { createClient } from "../../src/index.ts";
+
+describe("Agents Module", () => {
+  let base44: ReturnType<typeof createClient>;
+  let scope: nock.Scope;
+  const appId = "test-app-id";
+  const serverUrl = "https://api.base44.com";
+
+  beforeEach(() => {
+    base44 = createClient({ serverUrl, appId });
+    scope = nock(serverUrl);
+    nock.disableNetConnect();
+  });
+
+  afterEach(() => {
+    nock.cleanAll();
+    nock.enableNetConnect();
+  });
+
+  describe("getConversations", () => {
+    test("should fetch all conversations", async () => {
+      const mockConversations = [
+        { id: "conv-1", agent_name: "support", messages: [] },
+        { id: "conv-2", agent_name: "sales", messages: [] },
+      ];
+      scope.get(`/api/apps/${appId}/agents/conversations`).reply(200, mockConversations);
+
+      const result = await base44.agents.getConversations();
+      expect(result).toEqual(mockConversations);
+    });
+  });
+
+  describe("getConversation", () => {
+    test("should fetch a specific conversation", async () => {
+      const mockConversation = { id: "conv-1", agent_name: "support", messages: [] };
+      scope.get(`/api/apps/${appId}/agents/conversations/conv-1`).reply(200, mockConversation);
+
+      const result = await base44.agents.getConversation("conv-1");
+      expect(result).toEqual(mockConversation);
+    });
+  });
+
+  describe("createConversation", () => {
+    test("should create a conversation", async () => {
+      const created = { id: "conv-new", agent_name: "support", messages: [] };
+      scope.post(`/api/apps/${appId}/agents/conversations`).reply(200, created);
+
+      const result = await base44.agents.createConversation({ agent_name: "support" });
+      expect(result).toEqual(created);
+    });
+  });
+
+  describe("addMessage", () => {
+    test("should post to v2 endpoint", async () => {
+      const conversation = { id: "conv-1", agent_name: "support", messages: [] } as any;
+      const response = { id: "msg-1", role: "assistant", content: "Hello!" };
+      scope.post(`/api/apps/${appId}/agents/conversations/v2/conv-1/messages`).reply(200, response);
+
+      const result = await base44.agents.addMessage(conversation, { role: "user", content: "Hi" });
+      expect(result).toEqual(response);
+    });
+  });
+
+  describe("getWhatsAppConnectURL", () => {
+    test("should return URL without token when no auth", () => {
+      const url = base44.agents.getWhatsAppConnectURL("support");
+      expect(url).toBe(`${serverUrl}/api/apps/${appId}/agents/support/whatsapp`);
+    });
+
+    test("should include token when authenticated", () => {
+      const authed = createClient({ serverUrl, appId, token: "test-token" });
+      const url = authed.agents.getWhatsAppConnectURL("support");
+      expect(url).toBe(`${serverUrl}/api/apps/${appId}/agents/support/whatsapp?token=test-token`);
+    });
+
+    test("should encode agent name", () => {
+      const url = base44.agents.getWhatsAppConnectURL("my agent");
+      expect(url).toBe(`${serverUrl}/api/apps/${appId}/agents/my%20agent/whatsapp`);
+    });
+  });
+
+  describe("getTelegramConnectURL", () => {
+    test("should return URL without token when no auth", () => {
+      const url = base44.agents.getTelegramConnectURL("support");
+      expect(url).toBe(`${serverUrl}/api/apps/${appId}/agents/support/telegram`);
+    });
+
+    test("should include token when authenticated", () => {
+      const authed = createClient({ serverUrl, appId, token: "test-token" });
+      const url = authed.agents.getTelegramConnectURL("support");
+      expect(url).toBe(`${serverUrl}/api/apps/${appId}/agents/support/telegram?token=test-token`);
+    });
+
+    test("should encode agent name", () => {
+      const url = base44.agents.getTelegramConnectURL("my agent");
+      expect(url).toBe(`${serverUrl}/api/apps/${appId}/agents/my%20agent/telegram`);
+    });
+  });
+});