Files
hyperframes/packages/engine/src/services/wavChunks.ts
T

49 lines
1.8 KiB
TypeScript

/** Shared RIFF chunk traversal and WAV format-tag resolution. */
export interface RiffChunk {
/** Four ASCII characters: `fmt `, `data`, `LIST`, `fact`, … */
id: string;
/** Byte offset of the chunk's body, past the 8-byte header. */
body: number;
/** The size the chunk declares. May run past the end of a truncated file. */
size: number;
}
/**
* Every chunk after the 12-byte RIFF header, in the order they sit.
*
* Advances by each chunk's declared size, so ordering is not assumed — `data`
* may precede `fmt `, and trailing LIST/fact chunks are walked past rather than
* tripped over. Chunks are word-aligned, so an odd size carries a pad byte.
*/
export function* riffChunks(buffer: Buffer): Generator<RiffChunk> {
let offset = 12;
while (offset + 8 <= buffer.length) {
const id = buffer.toString("ascii", offset, offset + 4);
const size = buffer.readUInt32LE(offset + 4);
yield { id, body: offset + 8, size };
offset += 8 + size + (size % 2);
}
}
const EXTENSIBLE_FORMATS = new Map([
["0100000000001000800000aa00389b71", 1],
["0300000000001000800000aa00389b71", 3],
]);
/** Resolve WAVE_FORMAT_EXTENSIBLE only for the full PCM and IEEE-float GUIDs. */
function extensibleFormatTag(fmt: Buffer): number | null {
const extraSize = fmt.readUInt16LE(16);
if (extraSize < 22 || 18 + extraSize > fmt.length) return null;
return EXTENSIBLE_FORMATS.get(fmt.toString("hex", 24, 40)) ?? null;
}
/** Canonical codec tag, or null for a truncated or unsupported extensible header. */
export function wavFormatTag(buffer: Buffer, body: number, size: number): number | null {
const fmt = buffer.subarray(body, body + size);
if (fmt.length < 16) return null;
const tag = fmt.readUInt16LE(0);
if (tag !== 0xfffe) return tag;
return fmt.length < 40 ? null : extensibleFormatTag(fmt);
}