@better-i18n/mcp 0.15.2 → 0.15.4

package/dist/__tests__/base-tool.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base-tool.test.d.ts.map

package/dist/__tests__/base-tool.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-tool.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/base-tool.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/base-tool.test.js

@@ -0,0 +1,193 @@
+import { describe, it, expect } from "vitest";
+import { z } from "zod";
+import { parseProject } from "../helpers.js";
+import { success, error, executeTool, executeSimpleTool, projectSchema, } from "../base-tool.js";
+import { isErrorResult, expectSuccess, expectError } from "./helpers.js";
+// ---------------------------------------------------------------------------
+// parseProject
+// ---------------------------------------------------------------------------
+describe("parseProject", () => {
+    it('parses "org/project" into workspaceId and projectSlug', () => {
+        expect(parseProject("org/project")).toEqual({
+            workspaceId: "org",
+            projectSlug: "project",
+        });
+    });
+    it("throws a descriptive error for a single-segment string", () => {
+        expect(() => parseProject("invalid")).toThrow(/Invalid project format "invalid"/);
+    });
+    it("throws for an empty string", () => {
+        expect(() => parseProject("")).toThrow(/Invalid project format/);
+    });
+    it("throws when there are 3 segments (a/b/c)", () => {
+        expect(() => parseProject("a/b/c")).toThrow(/Invalid project format "a\/b\/c"/);
+    });
+    it("throws when the slug part is empty (org/)", () => {
+        expect(() => parseProject("org/")).toThrow(/Invalid project format "org\/"/);
+    });
+    it("throws when the org part is empty (/project)", () => {
+        expect(() => parseProject("/project")).toThrow(/Invalid project format "\/project"/);
+    });
+    it("handles hyphens in both org and slug", () => {
+        expect(parseProject("org-with-hyphens/proj-123")).toEqual({
+            workspaceId: "org-with-hyphens",
+            projectSlug: "proj-123",
+        });
+    });
+});
+// ---------------------------------------------------------------------------
+// projectSchema
+// ---------------------------------------------------------------------------
+describe("projectSchema", () => {
+    it("accepts a non-empty project string", () => {
+        expect(() => projectSchema.parse({ project: "org/slug" })).not.toThrow();
+    });
+    it("rejects an empty project string", () => {
+        expect(() => projectSchema.parse({ project: "" })).toThrow();
+    });
+    it("rejects a missing project field", () => {
+        expect(() => projectSchema.parse({})).toThrow();
+    });
+});
+// ---------------------------------------------------------------------------
+// success
+// ---------------------------------------------------------------------------
+describe("success", () => {
+    it("produces a result with type=text content", () => {
+        const result = success({ data: 1 });
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0]?.type).toBe("text");
+    });
+    it("serialises the payload as valid JSON", () => {
+        const result = success({ hello: "world", count: 42 });
+        const text = result.content[0]?.text;
+        expect(text).toBeDefined();
+        expect(() => JSON.parse(text)).not.toThrow();
+        expect(JSON.parse(text)).toEqual({ hello: "world", count: 42 });
+    });
+    it("does not set isError", () => {
+        const result = success({ ok: true });
+        expect(result.isError).toBeUndefined();
+    });
+});
+// ---------------------------------------------------------------------------
+// error
+// ---------------------------------------------------------------------------
+describe("error", () => {
+    it("sets isError: true", () => {
+        const result = error("something went wrong");
+        expect(result.isError).toBe(true);
+    });
+    it("includes the message in the text content", () => {
+        const msg = "something went wrong";
+        const result = error(msg);
+        expect(result.content[0]?.text).toBe(msg);
+    });
+    it("produces exactly one content entry", () => {
+        const result = error("oops");
+        expect(result.content).toHaveLength(1);
+        expect(result.content[0]?.type).toBe("text");
+    });
+});
+// ---------------------------------------------------------------------------
+// executeTool
+// ---------------------------------------------------------------------------
+describe("executeTool", () => {
+    const schema = z.object({ project: z.string().min(1), value: z.string() });
+    it("calls the handler with parsed input and ParsedProject on success", async () => {
+        const result = await executeTool({ project: "acme/website", value: "hello" }, schema, async (input, parsed) => {
+            return success({
+                value: input.value,
+                workspaceId: parsed.workspaceId,
+                projectSlug: parsed.projectSlug,
+            });
+        });
+        const data = expectSuccess(result);
+        expect(data.value).toBe("hello");
+        expect(data.workspaceId).toBe("acme");
+        expect(data.projectSlug).toBe("website");
+    });
+    it("returns isError: true with 'Validation error' on Zod failure", async () => {
+        const result = await executeTool({ project: "valid/project" /* missing required `value` */ }, schema, async () => success({}));
+        expect(isErrorResult(result)).toBe(true);
+        const msg = expectError(result);
+        expect(msg).toMatch(/Validation error/i);
+    });
+    it("returns isError: true when the handler throws", async () => {
+        const result = await executeTool({ project: "acme/website", value: "x" }, schema, async () => {
+            throw new Error("handler blew up");
+        });
+        expect(isErrorResult(result)).toBe(true);
+        expect(expectError(result)).toContain("handler blew up");
+    });
+    it("returns isError: true for invalid project format", async () => {
+        const result = await executeTool({ project: "not-a-valid-format", value: "x" }, schema, async () => success({}));
+        expect(isErrorResult(result)).toBe(true);
+        expect(expectError(result)).toMatch(/Invalid project format/i);
+    });
+    it("returns isError: true when args fail schema type coercion", async () => {
+        const result = await executeTool(null, // completely invalid args
+        schema, async () => success({}));
+        expect(isErrorResult(result)).toBe(true);
+    });
+    it("passes the full parsed project to the handler", async () => {
+        let capturedParsed = null;
+        await executeTool({ project: "my-org/my-slug", value: "test" }, schema, async (_input, parsed) => {
+            capturedParsed = parsed;
+            return success({});
+        });
+        expect(capturedParsed).toEqual({
+            workspaceId: "my-org",
+            projectSlug: "my-slug",
+        });
+    });
+    it("surfaces non-Error throws as string messages", async () => {
+        const result = await executeTool({ project: "acme/website", value: "x" }, schema, async () => {
+            // eslint-disable-next-line @typescript-eslint/no-throw-literal
+            throw "string error";
+        });
+        expect(isErrorResult(result)).toBe(true);
+        expect(expectError(result)).toBe("string error");
+    });
+});
+// ---------------------------------------------------------------------------
+// executeSimpleTool
+// ---------------------------------------------------------------------------
+describe("executeSimpleTool", () => {
+    const schema = z.object({ name: z.string().min(1), count: z.number() });
+    it("calls the handler with parsed input and returns its result", async () => {
+        const result = await executeSimpleTool({ name: "test", count: 5 }, schema, async (input) => success({ echo: input.name, times: input.count }));
+        const data = expectSuccess(result);
+        expect(data.echo).toBe("test");
+        expect(data.times).toBe(5);
+    });
+    it("returns isError: true with 'Validation error' on Zod failure", async () => {
+        const result = await executeSimpleTool({ name: "" /* fails min(1) */, count: 3 }, schema, async () => success({}));
+        expect(isErrorResult(result)).toBe(true);
+        expect(expectError(result)).toMatch(/Validation error/i);
+    });
+    it("returns isError: true when the handler throws an Error", async () => {
+        const result = await executeSimpleTool({ name: "good", count: 1 }, schema, async () => {
+            throw new Error("simple handler failed");
+        });
+        expect(isErrorResult(result)).toBe(true);
+        expect(expectError(result)).toContain("simple handler failed");
+    });
+    it("returns isError: true when the handler throws a non-Error value", async () => {
+        const result = await executeSimpleTool({ name: "good", count: 1 }, schema, async () => {
+            // eslint-disable-next-line @typescript-eslint/no-throw-literal
+            throw 42;
+        });
+        expect(isErrorResult(result)).toBe(true);
+        expect(expectError(result)).toBe("42");
+    });
+    it("returns isError: true when args are completely invalid", async () => {
+        const result = await executeSimpleTool(undefined, schema, async () => success({}));
+        expect(isErrorResult(result)).toBe(true);
+    });
+    it("does not include isError on a successful result", async () => {
+        const result = await executeSimpleTool({ name: "ok", count: 0 }, schema, async () => success({ ok: true }));
+        expect(result.isError).toBeUndefined();
+    });
+});
+//# sourceMappingURL=base-tool.test.js.map

