web-audio-recorder-ts 1.0.0

package/LICENSE

@@ -0,0 +1,62 @@
+MIT License
+
+Copyright (c) 2024 web-audio-recorder-ts 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.
+
+---
+
+OGG Vorbis Encoder License (Xiph BSD License)
+
+Copyright (c) 2002-2020, Xiph.org Foundation
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+- Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+
+- Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+
+- Neither the name of the Xiph.org Foundation nor the names of its
+  contributors may be used to endorse or promote products derived from
+  this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION
+OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
+EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
+PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
+PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
+LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
+NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+
+---
+
+MP3 LAME Encoder License (LGPL)
+
+The LAME encoder library is licensed under the LGPL (Lesser General Public License).
+Please refer to the LAME project for full license details:
+<http://lame.sourceforge.net/>

package/README.md

@@ -0,0 +1,261 @@
+# web-audio-recorder-ts
+
+TypeScript port of [web-audio-recorder-js](https://github.com/higuma/web-audio-recorder-js) with full type support for WAV, OGG Vorbis, and MP3 audio recording in browsers.
+
+## Features
+
+- ✅ Full TypeScript support with type definitions
+- ✅ Record audio in WAV, OGG Vorbis, and MP3 formats
+- ✅ Modern ES modules, CommonJS, and UMD builds
+- ✅ Zero runtime dependencies
+- ✅ Works in browsers and Web Workers
+- ✅ Type-safe API with IntelliSense support
+
+## Installation
+
+```bash
+npm install web-audio-recorder-ts
+# or
+pnpm add web-audio-recorder-ts
+# or
+yarn add web-audio-recorder-ts
+```
+
+## Quick Start
+
+### WAV Recording
+
+```typescript
+import { WebAudioRecorderWav } from 'web-audio-recorder-ts';
+
+// Create audio context
+const audioContext = new AudioContext();
+
+// Get user media
+const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+
+// Create recorder
+const recorder = new WebAudioRecorderWav(audioContext);
+
+// Set up callbacks
+recorder.setOnComplete((event) => {
+  console.log('Recording complete!', event.url);
+  // event.blob contains the WAV file
+  // event.url is a blob URL for playback
+});
+
+recorder.setOnError((event) => {
+  console.error('Error:', event.message);
+});
+
+// Start recording
+await recorder.start(stream);
+
+// Stop recording (after some time)
+const blob = await recorder.stop();
+```
+
+### OGG Vorbis Recording
+
+```typescript
+import { WebAudioRecorderOgg, loadOggVorbisEncoder } from 'web-audio-recorder-ts';
+
+// Load encoder script first
+await loadOggVorbisEncoder('/path/to/OggVorbisEncoder.min.js');
+
+// Configure memory initializer path (if needed)
+if (typeof window !== 'undefined') {
+  (window as any).OggVorbisEncoderConfig = {
+    memoryInitializerPrefixURL: '/path/to/'
+  };
+}
+
+const audioContext = new AudioContext();
+const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+
+const recorder = new WebAudioRecorderOgg(
+  audioContext,
+  {},
+  { quality: 0.7 } // OGG quality: -0.1 to 1.0
+);
+
+await recorder.start(stream);
+const blob = await recorder.stop();
+```
+
+### MP3 Recording
+
+```typescript
+import { WebAudioRecorderMp3, loadMp3LameEncoder } from 'web-audio-recorder-ts';
+
+// Load encoder script first
+await loadMp3LameEncoder('/path/to/Mp3LameEncoder.min.js');
+
+// Configure memory initializer path (if needed)
+if (typeof window !== 'undefined') {
+  (window as any).Mp3LameEncoderConfig = {
+    memoryInitializerPrefixURL: '/path/to/'
+  };
+}
+
+const audioContext = new AudioContext();
+const stream = await navigator.mediaDevices.getUserMedia({ audio: true });
+
+const recorder = new WebAudioRecorderMp3(
+  audioContext,
+  {},
+  { bitrate: 192 } // MP3 bitrate in kbps
+);
+
+await recorder.start(stream);
+const blob = await recorder.stop();
+```
+
+## API Reference
+
+### WebAudioRecorder (Base Class)
+
+Base class for all recorders. Usually you'll use the specific format recorders instead.
+
+#### Constructor
+
+```typescript
+constructor(
+  audioContext: AudioContext,
+  encoder: AudioEncoder,
+  options?: RecorderOptions
+)
+```
+
+#### Methods
+
+- `start(stream: MediaStream): Promise<void>` - Start recording
+- `stop(mimeType?: string): Promise<Blob>` - Stop recording and get the audio blob
+- `cancel(): void` - Cancel current recording
+- `getStatus(): RecorderStatus` - Get current recorder status
+- `setOnDataAvailable(callback: DataAvailableCallback | null): void` - Set data available callback
+- `setOnComplete(callback: CompleteCallback | null): void` - Set completion callback
+- `setOnError(callback: ErrorCallback | null): void` - Set error callback
+- `cleanup(): void` - Clean up resources
+
+### WebAudioRecorderWav
+
+WAV format recorder. No external dependencies required.
+
+```typescript
+const recorder = new WebAudioRecorderWav(audioContext, options?);
+```
+
+### WebAudioRecorderOgg
+
+OGG Vorbis format recorder. Requires OggVorbisEncoder.min.js and .mem files.
+
+```typescript
+const recorder = new WebAudioRecorderOgg(
+  audioContext,
+  options?,
+  { quality?: number } // -0.1 to 1.0, default: 0.5
+);
+```
+
+### WebAudioRecorderMp3
+
+MP3 format recorder. Requires Mp3LameEncoder.min.js and .mem files.
+
+```typescript
+const recorder = new WebAudioRecorderMp3(
+  audioContext,
+  options?,
+  { bitrate?: number } // in kbps, default: 128
+);
+```
+
+### Types
+
+```typescript
+interface RecorderOptions {
+  sampleRate?: number;        // Default: audioContext.sampleRate
+  numChannels?: number;       // Default: 2 (stereo)
+  bufferSize?: number;         // Default: 4096
+  onDataAvailable?: (event: DataAvailableEvent) => void;
+  onComplete?: (event: CompleteEvent) => void;
+  onError?: (event: ErrorEvent) => void;
+}
+
+enum RecorderStatus {
+  INACTIVE = 'inactive',
+  RECORDING = 'recording',
+  PAUSED = 'paused',
+  PROCESSING = 'processing',
+  COMPLETE = 'complete',
+  ERROR = 'error'
+}
+```
+
+## Setup for OGG and MP3
+
+OGG and MP3 encoders require external JavaScript files compiled via Emscripten. You need to:
+
+1. Copy the encoder files to your project:
+   - `OggVorbisEncoder.min.js` and `OggVorbisEncoder.min.js.mem`
+   - `Mp3LameEncoder.min.js` and `Mp3LameEncoder.min.js.mem`
+
+2. These files are included in the `lib/` directory of this package.
+
+3. Load the encoder scripts before creating recorders:
+
+```typescript
+// For OGG
+await loadOggVorbisEncoder('/path/to/OggVorbisEncoder.min.js');
+
+// For MP3
+await loadMp3LameEncoder('/path/to/Mp3LameEncoder.min.js');
+```
+
+4. Configure memory initializer path if needed:
+
+```typescript
+// For OGG
+window.OggVorbisEncoderConfig = {
+  memoryInitializerPrefixURL: '/path/to/'
+};
+
+// For MP3
+window.Mp3LameEncoderConfig = {
+  memoryInitializerPrefixURL: '/path/to/'
+};
+```
+
+## Browser Support
+
+- Chrome/Edge: Full support
+- Firefox: Full support
+- Safari: Full support (may require user gesture for audio context)
+- Opera: Full support
+
+## License
+
+- TypeScript code: MIT License
+- OGG Vorbis encoder: Xiph BSD License
+- MP3 LAME encoder: LGPL License
+
+See LICENSE file for details.
+
+## Credits
+
+This is a TypeScript port of:
+- [web-audio-recorder-js](https://github.com/higuma/web-audio-recorder-js) by higuma
+- [ogg-vorbis-encoder-js](https://github.com/higuma/ogg-vorbis-encoder-js) by higuma
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## Changelog
+
+### 1.0.0
+
+- Initial TypeScript port
+- Full type definitions
+- Support for WAV, OGG, and MP3 formats
+- Modern build system with ESM, CJS, and UMD outputs

package/dist/core/WebAudioRecorder.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Classe base WebAudioRecorder para gravação de áudio
+ *
+ * @module core/WebAudioRecorder
+ */
+import { RecorderOptions, RecorderStatus, DataAvailableCallback, CompleteCallback, ErrorCallback, AudioEncoder } from './types';
+/**
+ * Classe principal para gravação de áudio usando Web Audio API
+ */
+export declare class WebAudioRecorder {
+    protected audioContext: AudioContext | null;
+    protected sourceNode: MediaStreamAudioSourceNode | null;
+    protected scriptProcessor: ScriptProcessorNode | null;
+    protected encoder: AudioEncoder | null;
+    protected stream: MediaStream | null;
+    protected status: RecorderStatus;
+    protected sampleRate: number;
+    protected numChannels: number;
+    protected bufferSize: number;
+    protected startTime: number;
+    protected onDataAvailableCallback: DataAvailableCallback | null;
+    protected onCompleteCallback: CompleteCallback | null;
+    protected onErrorCallback: ErrorCallback | null;
+    /**
+     * Cria uma instância do WebAudioRecorder
+     *
+     * @param audioContext - Contexto de áudio Web Audio API
+     * @param encoder - Encoder de áudio a ser usado
+     * @param options - Opções de configuração do recorder
+     */
+    constructor(audioContext: AudioContext, encoder: AudioEncoder, options?: RecorderOptions);
+    /**
+     * Inicia a gravação de áudio
+     *
+     * @param stream - Stream de mídia a ser gravado
+     * @returns Promise que resolve quando a gravação inicia
+     */
+    start(stream: MediaStream): Promise<void>;
+    /**
+     * Para a gravação e finaliza o arquivo de áudio
+     *
+     * @param mimeType - Tipo MIME do arquivo (padrão: baseado no encoder)
+     * @returns Promise que resolve com o Blob do áudio gravado
+     */
+    stop(mimeType?: string): Promise<Blob>;
+    /**
+     * Cancela a gravação atual
+     */
+    cancel(): void;
+    /**
+     * Obtém o status atual do recorder
+     *
+     * @returns Status atual
+     */
+    getStatus(): RecorderStatus;
+    /**
+     * Define callback para quando dados estão disponíveis
+     *
+     * @param callback - Função callback
+     */
+    setOnDataAvailable(callback: DataAvailableCallback | null): void;
+    /**
+     * Define callback para quando gravação é completada
+     *
+     * @param callback - Função callback
+     */
+    setOnComplete(callback: CompleteCallback | null): void;
+    /**
+     * Define callback para quando ocorre erro
+     *
+     * @param callback - Função callback
+     */
+    setOnError(callback: ErrorCallback | null): void;
+    /**
+     * Trata erros e chama callback de erro
+     *
+     * @param error - Erro ocorrido
+     */
+    protected handleError(error: Error): void;
+    /**
+     * Limpa recursos e reseta o recorder
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=WebAudioRecorder.d.ts.map

package/dist/core/WebAudioRecorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebAudioRecorder.d.ts","sourceRoot":"","sources":["../../src/core/WebAudioRecorder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,cAAc,EAId,qBAAqB,EACrB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACb,MAAM,SAAS,CAAC;AAEjB;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,SAAS,CAAC,YAAY,EAAE,YAAY,GAAG,IAAI,CAAQ;IACnD,SAAS,CAAC,UAAU,EAAE,0BAA0B,GAAG,IAAI,CAAQ;IAC/D,SAAS,CAAC,eAAe,EAAE,mBAAmB,GAAG,IAAI,CAAQ;IAC7D,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAQ;IAC9C,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;IAC5C,SAAS,CAAC,MAAM,EAAE,cAAc,CAA2B;IAC3D,SAAS,CAAC,UAAU,EAAE,MAAM,CAAS;IACrC,SAAS,CAAC,WAAW,EAAE,MAAM,CAAK;IAClC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAQ;IACpC,SAAS,CAAC,SAAS,EAAE,MAAM,CAAK;IAChC,SAAS,CAAC,uBAAuB,EAAE,qBAAqB,GAAG,IAAI,CAAQ;IACvE,SAAS,CAAC,kBAAkB,EAAE,gBAAgB,GAAG,IAAI,CAAQ;IAC7D,SAAS,CAAC,eAAe,EAAE,aAAa,GAAG,IAAI,CAAQ;IAEvD;;;;;;OAMG;gBAED,YAAY,EAAE,YAAY,EAC1B,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,eAAoB;IAY/B;;;;;OAKG;IACG,KAAK,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA+D/C;;;;;OAKG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4D5C;;OAEG;IACH,MAAM,IAAI,IAAI;IA+Bd;;;;OAIG;IACH,SAAS,IAAI,cAAc;IAI3B;;;;OAIG;IACH,kBAAkB,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GAAG,IAAI;IAIhE;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;IAItD;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI;IAIhD;;;;OAIG;IACH,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAWzC;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/core/types.d.ts

@@ -0,0 +1,109 @@
+/**
+ * Tipos e interfaces principais para WebAudioRecorder
+ */
+/**
+ * Formatos de áudio suportados
+ */
+export declare enum AudioFormat {
+    WAV = "wav",
+    OGG = "ogg",
+    MP3 = "mp3"
+}
+/**
+ * Status do recorder
+ */
+export declare enum RecorderStatus {
+    INACTIVE = "inactive",
+    RECORDING = "recording",
+    PAUSED = "paused",
+    PROCESSING = "processing",
+    COMPLETE = "complete",
+    ERROR = "error"
+}
+/**
+ * Opções de configuração do recorder
+ */
+export interface RecorderOptions {
+    /** Taxa de amostragem em Hz (padrão: 44100) */
+    sampleRate?: number;
+    /** Número de canais (1 = mono, 2 = estéreo, padrão: 2) */
+    numChannels?: number;
+    /** Tamanho do buffer em frames (padrão: 4096) */
+    bufferSize?: number;
+    /** Callback quando dados estão disponíveis */
+    onDataAvailable?: (event: DataAvailableEvent) => void;
+    /** Callback quando gravação é completada */
+    onComplete?: (event: CompleteEvent) => void;
+    /** Callback quando ocorre erro */
+    onError?: (event: ErrorEvent) => void;
+}
+/**
+ * Evento de dados disponíveis
+ */
+export interface DataAvailableEvent {
+    /** Dados de áudio como Blob */
+    data: Blob;
+    /** Timestamp do evento */
+    timecode: number;
+}
+/**
+ * Evento de gravação completa
+ */
+export interface CompleteEvent {
+    /** Blob final do áudio gravado */
+    blob: Blob;
+    /** URL do objeto para reprodução */
+    url: string;
+}
+/**
+ * Evento de erro
+ */
+export interface ErrorEvent {
+    /** Mensagem de erro */
+    message: string;
+    /** Erro original (se houver) */
+    error?: Error;
+}
+/**
+ * Interface para encoders de áudio
+ */
+export interface AudioEncoder {
+    /** Codificar buffers de áudio */
+    encode(buffers: Float32Array[]): void;
+    /** Finalizar encoding e obter Blob */
+    finish(mimeType?: string): Blob;
+    /** Cancelar encoding */
+    cancel(): void;
+}
+/**
+ * Configuração para encoder OGG Vorbis
+ */
+export interface OggVorbisOptions {
+    /** Qualidade Vorbis (-0.1 a 1.0, padrão: 0.5) */
+    quality?: number;
+}
+/**
+ * Configuração para encoder MP3
+ */
+export interface Mp3Options {
+    /** Bitrate em kbps (padrão: 128) */
+    bitrate?: number;
+}
+/**
+ * Configuração para encoder WAV
+ */
+export interface WavOptions {
+}
+/**
+ * Callback para eventos de dados
+ */
+export type DataAvailableCallback = (event: DataAvailableEvent) => void;
+/**
+ * Callback para eventos de conclusão
+ */
+export type CompleteCallback = (event: CompleteEvent) => void;
+/**
+ * Callback para eventos de erro
+ */
+export type ErrorCallback = (event: ErrorEvent) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,WAAW;IACrB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAED;;GAEG;AACH,oBAAY,cAAc;IACxB,QAAQ,aAAa;IACrB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,UAAU,eAAe;IACzB,QAAQ,aAAa;IACrB,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACtD,4CAA4C;IAC5C,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;IAC5C,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,IAAI,CAAC;IACX,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,iCAAiC;IACjC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IACtC,sCAAsC;IACtC,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,wBAAwB;IACxB,MAAM,IAAI,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;CAE1B;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;AAE9D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC"}

package/dist/encoders/Mp3LameEncoder.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Wrapper TypeScript para Mp3LameEncoder (Emscripten)
+ *
+ * @module encoders/Mp3LameEncoder
+ */
+import { AudioEncoder, Mp3Options } from '../core/types';
+/**
+ * Wrapper para o encoder MP3 LAME compilado via Emscripten
+ */
+export declare class Mp3LameEncoderWrapper implements AudioEncoder {
+    private encoder;
+    private sampleRate;
+    private numChannels;
+    private bitrate;
+    /**
+     * Cria uma instância do encoder MP3 LAME
+     *
+     * @param sampleRate - Taxa de amostragem em Hz
+     * @param numChannels - Número de canais
+     * @param options - Opções do encoder MP3
+     */
+    constructor(sampleRate: number, numChannels: number, options?: Mp3Options);
+    /**
+     * Codifica buffers de áudio
+     *
+     * @param buffers - Array de buffers Float32Array, um por canal
+     */
+    encode(buffers: Float32Array[]): void;
+    /**
+     * Finaliza o encoding e retorna o Blob MP3
+     *
+     * @param mimeType - Tipo MIME (padrão: 'audio/mpeg')
+     * @returns Blob contendo o arquivo MP3
+     */
+    finish(mimeType?: string): Blob;
+    /**
+     * Cancela o encoding
+     */
+    cancel(): void;
+}
+/**
+ * Função helper para carregar o script Mp3LameEncoder
+ *
+ * @param scriptUrl - URL do script Mp3LameEncoder.min.js
+ * @returns Promise que resolve quando o script é carregado
+ */
+export declare function loadMp3LameEncoder(scriptUrl: string): Promise<void>;
+//# sourceMappingURL=Mp3LameEncoder.d.ts.map

package/dist/encoders/Mp3LameEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Mp3LameEncoder.d.ts","sourceRoot":"","sources":["../../src/encoders/Mp3LameEncoder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAczD;;GAEG;AACH,qBAAa,qBAAsB,YAAW,YAAY;IACxD,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;OAMG;gBACS,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe;IAc7E;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAYrC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,GAAE,MAAqB,GAAG,IAAI;IAQ7C;;OAEG;IACH,MAAM,IAAI,IAAI;CAMf;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEnE"}

package/dist/encoders/OggVorbisEncoder.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Wrapper TypeScript para OggVorbisEncoder (Emscripten)
+ *
+ * @module encoders/OggVorbisEncoder
+ */
+import { AudioEncoder, OggVorbisOptions } from '../core/types';
+/**
+ * Wrapper para o encoder OGG Vorbis compilado via Emscripten
+ */
+export declare class OggVorbisEncoderWrapper implements AudioEncoder {
+    private encoder;
+    private sampleRate;
+    private numChannels;
+    private quality;
+    /**
+     * Cria uma instância do encoder OGG Vorbis
+     *
+     * @param sampleRate - Taxa de amostragem em Hz
+     * @param numChannels - Número de canais
+     * @param options - Opções do encoder OGG
+     */
+    constructor(sampleRate: number, numChannels: number, options?: OggVorbisOptions);
+    /**
+     * Codifica buffers de áudio
+     *
+     * @param buffers - Array de buffers Float32Array, um por canal
+     */
+    encode(buffers: Float32Array[]): void;
+    /**
+     * Finaliza o encoding e retorna o Blob OGG
+     *
+     * @param mimeType - Tipo MIME (padrão: 'audio/ogg')
+     * @returns Blob contendo o arquivo OGG
+     */
+    finish(mimeType?: string): Blob;
+    /**
+     * Cancela o encoding
+     */
+    cancel(): void;
+}
+/**
+ * Função helper para carregar o script OggVorbisEncoder
+ *
+ * @param scriptUrl - URL do script OggVorbisEncoder.min.js
+ * @returns Promise que resolve quando o script é carregado
+ */
+export declare function loadOggVorbisEncoder(scriptUrl: string): Promise<void>;
+//# sourceMappingURL=OggVorbisEncoder.d.ts.map

package/dist/encoders/OggVorbisEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OggVorbisEncoder.d.ts","sourceRoot":"","sources":["../../src/encoders/OggVorbisEncoder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAc/D;;GAEG;AACH,qBAAa,uBAAwB,YAAW,YAAY;IAC1D,OAAO,CAAC,OAAO,CAAyC;IACxD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IAExB;;;;;;OAMG;gBACS,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,gBAAqB;IAcnF;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IAYrC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,GAAE,MAAoB,GAAG,IAAI;IAQ5C;;OAEG;IACH,MAAM,IAAI,IAAI;CAMf;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqErE"}

package/dist/encoders/WavAudioEncoder.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Encoder WAV para áudio
+ *
+ * @module encoders/WavAudioEncoder
+ */
+import { AudioEncoder } from '../core/types';
+/**
+ * Encoder WAV simples que cria arquivos WAV a partir de buffers de áudio
+ */
+export declare class WavAudioEncoder implements AudioEncoder {
+    private sampleRate;
+    private numChannels;
+    private buffers;
+    /**
+     * Cria uma instância do encoder WAV
+     *
+     * @param sampleRate - Taxa de amostragem em Hz
+     * @param numChannels - Número de canais (1 = mono, 2 = estéreo)
+     */
+    constructor(sampleRate: number, numChannels: number);
+    /**
+     * Codifica buffers de áudio
+     *
+     * @param buffers - Array de buffers Float32Array, um por canal
+     */
+    encode(buffers: Float32Array[]): void;
+    /**
+     * Finaliza o encoding e retorna o Blob WAV
+     *
+     * @param mimeType - Tipo MIME (padrão: 'audio/wav')
+     * @returns Blob contendo o arquivo WAV
+     */
+    finish(mimeType?: string): Blob;
+    /**
+     * Cancela o encoding e limpa os buffers
+     */
+    cancel(): void;
+    /**
+     * Escreve string no DataView
+     *
+     * @param view - DataView
+     * @param offset - Offset inicial
+     * @param string - String a escrever
+     */
+    private writeString;
+}
+//# sourceMappingURL=WavAudioEncoder.d.ts.map

package/dist/encoders/WavAudioEncoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WavAudioEncoder.d.ts","sourceRoot":"","sources":["../../src/encoders/WavAudioEncoder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;GAEG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAwB;IAEvC;;;;;OAKG;gBACS,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAMnD;;;;OAIG;IACH,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI;IASrC;;;;;OAKG;IACH,MAAM,CAAC,QAAQ,GAAE,MAAoB,GAAG,IAAI;IA2F5C;;OAEG;IACH,MAAM,IAAI,IAAI;IAId;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;CAKpB"}