@memberjunction/ng-conversations 6.2.0-edge.4 → 6.2.0-edge.5

package/dist/lib/services/realtime-pcm-wav.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"realtime-pcm-wav.d.ts","sourceRoot":"","sources":["../../../src/lib/services/realtime-pcm-wav.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAcnC;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAkCrF;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAErF;AASD;;;;;;GAMG;AACH,qBAAa,eAAe;IACxB,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,oGAAoG;IACpG,OAAO,CAAC,OAAO,CAAgB;IAC/B,gFAAgF;IAChF,OAAO,CAAC,gBAAgB,CAAK;IAC7B,8DAA8D;IAC9D,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;OAGG;gBACS,aAAa,SAAM;IAI/B,+DAA+D;IAC/D,IAAW,WAAW,IAAI,MAAM,CAE/B;IAED,uFAAuF;IAChF,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAMxC,kGAAkG;IAClG,OAAO,CAAC,UAAU;IAsBlB,gGAAgG;IAChG,OAAO,CAAC,IAAI;IAYZ;;;OAGG;IACI,SAAS,IAAI,MAAM,EAAE;CAgB/B;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,SAAM,GAAG,MAAM,EAAE,CA4BpF;AAED,+CAA+C;AAC/C,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,aAAa,SAAM,GAAG,MAAM,EAAE,CAEpF"}

package/dist/lib/services/realtime-pcm-wav.js

