@agora-build/audictl 0.1.0

package/README.md

@@ -0,0 +1,20 @@
+# @agora-build/audictl
+
+Manage macOS audio devices from the command line — a scriptable, agent-friendly
+replacement for the audio-device half of Audio MIDI Setup.
+
+```sh
+npm install -g @agora-build/audictl
+audictl list
+```
+
+The postinstall step downloads the prebuilt binary for your platform from
+[GitHub Releases](https://github.com/Agora-Build/audictl/releases). macOS only.
+
+Alternative install without npm:
+
+```sh
+curl -fsSL https://dl.agora.build/audictl/install.sh | bash
+```
+
+Full documentation: https://github.com/Agora-Build/audictl

package/bin/audictl

@@ -0,0 +1,3 @@
+#!/bin/sh
+echo "audictl binary not found. Run 'npm rebuild @agora-build/audictl' to install." >&2
+exit 1

package/install.js

@@ -0,0 +1,93 @@
+#!/usr/bin/env node
+"use strict";
+
+const https = require("https");
+const http = require("http");
+const fs = require("fs");
+const path = require("path");
+const { execSync } = require("child_process");
+const os = require("os");
+
+const pkg = require("./package.json");
+const VERSION = `v${pkg.version}`;
+const REPO = "Agora-Build/audictl";
+const BIN_DIR = path.join(__dirname, "bin");
+const BIN_PATH = path.join(BIN_DIR, "audictl");
+
+function getPlatformKey() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const map = {
+    "darwin-x64": "darwin-x86_64",
+    "darwin-arm64": "darwin-aarch64",
+  };
+
+  const key = `${platform}-${arch}`;
+  if (!map[key]) {
+    console.error(`Unsupported platform: ${key}`);
+    console.error("audictl drives CoreAudio and only runs on macOS (darwin-x64, darwin-arm64).");
+    process.exit(1);
+  }
+  return map[key];
+}
+
+function getDownloadUrl() {
+  const platformKey = getPlatformKey();
+  return `https://github.com/${REPO}/releases/download/${VERSION}/audictl-${VERSION}-${platformKey}.tar.gz`;
+}
+
+function fetch(url, redirects = 0) {
+  if (redirects > 5) {
+    return Promise.reject(new Error("Too many redirects"));
+  }
+  return new Promise((resolve, reject) => {
+    const client = url.startsWith("https") ? https : http;
+    client
+      .get(url, { headers: { "User-Agent": "audictl-npm-installer" } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          return resolve(fetch(res.headers.location, redirects + 1));
+        }
+        if (res.statusCode !== 200) {
+          return reject(new Error(`Download failed: HTTP ${res.statusCode} for ${url}`));
+        }
+        const chunks = [];
+        res.on("data", (chunk) => chunks.push(chunk));
+        res.on("end", () => resolve(Buffer.concat(chunks)));
+        res.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+async function install() {
+  const url = getDownloadUrl();
+  console.log(`Downloading audictl ${VERSION} for ${getPlatformKey()}...`);
+  console.log(`  ${url}`);
+
+  const tarball = await fetch(url);
+
+  // Write tarball to temp file and extract
+  const tmpFile = path.join(os.tmpdir(), `audictl-${Date.now()}.tar.gz`);
+  fs.writeFileSync(tmpFile, tarball);
+
+  fs.mkdirSync(BIN_DIR, { recursive: true });
+
+  try {
+    execSync(`tar -xzf "${tmpFile}" -C "${BIN_DIR}"`, { stdio: "pipe" });
+  } finally {
+    fs.unlinkSync(tmpFile);
+  }
+
+  // Ensure the binary is executable
+  fs.chmodSync(BIN_PATH, 0o755);
+  console.log(`Installed audictl ${VERSION} to ${BIN_PATH}`);
+}
+
+install().catch((err) => {
+  console.error(`Failed to install audictl: ${err.message}`);
+  console.error("");
+  console.error("You can manually download the binary from:");
+  console.error(`  https://github.com/${REPO}/releases/tag/${VERSION}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@agora-build/audictl",
+  "version": "0.1.0",
+  "description": "Manage macOS audio devices from the command line — a scriptable, agent-friendly replacement for Audio MIDI Setup.",
+  "bin": {
+    "audictl": "bin/audictl"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Agora-Build/audictl.git"
+  },
+  "keywords": [
+    "macos",
+    "audio",
+    "coreaudio",
+    "aggregate-device",
+    "sample-rate",
+    "cli",
+    "ai",
+    "agent"
+  ],
+  "author": "Agora Build <build@agora.io>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Agora-Build/audictl/issues"
+  },
+  "homepage": "https://github.com/Agora-Build/audictl#readme",
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}