mcp-docs-service 0.3.4 → 0.3.6

package/dist/types/index.d.ts

@@ -0,0 +1,44 @@
+export interface DocumentMetadata {
+    title?: string;
+    order?: number;
+    description?: string;
+    author?: string;
+    date?: Date;
+    tags?: string[];
+    status?: string;
+    [key: string]: any;
+}
+export interface DocumentEntry {
+    path: string;
+    name: string;
+    metadata: DocumentMetadata;
+}
+export interface TreeEntry {
+    name: string;
+    path: string;
+    type: string;
+    metadata?: DocumentMetadata;
+    children: TreeEntry[];
+    error?: string;
+}
+export interface NavigationItem {
+    title: string;
+    path: string | null;
+    order: number;
+}
+export interface NavigationSection {
+    title: string;
+    path: string | null;
+    items: NavigationItem[];
+    order: number;
+}
+export type ToolResponse = {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    metadata?: Record<string, any>;
+    isError?: boolean;
+};
+export * from "./docs.js";
+export * from "./tools.js";

package/dist/types/index.js

@@ -0,0 +1,4 @@
+// Re-export all types from specialized modules
+export * from "./docs.js";
+export * from "./tools.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAiDA,+CAA+C;AAC/C,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC"}

package/dist/types/tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Standard response format for tools
+ */
+export type ToolResponse = {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    metadata?: Record<string, any>;
+    isError?: boolean;
+};

package/dist/types/tools.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=tools.js.map

package/dist/types/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/types/tools.ts"],"names":[],"mappings":""}

package/dist/utils/file.d.ts

@@ -0,0 +1,24 @@
+import { FileInfo } from "../types/file.js";
+/**
+ * Gets file statistics and information
+ */
+export declare function getFileStats(filePath: string): Promise<FileInfo>;
+/**
+ * Searches for files matching a pattern
+ */
+export declare function searchFiles(rootPath: string, pattern: string, excludePatterns?: string[]): Promise<string[]>;
+/**
+ * Normalizes line endings to LF
+ */
+export declare function normalizeLineEndings(text: string): string;
+/**
+ * Creates a unified diff between two text contents
+ */
+export declare function createUnifiedDiff(originalContent: string, newContent: string, filepath?: string): string;
+/**
+ * Applies edits to a file
+ */
+export declare function applyFileEdits(filePath: string, edits: Array<{
+    oldText: string;
+    newText: string;
+}>, dryRun?: boolean): Promise<string>;

package/dist/utils/file.js

@@ -0,0 +1,94 @@
+import fs from "fs/promises";
+import path from "path";
+import { createTwoFilesPatch } from "diff";
+import { minimatch } from "minimatch";
+/**
+ * Gets file statistics and information
+ */
+export async function getFileStats(filePath) {
+    const stats = await fs.stat(filePath);
+    // Convert file mode to permission string (e.g., "rwxr-xr-x")
+    const mode = stats.mode;
+    const permissions = [
+        stats.mode & 0o400 ? "r" : "-",
+        stats.mode & 0o200 ? "w" : "-",
+        stats.mode & 0o100 ? "x" : "-",
+        stats.mode & 0o040 ? "r" : "-",
+        stats.mode & 0o020 ? "w" : "-",
+        stats.mode & 0o010 ? "x" : "-",
+        stats.mode & 0o004 ? "r" : "-",
+        stats.mode & 0o002 ? "w" : "-",
+        stats.mode & 0o001 ? "x" : "-",
+    ].join("");
+    return {
+        size: stats.size,
+        created: stats.birthtime,
+        modified: stats.mtime,
+        accessed: stats.atime,
+        isDirectory: stats.isDirectory(),
+        isFile: stats.isFile(),
+        permissions,
+    };
+}
+/**
+ * Searches for files matching a pattern
+ */
+export async function searchFiles(rootPath, pattern, excludePatterns = []) {
+    const results = [];
+    async function search(currentPath) {
+        const entries = await fs.readdir(currentPath, { withFileTypes: true });
+        for (const entry of entries) {
+            const entryPath = path.join(currentPath, entry.name);
+            const relativePath = path.relative(rootPath, entryPath);
+            // Check if path should be excluded
+            if (excludePatterns.some((excludePattern) => minimatch(relativePath, excludePattern))) {
+                continue;
+            }
+            if (entry.isDirectory()) {
+                await search(entryPath);
+            }
+            else if (minimatch(relativePath, pattern)) {
+                results.push(entryPath);
+            }
+        }
+    }
+    await search(rootPath);
+    return results;
+}
+/**
+ * Normalizes line endings to LF
+ */
+export function normalizeLineEndings(text) {
+    return text.replace(/\r\n/g, "\n");
+}
+/**
+ * Creates a unified diff between two text contents
+ */
+export function createUnifiedDiff(originalContent, newContent, filepath = "file") {
+    return createTwoFilesPatch(filepath, filepath, normalizeLineEndings(originalContent), normalizeLineEndings(newContent), "", "", { context: 3 });
+}
+/**
+ * Applies edits to a file
+ */
+export async function applyFileEdits(filePath, edits, dryRun = false) {
+    let content = await fs.readFile(filePath, "utf-8");
+    content = normalizeLineEndings(content);
+    // Apply all edits
+    for (const edit of edits) {
+        const { oldText, newText } = edit;
+        const normalizedOldText = normalizeLineEndings(oldText);
+        if (!content.includes(normalizedOldText)) {
+            throw new Error(`Edit failed: Could not find text to replace in ${filePath}`);
+        }
+        content = content.replace(normalizedOldText, normalizeLineEndings(newText));
+    }
+    // Create a diff to show changes
+    const originalContent = await fs.readFile(filePath, "utf-8");
+    const diff = createUnifiedDiff(originalContent, content, filePath);
+    // Write the changes if not a dry run
+    if (!dryRun) {
+        await fs.writeFile(filePath, content);
+    }
+    return diff;
+}
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1 @@
+export * from "./path.js";

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+// Re-export all utility functions
+export * from "./path.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,cAAc,WAAW,CAAC"}

