Тестирование плагинов

import {  shouldAckReaction,  removeAckReactionAfterReply,} from "openclaw/plugin-sdk/channel-feedback";import { installCommonResolveTargetErrorCases } from "openclaw/plugin-sdk/channel-target-testing";import { AUTH_PROFILE_RUNTIME_CONTRACT } from "openclaw/plugin-sdk/agent-runtime-test-contracts";import { createTestPluginApi } from "openclaw/plugin-sdk/plugin-test-api";import { expectChannelInboundContextContract } from "openclaw/plugin-sdk/channel-contract-testing";import { createStartAccountContext } from "openclaw/plugin-sdk/channel-test-helpers";import { describePluginRegistrationContract } from "openclaw/plugin-sdk/plugin-test-contracts";import { registerSingleProviderPlugin } from "openclaw/plugin-sdk/plugin-test-runtime";import { describeOpenAIProviderRuntimeContract } from "openclaw/plugin-sdk/provider-test-contracts";import { getProviderHttpMocks } from "openclaw/plugin-sdk/provider-http-test-mocks";import { withEnv, withFetchPreconnect, withServer } from "openclaw/plugin-sdk/test-env";import {  bundledPluginRoot,  createCliRuntimeCapture,  typedCases,} from "openclaw/plugin-sdk/test-fixtures";import { mockNodeBuiltinModule } from "openclaw/plugin-sdk/test-node-mocks";

import type {  ChannelAccountSnapshot,  ChannelGatewayContext,} from "openclaw/plugin-sdk/channel-contract";import type { OpenClawConfig } from "openclaw/plugin-sdk/config-contracts";import type { MockFn, PluginRuntime, RuntimeEnv } from "openclaw/plugin-sdk/plugin-test-runtime";

import { describe } from "vitest";import { installCommonResolveTargetErrorCases } from "openclaw/plugin-sdk/channel-target-testing"; describe("разрешение целей my-channel", () => {  installCommonResolveTargetErrorCases({    resolveTarget: ({ to, mode, allowFrom }) => {      // Логика разрешения целей вашего канала      return myChannelResolveTarget({ to, mode, allowFrom });    },    implicitAllowFrom: ["user1", "user2"],  });   // Добавьте тестовые случаи, специфичные для канала  it("должен разрешать цели @username", () => {    // ...  });});

import { describe, it, expect, vi } from "vitest"; describe("плагин my-channel", () => {  it("должен разрешать учетную запись из конфигурации", () => {    const cfg = {      channels: {        "my-channel": {          token: "test-token",          allowFrom: ["user1"],        },      },    };     const account = myPlugin.setup.resolveAccount(cfg, undefined);    expect(account.token).toBe("test-token");  });   it("должен проверять учетную запись без материализации секретов", () => {    const cfg = {      channels: {        "my-channel": { token: "test-token" },      },    };     const inspection = myPlugin.setup.inspectAccount(cfg, undefined);    expect(inspection.configured).toBe(true);    expect(inspection.tokenStatus).toBe("available");    // Значение токена не раскрывается    expect(inspection).not.toHaveProperty("token");  });});

import { describe, it, expect } from "vitest"; describe("плагин my-provider", () => {  it("должен разрешать динамические модели", () => {    const model = myProvider.resolveDynamicModel({      modelId: "custom-model-v2",      // ... контекст    });     expect(model.id).toBe("custom-model-v2");    expect(model.provider).toBe("my-provider");    expect(model.api).toBe("openai-completions");  });   it("должен возвращать каталог, когда доступен ключ API", async () => {    const result = await myProvider.catalog.run({      resolveProviderApiKey: () => ({ apiKey: "test-key" }),      // ... контекст    });     expect(result?.provider?.models).toHaveLength(2);  });});

import { createPluginRuntimeStore } from "openclaw/plugin-sdk/runtime-store";import type { PluginRuntime } from "openclaw/plugin-sdk/runtime-store"; const store = createPluginRuntimeStore<PluginRuntime>({  pluginId: "test-plugin",  errorMessage: "тестовая среда выполнения не задана",}); // При настройке тестовconst mockRuntime = {  agent: {    resolveAgentDir: vi.fn().mockReturnValue("/tmp/agent"),    // ... другие моки  },  config: {    current: vi.fn(() => ({}) as const),    mutateConfigFile: vi.fn(),    replaceConfigFile: vi.fn(),  },  // ... другие пространства имен} as unknown as PluginRuntime; store.setRuntime(mockRuntime); // После тестовstore.clearRuntime();

// Предпочтительно: заглушка отдельного экземпляраconst client = new MyChannelClient();client.sendMessage = vi.fn().mockResolvedValue({ id: "msg-1" }); // Не рекомендуется: изменение прототипа// MyChannelClient.prototype.sendMessage = vi.fn();

pnpm test src/plugins/contracts/

pnpm test <bundled-plugin-root>/my-channel/

pnpm test src/plugins/contracts/shape.contract.test.tspnpm test src/plugins/contracts/auth-choice.contract.test.tspnpm test src/plugins/contracts/runtime-seams.contract.test.ts

# Запустить все тестыpnpm test # Запустить тесты конкретного плагинаpnpm test <bundled-plugin-root>/my-channel/src/channel.test.ts # Запустить с фильтром по конкретному имени тестаpnpm test <bundled-plugin-root>/my-channel/ -t "разрешает учетную запись" # Запустить с измерением покрытияpnpm test:coverage

OPENCLAW_VITEST_MAX_WORKERS=1 pnpm test