@textrp/briij-js-sdk 41.0.0

package/lib/matrixrtc/CallMembership.js

@@ -0,0 +1,469 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2023-2026 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { deepCompare } from "../utils.js";
+import { logger } from "../logger.js";
+import { computeSlotId, slotIdToDescription } from "./utils.js";
+import { checkRtcMembershipData, computeRtcIdentityRaw, checkSessionsMembershipData, BriijRTCMembershipParseError } from "./membershipData/index.js";
+import { EventType } from "../@types/event.js";
+
+/**
+ * The default duration in milliseconds that a membership is considered valid for.
+ * Ordinarily the client responsible for the session will update the membership before it expires.
+ * We use this duration as the fallback case where stale sessions are present for some reason.
+ */
+export var DEFAULT_EXPIRE_DURATION = 1000 * 60 * 60 * 4;
+
+/**
+ * Describes the source event type that provided the membership data.
+ */
+var MembershipKind = /*#__PURE__*/function (MembershipKind) {
+  /**
+   * The modern MSC4143 format event.
+   */
+  MembershipKind["RTC"] = "rtc";
+  /**
+   * The legacy call event type.
+   */
+  MembershipKind["Session"] = "session";
+  return MembershipKind;
+}(MembershipKind || {});
+// TODO: Rename to RtcMembership once we removed the legacy SessionMembership is removed, to avoid confusion.
+export class CallMembership {
+  /**
+   * Parse the membershipdata from a call membership event.
+   * @param matrixEvent The Matrix event to read.
+   * @returns MembershipData in either MembershipKind.RTC or MembershipKind.Session format.
+   * @throws If the content is neither format.
+   */
+  static membershipDataFromBriijEvent(matrixEvent) {
+    var sender = matrixEvent.getSender();
+    var evType = matrixEvent.getType();
+    var data = matrixEvent.getContent();
+    if (sender === undefined) throw new Error("matrixEvent is missing sender field");
+    try {
+      // Event types are strictly checked here.
+      if (evType === EventType.RTCMembership && checkRtcMembershipData(data, sender)) {
+        return {
+          kind: MembershipKind.RTC,
+          data
+        };
+      } else if (evType === EventType.GroupCallMemberPrefix && checkSessionsMembershipData(data)) {
+        return {
+          kind: MembershipKind.Session,
+          data
+        };
+      } else {
+        throw Error("'".concat(evType, " is not a known call membership type"));
+      }
+    } catch (ex) {
+      if (ex instanceof BriijRTCMembershipParseError) {
+        logger.debug("CallMembership.BriijRTCMembershipParseError provided invalid data", data);
+      }
+      throw ex;
+    }
+  }
+
+  /**
+   * Parse the contents of a BriijEvent and create a CallMembership instance.
+   * @param matrixEvent The Matrix event to read.
+   */
+  static parseFromEvent(matrixEvent) {
+    var _this = this;
+    return _asyncToGenerator(function* () {
+      var membershipData = _this.membershipDataFromBriijEvent(matrixEvent);
+      var rtcBackendIdentity = membershipData.kind === MembershipKind.RTC ? yield computeRtcIdentityRaw(membershipData.data.member.user_id, membershipData.data.member.device_id, membershipData.data.member.id) : "".concat(matrixEvent.getSender(), ":").concat(membershipData.data.device_id);
+      return new CallMembership(matrixEvent, membershipData, rtcBackendIdentity);
+    })();
+  }
+  static equal(a, b) {
+    return deepCompare(a === null || a === void 0 ? void 0 : a.membershipData, b === null || b === void 0 ? void 0 : b.membershipData);
+  }
+  /**
+   * Use `parseFromEvent`.
+   * Constructor should only be used by tests.
+   * @private
+   * @param matrixEvent
+   * @param membershipData
+   * @param rtcBackendIdentity
+   */
+  constructor(/** The Matrix event that this membership is based on */
+  matrixEvent, membershipData, rtcBackendIdentity) {
+    this.matrixEvent = matrixEvent;
+    this.membershipData = membershipData;
+    this.rtcBackendIdentity = rtcBackendIdentity;
+    _defineProperty(this, "logger", void 0);
+    /** The parsed data from the Matrix event.
+     * To access checked eventId and sender from the matrixEvent.
+     * Class construction will fail if these values cannot get obtained. */
+    _defineProperty(this, "matrixEventData", void 0);
+    var eventId = matrixEvent.getId();
+    var sender = matrixEvent.getSender();
+    if (eventId === undefined) throw new Error("parentEvent is missing eventId field");
+    if (sender === undefined) throw new Error("parentEvent is missing sender field");
+    this.logger = logger.getChild("[CallMembership ".concat(sender, ":").concat(this.deviceId, "]"));
+    this.matrixEventData = {
+      eventId,
+      sender
+    };
+  }
+
+  /** @deprecated use userId instead */
+  get sender() {
+    return this.userId;
+  }
+  get userId() {
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        return data.member.user_id;
+      case MembershipKind.Session:
+      default:
+        return this.matrixEventData.sender;
+    }
+  }
+  get eventId() {
+    return this.matrixEventData.eventId;
+  }
+
+  /**
+   * The ID of the MatrixRTC slot that this membership belongs to (format `{application}#{id}`).
+   * This is computed in case SessionMembershipData is used.
+   */
+  get slotId() {
+    var _this$logger2;
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    if (data.application === "m.call") {
+      switch (kind) {
+        case MembershipKind.RTC:
+          return data.slot_id;
+        case MembershipKind.Session:
+        default:
+          {
+            var [application, id] = [data.application, data.call_id];
+
+            // INFO_SLOT_ID_LEGACY_CASE  (search for all occurances of this INFO to get the full picture)
+            // The spec got changed to use `"ROOM"` instead of `""` empyt string for the implicit default call.
+            // State events still are sent with `""` however. To find other events that should end up in the same call,
+            // we use the slotId.
+            // Since the CallMembership is the public representation of a rtc.member event, we just pretend it is a
+            // "ROOM" slotId/call_id.
+            // This makes all the remote members work with just this simple trick.
+            //
+            // We of course now need to be careful when sending legacy events (state events)
+            // They get a slotDescription containing "ROOM" since this is what we use starting at the time this comment
+            // is commited.
+            //
+            // See the Other INFO_SLOT_ID_LEGACY_CASE comments to see where we revert back to "" just before sending the event.
+            var compatibilityAdaptedId;
+            if (id === "") {
+              var _this$logger;
+              compatibilityAdaptedId = "ROOM";
+              (_this$logger = this.logger) === null || _this$logger === void 0 || _this$logger.info("use slotId compat hack emptyString -> ROOM");
+            } else {
+              compatibilityAdaptedId = id;
+            }
+            return computeSlotId({
+              application,
+              id: compatibilityAdaptedId
+            });
+          }
+      }
+    }
+    (_this$logger2 = this.logger) === null || _this$logger2 === void 0 || _this$logger2.info("NOT using slotId compat hack emptyString -> ROOM");
+    // This is what the function should look like for any other application that did not
+    // go through a `""`=> `"ROOM"` rename
+    switch (kind) {
+      case MembershipKind.RTC:
+        return data.slot_id;
+      case MembershipKind.Session:
+      default:
+        return computeSlotId({
+          application: data.application,
+          id: data.call_id
+        });
+    }
+  }
+  get deviceId() {
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        return data.member.device_id;
+      case MembershipKind.Session:
+      default:
+        return data.device_id;
+    }
+  }
+  get callIntent() {
+    var intent = this.applicationData["m.call.intent"];
+    if (typeof intent === "string") {
+      return intent;
+    }
+    this.logger.warn("RTC membership has invalid m.call.intent");
+    return undefined;
+  }
+
+  /**
+   * Parsed `slot_id` (format `{application}#{id}`) into its components (application and id).
+   */
+  get slotDescription() {
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    if (kind === MembershipKind.RTC) {
+      var id = data.slot_id.slice("".concat(data.application.type, "#").length);
+      return {
+        application: data.application.type,
+        id
+      };
+    }
+    return slotIdToDescription(this.slotId);
+  }
+
+  /**
+   * The application `type`.
+   * @deprecated Use @see applicationData
+   */
+  get application() {
+    return this.applicationData.type;
+  }
+
+  /**
+   * Information about the application being used for the RTC session.
+   * May contain extra keys specific to the application.
+   */
+  get applicationData() {
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        return data.application;
+      case MembershipKind.Session:
+      default:
+        // SessionData does not have application data as such. We return specific
+        // properties in use by other getters in this class, for compatibility.
+        return {
+          "type": data.application,
+          "m.call.intent": data["m.call.intent"]
+        };
+    }
+  }
+
+  /** @deprecated scope is not used and will be removed in future versions. replaced by application specific types.*/
+  get scope() {
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        return undefined;
+      case MembershipKind.Session:
+      default:
+        return data.scope;
+    }
+  }
+
+  /**
+   * This computes the membership ID for the membership.
+   * For the sticky event based rtcSessionData this is trivial it is `member.id`.
+   * This is not supposed to be used to identity on an rtc backend. This is just a nouance for
+   * a generated (sha256) anonymised identity. Only send `rtcBackendIdentity` to any rtc backend service.
+   *
+   * For the legacy sessionMemberEvents it is a bit more complex. Here we sometimes do not have this data
+   * in the event content and we expected the SFU and the client to use `${this.matrixEventData.sender}:${data.device_id}`.
+   *
+   * So if there is no membershipID we use the hard coded jwt id default (`${this.matrixEventData.sender}:${data.device_id}`)
+   * value (used until version 0.16.0)
+   *
+   * It is also possible for a session event to set a custom membershipID. in that case this will be used.
+   */
+  get memberId() {
+    var _data$membershipID;
+    // the createdTs behaves equivalent to the membershipID.
+    // we only need the field for the legacy member events where we needed to update them
+    // synapse ignores sending state events if they have the same content.
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case "rtc":
+        return data.member.id;
+      case "session":
+        return (// best case we have a client already publishing the right custom membershipId
+          (_data$membershipID = data.membershipID) !== null && _data$membershipID !== void 0 ? _data$membershipID : // alternativly we use the hard coded jwt id defuatl value (used until version 0.16.0)
+          "".concat(this.matrixEventData.sender, ":").concat(data.device_id)
+        );
+      default:
+        throw Error("Not possible to get memberID without knowing the membership event kind");
+    }
+  }
+
+  /**
+   * @deprecated renamed to `memberId`
+   */
+  get membershipID() {
+    return this.memberId;
+  }
+  createdTs() {
+    var _data$created_ts;
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        // TODO we need to read the referenced (relation) event if available to get the real created_ts
+        return this.matrixEvent.getTs();
+      case MembershipKind.Session:
+      default:
+        return (_data$created_ts = data.created_ts) !== null && _data$created_ts !== void 0 ? _data$created_ts : this.matrixEvent.getTs();
+    }
+  }
+
+  /**
+   * Gets the absolute expiry timestamp of the membership.
+   * @returns The absolute expiry time of the membership as a unix timestamp in milliseconds or undefined if not applicable
+   */
+  getAbsoluteExpiry() {
+    var _data$expires;
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        return undefined;
+      case MembershipKind.Session:
+      default:
+        // TODO: calculate this from the BriijRTCSession join configuration directly
+        return this.createdTs() + ((_data$expires = data.expires) !== null && _data$expires !== void 0 ? _data$expires : DEFAULT_EXPIRE_DURATION);
+    }
+  }
+
+  /**
+   * @returns The number of milliseconds until the membership expires or undefined if applicable
+   * @deprecated Not used by RTC events.
+   */
+  getMsUntilExpiry() {
+    var {
+      kind
+    } = this.membershipData;
+    if (kind === MembershipKind.Session) {
+      var absExpiry = this.getAbsoluteExpiry();
+      if (absExpiry) {
+        // Assume that local clock is sufficiently in sync with other clocks in the distributed system.
+        // We used to try and adjust for the local clock being skewed, but there are cases where this is not accurate.
+        // The current implementation allows for the local clock to be -infinity to +BriijRTCSession.MEMBERSHIP_EXPIRY_TIME/2
+        return absExpiry - Date.now();
+      }
+    }
+    return undefined;
+  }
+
+  /**
+   * @returns true if the membership has expired, otherwise false
+   */
+  isExpired() {
+    var {
+      kind
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        return false;
+      case MembershipKind.Session:
+      default:
+        return this.getMsUntilExpiry() <= 0;
+    }
+  }
+
+  /**
+   * ## RTC Membership
+   * Gets the primary transport to use for this RTC membership (m.rtc.member).
+   * This will return the primary transport that is used by this call membership to publish their media.
+   * Directly relates to the `rtc_transports` field.
+   *
+   * ## Legacy session membership
+   * In case of a legacy session membership (m.call.member) this will return the selected transport where
+   * media is published. How this selection happens depends on the `focus_active` field of the session membership.
+   * If the `focus_selection` is `oldest_membership` this will return the transport of the oldest membership
+   * in the room (based on the `created_ts` field of the session membership).
+   * If the `focus_selection` is `multi_sfu` it will return the first transport of the `foci_preferred` list.
+   * (`multi_sfu` is equivalent to how `m.rtc.member` `rtc_transports` work).
+   * @param oldestMembership For backwards compatibility with session membership (legacy). Unused in case of RTC membership.
+   * Always required to make the consumer not care if it deals with RTC or session memberships.
+   * @returns The transport this membership uses to publish media or undefined if no transport is available.
+   */
+  getTransport(oldestMembership) {
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        return data.rtc_transports[0];
+      case MembershipKind.Session:
+        switch (data.focus_active.focus_selection) {
+          case "oldest_membership":
+            if (CallMembership.equal(this, oldestMembership)) return data.foci_preferred[0];
+            if (oldestMembership !== undefined) return oldestMembership.getTransport(oldestMembership);
+            break;
+          case "multi_sfu":
+            return data.foci_preferred[0];
+          default:
+            // `focus_selection` not understood.
+            return undefined;
+        }
+        break;
+      default:
+        return undefined;
+    }
+  }
+
+  /**
+   * The value of the `rtc_transports` field for RTC memberships (m.rtc.member).
+   * Or the value of the `foci_preferred` field for legacy session memberships (m.call.member).
+   */
+  get transports() {
+    var {
+      kind,
+      data
+    } = this.membershipData;
+    switch (kind) {
+      case MembershipKind.RTC:
+        return data.rtc_transports;
+      case MembershipKind.Session:
+      default:
+        return data.foci_preferred;
+    }
+  }
+}
+//# sourceMappingURL=CallMembership.js.map

