@memberjunction/ng-mj-livekit-room 6.2.0-edge.2 → 6.2.0-edge.4

package/README.md

@@ -28,7 +28,7 @@ RealtimeBridgeResolver (MJServer) ──► @memberjunction/livekit-room-server
 ></mj-livekit-agent-room>
 
 <!-- Or just join an existing room -->
-<mj-livekit-agent-room [Mode]="'join'" [RoomName]="'support-42'" [DisplayName]="'Amith'"></mj-livekit-agent-room>
+<mj-livekit-agent-room [Mode]="'join'" [RoomName]="'support-42'" [DisplayName]="'Jordan'"></mj-livekit-agent-room>
 ```
 
 ## What it adds over the generic component
@@ -39,11 +39,18 @@ RealtimeBridgeResolver (MJServer) ──► @memberjunction/livekit-room-server
   emits `SessionStarted` with the bridge id.
 - **Server-authorized recording** — `EnableRecording` wires the record button to the egress mutations.
 - **Multi-provider** — extends `BaseAngularComponent`; pass `[Provider]` to scope to a specific MJ server.
+- **Saved layout** — the user's layout of the room is saved per user (see [Saved layout](#saved-layout)).
+- **Avatar notices** — when an agent's bot says the agent's avatar can't be shown, the room shows one info notice per
+  agent per join, such as "Audio only for Sage: the avatar can't be shown in this meeting". The user can dismiss it; it
+  also hides after 10 seconds or when the agent leaves, and doesn't show again in that join. A reconnect is the same
+  join; a disconnect or "Try again" starts a new one. `AvatarNoticeLabels` (`AvatarNoticeOverrides` from
+  `@memberjunction/ng-realtime-media`) gives a host's own line per reason, shown as written with `{Agent}` for the
+  agent's name. A reason it leaves out, or one the room doesn't know, gets the stock line.
 
 ## Inputs
 
-`Mode` (`agent` / `join`), `AgentID`, `AgentName`, `RoomName`, `DisplayName`, `TurnMode`, `AutoStart`,
-plus pass-through gates: `Layout`, `Title`, `ShowHeader`, `ShowControlBar`, `ShowChat`,
+`Mode` (`agent` / `join` / `preview`), `AgentID`, `AgentName`, `RoomName`, `DisplayName`, `TurnMode`, `AutoStart`,
+`AvatarNoticeLabels`, plus pass-through gates: `Layout`, `Title`, `ShowHeader`, `ShowControlBar`, `ShowChat`,
 `ShowParticipantsPanel`, `EnablePinning`, `EnableLayoutSwitcher`, `EnableNoiseFilter`,
 `EnableBackgroundEffects`, `ShowAgentState`, `ShowPreJoin`, `EnableRecording`, `StartWithMicrophone`,
 `StartWithCamera`, `AgentAvatarUrl`, `E2EEPassphrase`, `E2EEWorker`, and the device-control gates.
@@ -53,6 +60,23 @@ plus pass-through gates: `Layout`, `Title`, `ShowHeader`, `ShowControlBar`, `Sho
 `SessionStarted`, `Connected`, `Disconnected`, `ParticipantJoined`, `ParticipantLeft`, `DataReceived`,
 `ErrorOccurred`.
 
