bionic-audio 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Bionic Audio Contributors
+
+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,274 @@
+# bionic-audio
+
+Professional Windows WASAPI audio recorder library for Node.js and Bun. Record microphone, system loopback, or both simultaneously with support for multiple audio formats and advanced quality settings.
+
+**Status:** Production Ready | **Platform:** Windows 10/11 | **Architecture:** x64, ia32
+
+## Features
+
+- 🎤 **Microphone Recording**: Capture input from your microphone
+- 🔊 **Loopback Recording**: Capture system audio (what's playing on speakers)
+- 🎙️ **Dual Recording**: Record both microphone and loopback simultaneously
+- 📊 **Multiple Formats**: 16-bit PCM, 24-bit PCM, or 32-bit float WAV files
+- ⏱️ **Duration Control**: Record for a specific duration or indefinitely
+- 🎛️ **Gain Control**: Amplify or reduce signal strength
+- 📡 **Stream to stdout**: Raw PCM streaming for real-time processing
+- 🧵 **Threaded Capture**: Dedicated thread for capture operations
+- 🔌 **Easy Integration**: EventEmitter-based interface with promise support
+
+## Installation
+
+```bash
+npm install bionic-audio
+```
+
+Or globally for CLI access:
+
+```bash
+npm install -g bionic-audio
+```
+
+## Requirements
+
+- Windows 10/11
+- Node.js 14+ or Bun
+- `recorder.exe` binary (included in package, or build from source)
+
+## Quick Start
+
+### Basic Recording
+
+```typescript
+import { recordToFile } from 'bionic-audio';
+
+// Simple file recording - 5 seconds of system audio
+await recordToFile('./output.wav', { duration: 5 });
+```
+
+### EventEmitter Interface
+
+```typescript
+import { AudioRecorder } from 'bionic-audio';
+
+const recorder = new AudioRecorder({
+  output: './recording.wav',
+  duration: 10,
+  preserve32: true  // 32-bit float format
+});
+
+recorder.on('started', () => console.log('🎤 Recording started'));
+recorder.on('data', (bytes) => console.log(`📝 Wrote ${bytes} bytes`));
+recorder.on('error', (err) => console.error('❌ Error:', err));
+recorder.on('complete', (result) => {
+  console.log('✅ Recording complete:', result);
+});
+
+recorder.start();
+
+// Stop manually (or wait for duration to finish)
+setTimeout(() => recorder.stop(), 5000);
+```
+
+### Promise-Based Interface
+
+```typescript
+import { AudioRecorder } from 'bionic-audio';
+
+const recorder = new AudioRecorder();
+
+try {
+  const result = await recorder.record({
+    duration: 5,
+    output: './output.wav'
+  });
+  
+  console.log(`✅ Recording finished with exit code ${result.code}`);
+} catch (error) {
+  console.error('❌ Recording failed:', error);
+}
+```
+
+### Convenience Functions
+
+```typescript
+import { 
+  recordToFile, 
+  recordMicrophone, 
+  recordLoopback, 
+  recordBoth 
+} from 'bionic-audio';
+
+// Record system audio (loopback) to file
+await recordToFile('./output.wav', { duration: 10 });
+
+// Record microphone only
+await recordMicrophone('./mic.wav', { duration: 10 });
+
+// Record system audio only
+await recordLoopback('./system.wav', { duration: 10 });
+
+// Record both simultaneously (two separate files)
+await recordBoth('./combined.wav', { duration: 10 });
+```
+
+### Streaming to stdout
+
+```typescript
+import { AudioRecorder } from 'bionic-audio';
+import { createWriteStream } from 'fs';
+
+const recorder = new AudioRecorder();
+const output = createWriteStream('./stream.wav');
+
+recorder.pipe(output);
+recorder.start({ duration: 5, pcmOnly: true });
+```
+
+## API Reference
+
+### `new AudioRecorder(options?)`
+
+Creates a new audio recorder instance.
+
+**Options:**
+- `output?: string` - Output file path (required for file recording)
+- `duration?: number` - Recording duration in seconds (0 = infinite, default: 0)
+- `gain?: number` - Signal gain/amplitude multiplier (default: 1.0)
+- `preserve24?: boolean` - Keep 24-bit native format (default: false)
+- `preserve32?: boolean` - Keep 32-bit float format (default: false)
+- `pcmOnly?: boolean` - Output raw PCM without WAV header (default: false)
+- `loopback?: boolean` - Record system audio instead of microphone (default: false)
+- `microphone?: boolean` - Record microphone (default: true)
+- `both?: boolean` - Record both simultaneously (default: false)
+- `threaded?: boolean` - Use dedicated capture thread (default: false)
+
+### Methods
+
+#### `start(options?): void`
+Starts recording with optional runtime options.
+
+#### `stop(): boolean`
+Stops the recording process. Returns true if stopped, false if not running.
+
+#### `isRecording(): boolean`
+Check if currently recording.
+
+#### `record(options?): Promise<RecorderResult>`
+Promise-based recording. Blocks until recording completes or errors.
+
+```typescript
+const result = await recorder.record({ duration: 5 });
+// result: { code: number, signal: string | null, stderr: string }
+```
+
+#### `pipe(destination: NodeJS.WritableStream): void`
+Pipe raw audio data to a writable stream (e.g., for real-time processing).
+
+#### `getProcess(): ChildProcess | null`
+Access the underlying child process directly.
+
+### Events
+
+- `started` - Recording has started
+- `data(bytes: number)` - Data written (number of bytes)
+- `stderr(data: string)` - Stderr output from recorder
+- `exit(code: number, signal: string | null)` - Process exited
+- `complete(result: RecorderResult)` - Recording completed successfully
+- `error(error: Error)` - Error occurred
+
+### Convenience Functions
+
+#### `recordToFile(path: string, options?: RecorderOptions): Promise<RecorderResult>`
+Quick file recording.
+
+#### `recordMicrophone(path: string, options?: RecorderOptions): Promise<RecorderResult>`
+Record microphone only.
+
+#### `recordLoopback(path: string, options?: RecorderOptions): Promise<RecorderResult>`
+Record system audio only.
+
+#### `recordBoth(path: string, options?: RecorderOptions): Promise<RecorderResult>`
+Record both microphone and loopback simultaneously.
+
+## Configuration
+
+### Audio Quality
+
+- **16-bit PCM** (default): Balanced quality and file size, ~1.5 MB/min for stereo at 48kHz
+- **24-bit PCM** (`preserve24: true`): Higher quality, ~2.3 MB/min
+- **32-bit float** (`preserve32: true`): Highest quality, lossless internal format, ~3 MB/min
+
+### Gain Control
+
+```typescript
+// Amplify by 2x
+recorder.start({ gain: 2.0 });
+
+// Reduce by half
+recorder.start({ gain: 0.5 });
+```
+
+Gain is applied before clipping to prevent distortion.
+
+## Electron Integration
+
+```typescript
+import { AudioRecorder } from 'bionic-audio';
+import { ipcMain } from 'electron';
+
+let recorder: AudioRecorder | null = null;
+
+ipcMain.handle('start-recording', async (event, options) => {
+  recorder = new AudioRecorder(options);
+  
+  recorder.on('error', (err) => {
+    event.sender.send('recording-error', err.message);
+  });
+  
+  recorder.start();
+  return { ok: true };
+});
+
+ipcMain.handle('stop-recording', async () => {
+  recorder?.stop();
+  return { ok: true };
+});
+```
+
+## Building from Source
+
+```bash
+# Install dependencies
+npm install
+
+# Compile TypeScript
+npm run build
+
+# Build C++ recorder binary (requires MinGW or MSVC)
+gcc -o recorder.exe main.c -lole32 -std=c99
+```
+
+## Troubleshooting
+
+### "recorder.exe not found"
+Ensure the binary is in PATH or in one of these locations:
+- `./recorder.exe`
+- `./bin/recorder.exe`
+- `../recorder.exe`
+- `./dist/recorder.exe`
+
+### Distorted/Noisy Audio
+Try enabling gain control with values < 1.0:
+```typescript
+recorder.start({ gain: 0.8 });
+```
+
+### File Won't Play
+Ensure you're using a compatible audio player. 32-bit float WAV support varies. Try 16-bit output:
+```typescript
+recorder.start({ preserve32: false });
+```
+
+## License
+
+MIT

package/dist/AudioRecorder.d.ts

@@ -0,0 +1,96 @@
+import { ChildProcess } from 'child_process';
+import { EventEmitter } from 'events';
+export interface RecorderOptions {
+    /** Duration in seconds (0 = infinite) */
+    duration?: number;
+    /** Output file path or '-' for stdout */
+    output?: string;
+    /** PCM only (no WAV header) */
+    pcmOnly?: boolean;
+    /** Record loopback (system audio) */
+    loopback?: boolean;
+    /** Record microphone */
+    mic?: boolean;
+    /** Record both loopback and microphone simultaneously */
+    both?: boolean;
+    /** Gain multiplier (default 1.0) */
+    gain?: number;
+    /** Preserve 24-bit if available */
+    preserve24?: boolean;
+    /** Preserve 32-bit float (highest quality) */
+    preserve32?: boolean;
+    /** Run capture in dedicated thread */
+    threaded?: boolean;
+    /** Path to recorder.exe (default: auto-detect) */
+    recorderPath?: string;
+}
+export interface RecorderResult {
+    code: number;
+    signal: string | null;
+    stderr: string;
+}
+/**
+ * AudioRecorder - wrapper for Windows WASAPI recorder
+ *
+ * Usage:
+ *   const rec = new AudioRecorder({ output: 'session.wav', duration: 10, gain: 1.5 });
+ *   rec.start();
+ *   rec.on('complete', (result) => console.log('Done!'));
+ *   rec.on('error', (err) => console.error(err));
+ *
+ *   // or stop manually:
+ *   setTimeout(() => rec.stop(), 5000);
+ */
+export declare class AudioRecorder extends EventEmitter {
+    private process;
+    private options;
+    private recorderExePath;
+    private stderrBuffer;
+    constructor(options?: RecorderOptions);
+    private findRecorderExe;
+    /**
+     * Build command-line arguments based on options
+     */
+    private buildArgs;
+    /**
+     * Start recording
+     */
+    start(): void;
+    /**
+     * Stop recording
+     */
+    stop(): boolean;
+    /**
+     * Check if recording is active
+     */
+    isRecording(): boolean;
+    /**
+     * Get the underlying child process (for advanced usage)
+     */
+    getProcess(): ChildProcess | null;
+    /**
+     * Promise-based interface
+     */
+    record(): Promise<RecorderResult>;
+    /**
+     * Stream data to a file or another stream
+     */
+    pipe(destination: NodeJS.WritableStream): void;
+}
+/**
+ * Convenience function: record to file
+ */
+export declare function recordToFile(output: string, durationSeconds?: number, options?: Partial<RecorderOptions>): Promise<RecorderResult>;
+/**
+ * Convenience function: record microphone
+ */
+export declare function recordMicrophone(output: string, durationSeconds?: number, gain?: number): Promise<RecorderResult>;
+/**
+ * Convenience function: record system audio
+ */
+export declare function recordLoopback(output: string, durationSeconds?: number, gain?: number): Promise<RecorderResult>;
+/**
+ * Convenience function: record both
+ */
+export declare function recordBoth(output: string, durationSeconds?: number, gain?: number): Promise<RecorderResult>;
+//# sourceMappingURL=AudioRecorder.d.ts.map

package/dist/AudioRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioRecorder.d.ts","sourceRoot":"","sources":["../lib/AudioRecorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,YAAY,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,qCAAqC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wBAAwB;IACxB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,yDAAyD;IACzD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,8CAA8C;IAC9C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,YAAY,CAAc;gBAEtB,OAAO,GAAE,eAAoB;IAoBzC,OAAO,CAAC,eAAe;IAuBvB;;OAEG;IACH,OAAO,CAAC,SAAS;IA0CjB;;OAEG;IACI,KAAK,IAAI,IAAI;IAkDpB;;OAEG;IACI,IAAI,IAAI,OAAO;IAQtB;;OAEG;IACI,WAAW,IAAI,OAAO;IAI7B;;OAEG;IACI,UAAU,IAAI,YAAY,GAAG,IAAI;IAIxC;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;IAQ9C;;OAEG;IACI,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI;CAStD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,MAAW,EAC5B,OAAO,GAAE,OAAO,CAAC,eAAe,CAAM,GACrC,OAAO,CAAC,cAAc,CAAC,CAOzB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,MAAW,EAC5B,IAAI,GAAE,MAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,MAAW,EAC5B,IAAI,GAAE,MAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,eAAe,GAAE,MAAW,EAC5B,IAAI,GAAE,MAAY,GACjB,OAAO,CAAC,cAAc,CAAC,CAEzB"}

package/dist/AudioRecorder.js

@@ -0,0 +1,256 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AudioRecorder = void 0;
+exports.recordToFile = recordToFile;
+exports.recordMicrophone = recordMicrophone;
+exports.recordLoopback = recordLoopback;
+exports.recordBoth = recordBoth;
+const child_process_1 = require("child_process");
+const events_1 = require("events");
+const path = __importStar(require("path"));
+/**
+ * AudioRecorder - wrapper for Windows WASAPI recorder
+ *
+ * Usage:
+ *   const rec = new AudioRecorder({ output: 'session.wav', duration: 10, gain: 1.5 });
+ *   rec.start();
+ *   rec.on('complete', (result) => console.log('Done!'));
+ *   rec.on('error', (err) => console.error(err));
+ *
+ *   // or stop manually:
+ *   setTimeout(() => rec.stop(), 5000);
+ */
+class AudioRecorder extends events_1.EventEmitter {
+    constructor(options = {}) {
+        super();
+        this.process = null;
+        this.stderrBuffer = '';
+        this.options = {
+            duration: options.duration ?? 10,
+            output: options.output ?? 'recording.wav',
+            pcmOnly: options.pcmOnly ?? false,
+            loopback: !options.mic && !options.both,
+            mic: options.mic ?? false,
+            both: options.both ?? false,
+            gain: options.gain ?? 1.0,
+            preserve24: options.preserve24 ?? false,
+            preserve32: options.preserve32 ?? false,
+            threaded: options.threaded ?? false,
+            ...options,
+        };
+        // Try to find recorder.exe
+        this.recorderExePath = options.recorderPath || this.findRecorderExe();
+    }
+    findRecorderExe() {
+        // Common locations
+        const candidates = [
+            path.join(__dirname, '..', 'bin', 'recorder.exe'),
+            path.join(__dirname, 'recorder.exe'),
+            path.join(process.cwd(), 'recorder.exe'),
+            'd:\\recorder\\recorder.exe',
+            'recorder.exe', // rely on PATH
+        ];
+        for (const candidate of candidates) {
+            try {
+                require('fs').accessSync(candidate);
+                return candidate;
+            }
+            catch {
+                //
+            }
+        }
+        // Default fallback
+        return 'recorder.exe';
+    }
+    /**
+     * Build command-line arguments based on options
+     */
+    buildArgs() {
+        const args = [];
+        if (this.options.duration !== undefined && this.options.duration >= 0) {
+            args.push('-d', String(this.options.duration));
+        }
+        if (this.options.output) {
+            args.push('-o', this.options.output);
+        }
+        if (this.options.pcmOnly) {
+            args.push('-p');
+        }
+        if (this.options.both) {
+            args.push('-b');
+        }
+        else if (this.options.mic) {
+            args.push('-m');
+        }
+        else if (this.options.loopback) {
+            args.push('-l');
+        }
+        if (this.options.threaded) {
+            args.push('-t');
+        }
+        if (this.options.gain && this.options.gain !== 1.0) {
+            args.push('-g', String(this.options.gain));
+        }
+        if (this.options.preserve24) {
+            args.push('-24');
+        }
+        if (this.options.preserve32) {
+            args.push('-32');
+        }
+        return args;
+    }
+    /**
+     * Start recording
+     */
+    start() {
+        if (this.process) {
+            throw new Error('Recording already in progress');
+        }
+        const args = this.buildArgs();
+        this.stderrBuffer = '';
+        this.process = (0, child_process_1.spawn)(this.recorderExePath, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        // Capture stderr for diagnostics
+        this.process.stderr.on('data', (data) => {
+            const chunk = data.toString();
+            this.stderrBuffer += chunk;
+            this.emit('stderr', chunk);
+        });
+        // If output is stdout, emit data
+        if (this.options.output === '-') {
+            this.process.stdout.on('data', (data) => {
+                this.emit('data', data);
+            });
+        }
+        this.process.on('error', (err) => {
+            this.process = null;
+            this.emit('error', err);
+        });
+        this.process.on('exit', (code, signal) => {
+            this.process = null;
+            const result = {
+                code: code ?? -1,
+                signal,
+                stderr: this.stderrBuffer,
+            };
+            this.emit('exit', result);
+            if (code === 0) {
+                this.emit('complete', result);
+            }
+            else {
+                this.emit('error', new Error(`recorder exited with code ${code}`));
+            }
+        });
+        this.emit('started');
+    }
+    /**
+     * Stop recording
+     */
+    stop() {
+        if (!this.process) {
+            return false;
+        }
+        this.process.kill('SIGTERM');
+        return true;
+    }
+    /**
+     * Check if recording is active
+     */
+    isRecording() {
+        return this.process !== null && !this.process.killed;
+    }
+    /**
+     * Get the underlying child process (for advanced usage)
+     */
+    getProcess() {
+        return this.process;
+    }
+    /**
+     * Promise-based interface
+     */
+    async record() {
+        return new Promise((resolve, reject) => {
+            this.once('complete', resolve);
+            this.once('error', reject);
+            this.start();
+        });
+    }
+    /**
+     * Stream data to a file or another stream
+     */
+    pipe(destination) {
+        if (!this.isRecording() || this.options.output !== '-') {
+            throw new Error('Must start recording with output="-" to pipe data');
+        }
+        const proc = this.getProcess();
+        if (proc?.stdout) {
+            proc.stdout.pipe(destination);
+        }
+    }
+}
+exports.AudioRecorder = AudioRecorder;
+/**
+ * Convenience function: record to file
+ */
+async function recordToFile(output, durationSeconds = 10, options = {}) {
+    const recorder = new AudioRecorder({
+        output,
+        duration: durationSeconds,
+        ...options,
+    });
+    return recorder.record();
+}
+/**
+ * Convenience function: record microphone
+ */
+async function recordMicrophone(output, durationSeconds = 10, gain = 1.0) {
+    return recordToFile(output, durationSeconds, { mic: true, gain });
+}
+/**
+ * Convenience function: record system audio
+ */
+async function recordLoopback(output, durationSeconds = 10, gain = 1.0) {
+    return recordToFile(output, durationSeconds, { loopback: true, gain });
+}
+/**
+ * Convenience function: record both
+ */
+async function recordBoth(output, durationSeconds = 10, gain = 1.0) {
+    return recordToFile(output, durationSeconds, { both: true, gain });
+}
+//# sourceMappingURL=AudioRecorder.js.map

package/dist/AudioRecorder.js.map

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

package/lib/AudioRecorder.ts

@@ -0,0 +1,292 @@
+import { spawn, ChildProcess } from 'child_process';
+import { EventEmitter } from 'events';
+import * as path from 'path';
+
+export interface RecorderOptions {
+  /** Duration in seconds (0 = infinite) */
+  duration?: number;
+  /** Output file path or '-' for stdout */
+  output?: string;
+  /** PCM only (no WAV header) */
+  pcmOnly?: boolean;
+  /** Record loopback (system audio) */
+  loopback?: boolean;
+  /** Record microphone */
+  mic?: boolean;
+  /** Record both loopback and microphone simultaneously */
+  both?: boolean;
+  /** Gain multiplier (default 1.0) */
+  gain?: number;
+  /** Preserve 24-bit if available */
+  preserve24?: boolean;
+  /** Preserve 32-bit float (highest quality) */
+  preserve32?: boolean;
+  /** Run capture in dedicated thread */
+  threaded?: boolean;
+  /** Path to recorder.exe (default: auto-detect) */
+  recorderPath?: string;
+}
+
+export interface RecorderResult {
+  code: number;
+  signal: string | null;
+  stderr: string;
+}
+
+/**
+ * AudioRecorder - wrapper for Windows WASAPI recorder
+ *
+ * Usage:
+ *   const rec = new AudioRecorder({ output: 'session.wav', duration: 10, gain: 1.5 });
+ *   rec.start();
+ *   rec.on('complete', (result) => console.log('Done!'));
+ *   rec.on('error', (err) => console.error(err));
+ *
+ *   // or stop manually:
+ *   setTimeout(() => rec.stop(), 5000);
+ */
+export class AudioRecorder extends EventEmitter {
+  private process: ChildProcess | null = null;
+  private options: RecorderOptions;
+  private recorderExePath: string;
+  private stderrBuffer: string = '';
+
+  constructor(options: RecorderOptions = {}) {
+    super();
+    this.options = {
+      duration: options.duration ?? 10,
+      output: options.output ?? 'recording.wav',
+      pcmOnly: options.pcmOnly ?? false,
+      loopback: !options.mic && !options.both,
+      mic: options.mic ?? false,
+      both: options.both ?? false,
+      gain: options.gain ?? 1.0,
+      preserve24: options.preserve24 ?? false,
+      preserve32: options.preserve32 ?? false,
+      threaded: options.threaded ?? false,
+      ...options,
+    };
+
+    // Try to find recorder.exe
+    this.recorderExePath = options.recorderPath || this.findRecorderExe();
+  }
+
+  private findRecorderExe(): string {
+    // Common locations
+    const candidates = [
+      path.join(__dirname, '..', 'bin', 'recorder.exe'),
+      path.join(__dirname, 'recorder.exe'),
+      path.join(process.cwd(), 'recorder.exe'),
+      'd:\\recorder\\recorder.exe',
+      'recorder.exe', // rely on PATH
+    ];
+
+    for (const candidate of candidates) {
+      try {
+        require('fs').accessSync(candidate);
+        return candidate;
+      } catch {
+        //
+      }
+    }
+
+    // Default fallback
+    return 'recorder.exe';
+  }
+
+  /**
+   * Build command-line arguments based on options
+   */
+  private buildArgs(): string[] {
+    const args: string[] = [];
+
+    if (this.options.duration !== undefined && this.options.duration >= 0) {
+      args.push('-d', String(this.options.duration));
+    }
+
+    if (this.options.output) {
+      args.push('-o', this.options.output);
+    }
+
+    if (this.options.pcmOnly) {
+      args.push('-p');
+    }
+
+    if (this.options.both) {
+      args.push('-b');
+    } else if (this.options.mic) {
+      args.push('-m');
+    } else if (this.options.loopback) {
+      args.push('-l');
+    }
+
+    if (this.options.threaded) {
+      args.push('-t');
+    }
+
+    if (this.options.gain && this.options.gain !== 1.0) {
+      args.push('-g', String(this.options.gain));
+    }
+
+    if (this.options.preserve24) {
+      args.push('-24');
+    }
+
+    if (this.options.preserve32) {
+      args.push('-32');
+    }
+
+    return args;
+  }
+
+  /**
+   * Start recording
+   */
+  public start(): void {
+    if (this.process) {
+      throw new Error('Recording already in progress');
+    }
+
+    const args = this.buildArgs();
+    this.stderrBuffer = '';
+
+    this.process = spawn(this.recorderExePath, args, {
+      stdio: ['ignore', 'pipe', 'pipe'],
+      windowsHide: true,
+    });
+
+    // Capture stderr for diagnostics
+    this.process.stderr!.on('data', (data) => {
+      const chunk = data.toString();
+      this.stderrBuffer += chunk;
+      this.emit('stderr', chunk);
+    });
+
+    // If output is stdout, emit data
+    if (this.options.output === '-') {
+      this.process.stdout!.on('data', (data) => {
+        this.emit('data', data);
+      });
+    }
+
+    this.process.on('error', (err) => {
+      this.process = null;
+      this.emit('error', err);
+    });
+
+    this.process.on('exit', (code, signal) => {
+      this.process = null;
+      const result: RecorderResult = {
+        code: code ?? -1,
+        signal,
+        stderr: this.stderrBuffer,
+      };
+      this.emit('exit', result);
+      if (code === 0) {
+        this.emit('complete', result);
+      } else {
+        this.emit('error', new Error(`recorder exited with code ${code}`));
+      }
+    });
+
+    this.emit('started');
+  }
+
+  /**
+   * Stop recording
+   */
+  public stop(): boolean {
+    if (!this.process) {
+      return false;
+    }
+    this.process.kill('SIGTERM');
+    return true;
+  }
+
+  /**
+   * Check if recording is active
+   */
+  public isRecording(): boolean {
+    return this.process !== null && !this.process.killed;
+  }
+
+  /**
+   * Get the underlying child process (for advanced usage)
+   */
+  public getProcess(): ChildProcess | null {
+    return this.process;
+  }
+
+  /**
+   * Promise-based interface
+   */
+  public async record(): Promise<RecorderResult> {
+    return new Promise((resolve, reject) => {
+      this.once('complete', resolve);
+      this.once('error', reject);
+      this.start();
+    });
+  }
+
+  /**
+   * Stream data to a file or another stream
+   */
+  public pipe(destination: NodeJS.WritableStream): void {
+    if (!this.isRecording() || this.options.output !== '-') {
+      throw new Error('Must start recording with output="-" to pipe data');
+    }
+    const proc = this.getProcess();
+    if (proc?.stdout) {
+      proc.stdout.pipe(destination);
+    }
+  }
+}
+
+/**
+ * Convenience function: record to file
+ */
+export async function recordToFile(
+  output: string,
+  durationSeconds: number = 10,
+  options: Partial<RecorderOptions> = {}
+): Promise<RecorderResult> {
+  const recorder = new AudioRecorder({
+    output,
+    duration: durationSeconds,
+    ...options,
+  });
+  return recorder.record();
+}
+
+/**
+ * Convenience function: record microphone
+ */
+export async function recordMicrophone(
+  output: string,
+  durationSeconds: number = 10,
+  gain: number = 1.0
+): Promise<RecorderResult> {
+  return recordToFile(output, durationSeconds, { mic: true, gain });
+}
+
+/**
+ * Convenience function: record system audio
+ */
+export async function recordLoopback(
+  output: string,
+  durationSeconds: number = 10,
+  gain: number = 1.0
+): Promise<RecorderResult> {
+  return recordToFile(output, durationSeconds, { loopback: true, gain });
+}
+
+/**
+ * Convenience function: record both
+ */
+export async function recordBoth(
+  output: string,
+  durationSeconds: number = 10,
+  gain: number = 1.0
+): Promise<RecorderResult> {
+  return recordToFile(output, durationSeconds, { both: true, gain });
+}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "bionic-audio",
+  "version": "1.0.0",
+  "description": "Professional Windows WASAPI audio recorder library for Node.js and Bun - record microphone and system audio with advanced features",
+  "main": "dist/AudioRecorder.js",
+  "types": "dist/AudioRecorder.d.ts",
+  "bin": {
+    "bionic-audio": "./recorder.exe"
+  },
+  "files": [
+    "dist/",
+    "recorder.exe",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "audio",
+    "recording",
+    "WASAPI",
+    "windows",
+    "loopback",
+    "microphone",
+    "audio-recording",
+    "system-audio",
+    "capture",
+    "wav",
+    "stereo",
+    "nodejs",
+    "bun",
+    "bionic"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": ""
+  },
+  "bugs": {
+    "url": ""
+  },
+  "homepage": "",
+  "engines": {
+    "node": ">=14.0.0",
+    "npm": ">=6.0.0"
+  },
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "ia32"
+  ],
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
+  }
+}