package/lib/matrixrtc/CallMembership.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CallMembership.js","names":["deepCompare","logger","computeSlotId","slotIdToDescription","checkRtcMembershipData","computeRtcIdentityRaw","checkSessionsMembershipData","BriijRTCMembershipParseError","EventType","DEFAULT_EXPIRE_DURATION","MembershipKind","CallMembership","membershipDataFromBriijEvent","matrixEvent","sender","getSender","evType","getType","data","getContent","undefined","Error","RTCMembership","kind","RTC","GroupCallMemberPrefix","Session","concat","ex","debug","parseFromEvent","_this","_asyncToGenerator","membershipData","rtcBackendIdentity","member","user_id","device_id","id","equal","a","b","constructor","_defineProperty","eventId","getId","getChild","deviceId","matrixEventData","userId","slotId","_this$logger2","application","slot_id","call_id","compatibilityAdaptedId","_this$logger","info","callIntent","intent","applicationData","warn","slotDescription","slice","type","length","scope","memberId","_data$membershipID","membershipID","createdTs","_data$created_ts","getTs","created_ts","getAbsoluteExpiry","_data$expires","expires","getMsUntilExpiry","absExpiry","Date","now","isExpired","getTransport","oldestMembership","rtc_transports","focus_active","focus_selection","foci_preferred","transports"],"sources":["../../src/matrixrtc/CallMembership.ts"],"sourcesContent":["/*\nCopyright 2023-2026 The Matrix.org Foundation C.I.C.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n*/\n\nimport { deepCompare } from \"../utils.ts\";\nimport { type RTCCallIntent, type Transport, type SlotDescription } from \"./types.ts\";\nimport { type BriijEvent } from \"../models/event.ts\";\nimport { type Logger, logger } from \"../logger.ts\";\nimport { computeSlotId, slotIdToDescription } from \"./utils.ts\";\nimport {\n    checkRtcMembershipData,\n    computeRtcIdentityRaw,\n    type RtcMembershipData,\n    checkSessionsMembershipData,\n    type SessionMembershipData,\n    BriijRTCMembershipParseError,\n} from \"./membershipData/index.ts\";\nimport { EventType } from \"../@types/event.ts\";\n\n/**\n * The default duration in milliseconds that a membership is considered valid for.\n * Ordinarily the client responsible for the session will update the membership before it expires.\n * We use this duration as the fallback case where stale sessions are present for some reason.\n */\nexport const DEFAULT_EXPIRE_DURATION = 1000 * 60 * 60 * 4;\n\n/**\n * Describes the source event type that provided the membership data.\n */\nenum MembershipKind {\n    /**\n     * The modern MSC4143 format event.\n     */\n    RTC = \"rtc\",\n    /**\n     * The legacy call event type.\n     */\n    Session = \"session\",\n}\n\ntype MembershipData =\n    | { kind: MembershipKind.RTC; data: RtcMembershipData }\n    | { kind: MembershipKind.Session; data: SessionMembershipData };\n\ntype LimitedEvent = Pick<BriijEvent, \"getId\" | \"getSender\" | \"getTs\" | \"getType\" | \"getContent\">;\n// TODO: Rename to RtcMembership once we removed the legacy SessionMembership is removed, to avoid confusion.\nexport class CallMembership {\n    /**\n     * Parse the membershipdata from a call membership event.\n     * @param matrixEvent The Matrix event to read.\n     * @returns MembershipData in either MembershipKind.RTC or MembershipKind.Session format.\n     * @throws If the content is neither format.\n     */\n    public static membershipDataFromBriijEvent(matrixEvent: LimitedEvent): MembershipData {\n        const sender = matrixEvent.getSender();\n        const evType = matrixEvent.getType();\n        const data = matrixEvent.getContent();\n        if (sender === undefined) throw new Error(\"matrixEvent is missing sender field\");\n        try {\n            // Event types are strictly checked here.\n            if (evType === EventType.RTCMembership && checkRtcMembershipData(data, sender)) {\n                return { kind: MembershipKind.RTC, data };\n            } else if (evType === EventType.GroupCallMemberPrefix && checkSessionsMembershipData(data)) {\n                return { kind: MembershipKind.Session, data };\n            } else {\n                throw Error(`'${evType} is not a known call membership type`);\n            }\n        } catch (ex) {\n            if (ex instanceof BriijRTCMembershipParseError) {\n                logger.debug(\"CallMembership.BriijRTCMembershipParseError provided invalid data\", data);\n            }\n            throw ex;\n        }\n    }\n\n    /**\n     * Parse the contents of a BriijEvent and create a CallMembership instance.\n     * @param matrixEvent The Matrix event to read.\n     */\n    public static async parseFromEvent(matrixEvent: LimitedEvent): Promise<CallMembership> {\n        const membershipData: MembershipData = this.membershipDataFromBriijEvent(matrixEvent);\n        const rtcBackendIdentity =\n            membershipData.kind === MembershipKind.RTC\n                ? await computeRtcIdentityRaw(\n                      membershipData.data.member.user_id,\n                      membershipData.data.member.device_id,\n                      membershipData.data.member.id,\n                  )\n                : `${matrixEvent.getSender()}:${membershipData.data.device_id}`;\n        return new CallMembership(matrixEvent, membershipData, rtcBackendIdentity);\n    }\n\n    public static equal(a?: CallMembership, b?: CallMembership): boolean {\n        return deepCompare(a?.membershipData, b?.membershipData);\n    }\n\n    private logger: Logger;\n\n    /** The parsed data from the Matrix event.\n     * To access checked eventId and sender from the matrixEvent.\n     * Class construction will fail if these values cannot get obtained. */\n    private readonly matrixEventData: { eventId: string; sender: string };\n\n    /**\n     * Use `parseFromEvent`.\n     * Constructor should only be used by tests.\n     * @private\n     * @param matrixEvent\n     * @param membershipData\n     * @param rtcBackendIdentity\n     */\n    public constructor(\n        /** The Matrix event that this membership is based on */\n        private readonly matrixEvent: LimitedEvent,\n        private readonly membershipData: MembershipData,\n        public readonly rtcBackendIdentity: string,\n    ) {\n        const eventId = matrixEvent.getId();\n        const sender = matrixEvent.getSender();\n\n        if (eventId === undefined) throw new Error(\"parentEvent is missing eventId field\");\n        if (sender === undefined) throw new Error(\"parentEvent is missing sender field\");\n\n        this.logger = logger.getChild(`[CallMembership ${sender}:${this.deviceId}]`);\n        this.matrixEventData = { eventId, sender };\n    }\n\n    /** @deprecated use userId instead */\n    public get sender(): string {\n        return this.userId;\n    }\n\n    public get userId(): string {\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                return data.member.user_id;\n            case MembershipKind.Session:\n            default:\n                return this.matrixEventData.sender;\n        }\n    }\n\n    public get eventId(): string {\n        return this.matrixEventData.eventId;\n    }\n\n    /**\n     * The ID of the MatrixRTC slot that this membership belongs to (format `{application}#{id}`).\n     * This is computed in case SessionMembershipData is used.\n     */\n    public get slotId(): string {\n        const { kind, data } = this.membershipData;\n        if (data.application === \"m.call\") {\n            switch (kind) {\n                case MembershipKind.RTC:\n                    return data.slot_id;\n                case MembershipKind.Session:\n                default: {\n                    const [application, id] = [data.application, data.call_id];\n\n                    // INFO_SLOT_ID_LEGACY_CASE  (search for all occurances of this INFO to get the full picture)\n                    // The spec got changed to use `\"ROOM\"` instead of `\"\"` empyt string for the implicit default call.\n                    // State events still are sent with `\"\"` however. To find other events that should end up in the same call,\n                    // we use the slotId.\n                    // Since the CallMembership is the public representation of a rtc.member event, we just pretend it is a\n                    // \"ROOM\" slotId/call_id.\n                    // This makes all the remote members work with just this simple trick.\n                    //\n                    // We of course now need to be careful when sending legacy events (state events)\n                    // They get a slotDescription containing \"ROOM\" since this is what we use starting at the time this comment\n                    // is commited.\n                    //\n                    // See the Other INFO_SLOT_ID_LEGACY_CASE comments to see where we revert back to \"\" just before sending the event.\n                    let compatibilityAdaptedId: string;\n                    if (id === \"\") {\n                        compatibilityAdaptedId = \"ROOM\";\n                        this.logger?.info(\"use slotId compat hack emptyString -> ROOM\");\n                    } else {\n                        compatibilityAdaptedId = id;\n                    }\n                    return computeSlotId({\n                        application,\n                        id: compatibilityAdaptedId,\n                    });\n                }\n            }\n        }\n\n        this.logger?.info(\"NOT using slotId compat hack emptyString -> ROOM\");\n        // This is what the function should look like for any other application that did not\n        // go through a `\"\"`=> `\"ROOM\"` rename\n        switch (kind) {\n            case MembershipKind.RTC:\n                return data.slot_id;\n            case MembershipKind.Session:\n            default:\n                return computeSlotId({ application: data.application, id: data.call_id });\n        }\n    }\n\n    public get deviceId(): string {\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                return data.member.device_id;\n            case MembershipKind.Session:\n            default:\n                return data.device_id;\n        }\n    }\n\n    public get callIntent(): RTCCallIntent | undefined {\n        const intent = this.applicationData[\"m.call.intent\"];\n        if (typeof intent === \"string\") {\n            return intent;\n        }\n        this.logger.warn(\"RTC membership has invalid m.call.intent\");\n        return undefined;\n    }\n\n    /**\n     * Parsed `slot_id` (format `{application}#{id}`) into its components (application and id).\n     */\n    public get slotDescription(): SlotDescription {\n        const { kind, data } = this.membershipData;\n        if (kind === MembershipKind.RTC) {\n            const id = data.slot_id.slice(`${data.application.type}#`.length);\n            return { application: data.application.type, id };\n        }\n        return slotIdToDescription(this.slotId);\n    }\n\n    /**\n     * The application `type`.\n     * @deprecated Use @see applicationData\n     */\n    public get application(): string {\n        return this.applicationData.type;\n    }\n\n    /**\n     * Information about the application being used for the RTC session.\n     * May contain extra keys specific to the application.\n     */\n    public get applicationData(): { type: string; [key: string]: unknown } {\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                return data.application;\n            case MembershipKind.Session:\n            default:\n                // SessionData does not have application data as such. We return specific\n                // properties in use by other getters in this class, for compatibility.\n                return { \"type\": data.application, \"m.call.intent\": data[\"m.call.intent\"] };\n        }\n    }\n\n    /** @deprecated scope is not used and will be removed in future versions. replaced by application specific types.*/\n    public get scope(): SessionMembershipData[\"scope\"] | undefined {\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                return undefined;\n            case MembershipKind.Session:\n            default:\n                return data.scope;\n        }\n    }\n\n    /**\n     * This computes the membership ID for the membership.\n     * For the sticky event based rtcSessionData this is trivial it is `member.id`.\n     * This is not supposed to be used to identity on an rtc backend. This is just a nouance for\n     * a generated (sha256) anonymised identity. Only send `rtcBackendIdentity` to any rtc backend service.\n     *\n     * For the legacy sessionMemberEvents it is a bit more complex. Here we sometimes do not have this data\n     * in the event content and we expected the SFU and the client to use `${this.matrixEventData.sender}:${data.device_id}`.\n     *\n     * So if there is no membershipID we use the hard coded jwt id default (`${this.matrixEventData.sender}:${data.device_id}`)\n     * value (used until version 0.16.0)\n     *\n     * It is also possible for a session event to set a custom membershipID. in that case this will be used.\n     */\n    public get memberId(): string {\n        // the createdTs behaves equivalent to the membershipID.\n        // we only need the field for the legacy member events where we needed to update them\n        // synapse ignores sending state events if they have the same content.\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case \"rtc\":\n                return data.member.id;\n            case \"session\":\n                return (\n                    // best case we have a client already publishing the right custom membershipId\n                    data.membershipID ??\n                    // alternativly we use the hard coded jwt id defuatl value (used until version 0.16.0)\n                    `${this.matrixEventData.sender}:${data.device_id}`\n                );\n            default:\n                throw Error(\"Not possible to get memberID without knowing the membership event kind\");\n        }\n    }\n\n    /**\n     * @deprecated renamed to `memberId`\n     */\n    public get membershipID(): string {\n        return this.memberId;\n    }\n\n    public createdTs(): number {\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                // TODO we need to read the referenced (relation) event if available to get the real created_ts\n                return this.matrixEvent.getTs();\n            case MembershipKind.Session:\n            default:\n                return data.created_ts ?? this.matrixEvent.getTs();\n        }\n    }\n\n    /**\n     * Gets the absolute expiry timestamp of the membership.\n     * @returns The absolute expiry time of the membership as a unix timestamp in milliseconds or undefined if not applicable\n     */\n    public getAbsoluteExpiry(): number | undefined {\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                return undefined;\n            case MembershipKind.Session:\n            default:\n                // TODO: calculate this from the BriijRTCSession join configuration directly\n                return this.createdTs() + (data.expires ?? DEFAULT_EXPIRE_DURATION);\n        }\n    }\n\n    /**\n     * @returns The number of milliseconds until the membership expires or undefined if applicable\n     * @deprecated Not used by RTC events.\n     */\n    public getMsUntilExpiry(): number | undefined {\n        const { kind } = this.membershipData;\n        if (kind === MembershipKind.Session) {\n            const absExpiry = this.getAbsoluteExpiry();\n            if (absExpiry) {\n                // Assume that local clock is sufficiently in sync with other clocks in the distributed system.\n                // We used to try and adjust for the local clock being skewed, but there are cases where this is not accurate.\n                // The current implementation allows for the local clock to be -infinity to +BriijRTCSession.MEMBERSHIP_EXPIRY_TIME/2\n                return absExpiry - Date.now();\n            }\n        }\n        return undefined;\n    }\n\n    /**\n     * @returns true if the membership has expired, otherwise false\n     */\n    public isExpired(): boolean {\n        const { kind } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                return false;\n            case MembershipKind.Session:\n            default:\n                return this.getMsUntilExpiry()! <= 0;\n        }\n    }\n\n    /**\n     * ## RTC Membership\n     * Gets the primary transport to use for this RTC membership (m.rtc.member).\n     * This will return the primary transport that is used by this call membership to publish their media.\n     * Directly relates to the `rtc_transports` field.\n     *\n     * ## Legacy session membership\n     * In case of a legacy session membership (m.call.member) this will return the selected transport where\n     * media is published. How this selection happens depends on the `focus_active` field of the session membership.\n     * If the `focus_selection` is `oldest_membership` this will return the transport of the oldest membership\n     * in the room (based on the `created_ts` field of the session membership).\n     * If the `focus_selection` is `multi_sfu` it will return the first transport of the `foci_preferred` list.\n     * (`multi_sfu` is equivalent to how `m.rtc.member` `rtc_transports` work).\n     * @param oldestMembership For backwards compatibility with session membership (legacy). Unused in case of RTC membership.\n     * Always required to make the consumer not care if it deals with RTC or session memberships.\n     * @returns The transport this membership uses to publish media or undefined if no transport is available.\n     */\n    public getTransport(oldestMembership: CallMembership): Transport | undefined {\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                return data.rtc_transports[0];\n            case MembershipKind.Session:\n                switch (data.focus_active.focus_selection) {\n                    case \"oldest_membership\":\n                        if (CallMembership.equal(this, oldestMembership)) return data.foci_preferred[0];\n                        if (oldestMembership !== undefined) return oldestMembership.getTransport(oldestMembership);\n                        break;\n                    case \"multi_sfu\":\n                        return data.foci_preferred[0];\n                    default:\n                        // `focus_selection` not understood.\n                        return undefined;\n                }\n                break;\n            default:\n                return undefined;\n        }\n    }\n\n    /**\n     * The value of the `rtc_transports` field for RTC memberships (m.rtc.member).\n     * Or the value of the `foci_preferred` field for legacy session memberships (m.call.member).\n     */\n    public get transports(): Transport[] {\n        const { kind, data } = this.membershipData;\n        switch (kind) {\n            case MembershipKind.RTC:\n                return data.rtc_transports;\n            case MembershipKind.Session:\n            default:\n                return data.foci_preferred;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/matrixrtc/EncryptionManager.d.ts

