@mkterswingman/5mghost-yonder 0.0.1

package/scripts/download-ytdlp.mjs

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall script — downloads yt-dlp binary for the current platform.
+ *
+ * Runs automatically on `npm install`. Uses only Node.js built-ins (no deps).
+ *
+ * Env overrides:
+ *   YT_MCP_SKIP_YTDLP=1   — skip download entirely (CI / air-gapped)
+ *   YT_MCP_YTDLP_MIRROR   — custom base URL (default: GitHub releases)
+ */
+
+import { createWriteStream, chmodSync, mkdirSync, existsSync } from "node:fs";
+import { execFileSync } from "node:child_process";
+import { join, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+import { pipeline } from "node:stream/promises";
+
+// ── Constants ────────────────────────────────────────────────────────────────
+
+// Pinned version: upgrade by changing this constant + publishing new npm version.
+// Avoids auto-update breaking compat. postinstall (not optionalDeps) because yt-dlp is a standalone binary.
+const YT_DLP_VERSION = "2026.03.17";
+
+const BASE_URL =
+  process.env.YT_MCP_YTDLP_MIRROR ||
+  `https://github.com/yt-dlp/yt-dlp/releases/download/${YT_DLP_VERSION}`;
+
+/** Map (platform, arch) → binary file name on GitHub Releases. */
+const PLATFORM_MAP = {
+  "darwin-arm64":  "yt-dlp_macos",
+  "darwin-x64":    "yt-dlp_macos",
+  "linux-x64":     "yt-dlp_linux",
+  "linux-arm64":   "yt-dlp_linux_aarch64",
+  "win32-x64":     "yt-dlp.exe",
+};
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(__dirname, "..");
+const binDir = join(pkgRoot, "bin");
+
+function localName() {
+  return process.platform === "win32" ? "yt-dlp.exe" : "yt-dlp";
+}
+
+/**
+ * Follow redirects (GitHub releases → S3) and stream to disk.
+ * Uses global fetch() (Node 18+).
+ */
+async function download(url, dest) {
+  const res = await fetch(url, { redirect: "follow" });
+  if (!res.ok) {
+    throw new Error(`HTTP ${res.status} ${res.statusText} — ${url}`);
+  }
+  const fileStream = createWriteStream(dest);
+  // res.body is a ReadableStream; convert to Node stream for pipeline
+  await pipeline(res.body, fileStream);
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  // Allow skipping for CI or air-gapped environments
+  if (process.env.YT_MCP_SKIP_YTDLP === "1") {
+    console.log("[yt-mcp] YT_MCP_SKIP_YTDLP=1 — skipping yt-dlp download");
+    return;
+  }
+
+  const key = `${process.platform}-${process.arch}`;
+  const remoteName = PLATFORM_MAP[key];
+
+  if (!remoteName) {
+    console.warn(
+      `[yt-mcp] ⚠️  No pre-built yt-dlp binary for ${key}. ` +
+      `Install yt-dlp manually: https://github.com/yt-dlp/yt-dlp#installation`
+    );
+    return;
+  }
+
+  const dest = join(binDir, localName());
+
+  // Already downloaded?
+  if (existsSync(dest)) {
+    console.log(`[yt-mcp] yt-dlp already present at ${dest}`);
+    return;
+  }
+
+  mkdirSync(binDir, { recursive: true });
+
+  const url = `${BASE_URL}/${remoteName}`;
+  // Keep logs minimal — setup.ts controls user-facing output.
+  // These only show during direct `node scripts/download-ytdlp.mjs` or postinstall.
+  const verbose = !process.env.YT_MCP_QUIET;
+
+  if (verbose) console.log(`[yt-mcp] Downloading yt-dlp...`);
+
+  try {
+    await download(url, dest);
+
+    // chmod +x on non-Windows
+    if (process.platform !== "win32") {
+      chmodSync(dest, 0o755);
+    }
+
+    // macOS Gatekeeper: clear quarantine/provenance xattr so Node.js
+    // execFileSync doesn't hang waiting for a UI prompt that never appears.
+    if (process.platform === "darwin") {
+      try {
+        execFileSync("xattr", ["-cr", dest], { stdio: "ignore" });
+      } catch {
+        // xattr may fail in sandboxed environments — non-fatal
+      }
+    }
+
+    // Pre-run to trigger macOS Gatekeeper verification and cache the result.
+    // First execution of an ad-hoc signed binary takes ~15-20s for the network
+    // check. Doing it here (during install) means setup/serve won't wait.
+    try {
+      execFileSync(dest, ["--version"], {
+        stdio: "ignore",
+        timeout: 60_000,
+      });
+      if (verbose) console.log(`[yt-mcp] ✅ yt-dlp ready`);
+    } catch {
+      if (verbose) console.log(`[yt-mcp] ✅ yt-dlp installed`);
+    }
+  } catch (err) {
+    console.error(`[yt-mcp] ⚠️  Failed to download yt-dlp: ${err.message}`);
+    console.error(
+      `[yt-mcp]    Install manually: https://github.com/yt-dlp/yt-dlp#installation`
+    );
+    // Non-fatal — remote tools still work without yt-dlp
+  }
+}
+
+main();