@spaceflow/core 0.1.1

package/src/shared/git-provider/parse-repo-url.spec.ts

@@ -0,0 +1,221 @@
+import { parseRepoUrl } from "./parse-repo-url";
+
+describe("parseRepoUrl", () => {
+  // ============ Gitea 仓库 URL ============
+
+  describe("Gitea 仓库 URL", () => {
+    it("应解析仓库根目录 URL（未知域名默认为 github）", () => {
+      const result = parseRepoUrl("https://git.bjxgj.com/xgj/review-spec");
+      expect(result).toEqual({
+        owner: "xgj",
+        repo: "review-spec",
+        path: "",
+        provider: "github",
+        serverUrl: "https://git.bjxgj.com",
+      });
+    });
+
+    it("应解析带 /src/branch/ 的目录 URL", () => {
+      const result = parseRepoUrl(
+        "https://git.bjxgj.com/xgj/review-spec/src/branch/main/references",
+      );
+      expect(result).toEqual({
+        owner: "xgj",
+        repo: "review-spec",
+        path: "references",
+        ref: "main",
+        provider: "gitea",
+        serverUrl: "https://git.bjxgj.com",
+      });
+    });
+
+    it("应解析多层子目录路径", () => {
+      const result = parseRepoUrl(
+        "https://git.example.com/org/repo/src/branch/develop/path/to/specs",
+      );
+      expect(result).toEqual({
+        owner: "org",
+        repo: "repo",
+        path: "path/to/specs",
+        ref: "develop",
+        provider: "gitea",
+        serverUrl: "https://git.example.com",
+      });
+    });
+
+    it("应解析 /src/tag/ URL", () => {
+      const result = parseRepoUrl("https://git.example.com/org/repo/src/tag/v1.0/docs");
+      expect(result).toEqual({
+        owner: "org",
+        repo: "repo",
+        path: "docs",
+        ref: "v1.0",
+        provider: "gitea",
+        serverUrl: "https://git.example.com",
+      });
+    });
+
+    it("应解析 /src/commit/ URL", () => {
+      const result = parseRepoUrl("https://git.example.com/org/repo/src/commit/abc123/docs");
+      expect(result).toEqual({
+        owner: "org",
+        repo: "repo",
+        path: "docs",
+        ref: "abc123",
+        provider: "gitea",
+        serverUrl: "https://git.example.com",
+      });
+    });
+
+    it("分支目录但无子路径时 path 应为空", () => {
+      const result = parseRepoUrl("https://git.example.com/org/repo/src/branch/main");
+      expect(result?.path).toBe("");
+      expect(result?.ref).toBe("main");
+    });
+  });
+
+  // ============ GitHub 仓库 URL ============
+
+  describe("GitHub 仓库 URL", () => {
+    it("应解析仓库根目录 URL", () => {
+      const result = parseRepoUrl("https://github.com/facebook/react");
+      expect(result).toEqual({
+        owner: "facebook",
+        repo: "react",
+        path: "",
+        provider: "github",
+        serverUrl: "https://github.com",
+      });
+    });
+
+    it("应解析 /tree/ 目录 URL", () => {
+      const result = parseRepoUrl("https://github.com/org/repo/tree/main/docs/specs");
+      expect(result).toEqual({
+        owner: "org",
+        repo: "repo",
+        path: "docs/specs",
+        ref: "main",
+        provider: "github",
+        serverUrl: "https://github.com",
+      });
+    });
+
+    it("分支目录但无子路径时 path 应为空", () => {
+      const result = parseRepoUrl("https://github.com/org/repo/tree/develop");
+      expect(result?.path).toBe("");
+      expect(result?.ref).toBe("develop");
+    });
+  });
+
+  // ============ GitLab 仓库 URL ============
+
+  describe("GitLab 仓库 URL", () => {
+    it("应解析仓库根目录 URL", () => {
+      const result = parseRepoUrl("https://gitlab.com/org/repo");
+      expect(result).toEqual({
+        owner: "org",
+        repo: "repo",
+        path: "",
+        provider: "gitlab",
+        serverUrl: "https://gitlab.com",
+      });
+    });
+
+    it("应解析 /-/tree/ 目录 URL", () => {
+      const result = parseRepoUrl("https://gitlab.com/org/repo/-/tree/main/docs/specs");
+      expect(result).toEqual({
+        owner: "org",
+        repo: "repo",
+        path: "docs/specs",
+        ref: "main",
+        provider: "gitlab",
+        serverUrl: "https://gitlab.com",
+      });
+    });
+
+    it("分支目录但无子路径时 path 应为空", () => {
+      const result = parseRepoUrl("https://gitlab.com/org/repo/-/tree/develop");
+      expect(result?.path).toBe("");
+      expect(result?.ref).toBe("develop");
+      expect(result?.provider).toBe("gitlab");
+    });
+
+    it("应解析 GitLab SSH 格式", () => {
+      const result = parseRepoUrl("git@gitlab.com:org/repo.git");
+      expect(result?.provider).toBe("gitlab");
+      expect(result?.owner).toBe("org");
+      expect(result?.repo).toBe("repo");
+    });
+
+    it("自建 GitLab 使用 /-/tree/ 格式也应识别", () => {
+      const result = parseRepoUrl("https://git.company.com/team/project/-/tree/main/references");
+      expect(result?.path).toBe("references");
+      expect(result?.ref).toBe("main");
+    });
+  });
+
+  // ============ SSH URL ============
+
+  describe("SSH URL", () => {
+    it("应解析 git@ 格式", () => {
+      const result = parseRepoUrl("git@git.bjxgj.com:xgj/review-spec.git");
+      expect(result).toEqual({
+        owner: "xgj",
+        repo: "review-spec",
+        path: "",
+        provider: "github",
+        serverUrl: "https://git.bjxgj.com",
+      });
+    });
+
+    it("应解析 GitHub SSH 格式", () => {
+      const result = parseRepoUrl("git@github.com:org/repo.git");
+      expect(result?.provider).toBe("github");
+      expect(result?.owner).toBe("org");
+      expect(result?.repo).toBe("repo");
+    });
+
+    it("应解析 git+ssh:// 格式", () => {
+      const result = parseRepoUrl("git+ssh://git@git.bjxgj.com/xgj/review-spec.git");
+      expect(result?.owner).toBe("xgj");
+      expect(result?.repo).toBe("review-spec");
+      expect(result?.provider).toBe("github");
+    });
+  });
+
+  // ============ 边界情况 ============
+
+  describe("边界情况", () => {
+    it("空字符串应返回 null", () => {
+      expect(parseRepoUrl("")).toBeNull();
+    });
+
+    it("纯文本应返回 null", () => {
+      expect(parseRepoUrl("not-a-url")).toBeNull();
+    });
+
+    it("只有域名无路径应返回 null", () => {
+      expect(parseRepoUrl("https://github.com")).toBeNull();
+    });
+
+    it("只有一段路径应返回 null", () => {
+      expect(parseRepoUrl("https://github.com/org")).toBeNull();
+    });
+
+    it("URL 带尾部斜杠应正常解析", () => {
+      const result = parseRepoUrl("https://github.com/org/repo/");
+      expect(result?.owner).toBe("org");
+      expect(result?.repo).toBe("repo");
+    });
+
+    it("URL 带 .git 后缀应去除", () => {
+      const result = parseRepoUrl("https://github.com/org/repo.git");
+      expect(result?.repo).toBe("repo");
+    });
+
+    it("本地路径应返回 null", () => {
+      expect(parseRepoUrl("./references")).toBeNull();
+      expect(parseRepoUrl("/home/user/specs")).toBeNull();
+    });
+  });
+});

