feat: add the snippets plugin (B2)

plugins/snippets/tests/backend/activate.test.ts

@@ -0,0 +1,112 @@
+import { afterEach, describe, expect, it } from "vitest";
+import express from "express";
+import {
+  createMockCtx,
+  createTestDb,
+  type TestDb,
+} from "@termix/plugin-sdk/testing";
+import { PluginCapabilityError } from "@termix/plugin-sdk/backend";
+import { activate } from "../../src/backend/index.js";
+import { manifest, pluginDir, startServer, type TestServer } from "./helpers";
+
+let db: TestDb | null = null;
+let server: TestServer | null = null;
+
+afterEach(async () => {
+  db?.close();
+  db = null;
+  await server?.close();
+  server = null;
+});
+
+describe("snippets activate", () => {
+  it("registers snippets and snippetFolders sync entities at the legacy order values", async () => {
+    server = await startServer();
+    const types = server.mock.syncEntities.map((e) => e.type);
+    expect(types).toContain("snippets");
+    expect(types).toContain("snippetFolders");
+
+    const snippetsEntity = server.mock.syncEntities.find(
+      (e) => e.type === "snippets",
+    );
+    const foldersEntity = server.mock.syncEntities.find(
+      (e) => e.type === "snippetFolders",
+    );
+    expect(snippetsEntity?.order).toBe(60);
+    expect(foldersEntity?.order).toBe(40);
+  });
+
+  it("offers the snippets.access service, scoped to the calling user", async () => {
+    server = await startServer();
+    await server.request("POST", "/", {
+      body: { name: "Deploy", content: "echo deploy" },
+    });
+
+    const service = server.mock.services.get("snippets.access") as {
+      list: () => Promise<unknown>;
+    };
+    const listed = await server.mock.ctx.asUser("user-1", () => service.list());
+    expect(listed).toEqual([
+      expect.objectContaining({ name: "Deploy", content: "echo deploy" }),
+    ]);
+
+    const otherUsersList = await server.mock.ctx.asUser("user-2", () =>
+      service.list(),
+    );
+    expect(otherUsersList).toEqual([]);
+  });
+
+  it("wipes a user's snippets when user.data_wiped fires", async () => {
+    // events:core only to simulate core firing the topic in this test; the
+    // plugin's own manifest never declares it, since it only subscribes.
+    server = await startServer({
+      capabilities: [...manifest.capabilities, "events:core"],
+    });
+    await server.request("POST", "/", {
+      body: { name: "Deploy", content: "echo deploy" },
+    });
+
+    const before = (await server.request("GET", "/")).body;
+    expect(before).toHaveLength(1);
+
+    server.mock.ctx.events.emit("user.data_wiped", { userId: "user-1" });
+    // The listener's delete is fire-and-forget; give its microtasks a turn.
+    await new Promise((resolve) => setTimeout(resolve, 20));
+
+    const after = (await server.request("GET", "/")).body;
+    expect(after).toHaveLength(0);
+  });
+
+  it("fails closed without db:own", async () => {
+    db = await createTestDb(pluginDir);
+    const mock = createMockCtx({
+      pluginId: manifest.id,
+      manifest,
+      capabilities: [
+        "network:serve",
+        "ssh:connect",
+        "credentials:use",
+        "ui:surface",
+      ],
+      db: db.database,
+      router: () => express.Router(),
+    });
+    await expect(activate(mock.ctx)).rejects.toBeInstanceOf(
+      PluginCapabilityError,
+    );
+  });
+
+  it("fails closed without network:serve", async () => {
+    db = await createTestDb(pluginDir);
+    const mock = createMockCtx({
+      pluginId: manifest.id,
+      manifest,
+      capabilities: ["db:own", "ssh:connect", "credentials:use", "ui:surface"],
+      db: db.database,
+      router: () => express.Router(),
+    });
+    await expect(activate(mock.ctx)).rejects.toBeInstanceOf(
+      PluginCapabilityError,
+    );
+  });
+});