@youdie006/prodex 0.2.0

package/dist/repo.js

@@ -0,0 +1,386 @@
+import { lstat, realpath } from "node:fs/promises";
+import path from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { readVerifiedUtf8File } from "./safe-file.js";
+const execFileAsync = promisify(execFile);
+const MAX_REPO_READ_BYTES = 1_000_000;
+const MAX_REPO_SEARCH_MATCHES = 100;
+const MAX_GLOB_BRACE_EXPANSIONS = 64;
+const MAX_GLOB_BRACE_DEPTH = 8;
+const ENV_LIKE_GLOB_PROBES = [".env", ".envrc", ".env.local", ".envoy"];
+export function assertRepoRelativePath(repoPath) {
+    if (!repoPath || repoPath.trim() === "") {
+        throw new Error("Path must be a non-empty repo-relative path");
+    }
+    if (path.isAbsolute(repoPath)) {
+        throw new Error("Path must be repo-relative, not absolute");
+    }
+    const normalized = path.posix.normalize(repoPath.replaceAll("\\", "/"));
+    if (normalized === "." || normalized.startsWith("../") || normalized === "..") {
+        throw new Error("Path must stay inside the repo-relative root");
+    }
+    assertNotSensitiveRepoPath(normalized);
+}
+export function resolveRepoPath(root, repoPath) {
+    assertRepoRelativePath(repoPath);
+    const resolved = path.resolve(root, repoPath);
+    const relative = path.relative(root, resolved);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new Error(`Path ${repoPath} escapes the repository root`);
+    }
+    return resolved;
+}
+export async function readRepoFile(root, repoPath, options = {}) {
+    const resolved = resolveRepoPath(root, repoPath);
+    await assertResolvedRepoPathAllowed(root, resolved, repoPath);
+    const text = await readVerifiedUtf8File(resolved, () => assertResolvedRepoPathAllowed(root, resolved, repoPath), {
+        maxBytes: MAX_REPO_READ_BYTES
+    }).catch((error) => {
+        if (error instanceof Error && /too large/.test(error.message)) {
+            throw new Error(`Path ${repoPath} is too large to read through repo tools`);
+        }
+        throw error;
+    });
+    const lines = text.replace(/\r\n/g, "\n").split("\n");
+    if (lines.at(-1) === "")
+        lines.pop();
+    const startLine = Math.max(1, options.startLine ?? 1);
+    const maxLines = Math.max(1, Math.min(options.maxLines ?? 200, 500));
+    if (startLine > Math.max(1, lines.length)) {
+        throw new Error(`start_line ${startLine} is beyond the end of ${repoPath} (${lines.length} ${lines.length === 1 ? "line" : "lines"})`);
+    }
+    const selected = lines.slice(startLine - 1, startLine - 1 + maxLines);
+    const endLine = selected.length > 0 ? startLine + selected.length - 1 : startLine;
+    return {
+        path: repoPath,
+        start_line: startLine,
+        end_line: endLine,
+        total_lines: lines.length,
+        content: selected.join("\n")
+    };
+}
+export async function searchRepo(root, query, glob) {
+    return (await searchRepoWithMetadata(root, query, glob)).matches;
+}
+export async function searchRepoWithMetadata(root, query, glob) {
+    if (!query.trim()) {
+        throw new Error("Search query must not be empty");
+    }
+    if (glob) {
+        assertRepoRelativeGlob(glob);
+    }
+    const args = [
+        "--no-config",
+        "--no-follow",
+        "--json",
+        ...(glob ? ["--glob", glob] : []),
+        "--glob",
+        "!.bridge/**",
+        "--glob",
+        "!**/.bridge/**",
+        "--glob",
+        "!.git/**",
+        "--glob",
+        "!**/.git/**",
+        "--glob",
+        "!.env*",
+        "--glob",
+        "!**/.env*",
+        "--glob",
+        "!node_modules/**",
+        "--glob",
+        "!**/node_modules/**",
+        "--glob",
+        "!dist/**",
+        "--glob",
+        "!**/dist/**",
+        "-e",
+        query
+    ];
+    args.push(".");
+    try {
+        const { stdout } = await execFileAsync("rg", args, {
+            cwd: root,
+            timeout: 10_000,
+            maxBuffer: 1024 * 1024
+        });
+        const parsedMatches = stdout
+            .split("\n")
+            .filter(Boolean)
+            .map(parseRipgrepJsonMatch)
+            .filter((match) => match !== undefined);
+        const allowedMatches = [];
+        let truncated = false;
+        for (const match of parsedMatches) {
+            if (await isAllowedRepoSearchResult(root, match.path)) {
+                if (allowedMatches.length >= MAX_REPO_SEARCH_MATCHES) {
+                    truncated = true;
+                    break;
+                }
+                allowedMatches.push(match);
+            }
+        }
+        return { matches: allowedMatches, truncated, limit: MAX_REPO_SEARCH_MATCHES };
+    }
+    catch (error) {
+        const maybe = error;
+        if (maybe.code === "ENOENT") {
+            throw new Error("ripgrep (rg) is required on PATH for repo_search");
+        }
+        if (isSearchOutputTooLarge(error)) {
+            throw new Error("repo_search returned too many matches; narrow the query or glob and try again");
+        }
+        if (maybe.code === 1)
+            return { matches: [], truncated: false, limit: MAX_REPO_SEARCH_MATCHES };
+        throw error;
+    }
+}
+function parseRipgrepJsonMatch(line) {
+    let event;
+    try {
+        event = JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    }
+    if (!isRipgrepJsonMatch(event))
+        return undefined;
+    return {
+        path: event.data.path.text.replace(/^\.\//, ""),
+        line: event.data.line_number,
+        text: stripOneTrailingLineEnding(event.data.lines.text)
+    };
+}
+function isRipgrepJsonMatch(value) {
+    if (!isRecord(value) || value.type !== "match" || !isRecord(value.data))
+        return false;
+    const { path: matchPath, line_number: lineNumber, lines } = value.data;
+    return (isRecord(matchPath) &&
+        typeof matchPath.text === "string" &&
+        typeof lineNumber === "number" &&
+        Number.isFinite(lineNumber) &&
+        isRecord(lines) &&
+        typeof lines.text === "string");
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function isSearchOutputTooLarge(error) {
+    if (typeof error !== "object" || error === null)
+        return false;
+    const code = error.code;
+    const message = error.message;
+    return code === "ERR_CHILD_PROCESS_STDIO_MAXBUFFER" || (typeof message === "string" && /maxBuffer/i.test(message));
+}
+function stripOneTrailingLineEnding(value) {
+    return value.replace(/\r?\n$/, "");
+}
+function assertNotSensitiveRepoPath(normalizedPath) {
+    const segments = normalizedPath.split("/");
+    if (segments.some(isEnvLikeSegment)) {
+        throw new Error(`Path ${normalizedPath} is sensitive and cannot be read through repo tools`);
+    }
+    if (segments.some(isSensitiveRepoSegment)) {
+        throw new Error(`Path ${normalizedPath} is sensitive and cannot be read through repo tools`);
+    }
+}
+function assertRepoRelativeGlob(glob) {
+    const normalized = path.posix.normalize(glob.replaceAll("\\", "/").replace(/^!/, ""));
+    if (normalized.startsWith("../") || normalized === ".." || path.isAbsolute(normalized)) {
+        throw new Error("Glob must stay inside the repo-relative root");
+    }
+    assertNoSensitiveGlobSegment(normalized);
+    const concretePrefix = normalized.replace(/[*?[{].*$/, "").replace(/\/+$/, "");
+    if (concretePrefix) {
+        assertNotSensitiveRepoPath(concretePrefix);
+    }
+}
+function assertNoSensitiveGlobSegment(normalizedGlob) {
+    const segments = normalizedGlob.split("/").filter(Boolean);
+    if (segments.some((segment) => isSensitiveRepoSegment(segment) ||
+        isEnvLikeGlobSegment(segment))) {
+        throw new Error(`Glob ${normalizedGlob} is sensitive and cannot be used through repo tools`);
+    }
+}
+async function isAllowedRepoSearchResult(root, repoPath) {
+    try {
+        const normalized = path.posix.normalize(repoPath.replaceAll("\\", "/"));
+        const resolved = resolveRepoPath(root, normalized);
+        await assertResolvedRepoPathAllowed(root, resolved, normalized);
+        const stat = await lstat(resolved);
+        return stat.isFile() && !stat.isSymbolicLink() && stat.nlink <= 1;
+    }
+    catch {
+        return false;
+    }
+}
+function isSensitiveRepoSegment(segment) {
+    const folded = foldSensitiveSegment(segment);
+    return folded === ".bridge" || folded === ".git" || folded === "node_modules" || folded === "dist";
+}
+function isEnvLikeSegment(segment) {
+    return foldSensitiveSegment(segment).startsWith(".env");
+}
+function isEnvLikeGlobSegment(segment) {
+    const variants = expandBraceGlobSegment(segment);
+    if (variants === null)
+        return true;
+    return variants.some(isEnvLikeGlobVariant);
+}
+function isEnvLikeGlobVariant(segment) {
+    if (isBroadWildcardOnlyGlobVariant(segment))
+        return false;
+    const folded = foldSensitiveSegment(segment);
+    return ENV_LIKE_GLOB_PROBES.some((probe) => globSegmentMatches(folded, probe));
+}
+function isBroadWildcardOnlyGlobVariant(segment) {
+    return /^[*?]+$/.test(segment);
+}
+function globSegmentMatches(pattern, value) {
+    const regexSource = globSegmentToRegexSource(pattern);
+    if (regexSource === null)
+        return true;
+    try {
+        return new RegExp(`^${regexSource}$`, "u").test(value);
+    }
+    catch {
+        return true;
+    }
+}
+function globSegmentToRegexSource(pattern) {
+    let source = "";
+    for (let index = 0; index < pattern.length; index += 1) {
+        const char = pattern[index];
+        if (char === "*") {
+            source += ".*";
+            continue;
+        }
+        if (char === "?") {
+            source += ".";
+            continue;
+        }
+        if (char === "[") {
+            const charClass = readGlobCharClass(pattern, index);
+            if (charClass === null)
+                return null;
+            source += charClass.source;
+            index = charClass.end;
+            continue;
+        }
+        source += escapeRegexLiteral(char);
+    }
+    return source;
+}
+function readGlobCharClass(pattern, start) {
+    let end = start + 1;
+    if (pattern[end] === "]")
+        end += 1;
+    while (end < pattern.length && pattern[end] !== "]") {
+        end += 1;
+    }
+    if (end >= pattern.length)
+        return null;
+    let content = pattern.slice(start + 1, end);
+    let negated = "";
+    if (content.startsWith("!") || content.startsWith("^")) {
+        negated = "^";
+        content = content.slice(1);
+    }
+    if (!content)
+        return null;
+    const escaped = content.replaceAll("\\", "\\\\").replaceAll("]", "\\]");
+    return { source: `[${negated}${escaped}]`, end };
+}
+function escapeRegexLiteral(char) {
+    return char.replace(/[\\^$.*+?()[\]{}|]/g, "\\$&");
+}
+function foldSensitiveSegment(segment) {
+    return segment.toLowerCase();
+}
+function expandBraceGlobSegment(segment, depth = 0) {
+    if (depth > MAX_GLOB_BRACE_DEPTH)
+        return null;
+    const open = segment.indexOf("{");
+    if (open === -1)
+        return [segment];
+    const close = findMatchingBrace(segment, open);
+    if (close === -1)
+        return [segment];
+    const before = segment.slice(0, open);
+    const after = segment.slice(close + 1);
+    const alternatives = splitBraceAlternatives(segment.slice(open + 1, close));
+    const variants = [];
+    for (const alternative of alternatives) {
+        const expanded = expandBraceGlobSegment(`${before}${alternative}${after}`, depth + 1);
+        if (expanded === null)
+            return null;
+        variants.push(...expanded);
+        if (variants.length > MAX_GLOB_BRACE_EXPANSIONS)
+            return null;
+    }
+    return variants;
+}
+function findMatchingBrace(input, open) {
+    let depth = 0;
+    for (let index = open; index < input.length; index += 1) {
+        const char = input[index];
+        if (char === "{")
+            depth += 1;
+        if (char === "}") {
+            depth -= 1;
+            if (depth === 0)
+                return index;
+        }
+    }
+    return -1;
+}
+function splitBraceAlternatives(input) {
+    const alternatives = [];
+    let depth = 0;
+    let current = "";
+    for (const char of input) {
+        if (char === "{") {
+            depth += 1;
+            current += char;
+            continue;
+        }
+        if (char === "}") {
+            depth = Math.max(0, depth - 1);
+            current += char;
+            continue;
+        }
+        if (char === "," && depth === 0) {
+            alternatives.push(current);
+            current = "";
+            continue;
+        }
+        current += char;
+    }
+    alternatives.push(current);
+    return alternatives;
+}
+export async function assertResolvedRepoPathAllowed(root, resolved, repoPath) {
+    const realRoot = await realpath(root);
+    let realTarget;
+    try {
+        realTarget = await realpath(resolved);
+    }
+    catch (error) {
+        if (isErrorCode(error, "ENOENT")) {
+            throw new Error(`Path ${repoPath} was not found in the repo`);
+        }
+        throw error;
+    }
+    const relative = path.relative(realRoot, realTarget);
+    if (relative.startsWith("..") || path.isAbsolute(relative)) {
+        throw new Error(`Path ${repoPath} escapes the repository root after resolving symlinks`);
+    }
+    if (relative) {
+        assertNotSensitiveRepoPath(path.posix.normalize(relative.split(path.sep).join("/")));
+    }
+}
+function isErrorCode(error, code) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === code;
+}
+//# sourceMappingURL=repo.js.map

package/dist/repo.js.map

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

package/dist/safe-file.d.ts

@@ -0,0 +1,25 @@
+type SafeFileOperation = "read" | "write";
+export type SafeFileTestHooks = {
+    afterWrite?: (filePath: string, operation: SafeFileOperation) => Promise<void> | void;
+    beforeChmod?: (filePath: string, operation: SafeFileOperation) => Promise<void> | void;
+    beforeOpen?: (filePath: string, operation: SafeFileOperation) => Promise<void> | void;
+    beforeRename?: (filePath: string, tmpPath: string) => Promise<void> | void;
+    beforeReplace?: (filePath: string) => Promise<void> | void;
+    beforeWrite?: (filePath: string, operation: SafeFileOperation) => Promise<void> | void;
+};
+export declare function setSafeFileTestHooks(hooks: SafeFileTestHooks): void;
+export declare function readVerifiedUtf8File(filePath: string, validate: () => Promise<void>, options?: {
+    maxBytes?: number;
+    mode?: number;
+}): Promise<string>;
+export declare function writeVerifiedUtf8File(filePath: string, content: string, validate: () => Promise<void>, options?: {
+    create?: boolean;
+    exclusive?: boolean;
+    maxBytes?: number;
+    mode?: number;
+}): Promise<void>;
+export declare function replaceVerifiedUtf8File(filePath: string, content: string, validate: () => Promise<void>, verifyCurrentContent: (currentContent: string) => Promise<void> | void, options?: {
+    maxBytes?: number;
+    mode?: number;
+}): Promise<void>;
+export {};