repolet 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shiv Singh Baghel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,129 @@
+Repolet
+
+Copy a complete GitHub repository or a specific GitHub folder directly to your local filesystem.
+
+Repolet does not create a ZIP file and does not copy the .git history. It downloads the actual files into a normal local directory.
+
+Features
+
+Copy an entire GitHub repository
+
+Copy only a specific GitHub subfolder
+
+Support nested folders
+
+Preserve binary files such as PNG, PDF, MP3, SVG, etc.
+
+Custom destination folder
+
+Recursive file discovery
+
+GitHub token support
+
+Download progress
+
+Existing-folder protection
+
+Installation
+
+Using npm:
+
+npm install -g repolet
+
+Using pnpm:
+
+pnpm add -g repolet
+
+Or run directly with:
+
+npx repolet <github-url>
+
+Usage
+
+Copy an entire repository
+
+repolet https://github.com/user/repository
+
+For example:
+
+repolet https://github.com/Devendradhote001/KODR4-React kodr-repo
+
+Creates:
+
+kodr-repo/
+├── public/
+├── src/
+├── package.json
+└── ...
+
+Copy a specific folder
+
+repolet https://github.com/user/repository/tree/main/src my-src
+
+For example:
+
+repolet https://github.com/shivsingh78/my-portfolio/tree/main/src my-portfolio-src
+
+Creates:
+
+my-portfolio-src/
+├── App.jsx
+├── assets/
+├── components/
+├── index.css
+└── main.jsx
+
+Destination is optional
+
+repolet https://github.com/user/repository/tree/main/src
+
+Repolet will use the selected folder name as the destination.
+
+GitHub Authentication
+
+Public repositories can be downloaded without authentication.
+
+For private repositories or higher GitHub API limits, set a GitHub fine-grained personal access token:
+
+export GITHUB_TOKEN="your_token"
+
+Then:
+
+repolet https://github.com/user/private-repo private-repo
+
+The token is read from:
+
+GITHUB_TOKEN
+
+Repolet does not store the token.
+
+For a fine-grained token, use the minimum required repository permissions, such as:
+
+Contents → Read-only
+
+Options
+
+repolet --help
+repolet --version
+
+Examples
+
+Copy a complete repository:
+
+repolet https://github.com/user/repository
+
+Copy a folder:
+
+repolet https://github.com/user/repository/tree/main/components
+
+Copy to a custom directory:
+
+repolet https://github.com/user/repository/tree/main/components ui-components
+
+Requirements
+
+Node.js 18 or newer
+
+License
+
+MIT

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "repolet",
+  "version": "0.1.0",
+  "description": "Copy a complete GitHub repository or a specific folder directly to your local filesystem",
+  "type": "module",
+  "main": "src/index.js",
+  "bin": {
+    "repolet": "src/index.js"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "start": "node src/index.js"
+  },
+  "keywords": [
+    "github",
+    "git",
+    "clone",
+    "github-folder",
+    "repository",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "dependencies": {
+    "repolet": "file:/home/shivsingh/harikirat/repolet/repolet-0.1.0.tgz"
+  }
+}

package/src/downloader.js

@@ -0,0 +1,51 @@
+import fs from "fs/promises";
+import path from "path";
+
+export async function downloadFile(
+  file,
+  destinationRoot,
+  sourceRoot
+) {
+  let relativePath;
+
+  if (sourceRoot) {
+    relativePath = path.relative(
+      sourceRoot,
+      file.path
+    );
+  } else {
+    relativePath = file.path;
+  }
+
+  const outputPath = path.join(
+    destinationRoot,
+    relativePath
+  );
+
+  const directory = path.dirname(outputPath);
+
+  await fs.mkdir(directory, {
+    recursive: true
+  });
+
+  const response = await fetch(
+    file.download_url
+  );
+
+  if (!response.ok) {
+    throw new Error(
+      `Failed to download ${file.path}: ${response.status} ${response.statusText}`
+    );
+  }
+
+  const buffer = Buffer.from(
+    await response.arrayBuffer()
+  );
+
+  await fs.writeFile(
+    outputPath,
+    buffer
+  );
+
+  return outputPath;
+}

package/src/github.js