@@ -1,213 +0,0 @@
-/**
- * @fileoverview Pure, browser-and-node-safe helpers for the CLIENT-DIRECT realtime recorder:
- * encoding accumulated Float32 PCM into a seekable 16-bit PCM **WAV** container and computing a
- * bounded, downsampled waveform **peak** array at capture time.
- *
- * These functions are deliberately free of any browser API (`AudioContext`, `Blob`, …) so they can
- * be unit-tested in a plain Node environment. {@link RealtimeAudioRecorder} owns the live audio
- * graph and feeds the captured samples here.
- *
- * Why WAV (PCM) over webm/opus: a RIFF/WAVE header carries the exact duration and maps a byte
- * offset linearly to a time offset, so HTTP-range seeking is exact (no client-side duration nudge),
- * and peak extraction is trivial. The tradeoff is size — PCM WAV is larger than opus — which is
- * acceptable for these short session recordings.
- *
- * @module @memberjunction/ng-conversations/realtime-pcm-wav
- */
-/** Lowest value representable by signed 16-bit PCM. */
-const PCM16_MIN = -32768;
-/** Highest value representable by signed 16-bit PCM. */
-const PCM16_MAX = 32767;
-/** Canonical WAV/PCM header size in bytes (RIFF + fmt + data chunk headers). */
-export const WAV_HEADER_BYTES = 44;
-/**
- * Converts one Float32 sample (nominally in `[-1, 1]`) to a clamped signed 16-bit integer.
- * Out-of-range values (a hot mix can briefly exceed unity) are clamped, not wrapped.
- */
-function floatToPcm16(sample) {
-    const clamped = sample < -1 ? -1 : sample > 1 ? 1 : sample;
-    // Asymmetric scaling: negative full-scale is -32768, positive is +32767.
-    const scaled = clamped < 0 ? clamped * -PCM16_MIN : clamped * PCM16_MAX;
-    const rounded = Math.round(scaled);
-    return rounded < PCM16_MIN ? PCM16_MIN : rounded > PCM16_MAX ? PCM16_MAX : rounded;
-}
-/**
- * Encodes mono Float32 PCM samples as a canonical single-chunk 16-bit PCM WAV (RIFF/WAVE).
- * The returned `ArrayBuffer` is `WAV_HEADER_BYTES + samples.length * 2` bytes — a proper
- * 44-byte header followed by little-endian PCM16 data, so it is seekable and self-describing.
- *
- * @param samples Mono Float32 PCM in `[-1, 1]` (downmixed by the caller).
- * @param sampleRate Sample rate in Hz (from the capturing `AudioContext`).
- * @returns A standalone `ArrayBuffer` containing the full WAV file.
- */
-export function EncodePcm16Wav(samples, sampleRate) {
-    const numChannels = 1;
-    const bitsPerSample = 16;
-    const bytesPerSample = bitsPerSample / 8;
-    const blockAlign = numChannels * bytesPerSample;
-    const byteRate = sampleRate * blockAlign;
-    const dataSize = samples.length * bytesPerSample;
-    const buffer = new ArrayBuffer(WAV_HEADER_BYTES + dataSize);
-    const view = new DataView(buffer);
-    writeAscii(view, 0, 'RIFF');
-    view.setUint32(4, 36 + dataSize, true); // ChunkSize = 36 + Subchunk2Size
-    writeAscii(view, 8, 'WAVE');
-    writeAscii(view, 12, 'fmt ');
-    view.setUint32(16, 16, true); // Subchunk1Size (16 for PCM)
-    view.setUint16(20, 1, true); // AudioFormat = PCM
-    view.setUint16(22, numChannels, true);
-    view.setUint32(24, sampleRate, true);
-    view.setUint32(28, byteRate, true);
-    view.setUint16(32, blockAlign, true);
-    view.setUint16(34, bitsPerSample, true);
-    writeAscii(view, 36, 'data');
-    view.setUint32(40, dataSize, true);
-    let offset = WAV_HEADER_BYTES;
-    for (let i = 0; i < samples.length; i++) {
-        view.setInt16(offset, floatToPcm16(samples[i]), true);
-        offset += bytesPerSample;
-    }
-    return buffer;
-}
-/** @deprecated Use {@link EncodePcm16Wav}. */
-export function encodePcm16Wav(samples, sampleRate) {
-    return EncodePcm16Wav(samples, sampleRate);
-}
-/** Writes an ASCII string into a {@link DataView} byte-by-byte at `offset`. */
-function writeAscii(view, offset, text) {
-    for (let i = 0; i < text.length; i++) {
-        view.setUint8(offset + i, text.charCodeAt(i));
-    }
-}
-/**
- * A bounded, streaming waveform-peak accumulator. It maintains a fixed number of buckets
- * (`targetBuckets`) of max-absolute amplitude across the WHOLE recording regardless of length:
- * once every bucket has absorbed `samplesPerBucket` samples, the buckets are halved (pairwise
- * max-merged) and the per-bucket capacity doubles — so memory + cost stay O(targetBuckets) for an
- * arbitrarily long call. {@link Normalize} returns the final 0..1 peaks.
- */
-export class PeakAccumulator {
-    /** Target (max) number of buckets in the produced peak array. */
-    targetBuckets;
-    /** Current max-abs amplitude per bucket (length grows up to `2 * targetBuckets` before folding). */
-    buckets = [];
-    /** How many samples each bucket currently absorbs before a new bucket opens. */
-    samplesPerBucket = 1;
-    /** Samples absorbed into the current (last) bucket so far. */
-    samplesInCurrent = 0;
-    /**
-     * @param targetBuckets Desired bucket count (waveform resolution). Clamped to >= 1.
-     *   ~600 gives a smooth overview waveform at trivial cost.
-     */
-    constructor(targetBuckets = 600) {
-        this.targetBuckets = Math.max(1, Math.floor(targetBuckets));
-    }
-    /** Number of buckets currently held (for tests/inspection). */
-    get BucketCount() {
-        return this.buckets.length;
-    }
-    /** Absorbs a block of Float32 PCM samples, updating the running per-bucket max-abs. */
-    Push(samples) {
-        for (let i = 0; i < samples.length; i++) {
-            this.pushSample(samples[i]);
-        }
-    }
-    /** Absorbs one sample into the current bucket, opening/folding buckets as capacity is reached. */
-    pushSample(sample) {
-        if (this.buckets.length === 0) {
-            this.buckets.push(0);
-            this.samplesInCurrent = 0;
-        }
-        const abs = sample < 0 ? -sample : sample;
-        const last = this.buckets.length - 1;
-        if (abs > this.buckets[last]) {
-            this.buckets[last] = abs;
-        }
-        this.samplesInCurrent++;
-        if (this.samplesInCurrent >= this.samplesPerBucket) {
-            this.buckets.push(0);
-            this.samplesInCurrent = 0;
-            // Keep the bucket array bounded: once it reaches 2x the target, fold pairwise so the
-            // resolution stays under the cap while the per-bucket sample capacity doubles.
-            if (this.buckets.length >= this.targetBuckets * 2) {
-                this.fold();
-            }
-        }
-    }
-    /** Pairwise max-merges adjacent buckets, halving the count and doubling per-bucket capacity. */
-    fold() {
-        const folded = [];
-        for (let i = 0; i < this.buckets.length; i += 2) {
-            const a = this.buckets[i];
-            const b = i + 1 < this.buckets.length ? this.buckets[i + 1] : 0;
-            folded.push(a > b ? a : b);
-        }
-        this.buckets = folded;
-        this.samplesPerBucket *= 2;
-        this.samplesInCurrent = 0;
-    }
-    /**
-     * Produces the final normalized peak array (each value 0..1, divided by the global max).
-     * Trailing empty buckets are trimmed; an all-silent / empty recording yields `[]`.
-     */
-    Normalize() {
-        // Drop a trailing freshly-opened empty bucket that absorbed nothing.
-        const raw = this.buckets.length > 0 && this.samplesInCurrent === 0 && this.buckets.length > 1
-            ? this.buckets.slice(0, -1)
-            : this.buckets.slice();
-        let max = 0;
-        for (const v of raw) {
-            if (v > max) {
-                max = v;
-            }
-        }
-        if (max <= 0) {
-            return [];
-        }
-        return raw.map(v => v / max);
-    }
-}
-/**
- * One-shot peak downsampling of a complete Float32 PCM buffer into `targetBuckets` normalized
- * max-abs peaks (0..1). The streaming {@link PeakAccumulator} is the production path; this is the
- * direct, allocation-light equivalent used where the whole buffer is already in hand (and in tests).
- *
- * @param samples The full mono Float32 PCM buffer.
- * @param targetBuckets Desired bucket count (clamped to >= 1). Buckets beyond the sample count are
- *   not produced — a short buffer yields at most `samples.length` peaks.
- * @returns Normalized peaks; `[]` for an empty or all-silent buffer.
- */
-export function DownsamplePeaks(samples, targetBuckets = 600) {
-    const target = Math.max(1, Math.floor(targetBuckets));
-    if (samples.length === 0) {
-        return [];
-    }
-    const buckets = Math.min(target, samples.length);
-    const samplesPerBucket = samples.length / buckets;
-    const peaks = new Array(buckets).fill(0);
-    let globalMax = 0;
-    for (let b = 0; b < buckets; b++) {
-        const start = Math.floor(b * samplesPerBucket);
-        const end = b === buckets - 1 ? samples.length : Math.floor((b + 1) * samplesPerBucket);
-        let localMax = 0;
-        for (let i = start; i < end; i++) {
-            const abs = samples[i] < 0 ? -samples[i] : samples[i];
-            if (abs > localMax) {
-                localMax = abs;
-            }
-        }
-        peaks[b] = localMax;
-        if (localMax > globalMax) {
-            globalMax = localMax;
-        }
-    }
-    if (globalMax <= 0) {
-        return [];
-    }
-    return peaks.map(v => v / globalMax);
-}
-/** @deprecated Use {@link DownsamplePeaks}. */
-export function downsamplePeaks(samples, targetBuckets = 600) {
-    return DownsamplePeaks(samples, targetBuckets);
-}
-//# sourceMappingURL=realtime-pcm-wav.js.map