@@ -0,0 +1,44 @@
+import { type EncryptionConfig } from "./MatrixRTCSession.ts";
+import { type CallMembership } from "./CallMembership.ts";
+import { type EncryptionKeyMapKey } from "./types.ts";
+/**
+ * The string used for the keys in the the encryption key map.
+ * `@bob:examle.org:DEVICEID(UUIDRANDOM_MEMBERID_RANDOMUUID)`
+ */
+export declare function getEncryptionKeyMapKey(membership: CallMembershipIdentityParts): EncryptionKeyMapKey;
+/**
+ * This interface is for testing and for making it possible to interchange the encryption manager.
+ * @internal
+ */
+export interface IEncryptionManager {
+    /**
+     * Joins the encryption manager with the provided configuration.
+     *
+     * @param joinConfig - The configuration for joining encryption, or undefined
+     * if no specific configuration is provided.
+     */
+    join(joinConfig: EncryptionConfig | undefined): void;
+    /**
+     * Leaves the encryption manager, cleaning up any associated resources.
+     */
+    leave(): void;
+    /**
+     * Called from the BriijRTCSession when the memberships in this session updated.
+     *
+     * @param oldMemberships - The previous state of call memberships before the update.
+     */
+    onMembershipsUpdate(oldMemberships: CallMembership[]): void;
+    /**
+     * Retrieves the encryption keys currently managed by the encryption manager.
+     *
+     * @returns A map of participant IDs to their encryption keys.
+     */
+    getEncryptionKeys(): ReadonlyMap<EncryptionKeyMapKey, ReadonlyArray<{
+        key: Uint8Array<ArrayBuffer>;
+        keyIndex: number;
+        membership: CallMembershipIdentityParts;
+        rtcBackendIdentity: string;
+    }>>;
+}
+export type CallMembershipIdentityParts = Pick<CallMembership, "userId" | "deviceId" | "memberId">;
+//# sourceMappingURL=EncryptionManager.d.ts.map

