@textrp/briij-js-sdk 41.0.0

package/lib/matrixrtc/types.d.ts

@@ -0,0 +1,169 @@
+import type { IContent, IMentions } from "../briij.ts";
+import type { RelationEvent } from "../types.ts";
+import type { CallMembership } from "./CallMembership.ts";
+import { type CallMembershipIdentityParts } from "./EncryptionManager.ts";
+export type EncryptionKeyMapKey = string;
+export interface EncryptionKeyEntry {
+    index: number;
+    key: string;
+}
+/**
+ * The mxID, deviceId and membership timestamp of a RTC session participant.
+ */
+export type ParticipantDeviceInfo = {
+    userId: string;
+    deviceId: string;
+    membershipTs: number;
+};
+/**
+ * A type representing the information needed to decrypt video streams.
+ */
+export type InboundEncryptionSession = {
+    key: Uint8Array<ArrayBuffer>;
+    membership: CallMembershipIdentityParts;
+    keyIndex: number;
+    creationTS: number;
+};
+/**
+ * The information about the key used to encrypt video streams.
+ */
+export type OutboundEncryptionSession = {
+    key: Uint8Array<ArrayBuffer>;
+    creationTS: number;
+    sharedWith: Array<ParticipantDeviceInfo>;
+    keyId: number;
+};
+export interface EncryptionKeysEventContent {
+    keys: EncryptionKeyEntry[];
+    device_id: string;
+    call_id: string;
+    sent_ts?: number;
+}
+/**
+ * THe content of a to-device event that contains encryption keys.
+ */
+export interface EncryptionKeysToDeviceEventContent {
+    keys: {
+        index: number;
+        key: string;
+    };
+    member: {
+        id: string;
+        claimed_device_id: string;
+    };
+    room_id: string;
+    session: {
+        application: string;
+        call_id: string;
+        scope: string;
+    };
+    sent_ts?: number;
+}
+/**
+ * @deprecated Use `RTCNotificationType` instead.
+ */
+export type CallNotifyType = "ring" | "notify";
+/**
+ * @deprecated Use `IRTCNotificationContent` instead.
+ */
+export interface ICallNotifyContent {
+    "application": string;
+    "m.mentions": IMentions;
+    "notify_type": CallNotifyType;
+    "call_id": string;
+}
+export type RTCNotificationType = "ring" | "notification";
+/**
+ * Represents the intention of the call from the perspective of the sending user.
+ * May be any string, although `"audio"` and `"video"` are commonly accepted values.
+ */
+export type RTCCallIntent = "audio" | "video" | string;
+/**
+ * This will check if the content has all the expected fields to be a valid IRTCNotificationContent.
+ * It will also cap the lifetime to 90000ms (1.5 min) if a higher value is provided.
+ * @param content
+ * @throws if the content is invalid
+ * @returns a parsed IRTCNotificationContent
+ */
+export declare function parseCallNotificationContent(content: IContent): IRTCNotificationContent;
+/**
+ * Interface for `org.matrix.msc4075.rtc.notification` events.
+ * Don't cast event content to this directly. Use `parseCallNotificationContent` instead to validate the content first.
+ */
+export interface IRTCNotificationContent extends RelationEvent {
+    "m.mentions"?: IMentions;
+    "notification_type": RTCNotificationType;
+    /**
+     * The initial intent of the calling user.
+     */
+    "m.call.intent"?: RTCCallIntent;
+    "sender_ts": number;
+    "lifetime": number;
+}
+/**
+ * MSC4310 decline event content for `org.matrix.msc4310.rtc.decline`.
+ * Sent as a standard m.reference relation to an `org.matrix.msc4075.rtc.notification` event.
+ */
+export interface IRTCDeclineContent extends RelationEvent {
+}
+export declare enum Status {
+    Disconnected = "Disconnected",
+    Connecting = "Connecting",
+    Connected = "Connected",
+    Disconnecting = "Disconnecting",
+    Unknown = "Unknown"
+}
+/**
+ * A type collecting call encryption statistics for a session.
+ */
+export type Statistics = {
+    counters: {
+        /**
+         * The number of times we have sent a room event containing encryption keys.
+         */
+        roomEventEncryptionKeysSent: number;
+        /**
+         * The number of times we have received a room event containing encryption keys.
+         */
+        roomEventEncryptionKeysReceived: number;
+    };
+    totals: {
+        /**
+         * The total age (in milliseconds) of all room events containing encryption keys that we have received.
+         * We track the total age so that we can later calculate the average age of all keys received.
+         */
+        roomEventEncryptionKeysReceivedTotalAge: number;
+    };
+};
+export declare const isMyMembership: (m: CallMembership, userId: string, deviceId: string) => boolean;
+/**
+ *  A RTC transport is a JSON object that describes how to connect to a RTC member.
+ */
+export interface Transport {
+    type: string;
+    [key: string]: unknown;
+}
+/**
+ * Event content for a `m.rtc.slot` state event.
+ */
+export interface RtcSlotEventContent<T extends string = string> {
+    application: {
+        type: T;
+        [key: string]: unknown;
+    };
+    slot_id: string;
+}
+/**
+ * The session description is used to identify a session. Used in the state event.
+ */
+export interface SlotDescription {
+    /**
+     * The application type. e.g. "m.call".
+     */
+    application: string;
+    /**
+     * The application-specific slot ID. e.g. "ROOM".
+     */
+    id: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/lib/matrixrtc/types.js

@@ -0,0 +1,117 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/*
+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.
+*/
+
+/**
+ * The mxID, deviceId and membership timestamp of a RTC session participant.
+ */
+
+/**
+ * A type representing the information needed to decrypt video streams.
+ */
+
+/**
+ * The information about the key used to encrypt video streams.
+ */
+
+/**
+ * THe content of a to-device event that contains encryption keys.
+ */
+
+/**
+ * @deprecated Use `RTCNotificationType` instead.
+ */
+
+/**
+ * @deprecated Use `IRTCNotificationContent` instead.
+ */
+
+/**
+ * Represents the intention of the call from the perspective of the sending user.
+ * May be any string, although `"audio"` and `"video"` are commonly accepted values.
+ */
+
+/**
+ * This will check if the content has all the expected fields to be a valid IRTCNotificationContent.
+ * It will also cap the lifetime to 90000ms (1.5 min) if a higher value is provided.
+ * @param content
+ * @throws if the content is invalid
+ * @returns a parsed IRTCNotificationContent
+ */
+export function parseCallNotificationContent(content) {
+  if (content["m.mentions"] && typeof content["m.mentions"] !== "object") {
+    throw new Error("malformed m.mentions");
+  }
+  if (typeof content["notification_type"] !== "string") {
+    throw new Error("Missing or invalid notification_type");
+  }
+  if (typeof content["sender_ts"] !== "number") {
+    throw new Error("Missing or invalid sender_ts");
+  }
+  if (typeof content["lifetime"] !== "number") {
+    throw new Error("Missing or invalid lifetime");
+  }
+  if (content["relation"] && content["relation"]["rel_type"] !== "m.reference") {
+    throw new Error("Invalid relation");
+  }
+  if (content["m.call.intent"] && typeof content["m.call.intent"] !== "string") {
+    throw new Error("Invalid m.call.intent");
+  }
+  var cappedLifetime = content["lifetime"] >= 90000 ? 90000 : content["lifetime"];
+  return _objectSpread(_objectSpread({}, content), {}, {
+    lifetime: cappedLifetime
+  });
+}
+
+/**
+ * Interface for `org.matrix.msc4075.rtc.notification` events.
+ * Don't cast event content to this directly. Use `parseCallNotificationContent` instead to validate the content first.
+ */
+
+/**
+ * MSC4310 decline event content for `org.matrix.msc4310.rtc.decline`.
+ * Sent as a standard m.reference relation to an `org.matrix.msc4075.rtc.notification` event.
+ */
+
+export var Status = /*#__PURE__*/function (Status) {
+  Status["Disconnected"] = "Disconnected";
+  Status["Connecting"] = "Connecting";
+  Status["Connected"] = "Connected";
+  Status["Disconnecting"] = "Disconnecting";
+  Status["Unknown"] = "Unknown";
+  return Status;
+}({});
+
+/**
+ * A type collecting call encryption statistics for a session.
+ */
+
+export var isMyMembership = (m, userId, deviceId) => m.sender === userId && m.deviceId === deviceId;
+
+/**
+ *  A RTC transport is a JSON object that describes how to connect to a RTC member.
+ */
+
+/**
+ * Event content for a `m.rtc.slot` state event.
+ */
+
+/**
+ * The session description is used to identify a session. Used in the state event.
+ */
+//# sourceMappingURL=types.js.map

package/lib/matrixrtc/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","names":["parseCallNotificationContent","content","Error","cappedLifetime","_objectSpread","lifetime","Status","isMyMembership","m","userId","deviceId","sender"],"sources":["../../src/matrixrtc/types.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*/\nimport type { IContent, IMentions } from \"../briij.ts\";\nimport type { RelationEvent } from \"../types.ts\";\nimport type { CallMembership } from \"./CallMembership.ts\";\nimport { type CallMembershipIdentityParts } from \"./EncryptionManager.ts\";\n\nexport type EncryptionKeyMapKey = string;\n\nexport interface EncryptionKeyEntry {\n    index: number;\n    key: string;\n}\n\n/**\n * The mxID, deviceId and membership timestamp of a RTC session participant.\n */\nexport type ParticipantDeviceInfo = {\n    userId: string;\n    deviceId: string;\n    membershipTs: number;\n};\n\n/**\n * A type representing the information needed to decrypt video streams.\n */\nexport type InboundEncryptionSession = {\n    key: Uint8Array<ArrayBuffer>;\n    membership: CallMembershipIdentityParts;\n    keyIndex: number;\n    creationTS: number;\n};\n\n/**\n * The information about the key used to encrypt video streams.\n */\nexport type OutboundEncryptionSession = {\n    key: Uint8Array<ArrayBuffer>;\n    creationTS: number;\n    // The devices that this key is shared with.\n    sharedWith: Array<ParticipantDeviceInfo>;\n    // This is an index acting as the id of the key\n    keyId: number;\n};\n\nexport interface EncryptionKeysEventContent {\n    keys: EncryptionKeyEntry[];\n    device_id: string;\n    call_id: string;\n    sent_ts?: number;\n}\n\n/**\n * THe content of a to-device event that contains encryption keys.\n */\nexport interface EncryptionKeysToDeviceEventContent {\n    keys: { index: number; key: string };\n    member: {\n        id: string;\n        // TODO Remove that it is claimed, need to get the sealed sender from decryption info\n        // Or add some validation on it based on the encryption info\n        claimed_device_id: string;\n    };\n    room_id: string;\n    session: {\n        application: string;\n        call_id: string;\n        scope: string;\n    };\n    // Why is this needed?\n    sent_ts?: number;\n}\n/**\n * @deprecated Use `RTCNotificationType` instead.\n */\nexport type CallNotifyType = \"ring\" | \"notify\";\n/**\n * @deprecated Use `IRTCNotificationContent` instead.\n */\nexport interface ICallNotifyContent {\n    \"application\": string;\n    \"m.mentions\": IMentions;\n    \"notify_type\": CallNotifyType;\n    \"call_id\": string;\n}\n\nexport type RTCNotificationType = \"ring\" | \"notification\";\n\n/**\n * Represents the intention of the call from the perspective of the sending user.\n * May be any string, although `\"audio\"` and `\"video\"` are commonly accepted values.\n */\nexport type RTCCallIntent = \"audio\" | \"video\" | string;\n\n/**\n * This will check if the content has all the expected fields to be a valid IRTCNotificationContent.\n * It will also cap the lifetime to 90000ms (1.5 min) if a higher value is provided.\n * @param content\n * @throws if the content is invalid\n * @returns a parsed IRTCNotificationContent\n */\nexport function parseCallNotificationContent(content: IContent): IRTCNotificationContent {\n    if (content[\"m.mentions\"] && typeof content[\"m.mentions\"] !== \"object\") {\n        throw new Error(\"malformed m.mentions\");\n    }\n    if (typeof content[\"notification_type\"] !== \"string\") {\n        throw new Error(\"Missing or invalid notification_type\");\n    }\n    if (typeof content[\"sender_ts\"] !== \"number\") {\n        throw new Error(\"Missing or invalid sender_ts\");\n    }\n    if (typeof content[\"lifetime\"] !== \"number\") {\n        throw new Error(\"Missing or invalid lifetime\");\n    }\n\n    if (content[\"relation\"] && content[\"relation\"][\"rel_type\"] !== \"m.reference\") {\n        throw new Error(\"Invalid relation\");\n    }\n    if (content[\"m.call.intent\"] && typeof content[\"m.call.intent\"] !== \"string\") {\n        throw new Error(\"Invalid m.call.intent\");\n    }\n\n    const cappedLifetime = content[\"lifetime\"] >= 90000 ? 90000 : content[\"lifetime\"];\n    return { ...content, lifetime: cappedLifetime } as IRTCNotificationContent;\n}\n\n/**\n * Interface for `org.matrix.msc4075.rtc.notification` events.\n * Don't cast event content to this directly. Use `parseCallNotificationContent` instead to validate the content first.\n */\nexport interface IRTCNotificationContent extends RelationEvent {\n    \"m.mentions\"?: IMentions;\n    \"notification_type\": RTCNotificationType;\n    /**\n     * The initial intent of the calling user.\n     */\n    \"m.call.intent\"?: RTCCallIntent;\n    \"sender_ts\": number;\n    \"lifetime\": number;\n}\n\n/**\n * MSC4310 decline event content for `org.matrix.msc4310.rtc.decline`.\n * Sent as a standard m.reference relation to an `org.matrix.msc4075.rtc.notification` event.\n */\nexport interface IRTCDeclineContent extends RelationEvent {}\n\nexport enum Status {\n    Disconnected = \"Disconnected\",\n    Connecting = \"Connecting\",\n    Connected = \"Connected\",\n    Disconnecting = \"Disconnecting\",\n    Unknown = \"Unknown\",\n}\n\n/**\n * A type collecting call encryption statistics for a session.\n */\nexport type Statistics = {\n    counters: {\n        /**\n         * The number of times we have sent a room event containing encryption keys.\n         */\n        roomEventEncryptionKeysSent: number;\n        /**\n         * The number of times we have received a room event containing encryption keys.\n         */\n        roomEventEncryptionKeysReceived: number;\n    };\n    totals: {\n        /**\n         * The total age (in milliseconds) of all room events containing encryption keys that we have received.\n         * We track the total age so that we can later calculate the average age of all keys received.\n         */\n        roomEventEncryptionKeysReceivedTotalAge: number;\n    };\n};\n\nexport const isMyMembership = (m: CallMembership, userId: string, deviceId: string): boolean =>\n    m.sender === userId && m.deviceId === deviceId;\n\n/**\n *  A RTC transport is a JSON object that describes how to connect to a RTC member.\n */\nexport interface Transport {\n    type: string;\n    [key: string]: unknown;\n}\n\n/**\n * Event content for a `m.rtc.slot` state event.\n */\nexport interface RtcSlotEventContent<T extends string = string> {\n    application: {\n        type: T;\n        // other application specific keys\n        [key: string]: unknown;\n    };\n    slot_id: string;\n}\n\n/**\n * The session description is used to identify a session. Used in the state event.\n */\nexport interface SlotDescription {\n    /**\n     * The application type. e.g. \"m.call\".\n     */\n    application: string;\n    /**\n     * The application-specific slot ID. e.g. \"ROOM\".\n     */\n    id: string;\n}\n"],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAaA;AACA;AACA;;AAOA;AACA;AACA;;AAQA;AACA;AACA;;AAiBA;AACA;AACA;;AAkBA;AACA;AACA;;AAEA;AACA;AACA;;AAUA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,4BAA4BA,CAACC,OAAiB,EAA2B;EACrF,IAAIA,OAAO,CAAC,YAAY,CAAC,IAAI,OAAOA,OAAO,CAAC,YAAY,CAAC,KAAK,QAAQ,EAAE;IACpE,MAAM,IAAIC,KAAK,CAAC,sBAAsB,CAAC;EAC3C;EACA,IAAI,OAAOD,OAAO,CAAC,mBAAmB,CAAC,KAAK,QAAQ,EAAE;IAClD,MAAM,IAAIC,KAAK,CAAC,sCAAsC,CAAC;EAC3D;EACA,IAAI,OAAOD,OAAO,CAAC,WAAW,CAAC,KAAK,QAAQ,EAAE;IAC1C,MAAM,IAAIC,KAAK,CAAC,8BAA8B,CAAC;EACnD;EACA,IAAI,OAAOD,OAAO,CAAC,UAAU,CAAC,KAAK,QAAQ,EAAE;IACzC,MAAM,IAAIC,KAAK,CAAC,6BAA6B,CAAC;EAClD;EAEA,IAAID,OAAO,CAAC,UAAU,CAAC,IAAIA,OAAO,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,KAAK,aAAa,EAAE;IAC1E,MAAM,IAAIC,KAAK,CAAC,kBAAkB,CAAC;EACvC;EACA,IAAID,OAAO,CAAC,eAAe,CAAC,IAAI,OAAOA,OAAO,CAAC,eAAe,CAAC,KAAK,QAAQ,EAAE;IAC1E,MAAM,IAAIC,KAAK,CAAC,uBAAuB,CAAC;EAC5C;EAEA,IAAMC,cAAc,GAAGF,OAAO,CAAC,UAAU,CAAC,IAAI,KAAK,GAAG,KAAK,GAAGA,OAAO,CAAC,UAAU,CAAC;EACjF,OAAAG,aAAA,CAAAA,aAAA,KAAYH,OAAO;IAAEI,QAAQ,EAAEF;EAAc;AACjD;;AAEA;AACA;AACA;AACA;;AAYA;AACA;AACA;AACA;;AAGA,WAAYG,MAAM,0BAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAANA,MAAM;EAAA,OAANA,MAAM;AAAA;;AAQlB;AACA;AACA;;AAqBA,OAAO,IAAMC,cAAc,GAAGA,CAACC,CAAiB,EAAEC,MAAc,EAAEC,QAAgB,KAC9EF,CAAC,CAACG,MAAM,KAAKF,MAAM,IAAID,CAAC,CAACE,QAAQ,KAAKA,QAAQ;;AAElD;AACA;AACA;;AAMA;AACA;AACA;;AAUA;AACA;AACA","ignoreList":[]}

