@trebired/git-host 0.2.0 → 1.0.0

package/CHANGELOG.md

@@ -6,9 +6,10 @@ This project follows semantic versioning once published.
 
 ## Unreleased
 
-## 0.2.0
+## 1.0.0
 
 - Added repository linguist analysis through `readLinguist()` with ref-based text blob inspection powered by `linguist-js`.
+- Added live linguist progress reporting through `readLinguist(..., { onProgress })`, plus Socket.IO delivery through `createGitApiSocketServer()` and the typed `openLinguistSocket()` client helper.
 - Added optional tree entry enrichment for detected file languages and inline SVG icons from `material-icon-theme`.
 - Added tag APIs for listing, reading, creating, and deleting tags.
 - Added path- and ref-scoped commit history plus path-scoped diff filtering.

package/README.md

@@ -70,7 +70,12 @@ await gitHost.ensureRepository("demo", {
 const summary = await gitHost.readSummary("demo");
 console.log(summary.repository.current_branch);
 
-const linguist = await gitHost.readLinguist("demo", { ref: "main" });
+const linguist = await gitHost.readLinguist("demo", {
+  ref: "main",
+  onProgress(event) {
+    console.log(event.stage, event.percent);
+  },
+});
 console.log(linguist.languages.results);
 
 const tree = await gitHost.listTree("demo", {
@@ -198,7 +203,7 @@ JSON API hosting:
 
 ```ts
 import { createServer } from "node:http";
-import { createGitApiHandler, createGitHost } from "@trebired/git-host";
+import { createGitApiHandler, createGitApiSocketServer, createGitHost } from "@trebired/git-host";
 import { createLog } from "@trebired/logger";
 
 const log = createLog({
@@ -225,6 +230,16 @@ const apiServer = createServer(createGitApiHandler({
   },
 }));
 
+createGitApiSocketServer({
+  basePath: "/api/git",
+  gitHost,
+  httpServer: apiServer,
+  logger: log,
+  authorize({ action, repositoryId }) {
+    return canReadRepository(repositoryId, action);
+  },
+});
+
 apiServer.listen(3100);
 ```
 
@@ -275,6 +290,22 @@ function App() {
 }
 ```
 
+For long-running repository scans, the typed client also exposes a live Socket.IO linguist stream:
+
+```ts
+const socket = gitClient.openLinguistSocket("demo", {
+  ref: "main",
+  onProgress(event) {
+    console.log(event.stage, event.percent);
+  },
+  onResult(event) {
+    console.log(event.data.languages.results);
+  },
+});
+
+await socket.completed;
+```
+
 The React entry is intentionally headless. It helps apps fetch and mutate Git data consistently, but it does not ship a bundled styled UI.
 
 ## Current API
@@ -287,6 +318,7 @@ The first public slice is intentionally small:
 - `buildGitEnv()`
 - `RepositoryLockManager`
 - `createGitApiHandler()`
+- `createGitApiSocketServer()`
 - `createGitHttpHandler()`
 - `generateSshKeyPair()`
 - `normalizeSshPublicKey()`
@@ -338,6 +370,7 @@ The React entry currently exports:
 
 - `createGitApiClient()`
 - `GitApiClientProvider`
+- `openLinguistSocket()` through the typed client instance
 - `useGitRepositorySummary()`
 - `useGitBranches()`
 - `useGitCommits()`
@@ -411,6 +444,7 @@ Hosted transports keep identity and permission policy in your app.
 - `createGitHttpHandler()` supports host-owned repository resolution, optional identity resolution, permission checks, and request audit events.
 - `createGitSshServer()` supports host-owned public key authentication, permission checks, and command audit events.
 - `createGitApiHandler()` supports host-owned repository id mapping and per-route authorization.
+- `createGitApiSocketServer()` supports host-owned Socket.IO progress delivery for long-running linguist scans with the same repository mapping and authorization hooks.
 - `generateSshKeyPair()`, `normalizeSshPublicKey()`, `compareSshPublicKeys()`, and `fingerprintSshPublicKey()` help host apps manage SSH transport setup without owning the parsing details themselves.
 
 ## Platform Fit
@@ -454,7 +488,7 @@ log.info("git-host", "initializing repository", { repositoryId: "demo" });
 
 comes from `@trebired/logger`.
 
-You can pass that same `log` object into `createGitHost()`, `createGitHttpHandler()`, `createGitSshServer()`, and `createGitApiHandler()` through their `logger` option.
+You can pass that same `log` object into `createGitHost()`, `createGitHttpHandler()`, `createGitSshServer()`, `createGitApiHandler()`, and `createGitApiSocketServer()` through their `logger` option.
 
 If you do not pass a logger and `@trebired/logger` is installed in the host app, git-host will create a quiet console-only logger automatically before falling back to raw `console`.
 

package/dist/api/socket_events.d.ts

@@ -0,0 +1,7 @@
+declare const LINGUIST_START_EVENT = "git:linguist:start";
+declare const LINGUIST_PROGRESS_EVENT = "git:linguist:progress";
+declare const LINGUIST_RESULT_EVENT = "git:linguist:result";
+declare const LINGUIST_DONE_EVENT = "git:linguist:done";
+declare const LINGUIST_ERROR_EVENT = "git:linguist:error";
+export { LINGUIST_DONE_EVENT, LINGUIST_ERROR_EVENT, LINGUIST_PROGRESS_EVENT, LINGUIST_RESULT_EVENT, LINGUIST_START_EVENT, };
+//# sourceMappingURL=socket_events.d.ts.map

package/dist/api/socket_events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket_events.d.ts","sourceRoot":"","sources":["../../src/api/socket_events.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,oBAAoB,uBAAuB,CAAC;AAClD,QAAA,MAAM,uBAAuB,0BAA0B,CAAC;AACxD,QAAA,MAAM,qBAAqB,wBAAwB,CAAC;AACpD,QAAA,MAAM,mBAAmB,sBAAsB,CAAC;AAChD,QAAA,MAAM,oBAAoB,uBAAuB,CAAC;AAElD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,CAAC"}

package/dist/api/socket_events.js

@@ -0,0 +1,7 @@
+const LINGUIST_START_EVENT = "git:linguist:start";
+const LINGUIST_PROGRESS_EVENT = "git:linguist:progress";
+const LINGUIST_RESULT_EVENT = "git:linguist:result";
+const LINGUIST_DONE_EVENT = "git:linguist:done";
+const LINGUIST_ERROR_EVENT = "git:linguist:error";
+export { LINGUIST_DONE_EVENT, LINGUIST_ERROR_EVENT, LINGUIST_PROGRESS_EVENT, LINGUIST_RESULT_EVENT, LINGUIST_START_EVENT, };
+//# sourceMappingURL=socket_events.js.map

package/dist/api/socket_events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket_events.js","sourceRoot":"","sources":["../../src/api/socket_events.ts"],"names":[],"mappings":"AAAA,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAClD,MAAM,uBAAuB,GAAG,uBAAuB,CAAC;AACxD,MAAM,qBAAqB,GAAG,qBAAqB,CAAC;AACpD,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAChD,MAAM,oBAAoB,GAAG,oBAAoB,CAAC;AAElD,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,CAAC"}

package/dist/api/socket_server.d.ts

@@ -0,0 +1,6 @@
+import { Server as SocketIoServer } from "socket.io";
+import type { CreateGitApiSocketServerOptions } from "../types.js";
+import { LINGUIST_DONE_EVENT, LINGUIST_ERROR_EVENT, LINGUIST_PROGRESS_EVENT, LINGUIST_RESULT_EVENT, LINGUIST_START_EVENT } from "./socket_events.js";
+declare function createGitApiSocketServer(options: CreateGitApiSocketServerOptions): SocketIoServer<import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, import("socket.io").DefaultEventsMap, any>;
+export { createGitApiSocketServer, LINGUIST_DONE_EVENT, LINGUIST_ERROR_EVENT, LINGUIST_PROGRESS_EVENT, LINGUIST_RESULT_EVENT, LINGUIST_START_EVENT, };
+//# sourceMappingURL=socket_server.d.ts.map

package/dist/api/socket_server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket_server.d.ts","sourceRoot":"","sources":["../../src/api/socket_server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,WAAW,CAAC;AAGrD,OAAO,KAAK,EACV,+BAA+B,EAEhC,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAc5B,iBAAS,wBAAwB,CAAC,OAAO,EAAE,+BAA+B,yIAgJzE;AAED,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,oBAAoB,EACpB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,CAAC"}

package/dist/api/socket_server.js

@@ -0,0 +1,156 @@
+import { Server as SocketIoServer } from "socket.io";
+import { resolveLogger } from "../logging.js";
+import { text } from "../utils/text.js";
+import { LINGUIST_DONE_EVENT, LINGUIST_ERROR_EVENT, LINGUIST_PROGRESS_EVENT, LINGUIST_RESULT_EVENT, LINGUIST_START_EVENT, } from "./socket_events.js";
+import { authorizationAllowed, serializeError, statusForError } from "./handler/response.js";
+function normalizeSocketPath(basePathInput, socketPathInput) {
+    const socketPath = text(socketPathInput).replace(/\/+$/g, "");
+    if (socketPath) {
+        return socketPath.startsWith("/") ? socketPath : `/${socketPath}`;
+    }
+    const basePath = text(basePathInput).replace(/\/+$/g, "");
+    if (!basePath || basePath === "/")
+        return "/socket.io";
+    return `${basePath.startsWith("/") ? basePath : `/${basePath}`}/socket.io`;
+}
+function createGitApiSocketServer(options) {
+    if (!options || typeof options.gitHost !== "object") {
+        throw new TypeError("createGitApiSocketServer() requires a gitHost instance.");
+    }
+    if (!options.httpServer) {
+        throw new TypeError("createGitApiSocketServer() requires an httpServer.");
+    }
+    const logger = resolveLogger(options.logger);
+    const verbose = options.verbose === true;
+    const logGroup = "git-host.api.socket";
+    const basePath = text(options.basePath, "/api/git");
+    const path = normalizeSocketPath(basePath, options.socketPath);
+    const io = new SocketIoServer(options.httpServer, {
+        ...(options.socketOptions || {}),
+        path,
+    });
+    io.on("connection", (socket) => {
+        socket.on(LINGUIST_START_EVENT, async (payload) => {
+            const repositoryKey = text(payload && payload.repositoryKey);
+            const ref = text(payload && payload.ref);
+            const pathname = `${basePath.replace(/\/+$/g, "") || ""}/repositories/${encodeURIComponent(repositoryKey)}/linguist/socket`;
+            if (!repositoryKey) {
+                socket.emit(LINGUIST_ERROR_EVENT, {
+                    error: {
+                        code: "repository_not_found",
+                        message: "Repository key is required.",
+                    },
+                    status: 404,
+                });
+                socket.emit(LINGUIST_DONE_EVENT, { ok: false });
+                socket.disconnect();
+                return;
+            }
+            const repositoryId = text(options.resolveRepositoryId
+                ? await options.resolveRepositoryId(repositoryKey, socket.request)
+                : repositoryKey);
+            if (!repositoryId) {
+                socket.emit(LINGUIST_ERROR_EVENT, {
+                    error: {
+                        code: "repository_not_found",
+                        message: "Repository not found.",
+                    },
+                    status: 404,
+                });
+                socket.emit(LINGUIST_DONE_EVENT, { ok: false, repository_key: repositoryKey });
+                socket.disconnect();
+                return;
+            }
+            const searchParams = new URLSearchParams();
+            if (ref)
+                searchParams.set("ref", ref);
+            const auth = authorizationAllowed(options.authorize
+                ? await options.authorize({
+                    action: "linguist_socket",
+                    method: "SOCKET",
+                    pathname,
+                    remoteAddress: text(socket.handshake.address),
+                    repositoryId,
+                    repositoryKey,
+                    request: socket.request,
+                    searchParams,
+                })
+                : undefined);
+            if (!auth.allowed) {
+                logger.warn(logGroup, "api socket permission denied", {
+                    action: "linguist_socket",
+                    pathname,
+                    repositoryId,
+                    repositoryKey,
+                    status: auth.status || 403,
+                });
+                socket.emit(LINGUIST_ERROR_EVENT, {
+                    error: {
+                        code: "permission_denied",
+                        message: auth.message || "Permission denied.",
+                    },
+                    status: auth.status || 403,
+                });
+                socket.emit(LINGUIST_DONE_EVENT, {
+                    ok: false,
+                    repository_id: repositoryId,
+                    repository_key: repositoryKey,
+                });
+                socket.disconnect();
+                return;
+            }
+            try {
+                const data = await options.gitHost.readLinguist(repositoryId, {
+                    onProgress(progressEvent) {
+                        socket.emit(LINGUIST_PROGRESS_EVENT, progressEvent);
+                    },
+                    ref,
+                });
+                socket.emit(LINGUIST_RESULT_EVENT, {
+                    action: "linguist",
+                    data,
+                    repository_id: repositoryId,
+                    repository_key: repositoryKey,
+                });
+                socket.emit(LINGUIST_DONE_EVENT, {
+                    ok: true,
+                    repository_id: repositoryId,
+                    repository_key: repositoryKey,
+                });
+                if (verbose) {
+                    logger.info(logGroup, "api linguist socket completed", {
+                        repositoryId,
+                        repositoryKey,
+                        socketId: socket.id,
+                    });
+                }
+            }
+            catch (error) {
+                logger.error(logGroup, "api linguist socket failed", {
+                    error: error instanceof Error ? error.message : String(error),
+                    repositoryId,
+                    repositoryKey,
+                    socketId: socket.id,
+                });
+                socket.emit(LINGUIST_ERROR_EVENT, {
+                    ...serializeError(error),
+                    ok: false,
+                    repository_id: repositoryId,
+                    repository_key: repositoryKey,
+                    status: statusForError(error),
+                });
+                socket.emit(LINGUIST_DONE_EVENT, {
+                    ok: false,
+                    repository_id: repositoryId,
+                    repository_key: repositoryKey,
+                });
+            }
+            finally {
+                socket.disconnect();
+            }
+        });
+    });
+    return io;
+}
+export { createGitApiSocketServer, LINGUIST_DONE_EVENT, LINGUIST_ERROR_EVENT, LINGUIST_PROGRESS_EVENT, LINGUIST_RESULT_EVENT, LINGUIST_START_EVENT, };
+//# sourceMappingURL=socket_server.js.map

package/dist/api/socket_server.js.map

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

package/dist/core/inspect/linguist_progress.d.ts

@@ -0,0 +1,14 @@
+import type { GitLinguistProgressEvent, GitLinguistProgressStage, GitRepositoryHandle, MaybePromise } from "../../types.js";
+type GitLinguistProgressCallback = (event: GitLinguistProgressEvent) => MaybePromise<void>;
+type CreateLinguistProgressReporterOptions = {
+    onProgress?: GitLinguistProgressCallback;
+    repository: GitRepositoryHandle;
+    ref?: string;
+};
+declare function createLinguistProgressReporter(options: CreateLinguistProgressReporterOptions): {
+    emit: (stage: GitLinguistProgressStage, update?: Partial<Omit<GitLinguistProgressEvent, "emitted_at" | "percent" | "repository_id" | "scan_id" | "stage">>) => Promise<void>;
+    scanId: `${string}-${string}-${string}-${string}-${string}`;
+};
+export { createLinguistProgressReporter };
+export type { GitLinguistProgressCallback };
+//# sourceMappingURL=linguist_progress.d.ts.map

package/dist/core/inspect/linguist_progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linguist_progress.d.ts","sourceRoot":"","sources":["../../../src/core/inspect/linguist_progress.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,wBAAwB,EACxB,mBAAmB,EACnB,YAAY,EACb,MAAM,gBAAgB,CAAC;AAGxB,KAAK,2BAA2B,GAAG,CAAC,KAAK,EAAE,wBAAwB,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;AAE3F,KAAK,qCAAqC,GAAG;IAC3C,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,UAAU,EAAE,mBAAmB,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAoDF,iBAAS,8BAA8B,CAAC,OAAO,EAAE,qCAAqC;kBAY3E,wBAAwB,WACvB,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,YAAY,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,GAAG,OAAO,CAAC,CAAC,KAChH,OAAO,CAAC,IAAI,CAAC;;EA6BjB;AAED,OAAO,EAAE,8BAA8B,EAAE,CAAC;AAC1C,YAAY,EAAE,2BAA2B,EAAE,CAAC"}

package/dist/core/inspect/linguist_progress.js

@@ -0,0 +1,92 @@
+import { randomUUID } from "node:crypto";
+import { text } from "../../utils/text.js";
+function computeLinguistPercent(stage, state) {
+    if (stage === "queued")
+        return 0;
+    if (stage === "resolving_ref")
+        return 5;
+    if (stage === "listing_tree")
+        return 10;
+    if (stage === "analyzing")
+        return 90;
+    if (stage === "completed")
+        return 100;
+    if (stage === "failed") {
+        if (state.total_blobs > 0) {
+            const ratio = state.processed_blobs / state.total_blobs;
+            return Math.max(0, Math.min(95, Math.round(15 + (ratio * 70))));
+        }
+        return 0;
+    }
+    if (state.total_blobs <= 0)
+        return 15;
+    const ratio = state.processed_blobs / state.total_blobs;
+    return Math.max(15, Math.min(85, Math.round(15 + (ratio * 70))));
+}
+function defaultLinguistMessage(stage, state) {
+    switch (stage) {
+        case "queued":
+            return "Queued linguist scan.";
+        case "resolving_ref":
+            return "Resolving repository ref.";
+        case "listing_tree":
+            return "Listing repository tree.";
+        case "reading_blobs":
+            return state.total_blobs > 0
+                ? `Reading repository files (${state.processed_blobs}/${state.total_blobs}).`
+                : "Reading repository files.";
+        case "analyzing":
+            return "Analyzing repository languages.";
+        case "completed":
+            return "Completed linguist scan.";
+        case "failed":
+            return "Linguist scan failed.";
+        default:
+            return "Processing linguist scan.";
+    }
+}
+function createLinguistProgressReporter(options) {
+    const onProgress = typeof options.onProgress === "function" ? options.onProgress : null;
+    const scanId = randomUUID();
+    const state = {
+        commit: "",
+        processed_blobs: 0,
+        ref: text(options.ref, "HEAD"),
+        total_blobs: 0,
+        total_entries: 0,
+    };
+    async function emit(stage, update = {}) {
+        if (!onProgress)
+            return;
+        if (typeof update.ref === "string")
+            state.ref = text(update.ref, state.ref);
+        if (typeof update.commit === "string")
+            state.commit = text(update.commit, state.commit);
+        if (typeof update.total_entries === "number")
+            state.total_entries = Math.max(0, Number(update.total_entries) || 0);
+        if (typeof update.total_blobs === "number")
+            state.total_blobs = Math.max(0, Number(update.total_blobs) || 0);
+        if (typeof update.processed_blobs === "number")
+            state.processed_blobs = Math.max(0, Number(update.processed_blobs) || 0);
+        await onProgress({
+            commit: text(update.commit, state.commit) || undefined,
+            emitted_at: new Date().toISOString(),
+            error: update.error,
+            message: text(update.message, defaultLinguistMessage(stage, state)),
+            percent: computeLinguistPercent(stage, state),
+            processed_blobs: state.processed_blobs,
+            ref: text(update.ref, state.ref),
+            repository_id: options.repository.id,
+            scan_id: scanId,
+            stage,
+            total_blobs: state.total_blobs,
+            total_entries: state.total_entries,
+        });
+    }
+    return {
+        emit,
+        scanId,
+    };
+}
+export { createLinguistProgressReporter };
+//# sourceMappingURL=linguist_progress.js.map

package/dist/core/inspect/linguist_progress.js.map

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

package/dist/core/inspect.d.ts

@@ -1,10 +1,12 @@
-import type { GitArchive, GitBlob, GitBlame, GitCommitDetail, GitCompareSummary, GitRepositoryHandle, GitRepositoryLinguist, GitSearchResult, GitTreeEntry } from "../types.js";
+import type { GitArchive, GitBlob, GitBlame, GitCommitDetail, GitCompareSummary, GitLinguistProgressEvent, GitRepositoryHandle, GitRepositoryLinguist, GitSearchResult, GitTreeEntry } from "../types.js";
 declare function readRepositoryLinguist(repository: GitRepositoryHandle, options?: {
+    onProgress?: (event: GitLinguistProgressEvent) => Promise<void> | void;
     ref?: string;
 }): Promise<GitRepositoryLinguist>;
 declare function listRepositoryTree(repository: GitRepositoryHandle, options?: {
     icons?: boolean;
     linguist?: boolean;
+    onLinguistProgress?: (event: GitLinguistProgressEvent) => Promise<void> | void;
     path?: string;
     recursive?: boolean;
     ref?: string;

package/dist/core/inspect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/core/inspect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,QAAQ,EAER,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,qBAAqB,EAGrB,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAmNrB,iBAAe,sBAAsB,CACnC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE;IACP,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,OAAO,CAAC,qBAAqB,CAAC,CAMhC;AAED,iBAAe,kBAAkB,CAC/B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,OAAO,CAAC,YAAY,EAAE,CAAC,CAmBzB;AAED,iBAAe,kBAAkB,CAC/B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,OAAO,CAAC,OAAO,CAAC,CAiDlB;AAED,iBAAe,oBAAoB,CAAC,UAAU,EAAE,mBAAmB,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAqDtH;AAED,iBAAe,qBAAqB,CAClC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,iBAAiB,CAAC,CAmD5B;AAED,iBAAe,mBAAmB,CAChC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,OAAO,CAAC,QAAQ,CAAC,CAiEnB;AAED,iBAAe,gBAAgB,CAC7B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IACP,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAAC,eAAe,CAAC,CAqE1B;AAED,iBAAe,qBAAqB,CAClC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,OAAO,CAAC,UAAU,CAAC,CAyBrB;AAED,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,CAAC"}
+{"version":3,"file":"inspect.d.ts","sourceRoot":"","sources":["../../src/core/inspect.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EACV,OAAO,EACP,QAAQ,EAER,eAAe,EACf,iBAAiB,EACjB,wBAAwB,EACxB,mBAAmB,EACnB,qBAAqB,EAGrB,eAAe,EACf,YAAY,EACb,MAAM,aAAa,CAAC;AAkPrB,iBAAe,sBAAsB,CACnC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE;IACP,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvE,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,OAAO,CAAC,qBAAqB,CAAC,CAgDhC;AAED,iBAAe,kBAAkB,CAC/B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,OAAO,CAAC,YAAY,EAAE,CAAC,CAsBzB;AAED,iBAAe,kBAAkB,CAC/B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,OAAO,CAAC,OAAO,CAAC,CAiDlB;AAED,iBAAe,oBAAoB,CAAC,UAAU,EAAE,mBAAmB,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO,CAAC,eAAe,CAAC,CAqDtH;AAED,iBAAe,qBAAqB,CAClC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,iBAAiB,CAAC,CAmD5B;AAED,iBAAe,mBAAmB,CAChC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IACP,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GACA,OAAO,CAAC,QAAQ,CAAC,CAiEnB;AAED,iBAAe,gBAAgB,CAC7B,UAAU,EAAE,mBAAmB,EAC/B,OAAO,EAAE;IACP,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAAC,eAAe,CAAC,CAqE1B;AAED,iBAAe,qBAAqB,CAClC,UAAU,EAAE,mBAAmB,EAC/B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACT,GACL,OAAO,CAAC,UAAU,CAAC,CAyBrB;AAED,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,GACjB,CAAC"}

package/dist/core/inspect.js

@@ -1,8 +1,9 @@
 import analyseRawContent from "linguist-js/dist/entry/analyseRaw.js";
-import { GitHostError } from "../errors.js";
+import { GitHostError, isGitHostError } from "../errors.js";
 import { normalizeRepositoryRelativePath } from "../utils/paths.js";
 import { text } from "../utils/text.js";
 import { resolveTreeEntryIcon } from "./inspect/icon_theme.js";
+import { createLinguistProgressReporter } from "./inspect/linguist_progress.js";
 import { parseCommitLogOutput, parseNameStatusOutput, parseNumstatOutput } from "./repository.js";
 import { runGit, runGitBuffer } from "./run_git.js";
 import { assertRepositoryReady, decodeBlobContent, parseCommitMeta, parseLsTreeBuffer, resolveCommitForRef, summarizeFileLines, withFileStats, } from "./inspect/helpers.js";
@@ -77,10 +78,18 @@ async function readTreeEntryBlob(repository, ref, entry) {
         ...decodeBlobContent(contentRes.stdout),
     };
 }
-async function readRepositoryLinguistInput(repository, ref) {
+async function readRepositoryLinguistInput(repository, ref, onProgress) {
     const entries = await readRepositoryTreeEntries(repository, { recursive: true, ref });
     const blobEntries = entries.filter((entry) => entry.type === "blob");
     const input = {};
+    let processedBlobs = 0;
+    if (onProgress) {
+        await onProgress("reading_blobs", {
+            processed_blobs: 0,
+            total_blobs: blobEntries.length,
+            total_entries: entries.length,
+        });
+    }
     for (let index = 0; index < blobEntries.length; index += 16) {
         const chunk = blobEntries.slice(index, index + 16);
         const blobs = await Promise.all(chunk.map(async (entry) => {
@@ -91,8 +100,20 @@ async function readRepositoryLinguistInput(repository, ref) {
                 input[blob.path] = blob.content;
             }
         }
+        processedBlobs += chunk.length;
+        if (onProgress) {
+            await onProgress("reading_blobs", {
+                processed_blobs: processedBlobs,
+                total_blobs: blobEntries.length,
+                total_entries: entries.length,
+            });
+        }
     }
-    return input;
+    return {
+        input,
+        total_blobs: blobEntries.length,
+        total_entries: entries.length,
+    };
 }
 function normalizeLinguistLanguage(language, value, repositoryMetadata) {
     const name = text(language);
@@ -158,10 +179,52 @@ function normalizeLinguistResults(result, target) {
 }
 async function readRepositoryLinguist(repository, options = {}) {
     await assertRepositoryReady(repository);
-    const target = await resolveCommitForRef(repository.path, text(options.ref, "HEAD"), "Repository ref does not exist.");
-    const input = await readRepositoryLinguistInput(repository, target.ref);
-    const result = await analyseRawContent(input, { offline: true });
-    return normalizeLinguistResults(result, target);
+    const progress = createLinguistProgressReporter({
+        onProgress: options.onProgress,
+        ref: text(options.ref, "HEAD"),
+        repository,
+    });
+    let target = {
+        commit: "",
+        ref: text(options.ref, "HEAD"),
+    };
+    try {
+        await progress.emit("queued");
+        await progress.emit("resolving_ref", { ref: target.ref });
+        target = await resolveCommitForRef(repository.path, target.ref, "Repository ref does not exist.");
+        await progress.emit("listing_tree", { commit: target.commit, ref: target.ref });
+        const linguistInput = await readRepositoryLinguistInput(repository, target.ref, progress.emit);
+        await progress.emit("analyzing", {
+            commit: target.commit,
+            processed_blobs: linguistInput.total_blobs,
+            ref: target.ref,
+            total_blobs: linguistInput.total_blobs,
+            total_entries: linguistInput.total_entries,
+        });
+        const result = await analyseRawContent(linguistInput.input, { offline: true });
+        const normalized = normalizeLinguistResults(result, target);
+        await progress.emit("completed", {
+            commit: target.commit,
+            processed_blobs: linguistInput.total_blobs,
+            ref: target.ref,
+            total_blobs: linguistInput.total_blobs,
+            total_entries: linguistInput.total_entries,
+        });
+        return normalized;
+    }
+    catch (error) {
+        await progress.emit("failed", {
+            commit: text(target.commit) || undefined,
+            error: {
+                code: isGitHostError(error) ? error.code : (error instanceof Error ? "internal_error" : "internal_error"),
+                message: error instanceof Error ? error.message : "Linguist scan failed.",
+            },
+            ref: target.ref,
+        }).catch(() => {
+            return undefined;
+        });
+        throw error;
+    }
 }
 async function listRepositoryTree(repository, options = {}) {
     await assertRepositoryReady(repository);
@@ -174,7 +237,10 @@ async function listRepositoryTree(repository, options = {}) {
     if (options.icons !== true && options.linguist !== true)
         return entries;
     const linguist = options.linguist === true
-        ? await readRepositoryLinguist(repository, { ref })
+        ? await readRepositoryLinguist(repository, {
+            onProgress: options.onLinguistProgress,
+            ref,
+        })
         : null;
     return entries.map((entry) => ({
         ...entry,