package/dist/__tests__/base-tool.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-tool.test.js","sourceRoot":"","sources":["../../src/__tests__/base-tool.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/contract.test.d.ts

@@ -0,0 +1,24 @@
+/**
+ * contract.test.ts
+ *
+ * End-to-end contract tests that bridge the gap between tool logic and the real API.
+ *
+ * THREE test sections:
+ *
+ * 1. FORWARD CONTRACT — tool output → API schema validation
+ *    Execute each tool with a mock client, capture what it ACTUALLY sends to the
+ *    API (orgSlug, projectSlug, payload), and validate those args against the
+ *    mcp-types Zod schemas (the real API contract). If the API schema rejects it,
+ *    the tool has a normalization or mapping bug.
+ *
+ * 2. REVERSE CONTRACT — LLM-plausible args → tool acceptance
+ *    Simulate inputs an LLM would plausibly generate from reading inputSchema,
+ *    and assert the tool accepts them without isError. Catches regressions where
+ *    a schema tightening breaks something an LLM was expected to send.
+ *
+ * 3. NEGATIVE CONTRACT — invalid args MUST be rejected
+ *    Guard rails: assert that clearly invalid inputs are rejected (isError=true)
+ *    so we never silently swallow bad data from an LLM.
+ */
+export {};
+//# sourceMappingURL=contract.test.d.ts.map

package/dist/__tests__/contract.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG"}