@memberjunction/livekit-room-server 6.2.0-edge.1 → 6.2.0-edge.3

package/dist/meeting-dial-in-service.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @fileoverview Server-side service for verifying and generating phone dial-in codes for meetings.
+ *
+ * Security architecture:
+ * - Dial-in codes are NOT verified through a public GraphQL mutation.
+ * - Verification is performed server-side by the LiveKit SIP inbound path upon receiving verified webhooks.
+ * - Dual rate-limiting:
+ *   1. Keyed on the caller's verified phone number (`CallerNumber`).
+ *   2. Keyed on the dialed trunk number (`DialedNumber`) to prevent distributed brute-forcing against a single line.
+ * - Code generation uses `crypto.randomInt` (cryptographically secure pseudo-random number generator), never `Math.random`.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { BaseSingleton } from '@memberjunction/global';
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+/** Rate limiter with configurable attempt limits and lockout windows. */
+export declare class DialInRateLimiter {
+    private readonly maxAttempts;
+    private readonly windowMs;
+    private readonly lockoutMs;
+    private readonly attempts;
+    constructor(maxAttempts?: number, windowMs?: number, lockoutMs?: number);
+    CheckAllowed(key: string): {
+        allowed: boolean;
+        remainingMs?: number;
+    };
+    RecordFailure(key: string): void;
+    RecordSuccess(key: string): void;
+    Clear(): void;
+}
+/** Input parameters for verifying a dial-in code. */
+export interface VerifyDialInCodeParams {
+    /** The verified caller number from the SIP carrier webhook. */
+    CallerNumber: string;
+    /** The dialed phone number or Phone Numbers row ID. */
+    DialedNumber: string;
+    /** The DTMF dial-in code entered by the caller. */
+    DialInCode: string;
+    /** Optional authenticated context user. */
+    ContextUser?: UserInfo;
+    /** Optional metadata provider. */
+    Provider?: IMetadataProvider;
+}
+/** Result of dial-in code verification. */
+export interface VerifyDialInCodeOutcome {
+    Success: boolean;
+    ErrorMessage?: string;
+    RoomName?: string;
+    MeetingID?: string;
+}
+/**
+ * Server-side singleton service for meeting dial-in verification and code generation.
+ */
+export declare class MeetingDialInService extends BaseSingleton<MeetingDialInService> {
+    private readonly callerLimiter;
+    private readonly dialedLimiter;
+    constructor();
+    static get Instance(): MeetingDialInService;
+    /**
+     * Generates a cryptographically secure 6-digit numeric dial-in code.
+     */
+    GenerateDialInCode(): string;
+    /**
+     * Generates a unique 6-digit dial-in code for a given phone number among active/scheduled meetings.
+     */
+    GenerateUniqueDialInCode(phoneNumberID: string, user: UserInfo, provider?: IMetadataProvider): Promise<string | undefined>;
+    /**
+     * Verifies a DTMF dial-in code against active/scheduled meetings on the dialed line.
+     * Rate limits on both the verified caller number and the dialed number.
+     */
+    VerifyDialInCode(params: VerifyDialInCodeParams): Promise<VerifyDialInCodeOutcome>;
+    /** Clears rate limiter entries (test harness). */
+    ClearRateLimitsForTesting(): void;
+}
+//# sourceMappingURL=meeting-dial-in-service.d.ts.map

package/dist/meeting-dial-in-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meeting-dial-in-service.d.ts","sourceRoot":"","sources":["../src/meeting-dial-in-service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,EAAE,aAAa,EAAmB,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAqB,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAUhG,yEAAyE;AACzE,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqC;gBAG3C,WAAW,GAAE,MAAU,EACvB,QAAQ,GAAE,MAAuB,EACjC,SAAS,GAAE,MAAuB;IAG9C,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE;IAoBrE,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAahC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIhC,KAAK,IAAI,IAAI;CAGrB;AAED,qDAAqD;AACrD,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,WAAW,CAAC,EAAE,QAAQ,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,2CAA2C;AAC3C,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa,CAAC,oBAAoB,CAAC;IAE3E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA4D;IAE1F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA6D;;IAM3F,WAAkB,QAAQ,IAAI,oBAAoB,CAEjD;IAED;;OAEG;IACI,kBAAkB,IAAI,MAAM;IAInC;;OAEG;IACU,wBAAwB,CACnC,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAqB9B;;;OAGG;IACU,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,uBAAuB,CAAC;IA0E/F,kDAAkD;IAC3C,yBAAyB,IAAI,IAAI;CAIzC"}

