@ciphore/radiocli 0.2.3 → 0.2.5

package/dist/ui/use-command-executor.js

@@ -1,6 +1,7 @@
 import { useCallback } from 'react';
 import { favoriteTarget, normalizeMediaKeyBindings, parseMediaActionName } from './app-state.js';
-export function useCommandExecutor({ beginLearningTransportKey, countries, go, loadCountry, openAirPlaySettings, openLibrary, player, playingStation, providers, resetLearnedTransportKeys, runSearch, screen, selectedStation, setCountries, setFilters, setLibrary, setMessage, setSearchQuery, setSleepUntil, setVolume, settingsRef, store, toggleFavorite, toggleMute, updateCommand, updateSettings }) {
+import { importStreamUrl } from '../streams/import-stream.js';
+export function useCommandExecutor({ beginLearningTransportKey, cancelPendingTune, countries, go, loadCountry, openAirPlaySettings, openAirPlayCode, openLibrary, persistLibrary, player, playingStation, providers, resetLearnedTransportKeys, runSearch, screen, screenRef, selectedStation, setCountries, setFilters, setLibrary, setMessage, setSearchQuery, setSleepUntil, setVolume, settingsRef, store, toggleFavorite, toggleMute, updateCommand, updateSettings }) {
     return useCallback(async (rawCommand) => {
         const trimmed = rawCommand.trim();
         if (!trimmed) {
@@ -19,16 +20,18 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
                 setMessage('Usage: :country <name or code>');
                 return;
             }
+            const origin = screenRef.current;
             const availableCountries = countries.length > 0 ? countries : await providers.countries();
             if (countries.length === 0) {
                 setCountries(availableCountries);
             }
             const match = availableCountries.find(country => `${country.code} ${country.name}`.toLowerCase().includes(value.toLowerCase()));
             if (!match) {
-                setMessage(`Country not found: ${value}`);
+                if (screenRef.current === origin)
+                    setMessage(`Country not found: ${value}`);
                 return;
             }
-            await loadCountry(match);
+            await loadCountry(match, screenRef.current === origin);
             return;
         }
         if (name === 'codec') {
@@ -62,20 +65,20 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         }
         if (name === 'location') {
             const enabled = value === 'on' || value === 'true' || value === '1';
-            updateSettings({ enableNearbyLocation: enabled });
+            await updateSettings({ enableNearbyLocation: enabled });
             setMessage(`Nearby location lookup ${enabled ? 'enabled' : 'disabled'}.`);
             return;
         }
         if (name === 'timeout') {
             const seconds = Number(value);
             if (Number.isFinite(seconds)) {
-                updateSettings({ tuneTimeoutSeconds: Math.min(45, Math.max(3, seconds)) });
+                await updateSettings({ tuneTimeoutSeconds: Math.min(45, Math.max(3, seconds)) });
             }
             return;
         }
         if (name === 'skip') {
             const enabled = value !== 'off' && value !== 'false' && value !== '0';
-            updateSettings({ skipBrokenStreams: enabled });
+            await updateSettings({ skipBrokenStreams: enabled });
             return;
         }
         if (name === 'learn' || name === 'bind' || name === 'key') {
@@ -98,10 +101,10 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         }
         if (name === 'airplay-code' || name === 'airplay-passcode') {
             if (!value.trim()) {
-                go('airplay-code');
+                openAirPlayCode();
                 return;
             }
-            const result = player.submitAirPlayPasscode(value.trim());
+            const result = await player.submitAirPlayPasscode(value.trim());
             if (result.message) {
                 setMessage(result.message);
             }
@@ -138,7 +141,7 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
         }
         if (name === 'export' || name === 'backup') {
             try {
-                const backupPath = store.exportBackup(value || undefined);
+                const backupPath = await store.exportBackup(value || undefined);
                 setMessage(`Backup exported: ${backupPath}`);
             }
             catch (error) {
@@ -146,21 +149,43 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
             }
             return;
         }
-        if (name === 'import' || name === 'restore') {
+        if (name === 'import') {
             if (!value.trim()) {
-                setMessage('Usage: :import <backup.json>');
+                setMessage('Usage: :import <stream-url> [station name]');
                 return;
             }
             try {
-                const result = store.importBackup(value);
+                const [url = '', ...nameParts] = rest;
+                setMessage('Reading stream metadata...');
+                const result = await importStreamUrl(url, nameParts.join(' ') || undefined);
+                const nextLibrary = await persistLibrary(() => store.addImported([result.station]));
+                if (!nextLibrary)
+                    return;
+                openLibrary();
+                setMessage(result.warning
+                    ? `Imported ${result.station.name}. ${result.warning}`
+                    : `Imported ${result.station.name}${result.station.codec ? ` · ${result.station.codec}` : ''}${result.station.bitrate ? ` · ${result.station.bitrate} kbps` : ''}.`);
+            }
+            catch (error) {
+                setMessage(error instanceof Error ? error.message : 'Could not import the radio stream.');
+            }
+            return;
+        }
+        if (name === 'restore') {
+            if (!value.trim()) {
+                setMessage('Usage: :restore <backup.json>');
+                return;
+            }
+            try {
+                const result = await store.importBackup(value);
                 settingsRef.current = result.state.settings;
                 setLibrary(result.state);
                 setMessage(result.safetyBackupPath
-                    ? `Backup imported. Previous library saved to ${result.safetyBackupPath}`
-                    : `Backup imported: ${result.sourcePath}`);
+                    ? `Backup restored. Previous library saved to ${result.safetyBackupPath}`
+                    : `Backup restored: ${result.sourcePath}`);
             }
             catch (error) {
-                setMessage(error instanceof Error ? error.message : 'Could not import the RadioCLI backup.');
+                setMessage(error instanceof Error ? error.message : 'Could not restore the RadioCLI backup.');
             }
             return;
         }
@@ -169,7 +194,8 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
             return;
         }
         if (name === 'stop') {
-            setLibrary(store.finishActiveListeningSession());
+            cancelPendingTune();
+            persistLibrary(() => store.finishActiveListeningSession());
             await player.stop();
             return;
         }
@@ -190,25 +216,30 @@ export function useCommandExecutor({ beginLearningTransportKey, countries, go, l
                     : name === 'motion'
                         ? 'reduceMotion'
                         : 'transparentBackground';
-            const enabled = value === '' ? !settingsRef.current[key] : value === 'on' || value === 'true' || value === '1';
-            updateSettings({ [key]: enabled });
-            setMessage(`${name} ${enabled ? 'on' : 'off'}.`);
+            const saved = await updateSettings(value === ''
+                ? current => ({ [key]: !current[key] })
+                : { [key]: value === 'on' || value === 'true' || value === '1' });
+            setMessage(`${name} ${saved.settings[key] ? 'on' : 'off'}.`);
             return;
         }
         setMessage(`Unknown command: ${name}`);
     }, [
         beginLearningTransportKey,
+        cancelPendingTune,
         countries,
         go,
         loadCountry,
         openAirPlaySettings,
+        openAirPlayCode,
         openLibrary,
+        persistLibrary,
         player,
         playingStation,
         providers,
         resetLearnedTransportKeys,
         runSearch,
         screen,
+        screenRef,
         selectedStation,
         setCountries,
         setFilters,

package/dist/ui/visualizers/gallop.js

@@ -11,7 +11,7 @@ export function buildGallop(pulse, width, height, theme) {
     const frame = frames[frameIndex];
     const usableW = w > 8 ? w - 4 : w;
     const usableH = h > 4 ? h - 2 : h;
-    const scale = Math.min(usableW * 2 / horseStrideWidth, usableH * 4 / horseStrideHeight);
+    const scale = Math.min(usableW * 2 / horseStrideWidth, usableH * 4 / horseStrideHeight) * 0.9;
     const dotsW = Math.max(1, Math.floor(horseStrideWidth * scale));
     const dotsH = Math.max(1, Math.floor(horseStrideHeight * scale));
     const left = Math.floor((w - Math.ceil(dotsW / 2)) / 2) * 2;

package/dist/ui/visualizers/receiver-style-registry.js

@@ -65,9 +65,10 @@ export const receiverStyleRegistry = [
     { id: 'crossfade', maxRows: 14, minRows: 7 },
 ];
 export const receiverStyleNames = receiverStyleRegistry.map(style => style.id);
-export const defaultReceiverStyle = 'gallop-fine';
+export const defaultReceiverStyle = 'ultracode';
 export const receiverStyleMetadata = Object.fromEntries(receiverStyleRegistry.map(style => [style.id, style]));
 const retiredReceiverStyleNames = [
+    'synthwave-sun', 'neon-alley', 'safari-dusk', 'hot-air-balloons', 'deep-sea-whale', 'meteor-shower', 'volcano', 'desert-highway', 'firefly-grove', 'cherry-blossom', 'event-horizon', 'lighthouse',
     'duplex-wave', 'color-drift', 'undertow', 'cube-tide', 'parallax-slabs', 'voxel-swell',
     'dot-current', 'flip-matrix', 'raster-harp',
     'spin-lattice', 'packet-storm', 'spark-chamber',

package/dist/update-check.js

@@ -1,15 +1,16 @@
 import { realpathSync } from 'node:fs';
 import { spawn } from 'node:child_process';
 import { appVersion } from './version.js';
+import { networkPolicy, withExternalResponse } from './platform/network.js';
 const UPDATE_CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
 const UPDATE_PACKAGE_NAME = '@ciphore/radiocli';
 export async function checkForUpdate({ currentVersion = appVersion(), fetchImpl = fetch, now = new Date(), packageName = UPDATE_PACKAGE_NAME, timeoutMs = 3000 } = {}) {
     try {
-        const response = await fetchWithTimeout(registryLatestUrl(packageName), fetchImpl, timeoutMs);
-        if (!response.ok) {
-            throw new Error(`npm registry returned ${response.status}`);
-        }
-        const parsed = await response.json();
+        const parsed = await withExternalResponse(registryLatestUrl(packageName), { fetchImpl, timeoutMs }, async (response) => {
+            if (!response.ok)
+                throw new Error(`npm registry returned ${response.status}`);
+            return await response.json();
+        });
         const latestVersion = typeof parsed.version === 'string' ? parsed.version : undefined;
         if (!latestVersion) {
             throw new Error('npm registry response did not include a version');
@@ -31,7 +32,7 @@ export async function checkForUpdate({ currentVersion = appVersion(), fetchImpl
     }
 }
 export function shouldCheckForUpdate(updateCheck, now = Date.now()) {
-    if (process.env.RADIOCLI_DISABLE_UPDATE_CHECK === '1' || process.env.CI === 'true') {
+    if (!automaticUpdateChecksAllowed()) {
         return false;
     }
     if (!updateCheck?.checkedAt) {
@@ -41,7 +42,7 @@ export function shouldCheckForUpdate(updateCheck, now = Date.now()) {
     return !Number.isFinite(checkedAt) || now - checkedAt >= UPDATE_CHECK_INTERVAL_MS;
 }
 export function automaticUpdateChecksAllowed(enabled = true) {
-    return enabled && process.env.RADIOCLI_DISABLE_UPDATE_CHECK !== '1' && process.env.CI !== 'true';
+    return enabled && !networkPolicy().offline && process.env.RADIOCLI_DISABLE_UPDATE_CHECK !== '1' && process.env.CI !== 'true';
 }
 export function updateAvailableForVersion(updateCheck, currentVersion = updateCheck?.currentVersion) {
     return Boolean(updateCheck?.updateAvailable &&
@@ -95,9 +96,10 @@ export function installUpdate(command = updateCommandForInstall().command) {
     });
 }
 export function updateShellForPlatform(platform, command) {
+    // Login profiles can replace PATH and select a different package-manager installation.
     return platform === 'win32'
         ? { command: 'cmd.exe', args: ['/d', '/s', '/c', command] }
-        : { command: 'sh', args: ['-lc', command] };
+        : { command: 'sh', args: ['-c', command] };
 }
 export function compareSemver(left, right) {
     const leftParts = semverParts(left);
@@ -113,16 +115,6 @@ export function compareSemver(left, right) {
 function registryLatestUrl(packageName) {
     return `https://registry.npmjs.org/${encodeURIComponent(packageName)}/latest`;
 }
-async function fetchWithTimeout(url, fetchImpl, timeoutMs) {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    try {
-        return await fetchImpl(url, { signal: controller.signal });
-    }
-    finally {
-        clearTimeout(timer);
-    }
-}
 function semverParts(version) {
     const normalized = version.trim().replace(/^v/i, '').split(/[+-]/)[0] ?? '';
     const [major = '0', minor = '0', patch = '0'] = normalized.split('.');

package/docs/THIRD_PARTY_NOTICES.md

@@ -34,7 +34,9 @@ Earth vector data is public domain.
 
 ## node-airtunes2
 
-AirPlay support is provided as an optional integration with `node-airtunes2`
-2.5.0, distributed under the GNU Affero General Public License v3. Its source,
-license text, and attribution are available in the installed dependency and at
-<https://github.com/bertrandda/node-airtunes2>.
+AirPlay support uses a source copy of `node-airtunes2` 2.5.0, distributed under
+the GNU Affero General Public License v3, with RadioCLI's native Ed25519 security
+fix. The original attribution, license, complete native source, changes and
+archive provenance ship in `vendor/node-airtunes2/`. Runtime dependencies remain
+optional. See `vendor/node-airtunes2/RADIOCLI_PATCH.md` and the original project
+at <https://github.com/bertrandda/node-airtunes2>.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciphore/radiocli",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "A terminal-first world radio receiver built with Ink, mpv, and resilient public-radio providers.",
   "type": "module",
   "license": "MIT",
@@ -33,7 +33,16 @@
     "SECURITY.md",
     "CONTRIBUTING.md",
     "CODE_OF_CONDUCT.md",
-    "docs"
+    "docs",
+    "scripts/build-airplay-native.mjs",
+    "vendor/node-airtunes2/lib",
+    "vendor/node-airtunes2/src",
+    "vendor/node-airtunes2/package.json",
+    "vendor/node-airtunes2/binding.gyp",
+    "vendor/node-airtunes2/LICENSE",
+    "vendor/node-airtunes2/README.md",
+    "vendor/node-airtunes2/RADIOCLI_PATCH.md",
+    "vendor/node-airtunes2/UPSTREAM.json"
   ],
   "bin": {
     "radiocli": "dist/cli.js"
@@ -47,7 +56,7 @@
     "check:whitespace": "node scripts/whitespace-check.mjs",
     "check:exports": "knip",
     "check:package": "publint",
-    "audit:runtime": "node scripts/audit-ci.mjs --omit=dev --omit=optional --audit-level=high",
+    "audit:runtime": "node scripts/audit-ci.mjs --omit=dev --include=optional --audit-level=low",
     "audit:docs": "node scripts/audit-ci.mjs --prefix=apps/docs --omit=dev --audit-level=high",
     "lint": "npm run check:unused && npm run check:whitespace && npm run check:exports",
     "docs:dev": "npm --prefix apps/docs run dev",
@@ -56,27 +65,29 @@
     "start": "node dist/cli.js",
     "test": "vitest run",
     "verify": "npm run check && npm run lint && npm run test && npm run build && npm run smoke:data",
-    "verify:release": "npm run verify && npm run smoke:playback && npm run pack:check && npm run fresh:check && npm run check:package",
+    "verify:release": "node scripts/verify-release.mjs",
     "prepack": "npm run build",
-    "prepublishOnly": "npm run check && npm run lint && npm run test && npm run smoke:data && npm run fresh:check && npm run check:package",
+    "prepublishOnly": "npm run verify:release",
     "pack:check": "npm pack --dry-run",
     "smoke:data": "tsx src/smoke/data-smoke.ts",
     "smoke:mcp": "node scripts/mcp-smoke.mjs",
     "smoke:playback": "tsx src/smoke/playback-smoke.ts",
+    "smoke:network": "tsx src/smoke/network-playback-smoke.ts",
+    "smoke:cli": "tsx src/smoke/cli-smoke.ts",
     "demo:script": "node scripts/demo-script.mjs",
     "demo:assets": "node scripts/capture-demo-assets.mjs",
-    "fresh:check": "node scripts/fresh-check.mjs"
+    "fresh:check": "node scripts/fresh-check.mjs",
+    "postinstall": "node scripts/build-airplay-native.mjs"
   },
   "dependencies": {
+    "@homebridge/dbus-native": "^0.7.9",
     "@modelcontextprotocol/server": "^2.0.0",
     "ink": "^7.0.5",
     "jsonc-parser": "^3.3.1",
     "react": "^19.2.6",
+    "string-width": "8.2.1",
     "zod": "^4.4.3"
   },
-  "overrides": {
-    "protobufjs": "^7.5.8"
-  },
   "devDependencies": {
     "@types/node": "^22.15.0",
     "@types/react": "^19.2.15",
@@ -85,12 +96,24 @@
     "publint": "^0.3.21",
     "tsx": "^4.22.3",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.11"
   },
   "engines": {
     "node": ">=22"
   },
   "optionalDependencies": {
-    "node-airtunes2": "2.5.0"
+    "@noble/ed25519": "1.7.5",
+    "async": "3.2.6",
+    "axlsign": "git+https://github.com/ciderapp/curve25519-js.git#cae68782564b83ffa1c7c757e40a3944cb140290",
+    "big-integer": "1.6.52",
+    "bplist-creator": "0.1.1",
+    "bplist-parser": "0.3.2",
+    "chacha-js": "git+https://github.com/ciderapp/chacha20poly1305.git#f85941b8f5c62843a1459758cc3dbabad9f849cb",
+    "curve25519-js": "0.0.4",
+    "fast-srp-hap": "2.0.4",
+    "js-sha1": "0.7.0",
+    "lodash": "4.18.1",
+    "python-struct": "1.1.3",
+    "node-gyp": "12.3.0"
   }
 }

package/scripts/build-airplay-native.mjs

@@ -0,0 +1,22 @@
+import {spawnSync} from 'node:child_process';
+import {createRequire} from 'node:module';
+import {fileURLToPath} from 'node:url';
+
+const require = createRequire(import.meta.url);
+
+/** Optional Linux optimization. The sender retains its upstream JS fallback. */
+export function buildAirPlayNative({platform = process.platform, env = process.env, resolve = name => require.resolve(name), execute = spawnSync} = {}) {
+  const omitted = Object.entries(env).find(([name]) => name.toLowerCase() === 'npm_config_omit')?.[1] ?? '';
+  if (platform !== 'linux' || omitted.split(/[\s,]+/).includes('optional')) return 'skipped';
+  let entry;
+  try { entry = resolve('node-gyp/bin/node-gyp.js'); } catch { return 'unavailable'; }
+  try {
+    const result = execute(process.execPath, [entry, 'rebuild'], {
+      cwd: fileURLToPath(new URL('../vendor/node-airtunes2/', import.meta.url)), env,
+      shell: false, windowsHide: true, timeout: 120_000, stdio: 'ignore'
+    });
+    return result.status === 0 && !result.error ? 'built' : 'fallback';
+  } catch { return 'fallback'; }
+}
+
+if (process.argv[1] === fileURLToPath(import.meta.url)) buildAirPlayNative();