@trebired/git-host 0.1.0 → 1.0.0

package/CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to `@trebired/git-host` will be documented here.
 
 This project follows semantic versioning once published.
 
+## Unreleased
+
+## 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.
+- Added blame, search, and archive reads for deeper repository inspection.
+- Added merge, rebase, and cherry-pick start helpers to the core host API.
+- Added JSON API routes, typed client methods, and React hooks for linguist, tags, blame, search, archive, and enriched tree reads.
+- Added tests and README coverage for the expanded repository inspection surface.
+
 ## 0.1.0
 
 - Added the initial `@trebired/git-host` package scaffold with publishable metadata, README, MIT license, contribution guide, and TypeScript build setup.

package/README.md

@@ -1,6 +1,6 @@
 # @trebired/git-host
 
-Embeddable Git host for Node.js and Bun apps.
+Embeddable Git host for Node.js and Bun apps with real Git CLI execution, smart HTTP and SSH transports, repository inspection APIs, and optional React helpers.
 
 `@trebired/git-host` gives your app real Git repository operations and real Git transports without making you adopt a full forge product. It runs the real Git CLI, helps you resolve repository paths safely, serializes mutations per repository, and exposes a reusable API for repository initialization, summary reads, content inspection, branch operations, working-tree changes, remote sync helpers, JSON API handlers, and smart HTTP and SSH hosting.
 
@@ -70,6 +70,38 @@ await gitHost.ensureRepository("demo", {
 const summary = await gitHost.readSummary("demo");
 console.log(summary.repository.current_branch);
 
+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", {
+  ref: "main",
+  recursive: true,
+  linguist: true,
+  icons: true,
+});
+console.log(tree[0]?.language, Boolean(tree[0]?.icon));
+
+const tags = await gitHost.listTags("demo");
+const blame = await gitHost.readBlame("demo", {
+  ref: "main",
+  path: "src/app.ts",
+});
+const search = await gitHost.search("demo", {
+  ref: "main",
+  path: "src",
+  query: "value",
+});
+const archive = await gitHost.readArchive("demo", {
+  ref: "main",
+  format: "zip",
+});
+console.log(tags.length, blame.lines[0]?.author_name, search.match_count, archive.file_name);
+
 const workingTree = await gitHost.readWorkingTree("demo");
 console.log(workingTree.unstaged_entries);
 
