PaperClipAI/ui/src/api/chatEndpoints.test.ts

import { beforeEach, describe, expect, it, vi } from "vitest";

const mockApi = vi.hoisted(() => ({
  get: vi.fn(),
  post: vi.fn(),
  put: vi.fn(),
  patch: vi.fn(),
  delete: vi.fn(),
}));
vi.mock("./client", () => ({ api: mockApi }));
import { chatEndpointsApi } from "./chatEndpoints";

describe("chatEndpointsApi", () => {
  beforeEach(() => Object.values(mockApi).forEach((mock) => mock.mockReset()));

  it("uses company-scoped creation and list routes", async () => {
    mockApi.get.mockResolvedValue({ endpoints: [] });
    mockApi.post.mockResolvedValue({ id: "endpoint-1" });
    await expect(chatEndpointsApi.list("company-1")).resolves.toEqual([]);
    await chatEndpointsApi.create("company-1", {
      provider: "slack",
      assignedAgentId: "agent-1",
    });
    expect(mockApi.get).toHaveBeenCalledWith(
      "/companies/company-1/chat-endpoints",
    );
    expect(mockApi.post).toHaveBeenCalledWith(
      "/companies/company-1/chat-endpoints",
      { provider: "slack", assignedAgentId: "agent-1" },
    );
  });

  it("publishes a board message with a stable idempotency key", async () => {
    mockApi.post.mockResolvedValue({
      id: "publication-1",
      state: "retry",
      attempts: 1,
      redactedError: "The provider timed out",
      nextAttemptAt: "2026-09-06T12:01:00.000Z",
    });
    await expect(
      chatEndpointsApi.publishBoardMessage(
        "endpoint-1",
        "conversation-1",
        "Visible update",
        "client-request-1234",
      ),
    ).resolves.toEqual({
      id: "publication-1",
      state: "retry",
      attempts: 1,
      redactedError: "The provider timed out",
      nextAttemptAt: "2026-09-06T12:01:00.000Z",
    });
    expect(mockApi.post).toHaveBeenCalledWith(
      "/chat-endpoints/endpoint-1/conversations/conversation-1/publications",
      {
        body: "Visible update",
        idempotencyKey: "client-request-1234",
      },
    );
  });

  it("reads a stable publication batch anchor without posting", async () => {
    const status = {
      publication: { id: "file-part", state: "pending", attempts: 0 },
      total: 2,
      published: 1,
    };
    mockApi.get.mockResolvedValue(status);
    await expect(
      chatEndpointsApi.getPublicationBatchStatus(
        "endpoint-1",
        "conversation-1",
        "text-part",
      ),
    ).resolves.toEqual(status);
    expect(mockApi.get).toHaveBeenCalledWith(
      "/chat-endpoints/endpoint-1/conversations/conversation-1/publications/text-part/status",
    );
    expect(mockApi.post).not.toHaveBeenCalled();
  });

  it("sends only explicitly selected attachment ids with a board message", async () => {
    mockApi.post.mockResolvedValue({
      id: "publication-file",
      state: "published",
      attempts: 1,
    });
    await chatEndpointsApi.publishBoardMessage(
      "endpoint-1",
      "conversation-1",
      "Visible update with file",
      "client-request-file-1234",
      ["aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"],
    );
    expect(mockApi.post).toHaveBeenCalledWith(
      "/chat-endpoints/endpoint-1/conversations/conversation-1/publications",
      {
        body: "Visible update with file",
        idempotencyKey: "client-request-file-1234",
        attachmentIds: ["aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa"],
      },
    );
  });

  it("posts provider credentials through the mounted setup action", async () => {
    mockApi.post.mockResolvedValue({ id: "endpoint-1", status: "verifying" });
    await chatEndpointsApi.setup("endpoint-1", {
      action: "configure",
      credentials: { appId: "123", privateKey: "pem" },
    });
    expect(mockApi.post).toHaveBeenCalledWith(
      "/chat-endpoints/endpoint-1/setup",
      {
        action: "configure",
        credentials: {
          appId: "123",
          privateKey: "pem",
        },
      },
    );
  });

  it("generates a one-time setup secret through the endpoint-scoped route", async () => {
    mockApi.post.mockResolvedValue({ webhookSecret: "generated-secret" });
    await expect(
      chatEndpointsApi.generateSetupSecret("endpoint-1"),
    ).resolves.toEqual({ webhookSecret: "generated-secret" });
    expect(mockApi.post).toHaveBeenCalledWith(
      "/chat-endpoints/endpoint-1/setup-secret",
      {},
    );
  });

  it("resolves an ambiguous provider action through its narrow endpoint route", async () => {
    mockApi.post.mockResolvedValue(undefined);
    await chatEndpointsApi.resolveAction(
      "endpoint-1",
      "action-1",
      "mark_delivered",
    );
    expect(mockApi.post).toHaveBeenCalledWith(
      "/chat-endpoints/endpoint-1/actions/action-1/resolve",
      { action: "mark_delivered" },
    );
  });

  it("sends only the selected file-transfer phase and revision with publication resolution", async () => {
    const fileTransfer = {
      phase: "file_info_unknown" as const,
      version: 4,
      uploadUrl: "must-not-leave-client",
    };
    await chatEndpointsApi.resolvePublication(
      "endpoint-1",
      "publication-1",
      "retry_anyway",
      fileTransfer,
    );
    expect(mockApi.post).toHaveBeenCalledWith(
      "/chat-endpoints/endpoint-1/publications/publication-1/resolve",
      {
        action: "retry_anyway",
        fileTransfer: { phase: "file_info_unknown", version: 4 },
      },
    );
    await chatEndpointsApi.resolvePublication(
      "endpoint-1",
      "ordinary",
      "cancel",
    );
    expect(mockApi.post).toHaveBeenLastCalledWith(
      "/chat-endpoints/endpoint-1/publications/ordinary/resolve",
      { action: "cancel" },
    );
  });
});