+## Saved layout
+
+The binding saves the user's room layout in `MJ: User Settings`, per user and for every room: where they moved
+participants' tiles, where they put picture-in-picture boxes, and whether they hid their self-view. It loads the layout
+when it starts, gives it to the room, and saves each change the room reports, through `MediaLayoutPrefs` from
+`@memberjunction/ai-realtime-client/media`. The preview room (`Mode="preview"`) saves under its own keys, so trying it
+never changes a meeting's layout.
+
+| Saved | Meetings | Preview room |
+|---|---|---|
+| Tile moves | `mj.livekit.placement.v1` (`LIVEKIT_PLACEMENT_PREF_KEY`) | `mj.livekit.preview.placement.v1` (`LIVEKIT_PREVIEW_PLACEMENT_PREF_KEY`) |
+| Picture-in-picture boxes | `mj.livekit.pip.v1` (`LIVEKIT_PIP_PREF_KEY`) | `mj.livekit.preview.pip.v1` (`LIVEKIT_PREVIEW_PIP_PREF_KEY`) |
+| Self-view hidden | `mj.livekit.selfView.hidden.v1` (`LIVEKIT_SELF_VIEW_HIDDEN_PREF_KEY`) | `mj.livekit.preview.selfView.hidden.v1` (`LIVEKIT_PREVIEW_SELF_VIEW_HIDDEN_PREF_KEY`) |
+
+Only a saved `true` hides the self-view; nothing saved, `false` or any other value shows it. Show and Reset layout save
+`false`. When saving fails, the change still holds for the session.
+
 ## In Explorer
 
 `@memberjunction/ng-explorer-core` registers a `LiveKitRoomResource` (`DriverClass = 'LiveKitRoomResource'`)

package/dist/lib/agent-avatar-notices.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview The meeting room's notice that an agent's avatar can't be shown. Everyone in the room sees it, once per
+ * agent per join, from the agent's bot's attribute (`LiveKitParticipantView.AvatarAudioOnly`, read by the room core).
+ * Its words are `ng-realtime-media`'s `AvatarNoticeText` in the meeting form, which names the agent, since a meeting
+ * can have several.
+ *
+ * @module @memberjunction/ng-mj-livekit-room
+ */
+import type { LiveKitAvatarAudioOnly, LiveKitRoomState } from '@memberjunction/livekit-room-core';
+/** How long a notice shows before it hides itself, in milliseconds. */
+export declare const AGENT_AVATAR_NOTICE_HIDE_MS = 10000;
+/** A reason the room can name (`RealtimeAvatarUnavailableReason` in `@memberjunction/ai`). */
+type AvatarAudioOnlyReason = NonNullable<LiveKitAvatarAudioOnly['Reason']>;
+/** A notice over the room: the agent it is about, and why its avatar can't be shown. */
+export interface AgentAvatarNotice {
+    /** The agent's participant identity. */
+    Identity: string;
+    /** The agent's name, as the room shows it. */
+    AgentName: string;
+    /** Why, when the agent's bot gave a reason the room knows. */
+    Reason?: AvatarAudioOnlyReason;
+}
+/**
+ * The notices that agents' avatars can't be shown, for one meeting room. A notice shows from the first room state in
+ * which the agent's bot says audio only, until the user dismisses it, {@link AGENT_AVATAR_NOTICE_HIDE_MS} passes or the
+ * agent leaves, and not again in the same join: a reconnect is the same join, and only {@link Reset} starts a new one.
+ */
+export declare class AgentAvatarNotices {
+    private readonly changed;
+    private readonly hideAfterMs;
+    /** The agents that have had their notice in this join. */
+    private readonly noticed;
+    /** The hide timer of each notice showing, by agent. */
+    private readonly timers;
+    private visible;
+    /**
+     * @param changed Called whenever the notices showing change, including when one hides itself.
+     * @param hideAfterMs How long a notice shows before it hides itself.
+     */
+    constructor(changed: () => void, hideAfterMs?: number);
+    /** The notices showing now, oldest first. */
+    get Visible(): readonly AgentAvatarNotice[];
+    /** Shows a notice for each agent newly audio only in this join, and drops the notices of agents who left. */
+    Update(state: LiveKitRoomState): void;
+    /** Hides an agent's notice; it does not show again in this join. */
+    Dismiss(identity: string): void;
+    /** Starts a new join: no notice shows now, and each agent's can show once more. */
+    Reset(): void;
+    /** Stops the hide timers, for a room that is going away. */
+    Dispose(): void;
+    /** A new notice for an agent newly audio only in this join, with its hide timer started; none for anyone else. */
+    private noticeFor;
+    private hide;
+    private stopTimer;
+}
+export {};
+//# sourceMappingURL=agent-avatar-notices.d.ts.map

