pingthings 0.5.0 → 0.6.0

package/packs/xonotic-announcer/manifest.json

@@ -6,47 +6,47 @@
   "credits": "Xonotic Project (https://github.com/xonotic/xonotic-data.pk3dir)",
   "category": "arena",
   "sounds": [
-    "sounds/1fragleft.wav",
-    "sounds/airshot.wav",
-    "sounds/amazing.wav",
-    "sounds/awesome.wav",
-    "sounds/begin.wav",
-    "sounds/botlike.wav",
-    "sounds/electrobitch.wav",
-    "sounds/headshot.wav",
-    "sounds/impressive.wav",
-    "sounds/lastsecond.wav",
-    "sounds/leadgained.wav",
-    "sounds/narrowly.wav",
-    "sounds/prepareforbattle.wav",
-    "sounds/terminated.wav",
-    "sounds/yoda.wav"
+    "sounds/1fragleft.ogg",
+    "sounds/airshot.ogg",
+    "sounds/amazing.ogg",
+    "sounds/awesome.ogg",
+    "sounds/begin.ogg",
+    "sounds/botlike.ogg",
+    "sounds/electrobitch.ogg",
+    "sounds/headshot.ogg",
+    "sounds/impressive.ogg",
+    "sounds/lastsecond.ogg",
+    "sounds/leadgained.ogg",
+    "sounds/narrowly.ogg",
+    "sounds/prepareforbattle.ogg",
+    "sounds/terminated.ogg",
+    "sounds/yoda.ogg"
   ],
   "events": {
     "done": [
-      "sounds/awesome.wav",
-      "sounds/amazing.wav",
-      "sounds/impressive.wav",
-      "sounds/airshot.wav"
+      "sounds/awesome.ogg",
+      "sounds/amazing.ogg",
+      "sounds/impressive.ogg",
+      "sounds/airshot.ogg"
     ],
     "permission": [
-      "sounds/prepareforbattle.wav",
-      "sounds/begin.wav",
-      "sounds/1fragleft.wav"
+      "sounds/prepareforbattle.ogg",
+      "sounds/begin.ogg",
+      "sounds/1fragleft.ogg"
     ],
     "complete": [
-      "sounds/yoda.wav",
-      "sounds/botlike.wav",
-      "sounds/leadgained.wav"
+      "sounds/yoda.ogg",
+      "sounds/botlike.ogg",
+      "sounds/leadgained.ogg"
     ],
     "error": [
-      "sounds/terminated.wav",
-      "sounds/headshot.wav",
-      "sounds/electrobitch.wav"
+      "sounds/terminated.ogg",
+      "sounds/headshot.ogg",
+      "sounds/electrobitch.ogg"
     ],
     "blocked": [
-      "sounds/lastsecond.wav",
-      "sounds/narrowly.wav"
+      "sounds/lastsecond.ogg",
+      "sounds/narrowly.ogg"
     ]
   }
 }

package/src/cli/config.js

@@ -1,6 +1,6 @@
 import { readConfig, writeConfig, VALID_MODES, VALID_EVENTS } from '../config.js';
 
