vibe-notify 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vibe-notify
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,112 @@
+# vibe-notify 🔊
+
+Notification sounds for Claude Code sessions. Plays a customizable beep/jingle when Claude finishes responding — so you can step away and still know when your task is done.
+
+## Quick Start
+
+```bash
+# Install globally
+npm install -g vibe-notify
+
+# Test it
+vibe-notify victory
+
+# Set up config
+vibe-notify --init
+```
+
+Or run without installing:
+
+```bash
+npx -y vibe-notify victory
+```
+
+## Built-in Sounds
+
+| Sound | Description |
+|-------|-------------|
+| `short-beep` | Single short beep — quick acknowledgment |
+| `double-beep` | Two quick beeps — "something finished" |
+| `ascending` | Three rising tones — positive progression |
+| `descending` | Three falling tones — winding down |
+| `victory` | C-E-G-C arpeggio — celebratory jingle |
+| `custom` | Play your own `.wav` file |
+
+List them anytime: `vibe-notify --list`
+
+## Configuration
+
+Config file location (checked in order):
+1. **Project-local**: `.vibe-notify.json` in your project root
+2. **Global**: `~/.vibe-notify/config.json`
+
+```json
+{
+  "sound": "ascending",
+  "customFile": null,
+  "volume": 0.7,
+  "playback": {
+    "method": "auto"
+  }
+}
+```
+
+### Custom Sound File
+
+```json
+{
+  "sound": "custom",
+  "customFile": "C:\\Users\\You\\sounds\\done.wav",
+  "volume": 1.0
+}
+```
+
+## Claude Code Hook Setup
+
+Add this to your `.claude/settings.json` (project or global) to auto-play when Claude finishes:
+
+```json
+{
+  "hooks": {
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "npx",
+            "args": ["-y", "vibe-notify"],
+            "timeout": 15
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+Replace `"npx", "-y", "vibe-notify"` with `"vibe-notify"` if installed globally. Add a sound name like `"victory"` to the args to override the config.
+
+## CLI Reference
+
+```
+vibe-notify [options] [sound-name]
+
+Options:
+  --help, -h       Show help
+  --list, -l       List available sounds
+  --config, -c     Print config file path
+  --init           Create default config file
+  --version, -v    Show version
+```
+
+## How It Works
+
+- **Zero runtime dependencies** — all sound generation is pure Node.js
+- Built-in sounds are generated as WAV audio in-memory (sine waves with envelope)
+- Playback uses native system players: PowerShell SoundPlayer (Windows), afplay (macOS), paplay/aplay (Linux)
+- Falls back to `[System.Console]::Beep()` or terminal bell if WAV playback fails
+- Temp files are cleaned up immediately after playback
+
+## License
+
+MIT

package/dist/beep.d.ts

@@ -0,0 +1,12 @@
+import { Pattern, Tone } from './types';
+export declare const PATTERNS: Pattern[];
+export declare function getPatternByName(name: string): Pattern | undefined;
+/**
+ * Build a complete 16-bit PCM mono WAV buffer from a list of tones.
+ * Returns null if the pattern name is not found.
+ */
+export declare function buildPatternBuffer(patternName: string, volume?: number): Buffer | null;
+/**
+ * Generate a WAV file buffer from an array of Tone objects.
+ */
+export declare function generateWav(tones: Tone[], sampleRate: number, volume: number): Buffer;

package/dist/beep.js

@@ -0,0 +1,152 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PATTERNS = void 0;
+exports.getPatternByName = getPatternByName;
+exports.buildPatternBuffer = buildPatternBuffer;
+exports.generateWav = generateWav;
+// ── WAV constants ──────────────────────────────────────────────────────────
+const SAMPLE_RATE = 44100;
+const BITS_PER_SAMPLE = 16;
+const NUM_CHANNELS = 1;
+const BYTES_PER_SAMPLE = BITS_PER_SAMPLE / 8; // 2
+// ── Built-in sound patterns ────────────────────────────────────────────────
+exports.PATTERNS = [
+    {
+        name: 'short-beep',
+        description: 'A single short beep — quick task-complete acknowledgment',
+        tones: [{ frequency: 880, duration: 0.15 }],
+    },
+    {
+        name: 'double-beep',
+        description: 'Two quick beeps — "something just finished"',
+        tones: [
+            { frequency: 660, duration: 0.1, gap: 0.08 },
+            { frequency: 880, duration: 0.15 },
+        ],
+    },
+    {
+        name: 'ascending',
+        description: 'Three rising tones — positive progression',
+        tones: [
+            { frequency: 400, duration: 0.15, gap: 0.05 },
+            { frequency: 600, duration: 0.15, gap: 0.05 },
+            { frequency: 800, duration: 0.2 },
+        ],
+    },
+    {
+        name: 'descending',
+        description: 'Three falling tones — task complete, winding down',
+        tones: [
+            { frequency: 800, duration: 0.15, gap: 0.05 },
+            { frequency: 600, duration: 0.15, gap: 0.05 },
+            { frequency: 400, duration: 0.2 },
+        ],
+    },
+    {
+        name: 'victory',
+        description: 'Victory jingle — C5-E5-G5-C6 arpeggio',
+        tones: [
+            { frequency: 523.25, duration: 0.12, gap: 0.06 },
+            { frequency: 659.25, duration: 0.12, gap: 0.06 },
+            { frequency: 783.99, duration: 0.12, gap: 0.06 },
+            { frequency: 1046.5, duration: 0.3 },
+        ],
+    },
+];
+// ── Pattern lookup ─────────────────────────────────────────────────────────
+function getPatternByName(name) {
+    return exports.PATTERNS.find((p) => p.name === name);
+}
+// ── WAV generation ─────────────────────────────────────────────────────────
+/**
+ * Build a complete 16-bit PCM mono WAV buffer from a list of tones.
+ * Returns null if the pattern name is not found.
+ */
+function buildPatternBuffer(patternName, volume = 0.7) {
+    const pattern = getPatternByName(patternName);
+    if (!pattern)
+        return null;
+    return generateWav(pattern.tones, SAMPLE_RATE, clampVolume(volume));
+}
+/**
+ * Generate a WAV file buffer from an array of Tone objects.
+ */
+function generateWav(tones, sampleRate, volume) {
+    // Calculate total samples needed
+    let totalSamples = 0;
+    for (const tone of tones) {
+        totalSamples += Math.ceil(tone.duration * sampleRate);
+        if (tone.gap && tone.gap > 0) {
+            totalSamples += Math.ceil(tone.gap * sampleRate);
+        }
+    }
+    const dataSize = totalSamples * BYTES_PER_SAMPLE;
+    const headerSize = 44;
+    const buffer = Buffer.alloc(headerSize + dataSize);
+    // Write WAV header
+    writeWavHeader(buffer, dataSize, sampleRate);
+    // Generate audio samples
+    const samples = generateSamples(tones, sampleRate, volume, totalSamples);
+    // Write 16-bit PCM samples (little-endian)
+    let offset = headerSize;
+    for (let i = 0; i < totalSamples; i++) {
+        // Clamp to 16-bit range
+        const sample = Math.max(-32768, Math.min(32767, Math.round(samples[i] * 32767)));
+        buffer.writeInt16LE(sample, offset);
+        offset += 2;
+    }
+    return buffer;
+}
+// ── Internal helpers ───────────────────────────────────────────────────────
+function clampVolume(v) {
+    return Math.max(0, Math.min(1, v));
+}
+function writeWavHeader(buffer, dataSize, sampleRate) {
+    const byteRate = sampleRate * NUM_CHANNELS * BYTES_PER_SAMPLE;
+    const blockAlign = NUM_CHANNELS * BYTES_PER_SAMPLE;
+    // RIFF header
+    buffer.write('RIFF', 0, 'ascii');
+    buffer.writeUInt32LE(36 + dataSize, 4); // ChunkSize
+    buffer.write('WAVE', 8, 'ascii');
+    // fmt sub-chunk
+    buffer.write('fmt ', 12, 'ascii');
+    buffer.writeUInt32LE(16, 16); // Subchunk1Size (PCM = 16)
+    buffer.writeUInt16LE(1, 20); // AudioFormat (PCM = 1)
+    buffer.writeUInt16LE(NUM_CHANNELS, 22);
+    buffer.writeUInt32LE(sampleRate, 24);
+    buffer.writeUInt32LE(byteRate, 28);
+    buffer.writeUInt16LE(blockAlign, 32);
+    buffer.writeUInt16LE(BITS_PER_SAMPLE, 34);
+    // data sub-chunk
+    buffer.write('data', 36, 'ascii');
+    buffer.writeUInt32LE(dataSize, 40);
+}
+function generateSamples(tones, sampleRate, volume, totalSamples) {
+    const samples = new Float32Array(totalSamples);
+    let offset = 0;
+    for (const tone of tones) {
+        const toneSamples = Math.ceil(tone.duration * sampleRate);
+        const attackSamples = Math.ceil(0.01 * sampleRate); // 10ms attack
+        const releaseSamples = Math.ceil(0.02 * sampleRate); // 20ms release
+        for (let i = 0; i < toneSamples; i++) {
+            const t = i / sampleRate;
+            let sample = Math.sin(2 * Math.PI * tone.frequency * t) * volume;
+            // Apply envelope to prevent clicks
+            if (i < attackSamples) {
+                sample *= i / attackSamples; // Linear fade-in
+            }
+            else if (i >= toneSamples - releaseSamples) {
+                sample *= (toneSamples - i) / releaseSamples; // Linear fade-out
+            }
+            samples[offset + i] = sample;
+        }
+        offset += toneSamples;
+        // Write silence for gap
+        if (tone.gap && tone.gap > 0) {
+            const gapSamples = Math.ceil(tone.gap * sampleRate);
+            offset += gapSamples; // Float32Array is already zero-filled
+        }
+    }
+    return samples;
+}
+//# sourceMappingURL=beep.js.map

package/dist/beep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"beep.js","sourceRoot":"","sources":["../src/beep.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,4 @@
+import { CliAction } from './types';
+export declare function parseArgs(argv: string[]): CliAction;
+export declare function showHelp(): void;
+export declare function listSounds(): void;

package/dist/cli.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = parseArgs;
+exports.showHelp = showHelp;
+exports.listSounds = listSounds;
+const beep_1 = require("./beep");
+// ── Public API ─────────────────────────────────────────────────────────────
+function parseArgs(argv) {
+    const args = argv.slice(); // copy
+    if (args.length === 0) {
+        return { action: 'play' }; // Play configured sound
+    }
+    const first = args[0];
+    // Handle flags
+    switch (first) {
+        case '--help':
+        case '-h':
+            return { action: 'help' };
+        case '--list':
+        case '-l':
+            return { action: 'list' };
+        case '--config':
+        case '-c':
+            return { action: 'config' };
+        case '--init':
+            return { action: 'init' };
+        case '--version':
+        case '-v':
+            return { action: 'version' };
+    }
+    // Anything else is treated as a sound name
+    return { action: 'play', soundName: first };
+}
+// ── Display helpers ────────────────────────────────────────────────────────
+function showHelp() {
+    console.log(`vibe-notify — Notification sounds for Claude Code
+
+Usage:
+  vibe-notify [options] [sound-name]
+
+Options:
+  --help, -h       Show this help message
+  --list, -l       List available built-in sounds
+  --config, -c     Print the config file path
+  --init           Create a default config file at ~/.vibe-notify/config.json
+  --version, -v    Show version number
+
+Arguments:
+  sound-name       Play a specific sound (overrides config file):
+                   ${beep_1.PATTERNS.map((p) => p.name).join(', ')}
+
+  If no sound-name is given, plays the sound from the config file.
+
+Examples:
+  vibe-notify victory          Play the victory jingle
+  vibe-notify --list           See all available sounds
+  vibe-notify --init           Set up your config file
+
+Config file: ~/.vibe-notify/config.json (or .vibe-notify.json in project root)
+Claude Code hook: Add to .claude/settings.json → hooks.Stop
+`);
+}
+function listSounds() {
+    console.log('Available built-in sounds:\n');
+    for (const pattern of beep_1.PATTERNS) {
+        console.log(`  ${pattern.name.padEnd(14)} ${pattern.description}`);
+    }
+    console.log(`\n  ${'custom'.padEnd(14)} Play a custom .wav file (set "customFile" in config)`);
+    console.log(`\nUse "vibe-notify <name>" to play one, or set "sound" in your config file.`);
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;AAKA,8BAiCC;AAID,4BA2BC;AAED,gCAOC;AA7ED,iCAAkC;AAElC,8EAA8E;AAE9E,SAAgB,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,OAAO;IAElC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,wBAAwB;IACrD,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEtB,eAAe;IACf,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAE5B,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAE5B,KAAK,UAAU,CAAC;QAChB,KAAK,IAAI;YACP,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;QAE9B,KAAK,QAAQ;YACX,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAE5B,KAAK,WAAW,CAAC;QACjB,KAAK,IAAI;YACP,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACjC,CAAC;IAED,2CAA2C;IAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAE9E,SAAgB,QAAQ;IACtB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;qBAcO,eAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;;;;;;;CAW1D,CAAC,CAAC;AACH,CAAC;AAED,SAAgB,UAAU;IACxB,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC5C,KAAK,MAAM,OAAO,IAAI,eAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,uDAAuD,CAAC,CAAC;IAC/F,OAAO,CAAC,GAAG,CAAC,6EAA6E,CAAC,CAAC;AAC7F,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+import { VibeNotifyConfig } from './types';
+export declare const DEFAULT_CONFIG: VibeNotifyConfig;
+export declare function getConfigDir(): string;
+export declare function getConfigPath(): string;
+export declare function getConfigFilePath(): string;
+export declare function loadConfig(): VibeNotifyConfig;
+export declare function saveConfig(config: VibeNotifyConfig): void;
+export declare function initConfig(): string;

package/dist/config.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG = void 0;
+exports.getConfigDir = getConfigDir;
+exports.getConfigPath = getConfigPath;
+exports.getConfigFilePath = getConfigFilePath;
+exports.loadConfig = loadConfig;
+exports.saveConfig = saveConfig;
+exports.initConfig = initConfig;
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+// ── Defaults ───────────────────────────────────────────────────────────────
+exports.DEFAULT_CONFIG = {
+    sound: 'short-beep',
+    customFile: null,
+    volume: 0.7,
+    playback: {
+        method: 'auto',
+    },
+};
+// ── Path resolution ────────────────────────────────────────────────────────
+function getConfigDir() {
+    return (0, path_1.join)((0, os_1.homedir)(), '.vibe-notify');
+}
+function getConfigPath() {
+    // Project-local config takes priority
+    const local = (0, path_1.resolve)('.vibe-notify.json');
+    if ((0, fs_1.existsSync)(local)) {
+        return local;
+    }
+    // Fall back to global config
+    return (0, path_1.join)(getConfigDir(), 'config.json');
+}
+function getConfigFilePath() {
+    return getConfigPath();
+}
+// ── Load / Save ────────────────────────────────────────────────────────────
+function loadConfig() {
+    const configPath = getConfigPath();
+    if (!(0, fs_1.existsSync)(configPath)) {
+        return { ...exports.DEFAULT_CONFIG };
+    }
+    try {
+        const raw = (0, fs_1.readFileSync)(configPath, 'utf-8');
+        const parsed = JSON.parse(raw);
+        return mergeConfig(exports.DEFAULT_CONFIG, parsed);
+    }
+    catch (err) {
+        console.error(`Warning: Could not read config at ${configPath}. Using defaults.`);
+        return { ...exports.DEFAULT_CONFIG };
+    }
+}
+function saveConfig(config) {
+    const configPath = getConfigPath();
+    const dir = getConfigDir();
+    if (!(0, fs_1.existsSync)(dir)) {
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    (0, fs_1.writeFileSync)(configPath, JSON.stringify(config, null, 2), 'utf-8');
+}
+function initConfig() {
+    const configPath = getConfigPath();
+    const dir = getConfigDir();
+    if (!(0, fs_1.existsSync)(dir)) {
+        (0, fs_1.mkdirSync)(dir, { recursive: true });
+    }
+    if ((0, fs_1.existsSync)(configPath)) {
+        return configPath; // Already exists, don't overwrite
+    }
+    saveConfig({ ...exports.DEFAULT_CONFIG });
+    return configPath;
+}
+// ── Helpers ────────────────────────────────────────────────────────────────
+function mergeConfig(defaults, overrides) {
+    return {
+        ...defaults,
+        ...overrides,
+        playback: {
+            ...defaults.playback,
+            ...(overrides.playback || {}),
+        },
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,105 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const cli_1 = require("./cli");
+const config_1 = require("./config");
+const beep_1 = require("./beep");
+const player_1 = require("./player");
+// Read version from package.json
+let VERSION = '0.1.0';
+try {
+    // When running from dist/, package.json is one level up
+    const pkg = JSON.parse((0, fs_1.readFileSync)(__dirname + '/../package.json', 'utf-8'));
+    VERSION = pkg.version || VERSION;
+}
+catch {
+    // Fallback version
+}
+async function main() {
+    const cli = (0, cli_1.parseArgs)(process.argv.slice(2));
+    // ── Info actions (no sound played) ───────────────────────────────────
+    switch (cli.action) {
+        case 'help':
+            (0, cli_1.showHelp)();
+            return;
+        case 'list':
+            (0, cli_1.listSounds)();
+            return;
+        case 'config':
+            console.log((0, config_1.getConfigFilePath)());
+            return;
+        case 'init': {
+            const path = (0, config_1.initConfig)();
+            console.log(`Config created at: ${path}`);
+            return;
+        }
+        case 'version':
+            console.log(`vibe-notify v${VERSION}`);
+            return;
+        case 'play':
+            // Continue below
+            break;
+    }
+    // ── Play sound ───────────────────────────────────────────────────────
+    const config = (0, config_1.loadConfig)();
+    const soundName = cli.soundName || config.sound;
+    // Validate sound name
+    if (soundName !== 'custom' && !(0, beep_1.getPatternByName)(soundName)) {
+        console.error(`Unknown sound: "${soundName}"`);
+        console.error(`Use --list to see available sounds.`);
+        process.exit(1);
+    }
+    // ── Custom file playback ─────────────────────────────────────────────
+    if (soundName === 'custom') {
+        if (!config.customFile) {
+            console.error('Sound is set to "custom" but no customFile is configured.');
+            console.error(`Set "customFile" in ${(0, config_1.getConfigFilePath)()} to a .wav file path.`);
+            process.exit(1);
+        }
+        if (!(0, fs_1.existsSync)(config.customFile)) {
+            console.error(`Custom file not found: ${config.customFile}`);
+            process.exit(1);
+        }
+        try {
+            await (0, player_1.playFile)(config.customFile, config.playback.method);
+        }
+        catch (err) {
+            console.error(`Failed to play custom file: ${err.message}`);
+            process.exit(1);
+        }
+        return;
+    }
+    // ── Built-in pattern playback ────────────────────────────────────────
+    const buffer = (0, beep_1.buildPatternBuffer)(soundName, config.volume);
+    if (buffer) {
+        try {
+            await (0, player_1.playBuffer)(buffer, config.playback.method);
+        }
+        catch (err) {
+            // WAV playback failed — try fallback beep
+            const pattern = (0, beep_1.getPatternByName)(soundName);
+            if (pattern) {
+                try {
+                    await (0, player_1.fallbackBeep)(pattern.tones);
+                }
+                catch {
+                    // Both methods failed — non-fatal, just warn
+                    console.error(`Could not play sound: ${err.message}`);
+                }
+            }
+        }
+    }
+    else {
+        // Buffer generation failed — fallback to system beep
+        const pattern = (0, beep_1.getPatternByName)(soundName);
+        if (pattern) {
+            await (0, player_1.fallbackBeep)(pattern.tones);
+        }
+    }
+}
+main().catch((err) => {
+    console.error('vibe-notify error:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/player.d.ts

@@ -0,0 +1,15 @@
+import { Tone, PlaybackMethod } from './types';
+/**
+ * Play a WAV buffer through the system audio output.
+ * Writes to a temp file, plays it, then cleans up.
+ */
+export declare function playBuffer(buffer: Buffer, method?: PlaybackMethod): Promise<void>;
+/**
+ * Play a custom audio file (WAV) directly.
+ */
+export declare function playFile(filePath: string, method?: PlaybackMethod): Promise<void>;
+/**
+ * Fallback: play tones using system beep (no WAV generation needed).
+ * Uses [System.Console]::Beep on Windows, terminal BEL on Unix.
+ */
+export declare function fallbackBeep(tones: Tone[]): Promise<void>;

package/dist/player.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.playBuffer = playBuffer;
+exports.playFile = playFile;
+exports.fallbackBeep = fallbackBeep;
+const child_process_1 = require("child_process");
+const fs_1 = require("fs");
+const os_1 = require("os");
+const path_1 = require("path");
+// ── Public API ─────────────────────────────────────────────────────────────
+/**
+ * Play a WAV buffer through the system audio output.
+ * Writes to a temp file, plays it, then cleans up.
+ */
+async function playBuffer(buffer, method = 'auto') {
+    const tempFile = (0, path_1.join)((0, os_1.tmpdir)(), `vibe-notify-${Date.now()}.wav`);
+    try {
+        (0, fs_1.writeFileSync)(tempFile, buffer);
+        const platform = process.platform;
+        if (method === 'powershell' || (method === 'auto' && platform === 'win32')) {
+            await playWithPowerShell(tempFile);
+        }
+        else if (method === 'afplay' || (method === 'auto' && platform === 'darwin')) {
+            await playWithAfplay(tempFile);
+        }
+        else if (method === 'aplay' || (method === 'auto' && platform === 'linux')) {
+            await playWithLinux(tempFile);
+        }
+        else if (method === 'native') {
+            // "native" means try whatever the platform supports but don't use powershell/afplay/aplay
+            // On Windows this falls through to the beep fallback
+            throw new Error('Native method not supported for WAV playback');
+        }
+        else {
+            // Cross-platform fallback: try PowerShell even on non-Windows (WSL, etc.)
+            try {
+                await playWithPowerShell(tempFile);
+            }
+            catch {
+                await playWithLinux(tempFile);
+            }
+        }
+    }
+    finally {
+        try {
+            (0, fs_1.unlinkSync)(tempFile);
+        }
+        catch {
+            // Temp file cleanup is best-effort
+        }
+    }
+}
+/**
+ * Play a custom audio file (WAV) directly.
+ */
+async function playFile(filePath, method = 'auto') {
+    const platform = process.platform;
+    if (method === 'powershell' || (method === 'auto' && platform === 'win32')) {
+        await playWithPowerShell(filePath);
+    }
+    else if (method === 'afplay' || (method === 'auto' && platform === 'darwin')) {
+        await playWithAfplay(filePath);
+    }
+    else if (method === 'aplay' || (method === 'auto' && platform === 'linux')) {
+        await playWithLinux(filePath);
+    }
+    else {
+        await playWithPowerShell(filePath);
+    }
+}
+/**
+ * Fallback: play tones using system beep (no WAV generation needed).
+ * Uses [System.Console]::Beep on Windows, terminal BEL on Unix.
+ */
+async function fallbackBeep(tones) {
+    const platform = process.platform;
+    for (const tone of tones) {
+        if (platform === 'win32') {
+            await execPromise('powershell', [
+                '-NoProfile',
+                '-NonInteractive',
+                '-Command',
+                `[System.Console]::Beep(${tone.frequency}, ${Math.round(tone.duration * 1000)})`,
+            ]);
+        }
+        else {
+            // Terminal bell character
+            process.stderr.write('\x07');
+            await delay(tone.duration * 1000);
+        }
+        if (tone.gap && tone.gap > 0) {
+            await delay(tone.gap * 1000);
+        }
+    }
+}
+// ── Platform-specific players ──────────────────────────────────────────────
+async function playWithPowerShell(filePath) {
+    const escaped = filePath.replace(/'/g, "''");
+    await execPromise('powershell', [
+        '-NoProfile',
+        '-NonInteractive',
+        '-Command',
+        `$p = New-Object System.Media.SoundPlayer('${escaped}'); $p.PlaySync()`,
+    ]);
+}
+async function playWithAfplay(filePath) {
+    await execPromise('afplay', [filePath]);
+}
+async function playWithLinux(filePath) {
+    // Try PulseAudio first, fallback to ALSA
+    try {
+        await execPromise('paplay', [filePath]);
+    }
+    catch {
+        try {
+            await execPromise('aplay', [filePath]);
+        }
+        catch {
+            // Last resort: try ffplay if available
+            await execPromise('ffplay', ['-nodisp', '-autoexit', '-loglevel', 'quiet', filePath]);
+        }
+    }
+}
+// ── Utilities ──────────────────────────────────────────────────────────────
+function execPromise(command, args) {
+    return new Promise((resolve, reject) => {
+        const proc = (0, child_process_1.spawn)(command, args, {
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`${command} exited with code ${code}`));
+            }
+        });
+        proc.on('error', (err) => {
+            reject(err);
+        });
+    });
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=player.js.map

package/dist/player.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"player.js","sourceRoot":"","sources":["../src/player.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,45 @@
+/** A single tone in a sound pattern */
+export interface Tone {
+    /** Frequency in Hz */
+    frequency: number;
+    /** Duration in seconds */
+    duration: number;
+    /** Silence after this tone in seconds (optional) */
+    gap?: number;
+}
+/** A named sound pattern composed of tones */
+export interface Pattern {
+    name: string;
+    description: string;
+    tones: Tone[];
+}
+/** Supported playback methods */
+export type PlaybackMethod = 'auto' | 'powershell' | 'afplay' | 'aplay' | 'native';
+/** Config file shape */
+export interface VibeNotifyConfig {
+    /** Built-in pattern name, or "custom" for a custom file */
+    sound: string;
+    /** Absolute path to a .wav file (used when sound === "custom") */
+    customFile: string | null;
+    /** Volume 0.0–1.0 */
+    volume: number;
+    /** Playback settings */
+    playback: {
+        method: PlaybackMethod;
+    };
+}
+/** CLI action after parsing args */
+export type CliAction = {
+    action: 'help';
+} | {
+    action: 'list';
+} | {
+    action: 'config';
+} | {
+    action: 'init';
+} | {
+    action: 'version';
+} | {
+    action: 'play';
+    soundName?: string;
+};

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "vibe-notify",
+  "version": "0.1.0",
+  "description": "Notification sounds for Claude Code completions — customizable beeps when your session finishes",
+  "keywords": ["claude", "claude-code", "notification", "sound", "beep", "alert"],
+  "license": "MIT",
+  "author": "guant0u",
+  "repository": "github:GuanT0u/vibe-notify",
+  "homepage": "https://github.com/GuanT0u/vibe-notify#readme",
+  "main": "dist/index.js",
+  "bin": {
+    "vibe-notify": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "lint": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^18.19.0",
+    "typescript": "^5.3.0"
+  }
+}