package/lib/matrixrtc/utils.d.ts

@@ -0,0 +1,27 @@
+import { type CallMembershipIdentityParts } from "./EncryptionManager.ts";
+import type { InboundEncryptionSession, SlotDescription } from "./types.ts";
+/**
+ * Detects when a key for a given index is outdated.
+ */
+export declare class OutdatedKeyFilter {
+    private tsBuffer;
+    constructor();
+    /**
+     * Check if there is a recent key with the same keyId (index) and then use the creationTS to decide what to
+     * do with the key. If the key received is older than the one already in the buffer, it is ignored.
+     * @param participantId
+     * @param item
+     */
+    isOutdated(membership: CallMembershipIdentityParts, item: InboundEncryptionSession): boolean;
+}
+/**
+ * Converts a slot ID into it's component application and ID portions.
+ * @param slotId e.g. `m.call#call_id`
+ * @throws If the format of `slotId` is invalid.
+ */
+export declare function slotIdToDescription(slotId: string): SlotDescription;
+/**
+ * Converts a SlotDescription into it's slot ID format.
+ */
+export declare function computeSlotId(slotDescription: SlotDescription): string;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/matrixrtc/utils.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA0B,KAAK,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,wBAAwB,EAAuB,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjG;;GAEG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAA4D;;IAI5E;;;;;OAKG;IACI,UAAU,CAAC,UAAU,EAAE,2BAA2B,EAAE,IAAI,EAAE,wBAAwB,GAAG,OAAO;CActG;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe,CAQnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,eAAe,EAAE,eAAe,GAAG,MAAM,CAEtE"}

