Function parseGitHubPlugin

apps/cursor/src/lib/github-plugin/parse.ts:287–623

(
  url: string,
  options: {
    repoMeta?: GitHubRepoMeta | null;
    /**
     * Caller-controlled rate-limit retry budget for the underlying GitHub API
     * calls. Server actions should pass a small value (e.g. 3000) to stay
     * under their function timeout; bulk scripts can pass 30000 (the default).
     */
    maxWaitMs?: number;
  } = {},
)

}

export async function parseGitHubPlugin(
  url: string,
  options: {
    repoMeta?: GitHubRepoMeta | null;
    /**
     * Caller-controlled rate-limit retry budget for the underlying GitHub API
     * calls. Server actions should pass a small value (e.g. 3000) to stay
     * under their function timeout; bulk scripts can pass 30000 (the default).
     */
    maxWaitMs?: number;
  } = {},
): Promise<ParsedPlugin> {
  const parsed = parseGitHubUrl(url);
  if (!parsed) {
    throw new GitHubParseError(
      "Invalid GitHub URL. Expected format: https://github.com/owner/repo",
      "invalid_url",
    );
  }

  const { owner, repo } = parsed;
  const fetchOpts: FetchOptions = { maxWaitMs: options.maxWaitMs };

  const tree = await fetchGitHubTree(owner, repo, fetchOpts);
  if (tree.length === 0) {
    throw new GitHubParseError(
      "Could not read repository. Make sure the repo exists, is public, and the URL is correct.",
      "repo_unreadable",
    );
  }

  const rootManifestPaths = [
    ".plugin/plugin.json",
    ".cursor-plugin/plugin.json",
    ".claude-plugin/plugin.json",
    ".cursor-plugin/marketplace.json",
  ];
  let manifest: Record<string, unknown> = {};
  for (const mp of rootManifestPaths) {
    const content = await fetchGitHubFile(owner, repo, mp);
    if (content) {
      try {
        manifest = JSON.parse(content);
      } catch {
        // ignore invalid JSON
      }
      break;
    }
  }

  // Discover sub-plugin dirs. Two patterns are supported:
  //   1. Marketplace manifest lists `plugins[].source` (relative dirs).
  //   2. Any `<dir>/.cursor-plugin/plugin.json` in the tree.
  const subPluginDirs = new Set<string>();

  if (Array.isArray(manifest.plugins)) {
    for (const entry of manifest.plugins as Array<unknown>) {
      if (entry && typeof entry === "object") {