nano-git 0.1.0

package/dist/transport/server/upload-pack/ls-refs.mjs

@@ -0,0 +1,113 @@
+import { sha1 } from "../../../core/types.mjs";
+import { tryReadObject } from "../../../objects/raw.mjs";
+import { resolveRefHash } from "../../../refs/resolve.mjs";
+import { encodeFlushPkt, encodePktLine } from "../../protocol/pkt-line.mjs";
+//#region src/transport/server/upload-pack/ls-refs.ts
+/**
+* v2 ls-refs 命令响应生成
+*
+* 处理 ls-refs 命令，按 ref-prefix 过滤并生成 ref 列表响应。
+*
+* @see https://git-scm.com/docs/protocol-v2#_ls_refs
+*/
+/**
+* 从 args 中解析 ls-refs 选项
+*
+* @param args - ls-refs 命令的 args 列表
+* @returns 结构化的 ls-refs 选项
+*
+* @example
+* ```ts
+* const opts = parseLsRefsArgs(["symrefs", "peel", "ref-prefix refs/heads/"]);
+* // { symrefs: true, peel: true, unborn: false, refPrefixes: ["refs/heads/"] }
+* ```
+*/
+function parseLsRefsArgs(args) {
+	const prefixes = [];
+	for (const arg of args) if (arg.startsWith("ref-prefix ")) prefixes.push(arg.slice(11).trim());
+	return {
+		symrefs: args.includes("symrefs"),
+		peel: args.includes("peel"),
+		unborn: args.includes("unborn"),
+		refPrefixes: prefixes
+	};
+}
+/**
+* 读取仓库中的所有引用
+*
+* 包含 HEAD 和 refs/ 下的所有引用，返回名称到原始内容的映射。
+* 原始内容可能是 SHA-1 哈希或以 "ref: " 开头的符号引用。
+*/
+function readAllRefs(backend) {
+	const result = /* @__PURE__ */ new Map();
+	const headContent = backend.refs.read("HEAD");
+	if (headContent !== null) result.set("HEAD", headContent);
+	const refNames = backend.refs.listAll();
+	for (const ref of refNames) {
+		const content = backend.refs.read(ref);
+		if (content !== null) result.set(ref, content);
+	}
+	return result;
+}
+/**
+* 按 ref-prefix 过滤引用
+*
+* HEAD 始终包含（因为它可能符号引用到 unborn branch）。
+*/
+function filterRefsByPrefix(refs, prefixes) {
+	if (prefixes.length === 0) return refs;
+	const result = /* @__PURE__ */ new Map();
+	for (const [name, content] of refs) {
+		if (name === "HEAD") {
+			result.set(name, content);
+			continue;
+		}
+		for (const prefix of prefixes) if (name.startsWith(prefix)) {
+			result.set(name, content);
+			break;
+		}
+	}
+	return result;
+}
+/**
+* 生成 ls-refs 响应
+*
+* @param backend - 仓库后端
+* @param options - ls-refs 选项
+* @returns pkt-line 编码的 ls-refs 响应
+*
+* @example
+* ```ts
+* const buf = generateLsRefsResponse(backend, { symrefs: true, peel: true, unborn: false, refPrefixes: [] });
+* ```
+*/
+function generateLsRefsResponse(backend, options) {
+	const filtered = filterRefsByPrefix(readAllRefs(backend), options.refPrefixes);
+	const lines = [];
+	for (const [refName, content] of filtered) {
+		if (content === null || content.length === 0) continue;
+		if (content.startsWith("ref: ")) {
+			const target = content.slice(5);
+			const resolved = resolveRefHash(backend.refs, refName);
+			if (resolved === null && !options.unborn) continue;
+			const oid = resolved ?? "unborn";
+			const attrs = [];
+			if (options.symrefs) attrs.push(`symref-target:${target}`);
+			const attrStr = attrs.length > 0 ? ` ${attrs.join(" ")}` : "";
+			lines.push(encodePktLine(`${oid} ${refName}${attrStr}\n`));
+		} else if (/^[0-9a-f]{40}$/.test(content)) {
+			const oid = sha1(content);
+			const attrs = [];
+			if (options.peel && refName.startsWith("refs/tags/")) {
+				const obj = tryReadObject(backend.objects, oid);
+				if (obj?.type === "tag") attrs.push(`peeled:${obj.object}`);
+			}
+			const attrStr = attrs.length > 0 ? ` ${attrs.join(" ")}` : "";
+			lines.push(encodePktLine(`${oid} ${refName}${attrStr}\n`));
+		}
+	}
+	lines.push(encodeFlushPkt());
+	return Buffer.concat(lines);
+}
+//#endregion
+export { generateLsRefsResponse, parseLsRefsArgs };