package/lib/matrixrtc/utils.js

@@ -0,0 +1,72 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2025-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 { getEncryptionKeyMapKey } from "./EncryptionManager.js";
+/**
+ * Detects when a key for a given index is outdated.
+ */
+export class OutdatedKeyFilter {
+  constructor() {
+    // Map of participantId -> keyIndex -> timestamp
+    _defineProperty(this, "tsBuffer", new Map());
+  }
+
+  /**
+   * Check if there is a recent key with the same keyId (index) and then use the creationTS to decide what to
+   * do with the key. If the key received is older than the one already in the buffer, it is ignored.
+   * @param participantId
+   * @param item
+   */
+  isOutdated(membership, item) {
+    var _this$tsBuffer$get;
+    var mapKey = getEncryptionKeyMapKey(membership);
+    if (!this.tsBuffer.has(mapKey)) {
+      this.tsBuffer.set(mapKey, new Map());
+    }
+    var latestTimestamp = (_this$tsBuffer$get = this.tsBuffer.get(mapKey)) === null || _this$tsBuffer$get === void 0 ? void 0 : _this$tsBuffer$get.get(item.keyIndex);
+    if (latestTimestamp && latestTimestamp > item.creationTS) {
+      // The existing key is more recent, ignore this one
+      return true;
+    }
+    this.tsBuffer.get(mapKey).set(item.keyIndex, item.creationTS);
+    return false;
+  }
+}
+
+/**
+ * Converts a slot ID into it's component application and ID portions.
+ * @param slotId e.g. `m.call#call_id`
+ * @throws If the format of `slotId` is invalid.
+ */
+export function slotIdToDescription(slotId) {
+  var [application, id, ...unexpectedAdditionalValues] = slotId.split("#");
+  if (unexpectedAdditionalValues.length) {
+    throw Error("MatrixRTC Slot IDs *must* only contain two components seperated by one '#'. Additional '#' characters detected.");
+  }
+  return {
+    application,
+    id
+  };
+}
+
+/**
+ * Converts a SlotDescription into it's slot ID format.
+ */
+export function computeSlotId(slotDescription) {
+  return "".concat(slotDescription.application, "#").concat(slotDescription.id);
+}
+//# sourceMappingURL=utils.js.map