package/lib/matrixrtc/EncryptionManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncryptionManager.d.ts","sourceRoot":"","sources":["../../src/matrixrtc/EncryptionManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,2BAA2B,GAAG,mBAAmB,CAEnG;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAC/B;;;;;OAKG;IACH,IAAI,CAAC,UAAU,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAAC;IAErD;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IAEd;;;;OAIG;IACH,mBAAmB,CAAC,cAAc,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAE5D;;;;OAIG;IACH,iBAAiB,IAAI,WAAW,CAC5B,mBAAmB,EACnB,aAAa,CAAC;QACV,GAAG,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;QAC7B,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,2BAA2B,CAAC;QACxC,kBAAkB,EAAE,MAAM,CAAC;KAC9B,CAAC,CACL,CAAC;CACL;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC,CAAC"}

package/lib/matrixrtc/EncryptionManager.js

@@ -0,0 +1,13 @@
+/**
+ * The string used for the keys in the the encryption key map.
+ * `@bob:examle.org:DEVICEID(UUIDRANDOM_MEMBERID_RANDOMUUID)`
+ */
+export function getEncryptionKeyMapKey(membership) {
+  return "".concat(membership.userId, ":").concat(membership.deviceId, "(").concat(membership.memberId, ")");
+}
+
+/**
+ * This interface is for testing and for making it possible to interchange the encryption manager.
+ * @internal
+ */
+//# sourceMappingURL=EncryptionManager.js.map

