yarr-mcp 0.4.0

package/README.md

@@ -0,0 +1,34 @@
+# yarr-mcp
+
+Node launcher for the yarr MCP and CLI binary.
+
+```bash
+npx -y yarr-mcp mcp
+```
+
+Install globally when you want the command on `PATH`:
+
+```bash
+npm i -g yarr-mcp
+yarr --version
+yarr mcp
+```
+
+The package downloads the matching GitHub Release binary during `postinstall`.
+The npm package version and the yarr release tag are expected to match.
+Release automation publishes this package from the repository `v*` tag workflow;
+the GitHub repository must have an `NPM_TOKEN` secret with publish access.
+
+The package name is `yarr-mcp` because the shorter `yarr` npm name is already
+occupied by an unrelated package. The installed command is still `yarr`.
+
+## Overrides
+
+```bash
+YARR_BINARY_VERSION=v0.4.0 npm i -g yarr-mcp
+YARR_RELEASE_BASE_URL=https://github.com/jmagar/yarr-mcp/releases/download npm i -g yarr-mcp
+YARR_SKIP_DOWNLOAD=1 npm i -g yarr-mcp
+```
+
+Supported binary targets are Linux x64 and Windows x64, matching the current
+GitHub Release assets.

package/bin/yarr.js

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+const { binaryPath } = require("../lib/platform");
+
+function fail(message) {
+  process.stderr.write(`yarr: ${message}\n`);
+  process.exit(1);
+}
+
+const binary = binaryPath();
+
+if (!fs.existsSync(binary)) {
+  const installer = path.resolve(__dirname, "..", "scripts", "install.js");
+  const install = spawnSync(process.execPath, [installer], { stdio: "inherit" });
+  if (install.status !== 0) {
+    fail("binary is not installed; postinstall may have failed");
+  }
+}
+
+const child = spawnSync(binary, process.argv.slice(2), { stdio: "inherit" });
+
+if (child.error) {
+  fail(child.error.message);
+}
+
+if (child.signal) {
+  process.kill(process.pid, child.signal);
+} else {
+  process.exit(child.status ?? 1);
+}

package/lib/platform.js

@@ -0,0 +1,56 @@
+"use strict";
+
+const path = require("node:path");
+
+function packageVersion() {
+  return require("../package.json").version;
+}
+
+function targetFor(platform = process.platform, arch = process.arch) {
+  if (platform === "linux" && arch === "x64") {
+    return {
+      asset: "yarr-x86_64.tar.gz",
+      binary: "yarr",
+    };
+  }
+
+  if (platform === "win32" && arch === "x64") {
+    return {
+      asset: "yarr-windows-x86_64.tar.gz",
+      binary: "yarr.exe",
+    };
+  }
+
+  throw new Error(`Unsupported platform ${platform}/${arch}. Supported targets: linux/x64, win32/x64.`);
+}
+
+function releaseVersion(env = process.env) {
+  const raw = env.YARR_BINARY_VERSION || packageVersion();
+  return raw.startsWith("v") ? raw : `v${raw}`;
+}
+
+function releaseBaseUrl(env = process.env) {
+  return env.YARR_RELEASE_BASE_URL || "https://github.com/jmagar/yarr-mcp/releases/download";
+}
+
+function downloadUrl(target, env = process.env) {
+  return `${releaseBaseUrl(env)}/${releaseVersion(env)}/${target.asset}`;
+}
+
+function installRoot() {
+  return path.resolve(__dirname, "..", "vendor");
+}
+
+function binaryPath(platform = process.platform, arch = process.arch) {
+  const target = targetFor(platform, arch);
+  return path.join(installRoot(), target.binary);
+}
+
+module.exports = {
+  binaryPath,
+  downloadUrl,
+  installRoot,
+  packageVersion,
+  releaseVersion,
+  targetFor,
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "yarr-mcp",
+  "version": "0.4.0",
+  "description": "Node launcher for the yarr MCP and CLI binary.",
+  "license": "MIT",
+  "homepage": "https://github.com/jmagar/yarr-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jmagar/yarr-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jmagar/yarr-mcp/issues"
+  },
+  "bin": {
+    "yarr-mcp": "bin/yarr.js",
+    "yarr": "bin/yarr.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "scripts/",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/install.js",
+    "test": "node --test",
+    "check": "node --check bin/yarr.js && node --check scripts/install.js && node --check lib/platform.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "yarr",
+    "sonarr",
+    "radarr",
+    "plex",
+    "jellyfin"
+  ]
+}

package/scripts/install.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+"use strict";
+
+const fs = require("node:fs");
+const https = require("node:https");
+const os = require("node:os");
+const path = require("node:path");
+const { spawnSync } = require("node:child_process");
+const {
+  binaryPath,
+  downloadUrl,
+  installRoot,
+  releaseVersion,
+  targetFor,
+} = require("../lib/platform");
+
+function log(message) {
+  process.stderr.write(`yarr: ${message}\n`);
+}
+
+function download(url, destination) {
+  return new Promise((resolve, reject) => {
+    const request = https.get(url, (response) => {
+      if ([301, 302, 303, 307, 308].includes(response.statusCode)) {
+        response.resume();
+        download(response.headers.location, destination).then(resolve, reject);
+        return;
+      }
+
+      if (response.statusCode !== 200) {
+        response.resume();
+        reject(new Error(`download failed (${response.statusCode}) from ${url}`));
+        return;
+      }
+
+      const file = fs.createWriteStream(destination, { mode: 0o600 });
+      response.pipe(file);
+      file.on("finish", () => file.close(resolve));
+      file.on("error", reject);
+    });
+
+    request.on("error", reject);
+  });
+}
+
+function extract(archive, destination) {
+  fs.rmSync(destination, { recursive: true, force: true });
+  fs.mkdirSync(destination, { recursive: true });
+
+  const result = spawnSync("tar", ["-xzf", archive, "-C", destination], {
+    encoding: "utf8",
+  });
+
+  if (result.status !== 0) {
+    throw new Error((result.stderr || result.stdout || "tar extraction failed").trim());
+  }
+}
+
+async function main() {
+  if (process.env.YARR_SKIP_DOWNLOAD === "1") {
+    log("skipping binary download because YARR_SKIP_DOWNLOAD=1");
+    return;
+  }
+
+  const target = targetFor();
+  const destination = binaryPath();
+
+  if (fs.existsSync(destination)) {
+    log(`${path.basename(destination)} already installed for ${releaseVersion()}`);
+    return;
+  }
+
+  const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "yarr-mcp-install-"));
+  const archive = path.join(tempDir, target.asset);
+
+  try {
+    const url = downloadUrl(target);
+    log(`downloading ${url}`);
+    await download(url, archive);
+    extract(archive, installRoot());
+    fs.chmodSync(destination, 0o755);
+    log(`installed ${destination}`);
+  } finally {
+    fs.rmSync(tempDir, { recursive: true, force: true });
+  }
+}
+
+main().catch((error) => {
+  log(error.message);
+  process.exitCode = 1;
+});