mcp-docs-service 0.3.5 → 0.3.7

package/dist/utils/file.d.ts

@@ -1,24 +0,0 @@
-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

@@ -1,94 +0,0 @@
-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

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

package/dist/utils/index.d.ts

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

package/dist/utils/index.js

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

package/dist/utils/index.js.map

@@ -1 +0,0 @@
-{"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

@@ -1,16 +0,0 @@
-/**
- * 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

@@ -1,70 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}