pingthings 0.6.0 → 0.8.0

package/packs/xonotic-announcer/openpeon.json

@@ -0,0 +1,107 @@
+{
+  "cesp_version": "1.0",
+  "name": "xonotic-announcer",
+  "display_name": "Arena FPS announcer voice lines from Xonotic",
+  "version": "1.0.0",
+  "license": "GPL-2.0-or-later",
+  "author": {
+    "name": "Xonotic Project (https://github.com/xonotic/xonotic-data.pk3dir)"
+  },
+  "categories": {
+    "task.acknowledge": {
+      "sounds": [
+        {
+          "file": "sounds/awesome.ogg",
+          "label": "awesome",
+          "sha256": "a75cf21a39d7faadffe3e2f17b2d0ca0149bab71a31561a7424a149419ca8565"
+        },
+        {
+          "file": "sounds/amazing.ogg",
+          "label": "amazing",
+          "sha256": "54bc110c31bfb8ea9323cdf9df47826672393aca967421debb601b4d551e20c6"
+        },
+        {
+          "file": "sounds/impressive.ogg",
+          "label": "impressive",
+          "sha256": "294cef5c449dec7592bc52054e203d5d85277361f7af6da1077a9c4fcd95d340"
+        },
+        {
+          "file": "sounds/airshot.ogg",
+          "label": "airshot",
+          "sha256": "c07e53928cd4a7e5ef2d56862a43da4f3fafe0b28ddf91554a24174b56e3d527"
+        }
+      ]
+    },
+    "input.required": {
+      "sounds": [
+        {
+          "file": "sounds/prepareforbattle.ogg",
+          "label": "prepareforbattle",
+          "sha256": "20651628c3edf90b414fa8aa063e7568819ff820506920b4a8e86c78c7a336ad"
+        },
+        {
+          "file": "sounds/begin.ogg",
+          "label": "begin",
+          "sha256": "8bce8664a5735a4df20a7a2667cfeee9d4723238b979db6e87a3f0887050b812"
+        },
+        {
+          "file": "sounds/1fragleft.ogg",
+          "label": "1fragleft",
+          "sha256": "e1522f8e929369ba4c6f8134598c22caccbbd61439e17ee3a23e165d754580e6"
+        }
+      ]
+    },
+    "task.complete": {
+      "sounds": [
+        {
+          "file": "sounds/yoda.ogg",
+          "label": "yoda",
+          "sha256": "a8bef88c6f1813713f7c1de014b077975a6502f8d0eb87bd223577a299cdce9a"
+        },
+        {
+          "file": "sounds/botlike.ogg",
+          "label": "botlike",
+          "sha256": "2a05e921c609b5c6be9d74b10bb29e65ada70a89e4d448409bf17a09605dee38"
+        },
+        {
+          "file": "sounds/leadgained.ogg",
+          "label": "leadgained",
+          "sha256": "f9c1516d185020ca088f14b9ae38709a09f11fbc6acd80fbd610d7022fe5f0cc"
+        }
+      ]
+    },
+    "task.error": {
+      "sounds": [
+        {
+          "file": "sounds/terminated.ogg",
+          "label": "terminated",
+          "sha256": "823553d052e624aaa47f13235906cef52a9a4f74fdc3b323cc2f2a83c77b82bd"
+        },
+        {
+          "file": "sounds/headshot.ogg",
+          "label": "headshot",
+          "sha256": "571f39f1543a3bbd23d2712845ba7da6d782f24cd370ceffb9912f57a198ee92"
+        },
+        {
+          "file": "sounds/electrobitch.ogg",
+          "label": "electrobitch",
+          "sha256": "c562648da52d97b775a15610b8284aed6cf283bb7266f0d45f7c0063655cc7af"
+        }
+      ]
+    },
+    "resource.limit": {
+      "sounds": [
+        {
+          "file": "sounds/lastsecond.ogg",
+          "label": "lastsecond",
+          "sha256": "7a0c2f948af8f94bed17ff68a9eb3a45a16a0c75df25cb41ea5ab2106da0cb3b"
+        },
+        {
+          "file": "sounds/narrowly.ogg",
+          "label": "narrowly",
+          "sha256": "f8d42b5290e1ffd655fbce86c7b3a2021ac146d5afedd464f1d6568b4cc13a53"
+        }
+      ]
+    }
+  }
+}

package/src/cli/cesp.js

