tempest-react-sdk 0.78.0 → 0.80.0

package/dist/audio/voice-chain-stages.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"voice-chain-stages.cjs","names":[],"sources":["../../src/audio/voice-chain-stages.ts"],"sourcesContent":["/**\n * The individual stages a voice chain is built from, and the two side-chains\n * Web Audio cannot express declaratively.\n *\n * Split out of `voice-chain.ts` because every number here is a tuning decision\n * with a reason attached, and the file that assembles them should read as the\n * signal path rather than as a wall of constants.\n */\n\n/** Everything below this is rumble, not speech. */\nconst HIGH_PASS_HZ = 85;\n\n/** Where consonants live — the band that decides whether a word is understood. */\nconst PRESENCE_HZ = 3000;\nconst PRESENCE_GAIN_DB = 3;\nconst PRESENCE_Q = 1;\n\n/** Where microphone hiss lives, above anything speech needs. */\nconst HISS_HZ = 9000;\n\n/** The sibilance band a de-esser rides. */\nconst SIBILANCE_HZ = 7000;\nconst SIBILANCE_Q = 2;\n\n/** Deepest cut the de-esser applies, in dB. */\nconst DEESSER_MAX_CUT_DB = 10;\n\n/** Band energy above which the cut starts, as RMS. */\nconst DEESSER_THRESHOLD = 0.02;\n\n/** How steeply the cut follows the band's energy above the threshold. */\nconst DEESSER_SLOPE_DB_PER_RMS = 200;\n\n/** Seconds the de-esser takes to reach a new cut. */\nconst DEESSER_SMOOTHING = 0.02;\n\n/**\n * A leveller, not a limiter: 3:1 with a soft knee evens out the distance between\n * a whisper and a shout without audibly pumping.\n */\nconst COMPRESSOR = {\n    threshold: -24,\n    knee: 30,\n    ratio: 3,\n    attack: 0.003,\n    release: 0.25,\n} as const;\n\n/**\n * The ceiling the limiter holds, in dB relative to full scale.\n *\n * Just under zero, because digital clipping is not a degradation the other end\n * can recover from — it arrives as squared-off samples that no amount of\n * processing undoes.\n */\nconst LIMITER = {\n    threshold: -1,\n    knee: 0,\n    ratio: 20,\n    attack: 0.001,\n    release: 0.1,\n} as const;\n\n/** How often the gate and the de-esser look at the signal, in milliseconds. */\nexport const DETECTOR_POLL_MS = 20;\n\n/** Time constant for opening the gate. Short, so a first syllable survives. */\nconst GATE_ATTACK = 0.005;\n\n/** Time constant for closing it. Long, so a word does not end abruptly. */\nconst GATE_RELEASE = 0.12;\n\n/**\n * How long the gate stays open after the level drops.\n *\n * RMS falls to nothing between syllables, so a gate without hold chops speech\n * into pieces — it closes inside a word and reopens on the next one. This is the\n * difference between a gate that works and one everybody turns off again.\n */\nexport const GATE_HOLD_MS = 220;\n\n/** The window each detector reads. */\nconst DETECTOR_FFT_SIZE = 1024;\n\n/**\n * Root-mean-square of a time-domain window.\n *\n * RMS rather than peak because both detectors here answer \"how much energy is\n * there\", not \"did one sample spike\": a peak reading opens a gate on a keyboard\n * click and drives a de-esser off a single transient.\n *\n * @param buffer - Time-domain samples, -1..1.\n * @returns The window's RMS, 0..1.\n */\nfunction rms(buffer: Float32Array): number {\n    let sum = 0;\n    for (const sample of buffer) sum += sample * sample;\n    return Math.sqrt(sum / buffer.length);\n}\n\n/** Build the analyser both detectors read through. */\nfunction detectorFor(context: AudioContext): AnalyserNode {\n    const analyser = context.createAnalyser();\n    analyser.fftSize = DETECTOR_FFT_SIZE;\n    return analyser;\n}\n\n/** A high-pass at 85 Hz: fans, traffic, desk knocks, plosives. */\nexport function highPassStage(context: AudioContext): BiquadFilterNode {\n    const filter = context.createBiquadFilter();\n    filter.type = \"highpass\";\n    filter.frequency.value = HIGH_PASS_HZ;\n    return filter;\n}\n\n/** A 3:1 leveller with a soft knee. */\nexport function compressorStage(context: AudioContext): DynamicsCompressorNode {\n    const comp = context.createDynamicsCompressor();\n    comp.threshold.value = COMPRESSOR.threshold;\n    comp.knee.value = COMPRESSOR.knee;\n    comp.ratio.value = COMPRESSOR.ratio;\n    comp.attack.value = COMPRESSOR.attack;\n    comp.release.value = COMPRESSOR.release;\n    return comp;\n}\n\n/** A +3 dB peak at 3 kHz: speech that reads without getting louder. */\nexport function presenceStage(context: AudioContext): BiquadFilterNode {\n    const eq = context.createBiquadFilter();\n    eq.type = \"peaking\";\n    eq.frequency.value = PRESENCE_HZ;\n    eq.Q.value = PRESENCE_Q;\n    eq.gain.value = PRESENCE_GAIN_DB;\n    return eq;\n}\n\n/** A low-pass at 9 kHz: the hiss of a cheap microphone. */\nexport function hissCutStage(context: AudioContext): BiquadFilterNode {\n    const filter = context.createBiquadFilter();\n    filter.type = \"lowpass\";\n    filter.frequency.value = HISS_HZ;\n    return filter;\n}\n\n/** A hard 20:1 ceiling at -1 dBFS, placed after the output gain. */\nexport function limiterStage(context: AudioContext): DynamicsCompressorNode {\n    const limiter = context.createDynamicsCompressor();\n    limiter.threshold.value = LIMITER.threshold;\n    limiter.knee.value = LIMITER.knee;\n    limiter.ratio.value = LIMITER.ratio;\n    limiter.attack.value = LIMITER.attack;\n    limiter.release.value = LIMITER.release;\n    return limiter;\n}\n\n/** The nodes a gate stage owns. */\nexport interface GateStage {\n    /** Reads the signal entering the gate. */\n    detector: AnalyserNode;\n    /** The gain the detector drives, 0 when closed. */\n    gain: GainNode;\n    /** Stop the detector's timer. */\n    stop: () => void;\n}\n\n/**\n * Silence the line between phrases, without cutting inside a word.\n *\n * Measured on a timer rather than in an `AudioWorklet`. A worklet would gate\n * sample-accurately at the cost of a separate module file the consumer has to\n * serve and a second graph to keep in sync; at 20 ms the difference is inaudible\n * for speech, because the hold and the release are an order of magnitude longer\n * than the polling interval and are what actually shape how a gate sounds.\n *\n * The gate starts closed and opens on the first window over the threshold, so a\n * chain built while the room is quiet does not leak the first 20 ms of it.\n *\n * @param context - The graph's context.\n * @param threshold - Read on every tick, so the caller can move a slider while\n *     the chain is live rather than rebuild it.\n * @returns The stage's nodes and its teardown.\n */\nexport function gateStage(context: AudioContext, threshold: () => number): GateStage {\n    const detector = detectorFor(context);\n    const gain = context.createGain();\n    gain.gain.value = 0;\n\n    const buffer = new Float32Array(detector.fftSize);\n    let lastLoudAt = 0;\n\n    const timer = setInterval(() => {\n        detector.getFloatTimeDomainData(buffer);\n        const now = performance.now();\n        if (rms(buffer) >= threshold()) lastLoudAt = now;\n        const open = lastLoudAt > 0 && now - lastLoudAt < GATE_HOLD_MS;\n        gain.gain.setTargetAtTime(\n            open ? 1 : 0,\n            context.currentTime,\n            open ? GATE_ATTACK : GATE_RELEASE,\n        );\n    }, DETECTOR_POLL_MS);\n\n    return { detector, gain, stop: () => clearInterval(timer) };\n}\n\n/** The nodes a de-esser stage owns. */\nexport interface DeEsserStage {\n    /** Band-pass feeding the detector — the side-chain's input. */\n    band: BiquadFilterNode;\n    /** Reads 6-8 kHz only. */\n    detector: AnalyserNode;\n    /** The peaking filter in the signal path, whose gain rides the band. */\n    shaper: BiquadFilterNode;\n    /** Stop the detector's timer. */\n    stop: () => void;\n}\n\n/**\n * Pull the sibilance band down while it is loud, and let go when it is not.\n *\n * Web Audio has no side-chain, so the detector is built by hand: a band-pass\n * feeds an analyser watching only 6-8 kHz, and that analyser's energy drives the\n * gain of a peaking filter sitting in the main path. The distinction is the whole\n * stage — the cut has to answer to the *band*, not to how loud the person is. A\n * static cut at the same frequency would dull every consonant instead of the\n * syllables that actually hiss.\n *\n * @param context - The graph's context.\n * @returns The stage's nodes and its teardown.\n */\nexport function deEsserStage(context: AudioContext): DeEsserStage {\n    const band = context.createBiquadFilter();\n    band.type = \"bandpass\";\n    band.frequency.value = SIBILANCE_HZ;\n    band.Q.value = SIBILANCE_Q;\n\n    const detector = detectorFor(context);\n    band.connect(detector);\n\n    const shaper = context.createBiquadFilter();\n    shaper.type = \"peaking\";\n    shaper.frequency.value = SIBILANCE_HZ;\n    shaper.Q.value = SIBILANCE_Q;\n    shaper.gain.value = 0;\n\n    const buffer = new Float32Array(detector.fftSize);\n    const timer = setInterval(() => {\n        detector.getFloatTimeDomainData(buffer);\n        const over = Math.max(0, rms(buffer) - DEESSER_THRESHOLD);\n        const cut = Math.min(DEESSER_MAX_CUT_DB, over * DEESSER_SLOPE_DB_PER_RMS);\n        shaper.gain.setTargetAtTime(-cut, context.currentTime, DEESSER_SMOOTHING);\n    }, DETECTOR_POLL_MS);\n\n    return { band, detector, shaper, stop: () => clearInterval(timer) };\n}\n\nexport { rms as windowRms };\n"],"mappings":"AAUA,IAWM,EAAe,IAmBf,EAAa,CACf,UAAW,IACX,KAAM,GACN,MAAO,EACP,OAAQ,KACR,QAAS,GACb,EASM,EAAU,CACZ,UAAW,GACX,KAAM,EACN,MAAO,GACP,OAAQ,KACR,QAAS,EACb,EAMM,EAAc,KAGd,EAAe,IAYf,EAAoB,KAY1B,SAAS,EAAI,EAA8B,CACvC,IAAI,EAAM,EACV,IAAK,IAAM,KAAU,EAAQ,GAAO,EAAS,EAC7C,OAAO,KAAK,KAAK,EAAM,EAAO,MAAM,CACxC,CAGA,SAAS,EAAY,EAAqC,CACtD,IAAM,EAAW,EAAQ,eAAe,EAExC,MADA,GAAS,QAAU,EACZ,CACX,CAGA,SAAgB,EAAc,EAAyC,CACnE,IAAM,EAAS,EAAQ,mBAAmB,EAG1C,MAFA,GAAO,KAAO,WACd,EAAO,UAAU,MAAQ,GAClB,CACX,CAGA,SAAgB,EAAgB,EAA+C,CAC3E,IAAM,EAAO,EAAQ,yBAAyB,EAM9C,MALA,GAAK,UAAU,MAAQ,EAAW,UAClC,EAAK,KAAK,MAAQ,EAAW,KAC7B,EAAK,MAAM,MAAQ,EAAW,MAC9B,EAAK,OAAO,MAAQ,EAAW,OAC/B,EAAK,QAAQ,MAAQ,EAAW,QACzB,CACX,CAGA,SAAgB,EAAc,EAAyC,CACnE,IAAM,EAAK,EAAQ,mBAAmB,EAKtC,MAJA,GAAG,KAAO,UACV,EAAG,UAAU,MAAQ,IACrB,EAAG,EAAE,MAAQ,EACb,EAAG,KAAK,MAAQ,EACT,CACX,CAGA,SAAgB,EAAa,EAAyC,CAClE,IAAM,EAAS,EAAQ,mBAAmB,EAG1C,MAFA,GAAO,KAAO,UACd,EAAO,UAAU,MAAQ,IAClB,CACX,CAGA,SAAgB,EAAa,EAA+C,CACxE,IAAM,EAAU,EAAQ,yBAAyB,EAMjD,MALA,GAAQ,UAAU,MAAQ,EAAQ,UAClC,EAAQ,KAAK,MAAQ,EAAQ,KAC7B,EAAQ,MAAM,MAAQ,EAAQ,MAC9B,EAAQ,OAAO,MAAQ,EAAQ,OAC/B,EAAQ,QAAQ,MAAQ,EAAQ,QACzB,CACX,CA6BA,SAAgB,EAAU,EAAuB,EAAoC,CACjF,IAAM,EAAW,EAAY,CAAO,EAC9B,EAAO,EAAQ,WAAW,EAChC,EAAK,KAAK,MAAQ,EAElB,IAAM,EAAS,IAAI,aAAa,EAAS,OAAO,EAC5C,EAAa,EAEX,EAAQ,gBAAkB,CAC5B,EAAS,uBAAuB,CAAM,EACtC,IAAM,EAAM,YAAY,IAAI,EACxB,EAAI,CAAM,GAAK,EAAU,IAAG,EAAa,GAC7C,IAAM,EAAO,EAAa,GAAK,EAAM,EAAA,IACrC,EAAK,KAAK,gBACN,KACA,EAAQ,YACR,EAAO,EAAc,CACzB,CACJ,EAAA,EAAmB,EAEnB,MAAO,CAAE,WAAU,OAAM,SAAY,cAAc,CAAK,CAAE,CAC9D,CA2BA,SAAgB,EAAa,EAAqC,CAC9D,IAAM,EAAO,EAAQ,mBAAmB,EACxC,EAAK,KAAO,WACZ,EAAK,UAAU,MAAQ,EACvB,EAAK,EAAE,MAAQ,EAEf,IAAM,EAAW,EAAY,CAAO,EACpC,EAAK,QAAQ,CAAQ,EAErB,IAAM,EAAS,EAAQ,mBAAmB,EAC1C,EAAO,KAAO,UACd,EAAO,UAAU,MAAQ,EACzB,EAAO,EAAE,MAAQ,EACjB,EAAO,KAAK,MAAQ,EAEpB,IAAM,EAAS,IAAI,aAAa,EAAS,OAAO,EAC1C,EAAQ,gBAAkB,CAC5B,EAAS,uBAAuB,CAAM,EACtC,IAAM,EAAO,KAAK,IAAI,EAAG,EAAI,CAAM,EAAI,GAAiB,EAClD,EAAM,KAAK,IAAI,GAAoB,EAAO,GAAwB,EACxE,EAAO,KAAK,gBAAgB,CAAC,EAAK,EAAQ,YAAa,GAAiB,CAC5E,EAAA,EAAmB,EAEnB,MAAO,CAAE,OAAM,WAAU,SAAQ,SAAY,cAAc,CAAK,CAAE,CACtE"}
+{"version":3,"file":"voice-chain-stages.cjs","names":["SIBILANCE_HZ","COMPRESSOR","LIMITER","GATE_ATTACK","GATE_RELEASE","DETECTOR_FFT_SIZE","rms","sum","sample","buffer","detectorFor","analyser","context","highPassStage","filter","compressorStage","comp","presenceStage","eq","hissCutStage","limiterStage","limiter","gateStage","detector","gain","lastLoudAt","timer","now","threshold","open","deEsserStage","band","shaper","over","cut"],"sources":["../../src/audio/voice-chain-stages.ts"],"sourcesContent":["/**\n * The individual stages a voice chain is built from, and the two side-chains\n * Web Audio cannot express declaratively.\n *\n * Split out of `voice-chain.ts` because every number here is a tuning decision\n * with a reason attached, and the file that assembles them should read as the\n * signal path rather than as a wall of constants.\n */\n\n/** Everything below this is rumble, not speech. */\nconst HIGH_PASS_HZ = 85;\n\n/** Where consonants live — the band that decides whether a word is understood. */\nconst PRESENCE_HZ = 3000;\nconst PRESENCE_GAIN_DB = 3;\nconst PRESENCE_Q = 1;\n\n/** Where microphone hiss lives, above anything speech needs. */\nconst HISS_HZ = 9000;\n\n/** The sibilance band a de-esser rides. */\nconst SIBILANCE_HZ = 7000;\nconst SIBILANCE_Q = 2;\n\n/** Deepest cut the de-esser applies, in dB. */\nconst DEESSER_MAX_CUT_DB = 10;\n\n/** Band energy above which the cut starts, as RMS. */\nconst DEESSER_THRESHOLD = 0.02;\n\n/** How steeply the cut follows the band's energy above the threshold. */\nconst DEESSER_SLOPE_DB_PER_RMS = 200;\n\n/** Seconds the de-esser takes to reach a new cut. */\nconst DEESSER_SMOOTHING = 0.02;\n\n/**\n * A leveller, not a limiter: 3:1 with a soft knee evens out the distance between\n * a whisper and a shout without audibly pumping.\n */\nconst COMPRESSOR = {\n    threshold: -24,\n    knee: 30,\n    ratio: 3,\n    attack: 0.003,\n    release: 0.25,\n} as const;\n\n/**\n * The ceiling the limiter holds, in dB relative to full scale.\n *\n * Just under zero, because digital clipping is not a degradation the other end\n * can recover from — it arrives as squared-off samples that no amount of\n * processing undoes.\n */\nconst LIMITER = {\n    threshold: -1,\n    knee: 0,\n    ratio: 20,\n    attack: 0.001,\n    release: 0.1,\n} as const;\n\n/** How often the gate and the de-esser look at the signal, in milliseconds. */\nexport const DETECTOR_POLL_MS = 20;\n\n/** Time constant for opening the gate. Short, so a first syllable survives. */\nconst GATE_ATTACK = 0.005;\n\n/** Time constant for closing it. Long, so a word does not end abruptly. */\nconst GATE_RELEASE = 0.12;\n\n/**\n * How long the gate stays open after the level drops.\n *\n * RMS falls to nothing between syllables, so a gate without hold chops speech\n * into pieces — it closes inside a word and reopens on the next one. This is the\n * difference between a gate that works and one everybody turns off again.\n */\nexport const GATE_HOLD_MS = 220;\n\n/** The window each detector reads. */\nconst DETECTOR_FFT_SIZE = 1024;\n\n/**\n * Root-mean-square of a time-domain window.\n *\n * RMS rather than peak because both detectors here answer \"how much energy is\n * there\", not \"did one sample spike\": a peak reading opens a gate on a keyboard\n * click and drives a de-esser off a single transient.\n *\n * @param buffer - Time-domain samples, -1..1.\n * @returns The window's RMS, 0..1.\n */\nfunction rms(buffer: Float32Array): number {\n    let sum = 0;\n    for (const sample of buffer) sum += sample * sample;\n    return Math.sqrt(sum / buffer.length);\n}\n\n/** Build the analyser both detectors read through. */\nfunction detectorFor(context: AudioContext): AnalyserNode {\n    const analyser = context.createAnalyser();\n    analyser.fftSize = DETECTOR_FFT_SIZE;\n    return analyser;\n}\n\n/** A high-pass at 85 Hz: fans, traffic, desk knocks, plosives. */\nexport function highPassStage(context: AudioContext): BiquadFilterNode {\n    const filter = context.createBiquadFilter();\n    filter.type = \"highpass\";\n    filter.frequency.value = HIGH_PASS_HZ;\n    return filter;\n}\n\n/** A 3:1 leveller with a soft knee. */\nexport function compressorStage(context: AudioContext): DynamicsCompressorNode {\n    const comp = context.createDynamicsCompressor();\n    comp.threshold.value = COMPRESSOR.threshold;\n    comp.knee.value = COMPRESSOR.knee;\n    comp.ratio.value = COMPRESSOR.ratio;\n    comp.attack.value = COMPRESSOR.attack;\n    comp.release.value = COMPRESSOR.release;\n    return comp;\n}\n\n/** A +3 dB peak at 3 kHz: speech that reads without getting louder. */\nexport function presenceStage(context: AudioContext): BiquadFilterNode {\n    const eq = context.createBiquadFilter();\n    eq.type = \"peaking\";\n    eq.frequency.value = PRESENCE_HZ;\n    eq.Q.value = PRESENCE_Q;\n    eq.gain.value = PRESENCE_GAIN_DB;\n    return eq;\n}\n\n/** A low-pass at 9 kHz: the hiss of a cheap microphone. */\nexport function hissCutStage(context: AudioContext): BiquadFilterNode {\n    const filter = context.createBiquadFilter();\n    filter.type = \"lowpass\";\n    filter.frequency.value = HISS_HZ;\n    return filter;\n}\n\n/** A hard 20:1 ceiling at -1 dBFS, placed after the output gain. */\nexport function limiterStage(context: AudioContext): DynamicsCompressorNode {\n    const limiter = context.createDynamicsCompressor();\n    limiter.threshold.value = LIMITER.threshold;\n    limiter.knee.value = LIMITER.knee;\n    limiter.ratio.value = LIMITER.ratio;\n    limiter.attack.value = LIMITER.attack;\n    limiter.release.value = LIMITER.release;\n    return limiter;\n}\n\n/** The nodes a gate stage owns. */\nexport interface GateStage {\n    /** Reads the signal entering the gate. */\n    detector: AnalyserNode;\n    /** The gain the detector drives, 0 when closed. */\n    gain: GainNode;\n    /** Stop the detector's timer. */\n    stop: () => void;\n}\n\n/**\n * Silence the line between phrases, without cutting inside a word.\n *\n * Measured on a timer rather than in an `AudioWorklet`. A worklet would gate\n * sample-accurately at the cost of a separate module file the consumer has to\n * serve and a second graph to keep in sync; at 20 ms the difference is inaudible\n * for speech, because the hold and the release are an order of magnitude longer\n * than the polling interval and are what actually shape how a gate sounds.\n *\n * The gate starts closed and opens on the first window over the threshold, so a\n * chain built while the room is quiet does not leak the first 20 ms of it.\n *\n * @param context - The graph's context.\n * @param threshold - Read on every tick, so the caller can move a slider while\n *     the chain is live rather than rebuild it.\n * @returns The stage's nodes and its teardown.\n */\nexport function gateStage(context: AudioContext, threshold: () => number): GateStage {\n    const detector = detectorFor(context);\n    const gain = context.createGain();\n    gain.gain.value = 0;\n\n    const buffer = new Float32Array(detector.fftSize);\n    let lastLoudAt = 0;\n\n    const timer = setInterval(() => {\n        detector.getFloatTimeDomainData(buffer);\n        const now = performance.now();\n        if (rms(buffer) >= threshold()) lastLoudAt = now;\n        const open = lastLoudAt > 0 && now - lastLoudAt < GATE_HOLD_MS;\n        gain.gain.setTargetAtTime(\n            open ? 1 : 0,\n            context.currentTime,\n            open ? GATE_ATTACK : GATE_RELEASE,\n        );\n    }, DETECTOR_POLL_MS);\n\n    return { detector, gain, stop: () => clearInterval(timer) };\n}\n\n/** The nodes a de-esser stage owns. */\nexport interface DeEsserStage {\n    /** Band-pass feeding the detector — the side-chain's input. */\n    band: BiquadFilterNode;\n    /** Reads 6-8 kHz only. */\n    detector: AnalyserNode;\n    /** The peaking filter in the signal path, whose gain rides the band. */\n    shaper: BiquadFilterNode;\n    /** Stop the detector's timer. */\n    stop: () => void;\n}\n\n/**\n * Pull the sibilance band down while it is loud, and let go when it is not.\n *\n * Web Audio has no side-chain, so the detector is built by hand: a band-pass\n * feeds an analyser watching only 6-8 kHz, and that analyser's energy drives the\n * gain of a peaking filter sitting in the main path. The distinction is the whole\n * stage — the cut has to answer to the *band*, not to how loud the person is. A\n * static cut at the same frequency would dull every consonant instead of the\n * syllables that actually hiss.\n *\n * @param context - The graph's context.\n * @returns The stage's nodes and its teardown.\n */\nexport function deEsserStage(context: AudioContext): DeEsserStage {\n    const band = context.createBiquadFilter();\n    band.type = \"bandpass\";\n    band.frequency.value = SIBILANCE_HZ;\n    band.Q.value = SIBILANCE_Q;\n\n    const detector = detectorFor(context);\n    band.connect(detector);\n\n    const shaper = context.createBiquadFilter();\n    shaper.type = \"peaking\";\n    shaper.frequency.value = SIBILANCE_HZ;\n    shaper.Q.value = SIBILANCE_Q;\n    shaper.gain.value = 0;\n\n    const buffer = new Float32Array(detector.fftSize);\n    const timer = setInterval(() => {\n        detector.getFloatTimeDomainData(buffer);\n        const over = Math.max(0, rms(buffer) - DEESSER_THRESHOLD);\n        const cut = Math.min(DEESSER_MAX_CUT_DB, over * DEESSER_SLOPE_DB_PER_RMS);\n        shaper.gain.setTargetAtTime(-cut, context.currentTime, DEESSER_SMOOTHING);\n    }, DETECTOR_POLL_MS);\n\n    return { band, detector, shaper, stop: () => clearInterval(timer) };\n}\n\nexport { rms as windowRms };\n"],"mappings":"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"}

