chessdrive 0.0.0-stage → 0.1.0-staging.1

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# chessdrive
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The ChessDrive API on the command line: Generate, Embed, Search and Engine, one command each, readable output by
+default and the API's own JSON with `--json`.
+
+```bash
+npm i -g chessdrive
+chessdrive login
+chessdrive engine --fen "rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq - 0 1" --depth 18
+```
+
+`npx chessdrive` runs it without installing. The package holds no code of its own beyond a launcher: npm installs
+the one `@chessdrive/<platform>` package that matches your machine (macOS and Linux on x64 and arm64, Windows on
+x64), which holds the binary, so nothing is downloaded at install. Installing with `--omit=optional` leaves it out.
+
+Every command, flag and exit code is in the [CLI docs](https://platform.chessdrive.io/docs/cli).

package/bin/chessdrive.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+// The `chessdrive` command of the npm package (W2-19), esbuild's pattern: the package lists one package per
+// platform as an optional dependency, each holding that platform's binary from `make cli-release`, and npm
+// installs only the one whose `os` and `cpu` match. This runs it. Nothing is downloaded at install or here.
+'use strict';
+
+const { spawnSync } = require('node:child_process');
+const fs = require('node:fs');
+
+const platform = `${process.platform}-${process.arch}`;
+const pkg = `@chessdrive/${platform}`;
+const exe = process.platform === 'win32' ? 'chessdrive.exe' : 'chessdrive';
+
+let bin;
+try {
+	bin = require.resolve(`${pkg}/bin/${exe}`);
+} catch {
+	const builds = Object.keys(require('../package.json').optionalDependencies || {});
+	if (builds.includes(pkg)) {
+		console.error(`chessdrive: ${pkg}, the build for this machine, isn't installed. npm skips it when optional`);
+		console.error('dependencies are left out (--omit=optional, --no-optional): install chessdrive again without that.');
+	} else {
+		console.error(`chessdrive: there is no build for ${platform}; there are ${builds.map((b) => b.slice(b.indexOf('/') + 1)).join(', ')}.`);
+	}
+	process.exit(1);
+}
+
+// npm keeps the binary's executable bit, but a copy made some other way may not have it.
+if (process.platform !== 'win32') {
+	try {
+		fs.accessSync(bin, fs.constants.X_OK);
+	} catch {
+		try {
+			fs.chmodSync(bin, 0o755);
+		} catch {
+			// spawnSync reports it below
+		}
+	}
+}
+
+const run = spawnSync(bin, process.argv.slice(2), { stdio: 'inherit' });
+if (run.error) {
+	console.error(`chessdrive: couldn't run ${bin}: ${run.error.message}`);
+	process.exit(1);
+}
+// A binary stopped by a signal stops this the same way, so a shell sees what it would without npm.
+if (run.signal) process.kill(process.pid, run.signal);
+process.exit(run.status ?? 1);

package/package.json

@@ -1,6 +1,23 @@
 {
   "name": "chessdrive",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-staging.1",
+  "description": "The ChessDrive API on the command line: Generate, Embed, Search and Engine.",
+  "homepage": "https://platform-staging.chessdrive.io/docs/cli",
+  "license": "UNLICENSED",
+  "bin": {
+    "chessdrive": "bin/chessdrive.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "optionalDependencies": {
+    "@chessdrive/darwin-arm64": "0.1.0-staging.1",
+    "@chessdrive/darwin-x64": "0.1.0-staging.1",
+    "@chessdrive/linux-arm64": "0.1.0-staging.1",
+    "@chessdrive/linux-x64": "0.1.0-staging.1",
+    "@chessdrive/win32-x64": "0.1.0-staging.1"
+  }
+}