package/lib/matrixrtc/EncryptionManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EncryptionManager.js","names":["getEncryptionKeyMapKey","membership","concat","userId","deviceId","memberId"],"sources":["../../src/matrixrtc/EncryptionManager.ts"],"sourcesContent":["import { type EncryptionConfig } from \"./MatrixRTCSession.ts\";\nimport { type CallMembership } from \"./CallMembership.ts\";\nimport { type EncryptionKeyMapKey } from \"./types.ts\";\n\n/**\n * The string used for the keys in the the encryption key map.\n * `@bob:examle.org:DEVICEID(UUIDRANDOM_MEMBERID_RANDOMUUID)`\n */\nexport function getEncryptionKeyMapKey(membership: CallMembershipIdentityParts): EncryptionKeyMapKey {\n    return `${membership.userId}:${membership.deviceId}(${membership.memberId})`;\n}\n\n/**\n * This interface is for testing and for making it possible to interchange the encryption manager.\n * @internal\n */\nexport interface IEncryptionManager {\n    /**\n     * Joins the encryption manager with the provided configuration.\n     *\n     * @param joinConfig - The configuration for joining encryption, or undefined\n     * if no specific configuration is provided.\n     */\n    join(joinConfig: EncryptionConfig | undefined): void;\n\n    /**\n     * Leaves the encryption manager, cleaning up any associated resources.\n     */\n    leave(): void;\n\n    /**\n     * Called from the BriijRTCSession when the memberships in this session updated.\n     *\n     * @param oldMemberships - The previous state of call memberships before the update.\n     */\n    onMembershipsUpdate(oldMemberships: CallMembership[]): void;\n\n    /**\n     * Retrieves the encryption keys currently managed by the encryption manager.\n     *\n     * @returns A map of participant IDs to their encryption keys.\n     */\n    getEncryptionKeys(): ReadonlyMap<\n        EncryptionKeyMapKey,\n        ReadonlyArray<{\n            key: Uint8Array<ArrayBuffer>;\n            keyIndex: number;\n            membership: CallMembershipIdentityParts;\n            rtcBackendIdentity: string;\n        }>\n    >;\n}\n\nexport type CallMembershipIdentityParts = Pick<CallMembership, \"userId\" | \"deviceId\" | \"memberId\">;\n"],"mappings":"AAIA;AACA;AACA;AACA;AACA,OAAO,SAASA,sBAAsBA,CAACC,UAAuC,EAAuB;EACjG,UAAAC,MAAA,CAAUD,UAAU,CAACE,MAAM,OAAAD,MAAA,CAAID,UAAU,CAACG,QAAQ,OAAAF,MAAA,CAAID,UAAU,CAACI,QAAQ;AAC7E;;AAEA;AACA;AACA;AACA","ignoreList":[]}

