binary-collections 2.0.10 → 2.0.12

package/binaries/kill-night-crows.bat

@@ -0,0 +1,7 @@
+@echo off
+setlocal
+set "SCRIPT_DIR=%~dp0"
+
+powershell.exe -NoProfile -ExecutionPolicy Bypass -File "%SCRIPT_DIR%kill-night-crows.ps1" %*
+set "EXIT_CODE=%ERRORLEVEL%"
+endlocal & exit /b %EXIT_CODE%

package/binaries/kill-night-crows.ps1

@@ -0,0 +1,172 @@
+$isAdmin = ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole(
+    [Security.Principal.WindowsBuiltInRole]::Administrator
+)
+
+if (-not $isAdmin) {
+    $scriptPath = $PSCommandPath
+    if (-not $scriptPath) {
+        $scriptPath = $MyInvocation.MyCommand.Path
+    }
+
+    Write-Host "Requesting administrator privileges..."
+    Start-Process -FilePath "PowerShell.exe" -Verb RunAs -ArgumentList @(
+        "-NoProfile",
+        "-ExecutionPolicy",
+        "Bypass",
+        "-File",
+        $scriptPath
+    )
+    exit
+}
+
+$IntervalSeconds = 5
+$WatchSeconds = 5
+$KeepWindowOpen = $false
+$ShippingProcessName = "MadGlobal-Win64-Shipping"
+$LauncherProcessName = "MadGlobal.exe"
+
+function Write-Log {
+    param(
+        [string]$Message
+    )
+
+    $timestamp = Get-Date -Format "yyyy-MM-dd HH:mm:ss"
+    Write-Host "[$timestamp] $Message"
+}
+
+function Get-ParentProcess {
+    param(
+        [int]$ChildPid
+    )
+
+    try {
+        $child = Get-CimInstance Win32_Process -Filter "ProcessId = $ChildPid" -ErrorAction Stop
+        if (-not $child) {
+            return $null
+        }
+
+        return Get-CimInstance Win32_Process -Filter "ProcessId = $($child.ParentProcessId)" -ErrorAction SilentlyContinue
+    }
+    catch {
+        return $null
+    }
+}
+
+function Stop-ProcessTree {
+    param(
+        [int]$RootPid,
+        [string]$ExpectedProcessName
+    )
+
+    if ($RootPid -le 0) {
+        Write-Log "Invalid root PID: $RootPid"
+        return $false
+    }
+
+    if ($RootPid -eq $PID) {
+        Write-Log "Refusing to kill current PowerShell process PID $RootPid"
+        return $false
+    }
+
+    $root = Get-Process -Id $RootPid -ErrorAction SilentlyContinue
+    if (-not $root) {
+        Write-Log "Root process PID $RootPid no longer exists."
+        return $false
+    }
+
+    if ($ExpectedProcessName) {
+        $actualName = "$($root.ProcessName).exe"
+        if ($actualName -ine $ExpectedProcessName) {
+            Write-Log "Refusing to kill PID $RootPid because process is $actualName (expected $ExpectedProcessName)."
+            return $false
+        }
+    }
+
+    $taskkillOutput = & taskkill /F /T /PID $RootPid 2>&1
+    $taskkillExitCode = $LASTEXITCODE
+
+    if ($taskkillExitCode -ne 0) {
+        Write-Log "taskkill failed for PID $RootPid with exit code $taskkillExitCode"
+        foreach ($line in $taskkillOutput) {
+            Write-Log "taskkill: $line"
+        }
+        return $false
+    }
+
+    Write-Log "Killed process tree for PID $RootPid"
+    return $true
+}
+
+$startedAt = Get-Date
+if ($WatchSeconds -gt 0) {
+    Write-Log "Watching $ShippingProcessName.exe every $IntervalSeconds second(s) for up to $WatchSeconds second(s)."
+}
+else {
+    Write-Log "Watching $ShippingProcessName.exe every $IntervalSeconds second(s) until stopped."
+}
+
+while ($true) {
+    if ($WatchSeconds -gt 0) {
+        $elapsed = (Get-Date) - $startedAt
+        if ($elapsed.TotalSeconds -ge $WatchSeconds) {
+            Write-Log "Watch limit reached ($WatchSeconds second(s)). Exiting."
+            break
+        }
+    }
+
+    $shippingProcesses = Get-Process -Name $ShippingProcessName -ErrorAction SilentlyContinue
+
+    foreach ($shipping in $shippingProcesses) {
+        $responding = $true
+        try {
+            $responding = [bool]$shipping.Responding
+        }
+        catch {
+            # If we cannot read Responding, skip this process safely.
+            continue
+        }
+
+        if ($responding) {
+            continue
+        }
+
+        Write-Log "$($ShippingProcessName).exe PID $($shipping.Id) is not responding."
+
+        $parent = Get-ParentProcess -ChildPid $shipping.Id
+        if (-not $parent) {
+            Write-Log "Could not resolve parent process for PID $($shipping.Id)."
+            continue
+        }
+
+        if ($parent.Name -ieq $LauncherProcessName) {
+            Write-Log "Killing launcher tree: $($parent.Name) PID $($parent.ProcessId)"
+            $result = Stop-ProcessTree -RootPid ([int]$parent.ProcessId) -ExpectedProcessName $LauncherProcessName
+            if (-not $result) {
+                Write-Log "Launcher tree kill found no running processes."
+            }
+        }
+        else {
+            Write-Log "Parent process is $($parent.Name) PID $($parent.ProcessId); expected $LauncherProcessName. No action taken."
+        }
+    }
+
+    if ($WatchSeconds -gt 0) {
+        $remaining = $WatchSeconds - [int]((Get-Date) - $startedAt).TotalSeconds
+        if ($remaining -le 0) {
+            Write-Log "Watch limit reached ($WatchSeconds second(s)). Exiting."
+            break
+        }
+
+        if ($remaining -lt $IntervalSeconds) {
+            Start-Sleep -Seconds $remaining
+            continue
+        }
+    }
+
+    Start-Sleep -Seconds $IntervalSeconds
+}
+
+if ($KeepWindowOpen) {
+    Write-Host ""
+    Read-Host "Debug mode: press Enter to close"
+}