package/dist/transport/server/upload-pack/service.d.mts

@@ -0,0 +1,40 @@
+import { RepositoryBackend } from "../../../backend/types.mjs";
+
+//#region src/transport/server/upload-pack/service.d.ts
+/**
+ * Upload-Pack 服务接口
+ *
+ * 提供协议无关的 upload-pack 能力:
+ * - advertise(): 生成服务能力广告
+ * - handleRequest(): 处理客户端请求
+ */
+interface UploadPackService {
+  /**
+   * 生成能力广告
+   */
+  advertise(): Buffer;
+  /**
+   * 处理请求
+   *
+   * @param body - 客户端请求体（pkt-line 编码）
+   * @returns 服务端响应（pkt-line 编码）
+   * @throws {UploadPackServiceError} 命令不支持或参数不合法
+   */
+  handleRequest(body: Buffer): Buffer;
+}
+/**
+ * 创建 Upload-Pack 服务实例
+ *
+ * @param backend - 仓库后端
+ * @returns UploadPackService 实例
+ *
+ * @example
+ * ```ts
+ * const service = createUploadPackService(backend);
+ * const advertise = service.advertise();
+ * const response = service.handleRequest(body);
+ * ```
+ */
+declare function createUploadPackService(backend: RepositoryBackend): UploadPackService;
+//#endregion
+export { UploadPackService, createUploadPackService };

package/dist/transport/server/upload-pack/service.mjs

@@ -0,0 +1,51 @@
+import { UploadPackServiceError } from "./types.mjs";
+import { advertiseUploadPack } from "./advertise.mjs";
+import { parseCommandRequest } from "./command.mjs";
+import { generateLsRefsResponse, parseLsRefsArgs } from "./ls-refs.mjs";
+import { generateFetchResponse, parseFetchArgs } from "./fetch.mjs";
+//#region src/transport/server/upload-pack/service.ts
+/**
+* upload-pack 服务编排器
+*
+* 聚合 Git Wire 协议的服务端 upload-pack 能力：
+* - 能力广告生成
+* - ls-refs / fetch 命令处理
+*
+* 协议实现细节（v2 协议原语）在各子模块中维护，
+* 本文件仅提供协议无关的服务接口和工厂。
+*/
+/**
+* 创建 Upload-Pack 服务实例
+*
+* @param backend - 仓库后端
+* @returns UploadPackService 实例
+*
+* @example
+* ```ts
+* const service = createUploadPackService(backend);
+* const advertise = service.advertise();
+* const response = service.handleRequest(body);
+* ```
+*/
+function createUploadPackService(backend) {
+	return {
+		advertise() {
+			return advertiseUploadPack();
+		},
+		handleRequest(body) {
+			const parsed = parseCommandRequest(body);
+			try {
+				switch (parsed.command) {
+					case "ls-refs": return generateLsRefsResponse(backend, parseLsRefsArgs(parsed.args));
+					case "fetch": return generateFetchResponse(backend, parseFetchArgs(parsed.args));
+					default: throw new UploadPackServiceError(`unknown command: ${parsed.command}`);
+				}
+			} catch (err) {
+				if (err instanceof UploadPackServiceError) throw err;
+				throw err;
+			}
+		}
+	};
+}
+//#endregion
+export { createUploadPackService };

package/dist/transport/server/upload-pack/types.d.mts

@@ -0,0 +1,11 @@
+//#region src/transport/server/upload-pack/types.d.ts
+/**
+ * upload-pack 服务错误
+ *
+ * 当服务端处理请求时遇到可预见的错误情况抛出。
+ */
+declare class UploadPackServiceError extends Error {
+  constructor(message: string);
+}
+//#endregion
+export { UploadPackServiceError };

package/dist/transport/server/upload-pack/types.mjs

