Rename to encode-audio

Author: dy

README.md

@@ -4,10 +4,10 @@ Encode raw audio samples to any format.<br>
 JS / WASM – no ffmpeg, no native bindings, works in both node and browser.<br>
 Small API, minimal size, near-native performance, stream encoding.
 
-[![npm install audio-encode](https://nodei.co/npm/audio-encode.png?mini=true)](https://npmjs.org/package/audio-encode/)
+[![npm install encode-audio](https://nodei.co/npm/encode-audio.png?mini=true)](https://npmjs.org/package/encode-audio/)
 
 ```js
-import encode from 'audio-encode';
+import encode from 'encode-audio';
 
 const buf = await encode.wav(channelData, { sampleRate: 44100 });
 ```
@@ -16,19 +16,19 @@ const buf = await encode.wav(channelData, { sampleRate: 44100 });
 
 | Format | Package | Engine |
 |--------|---------|--------|
-| WAV | [@audio/wav-encode](https://github.com/audiojs/wav-encode) | JS |
-| MP3 | [@audio/mp3-encode](https://github.com/audiojs/mp3-encode) | WASM |
-| OGG Vorbis | [@audio/ogg-encode](https://github.com/audiojs/ogg-encode) | WASM |
-| Opus | [@audio/opus-encode](https://github.com/audiojs/opus-encode) | WASM |
-| FLAC | [@audio/flac-encode](https://github.com/audiojs/flac-encode) | WASM |
-| AIFF | [@audio/aiff-encode](https://github.com/audiojs/aiff-encode) | JS |
+| WAV | [@audio/wav-encode](https://npmjs.com/package/@audio/wav-encode) | JS |
+| MP3 | [@audio/mp3-encode](https://npmjs.com/package/@audio/mp3-encode) | WASM |
+| OGG Vorbis | [@audio/ogg-encode](https://npmjs.com/package/@audio/ogg-encode) | WASM |
+| Opus | [@audio/opus-encode](https://npmjs.com/package/@audio/opus-encode) | WASM |
+| FLAC | [@audio/flac-encode](https://npmjs.com/package/@audio/flac-encode) | WASM |
+| AIFF | [@audio/aiff-encode](https://npmjs.com/package/@audio/aiff-encode) | JS |
 
 ### Whole-file encode
 
-Specify the format as method name. Input is _Float32Array[]_ (one per channel) or a single _Float32Array_ (mono).
+Specify the format as method name. Input is _Float32Array[]_ (one per channel), a single _Float32Array_ (mono), or an [AudioBuffer](https://npmjs.com/package/audio-buffer).
 
 ```js
-import encode from 'audio-encode';
+import encode from 'encode-audio';
 
 const wav  = await encode.wav(channelData, { sampleRate: 44100 });
 const aiff = await encode.aiff(channelData, { sampleRate: 44100 });
@@ -43,7 +43,7 @@ const opus = await encode.opus(channelData, { sampleRate: 48000, bitrate: 96 });
 For chunk-by-chunk encoding, use `.stream()`:
 
 ```js
-import encode from 'audio-encode';
+import encode from 'encode-audio';
 
 const encoder = await encode.mp3.stream({ sampleRate: 44100, bitrate: 128 });
 
@@ -72,7 +72,7 @@ const c = await encoder.encode();        // end of stream — flush + free
 The `encode` registry is extensible:
 
 ```js
-import encode from 'audio-encode';
+import encode from 'encode-audio';
 encode.myformat = Object.assign(
   async (data, opts) => { /* ... */ },
   { stream: async (opts) => ({ encode: chunk => ..., free() {} }) }
@@ -82,9 +82,8 @@ encode.myformat = Object.assign(
 ## See also
 
 * [audio-decode](https://github.com/audiojs/audio-decode) – decode any audio format to raw samples.
-* [wasm-media-encoders](https://github.com/nicodemus26/wasm-media-encoders) – compact WASM MP3 & Vorbis encoders.
+* [wasm-media-encoders](https://github.com/arseneyr/wasm-media-encoders) – compact WASM MP3 & Vorbis encoders.
 * [AudioEncoder](https://developer.mozilla.org/en-US/docs/Web/API/AudioEncoder) – native WebCodecs encoder API.
-* [ffmpeg.wasm](https://github.com/ffmpegwasm/ffmpeg.wasm) – full encoding/decoding library.
 
 ## License
 

audio-encode.js

@@ -1,6 +1,6 @@
 /**
  * Audio encoder: whole-file and streaming
- * @module audio-encode
+ * @module encode-audio
  *
  * let buf = await encode.wav(channelData, { sampleRate: 44100 })
  *
@@ -59,6 +59,12 @@ function channels(data) {
 		return []
 	}
 	if (data instanceof Float32Array) return [data]
+	// AudioBuffer or AudioBuffer-like ({ numberOfChannels, getChannelData })
+	if (data.getChannelData && data.numberOfChannels) {
+		let ch = []
+		for (let i = 0; i < data.numberOfChannels; i++) ch.push(data.getChannelData(i))
+		return ch
+	}
 	return []
 }
 
@@ -118,5 +124,3 @@ function merge(a, b) {
 	return out
 }
 
-export { fmt, channels, norm, merge }
-

package-lock.json

@@ -1,5 +1,5 @@
 {
-  "name": "audio-encode",
+  "name": "encode-audio",
   "version": "1.0.0",
   "description": "Encode audio data in node or browser",
   "type": "module",
@@ -59,6 +59,7 @@
     "@audio/wav-encode": "^1.0.0"
   },
   "devDependencies": {
+    "audio-buffer": "^7.3.0",
     "audio-decode": "^4.0.0",
     "audio-lena": "^3.0.0",
     "tst": "^9.2.2"

package.json

@@ -1,83 +1,26 @@
 import t, { is, ok, almost } from 'tst'
-import encode, { streamEncoder, fmt, channels, norm, merge } from './audio-encode.js'
+import encode from './audio-encode.js'
 import decode from 'audio-decode'
-// --- test utilities ---
-
-function sine(sampleRate = 44100, freq = 440, duration = 1) {
-	let n = sampleRate * duration
-	let data = new Float32Array(n)
-	for (let i = 0; i < n; i++) data[i] = Math.sin(2 * Math.PI * freq * i / sampleRate)
-	return [data]
-}
+import AudioBuffer from 'audio-buffer'
 
 function rms(arr) {
 	let sum = 0
 	for (let i = 0; i < arr.length; i++) sum += arr[i] * arr[i]
 	return Math.sqrt(sum / arr.length)
 }
 
-// decode lena wav to get reference audio
+function sine(sr = 44100, freq = 440, dur = 1) {
+	let n = sr * dur, d = new Float32Array(n)
+	for (let i = 0; i < n; i++) d[i] = Math.sin(2 * Math.PI * freq * i / sr)
+	return [d]
+}
+
 let lenaPCM
 async function getLena() {
-	if (!lenaPCM) {
-		let wav = (await import('audio-lena/wav')).default
-		lenaPCM = await decode(wav)
-	}
+	if (!lenaPCM) lenaPCM = await decode((await import('audio-lena/wav')).default)
 	return lenaPCM
 }
 
-// --- core helpers ---
-
-t('channels', () => {
-	let mono = new Float32Array([1, 2, 3])
-	let stereo = [new Float32Array([1, 2]), new Float32Array([3, 4])]
-	is(channels(null).length, 0)
-	is(channels(undefined).length, 0)
-	is(channels([]).length, 0)
-	is(channels(mono).length, 1)
-	is(channels(mono)[0], mono)
-	is(channels(stereo).length, 2)
-})
-
-t('norm', () => {
-	is(norm(null).length, 0)
-	let buf = new Uint8Array([1, 2, 3])
-	is(norm(buf), buf)
-	ok(norm(new Int8Array([1, 2])) instanceof Uint8Array)
-})
-
-t('merge', () => {
-	let a = new Uint8Array([1, 2]), b = new Uint8Array([3, 4])
-	is(merge(a, b).length, 4)
-	is(merge(a, null), a)
-	is(merge(null, b), b)
-})
-
-t('streamEncoder', async () => {
-	let enc = streamEncoder(
-		ch => new Uint8Array([ch[0].length]),
-		() => new Uint8Array([0xFF]),
-		() => {}
-	)
-	let r1 = await enc.encode([new Float32Array([1, 2, 3])])
-	is(r1[0], 3)
-	let r2 = await enc.encode()
-	is(r2[0], 0xFF)
-	is((await enc.encode()).length, 0)
-})
-
-t('fmt', async () => {
-	let encoder = fmt(async (opts) => streamEncoder(
-		ch => new Uint8Array(ch[0].length * 2),
-		() => new Uint8Array([0xFE]),
-		() => {}
-	))
-	is(typeof encoder, 'function')
-	is(typeof encoder.stream, 'function')
-	let result = await encoder([new Float32Array(100)], { sampleRate: 44100 })
-	is(result.length, 201)
-})
-
 // --- format round-trip tests with lena ---
 
 t('wav round-trip (lena)', async () => {
@@ -144,3 +87,14 @@ t('wav streaming', async () => {
 	let final = await enc.encode()
 	ok(c1.length > 0 || c2.length > 0 || final.length > 0)
 })
+
+t('AudioBuffer input', async () => {
+	let ab = new AudioBuffer({ sampleRate: 44100, length: 44100 })
+	let ch = ab.getChannelData(0)
+	for (let i = 0; i < ch.length; i++) ch[i] = Math.sin(2 * Math.PI * 440 * i / 44100)
+	let buf = await encode.wav(ab, { sampleRate: 44100 })
+	ok(buf.length > 44, 'encodes AudioBuffer')
+	let dec = await decode(buf)
+	is(dec.sampleRate, 44100)
+	almost(rms(dec.channelData[0]), rms(ch), 0.001, 'rms matches')
+})