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

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

@@ -0,0 +1 @@
+{"version":3,"file":"room-audio-sources.d.ts","sourceRoot":"","sources":["../../src/room-audio/room-audio-sources.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAsB,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAKjG,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,wBAAwB;IACxB,KAAK,EAAE,UAAU,CAAC;IAClB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qGAAqG;AACrG,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEzI,mGAAmG;AACnG,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAEjF,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,QAAmB,CAAC;AAEzD,sEAAsE;AACtE,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAoBxI;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAWpD;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAclF"}

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

@@ -0,0 +1,116 @@
+/**
+ * @fileoverview Where the room audio player gets an audio file's bytes: an `MJ: Files` row (read from its storage
+ * provider through `@memberjunction/storage`), or an https URL (fetched through the SSRF-safe `SafeFetch`, with a
+ * timeout and a byte cap). Both return {@link RoomAudioFileContent}, which `DecodeAudio` turns into PCM.
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { LogError, Metadata } from '@memberjunction/core';
+import { FileStorageEngine } from '@memberjunction/storage';
+import { SafeFetch } from '@memberjunction/network-utils';
+/** The largest file the player will download from a URL, in bytes (25 MB). */
+export const MAX_ROOM_AUDIO_URL_BYTES = 25 * 1024 * 1024;
+/** How long a URL download may take before it is abandoned, in ms. */
+export const ROOM_AUDIO_URL_TIMEOUT_MS = 20_000;
+/**
+ * Reads an `MJ: Files` row's bytes from its storage provider, as the given user (so the user's read permission on
+ * the file applies).
+ *
+ * @throws {Error} when the row cannot be loaded, no storage account serves its provider, or the download fails.
+ */
+export async function ReadMJFileAudio(fileID, contextUser, provider) {
+    const md = provider ?? Metadata.Provider;
+    const file = await md.GetEntityObject('MJ: Files', contextUser);
+    const loaded = await file.Load(fileID);
+    if (!loaded) {
+        const detail = file.LatestResult?.CompleteMessage || 'not found, or not readable by this user';
+        throw new Error(`Hold audio file ${fileID} could not be loaded from MJ: Files: ${detail}.`);
+    }
+    await FileStorageEngine.Instance.Config(false, contextUser, provider);
+    const accounts = FileStorageEngine.Instance.GetAccountsByProviderID(file.ProviderID);
+    if (accounts.length === 0) {
+        throw new Error(`Hold audio file ${fileID} ('${file.Name}') is on storage provider ${file.Provider}, which has no configured storage account.`);
+    }
+    const driver = await FileStorageEngine.Instance.GetDriver(accounts[0].ID, contextUser);
+    const buffer = await driver.GetObject({ fullPath: file.ProviderKey ?? file.Name });
+    return {
+        Bytes: new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength),
+        MimeType: file.ContentType ?? undefined,
+        FileName: file.Name,
+    };
+}
+/**
+ * Checks that `url` is an absolute https URL. The player refuses plain http: hold audio is fetched by the server, and
+ * a cleartext fetch would let anyone on the path substitute what callers hear.
+ *
+ * @throws {Error} when the URL is malformed or not https.
+ */
+export function AssertHttpsAudioUrl(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`Hold audio URL is not a valid URL: '${url}'.`);
+    }
+    if (parsed.protocol !== 'https:') {
+        throw new Error(`Hold audio URL must use https; got '${parsed.protocol}' in '${url}'.`);
+    }
+    return parsed;
+}
+/**
+ * Downloads an https audio URL through `SafeFetch` (every redirect hop re-checked against private/reserved
+ * addresses), abandoning it after {@link ROOM_AUDIO_URL_TIMEOUT_MS} or once it passes {@link MAX_ROOM_AUDIO_URL_BYTES}.
+ *
+ * @throws {Error} on a non-https URL, an HTTP error status, a timeout, or a body over the byte cap.
+ */
+export async function FetchRoomAudioUrl(url) {
+    const parsed = AssertHttpsAudioUrl(url);
+    const response = await SafeFetch(parsed.href, { signal: AbortSignal.timeout(ROOM_AUDIO_URL_TIMEOUT_MS) });
+    if (!response.ok) {
+        void response.body?.cancel();
+        throw new Error(`Hold audio URL returned HTTP ${response.status}: '${url}'.`);
+    }
+    const declared = Number(response.headers.get('content-length') ?? '');
+    if (Number.isFinite(declared) && declared > MAX_ROOM_AUDIO_URL_BYTES) {
+        void response.body?.cancel();
+        throw new Error(`Hold audio URL is ${declared} bytes; the limit is ${MAX_ROOM_AUDIO_URL_BYTES} bytes: '${url}'.`);
+    }
+    const bytes = await readBodyWithCap(response, url);
+    return { Bytes: bytes, MimeType: response.headers.get('content-type') ?? undefined, FileName: parsed.pathname.split('/').pop() };
+}
+/** Reads a response body, stopping (and cancelling the stream) the moment it passes the byte cap. */
+async function readBodyWithCap(response, url) {
+    if (!response.body) {
+        return new Uint8Array(0);
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let total = 0;
+    try {
+        for (let chunk = await reader.read(); !chunk.done; chunk = await reader.read()) {
+            total += chunk.value.byteLength;
+            if (total > MAX_ROOM_AUDIO_URL_BYTES) {
+                throw new Error(`Hold audio URL exceeded the ${MAX_ROOM_AUDIO_URL_BYTES}-byte limit: '${url}'.`);
+            }
+            chunks.push(chunk.value);
+        }
+    }
+    finally {
+        if (total > MAX_ROOM_AUDIO_URL_BYTES) {
+            await reader.cancel().catch((err) => LogError(`[RoomAudioPlayer] cancelling the oversize download of '${url}' failed: ${err.message}`));
+        }
+        reader.releaseLock();
+    }
+    return concatChunks(chunks, total);
+}
+function concatChunks(chunks, total) {
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const chunk of chunks) {
+        out.set(chunk, offset);
+        offset += chunk.byteLength;
+    }
+    return out;
+}
+//# sourceMappingURL=room-audio-sources.js.map

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

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