package/lib/matrixrtc/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","names":["getEncryptionKeyMapKey","OutdatedKeyFilter","constructor","_defineProperty","Map","isOutdated","membership","item","_this$tsBuffer$get","mapKey","tsBuffer","has","set","latestTimestamp","get","keyIndex","creationTS","slotIdToDescription","slotId","application","id","unexpectedAdditionalValues","split","length","Error","computeSlotId","slotDescription","concat"],"sources":["../../src/matrixrtc/utils.ts"],"sourcesContent":["/*\r\nCopyright 2025-2026 The Matrix.org Foundation C.I.C.\r\n\r\nLicensed under the Apache License, Version 2.0 (the \"License\");\r\nyou may not use this file except in compliance with the License.\r\nYou may obtain a copy of the License at\r\n\r\n    http://www.apache.org/licenses/LICENSE-2.0\r\n\r\nUnless required by applicable law or agreed to in writing, software\r\ndistributed under the License is distributed on an \"AS IS\" BASIS,\r\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\r\nSee the License for the specific language governing permissions and\r\nlimitations under the License.\r\n*/\r\n\r\nimport { getEncryptionKeyMapKey, type CallMembershipIdentityParts } from \"./EncryptionManager.ts\";\r\nimport type { InboundEncryptionSession, EncryptionKeyMapKey, SlotDescription } from \"./types.ts\";\r\n\r\n/**\r\n * Detects when a key for a given index is outdated.\r\n */\r\nexport class OutdatedKeyFilter {\r\n    // Map of participantId -> keyIndex -> timestamp\r\n    private tsBuffer: Map<EncryptionKeyMapKey, Map<number, number>> = new Map();\r\n\r\n    public constructor() {}\r\n\r\n    /**\r\n     * Check if there is a recent key with the same keyId (index) and then use the creationTS to decide what to\r\n     * do with the key. If the key received is older than the one already in the buffer, it is ignored.\r\n     * @param participantId\r\n     * @param item\r\n     */\r\n    public isOutdated(membership: CallMembershipIdentityParts, item: InboundEncryptionSession): boolean {\r\n        const mapKey = getEncryptionKeyMapKey(membership);\r\n        if (!this.tsBuffer.has(mapKey)) {\r\n            this.tsBuffer.set(mapKey, new Map<number, number>());\r\n        }\r\n\r\n        const latestTimestamp = this.tsBuffer.get(mapKey)?.get(item.keyIndex);\r\n        if (latestTimestamp && latestTimestamp > item.creationTS) {\r\n            // The existing key is more recent, ignore this one\r\n            return true;\r\n        }\r\n        this.tsBuffer.get(mapKey)!.set(item.keyIndex, item.creationTS);\r\n        return false;\r\n    }\r\n}\r\n\r\n/**\r\n * Converts a slot ID into it's component application and ID portions.\r\n * @param slotId e.g. `m.call#call_id`\r\n * @throws If the format of `slotId` is invalid.\r\n */\r\nexport function slotIdToDescription(slotId: string): SlotDescription {\r\n    const [application, id, ...unexpectedAdditionalValues] = slotId.split(\"#\");\r\n    if (unexpectedAdditionalValues.length) {\r\n        throw Error(\r\n            \"MatrixRTC Slot IDs *must* only contain two components seperated by one '#'. Additional '#' characters detected.\",\r\n        );\r\n    }\r\n    return { application, id };\r\n}\r\n\r\n/**\r\n * Converts a SlotDescription into it's slot ID format.\r\n */\r\nexport function computeSlotId(slotDescription: SlotDescription): string {\r\n    return `${slotDescription.application}#${slotDescription.id}`;\r\n}\r\n"],"mappings":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAASA,sBAAsB,QAA0C,wBAAwB;AAGjG;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,CAAC;EAIpBC,WAAWA,CAAA,EAAG;IAHrB;IAAAC,eAAA,mBACkE,IAAIC,GAAG,CAAC,CAAC;EAErD;;EAEtB;AACJ;AACA;AACA;AACA;AACA;EACWC,UAAUA,CAACC,UAAuC,EAAEC,IAA8B,EAAW;IAAA,IAAAC,kBAAA;IAChG,IAAMC,MAAM,GAAGT,sBAAsB,CAACM,UAAU,CAAC;IACjD,IAAI,CAAC,IAAI,CAACI,QAAQ,CAACC,GAAG,CAACF,MAAM,CAAC,EAAE;MAC5B,IAAI,CAACC,QAAQ,CAACE,GAAG,CAACH,MAAM,EAAE,IAAIL,GAAG,CAAiB,CAAC,CAAC;IACxD;IAEA,IAAMS,eAAe,IAAAL,kBAAA,GAAG,IAAI,CAACE,QAAQ,CAACI,GAAG,CAACL,MAAM,CAAC,cAAAD,kBAAA,uBAAzBA,kBAAA,CAA2BM,GAAG,CAACP,IAAI,CAACQ,QAAQ,CAAC;IACrE,IAAIF,eAAe,IAAIA,eAAe,GAAGN,IAAI,CAACS,UAAU,EAAE;MACtD;MACA,OAAO,IAAI;IACf;IACA,IAAI,CAACN,QAAQ,CAACI,GAAG,CAACL,MAAM,CAAC,CAAEG,GAAG,CAACL,IAAI,CAACQ,QAAQ,EAAER,IAAI,CAACS,UAAU,CAAC;IAC9D,OAAO,KAAK;EAChB;AACJ;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAACC,MAAc,EAAmB;EACjE,IAAM,CAACC,WAAW,EAAEC,EAAE,EAAE,GAAGC,0BAA0B,CAAC,GAAGH,MAAM,CAACI,KAAK,CAAC,GAAG,CAAC;EAC1E,IAAID,0BAA0B,CAACE,MAAM,EAAE;IACnC,MAAMC,KAAK,CACP,iHACJ,CAAC;EACL;EACA,OAAO;IAAEL,WAAW;IAAEC;EAAG,CAAC;AAC9B;;AAEA;AACA;AACA;AACA,OAAO,SAASK,aAAaA,CAACC,eAAgC,EAAU;EACpE,UAAAC,MAAA,CAAUD,eAAe,CAACP,WAAW,OAAAQ,MAAA,CAAID,eAAe,CAACN,EAAE;AAC/D","ignoreList":[]}