package/dist/audio/voice-chain-stages.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-chain-stages.js","names":[],"sources":["../../src/audio/voice-chain-stages.ts"],"sourcesContent":["/**\n * The individual stages a voice chain is built from, and the two side-chains\n * Web Audio cannot express declaratively.\n *\n * Split out of `voice-chain.ts` because every number here is a tuning decision\n * with a reason attached, and the file that assembles them should read as the\n * signal path rather than as a wall of constants.\n */\n\n/** Everything below this is rumble, not speech. */\nconst HIGH_PASS_HZ = 85;\n\n/** Where consonants live — the band that decides whether a word is understood. */\nconst PRESENCE_HZ = 3000;\nconst PRESENCE_GAIN_DB = 3;\nconst PRESENCE_Q = 1;\n\n/** Where microphone hiss lives, above anything speech needs. */\nconst HISS_HZ = 9000;\n\n/** The sibilance band a de-esser rides. */\nconst SIBILANCE_HZ = 7000;\nconst SIBILANCE_Q = 2;\n\n/** Deepest cut the de-esser applies, in dB. */\nconst DEESSER_MAX_CUT_DB = 10;\n\n/** Band energy above which the cut starts, as RMS. */\nconst DEESSER_THRESHOLD = 0.02;\n\n/** How steeply the cut follows the band's energy above the threshold. */\nconst DEESSER_SLOPE_DB_PER_RMS = 200;\n\n/** Seconds the de-esser takes to reach a new cut. */\nconst DEESSER_SMOOTHING = 0.02;\n\n/**\n * A leveller, not a limiter: 3:1 with a soft knee evens out the distance between\n * a whisper and a shout without audibly pumping.\n */\nconst COMPRESSOR = {\n    threshold: -24,\n    knee: 30,\n    ratio: 3,\n    attack: 0.003,\n    release: 0.25,\n} as const;\n\n/**\n * The ceiling the limiter holds, in dB relative to full scale.\n *\n * Just under zero, because digital clipping is not a degradation the other end\n * can recover from — it arrives as squared-off samples that no amount of\n * processing undoes.\n */\nconst LIMITER = {\n    threshold: -1,\n    knee: 0,\n    ratio: 20,\n    attack: 0.001,\n    release: 0.1,\n} as const;\n\n/** How often the gate and the de-esser look at the signal, in milliseconds. */\nexport const DETECTOR_POLL_MS = 20;\n\n/** Time constant for opening the gate. Short, so a first syllable survives. */\nconst GATE_ATTACK = 0.005;\n\n/** Time constant for closing it. Long, so a word does not end abruptly. */\nconst GATE_RELEASE = 0.12;\n\n/**\n * How long the gate stays open after the level drops.\n *\n * RMS falls to nothing between syllables, so a gate without hold chops speech\n * into pieces — it closes inside a word and reopens on the next one. This is the\n * difference between a gate that works and one everybody turns off again.\n */\nexport const GATE_HOLD_MS = 220;\n\n/** The window each detector reads. */\nconst DETECTOR_FFT_SIZE = 1024;\n\n/**\n * Root-mean-square of a time-domain window.\n *\n * RMS rather than peak because both detectors here answer \"how much energy is\n * there\", not \"did one sample spike\": a peak reading opens a gate on a keyboard\n * click and drives a de-esser off a single transient.\n *\n * @param buffer - Time-domain samples, -1..1.\n * @returns The window's RMS, 0..1.\n */\nfunction rms(buffer: Float32Array): number {\n    let sum = 0;\n    for (const sample of buffer) sum += sample * sample;\n    return Math.sqrt(sum / buffer.length);\n}\n\n/** Build the analyser both detectors read through. */\nfunction detectorFor(context: AudioContext): AnalyserNode {\n    const analyser = context.createAnalyser();\n    analyser.fftSize = DETECTOR_FFT_SIZE;\n    return analyser;\n}\n\n/** A high-pass at 85 Hz: fans, traffic, desk knocks, plosives. */\nexport function highPassStage(context: AudioContext): BiquadFilterNode {\n    const filter = context.createBiquadFilter();\n    filter.type = \"highpass\";\n    filter.frequency.value = HIGH_PASS_HZ;\n    return filter;\n}\n\n/** A 3:1 leveller with a soft knee. */\nexport function compressorStage(context: AudioContext): DynamicsCompressorNode {\n    const comp = context.createDynamicsCompressor();\n    comp.threshold.value = COMPRESSOR.threshold;\n    comp.knee.value = COMPRESSOR.knee;\n    comp.ratio.value = COMPRESSOR.ratio;\n    comp.attack.value = COMPRESSOR.attack;\n    comp.release.value = COMPRESSOR.release;\n    return comp;\n}\n\n/** A +3 dB peak at 3 kHz: speech that reads without getting louder. */\nexport function presenceStage(context: AudioContext): BiquadFilterNode {\n    const eq = context.createBiquadFilter();\n    eq.type = \"peaking\";\n    eq.frequency.value = PRESENCE_HZ;\n    eq.Q.value = PRESENCE_Q;\n    eq.gain.value = PRESENCE_GAIN_DB;\n    return eq;\n}\n\n/** A low-pass at 9 kHz: the hiss of a cheap microphone. */\nexport function hissCutStage(context: AudioContext): BiquadFilterNode {\n    const filter = context.createBiquadFilter();\n    filter.type = \"lowpass\";\n    filter.frequency.value = HISS_HZ;\n    return filter;\n}\n\n/** A hard 20:1 ceiling at -1 dBFS, placed after the output gain. */\nexport function limiterStage(context: AudioContext): DynamicsCompressorNode {\n    const limiter = context.createDynamicsCompressor();\n    limiter.threshold.value = LIMITER.threshold;\n    limiter.knee.value = LIMITER.knee;\n    limiter.ratio.value = LIMITER.ratio;\n    limiter.attack.value = LIMITER.attack;\n    limiter.release.value = LIMITER.release;\n    return limiter;\n}\n\n/** The nodes a gate stage owns. */\nexport interface GateStage {\n    /** Reads the signal entering the gate. */\n    detector: AnalyserNode;\n    /** The gain the detector drives, 0 when closed. */\n    gain: GainNode;\n    /** Stop the detector's timer. */\n    stop: () => void;\n}\n\n/**\n * Silence the line between phrases, without cutting inside a word.\n *\n * Measured on a timer rather than in an `AudioWorklet`. A worklet would gate\n * sample-accurately at the cost of a separate module file the consumer has to\n * serve and a second graph to keep in sync; at 20 ms the difference is inaudible\n * for speech, because the hold and the release are an order of magnitude longer\n * than the polling interval and are what actually shape how a gate sounds.\n *\n * The gate starts closed and opens on the first window over the threshold, so a\n * chain built while the room is quiet does not leak the first 20 ms of it.\n *\n * @param context - The graph's context.\n * @param threshold - Read on every tick, so the caller can move a slider while\n *     the chain is live rather than rebuild it.\n * @returns The stage's nodes and its teardown.\n */\nexport function gateStage(context: AudioContext, threshold: () => number): GateStage {\n    const detector = detectorFor(context);\n    const gain = context.createGain();\n    gain.gain.value = 0;\n\n    const buffer = new Float32Array(detector.fftSize);\n    let lastLoudAt = 0;\n\n    const timer = setInterval(() => {\n        detector.getFloatTimeDomainData(buffer);\n        const now = performance.now();\n        if (rms(buffer) >= threshold()) lastLoudAt = now;\n        const open = lastLoudAt > 0 && now - lastLoudAt < GATE_HOLD_MS;\n        gain.gain.setTargetAtTime(\n            open ? 1 : 0,\n            context.currentTime,\n            open ? GATE_ATTACK : GATE_RELEASE,\n        );\n    }, DETECTOR_POLL_MS);\n\n    return { detector, gain, stop: () => clearInterval(timer) };\n}\n\n/** The nodes a de-esser stage owns. */\nexport interface DeEsserStage {\n    /** Band-pass feeding the detector — the side-chain's input. */\n    band: BiquadFilterNode;\n    /** Reads 6-8 kHz only. */\n    detector: AnalyserNode;\n    /** The peaking filter in the signal path, whose gain rides the band. */\n    shaper: BiquadFilterNode;\n    /** Stop the detector's timer. */\n    stop: () => void;\n}\n\n/**\n * Pull the sibilance band down while it is loud, and let go when it is not.\n *\n * Web Audio has no side-chain, so the detector is built by hand: a band-pass\n * feeds an analyser watching only 6-8 kHz, and that analyser's energy drives the\n * gain of a peaking filter sitting in the main path. The distinction is the whole\n * stage — the cut has to answer to the *band*, not to how loud the person is. A\n * static cut at the same frequency would dull every consonant instead of the\n * syllables that actually hiss.\n *\n * @param context - The graph's context.\n * @returns The stage's nodes and its teardown.\n */\nexport function deEsserStage(context: AudioContext): DeEsserStage {\n    const band = context.createBiquadFilter();\n    band.type = \"bandpass\";\n    band.frequency.value = SIBILANCE_HZ;\n    band.Q.value = SIBILANCE_Q;\n\n    const detector = detectorFor(context);\n    band.connect(detector);\n\n    const shaper = context.createBiquadFilter();\n    shaper.type = \"peaking\";\n    shaper.frequency.value = SIBILANCE_HZ;\n    shaper.Q.value = SIBILANCE_Q;\n    shaper.gain.value = 0;\n\n    const buffer = new Float32Array(detector.fftSize);\n    const timer = setInterval(() => {\n        detector.getFloatTimeDomainData(buffer);\n        const over = Math.max(0, rms(buffer) - DEESSER_THRESHOLD);\n        const cut = Math.min(DEESSER_MAX_CUT_DB, over * DEESSER_SLOPE_DB_PER_RMS);\n        shaper.gain.setTargetAtTime(-cut, context.currentTime, DEESSER_SMOOTHING);\n    }, DETECTOR_POLL_MS);\n\n    return { band, detector, shaper, stop: () => clearInterval(timer) };\n}\n\nexport { rms as windowRms };\n"],"mappings":"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"}
+{"version":3,"file":"voice-chain-stages.js","names":["SIBILANCE_HZ","COMPRESSOR","LIMITER","GATE_ATTACK","GATE_RELEASE","DETECTOR_FFT_SIZE","rms","sum","sample","buffer","detectorFor","analyser","context","highPassStage","filter","compressorStage","comp","presenceStage","eq","hissCutStage","limiterStage","limiter","gateStage","detector","gain","lastLoudAt","timer","now","threshold","open","deEsserStage","band","shaper","over","cut"],"sources":["../../src/audio/voice-chain-stages.ts"],"sourcesContent":["/**\n * The individual stages a voice chain is built from, and the two side-chains\n * Web Audio cannot express declaratively.\n *\n * Split out of `voice-chain.ts` because every number here is a tuning decision\n * with a reason attached, and the file that assembles them should read as the\n * signal path rather than as a wall of constants.\n */\n\n/** Everything below this is rumble, not speech. */\nconst HIGH_PASS_HZ = 85;\n\n/** Where consonants live — the band that decides whether a word is understood. */\nconst PRESENCE_HZ = 3000;\nconst PRESENCE_GAIN_DB = 3;\nconst PRESENCE_Q = 1;\n\n/** Where microphone hiss lives, above anything speech needs. */\nconst HISS_HZ = 9000;\n\n/** The sibilance band a de-esser rides. */\nconst SIBILANCE_HZ = 7000;\nconst SIBILANCE_Q = 2;\n\n/** Deepest cut the de-esser applies, in dB. */\nconst DEESSER_MAX_CUT_DB = 10;\n\n/** Band energy above which the cut starts, as RMS. */\nconst DEESSER_THRESHOLD = 0.02;\n\n/** How steeply the cut follows the band's energy above the threshold. */\nconst DEESSER_SLOPE_DB_PER_RMS = 200;\n\n/** Seconds the de-esser takes to reach a new cut. */\nconst DEESSER_SMOOTHING = 0.02;\n\n/**\n * A leveller, not a limiter: 3:1 with a soft knee evens out the distance between\n * a whisper and a shout without audibly pumping.\n */\nconst COMPRESSOR = {\n    threshold: -24,\n    knee: 30,\n    ratio: 3,\n    attack: 0.003,\n    release: 0.25,\n} as const;\n\n/**\n * The ceiling the limiter holds, in dB relative to full scale.\n *\n * Just under zero, because digital clipping is not a degradation the other end\n * can recover from — it arrives as squared-off samples that no amount of\n * processing undoes.\n */\nconst LIMITER = {\n    threshold: -1,\n    knee: 0,\n    ratio: 20,\n    attack: 0.001,\n    release: 0.1,\n} as const;\n\n/** How often the gate and the de-esser look at the signal, in milliseconds. */\nexport const DETECTOR_POLL_MS = 20;\n\n/** Time constant for opening the gate. Short, so a first syllable survives. */\nconst GATE_ATTACK = 0.005;\n\n/** Time constant for closing it. Long, so a word does not end abruptly. */\nconst GATE_RELEASE = 0.12;\n\n/**\n * How long the gate stays open after the level drops.\n *\n * RMS falls to nothing between syllables, so a gate without hold chops speech\n * into pieces — it closes inside a word and reopens on the next one. This is the\n * difference between a gate that works and one everybody turns off again.\n */\nexport const GATE_HOLD_MS = 220;\n\n/** The window each detector reads. */\nconst DETECTOR_FFT_SIZE = 1024;\n\n/**\n * Root-mean-square of a time-domain window.\n *\n * RMS rather than peak because both detectors here answer \"how much energy is\n * there\", not \"did one sample spike\": a peak reading opens a gate on a keyboard\n * click and drives a de-esser off a single transient.\n *\n * @param buffer - Time-domain samples, -1..1.\n * @returns The window's RMS, 0..1.\n */\nfunction rms(buffer: Float32Array): number {\n    let sum = 0;\n    for (const sample of buffer) sum += sample * sample;\n    return Math.sqrt(sum / buffer.length);\n}\n\n/** Build the analyser both detectors read through. */\nfunction detectorFor(context: AudioContext): AnalyserNode {\n    const analyser = context.createAnalyser();\n    analyser.fftSize = DETECTOR_FFT_SIZE;\n    return analyser;\n}\n\n/** A high-pass at 85 Hz: fans, traffic, desk knocks, plosives. */\nexport function highPassStage(context: AudioContext): BiquadFilterNode {\n    const filter = context.createBiquadFilter();\n    filter.type = \"highpass\";\n    filter.frequency.value = HIGH_PASS_HZ;\n    return filter;\n}\n\n/** A 3:1 leveller with a soft knee. */\nexport function compressorStage(context: AudioContext): DynamicsCompressorNode {\n    const comp = context.createDynamicsCompressor();\n    comp.threshold.value = COMPRESSOR.threshold;\n    comp.knee.value = COMPRESSOR.knee;\n    comp.ratio.value = COMPRESSOR.ratio;\n    comp.attack.value = COMPRESSOR.attack;\n    comp.release.value = COMPRESSOR.release;\n    return comp;\n}\n\n/** A +3 dB peak at 3 kHz: speech that reads without getting louder. */\nexport function presenceStage(context: AudioContext): BiquadFilterNode {\n    const eq = context.createBiquadFilter();\n    eq.type = \"peaking\";\n    eq.frequency.value = PRESENCE_HZ;\n    eq.Q.value = PRESENCE_Q;\n    eq.gain.value = PRESENCE_GAIN_DB;\n    return eq;\n}\n\n/** A low-pass at 9 kHz: the hiss of a cheap microphone. */\nexport function hissCutStage(context: AudioContext): BiquadFilterNode {\n    const filter = context.createBiquadFilter();\n    filter.type = \"lowpass\";\n    filter.frequency.value = HISS_HZ;\n    return filter;\n}\n\n/** A hard 20:1 ceiling at -1 dBFS, placed after the output gain. */\nexport function limiterStage(context: AudioContext): DynamicsCompressorNode {\n    const limiter = context.createDynamicsCompressor();\n    limiter.threshold.value = LIMITER.threshold;\n    limiter.knee.value = LIMITER.knee;\n    limiter.ratio.value = LIMITER.ratio;\n    limiter.attack.value = LIMITER.attack;\n    limiter.release.value = LIMITER.release;\n    return limiter;\n}\n\n/** The nodes a gate stage owns. */\nexport interface GateStage {\n    /** Reads the signal entering the gate. */\n    detector: AnalyserNode;\n    /** The gain the detector drives, 0 when closed. */\n    gain: GainNode;\n    /** Stop the detector's timer. */\n    stop: () => void;\n}\n\n/**\n * Silence the line between phrases, without cutting inside a word.\n *\n * Measured on a timer rather than in an `AudioWorklet`. A worklet would gate\n * sample-accurately at the cost of a separate module file the consumer has to\n * serve and a second graph to keep in sync; at 20 ms the difference is inaudible\n * for speech, because the hold and the release are an order of magnitude longer\n * than the polling interval and are what actually shape how a gate sounds.\n *\n * The gate starts closed and opens on the first window over the threshold, so a\n * chain built while the room is quiet does not leak the first 20 ms of it.\n *\n * @param context - The graph's context.\n * @param threshold - Read on every tick, so the caller can move a slider while\n *     the chain is live rather than rebuild it.\n * @returns The stage's nodes and its teardown.\n */\nexport function gateStage(context: AudioContext, threshold: () => number): GateStage {\n    const detector = detectorFor(context);\n    const gain = context.createGain();\n    gain.gain.value = 0;\n\n    const buffer = new Float32Array(detector.fftSize);\n    let lastLoudAt = 0;\n\n    const timer = setInterval(() => {\n        detector.getFloatTimeDomainData(buffer);\n        const now = performance.now();\n        if (rms(buffer) >= threshold()) lastLoudAt = now;\n        const open = lastLoudAt > 0 && now - lastLoudAt < GATE_HOLD_MS;\n        gain.gain.setTargetAtTime(\n            open ? 1 : 0,\n            context.currentTime,\n            open ? GATE_ATTACK : GATE_RELEASE,\n        );\n    }, DETECTOR_POLL_MS);\n\n    return { detector, gain, stop: () => clearInterval(timer) };\n}\n\n/** The nodes a de-esser stage owns. */\nexport interface DeEsserStage {\n    /** Band-pass feeding the detector — the side-chain's input. */\n    band: BiquadFilterNode;\n    /** Reads 6-8 kHz only. */\n    detector: AnalyserNode;\n    /** The peaking filter in the signal path, whose gain rides the band. */\n    shaper: BiquadFilterNode;\n    /** Stop the detector's timer. */\n    stop: () => void;\n}\n\n/**\n * Pull the sibilance band down while it is loud, and let go when it is not.\n *\n * Web Audio has no side-chain, so the detector is built by hand: a band-pass\n * feeds an analyser watching only 6-8 kHz, and that analyser's energy drives the\n * gain of a peaking filter sitting in the main path. The distinction is the whole\n * stage — the cut has to answer to the *band*, not to how loud the person is. A\n * static cut at the same frequency would dull every consonant instead of the\n * syllables that actually hiss.\n *\n * @param context - The graph's context.\n * @returns The stage's nodes and its teardown.\n */\nexport function deEsserStage(context: AudioContext): DeEsserStage {\n    const band = context.createBiquadFilter();\n    band.type = \"bandpass\";\n    band.frequency.value = SIBILANCE_HZ;\n    band.Q.value = SIBILANCE_Q;\n\n    const detector = detectorFor(context);\n    band.connect(detector);\n\n    const shaper = context.createBiquadFilter();\n    shaper.type = \"peaking\";\n    shaper.frequency.value = SIBILANCE_HZ;\n    shaper.Q.value = SIBILANCE_Q;\n    shaper.gain.value = 0;\n\n    const buffer = new Float32Array(detector.fftSize);\n    const timer = setInterval(() => {\n        detector.getFloatTimeDomainData(buffer);\n        const over = Math.max(0, rms(buffer) - DEESSER_THRESHOLD);\n        const cut = Math.min(DEESSER_MAX_CUT_DB, over * DEESSER_SLOPE_DB_PER_RMS);\n        shaper.gain.setTargetAtTime(-cut, context.currentTime, DEESSER_SMOOTHING);\n    }, DETECTOR_POLL_MS);\n\n    return { band, detector, shaper, stop: () => clearInterval(timer) };\n}\n\nexport { rms as windowRms };\n"],"mappings":"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"}

