@meetlark/mcp-server 1.0.0

package/test/tools.test.ts

@@ -0,0 +1,265 @@
+import { describe, it, beforeEach, afterEach } from "node:test";
+import assert from "node:assert";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { InMemoryTransport } from "@modelcontextprotocol/sdk/inMemory.js";
+import { createMeetLarkServer } from "../src/server.ts";
+
+let originalFetch: typeof globalThis.fetch;
+let client: Client;
+
+beforeEach(async () => {
+  originalFetch = globalThis.fetch;
+});
+
+afterEach(async () => {
+  globalThis.fetch = originalFetch;
+  await client?.close();
+});
+
+async function setupServer() {
+  const server = createMeetLarkServer("https://api.test");
+  const [clientTransport, serverTransport] = InMemoryTransport.createLinkedPair();
+  client = new Client({ name: "test-client", version: "1.0.0" });
+  await Promise.all([
+    client.connect(clientTransport),
+    server.connect(serverTransport),
+  ]);
+  return client;
+}
+
+function mockFetch(response: unknown, status = 200) {
+  let capturedUrl = "";
+  let capturedInit: RequestInit | undefined;
+
+  globalThis.fetch = async (input, init) => {
+    capturedUrl = String(input);
+    capturedInit = init;
+    return new Response(JSON.stringify(response), { status });
+  };
+
+  return { getCapturedUrl: () => capturedUrl, getCapturedInit: () => capturedInit };
+}
+
+describe("meetlark_create_poll", () => {
+  it("maps inputs to correct API call", async () => {
+    const captured = mockFetch(
+      { data: { id: "poll_1", adminToken: "adm_1", adminUrl: "http://test/admin/adm_1", participateToken: "prt_1", participateUrl: "http://test/vote/participate/prt_1" }, meta: { requestId: "r1" } },
+      201,
+    );
+
+    const c = await setupServer();
+    await c.callTool({ name: "meetlark_create_poll", arguments: {
+      title: "Standup",
+      description: "Daily standup",
+      timeSlots: [{ date: "2026-02-10", startTime: "09:00", endTime: "09:30" }],
+      creatorEmail: "test@example.com",
+      creatorName: "Test User",
+    }});
+
+    assert.ok(captured.getCapturedUrl().includes("/api/v1/polls?autoVerify=true"));
+    assert.strictEqual(captured.getCapturedInit()?.method, "POST");
+    const body = JSON.parse(captured.getCapturedInit()?.body as string);
+    assert.strictEqual(body.title, "Standup");
+    assert.strictEqual(body.creatorEmail, "test@example.com");
+  });
+
+  it("formats success response as MCP result", async () => {
+    const responseData = {
+      id: "poll_1",
+      adminToken: "adm_abc",
+      adminUrl: "http://test/admin/adm_abc",
+      participateToken: "prt_abc",
+      participateUrl: "http://test/vote/participate/prt_abc",
+    };
+
+    mockFetch({ data: responseData, meta: { requestId: "r1" } }, 201);
+
+    const c = await setupServer();
+    const result = await c.callTool({ name: "meetlark_create_poll", arguments: {
+      title: "Test",
+      timeSlots: [{ date: "2026-02-10", startTime: "09:00", endTime: "09:30" }],
+      creatorEmail: "test@example.com",
+    }});
+
+    assert.strictEqual(result.isError, undefined);
+    const content = result.content as Array<{ type: string; text: string }>;
+    assert.strictEqual(content[0].type, "text");
+    const parsed = JSON.parse(content[0].text);
+    assert.strictEqual(parsed.adminToken, "adm_abc");
+    assert.strictEqual(parsed.participateUrl, "http://test/vote/participate/prt_abc");
+  });
+
+  it("returns verification message on 403", async () => {
+    mockFetch(
+      {
+        error: { code: "email_not_verified", message: "Email not verified", details: { verificationSent: true, email: "test@example.com" } },
+        meta: { requestId: "r1" },
+      },
+      403,
+    );
+
+    const c = await setupServer();
+    const result = await c.callTool({ name: "meetlark_create_poll", arguments: {
+      title: "Test",
+      timeSlots: [{ date: "2026-02-10", startTime: "09:00", endTime: "09:30" }],
+      creatorEmail: "test@example.com",
+    }});
+
+    assert.strictEqual(result.isError, true);
+    const content = result.content as Array<{ type: string; text: string }>;
+    assert.ok(content[0].text.includes("Email verification required"));
+    assert.ok(content[0].text.includes("test@example.com"));
+  });
+});
+
+describe("meetlark_vote", () => {
+  it("maps inputs to correct API call", async () => {
+    const captured = mockFetch(
+      { data: { success: true, participant: { id: "p1", name: "Alice", votedAt: "2026-02-01T14:00:00Z" } }, meta: { requestId: "r1" } },
+    );
+
+    const c = await setupServer();
+    await c.callTool({ name: "meetlark_vote", arguments: {
+      participateToken: "prt_abc123",
+      name: "Alice",
+      votes: [{ timeSlotId: "ts1", value: "yes" }],
+    }});
+
+    assert.strictEqual(captured.getCapturedUrl(), "https://api.test/api/v1/vote/participate/prt_abc123");
+    assert.strictEqual(captured.getCapturedInit()?.method, "POST");
+    const body = JSON.parse(captured.getCapturedInit()?.body as string);
+    assert.strictEqual(body.name, "Alice");
+    assert.deepStrictEqual(body.votes, [{ timeSlotId: "ts1", value: "yes" }]);
+  });
+
+  it("returns success result", async () => {
+    const responseData = { success: true, participant: { id: "p1", name: "Alice", votedAt: "2026-02-01T14:00:00Z" } };
+    mockFetch({ data: responseData, meta: { requestId: "r1" } });
+
+    const c = await setupServer();
+    const result = await c.callTool({ name: "meetlark_vote", arguments: {
+      participateToken: "prt_abc123",
+      name: "Alice",
+      votes: [{ timeSlotId: "ts1", value: "yes" }],
+    }});
+
+    assert.strictEqual(result.isError, undefined);
+    const content = result.content as Array<{ type: string; text: string }>;
+    const parsed = JSON.parse(content[0].text);
+    assert.strictEqual(parsed.success, true);
+    assert.strictEqual(parsed.participant.name, "Alice");
+  });
+});
+
+describe("meetlark_get_results", () => {
+  it("calls correct endpoint", async () => {
+    const captured = mockFetch(
+      { data: { poll: { id: "poll_1", title: "Test", status: "open", timeSlots: [] } }, meta: { requestId: "r1" } },
+    );
+
+    const c = await setupServer();
+    await c.callTool({ name: "meetlark_get_results", arguments: {
+      participateToken: "prt_abc123",
+    }});
+
+    assert.strictEqual(captured.getCapturedUrl(), "https://api.test/api/v1/vote/participate/prt_abc123");
+    assert.strictEqual(captured.getCapturedInit()?.method, undefined); // GET
+  });
+
+  it("returns poll data", async () => {
+    const pollData = { poll: { id: "poll_1", title: "Standup", status: "open", timeSlots: [{ id: "ts1", date: "2026-02-10", startTime: "09:00", endTime: "09:30" }] } };
+    mockFetch({ data: pollData, meta: { requestId: "r1" } });
+
+    const c = await setupServer();
+    const result = await c.callTool({ name: "meetlark_get_results", arguments: {
+      participateToken: "prt_abc123",
+    }});
+
+    assert.strictEqual(result.isError, undefined);
+    const content = result.content as Array<{ type: string; text: string }>;
+    const parsed = JSON.parse(content[0].text);
+    assert.strictEqual(parsed.poll.title, "Standup");
+    assert.strictEqual(parsed.poll.timeSlots.length, 1);
+  });
+});
+
+describe("meetlark_get_admin_view", () => {
+  it("calls correct endpoint", async () => {
+    const captured = mockFetch(
+      { data: { id: "poll_1", title: "Test", status: "open" }, meta: { requestId: "r1" } },
+    );
+
+    const c = await setupServer();
+    await c.callTool({ name: "meetlark_get_admin_view", arguments: {
+      adminToken: "adm_abc123",
+    }});
+
+    assert.strictEqual(captured.getCapturedUrl(), "https://api.test/api/v1/polls/admin/adm_abc123");
+    assert.strictEqual(captured.getCapturedInit()?.method, undefined); // GET
+  });
+});
+
+describe("meetlark_close_poll", () => {
+  it("calls correct endpoint", async () => {
+    const captured = mockFetch(
+      { data: { success: true }, meta: { requestId: "r1" } },
+    );
+
+    const c = await setupServer();
+    await c.callTool({ name: "meetlark_close_poll", arguments: {
+      adminToken: "adm_abc123",
+    }});
+
+    assert.strictEqual(captured.getCapturedUrl(), "https://api.test/api/v1/polls/admin/adm_abc123/close");
+    assert.strictEqual(captured.getCapturedInit()?.method, "POST");
+  });
+});
+
+describe("meetlark_reopen_poll", () => {
+  it("calls correct endpoint", async () => {
+    const captured = mockFetch(
+      { data: { success: true }, meta: { requestId: "r1" } },
+    );
+
+    const c = await setupServer();
+    await c.callTool({ name: "meetlark_reopen_poll", arguments: {
+      adminToken: "adm_abc123",
+    }});
+
+    assert.strictEqual(captured.getCapturedUrl(), "https://api.test/api/v1/polls/admin/adm_abc123/reopen");
+    assert.strictEqual(captured.getCapturedInit()?.method, "POST");
+  });
+});
+
+describe("error handling", () => {
+  it("tools return isError on API errors", async () => {
+    mockFetch(
+      { error: { code: "poll_not_found", message: "Poll not found" }, meta: { requestId: "r1" } },
+      404,
+    );
+
+    const c = await setupServer();
+    const result = await c.callTool({ name: "meetlark_close_poll", arguments: {
+      adminToken: "adm_invalid",
+    }});
+
+    assert.strictEqual(result.isError, true);
+    const content = result.content as Array<{ type: string; text: string }>;
+    assert.ok(content[0].text.includes("Poll not found"));
+  });
+
+  it("tools return isError on network errors", async () => {
+    globalThis.fetch = async () => {
+      throw new Error("Connection refused");
+    };
+
+    const c = await setupServer();
+    const result = await c.callTool({ name: "meetlark_get_results", arguments: {
+      participateToken: "prt_abc123",
+    }});
+
+    assert.strictEqual(result.isError, true);
+    const content = result.content as Array<{ type: string; text: string }>;
+    assert.ok(content[0].text.includes("Could not connect to MeetLark API"));
+  });
+});

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "outDir": "dist",
+    "declaration": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "isolatedModules": true
+  },
+  "include": ["src/**/*.ts", "bin/**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/tsup.config.ts

@@ -0,0 +1,8 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts", "bin/cli.ts"],
+  format: ["esm"],
+  dts: true,
+  clean: true,
+});