package/lib/models/MSC3089Branch.d.ts

@@ -0,0 +1,98 @@
+import { type BriijClient } from "../client.ts";
+import { type IContent, type BriijEvent } from "./event.ts";
+import { type MSC3089TreeSpace } from "./MSC3089TreeSpace.ts";
+import { type FileType } from "../http-api/index.ts";
+import type { ISendEventResponse } from "../@types/requests.ts";
+import { type EncryptedFile } from "../@types/media.ts";
+export interface MSC3089EventContent {
+    active?: boolean;
+    name?: string;
+    locked?: boolean;
+    version?: number;
+}
+export interface MSC3089EventContent {
+    active?: boolean;
+    name?: string;
+    locked?: boolean;
+    version?: number;
+}
+/**
+ * Represents a [MSC3089](https://github.com/matrix-org/matrix-doc/pull/3089) branch - a reference
+ * to a file (leaf) in the tree. Note that this is UNSTABLE and subject to breaking changes
+ * without notice.
+ */
+export declare class MSC3089Branch {
+    private client;
+    readonly indexEvent: BriijEvent;
+    readonly directory: MSC3089TreeSpace;
+    constructor(client: BriijClient, indexEvent: BriijEvent, directory: MSC3089TreeSpace);
+    /**
+     * The file ID.
+     */
+    get id(): string;
+    /**
+     * Whether this branch is active/valid.
+     */
+    get isActive(): boolean;
+    /**
+     * Version for the file, one-indexed.
+     */
+    get version(): number;
+    private get roomId();
+    /**
+     * Deletes the file from the tree, including all prior edits/versions.
+     * @returns Promise which resolves when complete.
+     */
+    delete(): Promise<void>;
+    /**
+     * Gets the name for this file.
+     * @returns The name, or "Unnamed File" if unknown.
+     */
+    getName(): string;
+    /**
+     * Sets the name for this file.
+     * @param name - The new name for this file.
+     * @returns Promise which resolves when complete.
+     */
+    setName(name: string): Promise<void>;
+    /**
+     * Gets whether or not a file is locked.
+     * @returns True if locked, false otherwise.
+     */
+    isLocked(): boolean;
+    /**
+     * Sets a file as locked or unlocked.
+     * @param locked - True to lock the file, false otherwise.
+     * @returns Promise which resolves when complete.
+     */
+    setLocked(locked: boolean): Promise<void>;
+    /**
+     * Gets information about the file needed to download it.
+     * @returns Information about the file.
+     */
+    getFileInfo(): Promise<{
+        info: EncryptedFile;
+        httpUrl: string;
+    }>;
+    /**
+     * Gets the event the file points to.
+     * @returns Promise which resolves to the file's event.
+     */
+    getFileEvent(): Promise<BriijEvent>;
+    /**
+     * Creates a new version of this file with contents in a type that is compatible with BriijClient.uploadContent().
+     * @param name - The name of the file.
+     * @param encryptedContents - The encrypted contents.
+     * @param info - The encrypted file information.
+     * @param additionalContent - Optional event content fields to include in the message.
+     * @returns Promise which resolves to the file event's sent response.
+     */
+    createNewVersion(name: string, encryptedContents: FileType, info: EncryptedFile, additionalContent?: IContent): Promise<ISendEventResponse>;
+    /**
+     * Gets the file's version history, starting at this file.
+     * @returns Promise which resolves to the file's version history, with the
+     * first element being the current version and the last element being the first version.
+     */
+    getVersionHistory(): Promise<MSC3089Branch[]>;
+}
+//# sourceMappingURL=MSC3089Branch.d.ts.map