package/dist/audio/voice-chain.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"voice-chain.cjs","names":[],"sources":["../../src/audio/voice-chain.ts"],"sourcesContent":["import {\n    compressorStage,\n    deEsserStage,\n    gateStage,\n    highPassStage,\n    hissCutStage,\n    limiterStage,\n    presenceStage,\n} from \"./voice-chain-stages\";\n\n/** Which stages a voice chain builds. */\nexport interface VoiceChainSettings {\n    /** Cut everything below speech: fans, traffic rumble, desk knocks, plosives. */\n    highPass: boolean;\n    /** Silence the line when nobody is talking. */\n    gate: boolean;\n    /** RMS below which the gate closes, 0..1. See {@link suggestGateThreshold}. */\n    gateThreshold: number;\n    /** Even out the distance between a whisper and a shout. */\n    compressor: boolean;\n    /** Lift the consonant band so speech reads without getting louder. */\n    presence: boolean;\n    /** Roll off hiss above what speech uses. */\n    hissCut: boolean;\n    /** Ride down harsh S and CH sounds. */\n    deEsser: boolean;\n    /**\n     * Hard ceiling before the signal leaves.\n     *\n     * On by default and worth leaving on: the leveller is 3:1, which controls the\n     * average and lets a peak through, and `gain` can reach well above 1.\n     */\n    limiter: boolean;\n}\n\n/**\n * What a call wants before anybody touches a slider.\n *\n * High-pass, leveller and limiter only. Gate, presence, hiss cut and de-esser are\n * off because each has an audible cost when it is not needed — a gate set for the\n * wrong room clips words, presence on a bright microphone is harsh, and a de-esser\n * on a voice that does not hiss just dulls it.\n */\nexport const DEFAULT_VOICE_CHAIN: VoiceChainSettings = {\n    highPass: true,\n    gate: false,\n    gateThreshold: 0.02,\n    compressor: true,\n    presence: false,\n    hissCut: false,\n    deEsser: false,\n    limiter: true,\n};\n\n/** Options for {@link createVoiceChain}. */\nexport interface VoiceChainOptions {\n    /** Output multiplier, applied after every stage and before the limiter. Default `1`. */\n    gain?: number;\n    /**\n     * Reuse an existing `AudioContext` instead of creating one.\n     *\n     * Browsers cap live contexts (Chrome allows around six), so a page that already\n     * has one — a level meter, an audio bus — should hand it over.\n     */\n    context?: AudioContext;\n    /**\n     * Whether `release()` also stops `source`. Default `true`.\n     *\n     * Pass `false` when the track belongs to somebody else: a settings dialog\n     * building a second chain over its live preview would otherwise kill the meter\n     * the person is watching while they listen.\n     */\n    ownsSource?: boolean;\n}\n\n/** A running voice chain. */\nexport interface VoiceChain {\n    /** The processed track to publish. */\n    track: MediaStreamTrack;\n    /** Stop the detectors, disconnect the graph, and release the track. */\n    release: () => void;\n    /**\n     * Whether a graph was actually built.\n     *\n     * `false` when this engine has no Web Audio, and also when the settings asked\n     * for nothing — in both cases `track` is `source`, untouched.\n     */\n    readonly supported: boolean;\n}\n\n/** The `AudioContext` constructor this engine exposes, prefixed or not. */\nfunction audioContextConstructor(): typeof AudioContext | undefined {\n    if (typeof AudioContext !== \"undefined\") return AudioContext;\n    return (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n}\n\n/**\n * Whether any of this would change the signal.\n *\n * A chain that only passes audio through still costs a re-encode and a handful of\n * nodes, so a caller that rebuilds on every settings change should ask first —\n * and {@link createVoiceChain} asks too, handing back `source` rather than\n * building a graph that does nothing.\n *\n * @param settings - The stages under consideration.\n * @param gain - The output multiplier that would be applied. Default `1`.\n * @returns `true` when the chain would be audibly transparent.\n */\nexport function isVoiceChainIdle(settings: VoiceChainSettings, gain = 1): boolean {\n    return (\n        !settings.highPass &&\n        !settings.gate &&\n        !settings.compressor &&\n        !settings.presence &&\n        !settings.hissCut &&\n        !settings.deEsser &&\n        !settings.limiter &&\n        gain === 1\n    );\n}\n\n/** A chain that owns nothing, for an engine or a settings object with no work to do. */\nfunction passThrough(source: MediaStreamTrack, ownsSource: boolean): VoiceChain {\n    return {\n        track: source,\n        release: () => {\n            if (ownsSource) source.stop();\n        },\n        supported: false,\n    };\n}\n\n/**\n * Build the processing a microphone is published through.\n *\n * Ordered the way a console is: cut what is not speech, gate what is left, level\n * it, shape it, set how loud it goes out, then hold a ceiling. **The order is not\n * cosmetic.** Gating before the high-pass lets a rumble hold the gate open;\n * compressing before the gate lifts the noise floor up to meet the threshold; and\n * a limiter placed before the output gain is a ceiling the gain then walks\n * straight through.\n *\n * This sits *after* the browser's own echo cancellation and noise suppression,\n * which stay on: the two solve different problems. The browser's is trained on\n * stationary noise inside the capture pipeline; this cuts what it leaves behind\n * and decides when the line should be silent at all.\n *\n * @param source - The captured microphone track.\n * @param settings - Which stages to build. Default {@link DEFAULT_VOICE_CHAIN}.\n * @param options - See {@link VoiceChainOptions}.\n * @returns The track to publish plus its teardown. On an engine with no Web Audio,\n *   and when every stage is off, the source track is handed back untouched and\n *   `supported` is `false` — a call without processing beats a call that throws.\n *   The idle case is decided **before** a context is opened, because browsers cap\n *   how many can be live and one built for a chain that does nothing still counts.\n *\n * @example\n * const floor = await measureNoiseFloor(stream);\n * const chain = createVoiceChain(micTrack, {\n *     ...DEFAULT_VOICE_CHAIN,\n *     gate: true,\n *     gateThreshold: suggestGateThreshold(floor),\n * }, { gain: 1.4 });\n * await mesh.setLocalTrack(\"mic\", chain.track);\n */\nexport function createVoiceChain(\n    source: MediaStreamTrack,\n    settings: VoiceChainSettings = DEFAULT_VOICE_CHAIN,\n    { gain = 1, context: injectedContext, ownsSource = true }: VoiceChainOptions = {},\n): VoiceChain {\n    if (isVoiceChainIdle(settings, gain)) return passThrough(source, ownsSource);\n\n    const Ctor = audioContextConstructor();\n    const context = injectedContext ?? (Ctor ? new Ctor() : null);\n    if (!context) return passThrough(source, ownsSource);\n\n    const input = context.createMediaStreamSource(\n        typeof MediaStream === \"undefined\"\n            ? (source as unknown as MediaStream)\n            : new MediaStream([source]),\n    );\n    const built: AudioNode[] = [input];\n    const stops: (() => void)[] = [];\n    let node: AudioNode = input;\n\n    const chain = (next: AudioNode): void => {\n        node.connect(next);\n        node = next;\n        built.push(next);\n    };\n\n    if (settings.highPass) chain(highPassStage(context));\n\n    if (settings.gate) {\n        const stage = gateStage(context, () => settings.gateThreshold);\n        node.connect(stage.detector);\n        built.push(stage.detector);\n        stops.push(stage.stop);\n        chain(stage.gain);\n    }\n\n    if (settings.compressor) chain(compressorStage(context));\n    if (settings.presence) chain(presenceStage(context));\n    if (settings.hissCut) chain(hissCutStage(context));\n\n    if (settings.deEsser) {\n        const stage = deEsserStage(context);\n        node.connect(stage.band);\n        built.push(stage.band, stage.detector);\n        stops.push(stage.stop);\n        chain(stage.shaper);\n    }\n\n    const output = context.createGain();\n    output.gain.value = gain;\n    chain(output);\n\n    if (settings.limiter) chain(limiterStage(context));\n\n    const destination = context.createMediaStreamDestination();\n    node.connect(destination);\n    built.push(destination);\n    const track = destination.stream.getAudioTracks()[0];\n\n    const teardown = (): void => {\n        for (const stop of stops) stop();\n        for (const built_ of built) built_.disconnect();\n    };\n\n    if (!track) {\n        teardown();\n        return passThrough(source, ownsSource);\n    }\n\n    return {\n        track,\n        release: (): void => {\n            teardown();\n            track.stop();\n            if (ownsSource) source.stop();\n        },\n        supported: true,\n    };\n}\n\n/** A running monitor. */\nexport interface VoiceMonitor {\n    /** Stop listening and release the graph. Does **not** stop the source track. */\n    stop: () => void;\n}\n\n/**\n * Play your own processed microphone back to you.\n *\n * The only way to hear what these filters do without a second person on the call.\n * Every number the chain is tuned by — how deep the de-esser cuts, where the gate\n * sits, how much presence is too much — is a judgement made by ear, and without\n * this the only available ear belongs to somebody else.\n *\n * **Feedback is the hazard, and the reason this is a held, explicit action rather\n * than a setting:** without headphones the speakers feed the microphone that feeds\n * the speakers. Say so in the UI that offers it.\n *\n * @param source - The raw captured track to listen to. It is never stopped here.\n * @param settings - The stages to hear it through. Default {@link DEFAULT_VOICE_CHAIN}.\n * @param options - See {@link VoiceChainOptions}; `ownsSource` is forced to `false`.\n * @returns A handle that stops the monitor.\n */\nexport function monitorVoiceChain(\n    source: MediaStreamTrack,\n    settings: VoiceChainSettings = DEFAULT_VOICE_CHAIN,\n    options: Omit<VoiceChainOptions, \"ownsSource\"> = {},\n): VoiceMonitor {\n    const Ctor = audioContextConstructor();\n    const context = options.context ?? (Ctor ? new Ctor() : null);\n    if (!context) return { stop: () => undefined };\n\n    const chain = createVoiceChain(source, settings, { ...options, context, ownsSource: false });\n    const playback = context.createMediaStreamSource(\n        typeof MediaStream === \"undefined\"\n            ? (chain.track as unknown as MediaStream)\n            : new MediaStream([chain.track]),\n    );\n    playback.connect(context.destination);\n\n    return {\n        stop: (): void => {\n            playback.disconnect();\n            chain.release();\n        },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"voice-chain.cjs","names":["highPassStage","gateStage","compressorStage","presenceStage","hissCutStage","deEsserStage","limiterStage","require_voice_chain_stages","DEFAULT_VOICE_CHAIN","audioContextConstructor","isVoiceChainIdle","settings","gain","passThrough","source","ownsSource","createVoiceChain","injectedContext","Ctor","context","input","built","stops","node","chain","next","stage","output","destination","track","teardown","stop","built_","monitorVoiceChain","options","playback"],"sources":["../../src/audio/voice-chain.ts"],"sourcesContent":["import {\n    compressorStage,\n    deEsserStage,\n    gateStage,\n    highPassStage,\n    hissCutStage,\n    limiterStage,\n    presenceStage,\n} from \"./voice-chain-stages\";\n\n/** Which stages a voice chain builds. */\nexport interface VoiceChainSettings {\n    /** Cut everything below speech: fans, traffic rumble, desk knocks, plosives. */\n    highPass: boolean;\n    /** Silence the line when nobody is talking. */\n    gate: boolean;\n    /** RMS below which the gate closes, 0..1. See {@link suggestGateThreshold}. */\n    gateThreshold: number;\n    /** Even out the distance between a whisper and a shout. */\n    compressor: boolean;\n    /** Lift the consonant band so speech reads without getting louder. */\n    presence: boolean;\n    /** Roll off hiss above what speech uses. */\n    hissCut: boolean;\n    /** Ride down harsh S and CH sounds. */\n    deEsser: boolean;\n    /**\n     * Hard ceiling before the signal leaves.\n     *\n     * On by default and worth leaving on: the leveller is 3:1, which controls the\n     * average and lets a peak through, and `gain` can reach well above 1.\n     */\n    limiter: boolean;\n}\n\n/**\n * What a call wants before anybody touches a slider.\n *\n * High-pass, leveller and limiter only. Gate, presence, hiss cut and de-esser are\n * off because each has an audible cost when it is not needed — a gate set for the\n * wrong room clips words, presence on a bright microphone is harsh, and a de-esser\n * on a voice that does not hiss just dulls it.\n */\nexport const DEFAULT_VOICE_CHAIN: VoiceChainSettings = {\n    highPass: true,\n    gate: false,\n    gateThreshold: 0.02,\n    compressor: true,\n    presence: false,\n    hissCut: false,\n    deEsser: false,\n    limiter: true,\n};\n\n/** Options for {@link createVoiceChain}. */\nexport interface VoiceChainOptions {\n    /** Output multiplier, applied after every stage and before the limiter. Default `1`. */\n    gain?: number;\n    /**\n     * Reuse an existing `AudioContext` instead of creating one.\n     *\n     * Browsers cap live contexts (Chrome allows around six), so a page that already\n     * has one — a level meter, an audio bus — should hand it over.\n     */\n    context?: AudioContext;\n    /**\n     * Whether `release()` also stops `source`. Default `true`.\n     *\n     * Pass `false` when the track belongs to somebody else: a settings dialog\n     * building a second chain over its live preview would otherwise kill the meter\n     * the person is watching while they listen.\n     */\n    ownsSource?: boolean;\n}\n\n/** A running voice chain. */\nexport interface VoiceChain {\n    /** The processed track to publish. */\n    track: MediaStreamTrack;\n    /** Stop the detectors, disconnect the graph, and release the track. */\n    release: () => void;\n    /**\n     * Whether a graph was actually built.\n     *\n     * `false` when this engine has no Web Audio, and also when the settings asked\n     * for nothing — in both cases `track` is `source`, untouched.\n     */\n    readonly supported: boolean;\n}\n\n/** The `AudioContext` constructor this engine exposes, prefixed or not. */\nfunction audioContextConstructor(): typeof AudioContext | undefined {\n    if (typeof AudioContext !== \"undefined\") return AudioContext;\n    return (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n}\n\n/**\n * Whether any of this would change the signal.\n *\n * A chain that only passes audio through still costs a re-encode and a handful of\n * nodes, so a caller that rebuilds on every settings change should ask first —\n * and {@link createVoiceChain} asks too, handing back `source` rather than\n * building a graph that does nothing.\n *\n * @param settings - The stages under consideration.\n * @param gain - The output multiplier that would be applied. Default `1`.\n * @returns `true` when the chain would be audibly transparent.\n */\nexport function isVoiceChainIdle(settings: VoiceChainSettings, gain = 1): boolean {\n    return (\n        !settings.highPass &&\n        !settings.gate &&\n        !settings.compressor &&\n        !settings.presence &&\n        !settings.hissCut &&\n        !settings.deEsser &&\n        !settings.limiter &&\n        gain === 1\n    );\n}\n\n/** A chain that owns nothing, for an engine or a settings object with no work to do. */\nfunction passThrough(source: MediaStreamTrack, ownsSource: boolean): VoiceChain {\n    return {\n        track: source,\n        release: () => {\n            if (ownsSource) source.stop();\n        },\n        supported: false,\n    };\n}\n\n/**\n * Build the processing a microphone is published through.\n *\n * Ordered the way a console is: cut what is not speech, gate what is left, level\n * it, shape it, set how loud it goes out, then hold a ceiling. **The order is not\n * cosmetic.** Gating before the high-pass lets a rumble hold the gate open;\n * compressing before the gate lifts the noise floor up to meet the threshold; and\n * a limiter placed before the output gain is a ceiling the gain then walks\n * straight through.\n *\n * This sits *after* the browser's own echo cancellation and noise suppression,\n * which stay on: the two solve different problems. The browser's is trained on\n * stationary noise inside the capture pipeline; this cuts what it leaves behind\n * and decides when the line should be silent at all.\n *\n * @param source - The captured microphone track.\n * @param settings - Which stages to build. Default {@link DEFAULT_VOICE_CHAIN}.\n * @param options - See {@link VoiceChainOptions}.\n * @returns The track to publish plus its teardown. On an engine with no Web Audio,\n *   and when every stage is off, the source track is handed back untouched and\n *   `supported` is `false` — a call without processing beats a call that throws.\n *   The idle case is decided **before** a context is opened, because browsers cap\n *   how many can be live and one built for a chain that does nothing still counts.\n *\n * @example\n * const floor = await measureNoiseFloor(stream);\n * const chain = createVoiceChain(micTrack, {\n *     ...DEFAULT_VOICE_CHAIN,\n *     gate: true,\n *     gateThreshold: suggestGateThreshold(floor),\n * }, { gain: 1.4 });\n * await mesh.setLocalTrack(\"mic\", chain.track);\n */\nexport function createVoiceChain(\n    source: MediaStreamTrack,\n    settings: VoiceChainSettings = DEFAULT_VOICE_CHAIN,\n    { gain = 1, context: injectedContext, ownsSource = true }: VoiceChainOptions = {},\n): VoiceChain {\n    if (isVoiceChainIdle(settings, gain)) return passThrough(source, ownsSource);\n\n    const Ctor = audioContextConstructor();\n    const context = injectedContext ?? (Ctor ? new Ctor() : null);\n    if (!context) return passThrough(source, ownsSource);\n\n    const input = context.createMediaStreamSource(\n        typeof MediaStream === \"undefined\"\n            ? (source as unknown as MediaStream)\n            : new MediaStream([source]),\n    );\n    const built: AudioNode[] = [input];\n    const stops: (() => void)[] = [];\n    let node: AudioNode = input;\n\n    const chain = (next: AudioNode): void => {\n        node.connect(next);\n        node = next;\n        built.push(next);\n    };\n\n    if (settings.highPass) chain(highPassStage(context));\n\n    if (settings.gate) {\n        const stage = gateStage(context, () => settings.gateThreshold);\n        node.connect(stage.detector);\n        built.push(stage.detector);\n        stops.push(stage.stop);\n        chain(stage.gain);\n    }\n\n    if (settings.compressor) chain(compressorStage(context));\n    if (settings.presence) chain(presenceStage(context));\n    if (settings.hissCut) chain(hissCutStage(context));\n\n    if (settings.deEsser) {\n        const stage = deEsserStage(context);\n        node.connect(stage.band);\n        built.push(stage.band, stage.detector);\n        stops.push(stage.stop);\n        chain(stage.shaper);\n    }\n\n    const output = context.createGain();\n    output.gain.value = gain;\n    chain(output);\n\n    if (settings.limiter) chain(limiterStage(context));\n\n    const destination = context.createMediaStreamDestination();\n    node.connect(destination);\n    built.push(destination);\n    const track = destination.stream.getAudioTracks()[0];\n\n    const teardown = (): void => {\n        for (const stop of stops) stop();\n        for (const built_ of built) built_.disconnect();\n    };\n\n    if (!track) {\n        teardown();\n        return passThrough(source, ownsSource);\n    }\n\n    return {\n        track,\n        release: (): void => {\n            teardown();\n            track.stop();\n            if (ownsSource) source.stop();\n        },\n        supported: true,\n    };\n}\n\n/** A running monitor. */\nexport interface VoiceMonitor {\n    /** Stop listening and release the graph. Does **not** stop the source track. */\n    stop: () => void;\n}\n\n/**\n * Play your own processed microphone back to you.\n *\n * The only way to hear what these filters do without a second person on the call.\n * Every number the chain is tuned by — how deep the de-esser cuts, where the gate\n * sits, how much presence is too much — is a judgement made by ear, and without\n * this the only available ear belongs to somebody else.\n *\n * **Feedback is the hazard, and the reason this is a held, explicit action rather\n * than a setting:** without headphones the speakers feed the microphone that feeds\n * the speakers. Say so in the UI that offers it.\n *\n * @param source - The raw captured track to listen to. It is never stopped here.\n * @param settings - The stages to hear it through. Default {@link DEFAULT_VOICE_CHAIN}.\n * @param options - See {@link VoiceChainOptions}; `ownsSource` is forced to `false`.\n * @returns A handle that stops the monitor.\n */\nexport function monitorVoiceChain(\n    source: MediaStreamTrack,\n    settings: VoiceChainSettings = DEFAULT_VOICE_CHAIN,\n    options: Omit<VoiceChainOptions, \"ownsSource\"> = {},\n): VoiceMonitor {\n    const Ctor = audioContextConstructor();\n    const context = options.context ?? (Ctor ? new Ctor() : null);\n    if (!context) return { stop: () => undefined };\n\n    const chain = createVoiceChain(source, settings, { ...options, context, ownsSource: false });\n    const playback = context.createMediaStreamSource(\n        typeof MediaStream === \"undefined\"\n            ? (chain.track as unknown as MediaStream)\n            : new MediaStream([chain.track]),\n    );\n    playback.connect(context.destination);\n\n    return {\n        stop: (): void => {\n            playback.disconnect();\n            chain.release();\n        },\n    };\n}\n"],"mappings":"A,4CA2CA,IAAaQ,EAA0C,CACnD,SAAU,GACV,KAAM,GACN,cAAe,IACf,WAAY,GACZ,SAAU,GACV,QAAS,GACT,QAAS,GACT,QAAS,EACb,EAuCA,SAASC,GAA2D,CAEhE,OADI,OAAO,aAAiB,IAAoB,aACxC,WAA4D,kBACxE,CAcA,SAAgBC,EAAiB,EAA8B,EAAO,EAAY,CAC9E,MACI,CAACC,EAAS,UACV,CAACA,EAAS,MACV,CAACA,EAAS,YACV,CAACA,EAAS,UACV,CAACA,EAAS,SACV,CAACA,EAAS,SACV,CAACA,EAAS,SACVC,IAAS,CAEjB,CAGA,SAASC,EAAY,EAA0B,EAAiC,CAC5E,MAAO,CACH,MAAOC,EACP,YAAe,CACPC,GAAYD,EAAO,KAAK,CAChC,EACA,UAAW,EACf,CACJ,CAmCA,SAAgBE,EACZ,EACA,EAA+BR,EAC/B,CAAE,OAAO,EAAG,QAASS,EAAiB,aAAa,IAA4B,CAAC,EACtE,CACV,GAAIP,EAAiBC,EAAUC,CAAI,EAAG,OAAOC,EAAYC,EAAQC,CAAU,EAE3E,IAAMG,EAAOT,EAAwB,EAC/BU,EAAUF,IAAoBC,EAAO,IAAIA,EAAS,MACxD,GAAI,CAACC,EAAS,OAAON,EAAYC,EAAQC,CAAU,EAEnD,IAAMK,EAAQD,EAAQ,wBAClB,OAAO,YAAgB,IAChBL,EACD,IAAI,YAAY,CAACA,CAAM,CAAC,CAClC,EACMO,EAAqB,CAACD,CAAK,EAC3BE,EAAwB,CAAC,EAC3BC,EAAkBH,EAEhBI,EAAS,GAA0B,CACrCD,EAAK,QAAQE,CAAI,EACjB,EAAOA,EACPJ,EAAM,KAAKI,CAAI,CACnB,EAIA,GAFId,EAAS,UAAUa,EAAMxB,EAAAA,cAAcmB,CAAO,CAAC,EAE/CR,EAAS,KAAM,CACf,IAAMe,EAAQzB,EAAAA,UAAUkB,MAAeR,EAAS,aAAa,EAC7DY,EAAK,QAAQG,EAAM,QAAQ,EAC3BL,EAAM,KAAKK,EAAM,QAAQ,EACzBJ,EAAM,KAAKI,EAAM,IAAI,EACrBF,EAAME,EAAM,IAAI,CACpB,CAMA,GAJIf,EAAS,YAAYa,EAAMtB,EAAAA,gBAAgBiB,CAAO,CAAC,EACnDR,EAAS,UAAUa,EAAMrB,EAAAA,cAAcgB,CAAO,CAAC,EAC/CR,EAAS,SAASa,EAAMpB,EAAAA,aAAae,CAAO,CAAC,EAE7CR,EAAS,QAAS,CAClB,IAAMe,EAAQrB,EAAAA,aAAac,CAAO,EAClCI,EAAK,QAAQG,EAAM,IAAI,EACvBL,EAAM,KAAKK,EAAM,KAAMA,EAAM,QAAQ,EACrCJ,EAAM,KAAKI,EAAM,IAAI,EACrBF,EAAME,EAAM,MAAM,CACtB,CAEA,IAAMC,EAASR,EAAQ,WAAW,EAClC,EAAO,KAAK,MAAQP,EACpBY,EAAMG,CAAM,EAERhB,EAAS,SAASa,EAAMlB,EAAAA,aAAaa,CAAO,CAAC,EAEjD,IAAMS,EAAcT,EAAQ,6BAA6B,EACzDI,EAAK,QAAQK,CAAW,EACxBP,EAAM,KAAKO,CAAW,EACtB,IAAMC,EAAQD,EAAY,OAAO,eAAe,CAAC,CAAC,GAE5CE,MAAuB,CACzB,IAAK,IAAMC,KAAQT,EAAOS,EAAK,EAC/B,IAAK,IAAMC,KAAUX,EAAOW,EAAO,WAAW,CAClD,EAOA,OALKH,EAKE,CACH,QACA,YAAqB,CACjBC,EAAS,EACTD,EAAM,KAAK,EACPd,GAAYD,EAAO,KAAK,CAChC,EACA,UAAW,EACf,GAZIgB,EAAS,EACFjB,EAAYC,EAAQC,CAAU,EAY7C,CAyBA,SAAgBkB,EACZ,EACA,EAA+BzB,EAC/B,EAAiD,CAAC,EACtC,CACZ,IAAMU,EAAOT,EAAwB,EAC/BU,EAAUe,EAAQ,UAAYhB,EAAO,IAAIA,EAAS,MACxD,GAAI,CAACC,EAAS,MAAO,CAAE,SAAY,IAAA,EAAU,EAE7C,IAAMK,EAAQR,EAAiBF,EAAQH,EAAU,CAAE,GAAGuB,EAAS,UAAS,WAAY,EAAM,CAAC,EACrFC,EAAWhB,EAAQ,wBACrB,OAAO,YAAgB,IAChBK,EAAM,MACP,IAAI,YAAY,CAACA,EAAM,KAAK,CAAC,CACvC,EAGA,OAFAW,EAAS,QAAQhB,EAAQ,WAAW,EAE7B,CACH,SAAkB,CACdgB,EAAS,WAAW,EACpBX,EAAM,QAAQ,CAClB,CACJ,CACJ,C"}