package/dist/lib/agent-avatar-notices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-avatar-notices.d.ts","sourceRoot":"","sources":["../../src/lib/agent-avatar-notices.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAA0B,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1H,uEAAuE;AACvE,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,8FAA8F;AAC9F,KAAK,qBAAqB,GAAG,WAAW,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAE3E,wFAAwF;AACxF,MAAM,WAAW,iBAAiB;IAChC,wCAAwC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,MAAM,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;GAIG;AACH,qBAAa,kBAAkB;IAY3B,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAZ9B,0DAA0D;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,uDAAuD;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAoD;IAC3E,OAAO,CAAC,OAAO,CAAoC;IAEnD;;;OAGG;gBAEgB,OAAO,EAAE,MAAM,IAAI,EACnB,WAAW,GAAE,MAAoC;IAGpE,6CAA6C;IAC7C,IAAW,OAAO,IAAI,SAAS,iBAAiB,EAAE,CAEjD;IAED,6GAA6G;IACtG,MAAM,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAY5C,oEAAoE;IAC7D,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMtC,mFAAmF;IAC5E,KAAK,IAAI,IAAI;IASpB,4DAA4D;IACrD,OAAO,IAAI,IAAI;IAItB,kHAAkH;IAClH,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,IAAI;IAMZ,OAAO,CAAC,SAAS;CAOlB"}

package/dist/lib/agent-avatar-notices.js

@@ -0,0 +1,90 @@
+/**
+ * @fileoverview The meeting room's notice that an agent's avatar can't be shown. Everyone in the room sees it, once per
+ * agent per join, from the agent's bot's attribute (`LiveKitParticipantView.AvatarAudioOnly`, read by the room core).
+ * Its words are `ng-realtime-media`'s `AvatarNoticeText` in the meeting form, which names the agent, since a meeting
+ * can have several.
+ *
+ * @module @memberjunction/ng-mj-livekit-room
+ */
+/** How long a notice shows before it hides itself, in milliseconds. */
+export const AGENT_AVATAR_NOTICE_HIDE_MS = 10_000;
+/**
+ * The notices that agents' avatars can't be shown, for one meeting room. A notice shows from the first room state in
+ * which the agent's bot says audio only, until the user dismisses it, {@link AGENT_AVATAR_NOTICE_HIDE_MS} passes or the
+ * agent leaves, and not again in the same join: a reconnect is the same join, and only {@link Reset} starts a new one.
+ */
+export class AgentAvatarNotices {
+    changed;
+    hideAfterMs;
+    /** The agents that have had their notice in this join. */
+    noticed = new Set();
+    /** The hide timer of each notice showing, by agent. */
+    timers = new Map();
+    visible = [];
+    /**
+     * @param changed Called whenever the notices showing change, including when one hides itself.
+     * @param hideAfterMs How long a notice shows before it hides itself.
+     */
+    constructor(changed, hideAfterMs = AGENT_AVATAR_NOTICE_HIDE_MS) {
+        this.changed = changed;
+        this.hideAfterMs = hideAfterMs;
+    }
+    /** The notices showing now, oldest first. */
+    get Visible() {
+        return this.visible;
+    }
+    /** Shows a notice for each agent newly audio only in this join, and drops the notices of agents who left. */
+    Update(state) {
+        const present = new Set(state.Remote.map((p) => p.Identity));
+        const kept = this.visible.filter((notice) => present.has(notice.Identity));
+        this.visible.filter((notice) => !present.has(notice.Identity)).forEach((notice) => this.stopTimer(notice.Identity));
+        const added = state.Remote.flatMap((p) => this.noticeFor(p));
+        if (added.length === 0 && kept.length === this.visible.length) {
+            return;
+        }
+        this.visible = [...kept, ...added];
+        this.changed();
+    }
+    /** Hides an agent's notice; it does not show again in this join. */
+    Dismiss(identity) {
+        if (this.visible.some((notice) => notice.Identity === identity)) {
+            this.hide(identity);
+        }
+    }
+    /** Starts a new join: no notice shows now, and each agent's can show once more. */
+    Reset() {
+        this.noticed.clear();
+        [...this.timers.keys()].forEach((identity) => this.stopTimer(identity));
+        if (this.visible.length > 0) {
+            this.visible = [];
+            this.changed();
+        }
+    }
+    /** Stops the hide timers, for a room that is going away. */
+    Dispose() {
+        [...this.timers.keys()].forEach((identity) => this.stopTimer(identity));
+    }
+    /** A new notice for an agent newly audio only in this join, with its hide timer started; none for anyone else. */
+    noticeFor(participant) {
+        const audioOnly = participant.AvatarAudioOnly;
+        if (participant.Role !== 'agent' || !audioOnly || this.noticed.has(participant.Identity)) {
+            return [];
+        }
+        this.noticed.add(participant.Identity);
+        this.timers.set(participant.Identity, setTimeout(() => this.hide(participant.Identity), this.hideAfterMs));
+        return [{ Identity: participant.Identity, AgentName: participant.DisplayName, ...(audioOnly.Reason ? { Reason: audioOnly.Reason } : {}) }];
+    }
+    hide(identity) {
+        this.stopTimer(identity);
+        this.visible = this.visible.filter((notice) => notice.Identity !== identity);
+        this.changed();
+    }
+    stopTimer(identity) {
+        const timer = this.timers.get(identity);
+        if (timer !== undefined) {
+            clearTimeout(timer);
+            this.timers.delete(identity);
+        }
+    }
+}
+//# sourceMappingURL=agent-avatar-notices.js.map