@@ -171,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({
@@ -198,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);
 ```
 
@@ -206,17 +248,23 @@ Then apps can use routes like:
 ```txt
 GET /api/git/repositories/demo/summary
 GET /api/git/repositories/demo/branches
-GET /api/git/repositories/demo/commits?limit=20
+GET /api/git/repositories/demo/commits?limit=20&ref=main&path=src/app.ts
 GET /api/git/repositories/demo/commits/<commit-ref>
-GET /api/git/repositories/demo/tree?ref=HEAD&path=src
+GET /api/git/repositories/demo/tags
+GET /api/git/repositories/demo/tags/v1
+GET /api/git/repositories/demo/tree?ref=HEAD&path=src&linguist=true&icons=true
+GET /api/git/repositories/demo/linguist?ref=HEAD
+GET /api/git/repositories/demo/blame?ref=HEAD&path=src/app.ts
+GET /api/git/repositories/demo/search?ref=HEAD&path=src&query=value
+GET /api/git/repositories/demo/archive?ref=HEAD&format=zip
 GET /api/git/repositories/demo/blob?ref=HEAD&path=README.md
-GET /api/git/repositories/demo/diff?baseRef=main&headRef=feature%2Fx
+GET /api/git/repositories/demo/diff?baseRef=main&headRef=feature%2Fx&path=src
 ```
 
 React companion:
 
 ```ts
-import { createGitApiClient, GitApiClientProvider, useGitRepositorySummary } from "@trebired/git-host/react";
+import { createGitApiClient, GitApiClientProvider, useGitLinguist, useGitRepositorySummary } from "@trebired/git-host/react";
 
 const gitClient = createGitApiClient({
   baseUrl: "/api/git",
@@ -224,12 +272,13 @@ const gitClient = createGitApiClient({
 
 function RepositorySummaryCard() {
   const summary = useGitRepositorySummary("demo");
+  const linguist = useGitLinguist("demo", { ref: "main" });
 
   if (summary.loading) return "Loading...";
   if (summary.error) return summary.error.message;
   if (!summary.data) return "Missing repository";
 
-  return `${summary.data.repository.current_branch} @ ${summary.data.repository.head_short}`;
+  return `${summary.data.repository.current_branch} @ ${summary.data.repository.head_short} (${Object.keys(linguist.data?.languages.results || {}).length} languages)`;
 }
 
 function App() {
@@ -241,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
@@ -253,6 +318,7 @@ The first public slice is intentionally small:
 - `buildGitEnv()`
 - `RepositoryLockManager`
 - `createGitApiHandler()`
+- `createGitApiSocketServer()`
 - `createGitHttpHandler()`
 - `generateSshKeyPair()`
 - `normalizeSshPublicKey()`
@@ -267,21 +333,32 @@ And the main host instance methods:
 - `readSummary()`
 - `listBranches()`
 - `listCommits()`
+- `listTags()`
 - `listTree()`
+- `readLinguist()`
+- `readBlame()`
+- `search()`
+- `readArchive()`
 - `readBlob()`
 - `readCommit()`
+- `readTag()`
 - `diff()`
 - `readWorkingTree()`
 - `readStagedFile()`
 - `readUnstagedFile()`
 - `createBranch()`
+- `createTag()`
 - `checkoutBranch()`
 - `checkoutRef()`
 - `deleteBranch()`
+- `deleteTag()`
 - `stagePaths()`
 - `unstagePaths()`
 - `discardPaths()`
 - `commit()`
+- `merge()`
+- `rebase()`
+- `cherryPick()`
 - `continueOperation()`
 - `abortOperation()`
 - `fetch()`
@@ -293,11 +370,18 @@ The React entry currently exports:
 
 - `createGitApiClient()`
 - `GitApiClientProvider`
+- `openLinguistSocket()` through the typed client instance
 - `useGitRepositorySummary()`
 - `useGitBranches()`
 - `useGitCommits()`
 - `useGitCommit()`
+- `useGitTags()`
+- `useGitTag()`
 - `useGitTree()`
+- `useGitLinguist()`
+- `useGitBlame()`
+- `useGitSearch()`
+- `useGitArchive()`
 - `useGitBlob()`
 - `useGitDiff()`
 - `useGitApiQuery()`
@@ -360,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
@@ -370,8 +455,8 @@ The package is meant to replace or simplify:
 
 - Git CLI execution and environment shaping
 - repository locking and mutation coordination
-- repository summary, tree, blob, commit, diff, and working-tree reads
-- branch, checkout, commit, fetch, pull, and push operations
+- repository summary, tree, linguist, blame, search, archive, blob, commit, diff, and working-tree reads
+- branch, tag, checkout, commit, merge, rebase, cherry-pick, fetch, pull, and push operations
 - smart HTTP and SSH Git transport handling
 - thin JSON API route internals around those Git operations
 
@@ -403,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/handler/action.d.ts

@@ -1,5 +1,5 @@
 import type { CreateGitApiHandlerOptions } from "../../types.js";
 import { parseGitApiRoute } from "./route.js";
-declare function runGitApiAction(options: CreateGitApiHandlerOptions, route: ReturnType<typeof parseGitApiRoute>, repositoryId: string, searchParams: URLSearchParams): Promise<import("../../types.js").GitCommitDetail | import("../../types.js").GitCommitSummary[] | import("../../types.js").GitCompareSummary | import("../../types.js").GitBlob | import("../../types.js").GitBranchSummary[] | import("../../types.js").GitRepositorySummary | import("../../types.js").GitTreeEntry[]>;
+declare function runGitApiAction(options: CreateGitApiHandlerOptions, route: ReturnType<typeof parseGitApiRoute>, repositoryId: string, searchParams: URLSearchParams): Promise<import("../../types.js").GitCommitDetail | import("../../types.js").GitCommitSummary[] | import("../../types.js").GitCompareSummary | import("../../types.js").GitTagDetail | import("../../types.js").GitBlame | import("../../types.js").GitSearchResult | import("../../types.js").GitBlob | import("../../types.js").GitArchive | import("../../types.js").GitBranchSummary[] | import("../../types.js").GitRepositorySummary | import("../../types.js").GitRepositoryLinguist | import("../../types.js").GitTagSummary[] | import("../../types.js").GitTreeEntry[]>;
 export { runGitApiAction };
 //# sourceMappingURL=action.d.ts.map

package/dist/api/handler/action.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/api/handler/action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,iBAAe,eAAe,CAC5B,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAC1C,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,eAAe,2TAwC9B;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"action.d.ts","sourceRoot":"","sources":["../../../src/api/handler/action.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAGjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE9C,iBAAe,eAAe,CAC5B,OAAO,EAAE,0BAA0B,EACnC,KAAK,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,EAC1C,YAAY,EAAE,MAAM,EACpB,YAAY,EAAE,eAAe,ojBAkF9B;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}

package/dist/api/handler/action.js

@@ -14,15 +14,55 @@ async function runGitApiAction(options, route, repositoryId, searchParams) {
         case "commits":
             return await options.gitHost.listCommits(repositoryId, {
                 limit: parsePositiveInt(searchParams.get("limit"), "limit"),
+                path: text(searchParams.get("path")),
+                ref: text(searchParams.get("ref")),
             });
         case "commit":
             return await options.gitHost.readCommit(repositoryId, route.commitRef);
+        case "tags":
+            return await options.gitHost.listTags(repositoryId);
+        case "tag":
+            return await options.gitHost.readTag(repositoryId, route.tagName);
         case "tree":
             return await options.gitHost.listTree(repositoryId, {
+                icons: isTruthy(searchParams.get("icons")),
+                linguist: isTruthy(searchParams.get("linguist")),
                 path: text(searchParams.get("path")),
                 recursive: isTruthy(searchParams.get("recursive")),
                 ref: text(searchParams.get("ref")),
             });
+        case "blame": {
+            const blamePath = text(searchParams.get("path"));
+            if (!blamePath)
+                throw new GitHostError("invalid_repository_path", "blame path is required.");
+            return await options.gitHost.readBlame(repositoryId, {
+                path: blamePath,
+                ref: text(searchParams.get("ref")),
+            });
+        }
+        case "search": {
+            const query = text(searchParams.get("query"));
+            if (!query)
+                throw new GitHostError("git_command_failed", "query is required.");
+            return await options.gitHost.search(repositoryId, {
+                caseSensitive: searchParams.has("caseSensitive") ? isTruthy(searchParams.get("caseSensitive")) : undefined,
+                limit: parsePositiveInt(searchParams.get("limit"), "limit"),
+                path: text(searchParams.get("path")),
+                query,
+                ref: text(searchParams.get("ref")),
+                regexp: searchParams.has("regexp") ? isTruthy(searchParams.get("regexp")) : undefined,
+            });
+        }
+        case "archive":
+            return await options.gitHost.readArchive(repositoryId, {
+                format: text(searchParams.get("format")) === "zip" ? "zip" : undefined,
+                prefix: text(searchParams.get("prefix")),
+                ref: text(searchParams.get("ref")),
+            });
+        case "linguist":
+            return await options.gitHost.readLinguist(repositoryId, {
+                ref: text(searchParams.get("ref")),
+            });
         case "blob": {
             const blobPath = text(searchParams.get("path"));
             if (!blobPath)
@@ -37,7 +77,11 @@ async function runGitApiAction(options, route, repositoryId, searchParams) {
             const headRef = text(searchParams.get("headRef"));
             if (!baseRef || !headRef)
                 throw new GitHostError("git_command_failed", "baseRef and headRef are required.");
-            return await options.gitHost.diff(repositoryId, { baseRef, headRef });
+            return await options.gitHost.diff(repositoryId, {
+                baseRef,
+                headRef,
+                path: text(searchParams.get("path")),
+            });
         }
         default:
             throw new GitHostError("git_command_failed", "Unsupported Git API action.");

package/dist/api/handler/action.js.map

@@ -1 +1 @@
-{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../src/api/handler/action.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGjD,KAAK,UAAU,eAAe,CAC5B,OAAmC,EACnC,KAA0C,EAC1C,YAAoB,EACpB,YAA6B;IAE7B,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,wBAAwB,CAAC,CAAC;IAEnF,QAAQ,KAAK,CAAC,MAAM,EAAE,CAAC;QACrB,KAAK,SAAS;YACZ,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE;gBACrD,WAAW,EAAE,gBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;aAC9E,CAAC,CAAC;QACL,KAAK,UAAU;YACb,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;QAC1D,KAAK,SAAS;YACZ,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE;gBACrD,KAAK,EAAE,gBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;aAC5D,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACzE,KAAK,MAAM;YACT,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE;gBAClD,IAAI,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBACpC,SAAS,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBAClD,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;aACnC,CAAC,CAAC;QACL,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YAChD,IAAI,CAAC,QAAQ;gBAAE,MAAM,IAAI,YAAY,CAAC,yBAAyB,EAAE,wBAAwB,CAAC,CAAC;YAC3F,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE;gBAClD,IAAI,EAAE,QAAQ;gBACd,GAAG,EAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;aACnC,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YAClD,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,mCAAmC,CAAC,CAAC;YAC5G,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QACxE,CAAC;QACD;YACE,MAAM,IAAI,YAAY,CAAC,oBAAoB,EAAE,6BAA6B,CAAC,CAAC;IAChF,CAAC;AACH,CAAC;AAED,OAAO,EAAE,eAAe,EAAE,CAAC"}
+{"version":3,"file":"action.js","sourceRoot":"","sources":["../../../src/api/handler/action.ts"],"names":[],"mappings":"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"}

package/dist/api/handler/route.d.ts

@@ -1,15 +1,28 @@
 declare function parseGitApiRoute(pathnameInput: unknown, basePathInput: unknown): {
-    action: "blob" | "branches" | "diff" | "summary" | "tree";
+    action: "archive" | "blame" | "blob" | "branches" | "diff" | "linguist" | "search" | "summary" | "tree";
     repositoryKey: string;
     commitRef?: undefined;
+    tagName?: undefined;
 } | {
     action: "commits";
     repositoryKey: string;
     commitRef?: undefined;
+    tagName?: undefined;
 } | {
     action: "commit";
     commitRef: string;
     repositoryKey: string;
+    tagName?: undefined;
+} | {
+    action: "tags";
+    repositoryKey: string;
+    commitRef?: undefined;
+    tagName?: undefined;
+} | {
+    action: "tag";
+    repositoryKey: string;
+    tagName: string;
+    commitRef?: undefined;
 };
 export { parseGitApiRoute };
 //# sourceMappingURL=route.d.ts.map

package/dist/api/handler/route.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/api/handler/route.ts"],"names":[],"mappings":"AAiBA,iBAAS,gBAAgB,CAAC,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO;;;;;;;;;;;;EAgCvE;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"route.d.ts","sourceRoot":"","sources":["../../../src/api/handler/route.ts"],"names":[],"mappings":"AAiBA,iBAAS,gBAAgB,CAAC,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;EAmDvE;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/api/handler/route.js

@@ -30,7 +30,15 @@ function parseGitApiRoute(pathnameInput, basePathInput) {
     if (!repositoryKey)
         return null;
     const action = text(segments[2]);
-    if (action === "summary" || action === "branches" || action === "tree" || action === "blob" || action === "diff") {
+    if (action === "summary"
+        || action === "branches"
+        || action === "tree"
+        || action === "blob"
+        || action === "diff"
+        || action === "linguist"
+        || action === "blame"
+        || action === "search"
+        || action === "archive") {
         if (segments.length !== 3)
             return null;
         return { action, repositoryKey };
@@ -45,6 +53,16 @@ function parseGitApiRoute(pathnameInput, basePathInput) {
             return { action: "commit", commitRef, repositoryKey };
         }
     }
+    if (action === "tags") {
+        if (segments.length === 3)
+            return { action, repositoryKey };
+        if (segments.length === 4) {
+            const tagName = decodeRouteSegment(segments[3] || "");
+            if (!tagName)
+                return null;
+            return { action: "tag", repositoryKey, tagName };
+        }
+    }
     return null;
 }
 export { parseGitApiRoute };

package/dist/api/handler/route.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../src/api/handler/route.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C,SAAS,iBAAiB,CAAC,KAAc;IACvC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG;QAAE,OAAO,EAAE,CAAC;IACrC,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,aAAsB,EAAE,aAAsB;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IAClD,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC,IAAI,QAAQ,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3F,MAAM,SAAS,GAAG,QAAQ;QACxB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACrD,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACtD,IAAI,QAAQ,CAAC,CAAC,CAAC,KAAK,cAAc,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAEvE,MAAM,aAAa,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC5D,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAA+B,CAAC;IAC/D,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,UAAU,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACjH,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnC,CAAC;IAED,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAC5D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,MAAM,SAAS,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,QAAiB,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC;QACjE,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,OAAO,EAAE,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"route.js","sourceRoot":"","sources":["../../../src/api/handler/route.ts"],"names":[],"mappings":"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"}

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/create_git_host/branch_methods.d.ts

@@ -1,5 +1,5 @@
 import type { GitHost } from "../../types.js";
 import type { GitHostMethodContext } from "./shared.js";
-declare function createBranchMethods(context: GitHostMethodContext): Pick<GitHost, "checkoutBranch" | "checkoutRef" | "createBranch" | "deleteBranch" | "listBranches" | "listCommits">;
+declare function createBranchMethods(context: GitHostMethodContext): Pick<GitHost, "checkoutBranch" | "checkoutRef" | "createBranch" | "createTag" | "deleteBranch" | "deleteTag" | "listBranches" | "listCommits" | "listTags" | "readTag">;
 export { createBranchMethods };
 //# sourceMappingURL=branch_methods.d.ts.map