package/dist/audio/voice-chain.js.map

@@ -1 +1 @@
-{"version":3,"file":"voice-chain.js","names":[],"sources":["../../src/audio/voice-chain.ts"],"sourcesContent":["import {\n    compressorStage,\n    deEsserStage,\n    gateStage,\n    highPassStage,\n    hissCutStage,\n    limiterStage,\n    presenceStage,\n} from \"./voice-chain-stages\";\n\n/** Which stages a voice chain builds. */\nexport interface VoiceChainSettings {\n    /** Cut everything below speech: fans, traffic rumble, desk knocks, plosives. */\n    highPass: boolean;\n    /** Silence the line when nobody is talking. */\n    gate: boolean;\n    /** RMS below which the gate closes, 0..1. See {@link suggestGateThreshold}. */\n    gateThreshold: number;\n    /** Even out the distance between a whisper and a shout. */\n    compressor: boolean;\n    /** Lift the consonant band so speech reads without getting louder. */\n    presence: boolean;\n    /** Roll off hiss above what speech uses. */\n    hissCut: boolean;\n    /** Ride down harsh S and CH sounds. */\n    deEsser: boolean;\n    /**\n     * Hard ceiling before the signal leaves.\n     *\n     * On by default and worth leaving on: the leveller is 3:1, which controls the\n     * average and lets a peak through, and `gain` can reach well above 1.\n     */\n    limiter: boolean;\n}\n\n/**\n * What a call wants before anybody touches a slider.\n *\n * High-pass, leveller and limiter only. Gate, presence, hiss cut and de-esser are\n * off because each has an audible cost when it is not needed — a gate set for the\n * wrong room clips words, presence on a bright microphone is harsh, and a de-esser\n * on a voice that does not hiss just dulls it.\n */\nexport const DEFAULT_VOICE_CHAIN: VoiceChainSettings = {\n    highPass: true,\n    gate: false,\n    gateThreshold: 0.02,\n    compressor: true,\n    presence: false,\n    hissCut: false,\n    deEsser: false,\n    limiter: true,\n};\n\n/** Options for {@link createVoiceChain}. */\nexport interface VoiceChainOptions {\n    /** Output multiplier, applied after every stage and before the limiter. Default `1`. */\n    gain?: number;\n    /**\n     * Reuse an existing `AudioContext` instead of creating one.\n     *\n     * Browsers cap live contexts (Chrome allows around six), so a page that already\n     * has one — a level meter, an audio bus — should hand it over.\n     */\n    context?: AudioContext;\n    /**\n     * Whether `release()` also stops `source`. Default `true`.\n     *\n     * Pass `false` when the track belongs to somebody else: a settings dialog\n     * building a second chain over its live preview would otherwise kill the meter\n     * the person is watching while they listen.\n     */\n    ownsSource?: boolean;\n}\n\n/** A running voice chain. */\nexport interface VoiceChain {\n    /** The processed track to publish. */\n    track: MediaStreamTrack;\n    /** Stop the detectors, disconnect the graph, and release the track. */\n    release: () => void;\n    /**\n     * Whether a graph was actually built.\n     *\n     * `false` when this engine has no Web Audio, and also when the settings asked\n     * for nothing — in both cases `track` is `source`, untouched.\n     */\n    readonly supported: boolean;\n}\n\n/** The `AudioContext` constructor this engine exposes, prefixed or not. */\nfunction audioContextConstructor(): typeof AudioContext | undefined {\n    if (typeof AudioContext !== \"undefined\") return AudioContext;\n    return (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n}\n\n/**\n * Whether any of this would change the signal.\n *\n * A chain that only passes audio through still costs a re-encode and a handful of\n * nodes, so a caller that rebuilds on every settings change should ask first —\n * and {@link createVoiceChain} asks too, handing back `source` rather than\n * building a graph that does nothing.\n *\n * @param settings - The stages under consideration.\n * @param gain - The output multiplier that would be applied. Default `1`.\n * @returns `true` when the chain would be audibly transparent.\n */\nexport function isVoiceChainIdle(settings: VoiceChainSettings, gain = 1): boolean {\n    return (\n        !settings.highPass &&\n        !settings.gate &&\n        !settings.compressor &&\n        !settings.presence &&\n        !settings.hissCut &&\n        !settings.deEsser &&\n        !settings.limiter &&\n        gain === 1\n    );\n}\n\n/** A chain that owns nothing, for an engine or a settings object with no work to do. */\nfunction passThrough(source: MediaStreamTrack, ownsSource: boolean): VoiceChain {\n    return {\n        track: source,\n        release: () => {\n            if (ownsSource) source.stop();\n        },\n        supported: false,\n    };\n}\n\n/**\n * Build the processing a microphone is published through.\n *\n * Ordered the way a console is: cut what is not speech, gate what is left, level\n * it, shape it, set how loud it goes out, then hold a ceiling. **The order is not\n * cosmetic.** Gating before the high-pass lets a rumble hold the gate open;\n * compressing before the gate lifts the noise floor up to meet the threshold; and\n * a limiter placed before the output gain is a ceiling the gain then walks\n * straight through.\n *\n * This sits *after* the browser's own echo cancellation and noise suppression,\n * which stay on: the two solve different problems. The browser's is trained on\n * stationary noise inside the capture pipeline; this cuts what it leaves behind\n * and decides when the line should be silent at all.\n *\n * @param source - The captured microphone track.\n * @param settings - Which stages to build. Default {@link DEFAULT_VOICE_CHAIN}.\n * @param options - See {@link VoiceChainOptions}.\n * @returns The track to publish plus its teardown. On an engine with no Web Audio,\n *   and when every stage is off, the source track is handed back untouched and\n *   `supported` is `false` — a call without processing beats a call that throws.\n *   The idle case is decided **before** a context is opened, because browsers cap\n *   how many can be live and one built for a chain that does nothing still counts.\n *\n * @example\n * const floor = await measureNoiseFloor(stream);\n * const chain = createVoiceChain(micTrack, {\n *     ...DEFAULT_VOICE_CHAIN,\n *     gate: true,\n *     gateThreshold: suggestGateThreshold(floor),\n * }, { gain: 1.4 });\n * await mesh.setLocalTrack(\"mic\", chain.track);\n */\nexport function createVoiceChain(\n    source: MediaStreamTrack,\n    settings: VoiceChainSettings = DEFAULT_VOICE_CHAIN,\n    { gain = 1, context: injectedContext, ownsSource = true }: VoiceChainOptions = {},\n): VoiceChain {\n    if (isVoiceChainIdle(settings, gain)) return passThrough(source, ownsSource);\n\n    const Ctor = audioContextConstructor();\n    const context = injectedContext ?? (Ctor ? new Ctor() : null);\n    if (!context) return passThrough(source, ownsSource);\n\n    const input = context.createMediaStreamSource(\n        typeof MediaStream === \"undefined\"\n            ? (source as unknown as MediaStream)\n            : new MediaStream([source]),\n    );\n    const built: AudioNode[] = [input];\n    const stops: (() => void)[] = [];\n    let node: AudioNode = input;\n\n    const chain = (next: AudioNode): void => {\n        node.connect(next);\n        node = next;\n        built.push(next);\n    };\n\n    if (settings.highPass) chain(highPassStage(context));\n\n    if (settings.gate) {\n        const stage = gateStage(context, () => settings.gateThreshold);\n        node.connect(stage.detector);\n        built.push(stage.detector);\n        stops.push(stage.stop);\n        chain(stage.gain);\n    }\n\n    if (settings.compressor) chain(compressorStage(context));\n    if (settings.presence) chain(presenceStage(context));\n    if (settings.hissCut) chain(hissCutStage(context));\n\n    if (settings.deEsser) {\n        const stage = deEsserStage(context);\n        node.connect(stage.band);\n        built.push(stage.band, stage.detector);\n        stops.push(stage.stop);\n        chain(stage.shaper);\n    }\n\n    const output = context.createGain();\n    output.gain.value = gain;\n    chain(output);\n\n    if (settings.limiter) chain(limiterStage(context));\n\n    const destination = context.createMediaStreamDestination();\n    node.connect(destination);\n    built.push(destination);\n    const track = destination.stream.getAudioTracks()[0];\n\n    const teardown = (): void => {\n        for (const stop of stops) stop();\n        for (const built_ of built) built_.disconnect();\n    };\n\n    if (!track) {\n        teardown();\n        return passThrough(source, ownsSource);\n    }\n\n    return {\n        track,\n        release: (): void => {\n            teardown();\n            track.stop();\n            if (ownsSource) source.stop();\n        },\n        supported: true,\n    };\n}\n\n/** A running monitor. */\nexport interface VoiceMonitor {\n    /** Stop listening and release the graph. Does **not** stop the source track. */\n    stop: () => void;\n}\n\n/**\n * Play your own processed microphone back to you.\n *\n * The only way to hear what these filters do without a second person on the call.\n * Every number the chain is tuned by — how deep the de-esser cuts, where the gate\n * sits, how much presence is too much — is a judgement made by ear, and without\n * this the only available ear belongs to somebody else.\n *\n * **Feedback is the hazard, and the reason this is a held, explicit action rather\n * than a setting:** without headphones the speakers feed the microphone that feeds\n * the speakers. Say so in the UI that offers it.\n *\n * @param source - The raw captured track to listen to. It is never stopped here.\n * @param settings - The stages to hear it through. Default {@link DEFAULT_VOICE_CHAIN}.\n * @param options - See {@link VoiceChainOptions}; `ownsSource` is forced to `false`.\n * @returns A handle that stops the monitor.\n */\nexport function monitorVoiceChain(\n    source: MediaStreamTrack,\n    settings: VoiceChainSettings = DEFAULT_VOICE_CHAIN,\n    options: Omit<VoiceChainOptions, \"ownsSource\"> = {},\n): VoiceMonitor {\n    const Ctor = audioContextConstructor();\n    const context = options.context ?? (Ctor ? new Ctor() : null);\n    if (!context) return { stop: () => undefined };\n\n    const chain = createVoiceChain(source, settings, { ...options, context, ownsSource: false });\n    const playback = context.createMediaStreamSource(\n        typeof MediaStream === \"undefined\"\n            ? (chain.track as unknown as MediaStream)\n            : new MediaStream([chain.track]),\n    );\n    playback.connect(context.destination);\n\n    return {\n        stop: (): void => {\n            playback.disconnect();\n            chain.release();\n        },\n    };\n}\n"],"mappings":"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"}
+{"version":3,"file":"voice-chain.js","names":["DEFAULT_VOICE_CHAIN","audioContextConstructor","isVoiceChainIdle","settings","gain","passThrough","source","ownsSource","createVoiceChain","injectedContext","Ctor","context","input","built","stops","node","chain","next","highPassStage","stage","gateStage","compressorStage","presenceStage","hissCutStage","deEsserStage","output","limiterStage","destination","track","teardown","stop","built_","monitorVoiceChain","options","playback"],"sources":["../../src/audio/voice-chain.ts"],"sourcesContent":["import {\n    compressorStage,\n    deEsserStage,\n    gateStage,\n    highPassStage,\n    hissCutStage,\n    limiterStage,\n    presenceStage,\n} from \"./voice-chain-stages\";\n\n/** Which stages a voice chain builds. */\nexport interface VoiceChainSettings {\n    /** Cut everything below speech: fans, traffic rumble, desk knocks, plosives. */\n    highPass: boolean;\n    /** Silence the line when nobody is talking. */\n    gate: boolean;\n    /** RMS below which the gate closes, 0..1. See {@link suggestGateThreshold}. */\n    gateThreshold: number;\n    /** Even out the distance between a whisper and a shout. */\n    compressor: boolean;\n    /** Lift the consonant band so speech reads without getting louder. */\n    presence: boolean;\n    /** Roll off hiss above what speech uses. */\n    hissCut: boolean;\n    /** Ride down harsh S and CH sounds. */\n    deEsser: boolean;\n    /**\n     * Hard ceiling before the signal leaves.\n     *\n     * On by default and worth leaving on: the leveller is 3:1, which controls the\n     * average and lets a peak through, and `gain` can reach well above 1.\n     */\n    limiter: boolean;\n}\n\n/**\n * What a call wants before anybody touches a slider.\n *\n * High-pass, leveller and limiter only. Gate, presence, hiss cut and de-esser are\n * off because each has an audible cost when it is not needed — a gate set for the\n * wrong room clips words, presence on a bright microphone is harsh, and a de-esser\n * on a voice that does not hiss just dulls it.\n */\nexport const DEFAULT_VOICE_CHAIN: VoiceChainSettings = {\n    highPass: true,\n    gate: false,\n    gateThreshold: 0.02,\n    compressor: true,\n    presence: false,\n    hissCut: false,\n    deEsser: false,\n    limiter: true,\n};\n\n/** Options for {@link createVoiceChain}. */\nexport interface VoiceChainOptions {\n    /** Output multiplier, applied after every stage and before the limiter. Default `1`. */\n    gain?: number;\n    /**\n     * Reuse an existing `AudioContext` instead of creating one.\n     *\n     * Browsers cap live contexts (Chrome allows around six), so a page that already\n     * has one — a level meter, an audio bus — should hand it over.\n     */\n    context?: AudioContext;\n    /**\n     * Whether `release()` also stops `source`. Default `true`.\n     *\n     * Pass `false` when the track belongs to somebody else: a settings dialog\n     * building a second chain over its live preview would otherwise kill the meter\n     * the person is watching while they listen.\n     */\n    ownsSource?: boolean;\n}\n\n/** A running voice chain. */\nexport interface VoiceChain {\n    /** The processed track to publish. */\n    track: MediaStreamTrack;\n    /** Stop the detectors, disconnect the graph, and release the track. */\n    release: () => void;\n    /**\n     * Whether a graph was actually built.\n     *\n     * `false` when this engine has no Web Audio, and also when the settings asked\n     * for nothing — in both cases `track` is `source`, untouched.\n     */\n    readonly supported: boolean;\n}\n\n/** The `AudioContext` constructor this engine exposes, prefixed or not. */\nfunction audioContextConstructor(): typeof AudioContext | undefined {\n    if (typeof AudioContext !== \"undefined\") return AudioContext;\n    return (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n}\n\n/**\n * Whether any of this would change the signal.\n *\n * A chain that only passes audio through still costs a re-encode and a handful of\n * nodes, so a caller that rebuilds on every settings change should ask first —\n * and {@link createVoiceChain} asks too, handing back `source` rather than\n * building a graph that does nothing.\n *\n * @param settings - The stages under consideration.\n * @param gain - The output multiplier that would be applied. Default `1`.\n * @returns `true` when the chain would be audibly transparent.\n */\nexport function isVoiceChainIdle(settings: VoiceChainSettings, gain = 1): boolean {\n    return (\n        !settings.highPass &&\n        !settings.gate &&\n        !settings.compressor &&\n        !settings.presence &&\n        !settings.hissCut &&\n        !settings.deEsser &&\n        !settings.limiter &&\n        gain === 1\n    );\n}\n\n/** A chain that owns nothing, for an engine or a settings object with no work to do. */\nfunction passThrough(source: MediaStreamTrack, ownsSource: boolean): VoiceChain {\n    return {\n        track: source,\n        release: () => {\n            if (ownsSource) source.stop();\n        },\n        supported: false,\n    };\n}\n\n/**\n * Build the processing a microphone is published through.\n *\n * Ordered the way a console is: cut what is not speech, gate what is left, level\n * it, shape it, set how loud it goes out, then hold a ceiling. **The order is not\n * cosmetic.** Gating before the high-pass lets a rumble hold the gate open;\n * compressing before the gate lifts the noise floor up to meet the threshold; and\n * a limiter placed before the output gain is a ceiling the gain then walks\n * straight through.\n *\n * This sits *after* the browser's own echo cancellation and noise suppression,\n * which stay on: the two solve different problems. The browser's is trained on\n * stationary noise inside the capture pipeline; this cuts what it leaves behind\n * and decides when the line should be silent at all.\n *\n * @param source - The captured microphone track.\n * @param settings - Which stages to build. Default {@link DEFAULT_VOICE_CHAIN}.\n * @param options - See {@link VoiceChainOptions}.\n * @returns The track to publish plus its teardown. On an engine with no Web Audio,\n *   and when every stage is off, the source track is handed back untouched and\n *   `supported` is `false` — a call without processing beats a call that throws.\n *   The idle case is decided **before** a context is opened, because browsers cap\n *   how many can be live and one built for a chain that does nothing still counts.\n *\n * @example\n * const floor = await measureNoiseFloor(stream);\n * const chain = createVoiceChain(micTrack, {\n *     ...DEFAULT_VOICE_CHAIN,\n *     gate: true,\n *     gateThreshold: suggestGateThreshold(floor),\n * }, { gain: 1.4 });\n * await mesh.setLocalTrack(\"mic\", chain.track);\n */\nexport function createVoiceChain(\n    source: MediaStreamTrack,\n    settings: VoiceChainSettings = DEFAULT_VOICE_CHAIN,\n    { gain = 1, context: injectedContext, ownsSource = true }: VoiceChainOptions = {},\n): VoiceChain {\n    if (isVoiceChainIdle(settings, gain)) return passThrough(source, ownsSource);\n\n    const Ctor = audioContextConstructor();\n    const context = injectedContext ?? (Ctor ? new Ctor() : null);\n    if (!context) return passThrough(source, ownsSource);\n\n    const input = context.createMediaStreamSource(\n        typeof MediaStream === \"undefined\"\n            ? (source as unknown as MediaStream)\n            : new MediaStream([source]),\n    );\n    const built: AudioNode[] = [input];\n    const stops: (() => void)[] = [];\n    let node: AudioNode = input;\n\n    const chain = (next: AudioNode): void => {\n        node.connect(next);\n        node = next;\n        built.push(next);\n    };\n\n    if (settings.highPass) chain(highPassStage(context));\n\n    if (settings.gate) {\n        const stage = gateStage(context, () => settings.gateThreshold);\n        node.connect(stage.detector);\n        built.push(stage.detector);\n        stops.push(stage.stop);\n        chain(stage.gain);\n    }\n\n    if (settings.compressor) chain(compressorStage(context));\n    if (settings.presence) chain(presenceStage(context));\n    if (settings.hissCut) chain(hissCutStage(context));\n\n    if (settings.deEsser) {\n        const stage = deEsserStage(context);\n        node.connect(stage.band);\n        built.push(stage.band, stage.detector);\n        stops.push(stage.stop);\n        chain(stage.shaper);\n    }\n\n    const output = context.createGain();\n    output.gain.value = gain;\n    chain(output);\n\n    if (settings.limiter) chain(limiterStage(context));\n\n    const destination = context.createMediaStreamDestination();\n    node.connect(destination);\n    built.push(destination);\n    const track = destination.stream.getAudioTracks()[0];\n\n    const teardown = (): void => {\n        for (const stop of stops) stop();\n        for (const built_ of built) built_.disconnect();\n    };\n\n    if (!track) {\n        teardown();\n        return passThrough(source, ownsSource);\n    }\n\n    return {\n        track,\n        release: (): void => {\n            teardown();\n            track.stop();\n            if (ownsSource) source.stop();\n        },\n        supported: true,\n    };\n}\n\n/** A running monitor. */\nexport interface VoiceMonitor {\n    /** Stop listening and release the graph. Does **not** stop the source track. */\n    stop: () => void;\n}\n\n/**\n * Play your own processed microphone back to you.\n *\n * The only way to hear what these filters do without a second person on the call.\n * Every number the chain is tuned by — how deep the de-esser cuts, where the gate\n * sits, how much presence is too much — is a judgement made by ear, and without\n * this the only available ear belongs to somebody else.\n *\n * **Feedback is the hazard, and the reason this is a held, explicit action rather\n * than a setting:** without headphones the speakers feed the microphone that feeds\n * the speakers. Say so in the UI that offers it.\n *\n * @param source - The raw captured track to listen to. It is never stopped here.\n * @param settings - The stages to hear it through. Default {@link DEFAULT_VOICE_CHAIN}.\n * @param options - See {@link VoiceChainOptions}; `ownsSource` is forced to `false`.\n * @returns A handle that stops the monitor.\n */\nexport function monitorVoiceChain(\n    source: MediaStreamTrack,\n    settings: VoiceChainSettings = DEFAULT_VOICE_CHAIN,\n    options: Omit<VoiceChainOptions, \"ownsSource\"> = {},\n): VoiceMonitor {\n    const Ctor = audioContextConstructor();\n    const context = options.context ?? (Ctor ? new Ctor() : null);\n    if (!context) return { stop: () => undefined };\n\n    const chain = createVoiceChain(source, settings, { ...options, context, ownsSource: false });\n    const playback = context.createMediaStreamSource(\n        typeof MediaStream === \"undefined\"\n            ? (chain.track as unknown as MediaStream)\n            : new MediaStream([chain.track]),\n    );\n    playback.connect(context.destination);\n\n    return {\n        stop: (): void => {\n            playback.disconnect();\n            chain.release();\n        },\n    };\n}\n"],"mappings":"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"}