package/dist/lib/services/realtime-pcm-wav.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"realtime-pcm-wav.js","sourceRoot":"","sources":["../../../src/lib/services/realtime-pcm-wav.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview Pure, browser-and-node-safe helpers for the CLIENT-DIRECT realtime recorder:\n * encoding accumulated Float32 PCM into a seekable 16-bit PCM **WAV** container and computing a\n * bounded, downsampled waveform **peak** array at capture time.\n *\n * These functions are deliberately free of any browser API (`AudioContext`, `Blob`, …) so they can\n * be unit-tested in a plain Node environment. {@link RealtimeAudioRecorder} owns the live audio\n * graph and feeds the captured samples here.\n *\n * Why WAV (PCM) over webm/opus: a RIFF/WAVE header carries the exact duration and maps a byte\n * offset linearly to a time offset, so HTTP-range seeking is exact (no client-side duration nudge),\n * and peak extraction is trivial. The tradeoff is size — PCM WAV is larger than opus — which is\n * acceptable for these short session recordings.\n *\n * @module @memberjunction/ng-conversations/realtime-pcm-wav\n */\n\n/** Lowest value representable by signed 16-bit PCM. */\nconst PCM16_MIN = -32768;\n/** Highest value representable by signed 16-bit PCM. */\nconst PCM16_MAX = 32767;\n/** Canonical WAV/PCM header size in bytes (RIFF + fmt + data chunk headers). */\nexport const WAV_HEADER_BYTES = 44;\n\n/**\n * Converts one Float32 sample (nominally in `[-1, 1]`) to a clamped signed 16-bit integer.\n * Out-of-range values (a hot mix can briefly exceed unity) are clamped, not wrapped.\n */\nfunction floatToPcm16(sample: number): number {\n    const clamped = sample < -1 ? -1 : sample > 1 ? 1 : sample;\n    // Asymmetric scaling: negative full-scale is -32768, positive is +32767.\n    const scaled = clamped < 0 ? clamped * -PCM16_MIN : clamped * PCM16_MAX;\n    const rounded = Math.round(scaled);\n    return rounded < PCM16_MIN ? PCM16_MIN : rounded > PCM16_MAX ? PCM16_MAX : rounded;\n}\n\n/**\n * Encodes mono Float32 PCM samples as a canonical single-chunk 16-bit PCM WAV (RIFF/WAVE).\n * The returned `ArrayBuffer` is `WAV_HEADER_BYTES + samples.length * 2` bytes — a proper\n * 44-byte header followed by little-endian PCM16 data, so it is seekable and self-describing.\n *\n * @param samples Mono Float32 PCM in `[-1, 1]` (downmixed by the caller).\n * @param sampleRate Sample rate in Hz (from the capturing `AudioContext`).\n * @returns A standalone `ArrayBuffer` containing the full WAV file.\n */\nexport function EncodePcm16Wav(samples: Float32Array, sampleRate: number): ArrayBuffer {\n    const numChannels = 1;\n    const bitsPerSample = 16;\n    const bytesPerSample = bitsPerSample / 8;\n    const blockAlign = numChannels * bytesPerSample;\n    const byteRate = sampleRate * blockAlign;\n    const dataSize = samples.length * bytesPerSample;\n\n    const buffer = new ArrayBuffer(WAV_HEADER_BYTES + dataSize);\n    const view = new DataView(buffer);\n\n    writeAscii(view, 0, 'RIFF');\n    view.setUint32(4, 36 + dataSize, true); // ChunkSize = 36 + Subchunk2Size\n    writeAscii(view, 8, 'WAVE');\n\n    writeAscii(view, 12, 'fmt ');\n    view.setUint32(16, 16, true); // Subchunk1Size (16 for PCM)\n    view.setUint16(20, 1, true); // AudioFormat = PCM\n    view.setUint16(22, numChannels, true);\n    view.setUint32(24, sampleRate, true);\n    view.setUint32(28, byteRate, true);\n    view.setUint16(32, blockAlign, true);\n    view.setUint16(34, bitsPerSample, true);\n\n    writeAscii(view, 36, 'data');\n    view.setUint32(40, dataSize, true);\n\n    let offset = WAV_HEADER_BYTES;\n    for (let i = 0; i < samples.length; i++) {\n        view.setInt16(offset, floatToPcm16(samples[i]), true);\n        offset += bytesPerSample;\n    }\n\n    return buffer;\n}\n\n/** @deprecated Use {@link EncodePcm16Wav}. */\nexport function encodePcm16Wav(samples: Float32Array, sampleRate: number): ArrayBuffer {\n    return EncodePcm16Wav(samples, sampleRate);\n}\n\n/** Writes an ASCII string into a {@link DataView} byte-by-byte at `offset`. */\nfunction writeAscii(view: DataView, offset: number, text: string): void {\n    for (let i = 0; i < text.length; i++) {\n        view.setUint8(offset + i, text.charCodeAt(i));\n    }\n}\n\n/**\n * A bounded, streaming waveform-peak accumulator. It maintains a fixed number of buckets\n * (`targetBuckets`) of max-absolute amplitude across the WHOLE recording regardless of length:\n * once every bucket has absorbed `samplesPerBucket` samples, the buckets are halved (pairwise\n * max-merged) and the per-bucket capacity doubles — so memory + cost stay O(targetBuckets) for an\n * arbitrarily long call. {@link Normalize} returns the final 0..1 peaks.\n */\nexport class PeakAccumulator {\n    /** Target (max) number of buckets in the produced peak array. */\n    private readonly targetBuckets: number;\n    /** Current max-abs amplitude per bucket (length grows up to `2 * targetBuckets` before folding). */\n    private buckets: number[] = [];\n    /** How many samples each bucket currently absorbs before a new bucket opens. */\n    private samplesPerBucket = 1;\n    /** Samples absorbed into the current (last) bucket so far. */\n    private samplesInCurrent = 0;\n\n    /**\n     * @param targetBuckets Desired bucket count (waveform resolution). Clamped to >= 1.\n     *   ~600 gives a smooth overview waveform at trivial cost.\n     */\n    constructor(targetBuckets = 600) {\n        this.targetBuckets = Math.max(1, Math.floor(targetBuckets));\n    }\n\n    /** Number of buckets currently held (for tests/inspection). */\n    public get BucketCount(): number {\n        return this.buckets.length;\n    }\n\n    /** Absorbs a block of Float32 PCM samples, updating the running per-bucket max-abs. */\n    public Push(samples: Float32Array): void {\n        for (let i = 0; i < samples.length; i++) {\n            this.pushSample(samples[i]);\n        }\n    }\n\n    /** Absorbs one sample into the current bucket, opening/folding buckets as capacity is reached. */\n    private pushSample(sample: number): void {\n        if (this.buckets.length === 0) {\n            this.buckets.push(0);\n            this.samplesInCurrent = 0;\n        }\n        const abs = sample < 0 ? -sample : sample;\n        const last = this.buckets.length - 1;\n        if (abs > this.buckets[last]) {\n            this.buckets[last] = abs;\n        }\n        this.samplesInCurrent++;\n        if (this.samplesInCurrent >= this.samplesPerBucket) {\n            this.buckets.push(0);\n            this.samplesInCurrent = 0;\n            // Keep the bucket array bounded: once it reaches 2x the target, fold pairwise so the\n            // resolution stays under the cap while the per-bucket sample capacity doubles.\n            if (this.buckets.length >= this.targetBuckets * 2) {\n                this.fold();\n            }\n        }\n    }\n\n    /** Pairwise max-merges adjacent buckets, halving the count and doubling per-bucket capacity. */\n    private fold(): void {\n        const folded: number[] = [];\n        for (let i = 0; i < this.buckets.length; i += 2) {\n            const a = this.buckets[i];\n            const b = i + 1 < this.buckets.length ? this.buckets[i + 1] : 0;\n            folded.push(a > b ? a : b);\n        }\n        this.buckets = folded;\n        this.samplesPerBucket *= 2;\n        this.samplesInCurrent = 0;\n    }\n\n    /**\n     * Produces the final normalized peak array (each value 0..1, divided by the global max).\n     * Trailing empty buckets are trimmed; an all-silent / empty recording yields `[]`.\n     */\n    public Normalize(): number[] {\n        // Drop a trailing freshly-opened empty bucket that absorbed nothing.\n        const raw = this.buckets.length > 0 && this.samplesInCurrent === 0 && this.buckets.length > 1\n            ? this.buckets.slice(0, -1)\n            : this.buckets.slice();\n        let max = 0;\n        for (const v of raw) {\n            if (v > max) {\n                max = v;\n            }\n        }\n        if (max <= 0) {\n            return [];\n        }\n        return raw.map(v => v / max);\n    }\n}\n\n/**\n * One-shot peak downsampling of a complete Float32 PCM buffer into `targetBuckets` normalized\n * max-abs peaks (0..1). The streaming {@link PeakAccumulator} is the production path; this is the\n * direct, allocation-light equivalent used where the whole buffer is already in hand (and in tests).\n *\n * @param samples The full mono Float32 PCM buffer.\n * @param targetBuckets Desired bucket count (clamped to >= 1). Buckets beyond the sample count are\n *   not produced — a short buffer yields at most `samples.length` peaks.\n * @returns Normalized peaks; `[]` for an empty or all-silent buffer.\n */\nexport function DownsamplePeaks(samples: Float32Array, targetBuckets = 600): number[] {\n    const target = Math.max(1, Math.floor(targetBuckets));\n    if (samples.length === 0) {\n        return [];\n    }\n    const buckets = Math.min(target, samples.length);\n    const samplesPerBucket = samples.length / buckets;\n    const peaks = new Array<number>(buckets).fill(0);\n    let globalMax = 0;\n    for (let b = 0; b < buckets; b++) {\n        const start = Math.floor(b * samplesPerBucket);\n        const end = b === buckets - 1 ? samples.length : Math.floor((b + 1) * samplesPerBucket);\n        let localMax = 0;\n        for (let i = start; i < end; i++) {\n            const abs = samples[i] < 0 ? -samples[i] : samples[i];\n            if (abs > localMax) {\n                localMax = abs;\n            }\n        }\n        peaks[b] = localMax;\n        if (localMax > globalMax) {\n            globalMax = localMax;\n        }\n    }\n    if (globalMax <= 0) {\n        return [];\n    }\n    return peaks.map(v => v / globalMax);\n}\n\n/** @deprecated Use {@link DownsamplePeaks}. */\nexport function downsamplePeaks(samples: Float32Array, targetBuckets = 600): number[] {\n    return DownsamplePeaks(samples, targetBuckets);\n}\n"]}