binary-collections 2.0.8 → 2.0.9

package/lib/package-resolutions-updater.d.ts

@@ -4,6 +4,8 @@ import fs from 'fs';
 import https from 'https';
 import os from 'os';
 import path from 'path';
+import { getArgs } from './utils.js';
+import 'minimist';
 
 /**
  * 📦 GitHub Package Resolver
@@ -35,6 +37,30 @@ import path from 'path';
 
 const projectDir = process.cwd();
 const envPath = path.join(projectDir, ".env");
+const args = getArgs();
+const ACCESS_TOKEN = process.env.GITHUB_TOKEN || process.env.ACCESS_TOKEN;
+
+// Show help if --help/-h is passed
+if (args.help || args.h) {
+  showHelp();
+}
+
+/**
+ * Display help information for the package-resolutions-updater script.
+ */
+function showHelp() {
+  const helpText = `\n\
+GitHub Package Resolutions Updater\n\
+Usage:\n  node src/package-resolutions-updater.mjs [options]\n\
+Options:\n  --help, -h           Show this help message\n\
+Description:\n  Updates the commit hashes in package.json's 'resolutions' field for GitHub tarball URLs to point to the latest commit SHA of the corresponding repository and branch.\n\
+Features:\n  - Parses GitHub URLs to extract repository owner, name, and branch.\n  - Fetches the latest commit SHA across all branches using GitHub's API.\n  - Replaces the old branch or commit in the URL with the latest SHA.\n  - Overwrites package.json with the updated URLs.\n\
+Requirements:\n  - GitHub Personal Access Token (GITHUB_TOKEN) via .env\n  - ESM support (type: "module" in package.json)\n  - Node.js v18+ recommended\n\
+Dependencies:\n  - ansi-colors – for styled terminal output\n  - dotenv – to load GitHub token from .env\n\
+Examples:\n  node src/package-resolutions-updater.mjs\n  node src/package-resolutions-updater.mjs --help\n\n`;
+  console.log(helpText);
+  process.exit(0);
+}
 
 // Load the .env file using dotenv (ESM import)
 if (fs.existsSync(envPath)) dotenv.config({ path: envPath });