package/dist/lib/agent-avatar-notices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-avatar-notices.js","sourceRoot":"","sources":["../../src/lib/agent-avatar-notices.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @fileoverview The meeting room's notice that an agent's avatar can't be shown. Everyone in the room sees it, once per\n * agent per join, from the agent's bot's attribute (`LiveKitParticipantView.AvatarAudioOnly`, read by the room core).\n * Its words are `ng-realtime-media`'s `AvatarNoticeText` in the meeting form, which names the agent, since a meeting\n * can have several.\n *\n * @module @memberjunction/ng-mj-livekit-room\n */\n\nimport type { LiveKitAvatarAudioOnly, LiveKitParticipantView, LiveKitRoomState } from '@memberjunction/livekit-room-core';\n\n/** How long a notice shows before it hides itself, in milliseconds. */\nexport const AGENT_AVATAR_NOTICE_HIDE_MS = 10_000;\n\n/** A reason the room can name (`RealtimeAvatarUnavailableReason` in `@memberjunction/ai`). */\ntype AvatarAudioOnlyReason = NonNullable<LiveKitAvatarAudioOnly['Reason']>;\n\n/** A notice over the room: the agent it is about, and why its avatar can't be shown. */\nexport interface AgentAvatarNotice {\n  /** The agent's participant identity. */\n  Identity: string;\n  /** The agent's name, as the room shows it. */\n  AgentName: string;\n  /** Why, when the agent's bot gave a reason the room knows. */\n  Reason?: AvatarAudioOnlyReason;\n}\n\n/**\n * The notices that agents' avatars can't be shown, for one meeting room. A notice shows from the first room state in\n * which the agent's bot says audio only, until the user dismisses it, {@link AGENT_AVATAR_NOTICE_HIDE_MS} passes or the\n * agent leaves, and not again in the same join: a reconnect is the same join, and only {@link Reset} starts a new one.\n */\nexport class AgentAvatarNotices {\n  /** The agents that have had their notice in this join. */\n  private readonly noticed = new Set<string>();\n  /** The hide timer of each notice showing, by agent. */\n  private readonly timers = new Map<string, ReturnType<typeof setTimeout>>();\n  private visible: readonly AgentAvatarNotice[] = [];\n\n  /**\n   * @param changed Called whenever the notices showing change, including when one hides itself.\n   * @param hideAfterMs How long a notice shows before it hides itself.\n   */\n  constructor(\n    private readonly changed: () => void,\n    private readonly hideAfterMs: number = AGENT_AVATAR_NOTICE_HIDE_MS,\n  ) {}\n\n  /** The notices showing now, oldest first. */\n  public get Visible(): readonly AgentAvatarNotice[] {\n    return this.visible;\n  }\n\n  /** Shows a notice for each agent newly audio only in this join, and drops the notices of agents who left. */\n  public Update(state: LiveKitRoomState): void {\n    const present = new Set(state.Remote.map((p) => p.Identity));\n    const kept = this.visible.filter((notice) => present.has(notice.Identity));\n    this.visible.filter((notice) => !present.has(notice.Identity)).forEach((notice) => this.stopTimer(notice.Identity));\n    const added = state.Remote.flatMap((p) => this.noticeFor(p));\n    if (added.length === 0 && kept.length === this.visible.length) {\n      return;\n    }\n    this.visible = [...kept, ...added];\n    this.changed();\n  }\n\n  /** Hides an agent's notice; it does not show again in this join. */\n  public Dismiss(identity: string): void {\n    if (this.visible.some((notice) => notice.Identity === identity)) {\n      this.hide(identity);\n    }\n  }\n\n  /** Starts a new join: no notice shows now, and each agent's can show once more. */\n  public Reset(): void {\n    this.noticed.clear();\n    [...this.timers.keys()].forEach((identity) => this.stopTimer(identity));\n    if (this.visible.length > 0) {\n      this.visible = [];\n      this.changed();\n    }\n  }\n\n  /** Stops the hide timers, for a room that is going away. */\n  public Dispose(): void {\n    [...this.timers.keys()].forEach((identity) => this.stopTimer(identity));\n  }\n\n  /** A new notice for an agent newly audio only in this join, with its hide timer started; none for anyone else. */\n  private noticeFor(participant: LiveKitParticipantView): AgentAvatarNotice[] {\n    const audioOnly = participant.AvatarAudioOnly;\n    if (participant.Role !== 'agent' || !audioOnly || this.noticed.has(participant.Identity)) {\n      return [];\n    }\n    this.noticed.add(participant.Identity);\n    this.timers.set(participant.Identity, setTimeout(() => this.hide(participant.Identity), this.hideAfterMs));\n    return [{ Identity: participant.Identity, AgentName: participant.DisplayName, ...(audioOnly.Reason ? { Reason: audioOnly.Reason } : {}) }];\n  }\n\n  private hide(identity: string): void {\n    this.stopTimer(identity);\n    this.visible = this.visible.filter((notice) => notice.Identity !== identity);\n    this.changed();\n  }\n\n  private stopTimer(identity: string): void {\n    const timer = this.timers.get(identity);\n    if (timer !== undefined) {\n      clearTimeout(timer);\n      this.timers.delete(identity);\n    }\n  }\n}\n"]}

