@boringsql/dryrun 0.8.2

package/README.md

@@ -0,0 +1,36 @@
+# dryrun
+
+PostgreSQL schema/query advisor with a built-in MCP server. This npm package is
+a thin launcher — the real binary is written in Go and ships as a
+platform-specific dependency that npm selects automatically.
+
+## Use as an MCP server
+
+No install needed. Add to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "dryrun": {
+      "command": "npx",
+      "args": ["-y", "@boringsql/dryrun", "mcp-serve"]
+    }
+  }
+}
+```
+
+`npx` fetches the package on first run and caches it; subsequent launches are
+local. Pin a version for reproducibility: `"@boringsql/dryrun@0.8.2"`.
+
+## CLI
+
+```sh
+npx @boringsql/dryrun --help
+```
+
+Or install globally: `npm i -g @boringsql/dryrun` then `dryrun --help`.
+
+## Supported platforms
+
+`darwin-arm64`, `linux-x64`, `linux-arm64`. On other platforms, grab a prebuilt
+binary from the [GitHub Releases](https://github.com/boringSQL/dryrun/releases).

package/bin/dryrun.js

@@ -0,0 +1,55 @@
+#!/usr/bin/env node
+"use strict";
+
+// Launcher for the dryrun Go binary. The actual binary ships inside a
+// platform-specific optionalDependency (@boringsql/dryrun-<os>-<cpu>); npm
+// installs only the one matching the host. We resolve it and exec, forwarding
+// argv + stdio verbatim so MCP stdio transport passes straight through.
+
+const { spawnSync } = require("node:child_process");
+
+// node arch/platform -> our published platform packages
+const SUPPORTED = {
+  "darwin arm64": "@boringsql/dryrun-darwin-arm64",
+  "darwin x64": "@boringsql/dryrun-darwin-x64",
+  "linux x64": "@boringsql/dryrun-linux-x64",
+  "linux arm64": "@boringsql/dryrun-linux-arm64",
+  "win32 x64": "@boringsql/dryrun-win32-x64",
+};
+
+function resolveBinary() {
+  const key = `${process.platform} ${process.arch}`;
+  const pkg = SUPPORTED[key];
+  if (!pkg) {
+    fail(
+      `unsupported platform ${key}.\n` +
+        `Supported: ${Object.keys(SUPPORTED).join(", ")}.\n` +
+        `Install a prebuilt binary from https://github.com/boringSQL/dryrun/releases instead.`
+    );
+  }
+  try {
+    const binName = process.platform === "win32" ? "dryrun.exe" : "dryrun";
+    return require.resolve(`${pkg}/bin/${binName}`);
+  } catch (_e) {
+    fail(
+      `the platform package ${pkg} is not installed.\n` +
+        `This usually means npm skipped optional dependencies. Reinstall without\n` +
+        `--no-optional (e.g. \`npm i @boringsql/dryrun\`), or grab a binary from\n` +
+        `https://github.com/boringSQL/dryrun/releases.`
+    );
+  }
+}
+
+function fail(msg) {
+  process.stderr.write(`dryrun: ${msg}\n`);
+  process.exit(1);
+}
+
+const result = spawnSync(resolveBinary(), process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+if (result.error) fail(result.error.message);
+// propagate signal-kills as the conventional 128+signal exit code
+if (result.signal) process.exit(1);
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@boringsql/dryrun",
+  "version": "0.8.2",
+  "description": "dryrun — PostgreSQL schema/query advisor and MCP server. npx launcher.",
+  "bin": {
+    "dryrun": "bin/dryrun.js"
+  },
+  "files": [
+    "bin/dryrun.js"
+  ],
+  "optionalDependencies": {
+    "@boringsql/dryrun-darwin-arm64": "0.8.2",
+    "@boringsql/dryrun-darwin-x64": "0.8.2",
+    "@boringsql/dryrun-linux-x64": "0.8.2",
+    "@boringsql/dryrun-linux-arm64": "0.8.2",
+    "@boringsql/dryrun-win32-x64": "0.8.2"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "license": "BSD-2-Clause",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/boringSQL/dryrun.git"
+  },
+  "homepage": "https://github.com/boringSQL/dryrun#readme",
+  "bugs": {
+    "url": "https://github.com/boringSQL/dryrun/issues"
+  },
+  "keywords": [
+    "postgres",
+    "postgresql",
+    "mcp",
+    "model-context-protocol",
+    "sql",
+    "schema",
+    "dryrun"
+  ]
+}