Update SDK to be consumed by Element Call's CallViewModel

Update the public API to export the primitives and operators the call
model needs, and change `LocalMediaInputs` from observable flags to
immediate booleans with imperative setters. Add session timings, media
quality and capture settings as configuration options, and allow the
host to override the transport discovery with explicit URLs.

sdk/src/session/joinJsSdkSession.ts

@@ -13,18 +13,22 @@ import {
 } from "matrix-js-sdk/lib/matrixrtc";
 import { type CallMembershipIdentityParts } from "matrix-js-sdk/lib/matrixrtc/EncryptionManager";
 
-import { defaultSessionTimings, MatrixRTCMode } from "../config";
+import {
+  type DelayedLeaveTimings,
+  MatrixRTCMode,
+  type SessionTimings,
+} from "../config";
 
 interface Options {
   encryptMedia: boolean;
   matrixRTCMode: MatrixRTCMode;
   sendNotificationType?: RTCNotificationType;
   applicationData?: Record<string, unknown>;
+  timings: SessionTimings;
+  /** The delayed leave timings to use: delegated to the SFU or not. */
+  delayedLeave: DelayedLeaveTimings;
 }
 
-/** The session's timings; a later slice makes them an input. */
-export const sessionTimings = defaultSessionTimings;
-
 /**
  * Sends the membership and starts the membership manager, which keeps it
  * alive and retries on failure.
@@ -39,33 +43,34 @@ export function joinJsSdkSession(
     matrixRTCMode,
     sendNotificationType,
     applicationData,
+    timings,
+    delayedLeave,
   }: Options,
 ): void {
   // The one piece of application data the js-sdk can put in a membership
   const intent = applicationData?.["m.call.intent"];
   const callIntent =
     typeof intent === "string" ? (intent as RTCCallIntent) : undefined;
-  const timings = sessionTimings.delayedLeave;
   // Give up on the network as soon as either the sync has been down for the
   // grace period or the delayed leave has probably been sent, whichever is
   // sooner
   const maxWaitMs = Math.min(
-    sessionTimings.syncDisconnectGracePeriodMs,
-    timings.delay_ms,
+    timings.syncDisconnectGracePeriodMs,
+    delayedLeave.delay_ms,
   );
   session.joinRTCSession(ownMembershipIdentity, [transport], {
     notificationType: sendNotificationType,
     callIntent,
     manageMediaKeys: encryptMedia,
-    delayedLeaveEventRestartMs: timings.restart_ms,
-    delayedLeaveEventDelayMs: timings.delay_ms,
-    delayedLeaveEventRestartLocalTimeoutMs: timings.restart_timeout_ms,
-    networkErrorRetryMs: sessionTimings.networkErrorRetryMs,
-    makeKeyDelay: sessionTimings.waitForKeyRotationMs,
-    membershipEventExpiryMs: sessionTimings.membershipEventExpiryMs,
-    keyRotationParticipantLimit: sessionTimings.keyRotationParticipantLimit,
+    delayedLeaveEventRestartMs: delayedLeave.restart_ms,
+    delayedLeaveEventDelayMs: delayedLeave.delay_ms,
+    delayedLeaveEventRestartLocalTimeoutMs: delayedLeave.restart_timeout_ms,
+    networkErrorRetryMs: timings.networkErrorRetryMs,
+    makeKeyDelay: timings.waitForKeyRotationMs,
+    membershipEventExpiryMs: timings.membershipEventExpiryMs,
+    keyRotationParticipantLimit: timings.keyRotationParticipantLimit,
     unstableSendStickyEvents: matrixRTCMode === MatrixRTCMode.Matrix_2_0,
     maximumNetworkErrorRetryCount:
-      Math.ceil(maxWaitMs / sessionTimings.networkErrorRetryMs) + 1,
+      Math.ceil(maxWaitMs / timings.networkErrorRetryMs) + 1,
   });
 }