import { test } from "node:test";
import assert from "node:assert/strict";
import { mkdtemp, writeFile, readFile, readdir } from "node:fs/promises";
import { tmpdir } from "node:os";
import { join } from "node:path";
import { seal, unseal, compareVersions } from "../dist/primitives/index.js";
import { registerModuleTools, collectTools, resetTools, serveTools, listTools } from "../dist/tools/index.js";
import { runProvisioner, type Grant } from "../dist/provisioner/index.js";
import { emit, on, type Event } from "../dist/events/index.js";
import { useBroker } from "../dist/messaging/index.js";
test("seal round-trips and rejects the wrong key", () => {
const sealed = seal("hunter2", "node-key");
assert.equal(unseal(sealed, "node-key"), "hunter2");
assert.notEqual(sealed, "hunter2");
assert.throws(() => unseal(sealed, "wrong-key"));
});
test("semver orders releases", () => {
assert.equal(compareVersions("1.2.3", "1.2.10"), -1);
assert.equal(compareVersions("2.0.0", "1.9.9"), 1);
assert.equal(compareVersions("v1.0.0", "1.0.0"), 0);
});
test("module tools register and collect, a thrower is skipped not fatal", () => {
resetTools();
registerModuleTools("umami", () => [
{ name: "umami_stats", description: "d", input: {}, run: async () => 1 },
]);
registerModuleTools("broken", () => {
throw new Error("no token");
});
const collected = collectTools({});
const umami = collected.find((c) => c.module === "umami");
const broken = collected.find((c) => c.module === "broken");
assert.equal(umami?.tools.length, 1);
assert.equal(broken?.tools.length, 0);
});
test("provisioner creates a sealed credential for a grant, then removes on withdrawal", async () => {
const dir = await mkdtemp(join(tmpdir(), "prov-"));
const created: string[] = [];
const removed: string[] = [];
const grant: Grant = { resource: "analytics", consumer: "webapp", node: "anchor", values: { name: "webapp" } };
await writeFile(join(dir, "webapp.grant.json"), JSON.stringify(grant));
const stop = runProvisioner(
"analytics",
{
async create(g) {
created.push(g.consumer);
return { fields: { siteId: "abc", snippet: "` };
},
},
]);
const broker = memBroker();
const stop = await serveTools(broker, {});
// Invoke it the way a caller (mesh-control's command API) would — over the broker, by name.
const result = await broker.request<{ tool: string; args: Record }, { snippet: string }>(
"tools.invoke",
{ tool: "create_site", args: { domain: "my-app" } },
);
assert.match(result.snippet, /data-website-id="site-123"/);
// Discovery works, and an unknown tool is refused rather than silently dropped.
assert.deepEqual(listTools({}).map((t) => t.name), ["create_site"]);
await assert.rejects(broker.request("tools.invoke", { tool: "nope", args: {} }));
stop();
server.close();
});
test("serving refuses two modules exposing one tool name", async () => {
resetTools();
registerModuleTools("a", () => [{ name: "dup", description: "", input: {}, run: async () => 1 }]);
registerModuleTools("b", () => [{ name: "dup", description: "", input: {}, run: async () => 2 }]);
await assert.rejects(serveTools(memBroker(), {}), /exposed by two modules/);
});
// A minimal in-memory broker: request routes to a registered handle, and publish routes to every
// subscriber whose topic pattern matches. Enough to exercise tools and events; the real binding is
// the mesh's AMQP one, provided by the hosting runtime.
function memBroker() {
const handlers = new Map Promise>();
const subs: { pattern: string; handler: (env: { key: string; node: string; body: unknown }) => Promise }[] = [];
return {
async request(key: string, body: Req): Promise {
const h = handlers.get(key);
if (!h) throw new Error(`no handler for ${key}`);
return (await h(body)) as Res;
},
async handle(key: string, handler: (b: Req) => Promise): Promise<() => void> {
handlers.set(key, handler as (b: unknown) => Promise);
return () => handlers.delete(key);
},
async publish(env: { key: string; node: string; body: T }): Promise {
for (const s of subs) if (topicMatch(s.pattern, env.key)) await s.handler(env);
},
async subscribe(pattern: string, handler: (env: { key: string; node: string; body: T }) => Promise): Promise<() => void> {
const entry = { pattern, handler: handler as (env: { key: string; node: string; body: unknown }) => Promise };
subs.push(entry);
return () => {
const i = subs.indexOf(entry);
if (i >= 0) subs.splice(i, 1);
};
},
async close(): Promise {},
};
}
// AMQP topic matching: `*` one segment, `#` any run of segments.
function topicMatch(pattern: string, key: string): boolean {
if (pattern === "#") return true;
const p = pattern.split(".");
const k = key.split(".");
let pi = 0;
let ki = 0;
while (pi < p.length) {
if (p[pi] === "#") return true; // simplification: # only as a trailing wildcard
if (ki >= k.length) return false;
if (p[pi] !== "*" && p[pi] !== k[ki]) return false;
pi++;
ki++;
}
return ki === k.length;
}
test("events: a module emits, a listener and the audit sink (#) both receive it, with metadata", async () => {
const broker = memBroker();
useBroker(() => broker);
process.env.MESH_MODULE = "umami";
process.env.MESH_NODE = "anchor";
const heard: Event[] = [];
const audited: Event[] = [];
await on("module.umami.#", async (e) => void heard.push(e));
await on("#", async (e) => void audited.push(e)); // the audit logger is just this
await emit("module.umami.site.created", { domain: "my-app" });
await emit("module.plex.play.started", { title: "x" }); // a different module's event
// The umami listener heard only umami's event; the audit sink heard both.
assert.deepEqual(heard.map((e) => e.type), ["module.umami.site.created"]);
assert.deepEqual(audited.map((e) => e.type), ["module.umami.site.created", "module.plex.play.started"]);
// The metadata an audit trail needs is present — read back from the ADR 0047 headers, not the body.
const e = heard[0];
assert.equal(e.source, "umami");
assert.equal(e.node, "anchor");
assert.equal((e.body as { domain: string }).domain, "my-app");
assert.match(e.at, /^\d{4}-\d{2}-\d{2}T/);
// Every event carries a unique id (x-event-id) — the handle a consumer dedups on.
assert.ok(e.id, "event has an x-event-id");
assert.notEqual(audited[0].id, audited[1].id);
// The body is exactly the domain payload — provenance never leaks into it.
assert.deepEqual(Object.keys(e.body as object), ["domain"]);
delete process.env.MESH_MODULE;
delete process.env.MESH_NODE;
});
async function waitFor(cond: () => boolean, ms: number): Promise {
const start = Date.now();
while (!cond()) {
if (Date.now() - start > ms) throw new Error("timed out waiting");
await new Promise((r) => setTimeout(r, 10));
}
}