kandev/plugin-registry/build-index.test.mjs

import assert from "node:assert/strict";
import test, { afterEach } from "node:test";
import {
  buildEntry,
  buildIndex,
  parseManifestFields,
  parsePluginsYaml,
} from "./build-index.mjs";

const realFetch = globalThis.fetch;
afterEach(() => {
  globalThis.fetch = realFetch;
});

/** Stub global fetch, routing by URL to a release / manifest / repo response. */
function stubGitHub({ release, manifestText, repoMeta }) {
  globalThis.fetch = async (url) => {
    const u = String(url);
    if (u.includes("/releases/latest")) return jsonResponse(release);
    if (u.includes("/manifest.yaml")) return textResponse(manifestText ?? "");
    if (u.includes("/repos/")) return jsonResponse(repoMeta);
    throw new Error(`unexpected fetch: ${u}`);
  };
}

const jsonResponse = (body, ok = body !== null) => ({
  ok,
  status: ok ? 200 : 500,
  json: async () => body ?? {},
  text: async () => JSON.stringify(body ?? {}),
});
const textResponse = (text) => ({ ok: text !== "", status: text ? 200 : 404, text: async () => text });

test("parsePluginsYaml reads the constrained pointer list", () => {
  const specs = parsePluginsYaml(
    [
      "# a comment",
      "plugins:",
      "  - id: hello",
      "    repo: kdlbs/kandev-plugin-hello",
      "    featured: true",
      "  - id: agent-stats",
      "    repo: kdlbs/kandev-plugin-agent-stats",
      "    categories: [analytics, ops]",
    ].join("\n"),
  );
  assert.equal(specs.length, 2);
  assert.deepEqual(specs[0], { id: "hello", repo: "kdlbs/kandev-plugin-hello", featured: true });
  assert.deepEqual(specs[1].categories, ["analytics", "ops"]);
});

test("parseManifestFields extracts presentation keys and ignores the rest", () => {
  const fields = parseManifestFields(
    [
      "id: hello",
      "api_version: 1",
      'display_name: "Hello"',
      "description: A starter plugin",
      "icon: icon.svg",
      "categories: [getting-started]",
      "min_kandev_version: 0.72.0",
      "capabilities:",
      "  state: true",
    ].join("\n"),
  );
  assert.equal(fields.display_name, "Hello");
  assert.equal(fields.description, "A starter plugin");
  assert.equal(fields.icon, "icon.svg");
  assert.equal(fields.min_kandev_version, "0.72.0");
  assert.deepEqual(fields.categories, ["getting-started"]);
  assert.equal("id" in fields, false);
});

test("parseManifestFields reads block-sequence categories", () => {
  const fields = parseManifestFields(
    ["display_name: Multi", "categories:", "  - integrations", "  - analytics", "author: kandev"].join(
      "\n",
    ),
  );
  assert.deepEqual(fields.categories, ["integrations", "analytics"]);
  assert.equal(fields.author, "kandev");
});

test("buildEntry resolves release, manifest, icon_url and stars", async () => {
  stubGitHub({
    release: {
      tag_name: "v1.2.0",
      name: "Release notes",
      published_at: "2026-01-01T00:00:00Z",
      assets: [{ name: "foo-1.2.0.tar.gz", browser_download_url: "https://dl/foo-1.2.0.tar.gz" }],
    },
    manifestText: "display_name: Foo\ndescription: A foo\nicon: icon.svg\ncategories: [x]",
    repoMeta: { stargazers_count: 42, pushed_at: "2026-02-02T00:00:00Z", owner: { login: "acme" } },
  });

  const { record, error } = await buildEntry({ id: "foo", repo: "acme/foo" });
  assert.equal(error, undefined);
  assert.equal(record.name, "Foo");
  assert.equal(record.version, "1.2.0");
  assert.equal(record.package_url, "https://dl/foo-1.2.0.tar.gz");
  assert.equal(record.icon_url, "https://raw.githubusercontent.com/acme/foo/v1.2.0/icon.svg");
  assert.equal(record.stars, 42);
  assert.equal(record.updated_at, "2026-02-02T00:00:00Z");
  assert.deepEqual(record.categories, ["x"]);
});

test("buildEntry errors (not throws) when there is no installable release", async () => {
  stubGitHub({ release: null });
  const { record, error } = await buildEntry({ id: "foo", repo: "acme/foo" });
  assert.equal(record, undefined);
  assert.match(error, /no latest release/);
});

test("buildEntry keeps stars null (never 0) when repo metadata lookup fails", async () => {
  stubGitHub({
    release: { tag_name: "1.0.0", assets: [{ name: "foo-1.0.0.tar.gz", browser_download_url: "https://dl/foo.tar.gz" }] },
    manifestText: "",
    repoMeta: null, // -> !ok -> throw -> caught
  });
  const { record } = await buildEntry({ id: "foo", repo: "acme/foo" });
  assert.equal(record.stars, null);
  assert.equal(record.icon_url, null); // no manifest icon
});

test("empty plugins.yaml parses to no specs and builds a valid empty index", async () => {
  assert.deepEqual(parsePluginsYaml("plugins: []"), []);
  const { document, errors } = await buildIndex([]);
  assert.equal(document.plugins.length, 0);
  assert.equal(errors.length, 0);
  assert.equal(document.schema_version, 1);
  assert.equal(document.source.name, "Kandev Official");
});

test("buildIndex skips bad entries but still builds the good ones", async () => {
  // First entry has a release, second does not.
  let call = 0;
  globalThis.fetch = async (url) => {
    const u = String(url);
    if (u.includes("/releases/latest")) {
      call += 1;
      return call === 1
        ? jsonResponse({ tag_name: "1.0.0", assets: [{ name: "a-1.0.0.tar.gz", browser_download_url: "https://dl/a" }] })
        : jsonResponse(null);
    }
    if (u.includes("/manifest.yaml")) return textResponse("");
    return jsonResponse({ stargazers_count: 1, owner: { login: "o" } });
  };

  const { document, errors } = await buildIndex([
    { id: "a", repo: "o/a" },
    { id: "b", repo: "o/b" },
  ]);
  assert.equal(document.plugins.length, 1);
  assert.equal(document.plugins[0].id, "a");
  assert.equal(errors.length, 1);
  assert.equal(document.schema_version, 1);
});