@victorysightsound/dial-cli 4.2.5

package/README.md

@@ -0,0 +1,29 @@
+# @victorysightsound/dial-cli
+
+Install the DIAL CLI from npm:
+
+```bash
+npm install -g @victorysightsound/dial-cli
+```
+
+This package downloads the matching prebuilt DIAL binary from the GitHub release for the current package version and exposes `dial` as the global command.
+
+Supported targets:
+- macOS Apple Silicon
+- macOS Intel
+- Linux x86_64
+- Linux ARM64
+- Windows x86_64
+
+Requirements:
+- Node.js 18 or newer
+- internet access during install so the matching GitHub release asset can be downloaded
+
+Verify the install:
+
+```bash
+dial --version
+```
+
+If you need the full onboarding guide, see the main project docs:
+- https://github.com/victorysightsound/dial/blob/main/docs/getting-started.md

package/bin/dial.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+
+import { installedBinaryPath, packageRootFrom } from "../lib/package-paths.mjs";
+import { resolveAssetSpec } from "../lib/platform.mjs";
+
+let asset;
+try {
+  asset = resolveAssetSpec();
+} catch (error) {
+  console.error(`dial-cli: ${error.message}`);
+  process.exit(1);
+}
+
+const packageRoot = packageRootFrom(import.meta.url);
+const binaryPath = installedBinaryPath(packageRoot, asset.binaryName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(
+    `dial-cli: missing platform binary at ${binaryPath}. Reinstall with 'npm install -g @victorysightsound/dial-cli'.`,
+  );
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+});
+
+child.on("error", (error) => {
+  console.error(`dial-cli: failed to start '${binaryPath}': ${error.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 1);
+});

package/lib/package-paths.mjs

@@ -0,0 +1,34 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+export function packageRootFrom(importMetaUrl) {
+  return path.resolve(path.dirname(fileURLToPath(importMetaUrl)), "..");
+}
+
+export function vendorDirectory(packageRoot) {
+  return path.join(packageRoot, "vendor");
+}
+
+export function installedBinaryPath(packageRoot, binaryName) {
+  return path.join(vendorDirectory(packageRoot), binaryName);
+}
+
+export async function readPackageVersion(packageRoot) {
+  const packageJsonPath = path.join(packageRoot, "package.json");
+  const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+  return String(packageJson.version);
+}
+
+export function buildDownloadUrl(version, assetName, env = process.env) {
+  if (env.DIAL_NPM_BINARY_URL) {
+    return env.DIAL_NPM_BINARY_URL;
+  }
+
+  const normalizedVersion = String(version).replace(/^v/, "");
+  const baseUrl =
+    env.DIAL_NPM_BASE_URL ??
+    `https://github.com/victorysightsound/dial/releases/download/v${normalizedVersion}`;
+
+  return `${baseUrl.replace(/\/$/, "")}/${assetName}`;
+}

package/lib/platform.mjs

@@ -0,0 +1,64 @@
+const TARGETS = new Map([
+  [
+    "darwin:arm64",
+    {
+      target: "aarch64-apple-darwin",
+      archive: "tar.gz",
+      binaryName: "dial",
+    },
+  ],
+  [
+    "darwin:x64",
+    {
+      target: "x86_64-apple-darwin",
+      archive: "tar.gz",
+      binaryName: "dial",
+    },
+  ],
+  [
+    "linux:arm64",
+    {
+      target: "aarch64-unknown-linux-gnu",
+      archive: "tar.gz",
+      binaryName: "dial",
+    },
+  ],
+  [
+    "linux:x64",
+    {
+      target: "x86_64-unknown-linux-gnu",
+      archive: "tar.gz",
+      binaryName: "dial",
+    },
+  ],
+  [
+    "win32:x64",
+    {
+      target: "x86_64-pc-windows-msvc",
+      archive: "zip",
+      binaryName: "dial.exe",
+    },
+  ],
+]);
+
+export function supportedTargetKeys() {
+  return [...TARGETS.keys()].sort();
+}
+
+export function resolveAssetSpec(
+  platform = process.platform,
+  arch = process.arch,
+) {
+  const key = `${platform}:${arch}`;
+  const spec = TARGETS.get(key);
+  if (!spec) {
+    throw new Error(
+      `Unsupported platform '${platform}' on '${arch}'. Supported targets: ${supportedTargetKeys().join(", ")}`,
+    );
+  }
+
+  return {
+    ...spec,
+    assetName: `dial-${spec.target}.${spec.archive}`,
+  };
+}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@victorysightsound/dial-cli",
+  "version": "4.2.5",
+  "description": "Install the DIAL CLI as a global command via npm",
+  "keywords": [
+    "dial",
+    "cli",
+    "ai",
+    "automation",
+    "development"
+  ],
+  "license": "MIT OR Apache-2.0",
+  "homepage": "https://github.com/victorysightsound/dial#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/victorysightsound/dial.git"
+  },
+  "bugs": {
+    "url": "https://github.com/victorysightsound/dial/issues"
+  },
+  "type": "module",
+  "bin": {
+    "dial": "bin/dial.js"
+  },
+  "files": [
+    "README.md",
+    "bin/",
+    "lib/",
+    "scripts/"
+  ],
+  "scripts": {
+    "postinstall": "node ./scripts/postinstall.js",
+    "test": "node --test ./test/*.test.mjs"
+  },
+  "dependencies": {
+    "extract-zip": "^2.0.1",
+    "tar": "^7.4.3"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/postinstall.js

@@ -0,0 +1,95 @@
+#!/usr/bin/env node
+
+import fs from "node:fs/promises";
+import { createWriteStream } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+
+import extractZip from "extract-zip";
+import * as tar from "tar";
+
+import { buildDownloadUrl, installedBinaryPath, packageRootFrom, readPackageVersion, vendorDirectory } from "../lib/package-paths.mjs";
+import { resolveAssetSpec } from "../lib/platform.mjs";
+
+async function downloadFile(url, destinationPath) {
+  const response = await fetch(url, {
+    headers: {
+      "user-agent": "dial-cli-npm-installer",
+    },
+  });
+
+  if (!response.ok || !response.body) {
+    const detail =
+      response.status === 404
+        ? "matching GitHub release asset was not found"
+        : `download failed with HTTP ${response.status}`;
+    throw new Error(`Unable to download ${url}: ${detail}`);
+  }
+
+  await pipeline(
+    Readable.fromWeb(response.body),
+    createWriteStream(destinationPath),
+  );
+}
+
+async function extractArchive(archivePath, archiveType, destinationDir) {
+  if (archiveType === "tar.gz") {
+    await tar.x({
+      cwd: destinationDir,
+      file: archivePath,
+      strict: true,
+    });
+    return;
+  }
+
+  if (archiveType === "zip") {
+    await extractZip(archivePath, { dir: destinationDir });
+    return;
+  }
+
+  throw new Error(`Unsupported archive type '${archiveType}'`);
+}
+
+async function main() {
+  if (process.env.DIAL_NPM_SKIP_DOWNLOAD === "1") {
+    console.log("dial-cli: skipping binary download because DIAL_NPM_SKIP_DOWNLOAD=1");
+    return;
+  }
+
+  const packageRoot = packageRootFrom(import.meta.url);
+  const version = await readPackageVersion(packageRoot);
+  const asset = resolveAssetSpec();
+  const downloadUrl = buildDownloadUrl(version, asset.assetName);
+  const targetBinary = installedBinaryPath(packageRoot, asset.binaryName);
+  const targetVendorDir = vendorDirectory(packageRoot);
+  const tempDir = await fs.mkdtemp(path.join(os.tmpdir(), "dial-cli-"));
+  const archivePath = path.join(tempDir, asset.assetName);
+
+  try {
+    console.log(`dial-cli: downloading ${asset.assetName}`);
+    await downloadFile(downloadUrl, archivePath);
+    await extractArchive(archivePath, asset.archive, tempDir);
+    await fs.mkdir(targetVendorDir, { recursive: true });
+
+    const extractedBinary = path.join(tempDir, asset.binaryName);
+    await fs.copyFile(extractedBinary, targetBinary);
+
+    if (process.platform !== "win32") {
+      await fs.chmod(targetBinary, 0o755);
+    }
+
+    console.log(`dial-cli: installed DIAL ${version} for ${asset.target}`);
+  } catch (error) {
+    console.error(`dial-cli: ${error.message}`);
+    console.error(
+      "dial-cli: install failed. Ensure the matching GitHub release exists and try the install again.",
+    );
+    process.exitCode = 1;
+  } finally {
+    await fs.rm(tempDir, { force: true, recursive: true });
+  }
+}
+
+await main();