package/dist/lib/device-error-notice.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview The meeting room's notice for a device error: a microphone, camera, speaker or share that failed, or
+ * that the browser refused. Its line says what the user asked for and, after a colon, the reason the browser, LiveKit or
+ * the share picker gave, as the room's notice about what the agent sees does ("Couldn't change what the agent sees: …").
+ * For a panel share where the user picked another surface, the reason is `/media`'s own hint, so the line reads
+ * "Couldn't start sharing: To share only the panel, choose this tab in the browser's picker." A share picker the user
+ * closed is no error, so nothing shows for it.
+ *
+ * @module @memberjunction/ng-mj-livekit-room
+ */
+import type { LiveKitRoomError } from '@memberjunction/livekit-room-core';
+/**
+ * The meeting room's notice line for a room error: for a `device` error, what the user asked for and the reason given,
+ * or what they asked for alone when no reason was given; `null` for any other kind of error.
+ *
+ * @param error The error the room reported.
+ * @returns The line, such as "Couldn't turn on your camera: Could not start video source", or `null`.
+ */
+export declare function DeviceErrorNoticeText(error: LiveKitRoomError): string | null;
+//# sourceMappingURL=device-error-notice.d.ts.map

package/dist/lib/device-error-notice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-error-notice.d.ts","sourceRoot":"","sources":["../../src/lib/device-error-notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAsB,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAoC9F;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAO5E"}