package/dist/audio/wav.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"wav.cjs","names":[],"sources":["../../src/audio/wav.ts"],"sourcesContent":["/** Raw PCM ready to be wrapped in a RIFF container. */\nexport interface PcmAudio {\n    /** One `Float32Array` per channel, samples in −1…1. */\n    channels: readonly Float32Array[];\n    sampleRate: number;\n}\n\n/** Options for {@link blobToWav}. */\nexport interface WavOptions {\n    /**\n     * Mix down to one channel. Default `false`.\n     *\n     * Worth turning on for speech headed to a server: a microphone recorded in stereo\n     * carries two nearly identical channels and doubles the upload for nothing.\n     */\n    mono?: boolean;\n    /**\n     * Resample to this rate. Default: keep the source rate.\n     *\n     * 16000 is the rate most speech-to-text APIs want, and dropping 48 kHz to 16 kHz\n     * removes two thirds of the bytes with no audible loss on voice.\n     */\n    sampleRate?: number;\n}\n\n/** Bytes per sample in the output. 16-bit PCM is what every decoder accepts. */\nconst BYTES_PER_SAMPLE = 2;\n\n/**\n * Wrap PCM in a 16-bit RIFF/WAVE container.\n *\n * The header is the 44-byte canonical form: `RIFF` size, `WAVE`, a 16-byte `fmt `\n * chunk declaring format 1 (uncompressed PCM), then `data`. Samples are interleaved\n * and clamped before scaling, because a value even slightly past ±1 wraps around when\n * truncated to 16 bits and turns a loud passage into a burst of noise.\n *\n * Implemented here rather than pulled from a package: it is a fixed header and a\n * scaling loop, roughly forty lines, and a dependency for it would put its own\n * version bounds on every consumer of this SDK to save writing them.\n *\n * @param audio - Channels and sample rate.\n * @returns A `Blob` of type `audio/wav`.\n */\nexport function encodeWav({ channels, sampleRate }: PcmAudio): Blob {\n    const channelCount = Math.max(1, channels.length);\n    const frameCount = channels[0]?.length ?? 0;\n    const dataBytes = frameCount * channelCount * BYTES_PER_SAMPLE;\n    const buffer = new ArrayBuffer(44 + dataBytes);\n    const view = new DataView(buffer);\n\n    const ascii = (offset: number, text: string): void => {\n        for (let index = 0; index < text.length; index += 1) {\n            view.setUint8(offset + index, text.charCodeAt(index));\n        }\n    };\n\n    const byteRate = sampleRate * channelCount * BYTES_PER_SAMPLE;\n    ascii(0, \"RIFF\");\n    view.setUint32(4, 36 + dataBytes, true);\n    ascii(8, \"WAVE\");\n    ascii(12, \"fmt \");\n    view.setUint32(16, 16, true);\n    view.setUint16(20, 1, true);\n    view.setUint16(22, channelCount, true);\n    view.setUint32(24, sampleRate, true);\n    view.setUint32(28, byteRate, true);\n    view.setUint16(32, channelCount * BYTES_PER_SAMPLE, true);\n    view.setUint16(34, BYTES_PER_SAMPLE * 8, true);\n    ascii(36, \"data\");\n    view.setUint32(40, dataBytes, true);\n\n    let offset = 44;\n    for (let frame = 0; frame < frameCount; frame += 1) {\n        for (let channel = 0; channel < channelCount; channel += 1) {\n            const sample = channels[channel]?.[frame] ?? 0;\n            const clamped = sample < -1 ? -1 : sample > 1 ? 1 : sample;\n            // Asymmetric scaling: 16-bit PCM runs −32768…32767.\n            view.setInt16(offset, clamped < 0 ? clamped * 0x8000 : clamped * 0x7fff, true);\n            offset += BYTES_PER_SAMPLE;\n        }\n    }\n\n    return new Blob([buffer], { type: \"audio/wav\" });\n}\n\n/** Average every channel of a decoded buffer into one. */\nfunction mixToMono(buffer: AudioBuffer): Float32Array {\n    const frames = buffer.length;\n    const out = new Float32Array(frames);\n    for (let channel = 0; channel < buffer.numberOfChannels; channel += 1) {\n        const data = buffer.getChannelData(channel);\n        for (let frame = 0; frame < frames; frame += 1) out[frame] += data[frame];\n    }\n    if (buffer.numberOfChannels > 1) {\n        for (let frame = 0; frame < frames; frame += 1) out[frame] /= buffer.numberOfChannels;\n    }\n    return out;\n}\n\n/**\n * Convert a recording to 16-bit WAV, with no dependency.\n *\n * `MediaRecorder` cannot produce WAV — it emits Opus on Chromium and Firefox and AAC\n * on Safari — so a backend that insists on WAV has to be served either by a\n * server-side transcode or by this. It decodes through `AudioContext.decodeAudioData`,\n * which is the browser's own decoder for whatever container the recorder chose, then\n * re-encodes the PCM.\n *\n * !!! The cost is real: WAV is uncompressed, so the same voice note that is 40 KB in\n * Opus is roughly 500 KB here at 48 kHz stereo. `{ mono: true, sampleRate: 16000 }`\n * takes that to about 80 KB and is what a speech-to-text endpoint wants anyway.\n *\n * Resampling uses `OfflineAudioContext`, i.e. the browser's own resampler, rather\n * than a hand-rolled one — this is exactly the \"we want the underlying call, not a\n * wrapper\" case.\n *\n * @param blob - A recording from {@link createAudioRecorder}, or any decodable audio.\n * @param options - See {@link WavOptions}.\n * @returns A `Blob` of type `audio/wav`.\n * @throws When the environment has no Web Audio, or the blob cannot be decoded.\n */\nexport async function blobToWav(blob: Blob, options: WavOptions = {}): Promise<Blob> {\n    const { mono = false, sampleRate: target } = options;\n\n    const Ctor: typeof AudioContext | undefined =\n        typeof AudioContext !== \"undefined\"\n            ? AudioContext\n            : (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!Ctor) throw new Error(\"Web Audio is not available in this environment.\");\n\n    const context = new Ctor();\n    let decoded: AudioBuffer;\n    try {\n        decoded = await context.decodeAudioData(await blob.arrayBuffer());\n    } finally {\n        void context.close().catch(() => undefined);\n    }\n\n    const wantedChannels = mono ? 1 : decoded.numberOfChannels;\n    const wantedRate = target ?? decoded.sampleRate;\n\n    if (wantedRate === decoded.sampleRate) {\n        const channels = mono\n            ? [mixToMono(decoded)]\n            : Array.from({ length: decoded.numberOfChannels }, (_, index) =>\n                  decoded.getChannelData(index),\n              );\n        return encodeWav({ channels, sampleRate: decoded.sampleRate });\n    }\n\n    const Offline: typeof OfflineAudioContext | undefined =\n        typeof OfflineAudioContext !== \"undefined\" ? OfflineAudioContext : undefined;\n    if (!Offline) throw new Error(\"Resampling requires OfflineAudioContext.\");\n\n    const frames = Math.max(1, Math.round((decoded.duration * wantedRate) | 0) || 1);\n    const offline = new Offline(wantedChannels, frames, wantedRate);\n    const source = offline.createBufferSource();\n    source.buffer = decoded;\n    source.connect(offline.destination);\n    source.start();\n    const rendered = await offline.startRendering();\n\n    return encodeWav({\n        channels: Array.from({ length: rendered.numberOfChannels }, (_, index) =>\n            rendered.getChannelData(index),\n        ),\n        sampleRate: rendered.sampleRate,\n    });\n}\n"],"mappings":"AA2CA,SAAgB,EAAU,CAAE,WAAU,cAA8B,CAChE,IAAM,EAAe,KAAK,IAAI,EAAG,EAAS,MAAM,EAC1C,EAAa,EAAS,EAAE,EAAE,QAAU,EACpC,EAAY,EAAa,EAAe,EACxC,EAAS,IAAI,YAAY,GAAK,CAAS,EACvC,EAAO,IAAI,SAAS,CAAM,EAE1B,GAAS,EAAgB,IAAuB,CAClD,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAK,OAAQ,GAAS,EAC9C,EAAK,SAAS,EAAS,EAAO,EAAK,WAAW,CAAK,CAAC,CAE5D,EAEM,EAAW,EAAa,EAAe,EAC7C,EAAM,EAAG,MAAM,EACf,EAAK,UAAU,EAAG,GAAK,EAAW,EAAI,EACtC,EAAM,EAAG,MAAM,EACf,EAAM,GAAI,MAAM,EAChB,EAAK,UAAU,GAAI,GAAI,EAAI,EAC3B,EAAK,UAAU,GAAI,EAAG,EAAI,EAC1B,EAAK,UAAU,GAAI,EAAc,EAAI,EACrC,EAAK,UAAU,GAAI,EAAY,EAAI,EACnC,EAAK,UAAU,GAAI,EAAU,EAAI,EACjC,EAAK,UAAU,GAAI,EAAe,EAAkB,EAAI,EACxD,EAAK,UAAU,GAAI,GAAsB,EAAI,EAC7C,EAAM,GAAI,MAAM,EAChB,EAAK,UAAU,GAAI,EAAW,EAAI,EAElC,IAAI,EAAS,GACb,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAY,GAAS,EAC7C,IAAK,IAAI,EAAU,EAAG,EAAU,EAAc,GAAW,EAAG,CACxD,IAAM,EAAS,EAAS,EAAQ,GAAG,IAAU,EACvC,EAAU,EAAS,GAAK,GAAK,EAAS,EAAI,EAAI,EAEpD,EAAK,SAAS,EAAQ,EAAU,EAAI,EAAU,MAAS,EAAU,MAAQ,EAAI,EAC7E,GAAU,CACd,CAGJ,OAAO,IAAI,KAAK,CAAC,CAAM,EAAG,CAAE,KAAM,WAAY,CAAC,CACnD,CAGA,SAAS,EAAU,EAAmC,CAClD,IAAM,EAAS,EAAO,OAChB,EAAM,IAAI,aAAa,CAAM,EACnC,IAAK,IAAI,EAAU,EAAG,EAAU,EAAO,iBAAkB,GAAW,EAAG,CACnE,IAAM,EAAO,EAAO,eAAe,CAAO,EAC1C,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAQ,GAAS,EAAG,EAAI,IAAU,EAAK,EACvE,CACA,GAAI,EAAO,iBAAmB,EAC1B,IAAK,IAAI,EAAQ,EAAG,EAAQ,EAAQ,GAAS,EAAG,EAAI,IAAU,EAAO,iBAEzE,OAAO,CACX,CAwBA,eAAsB,EAAU,EAAY,EAAsB,CAAC,EAAkB,CACjF,GAAM,CAAE,OAAO,GAAO,WAAY,GAAW,EAEvC,EACF,OAAO,aAAiB,IAClB,aACC,WAA4D,mBACvE,GAAI,CAAC,EAAM,MAAU,MAAM,iDAAiD,EAE5E,IAAM,EAAU,IAAI,EAChB,EACJ,GAAI,CACA,EAAU,MAAM,EAAQ,gBAAgB,MAAM,EAAK,YAAY,CAAC,CACpE,QAAU,CACN,EAAa,MAAM,CAAC,CAAC,UAAY,IAAA,EAAS,CAC9C,CAEA,IAAM,EAAiB,EAAO,EAAI,EAAQ,iBACpC,EAAa,GAAU,EAAQ,WAErC,GAAI,IAAe,EAAQ,WAMvB,OAAO,EAAU,CAAE,SALF,EACX,CAAC,EAAU,CAAO,CAAC,EACnB,MAAM,KAAK,CAAE,OAAQ,EAAQ,gBAAiB,GAAI,EAAG,IACjD,EAAQ,eAAe,CAAK,CAChC,EACuB,WAAY,EAAQ,UAAW,CAAC,EAGjE,IAAM,EACF,OAAO,oBAAwB,IAAc,oBAAsB,IAAA,GACvE,GAAI,CAAC,EAAS,MAAU,MAAM,0CAA0C,EAGxE,IAAM,EAAU,IAAI,EAAQ,EADb,KAAK,IAAI,EAAG,KAAK,MAAO,EAAQ,SAAW,EAAc,CAAC,GAAK,CAClC,EAAQ,CAAU,EACxD,EAAS,EAAQ,mBAAmB,EAC1C,EAAO,OAAS,EAChB,EAAO,QAAQ,EAAQ,WAAW,EAClC,EAAO,MAAM,EACb,IAAM,EAAW,MAAM,EAAQ,eAAe,EAE9C,OAAO,EAAU,CACb,SAAU,MAAM,KAAK,CAAE,OAAQ,EAAS,gBAAiB,GAAI,EAAG,IAC5D,EAAS,eAAe,CAAK,CACjC,EACA,WAAY,EAAS,UACzB,CAAC,CACL"}
+{"version":3,"file":"wav.cjs","names":["encodeWav","channelCount","channels","frameCount","dataBytes","buffer","view","ascii","index","text","offset","byteRate","sampleRate","frame","channel","sample","clamped","mixToMono","frames","out","data","blobToWav","target","options","Ctor","context","decoded","blob","wantedChannels","mono","wantedRate","Offline","offline","source","rendered"],"sources":["../../src/audio/wav.ts"],"sourcesContent":["/** Raw PCM ready to be wrapped in a RIFF container. */\nexport interface PcmAudio {\n    /** One `Float32Array` per channel, samples in −1…1. */\n    channels: readonly Float32Array[];\n    sampleRate: number;\n}\n\n/** Options for {@link blobToWav}. */\nexport interface WavOptions {\n    /**\n     * Mix down to one channel. Default `false`.\n     *\n     * Worth turning on for speech headed to a server: a microphone recorded in stereo\n     * carries two nearly identical channels and doubles the upload for nothing.\n     */\n    mono?: boolean;\n    /**\n     * Resample to this rate. Default: keep the source rate.\n     *\n     * 16000 is the rate most speech-to-text APIs want, and dropping 48 kHz to 16 kHz\n     * removes two thirds of the bytes with no audible loss on voice.\n     */\n    sampleRate?: number;\n}\n\n/** Bytes per sample in the output. 16-bit PCM is what every decoder accepts. */\nconst BYTES_PER_SAMPLE = 2;\n\n/**\n * Wrap PCM in a 16-bit RIFF/WAVE container.\n *\n * The header is the 44-byte canonical form: `RIFF` size, `WAVE`, a 16-byte `fmt `\n * chunk declaring format 1 (uncompressed PCM), then `data`. Samples are interleaved\n * and clamped before scaling, because a value even slightly past ±1 wraps around when\n * truncated to 16 bits and turns a loud passage into a burst of noise.\n *\n * Implemented here rather than pulled from a package: it is a fixed header and a\n * scaling loop, roughly forty lines, and a dependency for it would put its own\n * version bounds on every consumer of this SDK to save writing them.\n *\n * @param audio - Channels and sample rate.\n * @returns A `Blob` of type `audio/wav`.\n */\nexport function encodeWav({ channels, sampleRate }: PcmAudio): Blob {\n    const channelCount = Math.max(1, channels.length);\n    const frameCount = channels[0]?.length ?? 0;\n    const dataBytes = frameCount * channelCount * BYTES_PER_SAMPLE;\n    const buffer = new ArrayBuffer(44 + dataBytes);\n    const view = new DataView(buffer);\n\n    const ascii = (offset: number, text: string): void => {\n        for (let index = 0; index < text.length; index += 1) {\n            view.setUint8(offset + index, text.charCodeAt(index));\n        }\n    };\n\n    const byteRate = sampleRate * channelCount * BYTES_PER_SAMPLE;\n    ascii(0, \"RIFF\");\n    view.setUint32(4, 36 + dataBytes, true);\n    ascii(8, \"WAVE\");\n    ascii(12, \"fmt \");\n    view.setUint32(16, 16, true);\n    view.setUint16(20, 1, true);\n    view.setUint16(22, channelCount, true);\n    view.setUint32(24, sampleRate, true);\n    view.setUint32(28, byteRate, true);\n    view.setUint16(32, channelCount * BYTES_PER_SAMPLE, true);\n    view.setUint16(34, BYTES_PER_SAMPLE * 8, true);\n    ascii(36, \"data\");\n    view.setUint32(40, dataBytes, true);\n\n    let offset = 44;\n    for (let frame = 0; frame < frameCount; frame += 1) {\n        for (let channel = 0; channel < channelCount; channel += 1) {\n            const sample = channels[channel]?.[frame] ?? 0;\n            const clamped = sample < -1 ? -1 : sample > 1 ? 1 : sample;\n            // Asymmetric scaling: 16-bit PCM runs −32768…32767.\n            view.setInt16(offset, clamped < 0 ? clamped * 0x8000 : clamped * 0x7fff, true);\n            offset += BYTES_PER_SAMPLE;\n        }\n    }\n\n    return new Blob([buffer], { type: \"audio/wav\" });\n}\n\n/** Average every channel of a decoded buffer into one. */\nfunction mixToMono(buffer: AudioBuffer): Float32Array {\n    const frames = buffer.length;\n    const out = new Float32Array(frames);\n    for (let channel = 0; channel < buffer.numberOfChannels; channel += 1) {\n        const data = buffer.getChannelData(channel);\n        for (let frame = 0; frame < frames; frame += 1) out[frame] += data[frame];\n    }\n    if (buffer.numberOfChannels > 1) {\n        for (let frame = 0; frame < frames; frame += 1) out[frame] /= buffer.numberOfChannels;\n    }\n    return out;\n}\n\n/**\n * Convert a recording to 16-bit WAV, with no dependency.\n *\n * `MediaRecorder` cannot produce WAV — it emits Opus on Chromium and Firefox and AAC\n * on Safari — so a backend that insists on WAV has to be served either by a\n * server-side transcode or by this. It decodes through `AudioContext.decodeAudioData`,\n * which is the browser's own decoder for whatever container the recorder chose, then\n * re-encodes the PCM.\n *\n * !!! The cost is real: WAV is uncompressed, so the same voice note that is 40 KB in\n * Opus is roughly 500 KB here at 48 kHz stereo. `{ mono: true, sampleRate: 16000 }`\n * takes that to about 80 KB and is what a speech-to-text endpoint wants anyway.\n *\n * Resampling uses `OfflineAudioContext`, i.e. the browser's own resampler, rather\n * than a hand-rolled one — this is exactly the \"we want the underlying call, not a\n * wrapper\" case.\n *\n * @param blob - A recording from {@link createAudioRecorder}, or any decodable audio.\n * @param options - See {@link WavOptions}.\n * @returns A `Blob` of type `audio/wav`.\n * @throws When the environment has no Web Audio, or the blob cannot be decoded.\n */\nexport async function blobToWav(blob: Blob, options: WavOptions = {}): Promise<Blob> {\n    const { mono = false, sampleRate: target } = options;\n\n    const Ctor: typeof AudioContext | undefined =\n        typeof AudioContext !== \"undefined\"\n            ? AudioContext\n            : (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!Ctor) throw new Error(\"Web Audio is not available in this environment.\");\n\n    const context = new Ctor();\n    let decoded: AudioBuffer;\n    try {\n        decoded = await context.decodeAudioData(await blob.arrayBuffer());\n    } finally {\n        void context.close().catch(() => undefined);\n    }\n\n    const wantedChannels = mono ? 1 : decoded.numberOfChannels;\n    const wantedRate = target ?? decoded.sampleRate;\n\n    if (wantedRate === decoded.sampleRate) {\n        const channels = mono\n            ? [mixToMono(decoded)]\n            : Array.from({ length: decoded.numberOfChannels }, (_, index) =>\n                  decoded.getChannelData(index),\n              );\n        return encodeWav({ channels, sampleRate: decoded.sampleRate });\n    }\n\n    const Offline: typeof OfflineAudioContext | undefined =\n        typeof OfflineAudioContext !== \"undefined\" ? OfflineAudioContext : undefined;\n    if (!Offline) throw new Error(\"Resampling requires OfflineAudioContext.\");\n\n    const frames = Math.max(1, Math.round((decoded.duration * wantedRate) | 0) || 1);\n    const offline = new Offline(wantedChannels, frames, wantedRate);\n    const source = offline.createBufferSource();\n    source.buffer = decoded;\n    source.connect(offline.destination);\n    source.start();\n    const rendered = await offline.startRendering();\n\n    return encodeWav({\n        channels: Array.from({ length: rendered.numberOfChannels }, (_, index) =>\n            rendered.getChannelData(index),\n        ),\n        sampleRate: rendered.sampleRate,\n    });\n}\n"],"mappings":"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"}

