fix(plugins): build package-local npm runtimes

test/plugin-npm-runtime-build.test.ts

@@ -0,0 +1,79 @@
+import fs from "node:fs";
+import path from "node:path";
+import { describe, expect, it } from "vitest";
+import { resolvePluginNpmRuntimeBuildPlan } from "../scripts/lib/plugin-npm-runtime-build.mjs";
+
+const repoRoot = path.resolve(import.meta.dirname, "..");
+
+function readJsonFile(filePath: string): Record<string, unknown> {
+  return JSON.parse(fs.readFileSync(filePath, "utf8")) as Record<string, unknown>;
+}
+
+function isPublishablePluginPackage(packageJson: Record<string, unknown>): boolean {
+  const openclaw = packageJson.openclaw as { release?: { publishToNpm?: unknown } } | undefined;
+  return openclaw?.release?.publishToNpm === true;
+}
+
+function listPublishablePluginPackageDirs(): string[] {
+  const extensionsRoot = path.join(repoRoot, "extensions");
+  return fs
+    .readdirSync(extensionsRoot, { withFileTypes: true })
+    .filter((dirent) => dirent.isDirectory())
+    .map((dirent) => path.join(extensionsRoot, dirent.name))
+    .filter((packageDir) => {
+      const packageJsonPath = path.join(packageDir, "package.json");
+      return (
+        fs.existsSync(packageJsonPath) && isPublishablePluginPackage(readJsonFile(packageJsonPath))
+      );
+    })
+    .toSorted((left, right) => left.localeCompare(right));
+}
+
+describe("plugin npm runtime build planning", () => {
+  it("plans package-local runtime entries for every publishable plugin package", () => {
+    const packageDirs = listPublishablePluginPackageDirs();
+    expect(packageDirs.length).toBeGreaterThan(0);
+
+    const plans = packageDirs.map((packageDir) =>
+      resolvePluginNpmRuntimeBuildPlan({
+        repoRoot,
+        packageDir,
+      }),
+    );
+    expect(plans.filter(Boolean).map((plan) => plan?.pluginDir)).toEqual(
+      packageDirs.map((packageDir) => path.basename(packageDir)),
+    );
+    for (const plan of plans) {
+      expect(plan?.outDir).toBe(path.join(plan?.packageDir ?? "", "dist"));
+      expect(plan?.runtimeExtensions.every((entry) => entry.startsWith("./dist/"))).toBe(true);
+    }
+  });
+
+  it("includes top-level public runtime surfaces and root-build-excluded plugins", () => {
+    const qqbotPlan = resolvePluginNpmRuntimeBuildPlan({
+      repoRoot,
+      packageDir: path.join(repoRoot, "extensions", "qqbot"),
+    });
+    expect(qqbotPlan?.entry).toEqual(
+      expect.objectContaining({
+        index: path.join(repoRoot, "extensions", "qqbot", "index.ts"),
+        "runtime-api": path.join(repoRoot, "extensions", "qqbot", "runtime-api.ts"),
+        "setup-entry": path.join(repoRoot, "extensions", "qqbot", "setup-entry.ts"),
+      }),
+    );
+    expect(qqbotPlan?.runtimeExtensions).toEqual(["./dist/index.js"]);
+    expect(qqbotPlan?.runtimeSetupEntry).toBe("./dist/setup-entry.js");
+
+    const diffsPlan = resolvePluginNpmRuntimeBuildPlan({
+      repoRoot,
+      packageDir: path.join(repoRoot, "extensions", "diffs"),
+    });
+    expect(diffsPlan?.entry).toEqual(
+      expect.objectContaining({
+        api: path.join(repoRoot, "extensions", "diffs", "api.ts"),
+        index: path.join(repoRoot, "extensions", "diffs", "index.ts"),
+        "runtime-api": path.join(repoRoot, "extensions", "diffs", "runtime-api.ts"),
+      }),
+    );
+  });
+});