package/binaries/kill-process.cjs

@@ -1,43 +1,178 @@
 #!/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");
 
+/**
+ * __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));
 
-// Define possible script extensions by platform
+/**
+ * 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);
+
   if (fs.existsSync(script)) {
     found = script;
     break;
   }
 }
 
+/**
+ * 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 isSh = found.endsWith(".sh") || (found === found && process.platform !== "win32");
 
+/**
+ * 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 {
   cmd = found;
   args = process.argv.slice(2);
 }
 
-const result = spawnSync(cmd, args, { stdio: "inherit" });
+/**
+ * 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/binaries/nodekill.cjs

@@ -1,43 +1,178 @@
 #!/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");
 
+/**
+ * __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));
 
-// Define possible script extensions by platform
+/**
+ * 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);
+
   if (fs.existsSync(script)) {
     found = script;
     break;
   }
 }
 
+/**
+ * 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 isSh = found.endsWith(".sh") || (found === found && process.platform !== "win32");
 
+/**
+ * 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 {
   cmd = found;
   args = process.argv.slice(2);
 }
 
-const result = spawnSync(cmd, args, { stdio: "inherit" });
+/**
+ * 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/binaries/prod.cjs

@@ -1,43 +1,178 @@
 #!/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");
 
+/**
+ * __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));
 
-// Define possible script extensions by platform
+/**
+ * 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);
+
   if (fs.existsSync(script)) {
     found = script;
     break;
   }
 }
 
+/**
+ * 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 isSh = found.endsWith(".sh") || (found === found && process.platform !== "win32");
 
+/**
+ * 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 {
   cmd = found;
   args = process.argv.slice(2);
 }
 
-const result = spawnSync(cmd, args, { stdio: "inherit" });
+/**
+ * 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);