package/dist/room-audio/room-speech-synthesizer.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview The text-to-speech port the room audio player announces through ({@link IRoomSpeechSynthesizer}),
+ * and {@link MJRoomSpeechSynthesizer}, an implementation over MJ's own `AITextToSpeechRunner` (model selection,
+ * credentials, failover and an `MJ: AI Prompt Runs` row, all handled there).
+ *
+ * The player ships with NO synthesizer installed, because a voice is vendor-specific and only the host knows which
+ * one its callers should hear. A host opts in once at startup:
+ *
+ * ```ts
+ * RoomAudioPlayer.Instance.SetSpeechSynthesizer(new MJRoomSpeechSynthesizer({ Voice: 'alloy' }));
+ * ```
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { type UserInfo } from '@memberjunction/core';
+import { AITextToSpeechRunner } from '@memberjunction/ai-prompts';
+import { type DecodedAudio } from './audio-decoder.js';
+/** Turns announcement text into audio. Return `null` when speech could not be produced (and log why). */
+export interface IRoomSpeechSynthesizer {
+    /**
+     * Speaks `text`.
+     *
+     * @param text What to say.
+     * @param contextUser The user the synthesis runs (and is logged) as.
+     * @returns The audio, or `null` when it could not be produced.
+     */
+    Synthesize(text: string, contextUser: UserInfo): Promise<DecodedAudio | null>;
+}
+/** Options for {@link MJRoomSpeechSynthesizer}. */
+export interface MJRoomSpeechSynthesizerOptions {
+    /** The provider-native voice id or name (required: voices belong to a vendor). */
+    Voice: string;
+    /** Pins the TTS model by ID. Recommended whenever the voice matters, since voices are vendor-specific. */
+    ModelID?: string;
+    /** The carrier `MJ: AI Prompts` row whose bindings choose the model. Default: the runner's `Default Text To Speech`. */
+    PromptID?: string;
+    /** The vendor's output format string (e.g. `mp3_44100_128`). Default: the vendor's default (MP3 or WAV decode either way). */
+    OutputFormat?: string;
+}
+/** The part of `AITextToSpeechRunner` the synthesizer uses — a seam so tests inject a fake. */
+export type TextToSpeechRunnerLike = Pick<AITextToSpeechRunner, 'RunTextToSpeech'>;
+/** An {@link IRoomSpeechSynthesizer} backed by MJ's `AITextToSpeechRunner`. Never throws: failures log and return `null`. */
+export declare class MJRoomSpeechSynthesizer implements IRoomSpeechSynthesizer {
+    private readonly options;
+    private readonly runner;
+    /**
+     * @param options The voice and model selection.
+     * @param runner The runner (tests); defaults to a new `AITextToSpeechRunner`.
+     * @throws {Error} when no voice is given.
+     */
+    constructor(options: MJRoomSpeechSynthesizerOptions, runner?: TextToSpeechRunnerLike);
+    /** Speaks `text` through the configured TTS model and decodes the result to PCM. */
+    Synthesize(text: string, contextUser: UserInfo): Promise<DecodedAudio | null>;
+}
+//# sourceMappingURL=room-speech-synthesizer.d.ts.map