package/dist/audio/wav.js.map

@@ -1 +1 @@
-{"version":3,"file":"wav.js","names":[],"sources":["../../src/audio/wav.ts"],"sourcesContent":["/** Raw PCM ready to be wrapped in a RIFF container. */\nexport interface PcmAudio {\n    /** One `Float32Array` per channel, samples in −1…1. */\n    channels: readonly Float32Array[];\n    sampleRate: number;\n}\n\n/** Options for {@link blobToWav}. */\nexport interface WavOptions {\n    /**\n     * Mix down to one channel. Default `false`.\n     *\n     * Worth turning on for speech headed to a server: a microphone recorded in stereo\n     * carries two nearly identical channels and doubles the upload for nothing.\n     */\n    mono?: boolean;\n    /**\n     * Resample to this rate. Default: keep the source rate.\n     *\n     * 16000 is the rate most speech-to-text APIs want, and dropping 48 kHz to 16 kHz\n     * removes two thirds of the bytes with no audible loss on voice.\n     */\n    sampleRate?: number;\n}\n\n/** Bytes per sample in the output. 16-bit PCM is what every decoder accepts. */\nconst BYTES_PER_SAMPLE = 2;\n\n/**\n * Wrap PCM in a 16-bit RIFF/WAVE container.\n *\n * The header is the 44-byte canonical form: `RIFF` size, `WAVE`, a 16-byte `fmt `\n * chunk declaring format 1 (uncompressed PCM), then `data`. Samples are interleaved\n * and clamped before scaling, because a value even slightly past ±1 wraps around when\n * truncated to 16 bits and turns a loud passage into a burst of noise.\n *\n * Implemented here rather than pulled from a package: it is a fixed header and a\n * scaling loop, roughly forty lines, and a dependency for it would put its own\n * version bounds on every consumer of this SDK to save writing them.\n *\n * @param audio - Channels and sample rate.\n * @returns A `Blob` of type `audio/wav`.\n */\nexport function encodeWav({ channels, sampleRate }: PcmAudio): Blob {\n    const channelCount = Math.max(1, channels.length);\n    const frameCount = channels[0]?.length ?? 0;\n    const dataBytes = frameCount * channelCount * BYTES_PER_SAMPLE;\n    const buffer = new ArrayBuffer(44 + dataBytes);\n    const view = new DataView(buffer);\n\n    const ascii = (offset: number, text: string): void => {\n        for (let index = 0; index < text.length; index += 1) {\n            view.setUint8(offset + index, text.charCodeAt(index));\n        }\n    };\n\n    const byteRate = sampleRate * channelCount * BYTES_PER_SAMPLE;\n    ascii(0, \"RIFF\");\n    view.setUint32(4, 36 + dataBytes, true);\n    ascii(8, \"WAVE\");\n    ascii(12, \"fmt \");\n    view.setUint32(16, 16, true);\n    view.setUint16(20, 1, true);\n    view.setUint16(22, channelCount, true);\n    view.setUint32(24, sampleRate, true);\n    view.setUint32(28, byteRate, true);\n    view.setUint16(32, channelCount * BYTES_PER_SAMPLE, true);\n    view.setUint16(34, BYTES_PER_SAMPLE * 8, true);\n    ascii(36, \"data\");\n    view.setUint32(40, dataBytes, true);\n\n    let offset = 44;\n    for (let frame = 0; frame < frameCount; frame += 1) {\n        for (let channel = 0; channel < channelCount; channel += 1) {\n            const sample = channels[channel]?.[frame] ?? 0;\n            const clamped = sample < -1 ? -1 : sample > 1 ? 1 : sample;\n            // Asymmetric scaling: 16-bit PCM runs −32768…32767.\n            view.setInt16(offset, clamped < 0 ? clamped * 0x8000 : clamped * 0x7fff, true);\n            offset += BYTES_PER_SAMPLE;\n        }\n    }\n\n    return new Blob([buffer], { type: \"audio/wav\" });\n}\n\n/** Average every channel of a decoded buffer into one. */\nfunction mixToMono(buffer: AudioBuffer): Float32Array {\n    const frames = buffer.length;\n    const out = new Float32Array(frames);\n    for (let channel = 0; channel < buffer.numberOfChannels; channel += 1) {\n        const data = buffer.getChannelData(channel);\n        for (let frame = 0; frame < frames; frame += 1) out[frame] += data[frame];\n    }\n    if (buffer.numberOfChannels > 1) {\n        for (let frame = 0; frame < frames; frame += 1) out[frame] /= buffer.numberOfChannels;\n    }\n    return out;\n}\n\n/**\n * Convert a recording to 16-bit WAV, with no dependency.\n *\n * `MediaRecorder` cannot produce WAV — it emits Opus on Chromium and Firefox and AAC\n * on Safari — so a backend that insists on WAV has to be served either by a\n * server-side transcode or by this. It decodes through `AudioContext.decodeAudioData`,\n * which is the browser's own decoder for whatever container the recorder chose, then\n * re-encodes the PCM.\n *\n * !!! The cost is real: WAV is uncompressed, so the same voice note that is 40 KB in\n * Opus is roughly 500 KB here at 48 kHz stereo. `{ mono: true, sampleRate: 16000 }`\n * takes that to about 80 KB and is what a speech-to-text endpoint wants anyway.\n *\n * Resampling uses `OfflineAudioContext`, i.e. the browser's own resampler, rather\n * than a hand-rolled one — this is exactly the \"we want the underlying call, not a\n * wrapper\" case.\n *\n * @param blob - A recording from {@link createAudioRecorder}, or any decodable audio.\n * @param options - See {@link WavOptions}.\n * @returns A `Blob` of type `audio/wav`.\n * @throws When the environment has no Web Audio, or the blob cannot be decoded.\n */\nexport async function blobToWav(blob: Blob, options: WavOptions = {}): Promise<Blob> {\n    const { mono = false, sampleRate: target } = options;\n\n    const Ctor: typeof AudioContext | undefined =\n        typeof AudioContext !== \"undefined\"\n            ? AudioContext\n            : (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!Ctor) throw new Error(\"Web Audio is not available in this environment.\");\n\n    const context = new Ctor();\n    let decoded: AudioBuffer;\n    try {\n        decoded = await context.decodeAudioData(await blob.arrayBuffer());\n    } finally {\n        void context.close().catch(() => undefined);\n    }\n\n    const wantedChannels = mono ? 1 : decoded.numberOfChannels;\n    const wantedRate = target ?? decoded.sampleRate;\n\n    if (wantedRate === decoded.sampleRate) {\n        const channels = mono\n            ? [mixToMono(decoded)]\n            : Array.from({ length: decoded.numberOfChannels }, (_, index) =>\n                  decoded.getChannelData(index),\n              );\n        return encodeWav({ channels, sampleRate: decoded.sampleRate });\n    }\n\n    const Offline: typeof OfflineAudioContext | undefined =\n        typeof OfflineAudioContext !== \"undefined\" ? OfflineAudioContext : undefined;\n    if (!Offline) throw new Error(\"Resampling requires OfflineAudioContext.\");\n\n    const frames = Math.max(1, Math.round((decoded.duration * wantedRate) | 0) || 1);\n    const offline = new Offline(wantedChannels, frames, wantedRate);\n    const source = offline.createBufferSource();\n    source.buffer = decoded;\n    source.connect(offline.destination);\n    source.start();\n    const rendered = await offline.startRendering();\n\n    return encodeWav({\n        channels: Array.from({ length: rendered.numberOfChannels }, (_, index) =>\n            rendered.getChannelData(index),\n        ),\n        sampleRate: rendered.sampleRate,\n    });\n}\n"],"mappings":"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"}
+{"version":3,"file":"wav.js","names":["encodeWav","channelCount","channels","frameCount","dataBytes","buffer","view","ascii","index","text","offset","byteRate","sampleRate","frame","channel","sample","clamped","mixToMono","frames","out","data","blobToWav","target","options","Ctor","context","decoded","blob","wantedChannels","mono","wantedRate","Offline","offline","source","rendered"],"sources":["../../src/audio/wav.ts"],"sourcesContent":["/** Raw PCM ready to be wrapped in a RIFF container. */\nexport interface PcmAudio {\n    /** One `Float32Array` per channel, samples in −1…1. */\n    channels: readonly Float32Array[];\n    sampleRate: number;\n}\n\n/** Options for {@link blobToWav}. */\nexport interface WavOptions {\n    /**\n     * Mix down to one channel. Default `false`.\n     *\n     * Worth turning on for speech headed to a server: a microphone recorded in stereo\n     * carries two nearly identical channels and doubles the upload for nothing.\n     */\n    mono?: boolean;\n    /**\n     * Resample to this rate. Default: keep the source rate.\n     *\n     * 16000 is the rate most speech-to-text APIs want, and dropping 48 kHz to 16 kHz\n     * removes two thirds of the bytes with no audible loss on voice.\n     */\n    sampleRate?: number;\n}\n\n/** Bytes per sample in the output. 16-bit PCM is what every decoder accepts. */\nconst BYTES_PER_SAMPLE = 2;\n\n/**\n * Wrap PCM in a 16-bit RIFF/WAVE container.\n *\n * The header is the 44-byte canonical form: `RIFF` size, `WAVE`, a 16-byte `fmt `\n * chunk declaring format 1 (uncompressed PCM), then `data`. Samples are interleaved\n * and clamped before scaling, because a value even slightly past ±1 wraps around when\n * truncated to 16 bits and turns a loud passage into a burst of noise.\n *\n * Implemented here rather than pulled from a package: it is a fixed header and a\n * scaling loop, roughly forty lines, and a dependency for it would put its own\n * version bounds on every consumer of this SDK to save writing them.\n *\n * @param audio - Channels and sample rate.\n * @returns A `Blob` of type `audio/wav`.\n */\nexport function encodeWav({ channels, sampleRate }: PcmAudio): Blob {\n    const channelCount = Math.max(1, channels.length);\n    const frameCount = channels[0]?.length ?? 0;\n    const dataBytes = frameCount * channelCount * BYTES_PER_SAMPLE;\n    const buffer = new ArrayBuffer(44 + dataBytes);\n    const view = new DataView(buffer);\n\n    const ascii = (offset: number, text: string): void => {\n        for (let index = 0; index < text.length; index += 1) {\n            view.setUint8(offset + index, text.charCodeAt(index));\n        }\n    };\n\n    const byteRate = sampleRate * channelCount * BYTES_PER_SAMPLE;\n    ascii(0, \"RIFF\");\n    view.setUint32(4, 36 + dataBytes, true);\n    ascii(8, \"WAVE\");\n    ascii(12, \"fmt \");\n    view.setUint32(16, 16, true);\n    view.setUint16(20, 1, true);\n    view.setUint16(22, channelCount, true);\n    view.setUint32(24, sampleRate, true);\n    view.setUint32(28, byteRate, true);\n    view.setUint16(32, channelCount * BYTES_PER_SAMPLE, true);\n    view.setUint16(34, BYTES_PER_SAMPLE * 8, true);\n    ascii(36, \"data\");\n    view.setUint32(40, dataBytes, true);\n\n    let offset = 44;\n    for (let frame = 0; frame < frameCount; frame += 1) {\n        for (let channel = 0; channel < channelCount; channel += 1) {\n            const sample = channels[channel]?.[frame] ?? 0;\n            const clamped = sample < -1 ? -1 : sample > 1 ? 1 : sample;\n            // Asymmetric scaling: 16-bit PCM runs −32768…32767.\n            view.setInt16(offset, clamped < 0 ? clamped * 0x8000 : clamped * 0x7fff, true);\n            offset += BYTES_PER_SAMPLE;\n        }\n    }\n\n    return new Blob([buffer], { type: \"audio/wav\" });\n}\n\n/** Average every channel of a decoded buffer into one. */\nfunction mixToMono(buffer: AudioBuffer): Float32Array {\n    const frames = buffer.length;\n    const out = new Float32Array(frames);\n    for (let channel = 0; channel < buffer.numberOfChannels; channel += 1) {\n        const data = buffer.getChannelData(channel);\n        for (let frame = 0; frame < frames; frame += 1) out[frame] += data[frame];\n    }\n    if (buffer.numberOfChannels > 1) {\n        for (let frame = 0; frame < frames; frame += 1) out[frame] /= buffer.numberOfChannels;\n    }\n    return out;\n}\n\n/**\n * Convert a recording to 16-bit WAV, with no dependency.\n *\n * `MediaRecorder` cannot produce WAV — it emits Opus on Chromium and Firefox and AAC\n * on Safari — so a backend that insists on WAV has to be served either by a\n * server-side transcode or by this. It decodes through `AudioContext.decodeAudioData`,\n * which is the browser's own decoder for whatever container the recorder chose, then\n * re-encodes the PCM.\n *\n * !!! The cost is real: WAV is uncompressed, so the same voice note that is 40 KB in\n * Opus is roughly 500 KB here at 48 kHz stereo. `{ mono: true, sampleRate: 16000 }`\n * takes that to about 80 KB and is what a speech-to-text endpoint wants anyway.\n *\n * Resampling uses `OfflineAudioContext`, i.e. the browser's own resampler, rather\n * than a hand-rolled one — this is exactly the \"we want the underlying call, not a\n * wrapper\" case.\n *\n * @param blob - A recording from {@link createAudioRecorder}, or any decodable audio.\n * @param options - See {@link WavOptions}.\n * @returns A `Blob` of type `audio/wav`.\n * @throws When the environment has no Web Audio, or the blob cannot be decoded.\n */\nexport async function blobToWav(blob: Blob, options: WavOptions = {}): Promise<Blob> {\n    const { mono = false, sampleRate: target } = options;\n\n    const Ctor: typeof AudioContext | undefined =\n        typeof AudioContext !== \"undefined\"\n            ? AudioContext\n            : (globalThis as { webkitAudioContext?: typeof AudioContext }).webkitAudioContext;\n    if (!Ctor) throw new Error(\"Web Audio is not available in this environment.\");\n\n    const context = new Ctor();\n    let decoded: AudioBuffer;\n    try {\n        decoded = await context.decodeAudioData(await blob.arrayBuffer());\n    } finally {\n        void context.close().catch(() => undefined);\n    }\n\n    const wantedChannels = mono ? 1 : decoded.numberOfChannels;\n    const wantedRate = target ?? decoded.sampleRate;\n\n    if (wantedRate === decoded.sampleRate) {\n        const channels = mono\n            ? [mixToMono(decoded)]\n            : Array.from({ length: decoded.numberOfChannels }, (_, index) =>\n                  decoded.getChannelData(index),\n              );\n        return encodeWav({ channels, sampleRate: decoded.sampleRate });\n    }\n\n    const Offline: typeof OfflineAudioContext | undefined =\n        typeof OfflineAudioContext !== \"undefined\" ? OfflineAudioContext : undefined;\n    if (!Offline) throw new Error(\"Resampling requires OfflineAudioContext.\");\n\n    const frames = Math.max(1, Math.round((decoded.duration * wantedRate) | 0) || 1);\n    const offline = new Offline(wantedChannels, frames, wantedRate);\n    const source = offline.createBufferSource();\n    source.buffer = decoded;\n    source.connect(offline.destination);\n    source.start();\n    const rendered = await offline.startRendering();\n\n    return encodeWav({\n        channels: Array.from({ length: rendered.numberOfChannels }, (_, index) =>\n            rendered.getChannelData(index),\n        ),\n        sampleRate: rendered.sampleRate,\n    });\n}\n"],"mappings":"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"}

