@canyonjs/git-provider 0.0.1 → 0.0.2

package/README.md

@@ -1,49 +1,81 @@
-# git-provider
+# @canyonjs/git-provider
 
-统一封装 GitHub / GitLab / Gitea 的常见仓库 API。
+面向 **Git 托管平台（GitLab / GitHub）** 的轻量 TypeScript 客户端库。通过对外的 **`ScmAdapter`** 接口屏蔽平台差异：业务代码只依赖「仓库信息与两个引用之间的 Compare 结果」，由工厂方法按配置选择具体适配器。
 
-## Development
+## 能力与现状
 
-- Install dependencies:
+| 能力 | GitLab | GitHub |
+| --- | --- | --- |
+| `getRepoInfo` | 支持（Project API） | 支持（`owner/repo` 或数字仓库 id） |
+| `getCompare` | **已实现**：比较 API + 逐文件 Raw 内容与行级差异 | **未实现**（调用会抛错） |
 
-```bash
-npm install
-```
+`getCompare` 返回结构化结果 **`Compare`**：
+
+- **`commitList`**：`base` … `head` 范围内涉及的提交 id（来源 GitLab `repository/compare`）。
+- **`changedFiles`**：**仅保留扩展名为 `tsx` / `ts` / `jsx` / `js` 的文件**；每项含 **`path`** 以及 **`additions` / `deletions` 行号列表**（由 `diff` 对两侧全文做逐行比对得到）。不支持 Windows 路径风格，假定仓库路径均为 POSIX `/`。
+
+GitLab 侧会处理 **重命名**：在 `base` 与 `head` 上分别按 **旧路径 / 新路径** 拉取 Raw，再在统一展示路径上与行号结果对齐。
 
