binary-collections 2.0.12 → 2.0.13

package/binaries/ycw.cjs

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+
+/**
+ * Built-in Node.js modules:
+ *
+ * - child_process:
+ *   Used to launch external scripts/programs.
+ *
+ * - path:
+ *   Safely handles file paths across operating systems.
+ *
+ * - fs:
+ *   Used to check whether files exist.
+ */
+const { spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const which = require('which');
+const { isWindows } = require('../src/utils/isWindows.js');
+
+/**
+ * __dirname
+ *   Absolute directory path of this launcher script.
+ *
+ * __filename
+ *   Absolute path of this launcher file itself.
+ *
+ * base
+ *   Filename without extension.
+ *
+ * Example:
+ *   File = "/tools/mytool.js"
+ *
+ *   binDir = "/tools"
+ *   base   = "mytool"
+ */
+const binDir = __dirname;
+const base = path.basename(__filename, path.extname(__filename));
+
+/**
+ * Determine which script extensions to search for
+ * based on the current operating system.
+ *
+ * Windows:
+ *   .cmd
+ *   .bat
+ *   .ps1
+ *   .vbs
+ *
+ * Linux/macOS:
+ *   .sh
+ *   executable file without extension
+ */
+const candidates = process.platform === 'win32' ? ['.cmd', '.bat', '.ps1', '.vbs'] : ['.sh', ''];
+
+/**
+ * Search for the first matching script
+ * in the same directory as this launcher.
+ *
+ * Example:
+ *   If base = "mytool"
+ *
+ *   Windows checks:
+ *     mytool.cmd
+ *     mytool.bat
+ *     mytool.ps1
+ *     mytool.vbs
+ *
+ *   Linux/macOS checks:
+ *     mytool.sh
+ *     mytool
+ */
+let found = null;
+
+for (const ext of candidates) {
+  const script = path.join(binDir, base + ext);
+  const exists = fs.existsSync(script);
+  // console.log(`Checking for ${script}: ${exists ? 'found' : 'not found'}`);
+  if (exists) {
+    found = script;
+    break;
+  }
+}
+
+/**
+ * If no matching script was found,
+ * try check if `bash` is available and if so, check for a .sh script.
+ */
+if (!found) {
+  try {
+    spawnSync('bash', ['--version'], { stdio: 'ignore' });
+    const bashScript = [path.join(binDir, base), path.join(binDir, base + '.sh')].find((script) =>
+      fs.existsSync(script)
+    );
+    if (bashScript) {
+      found = bashScript;
+    }
+  } catch {
+    // bash is not available, do nothing
+  }
+}
+
+/**
+ * If no matching script was found,
+ * print an error and exit with failure code 1.
+ */
+if (!found) {
+  console.error(`No script found for ${base} in ${binDir}`);
+  process.exit(1);
+}
+
+/**
+ * Detect special script types
+ * that require a shell/interpreter.
+ */
+const isPs1 = found.endsWith('.ps1');
+const isCmd = found.endsWith('.cmd');
+const isUnixShell = found.endsWith('.sh') || path.extname(found) === '';
+
+/**
+ * cmd
+ *   The executable program to launch.
+ *
+ * args
+ *   Arguments passed to the executable.
+ */
+let cmd, args;
+
+/**
+ * PowerShell scripts:
+ *
+ * Run through powershell.exe because .ps1 files
+ * are not directly executable like binaries.
+ *
+ * Flags:
+ *   -NoProfile
+ *     Prevent loading user profile scripts.
+ *
+ *   -ExecutionPolicy Bypass
+ *     Allow script execution even if policy blocks it.
+ *
+ *   -File
+ *     Specifies the script to execute.
+ *
+ * process.argv.slice(2)
+ *   Forward all user-provided command-line arguments.
+ */
+if (isPs1) {
+  cmd = 'powershell.exe';
+
+  args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', found, ...process.argv.slice(2)];
+
+  /**
+   * CMD batch files:
+   *
+   * Run through cmd.exe using:
+   *   /c
+   * which means:
+   *   "execute command and terminate"
+   */
+} else if (isCmd) {
+  cmd = 'cmd.exe';
+
+  args = ['/c', found, ...process.argv.slice(2)];
+
+  /**
+   * Other scripts:
+   *
+   * Usually:
+   *   - shell scripts (.sh)
+   *   - executable binaries
+   *
+   * These can be executed directly.
+   */
+} else if (isUnixShell) {
+  // Capture shebang scripts (no extension) and .sh scripts
+  const shebang = fs.readFileSync(found, 'utf8').split('\n')[0].trim();
+  const interpreter = shebang.startsWith('#!')
+    ? shebang
+        .slice(2)
+        .trim()
+        .replace(/^\/usr\/bin\/env\s+/, '')
+        .replace(/^\/bin\/env\s+/, '')
+        .replace(/^\/usr\/bin\//, '')
+        .replace(/^\/bin\//, '')
+    : null;
+
+  if (interpreter) {
+    const resolvedOrNull = which.sync(interpreter, { nothrow: true });
+    if (!resolvedOrNull) {
+      if (['bash', 'sh'].includes(interpreter) && isWindows()) {
+        const locationsToCheck = [
+          'C:\\Program Files\\Git\\usr\\bin',
+          'C:\\Program Files\\Git\\bin',
+          'C:\\Program Files (x86)\\Git\\usr\\bin',
+          'C:\\msys64\\usr\\bin',
+          'C:\\msys64\\bin',
+          'C:\\cygwin64\\bin',
+          'C:\\cygwin\\bin',
+          'C:\\MinGW\\bin',
+          'C:\\MinGW\\msys\\1.0\\bin'
+        ];
+        for (const location of locationsToCheck) {
+          const potentialPath = path.join(location, 'bash.exe');
+          if (fs.existsSync(potentialPath)) {
+            cmd = potentialPath;
+            args = [found, ...process.argv.slice(2)];
+            break;
+          }
+        }
+      }
+    } else {
+      cmd = resolvedOrNull || interpreter;
+      args = [found, ...process.argv.slice(2)];
+    }
+  } else {
+    cmd = found;
+    args = process.argv.slice(2);
+  }
+} else {
+  cmd = found;
+  args = process.argv.slice(2);
+}
+
+console.log(
+  `Executing: ${path.isAbsolute(cmd) ? path.relative(process.cwd(), cmd) : cmd} ${args
+    .map((f) => {
+      if (path.isAbsolute(f)) return path.relative(process.cwd(), f);
+      return f;
+    })
+    .join(' ')}`
+);
+
+/**
+ * Execute the selected script synchronously.
+ *
+ * stdio: "inherit"
+ *   Shares the current terminal with the child process,
+ *   so stdout/stderr/input behave normally.
+ *
+ * spawnSync waits until the child process exits.
+ */
+const result = spawnSync(cmd, args, {
+  stdio: 'inherit'
+});
+
+/**
+ * Exit using the same exit code
+ * returned by the child process.
+ *
+ * If result.status is null/undefined,
+ * default to exit code 1.
+ */
+process.exit(result.status ?? 1);

package/docs-src/binary-collections.md

@@ -0,0 +1,34 @@
+## Binary Collections (Main Dispatcher)
+
+The main entry point that dynamically finds and executes other scripts by name.
+
+### Usage
+
+```bash
+npx --legacy-peer-deps -y binary-collections <script-name> [...args]
+```
+
+### Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `list` | List all available scripts |
+| `<script-name>` | Find and execute a script by name |
+| `-h, --help` | Show help message |
+
+### Examples
+
+```bash
+npx --legacy-peer-deps -y binary-collections list
+npx --legacy-peer-deps -y binary-collections git-diff -s
+npx --legacy-peer-deps -y binary-collections del-node-modules --force
+npx --legacy-peer-deps -y binary-collections find-node-modules
+```
+
+### Development
+
+When developing locally, use `bc <commandName>` (`bin/bc` on Unix or `bin/bc.cmd` on Windows). Its usage is the same as `binary-collections <commandName>`.
+
+### Source
+
+See [`src/binary-collections.cjs`](../src/binary-collections.cjs) & [`bin/bc`](../bin/bc)

package/docs-src/changelog.md

@@ -0,0 +1,26 @@
+## Changelog Generator
+
+Generates a `CHANGELOG.md` file from git commit history, grouped by version bumps.
+
+### Usage
+
+```bash
+changelog
+```
+
+### Description
+
+- Analyzes git commit history looking for version bumps
+- Groups commits by version
+- Skips dependabot and irrelevant commits
+- Outputs the original git log to `tmp/original.md` for reference
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+
+### Source
+
+See [`src/changelog.cjs`](../src/changelog.cjs)

package/docs-src/clean-github-actions-caches.md

@@ -0,0 +1,115 @@
+## GitHub Actions Cache Cleaner
+
+Removes outdated GitHub Actions caches in the current repository, keeping only the newest cache for each prefix. Ensures safe cleanup by retaining the latest cache per group and authenticates using tokens from your .env file.
+
+### Usage
+
+```bash
+# use npx
+npx --yes binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz clean-github-actions-caches
+
+# use yarn dlx
+yarn dlx binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz clean-github-actions-caches
+
+# keep the first 3 cache key segments as the grouping prefix
+clean-github-actions-caches --prefix-depth 3
+```
+
+### Aliases
+
+This command is available under several aliases (all invoke the same CLI):
+
+- `clean-github-actions-cache`
+- `clear-github-actions-cache`
+- `clear-github-actions-caches`
+- `clear-gh-caches`
+
+
+### Features
+- Authenticates using `ACCESS_TOKEN` or `GITHUB_TOKEN` from your `.env` file
+- Groups caches by the first N key segments split on `-` or `_` and deletes all but the latest for each group
+- Operates on the current repository (origin remote) and matches the working directory of your terminal
+- Safe: Only deletes caches older than the most recent per prefix
+- Accepts `--repo owner/repo` to target a specific repository and `--prefix-depth <n>` to control grouping
+
+### Environment Setup
+1. Add `ACCESS_TOKEN` or `GITHUB_TOKEN` to your `.env` file
+2. Ensure you have access to the repository's cache management
+
+### Source
+See [`src/clean-github-actions-caches.cjs`](../src/clean-github-actions-caches.cjs) & [`src/clean-github-actions-caches-cli.cjs`](../src/clean-github-actions-caches-cli.cjs)
+
+### Github CI Examples
+
+```yaml
+name: Clean GitHub Actions Cache
+
+on:
+  # Trigger this workflow when the specified workflows complete (e.g., after build and test workflows)
+  workflow_run:
+    workflows:
+      - Node.js Package Build
+      - Node.js Package Test
+    types:
+      - completed
+
+  # Allow manual triggering of this workflow from the GitHub Actions UI
+  workflow_dispatch:
+
+  # Uncomment the following lines to enable scheduled cache cleaning (e.g., every hour)
+  # schedule:
+  #   - cron: '0 * * * *'
+
+  # Uncomment the following lines to enable cache cleaning on pushes to the master branch
+  # push:
+  #   branches:
+  #     - master
+
+  # Allow this workflow to be called by other workflows, passing the ACCESS_TOKEN secret
+  workflow_call:
+    secrets:
+      ACCESS_TOKEN:
+        required: true
+
+concurrency:
+  group: clean-cache
+  cancel-in-progress: true
+
+jobs:
+  clean-cache:
+    # if: contains(github.repository, 'php-proxy-hunter')
+    runs-on: windows-latest
+
+    env:
+      PIP_CACHE_DIR: "${{ github.workspace }}/project/tmp/pip"
+      NUITKA_CACHE_DIR: "${{ github.workspace }}/project/tmp/nuitka-cache"
+      NODE_OPTIONS: "--max_old_space_size=4096"
+      YARN_ENABLE_IMMUTABLE_INSTALLS: false
+      ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+      GH_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+      YARN_CHECKSUM_BEHAVIOR: update
+
+    steps:
+      - name: 📥 Checkout Repository
+        uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+
+      - name: 🐍 Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          architecture: "x64"
+
+      - name: 🟢 Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20.x
+
+      - name: 🧹 Clean GitHub Actions Cache ${{ github.event.workflow_run.head_sha }}
+        env:
+          GH_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+        run: |
+          npx --legacy-peer-deps -y binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz clean-github-actions-caches --repo ${{ github.repository }} --sha ${{ github.event.workflow_run.head_sha }}
+        shell: bash
+```

package/docs-src/copy-move-file.md

@@ -0,0 +1,59 @@
+## Copy & Move File
+
+Copies or moves files/directories via CLI.
+
+### Usage
+
+```bash
+copy <src> <dest>
+move <src> <dest>
+````
+
+### Behavior
+
+* If `src` is a **file** and `dest` is a **directory**, the file will be placed inside that directory using its original filename.
+* If `src` is a **file** and `dest` is a **file path**, it will be copied/moved directly to that path.
+* If `src` is a **directory**, the entire directory will be copied/moved into the destination.
+
+### Aliases
+
+The copy command is available under several aliases (all invoke the same CLI):
+
+* `copy` (default)
+* `node-copy`
+* `copy-file`
+
+The move command is available under several aliases (all invoke the same CLI):
+
+* `move` (default)
+* `node-move`
+* `move-file`
+
+### Options
+
+| Option       | Description       |
+| ------------ | ----------------- |
+| `-h, --help` | Show help message |
+
+### Examples
+
+```bash
+# file → file
+copy file.txt backup/file.txt
+move file.txt backup/file.txt
+
+# file → directory (auto-append filename)
+copy file.txt backup/
+move file.txt backup/
+
+# directory → directory
+copy ./src ./dist
+move ./src ./dist
+```
+
+### Source
+
+See [`src/file/copy-cli.mjs`](../src/file/copy-cli.mjs),
+[`src/file/copy.mjs`](../src/file/copy.mjs),
+[`src/file/move-cli.mjs`](../src/file/move-cli.mjs),
+[`src/file/move.mjs`](../src/file/move.mjs)

package/docs-src/del-gradle.md

@@ -0,0 +1,17 @@
+## Gradle Build Cleaner
+
+Deletes Gradle `build/` directories.
+
+### Usage
+
+```bash
+del-gradle
+```
+
+### Description
+
+Searches for `build.gradle` files and deletes the adjacent `build/` directories, ignoring `node_modules` and `vendor` directories.
+
+### Source
+
+See [`src/del-gradle.js`](../src/del-gradle.js)

package/docs-src/del-ps.md

@@ -0,0 +1,28 @@
+## Process Management
+
+Terminate processes quickly by name or type across platforms.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `del-ps <process-name>` | Kill processes by command name (cross-platform) |
+| `kill-process <name>` | Kill process by name (Unix `killall`) |
+| `nodekill` | Kill all Node.js processes |
+| `javakill` | Kill all Java processes (Windows `taskkill`) |
+
+### Usage
+
+```bash
+# Kill processes by name
+del-ps <process-name>
+
+# Kill specific types
+kill-process <name>    # Unix: uses killall
+nodekill               # Kill all node.exe processes
+javakill               # Kill all java.exe processes (Windows)
+```
+
+### Source
+
+See [`src/del-ps.js`](../src/del-ps.js) and shell wrappers in [`bin/`](../bin/)

package/docs-src/downloader.md

@@ -0,0 +1,62 @@
+# Downloader
+
+Downloads files from URLs over HTTP/HTTPS to the local filesystem. Uses `axios` with streaming to efficiently write downloaded content directly to disk, and supports up to 10 redirects.
+
+## Usage
+
+```bash
+downloader <url> [output-path]
+```
+
+### Aliases
+
+This command is available under several aliases (all invoke the same CLI):
+
+- `downloader` (default)
+- `download`
+- `download-file`
+- `file-downloader`
+- `fetch-file`
+
+### Arguments
+
+| Argument      | Description                             |
+| :------------ | :-------------------------------------- |
+| `url`         | File URL to download (required)         |
+| `output-path` | Optional destination path on disk       |
+
+### Options
+
+| Flag           | Description       |
+| :------------- | :---------------- |
+| `-h`, `--help` | Show help message |
+
+### Behavior
+
+- If no `output-path` is provided, the filename is derived from the URL's pathname (e.g., `https://example.com/file.zip` saves as `file.zip` in the current directory).
+- If the URL path ends with `/` or has no filename segment, the default name `downloaded-file` is used.
+- The output path is resolved to an absolute path, and any missing parent directories are created automatically.
+
+### Examples
+
+Download to the current directory (filename auto-derived from URL):
+
+```bash
+downloader https://example.com/file.zip
+```
+
+Download and save with a custom filename:
+
+```bash
+downloader https://example.com/file.zip downloads/custom.zip
+```
+
+Using an alias:
+
+```bash
+fetch-file https://example.com/data.json ./data/input.json
+```
+
+## Source
+
+See [`src/downloader-cli.cjs`](../src/downloader-cli.cjs).

package/docs-src/env-helpers.md

@@ -0,0 +1,29 @@
+## Environment Helpers
+
+Set `NODE_ENV` and run a command in the configured environment.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `dev <command>` | Sets `NODE_ENV=development` and runs the command |
+| `prod <command>` | Sets `NODE_ENV=production` and runs the command |
+| `empty` | No-op utility placeholder |
+
+### Usage
+
+```bash
+dev <command> [args...]
+prod <command> [args...]
+```
+
+### Examples
+
+```bash
+dev node server.js
+prod npm start
+```
+
+### Source
+
+See [`bin/dev`](../bin/dev) & [`bin/prod`](../bin/prod)

package/docs-src/find-node-modules.md

@@ -0,0 +1,17 @@
+## Find Node Modules
+
+Locates all `node_modules` directories within a project.
+
+### Usage
+
+```bash
+find-node-modules
+```
+
+### Description
+
+Finds and prints all `node_modules` directories under the current working directory.
+
+### Source
+
+See [`src/find-node-modules.cjs`](../src/find-node-modules.cjs) & [`src/find-node-modules-cli.js`](../src/find-node-modules-cli.js)

package/docs-src/free-chatgpt.md

@@ -0,0 +1,26 @@
+# free-chatgpt.js
+
+Automates browser interaction with ChatGPT using Puppeteer, including login, question submission, and response retrieval. Supports session persistence via cookies and flexible question input.
+
+## Usage
+
+```bash
+# use npx
+npx --yes binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz free-chatgpt
+
+# use yarn dlx
+yarn dlx binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz free-chatgpt
+```
+
+### Argument Options
+
+- `--question, -q`   The question to ask ChatGPT (default: "Hello, ChatGPT!")
+- `--qfile, -qf`     Path to a file containing the question text
+- `--help, -h`       Show help message
+
+## Notes
+
+- Cookies are stored in `./tmp/cookies` for session reuse.
+- Responses are saved to `./tmp/response.txt`.
+- Requires access to `chat.openai.com` (firewall must allow connection).
+- Uses Puppeteer with stealth plugin to avoid bot detection.