package/dist/lib/device-error-notice.js

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview The meeting room's notice for a device error: a microphone, camera, speaker or share that failed, or
+ * that the browser refused. Its line says what the user asked for and, after a colon, the reason the browser, LiveKit or
+ * the share picker gave, as the room's notice about what the agent sees does ("Couldn't change what the agent sees: …").
+ * For a panel share where the user picked another surface, the reason is `/media`'s own hint, so the line reads
+ * "Couldn't start sharing: To share only the panel, choose this tab in the browser's picker." A share picker the user
+ * closed is no error, so nothing shows for it.
+ *
+ * @module @memberjunction/ng-mj-livekit-room
+ */
+/** How the notice starts: what the user asked for, by device and request. */
+const LEADS = {
+    microphone: {
+        on: "Couldn't turn on your microphone",
+        off: "Couldn't turn off your microphone",
+        switch: "Couldn't switch your microphone",
+        unknown: "Couldn't use your microphone",
+    },
+    camera: {
+        on: "Couldn't turn on your camera",
+        off: "Couldn't turn off your camera",
+        switch: "Couldn't switch your camera",
+        unknown: "Couldn't use your camera",
+    },
+    screen: {
+        on: "Couldn't start sharing",
+        off: "Couldn't stop sharing",
+        switch: "Couldn't share",
+        unknown: "Couldn't share",
+    },
+    speaker: {
+        on: "Couldn't turn on the sound",
+        off: "Couldn't turn off the sound",
+        switch: "Couldn't switch your speaker",
+        unknown: "Couldn't play the sound",
+    },
+};
+/** How the notice starts for a device error about no one device (listing the devices). */
+const NO_DEVICE_LEAD = "Couldn't use your devices";
+/**
+ * The meeting room's notice line for a room error: for a `device` error, what the user asked for and the reason given,
+ * or what they asked for alone when no reason was given; `null` for any other kind of error.
+ *
+ * @param error The error the room reported.
+ * @returns The line, such as "Couldn't turn on your camera: Could not start video source", or `null`.
+ */
+export function DeviceErrorNoticeText(error) {
+    if (error.Kind !== 'device') {
+        return null;
+    }
+    const lead = error.Device ? LEADS[error.Device.Media][error.Device.Change ?? 'unknown'] : NO_DEVICE_LEAD;
+    const reason = reasonOf(error.Cause);
+    return reason ? `${lead}: ${reason}` : `${lead}.`;
+}
+/** The reason an error's cause gives: an error's message, or the text the preview room passes; empty for anything else. */
+function reasonOf(cause) {
+    if (cause instanceof Error) {
+        return cause.message.trim();
+    }
+    return typeof cause === 'string' ? cause.trim() : '';
+}
+//# sourceMappingURL=device-error-notice.js.map

