@ciphore/radiocli 0.1.9 → 0.2.1

package/dist/update-check.js

@@ -0,0 +1,122 @@
+import { realpathSync } from 'node:fs';
+import { spawn } from 'node:child_process';
+import { appVersion } from './version.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 latestVersion = typeof parsed.version === 'string' ? parsed.version : undefined;
+        if (!latestVersion) {
+            throw new Error('npm registry response did not include a version');
+        }
+        return {
+            checkedAt: now.toISOString(),
+            currentVersion,
+            latestVersion,
+            updateAvailable: compareSemver(latestVersion, currentVersion) > 0
+        };
+    }
+    catch (error) {
+        return {
+            checkedAt: now.toISOString(),
+            currentVersion,
+            updateAvailable: false,
+            error: error instanceof Error ? error.message : 'Update check failed'
+        };
+    }
+}
+export function shouldCheckForUpdate(updateCheck, now = Date.now()) {
+    if (process.env.RADIOCLI_DISABLE_UPDATE_CHECK === '1' || process.env.CI === 'true') {
+        return false;
+    }
+    if (!updateCheck?.checkedAt) {
+        return true;
+    }
+    const checkedAt = Date.parse(updateCheck.checkedAt);
+    return !Number.isFinite(checkedAt) || now - checkedAt >= UPDATE_CHECK_INTERVAL_MS;
+}
+export function updateStatusText(updateCheck) {
+    if (!updateCheck) {
+        return 'not checked yet';
+    }
+    if (updateCheck.updateAvailable && updateCheck.latestVersion) {
+        return `v${updateCheck.latestVersion} available`;
+    }
+    if (updateCheck.error) {
+        return `check failed: ${updateCheck.error}`;
+    }
+    return updateCheck.latestVersion ? `current at v${updateCheck.latestVersion}` : 'not checked yet';
+}
+export function updateCommandForInstall(entryPath = process.argv[1]) {
+    const resolved = resolvePath(entryPath);
+    const haystack = [entryPath, resolved].filter(Boolean).join('\n');
+    if (/\/(?:opt\/homebrew|usr\/local)\/(?:Cellar|Homebrew)\//.test(haystack) || /\/\.linuxbrew\/(?:Cellar|Homebrew)\//.test(haystack)) {
+        return { method: 'homebrew', command: 'brew update && brew upgrade radiocli' };
+    }
+    if (/\/node_modules\/@ciphore\/radiocli\//.test(haystack)) {
+        return { method: 'npm', command: 'npm install -g @ciphore/radiocli@latest' };
+    }
+    return { method: 'unknown', command: 'npm install -g @ciphore/radiocli@latest' };
+}
+export function installUpdate(command = updateCommandForInstall().command) {
+    return new Promise(resolve => {
+        const shell = process.platform === 'win32' ? 'cmd.exe' : 'sh';
+        const args = process.platform === 'win32' ? ['/d', '/s', '/c', command] : ['-lc', command];
+        const child = spawn(shell, args, { stdio: ['ignore', 'pipe', 'pipe'] });
+        const chunks = [];
+        child.stdout.on('data', chunk => chunks.push(Buffer.from(chunk)));
+        child.stderr.on('data', chunk => chunks.push(Buffer.from(chunk)));
+        child.on('error', error => {
+            resolve({ ok: false, command, output: error.message });
+        });
+        child.on('close', code => {
+            const output = Buffer.concat(chunks).toString('utf8').trim();
+            resolve({ ok: code === 0, command, output });
+        });
+    });
+}
+export function compareSemver(left, right) {
+    const leftParts = semverParts(left);
+    const rightParts = semverParts(right);
+    for (let index = 0; index < 3; index += 1) {
+        const delta = leftParts[index] - rightParts[index];
+        if (delta !== 0) {
+            return delta;
+        }
+    }
+    return 0;
+}
+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('.');
+    return [Number(major) || 0, Number(minor) || 0, Number(patch) || 0];
+}
+function resolvePath(path) {
+    if (!path) {
+        return undefined;
+    }
+    try {
+        return realpathSync(path);
+    }
+    catch {
+        return path;
+    }
+}

package/docs/THIRD_PARTY_NOTICES.md

@@ -31,3 +31,10 @@ SOFTWARE.
 
 The land polygon data is derived from Natural Earth 110m land data. Natural
 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>.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciphore/radiocli",
-  "version": "0.1.9",
+  "version": "0.2.1",
   "description": "A terminal-first world radio receiver built with Ink, mpv, and resilient public-radio providers.",
   "type": "module",
   "license": "MIT",
