@revkeen/cli-binary 0.0.1-rc2

package/bin/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RevKeen
+
+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/bin/README.md

@@ -0,0 +1,54 @@
+# RevKeen CLI
+
+The official RevKeen command-line interface — manage payments, subscriptions,
+invoices and billing from your terminal.
+
+> **Know What You Keep, Not Just What You Earn.**
+
+A single self-contained binary (Go + [Cobra](https://cobra.dev)), with commands
+generated from the RevKeen OpenAPI contract.
+
+## Install
+
+```bash
+# Homebrew (macOS / Linux)
+brew install revkeen/tap/revkeen
+
+# npm
+npm install -g @revkeen/cli-binary
+
+# Shell script (macOS / Linux)
+curl -fsSL https://cli.revkeen.com/install.sh | sh
+```
+
+## Authentication
+
+```bash
+revkeen auth login          # OAuth device flow, or
+revkeen config set api-key rk_live_...   # API key (rk_live_* / rk_sandbox_*)
+```
+
+Configuration is stored in `~/.revkeen/config.toml`. The `REVKEEN_API_KEY`
+environment variable overrides the stored key.
+
+Target staging with `revkeen config set environment staging`.
+
+## Usage
+
+```bash
+revkeen customers list
+revkeen invoices list
+revkeen subscriptions get sub_123
+revkeen analytics revenue-get-mrr-summary
+
+# Escape hatch for any endpoint
+revkeen api GET /v2/customers
+revkeen api POST /v2/invoices -d '{"customerId":"cus_xxx"}'
+```
+
+Global flags: `--output table|json|yaml|csv`, `--json`, `--agent` (compact JSON
+for tools/LLMs), `--no-color`. Run `revkeen --help` for the full command list.
+
+## License
+
+[MIT](./LICENSE)

package/install.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const https = require("https");
+const os = require("os");
+const path = require("path");
+const { createWriteStream, mkdirSync } = fs;
+
+const VERSION = require("./package.json").version;
+const REPO = "revkeen/cli";
+
+const PLATFORM_MAP = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows",
+};
+
+const ARCH_MAP = {
+  x64: "amd64",
+  arm64: "arm64",
+};
+
+function getArchiveName() {
+  const platform = PLATFORM_MAP[process.platform];
+  const arch = ARCH_MAP[process.arch];
+
+  if (!platform) {
+    throw new Error(`Unsupported platform: ${process.platform}`);
+  }
+  if (!arch) {
+    throw new Error(`Unsupported architecture: ${process.arch}`);
+  }
+  if (platform === "windows" && arch === "arm64") {
+    throw new Error("Windows arm64 is not supported");
+  }
+
+  const ext = platform === "windows" ? "zip" : "tar.gz";
+  return `revkeen_${platform}_${arch}.${ext}`;
+}
+
+function getBinaryName() {
+  return process.platform === "win32" ? "revkeen.exe" : "revkeen";
+}
+
+function downloadFile(url) {
+  return new Promise((resolve, reject) => {
+    const follow = (url, redirects) => {
+      if (redirects > 5) {
+        return reject(new Error("Too many redirects"));
+      }
+
+      const proto = url.startsWith("https") ? https : require("http");
+      proto
+        .get(url, { headers: { "User-Agent": "revkeen-cli-npm" } }, (res) => {
+          if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+            return follow(res.headers.location, redirects + 1);
+          }
+          if (res.statusCode !== 200) {
+            return reject(
+              new Error(`Download failed: HTTP ${res.statusCode} from ${url}`)
+            );
+          }
+          const chunks = [];
+          res.on("data", (chunk) => chunks.push(chunk));
+          res.on("end", () => resolve(Buffer.concat(chunks)));
+          res.on("error", reject);
+        })
+        .on("error", reject);
+    };
+    follow(url, 0);
+  });
+}
+
+async function extractTarGz(buffer, destDir) {
+  const tmpFile = path.join(os.tmpdir(), `revkeen-${Date.now()}.tar.gz`);
+  fs.writeFileSync(tmpFile, buffer);
+  try {
+    execSync(`tar -xzf "${tmpFile}" -C "${destDir}"`, { stdio: "pipe" });
+  } finally {
+    fs.unlinkSync(tmpFile);
+  }
+}
+
+async function extractZip(buffer, destDir) {
+  const tmpFile = path.join(os.tmpdir(), `revkeen-${Date.now()}.zip`);
+  fs.writeFileSync(tmpFile, buffer);
+  try {
+    // Use PowerShell on Windows, unzip on Unix
+    if (process.platform === "win32") {
+      execSync(
+        `powershell -Command "Expand-Archive -Path '${tmpFile}' -DestinationPath '${destDir}' -Force"`,
+        { stdio: "pipe" }
+      );
+    } else {
+      execSync(`unzip -o "${tmpFile}" -d "${destDir}"`, { stdio: "pipe" });
+    }
+  } finally {
+    fs.unlinkSync(tmpFile);
+  }
+}
+
+async function main() {
+  const archiveName = getArchiveName();
+  const binaryName = getBinaryName();
+  const binDir = path.join(__dirname, "bin");
+  const binaryPath = path.join(binDir, binaryName);
+
+  // Skip if binary already exists (e.g. CI caching)
+  if (fs.existsSync(binaryPath)) {
+    console.log(`revkeen binary already exists at ${binaryPath}`);
+    return;
+  }
+
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${archiveName}`;
+  console.log(`Downloading revkeen v${VERSION} for ${process.platform}/${process.arch}...`);
+  console.log(`  ${url}`);
+
+  const buffer = await downloadFile(url);
+
+  mkdirSync(binDir, { recursive: true });
+
+  if (archiveName.endsWith(".zip")) {
+    await extractZip(buffer, binDir);
+  } else {
+    await extractTarGz(buffer, binDir);
+  }
+
+  // chmod +x on Unix
+  if (process.platform !== "win32") {
+    fs.chmodSync(binaryPath, 0o755);
+  }
+
+  // Verify the binary exists
+  if (!fs.existsSync(binaryPath)) {
+    throw new Error(
+      `Binary not found at ${binaryPath} after extraction. Archive contents may have unexpected structure.`
+    );
+  }
+
+  console.log(`Installed revkeen v${VERSION} to ${binaryPath}`);
+}
+
+main().catch((err) => {
+  // In CI or monorepo installs, the release may not exist yet.
+  // Don't fail pnpm install — the binary is only needed by npm consumers.
+  if (process.env.CI || process.env.REVKEEN_SKIP_CLI_DOWNLOAD) {
+    console.warn(`Skipping revkeen CLI download (CI): ${err.message}`);
+    process.exit(0);
+  }
+  console.error(`Failed to install revkeen: ${err.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@revkeen/cli-binary",
+  "version": "0.0.1-rc2",
+  "description": "RevKeen CLI — manage payments, subscriptions & billing from your terminal",
+  "bin": {
+    "revkeen": "run.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "install.js",
+    "run.js",
+    "bin/"
+  ],
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/revkeen/cli.git"
+  },
+  "homepage": "https://revkeen.com",
+  "keywords": [
+    "revkeen",
+    "cli",
+    "billing",
+    "payments",
+    "subscriptions",
+    "invoices"
+  ],
+  "license": "MIT"
+}

package/run.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+
+const binaryName = process.platform === "win32" ? "revkeen.exe" : "revkeen";
+const binaryPath = path.join(__dirname, "bin", binaryName);
+
+try {
+  execFileSync(binaryPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  if (err.status !== undefined) {
+    process.exit(err.status);
+  }
+  console.error(`Failed to run revkeen: ${err.message}`);
+  process.exit(1);
+}