Function downloadFromGitHub

cli/src/utils/github-downloader.ts:158–224

(
  options: DownloadOptions = {}
)

 * Downloads and extracts the craftrn-ui directory from GitHub
 */
export async function downloadFromGitHub(
  options: DownloadOptions = {}
): Promise<string> {
  const branch = options.branch || DEFAULT_BRANCH;
  const cachePath = getCachePath(branch);
  const craftrnUiPath = path.join(cachePath, "demo-app", "craftrn-ui");

  const spinner = options.silent
    ? null
    : ora("Checking cache...").start();

  // Check if cache exists and is fresh
  if (await fs.pathExists(craftrnUiPath)) {
    if (spinner) spinner.text = "Checking cache...";
    const stale = await isCacheStale(branch, options.forceLatest || false);
    if (!stale) {
      if (spinner) spinner.succeed("Using cached components");
      return craftrnUiPath;
    }
    // Cache is stale (older than 1 day), remove it
    if (spinner) spinner.text = "Cache is outdated (older than 1 day), downloading latest...";
    await fs.remove(cachePath);
  }

  if (spinner) spinner.text = "Downloading components from GitHub...";

  const tarballUrl = `https://github.com/${GITHUB_OWNER}/${GITHUB_REPO}/archive/refs/heads/${branch}.tar.gz`;
  const tempTarPath = path.join(cachePath, "archive.tar.gz");
  const extractPath = path.join(cachePath, "extracted");

  await fs.ensureDir(cachePath);

  // Download tarball
  await downloadFile(tarballUrl, tempTarPath, spinner);

  // Extract tarball
  await fs.ensureDir(extractPath);
  await tar.extract({ file: tempTarPath, cwd: extractPath });
  await fs.remove(tempTarPath);

  // Move extracted directory to final location
  const extractedRepoPath = path.join(
    extractPath,
    `${GITHUB_REPO}-${branch}`,
    "demo-app",
    "craftrn-ui"
  );

  if (!(await fs.pathExists(extractedRepoPath))) {
    if (spinner) spinner.fail("Failed to extract components");
    throw new Error("Failed to extract craftrn-ui directory from tarball");
  }

  const finalPath = path.join(cachePath, "demo-app", "craftrn-ui");
  await fs.ensureDir(path.dirname(finalPath));
  if (await fs.pathExists(finalPath)) {
    await fs.remove(finalPath);
  }