@pocketcoder/host 0.0.2

package/dist/services/filesystem.js

@@ -0,0 +1,249 @@
+/**
+ * Filesystem service for listing, reading, and writing files within a project.
+ */
+import { readdir, readFile as fsReadFile, writeFile as fsWriteFile, stat, realpath, mkdir, } from "node:fs/promises";
+import { join, resolve, dirname } from "node:path";
+import { MAX_FILE_SIZE, MAX_FS_ENTRIES, MAX_WRITE_SIZE } from "@pocketcoder/shared/constants";
+/**
+ * Validates that a resolved path is within the project root.
+ * Prevents path traversal and symlink escapes.
+ */
+export async function validatePathWithinProject(projectPath, relativePath) {
+    const resolvedProject = await realpath(projectPath);
+    const targetPath = resolve(resolvedProject, relativePath);
+    // First check normalized path to detect traversal attempts BEFORE attempting realpath
+    // This catches cases like "../../../etc/passwd" where the file doesn't exist
+    const normalized = resolve(targetPath);
+    if (!normalized.startsWith(resolvedProject + "/") && normalized !== resolvedProject) {
+        throw new PathEscapeError("Path escapes project directory");
+    }
+    // Then resolve symlinks and verify the real path is still within the project
+    const resolvedTarget = await realpath(targetPath);
+    if (!resolvedTarget.startsWith(resolvedProject + "/") && resolvedTarget !== resolvedProject) {
+        throw new PathEscapeError("Path escapes project directory");
+    }
+    return resolvedTarget;
+}
+/**
+ * Validates a path without requiring the target to exist (for new files).
+ * Checks the parent directory is within the project root.
+ */
+export async function validateParentWithinProject(projectPath, relativePath) {
+    const resolvedProject = await realpath(projectPath);
+    const targetPath = resolve(resolvedProject, relativePath);
+    // Normalize to remove .. segments
+    const normalized = resolve(targetPath);
+    if (!normalized.startsWith(resolvedProject + "/") && normalized !== resolvedProject) {
+        throw new PathEscapeError("Path escapes project directory");
+    }
+    return normalized;
+}
+export class PathEscapeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "PathEscapeError";
+    }
+}
+export class FileTooLargeError extends Error {
+    size;
+    limit;
+    constructor(size, limit) {
+        super(`File exceeds ${limit} byte limit (${size} bytes)`);
+        this.name = "FileTooLargeError";
+        this.size = size;
+        this.limit = limit;
+    }
+}
+export class UnsupportedFormatError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "UnsupportedFormatError";
+    }
+}
+export class FileNotFoundError extends Error {
+    constructor(filePath) {
+        super(`File not found: ${filePath}`);
+        this.name = "FileNotFoundError";
+    }
+}
+export class ContentTooLargeError extends Error {
+    size;
+    limit;
+    constructor(size, limit) {
+        super(`Content exceeds ${limit} byte limit (${size} bytes)`);
+        this.name = "ContentTooLargeError";
+        this.size = size;
+        this.limit = limit;
+    }
+}
+/**
+ * Write a file within a project directory.
+ * Creates parent directories if createDirs is true.
+ * Returns path, size, and mtime.
+ * Throws ContentTooLargeError if content exceeds MAX_WRITE_SIZE (1MB).
+ * Throws PathEscapeError if path is outside project root.
+ */
+export async function writeFile(projectPath, relativePath, content, createDirs = true) {
+    const contentBytes = Buffer.byteLength(content, "utf-8");
+    if (contentBytes > MAX_WRITE_SIZE) {
+        throw new ContentTooLargeError(contentBytes, MAX_WRITE_SIZE);
+    }
+    const resolvedPath = await validateParentWithinProject(projectPath, relativePath);
+    if (createDirs) {
+        await mkdir(dirname(resolvedPath), { recursive: true });
+    }
+    await fsWriteFile(resolvedPath, content, "utf-8");
+    const fileStats = await stat(resolvedPath);
+    // After writing, verify the real path is still within the project
+    // (guards against TOCTOU with symlinks created between validation and write)
+    const realResolved = await realpath(resolvedPath);
+    const realProject = await realpath(projectPath);
+    if (!realResolved.startsWith(realProject + "/") && realResolved !== realProject) {
+        throw new PathEscapeError("Path escapes project directory");
+    }
+    return {
+        path: relativePath,
+        size: fileStats.size,
+        mtime: fileStats.mtime.toISOString(),
+    };
+}
+/**
+ * Read a file within a project directory.
+ * Returns content, encoding, size, and mtime.
+ * Throws FileTooLargeError if file exceeds MAX_FILE_SIZE (10MB).
+ * Throws UnsupportedFormatError if file is binary.
+ * Throws FileNotFoundError if file does not exist.
+ * Throws PathEscapeError if path is outside project root.
+ */
+export async function readFile(projectPath, relativePath) {
+    let resolvedPath;
+    try {
+        resolvedPath = await validatePathWithinProject(projectPath, relativePath);
+    }
+    catch (err) {
+        // realpath throws ENOENT if the file doesn't exist
+        if (err instanceof PathEscapeError)
+            throw err;
+        const code = err.code;
+        if (code === "ENOENT")
+            throw new FileNotFoundError(relativePath);
+        throw err;
+    }
+    let fileStats;
+    try {
+        fileStats = await stat(resolvedPath);
+    }
+    catch {
+        throw new FileNotFoundError(relativePath);
+    }
+    if (!fileStats.isFile()) {
+        throw new FileNotFoundError(relativePath);
+    }
+    if (fileStats.size > MAX_FILE_SIZE) {
+        throw new FileTooLargeError(fileStats.size, MAX_FILE_SIZE);
+    }
+    const buffer = await fsReadFile(resolvedPath);
+    // Detect binary content by checking for null bytes in the first 8KB
+    if (isBinary(buffer)) {
+        throw new UnsupportedFormatError("Binary file format not supported");
+    }
+    return {
+        content: buffer.toString("utf-8"),
+        encoding: "utf-8",
+        size: fileStats.size,
+        mtime: fileStats.mtime.toISOString(),
+    };
+}
+/**
+ * Check if a buffer contains binary data by looking for null bytes.
+ */
+function isBinary(buffer) {
+    const checkLength = Math.min(buffer.length, 8192);
+    for (let i = 0; i < checkLength; i++) {
+        if (buffer[i] === 0) {
+            return true;
+        }
+    }
+    return false;
+}
+/**
+ * List directory contents at a given path within a project.
+ * Returns FsNode[] with lazy loading (depth parameter).
+ */
+export async function listDirectory(projectPath, relativePath, depth = 1) {
+    const resolvedProject = await realpath(projectPath);
+    const targetPath = relativePath === ""
+        ? resolvedProject
+        : await validatePathWithinProject(projectPath, relativePath);
+    const children = [];
+    let truncated = false;
+    await collectEntries(resolvedProject, targetPath, relativePath, depth, children, {
+        truncated: false,
+        count: 0,
+    });
+    if (children.length > MAX_FS_ENTRIES) {
+        truncated = true;
+        children.length = MAX_FS_ENTRIES;
+    }
+    return { children, truncated };
+}
+async function collectEntries(projectRoot, dirPath, relativeDir, depth, result, state) {
+    if (depth <= 0 || state.count >= MAX_FS_ENTRIES)
+        return;
+    let entries;
+    try {
+        entries = await readdir(dirPath, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    // Sort: directories first, then alphabetically
+    entries.sort((a, b) => {
+        const aIsDir = a.isDirectory() ? 0 : 1;
+        const bIsDir = b.isDirectory() ? 0 : 1;
+        if (aIsDir !== bIsDir)
+            return aIsDir - bIsDir;
+        return a.name.localeCompare(b.name);
+    });
+    for (const entry of entries) {
+        if (state.count >= MAX_FS_ENTRIES) {
+            state.truncated = true;
+            return;
+        }
+        const entryPath = join(dirPath, entry.name);
+        const entryRelative = relativeDir === "" ? entry.name : `${relativeDir}/${entry.name}`;
+        const node = {
+            name: entry.name,
+            path: entryRelative,
+            type: entry.isDirectory() ? "dir" : "file",
+        };
+        if (!entry.isDirectory()) {
+            try {
+                const stats = await stat(entryPath);
+                node.size = stats.size;
+                node.mtime = stats.mtime.toISOString();
+            }
+            catch {
+                // Skip files we can't stat
+            }
+        }
+        else {
+            try {
+                const stats = await stat(entryPath);
+                node.mtime = stats.mtime.toISOString();
+            }
+            catch {
+                // Skip directories we can't stat
+            }
+        }
+        result.push(node);
+        state.count++;
+        // Recurse into subdirectories if depth > 1
+        if (entry.isDirectory() && depth > 1) {
+            node.children = [];
+            node.expanded = true;
+            await collectEntries(projectRoot, entryPath, entryRelative, depth - 1, node.children, state);
+        }
+    }
+}
+//# sourceMappingURL=filesystem.js.map

package/dist/services/filesystem.js.map

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

package/dist/services/git.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Git service for executing git commands within project directories.
+ * Parses git porcelain output into structured data.
+ */
+import type { GitBranch, GitFileStatus, Message } from "@pocketcoder/shared";
+export declare class GitNotInitializedError extends Error {
+    constructor(path: string);
+}
+export interface GitStatusResult {
+    branch: string;
+    clean: boolean;
+    staged: GitFileStatus[];
+    unstaged: GitFileStatus[];
+    conflicts: GitFileStatus[];
+}
+/**
+ * Get the git status for a project directory.
+ * Uses `git status --porcelain=v1 --branch` for structured output.
+ */
+export declare function getGitStatus(projectPath: string): Promise<GitStatusResult>;
+export interface GitBranchCreateResult {
+    name: string;
+    created: boolean;
+}
+/**
+ * Create a new git branch.
+ * @param projectPath The path to the project
+ * @param name The branch name to create
+ * @param startPoint The commit/ref to base the branch on (default: HEAD)
+ */
+export declare function createGitBranch(projectPath: string, name: string, startPoint?: string): Promise<GitBranchCreateResult>;
+export interface GitCheckoutResult {
+    ref: string;
+    switched: boolean;
+}
+/**
+ * Checkout a git ref (branch, tag, or commit).
+ */
+export declare function checkoutGitRef(projectPath: string, ref: string): Promise<GitCheckoutResult>;
+/**
+ * Stage files in the git index.
+ * @param projectPath The path to the project
+ * @param paths Files to stage (use ['.'] to stage all)
+ * @returns List of staged file paths
+ */
+export declare function stageFiles(projectPath: string, paths: string[]): Promise<string[]>;
+/**
+ * Unstage files from the git index.
+ * @param projectPath The path to the project
+ * @param paths Files to unstage (use ['.'] to unstage all)
+ * @returns List of unstaged file paths
+ */
+export declare function unstageFiles(projectPath: string, paths: string[]): Promise<string[]>;
+export interface GitCommitResult {
+    sha: string;
+    message: string;
+}
+/**
+ * Create a git commit with the given message.
+ * @param projectPath The path to the project
+ * @param message The commit message
+ * @returns The commit sha and message
+ */
+export declare function createGitCommit(projectPath: string, message: string): Promise<GitCommitResult>;
+export interface GitPushResult {
+    remote: string;
+    branch: string;
+    pushed: boolean;
+}
+/**
+ * Push commits to a remote repository via PTY for credential prompt support.
+ * @param projectPath The path to the project
+ * @param remote Remote name (default: origin)
+ * @param branch Branch to push (default: current branch)
+ * @param force Whether to force push (default: false)
+ * @param requestId Request ID for credential prompt correlation
+ * @param send Function to send messages to the client (for credential prompts)
+ */
+export declare function gitPush(projectPath: string, remote?: string, branch?: string, force?: boolean, requestId?: string, send?: (message: Message) => void): Promise<GitPushResult>;
+/**
+ * Run a git command via PTY with credential prompt handling.
+ * Used for push and pull operations that may require authentication.
+ */
+export declare function runGitViaPty(projectPath: string, args: string[], branch: string, remote: string, requestId?: string, send?: (message: Message) => void): Promise<GitPushResult>;
+export interface GitPullResult {
+    remote: string;
+    branch: string;
+    pulled: boolean;
+    conflicts?: string[];
+}
+/**
+ * Pull from a remote repository via PTY for credential prompt support.
+ * Detects merge conflicts and returns conflict file list.
+ * @param projectPath The path to the project
+ * @param remote Remote name (default: origin)
+ * @param branch Branch to pull (default: current branch)
+ * @param requestId Request ID for credential prompt correlation
+ * @param send Function to send messages to the client (for credential prompts)
+ */
+export declare function gitPull(projectPath: string, remote?: string, branch?: string, requestId?: string, send?: (message: Message) => void): Promise<GitPullResult>;
+export interface GitFileBaseResult {
+    path: string;
+    ref: string;
+    content: string | null;
+}
+/**
+ * Get the content of a file at a given git ref (default HEAD).
+ * Returns null content for files that don't exist at the ref (new files).
+ */
+export declare function getFileAtRef(projectPath: string, filePath: string, ref?: string): Promise<GitFileBaseResult>;
+export interface GitBranchesResult {
+    current: string;
+    branches: GitBranch[];
+}
+/**
+ * Get the list of local branches with remote tracking info.
+ * Uses `git branch -vv --no-color` for structured output.
+ */
+export declare function getGitBranches(projectPath: string): Promise<GitBranchesResult>;
+export interface GitDiffFileResult {
+    path: string;
+    status: string;
+    additions: number;
+    deletions: number;
+    diff: string;
+}
+export interface GitDiffResult {
+    files: GitDiffFileResult[];
+}
+/**
+ * Get diff for files in a project directory.
+ * @param projectPath The path to the project
+ * @param path Optional specific file path to diff
+ * @param staged Whether to diff staged changes (--cached)
+ */
+export declare function getDiff(projectPath: string, path?: string, staged?: boolean): Promise<GitDiffResult>;
+export interface GitDiscardResult {
+    discarded: number;
+}
+/**
+ * Discard uncommitted changes.
+ * For tracked files: uses `git checkout HEAD -- <paths>`.
+ * If all=true: also removes untracked files with `git clean -fd`.
+ * @param projectPath The path to the project
+ * @param paths Specific files to discard (optional)
+ * @param all Whether to discard all changes including untracked files
+ */
+export declare function discardChanges(projectPath: string, paths?: string[], all?: boolean): Promise<GitDiscardResult>;
+//# sourceMappingURL=git.d.ts.map

package/dist/services/git.d.ts.map

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