package/src/shared/git-provider/parse-repo-url.ts

@@ -0,0 +1,155 @@
+import type { RemoteRepoRef, GitProviderType } from "./types";
+import { detectProvider } from "./detect-provider";
+
+/** 已知的 GitHub 域名 */
+const GITHUB_HOSTS = new Set(["github.com", "www.github.com"]);
+
+/** 已知的 GitLab 域名 */
+const GITLAB_HOSTS = new Set(["gitlab.com", "www.gitlab.com"]);
+
+/**
+ * 解析浏览器中复制的仓库 URL 为结构化的仓库引用
+ *
+ * 支持的 URL 格式：
+ * - Gitea 仓库：https://git.example.com/owner/repo
+ * - Gitea 目录：https://git.example.com/owner/repo/src/branch/main/path/to/dir
+ * - Gitea 标签：https://git.example.com/owner/repo/src/tag/v1.0/path/to/dir
+ * - Gitea commit：https://git.example.com/owner/repo/src/commit/abc123/path/to/dir
+ * - GitHub 仓库：https://github.com/owner/repo
+ * - GitHub 目录：https://github.com/owner/repo/tree/main/path/to/dir
+ * - GitLab 仓库：https://gitlab.com/owner/repo
+ * - GitLab 目录：https://gitlab.com/owner/repo/-/tree/main/path/to/dir
+ * - git+ssh URL：git+ssh://git@host/owner/repo.git
+ * - SSH URL：git@host:owner/repo.git
+ *
+ * @returns 解析后的仓库引用，无法解析时返回 null
+ */
+export function parseRepoUrl(url: string): RemoteRepoRef | null {
+  const trimmed = url.trim();
+  if (!trimmed) return null;
+  // SSH 格式: git@host:owner/repo.git
+  if (trimmed.startsWith("git@")) {
+    return parseSshUrl(trimmed);
+  }
+  // git+ssh:// 格式
+  if (trimmed.startsWith("git+ssh://")) {
+    return parseGitSshUrl(trimmed);
+  }
+  // HTTP(S) URL
+  if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
+    return parseHttpUrl(trimmed);
+  }
+  return null;
+}
+
+/** 解析 HTTP(S) URL */
+function parseHttpUrl(url: string): RemoteRepoRef | null {
+  let parsed: URL;
+  try {
+    parsed = new URL(url);
+  } catch {
+    return null;
+  }
+  const hostname = parsed.hostname;
+  const segments = parsed.pathname.split("/").filter(Boolean);
+  if (segments.length < 2) return null;
+  const owner = segments[0];
+  const repo = segments[1].replace(/\.git$/, "");
+  const serverUrl = `${parsed.protocol}//${parsed.host}`;
+  const isGithub = isGithubHost(hostname);
+  const isGitlab = isGitlabHost(hostname);
+  const provider: GitProviderType = isGithub
+    ? "github"
+    : isGitlab
+      ? "gitlab"
+      : detectProviderForHost(serverUrl);
+  // 仓库根目录（只有 owner/repo）
+  if (segments.length === 2) {
+    return { owner, repo, path: "", provider, serverUrl };
+  }
+  // GitHub: /owner/repo/tree/branch/path...
+  if (isGithub && segments[2] === "tree" && segments.length >= 4) {
+    const ref = segments[3];
+    const path = segments.slice(4).join("/");
+    return { owner, repo, path, ref, provider, serverUrl };
+  }
+  // GitLab: /owner/repo/-/tree/branch/path...
+  if (segments[2] === "-" && segments[3] === "tree" && segments.length >= 5) {
+    const ref = segments[4];
+    const path = segments.slice(5).join("/");
+    return { owner, repo, path, ref, provider: isGitlab ? "gitlab" : provider, serverUrl };
+  }
+  // Gitea: /owner/repo/src/branch/<branch>/path...
+  //        /owner/repo/src/tag/<tag>/path...
+  //        /owner/repo/src/commit/<sha>/path...
+  if (segments[2] === "src" && segments.length >= 4) {
+    const refType = segments[3]; // "branch", "tag", "commit"
+    if (
+      (refType === "branch" || refType === "tag" || refType === "commit") &&
+      segments.length >= 5
+    ) {
+      const ref = segments[4];
+      const path = segments.slice(5).join("/");
+      return { owner, repo, path, ref, provider: "gitea", serverUrl };
+    }
+  }
+  // 无法识别的子路径，当作仓库根目录
+  return { owner, repo, path: "", provider, serverUrl };
+}
+
+/** 解析 git@host:owner/repo.git 格式 */
+function parseSshUrl(url: string): RemoteRepoRef | null {
+  const match = url.match(/^git@([^:]+):(.+?)(?:\.git)?$/);
+  if (!match) return null;
+  const host = match[1];
+  const pathPart = match[2];
+  const segments = pathPart.split("/").filter(Boolean);
+  if (segments.length < 2) return null;
+  const owner = segments[0];
+  const repo = segments[1];
+  const serverUrl = `https://${host}`;
+  const provider: GitProviderType = isGithubHost(host)
+    ? "github"
+    : isGitlabHost(host)
+      ? "gitlab"
+      : detectProviderForHost(serverUrl);
+  return { owner, repo, path: "", provider, serverUrl };
+}
+
+/** 解析 git+ssh://git@host/owner/repo.git 格式 */
+function parseGitSshUrl(url: string): RemoteRepoRef | null {
+  let parsed: URL;
+  try {
+    parsed = new URL(url.replace("git+ssh://", "ssh://"));
+  } catch {
+    return null;
+  }
+  const host = parsed.hostname;
+  const segments = parsed.pathname.split("/").filter(Boolean);
+  if (segments.length < 2) return null;
+  const owner = segments[0];
+  const repo = segments[1].replace(/\.git$/, "");
+  const serverUrl = `https://${host}`;
+  const provider: GitProviderType = isGithubHost(host)
+    ? "github"
+    : isGitlabHost(host)
+      ? "gitlab"
+      : detectProviderForHost(serverUrl);
+  return { owner, repo, path: "", provider, serverUrl };
+}
+
+/** 判断是否为 GitHub 域名 */
+function isGithubHost(hostname: string): boolean {
+  return GITHUB_HOSTS.has(hostname) || hostname.endsWith(".github.com");
+}
+
+/** 判断是否为 GitLab 域名 */
+function isGitlabHost(hostname: string): boolean {
+  return GITLAB_HOSTS.has(hostname) || hostname.endsWith(".gitlab.com");
+}
+
+/** 根据服务器 URL 检测 provider 类型（非 GitHub/GitLab 默认为 Gitea） */
+function detectProviderForHost(serverUrl: string): GitProviderType {
+  const detected = detectProvider({ GIT_PROVIDER_URL: serverUrl });
+  return detected.provider;
+}