@@ -73,7 +73,7 @@
     "protobufjs": "^7.5.8"
   },
   "devDependencies": {
-    "@types/node": "^25.9.1",
+    "@types/node": "^22.15.0",
     "@types/react": "^19.2.15",
     "ink-testing-library": "^4.0.0",
     "knip": "^6.14.2",

package/dist/ui/screens/screen-render.test.js

@@ -1,214 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { render } from 'ink-testing-library';
-import { describe, expect, it } from 'vitest';
-import { DisplayContext, resolveDisplayMode } from '../display-context.js';
-import { HelpScreen } from './HelpScreen.js';
-import { NowPlayingScreen } from './NowPlayingScreen.js';
-import { SettingsScreen } from './SettingsScreen.js';
-import { ExploreScreen } from './ExploreScreen.js';
-import { CountriesScreen } from './CountriesScreen.js';
-import { buildContributionGraph, contributionLevel, contributionScaleSeconds, StatsScreen } from './StatsScreen.js';
-import { settingsItems } from '../screen-items.js';
-import { defaultExploreCursor } from '../app-state.js';
-const station = {
-    id: 'station-1',
-    provider: 'radio-browser',
-    name: 'KEXP 90.3 FM',
-    country: 'United States',
-    tags: ['indie'],
-    codec: 'MP3',
-    bitrate: 128
-};
-const playback = {
-    backend: 'mpv',
-    state: 'idle',
-    volume: 70,
-    muted: false,
-    ready: false
-};
-const diagnostics = {
-    backend: 'mpv',
-    availableBackends: ['mpv'],
-    preferredBackend: 'auto',
-    active: false,
-    volume: 70,
-    muted: false,
-    ready: false
-};
-const trackHistory = [
-    { title: 'Bjork - Joga', stationKey: 'radio-browser:station-1', stationName: 'KEXP 90.3 FM', at: '2' },
-    { title: 'Aphex Twin - Avril 14th', stationKey: 'radio-browser:station-1', stationName: 'KEXP 90.3 FM', at: '1' }
-];
-function renderNowPlaying(asciiMode, showDiagnostics) {
-    const mode = resolveDisplayMode({ asciiMode }, {});
-    return render(_jsx(DisplayContext.Provider, { value: mode, children: _jsx(NowPlayingScreen, { station: station, playback: playback, metadata: null, theme: "green", favorite: true, pulse: 0, diagnostics: diagnostics, sleepLabel: "Sleep off", showDiagnostics: showDiagnostics, stationTime: "12:00", receiverStyle: "pulse-grid", trackHistory: trackHistory, width: 72, height: 30 }) }));
-}
-const settings = {
-    theme: 'green',
-    receiverStyle: 'pulse-grid',
-    volume: 70,
-    enableRadioGarden: false,
-    enableNearbyLocation: false,
-    preferredBackend: 'auto',
-    tuneTimeoutSeconds: 12,
-    skipBrokenStreams: true,
-    mediaKeys: { previous: [], playPause: [], next: [] },
-    resumeOnLaunch: true,
-    asciiMode: true,
-    reduceMotion: false,
-    transparentBackground: false
-};
-describe('SettingsScreen rendering', () => {
-    it('renders the new display and playback toggles with their values', () => {
-        const settingsIndex = Math.max(0, settingsItems.indexOf('Resume last station on launch'));
-        const { lastFrame } = render(_jsx(SettingsScreen, { selected: settingsIndex, settings: settings, storePath: "/tmp/radiocli.json", playback: playback, backends: ['mpv'], airPlayDevices: [], providerHealth: {}, theme: "green", diagnostics: diagnostics, width: 80 }));
-        const frame = lastFrame() ?? '';
-        expect(frame).toContain('Resume last station on launch');
-        expect(frame).toContain('ASCII-safe display');
-        expect(frame).toContain('Reduce motion');
-        expect(frame).toContain('Transparent background');
-    });
-});
-function renderExplore(asciiMode) {
-    const mode = resolveDisplayMode({ asciiMode }, {});
-    return render(_jsx(DisplayContext.Provider, { value: mode, children: _jsx(ExploreScreen, { title: "Explore", subtitle: "Move a map cursor through geotagged stations", stations: [station], selected: 0, loading: false, theme: "green", favorites: new Set(), filterLabel: "", cursor: defaultExploreCursor, pageSize: 8, width: 100, height: 24 }) }));
-}
-describe('Explore world map rendering', () => {
-    it('rasterizes land with braille glyphs by default', () => {
-        const frame = renderExplore(false).lastFrame() ?? '';
-        expect(/[⠀-⣿]/.test(frame)).toBe(true);
-    });
-    it('replaces braille with ASCII in ASCII-safe mode', () => {
-        const frame = renderExplore(true).lastFrame() ?? '';
-        expect(/[⠀-⣿]/.test(frame)).toBe(false);
-    });
-});
-describe('CountriesScreen rendering', () => {
-    it('keeps long country rows to one terminal line', () => {
-        const frame = render(_jsx(CountriesScreen, { countries: [
-                {
-                    name: 'The Extremely Long Democratic Republic Of The Country With A Very Long Name',
-                    code: 'TL',
-                    stationCount: 123456789
-                }
-            ], selected: 0, loading: false, filter: "", editingFilter: false, theme: "green", pageSize: 1, width: 48 })).lastFrame() ?? '';
-        expect(frame).toContain('>');
-        expect(frame).toContain('…');
-        expect(frame).not.toContain('Very Long Name');
-    });
-});
-describe('StatsScreen rendering', () => {
-    it('renders activity heatmap as large calendar-year cells with readable month labels', () => {
-        const library = {
-            recent: [],
-            favorites: [],
-            imported: [],
-            trackHistory: [],
-            searchHistory: [],
-            activity: {
-                sessions: [
-                    {
-                        id: 'listen',
-                        station,
-                        startedAt: new Date(2026, 4, 24, 12).toISOString(),
-                        endedAt: new Date(2026, 4, 24, 13).toISOString(),
-                        listenedSeconds: 3600
-                    }
-                ]
-            },
-            settings
-        };
-        const frame = render(_jsx(DisplayContext.Provider, { value: resolveDisplayMode({ asciiMode: false }, {}), children: _jsx(StatsScreen, { library: library, theme: "green", width: 132, height: 32 }) })).lastFrame() ?? '';
-        expect(frame).toContain('Jan');
-        expect(frame).not.toContain('██');
-    });
-    it('starts the contribution graph at January and uses large cells when space allows', () => {
-        const graph = buildContributionGraph([
-            { date: '2026-01-01', seconds: 3600 },
-            { date: '2026-12-31', seconds: 0 }
-        ], 170);
-        expect(graph.months.startsWith('Jan')).toBe(true);
-        expect(graph.months).toContain('Dec');
-        expect(graph.cellText).toBe('  ');
-        expect(graph.cellGap).toBe('');
-        expect(graph.tileHeight).toBe(2);
-        expect(graph.rows[4]?.cells[0]).toMatchObject({
-            level: 4,
-            text: '  ',
-            visible: true
-        });
-        expect(graph.rows[0]?.cells[0]).toMatchObject({
-            level: 0,
-            text: '  ',
-            visible: true
-        });
-        expect(graph.rows[6]?.cells.at(-1)).toMatchObject({
-            level: 0,
-            text: '  ',
-            visible: true
-        });
-        const normalWidthGraph = buildContributionGraph([
-            { date: '2026-01-01', seconds: 3600 },
-            { date: '2026-12-31', seconds: 0 }
-        ], 128);
-        expect(normalWidthGraph.cellText).toBe('  ');
-        expect(normalWidthGraph.cellGap).toBe('');
-        const compactWidthGraph = buildContributionGraph([
-            { date: '2026-01-01', seconds: 3600 },
-            { date: '2026-12-31', seconds: 0 }
-        ], 80);
-        expect(compactWidthGraph.cellText).toBe(' ');
-        expect(compactWidthGraph.cellGap).toBe('');
-    });
-    it('uses one-line heatmap cells when the stats panel is height constrained', () => {
-        const graph = buildContributionGraph([
-            { date: '2026-01-01', seconds: 3600 },
-            { date: '2026-12-31', seconds: 0 }
-        ], 170, 20);
-        expect(graph.cellText).toBe('  ');
-        expect(graph.cellGap).toBe('');
-        expect(graph.tileHeight).toBe(1);
-    });
-    it('caps contribution color scaling so one outlier does not flatten normal active days', () => {
-        const days = [
-            ...Array.from({ length: 19 }, (_, index) => ({ date: `2026-05-${String(index + 1).padStart(2, '0')}`, seconds: 3600 })),
-            { date: '2026-05-20', seconds: 36_000 }
-        ];
-        const scaleSeconds = contributionScaleSeconds(days);
-        expect(scaleSeconds).toBe(3600);
-        expect(contributionLevel(3600, scaleSeconds)).toBe(4);
-        expect(contributionLevel(900, scaleSeconds)).toBe(2);
-        expect(contributionLevel(0, scaleSeconds)).toBe(0);
-    });
-});
-describe('HelpScreen rendering', () => {
-    it('lists keybinding sections and : commands', () => {
-        const { lastFrame } = render(_jsx(HelpScreen, { theme: "green", width: 80 }));
-        const frame = lastFrame() ?? '';
-        expect(frame).toContain('Navigation');
-        expect(frame).toContain('Playback');
-        expect(frame).toContain(':search');
-        expect(frame).toContain(':doctor');
-        expect(frame).toContain('Toggle this help');
-    });
-});
-describe('NowPlayingScreen rendering', () => {
-    it('shows recent tracks for the tuned station when diagnostics are open', () => {
-        const { lastFrame } = renderNowPlaying(false, true);
-        const frame = lastFrame() ?? '';
-        expect(frame).toContain('Bjork - Joga');
-        expect(frame).toContain('UNITED STATES');
-    });
-    it('uses Unicode box borders by default', () => {
-        const { lastFrame } = renderNowPlaying(false, false);
-        const frame = lastFrame() ?? '';
-        expect(/[\u2500-\u257f]/.test(frame)).toBe(true);
-    });
-    it('emits only ASCII characters in ASCII-safe mode', () => {
-        const { lastFrame } = renderNowPlaying(true, true);
-        const frame = lastFrame() ?? '';
-        expect(frame).toContain('Bjork - Joga');
-        // No braille, block, box-drawing, or punctuation glyphs survive ASCII mode.
-        expect(/[^\x00-\x7f]/.test(frame)).toBe(false);
-    });
-});