package/dist/room-audio/room-speech-synthesizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-speech-synthesizer.d.ts","sourceRoot":"","sources":["../../src/room-audio/room-speech-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEjE,yGAAyG;AACzG,MAAM,WAAW,sBAAsB;IACrC;;;;;;OAMG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CAC/E;AAED,mDAAmD;AACnD,MAAM,WAAW,8BAA8B;IAC7C,kFAAkF;IAClF,KAAK,EAAE,MAAM,CAAC;IACd,0GAA0G;IAC1G,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wHAAwH;IACxH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8HAA8H;IAC9H,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,+FAA+F;AAC/F,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,CAAC;AAEnF,6HAA6H;AAC7H,qBAAa,uBAAwB,YAAW,sBAAsB;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiC;IACzD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAEhD;;;;OAIG;gBACS,OAAO,EAAE,8BAA8B,EAAE,MAAM,CAAC,EAAE,sBAAsB;IAQpF,oFAAoF;IACvE,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAqB3F"}

package/dist/room-audio/room-speech-synthesizer.js

@@ -0,0 +1,56 @@
+/**
+ * @fileoverview The text-to-speech port the room audio player announces through ({@link IRoomSpeechSynthesizer}),
+ * and {@link MJRoomSpeechSynthesizer}, an implementation over MJ's own `AITextToSpeechRunner` (model selection,
+ * credentials, failover and an `MJ: AI Prompt Runs` row, all handled there).
+ *
+ * The player ships with NO synthesizer installed, because a voice is vendor-specific and only the host knows which
+ * one its callers should hear. A host opts in once at startup:
+ *
+ * ```ts
+ * RoomAudioPlayer.Instance.SetSpeechSynthesizer(new MJRoomSpeechSynthesizer({ Voice: 'alloy' }));
+ * ```
+ *
+ * @module @memberjunction/livekit-room-server
+ */
+import { LogError } from '@memberjunction/core';
+import { AITextToSpeechRunner } from '@memberjunction/ai-prompts';
+import { DecodeAudio } from './audio-decoder.js';
+/** An {@link IRoomSpeechSynthesizer} backed by MJ's `AITextToSpeechRunner`. Never throws: failures log and return `null`. */
+export class MJRoomSpeechSynthesizer {
+    /**
+     * @param options The voice and model selection.
+     * @param runner The runner (tests); defaults to a new `AITextToSpeechRunner`.
+     * @throws {Error} when no voice is given.
+     */
+    constructor(options, runner) {
+        if (!options.Voice?.trim()) {
+            throw new Error('MJRoomSpeechSynthesizer needs a Voice (a provider-native voice id or name).');
+        }
+        this.options = options;
+        this.runner = runner ?? new AITextToSpeechRunner();
+    }
+    /** Speaks `text` through the configured TTS model and decodes the result to PCM. */
+    async Synthesize(text, contextUser) {
+        try {
+            const result = await this.runner.RunTextToSpeech({
+                text,
+                voice: this.options.Voice,
+                output_format: this.options.OutputFormat,
+                ModelID: this.options.ModelID,
+                PromptID: this.options.PromptID,
+                ContextUser: contextUser,
+            });
+            const audio = result.SpeechResult?.data;
+            if (!result.Success || !audio || audio.byteLength === 0) {
+                LogError(`[MJRoomSpeechSynthesizer] text-to-speech failed for voice '${this.options.Voice}': ${result.ErrorMessage ?? 'no audio returned'}`);
+                return null;
+            }
+            return await DecodeAudio(new Uint8Array(audio.buffer, audio.byteOffset, audio.byteLength));
+        }
+        catch (err) {
+            LogError(`[MJRoomSpeechSynthesizer] could not synthesize an announcement: ${err instanceof Error ? err.message : String(err)}`);
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=room-speech-synthesizer.js.map

package/dist/room-audio/room-speech-synthesizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-speech-synthesizer.js","sourceRoot":"","sources":["../../src/room-audio/room-speech-synthesizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,QAAQ,EAAiB,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,WAAW,EAAqB,MAAM,iBAAiB,CAAC;AA6BjE,6HAA6H;AAC7H,MAAM,OAAO,uBAAuB;IAIlC;;;;OAIG;IACH,YAAY,OAAuC,EAAE,MAA+B;QAClF,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC;YAC3B,MAAM,IAAI,KAAK,CAAC,6EAA6E,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,oBAAoB,EAAE,CAAC;IACrD,CAAC;IAED,oFAAoF;IAC7E,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,WAAqB;QACzD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;gBAC/C,IAAI;gBACJ,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;gBACzB,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY;gBACxC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;gBAC7B,QAAQ,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ;gBAC/B,WAAW,EAAE,WAAW;aACzB,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,CAAC,YAAY,EAAE,IAAI,CAAC;YACxC,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;gBACxD,QAAQ,CAAC,8DAA8D,IAAI,CAAC,OAAO,CAAC,KAAK,MAAM,MAAM,CAAC,YAAY,IAAI,mBAAmB,EAAE,CAAC,CAAC;gBAC7I,OAAO,IAAI,CAAC;YACd,CAAC;YACD,OAAO,MAAM,WAAW,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;QAC7F,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,mEAAmE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChI,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;CACF"}

package/dist/room-authorization.d.ts

@@ -0,0 +1,58 @@
+import { BaseSingleton } from '@memberjunction/global';
+import { type IMetadataProvider, type UserInfo } from '@memberjunction/core';
+export declare const DEFAULT_SIP_CALL_ROOM_PREFIX = "call-";
+export declare const SIP_CALL_ROOM_PREFIX = "call-";
+export interface RoomAuthorizationResult {
+    Authorized: boolean;
+    Reason?: string;
+}
+export type RoomAuthorizerFn = (roomName: string, user: UserInfo, provider?: IMetadataProvider) => Promise<RoomAuthorizationResult>;
+/**
+ * Service enforcing per-room authorization for LiveKit rooms.
+ *
+ * Rules:
+ * 1. Rooms tied to an `MJ: Meetings` record:
+ *    - Cancelled meetings refuse access.
+ *    - Host user (`meeting.HostUserID`) is granted access.
+ *    - Meeting participants (`MJ: Meeting Participants` where `UserID = user.ID`):
+ *      - If `InviteStatus === 'Declined'`, access is refused.
+ *      - If `InviteStatus` is `'Invited'`, `'Accepted'`, or `'Tentative'`, access is granted.
+ *    - Non-participants are refused access.
+ *
+ * 2. Rooms tied to an `MJ: Interactions` record OR starting with the SIP call prefix (`call-`):
+ *    - Never ad-hoc.
+ *    - User who has an `Accepted` offer for this room is granted access.
+ *    - User who started it (the Interaction's agent-session owner) is granted access.
+ *    - Otherwise access is refused.
+ *
+ * 3. Rooms tied to an `MJ: Interaction Offers` record:
+ *    - User must be the `TargetUserID` AND have `Status === 'Accepted'`.
+ *    - Otherwise access is refused.
+ *
+ * 4. Ad-hoc rooms:
+ *    - Only rooms with NO Meeting, NO Interaction, and NO Offer row (and not starting with `call-`)
+ *      are ad-hoc and open to authenticated users.
+ */
+export declare class RoomAuthorizationService extends BaseSingleton<RoomAuthorizationService> {
+    private authorizerOverride?;
+    private sipRoomPrefix;
+    constructor();
+    static get Instance(): RoomAuthorizationService;
+    /**
+     * Sets an authorizer override for testing or specialized harnesses.
+     */
+    SetAuthorizerForTesting(fn?: RoomAuthorizerFn): void;
+    /**
+     * Sets or resets the SIP call room prefix (e.g. to match LiveKitSipTelephonyService.roomPrefix).
+     */
+    SetSipRoomPrefix(prefix?: string): void;
+    /**
+     * Gets the active SIP call room prefix.
+     */
+    get SipRoomPrefix(): string;
+    /**
+     * Authorizes whether the given user may access the specified LiveKit room.
+     */
+    AuthorizeRoomAccess(roomName: string, user: UserInfo, provider?: IMetadataProvider): Promise<RoomAuthorizationResult>;
+}
+//# sourceMappingURL=room-authorization.d.ts.map

package/dist/room-authorization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-authorization.d.ts","sourceRoot":"","sources":["../src/room-authorization.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAA+B,MAAM,wBAAwB,CAAC;AACpF,OAAO,EAAqB,KAAK,iBAAiB,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGhG,eAAO,MAAM,4BAA4B,UAAU,CAAC;AACpD,eAAO,MAAM,oBAAoB,UAA+B,CAAC;AAEjE,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,iBAAiB,KACzB,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAoCtC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,wBAAyB,SAAQ,aAAa,CAAC,wBAAwB,CAAC;IACnF,OAAO,CAAC,kBAAkB,CAAC,CAAmB;IAC9C,OAAO,CAAC,aAAa,CAAwH;;IAM7I,WAAkB,QAAQ,IAAI,wBAAwB,CAErD;IAED;;OAEG;IACI,uBAAuB,CAAC,EAAE,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAI3D;;OAEG;IACI,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI9C;;OAEG;IACH,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED;;OAEG;IACU,mBAAmB,CAC9B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,EACd,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,OAAO,CAAC,uBAAuB,CAAC;CAyLpC"}

package/dist/room-authorization.js

@@ -0,0 +1,212 @@
+import { BaseSingleton, EscapeSQLString, UUIDsEqual } from '@memberjunction/global';
+import { LogError, RunView } from '@memberjunction/core';
+import { LiveKitAgentRoomCoordinator } from './livekit-agent-room-coordinator.js';
+export const DEFAULT_SIP_CALL_ROOM_PREFIX = 'call-';
+export const SIP_CALL_ROOM_PREFIX = DEFAULT_SIP_CALL_ROOM_PREFIX;
+/**
+ * Service enforcing per-room authorization for LiveKit rooms.
+ *
+ * Rules:
+ * 1. Rooms tied to an `MJ: Meetings` record:
+ *    - Cancelled meetings refuse access.
+ *    - Host user (`meeting.HostUserID`) is granted access.
+ *    - Meeting participants (`MJ: Meeting Participants` where `UserID = user.ID`):
+ *      - If `InviteStatus === 'Declined'`, access is refused.
+ *      - If `InviteStatus` is `'Invited'`, `'Accepted'`, or `'Tentative'`, access is granted.
+ *    - Non-participants are refused access.
+ *
+ * 2. Rooms tied to an `MJ: Interactions` record OR starting with the SIP call prefix (`call-`):
+ *    - Never ad-hoc.
+ *    - User who has an `Accepted` offer for this room is granted access.
+ *    - User who started it (the Interaction's agent-session owner) is granted access.
+ *    - Otherwise access is refused.
+ *
+ * 3. Rooms tied to an `MJ: Interaction Offers` record:
+ *    - User must be the `TargetUserID` AND have `Status === 'Accepted'`.
+ *    - Otherwise access is refused.
+ *
+ * 4. Ad-hoc rooms:
+ *    - Only rooms with NO Meeting, NO Interaction, and NO Offer row (and not starting with `call-`)
+ *      are ad-hoc and open to authenticated users.
+ */
+export class RoomAuthorizationService extends BaseSingleton {
+    constructor() {
+        super();
+        this.sipRoomPrefix = (process.env.LIVEKIT_SIP_ROOM_PREFIX ?? DEFAULT_SIP_CALL_ROOM_PREFIX).trim() || DEFAULT_SIP_CALL_ROOM_PREFIX;
+    }
+    static get Instance() {
+        return RoomAuthorizationService.getInstance();
+    }
+    /**
+     * Sets an authorizer override for testing or specialized harnesses.
+     */
+    SetAuthorizerForTesting(fn) {
+        this.authorizerOverride = fn;
+    }
+    /**
+     * Sets or resets the SIP call room prefix (e.g. to match LiveKitSipTelephonyService.roomPrefix).
+     */
+    SetSipRoomPrefix(prefix) {
+        this.sipRoomPrefix = (prefix ?? process.env.LIVEKIT_SIP_ROOM_PREFIX ?? DEFAULT_SIP_CALL_ROOM_PREFIX).trim() || DEFAULT_SIP_CALL_ROOM_PREFIX;
+    }
+    /**
+     * Gets the active SIP call room prefix.
+     */
+    get SipRoomPrefix() {
+        return this.sipRoomPrefix;
+    }
+    /**
+     * Authorizes whether the given user may access the specified LiveKit room.
+     */
+    async AuthorizeRoomAccess(roomName, user, provider) {
+        if (!user || !user.ID) {
+            return { Authorized: false, Reason: 'User is not authenticated.' };
+        }
+        if (this.authorizerOverride) {
+            return await this.authorizerOverride(roomName, user, provider);
+        }
+        const trimmedRoom = roomName.trim();
+        if (!trimmedRoom) {
+            return { Authorized: false, Reason: 'Room name cannot be empty.' };
+        }
+        const escapedRoom = EscapeSQLString(trimmedRoom);
+        const escapedUserID = EscapeSQLString(user.ID);
+        const rv = provider ? RunView.FromMetadataProvider(provider) : new RunView();
+        try {
+            // Batch initial lookups for Meetings, Interactions, Interaction Offers, and Agent Session Bridges
+            const [meetingResult, interactionResult, offerResult, bridgeResult] = await rv.RunViews([
+                {
+                    EntityName: 'MJ: Meetings',
+                    ExtraFilter: `RoomName = '${escapedRoom}'`,
+                    Fields: ['ID', 'Status', 'HostUserID'],
+                    ResultType: 'simple',
+                },
+                {
+                    EntityName: 'MJ: Interactions',
+                    ExtraFilter: `RoomName = '${escapedRoom}'`,
+                    Fields: ['ID', 'Status', 'AgentSessionID'],
+                    ResultType: 'simple',
+                },
+                {
+                    EntityName: 'MJ: Interaction Offers',
+                    ExtraFilter: `RoomName = '${escapedRoom}'`,
+                    Fields: ['ID', 'Status', 'TargetUserID'],
+                    ResultType: 'simple',
+                },
+                {
+                    EntityName: 'MJ: AI Agent Session Bridges',
+                    ExtraFilter: `ExternalConnectionID = '${escapedRoom}' AND Status = 'Active'`,
+                    Fields: ['ID', 'AgentSessionID'],
+                    ResultType: 'simple',
+                },
+            ], user);
+            if (!meetingResult.Success) {
+                LogError(`[RoomAuthorizationService] Error querying MJ: Meetings for room '${trimmedRoom}': ${meetingResult.ErrorMessage}`);
+                return { Authorized: false, Reason: 'Error verifying meeting authorization.' };
+            }
+            if (!interactionResult.Success) {
+                LogError(`[RoomAuthorizationService] Error querying MJ: Interactions for room '${trimmedRoom}': ${interactionResult.ErrorMessage}`);
+                return { Authorized: false, Reason: 'Error verifying interaction authorization.' };
+            }
+            if (!offerResult.Success) {
+                LogError(`[RoomAuthorizationService] Error querying MJ: Interaction Offers for room '${trimmedRoom}': ${offerResult.ErrorMessage}`);
+                return { Authorized: false, Reason: 'Error verifying interaction offer authorization.' };
+            }
+            if (!bridgeResult.Success) {
+                LogError(`[RoomAuthorizationService] Error querying MJ: AI Agent Session Bridges for room '${trimmedRoom}': ${bridgeResult.ErrorMessage}`);
+                return { Authorized: false, Reason: 'Error verifying agent bridge authorization.' };
+            }
+            const meetings = (meetingResult.Results ?? []);
+            const interactions = (interactionResult.Results ?? []);
+            const offers = (offerResult.Results ?? []);
+            const bridges = (bridgeResult.Results ?? []);
+            const activeRoster = LiveKitAgentRoomCoordinator.Instance.GetAgentsInRoom(trimmedRoom);
+            const agentSessionIDs = new Set();
+            for (const i of interactions) {
+                if (i.AgentSessionID)
+                    agentSessionIDs.add(i.AgentSessionID);
+            }
+            for (const b of bridges) {
+                if (b.AgentSessionID)
+                    agentSessionIDs.add(b.AgentSessionID);
+            }
+            for (const r of activeRoster) {
+                if (r.AgentSessionID)
+                    agentSessionIDs.add(r.AgentSessionID);
+            }
+            // 1. Check if room is tied to an MJ: Meetings record
+            if (meetings.length > 0) {
+                const meeting = meetings[0];
+                if (meeting.Status === 'Cancelled') {
+                    return { Authorized: false, Reason: 'Meeting is cancelled.' };
+                }
+                if (UUIDsEqual(meeting.HostUserID, user.ID)) {
+                    return { Authorized: true };
+                }
+                const participantResult = await rv.RunView({
+                    EntityName: 'MJ: Meeting Participants',
+                    ExtraFilter: `MeetingID = '${EscapeSQLString(meeting.ID)}' AND UserID = '${escapedUserID}'`,
+                    Fields: ['ID', 'InviteStatus', 'UserID'],
+                    ResultType: 'simple',
+                }, user);
+                if (!participantResult.Success) {
+                    LogError(`[RoomAuthorizationService] Error querying MJ: Meeting Participants for meeting '${meeting.ID}': ${participantResult.ErrorMessage}`);
+                    return { Authorized: false, Reason: 'Error verifying participant authorization.' };
+                }
+                const participants = (participantResult.Results ?? []);
+                if (participants.length > 0) {
+                    const participant = participants[0];
+                    if (participant.InviteStatus === 'Declined') {
+                        return { Authorized: false, Reason: 'User declined the invitation to this meeting.' };
+                    }
+                    return { Authorized: true };
+                }
+                return { Authorized: false, Reason: 'User is not a host or participant in this meeting.' };
+            }
+            // 2. Check if room is tied to an Interaction, has active agent sessions (e.g. web agent rooms), or has a SIP call prefix (never ad-hoc)
+            const isSipCallRoom = trimmedRoom.startsWith(this.sipRoomPrefix);
+            if (interactions.length > 0 || isSipCallRoom || agentSessionIDs.size > 0) {
+                // User with an Accepted offer for it
+                const hasAcceptedOffer = offers.some((o) => UUIDsEqual(o.TargetUserID, user.ID) && o.Status === 'Accepted');
+                if (hasAcceptedOffer) {
+                    return { Authorized: true };
+                }
+                // User who started it (the Interaction's or Agent Session's owner)
+                if (agentSessionIDs.size > 0) {
+                    const filter = [...agentSessionIDs].map((id) => `ID = '${EscapeSQLString(id)}'`).join(' OR ');
+                    const sessionResult = await rv.RunView({
+                        EntityName: 'MJ: AI Agent Sessions',
+                        ExtraFilter: filter,
+                        Fields: ['ID', 'UserID'],
+                        ResultType: 'simple',
+                    }, user);
+                    if (!sessionResult.Success) {
+                        LogError(`[RoomAuthorizationService] Error querying MJ: AI Agent Sessions for room '${trimmedRoom}': ${sessionResult.ErrorMessage}`);
+                        return { Authorized: false, Reason: 'Error verifying session authorization.' };
+                    }
+                    const sessions = (sessionResult.Results ?? []);
+                    if (sessions.some((s) => UUIDsEqual(s.UserID, user.ID))) {
+                        return { Authorized: true };
+                    }
+                }
+                return { Authorized: false, Reason: 'User is not authorized to access this call or agent session room.' };
+            }
+            // 3. Rooms tied to an MJ: Interaction Offers record
+            if (offers.length > 0) {
+                const acceptedOffer = offers.find((o) => UUIDsEqual(o.TargetUserID, user.ID) && o.Status === 'Accepted');
+                if (acceptedOffer) {
+                    return { Authorized: true };
+                }
+                return { Authorized: false, Reason: 'User has not accepted a handoff offer for this room.' };
+            }
+            // 4. Ad-hoc rooms: only rooms with no Meeting, no Interaction, no Agent Session, and no Offer row
+            return { Authorized: true };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            LogError(`[RoomAuthorizationService] Unexpected error authorizing room '${trimmedRoom}': ${msg}`);
+            return { Authorized: false, Reason: `Internal authorization error: ${msg}` };
+        }
+    }
+}
+//# sourceMappingURL=room-authorization.js.map

package/dist/room-authorization.js.map

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