@@ -0,0 +1,124 @@
+async function githubRequest(url) {
+  const headers = {
+    Accept: "application/vnd.github+json",
+    "User-Agent": "repolet"
+  };
+
+  const token = process.env.GITHUB_TOKEN;
+
+  if (token) {
+    headers.Authorization = `Bearer ${token}`;
+  }
+
+  const response = await fetch(url, {
+    headers
+  });
+
+  if (!response.ok) {
+    if (response.status === 401) {
+      throw new Error(
+        "GitHub authentication failed. Check your GITHUB_TOKEN."
+      );
+    }
+
+    if (response.status === 403) {
+      throw new Error(
+        "GitHub API rate limit exceeded. Set GITHUB_TOKEN to increase the API limit."
+      );
+    }
+
+    if (response.status === 404) {
+      throw new Error(
+        "GitHub repository or branch not found, or you do not have permission to access it."
+      );
+    }
+
+    throw new Error(
+      `GitHub API request failed: ${response.status} ${response.statusText}`
+    );
+  }
+
+  return response.json();
+}
+async function getDefaultBranch(owner, repo) {
+  const url =
+    `https://api.github.com/repos/${owner}/${repo}`;
+
+  const data = await githubRequest(url);
+
+  return data.default_branch;
+}
+
+export async function getAllFiles({
+  owner,
+  repo,
+  branch,
+  path,
+  type
+}) {
+  // --------------------------------
+  // 1. Determine branch
+  // --------------------------------
+
+  if (!branch) {
+    branch = await getDefaultBranch(
+      owner,
+      repo
+    );
+  }
+
+  // --------------------------------
+  // 2. Fetch complete repository tree
+  // --------------------------------
+
+  const url =
+    `https://api.github.com/repos/${owner}/${repo}/git/trees/${encodeURIComponent(branch)}` +
+    "?recursive=1";
+
+  const data = await githubRequest(url);
+
+  if (data.truncated) {
+    throw new Error(
+      "GitHub returned a truncated repository tree. This repository is too large for the recursive tree request."
+    );
+  }
+
+  // --------------------------------
+  // 3. Determine selected path
+  // --------------------------------
+
+  const prefix = path
+    ? path.endsWith("/")
+      ? path
+      : `${path}/`
+    : "";
+
+  // --------------------------------
+  // 4. Select files
+  // --------------------------------
+
+  const files = data.tree.filter((item) => {
+    if (item.type !== "blob") {
+      return false;
+    }
+
+    // Whole repository
+    if (type === "repository") {
+      return true;
+    }
+
+    // Selected folder
+    return item.path.startsWith(prefix);
+  });
+
+  // --------------------------------
+  // 5. Build download URLs
+  // --------------------------------
+
+  return files.map((item) => ({
+    type: "file",
+    path: item.path,
+    download_url:
+      `https://raw.githubusercontent.com/${owner}/${repo}/${encodeURIComponent(branch)}/${item.path}`
+  }));
+}

