@langapi/mcp-server 1.0.0

package/dist/utils/sync-cache.test.js

@@ -0,0 +1,205 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import { mkdir, rm, readFile } from "fs/promises";
+import { join } from "path";
+import { tmpdir } from "os";
+import { detectLocalDelta, getFullDiff, readSyncCache, writeSyncCache, } from "./sync-cache.js";
+describe("detectLocalDelta", () => {
+    it("should mark all keys as new when cache is null", () => {
+        const currentContent = [
+            { key: "hello", value: "Hello" },
+            { key: "world", value: "World" },
+        ];
+        const result = detectLocalDelta(currentContent, null);
+        expect(result.newKeys).toEqual(["hello", "world"]);
+        expect(result.changedKeys).toEqual([]);
+        expect(result.unchangedKeys).toEqual([]);
+        expect(result.contentToSync).toEqual(currentContent);
+    });
+    it("should return empty arrays when current content is empty", () => {
+        const cachedContent = { hello: "Hello", world: "World" };
+        const result = detectLocalDelta([], cachedContent);
+        expect(result.newKeys).toEqual([]);
+        expect(result.changedKeys).toEqual([]);
+        expect(result.unchangedKeys).toEqual([]);
+        expect(result.contentToSync).toEqual([]);
+    });
+    it("should detect all new keys when none exist in cache", () => {
+        const currentContent = [
+            { key: "new1", value: "New 1" },
+            { key: "new2", value: "New 2" },
+        ];
+        const cachedContent = { existing: "Existing" };
+        const result = detectLocalDelta(currentContent, cachedContent);
+        expect(result.newKeys).toEqual(["new1", "new2"]);
+        expect(result.changedKeys).toEqual([]);
+        expect(result.unchangedKeys).toEqual([]);
+        expect(result.contentToSync).toHaveLength(2);
+    });
+    it("should detect all unchanged keys when values match", () => {
+        const currentContent = [
+            { key: "hello", value: "Hello" },
+            { key: "world", value: "World" },
+        ];
+        const cachedContent = { hello: "Hello", world: "World" };
+        const result = detectLocalDelta(currentContent, cachedContent);
+        expect(result.newKeys).toEqual([]);
+        expect(result.changedKeys).toEqual([]);
+        expect(result.unchangedKeys).toEqual(["hello", "world"]);
+        expect(result.contentToSync).toEqual([]);
+    });
+    it("should detect changed keys when values differ", () => {
+        const currentContent = [
+            { key: "hello", value: "Hello there" },
+            { key: "world", value: "World" },
+        ];
+        const cachedContent = { hello: "Hello", world: "World" };
+        const result = detectLocalDelta(currentContent, cachedContent);
+        expect(result.newKeys).toEqual([]);
+        expect(result.changedKeys).toEqual(["hello"]);
+        expect(result.unchangedKeys).toEqual(["world"]);
+        expect(result.contentToSync).toHaveLength(1);
+        expect(result.contentToSync[0]).toEqual({ key: "hello", value: "Hello there" });
+    });
+    it("should handle mixed new, changed, and unchanged keys", () => {
+        const currentContent = [
+            { key: "new", value: "New key" },
+            { key: "changed", value: "Changed value" },
+            { key: "unchanged", value: "Same value" },
+        ];
+        const cachedContent = {
+            changed: "Original value",
+            unchanged: "Same value",
+            removed: "This will be ignored by detectLocalDelta",
+        };
+        const result = detectLocalDelta(currentContent, cachedContent);
+        expect(result.newKeys).toEqual(["new"]);
+        expect(result.changedKeys).toEqual(["changed"]);
+        expect(result.unchangedKeys).toEqual(["unchanged"]);
+        expect(result.contentToSync).toHaveLength(2);
+    });
+});
+describe("getFullDiff", () => {
+    it("should mark all keys as new when cache is null", () => {
+        const currentContent = [
+            { key: "hello", value: "Hello" },
+            { key: "world", value: "World" },
+        ];
+        const result = getFullDiff(currentContent, null);
+        expect(result.newKeys).toEqual(["hello", "world"]);
+        expect(result.changedKeys).toEqual([]);
+        expect(result.unchangedKeys).toEqual([]);
+        expect(result.removedKeys).toEqual([]);
+    });
+    it("should detect removed keys", () => {
+        const currentContent = [
+            { key: "remaining", value: "Still here" },
+        ];
+        const cachedContent = {
+            remaining: "Still here",
+            removed1: "Gone",
+            removed2: "Also gone",
+        };
+        const result = getFullDiff(currentContent, cachedContent);
+        expect(result.newKeys).toEqual([]);
+        expect(result.changedKeys).toEqual([]);
+        expect(result.unchangedKeys).toEqual(["remaining"]);
+        expect(result.removedKeys).toEqual(["removed1", "removed2"]);
+    });
+    it("should include old and new values for changed keys", () => {
+        const currentContent = [
+            { key: "greeting", value: "Welcome" },
+        ];
+        const cachedContent = { greeting: "Hello there" };
+        const result = getFullDiff(currentContent, cachedContent);
+        expect(result.changedKeys).toHaveLength(1);
+        expect(result.changedKeys[0]).toEqual({
+            key: "greeting",
+            oldValue: "Hello there",
+            newValue: "Welcome",
+        });
+    });
+    it("should handle mixed scenario with all change types", () => {
+        const currentContent = [
+            { key: "new", value: "Brand new" },
+            { key: "changed", value: "Updated value" },
+            { key: "unchanged", value: "Same" },
+        ];
+        const cachedContent = {
+            changed: "Old value",
+            unchanged: "Same",
+            removed: "Will be detected as removed",
+        };
+        const result = getFullDiff(currentContent, cachedContent);
+        expect(result.newKeys).toEqual(["new"]);
+        expect(result.changedKeys).toEqual([
+            { key: "changed", oldValue: "Old value", newValue: "Updated value" },
+        ]);
+        expect(result.unchangedKeys).toEqual(["unchanged"]);
+        expect(result.removedKeys).toEqual(["removed"]);
+    });
+    it("should handle empty current content with cached content", () => {
+        const cachedContent = { key1: "Value 1", key2: "Value 2" };
+        const result = getFullDiff([], cachedContent);
+        expect(result.newKeys).toEqual([]);
+        expect(result.changedKeys).toEqual([]);
+        expect(result.unchangedKeys).toEqual([]);
+        expect(result.removedKeys).toEqual(["key1", "key2"]);
+    });
+});
+describe("readSyncCache / writeSyncCache", () => {
+    let testDir;
+    beforeEach(async () => {
+        testDir = join(tmpdir(), `sync-cache-test-${Date.now()}`);
+        await mkdir(testDir, { recursive: true });
+    });
+    afterEach(async () => {
+        try {
+            await rm(testDir, { recursive: true, force: true });
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+    });
+    it("should write and read back same content", async () => {
+        const content = [
+            { key: "hello", value: "Hello" },
+            { key: "world", value: "World" },
+        ];
+        await writeSyncCache(testDir, "en", content);
+        const result = await readSyncCache(testDir, "en");
+        expect(result).toEqual({
+            hello: "Hello",
+            world: "World",
+        });
+    });
+    it("should return null when cache file does not exist", async () => {
+        const result = await readSyncCache(testDir, "en");
+        expect(result).toBeNull();
+    });
+    it("should return null when source language does not match", async () => {
+        const content = [{ key: "hello", value: "Hello" }];
+        await writeSyncCache(testDir, "en", content);
+        const result = await readSyncCache(testDir, "de");
+        expect(result).toBeNull();
+    });
+    it("should create cache directory if it does not exist", async () => {
+        const nestedDir = join(testDir, "nested", "path");
+        const content = [{ key: "test", value: "Test" }];
+        await writeSyncCache(nestedDir, "en", content);
+        const cacheFile = join(nestedDir, ".langapi", "sync-cache.json");
+        const fileContent = await readFile(cacheFile, "utf-8");
+        const cache = JSON.parse(fileContent);
+        expect(cache.sourceLang).toBe("en");
+        expect(cache.content).toEqual({ test: "Test" });
+        expect(cache.lastSync).toBeDefined();
+    });
+    it("should overwrite existing cache on subsequent writes", async () => {
+        const content1 = [{ key: "old", value: "Old value" }];
+        const content2 = [{ key: "new", value: "New value" }];
+        await writeSyncCache(testDir, "en", content1);
+        await writeSyncCache(testDir, "en", content2);
+        const result = await readSyncCache(testDir, "en");
+        expect(result).toEqual({ new: "New value" });
+    });
+});
+//# sourceMappingURL=sync-cache.test.js.map

package/dist/utils/sync-cache.test.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Validation utilities for input sanitization
+ */
+import { z } from "zod";
+/**
+ * RFC 5646 language code pattern
+ * Matches: en, de, fr, pt-BR, zh-CN, etc.
+ */
+export declare const LANGUAGE_CODE_PATTERN: RegExp;
+/**
+ * Zod schema for language code validation
+ */
+export declare const languageCodeSchema: z.ZodString;
+/**
+ * Zod schema for array of language codes
+ */
+export declare const languageCodesArraySchema: z.ZodArray<z.ZodString, "many">;
+/**
+ * Validate a language code
+ */
+export declare function isValidLanguageCode(code: string): boolean;
+/**
+ * Validate that a path is within the project directory
+ * Prevents path traversal attacks
+ */
+export declare function isPathWithinProject(filePath: string, projectPath: string): boolean;
+/**
+ * Get a safe file path within the project directory
+ * Returns null if path would escape project directory
+ */
+export declare function getSafeFilePath(relativePath: string, projectPath: string): string | null;
+/**
+ * Sanitize a language code by ensuring it matches the expected pattern
+ * Returns the sanitized code or null if invalid
+ */
+export declare function sanitizeLanguageCode(code: string): string | null;
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAA6B,CAAC;AAEhE;;GAEG;AACH,eAAO,MAAM,kBAAkB,aAO3B,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,wBAAwB,iCAE6B,CAAC;AAEnE;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,GAClB,OAAO,CAMT;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,MAAM,GAAG,IAAI,CAUf;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMhE"}

package/dist/utils/validation.js

@@ -0,0 +1,67 @@
+/**
+ * Validation utilities for input sanitization
+ */
+import { z } from "zod";
+import { resolve } from "path";
+/**
+ * RFC 5646 language code pattern
+ * Matches: en, de, fr, pt-BR, zh-CN, etc.
+ */
+export const LANGUAGE_CODE_PATTERN = /^[a-z]{2,3}(-[A-Z]{2})?$/;
+/**
+ * Zod schema for language code validation
+ */
+export const languageCodeSchema = z
+    .string()
+    .min(2)
+    .max(6)
+    .regex(LANGUAGE_CODE_PATTERN, {
+    message: "Invalid language code. Expected format: 'en', 'de', 'pt-BR', etc.",
+});
+/**
+ * Zod schema for array of language codes
+ */
+export const languageCodesArraySchema = z
+    .array(languageCodeSchema)
+    .min(1, { message: "At least one target language is required" });
+/**
+ * Validate a language code
+ */
+export function isValidLanguageCode(code) {
+    return LANGUAGE_CODE_PATTERN.test(code);
+}
+/**
+ * Validate that a path is within the project directory
+ * Prevents path traversal attacks
+ */
+export function isPathWithinProject(filePath, projectPath) {
+    const resolvedProject = resolve(projectPath);
+    const resolvedFile = resolve(projectPath, filePath);
+    // Check that resolved file path starts with project path
+    return resolvedFile.startsWith(resolvedProject);
+}
+/**
+ * Get a safe file path within the project directory
+ * Returns null if path would escape project directory
+ */
+export function getSafeFilePath(relativePath, projectPath) {
+    const resolvedProject = resolve(projectPath);
+    const resolvedFile = resolve(projectPath, relativePath);
+    // Check that resolved file path starts with project path
+    if (!resolvedFile.startsWith(resolvedProject)) {
+        return null;
+    }
+    return resolvedFile;
+}
+/**
+ * Sanitize a language code by ensuring it matches the expected pattern
+ * Returns the sanitized code or null if invalid
+ */
+export function sanitizeLanguageCode(code) {
+    const trimmed = code.trim();
+    if (isValidLanguageCode(trimmed)) {
+        return trimmed;
+    }
+    return null;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAwB,MAAM,MAAM,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;AAEhE;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC;KAChC,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,GAAG,CAAC,CAAC,CAAC;KACN,KAAK,CAAC,qBAAqB,EAAE;IAC5B,OAAO,EACL,mEAAmE;CACtE,CAAC,CAAC;AAEL;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC;KACtC,KAAK,CAAC,kBAAkB,CAAC;KACzB,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC,CAAC;AAEnE;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY;IAC9C,OAAO,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAAgB,EAChB,WAAmB;IAEnB,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAEpD,yDAAyD;IACzD,OAAO,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC;AAClD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,YAAoB,EACpB,WAAmB;IAEnB,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;IAExD,yDAAyD;IACzD,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@langapi/mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for LangAPI - AI-powered translation management for i18n projects",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "langapi-mcp": "./bin/langapi-mcp.js",
+    "@langapi/mcp-server": "./bin/langapi-mcp.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src/**/*.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "i18n",
+    "internationalization",
+    "translation",
+    "langapi",
+    "ai",
+    "claude",
+    "cursor"
+  ],
+  "author": "LangAPI",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TedyHub/-langapi-mcp-server"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "glob": "^11.0.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.0.16"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}