package/dist/lib/device-error-notice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-error-notice.js","sourceRoot":"","sources":["../../src/lib/device-error-notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,6EAA6E;AAC7E,MAAM,KAAK,GAA2F;IACpG,UAAU,EAAE;QACV,EAAE,EAAE,kCAAkC;QACtC,GAAG,EAAE,mCAAmC;QACxC,MAAM,EAAE,iCAAiC;QACzC,OAAO,EAAE,8BAA8B;KACxC;IACD,MAAM,EAAE;QACN,EAAE,EAAE,8BAA8B;QAClC,GAAG,EAAE,+BAA+B;QACpC,MAAM,EAAE,6BAA6B;QACrC,OAAO,EAAE,0BAA0B;KACpC;IACD,MAAM,EAAE;QACN,EAAE,EAAE,wBAAwB;QAC5B,GAAG,EAAE,uBAAuB;QAC5B,MAAM,EAAE,gBAAgB;QACxB,OAAO,EAAE,gBAAgB;KAC1B;IACD,OAAO,EAAE;QACP,EAAE,EAAE,4BAA4B;QAChC,GAAG,EAAE,6BAA6B;QAClC,MAAM,EAAE,8BAA8B;QACtC,OAAO,EAAE,yBAAyB;KACnC;CACF,CAAC;AAEF,0FAA0F;AAC1F,MAAM,cAAc,GAAG,2BAA2B,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAuB;IAC3D,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;IACzG,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;AACpD,CAAC;AAED,2HAA2H;AAC3H,SAAS,QAAQ,CAAC,KAAc;IAC9B,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC9B,CAAC;IACD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC","sourcesContent":["/**\n * @fileoverview The meeting room's notice for a device error: a microphone, camera, speaker or share that failed, or\n * that the browser refused. Its line says what the user asked for and, after a colon, the reason the browser, LiveKit or\n * the share picker gave, as the room's notice about what the agent sees does (\"Couldn't change what the agent sees: …\").\n * For a panel share where the user picked another surface, the reason is `/media`'s own hint, so the line reads\n * \"Couldn't start sharing: To share only the panel, choose this tab in the browser's picker.\" A share picker the user\n * closed is no error, so nothing shows for it.\n *\n * @module @memberjunction/ng-mj-livekit-room\n */\n\nimport type { LiveKitErrorDevice, LiveKitRoomError } from '@memberjunction/livekit-room-core';\n\n/** What the user asked of a device, or `'unknown'` when the room can't tell. */\ntype DeviceRequest = NonNullable<LiveKitErrorDevice['Change']> | 'unknown';\n\n/** How the notice starts: what the user asked for, by device and request. */\nconst LEADS: Readonly<Record<LiveKitErrorDevice['Media'], Readonly<Record<DeviceRequest, string>>>> = {\n  microphone: {\n    on: \"Couldn't turn on your microphone\",\n    off: \"Couldn't turn off your microphone\",\n    switch: \"Couldn't switch your microphone\",\n    unknown: \"Couldn't use your microphone\",\n  },\n  camera: {\n    on: \"Couldn't turn on your camera\",\n    off: \"Couldn't turn off your camera\",\n    switch: \"Couldn't switch your camera\",\n    unknown: \"Couldn't use your camera\",\n  },\n  screen: {\n    on: \"Couldn't start sharing\",\n    off: \"Couldn't stop sharing\",\n    switch: \"Couldn't share\",\n    unknown: \"Couldn't share\",\n  },\n  speaker: {\n    on: \"Couldn't turn on the sound\",\n    off: \"Couldn't turn off the sound\",\n    switch: \"Couldn't switch your speaker\",\n    unknown: \"Couldn't play the sound\",\n  },\n};\n\n/** How the notice starts for a device error about no one device (listing the devices). */\nconst NO_DEVICE_LEAD = \"Couldn't use your devices\";\n\n/**\n * The meeting room's notice line for a room error: for a `device` error, what the user asked for and the reason given,\n * or what they asked for alone when no reason was given; `null` for any other kind of error.\n *\n * @param error The error the room reported.\n * @returns The line, such as \"Couldn't turn on your camera: Could not start video source\", or `null`.\n */\nexport function DeviceErrorNoticeText(error: LiveKitRoomError): string | null {\n  if (error.Kind !== 'device') {\n    return null;\n  }\n  const lead = error.Device ? LEADS[error.Device.Media][error.Device.Change ?? 'unknown'] : NO_DEVICE_LEAD;\n  const reason = reasonOf(error.Cause);\n  return reason ? `${lead}: ${reason}` : `${lead}.`;\n}\n\n/** The reason an error's cause gives: an error's message, or the text the preview room passes; empty for anything else. */\nfunction reasonOf(cause: unknown): string {\n  if (cause instanceof Error) {\n    return cause.message.trim();\n  }\n  return typeof cause === 'string' ? cause.trim() : '';\n}\n"]}