@@ -128,7 +154,7 @@ function fetchJson(url) {
     "User-Agent": selectedUserAgent,
     Accept: "application/vnd.github.v3+json",
     "X-GitHub-Api-Version": "2022-11-28",
-    ...(process.env.GITHUB_TOKEN ? { Authorization: `token ${process.env.GITHUB_TOKEN}` } : {})
+    ...(ACCESS_TOKEN ? { Authorization: `token ${ACCESS_TOKEN}` } : {})
   };
   return new Promise((resolve, reject) => {
     https

package/lib/package-resolutions-updater.mjs

@@ -39,8 +39,31 @@ import fs from "fs";
 import https from "https";
 import os from "os";
 import path from "path";
+import { getArgs } from "./utils.js";
 const projectDir = process.cwd();
 const envPath = path.join(projectDir, ".env");
+const args = getArgs();
+const ACCESS_TOKEN = process.env.GITHUB_TOKEN || process.env.ACCESS_TOKEN;
+// Show help if --help/-h is passed
+if (args.help || args.h) {
+    showHelp();
+}
+/**
+ * Display help information for the package-resolutions-updater script.
+ */
+function showHelp() {
+    const helpText = `\n\
+GitHub Package Resolutions Updater\n\
+Usage:\n  node src/package-resolutions-updater.mjs [options]\n\
+Options:\n  --help, -h           Show this help message\n\
+Description:\n  Updates the commit hashes in package.json's 'resolutions' field for GitHub tarball URLs to point to the latest commit SHA of the corresponding repository and branch.\n\
+Features:\n  - Parses GitHub URLs to extract repository owner, name, and branch.\n  - Fetches the latest commit SHA across all branches using GitHub's API.\n  - Replaces the old branch or commit in the URL with the latest SHA.\n  - Overwrites package.json with the updated URLs.\n\
+Requirements:\n  - GitHub Personal Access Token (GITHUB_TOKEN) via .env\n  - ESM support (type: "module" in package.json)\n  - Node.js v18+ recommended\n\
+Dependencies:\n  - ansi-colors – for styled terminal output\n  - dotenv – to load GitHub token from .env\n\
+Examples:\n  node src/package-resolutions-updater.mjs\n  node src/package-resolutions-updater.mjs --help\n\n`;
+    console.log(helpText);
+    process.exit(0);
+}
 // Load the .env file using dotenv (ESM import)
 if (fs.existsSync(envPath))
     dotenv.config({ path: envPath });
@@ -128,7 +151,7 @@ catch (_e) {
  * @returns {Promise<any>}
  */
 function fetchJson(url) {
-    const headers = Object.assign({ "User-Agent": selectedUserAgent, Accept: "application/vnd.github.v3+json", "X-GitHub-Api-Version": "2022-11-28" }, (process.env.GITHUB_TOKEN ? { Authorization: `token ${process.env.GITHUB_TOKEN}` } : {}));
+    const headers = Object.assign({ "User-Agent": selectedUserAgent, Accept: "application/vnd.github.v3+json", "X-GitHub-Api-Version": "2022-11-28" }, (ACCESS_TOKEN ? { Authorization: `token ${ACCESS_TOKEN}` } : {}));
     return new Promise((resolve, reject) => {
         https
             .get(url, { headers }, (res) => {

package/lib/submodule-install.cjs

@@ -11,6 +11,7 @@ if (fs.existsSync(envPath))
 const { getArgs } = require("./utils.js");
 const args = getArgs();
 const positional = args._ || [];
+const ACCESS_TOKEN = process.env.GITHUB_TOKEN || process.env.ACCESS_TOKEN;
 let ROOT = runGit(["rev-parse", "--show-toplevel"]).trim();
 let REPO_PATH = ROOT;
 if (args.cwd) {
@@ -54,22 +55,22 @@ for (const line of submoduleList) {
         continue;
     }
     const GIT_MODULES = path.join(RELATIVE_MODULE_PATH, ".gitmodules");
-    if (process.env.ACCESS_TOKEN) {
+    if (ACCESS_TOKEN) {
         let URL_WITH_TOKEN = "";
         let repoInfo;
         if (URL.includes("github.com")) {
             repoInfo = URL.replace("https://github.com/", "");
-            URL_WITH_TOKEN = `https://${process.env.ACCESS_TOKEN}@github.com/${repoInfo}`;
+            URL_WITH_TOKEN = `https://${ACCESS_TOKEN}@github.com/${repoInfo}`;
         }
         else if (URL.includes("gitlab.com") && typeof process.env.GITLAB_TOKEN === "string") {
             repoInfo = URL.replace("https://gitlab.com/", "");
-            URL_WITH_TOKEN = `https://oauth2:${process.env.ACCESS_TOKEN}@gitlab.com/${repoInfo}`;
+            URL_WITH_TOKEN = `https://oauth2:${ACCESS_TOKEN}@gitlab.com/${repoInfo}`;
         }
         else {
             // For other Git providers, try a generic approach
             const urlObj = new URL(URL);
             repoInfo = urlObj.pathname.substring(1); // Remove leading slash
-            URL_WITH_TOKEN = `${urlObj.protocol}//${process.env.ACCESS_TOKEN}@${urlObj.host}${urlObj.pathname}`;
+            URL_WITH_TOKEN = `${urlObj.protocol}//${ACCESS_TOKEN}@${urlObj.host}${urlObj.pathname}`;
         }
         if (URL_WITH_TOKEN && URL_WITH_TOKEN.length > 0) {
             console.log(`Apply token for ${repoInfo} at ${MODULE_PATH} branch ${BRANCH}`);

package/lib/submodule-install.d.mts

@@ -12,7 +12,7 @@ if (fs.existsSync(envPath)) dotenv.config({ path: envPath });
 const { getArgs } = require("./utils.js");
 const args = getArgs();
 const positional = args._ || [];
-
+const ACCESS_TOKEN = process.env.GITHUB_TOKEN || process.env.ACCESS_TOKEN;
 let ROOT = runGit(["rev-parse", "--show-toplevel"]).trim();
 let REPO_PATH = ROOT;
 
@@ -68,21 +68,21 @@ for (const line of submoduleList) {
 
   const GIT_MODULES = path.join(RELATIVE_MODULE_PATH, ".gitmodules");
 
-  if (process.env.ACCESS_TOKEN) {
+  if (ACCESS_TOKEN) {
     let URL_WITH_TOKEN = "";
     let repoInfo;
 
     if (URL.includes("github.com")) {
       repoInfo = URL.replace("https://github.com/", "");
-      URL_WITH_TOKEN = `https://${process.env.ACCESS_TOKEN}@github.com/${repoInfo}`;
+      URL_WITH_TOKEN = `https://${ACCESS_TOKEN}@github.com/${repoInfo}`;
     } else if (URL.includes("gitlab.com") && typeof process.env.GITLAB_TOKEN === "string") {
       repoInfo = URL.replace("https://gitlab.com/", "");
-      URL_WITH_TOKEN = `https://oauth2:${process.env.ACCESS_TOKEN}@gitlab.com/${repoInfo}`;
+      URL_WITH_TOKEN = `https://oauth2:${ACCESS_TOKEN}@gitlab.com/${repoInfo}`;
     } else {
       // For other Git providers, try a generic approach
       const urlObj = new URL(URL);
       repoInfo = urlObj.pathname.substring(1); // Remove leading slash
-      URL_WITH_TOKEN = `${urlObj.protocol}//${process.env.ACCESS_TOKEN}@${urlObj.host}${urlObj.pathname}`;
+      URL_WITH_TOKEN = `${urlObj.protocol}//${ACCESS_TOKEN}@${urlObj.host}${urlObj.pathname}`;
     }
 
     if (URL_WITH_TOKEN && URL_WITH_TOKEN.length > 0) {

package/lib/submodule-install.d.ts

@@ -12,7 +12,7 @@ if (fs.existsSync(envPath)) dotenv.config({ path: envPath });
 const { getArgs } = require("./utils.js");
 const args = getArgs();
 const positional = args._ || [];
-
+const ACCESS_TOKEN = process.env.GITHUB_TOKEN || process.env.ACCESS_TOKEN;
 let ROOT = runGit(["rev-parse", "--show-toplevel"]).trim();
 let REPO_PATH = ROOT;
 
@@ -68,21 +68,21 @@ for (const line of submoduleList) {
 
   const GIT_MODULES = path.join(RELATIVE_MODULE_PATH, ".gitmodules");
 
-  if (process.env.ACCESS_TOKEN) {
+  if (ACCESS_TOKEN) {
     let URL_WITH_TOKEN = "";
     let repoInfo;
 
     if (URL.includes("github.com")) {
       repoInfo = URL.replace("https://github.com/", "");
-      URL_WITH_TOKEN = `https://${process.env.ACCESS_TOKEN}@github.com/${repoInfo}`;
+      URL_WITH_TOKEN = `https://${ACCESS_TOKEN}@github.com/${repoInfo}`;
     } else if (URL.includes("gitlab.com") && typeof process.env.GITLAB_TOKEN === "string") {
       repoInfo = URL.replace("https://gitlab.com/", "");
-      URL_WITH_TOKEN = `https://oauth2:${process.env.ACCESS_TOKEN}@gitlab.com/${repoInfo}`;
+      URL_WITH_TOKEN = `https://oauth2:${ACCESS_TOKEN}@gitlab.com/${repoInfo}`;
     } else {
       // For other Git providers, try a generic approach
       const urlObj = new URL(URL);
       repoInfo = urlObj.pathname.substring(1); // Remove leading slash
-      URL_WITH_TOKEN = `${urlObj.protocol}//${process.env.ACCESS_TOKEN}@${urlObj.host}${urlObj.pathname}`;
+      URL_WITH_TOKEN = `${urlObj.protocol}//${ACCESS_TOKEN}@${urlObj.host}${urlObj.pathname}`;
     }
 
     if (URL_WITH_TOKEN && URL_WITH_TOKEN.length > 0) {

package/lib/submodule-install.mjs

@@ -23,6 +23,7 @@ var require_submodule_install = __commonJS({
     var { getArgs } = require_utils();
     var args = getArgs();
     var positional = args._ || [];
+    var ACCESS_TOKEN = process.env.GITHUB_TOKEN || process.env.ACCESS_TOKEN;
     var ROOT = runGit(["rev-parse", "--show-toplevel"]).trim();
     var REPO_PATH = ROOT;
     if (args.cwd) {
@@ -63,19 +64,19 @@ var require_submodule_install = __commonJS({
         continue;
       }
       const GIT_MODULES = path.join(RELATIVE_MODULE_PATH, ".gitmodules");
-      if (process.env.ACCESS_TOKEN) {
+      if (ACCESS_TOKEN) {
         let URL_WITH_TOKEN = "";
         let repoInfo;
         if (URL.includes("github.com")) {
           repoInfo = URL.replace("https://github.com/", "");
-          URL_WITH_TOKEN = `https://${process.env.ACCESS_TOKEN}@github.com/${repoInfo}`;
+          URL_WITH_TOKEN = `https://${ACCESS_TOKEN}@github.com/${repoInfo}`;
         } else if (URL.includes("gitlab.com") && typeof process.env.GITLAB_TOKEN === "string") {
           repoInfo = URL.replace("https://gitlab.com/", "");
-          URL_WITH_TOKEN = `https://oauth2:${process.env.ACCESS_TOKEN}@gitlab.com/${repoInfo}`;
+          URL_WITH_TOKEN = `https://oauth2:${ACCESS_TOKEN}@gitlab.com/${repoInfo}`;
         } else {
           const urlObj = new URL(URL);
           repoInfo = urlObj.pathname.substring(1);
-          URL_WITH_TOKEN = `${urlObj.protocol}//${process.env.ACCESS_TOKEN}@${urlObj.host}${urlObj.pathname}`;
+          URL_WITH_TOKEN = `${urlObj.protocol}//${ACCESS_TOKEN}@${urlObj.host}${urlObj.pathname}`;
         }
         if (URL_WITH_TOKEN && URL_WITH_TOKEN.length > 0) {
           console.log(`Apply token for ${repoInfo} at ${MODULE_PATH} branch ${BRANCH}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "binary-collections",
-  "version": "2.0.8",
+  "version": "2.0.9",
   "description": "Utility to clean any programming caches and more",
   "keywords": [
     "cache",

package/src/package-resolutions-updater.mjs

@@ -31,9 +31,34 @@ import fs from "fs";
 import https from "https";
 import os from "os";
 import path from "path";
+import { getArgs } from "./utils.js";
 
 const projectDir = process.cwd();
 const envPath = path.join(projectDir, ".env");
+const args = getArgs();
+const ACCESS_TOKEN = process.env.GITHUB_TOKEN || process.env.ACCESS_TOKEN;
+
+// Show help if --help/-h is passed
+if (args.help || args.h) {
+  showHelp();
+}
+
+/**
+ * Display help information for the package-resolutions-updater script.
+ */
+function showHelp() {
+  const helpText = `\n\
+GitHub Package Resolutions Updater\n\
+Usage:\n  node src/package-resolutions-updater.mjs [options]\n\
+Options:\n  --help, -h           Show this help message\n\
+Description:\n  Updates the commit hashes in package.json's 'resolutions' field for GitHub tarball URLs to point to the latest commit SHA of the corresponding repository and branch.\n\
+Features:\n  - Parses GitHub URLs to extract repository owner, name, and branch.\n  - Fetches the latest commit SHA across all branches using GitHub's API.\n  - Replaces the old branch or commit in the URL with the latest SHA.\n  - Overwrites package.json with the updated URLs.\n\
+Requirements:\n  - GitHub Personal Access Token (GITHUB_TOKEN) via .env\n  - ESM support (type: "module" in package.json)\n  - Node.js v18+ recommended\n\
+Dependencies:\n  - ansi-colors – for styled terminal output\n  - dotenv – to load GitHub token from .env\n\
+Examples:\n  node src/package-resolutions-updater.mjs\n  node src/package-resolutions-updater.mjs --help\n\n`;
+  console.log(helpText);
+  process.exit(0);
+}
 
 // Load the .env file using dotenv (ESM import)
 if (fs.existsSync(envPath)) dotenv.config({ path: envPath });
@@ -127,7 +152,7 @@ function fetchJson(url) {
     "User-Agent": selectedUserAgent,
     Accept: "application/vnd.github.v3+json",
     "X-GitHub-Api-Version": "2022-11-28",
-    ...(process.env.GITHUB_TOKEN ? { Authorization: `token ${process.env.GITHUB_TOKEN}` } : {})
+    ...(ACCESS_TOKEN ? { Authorization: `token ${ACCESS_TOKEN}` } : {})
   };
   return new Promise((resolve, reject) => {
     https

package/tmp/test-repo/package.json

@@ -2,6 +2,6 @@
   "name": "test-repo",
   "packageManager": "yarn@4.9.2",
   "dependencies": {
-    "binary-collections": "D:/Repositories/binary-collections/releases/bin.tgz"
+    "binary-collections": "D:\\Repositories\\binary-collections\\releases\\bin.tgz"
   }
 }