package/lib/matrixrtc/IKeyTransport.d.ts

@@ -0,0 +1,37 @@
+import { type CallMembershipIdentityParts } from "./EncryptionManager.ts";
+import { type ParticipantDeviceInfo } from "./types.ts";
+export declare enum KeyTransportEvents {
+    ReceivedKeys = "received_keys",
+    NotSupportedError = "not_supported_error"
+}
+export type KeyTransportEventsHandlerMap = {
+    [KeyTransportEvents.ReceivedKeys]: KeyTransportEventListener;
+    [KeyTransportEvents.NotSupportedError]: () => void;
+};
+export type KeyTransportEventListener = (membership: CallMembershipIdentityParts, keyBase64Encoded: string, index: number, timestamp: number) => void;
+/**
+ * Generic interface for the transport used to share room keys.
+ * Keys can be shared using different transports, e.g. to-device messages or room messages.
+ */
+export interface IKeyTransport {
+    /**
+     * Sends the current user media key to the given members.
+     * @param keyBase64Encoded
+     * @param index
+     * @param members - The participants that should get they key
+     */
+    sendKey(keyBase64Encoded: string, index: number, members: ParticipantDeviceInfo[]): Promise<void>;
+    /** Subscribe to keys from this transport. */
+    on(event: KeyTransportEvents.ReceivedKeys, listener: KeyTransportEventListener): this;
+    /** Unsubscribe from keys from this transport. */
+    off(event: KeyTransportEvents.ReceivedKeys, listener: KeyTransportEventListener): this;
+    /** Once start is called the underlying transport will subscribe to its transport system.
+     * Before start is called this transport will not emit any events.
+     */
+    start(): void;
+    /** Once stop is called the underlying transport will unsubscribe from its transport system.
+     * After stop is called this transport will not emit any events.
+     */
+    stop(): void;
+}
+//# sourceMappingURL=IKeyTransport.d.ts.map

package/lib/matrixrtc/IKeyTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IKeyTransport.d.ts","sourceRoot":"","sources":["../../src/matrixrtc/IKeyTransport.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,EAAE,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,oBAAY,kBAAkB;IAC1B,YAAY,kBAAkB;IAC9B,iBAAiB,wBAAwB;CAC5C;AAED,MAAM,MAAM,4BAA4B,GAAG;IACvC,CAAC,kBAAkB,CAAC,YAAY,CAAC,EAAE,yBAAyB,CAAC;IAC7D,CAAC,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,MAAM,IAAI,CAAC;CACtD,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG,CACpC,UAAU,EAAE,2BAA2B,EACvC,gBAAgB,EAAE,MAAM,EACxB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,KAChB,IAAI,CAAC;AAEV;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B;;;;;OAKG;IACH,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElG,6CAA6C;IAC7C,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,YAAY,EAAE,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACtF,iDAAiD;IACjD,GAAG,CAAC,KAAK,EAAE,kBAAkB,CAAC,YAAY,EAAE,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAAC;IAEvF;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;IACd;;OAEG;IACH,IAAI,IAAI,IAAI,CAAC;CAChB"}