-const VALID_KEYS = ['activePack', 'mode', 'specificSound', 'volume', 'eventPacks', 'cooldown', 'quietHours'];
+const VALID_KEYS = ['activePack', 'mode', 'specificSound', 'volume', 'eventPacks', 'cooldown', 'quietHours', 'notifications'];
 
 function showHelp() {
   console.log(`
@@ -112,16 +112,16 @@ export default function config(args) {
     return;
   }
 
-  // Validate cooldown
-  if (key === 'cooldown') {
+  // Validate boolean keys
+  if (key === 'notifications' || key === 'cooldown') {
     if (value !== 'true' && value !== 'false') {
-      console.error('Cooldown must be true or false.');
+      console.error(`${key} must be true or false.`);
       process.exit(1);
     }
     const cfg = readConfig();
-    cfg.cooldown = value === 'true';
+    cfg[key] = value === 'true';
     writeConfig(cfg);
-    console.log(`cooldown set to: ${cfg.cooldown}`);
+    console.log(`${key} set to: ${cfg[key]}`);
     return;
   }
 

package/src/cli/first-run.js

@@ -0,0 +1,59 @@
+import { createInterface } from 'node:readline';
+import { writeConfig, getDefaults } from '../config.js';
+import { listPacks, getPackSounds, pickRandom } from '../packs.js';
+import { playSound } from '../player.js';
+import { basename } from 'node:path';
+
+export async function runFirstTimeSetup() {
+  const packs = listPacks();
+
+  console.log('\n  ================================================');
+  console.log('     WELCOME TO PINGTHINGS!');
+  console.log('     Your terminal is about to get a LOT cooler.');
+  console.log('  ================================================\n');
+  console.log('  Let\'s pick your first sound pack.\n');
+
+  for (let i = 0; i < packs.length; i++) {
+    console.log(`    ${i + 1}. ${packs[i].name}  (${packs[i].category})`);
+    console.log(`       ${packs[i].description}`);
+  }
+
+  console.log('\n  Enter a number to preview, then press enter to confirm.\n');
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+
+  const chosen = await new Promise((resolve) => {
+    const ask = () => {
+      rl.question('  Pick a pack (1-' + packs.length + '): ', (answer) => {
+        const num = parseInt(answer.trim(), 10);
+        if (isNaN(num) || num < 1 || num > packs.length) {
+          console.log(`  Enter a number between 1 and ${packs.length}.`);
+          ask();
+          return;
+        }
+
+        const pack = packs[num - 1];
+        const sounds = getPackSounds(pack.name);
+        if (sounds.length > 0) {
+          const sample = pickRandom(sounds);
+          console.log(`\n  Preview: ${basename(sample)}`);
+          playSound(sample);
+        }
+
+        resolve(pack);
+      });
+    };
+    ask();
+  });
+
+  // Save config
+  const config = getDefaults();
+  config.activePack = chosen.name;
+  writeConfig(config);
+
+  console.log(`\n  Active pack set to: ${chosen.name}`);
+  console.log('\n  Quick tip: Run "pingthings init" to set up Claude Code hooks.');
+  console.log('  Or just run "pingthings play" anytime to hear a sound.\n');
+
+  rl.close();
+}

package/src/cli/play.js

@@ -1,15 +1,18 @@
 import { readConfig, VALID_EVENTS, getLastPlayed, setLastPlayed, isQuietHours } from '../config.js';
 import { getPackSounds, getEventSounds, pickRandom, resolvePack } from '../packs.js';
 import { playSound } from '../player.js';
+import { sendNotification } from '../notify.js';
 import { basename } from 'node:path';
 
 function parseArgs(args) {
-  const result = { sound: null, event: null };
+  const result = { sound: null, event: null, notify: false };
 
   for (let i = 0; i < args.length; i++) {
     if ((args[i] === '--event' || args[i] === '-e') && args[i + 1]) {
       result.event = args[i + 1];
       i++;
+    } else if (args[i] === '--notify' || args[i] === '-n') {
+      result.notify = true;
     } else if (args[i] === '--help' || args[i] === '-h') {
       showHelp();
       process.exit(0);
@@ -155,4 +158,10 @@ export default function play(args) {
 
   setLastPlayed(soundFile);
   playSound(soundFile, config.volume);
+
+  // Desktop notification
+  if (parsed.notify || config.notifications) {
+    const event = parsed.event || 'notification';
+    sendNotification('pingthings', `${event}: ${basename(soundFile)}`);
+  }
 }

package/src/cli/update.js

@@ -0,0 +1,43 @@
+import { execFileSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+function showHelp() {
+  console.log(`
+Usage: pingthings update
+
+Check for new versions of pingthings on npm.
+`);
+}
+
+export default function update(args) {
+  if (args.includes('--help') || args.includes('-h')) {
+    showHelp();
+    return;
+  }
+
+  const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf8'));
+  const current = pkg.version;
+
+  console.log(`\nCurrent version: ${current}`);
+  console.log('Checking npm for updates...\n');
+
+  try {
+    const latest = execFileSync('npm', ['view', 'pingthings', 'version'], {
+      encoding: 'utf8',
+      timeout: 10000,
+    }).trim();
+
+    if (latest === current) {
+      console.log('You are on the latest version.');
+    } else {
+      console.log(`New version available: ${latest}`);
+      console.log(`\nRun: npm install -g pingthings@${latest}`);
+    }
+  } catch {
+    console.error('Could not check for updates. Are you online?');
+  }
+}

package/src/config.js

@@ -10,6 +10,7 @@ const DEFAULTS = {
   eventPacks: {},
   cooldown: true,
   quietHours: null,
+  notifications: false,
 };
 
 export function getConfigDir() {
@@ -23,6 +24,10 @@ export function getConfigPath() {
   return join(getConfigDir(), 'config.json');
 }
 
+export function isFirstRun() {
+  return !existsSync(getConfigPath());
+}
+
 export function readConfig() {
   const configPath = getConfigPath();
   if (!existsSync(configPath)) {

package/src/notify.js

@@ -0,0 +1,19 @@
+import { spawn } from 'node:child_process';
+import { platform } from 'node:os';
+
+export function sendNotification(title, message) {
+  const os = platform();
+
+  if (os === 'darwin') {
+    spawn('osascript', [
+      '-e',
+      `display notification "${message}" with title "${title}"`,
+    ], { detached: true, stdio: 'ignore' }).unref();
+  } else if (os === 'linux') {
+    spawn('notify-send', [title, message], {
+      detached: true,
+      stdio: 'ignore',
+    }).on('error', () => {}).unref();
+  }
+  // Windows: no native CLI notification without dependencies, skip for now
+}