package/dist/auth/AuthGuard.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"AuthGuard.cjs","names":[],"sources":["../../src/auth/AuthGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nexport interface AuthGuardProps {\n    /** Whether the current user is authenticated. */\n    isAuthenticated: boolean;\n    /** Element to render when authenticated. */\n    children: ReactNode;\n    /** Element to render when not authenticated. Use this to redirect (e.g. `<Navigate to=\"/login\" />`). */\n    fallback: ReactNode;\n}\n\n/**\n * Router-agnostic auth gate. The caller decides what to render in either\n * branch — typically `<Outlet />` for protected layouts and `<Navigate />` for\n * the redirect. Pair with {@link createAuthStore} or any custom auth source.\n *\n * @example\n * <AuthGuard\n *     isAuthenticated={useAuthStore((s) => s.isAuthenticated)}\n *     fallback={<Navigate to=\"/login\" replace />}\n * >\n *     <Outlet />\n * </AuthGuard>\n */\nexport function AuthGuard({ isAuthenticated, children, fallback }: AuthGuardProps) {\n    return <>{isAuthenticated ? children : fallback}</>;\n}\n"],"mappings":"mCAwBA,SAAgB,EAAU,CAAE,kBAAiB,WAAU,YAA4B,CAC/E,OAAO,EAAA,EAAA,IAAA,CAAA,EAAA,SAAA,CAAA,SAAG,EAAkB,EAAW,CAAW,CAAA,CACtD"}
+{"version":3,"file":"AuthGuard.cjs","names":["_Fragment","react_jsx_runtime","AuthGuard","isAuthenticated","children","fallback"],"sources":["../../src/auth/AuthGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nexport interface AuthGuardProps {\n    /** Whether the current user is authenticated. */\n    isAuthenticated: boolean;\n    /** Element to render when authenticated. */\n    children: ReactNode;\n    /** Element to render when not authenticated. Use this to redirect (e.g. `<Navigate to=\"/login\" />`). */\n    fallback: ReactNode;\n}\n\n/**\n * Router-agnostic auth gate. The caller decides what to render in either\n * branch — typically `<Outlet />` for protected layouts and `<Navigate />` for\n * the redirect. Pair with {@link createAuthStore} or any custom auth source.\n *\n * @example\n * <AuthGuard\n *     isAuthenticated={useAuthStore((s) => s.isAuthenticated)}\n *     fallback={<Navigate to=\"/login\" replace />}\n * >\n *     <Outlet />\n * </AuthGuard>\n */\nexport function AuthGuard({ isAuthenticated, children, fallback }: AuthGuardProps) {\n    return <>{isAuthenticated ? children : fallback}</>;\n}\n"],"mappings":"A,mCAwBA,SAAgBE,EAAU,CAAE,kBAAiB,WAAU,YAA4B,CAC/E,OAAO,EAAAD,EAAA,IAAA,CAAAD,EAAAA,SAAA,CAAA,SAAGG,EAAkBC,EAAWC,CAAW,CAAA,CACtD,C"}

package/dist/auth/AuthGuard.js.map

@@ -1 +1 @@
-{"version":3,"file":"AuthGuard.js","names":[],"sources":["../../src/auth/AuthGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nexport interface AuthGuardProps {\n    /** Whether the current user is authenticated. */\n    isAuthenticated: boolean;\n    /** Element to render when authenticated. */\n    children: ReactNode;\n    /** Element to render when not authenticated. Use this to redirect (e.g. `<Navigate to=\"/login\" />`). */\n    fallback: ReactNode;\n}\n\n/**\n * Router-agnostic auth gate. The caller decides what to render in either\n * branch — typically `<Outlet />` for protected layouts and `<Navigate />` for\n * the redirect. Pair with {@link createAuthStore} or any custom auth source.\n *\n * @example\n * <AuthGuard\n *     isAuthenticated={useAuthStore((s) => s.isAuthenticated)}\n *     fallback={<Navigate to=\"/login\" replace />}\n * >\n *     <Outlet />\n * </AuthGuard>\n */\nexport function AuthGuard({ isAuthenticated, children, fallback }: AuthGuardProps) {\n    return <>{isAuthenticated ? children : fallback}</>;\n}\n"],"mappings":";;AAwBA,SAAgB,EAAU,EAAE,oBAAiB,aAAU,eAA4B;CAC/E,OAAO,kBAAA,GAAA,EAAA,UAAG,IAAkB,IAAW,EAAW,CAAA;AACtD"}
+{"version":3,"file":"AuthGuard.js","names":["_Fragment","AuthGuard","Fragment","isAuthenticated","children","fallback"],"sources":["../../src/auth/AuthGuard.tsx"],"sourcesContent":["import type { ReactNode } from \"react\";\n\nexport interface AuthGuardProps {\n    /** Whether the current user is authenticated. */\n    isAuthenticated: boolean;\n    /** Element to render when authenticated. */\n    children: ReactNode;\n    /** Element to render when not authenticated. Use this to redirect (e.g. `<Navigate to=\"/login\" />`). */\n    fallback: ReactNode;\n}\n\n/**\n * Router-agnostic auth gate. The caller decides what to render in either\n * branch — typically `<Outlet />` for protected layouts and `<Navigate />` for\n * the redirect. Pair with {@link createAuthStore} or any custom auth source.\n *\n * @example\n * <AuthGuard\n *     isAuthenticated={useAuthStore((s) => s.isAuthenticated)}\n *     fallback={<Navigate to=\"/login\" replace />}\n * >\n *     <Outlet />\n * </AuthGuard>\n */\nexport function AuthGuard({ isAuthenticated, children, fallback }: AuthGuardProps) {\n    return <>{isAuthenticated ? children : fallback}</>;\n}\n"],"mappings":";;AAwBA,SAAgBC,EAAU,EAAE,oBAAiB,aAAU,eAA4B;CAC/E,OAAO,kBAAAD,GAAA,EAAA,UAAGG,IAAkBC,IAAWC,EAAW,CAAA;AACtD"}

package/dist/auth/create-auth-store.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"create-auth-store.cjs","names":[],"sources":["../../src/auth/create-auth-store.ts"],"sourcesContent":["import { create } from \"zustand\";\nimport { persist, createJSONStorage } from \"zustand/middleware\";\n\nexport interface AuthState<TUser> {\n    user: TUser | null;\n    token: string | null;\n    isAuthenticated: boolean;\n    setSession: (session: { user: TUser; token: string }) => void;\n    setUser: (user: TUser | null) => void;\n    setToken: (token: string | null) => void;\n    logout: () => void;\n}\n\nexport interface CreateAuthStoreOptions<TUser> {\n    /** Persist key used in storage (default: \"tempest-auth\"). */\n    name?: string;\n    /** Which storage to persist into (default: localStorage). */\n    storage?: \"local\" | \"session\";\n    /** Initial user (useful for SSR hydration). */\n    initialUser?: TUser | null;\n    /** Initial token. */\n    initialToken?: string | null;\n}\n\n/**\n * Build a typed Zustand auth store with `persist` middleware. Each app passes\n * its own `TUser` shape so the SDK does not own the user model.\n *\n * @example\n * const useAuthStore = createAuthStore<UserResponse>();\n * const { user, token, logout } = useAuthStore();\n */\nexport function createAuthStore<TUser>(options: CreateAuthStoreOptions<TUser> = {}) {\n    const name = options.name ?? \"tempest-auth\";\n    const storageImpl = options.storage === \"session\" ? () => sessionStorage : () => localStorage;\n\n    return create<AuthState<TUser>>()(\n        persist(\n            (set) => ({\n                user: options.initialUser ?? null,\n                token: options.initialToken ?? null,\n                isAuthenticated: !!options.initialToken,\n                setSession: ({ user, token }) => set({ user, token, isAuthenticated: true }),\n                setUser: (user) => set({ user }),\n                setToken: (token) => set({ token, isAuthenticated: !!token }),\n                logout: () => set({ user: null, token: null, isAuthenticated: false }),\n            }),\n            {\n                name,\n                storage: createJSONStorage(storageImpl),\n                partialize: (state) => ({ user: state.user, token: state.token }),\n                onRehydrateStorage: () => (state) => {\n                    if (state) state.isAuthenticated = !!state.token;\n                },\n            },\n        ),\n    );\n}\n"],"mappings":"yDAgCA,SAAgB,EAAuB,EAAyC,CAAC,EAAG,CAChF,IAAM,EAAO,EAAQ,MAAQ,eACvB,EAAc,EAAQ,UAAY,cAAkB,mBAAuB,aAEjF,OAAA,EAAO,EAAA,OAAA,CAAyB,CAAC,EAAA,EAC7B,EAAA,QAAA,CACK,IAAS,CACN,KAAM,EAAQ,aAAe,KAC7B,MAAO,EAAQ,cAAgB,KAC/B,gBAAiB,CAAC,CAAC,EAAQ,aAC3B,YAAa,CAAE,OAAM,WAAY,EAAI,CAAE,OAAM,QAAO,gBAAiB,EAAK,CAAC,EAC3E,QAAU,GAAS,EAAI,CAAE,MAAK,CAAC,EAC/B,SAAW,GAAU,EAAI,CAAE,QAAO,gBAAiB,CAAC,CAAC,CAAM,CAAC,EAC5D,WAAc,EAAI,CAAE,KAAM,KAAM,MAAO,KAAM,gBAAiB,EAAM,CAAC,CACzE,GACA,CACI,OACA,SAAA,EAAS,EAAA,kBAAA,CAAkB,CAAW,EACtC,WAAa,IAAW,CAAE,KAAM,EAAM,KAAM,MAAO,EAAM,KAAM,GAC/D,uBAA2B,GAAU,CAC7B,IAAO,EAAM,gBAAkB,CAAC,CAAC,EAAM,MAC/C,CACJ,CACJ,CACJ,CACJ"}
+{"version":3,"file":"create-auth-store.cjs","names":["create","persist","createJSONStorage","zustand","zustand_middleware","createAuthStore","name","options","storageImpl","set","token","state"],"sources":["../../src/auth/create-auth-store.ts"],"sourcesContent":["import { create } from \"zustand\";\nimport { persist, createJSONStorage } from \"zustand/middleware\";\n\nexport interface AuthState<TUser> {\n    user: TUser | null;\n    token: string | null;\n    isAuthenticated: boolean;\n    setSession: (session: { user: TUser; token: string }) => void;\n    setUser: (user: TUser | null) => void;\n    setToken: (token: string | null) => void;\n    logout: () => void;\n}\n\nexport interface CreateAuthStoreOptions<TUser> {\n    /** Persist key used in storage (default: \"tempest-auth\"). */\n    name?: string;\n    /** Which storage to persist into (default: localStorage). */\n    storage?: \"local\" | \"session\";\n    /** Initial user (useful for SSR hydration). */\n    initialUser?: TUser | null;\n    /** Initial token. */\n    initialToken?: string | null;\n}\n\n/**\n * Build a typed Zustand auth store with `persist` middleware. Each app passes\n * its own `TUser` shape so the SDK does not own the user model.\n *\n * @example\n * const useAuthStore = createAuthStore<UserResponse>();\n * const { user, token, logout } = useAuthStore();\n */\nexport function createAuthStore<TUser>(options: CreateAuthStoreOptions<TUser> = {}) {\n    const name = options.name ?? \"tempest-auth\";\n    const storageImpl = options.storage === \"session\" ? () => sessionStorage : () => localStorage;\n\n    return create<AuthState<TUser>>()(\n        persist(\n            (set) => ({\n                user: options.initialUser ?? null,\n                token: options.initialToken ?? null,\n                isAuthenticated: !!options.initialToken,\n                setSession: ({ user, token }) => set({ user, token, isAuthenticated: true }),\n                setUser: (user) => set({ user }),\n                setToken: (token) => set({ token, isAuthenticated: !!token }),\n                logout: () => set({ user: null, token: null, isAuthenticated: false }),\n            }),\n            {\n                name,\n                storage: createJSONStorage(storageImpl),\n                partialize: (state) => ({ user: state.user, token: state.token }),\n                onRehydrateStorage: () => (state) => {\n                    if (state) state.isAuthenticated = !!state.token;\n                },\n            },\n        ),\n    );\n}\n"],"mappings":"A,yDAgCA,SAAgBK,EAAuB,EAAyC,CAAC,EAAG,CAChF,IAAMC,EAAOC,EAAQ,MAAQ,eACvBC,EAAcD,EAAQ,UAAY,cAAkB,mBAAuB,aAEjF,OAAA,EAAOP,EAAAA,OAAAA,CAAyB,CAAC,EAAA,EAC7BC,EAAAA,QAAAA,CACK,IAAS,CACN,KAAMM,EAAQ,aAAe,KAC7B,MAAOA,EAAQ,cAAgB,KAC/B,gBAAiB,CAAC,CAACA,EAAQ,aAC3B,YAAa,CAAE,OAAM,WAAYE,EAAI,CAAE,OAAM,QAAO,gBAAiB,EAAK,CAAC,EAC3E,QAAU,GAASA,EAAI,CAAE,MAAK,CAAC,EAC/B,SAAW,GAAUA,EAAI,CAAE,QAAO,gBAAiB,CAAC,CAACC,CAAM,CAAC,EAC5D,WAAcD,EAAI,CAAE,KAAM,KAAM,MAAO,KAAM,gBAAiB,EAAM,CAAC,CACzE,GACA,CACI,OACA,SAAA,EAASP,EAAAA,kBAAAA,CAAkBM,CAAW,EACtC,WAAa,IAAW,CAAE,KAAMG,EAAM,KAAM,MAAOA,EAAM,KAAM,GAC/D,uBAA2B,GAAU,CAC7BA,IAAO,EAAM,gBAAkB,CAAC,CAACA,EAAM,MAC/C,CACJ,CACJ,CACJ,CACJ,C"}