@@ -0,0 +1,21 @@
+//#region src/transport/server/upload-pack/types.ts
+/**
+* upload-pack 服务端类型定义与常量
+*/
+/** 服务端 agent 字符串 */
+const SERVER_AGENT = "nano-git/0.1";
+/** pkt-line 单帧最大负载字节数 */
+const MAX_PKT_PAYLOAD = 65520;
+/**
+* upload-pack 服务错误
+*
+* 当服务端处理请求时遇到可预见的错误情况抛出。
+*/
+var UploadPackServiceError = class extends Error {
+	constructor(message) {
+		super(`upload-pack: ${message}`);
+		this.name = "UploadPackServiceError";
+	}
+};
+//#endregion
+export { MAX_PKT_PAYLOAD, SERVER_AGENT, UploadPackServiceError };

package/dist/transport/upload-pack.d.mts

@@ -0,0 +1,7 @@
+import { LsRefsEntry, ObjectInfoEntry, ObjectInfoResponse, V2CapabilityAdvertisement, V2CommandEntry, V2FetchRequest, V2FetchResponse, V2GitServiceTransport } from "./client/upload-pack/types.mjs";
+import { ObjectInfoError, ObjectInfoQueryResult, ObjectInfoResult, objectInfo, parseObjectInfoResponse } from "./client/upload-pack/object-info.mjs";
+import { V2CapabilityError, getCommandFeatures, hasCommand, parseV2CapabilityAdvertisement } from "./client/upload-pack/capability-advertisement.mjs";
+import { V2SmartHttpError, createV2HttpTransport } from "./client/upload-pack/http.mjs";
+import { LsRefsError, LsRefsOptions, lsRefs, lsRefsToRefAdvertisement, parseLsRefsResponse } from "./client/upload-pack/ls-refs.mjs";
+import { V2FetchError, V2FetchParams, parseV2FetchResponse, v2Fetch, v2FetchObjects } from "./client/upload-pack/fetch.mjs";
+export { type LsRefsEntry, LsRefsError, type LsRefsOptions, type ObjectInfoEntry, ObjectInfoError, type ObjectInfoQueryResult, type ObjectInfoResponse, type ObjectInfoResult, type V2CapabilityAdvertisement, V2CapabilityError, type V2CommandEntry, V2FetchError, type V2FetchParams, type V2FetchRequest, type V2FetchResponse, type V2GitServiceTransport, V2SmartHttpError, createV2HttpTransport, getCommandFeatures, hasCommand, lsRefs, lsRefsToRefAdvertisement, objectInfo, parseLsRefsResponse, parseObjectInfoResponse, parseV2CapabilityAdvertisement, parseV2FetchResponse, v2Fetch, v2FetchObjects };

package/dist/transport/upload-pack.mjs

@@ -0,0 +1,6 @@
+import { V2CapabilityError, getCommandFeatures, hasCommand, parseV2CapabilityAdvertisement } from "./client/upload-pack/capability-advertisement.mjs";
+import { V2SmartHttpError, createV2HttpTransport } from "./client/upload-pack/http.mjs";
+import { LsRefsError, lsRefs, lsRefsToRefAdvertisement, parseLsRefsResponse } from "./client/upload-pack/ls-refs.mjs";
+import { V2FetchError, parseV2FetchResponse, v2Fetch, v2FetchObjects } from "./client/upload-pack/fetch.mjs";
+import { ObjectInfoError, objectInfo, parseObjectInfoResponse } from "./client/upload-pack/object-info.mjs";
+export { LsRefsError, ObjectInfoError, V2CapabilityError, V2FetchError, V2SmartHttpError, createV2HttpTransport, getCommandFeatures, hasCommand, lsRefs, lsRefsToRefAdvertisement, objectInfo, parseLsRefsResponse, parseObjectInfoResponse, parseV2CapabilityAdvertisement, parseV2FetchResponse, v2Fetch, v2FetchObjects };

package/package.json

