browser/platform_web/pages/PluginPageHostPage.test.tsx

import { renderToStaticMarkup } from "react-dom/server";
import { describe, expect, it } from "vitest";
import hostSource from "./PluginPageHostPage.tsx?raw";

import type { GamePluginResponse } from "../api/types";
import type { PageComponentProps } from "../contracts/page";
import { capabilitiesForRoles } from "../contracts/workspace";
import type { OperationTracker } from "../stores/operations";
import { PluginPageHostPage } from "./PluginPageHostPage";

const operations: OperationTracker = {
  operations: [],
  begin: () => "operation-test",
  update: () => undefined,
  succeed: () => undefined,
  fail: () => undefined,
  isPending: () => false
};

const plugin: GamePluginResponse = {
  id: "game.scum",
  name: "SCUM Server",
  version: "1.0.0",
  serverType: "scum",
  serverDisplayName: "SCUM Server",
  manifestRef: "artifact://manifests/game.scum/1.0.0",
  createFormSchemaRef: "schemas/create-form.schema.json",
  requiredRunCapabilities: [],
  declaredPermissions: ["server.read", "server.game-client.read", "server.game-client.command"],
  permissions: { ai: true, logs: false, files: false, jobs: true, artifacts: false, remoteAccess: false },
  lifecycleActions: {},
  bridgeActions: ["server.instances.read"],
  pages: [{
    key: "players",
    title: "用户管理",
    path: "/players",
    bundleKey: "scum-server-plugin",
    bundleVersion: "1.0.1",
    bundleIntegritySha256: "sha256:3488b316d909e597024f8f31c7bc96ab8019f643d74a528dc442d3df0dc3d54e",
    permissions: ["server.game-client.read", "server.game-client.command"],
    bridgeActions: ["server.instances.read"]
  }],
  tags: ["scum"],
  aiPurposes: [],
  productionLifecycle: { operations: ["install", "enable", "disable", "upgrade", "rollback", "retire", "dependency-check"], dependencyPolicy: "required", approvalRequired: ["disable", "rollback", "retire"] },
  gameClientBridge: {
    commands: [{ type: "announcement.send", title: "Send announcement", permission: "server.game-client.command", approvalLevel: "operator", payloadSchemaRef: "schemas/bridge/announcement.json", timeoutSeconds: 30, maxPayloadBytes: 4096 }],
    snapshots: [{ type: "companion.health", schemaVersion: "1", schemaRef: "schemas/bridge/health.json", keepForSeconds: 3600, maxRecords: 24 }],
    commandRetentionSeconds: 86400,
    maxCommands: 1000,
    pages: [{ pageKey: "players", commandTypes: ["announcement.send"], snapshotTypes: ["companion.health"] }]
  },
  status: "installed"
};

function props(serverId = "server-1"): PageComponentProps {
  const session = {
    id: "operator-1",
    displayName: "Operator",
    status: "active" as const,
    roles: ["platformAdmin" as const],
    capabilities: capabilitiesForRoles(["platformAdmin"]),
    profile: {},
    source: "local" as const
  };
  return {
    session,
    params: { pluginId: "game.scum", routeKey: "players", serverId },
    operations,
    onNavigate: () => undefined,
    onLogout: async () => undefined,
    onProfileSave: async () => session,
    onThemePreferenceSave: async () => ({ userId: session.id, paletteId: "mecha-black", backgroundPresetId: "mecha-grid", persistence: "api", updatedAt: "2026-07-20T00:00:00Z" })
  };
}

describe("PluginPageHostPage", () => {
  it("renders a generic manifest-owned bundle declaration", () => {
    const html = renderToStaticMarkup(<PluginPageHostPage {...props()} initialPlugin={plugin} />);
    expect(html).toContain("用户管理");
    expect(html).toContain("平台托管上下文");
    expect(html).toContain("scum-server-plugin@1.0.1");
    expect(html).toContain("完整性");
    expect(html).toContain("返回服务器");
    expect(html).not.toMatch(/sessionToken|componentKey|hostPath|dsn|runSocket|credential/i);
  });

  it("does not mount a bundle without client-side availability validation", () => {
    const html = renderToStaticMarkup(<PluginPageHostPage {...props("")} initialPlugin={plugin} />);
    expect(html).toContain("未绑定服务器");
    expect(html).toContain("正在校验并加载插件页面 bundle");
  });

  it("remains a manifest-driven host without SCUM component imports or game branches", () => {
    expect(hostSource).toContain("loadPluginPageBundle");
    expect(hostSource).not.toMatch(/ScumFileConfigWorkbench|GamePlayerIntelligencePanel|GameGiftCatalogPanel|ScumMapTrajectoryPanel|game\.scum/);
  });

  it("keeps typed SCUM workspace callbacks stable across parent operational refreshes", () => {
    expect(hostSource).toContain("readyPluginRef.current = readyPlugin");
    expect(hostSource).toContain("hostContextRef.current = hostContext");
    expect(hostSource).toContain("listSCUMPlayers: () => platformApiClient.listSCUMPlayers(serverId)");
    expect(hostSource).toContain("createSCUMWorkflow: (request) => platformApiClient.createSCUMWorkflow(serverId, request as never)");
    expect(hostSource).toContain("createSCUMOperation: (request) => platformApiClient.createSCUMOperation(serverId, request as never)");
    expect(hostSource).toContain("listSCUMWorkflowSteps: (workflowId) => platformApiClient.listSCUMWorkflowSteps(serverId, workflowId)");
    expect(hostSource).not.toContain("refreshWorkspace");
    expect(hostSource).not.toContain("requestFile");
    expect(hostSource).not.toContain("writeFile");
    expect(hostSource).not.toContain("getDeclaredFileReadSnapshot");
    expect(hostSource).toContain("}, [pluginId, serverId]);");
    expect(hostSource).not.toContain("}, [hostContext, readyPlugin, serverId]);");
  });
});