package/dist/meeting-dial-in-service.js

@@ -0,0 +1,175 @@
+/**
+ * @fileoverview Server-side service for verifying and generating phone dial-in codes for meetings.
+ *
+ * Security architecture:
+ * - Dial-in codes are NOT verified through a public GraphQL mutation.
+ * - Verification is performed server-side by the LiveKit SIP inbound path upon receiving verified webhooks.
+ * - Dual rate-limiting:
+ *   1. Keyed on the caller's verified phone number (`CallerNumber`).
+ *   2. Keyed on the dialed trunk number (`DialedNumber`) to prevent distributed brute-forcing against a single line.
+ * - Code generation uses `crypto.randomInt` (cryptographically secure pseudo-random number generator), never `Math.random`.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { randomInt } from 'node:crypto';
+import { BaseSingleton, EscapeSQLString } from '@memberjunction/global';
+import { LogError, RunView } from '@memberjunction/core';
+/** Rate limiter with configurable attempt limits and lockout windows. */
+export class DialInRateLimiter {
+    constructor(maxAttempts = 5, windowMs = 15 * 60 * 1000, lockoutMs = 15 * 60 * 1000) {
+        this.maxAttempts = maxAttempts;
+        this.windowMs = windowMs;
+        this.lockoutMs = lockoutMs;
+        this.attempts = new Map();
+    }
+    CheckAllowed(key) {
+        const entry = this.attempts.get(key);
+        if (!entry) {
+            return { allowed: true };
+        }
+        const now = Date.now();
+        if (entry.lockedUntil && entry.lockedUntil > now) {
+            return { allowed: false, remainingMs: entry.lockedUntil - now };
+        }
+        if (now - entry.firstAttemptAt > this.windowMs) {
+            this.attempts.delete(key);
+            return { allowed: true };
+        }
+        if (entry.attempts >= this.maxAttempts) {
+            entry.lockedUntil = now + this.lockoutMs;
+            return { allowed: false, remainingMs: this.lockoutMs };
+        }
+        return { allowed: true };
+    }
+    RecordFailure(key) {
+        const now = Date.now();
+        const entry = this.attempts.get(key);
+        if (!entry || now - entry.firstAttemptAt > this.windowMs) {
+            this.attempts.set(key, { attempts: 1, firstAttemptAt: now });
+        }
+        else {
+            entry.attempts++;
+            if (entry.attempts >= this.maxAttempts) {
+                entry.lockedUntil = now + this.lockoutMs;
+            }
+        }
+    }
+    RecordSuccess(key) {
+        this.attempts.delete(key);
+    }
+    Clear() {
+        this.attempts.clear();
+    }
+}
+/**
+ * Server-side singleton service for meeting dial-in verification and code generation.
+ */
+export class MeetingDialInService extends BaseSingleton {
+    constructor() {
+        super();
+        // Caller-based limiter: 5 attempts per 15 minutes
+        this.callerLimiter = new DialInRateLimiter(5, 15 * 60 * 1000, 15 * 60 * 1000);
+        // Dialed-number limiter: 20 failed attempts per 15 minutes across all callers
+        this.dialedLimiter = new DialInRateLimiter(20, 15 * 60 * 1000, 15 * 60 * 1000);
+    }
+    static get Instance() {
+        return MeetingDialInService.getInstance();
+    }
+    /**
+     * Generates a cryptographically secure 6-digit numeric dial-in code.
+     */
+    GenerateDialInCode() {
+        return randomInt(100000, 1000000).toString();
+    }
+    /**
+     * Generates a unique 6-digit dial-in code for a given phone number among active/scheduled meetings.
+     */
+    async GenerateUniqueDialInCode(phoneNumberID, user, provider) {
+        const rv = provider ? RunView.FromMetadataProvider(provider) : new RunView();
+        const escapedPhoneID = EscapeSQLString(phoneNumberID);
+        for (let attempt = 0; attempt < 10; attempt++) {
+            const candidate = this.GenerateDialInCode();
+            const res = await rv.RunView({
+                EntityName: 'MJ: Meetings',
+                ExtraFilter: `DialInPhoneNumberID = '${escapedPhoneID}' AND DialInCode = '${candidate}' AND Status IN ('Live', 'Scheduled')`,
+                ResultType: 'entity_object',
+            }, user);
+            if (res.Success && (!res.Results || res.Results.length === 0)) {
+                return candidate;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Verifies a DTMF dial-in code against active/scheduled meetings on the dialed line.
+     * Rate limits on both the verified caller number and the dialed number.
+     */
+    async VerifyDialInCode(params) {
+        try {
+            const callerNumber = (params.CallerNumber ?? '').trim().toLowerCase();
+            const dialedNumber = (params.DialedNumber ?? '').trim();
+            const dialInCode = (params.DialInCode ?? '').trim();
+            if (!callerNumber) {
+                return { Success: false, ErrorMessage: 'Caller number is required.' };
+            }
+            if (!dialedNumber) {
+                return { Success: false, ErrorMessage: 'Dialed number is required.' };
+            }
+            if (!dialInCode) {
+                return { Success: false, ErrorMessage: 'Dial-in code is required.' };
+            }
+            // Check caller-based rate limit
+            const callerLimit = this.callerLimiter.CheckAllowed(callerNumber);
+            if (!callerLimit.allowed) {
+                const remainingSeconds = Math.ceil((callerLimit.remainingMs ?? 0) / 1000);
+                return {
+                    Success: false,
+                    ErrorMessage: `Too many invalid attempts from this caller. Please try again in ${remainingSeconds} seconds.`,
+                };
+            }
+            // Check dialed-number-based rate limit
+            const dialedKey = dialedNumber.toLowerCase();
+            const dialedLimit = this.dialedLimiter.CheckAllowed(dialedKey);
+            if (!dialedLimit.allowed) {
+                const remainingSeconds = Math.ceil((dialedLimit.remainingMs ?? 0) / 1000);
+                return {
+                    Success: false,
+                    ErrorMessage: `Too many invalid attempts on this line. Please try again in ${remainingSeconds} seconds.`,
+                };
+            }
+            const escapedDialed = EscapeSQLString(dialedNumber);
+            const escapedCode = EscapeSQLString(dialInCode);
+            const rv = params.Provider ? RunView.FromMetadataProvider(params.Provider) : new RunView();
+            const filter = `(DialInPhoneNumberID = '${escapedDialed}' OR DialInPhoneNumber = '${escapedDialed}') AND DialInCode = '${escapedCode}' AND Status IN ('Live', 'Scheduled')`;
+            const result = await rv.RunView({
+                EntityName: 'MJ: Meetings',
+                ExtraFilter: filter,
+                ResultType: 'entity_object',
+            }, params.ContextUser);
+            if (!result.Success || !result.Results || result.Results.length === 0) {
+                this.callerLimiter.RecordFailure(callerNumber);
+                this.dialedLimiter.RecordFailure(dialedKey);
+                return { Success: false, ErrorMessage: 'Invalid dial-in code.' };
+            }
+            this.callerLimiter.RecordSuccess(callerNumber);
+            this.dialedLimiter.RecordSuccess(dialedKey);
+            const meeting = result.Results[0];
+            return {
+                Success: true,
+                RoomName: meeting.RoomName,
+                MeetingID: meeting.ID,
+            };
+        }
+        catch (error) {
+            const msg = error instanceof Error ? error.message : String(error);
+            LogError(`[MeetingDialInService] VerifyDialInCode exception: ${msg}`);
+            return { Success: false, ErrorMessage: msg };
+        }
+    }
+    /** Clears rate limiter entries (test harness). */
+    ClearRateLimitsForTesting() {
+        this.callerLimiter.Clear();
+        this.dialedLimiter.Clear();
+    }
+}
+//# sourceMappingURL=meeting-dial-in-service.js.map

package/dist/meeting-dial-in-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meeting-dial-in-service.js","sourceRoot":"","sources":["../src/meeting-dial-in-service.ts"],"names":[],"mappings":"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"}

package/dist/room-audio/audio-decoder.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview {@link DecodeAudio} — turns an audio file's bytes (WAV or MP3) into mono PCM16, the one shape the
+ * room audio player plays. WAV is parsed here (RIFF chunk walk, integer PCM 8/16/24/32-bit and IEEE float 32/64-bit,
+ * any channel count downmixed); MP3 is decoded by `mpg123-decoder`, a WebAssembly build of libmpg123 with no native
+ * build step. Anything else is refused with an error that names the format it saw.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+/** Decoded audio: mono 16-bit PCM and its sample rate. */
+export interface DecodedAudio {
+    /** Mono PCM16 samples. */
+    Pcm: Int16Array;
+    /** The rate of {@link Pcm}, in Hz. */
+    SampleRate: number;
+}
+/** What the caller knows about the bytes, used only when the bytes themselves do not say what they are. */
+export interface AudioFormatHint {
+    /** The MIME type (e.g. `audio/mpeg`, `audio/wav`). */
+    MimeType?: string;
+    /** The file name (its extension is read). */
+    FileName?: string;
+}
+/** The longest audio {@link DecodeAudio} accepts, in seconds (15 minutes). Hold music loops; a longer file is a mistake. */
+export declare const MAX_DECODED_AUDIO_SECONDS: number;
+/**
+ * Decodes WAV or MP3 bytes into mono PCM16. The format is read from the bytes' own signature first and from the hint
+ * only when the bytes carry none (a bare MP3 frame stream).
+ *
+ * @param bytes The file's bytes.
+ * @param hint The MIME type and/or file name, when known.
+ * @returns Mono PCM16 at the file's own sample rate.
+ * @throws {Error} when the format is not WAV or MP3, the file is malformed or empty, or it is longer than
+ *   {@link MAX_DECODED_AUDIO_SECONDS}.
+ */
+export declare function DecodeAudio(bytes: Uint8Array, hint?: AudioFormatHint): Promise<DecodedAudio>;
+/** Throws when `sampleCount` samples at `sampleRate` run longer than {@link MAX_DECODED_AUDIO_SECONDS}. */
+export declare function AssertAudioDurationWithinCap(sampleCount: number, sampleRate: number): void;
+/** Converts one [-1, 1] float sample to PCM16, clamping anything outside the range. */
+export declare function FloatToPcm16(sample: number): number;
+//# sourceMappingURL=audio-decoder.d.ts.map

package/dist/room-audio/audio-decoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-decoder.d.ts","sourceRoot":"","sources":["../../src/room-audio/audio-decoder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,0DAA0D;AAC1D,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,GAAG,EAAE,UAAU,CAAC;IAChB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,2GAA2G;AAC3G,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,4HAA4H;AAC5H,eAAO,MAAM,yBAAyB,QAAU,CAAC;AAoBjD;;;;;;;;;GASG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,YAAY,CAAC,CAQlG;AAED,2GAA2G;AAC3G,wBAAgB,4BAA4B,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAQ1F;AAqID,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGnD"}

package/dist/room-audio/audio-decoder.js

@@ -0,0 +1,205 @@
+/**
+ * @fileoverview {@link DecodeAudio} — turns an audio file's bytes (WAV or MP3) into mono PCM16, the one shape the
+ * room audio player plays. WAV is parsed here (RIFF chunk walk, integer PCM 8/16/24/32-bit and IEEE float 32/64-bit,
+ * any channel count downmixed); MP3 is decoded by `mpg123-decoder`, a WebAssembly build of libmpg123 with no native
+ * build step. Anything else is refused with an error that names the format it saw.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { MPEGDecoder } from 'mpg123-decoder';
+/** The longest audio {@link DecodeAudio} accepts, in seconds (15 minutes). Hold music loops; a longer file is a mistake. */
+export const MAX_DECODED_AUDIO_SECONDS = 15 * 60;
+const WAV_FORMAT_PCM = 1;
+const WAV_FORMAT_FLOAT = 3;
+const WAV_FORMAT_EXTENSIBLE = 0xfffe;
+/**
+ * Decodes WAV or MP3 bytes into mono PCM16. The format is read from the bytes' own signature first and from the hint
+ * only when the bytes carry none (a bare MP3 frame stream).
+ *
+ * @param bytes The file's bytes.
+ * @param hint The MIME type and/or file name, when known.
+ * @returns Mono PCM16 at the file's own sample rate.
+ * @throws {Error} when the format is not WAV or MP3, the file is malformed or empty, or it is longer than
+ *   {@link MAX_DECODED_AUDIO_SECONDS}.
+ */
+export async function DecodeAudio(bytes, hint) {
+    if (bytes.byteLength === 0) {
+        throw new Error('Cannot decode audio: the file is empty.');
+    }
+    const format = detectFormat(bytes, hint);
+    const decoded = format === 'wav' ? decodeWav(bytes) : await decodeMp3(bytes);
+    AssertAudioDurationWithinCap(decoded.Pcm.length, decoded.SampleRate);
+    return decoded;
+}
+/** Throws when `sampleCount` samples at `sampleRate` run longer than {@link MAX_DECODED_AUDIO_SECONDS}. */
+export function AssertAudioDurationWithinCap(sampleCount, sampleRate) {
+    const seconds = sampleCount / sampleRate;
+    if (seconds > MAX_DECODED_AUDIO_SECONDS) {
+        throw new Error(`Audio is ${Math.round(seconds)} s long; the room audio player accepts at most ${MAX_DECODED_AUDIO_SECONDS} s ` +
+            '(15 minutes). Trim the file — hold music loops, so a few minutes is plenty.');
+    }
+}
+// ── Format detection ─────────────────────────────────────────────────────────────────────────────────────────────
+function ascii(bytes, start, length) {
+    return String.fromCharCode(...bytes.subarray(start, start + length));
+}
+function isMp3Signature(bytes) {
+    if (bytes.byteLength >= 3 && ascii(bytes, 0, 3) === 'ID3') {
+        return true;
+    }
+    // An MPEG audio frame header starts with 11 set sync bits.
+    return bytes.byteLength >= 2 && bytes[0] === 0xff && (bytes[1] & 0xe0) === 0xe0;
+}
+/** Names a recognisable but unsupported container from its signature, for the error message. */
+function describeUnsupportedSignature(bytes) {
+    if (bytes.byteLength >= 4 && ascii(bytes, 0, 4) === 'OggS')
+        return 'Ogg (Vorbis/Opus)';
+    if (bytes.byteLength >= 4 && ascii(bytes, 0, 4) === 'fLaC')
+        return 'FLAC';
+    if (bytes.byteLength >= 8 && ascii(bytes, 4, 4) === 'ftyp')
+        return 'MP4/M4A (AAC)';
+    if (bytes.byteLength >= 4 && ascii(bytes, 0, 4) === 'FORM')
+        return 'AIFF';
+    if (bytes.byteLength >= 4 && bytes[0] === 0x1a && bytes[1] === 0x45 && bytes[2] === 0xdf && bytes[3] === 0xa3)
+        return 'WebM/Matroska';
+    return undefined;
+}
+function formatFromHint(hint) {
+    const mime = hint?.MimeType?.toLowerCase().split(';')[0].trim() ?? '';
+    const name = hint?.FileName?.toLowerCase() ?? '';
+    if (['audio/wav', 'audio/x-wav', 'audio/wave', 'audio/vnd.wave'].includes(mime) || name.endsWith('.wav'))
+        return 'wav';
+    if (['audio/mpeg', 'audio/mp3', 'audio/mpeg3', 'audio/x-mpeg-3'].includes(mime) || name.endsWith('.mp3'))
+        return 'mp3';
+    return undefined;
+}
+function detectFormat(bytes, hint) {
+    if (bytes.byteLength >= 12 && ascii(bytes, 0, 4) === 'RIFF' && ascii(bytes, 8, 4) === 'WAVE') {
+        return 'wav';
+    }
+    if (isMp3Signature(bytes)) {
+        return 'mp3';
+    }
+    const unsupported = describeUnsupportedSignature(bytes);
+    const hinted = unsupported ? undefined : formatFromHint(hint);
+    if (hinted === 'mp3') {
+        return 'mp3'; // an MP3 stream may begin mid-frame; let the decoder resync
+    }
+    const seen = unsupported ?? (hint?.MimeType || hint?.FileName || 'unrecognised bytes');
+    throw new Error(`Unsupported audio format: ${seen}. The room audio player plays WAV (PCM or float) and MP3.`);
+}
+// ── WAV ──────────────────────────────────────────────────────────────────────────────────────────────────────────
+/** Walks the RIFF chunks and returns the `fmt ` description and the `data` byte range. */
+function readWavChunks(bytes) {
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    let format;
+    let offset = 12;
+    while (offset + 8 <= bytes.byteLength) {
+        const id = ascii(bytes, offset, 4);
+        const size = view.getUint32(offset + 4, true);
+        const body = offset + 8;
+        if (id === 'fmt ') {
+            format = readWavFormat(view, body, size);
+        }
+        else if (id === 'data') {
+            if (!format) {
+                throw new Error('Malformed WAV: the data chunk comes before the fmt chunk.');
+            }
+            // A streaming writer may leave the size as 0 or 0xFFFFFFFF; clamp to what is actually there.
+            return { Format: format, DataOffset: body, DataLength: Math.min(size, bytes.byteLength - body) };
+        }
+        offset = body + size + (size & 1); // chunks are word-aligned: an odd-sized chunk carries one pad byte
+    }
+    throw new Error(format ? 'Malformed WAV: no data chunk.' : 'Malformed WAV: no fmt chunk.');
+}
+function readWavFormat(view, body, size) {
+    if (size < 16 || body + 16 > view.byteLength) {
+        throw new Error('Malformed WAV: the fmt chunk is truncated.');
+    }
+    let formatCode = view.getUint16(body, true);
+    if (formatCode === WAV_FORMAT_EXTENSIBLE && size >= 40 && body + 26 <= view.byteLength) {
+        formatCode = view.getUint16(body + 24, true); // the first two bytes of the SubFormat GUID are the real code
+    }
+    return {
+        FormatCode: formatCode,
+        Channels: view.getUint16(body + 2, true),
+        SampleRate: view.getUint32(body + 4, true),
+        BitsPerSample: view.getUint16(body + 14, true),
+    };
+}
+function sampleReaderFor(format) {
+    const { FormatCode: code, BitsPerSample: bits } = format;
+    if (code === WAV_FORMAT_PCM && bits === 8)
+        return (v, o) => (v.getUint8(o) - 128) / 128;
+    if (code === WAV_FORMAT_PCM && bits === 16)
+        return (v, o) => v.getInt16(o, true) / 32768;
+    if (code === WAV_FORMAT_PCM && bits === 24) {
+        return (v, o) => ((v.getUint8(o) | (v.getUint8(o + 1) << 8) | (v.getInt8(o + 2) << 16)) / 8388608);
+    }
+    if (code === WAV_FORMAT_PCM && bits === 32)
+        return (v, o) => v.getInt32(o, true) / 2147483648;
+    if (code === WAV_FORMAT_FLOAT && bits === 32)
+        return (v, o) => v.getFloat32(o, true);
+    if (code === WAV_FORMAT_FLOAT && bits === 64)
+        return (v, o) => v.getFloat64(o, true);
+    throw new Error(`Unsupported WAV encoding: format code ${code}, ${bits}-bit. The room audio player plays integer PCM ` +
+        '(8/16/24/32-bit) and IEEE float (32/64-bit) WAV.');
+}
+function decodeWav(bytes) {
+    const { Format: format, DataOffset: dataOffset, DataLength: dataLength } = readWavChunks(bytes);
+    if (format.Channels < 1 || format.SampleRate < 1) {
+        throw new Error(`Malformed WAV: ${format.Channels} channel(s) at ${format.SampleRate} Hz.`);
+    }
+    const read = sampleReaderFor(format);
+    const bytesPerSample = format.BitsPerSample / 8;
+    const frameBytes = bytesPerSample * format.Channels;
+    const frames = Math.floor(dataLength / frameBytes);
+    if (frames === 0) {
+        throw new Error('Cannot decode audio: the WAV data chunk holds no samples.');
+    }
+    AssertAudioDurationWithinCap(frames, format.SampleRate); // before allocating the output for an over-long file
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const pcm = new Int16Array(frames);
+    for (let frame = 0; frame < frames; frame++) {
+        const base = dataOffset + frame * frameBytes;
+        let sum = 0;
+        for (let channel = 0; channel < format.Channels; channel++) {
+            sum += read(view, base + channel * bytesPerSample);
+        }
+        pcm[frame] = FloatToPcm16(sum / format.Channels);
+    }
+    return { Pcm: pcm, SampleRate: format.SampleRate };
+}
+/** Converts one [-1, 1] float sample to PCM16, clamping anything outside the range. */
+export function FloatToPcm16(sample) {
+    const clamped = sample > 1 ? 1 : sample < -1 ? -1 : sample;
+    return clamped < 0 ? Math.round(clamped * 32768) : Math.round(clamped * 32767);
+}
+// ── MP3 ──────────────────────────────────────────────────────────────────────────────────────────────────────────
+async function decodeMp3(bytes) {
+    const decoder = new MPEGDecoder();
+    try {
+        await decoder.ready;
+        const result = decoder.decode(bytes);
+        if (result.samplesDecoded === 0 || result.channelData.length === 0) {
+            const reason = result.errors.length > 0 ? result.errors[0].message : 'no audio frames found';
+            throw new Error(`Cannot decode MP3: ${reason}.`);
+        }
+        return { Pcm: downmixFloatChannels(result.channelData, result.samplesDecoded), SampleRate: result.sampleRate };
+    }
+    finally {
+        decoder.free();
+    }
+}
+function downmixFloatChannels(channels, sampleCount) {
+    const pcm = new Int16Array(sampleCount);
+    for (let i = 0; i < sampleCount; i++) {
+        let sum = 0;
+        for (const channel of channels) {
+            sum += channel[i];
+        }
+        pcm[i] = FloatToPcm16(sum / channels.length);
+    }
+    return pcm;
+}
+//# sourceMappingURL=audio-decoder.js.map

package/dist/room-audio/audio-decoder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-decoder.js","sourceRoot":"","sources":["../../src/room-audio/audio-decoder.ts"],"names":[],"mappings":"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"}

package/dist/room-audio/comfort-tone.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview {@link GenerateComfortTone} — a procedurally generated hold loop for when a queue has no music
+ * configured. Four soft major/minor pads (C – Am – F – G, the progression everyone has heard a thousand times and
+ * nobody minds) with slow raised-cosine swells, a quiet bass an octave below, and a touch of second harmonic for
+ * warmth. Each chord fades fully out before the next fades in, so the loop seam is silent and never clicks.
+ *
+ * Synthesized at runtime: no audio asset ships, so there is nothing to license.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+/** Length of one pass of the comfort tone, in seconds. */
+export declare const COMFORT_TONE_LOOP_SECONDS = 10;
+/** Peak level of the comfort tone as a fraction of full scale (about −15 dBFS — quieter than speech). */
+export declare const COMFORT_TONE_PEAK = 0.18;
+/**
+ * Generates one {@link COMFORT_TONE_LOOP_SECONDS}-second pass of the comfort tone as mono PCM16. Loop it end to end.
+ *
+ * @param sampleRate The rate to synthesize at, in Hz (generate at the playback rate to avoid resampling).
+ * @returns Mono PCM16 samples; every sample's magnitude is at most {@link COMFORT_TONE_PEAK} of full scale.
+ * @throws {Error} when `sampleRate` is not a positive integer.
+ */
+export declare function GenerateComfortTone(sampleRate: number): Int16Array;
+//# sourceMappingURL=comfort-tone.d.ts.map

package/dist/room-audio/comfort-tone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfort-tone.d.ts","sourceRoot":"","sources":["../../src/room-audio/comfort-tone.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0DAA0D;AAC1D,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,yGAAyG;AACzG,eAAO,MAAM,iBAAiB,OAAO,CAAC;AAiBtC;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAQlE"}

package/dist/room-audio/comfort-tone.js

@@ -0,0 +1,70 @@
+/**
+ * @fileoverview {@link GenerateComfortTone} — a procedurally generated hold loop for when a queue has no music
+ * configured. Four soft major/minor pads (C – Am – F – G, the progression everyone has heard a thousand times and
+ * nobody minds) with slow raised-cosine swells, a quiet bass an octave below, and a touch of second harmonic for
+ * warmth. Each chord fades fully out before the next fades in, so the loop seam is silent and never clicks.
+ *
+ * Synthesized at runtime: no audio asset ships, so there is nothing to license.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+/** Length of one pass of the comfort tone, in seconds. */
+export const COMFORT_TONE_LOOP_SECONDS = 10;
+/** Peak level of the comfort tone as a fraction of full scale (about −15 dBFS — quieter than speech). */
+export const COMFORT_TONE_PEAK = 0.18;
+/** One chord of the progression: the frequencies of its voices, root first. */
+const CHORDS = [
+    [261.63, 329.63, 392.0], // C major (C4 E4 G4)
+    [220.0, 261.63, 329.63], // A minor (A3 C4 E4)
+    [174.61, 220.0, 261.63], // F major (F3 A3 C4)
+    [196.0, 246.94, 293.66], // G major (G3 B3 D4)
+];
+/** Fraction of each chord spent swelling in (and, symmetrically, fading out). */
+const SWELL_FRACTION = 0.3;
+/** Relative weight of the bass voice (the chord root an octave down) and of each voice's second harmonic. */
+const BASS_WEIGHT = 0.5;
+const HARMONIC_WEIGHT = 0.15;
+/**
+ * Generates one {@link COMFORT_TONE_LOOP_SECONDS}-second pass of the comfort tone as mono PCM16. Loop it end to end.
+ *
+ * @param sampleRate The rate to synthesize at, in Hz (generate at the playback rate to avoid resampling).
+ * @returns Mono PCM16 samples; every sample's magnitude is at most {@link COMFORT_TONE_PEAK} of full scale.
+ * @throws {Error} when `sampleRate` is not a positive integer.
+ */
+export function GenerateComfortTone(sampleRate) {
+    if (!Number.isInteger(sampleRate) || sampleRate <= 0) {
+        throw new Error(`GenerateComfortTone needs a positive integer sample rate; got ${sampleRate}.`);
+    }
+    const chordSamples = Math.round((COMFORT_TONE_LOOP_SECONDS / CHORDS.length) * sampleRate);
+    const out = new Int16Array(chordSamples * CHORDS.length);
+    CHORDS.forEach((chord, index) => renderChord(out, index * chordSamples, chordSamples, chord, sampleRate));
+    return out;
+}
+/** Writes one enveloped chord into `out` starting at `start`. */
+function renderChord(out, start, length, chord, sampleRate) {
+    const voices = [...chord, chord[0] / 2];
+    const weights = [...chord.map(() => 1), BASS_WEIGHT];
+    // Normalise so the worst case (every voice and harmonic in phase at the envelope peak) stays at COMFORT_TONE_PEAK.
+    const worstCase = weights.reduce((total, weight) => total + weight * (1 + HARMONIC_WEIGHT), 0);
+    const scale = (COMFORT_TONE_PEAK * 32767) / worstCase;
+    for (let i = 0; i < length; i++) {
+        const t = i / sampleRate;
+        let sample = 0;
+        for (let v = 0; v < voices.length; v++) {
+            const phase = 2 * Math.PI * voices[v] * t;
+            sample += weights[v] * (Math.sin(phase) + HARMONIC_WEIGHT * Math.sin(2 * phase));
+        }
+        out[start + i] = Math.round(sample * swellEnvelope(i / length) * scale);
+    }
+}
+/** A raised-cosine swell: 0 at both ends of the chord, 1 across the middle. */
+function swellEnvelope(position) {
+    if (position < SWELL_FRACTION) {
+        return 0.5 - 0.5 * Math.cos((Math.PI * position) / SWELL_FRACTION);
+    }
+    if (position > 1 - SWELL_FRACTION) {
+        return 0.5 - 0.5 * Math.cos((Math.PI * (1 - position)) / SWELL_FRACTION);
+    }
+    return 1;
+}
+//# sourceMappingURL=comfort-tone.js.map

package/dist/room-audio/comfort-tone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"comfort-tone.js","sourceRoot":"","sources":["../../src/room-audio/comfort-tone.ts"],"names":[],"mappings":"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"}