rainbo-cli 0.1.4

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2026 Rainbo
+
+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,41 @@
+# rainbo-cli
+
+Rainbo command line tools for data migration workflows.
+
+## Requirements
+
+- Node.js 16+
+- R with `Rscript` available on `PATH`
+
+## Install
+
+```bash
+npm install -g rainbo-cli
+rainbo-cli --version
+```
+
+## Development
+
+```bash
+Rscript src/rainbo-cli.R --version
+npm run build:release
+node scripts/run.js help
+```
+
+## Release
+
+1. Update `package.json` version.
+2. Commit the change.
+3. Run:
+
+```bash
+bash scripts/tag-release.sh
+```
+
+Pushing the `vX.Y.Z` tag triggers GitHub Actions to create GitHub Release
+archives and publish the npm wrapper package.
+
+Required repository secret:
+
+- `NPM_TOKEN`: npm automation token with publish permission for `rainbo-cli`.
+

package/checksums.txt

@@ -0,0 +1,6 @@
+cb7e4a240e532b2c52dbdd37596ccf3540ca9c9cfd54e2f0a5e5edb4ea8454c9  rainbo-cli-0.1.4-darwin-amd64.tar.gz
+608c5002eb6e4ab1b319562cb1433d549e57788aee5dbba249ce0afcfaf7912a  rainbo-cli-0.1.4-darwin-arm64.tar.gz
+70230ae663d06aafe66c36d9f9e890fdaf3110c01f2369786062803904e8120c  rainbo-cli-0.1.4-linux-amd64.tar.gz
+32e430c0d39775ffcdb433a0e1998f394509f581d9e4e0f19b9bbc73e65c6323  rainbo-cli-0.1.4-linux-arm64.tar.gz
+0adf480f6151eee0c2482454bfc74af4875aa14036d68254424068012bbc3ecc  rainbo-cli-0.1.4-windows-amd64.zip
+0adf480f6151eee0c2482454bfc74af4875aa14036d68254424068012bbc3ecc  rainbo-cli-0.1.4-windows-arm64.zip

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "rainbo-cli",
+  "version": "0.1.4",
+  "description": "Rainbo command line tools for data migration workflows",
+  "bin": {
+    "rainbo-cli": "scripts/run.js"
+  },
+  "scripts": {
+    "build:release": "bash scripts/build-release.sh",
+    "postinstall": "node scripts/install.js",
+    "test": "node scripts/run.js --version && node scripts/run.js help"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/work2a/rainbo-cli.git"
+  },
+  "license": "MIT",
+  "files": [
+    "scripts/install.js",
+    "scripts/run.js",
+    "checksums.txt",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/scripts/install.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+
+const crypto = require("crypto");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const { execFileSync } = require("child_process");
+
+const VERSION = require("../package.json").version.replace(/-.*$/, "");
+const REPO = "work2a/rainbo-cli";
+const NAME = "rainbo-cli";
+
+const PLATFORM_MAP = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+};
+
+const ARCH_MAP = {
+  x64: "amd64",
+  arm64: "arm64",
+};
+
+const platform = PLATFORM_MAP[process.platform];
+const arch = ARCH_MAP[process.arch];
+const isWindows = process.platform === "win32";
+const ext = isWindows ? ".zip" : ".tar.gz";
+const archiveName = `${NAME}-${VERSION}-${platform}-${arch}${ext}`;
+const githubUrl = `https://github.com/${REPO}/releases/download/v${VERSION}/${archiveName}`;
+const vendorDir = path.join(__dirname, "..", "vendor");
+const installDir = path.join(vendorDir, NAME);
+
+function download(url, destPath) {
+  execFileSync("curl", [
+    "--fail",
+    "--location",
+    "--silent",
+    "--show-error",
+    "--connect-timeout",
+    "10",
+    "--max-time",
+    "120",
+    "--max-redirs",
+    "3",
+    "--output",
+    destPath,
+    url,
+  ], { stdio: ["ignore", "ignore", "pipe"] });
+}
+
+function getExpectedChecksum(archive) {
+  const checksumsPath = path.join(__dirname, "..", "checksums.txt");
+  if (!fs.existsSync(checksumsPath)) {
+    console.error("[WARN] checksums.txt not found, skipping checksum verification");
+    return null;
+  }
+
+  const content = fs.readFileSync(checksumsPath, "utf8");
+  for (const line of content.split("\n")) {
+    const trimmed = line.trim();
+    if (!trimmed) continue;
+    const idx = trimmed.indexOf("  ");
+    if (idx === -1) continue;
+    if (trimmed.slice(idx + 2) === archive) return trimmed.slice(0, idx);
+  }
+
+  throw new Error(`Checksum entry not found for ${archive}`);
+}
+
+function verifyChecksum(archivePath, expectedHash) {
+  if (expectedHash === null) return;
+
+  const actual = crypto.createHash("sha256")
+    .update(fs.readFileSync(archivePath))
+    .digest("hex");
+
+  if (actual.toLowerCase() !== expectedHash.toLowerCase()) {
+    throw new Error(`Checksum mismatch for ${path.basename(archivePath)}`);
+  }
+}
+
+function extractArchive(archivePath, destDir) {
+  fs.rmSync(destDir, { recursive: true, force: true });
+  fs.mkdirSync(destDir, { recursive: true });
+
+  if (isWindows) {
+    const psCommand =
+      "$ErrorActionPreference='Stop';" +
+      "Expand-Archive -LiteralPath $env:RAINBO_CLI_ARCHIVE -DestinationPath $env:RAINBO_CLI_DEST -Force";
+    execFileSync("powershell.exe", [
+      "-NoProfile",
+      "-ExecutionPolicy",
+      "Bypass",
+      "-Command",
+      psCommand,
+    ], {
+      stdio: "inherit",
+      env: {
+        ...process.env,
+        RAINBO_CLI_ARCHIVE: archivePath,
+        RAINBO_CLI_DEST: destDir,
+      },
+    });
+  } else {
+    execFileSync("tar", ["-xzf", archivePath, "-C", destDir, "--strip-components", "1"], {
+      stdio: "inherit",
+    });
+  }
+}
+
+function install() {
+  if (!platform || !arch) {
+    throw new Error(`Unsupported platform: ${process.platform}-${process.arch}`);
+  }
+
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), `${NAME}-`));
+  const archivePath = path.join(tmpDir, archiveName);
+
+  try {
+    download(githubUrl, archivePath);
+    verifyChecksum(archivePath, getExpectedChecksum(archiveName));
+    extractArchive(archivePath, installDir);
+    console.log(`${NAME} v${VERSION} installed successfully`);
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+if (require.main === module) {
+  const isNpxPostinstall = process.env.npm_command === "exec" && !process.env.RAINBO_CLI_RUN;
+  if (isNpxPostinstall) process.exit(0);
+
+  try {
+    install();
+  } catch (err) {
+    console.error(`Failed to install ${NAME}: ${err.message}`);
+    console.error(`Make sure the v${VERSION} GitHub Release exists and Rscript is installed.`);
+    process.exit(1);
+  }
+}
+
+module.exports = { getExpectedChecksum, verifyChecksum };
+

package/scripts/run.js

@@ -0,0 +1,44 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const isWindows = process.platform === "win32";
+const launcher = path.join(
+  __dirname,
+  "..",
+  "vendor",
+  "rainbo-cli",
+  isWindows ? "rainbo-cli.cmd" : "rainbo-cli"
+);
+const sourceEntry = path.join(__dirname, "..", "src", "rainbo-cli.R");
+
+function installIfMissing() {
+  if (fs.existsSync(launcher)) return;
+  if (fs.existsSync(sourceEntry)) return;
+
+  const result = spawnSync(process.execPath, [path.join(__dirname, "install.js")], {
+    stdio: "inherit",
+    env: { ...process.env, RAINBO_CLI_RUN: "true" },
+  });
+
+  if (result.status !== 0) {
+    process.exit(result.status || 1);
+  }
+}
+
+installIfMissing();
+
+const useSource = fs.existsSync(sourceEntry);
+const command = useSource ? "Rscript" : launcher;
+const args = useSource ? [sourceEntry, ...process.argv.slice(2)] : process.argv.slice(2);
+
+const result = spawnSync(command, args, { stdio: "inherit", shell: isWindows });
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+process.exit(result.status || 0);