package/src/index.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node
+import fs from "fs/promises";
+
+import { parseGitHubUrl } from "./parser.js";
+import { getAllFiles } from "./github.js";
+import { downloadFile } from "./downloader.js";
+
+const VERSION = "0.1.0";
+
+const args = process.argv.slice(2);
+const cleanArgs = args.filter((arg) => arg !== "--");
+
+const showHelp = cleanArgs.includes("--help") || cleanArgs.includes("-h");
+
+const showVersion = cleanArgs.includes("--version") || cleanArgs.includes("-v");
+
+if (showHelp) {
+  console.log(`
+Repolet v${VERSION}
+
+Copy a specific folder from a GitHub repository.
+
+Usage:
+  repolet <github-folder-url> [destination]
+
+Examples:
+  repolet https://github.com/user/repo/tree/main/src
+  repolet https://github.com/user/repo/tree/main/src my-src
+
+Options:
+  -h, --help       Show help
+  -v, --version    Show version
+`);
+
+  process.exit(0);
+}
+
+if (showVersion) {
+  console.log(`repolet v${VERSION}`);
+  process.exit(0);
+}
+
+const githubUrl = cleanArgs[0];
+const customDestination = cleanArgs[1];
+
+if (!githubUrl) {
+  console.log("Usage: repolet <github-folder-url> [destination]");
+
+  console.log("Run 'repolet --help' for more information.");
+
+  process.exit(1);
+}
+
+try {
+  // --------------------------------
+  // 1. Parse GitHub URL
+  // --------------------------------
+  const folder = parseGitHubUrl(githubUrl);
+
+  console.log("\nRepository information:");
+  console.log(`  Owner : ${folder.owner}`);
+  console.log(`  Repo  : ${folder.repo}`);
+  console.log(`  Type  : ${folder.type}`);
+  console.log(`  Branch: ${folder.branch || "default"}`);
+  console.log(`  Path  : ${folder.path || "/"}`);
+
+  // --------------------------------
+  // 2. Determine destination
+  // --------------------------------
+  const destinationRoot =
+    customDestination ||
+    (folder.type === "folder" ? folder.path.split("/").pop() : folder.repo);
+
+  // --------------------------------
+  // 3. Check destination
+  // --------------------------------
+  try {
+    await fs.access(destinationRoot);
+
+    console.error(`\n❌ Destination already exists: ./${destinationRoot}`);
+
+    console.error("Choose another destination or remove the existing folder.");
+
+    process.exit(1);
+  } catch {
+    // Destination doesn't exist.
+  }
+
+  // --------------------------------
+  // 4. Find files
+  // --------------------------------
+  console.log("\nScanning folder recursively...");
+
+  const files = await getAllFiles(folder);
+
+  console.log(`Found ${files.length} files.`);
+
+  if (files.length === 0) {
+    console.log("\n⚠️ Folder is empty.");
+    process.exit(0);
+  }
+
+  // --------------------------------
+  // 5. Download
+  // --------------------------------
+  console.log(`\nDownloading to: ./${destinationRoot}\n`);
+
+  let successful = 0;
+  let failed = 0;
+
+  for (let i = 0; i < files.length; i++) {
+    const file = files[i];
+
+    const progress = `[${i + 1}/${files.length}]`;
+
+    try {
+      const outputPath = await downloadFile(file, destinationRoot, folder.path);
+
+      successful++;
+
+      console.log(`✓ ${progress} ${outputPath}`);
+    } catch (error) {
+      failed++;
+
+      console.error(`✗ ${progress} ${file.path}`);
+
+      console.error(`  ${error.message}`);
+    }
+  }
+
+  // --------------------------------
+  // 6. Summary
+  // --------------------------------
+  console.log("\n--------------------------------");
+  console.log("Download finished");
+  console.log("--------------------------------");
+
+  console.log(`Successful: ${successful}`);
+  console.log(`Failed    : ${failed}`);
+  console.log(`Location  : ./${destinationRoot}`);
+
+  if (failed > 0) {
+    console.log("\n⚠️ Some files could not be downloaded.");
+
+    process.exitCode = 1;
+  } else {
+    console.log("\n✅ Download complete!");
+  }
+} catch (error) {
+  console.error("\n❌ Error:", error.message);
+  process.exit(1);
+}

package/src/parser.js

@@ -0,0 +1,78 @@
+export function parseGitHubUrl(url) {
+  let parsedUrl;
+
+  try {
+    parsedUrl = new URL(url);
+  } catch {
+    throw new Error("Invalid URL.");
+  }
+
+  if (parsedUrl.hostname !== "github.com") {
+    throw new Error("Only github.com URLs are supported.");
+  }
+
+  const parts = parsedUrl.pathname
+    .split("/")
+    .filter(Boolean);
+
+  if (parts.length < 2) {
+    throw new Error(
+      "Invalid GitHub URL. Expected /owner/repository"
+    );
+  }
+
+  const owner = parts[0];
+
+  // Remove .git if the user supplied:
+  // https://github.com/user/repo.git
+  const repo = parts[1].replace(/\.git$/, "");
+
+  // Whole repository:
+  //
+  // github.com/user/repo
+  //
+  if (parts.length === 2) {
+    return {
+      owner,
+      repo,
+      branch: null,
+      path: "",
+      type: "repository"
+    };
+  }
+
+  // Folder:
+  //
+  // github.com/user/repo/tree/main/src
+  //
+  if (parts[2] !== "tree") {
+    throw new Error(
+      "Only GitHub repository or folder URLs are supported."
+    );
+  }
+
+  if (parts.length < 5) {
+    throw new Error(
+      "Invalid GitHub folder URL. Expected /owner/repo/tree/branch/folder"
+    );
+  }
+
+  const branch = parts[3];
+  const pathParts = parts.slice(4);
+
+  if (!branch) {
+    throw new Error("GitHub branch is missing.");
+  }
+
+  if (pathParts.length === 0) {
+    throw new Error("GitHub folder path is missing.");
+  }
+
+  return {
+    owner,
+    repo,
+    branch,
+    path: pathParts.join("/"),
+    type: "folder"
+  };
+}