package/dist/auth/create-auth-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-auth-store.js","names":[],"sources":["../../src/auth/create-auth-store.ts"],"sourcesContent":["import { create } from \"zustand\";\nimport { persist, createJSONStorage } from \"zustand/middleware\";\n\nexport interface AuthState<TUser> {\n    user: TUser | null;\n    token: string | null;\n    isAuthenticated: boolean;\n    setSession: (session: { user: TUser; token: string }) => void;\n    setUser: (user: TUser | null) => void;\n    setToken: (token: string | null) => void;\n    logout: () => void;\n}\n\nexport interface CreateAuthStoreOptions<TUser> {\n    /** Persist key used in storage (default: \"tempest-auth\"). */\n    name?: string;\n    /** Which storage to persist into (default: localStorage). */\n    storage?: \"local\" | \"session\";\n    /** Initial user (useful for SSR hydration). */\n    initialUser?: TUser | null;\n    /** Initial token. */\n    initialToken?: string | null;\n}\n\n/**\n * Build a typed Zustand auth store with `persist` middleware. Each app passes\n * its own `TUser` shape so the SDK does not own the user model.\n *\n * @example\n * const useAuthStore = createAuthStore<UserResponse>();\n * const { user, token, logout } = useAuthStore();\n */\nexport function createAuthStore<TUser>(options: CreateAuthStoreOptions<TUser> = {}) {\n    const name = options.name ?? \"tempest-auth\";\n    const storageImpl = options.storage === \"session\" ? () => sessionStorage : () => localStorage;\n\n    return create<AuthState<TUser>>()(\n        persist(\n            (set) => ({\n                user: options.initialUser ?? null,\n                token: options.initialToken ?? null,\n                isAuthenticated: !!options.initialToken,\n                setSession: ({ user, token }) => set({ user, token, isAuthenticated: true }),\n                setUser: (user) => set({ user }),\n                setToken: (token) => set({ token, isAuthenticated: !!token }),\n                logout: () => set({ user: null, token: null, isAuthenticated: false }),\n            }),\n            {\n                name,\n                storage: createJSONStorage(storageImpl),\n                partialize: (state) => ({ user: state.user, token: state.token }),\n                onRehydrateStorage: () => (state) => {\n                    if (state) state.isAuthenticated = !!state.token;\n                },\n            },\n        ),\n    );\n}\n"],"mappings":";;;AAgCA,SAAgB,EAAuB,IAAyC,CAAC,GAAG;CAChF,IAAM,IAAO,EAAQ,QAAQ,gBACvB,IAAc,EAAQ,YAAY,kBAAkB,uBAAuB;CAEjF,OAAO,EAAyB,CAAC,CAC7B,GACK,OAAS;EACN,MAAM,EAAQ,eAAe;EAC7B,OAAO,EAAQ,gBAAgB;EAC/B,iBAAiB,CAAC,CAAC,EAAQ;EAC3B,aAAa,EAAE,SAAM,eAAY,EAAI;GAAE;GAAM;GAAO,iBAAiB;EAAK,CAAC;EAC3E,UAAU,MAAS,EAAI,EAAE,QAAK,CAAC;EAC/B,WAAW,MAAU,EAAI;GAAE;GAAO,iBAAiB,CAAC,CAAC;EAAM,CAAC;EAC5D,cAAc,EAAI;GAAE,MAAM;GAAM,OAAO;GAAM,iBAAiB;EAAM,CAAC;CACzE,IACA;EACI;EACA,SAAS,EAAkB,CAAW;EACtC,aAAa,OAAW;GAAE,MAAM,EAAM;GAAM,OAAO,EAAM;EAAM;EAC/D,2BAA2B,MAAU;GACjC,AAAI,MAAO,EAAM,kBAAkB,CAAC,CAAC,EAAM;EAC/C;CACJ,CACJ,CACJ;AACJ"}
+{"version":3,"file":"create-auth-store.js","names":["createAuthStore","name","options","storageImpl","create","persist","set","token","createJSONStorage","state"],"sources":["../../src/auth/create-auth-store.ts"],"sourcesContent":["import { create } from \"zustand\";\nimport { persist, createJSONStorage } from \"zustand/middleware\";\n\nexport interface AuthState<TUser> {\n    user: TUser | null;\n    token: string | null;\n    isAuthenticated: boolean;\n    setSession: (session: { user: TUser; token: string }) => void;\n    setUser: (user: TUser | null) => void;\n    setToken: (token: string | null) => void;\n    logout: () => void;\n}\n\nexport interface CreateAuthStoreOptions<TUser> {\n    /** Persist key used in storage (default: \"tempest-auth\"). */\n    name?: string;\n    /** Which storage to persist into (default: localStorage). */\n    storage?: \"local\" | \"session\";\n    /** Initial user (useful for SSR hydration). */\n    initialUser?: TUser | null;\n    /** Initial token. */\n    initialToken?: string | null;\n}\n\n/**\n * Build a typed Zustand auth store with `persist` middleware. Each app passes\n * its own `TUser` shape so the SDK does not own the user model.\n *\n * @example\n * const useAuthStore = createAuthStore<UserResponse>();\n * const { user, token, logout } = useAuthStore();\n */\nexport function createAuthStore<TUser>(options: CreateAuthStoreOptions<TUser> = {}) {\n    const name = options.name ?? \"tempest-auth\";\n    const storageImpl = options.storage === \"session\" ? () => sessionStorage : () => localStorage;\n\n    return create<AuthState<TUser>>()(\n        persist(\n            (set) => ({\n                user: options.initialUser ?? null,\n                token: options.initialToken ?? null,\n                isAuthenticated: !!options.initialToken,\n                setSession: ({ user, token }) => set({ user, token, isAuthenticated: true }),\n                setUser: (user) => set({ user }),\n                setToken: (token) => set({ token, isAuthenticated: !!token }),\n                logout: () => set({ user: null, token: null, isAuthenticated: false }),\n            }),\n            {\n                name,\n                storage: createJSONStorage(storageImpl),\n                partialize: (state) => ({ user: state.user, token: state.token }),\n                onRehydrateStorage: () => (state) => {\n                    if (state) state.isAuthenticated = !!state.token;\n                },\n            },\n        ),\n    );\n}\n"],"mappings":";;;AAgCA,SAAgBA,EAAuB,IAAyC,CAAC,GAAG;CAChF,IAAMC,IAAOC,EAAQ,QAAQ,gBACvBC,IAAcD,EAAQ,YAAY,kBAAkB,uBAAuB;CAEjF,OAAOE,EAAyB,CAAC,CAC7BC,GACK,OAAS;EACN,MAAMH,EAAQ,eAAe;EAC7B,OAAOA,EAAQ,gBAAgB;EAC/B,iBAAiB,CAAC,CAACA,EAAQ;EAC3B,aAAa,EAAE,SAAM,eAAYI,EAAI;GAAE;GAAM;GAAO,iBAAiB;EAAK,CAAC;EAC3E,UAAU,MAASA,EAAI,EAAE,QAAK,CAAC;EAC/B,WAAW,MAAUA,EAAI;GAAE;GAAO,iBAAiB,CAAC,CAACC;EAAM,CAAC;EAC5D,cAAcD,EAAI;GAAE,MAAM;GAAM,OAAO;GAAM,iBAAiB;EAAM,CAAC;CACzE,IACA;EACI;EACA,SAASE,EAAkBL,CAAW;EACtC,aAAa,OAAW;GAAE,MAAMM,EAAM;GAAM,OAAOA,EAAM;EAAM;EAC/D,2BAA2B,MAAU;GACjC,AAAIA,MAAO,EAAM,kBAAkB,CAAC,CAACA,EAAM;EAC/C;CACJ,CACJ,CACJ;AACJ"}

package/dist/auth/create-tempest-auth.cjs

@@ -1,2 +1,2 @@
-const e=require("../utils/dev-mode.cjs"),t=require("../http/errors.cjs"),n=require("../http/api-client.cjs"),r=require("./create-auth-store.cjs"),i=require("./refresh-queue.cjs");var a=1e4;function o(e,t){return e.length===0?Promise.resolve():new Promise(n=>{let r=setTimeout(n,t);Promise.allSettled(e).then(()=>{clearTimeout(r),n()})})}function s(e){let t=e??{};return{token:t.access_token,refreshToken:t.refresh_token}}function c(c){let{baseURL:l,prefix:u,loginPath:d=`/api/auth/login`,refreshPath:ee=`/api/auth/refresh`,logoutPath:f,onLogoutError:te,mePath:p,storeName:m=`tempest-auth`,storage:h=`local`,withCredentials:g=!1,csrf:_,fetcher:v,parseTokens:y=s,parseUser:b,refreshBody:x=e=>e?{refresh_token:e}:void 0,retry:ne,redirectTo:S,onSessionEnd:C}=c,w=r.createAuthStore({name:m,storage:h}),T=`${m}-refresh`;function E(){return typeof window>`u`?null:h===`session`?window.sessionStorage:window.localStorage}function D(){return E()?.getItem(T)??null}function O(e){let t=E();t&&(e?t.setItem(T,e):t.removeItem(T))}let k=()=>w.getState(),A=()=>k().token;async function j(){if(!p)return k().user;let e=M,n;try{n=await $.get(p,{skipAuthRetry:!0})}catch(n){throw M===e?n:new t.SessionSupersededError}if(M!==e)throw new t.SessionSupersededError;return k().setUser(n),n}let M=0,N=Promise.resolve(),P=0,F=new Set,I=new Set,L=new Set,R=new Set;function z(e){let t=e.then(()=>void 0,()=>void 0);return L.add(t),t.then(()=>L.delete(t)),e}function B(t){e.isDevBuild()&&console.warn(`[tempest-react-sdk] createTempestAuth: logoutPath revocation failed`,t);try{te?.(t)}catch{return}}function V(e){let t=(async()=>{try{await e()}catch(e){B(e)}})();return I.add(t),t.then(()=>I.delete(t)),t}function H(e,t){f&&!g&&t&&V(()=>U(e).post(f,{body:x(t)}))}function U(e){return n.createApiClient({baseURL:l,prefix:u,withCredentials:g,csrf:_,fetcher:v,getToken:()=>e})}function W(){M+=1,K=i.createRefreshQueue(G)}async function G(){let e=M;R.add(e);try{let n;try{n=await z($.post(ee,{body:x(D()),skipAuth:!0}))}catch(n){throw M===e?n:new t.SessionSupersededError}let{token:r,refreshToken:i}=y(n);if(M!==e)throw H(r??null,i),new t.SessionSupersededError;k().setToken(r),i&&O(i)}finally{R.delete(e)}}let K=i.createRefreshQueue(G);function q(e){let t=A();return t===null?!1:e.token===null||e.token!==t}function J(){return A()===null&&D()===null}async function Y(){if(!(F.size>0&&P===0&&(await Promise.allSettled([...F]),A()!==null)))throw Error(`anonymous 401 with no session`)}async function X(e){if(e.epoch!==null&&e.epoch!==M)throw new t.SessionSupersededError;if(q(e)){if(e.token===null)throw Error(`anonymous 401 under a live session`);return}return e.token===null&&J()?R.has(M)?K():Y():K()}async function Z(e,n){if(n.epoch!==null&&n.epoch!==M)throw new t.SessionSupersededError;q(n)||n.token===null&&J()||await se()}async function re(e){I.size>0&&await o([...I],a);let t=ie(e);F.add(t);try{return await t}finally{F.delete(t)}}async function ie(e){let n=M,r=await z($.post(d,{body:e,skipAuth:!0})),{token:i,refreshToken:a}=y(r);if(M!==n)throw H(i??null,a),new t.SessionSupersededError;let{done:o}=Q(`switch`),s=M;if(await o.catch(()=>void 0),M!==s)throw new t.SessionSupersededError;k().setToken(i),O(a??null);let c=b?.(r);return c==null?j():(k().setUser(c),c)}function Q(e){let{user:t,token:n}=k(),r=n!==null||t!==null||D()!==null;if((r||e!==`expired`)&&W(),k().logout(),O(null),!r)return{live:r,done:e===`switch`||P===0?N:Promise.resolve()};if(!C)return{live:r,done:Promise.resolve()};let i=U(n);P+=1;let a=(async()=>{try{await C({reason:e,user:t,token:n,api:i})}finally{--P}})();return N=a.then(()=>void 0,()=>void 0),{live:r,done:a.then(()=>void 0)}}function ae(){if(!f)return null;let e=f,{token:t,user:n}=k(),r=D();if(!g&&t===null&&n===null&&r===null)return null;let i=g?[...L]:[];return V(async()=>(await o(i,a),U(t).post(e,{body:x(r)})))}function oe(){let e=ae(),{done:t}=Q(`logout`);return e?Promise.all([e,t]).then(()=>void 0):t}async function se(){let{live:e,done:t}=Q(`expired`);await t.catch(()=>void 0),e&&S&&typeof window<`u`&&window.location.assign(S)}let $=n.createApiClient({baseURL:l,prefix:u,withCredentials:g,csrf:_,fetcher:v,getToken:A,getSessionEpoch:()=>M,refresh:X,retry:ne,onUnauthorized:Z});return{useAuthStore:w,api:$,login:re,logout:oe,refresh:()=>K(),getToken:A}}exports.createTempestAuth=c;
+const e=require("../utils/dev-mode.cjs"),t=require("../http/errors.cjs"),n=require("../http/api-client.cjs"),r=require("./create-auth-store.cjs"),i=require("./refresh-queue.cjs");var a=1e4;function o(e,t){return e.length===0?Promise.resolve():new Promise(n=>{let r=setTimeout(n,t);Promise.allSettled(e).then(()=>{clearTimeout(r),n()})})}function s(e){let t=e??{};return{token:t.access_token,refreshToken:t.refresh_token}}function c(c){let{baseURL:l,prefix:u,loginPath:d=`/api/auth/login`,refreshPath:ee=`/api/auth/refresh`,logoutPath:f,onLogoutError:te,mePath:p,storeName:m=`tempest-auth`,storage:h=`local`,withCredentials:g=!1,csrf:_,fetcher:v,parseTokens:y=s,parseUser:b,refreshBody:x=e=>e?{refresh_token:e}:void 0,retry:ne,redirectTo:S,onSessionEnd:C}=c,w=r.createAuthStore({name:m,storage:h}),T=`${m}-refresh`;function E(){return typeof window>`u`?null:h===`session`?window.sessionStorage:window.localStorage}function D(){return E()?.getItem(T)??null}function O(e){let t=E();t&&(e?t.setItem(T,e):t.removeItem(T))}let k=()=>w.getState(),A=()=>k().token;async function j(){if(!p)return k().user;let e=M,n;try{n=await $.get(p,{skipAuthRetry:!0})}catch(n){throw M===e?n:new t.SessionSupersededError}if(M!==e)throw new t.SessionSupersededError;return k().setUser(n),n}let M=0,N=Promise.resolve(),P=0,F=new Set,I=new Set,L=new Set,R=new Set;function z(e){let t=e.then(()=>void 0,()=>void 0);return L.add(t),t.then(()=>L.delete(t)),e}function B(t){e.isDevBuild()&&console.warn(`[tempest-react-sdk] createTempestAuth: logoutPath revocation failed`,t);try{te?.(t)}catch{return}}function V(e){let t=(async()=>{try{await e()}catch(e){B(e)}})();return I.add(t),t.then(()=>I.delete(t)),t}function H(e,t){f&&!g&&t&&V(()=>U(e).post(f,{body:x(t)}))}function U(e){return n.createApiClient({baseURL:l,prefix:u,withCredentials:g,csrf:_,fetcher:v,getToken:()=>e})}function W(){M+=1,K=i.createRefreshQueue(G)}async function G(){let e=M;R.add(e);try{let n;try{n=await z($.post(ee,{body:x(D()),skipAuth:!0}))}catch(n){throw M===e?n:new t.SessionSupersededError}let{token:r,refreshToken:i}=y(n);if(M!==e)throw H(r??null,i),new t.SessionSupersededError;k().setToken(r),i&&O(i)}finally{R.delete(e)}}let K=i.createRefreshQueue(G);function q(e){let t=A();return t===null?!1:e.token===null||e.token!==t}function J(){return A()===null&&D()===null}async function Y(){if(!(F.size>0&&P===0&&(await Promise.allSettled([...F]),A()!==null)))throw Error(`anonymous 401 with no session`)}async function X(e){if(e.epoch!==null&&e.epoch!==M)throw new t.SessionSupersededError;if(q(e)){if(e.token===null)throw Error(`anonymous 401 under a live session`)}else return e.token===null&&J()?R.has(M)?K():Y():K()}async function Z(e,n){if(n.epoch!==null&&n.epoch!==M)throw new t.SessionSupersededError;q(n)||n.token===null&&J()||await se()}async function re(e){I.size>0&&await o([...I],a);let t=ie(e);F.add(t);try{return await t}finally{F.delete(t)}}async function ie(e){let n=M,r=await z($.post(d,{body:e,skipAuth:!0})),{token:i,refreshToken:a}=y(r);if(M!==n)throw H(i??null,a),new t.SessionSupersededError;let{done:o}=Q(`switch`),s=M;if(await o.catch(()=>void 0),M!==s)throw new t.SessionSupersededError;k().setToken(i),O(a??null);let c=b?.(r);return c==null?j():(k().setUser(c),c)}function Q(e){let{user:t,token:n}=k(),r=n!==null||t!==null||D()!==null;if((r||e!==`expired`)&&W(),k().logout(),O(null),!r)return{live:r,done:e===`switch`||P===0?N:Promise.resolve()};if(!C)return{live:r,done:Promise.resolve()};let i=U(n);P+=1;let a=(async()=>{try{await C({reason:e,user:t,token:n,api:i})}finally{--P}})();return N=a.then(()=>void 0,()=>void 0),{live:r,done:a.then(()=>void 0)}}function ae(){if(!f)return null;let e=f,{token:t,user:n}=k(),r=D();if(!g&&t===null&&n===null&&r===null)return null;let i=g?[...L]:[];return V(async()=>(await o(i,a),U(t).post(e,{body:x(r)})))}function oe(){let e=ae(),{done:t}=Q(`logout`);return e?Promise.all([e,t]).then(()=>void 0):t}async function se(){let{live:e,done:t}=Q(`expired`);await t.catch(()=>void 0),e&&S&&typeof window<`u`&&window.location.assign(S)}let $=n.createApiClient({baseURL:l,prefix:u,withCredentials:g,csrf:_,fetcher:v,getToken:A,getSessionEpoch:()=>M,refresh:X,retry:ne,onUnauthorized:Z});return{useAuthStore:w,api:$,login:re,logout:oe,refresh:()=>K(),getToken:A}}exports.createTempestAuth=c;
 //# sourceMappingURL=create-tempest-auth.cjs.map