package/dist/lib/meetings/meeting-list.component.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter, OnInit } from '@angular/core';
+import type { IMetadataProvider } from '@memberjunction/core';
+import { type MeetingInfo } from '@memberjunction/graphql-dataprovider';
+import * as i0 from "@angular/core";
+export declare class MJMeetingListComponent implements OnInit {
+    private readonly cdr;
+    Provider?: IMetadataProvider;
+    JoinMeeting: EventEmitter<MeetingInfo>;
+    ScheduleRequested: EventEmitter<void>;
+    EditMeetingRequested: EventEmitter<MeetingInfo>;
+    Meetings: MeetingInfo[];
+    FilteredMeetings: MeetingInfo[];
+    ActiveFilter: 'all' | 'live' | 'scheduled' | 'past';
+    SearchQuery: string;
+    Loading: boolean;
+    ErrorMessage: string | null;
+    ngOnInit(): void;
+    LoadMeetings(): Promise<void>;
+    SetFilter(filter: 'all' | 'live' | 'scheduled' | 'past'): void;
+    OnSearchChange(): void;
+    ApplyFilter(): void;
+    OnJoin(meeting: MeetingInfo): void;
+    OnSchedule(): void;
+    OnEdit(meeting: MeetingInfo): void;
+    OnCancelMeeting(meeting: MeetingInfo): Promise<void>;
+    FormatTime(dateStr?: string): string;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MJMeetingListComponent, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MJMeetingListComponent, "mj-meeting-list", never, { "Provider": { "alias": "Provider"; "required": false; }; }, { "JoinMeeting": "JoinMeeting"; "ScheduleRequested": "ScheduleRequested"; "EditMeetingRequested": "EditMeetingRequested"; }, never, never, true, never>;
+}
+//# sourceMappingURL=meeting-list.component.d.ts.map

package/dist/lib/meetings/meeting-list.component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meeting-list.component.d.ts","sourceRoot":"","sources":["../../../src/lib/meetings/meeting-list.component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyD,YAAY,EAAS,MAAM,EAAkB,MAAM,eAAe,CAAC;AAGnI,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,sCAAsC,CAAC;;AAE9C,qBAiaa,sBAAuB,YAAW,MAAM;IACnD,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiD;IAE5D,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE5B,WAAW,4BAAmC;IAC9C,iBAAiB,qBAA4B;IAC7C,oBAAoB,4BAAmC;IAE1D,QAAQ,EAAE,WAAW,EAAE,CAAM;IAC7B,gBAAgB,EAAE,WAAW,EAAE,CAAM;IACrC,YAAY,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,CAAS;IAC5D,WAAW,EAAE,MAAM,CAAM;IACzB,OAAO,EAAE,OAAO,CAAS;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE1C,QAAQ,IAAI,IAAI;IAIH,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAiBnC,SAAS,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,IAAI;IAK9D,cAAc,IAAI,IAAI;IAItB,WAAW,IAAI,IAAI;IAyBnB,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAIlC,UAAU,IAAI,IAAI;IAIlB,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAI5B,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1D,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;yCApGhC,sBAAsB;2CAAtB,sBAAsB;CAkHlC"}