package/dist/utils/path.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Normalizes a path consistently
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * Expands the home directory in a path (e.g., ~/docs -> /home/user/docs)
+ */
+export declare function expandHome(p: string): string;
+/**
+ * Validates that a path is within allowed directories
+ * @param p The path to validate
+ * @param allowedDirectories Array of allowed directory paths
+ * @returns The normalized path if valid
+ * @throws Error if path is not within allowed directories
+ */
+export declare function validatePath(p: string, allowedDirectories: string[]): Promise<string>;

package/dist/utils/path.js

@@ -0,0 +1,70 @@
+import path from "path";
+import os from "os";
+import fs from "fs/promises";
+/**
+ * Normalizes a path consistently
+ */
+export function normalizePath(p) {
+    return path.normalize(p);
+}
+/**
+ * Expands the home directory in a path (e.g., ~/docs -> /home/user/docs)
+ */
+export function expandHome(p) {
+    if (!p)
+        return p;
+    if (p === "~" || p.startsWith("~/")) {
+        return p.replace(/^~/, os.homedir());
+    }
+    return p;
+}
+/**
+ * Validates that a path is within allowed directories
+ * @param p The path to validate
+ * @param allowedDirectories Array of allowed directory paths
+ * @returns The normalized path if valid
+ * @throws Error if path is not within allowed directories
+ */
+export async function validatePath(p, allowedDirectories) {
+    // Handle empty path by using the first allowed directory
+    if (!p) {
+        return allowedDirectories[0];
+    }
+    // Resolve the path
+    const normalizedPath = normalizePath(path.resolve(expandHome(p)));
+    // Check if the path is exactly an allowed directory
+    if (allowedDirectories.some((dir) => dir === normalizedPath)) {
+        return normalizedPath;
+    }
+    // Check if the path is within any of the allowed directories
+    const isAllowed = allowedDirectories.some((dir) => {
+        const relativePath = path.relative(dir, normalizedPath);
+        return (relativePath !== "" &&
+            !relativePath.startsWith("..") &&
+            !path.isAbsolute(relativePath));
+    });
+    if (!isAllowed) {
+        // Try to resolve the path relative to the allowed directories
+        for (const dir of allowedDirectories) {
+            const resolvedPath = path.resolve(dir, p);
+            try {
+                // Check if the path exists
+                await fs.access(resolvedPath);
+                // If it exists, check if it's within an allowed directory
+                const relativePath = path.relative(dir, resolvedPath);
+                if (relativePath !== "" &&
+                    !relativePath.startsWith("..") &&
+                    !path.isAbsolute(relativePath)) {
+                    return resolvedPath;
+                }
+            }
+            catch (error) {
+                // Path doesn't exist, continue to the next directory
+            }
+        }
+        // If we get here, the path is not allowed
+        throw new Error(`Access denied: ${p} is not within allowed directories. Allowed directories: ${allowedDirectories.join(", ")}`);
+    }
+    return normalizedPath;
+}
+//# sourceMappingURL=path.js.map

package/dist/utils/path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../src/utils/path.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,MAAM,aAAa,CAAC;AAE7B;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,CAAS;IACrC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,CAAS,EACT,kBAA4B;IAE5B,yDAAyD;IACzD,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,mBAAmB;IACnB,MAAM,cAAc,GAAG,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElE,oDAAoD;IACpD,IAAI,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,cAAc,CAAC,EAAE,CAAC;QAC7D,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,6DAA6D;IAC7D,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACxD,OAAO,CACL,YAAY,KAAK,EAAE;YACnB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC;YAC9B,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,8DAA8D;QAC9D,KAAK,MAAM,GAAG,IAAI,kBAAkB,EAAE,CAAC;YACrC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC;gBACH,2BAA2B;gBAC3B,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAC9B,0DAA0D;gBAC1D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;gBACtD,IACE,YAAY,KAAK,EAAE;oBACnB,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,CAAC;oBAC9B,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAC9B,CAAC;oBACD,OAAO,YAAY,CAAC;gBACtB,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,qDAAqD;YACvD,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,MAAM,IAAI,KAAK,CACb,kBAAkB,CAAC,4DAA4D,kBAAkB,CAAC,IAAI,CACpG,IAAI,CACL,EAAE,CACJ,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-docs-service",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "MCP Documentation Service - A Model Context Protocol implementation for documentation management",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,8 @@
     "lint": "eslint src --ext .ts",
     "test": "vitest run",
     "test:watch": "vitest",
-    "prepublishOnly": "npm run build"
+    "prepublishOnly": "npm run build",
+    "prepare-publish": "node scripts/prepare-publish.js"
   },
   "keywords": [
     "mcp",