@cursor/bdk 0.2.3 → 0.2.5

package/src/internal/scm/pr-url.ts

@@ -1,245 +0,0 @@
-/**
- * Provider-neutral PR URL parse. GitHub.com plus the Origin page shapes
- * humans paste: cursor.com/codebase (canonical), origin.cursor.com, and the
- * retired review-host shape that older links and stored PR records still
- * carry.
- *
- * {@link parseScmPrUrl} is the wider parse the review seams use: it also
- * recognizes GitLab merge requests (`/-/merge_requests/<iid>` on any host),
- * Bitbucket Cloud / Data Center pull requests, and GitHub Enterprise Server
- * (`/<owner>/<repo>/pull/<n>` on a host that is none of the above). The
- * narrow {@link parsePrUrl} keeps its github.com + Origin contract for the
- * free-text callers (Slack `pr-ref`) where "any host with /pull/N" would be
- * too eager.
- */
-
-export type PrProvider = "github" | "origin";
-
-/** Every SCM the review seams can address. */
-export type ScmPrProvider = PrProvider | "gitlab" | "bitbucket";
-
-export type ParsedPrUrl = {
-  provider: PrProvider;
-  owner: string;
-  repo: string;
-  number: number;
-  url: string;
-};
-
-export type ParsedScmPrUrl = {
-  provider: ScmPrProvider;
-  /**
-   * Namespace half of the repo: GitHub owner, GitLab group path (nested
-   * groups joined with `/`), Bitbucket workspace / project key (`~user`
-   * for Data Center personal repos).
-   */
-  owner: string;
-  repo: string;
-  number: number;
-  /** Canonical PR page URL. */
-  url: string;
-  /**
-   * Hostname the PR lives on (lowercase). `github.com` for dotcom, the
-   * GHES hostname for GitHub Enterprise, `gitlab.com` or the self-managed
-   * host for GitLab, `bitbucket.org` or the Data Center host for Bitbucket.
-   * Origin PRs report the Origin page host.
-   */
-  host: string;
-};
-
-const ORIGIN_PAGE = /^origin(-[a-z0-9]+)?\.cursor\.com$/i;
-
-/**
- * Retired Origin UI host. Accepted on input only, for links minted before
- * the move to cursor.com/codebase; every canonical URL this module emits is
- * the cursor.com shape.
- */
-const LEGACY_REVIEW_CURSOR_HOSTS = new Set(["review.cursor.com"]);
-
-function positiveInt(raw: string | undefined): number | undefined {
-  if (raw === undefined) {
-    return undefined;
-  }
-  const n = Number(raw);
-  if (!Number.isInteger(n) || n <= 0) {
-    return undefined;
-  }
-  return n;
-}
-
-function parsed(
-  provider: ScmPrProvider,
-  host: string,
-  owner: string | undefined,
-  repo: string | undefined,
-  number: number | undefined,
-  url?: string,
-): ParsedScmPrUrl | undefined {
-  if (
-    owner === undefined ||
-    owner === "" ||
-    repo === undefined ||
-    repo === "" ||
-    number === undefined
-  ) {
-    return undefined;
-  }
-  const canonical =
-    url ??
-    (provider === "origin"
-      ? `https://cursor.com/codebase/${owner}/${repo}/pull/${number}`
-      : `https://${host}/${owner}/${repo}/pull/${number}`);
-  return { provider, owner, repo, number, url: canonical, host };
-}
-
-/** Strip Slack mrkdwn wrappers and trailing punctuation before `URL`. */
-function normalizeRaw(raw: string): string {
-  return raw
-    .trim()
-    .replace(/^[<[]+/, "")
-    .replace(/[>\].,;]+$/, "");
-}
-
-function isGithubDotCom(host: string): boolean {
-  return host === "github.com" || host === "www.github.com";
-}
-
-/** github.com and Origin only — the contract free-text PR references use. */
-export function parsePrUrl(raw: string): ParsedPrUrl | undefined {
-  const wide = parseScmPrUrl(raw);
-  if (wide === undefined) {
-    return undefined;
-  }
-  if (wide.provider === "origin") {
-    return { ...wide, provider: "origin" };
-  }
-  if (wide.provider === "github" && isGithubDotCom(wide.host)) {
-    return { ...wide, provider: "github" };
-  }
-  return undefined;
-}
-
-/**
- * Every provider shape, including GitHub Enterprise Server. The GitLab and
- * Bitbucket path shapes are unambiguous on any host; a plain
- * `/<owner>/<repo>/pull/<n>` on a host that is not github.com, Origin,
- * GitLab, or Bitbucket is taken as GHES (the only remaining forge with that
- * route). Callers that must not accept arbitrary hosts use
- * {@link parsePrUrl}.
- */
-export function parseScmPrUrl(raw: string): ParsedScmPrUrl | undefined {
-  let url: URL;
-  try {
-    url = new URL(normalizeRaw(raw));
-  } catch {
-    return undefined;
-  }
-  if (url.protocol !== "https:" && url.protocol !== "http:") {
-    return undefined;
-  }
-
-  const parts = url.pathname.split("/").filter(Boolean);
-  const host = url.hostname.toLowerCase();
-
-  if (ORIGIN_PAGE.test(host) && parts.length >= 4 && parts[2] === "github") {
-    return parsed("origin", host, parts[0], parts[1], positiveInt(parts[3]));
-  }
-
-  if (
-    (host === "cursor.com" || host === "www.cursor.com") &&
-    parts[0] === "codebase" &&
-    parts.length >= 5 &&
-    parts[3] === "pull"
-  ) {
-    return parsed("origin", host, parts[1], parts[2], positiveInt(parts[4]));
-  }
-
-  if (LEGACY_REVIEW_CURSOR_HOSTS.has(host) && parts[0] === "pr") {
-    if (parts.length >= 5 && parts[3] === "github") {
-      return parsed("origin", host, parts[1], parts[2], positiveInt(parts[4]));
-    }
-    if (parts.length >= 4) {
-      return parsed("origin", host, parts[1], parts[2], positiveInt(parts[3]));
-    }
-  }
-
-  // GitLab MR page: /<group>/[<subgroup>/…]<project>/-/merge_requests/<iid>
-  const separator = parts.indexOf("-");
-  if (
-    separator >= 2 &&
-    parts[separator + 1] === "merge_requests" &&
-    parts.length >= separator + 3
-  ) {
-    const owner = parts.slice(0, separator - 1).join("/");
-    const repo = parts[separator - 1];
-    const number = positiveInt(parts[separator + 2]);
-    return parsed(
-      "gitlab",
-      host,
-      owner,
-      repo,
-      number,
-      number === undefined
-        ? undefined
-        : `https://${host}/${owner}/${repo}/-/merge_requests/${number}`,
-    );
-  }
-
-  // Bitbucket Cloud: bitbucket.org/<workspace>/<slug>/pull-requests/<id>
-  if (
-    (host === "bitbucket.org" || host === "www.bitbucket.org") &&
-    parts.length >= 4 &&
-    parts[2] === "pull-requests"
-  ) {
-    const number = positiveInt(parts[3]);
-    return parsed(
-      "bitbucket",
-      "bitbucket.org",
-      parts[0],
-      parts[1],
-      number,
-      number === undefined
-        ? undefined
-        : `https://bitbucket.org/${parts[0]}/${parts[1]}/pull-requests/${number}`,
-    );
-  }
-
-  // Bitbucket Data Center: [/<context>]/projects/<KEY>/repos/<slug>/pull-requests/<id>
-  // (personal repos: /users/<name>/repos/<slug>/…, full name `~name/slug`).
-  const dc = parts.findIndex(
-    (part, index) =>
-      (part === "projects" || part === "users") &&
-      parts[index + 2] === "repos" &&
-      parts[index + 4] === "pull-requests",
-  );
-  if (dc !== -1 && parts.length >= dc + 6) {
-    const number = positiveInt(parts[dc + 5]);
-    const owner = parts[dc] === "users" ? `~${parts[dc + 1]}` : parts[dc + 1];
-    const slug = parts[dc + 3];
-    const context = parts.slice(0, dc).join("/");
-    return parsed(
-      "bitbucket",
-      host,
-      owner,
-      slug,
-      number,
-      number === undefined
-        ? undefined
-        : `${url.origin}/${context === "" ? "" : `${context}/`}${parts.slice(dc, dc + 4).join("/")}/pull-requests/${number}`,
-    );
-  }
-
-  // GitHub (dotcom or Enterprise Server): /<owner>/<repo>/pull/<n>. Checked
-  // last so the forge-specific shapes above win on shared hosts.
-  if (
-    parts.length >= 4 &&
-    parts[2] === "pull" &&
-    !ORIGIN_PAGE.test(host) &&
-    !/(^|\.)cursor\.com$/.test(host)
-  ) {
-    const githubHost = isGithubDotCom(host) ? "github.com" : host;
-    return parsed("github", githubHost, parts[0], parts[1], positiveInt(parts[3]));
-  }
-
-  return undefined;
-}