openclaw/extensions/matrix-js/src/matrix/sdk/http-client.test.ts

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

const { performMatrixRequestMock } = vi.hoisted(() => ({
  performMatrixRequestMock: vi.fn(),
}));

vi.mock("./transport.js", () => ({
  performMatrixRequest: performMatrixRequestMock,
}));

import { MatrixAuthedHttpClient } from "./http-client.js";

describe("MatrixAuthedHttpClient", () => {
  beforeEach(() => {
    performMatrixRequestMock.mockReset();
  });

  it("parses JSON responses and forwards absolute-endpoint opt-in", async () => {
    performMatrixRequestMock.mockResolvedValue({
      response: new Response('{"ok":true}', {
        status: 200,
        headers: { "content-type": "application/json" },
      }),
      text: '{"ok":true}',
      buffer: Buffer.from('{"ok":true}', "utf8"),
    });

    const client = new MatrixAuthedHttpClient("https://matrix.example.org", "token");
    const result = await client.requestJson({
      method: "GET",
      endpoint: "https://matrix.example.org/_matrix/client/v3/account/whoami",
      timeoutMs: 5000,
      allowAbsoluteEndpoint: true,
    });

    expect(result).toEqual({ ok: true });
    expect(performMatrixRequestMock).toHaveBeenCalledWith(
      expect.objectContaining({
        method: "GET",
        endpoint: "https://matrix.example.org/_matrix/client/v3/account/whoami",
        allowAbsoluteEndpoint: true,
      }),
    );
  });

  it("returns plain text when response is not JSON", async () => {
    performMatrixRequestMock.mockResolvedValue({
      response: new Response("pong", {
        status: 200,
        headers: { "content-type": "text/plain" },
      }),
      text: "pong",
      buffer: Buffer.from("pong", "utf8"),
    });

    const client = new MatrixAuthedHttpClient("https://matrix.example.org", "token");
    const result = await client.requestJson({
      method: "GET",
      endpoint: "/_matrix/client/v3/ping",
      timeoutMs: 5000,
    });

    expect(result).toBe("pong");
  });

  it("returns raw buffers for media requests", async () => {
    const payload = Buffer.from([1, 2, 3, 4]);
    performMatrixRequestMock.mockResolvedValue({
      response: new Response(payload, { status: 200 }),
      text: payload.toString("utf8"),
      buffer: payload,
    });

    const client = new MatrixAuthedHttpClient("https://matrix.example.org", "token");
    const result = await client.requestRaw({
      method: "GET",
      endpoint: "/_matrix/media/v3/download/example/id",
      timeoutMs: 5000,
    });

    expect(result).toEqual(payload);
  });

  it("raises HTTP errors with status code metadata", async () => {
    performMatrixRequestMock.mockResolvedValue({
      response: new Response(JSON.stringify({ error: "forbidden" }), {
        status: 403,
        headers: { "content-type": "application/json" },
      }),
      text: JSON.stringify({ error: "forbidden" }),
      buffer: Buffer.from(JSON.stringify({ error: "forbidden" }), "utf8"),
    });

    const client = new MatrixAuthedHttpClient("https://matrix.example.org", "token");
    await expect(
      client.requestJson({
        method: "GET",
        endpoint: "/_matrix/client/v3/rooms",
        timeoutMs: 5000,
      }),
    ).rejects.toMatchObject({
      message: "forbidden",
      statusCode: 403,
    });
  });
});