-- Run the unit tests:
+## 依赖与请求
+
+- 运行时依赖：**[`diff`](https://www.npmjs.com/package/diff)**（行级比对）。
+- HTTP 使用全局 **`fetch`**（见 `src/request.ts`），按需配置超时等。
+
+## 安装
 
 ```bash
-npm run test
+pnpm add @canyonjs/git-provider
 ```
 
-- Build the library:
+若从源码开发与联调：
 
 ```bash
-npm run build
+pnpm install
+pnpm run build
 ```
 
-## Usage
+## 用法示例
 
 ```ts
-import { createGitProviderClient } from 'git-provider'
-
-const client = createGitProviderClient({
-  provider: 'gitlab', // 'github' | 'gitlab' | 'gitea'
-  token: process.env.GIT_TOKEN
-})
+import {
+  createScmAdapter,
+  type Compare,
+  type ScmConfig,
+} from "@canyonjs/git-provider";
 
-// 1) 根据 id 或 owner/repo 获取仓库摘要
-const repo = await client.getRepositorySummary('canyon-project/canyon')
+const config: ScmConfig = {
+  type: "gitlab",
+  base: "https://gitlab.example.com",
+  token: process.env.GITLAB_TOKEN!,
+};
 
-// 2) 获取 commit 摘要
-const commit = await client.getCommitSummary('canyon-project/canyon', 'abc123')
+const adapter = createScmAdapter(config);
 
-// 3) 获取单个文件内容
-const file = await client.getFileContent('canyon-project/canyon', 'README.md', 'main')
+const repo = await adapter.getRepoInfo("group/project"); // GitLab numeric id / path_with_namespace 等由平台解释
 
-// 4) 获取指定 commit 的 zip 产物
-const archive = await client.downloadArchive('canyon-project/canyon', 'abc123')
+const result: Compare = await adapter.getCompare(
+  repo.id,
+  "main~10", // base ref
+  "main", // head ref
+);
 
-// 5) 比较两个 commit
-const compare = await client.compareCommits('canyon-project/canyon', 'fromSha', 'toSha')
+console.log(result.commitList.length, result.changedFiles.length);
 ```
+
+GitHub 仅 token、`base` 固定为 `https://api.github.com`。
+
+## 开发与脚本
+
+| 脚本 | 说明 |
+| --- | --- |
+| `pnpm run build` | 使用 tsdown 产出 `dist` |
+| `pnpm run dev` | 监听构建 |
+| `pnpm run typecheck` | TypeScript 检查 |
+| `pnpm run test` | Vitest |
+| `pnpm run debug` | 本地脚本 `src/debug.ts`（可自行改为写 token、仓库与 ref） |
+
+目录概览：**`src/adapter.ts`** 定义 **`ScmAdapter`**；**`src/gitlab.ts`** / **`src/github.ts`** 为实现；**`src/diff-line.ts`** 为行号计算与扩展名判定；**`src/types.ts`** 为配置与各数据结构类型。
+
+## 许可证
+
+MIT

package/dist/index.d.mts

@@ -1,78 +1,47 @@
-//#region src/index.d.ts
-type GitProvider = 'github' | 'gitlab' | 'gitea';
-interface GitProviderClientOptions {
-  provider: GitProvider;
-  token?: string;
-  baseUrl?: string;
-  headers?: Record<string, string>;
-}
-interface RepositorySummary {
-  provider: GitProvider;
+//#region src/types.d.ts
+type ScmType = "github" | "gitlab";
+type GitlabScmConfig = {
+  type: "gitlab";
+  base: string;
+  token: string;
+};
+type GithubScmConfig = {
+  type: "github";
+  token: string;
+};
+/** GitLab 需 base + token，GitHub 仅需 token（base 固定为 api.github.com） */
+type ScmConfig = GitlabScmConfig | GithubScmConfig;
+interface RepoInfo {
+  /** 平台返回的仓库 ID（如 GitLab project id、GitHub repo id），String(data.id) */
   id: string;
-  fullName: string;
-  name: string;
-  defaultBranch?: string;
-  webUrl?: string;
-  private?: boolean;
-  description?: string | null;
-}
-interface CommitSummary {
-  provider: GitProvider;
-  sha: string;
-  shortSha: string;
-  title: string;
-  message: string;
-  authorName?: string;
-  authorEmail?: string;
-  authoredAt?: string;
-  webUrl?: string;
-}
-interface CompareSummary {
-  provider: GitProvider;
-  fromSha: string;
-  toSha: string;
-  status?: string;
-  aheadBy?: number;
-  behindBy?: number;
-  totalCommits: number;
+  pathWithNamespace: string;
+  description: string;
 }
-interface FileContentResult {
-  provider: GitProvider;
+interface CompareDiffItem {
   path: string;
-  ref: string;
-  sha?: string;
-  size?: number;
-  content: string;
+  additions: number[];
+  deletions: number[];
 }
-interface ArchiveResult {
-  provider: GitProvider;
-  ref: string;
-  contentType?: string | null;
-  fileName?: string;
-  size: number;
-  data: Uint8Array;
+interface Compare {
+  commitList: string[];
+  changedFiles: CompareDiffItem[];
 }
-declare class GitProviderClient {
-  private readonly provider;
-  private readonly token?;
-  private readonly baseUrl;
-  private readonly extraHeaders;
-  constructor(options: GitProviderClientOptions);
-  getRepositorySummary(idOrPath: string | number): Promise<RepositorySummary>;
-  getCommitSummary(repo: string | number, sha: string): Promise<CommitSummary>;
-  compareCommits(repo: string | number, fromSha: string, toSha: string): Promise<CompareSummary>;
-  getFileContent(repo: string | number, filePath: string, ref: string): Promise<FileContentResult>;
-  downloadArchive(repo: string | number, ref: string): Promise<ArchiveResult>;
-  private fetchGiteaProject;
-  private resolveOwnerRepo;
-  private parseOwnerRepo;
-  private encodeGitLabProjectId;
-  private encodePath;
-  private parseFileNameFromHeaders;
-  private requestJson;
-  private fetchWithAuth;
-  private getAuthHeaders;
+//#endregion
+//#region src/adapter.d.ts
+/**
+ * SCM 适配器接口：业务层只依赖此接口，通过 createScmAdapter 获取具体实现。
+ */
+interface ScmAdapter {
+  /** 获取仓库信息（id、pathWithNamespace、description） */
+  getRepoInfo(repoID: string): Promise<RepoInfo>;
+  /** 获取 base...head 之间变更 */
+  getCompare(repoID: string, base: string, head: string): Promise<Compare>;
 }
-declare function createGitProviderClient(options: GitProviderClientOptions): GitProviderClient;
 //#endregion
-export { ArchiveResult, CommitSummary, CompareSummary, FileContentResult, GitProvider, GitProviderClient, GitProviderClientOptions, RepositorySummary, createGitProviderClient };
+//#region src/index.d.ts
+/**
+ * 根据配置里的 `type`（github / gitlab …）创建对应适配器，调用方只依赖返回的 `ScmAdapter`。
+ */
+declare function createScmAdapter(config: ScmConfig): ScmAdapter;
+//#endregion
+export { type Compare, type CompareDiffItem, type RepoInfo, type ScmAdapter, type ScmConfig, type ScmType, createScmAdapter };

package/dist/index.mjs

@@ -1,289 +1,248 @@
-//#region src/index.ts
-function stripTrailingSlash(value) {
-	return value.endsWith("/") ? value.slice(0, -1) : value;
-}
-function normalizeProviderBaseUrl(provider, baseUrl) {
-	if (baseUrl) return stripTrailingSlash(baseUrl);
-	if (provider === "github") return "https://api.github.com";
-	if (provider === "gitlab") return "https://gitlab.com/api/v4";
-	return "https://gitea.com/api/v1";
+import { diffLines } from "diff";
+var HttpError = class extends Error {
+	status;
+	statusText;
+	data;
+	constructor(status, statusText, data) {
+		const detail = typeof data === "string" ? data : data != null && typeof data === "object" ? JSON.stringify(data) : data === void 0 ? "" : String(data);
+		super(detail ? `Request failed with ${status}: ${detail}` : `Request failed with ${status}`);
+		this.name = "HttpError";
+		this.status = status;
+		this.statusText = statusText;
+		this.data = data;
+	}
+};
+function mergeSignal(timeoutSignal, userSignal) {
+	if (!userSignal) return timeoutSignal;
+	const any = AbortSignal.any;
+	if (typeof any === "function") return any([userSignal, timeoutSignal]);
+	return timeoutSignal;
 }
-function shortSha(sha) {
-	return sha.slice(0, 8);
+async function parseBody(res) {
+	const text = await res.text();
+	if (!text) return void 0;
+	if ((res.headers.get("content-type") ?? "").includes("application/json")) try {
+		return JSON.parse(text);
+	} catch {
+		return text;
+	}
+	return text;
 }
-function decodeBase64ToUtf8(value) {
-	return Buffer.from(value.replace(/\n/g, ""), "base64").toString("utf-8");
+async function dispatch(url, config) {
+	const timeoutMs = config.timeout ?? 1e4;
+	const controller = new AbortController();
+	const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+	const signal = mergeSignal(controller.signal, config.signal);
+	try {
+		const res = await fetch(url, {
+			method: config.method ?? "GET",
+			headers: config.headers,
+			body: config.body,
+			signal
+		});
+		const data = await parseBody(res);
+		if (!res.ok) throw new HttpError(res.status, res.statusText, data);
+		return {
+			data,
+			status: res.status,
+			statusText: res.statusText
+		};
+	} finally {
+		clearTimeout(timeoutId);
+	}
 }
-function isLikelyNumericRepoId(repo) {
-	return typeof repo === "number" || /^\d+$/.test(repo);
+/** 类似 `axios.get`：返回 `{ data, status, statusText }`，非 2xx 抛 `HttpError` */
+function get(url, config = {}) {
+	return dispatch(url, {
+		...config,
+		method: "GET"
+	});
 }
-var GitProviderClient = class {
-	provider;
+//#endregion
+//#region src/github.ts
+const GITHUB_BASE = "https://api.github.com";
+var GithubAdapter = class {
+	base = GITHUB_BASE;
 	token;
-	baseUrl;
-	extraHeaders;
-	constructor(options) {
-		this.provider = options.provider;
-		this.token = options.token;
-		this.baseUrl = normalizeProviderBaseUrl(options.provider, options.baseUrl);
-		this.extraHeaders = options.headers ?? {};
+	constructor(config) {
+		this.token = config.token;
 	}
-	async getRepositorySummary(idOrPath) {
-		if (this.provider === "github") {
-			const url = isLikelyNumericRepoId(idOrPath) ? `${this.baseUrl}/repositories/${idOrPath}` : `${this.baseUrl}/repos/${encodeURIComponent(String(idOrPath).split("/")[0])}/${encodeURIComponent(String(idOrPath).split("/")[1] ?? "")}`;
-			const project = await this.requestJson(url);
-			return {
-				provider: this.provider,
-				id: String(project.id),
-				fullName: project.full_name,
-				name: project.name,
-				defaultBranch: project.default_branch,
-				webUrl: project.html_url,
-				private: project.private,
-				description: project.description
-			};
-		}
-		if (this.provider === "gitlab") {
-			const projectId = this.encodeGitLabProjectId(idOrPath);
-			const project = await this.requestJson(`${this.baseUrl}/projects/${projectId}`);
-			return {
-				provider: this.provider,
-				id: String(project.id),
-				fullName: project.path_with_namespace,
-				name: project.name,
-				defaultBranch: project.default_branch,
-				webUrl: project.web_url,
-				private: project.visibility ? project.visibility !== "public" : void 0,
-				description: project.description
-			};
-		}
-		const project = await this.fetchGiteaProject(idOrPath);
+	headers() {
 		return {
-			provider: this.provider,
-			id: String(project.id),
-			fullName: project.full_name,
-			name: project.name,
-			defaultBranch: project.default_branch,
-			webUrl: project.html_url,
-			private: project.private,
-			description: project.description
+			Authorization: `Bearer ${this.token}`,
+			Accept: "application/vnd.github.v3+json"
 		};
 	}
-	async getCommitSummary(repo, sha) {
-		if (this.provider === "github") {
-			const ownerRepo = await this.resolveOwnerRepo(repo);
-			const commit = await this.requestJson(`${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}/commits/${encodeURIComponent(sha)}`);
-			return {
-				provider: this.provider,
-				sha: commit.sha,
-				shortSha: shortSha(commit.sha),
-				title: commit.commit?.message?.split("\n")[0] ?? "",
-				message: commit.commit?.message ?? "",
-				authorName: commit.commit?.author?.name,
-				authorEmail: commit.commit?.author?.email,
-				authoredAt: commit.commit?.author?.date,
-				webUrl: commit.html_url
-			};
-		}
-		if (this.provider === "gitlab") {
-			const pid = this.encodeGitLabProjectId(repo);
-			const commit = await this.requestJson(`${this.baseUrl}/projects/${pid}/repository/commits/${encodeURIComponent(sha)}`);
-			return {
-				provider: this.provider,
-				sha: commit.id,
-				shortSha: shortSha(commit.short_id ?? commit.id),
-				title: commit.title ?? commit.message?.split("\n")[0] ?? "",
-				message: commit.message ?? "",
-				authorName: commit.author_name,
-				authorEmail: commit.author_email,
-				authoredAt: commit.authored_date,
-				webUrl: commit.web_url
-			};
-		}
-		const ownerRepo = await this.resolveOwnerRepo(repo);
-		const commit = await this.requestJson(`${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}/commits/${encodeURIComponent(sha)}`);
+	/**
+	* 支持 repoID：数字 ID，或 owner/repo 形式
+	*/
+	async getRepoInfo(repoID) {
+		const raw = repoID.trim();
+		let url;
+		if (raw.includes("/")) {
+			const [owner, repo] = raw.split("/");
+			if (!owner || !repo) throw new Error("GitHub owner/repo 格式无效");
+			url = `${this.base}/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`;
+		} else url = `${this.base}/repositories/${encodeURIComponent(raw)}`;
+		const { data } = await get(url, { headers: this.headers() });
+		if (!data?.full_name) throw new Error("GitHub 未返回 full_name");
 		return {
-			provider: this.provider,
-			sha: commit.sha,
-			shortSha: shortSha(commit.sha),
-			title: commit.commit?.message?.split("\n")[0] ?? "",
-			message: commit.commit?.message ?? "",
-			authorName: commit.commit?.author?.name,
-			authorEmail: commit.commit?.author?.email,
-			authoredAt: commit.commit?.author?.date,
-			webUrl: commit.html_url
+			id: String(data.id),
+			pathWithNamespace: data.full_name,
+			description: data.description ?? ""
 		};
 	}
-	async compareCommits(repo, fromSha, toSha) {
-		if (this.provider === "github") {
-			const ownerRepo = await this.resolveOwnerRepo(repo);
-			const compare = await this.requestJson(`${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}/compare/${encodeURIComponent(fromSha)}...${encodeURIComponent(toSha)}`);
-			return {
-				provider: this.provider,
-				fromSha,
-				toSha,
-				status: compare.status,
-				aheadBy: compare.ahead_by,
-				behindBy: compare.behind_by,
-				totalCommits: compare.total_commits ?? compare.commits?.length ?? 0
-			};
-		}
-		if (this.provider === "gitlab") {
-			const pid = this.encodeGitLabProjectId(repo);
-			const compare = await this.requestJson(`${this.baseUrl}/projects/${pid}/repository/compare?from=${encodeURIComponent(fromSha)}&to=${encodeURIComponent(toSha)}`);
-			return {
-				provider: this.provider,
-				fromSha,
-				toSha,
-				status: compare.compare_same_ref ? "identical" : "different",
-				totalCommits: compare.commits?.length ?? 0
-			};
-		}
-		const ownerRepo = await this.resolveOwnerRepo(repo);
-		const compare = await this.requestJson(`${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}/compare/${encodeURIComponent(fromSha)}...${encodeURIComponent(toSha)}`);
-		return {
-			provider: this.provider,
-			fromSha,
-			toSha,
-			status: compare.status,
-			aheadBy: compare.ahead_by,
-			behindBy: compare.behind_by,
-			totalCommits: compare.total_commits ?? compare.commits?.length ?? 0
-		};
+	async getCompare(_repoID, _base, _head) {
+		throw new Error("GitHubAdapter.getCompare 尚未实现");
 	}
-	async getFileContent(repo, filePath, ref) {
-		if (this.provider === "github") {
-			const ownerRepo = await this.resolveOwnerRepo(repo);
-			const payload = await this.requestJson(`${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}/contents/${this.encodePath(filePath)}?ref=${encodeURIComponent(ref)}`);
-			return {
-				provider: this.provider,
-				path: payload.path ?? filePath,
-				ref,
-				sha: payload.sha,
-				size: payload.size,
-				content: decodeBase64ToUtf8(payload.content ?? "")
-			};
+};
+//#endregion
+//#region src/diff-line.ts
+/** 参与逐行 diff 的源码扩展名（不含点）；匹配时按后缀长度降序避免 `.tsx` 被当成 `.ts`。 */
+const DEFAULT_LINE_DIFF_EXTENSIONS = [
+	"tsx",
+	"ts",
+	"jsx",
+	"js"
+];
+function textExceedsLineCount(text, maxLines) {
+	if (maxLines < 1) return true;
+	if (text === "") return false;
+	let n = 1;
+	for (let i = 0; i < text.length; i++) if (text.charCodeAt(i) === 10) {
+		n++;
+		if (n > maxLines) return true;
+	}
+	return false;
+}
+function textsExceedDiffLineBudget(oldText, newText, maxLines) {
+	return textExceedsLineCount(oldText, maxLines) || textExceedsLineCount(newText, maxLines);
+}
+function pathMatchesLineDiffExtensions(filePath, extensions = DEFAULT_LINE_DIFF_EXTENSIONS) {
+	const basename = filePath.split("/").pop() ?? "";
+	if (!basename.includes(".")) return false;
+	const sorted = [...extensions].sort((a, b) => b.length - a.length);
+	const lower = basename.toLowerCase();
+	return sorted.some((ext) => lower.endsWith(`.${ext.toLowerCase()}`));
+}
+/**
+* 给定同一文件在「旧版 / 新版」两段全文下的行号桶（算法与原先的 diffLines 口径一致）。
+*/
+function lineBucketsFromTexts(oldText, newText) {
+	const changes = diffLines(oldText ?? "", newText ?? "");
+	const additions = [];
+	const deletions = [];
+	const lineRangeDescending = (endLine, len) => Array.from({ length: len }, (_, i) => endLine - i).reverse();
+	const prefixSumInclusive = (lengths, index) => lengths.slice(0, index + 1).reduce((s, v) => s + v, 0);
+	const unchangedOnNewSide = changes.map((c) => c.added || c.removed ? 0 : c.count ?? 0);
+	const unchangedOnOldSide = changes.map((c) => c.added || c.removed ? 0 : c.count ?? 0);
+	changes.forEach((change, idx) => {
+		const count = change.count ?? 0;
+		if (change.added) {
+			const anchor = prefixSumInclusive(unchangedOnNewSide, idx) + 1;
+			additions.push(...lineRangeDescending(anchor + count - 1, count));
+		} else if (change.removed) {
+			const anchor = prefixSumInclusive(unchangedOnOldSide, idx) + 1;
+			deletions.push(...lineRangeDescending(anchor + count - 1, count));
 		}
-		if (this.provider === "gitlab") {
-			const pid = this.encodeGitLabProjectId(repo);
-			const payload = await this.requestJson(`${this.baseUrl}/projects/${pid}/repository/files/${this.encodePath(filePath)}?ref=${encodeURIComponent(ref)}`);
+	});
+	return {
+		additions,
+		deletions
+	};
+}
+function comparedRefsFromGitlabDiff(diff) {
+	const oldPath = diff.old_path ?? "";
+	const newPath = diff.new_path ?? "";
+	const keyPath = newPath || oldPath || "";
+	if (!keyPath) return null;
+	return {
+		keyPath,
+		pathAtBase: oldPath || newPath,
+		pathAtHead: newPath || oldPath
+	};
+}
+/**
+* 调用方可自行按扩展名等规则筛掉不需要的路径；本函数对已传入的列表全部拉全文并分段并发。
+* 任一版本全文行数超过 `LINE_DIFF_MAX_LINES_PER_FILE_SIDE` 时该行号结果退化为空数组（仍会请求 raw）。
+*/
+async function computeLineBucketsByRef(files, baseRef, headRef, fetchText, concurrent) {
+	const chunk = concurrent != null ? Math.max(1, concurrent) : Math.min(files.length || 1, 64);
+	const out = /* @__PURE__ */ new Map();
+	for (let offset = 0; offset < files.length; offset += chunk) {
+		const slice = files.slice(offset, offset + chunk);
+		const parts = await Promise.all(slice.map(async ({ keyPath, pathAtBase, pathAtHead }) => {
+			const [oldText, newText] = await Promise.all([fetchText(pathAtBase, baseRef).catch(() => ""), fetchText(pathAtHead, headRef).catch(() => "")]);
 			return {
-				provider: this.provider,
-				path: payload.file_path ?? filePath,
-				ref,
-				sha: payload.blob_id,
-				size: payload.size,
-				content: decodeBase64ToUtf8(payload.content ?? "")
+				keyPath,
+				buckets: textsExceedDiffLineBudget(oldText, newText, 1e4) ? {
+					additions: [],
+					deletions: []
+				} : lineBucketsFromTexts(oldText, newText)
 			};
-		}
-		const ownerRepo = await this.resolveOwnerRepo(repo);
-		const payload = await this.requestJson(`${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}/contents/${this.encodePath(filePath)}?ref=${encodeURIComponent(ref)}`);
-		return {
-			provider: this.provider,
-			path: payload.path ?? filePath,
-			ref,
-			sha: payload.sha,
-			size: payload.size,
-			content: decodeBase64ToUtf8(payload.content ?? "")
-		};
+		}));
+		for (const { keyPath, buckets } of parts) out.set(keyPath, buckets);
 	}
-	async downloadArchive(repo, ref) {
-		let url;
-		if (this.provider === "gitlab") {
-			const pid = this.encodeGitLabProjectId(repo);
-			url = `${this.baseUrl}/projects/${pid}/repository/archive.zip?sha=${encodeURIComponent(ref)}`;
-		} else {
-			const ownerRepo = await this.resolveOwnerRepo(repo);
-			if (this.provider === "github") url = `${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}/zipball/${encodeURIComponent(ref)}`;
-			else url = `${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}/archive/${encodeURIComponent(ref)}.zip`;
-		}
-		const response = await this.fetchWithAuth(url, { headers: { Accept: "application/zip" } });
-		if (!response.ok) {
-			const body = await response.text();
-			throw new Error(`[${this.provider}] request failed (${response.status}): ${body}`);
-		}
-		const data = new Uint8Array(await response.arrayBuffer());
-		return {
-			provider: this.provider,
-			ref,
-			contentType: response.headers.get("content-type"),
-			fileName: this.parseFileNameFromHeaders(response.headers),
-			size: data.byteLength,
-			data
-		};
+	return out;
+}
+//#endregion
+//#region src/gitlab.ts
+var GitlabAdapter = class {
+	base;
+	token;
+	constructor(config) {
+		this.base = config.base.replace(/\/$/, "");
+		this.token = config.token;
 	}
-	async fetchGiteaProject(idOrPath) {
-		if (!isLikelyNumericRepoId(idOrPath)) {
-			const ownerRepo = this.parseOwnerRepo(String(idOrPath));
-			return this.requestJson(`${this.baseUrl}/repos/${encodeURIComponent(ownerRepo.owner)}/${encodeURIComponent(ownerRepo.repo)}`);
-		}
-		try {
-			return await this.requestJson(`${this.baseUrl}/repositories/${idOrPath}`);
-		} catch {
-			throw new Error("[gitea] numeric repository id not found; try owner/repo form");
-		}
+	headers() {
+		return { "PRIVATE-TOKEN": this.token };
 	}
-	async resolveOwnerRepo(repo) {
-		if (!isLikelyNumericRepoId(repo)) return this.parseOwnerRepo(String(repo));
-		if (this.provider === "gitlab") {
-			const project = await this.getRepositorySummary(repo);
-			return this.parseOwnerRepo(project.fullName);
-		}
-		const project = await this.getRepositorySummary(repo);
-		return this.parseOwnerRepo(project.fullName);
+	fileRawUrl(repoID, filePath, ref) {
+		const encodedPath = encodeURIComponent(filePath);
+		return `${this.base}/api/v4/projects/${encodeURIComponent(repoID)}/repository/files/${encodedPath}/raw?ref=${encodeURIComponent(ref)}`;
+	}
+	async getRawFileText(repoID, filePath, ref) {
+		const { data } = await get(this.fileRawUrl(repoID, filePath, ref), { headers: this.headers() });
+		return typeof data === "string" ? data : "";
 	}
-	parseOwnerRepo(raw) {
-		const parts = raw.split("/");
-		if (parts.length < 2 || !parts[0] || !parts[1]) throw new Error(`invalid repository identifier "${raw}", expected "owner/repo" or numeric id`);
+	async getRepoInfo(repoID) {
+		const { data } = await get(`${this.base}/api/v4/projects/${encodeURIComponent(repoID)}`, { headers: this.headers() });
 		return {
-			owner: parts[0],
-			repo: parts.slice(1).join("/")
+			id: String(data.id),
+			pathWithNamespace: data.path_with_namespace,
+			description: data.description ?? ""
 		};
 	}
-	encodeGitLabProjectId(idOrPath) {
-		if (isLikelyNumericRepoId(idOrPath)) return String(idOrPath);
-		return this.encodePath(String(idOrPath));
-	}
-	encodePath(path) {
-		return path.split("/").filter(Boolean).map((piece) => encodeURIComponent(piece)).join("%2F");
-	}
-	parseFileNameFromHeaders(headers) {
-		const disposition = headers.get("content-disposition");
-		if (!disposition) return;
-		const utf8Match = disposition.match(/filename\*=UTF-8''([^;]+)/i);
-		if (utf8Match?.[1]) return decodeURIComponent(utf8Match[1]);
-		return disposition.match(/filename="([^"]+)"/i)?.[1];
-	}
-	async requestJson(url) {
-		const response = await this.fetchWithAuth(url);
-		if (!response.ok) {
-			const body = await response.text();
-			throw new Error(`[${this.provider}] request failed (${response.status}): ${body}`);
-		}
-		return response.json();
-	}
-	async fetchWithAuth(url, init) {
-		const headers = new Headers(init?.headers);
-		for (const [key, value] of Object.entries(this.getAuthHeaders())) headers.set(key, value);
-		for (const [key, value] of Object.entries(this.extraHeaders)) headers.set(key, value);
-		return fetch(url, {
-			...init,
-			headers
-		});
-	}
-	getAuthHeaders() {
-		const headers = {};
-		if (this.provider === "github") headers.Accept = "application/vnd.github+json";
-		else headers.Accept = "application/json";
-		if (!this.token) return headers;
-		if (this.provider === "gitlab") headers["PRIVATE-TOKEN"] = this.token;
-		else if (this.provider === "gitea") headers.Authorization = `token ${this.token}`;
-		else headers.Authorization = `Bearer ${this.token}`;
-		return headers;
+	async getCompare(repoID, base, head) {
+		const { data } = await get(`${this.base}/api/v4/projects/${encodeURIComponent(repoID)}/repository/compare?from=${encodeURIComponent(base)}&to=${encodeURIComponent(head)}`, { headers: this.headers() });
+		const diffRows = data.diffs ?? [];
+		const comparedPaths = diffRows.map(comparedRefsFromGitlabDiff).filter((entry) => entry != null).filter((entry) => pathMatchesLineDiffExtensions(entry.keyPath));
+		const lineBuckets = comparedPaths.length > 1500 ? /* @__PURE__ */ new Map() : await computeLineBucketsByRef(comparedPaths, base, head, (path, ref) => this.getRawFileText(repoID, path, ref));
+		const changedFiles = diffRows.map((d) => {
+			const path = comparedRefsFromGitlabDiff(d)?.keyPath ?? (d.new_path || d.old_path || "");
+			const buckets = lineBuckets.get(path);
+			return {
+				path,
+				additions: buckets?.additions ?? [],
+				deletions: buckets?.deletions ?? []
+			};
+		}).filter((item) => pathMatchesLineDiffExtensions(item.path));
+		return {
+			commitList: (data.commits ?? []).map((c) => c.id),
+			changedFiles
+		};
 	}
 };
-function createGitProviderClient(options) {
-	return new GitProviderClient(options);
+//#endregion
+//#region src/index.ts
+/**
+* 根据配置里的 `type`（github / gitlab …）创建对应适配器，调用方只依赖返回的 `ScmAdapter`。
+*/
+function createScmAdapter(config) {
+	switch (config.type) {
+		case "github": return new GithubAdapter(config);
+		case "gitlab": return new GitlabAdapter(config);
+	}
 }
 //#endregion
-export { GitProviderClient, createGitProviderClient };
+export { createScmAdapter };

package/package.json

@@ -1,24 +1,22 @@
 {
   "name": "@canyonjs/git-provider",
   "type": "module",
-  "version": "0.0.1",
-  "description": "Unified Git provider client for GitHub, GitLab, and Gitea.",
+  "version": "0.0.2",
+  "description": "GitLab provider client with adapter architecture.",
   "keywords": [
     "git",
-    "github",
     "gitlab",
-    "gitea",
     "api"
   ],
   "author": "canyonjs",
   "license": "MIT",
-  "homepage": "https://git.dev.sh.ctripcorp.com/canyon-project/git-provider#readme",
+  "homepage": "https://github.com/canyon-project/git-provider#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://git.dev.sh.ctripcorp.com/canyon-project/git-provider.git"
+    "url": "git+https://github.com/canyon-project/git-provider.git"
   },
   "bugs": {
-    "url": "https://git.dev.sh.ctripcorp.com/canyon-project/git-provider/issues"
+    "url": "https://github.com/canyon-project/git-provider/issues"
   },
   "types": "./dist/index.d.ts",
   "exports": {
@@ -31,17 +29,19 @@
   "sideEffects": false,
   "devDependencies": {
     "@types/node": "^25.5.0",
-    "@typescript/native-preview": "7.0.0-dev.20260328.1",
-    "bumpp": "^11.0.1",
+    "@typescript/native-preview": "7.0.0-dev.20260505.1",
     "tsdown": "^0.21.7",
-    "typescript": "^6.0.2",
+    "tsx": "^4.21.0",
     "vitest": "^4.1.2"
   },
+  "dependencies": {
+    "diff": "^9.0.0"
+  },
   "scripts": {
     "build": "tsdown",
     "dev": "tsdown --watch",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit",
-    "release": "bumpp"
+    "typecheck": "tsgo --noEmit",
+    "debug": "tsx src/debug.ts"
   }
 }