renames and restructure

- session -> matrixrtc (folder) - move MatrixRtcClient to top level of sdk - RtcTransport -> Transport - backend -> media-backend
2026-10-16 23:45:50 +00:00 · 2026-10-08 13:53:57 +02:00
parent d0a2ff12f1
commit 5b13e1da81
51 changed files with 96 additions and 85 deletions
@@ -0,0 +1,135 @@
+/*
+Copyright 2026 Element Creations Ltd.
+
+SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial
+Please see LICENSE in the repository root for full details.
+*/
+
+import {
+  observeParticipantMedia,
+  roomEventSelector,
+} from "@livekit/components-core";
+import {
+  type LocalParticipant,
+  type Participant,
+  type Room as LivekitRoom,
+  RoomEvent,
+  type TrackPublication,
+} from "livekit-client";
+import { filter, map, type Observable } from "rxjs";
+
+import { type ObservableScope } from "../../reactive/ObservableScope";
+import { generateItems } from "../../reactive/observable";
+import { E2eeType } from "../../encryption";
+import { type EncryptionSystem } from "../../encryption";
+import { type Behavior } from "../../reactive/Behavior";
+import {
+  type EncryptionError,
+  type LocalMemberMedia,
+  type MediaSource,
+  type MemberMedia,
+} from "../../api";
+import {
+  createLivekitMediaTrack,
+  createLocalLivekitMediaTrack,
+} from "./LivekitMediaTrack";
+
+/**
+ * A participant as `MemberMedia`. The only place, with `LivekitMediaTrack`,
+ * that reads a LiveKit participant; everything above sees tracks and
+ * behaviors.
+ */
+export function createLivekitMemberMedia(
+  scope: ObservableScope,
+  participant: Participant,
+  room: LivekitRoom,
+  encryptionSystem: EncryptionSystem,
+): MemberMedia {
+  return {
+    local: false,
+    tracks$: memberTracks$(scope, participant, (trackScope, publication) =>
+      createLivekitMediaTrack(trackScope, participant, publication, room),
+    ),
+    encryptionError$: encryptionErrors$(
+      scope,
+      participant,
+      room,
+      encryptionSystem,
+    ),
+  };
+}
+
+export function createLocalLivekitMemberMedia(
+  scope: ObservableScope,
+  participant: LocalParticipant,
+  room: LivekitRoom,
+  encryptionSystem: EncryptionSystem,
+  setEnabled: (source: MediaSource, enabled: boolean) => Promise<boolean>,
+): LocalMemberMedia {
+  return {
+    local: true,
+    tracks$: memberTracks$(scope, participant, (trackScope, publication) =>
+      createLocalLivekitMediaTrack(
+        trackScope,
+        participant,
+        publication,
+        room,
+        setEnabled,
+      ),
+    ),
+    encryptionError$: encryptionErrors$(
+      scope,
+      participant,
+      room,
+      encryptionSystem,
+    ),
+  };
+}
+
+/** One track per publication, each living as long as its publication is in the participant's map. */
+function memberTracks$<T>(
+  scope: ObservableScope,
+  participant: Participant,
+  factory: (scope: ObservableScope, publication: TrackPublication) => T,
+): Behavior<T[]> {
+  return scope.behavior(
+    observeParticipantMedia(participant).pipe(
+      generateItems(
+        `${participant.identity} tracks$`,
+        function* () {
+          for (const publication of participant.trackPublications.values())
+            yield { keys: [publication.trackSid], data: publication };
+        },
+        (trackScope, publication$) => factory(trackScope, publication$.value),
+      ),
+    ),
+  );
+}
+
+function encryptionErrors$(
+  scope: ObservableScope,
+  participant: Participant,
+  room: LivekitRoom,
+  encryptionSystem: EncryptionSystem,
+): Observable<EncryptionError> {
+  return roomEventSelector(room, RoomEvent.EncryptionError).pipe(
+    map(([error]) => error?.message ?? ""),
+    // The participant the error is about does not survive the trip from the
+    // worker, so the identity is matched in the message. A shared key is the
+    // same for everyone, so its errors are too.
+    filter(
+      (message) =>
+        encryptionSystem.kind === E2eeType.SHARED_KEY ||
+        message.includes(participant.identity),
+    ),
+    map((message): EncryptionError | undefined =>
+      message.includes("MissingKey")
+        ? "MissingKey"
+        : message.includes("InvalidKey")
+          ? "InvalidKey"
+          : undefined,
+    ),
+    filter((error) => error !== undefined),
+    scope.bind(),
+  );
+}