@plusplusoneplusplus/coc 1.0.0

package/dist/server/repos/repo-routes.js

@@ -0,0 +1,321 @@
+"use strict";
+/**
+ * Repo Routes
+ *
+ * Registers all /api/repos/* REST endpoints for browsing
+ * registered workspace repositories.
+ *
+ * GET  /api/repos                      — list all repos
+ * GET  /api/repos/:repoId/tree         — list directory entries
+ * GET  /api/repos/:repoId/files        — list all files recursively
+ * GET  /api/repos/:repoId/search       — fuzzy file-path search
+ * GET  /api/repos/:repoId/blob         — read file content
+ * PUT  /api/repos/:repoId/blob         — write file content
+ * GET  /api/repos/:repoId/reveal       — reveal file/folder in OS file manager
+ *
+ * Cross-platform compatible (Linux/Mac/Windows).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRepoRoutes = registerRepoRoutes;
+const url = __importStar(require("url"));
+const path = __importStar(require("path"));
+const child_process = __importStar(require("child_process"));
+const router_1 = require("../router");
+const tree_service_1 = require("./tree-service");
+/**
+ * Extract and validate repoId + path from an incoming request.
+ * Returns undefined and sends an error response if validation fails.
+ */
+function parseRepoRequest(res, match, query, options) {
+    const repoId = decodeURIComponent(match[1]);
+    const rawPath = typeof query.path === 'string' ? query.path : undefined;
+    if (options.pathRequired && !rawPath) {
+        (0, router_1.send400)(res, 'Missing required query parameter: path');
+        return undefined;
+    }
+    const resolvedPath = rawPath ?? options.pathDefault ?? '.';
+    if (resolvedPath.split('/').includes('..') || resolvedPath.split('\\').includes('..')) {
+        (0, router_1.send400)(res, 'Invalid path: directory traversal not allowed');
+        return undefined;
+    }
+    return { repoId, path: resolvedPath };
+}
+// ============================================================================
+// Registration
+// ============================================================================
+/**
+ * Register all repo API routes on the given route table.
+ * Mutates the `routes` array in-place.
+ *
+ * @param routes  - Shared route table
+ * @param dataDir - CoC data directory (e.g. ~/.coc)
+ * @param service - Shared RepoTreeService instance (singleton)
+ */
+function registerRepoRoutes(routes, dataDir, service) {
+    const svc = service ?? new tree_service_1.RepoTreeService(dataDir);
+    // -- List repos ----------------------------------------------------------
+    routes.push({
+        method: 'GET',
+        pattern: '/api/repos',
+        handler: async (_req, res) => {
+            try {
+                const repos = await svc.listRepos();
+                (0, router_1.sendJson)(res, repos);
+            }
+            catch (err) {
+                (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+            }
+        },
+    });
+    // -- List directory -------------------------------------------------------
+    routes.push({
+        method: 'GET',
+        pattern: /^\/api\/repos\/([^/]+)\/tree$/,
+        handler: async (req, res, match) => {
+            try {
+                const parsedUrl = url.parse(req.url ?? '', true);
+                const parsed = parseRepoRequest(res, match, parsedUrl.query, {
+                    pathRequired: false,
+                    pathDefault: '.',
+                });
+                if (!parsed)
+                    return;
+                const repo = await svc.resolveRepo(parsed.repoId);
+                if (!repo) {
+                    (0, router_1.send404)(res, `Unknown repo: ${parsed.repoId}`);
+                    return;
+                }
+                const showIgnored = parsedUrl.query.showIgnored === 'true';
+                const rawDepth = parseInt(String(parsedUrl.query.depth ?? '1'), 10);
+                const depth = Math.min(Math.max(isNaN(rawDepth) ? 1 : rawDepth, 1), 5);
+                const result = depth > 1
+                    ? await svc.listDirectoryDeep(parsed.repoId, parsed.path, depth, { showIgnored })
+                    : await svc.listDirectory(parsed.repoId, parsed.path, { showIgnored });
+                (0, router_1.sendJson)(res, result);
+            }
+            catch (err) {
+                if (err instanceof Error && (err.message.includes('does not exist') || err.message.includes('not found'))) {
+                    (0, router_1.send404)(res, `Path not found: ${err.message}`);
+                }
+                else {
+                    (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+                }
+            }
+        },
+    });
+    // -- List all files (recursive) -------------------------------------------
+    routes.push({
+        method: 'GET',
+        pattern: /^\/api\/repos\/([^/]+)\/files$/,
+        handler: async (req, res, match) => {
+            try {
+                const parsedUrl = url.parse(req.url ?? '', true);
+                const parsed = parseRepoRequest(res, match, parsedUrl.query, {
+                    pathRequired: false,
+                    pathDefault: '.',
+                });
+                if (!parsed)
+                    return;
+                const repo = await svc.resolveRepo(parsed.repoId);
+                if (!repo) {
+                    (0, router_1.send404)(res, `Unknown repo: ${parsed.repoId}`);
+                    return;
+                }
+                const showIgnored = parsedUrl.query.showIgnored === 'true';
+                const result = await svc.listFilesRecursive(parsed.repoId, parsed.path, { showIgnored });
+                (0, router_1.sendJson)(res, result);
+            }
+            catch (err) {
+                if (err instanceof Error && (err.message.includes('does not exist') || err.message.includes('not found'))) {
+                    (0, router_1.send404)(res, `Path not found: ${err.message}`);
+                }
+                else {
+                    (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+                }
+            }
+        },
+    });
+    // -- Search files (fuzzy) -------------------------------------------------
+    routes.push({
+        method: 'GET',
+        pattern: /^\/api\/repos\/([^/]+)\/search$/,
+        handler: async (req, res, match) => {
+            try {
+                const parsedUrl = url.parse(req.url ?? '', true);
+                const repoId = decodeURIComponent(match[1]);
+                const q = typeof parsedUrl.query.q === 'string' ? parsedUrl.query.q : '';
+                if (!q) {
+                    (0, router_1.send400)(res, 'Missing required query parameter: q');
+                    return;
+                }
+                const rawLimit = parseInt(String(parsedUrl.query.limit ?? '50'), 10);
+                const limit = isNaN(rawLimit) ? 50 : Math.min(Math.max(rawLimit, 1), 200);
+                const showIgnored = parsedUrl.query.showIgnored === 'true';
+                const repo = await svc.resolveRepo(repoId);
+                if (!repo) {
+                    (0, router_1.send404)(res, `Unknown repo: ${repoId}`);
+                    return;
+                }
+                const result = await svc.searchFiles(repoId, q, { limit, showIgnored });
+                (0, router_1.sendJson)(res, result);
+            }
+            catch (err) {
+                (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+            }
+        },
+    });
+    // -- Read blob ------------------------------------------------------------
+    routes.push({
+        method: 'GET',
+        pattern: /^\/api\/repos\/([^/]+)\/blob$/,
+        handler: async (req, res, match) => {
+            try {
+                const parsedUrl = url.parse(req.url ?? '', true);
+                const parsed = parseRepoRequest(res, match, parsedUrl.query, {
+                    pathRequired: true,
+                });
+                if (!parsed)
+                    return;
+                const repo = await svc.resolveRepo(parsed.repoId);
+                if (!repo) {
+                    (0, router_1.send404)(res, `Unknown repo: ${parsed.repoId}`);
+                    return;
+                }
+                const blob = await svc.readBlob(parsed.repoId, parsed.path);
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(blob));
+            }
+            catch (err) {
+                if (err instanceof Error && (err.message.includes('not found') || err.message.includes('File not found'))) {
+                    (0, router_1.send404)(res, `Path not found: ${err.message}`);
+                }
+                else {
+                    (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+                }
+            }
+        },
+    });
+    // -- Write blob -----------------------------------------------------------
+    routes.push({
+        method: 'PUT',
+        pattern: /^\/api\/repos\/([^/]+)\/blob$/,
+        handler: async (req, res, match) => {
+            try {
+                const parsedUrl = url.parse(req.url ?? '', true);
+                const parsed = parseRepoRequest(res, match, parsedUrl.query, {
+                    pathRequired: true,
+                });
+                if (!parsed)
+                    return;
+                let body;
+                try {
+                    body = await (0, router_1.readJsonBody)(req);
+                }
+                catch {
+                    (0, router_1.send400)(res, 'Invalid JSON body');
+                    return;
+                }
+                if (body.content === undefined || body.content === null) {
+                    (0, router_1.send400)(res, 'Missing required field: content');
+                    return;
+                }
+                if (typeof body.content !== 'string') {
+                    (0, router_1.send400)(res, 'Field "content" must be a string');
+                    return;
+                }
+                const repo = await svc.resolveRepo(parsed.repoId);
+                if (!repo) {
+                    (0, router_1.send404)(res, `Unknown repo: ${parsed.repoId}`);
+                    return;
+                }
+                await svc.writeBlob(parsed.repoId, parsed.path, body.content);
+                (0, router_1.sendJson)(res, { success: true });
+            }
+            catch (err) {
+                if (err instanceof Error && err.message.includes('Path traversal')) {
+                    (0, router_1.send400)(res, err.message);
+                }
+                else {
+                    (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+                }
+            }
+        },
+    });
+    // -- Reveal in OS file manager --------------------------------------------
+    routes.push({
+        method: 'GET',
+        pattern: /^\/api\/repos\/([^/]+)\/reveal$/,
+        handler: async (req, res, match) => {
+            try {
+                const parsedUrl = url.parse(req.url ?? '', true);
+                const parsed = parseRepoRequest(res, match, parsedUrl.query, {
+                    pathRequired: true,
+                });
+                if (!parsed)
+                    return;
+                const repo = await svc.resolveRepo(parsed.repoId);
+                if (!repo) {
+                    (0, router_1.send404)(res, `Unknown repo: ${parsed.repoId}`);
+                    return;
+                }
+                const absPath = path.resolve(repo.localPath, parsed.path);
+                const normalizedRepo = path.resolve(repo.localPath);
+                if (!absPath.startsWith(normalizedRepo + path.sep) && absPath !== normalizedRepo) {
+                    (0, router_1.send400)(res, 'Invalid path: directory traversal not allowed');
+                    return;
+                }
+                const platform = process.platform;
+                if (platform === 'win32') {
+                    child_process.spawn('explorer.exe', ['/select,', absPath], { detached: true, stdio: 'ignore' });
+                }
+                else if (platform === 'darwin') {
+                    child_process.spawn('open', ['-R', absPath], { detached: true, stdio: 'ignore' });
+                }
+                else {
+                    // Linux: open parent directory (best-effort)
+                    const parentDir = path.dirname(absPath);
+                    child_process.spawn('xdg-open', [parentDir], { detached: true, stdio: 'ignore' });
+                }
+                res.writeHead(204);
+                res.end();
+            }
+            catch (err) {
+                (0, router_1.send500)(res, err instanceof Error ? err.message : String(err));
+            }
+        },
+    });
+}
+//# sourceMappingURL=repo-routes.js.map

package/dist/server/repos/repo-routes.js.map

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

package/dist/server/repos/tree-service.d.ts

@@ -0,0 +1,112 @@
+import type { WorkspaceInfo } from '@plusplusoneplusplus/forge';
+import type { RepoInfo, TreeListResult, SearchFilesResult } from './types';
+export interface RepoTreeServiceOptions {
+    /**
+     * Maximum entries returned per directory listing.
+     * Listings exceeding this are truncated and `truncated: true` is set.
+     * Default: 5000.
+     */
+    maxEntries?: number;
+}
+export declare class RepoTreeService {
+    private readonly maxEntries;
+    private readonly dataDir;
+    private static rgAvailable;
+    private static checkRipgrepAvailable;
+    /**
+     * Uses `rg --files --hidden --max-depth 1` to determine which file entries are gitignored.
+     * rg natively respects .gitignore, so files absent from its output are ignored.
+     * Directories are not handled here (rg --files never lists them).
+     * Returns null if rg is unavailable or encounters an error (caller should fall back).
+     */
+    private static getIgnoredNamesViaRipgrep;
+    /**
+     * Returns the set of entry names that should be hidden from directory listings.
+     * Primary path: rg for files (non-blocking) + async git check-ignore for dirs.
+     * Fallback: async git check-ignore for all entries when rg is unavailable.
+     */
+    private static getIgnoredNames;
+    private listFilesWithRipgrep;
+    constructor(dataDir: string, options?: RepoTreeServiceOptions);
+    /**
+     * List all registered repos from workspaces.json.
+     * @returns Array of RepoInfo with headSha resolved from git.
+     */
+    listRepos(): Promise<RepoInfo[]>;
+    /**
+     * Resolve a repo by ID. Returns undefined if not found.
+     */
+    resolveRepo(repoId: string): Promise<RepoInfo | undefined>;
+    /**
+     * List the contents of `relativePath` inside the repo identified by `repoId`.
+     *
+     * @param repoId       Stable workspace ID.
+     * @param relativePath Path relative to repo root ('.' or '' = root).
+     * @param options      Optional listing options.
+     * @returns TreeListResult with entries (dirs-first, alpha-sorted), or throws if
+     *          path is outside repo root (traversal guard) or does not exist.
+     */
+    listDirectory(repoId: string, relativePath: string, options?: {
+        showIgnored?: boolean;
+    }): Promise<TreeListResult>;
+    /**
+     * List the contents of `relativePath` to the given depth.
+     * depth=1 returns the same flat TreeListResult as listDirectory().
+     * depth>1 populates `children` on directory entries recursively.
+     * Truncated directories are not recursed into.
+     */
+    listDirectoryDeep(repoId: string, relativePath: string, depth: number, options?: {
+        showIgnored?: boolean;
+    }): Promise<TreeListResult>;
+    /**
+     * Recursively list all files under `relativePath` inside the repo.
+     * Returns a flat array of relative paths (files only, no directories).
+     * Respects gitignore unless `showIgnored` is set. Capped by `maxEntries`.
+     */
+    listFilesRecursive(repoId: string, relativePath: string, options?: {
+        showIgnored?: boolean;
+    }): Promise<{
+        files: string[];
+        truncated: boolean;
+    }>;
+    /**
+     * Read file content.
+     * @returns content (text or base64), encoding, and mimeType.
+     * @throws if file not found, path traversal detected, or file exceeds 1 MB.
+     */
+    readBlob(repoId: string, relativePath: string): Promise<{
+        content: string;
+        encoding: 'utf-8' | 'base64';
+        mimeType: string;
+    }>;
+    /**
+     * Write text content to a file inside a repo.
+     * @throws if repo not found, path traversal detected, or path is a directory.
+     */
+    writeBlob(repoId: string, relativePath: string, content: string): Promise<void>;
+    /**
+     * Fuzzy-score a single file path against a query.
+     * Mirrors the scoring logic in QuickOpen.tsx.
+     * Returns 0 if not all query characters are found in order.
+     */
+    static fuzzyScore(query: string, filePath: string): number;
+    /**
+     * Fuzzy-search all files under the repo root.
+     * Returns results sorted by score descending, limited to `options.limit`.
+     *
+     * @param repoId   Stable workspace ID.
+     * @param query    Search query (min 1 character).
+     * @param options  Optional: limit (default 50, max 200), showIgnored (default false).
+     */
+    searchFiles(repoId: string, query: string, options?: {
+        limit?: number;
+        showIgnored?: boolean;
+    }): Promise<SearchFilesResult>;
+    /**
+     * Build a RepoInfo from a WorkspaceInfo.
+     * Pure mapping + git HEAD resolution.
+     */
+    static toRepoInfo(workspace: WorkspaceInfo): RepoInfo;
+    private readWorkspaces;
+}
+//# sourceMappingURL=tree-service.d.ts.map

package/dist/server/repos/tree-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-service.d.ts","sourceRoot":"","sources":["../../../src/server/repos/tree-service.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,KAAK,EAAE,QAAQ,EAAa,cAAc,EAAoB,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAExG,MAAM,WAAW,sBAAsB;IACnC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACvB;AAoLD,qBAAa,eAAe;IACxB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IAEjC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAsB;mBAE3B,qBAAqB;IAW1C;;;;;OAKG;mBACkB,yBAAyB;IA8B9C;;;;OAIG;mBACkB,eAAe;YAoBtB,oBAAoB;gBAsCtB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAK7D;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAKtC;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC;IAMhE;;;;;;;;OAQG;IACG,aAAa,CACf,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACpC,OAAO,CAAC,cAAc,CAAC;IAsF1B;;;;;OAKG;IACG,iBAAiB,CACnB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACpC,OAAO,CAAC,cAAc,CAAC;IAc1B;;;;OAIG;IACG,kBAAkB,CACpB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACpC,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAgFnD;;;;OAIG;IACG,QAAQ,CACV,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,GAAG,QAAQ,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IA2C/E;;;OAGG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBrF;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IA0B1D;;;;;;;OAOG;IACG,WAAW,CACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GACpD,OAAO,CAAC,iBAAiB,CAAC;IAqB7B;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,aAAa,GAAG,QAAQ;YAyCvC,cAAc;CAS/B"}