@@ -0,0 +1,98 @@
+{
+  "name": "nano-git",
+  "version": "0.1.0",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts",
+    "./backend": "./src/backend/index.ts",
+    "./backend/file": "./src/backend/file.ts",
+    "./backend/memory": "./src/backend/memory.ts",
+    "./errors": "./src/errors.ts",
+    "./hash-file": "./src/hash-file.ts",
+    "./objects": "./src/objects/index.ts",
+    "./odb/file": "./src/odb/file.ts",
+    "./odb/memory": "./src/odb/memory.ts",
+    "./pack": "./src/pack/index.ts",
+    "./refs/file": "./src/refs/file.ts",
+    "./refs/memory": "./src/refs/memory.ts",
+    "./refs/names": "./src/refs/names.ts",
+    "./refs/resolve": "./src/refs/resolve.ts",
+    "./refs/shallow/file": "./src/refs/shallow/file.ts",
+    "./refs/shallow/memory": "./src/refs/shallow/memory.ts",
+    "./repository/core": "./src/repository/core.ts",
+    "./repository/file": "./src/repository/file.ts",
+    "./repository/memory": "./src/repository/memory.ts",
+    "./repository/tree/tree-patch": "./src/repository/tree/tree-patch.ts",
+    "./repository/tree/tree-walk": "./src/repository/tree/tree-walk.ts",
+    "./sha1": "./src/sha1.ts",
+    "./transport": "./src/transport/index.ts",
+    "./transport/http": "./src/transport/http/index.ts",
+    "./transport/receive-pack": "./src/transport/receive-pack.ts",
+    "./transport/server/receive-pack": "./src/transport/server/receive-pack/index.ts",
+    "./transport/server/upload-pack": "./src/transport/server/upload-pack/index.ts",
+    "./transport/upload-pack": "./src/transport/upload-pack.ts"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.mjs",
+      "./backend": "./dist/backend/index.mjs",
+      "./backend/file": "./dist/backend/file.mjs",
+      "./backend/memory": "./dist/backend/memory.mjs",
+      "./errors": "./dist/errors.mjs",
+      "./hash-file": "./dist/hash-file.mjs",
+      "./objects": "./dist/objects/index.mjs",
+      "./odb/file": "./dist/odb/file.mjs",
+      "./odb/memory": "./dist/odb/memory.mjs",
+      "./pack": "./dist/pack/index.mjs",
+      "./refs/file": "./dist/refs/file.mjs",
+      "./refs/memory": "./dist/refs/memory.mjs",
+      "./refs/names": "./dist/refs/names.mjs",
+      "./refs/resolve": "./dist/refs/resolve.mjs",
+      "./refs/shallow/file": "./dist/refs/shallow/file.mjs",
+      "./refs/shallow/memory": "./dist/refs/shallow/memory.mjs",
+      "./repository/core": "./dist/repository/core.mjs",
+      "./repository/file": "./dist/repository/file.mjs",
+      "./repository/memory": "./dist/repository/memory.mjs",
+      "./repository/tree/tree-patch": "./dist/repository/tree/tree-patch.mjs",
+      "./repository/tree/tree-walk": "./dist/repository/tree/tree-walk.mjs",
+      "./sha1": "./dist/sha1.mjs",
+      "./transport": "./dist/transport/index.mjs",
+      "./transport/http": "./dist/transport/http/index.mjs",
+      "./transport/receive-pack": "./dist/transport/receive-pack.mjs",
+      "./transport/server/receive-pack": "./dist/transport/server/receive-pack/index.mjs",
+      "./transport/server/upload-pack": "./dist/transport/server/upload-pack/index.mjs",
+      "./transport/upload-pack": "./dist/transport/upload-pack.mjs"
+    }
+  },
+  "scripts": {
+    "build": "tsdown",
+    "lint": "oxlint .",
+    "format": "oxfmt .",
+    "format:check": "oxfmt --check .",
+    "test": "bun test",
+    "prepublishOnly": "bun run build",
+    "prepare": "husky"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "husky": "^9.1.7",
+    "lint-staged": "^17.0.7",
+    "oxfmt": "^0.55.0",
+    "oxlint": "^1.70.0",
+    "oxlint-tsgolint": "^0.23.0",
+    "tsdown": "^0.22.3"
+  },
+  "peerDependencies": {
+    "typescript": "^6"
+  },
+  "lint-staged": {
+    "*": [
+      "oxlint --fix --no-error-on-unmatched-pattern",
+      "oxfmt --no-error-on-unmatched-pattern"
+    ]
+  }
+}