openclaw/src/plugins/runtime/runtime-web-channel-plugin.test.ts

// Runtime web-channel plugin tests cover web channel plugin activation and runtime behavior.
import { afterEach, describe, expect, it, vi } from "vitest";

afterEach(() => {
  vi.doUnmock("./runtime-plugin-boundary.js");
  vi.resetModules();
});

describe("runtime web channel plugin", () => {
  it("resolves the default auth dir through the light runtime on each call", async () => {
    let authDir = "/tmp/openclaw-default-auth";
    const resolveDefaultWebAuthDir = vi.fn(() => authDir);
    const resolvePluginRuntimeRecordByEntryBaseNames = vi.fn(() => ({
      origin: "bundled",
      source: "test",
    }));

    vi.doMock("./runtime-plugin-boundary.js", () => ({
      loadPluginBoundaryModule: () => ({ resolveDefaultWebAuthDir }),
      resolvePluginRuntimeModulePath: () => "/tmp/light-runtime-api.js",
      resolvePluginRuntimeRecordByEntryBaseNames,
    }));

    const { resolveWebChannelAuthDir } = await import("./runtime-web-channel-plugin.js");

    expect(resolveWebChannelAuthDir()).toBe("/tmp/openclaw-default-auth");
    authDir = "/tmp/openclaw-profile-auth";
    expect(resolveWebChannelAuthDir()).toBe("/tmp/openclaw-profile-auth");
    expect(resolveDefaultWebAuthDir).toHaveBeenCalledTimes(2);
    expect(resolvePluginRuntimeRecordByEntryBaseNames).toHaveBeenCalledOnce();
  });

  it("reuses the prepared heavy runtime before resolving plugin metadata again", async () => {
    const extractText = vi.fn((value: string) => value);
    const startWebLoginWithQr = vi.fn(async () => "started");
    const resolvePluginRuntimeRecordByEntryBaseNames = vi.fn(() => ({
      origin: "bundled",
      source: "test",
    }));
    vi.doMock("./runtime-plugin-boundary.js", () => ({
      loadPluginBoundaryModule: () => ({ extractText, startWebLoginWithQr }),
      resolvePluginRuntimeModulePath: () => "/tmp/runtime-api.js",
      resolvePluginRuntimeRecordByEntryBaseNames,
    }));

    const runtime = await import("./runtime-web-channel-plugin.js");

    expect(runtime.extractText("first")).toBe("first");
    expect(runtime.extractText("second")).toBe("second");
    await expect(runtime.startWebLoginWithQr()).resolves.toBe("started");
    expect(resolvePluginRuntimeRecordByEntryBaseNames).toHaveBeenCalledOnce();
  });

  it("reports heavy runtime load failures as promise rejections", async () => {
    vi.doMock("./runtime-plugin-boundary.js", () => ({
      loadPluginBoundaryModule: () => {
        throw new Error("runtime unavailable");
      },
      resolvePluginRuntimeModulePath: () => "/tmp/runtime-api.js",
      resolvePluginRuntimeRecordByEntryBaseNames: () => ({
        origin: "bundled",
        source: "test",
      }),
    }));
    const runtime = await import("./runtime-web-channel-plugin.js");

    await expect(runtime.loginWeb(false)).rejects.toThrow("runtime unavailable");
    await expect(runtime.monitorWebChannel()).rejects.toThrow("runtime unavailable");
  });

  it("falls back to the older WhatsApp light runtime auth dir export", async () => {
    vi.doMock("./runtime-plugin-boundary.js", () => ({
      loadPluginBoundaryModule: () => ({ WA_WEB_AUTH_DIR: "/tmp/openclaw-legacy-auth" }),
      resolvePluginRuntimeModulePath: () => "/tmp/light-runtime-api.js",
      resolvePluginRuntimeRecordByEntryBaseNames: () => ({
        origin: "external",
        source: "test",
      }),
    }));

    const { resolveWebChannelAuthDir } = await import("./runtime-web-channel-plugin.js");

    expect(resolveWebChannelAuthDir()).toBe("/tmp/openclaw-legacy-auth");
  });

  it("rejects non-string legacy auth dir exports", async () => {
    vi.doMock("./runtime-plugin-boundary.js", () => ({
      loadPluginBoundaryModule: () => ({
        WA_WEB_AUTH_DIR: Object("/tmp/openclaw-string-object-auth"),
      }),
      resolvePluginRuntimeModulePath: () => "/tmp/light-runtime-api.js",
      resolvePluginRuntimeRecordByEntryBaseNames: () => ({
        origin: "external",
        source: "test",
      }),
    }));

    const { resolveWebChannelAuthDir } = await import("./runtime-web-channel-plugin.js");

    expect(() => resolveWebChannelAuthDir()).toThrow(
      "web channel plugin runtime is missing export 'resolveDefaultWebAuthDir'",
    );
  });
});