package/lib/models/MSC3089Branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MSC3089Branch.d.ts","sourceRoot":"","sources":["../../src/models/MSC3089Branch.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,WAAW,mBAAmB;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAChC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,aAAa;IAElB,OAAO,CAAC,MAAM;aACE,UAAU,EAAE,UAAU;aACtB,SAAS,EAAE,gBAAgB;gBAFnC,MAAM,EAAE,WAAW,EACX,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,gBAAgB;IAK/C;;OAEG;IACH,IAAW,EAAE,IAAI,MAAM,CAMtB;IAED;;OAEG;IACH,IAAW,QAAQ,IAAI,OAAO,CAE7B;IAED;;OAEG;IACH,IAAW,OAAO,IAAI,MAAM,CAE3B;IAED,OAAO,KAAK,MAAM,GAEjB;IAED;;;OAGG;IACU,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAQpC;;;OAGG;IACI,OAAO,IAAI,MAAM;IAIxB;;;;OAIG;IACU,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD;;;OAGG;IACI,QAAQ,IAAI,OAAO;IAI1B;;;;OAIG;IACU,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD;;;OAGG;IACU,WAAW,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAa7E;;;OAGG;IACU,YAAY,IAAI,OAAO,CAAC,UAAU,CAAC;IAoBhD;;;;;;;OAOG;IACU,gBAAgB,CACzB,IAAI,EAAE,MAAM,EACZ,iBAAiB,EAAE,QAAQ,EAC3B,IAAI,EAAE,aAAa,EACnB,iBAAiB,CAAC,EAAE,QAAQ,GAC7B,OAAO,CAAC,kBAAkB,CAAC;IAoC9B;;;;OAIG;IACU,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;CAgC7D"}