matrix-js-sdk 42.0.0 → 42.1.0

package/lib/http-api/interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"interface.js","names":[],"sources":["../../src/http-api/interface.ts"],"sourcesContent":["/*\nCopyright 2022 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 { type MatrixError } from \"./errors.ts\";\nimport { type Logger } from \"../logger.ts\";\nimport { type QueryDict } from \"../utils.ts\";\n\nexport type Body = Record<string, any> | BodyInit;\n\n/**\n * Unencrypted access and (optional) refresh token\n */\nexport type AccessTokens = {\n    /**\n     * The new access token to use for authenticated requests\n     */\n    accessToken: string;\n    /**\n     * The new refresh token to use for refreshing tokens, optional\n     */\n    refreshToken?: string;\n    /**\n     * Approximate date when the access token will expire, optional\n     */\n    expiry?: Date;\n};\n\n/**\n * Function that performs token refresh using the given refreshToken.\n * Returns a promise that resolves to the refreshed access and (optional) refresh tokens.\n *\n * Can be passed to HttpApi instance as {@link IHttpOpts.tokenRefreshFunction} during client creation {@link ICreateClientOpts}\n */\nexport type TokenRefreshFunction = (refreshToken: string) => Promise<AccessTokens>;\n\n/** Options object for `FetchHttpApi` and {@link MatrixHttpApi}. */\nexport interface IHttpOpts {\n    fetchFn?: typeof globalThis.fetch;\n\n    baseUrl: string;\n    idBaseUrl?: string;\n    prefix: string;\n    extraParams?: QueryDict;\n\n    accessToken?: string;\n    /**\n     * Used in conjunction with tokenRefreshFunction to attempt token refresh\n     */\n    refreshToken?: string;\n    /**\n     * Function to attempt token refresh when a possibly expired token is encountered\n     * Optional, only called when a refreshToken is present\n     */\n    tokenRefreshFunction?: TokenRefreshFunction;\n\n    /**\n     * Whether to use the HTTP Authorization header over the `access_token` query parameter\n     * @deprecated as of v1.11 in https://spec.matrix.org/v1.17/client-server-api/#using-access-tokens\n     */\n    useAuthorizationHeader?: boolean; // defaults to true\n\n    /** For historical reasons, must be set to `true`. Will eventually be removed. */\n    onlyData?: boolean;\n\n    localTimeoutMs?: number;\n\n    /** Optional logger instance. If provided, requests and responses will be logged. */\n    logger?: Logger;\n}\n\n/** Options object for `FetchHttpApi.requestOtherUrl`. */\nexport interface BaseRequestOpts extends Pick<RequestInit, \"priority\"> {\n    /**\n     * map of additional request headers\n     */\n    headers?: Record<string, string>;\n    abortSignal?: AbortSignal;\n    /**\n     * The maximum amount of time to wait before\n     * timing out the request. If not specified, there is no timeout.\n     */\n    localTimeoutMs?: number;\n    keepAlive?: boolean; // defaults to false\n\n    /**\n     * By default, we will:\n     *\n     *  *  If the `body` is an object, JSON-encode it and set `Content-Type: application/json` in the\n     *     request headers (unless overridden by {@link headers}).\n     *\n     *  * Set `Accept: application/json` in the request headers (again, unless overridden by {@link headers}).\n     *\n     *  * Parse the response as JSON and return the parsed response.\n     *\n     * Setting this to `false` inhibits all three behaviors, and the response is instead parsed as a UTF-8 string. It\n     * defaults to `true`, unless {@link rawResponseBody} is set.\n     *\n     * @deprecated Instead of setting this to `false`, set {@link rawResponseBody} to `true`.\n     */\n    json?: boolean;\n\n    /**\n     * Setting this to `true` does two things:\n     *\n     *  * Inhibits the automatic addition of `Accept: application/json` in the request headers.\n     *\n     *  * Causes the raw response to be returned as a {@link https://developer.mozilla.org/en-US/docs/Web/API/Blob|Blob}\n     *    instead of parsing it as JSON.\n     */\n    rawResponseBody?: boolean;\n}\n\nexport interface IRequestOpts extends BaseRequestOpts {\n    /**\n     * The alternative base url to use.\n     * If not specified, uses this.opts.baseUrl\n     */\n    baseUrl?: string;\n    /**\n     * The full prefix to use e.g.\n     * \"/_matrix/client/v2_alpha\". If not specified, uses this.opts.prefix.\n     */\n    prefix?: string;\n\n    // Set to true to prevent the request function from emitting a Session.logged_out event.\n    // This is intended for use on endpoints where M_UNKNOWN_TOKEN is a valid/notable error response,\n    // such as with token refreshes.\n    inhibitLogoutEmit?: boolean;\n}\n\nexport enum HttpApiEvent {\n    SessionLoggedOut = \"Session.logged_out\",\n    NoConsent = \"no_consent\",\n}\n\nexport type HttpApiEventHandlerMap = {\n    /**\n     * Fires whenever the login session the JS SDK is using is no\n     * longer valid and the user must log in again.\n     * NB. This only fires when action is required from the user, not\n     * when then login session can be renewed by using a refresh token.\n     * @example\n     * ```\n     * matrixClient.on(\"Session.logged_out\", function(errorObj){\n     *   // show the login screen\n     * });\n     * ```\n     */\n    [HttpApiEvent.SessionLoggedOut]: (err: MatrixError) => void;\n    /**\n     * Fires when the JS SDK receives a M_CONSENT_NOT_GIVEN error in response\n     * to a HTTP request.\n     * @example\n     * ```\n     * matrixClient.on(\"no_consent\", function(message, contentUri) {\n     *     console.info(message + ' Go to ' + contentUri);\n     * });\n     * ```\n     */\n    [HttpApiEvent.NoConsent]: (message: string, consentUri: string) => void;\n};\n\nexport interface UploadProgress {\n    loaded: number;\n    total: number;\n}\n\nexport interface UploadOpts {\n    /**\n     * Name to give the file on the server. Defaults to <tt>file.name</tt>.\n     */\n    name?: string;\n    /**\n     * Content-type for the upload. Defaults to\n     *   <tt>file.type</tt>, or <tt>applicaton/octet-stream</tt>.\n     */\n    type?: string;\n    /**\n     * if false will not send the filename,\n     *   e.g for encrypted file uploads where filename leaks are undesirable.\n     *   Defaults to true.\n     */\n    includeFilename?: boolean;\n    /**\n     * Optional. Called when a chunk of\n     *    data has been uploaded, with an object containing the fields `loaded`\n     *    (number of bytes transferred) and `total` (total size, if known).\n     */\n    progressHandler?(progress: UploadProgress): void;\n    abortController?: AbortController;\n}\n\nexport interface Upload {\n    loaded: number;\n    total: number;\n    promise: Promise<UploadResponse>;\n    abortController: AbortController;\n}\n\nexport interface UploadResponse {\n    // eslint-disable-next-line camelcase\n    content_uri: string;\n}\n\nexport type FileType = XMLHttpRequestBodyInit;\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAmCA;;AA4DA,WAAY,YAAY,0BAAZ,YAAY;EAAZ,YAAY;EAAZ,YAAY;EAAA,OAAZ,YAAY;AAAA","ignoreList":[]}
+{"version":3,"file":"interface.js","names":[],"sources":["../../src/http-api/interface.ts"],"sourcesContent":["/*\nCopyright 2022 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 { type MatrixError } from \"./errors.ts\";\nimport { type Logger } from \"../logger.ts\";\nimport { type QueryDict } from \"../utils.ts\";\n\nexport type Body = Record<string, any> | BodyInit;\n\n/**\n * Unencrypted access and (optional) refresh token\n */\nexport type AccessTokens = {\n    /**\n     * The new access token to use for authenticated requests\n     */\n    accessToken: string;\n    /**\n     * The new refresh token to use for refreshing tokens, optional\n     */\n    refreshToken?: string;\n    /**\n     * Approximate date when the access token will expire, optional\n     */\n    expiry?: Date;\n};\n\n/**\n * Function that performs token refresh using the given refreshToken.\n * Returns a promise that resolves to the refreshed access and (optional) refresh tokens.\n *\n * Can be passed to HttpApi instance as {@link IHttpOpts.tokenRefreshFunction} during client creation {@link ICreateClientOpts}\n */\nexport type TokenRefreshFunction = (refreshToken: string) => Promise<AccessTokens>;\n\n/** Options object for `FetchHttpApi` and {@link MatrixHttpApi}. */\nexport interface IHttpOpts {\n    fetchFn?: typeof globalThis.fetch;\n\n    baseUrl: string;\n    idBaseUrl?: string;\n    prefix: string;\n    extraParams?: QueryDict;\n\n    accessToken?: string;\n    /**\n     * Used in conjunction with tokenRefreshFunction to attempt token refresh\n     */\n    refreshToken?: string;\n    /**\n     * Function to attempt token refresh when a possibly expired token is encountered\n     * Optional, only called when a refreshToken is present\n     */\n    tokenRefreshFunction?: TokenRefreshFunction;\n\n    /**\n     * Whether to use the HTTP Authorization header over the `access_token` query parameter\n     * @deprecated as of v1.11 in https://spec.matrix.org/v1.17/client-server-api/#using-access-tokens\n     */\n    useAuthorizationHeader?: boolean; // defaults to true\n\n    /** For historical reasons, must be set to `true`. Will eventually be removed. */\n    onlyData?: boolean;\n\n    localTimeoutMs?: number;\n\n    /** Optional logger instance. If provided, requests and responses will be logged. */\n    logger?: Logger;\n}\n\n/** Options object for `FetchHttpApi.requestOtherUrl`. */\nexport interface BaseRequestOpts extends Pick<RequestInit, \"priority\"> {\n    /**\n     * map of additional request headers\n     */\n    headers?: Record<string, string>;\n    abortSignal?: AbortSignal;\n    /**\n     * The maximum amount of time to wait before\n     * timing out the request. If not specified, there is no timeout.\n     */\n    localTimeoutMs?: number;\n    keepAlive?: boolean; // defaults to false\n\n    /**\n     * By default, we will:\n     *\n     *  *  If the `body` is an object, JSON-encode it and set `Content-Type: application/json` in the\n     *     request headers (unless overridden by {@link headers}).\n     *\n     *  * Set `Accept: application/json` in the request headers (again, unless overridden by {@link headers}).\n     *\n     *  * Parse the response as JSON and return the parsed response.\n     *\n     * Setting this to `false` inhibits all three behaviors, and the response is instead parsed as a UTF-8 string. It\n     * defaults to `true`, unless {@link rawResponseBody} is set.\n     *\n     * @deprecated Instead of setting this to `false`, set {@link rawResponseBody} to `true`.\n     */\n    json?: boolean;\n\n    /**\n     * Setting this to `true` does two things:\n     *\n     *  * Inhibits the automatic addition of `Accept: application/json` in the request headers.\n     *\n     *  * Causes the raw response to be returned as a {@link https://developer.mozilla.org/en-US/docs/Web/API/Blob|Blob}\n     *    instead of parsing it as JSON.\n     */\n    rawResponseBody?: boolean;\n}\n\nexport interface IRequestOpts extends BaseRequestOpts {\n    /**\n     * The alternative base url to use.\n     * If not specified, uses this.opts.baseUrl\n     */\n    baseUrl?: string;\n    /**\n     * The full prefix to use e.g.\n     * \"/_matrix/client/v2_alpha\". If not specified, uses this.opts.prefix.\n     */\n    prefix?: string;\n\n    // Set to true to prevent the request function from emitting a Session.logged_out event.\n    // This is intended for use on endpoints where M_UNKNOWN_TOKEN is a valid/notable error response,\n    // such as with token refreshes.\n    inhibitLogoutEmit?: boolean;\n}\n\nexport enum HttpApiEvent {\n    SessionLoggedOut = \"Session.logged_out\",\n    NoConsent = \"no_consent\",\n}\n\nexport type HttpApiEventHandlerMap = {\n    /**\n     * Fires whenever the login session the JS SDK is using is no\n     * longer valid and the user must log in again.\n     * NB. This only fires when action is required from the user, not\n     * when then login session can be renewed by using a refresh token.\n     * @example\n     * ```\n     * matrixClient.on(\"Session.logged_out\", function(errorObj){\n     *   // show the login screen\n     * });\n     * ```\n     */\n    [HttpApiEvent.SessionLoggedOut]: (err: MatrixError) => void;\n    /**\n     * Fires when the JS SDK receives a M_CONSENT_NOT_GIVEN error in response\n     * to a HTTP request.\n     * @example\n     * ```\n     * matrixClient.on(\"no_consent\", function(message, contentUri) {\n     *     console.info(message + ' Go to ' + contentUri);\n     * });\n     * ```\n     */\n    [HttpApiEvent.NoConsent]: (message: string, consentUri: string) => void;\n};\n\nexport interface UploadProgress {\n    loaded: number;\n    total: number;\n}\n\nexport interface UploadOpts {\n    /**\n     * Name to give the file on the server. Defaults to <tt>file.name</tt>.\n     */\n    name?: string;\n    /**\n     * Content-type for the upload. Defaults to\n     *   <tt>file.type</tt>, or <tt>applicaton/octet-stream</tt>.\n     */\n    type?: string;\n    /**\n     * if false will not send the filename,\n     *   e.g for encrypted file uploads where filename leaks are undesirable.\n     *   Defaults to true.\n     */\n    includeFilename?: boolean;\n    /**\n     * Optional. Called when a chunk of\n     *    data has been uploaded, with an object containing the fields `loaded`\n     *    (number of bytes transferred) and `total` (total size, if known).\n     */\n    progressHandler?(progress: UploadProgress): void;\n    abortController?: AbortController;\n}\n\nexport interface Upload {\n    loaded: number;\n    total: number;\n    promise: Promise<UploadResponse>;\n    abortController: AbortController;\n}\n\nexport interface UploadResponse {\n    content_uri: string;\n}\n\nexport type FileType = XMLHttpRequestBodyInit;\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAQA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AAmCA;;AA4DA,WAAY,YAAY,0BAAZ,YAAY;EAAZ,YAAY;EAAZ,YAAY;EAAA,OAAZ,YAAY;AAAA","ignoreList":[]}

package/lib/http-api/refresh.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../../src/http-api/refresh.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;GAEG;AAEH,0BAAkB,mBAAmB;IACjC,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;CACpB;AAED,UAAU,QAAQ;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,IAAI,CAAC;CACjB;AAQD,KAAK,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,sBAAsB,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAC,CAAC;AAEhG;;;GAGG;AACH,qBAAa,cAAc;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAxC,YAAoC,IAAI,EAAE,IAAI,EAAI;IAElD;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAAC,CAA+B;IAE3D,OAAO,CAAC,wBAAwB,CAAC,CAAO;IAExC;;;;OAIG;IACU,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,CASlD;YAEa,eAAe;IAa7B;;;;;;OAMG;IACU,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAEjG;YAGa,mBAAmB;IA6BjC;;;;OAIG;YACW,cAAc;CAgC/B"}
+{"version":3,"file":"refresh.d.ts","sourceRoot":"","sources":["../../src/http-api/refresh.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD;;GAEG;AAEH,0BAAkB,mBAAmB;IACjC,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,MAAM,WAAW;CACpB;AAED,UAAU,QAAQ;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,IAAI,CAAC;CACjB;AAQD,KAAK,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,sBAAsB,GAAG,QAAQ,GAAG,cAAc,GAAG,aAAa,CAAC,CAAC;AAEhG;;;GAGG;AACH,qBAAa,cAAc;IACJ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAxC,YAAoC,IAAI,EAAE,IAAI,EAAI;IAElD;;;OAGG;IACH,OAAO,CAAC,mBAAmB,CAAC,CAA+B;IAE3D,OAAO,CAAC,wBAAwB,CAAC,CAAO;IAExC;;;;OAIG;IACU,iBAAiB,IAAI,OAAO,CAAC,QAAQ,CAAC,CASlD;YAEa,eAAe;IAa7B;;;;;;OAMG;IACU,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAEjG;YAEa,mBAAmB;IA6BjC;;;;OAIG;YACW,cAAc;CAgC/B"}

package/lib/http-api/refresh.js

@@ -83,9 +83,6 @@ export class TokenRefresher {
   async handleUnknownToken(snapshot, attempt) {
     return this._handleUnknownToken(snapshot, attempt);
   }
-
-  /* eslint-disable @typescript-eslint/naming-convention */
-
   async _handleUnknownToken(snapshot, attempt) {
     if (snapshot?.expiry) {
       // If our token is unknown, but it should not have expired yet, then we should not refresh

package/lib/http-api/refresh.js.map

@@ -1 +1 @@
-{"version":3,"file":"refresh.js","names":[],"sources":["../../src/http-api/refresh.ts"],"sourcesContent":["/*\nCopyright 2025 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 { MatrixError, TokenRefreshLogoutError } from \"./errors.ts\";\nimport { type IHttpOpts } from \"./interface.ts\";\nimport { sleep } from \"../utils.ts\";\n\n/**\n * This is an internal module. See {@link MatrixHttpApi} for the public class.\n */\n\nexport const enum TokenRefreshOutcome {\n    Success = \"success\",\n    Failure = \"failure\",\n    Logout = \"logout\",\n}\n\ninterface Snapshot {\n    accessToken: string;\n    refreshToken?: string;\n    expiry?: Date;\n}\n\n// If the token expires in less than this time amount of time, we will eagerly refresh it before making the intended request.\nconst REFRESH_IF_TOKEN_EXPIRES_WITHIN_MS = 500;\n// If we get an unknown token error and the token expires in less than this time amount of time, we will refresh it before making the intended request.\n// Otherwise, we will error as the token should not have expired yet and we need to avoid retrying indefinitely.\nconst REFRESH_ON_ERROR_IF_TOKEN_EXPIRES_WITHIN_MS = 60 * 1000;\n\ntype Opts = Pick<IHttpOpts, \"tokenRefreshFunction\" | \"logger\" | \"refreshToken\" | \"accessToken\">;\n\n/**\n * This class is responsible for managing the access token and refresh token for authenticated requests.\n * It will automatically refresh the access token when it is about to expire, and will handle unknown token errors.\n */\nexport class TokenRefresher {\n    public constructor(private readonly opts: Opts) {}\n\n    /**\n     * Promise used to block authenticated requests during a token refresh to avoid repeated expected errors.\n     * @private\n     */\n    private tokenRefreshPromise?: Promise<TokenRefreshOutcome>;\n\n    private latestTokenRefreshExpiry?: Date;\n\n    /**\n     * This function is called before every request to ensure that the access token is valid.\n     * @returns a snapshot containing the access token and other properties which must be passed to the handleUnknownToken\n     *     handler if an M_UNKNOWN_TOKEN error is encountered.\n     */\n    public async prepareForRequest(): Promise<Snapshot> {\n        // Ensure our token is refreshed before we build the headers/params\n        await this.refreshIfNeeded();\n\n        return {\n            accessToken: this.opts.accessToken!,\n            refreshToken: this.opts.refreshToken,\n            expiry: this.latestTokenRefreshExpiry,\n        };\n    }\n\n    private async refreshIfNeeded(): Promise<unknown> {\n        if (this.tokenRefreshPromise) {\n            return this.tokenRefreshPromise;\n        }\n        // If we don't know the token expiry, we can't eagerly refresh\n        if (!this.latestTokenRefreshExpiry) return;\n\n        const expiresIn = this.latestTokenRefreshExpiry.getTime() - Date.now();\n        if (expiresIn <= REFRESH_IF_TOKEN_EXPIRES_WITHIN_MS) {\n            await this._handleUnknownToken();\n        }\n    }\n\n    /**\n     * This function is called when an M_UNKNOWN_TOKEN error is encountered.\n     * It will attempt to refresh the access token if it is unknown, and will return a TokenRefreshOutcome.\n     * @param snapshot - the snapshot returned by prepareForRequest\n     * @param attempt - the number of attempts made for this request so far\n     * @returns a TokenRefreshOutcome indicating the result of the refresh attempt\n     */\n    public async handleUnknownToken(snapshot: Snapshot, attempt: number): Promise<TokenRefreshOutcome> {\n        return this._handleUnknownToken(snapshot, attempt);\n    }\n\n    /* eslint-disable @typescript-eslint/naming-convention */\n    private async _handleUnknownToken(): Promise<TokenRefreshOutcome>;\n    private async _handleUnknownToken(snapshot: Snapshot, attempt: number): Promise<TokenRefreshOutcome>;\n    private async _handleUnknownToken(snapshot?: Snapshot, attempt?: number): Promise<TokenRefreshOutcome> {\n        if (snapshot?.expiry) {\n            // If our token is unknown, but it should not have expired yet, then we should not refresh\n            const expiresIn = snapshot.expiry.getTime() - Date.now();\n            // If it still has plenty of time left on the clock, we assume something else must be wrong and\n            // do not refresh. Otherwise if it's expired, or will soon, we try refreshing.\n            if (expiresIn >= REFRESH_ON_ERROR_IF_TOKEN_EXPIRES_WITHIN_MS) {\n                return TokenRefreshOutcome.Logout;\n            }\n        }\n\n        if (!snapshot || snapshot?.accessToken === this.opts.accessToken) {\n            // If we have a snapshot, but the access token is the same as the current one then a refresh\n            // did not happen behind us but one may be ongoing anyway\n            this.tokenRefreshPromise ??= this.doTokenRefresh(attempt);\n\n            try {\n                return await this.tokenRefreshPromise;\n            } finally {\n                this.tokenRefreshPromise = undefined;\n            }\n        }\n\n        // We may end up here if the token was refreshed in the background due to another request\n        return TokenRefreshOutcome.Success;\n    }\n\n    /**\n     * Attempt to refresh access tokens.\n     * On success, sets new access and refresh tokens in opts.\n     * @returns Promise that resolves to a boolean - true when token was refreshed successfully\n     */\n    private async doTokenRefresh(attempt?: number): Promise<TokenRefreshOutcome> {\n        if (!this.opts.refreshToken || !this.opts.tokenRefreshFunction) {\n            this.opts.logger?.error(\"Unable to refresh token - no refresh token or refresh function\");\n            return TokenRefreshOutcome.Logout;\n        }\n\n        if (attempt && attempt > 1) {\n            // Exponential backoff to ensure we don't trash the server, up to 2^5 seconds\n            await sleep(1000 * Math.min(32, 2 ** attempt));\n        }\n\n        try {\n            this.opts.logger?.debug(\"Attempting to refresh token\");\n            const { accessToken, refreshToken, expiry } = await this.opts.tokenRefreshFunction(this.opts.refreshToken);\n            this.opts.accessToken = accessToken;\n            this.opts.refreshToken = refreshToken;\n            this.latestTokenRefreshExpiry = expiry;\n            this.opts.logger?.debug(\"... token refresh complete, new token expiry:\", expiry);\n\n            // successfully got new tokens\n            return TokenRefreshOutcome.Success;\n        } catch (error) {\n            // If we get a TokenError or MatrixError, we should log out, otherwise assume transient\n            if (error instanceof TokenRefreshLogoutError || error instanceof MatrixError) {\n                this.opts.logger?.error(\"Failed to refresh token\", error);\n                return TokenRefreshOutcome.Logout;\n            }\n\n            this.opts.logger?.warn(\"Failed to refresh token\", error);\n            return TokenRefreshOutcome.Failure;\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"refresh.js","names":[],"sources":["../../src/http-api/refresh.ts"],"sourcesContent":["/*\nCopyright 2025 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 { MatrixError, TokenRefreshLogoutError } from \"./errors.ts\";\nimport { type IHttpOpts } from \"./interface.ts\";\nimport { sleep } from \"../utils.ts\";\n\n/**\n * This is an internal module. See {@link MatrixHttpApi} for the public class.\n */\n\nexport const enum TokenRefreshOutcome {\n    Success = \"success\",\n    Failure = \"failure\",\n    Logout = \"logout\",\n}\n\ninterface Snapshot {\n    accessToken: string;\n    refreshToken?: string;\n    expiry?: Date;\n}\n\n// If the token expires in less than this time amount of time, we will eagerly refresh it before making the intended request.\nconst REFRESH_IF_TOKEN_EXPIRES_WITHIN_MS = 500;\n// If we get an unknown token error and the token expires in less than this time amount of time, we will refresh it before making the intended request.\n// Otherwise, we will error as the token should not have expired yet and we need to avoid retrying indefinitely.\nconst REFRESH_ON_ERROR_IF_TOKEN_EXPIRES_WITHIN_MS = 60 * 1000;\n\ntype Opts = Pick<IHttpOpts, \"tokenRefreshFunction\" | \"logger\" | \"refreshToken\" | \"accessToken\">;\n\n/**\n * This class is responsible for managing the access token and refresh token for authenticated requests.\n * It will automatically refresh the access token when it is about to expire, and will handle unknown token errors.\n */\nexport class TokenRefresher {\n    public constructor(private readonly opts: Opts) {}\n\n    /**\n     * Promise used to block authenticated requests during a token refresh to avoid repeated expected errors.\n     * @private\n     */\n    private tokenRefreshPromise?: Promise<TokenRefreshOutcome>;\n\n    private latestTokenRefreshExpiry?: Date;\n\n    /**\n     * This function is called before every request to ensure that the access token is valid.\n     * @returns a snapshot containing the access token and other properties which must be passed to the handleUnknownToken\n     *     handler if an M_UNKNOWN_TOKEN error is encountered.\n     */\n    public async prepareForRequest(): Promise<Snapshot> {\n        // Ensure our token is refreshed before we build the headers/params\n        await this.refreshIfNeeded();\n\n        return {\n            accessToken: this.opts.accessToken!,\n            refreshToken: this.opts.refreshToken,\n            expiry: this.latestTokenRefreshExpiry,\n        };\n    }\n\n    private async refreshIfNeeded(): Promise<unknown> {\n        if (this.tokenRefreshPromise) {\n            return this.tokenRefreshPromise;\n        }\n        // If we don't know the token expiry, we can't eagerly refresh\n        if (!this.latestTokenRefreshExpiry) return;\n\n        const expiresIn = this.latestTokenRefreshExpiry.getTime() - Date.now();\n        if (expiresIn <= REFRESH_IF_TOKEN_EXPIRES_WITHIN_MS) {\n            await this._handleUnknownToken();\n        }\n    }\n\n    /**\n     * This function is called when an M_UNKNOWN_TOKEN error is encountered.\n     * It will attempt to refresh the access token if it is unknown, and will return a TokenRefreshOutcome.\n     * @param snapshot - the snapshot returned by prepareForRequest\n     * @param attempt - the number of attempts made for this request so far\n     * @returns a TokenRefreshOutcome indicating the result of the refresh attempt\n     */\n    public async handleUnknownToken(snapshot: Snapshot, attempt: number): Promise<TokenRefreshOutcome> {\n        return this._handleUnknownToken(snapshot, attempt);\n    }\n\n    private async _handleUnknownToken(): Promise<TokenRefreshOutcome>;\n    private async _handleUnknownToken(snapshot: Snapshot, attempt: number): Promise<TokenRefreshOutcome>;\n    private async _handleUnknownToken(snapshot?: Snapshot, attempt?: number): Promise<TokenRefreshOutcome> {\n        if (snapshot?.expiry) {\n            // If our token is unknown, but it should not have expired yet, then we should not refresh\n            const expiresIn = snapshot.expiry.getTime() - Date.now();\n            // If it still has plenty of time left on the clock, we assume something else must be wrong and\n            // do not refresh. Otherwise if it's expired, or will soon, we try refreshing.\n            if (expiresIn >= REFRESH_ON_ERROR_IF_TOKEN_EXPIRES_WITHIN_MS) {\n                return TokenRefreshOutcome.Logout;\n            }\n        }\n\n        if (!snapshot || snapshot?.accessToken === this.opts.accessToken) {\n            // If we have a snapshot, but the access token is the same as the current one then a refresh\n            // did not happen behind us but one may be ongoing anyway\n            this.tokenRefreshPromise ??= this.doTokenRefresh(attempt);\n\n            try {\n                return await this.tokenRefreshPromise;\n            } finally {\n                this.tokenRefreshPromise = undefined;\n            }\n        }\n\n        // We may end up here if the token was refreshed in the background due to another request\n        return TokenRefreshOutcome.Success;\n    }\n\n    /**\n     * Attempt to refresh access tokens.\n     * On success, sets new access and refresh tokens in opts.\n     * @returns Promise that resolves to a boolean - true when token was refreshed successfully\n     */\n    private async doTokenRefresh(attempt?: number): Promise<TokenRefreshOutcome> {\n        if (!this.opts.refreshToken || !this.opts.tokenRefreshFunction) {\n            this.opts.logger?.error(\"Unable to refresh token - no refresh token or refresh function\");\n            return TokenRefreshOutcome.Logout;\n        }\n\n        if (attempt && attempt > 1) {\n            // Exponential backoff to ensure we don't trash the server, up to 2^5 seconds\n            await sleep(1000 * Math.min(32, 2 ** attempt));\n        }\n\n        try {\n            this.opts.logger?.debug(\"Attempting to refresh token\");\n            const { accessToken, refreshToken, expiry } = await this.opts.tokenRefreshFunction(this.opts.refreshToken);\n            this.opts.accessToken = accessToken;\n            this.opts.refreshToken = refreshToken;\n            this.latestTokenRefreshExpiry = expiry;\n            this.opts.logger?.debug(\"... token refresh complete, new token expiry:\", expiry);\n\n            // successfully got new tokens\n            return TokenRefreshOutcome.Success;\n        } catch (error) {\n            // If we get a TokenError or MatrixError, we should log out, otherwise assume transient\n            if (error instanceof TokenRefreshLogoutError || error instanceof MatrixError) {\n                this.opts.logger?.error(\"Failed to refresh token\", error);\n                return TokenRefreshOutcome.Logout;\n            }\n\n            this.opts.logger?.warn(\"Failed to refresh token\", error);\n            return TokenRefreshOutcome.Failure;\n        }\n    }\n}\n"],"mappings":";AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAAS,WAAW,EAAE,uBAAuB,QAAQ,aAAa;AAElE,SAAS,KAAK,QAAQ,aAAa;;AAEnC;AACA;AACA;;AAEA,WAAkB,mBAAmB,0BAAnB,mBAAmB;EAAnB,mBAAmB;EAAnB,mBAAmB;EAAnB,mBAAmB;EAAA,OAAnB,mBAAmB;AAAA;AAYrC;AACA,MAAM,kCAAkC,GAAG,GAAG;AAC9C;AACA;AACA,MAAM,2CAA2C,GAAG,EAAE,GAAG,IAAI;AAI7D;AACA;AACA;AACA;AACA,OAAO,MAAM,cAAc,CAAC;EACjB,WAAW,CAAkB,IAAU,EAAE;IAEhD;AACJ;AACA;AACA;IAHI;IAAA;IAAA,KAFoC,IAAU,GAAV,IAAU;EAAG;EAUjD;AACJ;AACA;AACA;AACA;EACI,MAAa,iBAAiB,GAAsB;IAChD;IACA,MAAM,IAAI,CAAC,eAAe,CAAC,CAAC;IAE5B,OAAO;MACH,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,WAAY;MACnC,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY;MACpC,MAAM,EAAE,IAAI,CAAC;IACjB,CAAC;EACL;EAEA,MAAc,eAAe,GAAqB;IAC9C,IAAI,IAAI,CAAC,mBAAmB,EAAE;MAC1B,OAAO,IAAI,CAAC,mBAAmB;IACnC;IACA;IACA,IAAI,CAAC,IAAI,CAAC,wBAAwB,EAAE;IAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IACtE,IAAI,SAAS,IAAI,kCAAkC,EAAE;MACjD,MAAM,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACpC;EACJ;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACI,MAAa,kBAAkB,CAAC,QAAkB,EAAE,OAAe,EAAgC;IAC/F,OAAO,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,OAAO,CAAC;EACtD;EAIA,MAAc,mBAAmB,CAAC,QAAmB,EAAE,OAAgB,EAAgC;IACnG,IAAI,QAAQ,EAAE,MAAM,EAAE;MAClB;MACA,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;MACxD;MACA;MACA,IAAI,SAAS,IAAI,2CAA2C,EAAE;QAC1D,OAAO,mBAAmB,CAAC,MAAM;MACrC;IACJ;IAEA,IAAI,CAAC,QAAQ,IAAI,QAAQ,EAAE,WAAW,KAAK,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE;MAC9D;MACA;MACA,IAAI,CAAC,mBAAmB,KAAK,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;MAEzD,IAAI;QACA,OAAO,MAAM,IAAI,CAAC,mBAAmB;MACzC,CAAC,SAAS;QACN,IAAI,CAAC,mBAAmB,GAAG,SAAS;MACxC;IACJ;;IAEA;IACA,OAAO,mBAAmB,CAAC,OAAO;EACtC;;EAEA;AACJ;AACA;AACA;AACA;EACI,MAAc,cAAc,CAAC,OAAgB,EAAgC;IACzE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE;MAC5D,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,gEAAgE,CAAC;MACzF,OAAO,mBAAmB,CAAC,MAAM;IACrC;IAEA,IAAI,OAAO,IAAI,OAAO,GAAG,CAAC,EAAE;MACxB;MACA,MAAM,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC;IAClD;IAEA,IAAI;MACA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,6BAA6B,CAAC;MACtD,MAAM;QAAE,WAAW;QAAE,YAAY;QAAE;MAAO,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC;MAC1G,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,WAAW;MACnC,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,YAAY;MACrC,IAAI,CAAC,wBAAwB,GAAG,MAAM;MACtC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,+CAA+C,EAAE,MAAM,CAAC;;MAEhF;MACA,OAAO,mBAAmB,CAAC,OAAO;IACtC,CAAC,CAAC,OAAO,KAAK,EAAE;MACZ;MACA,IAAI,KAAK,YAAY,uBAAuB,IAAI,KAAK,YAAY,WAAW,EAAE;QAC1E,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC;QACzD,OAAO,mBAAmB,CAAC,MAAM;MACrC;MAEA,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE,KAAK,CAAC;MACxD,OAAO,mBAAmB,CAAC,OAAO;IACtC;EACJ;AACJ","ignoreList":[]}

package/lib/interactive-auth.d.ts.map

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

package/lib/interactive-auth.js

@@ -69,9 +69,7 @@ export let AuthType = /*#__PURE__*/function (AuthType) {
  */
 
 export class NoAuthFlowFoundError extends Error {
-  constructor(m,
-  // eslint-disable-next-line @typescript-eslint/naming-convention, camelcase
-  required_stages, flows) {
+  constructor(m, required_stages, flows) {
     super(m);
     _defineProperty(this, "name", "NoAuthFlowFoundError");
     this.required_stages = required_stages;
@@ -282,12 +280,13 @@ export class InteractiveAuth {
     // if we're currently trying a request, wait for it to finish
     // as otherwise we can get multiple 200 responses which can mean
     // things like multiple logins for register requests.
-    // (but discard any exceptions as we only care when its done,
-    // not whether it worked or not)
     while (this.submitPromise) {
       try {
         await this.submitPromise;
-      } catch {}
+      } catch {
+        // discard any exceptions as we only care when its done,
+        // not whether it worked or not
+      }
     }
 
     // use the sessionid from the last request, if one is present.

package/lib/interactive-auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"interactive-auth.js","names":[],"sources":["../src/interactive-auth.ts"],"sourcesContent":["/*\nCopyright 2016 OpenMarket Ltd\nCopyright 2017 Vector Creations Ltd\nCopyright 2019 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 { logger } from \"./logger.ts\";\nimport { type MatrixClient } from \"./client.ts\";\nimport { MatrixError } from \"./http-api/index.ts\";\nimport { type UserIdentifier } from \"./@types/auth.ts\";\n\nconst EMAIL_STAGE_TYPE = \"m.login.email.identity\";\nconst MSISDN_STAGE_TYPE = \"m.login.msisdn\";\n\nexport interface UIAFlow {\n    stages: Array<AuthType | string>;\n}\n\nexport interface IInputs {\n    // An email address. If supplied, a flow using email verification will be chosen.\n    emailAddress?: string;\n    // An ISO two letter country code. Gives the country that opts.phoneNumber should be resolved relative to.\n    phoneCountry?: string;\n    // A phone number. If supplied, a flow using phone number validation will be chosen.\n    phoneNumber?: string;\n    registrationToken?: string;\n}\n\nexport interface IStageStatus {\n    emailSid?: string;\n    errcode?: string;\n    error?: string;\n}\n\n/**\n * Data returned in the body of a 401 response from a UIA endpoint.\n *\n * @see https://spec.matrix.org/v1.6/client-server-api/#user-interactive-api-in-the-rest-api\n */\nexport interface IAuthData {\n    /**\n     * This is a session identifier that the client must pass back to the home server,\n     * if one is provided, in subsequent attempts to authenticate in the same API call.\n     */\n    session?: string;\n    /**\n     * A list of the stages the client has completed successfully\n     */\n    completed?: string[];\n    /**\n     * A list of the login flows supported by the server for this API.\n     */\n    flows?: UIAFlow[];\n    /**\n     * Contains any information that the client will need to know in order to use a given type of authentication.\n     * For each login type presented, that type may be present as a key in this dictionary.\n     * For example, the public part of an OAuth client ID could be given here.\n     */\n    params?: Record<string, Record<string, any>>;\n}\n\nexport enum AuthType {\n    Password = \"m.login.password\",\n    Recaptcha = \"m.login.recaptcha\",\n    Terms = \"m.login.terms\",\n    Email = \"m.login.email.identity\",\n    Msisdn = \"m.login.msisdn\",\n    Sso = \"m.login.sso\",\n    SsoUnstable = \"org.matrix.login.sso\",\n    Dummy = \"m.login.dummy\",\n    RegistrationToken = \"m.login.registration_token\",\n    // For backwards compatability with servers that have not yet updated to\n    // use the stable \"m.login.registration_token\" type.\n    // The authentication flow is the same in both cases.\n    UnstableRegistrationToken = \"org.matrix.msc3231.login.registration_token\",\n    /**\n     * m.oauth stage introduced by MSC4312:\n     * https://spec.matrix.org/v1.17/client-server-api/#oauth-authentication\n     */\n    OAuth = \"m.oauth\",\n}\n\n/**\n * https://spec.matrix.org/v1.7/client-server-api/#password-based\n */\ntype PasswordDict = {\n    type: AuthType.Password;\n    identifier: UserIdentifier;\n    password: string;\n    session: string;\n};\n\n/**\n * https://spec.matrix.org/v1.7/client-server-api/#google-recaptcha\n */\ntype RecaptchaDict = {\n    type: AuthType.Recaptcha;\n    response: string;\n    session: string;\n};\n\ninterface ThreepidCreds {\n    sid: string;\n    client_secret: string;\n    id_server: string;\n    id_access_token: string;\n}\n\n/**\n * https://spec.matrix.org/v1.7/client-server-api/#email-based-identity--homeserver\n */\ntype EmailIdentityDict = {\n    type: AuthType.Email;\n    threepid_creds: ThreepidCreds;\n    session: string;\n};\n\n/**\n * The parameters which are submitted as the `auth` dict in a UIA request\n *\n * @see https://spec.matrix.org/v1.6/client-server-api/#authentication-types\n */\nexport type AuthDict =\n    | PasswordDict\n    | RecaptchaDict\n    | EmailIdentityDict\n    | { type: Exclude<string, AuthType>; [key: string]: any }\n    // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n    | {};\n\nexport class NoAuthFlowFoundError extends Error {\n    public name = \"NoAuthFlowFoundError\";\n\n    public constructor(\n        m: string,\n        // eslint-disable-next-line @typescript-eslint/naming-convention, camelcase\n        public readonly required_stages: string[],\n        public readonly flows: UIAFlow[],\n    ) {\n        super(m);\n    }\n}\n\n/**\n * The type of an application callback to perform the user-interactive bit of UIA.\n *\n * It is called with a single parameter, `makeRequest`, which is a function which takes the UIA parameters and\n * makes the HTTP request. The `authData` parameter in `makeRequest` can be set to null to omit the `auth` field\n * from the UIA request.\n *\n * The generic parameter `T` is the type of the response of the endpoint, once it is eventually successful.\n */\nexport type UIAuthCallback<T> = (makeRequest: (authData: AuthDict | null) => Promise<T>) => Promise<T>;\n\ninterface IOpts<T> {\n    /**\n     * A matrix client to use for the auth process\n     */\n    matrixClient: MatrixClient;\n    /**\n     * Error response from the last request. If null, a request will be made with no auth before starting.\n     */\n    authData?: IAuthData;\n    /**\n     * Inputs provided by the user and used by different stages of the auto process.\n     * The inputs provided will affect what flow is chosen.\n     */\n    inputs?: IInputs;\n    /**\n     * If resuming an existing interactive auth session, the sessionId of that session.\n     */\n    sessionId?: string;\n    /**\n     * If resuming an existing interactive auth session, the client secret for that session\n     */\n    clientSecret?: string;\n    /**\n     * If returning from having completed m.login.email.identity auth, the sid for the email verification session.\n     */\n    emailSid?: string;\n\n    /**\n     * If specified, will prefer flows which entirely consist of listed stages.\n     * These should normally be of type AuthTypes but can be string when supporting custom auth stages.\n     *\n     * This can be used to avoid needing the fallback mechanism.\n     */\n    supportedStages?: Array<AuthType | string>;\n\n    /**\n     * Called with the new auth dict to submit the request.\n     * Also passes a second deprecated arg which is a flag set to true if this request is a background request.\n     * The busyChanged callback should be used instead of the background flag.\n     * Should return a promise which resolves to the successful response or rejects with a MatrixError.\n     */\n    doRequest(this: void, auth: AuthDict | null, background: boolean): Promise<T>;\n    /**\n     * Called when the status of the UI auth changes,\n     * ie. when the state of an auth stage changes of when the auth flow moves to a new stage.\n     * The arguments are: the login type (eg m.login.password); and an object which is either an error or an\n     * informational object specific to the login type.\n     * If the 'errcode' key is defined, the object is an error, and has keys:\n     *     errcode: string, the textual error code, eg. M_UNKNOWN\n     *     error: string, human readable string describing the error\n     *\n     * The login type specific objects are as follows:\n     *     m.login.email.identity:\n     *         * emailSid: string, the sid of the active email auth session\n     */\n    stateUpdated(this: void, nextStage: AuthType | string, status: IStageStatus): void;\n\n    /**\n     * A function that takes the email address (string), clientSecret (string), attempt number (int) and\n     * sessionId (string) and calls the relevant requestToken function and returns the promise returned by that\n     * function.\n     * If the resulting promise rejects, the rejection will propagate through to the attemptAuth promise.\n     */\n    requestEmailToken(\n        this: void,\n        email: string,\n        secret: string,\n        attempt: number,\n        session: string,\n    ): Promise<{ sid: string }>;\n    /**\n     * Called whenever the interactive auth logic becomes busy submitting information provided by the user or finishes.\n     * After this has been called with true the UI should indicate that a request is in progress\n     * until it is called again with false.\n     */\n    busyChanged?(this: void, busy: boolean): void;\n    startAuthStage?(this: void, nextStage: string): Promise<void>; // LEGACY\n}\n\n/**\n * Abstracts the logic used to drive the interactive auth process.\n *\n * <p>Components implementing an interactive auth flow should instantiate one of\n * these, passing in the necessary callbacks to the constructor. They should\n * then call attemptAuth, which will return a promise which will resolve or\n * reject when the interactive-auth process completes.\n *\n * <p>Meanwhile, calls will be made to the startAuthStage and doRequest\n * callbacks, and information gathered from the user can be submitted with\n * submitAuthDict.\n *\n * @param opts - options object\n * @typeParam T - the return type of the request when it is successful\n */\nexport class InteractiveAuth<T> {\n    private readonly matrixClient: MatrixClient;\n    private readonly inputs: IInputs;\n    private readonly clientSecret: string;\n    private readonly requestCallback: IOpts<T>[\"doRequest\"];\n    private readonly busyChangedCallback?: IOpts<T>[\"busyChanged\"];\n    private readonly stateUpdatedCallback: IOpts<T>[\"stateUpdated\"];\n    private readonly requestEmailTokenCallback: IOpts<T>[\"requestEmailToken\"];\n    private readonly supportedStages?: Set<string>;\n\n    // The current latest data or error received from the server during the user interactive auth flow.\n    private data: IAuthData & MatrixError[\"data\"];\n    private emailSid?: string;\n    private requestingEmailToken = false;\n    private attemptAuthDeferred: PromiseWithResolvers<T> | null = null;\n    private chosenFlow: UIAFlow | null = null;\n    private currentStage: string | null = null;\n\n    private emailAttempt = 1;\n\n    // if we are currently trying to submit an auth dict (which includes polling)\n    // the promise the will resolve/reject when it completes\n    private submitPromise: Promise<void> | null = null;\n\n    public constructor(opts: IOpts<T>) {\n        this.matrixClient = opts.matrixClient;\n        this.data = opts.authData || { flows: [] };\n        this.requestCallback = opts.doRequest;\n        this.busyChangedCallback = opts.busyChanged;\n        // startAuthStage included for backwards compat\n        this.stateUpdatedCallback = opts.stateUpdated || opts.startAuthStage;\n        this.requestEmailTokenCallback = opts.requestEmailToken;\n        this.inputs = opts.inputs || {};\n\n        if (opts.sessionId) this.data.session = opts.sessionId;\n        this.clientSecret = opts.clientSecret || this.matrixClient.generateClientSecret();\n        this.emailSid = opts.emailSid;\n        if (opts.supportedStages !== undefined) this.supportedStages = new Set(opts.supportedStages);\n    }\n\n    /**\n     * begin the authentication process.\n     *\n     * @returns which resolves to the response on success,\n     * or rejects with the error on failure. Rejects with NoAuthFlowFoundError if\n     *     no suitable authentication flow can be found\n     */\n    public async attemptAuth(): Promise<T> {\n        // This promise will be quite long-lived and will resolve when the\n        // request is authenticated and completes successfully.\n        this.attemptAuthDeferred = Promise.withResolvers();\n        // pluck the promise out now, as doRequest may clear before we return\n        const promise = this.attemptAuthDeferred.promise;\n\n        // if we have no flows, try a request to acquire the flows\n        if (!(this.data as IAuthData)?.flows?.length) {\n            this.busyChangedCallback?.(true);\n            // use the existing sessionId, if one is present.\n            const auth = (this.data as IAuthData).session ? { session: (this.data as IAuthData).session } : null;\n            this.doRequest(auth).finally(() => {\n                this.busyChangedCallback?.(false);\n            });\n        } else {\n            this.startNextAuthStage();\n        }\n\n        return promise;\n    }\n\n    /**\n     * Poll to check if the auth session or current stage has been\n     * completed out-of-band. If so, the attemptAuth promise will\n     * be resolved.\n     */\n    public async poll(): Promise<void> {\n        if (!(this.data as IAuthData).session) return;\n        // likewise don't poll if there is no auth session in progress\n        if (!this.attemptAuthDeferred) return;\n        // if we currently have a request in flight, there's no point making\n        // another just to check what the status is\n        if (this.submitPromise) return;\n\n        let authDict: AuthDict = {};\n        if (this.currentStage == EMAIL_STAGE_TYPE) {\n            // The email can be validated out-of-band, but we need to provide the\n            // creds so the HS can go & check it.\n            if (this.emailSid) {\n                const creds: Record<string, string> = {\n                    sid: this.emailSid,\n                    client_secret: this.clientSecret,\n                };\n                const isUrl = this.matrixClient.getIdentityServerUrl();\n                if (isUrl) {\n                    creds.id_server = new URL(isUrl).host;\n                }\n                authDict = {\n                    type: EMAIL_STAGE_TYPE,\n                    threepid_creds: creds,\n                };\n            }\n        }\n\n        this.submitAuthDict(authDict, true);\n    }\n\n    /**\n     * get the auth session ID\n     *\n     * @returns session id\n     */\n    public getSessionId(): string | undefined {\n        return (this.data as IAuthData)?.session;\n    }\n\n    /**\n     * get the client secret used for validation sessions\n     * with the identity server.\n     *\n     * @returns client secret\n     */\n    public getClientSecret(): string {\n        return this.clientSecret;\n    }\n\n    /**\n     * get the server params for a given stage\n     *\n     * @param loginType - login type for the stage\n     * @returns any parameters from the server for this stage\n     */\n    public getStageParams(loginType: string): Record<string, any> | undefined {\n        return (this.data as IAuthData)?.params?.[loginType];\n    }\n\n    public getChosenFlow(): UIAFlow | null {\n        return this.chosenFlow;\n    }\n\n    /**\n     * submit a new auth dict and fire off the request. This will either\n     * make attemptAuth resolve/reject, or cause the startAuthStage callback\n     * to be called for a new stage.\n     *\n     * @param authData - new auth dict to send to the server. Should\n     *    include a `type` property denoting the login type, as well as any\n     *    other params for that stage.\n     * @param background - If true, this request failing will not result\n     *    in the attemptAuth promise being rejected. This can be set to true\n     *    for requests that just poll to see if auth has been completed elsewhere.\n     */\n    public async submitAuthDict(authData: AuthDict, background = false): Promise<void> {\n        if (!this.attemptAuthDeferred) {\n            throw new Error(\"submitAuthDict() called before attemptAuth()\");\n        }\n\n        if (!background) {\n            this.busyChangedCallback?.(true);\n        }\n\n        // if we're currently trying a request, wait for it to finish\n        // as otherwise we can get multiple 200 responses which can mean\n        // things like multiple logins for register requests.\n        // (but discard any exceptions as we only care when its done,\n        // not whether it worked or not)\n        while (this.submitPromise) {\n            try {\n                await this.submitPromise;\n            } catch {}\n        }\n\n        // use the sessionid from the last request, if one is present.\n        let auth: AuthDict;\n        if ((this.data as IAuthData)?.session) {\n            auth = Object.assign(\n                {\n                    session: (this.data as IAuthData).session,\n                },\n                authData,\n            );\n        } else {\n            auth = authData;\n        }\n\n        try {\n            // NB. the 'background' flag is deprecated by the busyChanged\n            // callback and is here for backwards compat\n            this.submitPromise = this.doRequest(auth, background);\n            await this.submitPromise;\n        } finally {\n            this.submitPromise = null;\n            if (!background) {\n                this.busyChangedCallback?.(false);\n            }\n        }\n    }\n\n    /**\n     * Gets the sid for the email validation session\n     * Specific to m.login.email.identity\n     *\n     * @returns The sid of the email auth session\n     */\n    public getEmailSid(): string | undefined {\n        return this.emailSid;\n    }\n\n    /**\n     * Sets the sid for the email validation session\n     * This must be set in order to successfully poll for completion\n     * of the email validation.\n     * Specific to m.login.email.identity\n     *\n     * @param sid - The sid for the email validation session\n     */\n    public setEmailSid(sid: string): void {\n        this.emailSid = sid;\n    }\n\n    /**\n     * Requests a new email token and sets the email sid for the validation session\n     */\n    public requestEmailToken = async (): Promise<void> => {\n        if (!this.requestingEmailToken) {\n            logger.trace(\"Requesting email token. Attempt: \" + this.emailAttempt);\n            // If we've picked a flow with email auth, we send the email\n            // now because we want the request to fail as soon as possible\n            // if the email address is not valid (ie. already taken or not\n            // registered, depending on what the operation is).\n            this.requestingEmailToken = true;\n            try {\n                const requestTokenResult = await this.requestEmailTokenCallback(\n                    this.inputs.emailAddress!,\n                    this.clientSecret,\n                    this.emailAttempt++,\n                    (this.data as IAuthData).session!,\n                );\n                this.emailSid = requestTokenResult.sid;\n                logger.trace(\"Email token request succeeded\");\n            } finally {\n                this.requestingEmailToken = false;\n            }\n        } else {\n            logger.warn(\"Could not request email token: Already requesting\");\n        }\n    };\n\n    /**\n     * Fire off a request, and either resolve the promise, or call\n     * startAuthStage.\n     *\n     * @internal\n     * @param auth - new auth dict, including session id\n     * @param background - If true, this request is a background poll, so it\n     *    failing will not result in the attemptAuth promise being rejected.\n     *    This can be set to true for requests that just poll to see if auth has\n     *    been completed elsewhere.\n     */\n    private async doRequest(auth: AuthDict | null, background = false): Promise<void> {\n        try {\n            const result = await this.requestCallback(auth, background);\n            this.attemptAuthDeferred!.resolve(result);\n            this.attemptAuthDeferred = null;\n        } catch (error) {\n            const matrixError = error instanceof MatrixError ? error : null;\n\n            // sometimes UI auth errors don't come with flows\n            const errorFlows = matrixError?.data?.flows ?? null;\n            const haveFlows = (this.data as IAuthData)?.flows || Boolean(errorFlows);\n            if (!matrixError || matrixError.httpStatus !== 401 || !matrixError.data || !haveFlows) {\n                // doesn't look like an interactive-auth failure.\n                if (!background) {\n                    this.attemptAuthDeferred?.reject(error);\n                } else {\n                    // We ignore all failures here (even non-UI auth related ones)\n                    // since we don't want to suddenly fail if the internet connection\n                    // had a blip whilst we were polling\n                    logger.log(\"Background poll request failed doing UI auth: ignoring\", error);\n                }\n            }\n            if (matrixError && !matrixError.data) {\n                matrixError.data = {};\n            }\n            // if the error didn't come with flows, completed flows or session ID,\n            // copy over the ones we have. Synapse sometimes sends responses without\n            // any UI auth data (eg. when polling for email validation, if the email\n            // has not yet been validated). This appears to be a Synapse bug, which\n            // we workaround here.\n            if (matrixError && !matrixError.data.flows && !matrixError.data.completed && !matrixError.data.session) {\n                matrixError.data.flows = (this.data as IAuthData).flows;\n                matrixError.data.completed = (this.data as IAuthData).completed;\n                matrixError.data.session = (this.data as IAuthData).session;\n            }\n            if (matrixError) {\n                this.data = matrixError.data;\n            }\n            try {\n                this.startNextAuthStage();\n            } catch (e) {\n                this.attemptAuthDeferred!.reject(e);\n                this.attemptAuthDeferred = null;\n                return;\n            }\n\n            if (!this.emailSid && this.chosenFlow?.stages.includes(AuthType.Email)) {\n                try {\n                    await this.requestEmailToken();\n                    // NB. promise is not resolved here - at some point, doRequest\n                    // will be called again and if the user has jumped through all\n                    // the hoops correctly, auth will be complete and the request\n                    // will succeed.\n                    // Also, we should expose the fact that this request has compledted\n                    // so clients can know that the email has actually been sent.\n                } catch (e) {\n                    // we failed to request an email token, so fail the request.\n                    // This could be due to the email already beeing registered\n                    // (or not being registered, depending on what we're trying\n                    // to do) or it could be a network failure. Either way, pass\n                    // the failure up as the user can't complete auth if we can't\n                    // send the email, for whatever reason.\n                    this.attemptAuthDeferred!.reject(e);\n                    this.attemptAuthDeferred = null;\n                }\n            }\n        }\n    }\n\n    /**\n     * Pick the next stage and call the callback\n     *\n     * @internal\n     * @throws {@link NoAuthFlowFoundError} If no suitable authentication flow can be found\n     */\n    private startNextAuthStage(): void {\n        const nextStage = this.chooseStage();\n        if (!nextStage) {\n            throw new Error(\"No incomplete flows from the server\");\n        }\n        this.currentStage = nextStage;\n\n        if (nextStage === AuthType.Dummy) {\n            this.submitAuthDict({\n                type: \"m.login.dummy\",\n            });\n            return;\n        }\n\n        if (this.data?.errcode || this.data?.error) {\n            this.stateUpdatedCallback(nextStage, {\n                errcode: this.data?.errcode || \"\",\n                error: this.data?.error || \"\",\n            });\n            return;\n        }\n\n        this.stateUpdatedCallback(nextStage, nextStage === EMAIL_STAGE_TYPE ? { emailSid: this.emailSid } : {});\n    }\n\n    /**\n     * Pick the next auth stage\n     *\n     * @internal\n     * @returns login type\n     * @throws {@link NoAuthFlowFoundError} If no suitable authentication flow can be found\n     */\n    private chooseStage(): AuthType | string | undefined {\n        if (this.chosenFlow === null) {\n            this.chosenFlow = this.chooseFlow();\n        }\n        logger.log(\"Active flow => %s\", JSON.stringify(this.chosenFlow));\n        const nextStage = this.firstUncompletedStage(this.chosenFlow);\n        logger.log(\"Next stage: %s\", nextStage);\n        return nextStage;\n    }\n\n    // Returns a low number for flows we consider best. Counts increase for longer flows and even more so\n    // for flows which contain stages not listed in `supportedStages`.\n    private scoreFlow(flow: UIAFlow): number {\n        let score = flow.stages.length;\n        if (this.supportedStages !== undefined) {\n            // Add 10 points to the score for each unsupported stage in the flow.\n            score += flow.stages.filter((stage) => !this.supportedStages!.has(stage)).length * 10;\n        }\n        return score;\n    }\n\n    /**\n     * Pick one of the flows from the returned list\n     * If a flow using all of the inputs is found, it will\n     * be returned, otherwise, null will be returned.\n     *\n     * Only flows using all given inputs are chosen because it\n     * is likely to be surprising if the user provides a\n     * credential and it is not used. For example, for registration,\n     * this could result in the email not being used which would leave\n     * the account with no means to reset a password.\n     *\n     * @internal\n     * @returns flow\n     * @throws {@link NoAuthFlowFoundError} If no suitable authentication flow can be found\n     */\n    private chooseFlow(): UIAFlow {\n        const flows = (this.data as IAuthData)?.flows || [];\n\n        // we've been given an email or we've already done an email part\n        const haveEmail = Boolean(this.inputs.emailAddress) || Boolean(this.emailSid);\n        const haveMsisdn = Boolean(this.inputs.phoneCountry) && Boolean(this.inputs.phoneNumber);\n\n        // Flows are not represented in a significant order, so we can choose any we support best\n        // Sort flows based on how many unsupported stages they contain ascending\n        flows.sort((a, b) => this.scoreFlow(a) - this.scoreFlow(b));\n\n        for (const flow of flows) {\n            let flowHasEmail = false;\n            let flowHasMsisdn = false;\n            for (const stage of flow.stages) {\n                if (stage === EMAIL_STAGE_TYPE) {\n                    flowHasEmail = true;\n                } else if (stage == MSISDN_STAGE_TYPE) {\n                    flowHasMsisdn = true;\n                }\n            }\n\n            if (flowHasEmail == haveEmail && flowHasMsisdn == haveMsisdn) {\n                return flow;\n            }\n        }\n\n        const requiredStages: string[] = [];\n        if (haveEmail) requiredStages.push(EMAIL_STAGE_TYPE);\n        if (haveMsisdn) requiredStages.push(MSISDN_STAGE_TYPE);\n        // Throw an error with a fairly generic description, but with more\n        // information such that the app can give a better one if so desired.\n        throw new NoAuthFlowFoundError(\"No appropriate authentication flow found\", requiredStages, flows);\n    }\n\n    /**\n     * Get the first uncompleted stage in the given flow\n     *\n     * @internal\n     * @returns login type\n     */\n    private firstUncompletedStage(flow: UIAFlow): AuthType | string | undefined {\n        const completed = (this.data as IAuthData)?.completed || [];\n        return flow.stages.find((stageType) => !completed.includes(stageType));\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"interactive-auth.js","names":[],"sources":["../src/interactive-auth.ts"],"sourcesContent":["/*\nCopyright 2016 OpenMarket Ltd\nCopyright 2017 Vector Creations Ltd\nCopyright 2019 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 { logger } from \"./logger.ts\";\nimport { type MatrixClient } from \"./client.ts\";\nimport { MatrixError } from \"./http-api/index.ts\";\nimport { type UserIdentifier } from \"./@types/auth.ts\";\n\nconst EMAIL_STAGE_TYPE = \"m.login.email.identity\";\nconst MSISDN_STAGE_TYPE = \"m.login.msisdn\";\n\nexport interface UIAFlow {\n    stages: Array<AuthType | string>;\n}\n\nexport interface IInputs {\n    // An email address. If supplied, a flow using email verification will be chosen.\n    emailAddress?: string;\n    // An ISO two letter country code. Gives the country that opts.phoneNumber should be resolved relative to.\n    phoneCountry?: string;\n    // A phone number. If supplied, a flow using phone number validation will be chosen.\n    phoneNumber?: string;\n    registrationToken?: string;\n}\n\nexport interface IStageStatus {\n    emailSid?: string;\n    errcode?: string;\n    error?: string;\n}\n\n/**\n * Data returned in the body of a 401 response from a UIA endpoint.\n *\n * @see https://spec.matrix.org/v1.6/client-server-api/#user-interactive-api-in-the-rest-api\n */\nexport interface IAuthData {\n    /**\n     * This is a session identifier that the client must pass back to the home server,\n     * if one is provided, in subsequent attempts to authenticate in the same API call.\n     */\n    session?: string;\n    /**\n     * A list of the stages the client has completed successfully\n     */\n    completed?: string[];\n    /**\n     * A list of the login flows supported by the server for this API.\n     */\n    flows?: UIAFlow[];\n    /**\n     * Contains any information that the client will need to know in order to use a given type of authentication.\n     * For each login type presented, that type may be present as a key in this dictionary.\n     * For example, the public part of an OAuth client ID could be given here.\n     */\n    params?: Record<string, Record<string, any>>;\n}\n\nexport enum AuthType {\n    Password = \"m.login.password\",\n    Recaptcha = \"m.login.recaptcha\",\n    Terms = \"m.login.terms\",\n    Email = \"m.login.email.identity\",\n    Msisdn = \"m.login.msisdn\",\n    Sso = \"m.login.sso\",\n    SsoUnstable = \"org.matrix.login.sso\",\n    Dummy = \"m.login.dummy\",\n    RegistrationToken = \"m.login.registration_token\",\n    // For backwards compatability with servers that have not yet updated to\n    // use the stable \"m.login.registration_token\" type.\n    // The authentication flow is the same in both cases.\n    UnstableRegistrationToken = \"org.matrix.msc3231.login.registration_token\",\n    /**\n     * m.oauth stage introduced by MSC4312:\n     * https://spec.matrix.org/v1.17/client-server-api/#oauth-authentication\n     */\n    OAuth = \"m.oauth\",\n}\n\n/**\n * https://spec.matrix.org/v1.7/client-server-api/#password-based\n */\ntype PasswordDict = {\n    type: AuthType.Password;\n    identifier: UserIdentifier;\n    password: string;\n    session: string;\n};\n\n/**\n * https://spec.matrix.org/v1.7/client-server-api/#google-recaptcha\n */\ntype RecaptchaDict = {\n    type: AuthType.Recaptcha;\n    response: string;\n    session: string;\n};\n\ninterface ThreepidCreds {\n    sid: string;\n    client_secret: string;\n    id_server: string;\n    id_access_token: string;\n}\n\n/**\n * https://spec.matrix.org/v1.7/client-server-api/#email-based-identity--homeserver\n */\ntype EmailIdentityDict = {\n    type: AuthType.Email;\n    threepid_creds: ThreepidCreds;\n    session: string;\n};\n\n/**\n * The parameters which are submitted as the `auth` dict in a UIA request\n *\n * @see https://spec.matrix.org/v1.6/client-server-api/#authentication-types\n */\nexport type AuthDict =\n    | PasswordDict\n    | RecaptchaDict\n    | EmailIdentityDict\n    | { type: Exclude<string, AuthType>; [key: string]: any }\n    // eslint-disable-next-line @typescript-eslint/no-empty-object-type\n    | {};\n\nexport class NoAuthFlowFoundError extends Error {\n    public name = \"NoAuthFlowFoundError\";\n\n    public constructor(\n        m: string,\n        public readonly required_stages: string[],\n        public readonly flows: UIAFlow[],\n    ) {\n        super(m);\n    }\n}\n\n/**\n * The type of an application callback to perform the user-interactive bit of UIA.\n *\n * It is called with a single parameter, `makeRequest`, which is a function which takes the UIA parameters and\n * makes the HTTP request. The `authData` parameter in `makeRequest` can be set to null to omit the `auth` field\n * from the UIA request.\n *\n * The generic parameter `T` is the type of the response of the endpoint, once it is eventually successful.\n */\nexport type UIAuthCallback<T> = (makeRequest: (authData: AuthDict | null) => Promise<T>) => Promise<T>;\n\ninterface IOpts<T> {\n    /**\n     * A matrix client to use for the auth process\n     */\n    matrixClient: MatrixClient;\n    /**\n     * Error response from the last request. If null, a request will be made with no auth before starting.\n     */\n    authData?: IAuthData;\n    /**\n     * Inputs provided by the user and used by different stages of the auto process.\n     * The inputs provided will affect what flow is chosen.\n     */\n    inputs?: IInputs;\n    /**\n     * If resuming an existing interactive auth session, the sessionId of that session.\n     */\n    sessionId?: string;\n    /**\n     * If resuming an existing interactive auth session, the client secret for that session\n     */\n    clientSecret?: string;\n    /**\n     * If returning from having completed m.login.email.identity auth, the sid for the email verification session.\n     */\n    emailSid?: string;\n\n    /**\n     * If specified, will prefer flows which entirely consist of listed stages.\n     * These should normally be of type AuthTypes but can be string when supporting custom auth stages.\n     *\n     * This can be used to avoid needing the fallback mechanism.\n     */\n    supportedStages?: Array<AuthType | string>;\n\n    /**\n     * Called with the new auth dict to submit the request.\n     * Also passes a second deprecated arg which is a flag set to true if this request is a background request.\n     * The busyChanged callback should be used instead of the background flag.\n     * Should return a promise which resolves to the successful response or rejects with a MatrixError.\n     */\n    doRequest(this: void, auth: AuthDict | null, background: boolean): Promise<T>;\n    /**\n     * Called when the status of the UI auth changes,\n     * ie. when the state of an auth stage changes of when the auth flow moves to a new stage.\n     * The arguments are: the login type (eg m.login.password); and an object which is either an error or an\n     * informational object specific to the login type.\n     * If the 'errcode' key is defined, the object is an error, and has keys:\n     *     errcode: string, the textual error code, eg. M_UNKNOWN\n     *     error: string, human readable string describing the error\n     *\n     * The login type specific objects are as follows:\n     *     m.login.email.identity:\n     *         * emailSid: string, the sid of the active email auth session\n     */\n    stateUpdated(this: void, nextStage: AuthType | string, status: IStageStatus): void;\n\n    /**\n     * A function that takes the email address (string), clientSecret (string), attempt number (int) and\n     * sessionId (string) and calls the relevant requestToken function and returns the promise returned by that\n     * function.\n     * If the resulting promise rejects, the rejection will propagate through to the attemptAuth promise.\n     */\n    requestEmailToken(\n        this: void,\n        email: string,\n        secret: string,\n        attempt: number,\n        session: string,\n    ): Promise<{ sid: string }>;\n    /**\n     * Called whenever the interactive auth logic becomes busy submitting information provided by the user or finishes.\n     * After this has been called with true the UI should indicate that a request is in progress\n     * until it is called again with false.\n     */\n    busyChanged?(this: void, busy: boolean): void;\n    startAuthStage?(this: void, nextStage: string): Promise<void>; // LEGACY\n}\n\n/**\n * Abstracts the logic used to drive the interactive auth process.\n *\n * <p>Components implementing an interactive auth flow should instantiate one of\n * these, passing in the necessary callbacks to the constructor. They should\n * then call attemptAuth, which will return a promise which will resolve or\n * reject when the interactive-auth process completes.\n *\n * <p>Meanwhile, calls will be made to the startAuthStage and doRequest\n * callbacks, and information gathered from the user can be submitted with\n * submitAuthDict.\n *\n * @param opts - options object\n * @typeParam T - the return type of the request when it is successful\n */\nexport class InteractiveAuth<T> {\n    private readonly matrixClient: MatrixClient;\n    private readonly inputs: IInputs;\n    private readonly clientSecret: string;\n    private readonly requestCallback: IOpts<T>[\"doRequest\"];\n    private readonly busyChangedCallback?: IOpts<T>[\"busyChanged\"];\n    private readonly stateUpdatedCallback: IOpts<T>[\"stateUpdated\"];\n    private readonly requestEmailTokenCallback: IOpts<T>[\"requestEmailToken\"];\n    private readonly supportedStages?: Set<string>;\n\n    // The current latest data or error received from the server during the user interactive auth flow.\n    private data: IAuthData & MatrixError[\"data\"];\n    private emailSid?: string;\n    private requestingEmailToken = false;\n    private attemptAuthDeferred: PromiseWithResolvers<T> | null = null;\n    private chosenFlow: UIAFlow | null = null;\n    private currentStage: string | null = null;\n\n    private emailAttempt = 1;\n\n    // if we are currently trying to submit an auth dict (which includes polling)\n    // the promise the will resolve/reject when it completes\n    private submitPromise: Promise<void> | null = null;\n\n    public constructor(opts: IOpts<T>) {\n        this.matrixClient = opts.matrixClient;\n        this.data = opts.authData || { flows: [] };\n        this.requestCallback = opts.doRequest;\n        this.busyChangedCallback = opts.busyChanged;\n        // startAuthStage included for backwards compat\n        this.stateUpdatedCallback = opts.stateUpdated || opts.startAuthStage;\n        this.requestEmailTokenCallback = opts.requestEmailToken;\n        this.inputs = opts.inputs || {};\n\n        if (opts.sessionId) this.data.session = opts.sessionId;\n        this.clientSecret = opts.clientSecret || this.matrixClient.generateClientSecret();\n        this.emailSid = opts.emailSid;\n        if (opts.supportedStages !== undefined) this.supportedStages = new Set(opts.supportedStages);\n    }\n\n    /**\n     * begin the authentication process.\n     *\n     * @returns which resolves to the response on success,\n     * or rejects with the error on failure. Rejects with NoAuthFlowFoundError if\n     *     no suitable authentication flow can be found\n     */\n    public async attemptAuth(): Promise<T> {\n        // This promise will be quite long-lived and will resolve when the\n        // request is authenticated and completes successfully.\n        this.attemptAuthDeferred = Promise.withResolvers();\n        // pluck the promise out now, as doRequest may clear before we return\n        const promise = this.attemptAuthDeferred.promise;\n\n        // if we have no flows, try a request to acquire the flows\n        if (!(this.data as IAuthData)?.flows?.length) {\n            this.busyChangedCallback?.(true);\n            // use the existing sessionId, if one is present.\n            const auth = (this.data as IAuthData).session ? { session: (this.data as IAuthData).session } : null;\n            this.doRequest(auth).finally(() => {\n                this.busyChangedCallback?.(false);\n            });\n        } else {\n            this.startNextAuthStage();\n        }\n\n        return promise;\n    }\n\n    /**\n     * Poll to check if the auth session or current stage has been\n     * completed out-of-band. If so, the attemptAuth promise will\n     * be resolved.\n     */\n    public async poll(): Promise<void> {\n        if (!(this.data as IAuthData).session) return;\n        // likewise don't poll if there is no auth session in progress\n        if (!this.attemptAuthDeferred) return;\n        // if we currently have a request in flight, there's no point making\n        // another just to check what the status is\n        if (this.submitPromise) return;\n\n        let authDict: AuthDict = {};\n        if (this.currentStage == EMAIL_STAGE_TYPE) {\n            // The email can be validated out-of-band, but we need to provide the\n            // creds so the HS can go & check it.\n            if (this.emailSid) {\n                const creds: Record<string, string> = {\n                    sid: this.emailSid,\n                    client_secret: this.clientSecret,\n                };\n                const isUrl = this.matrixClient.getIdentityServerUrl();\n                if (isUrl) {\n                    creds.id_server = new URL(isUrl).host;\n                }\n                authDict = {\n                    type: EMAIL_STAGE_TYPE,\n                    threepid_creds: creds,\n                };\n            }\n        }\n\n        this.submitAuthDict(authDict, true);\n    }\n\n    /**\n     * get the auth session ID\n     *\n     * @returns session id\n     */\n    public getSessionId(): string | undefined {\n        return (this.data as IAuthData)?.session;\n    }\n\n    /**\n     * get the client secret used for validation sessions\n     * with the identity server.\n     *\n     * @returns client secret\n     */\n    public getClientSecret(): string {\n        return this.clientSecret;\n    }\n\n    /**\n     * get the server params for a given stage\n     *\n     * @param loginType - login type for the stage\n     * @returns any parameters from the server for this stage\n     */\n    public getStageParams(loginType: string): Record<string, any> | undefined {\n        return (this.data as IAuthData)?.params?.[loginType];\n    }\n\n    public getChosenFlow(): UIAFlow | null {\n        return this.chosenFlow;\n    }\n\n    /**\n     * submit a new auth dict and fire off the request. This will either\n     * make attemptAuth resolve/reject, or cause the startAuthStage callback\n     * to be called for a new stage.\n     *\n     * @param authData - new auth dict to send to the server. Should\n     *    include a `type` property denoting the login type, as well as any\n     *    other params for that stage.\n     * @param background - If true, this request failing will not result\n     *    in the attemptAuth promise being rejected. This can be set to true\n     *    for requests that just poll to see if auth has been completed elsewhere.\n     */\n    public async submitAuthDict(authData: AuthDict, background = false): Promise<void> {\n        if (!this.attemptAuthDeferred) {\n            throw new Error(\"submitAuthDict() called before attemptAuth()\");\n        }\n\n        if (!background) {\n            this.busyChangedCallback?.(true);\n        }\n\n        // if we're currently trying a request, wait for it to finish\n        // as otherwise we can get multiple 200 responses which can mean\n        // things like multiple logins for register requests.\n        while (this.submitPromise) {\n            try {\n                await this.submitPromise;\n            } catch {\n                // discard any exceptions as we only care when its done,\n                // not whether it worked or not\n            }\n        }\n\n        // use the sessionid from the last request, if one is present.\n        let auth: AuthDict;\n        if ((this.data as IAuthData)?.session) {\n            auth = Object.assign(\n                {\n                    session: (this.data as IAuthData).session,\n                },\n                authData,\n            );\n        } else {\n            auth = authData;\n        }\n\n        try {\n            // NB. the 'background' flag is deprecated by the busyChanged\n            // callback and is here for backwards compat\n            this.submitPromise = this.doRequest(auth, background);\n            await this.submitPromise;\n        } finally {\n            this.submitPromise = null;\n            if (!background) {\n                this.busyChangedCallback?.(false);\n            }\n        }\n    }\n\n    /**\n     * Gets the sid for the email validation session\n     * Specific to m.login.email.identity\n     *\n     * @returns The sid of the email auth session\n     */\n    public getEmailSid(): string | undefined {\n        return this.emailSid;\n    }\n\n    /**\n     * Sets the sid for the email validation session\n     * This must be set in order to successfully poll for completion\n     * of the email validation.\n     * Specific to m.login.email.identity\n     *\n     * @param sid - The sid for the email validation session\n     */\n    public setEmailSid(sid: string): void {\n        this.emailSid = sid;\n    }\n\n    /**\n     * Requests a new email token and sets the email sid for the validation session\n     */\n    public requestEmailToken = async (): Promise<void> => {\n        if (!this.requestingEmailToken) {\n            logger.trace(\"Requesting email token. Attempt: \" + this.emailAttempt);\n            // If we've picked a flow with email auth, we send the email\n            // now because we want the request to fail as soon as possible\n            // if the email address is not valid (ie. already taken or not\n            // registered, depending on what the operation is).\n            this.requestingEmailToken = true;\n            try {\n                const requestTokenResult = await this.requestEmailTokenCallback(\n                    this.inputs.emailAddress!,\n                    this.clientSecret,\n                    this.emailAttempt++,\n                    (this.data as IAuthData).session!,\n                );\n                this.emailSid = requestTokenResult.sid;\n                logger.trace(\"Email token request succeeded\");\n            } finally {\n                this.requestingEmailToken = false;\n            }\n        } else {\n            logger.warn(\"Could not request email token: Already requesting\");\n        }\n    };\n\n    /**\n     * Fire off a request, and either resolve the promise, or call\n     * startAuthStage.\n     *\n     * @internal\n     * @param auth - new auth dict, including session id\n     * @param background - If true, this request is a background poll, so it\n     *    failing will not result in the attemptAuth promise being rejected.\n     *    This can be set to true for requests that just poll to see if auth has\n     *    been completed elsewhere.\n     */\n    private async doRequest(auth: AuthDict | null, background = false): Promise<void> {\n        try {\n            const result = await this.requestCallback(auth, background);\n            this.attemptAuthDeferred!.resolve(result);\n            this.attemptAuthDeferred = null;\n        } catch (error) {\n            const matrixError = error instanceof MatrixError ? error : null;\n\n            // sometimes UI auth errors don't come with flows\n            const errorFlows = matrixError?.data?.flows ?? null;\n            const haveFlows = (this.data as IAuthData)?.flows || Boolean(errorFlows);\n            if (!matrixError || matrixError.httpStatus !== 401 || !matrixError.data || !haveFlows) {\n                // doesn't look like an interactive-auth failure.\n                if (!background) {\n                    this.attemptAuthDeferred?.reject(error);\n                } else {\n                    // We ignore all failures here (even non-UI auth related ones)\n                    // since we don't want to suddenly fail if the internet connection\n                    // had a blip whilst we were polling\n                    logger.log(\"Background poll request failed doing UI auth: ignoring\", error);\n                }\n            }\n            if (matrixError && !matrixError.data) {\n                matrixError.data = {};\n            }\n            // if the error didn't come with flows, completed flows or session ID,\n            // copy over the ones we have. Synapse sometimes sends responses without\n            // any UI auth data (eg. when polling for email validation, if the email\n            // has not yet been validated). This appears to be a Synapse bug, which\n            // we workaround here.\n            if (matrixError && !matrixError.data.flows && !matrixError.data.completed && !matrixError.data.session) {\n                matrixError.data.flows = (this.data as IAuthData).flows;\n                matrixError.data.completed = (this.data as IAuthData).completed;\n                matrixError.data.session = (this.data as IAuthData).session;\n            }\n            if (matrixError) {\n                this.data = matrixError.data;\n            }\n            try {\n                this.startNextAuthStage();\n            } catch (e) {\n                this.attemptAuthDeferred!.reject(e);\n                this.attemptAuthDeferred = null;\n                return;\n            }\n\n            if (!this.emailSid && this.chosenFlow?.stages.includes(AuthType.Email)) {\n                try {\n                    await this.requestEmailToken();\n                    // NB. promise is not resolved here - at some point, doRequest\n                    // will be called again and if the user has jumped through all\n                    // the hoops correctly, auth will be complete and the request\n                    // will succeed.\n                    // Also, we should expose the fact that this request has compledted\n                    // so clients can know that the email has actually been sent.\n                } catch (e) {\n                    // we failed to request an email token, so fail the request.\n                    // This could be due to the email already beeing registered\n                    // (or not being registered, depending on what we're trying\n                    // to do) or it could be a network failure. Either way, pass\n                    // the failure up as the user can't complete auth if we can't\n                    // send the email, for whatever reason.\n                    this.attemptAuthDeferred!.reject(e);\n                    this.attemptAuthDeferred = null;\n                }\n            }\n        }\n    }\n\n    /**\n     * Pick the next stage and call the callback\n     *\n     * @internal\n     * @throws {@link NoAuthFlowFoundError} If no suitable authentication flow can be found\n     */\n    private startNextAuthStage(): void {\n        const nextStage = this.chooseStage();\n        if (!nextStage) {\n            throw new Error(\"No incomplete flows from the server\");\n        }\n        this.currentStage = nextStage;\n\n        if (nextStage === AuthType.Dummy) {\n            this.submitAuthDict({\n                type: \"m.login.dummy\",\n            });\n            return;\n        }\n\n        if (this.data?.errcode || this.data?.error) {\n            this.stateUpdatedCallback(nextStage, {\n                errcode: this.data?.errcode || \"\",\n                error: this.data?.error || \"\",\n            });\n            return;\n        }\n\n        this.stateUpdatedCallback(nextStage, nextStage === EMAIL_STAGE_TYPE ? { emailSid: this.emailSid } : {});\n    }\n\n    /**\n     * Pick the next auth stage\n     *\n     * @internal\n     * @returns login type\n     * @throws {@link NoAuthFlowFoundError} If no suitable authentication flow can be found\n     */\n    private chooseStage(): AuthType | string | undefined {\n        if (this.chosenFlow === null) {\n            this.chosenFlow = this.chooseFlow();\n        }\n        logger.log(\"Active flow => %s\", JSON.stringify(this.chosenFlow));\n        const nextStage = this.firstUncompletedStage(this.chosenFlow);\n        logger.log(\"Next stage: %s\", nextStage);\n        return nextStage;\n    }\n\n    // Returns a low number for flows we consider best. Counts increase for longer flows and even more so\n    // for flows which contain stages not listed in `supportedStages`.\n    private scoreFlow(flow: UIAFlow): number {\n        let score = flow.stages.length;\n        if (this.supportedStages !== undefined) {\n            // Add 10 points to the score for each unsupported stage in the flow.\n            score += flow.stages.filter((stage) => !this.supportedStages!.has(stage)).length * 10;\n        }\n        return score;\n    }\n\n    /**\n     * Pick one of the flows from the returned list\n     * If a flow using all of the inputs is found, it will\n     * be returned, otherwise, null will be returned.\n     *\n     * Only flows using all given inputs are chosen because it\n     * is likely to be surprising if the user provides a\n     * credential and it is not used. For example, for registration,\n     * this could result in the email not being used which would leave\n     * the account with no means to reset a password.\n     *\n     * @internal\n     * @returns flow\n     * @throws {@link NoAuthFlowFoundError} If no suitable authentication flow can be found\n     */\n    private chooseFlow(): UIAFlow {\n        const flows = (this.data as IAuthData)?.flows || [];\n\n        // we've been given an email or we've already done an email part\n        const haveEmail = Boolean(this.inputs.emailAddress) || Boolean(this.emailSid);\n        const haveMsisdn = Boolean(this.inputs.phoneCountry) && Boolean(this.inputs.phoneNumber);\n\n        // Flows are not represented in a significant order, so we can choose any we support best\n        // Sort flows based on how many unsupported stages they contain ascending\n        flows.sort((a, b) => this.scoreFlow(a) - this.scoreFlow(b));\n\n        for (const flow of flows) {\n            let flowHasEmail = false;\n            let flowHasMsisdn = false;\n            for (const stage of flow.stages) {\n                if (stage === EMAIL_STAGE_TYPE) {\n                    flowHasEmail = true;\n                } else if (stage == MSISDN_STAGE_TYPE) {\n                    flowHasMsisdn = true;\n                }\n            }\n\n            if (flowHasEmail == haveEmail && flowHasMsisdn == haveMsisdn) {\n                return flow;\n            }\n        }\n\n        const requiredStages: string[] = [];\n        if (haveEmail) requiredStages.push(EMAIL_STAGE_TYPE);\n        if (haveMsisdn) requiredStages.push(MSISDN_STAGE_TYPE);\n        // Throw an error with a fairly generic description, but with more\n        // information such that the app can give a better one if so desired.\n        throw new NoAuthFlowFoundError(\"No appropriate authentication flow found\", requiredStages, flows);\n    }\n\n    /**\n     * Get the first uncompleted stage in the given flow\n     *\n     * @internal\n     * @returns login type\n     */\n    private firstUncompletedStage(flow: UIAFlow): AuthType | string | undefined {\n        const completed = (this.data as IAuthData)?.completed || [];\n        return flow.stages.find((stageType) => !completed.includes(stageType));\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAmBA,sGAAsG;AACtG,UAAU,mBAAoB,SAAQ,MAAM;IACxC;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,MAAO,SAAQ,UAAU;IACtC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACvB;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEvC;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEvC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEtC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEtC;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC1C;AA4ED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAA0B,mBAAmB,CAAC;AAEjE;;;;;;;;;GASG;AACH,qBAAa,OAAQ,YAAW,UAAU;IAIlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAH3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IAEtB,YACqB,MAAM,EAAE,UAAU,EACnC,IAAI,EAAE,MAAM,EAGf;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAE/B;IAEM,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAE/B;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;CACJ;AAED;;;GAGG;AACH,UAAU,QAAQ;IACd,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACvC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAY,YAAW,MAAM;IACnB,OAAO,CAAC,aAAa;IAAxC,YAA2B,aAAa,EAAE,QAAQ,EAAI;IAE/C,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAE/B;IAEM,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAE/B;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAE9C;IAED,OAAO,CAAC,eAAe;CAiB1B"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAmBA,sGAAsG;AACtG,UAAU,mBAAoB,SAAQ,MAAM;IACxC;;;;;;OAMG;IACH,GAAG,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC5B;AAED,uDAAuD;AACvD,MAAM,WAAW,MAAO,SAAQ,UAAU;IACtC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;CACvC;AAED,sEAAsE;AACtE,MAAM,WAAW,UAAU;IACvB;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEvC;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEvC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEtC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAEtC;;;;OAIG;IACH,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC1C;AA0ED;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAA0B,mBAAmB,CAAC;AAEjE;;;;;;;;;GASG;AACH,qBAAa,OAAQ,YAAW,UAAU;IAIlC,OAAO,CAAC,QAAQ,CAAC,MAAM;IAH3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;IAEtB,YACqB,MAAM,EAAE,UAAU,EACnC,IAAI,EAAE,MAAM,EAGf;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAE/B;IAEM,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAE/B;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;CACJ;AAED;;;GAGG;AACH,UAAU,QAAQ;IACd,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IACvC,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,QAAQ,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,WAAY,YAAW,MAAM;IACnB,OAAO,CAAC,aAAa;IAAxC,YAA2B,aAAa,EAAE,QAAQ,EAAI;IAE/C,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAE/B;IAEM,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAE/B;IAEM,KAAK,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAEhC;IAEM,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAE9C;IAED,OAAO,CAAC,eAAe;CAiB1B"}

package/lib/logger.js

@@ -39,11 +39,9 @@ const DEFAULT_NAMESPACE = "matrix";
 // when logging so we always get the current value of console methods.
 loglevel.methodFactory = function (methodName, logLevel, loggerName) {
   return function (...args) {
-    /* eslint-disable @typescript-eslint/no-invalid-this */
     if (this.prefix) {
       args.unshift(this.prefix);
     }
-    /* eslint-enable @typescript-eslint/no-invalid-this */
     const supportedByConsole = methodName === "error" || methodName === "warn" || methodName === "trace" || methodName === "info" || methodName === "debug";
     /* eslint-disable no-console */
     if (supportedByConsole) {

package/lib/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","names":[],"sources":["../src/logger.ts"],"sourcesContent":["/*\nCopyright 2018 André Jaenisch\nCopyright 2019-2025 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 loglevel from \"loglevel\";\n\n/** Backwards-compatibility hack to expose `log` to applications that might still be relying on it. */\ninterface LoggerWithLogMethod extends Logger {\n    /**\n     * Output debug message to the logger.\n     *\n     * @param msg - Data to log.\n     *\n     * @deprecated prefer {@link Logger.debug}.\n     */\n    log(...msg: any[]): void;\n}\n\n/** Logger interface used within the js-sdk codebase */\nexport interface Logger extends BaseLogger {\n    /**\n     * Create a child logger.\n     *\n     * This child will use the `methodFactory` of the parent, so any log extensions applied to the parent\n     * at the time of calling `getChild` will be applied to the child as well.\n     * It will NOT apply changes to the parent's `methodFactory` after the child was created.\n     * Those changes need to be applied to the child manually.\n     *\n     * @param namespace - name to add to the current logger to generate the child. Some implementations of `Logger`\n     *    use this as a prefix; others use a different mechanism.\n     */\n    getChild(namespace: string): Logger;\n}\n\n/** The basic interface for a logger which doesn't support children */\nexport interface BaseLogger {\n    /**\n     * Output trace message to the logger, with stack trace.\n     *\n     * @param msg - Data to log.\n     */\n    trace(this: void, ...msg: any[]): void;\n\n    /**\n     * Output debug message to the logger.\n     *\n     * @param msg - Data to log.\n     */\n    debug(this: void, ...msg: any[]): void;\n\n    /**\n     * Output info message to the logger.\n     *\n     * @param msg - Data to log.\n     */\n    info(this: void, ...msg: any[]): void;\n\n    /**\n     * Output warn message to the logger.\n     *\n     * @param msg - Data to log.\n     */\n    warn(this: void, ...msg: any[]): void;\n\n    /**\n     * Output error message to the logger.\n     *\n     * @param msg - Data to log.\n     */\n    error(this: void, ...msg: any[]): void;\n}\n\n// This is to demonstrate, that you can use any namespace you want.\n// Namespaces allow you to turn on/off the logging for specific parts of the\n// application.\n// An idea would be to control this via an environment variable (on Node.js).\n// See https://www.npmjs.com/package/debug to see how this could be implemented\n// Part of #332 is introducing a logging library in the first place.\nconst DEFAULT_NAMESPACE = \"matrix\";\n\n// because rageshakes in react-sdk hijack the console log, also at module load time,\n// initializing the logger here races with the initialization of rageshakes.\n// to avoid the issue, we override the methodFactory of loglevel that binds to the\n// console methods at initialization time by a factory that looks up the console methods\n// when logging so we always get the current value of console methods.\nloglevel.methodFactory = function (methodName, logLevel, loggerName) {\n    return function (this: PrefixedLogger, ...args): void {\n        /* eslint-disable @typescript-eslint/no-invalid-this */\n        if (this.prefix) {\n            args.unshift(this.prefix);\n        }\n        /* eslint-enable @typescript-eslint/no-invalid-this */\n        const supportedByConsole =\n            methodName === \"error\" ||\n            methodName === \"warn\" ||\n            methodName === \"trace\" ||\n            methodName === \"info\" ||\n            methodName === \"debug\";\n        /* eslint-disable no-console */\n        if (supportedByConsole) {\n            return console[methodName](...args);\n        } else {\n            return console.log(...args);\n        }\n        /* eslint-enable no-console */\n    };\n};\n\n/**\n * Implementation of {@link Logger} based on `loglevel`.\n */\ninterface PrefixedLogger extends loglevel.Logger, LoggerWithLogMethod {\n    prefix?: string;\n}\n\n/**\n * Internal utility function: gets a {@link Logger} based on `loglevel`.\n *\n * Child loggers produced by {@link Logger.getChild} add the name of the child logger as a prefix on each log line.\n *\n * @param prefix Prefix to add to each logged line. If undefined, no prefix will be added.\n */\nfunction getPrefixedLogger(prefix?: string): PrefixedLogger {\n    const loggerName = DEFAULT_NAMESPACE + (prefix === undefined ? \"\" : `-${prefix}`);\n    const prefixLogger = loglevel.getLogger(loggerName) as PrefixedLogger;\n\n    if (prefixLogger.getChild === undefined) {\n        // This is a new loglevel Logger which has not been turned into a PrefixedLogger yet.\n        prefixLogger.prefix = prefix;\n        prefixLogger.getChild = (childPrefix): Logger => {\n            // create the new child logger\n            const childLogger = getPrefixedLogger((prefix ?? \"\") + childPrefix);\n            // Assign the methodFactory from the parent logger.\n            // This is useful if we add extensions to the parent logger that modifies\n            // its methodFactory. (An example extension is: storing each log to a rageshake db)\n            childLogger.methodFactory = prefixLogger.methodFactory;\n            // Rebuild the child logger with the new methodFactory.\n            childLogger.rebuild();\n            return childLogger;\n        };\n        prefixLogger.setLevel(loglevel.levels.DEBUG, false);\n    }\n\n    return prefixLogger;\n}\n\n/**\n * Drop-in replacement for `console` using {@link https://www.npmjs.com/package/loglevel|loglevel}.\n * Can be tailored down to specific use cases if needed.\n *\n * @deprecated avoid the use of this unless you are the constructor of `MatrixClient`: you should be using the logger\n *    associated with `MatrixClient`.\n */\nexport const logger = getPrefixedLogger() as LoggerWithLogMethod;\n\n/**\n * A \"span\" for grouping related log lines together.\n *\n * The current implementation just adds the name at the start of each log line.\n *\n * This offers a lighter-weight alternative to 'child' loggers returned by {@link Logger#getChild}. In particular,\n * it's not possible to apply individual filters to the LogSpan such as setting the verbosity level. On the other hand,\n * no reference to the LogSpan is retained in the logging framework, so it is safe to make lots of them over the course\n * of an application's life and just drop references to them when the job is done.\n */\nexport class LogSpan implements BaseLogger {\n    private readonly name;\n\n    public constructor(\n        private readonly parent: BaseLogger,\n        name: string,\n    ) {\n        this.name = name + \":\";\n    }\n\n    public trace(...msg: any[]): void {\n        this.parent.trace(this.name, ...msg);\n    }\n\n    public debug(...msg: any[]): void {\n        this.parent.debug(this.name, ...msg);\n    }\n\n    public info(...msg: any[]): void {\n        this.parent.info(this.name, ...msg);\n    }\n\n    public warn(...msg: any[]): void {\n        this.parent.warn(this.name, ...msg);\n    }\n\n    public error(...msg: any[]): void {\n        this.parent.error(this.name, ...msg);\n    }\n}\n\n/**\n * A simplification of the `Debugger` type exposed by the `debug` library. We reimplement the bits we need here\n * to avoid a dependency on `debug`.\n */\ninterface Debugger {\n    (formatter: any, ...args: any[]): void;\n    extend: (namespace: string, delimiter?: string) => Debugger;\n}\n\n/**\n * A `Logger` instance, suitable for use in {@link ICreateClientOpts.logger}, which will write to the `debug` library.\n *\n * @example\n * ```js\n *     import debug from \"debug\";\n *\n *     const client = createClient({\n *         baseUrl: homeserverUrl,\n *         userId: userId,\n *         accessToken: \"akjgkrgjs\",\n *         deviceId: \"xzcvb\",\n *         logger: new DebugLogger(debug(`matrix-js-sdk:${userId}`)),\n *     });\n * ```\n */\nexport class DebugLogger implements Logger {\n    public constructor(private debugInstance: Debugger) {}\n\n    public trace(...msg: any[]): void {\n        this.debugWithPrefix(\"[TRACE]\", ...msg);\n    }\n\n    public debug(...msg: any[]): void {\n        this.debugWithPrefix(\"[DEBUG]\", ...msg);\n    }\n\n    public info(...msg: any[]): void {\n        this.debugWithPrefix(\"[INFO]\", ...msg);\n    }\n\n    public warn(...msg: any[]): void {\n        this.debugWithPrefix(\"[WARN]\", ...msg);\n    }\n\n    public error(...msg: any[]): void {\n        this.debugWithPrefix(\"[ERROR]\", ...msg);\n    }\n\n    public getChild(namespace: string): DebugLogger {\n        return new DebugLogger(this.debugInstance.extend(namespace));\n    }\n\n    private debugWithPrefix(prefix: string, ...msg: any[]): void {\n        let formatter: string;\n\n        // Convert the first argument to a string, so that we can safely add a prefix. This is much the same logic that\n        // `debug()` uses.\n        if (msg.length === 0) {\n            formatter = \"\";\n        } else if (msg[0] instanceof Error) {\n            const err = msg.shift();\n            formatter = err.stack || err.message;\n        } else if (typeof msg[0] == \"string\") {\n            formatter = msg.shift();\n        } else {\n            formatter = \"%O\";\n        }\n        this.debugInstance(prefix + \" \" + formatter, ...msg);\n    }\n}\n"],"mappings":"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","ignoreList":[]}
+{"version":3,"file":"logger.js","names":[],"sources":["../src/logger.ts"],"sourcesContent":["/*\nCopyright 2018 André Jaenisch\nCopyright 2019-2025 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 loglevel from \"loglevel\";\n\n/** Backwards-compatibility hack to expose `log` to applications that might still be relying on it. */\ninterface LoggerWithLogMethod extends Logger {\n    /**\n     * Output debug message to the logger.\n     *\n     * @param msg - Data to log.\n     *\n     * @deprecated prefer {@link Logger.debug}.\n     */\n    log(...msg: any[]): void;\n}\n\n/** Logger interface used within the js-sdk codebase */\nexport interface Logger extends BaseLogger {\n    /**\n     * Create a child logger.\n     *\n     * This child will use the `methodFactory` of the parent, so any log extensions applied to the parent\n     * at the time of calling `getChild` will be applied to the child as well.\n     * It will NOT apply changes to the parent's `methodFactory` after the child was created.\n     * Those changes need to be applied to the child manually.\n     *\n     * @param namespace - name to add to the current logger to generate the child. Some implementations of `Logger`\n     *    use this as a prefix; others use a different mechanism.\n     */\n    getChild(namespace: string): Logger;\n}\n\n/** The basic interface for a logger which doesn't support children */\nexport interface BaseLogger {\n    /**\n     * Output trace message to the logger, with stack trace.\n     *\n     * @param msg - Data to log.\n     */\n    trace(this: void, ...msg: any[]): void;\n\n    /**\n     * Output debug message to the logger.\n     *\n     * @param msg - Data to log.\n     */\n    debug(this: void, ...msg: any[]): void;\n\n    /**\n     * Output info message to the logger.\n     *\n     * @param msg - Data to log.\n     */\n    info(this: void, ...msg: any[]): void;\n\n    /**\n     * Output warn message to the logger.\n     *\n     * @param msg - Data to log.\n     */\n    warn(this: void, ...msg: any[]): void;\n\n    /**\n     * Output error message to the logger.\n     *\n     * @param msg - Data to log.\n     */\n    error(this: void, ...msg: any[]): void;\n}\n\n// This is to demonstrate, that you can use any namespace you want.\n// Namespaces allow you to turn on/off the logging for specific parts of the\n// application.\n// An idea would be to control this via an environment variable (on Node.js).\n// See https://www.npmjs.com/package/debug to see how this could be implemented\n// Part of #332 is introducing a logging library in the first place.\nconst DEFAULT_NAMESPACE = \"matrix\";\n\n// because rageshakes in react-sdk hijack the console log, also at module load time,\n// initializing the logger here races with the initialization of rageshakes.\n// to avoid the issue, we override the methodFactory of loglevel that binds to the\n// console methods at initialization time by a factory that looks up the console methods\n// when logging so we always get the current value of console methods.\nloglevel.methodFactory = function (methodName, logLevel, loggerName) {\n    return function (this: PrefixedLogger, ...args): void {\n        if (this.prefix) {\n            args.unshift(this.prefix);\n        }\n        const supportedByConsole =\n            methodName === \"error\" ||\n            methodName === \"warn\" ||\n            methodName === \"trace\" ||\n            methodName === \"info\" ||\n            methodName === \"debug\";\n        /* eslint-disable no-console */\n        if (supportedByConsole) {\n            return console[methodName](...args);\n        } else {\n            return console.log(...args);\n        }\n        /* eslint-enable no-console */\n    };\n};\n\n/**\n * Implementation of {@link Logger} based on `loglevel`.\n */\ninterface PrefixedLogger extends loglevel.Logger, LoggerWithLogMethod {\n    prefix?: string;\n}\n\n/**\n * Internal utility function: gets a {@link Logger} based on `loglevel`.\n *\n * Child loggers produced by {@link Logger.getChild} add the name of the child logger as a prefix on each log line.\n *\n * @param prefix Prefix to add to each logged line. If undefined, no prefix will be added.\n */\nfunction getPrefixedLogger(prefix?: string): PrefixedLogger {\n    const loggerName = DEFAULT_NAMESPACE + (prefix === undefined ? \"\" : `-${prefix}`);\n    const prefixLogger = loglevel.getLogger(loggerName) as PrefixedLogger;\n\n    if (prefixLogger.getChild === undefined) {\n        // This is a new loglevel Logger which has not been turned into a PrefixedLogger yet.\n        prefixLogger.prefix = prefix;\n        prefixLogger.getChild = (childPrefix): Logger => {\n            // create the new child logger\n            const childLogger = getPrefixedLogger((prefix ?? \"\") + childPrefix);\n            // Assign the methodFactory from the parent logger.\n            // This is useful if we add extensions to the parent logger that modifies\n            // its methodFactory. (An example extension is: storing each log to a rageshake db)\n            childLogger.methodFactory = prefixLogger.methodFactory;\n            // Rebuild the child logger with the new methodFactory.\n            childLogger.rebuild();\n            return childLogger;\n        };\n        prefixLogger.setLevel(loglevel.levels.DEBUG, false);\n    }\n\n    return prefixLogger;\n}\n\n/**\n * Drop-in replacement for `console` using {@link https://www.npmjs.com/package/loglevel|loglevel}.\n * Can be tailored down to specific use cases if needed.\n *\n * @deprecated avoid the use of this unless you are the constructor of `MatrixClient`: you should be using the logger\n *    associated with `MatrixClient`.\n */\nexport const logger = getPrefixedLogger() as LoggerWithLogMethod;\n\n/**\n * A \"span\" for grouping related log lines together.\n *\n * The current implementation just adds the name at the start of each log line.\n *\n * This offers a lighter-weight alternative to 'child' loggers returned by {@link Logger#getChild}. In particular,\n * it's not possible to apply individual filters to the LogSpan such as setting the verbosity level. On the other hand,\n * no reference to the LogSpan is retained in the logging framework, so it is safe to make lots of them over the course\n * of an application's life and just drop references to them when the job is done.\n */\nexport class LogSpan implements BaseLogger {\n    private readonly name;\n\n    public constructor(\n        private readonly parent: BaseLogger,\n        name: string,\n    ) {\n        this.name = name + \":\";\n    }\n\n    public trace(...msg: any[]): void {\n        this.parent.trace(this.name, ...msg);\n    }\n\n    public debug(...msg: any[]): void {\n        this.parent.debug(this.name, ...msg);\n    }\n\n    public info(...msg: any[]): void {\n        this.parent.info(this.name, ...msg);\n    }\n\n    public warn(...msg: any[]): void {\n        this.parent.warn(this.name, ...msg);\n    }\n\n    public error(...msg: any[]): void {\n        this.parent.error(this.name, ...msg);\n    }\n}\n\n/**\n * A simplification of the `Debugger` type exposed by the `debug` library. We reimplement the bits we need here\n * to avoid a dependency on `debug`.\n */\ninterface Debugger {\n    (formatter: any, ...args: any[]): void;\n    extend: (namespace: string, delimiter?: string) => Debugger;\n}\n\n/**\n * A `Logger` instance, suitable for use in {@link ICreateClientOpts.logger}, which will write to the `debug` library.\n *\n * @example\n * ```js\n *     import debug from \"debug\";\n *\n *     const client = createClient({\n *         baseUrl: homeserverUrl,\n *         userId: userId,\n *         accessToken: \"akjgkrgjs\",\n *         deviceId: \"xzcvb\",\n *         logger: new DebugLogger(debug(`matrix-js-sdk:${userId}`)),\n *     });\n * ```\n */\nexport class DebugLogger implements Logger {\n    public constructor(private debugInstance: Debugger) {}\n\n    public trace(...msg: any[]): void {\n        this.debugWithPrefix(\"[TRACE]\", ...msg);\n    }\n\n    public debug(...msg: any[]): void {\n        this.debugWithPrefix(\"[DEBUG]\", ...msg);\n    }\n\n    public info(...msg: any[]): void {\n        this.debugWithPrefix(\"[INFO]\", ...msg);\n    }\n\n    public warn(...msg: any[]): void {\n        this.debugWithPrefix(\"[WARN]\", ...msg);\n    }\n\n    public error(...msg: any[]): void {\n        this.debugWithPrefix(\"[ERROR]\", ...msg);\n    }\n\n    public getChild(namespace: string): DebugLogger {\n        return new DebugLogger(this.debugInstance.extend(namespace));\n    }\n\n    private debugWithPrefix(prefix: string, ...msg: any[]): void {\n        let formatter: string;\n\n        // Convert the first argument to a string, so that we can safely add a prefix. This is much the same logic that\n        // `debug()` uses.\n        if (msg.length === 0) {\n            formatter = \"\";\n        } else if (msg[0] instanceof Error) {\n            const err = msg.shift();\n            formatter = err.stack || err.message;\n        } else if (typeof msg[0] == \"string\") {\n            formatter = msg.shift();\n        } else {\n            formatter = \"%O\";\n        }\n        this.debugInstance(prefix + \" \" + formatter, ...msg);\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/matrixrtc/CallMembership.d.ts

@@ -130,7 +130,7 @@ export declare class CallMembership {
      * ## 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.
+     * Directly relates to the `transports.published` field.
      *
      * ## Legacy session membership
      * In case of a legacy session membership (m.call.member) this will return the selected transport where
@@ -138,14 +138,14 @@ export declare class CallMembership {
      * 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).
+     * (`multi_sfu` is equivalent to how `m.rtc.member` `transports.published` 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: CallMembership): Transport | undefined;
     /**
-     * The value of the `rtc_transports` field for RTC memberships (m.rtc.member).
+     * The value of the `transports.published` field for RTC memberships (m.rtc.member).
      * Or the value of the `foci_preferred` field for legacy session memberships (m.call.member).
      */
     get transports(): Transport[];

package/lib/matrixrtc/CallMembership.js

@@ -402,7 +402,7 @@ export class CallMembership {
    * ## 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.
+   * Directly relates to the `transports.published` field.
    *
    * ## Legacy session membership
    * In case of a legacy session membership (m.call.member) this will return the selected transport where
@@ -410,7 +410,7 @@ export class CallMembership {
    * 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).
+   * (`multi_sfu` is equivalent to how `m.rtc.member` `transports.published` 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.
@@ -422,7 +422,7 @@ export class CallMembership {
     } = this.membershipData;
     switch (kind) {
       case MembershipKind.RTC:
-        return data.rtc_transports[0];
+        return data.transports.published[0];
       case MembershipKind.Session:
         switch (data.focus_active.focus_selection) {
           case "oldest_membership":
@@ -442,7 +442,7 @@ export class CallMembership {
   }
 
   /**
-   * The value of the `rtc_transports` field for RTC memberships (m.rtc.member).
+   * The value of the `transports.published` field for RTC memberships (m.rtc.member).
    * Or the value of the `foci_preferred` field for legacy session memberships (m.call.member).
    */
   get transports() {
@@ -452,7 +452,7 @@ export class CallMembership {
     } = this.membershipData;
     switch (kind) {
       case MembershipKind.RTC:
-        return data.rtc_transports;
+        return data.transports.published;
       case MembershipKind.Session:
       default:
         return data.foci_preferred;