@@ -0,0 +1,101 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { createHash } from 'node:crypto';
+import { resolvePack, listPacks } from '../packs.js';
+
+const PINGTHINGS_TO_CESP = {
+  done: 'task.acknowledge',
+  permission: 'input.required',
+  complete: 'task.complete',
+  error: 'task.error',
+  blocked: 'resource.limit',
+};
+
+function showHelp() {
+  console.log(`
+Usage: pingthings cesp [pack|--all]
+
+Generate CESP-compatible openpeon.json for a pack.
+Makes your packs work with any CESP-compatible tool (PeonPing, etc.)
+
+Arguments:
+  pack     Generate for a specific pack
+  --all    Generate for all built-in packs
+
+Examples:
+  pingthings cesp 7kaa-soldiers    Generate for one pack
+  pingthings cesp --all            Generate for all packs
+`);
+}
+
+function generateCesp(packName) {
+  const pack = resolvePack(packName);
+  if (!pack || !pack.manifest) {
+    console.error(`Pack not found: ${packName}`);
+    return false;
+  }
+
+  const m = pack.manifest;
+  const categories = {};
+
+  for (const [pingEvent, cespEvent] of Object.entries(PINGTHINGS_TO_CESP)) {
+    const eventSounds = m.events?.[pingEvent] || [];
+    if (eventSounds.length === 0) continue;
+
+    categories[cespEvent] = {
+      sounds: eventSounds.map(file => {
+        const fullPath = join(pack.dir, file);
+        let sha256 = '';
+        try {
+          const data = readFileSync(fullPath);
+          sha256 = createHash('sha256').update(data).digest('hex');
+        } catch {}
+
+        return {
+          file,
+          label: file.split('/').pop().replace(/\.\w+$/, '').replace(/[-_]/g, ' '),
+          ...(sha256 ? { sha256 } : {}),
+        };
+      }),
+    };
+  }
+
+  const cesp = {
+    cesp_version: '1.0',
+    name: m.name,
+    display_name: m.description,
+    version: m.version || '1.0.0',
+    license: m.license,
+    author: {
+      name: m.credits || 'Unknown',
+    },
+    categories,
+  };
+
+  const outPath = join(pack.dir, 'openpeon.json');
+  writeFileSync(outPath, JSON.stringify(cesp, null, 2) + '\n', 'utf8');
+  console.log(`  Generated: ${outPath}`);
+  return true;
+}
+
+export default function cesp(args) {
+  if (args.includes('--help') || args.includes('-h') || args.length === 0) {
+    showHelp();
+    if (args.length === 0) process.exit(1);
+    return;
+  }
+
+  if (args.includes('--all')) {
+    console.log('\nGenerating CESP manifests for all packs:\n');
+    const packs = listPacks();
+    for (const pack of packs) {
+      if (pack.isBuiltIn) {
+        generateCesp(pack.name);
+      }
+    }
+    console.log('\nDone.\n');
+    return;
+  }
+
+  generateCesp(args[0]);
+}

package/src/packs.js

@@ -12,19 +12,76 @@ function getUserPacksDir() {
   return join(getConfigDir(), 'packs');
 }
 
+// CESP event → pingthings event mapping
+const CESP_EVENT_MAP = {
+  'session.start': 'permission',
+  'task.acknowledge': 'done',
+  'task.complete': 'complete',
+  'task.error': 'error',
+  'input.required': 'permission',
+  'resource.limit': 'blocked',
+  'user.spam': 'blocked',
+  'session.end': 'complete',
+  'task.progress': 'done',
+};
+
+function convertCespManifest(cesp) {
+  const events = {};
+  for (const [cespEvent, sounds] of Object.entries(cesp.categories || {})) {
+    const pingEvent = CESP_EVENT_MAP[cespEvent];
+    if (!pingEvent) continue;
+    const files = (sounds.sounds || []).map(s => s.file);
+    if (!events[pingEvent]) events[pingEvent] = [];
+    events[pingEvent].push(...files);
+  }
+
+  const allSounds = [];
+  for (const sounds of Object.values(cesp.categories || {})) {
+    for (const s of sounds.sounds || []) {
+      if (!allSounds.includes(s.file)) allSounds.push(s.file);
+    }
+  }
+
+  return {
+    name: cesp.name,
+    description: cesp.display_name || cesp.description || '',
+    version: cesp.version || '1.0.0',
+    license: cesp.license || 'Unknown',
+    credits: cesp.author?.name || '',
+    category: cesp.tags?.[0] || 'other',
+    sounds: allSounds,
+    events,
+    _cesp: true,
+  };
+}
+
 function readManifest(packDir) {
+  // Prefer manifest.json (our native format) — richer metadata
   const manifestPath = join(packDir, 'manifest.json');
-  if (!existsSync(manifestPath)) return null;
-  try {
-    const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
-    if (!manifest.name) {
-      console.error(`Warning: manifest.json in ${packDir} is missing "name" field`);
+  if (existsSync(manifestPath)) {
+    try {
+      const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+      if (!manifest.name) {
+        console.error(`Warning: manifest.json in ${packDir} is missing "name" field`);
+      }
+      return manifest;
+    } catch (err) {
+      console.error(`Warning: Failed to parse ${manifestPath}: ${err.message}`);
+    }
+  }
+
+  // Fall back to CESP format (openpeon.json) for community packs
+  const cespPath = join(packDir, 'openpeon.json');
+  if (existsSync(cespPath)) {
+    try {
+      const cesp = JSON.parse(readFileSync(cespPath, 'utf8'));
+      return convertCespManifest(cesp);
+    } catch (err) {
+      console.error(`Warning: Failed to parse ${cespPath}: ${err.message}`);
     }
-    return manifest;
-  } catch (err) {
-    console.error(`Warning: Failed to parse ${manifestPath}: ${err.message}`);
-    return null;
   }
+
+  return null;
 }
 
 function discoverSounds(packDir) {