spck 0.3.1

package/dist/services/GitService.d.ts

@@ -0,0 +1,243 @@
+/**
+ * Git service - executes command-line git operations
+ */
+import { AuthenticatedSocket } from '../types.js';
+export declare class GitService {
+    private rootPath;
+    private submoduleCache;
+    private static SUBMODULE_CACHE_TTL;
+    private _hasCurl;
+    constructor(rootPath: string);
+    /**
+     * Check if curl is available on the system (cached)
+     */
+    private hasCurl;
+    /**
+     * Get submodules for a directory, using a short-lived cache to avoid
+     * repeated git submodule status calls during bulk operations.
+     */
+    private getCachedSubmodules;
+    /**
+     * Resolve the effective git working directory.
+     * When gitRoot is provided (submodule path), resolve it relative to dir.
+     */
+    private resolveGitCwd;
+    /**
+     * Handle git RPC methods
+     */
+    handle(method: string, params: any, socket: AuthenticatedSocket): Promise<any>;
+    /**
+     * Validate git directory
+     */
+    private validateGitDir;
+    /**
+     * Sanitize filename to prevent command injection
+     * Rejects filenames that could be interpreted as git flags or contain control characters
+     */
+    private sanitizeFilename;
+    /**
+     * Execute git command
+     */
+    private execGit;
+    /**
+     * Read commit object
+     */
+    private readCommit;
+    /**
+     * Parse commit object
+     */
+    private parseCommit;
+    /**
+     * Parse git identity (author/committer)
+     */
+    private parseIdentity;
+    /**
+     * Read git object
+     */
+    private readObject;
+    /**
+     * Get HEAD tree oid
+     */
+    private getHeadTree;
+    /**
+     * Get object ID at path in tree or index stage
+     * @param dir - Git repository directory
+     * @param params.path - File path to lookup
+     * @param params.tree - Tree object ID to search in (e.g., HEAD tree)
+     * @param params.stage - Index stage number (0=normal, 1=ancestor, 2=ours, 3=theirs during merge)
+     */
+    private getOidAtPath;
+    /**
+     * List files in ref
+     */
+    private listFiles;
+    /**
+     * Resolve ref to oid
+     */
+    private resolveRef;
+    /**
+     * Get current branch
+     */
+    private currentBranch;
+    /**
+     * Get commit history
+     */
+    private log;
+    /**
+     * Get working directory status
+     * Uses two git commands:
+     * 1. With -uall for detailed untracked files
+     * 2. With --ignored (no -uall) for rolled-up ignored directories
+     */
+    private status;
+    /**
+     * Parse git status output into status array
+     */
+    private parseGitStatus;
+    /**
+     * Get status counts (conflicts, changes, fileCount)
+     */
+    private statusCounts;
+    /**
+     * Stage files
+     */
+    private add;
+    /**
+     * Remove files from index (git rm --cached)
+     */
+    private remove;
+    /**
+     * Reset file(s) in index to match ref (git reset <ref> -- <filepath(s)>)
+     */
+    private resetIndex;
+    /**
+     * Create commit
+     */
+    private commit;
+    /**
+     * Allowed git config key patterns.
+     * Only these keys can be read or written via the RPC interface
+     * to prevent injection of dangerous config like core.sshCommand.
+     */
+    private static ALLOWED_CONFIG_KEYS;
+    /**
+     * Allowed git config key prefixes for dynamic keys (e.g. remote.origin.url)
+     */
+    private static ALLOWED_CONFIG_PREFIXES;
+    /**
+     * Validate that a git config key is allowed
+     */
+    private validateConfigKey;
+    /**
+     * Get config value
+     */
+    private getConfig;
+    /**
+     * Set config value
+     */
+    private setConfig;
+    /**
+     * List branches
+     * When remote is specified, returns branch names without the remote prefix
+     * to match isomorphic-git behavior (e.g. 'main' instead of 'origin/main')
+     */
+    private listBranches;
+    /**
+     * Validate a git ref (branch name, tag, or commit hash)
+     * Rejects refs that could be interpreted as flags
+     */
+    private sanitizeRef;
+    /**
+     * Checkout branch or commit
+     */
+    private checkout;
+    /**
+     * Initialize repository
+     */
+    private init;
+    /**
+     * List git remotes
+     */
+    private listRemotes;
+    /**
+     * Add git remote
+     */
+    private addRemote;
+    /**
+     * Delete git remote
+     */
+    private deleteRemote;
+    /**
+     * Clear git index (remove cached files)
+     */
+    private clearIndex;
+    /**
+     * Find which submodule a filepath belongs to (if any).
+     * Returns the submodule path and the filepath relative to the submodule root.
+     */
+    private findSubmoduleForPath;
+    /**
+     * Check if file is ignored by .gitignore
+     * Handles files inside submodules by running check-ignore from the submodule dir
+     */
+    private isIgnored;
+    /**
+     * Run git check-ignore for a list of paths in a single directory.
+     * Returns a Set of ignored paths.
+     */
+    private checkIgnorePaths;
+    /**
+     * Check multiple files if they are ignored by .gitignore
+     * Returns array of 1 (ignored) or 0 (not ignored) for bandwidth efficiency
+     * Handles files inside submodules by routing check-ignore to the submodule dir
+     */
+    private bulkIsIgnored;
+    /**
+     * Check if directory is a git repository
+     * Uses git rev-parse --is-inside-work-tree
+     */
+    private isInitialized;
+    /**
+     * List git submodules
+     * Uses git submodule status to detect submodules
+     * Note: always runs from the main repo dir (not gitCwd)
+     */
+    private listSubmodules;
+    /**
+     * Check if a file exists in HEAD commit
+     * Used to determine if a renamed file is truly new or was previously committed
+     */
+    private isFileInHead;
+    /**
+     * Get default author from git config
+     */
+    private getDefaultAuthor;
+    /**
+     * Push to remote
+     */
+    private push;
+    /**
+     * Pull from remote
+     */
+    private pull;
+    /**
+     * Fetch from remote
+     */
+    private fetch;
+    /**
+     * Clone a repository
+     */
+    private clone;
+    /**
+     * Set up an askpass mechanism for SSH/Git credential prompts.
+     * Creates a temporary HTTP server and shell script that SSH_ASKPASS/GIT_ASKPASS
+     * points to. When SSH or git needs a passphrase/password, it calls the script,
+     * which forwards the prompt to the client via requestAuth.
+     */
+    private setupAskpass;
+    /**
+     * Request authentication from client (server-to-client RPC)
+     */
+    private requestAuth;
+}
+//# sourceMappingURL=GitService.d.ts.map