@cratestack/cli 0.4.16

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stephane Segning
+
+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,49 @@
+# @cratestack/cli
+
+npm wrapper around [`cratestack-cli`](https://crates.io/crates/cratestack-cli) — the CrateStack
+`.cstack` schema validator and client/Studio code generator. Installing this package downloads the
+prebuilt `cratestack` binary matching your platform from the matching
+[GitHub Release](https://github.com/cratestack/cratestack/releases); no Rust toolchain required.
+
+## Install
+
+```bash
+npm install --global @cratestack/cli
+```
+
+Or run without installing:
+
+```bash
+npx @cratestack/cli --help
+```
+
+## Supported platforms
+
+macOS (x64, arm64), Linux (x64, arm64), Windows (x64). See
+[cratestack-cli](https://github.com/cratestack/cratestack/tree/main/crates/cratestack-cli) for the
+full command reference (`check`, `generate-dart`, `generate-typescript`, `studio`, `print-ir`).
+
+## How it works
+
+The `postinstall` script (`scripts/install.js`) detects your OS/architecture, downloads the
+matching release archive plus its `.sha256` checksum from GitHub Releases, verifies the checksum,
+and extracts the `cratestack` binary into `bin/`. The `cratestack` command then execs that binary.
+
+Environment variables:
+
+- `CRATESTACK_CLI_SKIP_DOWNLOAD=1` — skip the postinstall download (e.g. offline/vendored installs
+  that provide the binary another way).
+- `CRATESTACK_CLI_BINARY_PATH=/path/to/cratestack` — run a specific binary instead of the one
+  downloaded at install time.
+
+If the download fails or your platform isn't yet supported, fall back to:
+
+```bash
+cargo binstall cratestack-cli
+# or
+cargo install cratestack-cli
+```
+
+## License
+
+MIT

package/bin/cratestack.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+// Thin shim that execs the binary scripts/install.js downloaded into
+// ./bin/ at install time. Set CRATESTACK_CLI_BINARY_PATH to point at a
+// manually provided binary instead (e.g. a vendored/offline install).
+
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+
+const binName = process.platform === "win32" ? "cratestack.exe" : "cratestack";
+const binaryPath =
+  process.env.CRATESTACK_CLI_BINARY_PATH || path.join(__dirname, binName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(
+    `cratestack binary not found at ${binaryPath}.\n` +
+      "The postinstall download may have failed or been skipped " +
+      "(CRATESTACK_CLI_SKIP_DOWNLOAD, --ignore-scripts). Reinstall with:\n" +
+      "  npm install @cratestack/cli\n" +
+      "or fall back to:\n" +
+      "  cargo binstall cratestack-cli",
+  );
+  process.exit(1);
+}
+
+const result = spawnSync(binaryPath, process.argv.slice(2), { stdio: "inherit" });
+if (result.error) {
+  console.error(`failed to run ${binaryPath}: ${result.error.message}`);
+  process.exit(1);
+}
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@cratestack/cli",
+  "version": "0.4.16",
+  "description": "Prebuilt cratestack-cli binary, fetched from GitHub Releases on install. No Rust toolchain required.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cratestack/cratestack.git",
+    "directory": "packages/cratestack-cli-npm"
+  },
+  "homepage": "https://cratestack.dev",
+  "bugs": "https://github.com/cratestack/cratestack/issues",
+  "keywords": [
+    "cratestack",
+    "cstack",
+    "cli",
+    "codegen"
+  ],
+  "bin": {
+    "cratestack": "bin/cratestack.js"
+  },
+  "files": [
+    "bin",
+    "scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node ./scripts/install.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}

package/scripts/install.js

@@ -0,0 +1,148 @@
+#!/usr/bin/env node
+// Downloads the cratestack-cli binary matching this package's version and
+// the host platform from the GitHub Release the release-cli.yml workflow
+// publishes, verifies its checksum, and extracts it to ./bin/.
+//
+// Archive naming and layout here must stay in sync with:
+//   - .github/workflows/release-cli.yml ("Package archive" step)
+//   - crates/cratestack-cli/Cargo.toml   ([package.metadata.binstall])
+
+"use strict";
+
+const fs = require("node:fs");
+const https = require("node:https");
+const os = require("node:os");
+const path = require("node:path");
+const crypto = require("node:crypto");
+const { execFileSync } = require("node:child_process");
+
+const pkg = require("../package.json");
+
+const REPO = "https://github.com/cratestack/cratestack";
+const BIN_DIR = path.join(__dirname, "..", "bin");
+
+function resolveTarget() {
+  const platform = process.platform;
+  const arch = process.arch;
+  const targets = {
+    "darwin:x64": "x86_64-apple-darwin",
+    "darwin:arm64": "aarch64-apple-darwin",
+    "linux:x64": "x86_64-unknown-linux-gnu",
+    "linux:arm64": "aarch64-unknown-linux-gnu",
+    "win32:x64": "x86_64-pc-windows-msvc",
+  };
+  const target = targets[`${platform}:${arch}`];
+  if (!target) {
+    throw new Error(
+      `@cratestack/cli has no prebuilt binary for ${platform}/${arch}. ` +
+        `Supported: ${Object.keys(targets).join(", ")}. ` +
+        "Install from source instead: cargo install cratestack-cli",
+    );
+  }
+  return target;
+}
+
+function fetchBuffer(url, redirectsLeft = 5) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { "User-Agent": "cratestack-cli-npm-installer" } }, (res) => {
+        if (
+          res.statusCode >= 300 &&
+          res.statusCode < 400 &&
+          res.headers.location &&
+          redirectsLeft > 0
+        ) {
+          res.resume();
+          resolve(fetchBuffer(res.headers.location, redirectsLeft - 1));
+          return;
+        }
+        if (res.statusCode !== 200) {
+          reject(new Error(`GET ${url} failed: HTTP ${res.statusCode}`));
+          res.resume();
+          return;
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+        res.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+function verifyChecksum(assetName, archiveBuf, sha256Buf) {
+  const expected = sha256Buf.toString("utf8").trim().split(/\s+/)[0];
+  const actual = crypto.createHash("sha256").update(archiveBuf).digest("hex");
+  if (expected !== actual) {
+    throw new Error(
+      `checksum mismatch for ${assetName}: expected ${expected}, got ${actual}`,
+    );
+  }
+}
+
+function extract(archivePath, ext, destDir) {
+  fs.mkdirSync(destDir, { recursive: true });
+  if (ext === "zip") {
+    execFileSync(
+      "powershell",
+      [
+        "-NoProfile",
+        "-Command",
+        `Expand-Archive -Path '${archivePath}' -DestinationPath '${destDir}' -Force`,
+      ],
+      { stdio: "inherit" },
+    );
+  } else {
+    execFileSync("tar", ["-xzf", archivePath, "-C", destDir], { stdio: "inherit" });
+  }
+}
+
+async function main() {
+  if (process.env.CRATESTACK_CLI_SKIP_DOWNLOAD) {
+    console.log("CRATESTACK_CLI_SKIP_DOWNLOAD set; skipping binary download.");
+    return;
+  }
+
+  const target = resolveTarget();
+  const version = pkg.version;
+  const ext = process.platform === "win32" ? "zip" : "tar.gz";
+  const assetName = `cratestack-cli-${target}-v${version}.${ext}`;
+  const assetUrl = `${REPO}/releases/download/v${version}/${assetName}`;
+
+  console.log(`Downloading ${assetName} ...`);
+  const [archiveBuf, checksumBuf] = await Promise.all([
+    fetchBuffer(assetUrl),
+    fetchBuffer(`${assetUrl}.sha256`),
+  ]);
+  verifyChecksum(assetName, archiveBuf, checksumBuf);
+
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "cratestack-cli-"));
+  const archivePath = path.join(tmpDir, assetName);
+  fs.writeFileSync(archivePath, archiveBuf);
+
+  extract(archivePath, ext, tmpDir);
+
+  const binName = process.platform === "win32" ? "cratestack.exe" : "cratestack";
+  const extracted = path.join(tmpDir, binName);
+  if (!fs.existsSync(extracted)) {
+    throw new Error(`expected ${binName} inside ${assetName}, but it was not found`);
+  }
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+  const installed = path.join(BIN_DIR, binName);
+  fs.copyFileSync(extracted, installed);
+  if (process.platform !== "win32") {
+    fs.chmodSync(installed, 0o755);
+  }
+  fs.rmSync(tmpDir, { recursive: true, force: true });
+
+  console.log(`cratestack-cli ${version} (${target}) installed to ${installed}`);
+}
+
+main().catch((err) => {
+  console.error(`@cratestack/cli install failed: ${err.message}`);
+  console.error(
+    "Fall back to: cargo binstall cratestack-cli   or   cargo install cratestack-cli",
+  );
+  process.exit(1);
+});