@unwanted/matrix-sdk-mini 34.12.0-1

package/lib/rendezvous/index.js

@@ -0,0 +1,23 @@
+/*
+Copyright 2022 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+export * from "./MSC4108SignInWithQR.js";
+export * from "./RendezvousError.js";
+export * from "./RendezvousFailureReason.js";
+export * from "./RendezvousIntent.js";
+export * from "./transports/index.js";
+export * from "./channels/index.js";
+//# sourceMappingURL=index.js.map

package/lib/rendezvous/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/rendezvous/index.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\nexport * from \"./MSC4108SignInWithQR.ts\";\nexport type * from \"./RendezvousChannel.ts\";\nexport type * from \"./RendezvousCode.ts\";\nexport * from \"./RendezvousError.ts\";\nexport * from \"./RendezvousFailureReason.ts\";\nexport * from \"./RendezvousIntent.ts\";\nexport type * from \"./RendezvousTransport.ts\";\nexport * from \"./transports/index.ts\";\nexport * from \"./channels/index.ts\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,0BAA0B;AAGxC,cAAc,sBAAsB;AACpC,cAAc,8BAA8B;AAC5C,cAAc,uBAAuB;AAErC,cAAc,uBAAuB;AACrC,cAAc,qBAAqB","ignoreList":[]}

package/lib/rendezvous/transports/MSC4108RendezvousSession.d.ts

@@ -0,0 +1,61 @@
+import { ClientRendezvousFailureReason, MSC4108FailureReason, RendezvousFailureListener } from "../index.ts";
+import { MatrixClient } from "../../matrix.ts";
+/**
+ * Prototype of the unstable [MSC4108](https://github.com/matrix-org/matrix-spec-proposals/pull/4108)
+ * insecure rendezvous session protocol.
+ * @experimental Note that this is UNSTABLE and may have breaking changes without notice.
+ */
+export declare class MSC4108RendezvousSession {
+    url?: string;
+    private readonly client?;
+    private readonly fallbackRzServer?;
+    private readonly fetchFn?;
+    private readonly onFailure?;
+    private etag?;
+    private expiresAt?;
+    private expiresTimer?;
+    private _cancelled;
+    private _ready;
+    constructor({ onFailure, url, fetchFn, }: {
+        fetchFn?: typeof globalThis.fetch;
+        onFailure?: RendezvousFailureListener;
+        url: string;
+    });
+    constructor({ onFailure, client, fallbackRzServer, fetchFn, }: {
+        fetchFn?: typeof globalThis.fetch;
+        onFailure?: RendezvousFailureListener;
+        client?: MatrixClient;
+        fallbackRzServer?: string;
+    });
+    /**
+     * Returns whether the channel is ready to be used.
+     */
+    get ready(): boolean;
+    /**
+     * Returns whether the channel has been cancelled.
+     */
+    get cancelled(): boolean;
+    private fetch;
+    private getPostEndpoint;
+    /**
+     * Sends data via the rendezvous channel.
+     * @param data the payload to send
+     */
+    send(data: string): Promise<void>;
+    /**
+     * Receives data from the rendezvous channel.
+     * @return the returned promise won't resolve until new data is acquired or the channel is closed either by the server or the other party.
+     */
+    receive(): Promise<string | undefined>;
+    /**
+     * Cancels the rendezvous channel.
+     * If the reason is user_declined or user_cancelled then the channel will also be closed.
+     * @param reason the reason to cancel with
+     */
+    cancel(reason: MSC4108FailureReason | ClientRendezvousFailureReason): Promise<void>;
+    /**
+     * Closes the rendezvous channel.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=MSC4108RendezvousSession.d.ts.map

package/lib/rendezvous/transports/MSC4108RendezvousSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MSC4108RendezvousSession.d.ts","sourceRoot":"","sources":["../../../src/rendezvous/transports/MSC4108RendezvousSession.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7G,OAAO,EAAE,YAAY,EAAU,MAAM,iBAAiB,CAAC;AAGvD;;;;GAIG;AACH,qBAAa,wBAAwB;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAA4B;IACvD,OAAO,CAAC,IAAI,CAAC,CAAS;IACtB,OAAO,CAAC,SAAS,CAAC,CAAO;IACzB,OAAO,CAAC,YAAY,CAAC,CAAgC;IACrD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;gBAEJ,EACf,SAAS,EACT,GAAG,EACH,OAAO,GACV,EAAE;QACC,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;QAClC,SAAS,CAAC,EAAE,yBAAyB,CAAC;QACtC,GAAG,EAAE,MAAM,CAAC;KACf;gBACkB,EACf,SAAS,EACT,MAAM,EACN,gBAAgB,EAChB,OAAO,GACV,EAAE;QACC,OAAO,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;QAClC,SAAS,CAAC,EAAE,yBAAyB,CAAC;QACtC,MAAM,CAAC,EAAE,YAAY,CAAC;QACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC7B;IAqBD;;OAEG;IACH,IAAW,KAAK,IAAI,OAAO,CAE1B;IAED;;OAEG;IACH,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,OAAO,CAAC,KAAK;YAOC,eAAe;IAgB7B;;;OAGG;IACU,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuD9C;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IA6CnD;;;;OAIG;IACU,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBhG;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAatC"}

package/lib/rendezvous/transports/MSC4108RendezvousSession.js

@@ -0,0 +1,253 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2024 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { logger } from "../../logger.js";
+import { sleep } from "../../utils.js";
+import { ClientRendezvousFailureReason, MSC4108FailureReason } from "../index.js";
+import { Method } from "../../matrix.js";
+import { ClientPrefix } from "../../http-api/index.js";
+
+/**
+ * Prototype of the unstable [MSC4108](https://github.com/matrix-org/matrix-spec-proposals/pull/4108)
+ * insecure rendezvous session protocol.
+ * @experimental Note that this is UNSTABLE and may have breaking changes without notice.
+ */
+export class MSC4108RendezvousSession {
+  constructor(_ref) {
+    var {
+      fetchFn,
+      onFailure,
+      url,
+      client,
+      fallbackRzServer
+    } = _ref;
+    _defineProperty(this, "url", void 0);
+    _defineProperty(this, "client", void 0);
+    _defineProperty(this, "fallbackRzServer", void 0);
+    _defineProperty(this, "fetchFn", void 0);
+    _defineProperty(this, "onFailure", void 0);
+    _defineProperty(this, "etag", void 0);
+    _defineProperty(this, "expiresAt", void 0);
+    _defineProperty(this, "expiresTimer", void 0);
+    _defineProperty(this, "_cancelled", false);
+    _defineProperty(this, "_ready", false);
+    this.fetchFn = fetchFn;
+    this.onFailure = onFailure;
+    this.client = client;
+    this.fallbackRzServer = fallbackRzServer;
+    this.url = url;
+  }
+
+  /**
+   * Returns whether the channel is ready to be used.
+   */
+  get ready() {
+    return this._ready;
+  }
+
+  /**
+   * Returns whether the channel has been cancelled.
+   */
+  get cancelled() {
+    return this._cancelled;
+  }
+  fetch(resource, options) {
+    if (this.fetchFn) {
+      return this.fetchFn(resource, options);
+    }
+    return globalThis.fetch(resource, options);
+  }
+  getPostEndpoint() {
+    var _this = this;
+    return _asyncToGenerator(function* () {
+      if (_this.client) {
+        try {
+          if (yield _this.client.doesServerSupportUnstableFeature("org.matrix.msc4108")) {
+            return _this.client.http.getUrl("/org.matrix.msc4108/rendezvous", undefined, ClientPrefix.Unstable).toString();
+          }
+        } catch (err) {
+          logger.warn("Failed to get unstable features", err);
+        }
+      }
+      return _this.fallbackRzServer;
+    })();
+  }
+
+  /**
+   * Sends data via the rendezvous channel.
+   * @param data the payload to send
+   */
+  send(data) {
+    var _this2 = this;
+    return _asyncToGenerator(function* () {
+      var _this2$url, _res$headers$get;
+      if (_this2._cancelled) {
+        return;
+      }
+      var method = _this2.url ? Method.Put : Method.Post;
+      var uri = (_this2$url = _this2.url) !== null && _this2$url !== void 0 ? _this2$url : yield _this2.getPostEndpoint();
+      if (!uri) {
+        throw new Error("Invalid rendezvous URI");
+      }
+      var headers = {
+        "content-type": "text/plain"
+      };
+
+      // if we didn't create the rendezvous channel, we need to fetch the first etag if needed
+      if (!_this2.etag && _this2.url) {
+        yield _this2.receive();
+      }
+      if (_this2.etag) {
+        headers["if-match"] = _this2.etag;
+      }
+      logger.info("=> ".concat(method, " ").concat(uri, " with ").concat(data, " if-match: ").concat(_this2.etag));
+      var res = yield _this2.fetch(uri, {
+        method,
+        headers,
+        body: data,
+        redirect: "follow"
+      });
+      if (res.status === 404) {
+        return _this2.cancel(ClientRendezvousFailureReason.Unknown);
+      }
+      _this2.etag = (_res$headers$get = res.headers.get("etag")) !== null && _res$headers$get !== void 0 ? _res$headers$get : undefined;
+      logger.info("Received etag: ".concat(_this2.etag));
+      if (method === Method.Post) {
+        var expires = res.headers.get("expires");
+        if (expires) {
+          if (_this2.expiresTimer) {
+            clearTimeout(_this2.expiresTimer);
+            _this2.expiresTimer = undefined;
+          }
+          _this2.expiresAt = new Date(expires);
+          _this2.expiresTimer = setTimeout(() => {
+            _this2.expiresTimer = undefined;
+            _this2.cancel(ClientRendezvousFailureReason.Expired);
+          }, _this2.expiresAt.getTime() - Date.now());
+        }
+        // MSC4108: we expect a JSON response with a rendezvous URL
+        var json = yield res.json();
+        if (typeof json.url !== "string") {
+          throw new Error("No rendezvous URL given");
+        }
+        _this2.url = json.url;
+        _this2._ready = true;
+      }
+    })();
+  }
+
+  /**
+   * Receives data from the rendezvous channel.
+   * @return the returned promise won't resolve until new data is acquired or the channel is closed either by the server or the other party.
+   */
+  receive() {
+    var _this3 = this;
+    return _asyncToGenerator(function* () {
+      if (!_this3.url) {
+        throw new Error("Rendezvous not set up");
+      }
+      // eslint-disable-next-line no-constant-condition
+      while (true) {
+        var _poll$headers$get;
+        if (_this3._cancelled) {
+          return undefined;
+        }
+        var headers = {};
+        if (_this3.etag) {
+          headers["if-none-match"] = _this3.etag;
+        }
+        logger.info("=> GET ".concat(_this3.url, " if-none-match: ").concat(_this3.etag));
+        var poll = yield _this3.fetch(_this3.url, {
+          method: Method.Get,
+          headers
+        });
+        if (poll.status === 404) {
+          yield _this3.cancel(ClientRendezvousFailureReason.Unknown);
+          return undefined;
+        }
+
+        // rely on server expiring the channel rather than checking ourselves
+
+        var etag = (_poll$headers$get = poll.headers.get("etag")) !== null && _poll$headers$get !== void 0 ? _poll$headers$get : undefined;
+        if (poll.headers.get("content-type") !== "text/plain") {
+          _this3.etag = etag;
+        } else if (poll.status === 200) {
+          if (!etag) {
+            // Some browsers & extensions block the ETag header for anti-tracking purposes
+            // We try and detect this so the client can give the user a somewhat helpful message
+            yield _this3.cancel(ClientRendezvousFailureReason.ETagMissing);
+            return undefined;
+          }
+          _this3.etag = etag;
+          var text = yield poll.text();
+          logger.info("Received: ".concat(text, " with etag ").concat(_this3.etag));
+          return text;
+        }
+        yield sleep(1000);
+      }
+    })();
+  }
+
+  /**
+   * Cancels the rendezvous channel.
+   * If the reason is user_declined or user_cancelled then the channel will also be closed.
+   * @param reason the reason to cancel with
+   */
+  cancel(reason) {
+    var _this4 = this;
+    return _asyncToGenerator(function* () {
+      var _this4$onFailure;
+      if (_this4._cancelled) return;
+      if (_this4.expiresTimer) {
+        clearTimeout(_this4.expiresTimer);
+        _this4.expiresTimer = undefined;
+      }
+      if (reason === ClientRendezvousFailureReason.Unknown && _this4.expiresAt && _this4.expiresAt.getTime() < Date.now()) {
+        reason = ClientRendezvousFailureReason.Expired;
+      }
+      _this4._cancelled = true;
+      _this4._ready = false;
+      (_this4$onFailure = _this4.onFailure) === null || _this4$onFailure === void 0 || _this4$onFailure.call(_this4, reason);
+      if (reason === ClientRendezvousFailureReason.UserDeclined || reason === MSC4108FailureReason.UserCancelled) {
+        yield _this4.close();
+      }
+    })();
+  }
+
+  /**
+   * Closes the rendezvous channel.
+   */
+  close() {
+    var _this5 = this;
+    return _asyncToGenerator(function* () {
+      if (_this5.expiresTimer) {
+        clearTimeout(_this5.expiresTimer);
+        _this5.expiresTimer = undefined;
+      }
+      if (!_this5.url) return;
+      try {
+        yield _this5.fetch(_this5.url, {
+          method: Method.Delete
+        });
+      } catch (e) {
+        logger.warn(e);
+      }
+    })();
+  }
+}
+//# sourceMappingURL=MSC4108RendezvousSession.js.map

package/lib/rendezvous/transports/MSC4108RendezvousSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MSC4108RendezvousSession.js","names":["logger","sleep","ClientRendezvousFailureReason","MSC4108FailureReason","Method","ClientPrefix","MSC4108RendezvousSession","constructor","_ref","fetchFn","onFailure","url","client","fallbackRzServer","_defineProperty","ready","_ready","cancelled","_cancelled","fetch","resource","options","globalThis","getPostEndpoint","_this","_asyncToGenerator","doesServerSupportUnstableFeature","http","getUrl","undefined","Unstable","toString","err","warn","send","data","_this2","_this2$url","_res$headers$get","method","Put","Post","uri","Error","headers","etag","receive","info","concat","res","body","redirect","status","cancel","Unknown","get","expires","expiresTimer","clearTimeout","expiresAt","Date","setTimeout","Expired","getTime","now","json","_this3","_poll$headers$get","poll","Get","ETagMissing","text","reason","_this4","_this4$onFailure","call","UserDeclined","UserCancelled","close","_this5","Delete","e"],"sources":["../../../src/rendezvous/transports/MSC4108RendezvousSession.ts"],"sourcesContent":["/*\nCopyright 2024 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 { sleep } from \"../../utils.ts\";\nimport { ClientRendezvousFailureReason, MSC4108FailureReason, RendezvousFailureListener } from \"../index.ts\";\nimport { MatrixClient, Method } from \"../../matrix.ts\";\nimport { ClientPrefix } from \"../../http-api/index.ts\";\n\n/**\n * Prototype of the unstable [MSC4108](https://github.com/matrix-org/matrix-spec-proposals/pull/4108)\n * insecure rendezvous session protocol.\n * @experimental Note that this is UNSTABLE and may have breaking changes without notice.\n */\nexport class MSC4108RendezvousSession {\n    public url?: string;\n    private readonly client?: MatrixClient;\n    private readonly fallbackRzServer?: string;\n    private readonly fetchFn?: typeof globalThis.fetch;\n    private readonly onFailure?: RendezvousFailureListener;\n    private etag?: string;\n    private expiresAt?: Date;\n    private expiresTimer?: ReturnType<typeof setTimeout>;\n    private _cancelled = false;\n    private _ready = false;\n\n    public constructor({\n        onFailure,\n        url,\n        fetchFn,\n    }: {\n        fetchFn?: typeof globalThis.fetch;\n        onFailure?: RendezvousFailureListener;\n        url: string;\n    });\n    public constructor({\n        onFailure,\n        client,\n        fallbackRzServer,\n        fetchFn,\n    }: {\n        fetchFn?: typeof globalThis.fetch;\n        onFailure?: RendezvousFailureListener;\n        client?: MatrixClient;\n        fallbackRzServer?: string;\n    });\n    public constructor({\n        fetchFn,\n        onFailure,\n        url,\n        client,\n        fallbackRzServer,\n    }: {\n        fetchFn?: typeof globalThis.fetch;\n        onFailure?: RendezvousFailureListener;\n        url?: string;\n        client?: MatrixClient;\n        fallbackRzServer?: string;\n    }) {\n        this.fetchFn = fetchFn;\n        this.onFailure = onFailure;\n        this.client = client;\n        this.fallbackRzServer = fallbackRzServer;\n        this.url = url;\n    }\n\n    /**\n     * Returns whether the channel is ready to be used.\n     */\n    public get ready(): boolean {\n        return this._ready;\n    }\n\n    /**\n     * Returns whether the channel has been cancelled.\n     */\n    public get cancelled(): boolean {\n        return this._cancelled;\n    }\n\n    private fetch(resource: URL | string, options?: RequestInit): ReturnType<typeof globalThis.fetch> {\n        if (this.fetchFn) {\n            return this.fetchFn(resource, options);\n        }\n        return globalThis.fetch(resource, options);\n    }\n\n    private async getPostEndpoint(): Promise<string | undefined> {\n        if (this.client) {\n            try {\n                if (await this.client.doesServerSupportUnstableFeature(\"org.matrix.msc4108\")) {\n                    return this.client.http\n                        .getUrl(\"/org.matrix.msc4108/rendezvous\", undefined, ClientPrefix.Unstable)\n                        .toString();\n                }\n            } catch (err) {\n                logger.warn(\"Failed to get unstable features\", err);\n            }\n        }\n\n        return this.fallbackRzServer;\n    }\n\n    /**\n     * Sends data via the rendezvous channel.\n     * @param data the payload to send\n     */\n    public async send(data: string): Promise<void> {\n        if (this._cancelled) {\n            return;\n        }\n        const method = this.url ? Method.Put : Method.Post;\n        const uri = this.url ?? (await this.getPostEndpoint());\n\n        if (!uri) {\n            throw new Error(\"Invalid rendezvous URI\");\n        }\n\n        const headers: Record<string, string> = { \"content-type\": \"text/plain\" };\n\n        // if we didn't create the rendezvous channel, we need to fetch the first etag if needed\n        if (!this.etag && this.url) {\n            await this.receive();\n        }\n\n        if (this.etag) {\n            headers[\"if-match\"] = this.etag;\n        }\n\n        logger.info(`=> ${method} ${uri} with ${data} if-match: ${this.etag}`);\n\n        const res = await this.fetch(uri, { method, headers, body: data, redirect: \"follow\" });\n        if (res.status === 404) {\n            return this.cancel(ClientRendezvousFailureReason.Unknown);\n        }\n        this.etag = res.headers.get(\"etag\") ?? undefined;\n\n        logger.info(`Received etag: ${this.etag}`);\n\n        if (method === Method.Post) {\n            const expires = res.headers.get(\"expires\");\n            if (expires) {\n                if (this.expiresTimer) {\n                    clearTimeout(this.expiresTimer);\n                    this.expiresTimer = undefined;\n                }\n                this.expiresAt = new Date(expires);\n                this.expiresTimer = setTimeout(() => {\n                    this.expiresTimer = undefined;\n                    this.cancel(ClientRendezvousFailureReason.Expired);\n                }, this.expiresAt.getTime() - Date.now());\n            }\n            // MSC4108: we expect a JSON response with a rendezvous URL\n            const json = await res.json();\n            if (typeof json.url !== \"string\") {\n                throw new Error(\"No rendezvous URL given\");\n            }\n            this.url = json.url;\n            this._ready = true;\n        }\n    }\n\n    /**\n     * Receives data from the rendezvous channel.\n     * @return the returned promise won't resolve until new data is acquired or the channel is closed either by the server or the other party.\n     */\n    public async receive(): Promise<string | undefined> {\n        if (!this.url) {\n            throw new Error(\"Rendezvous not set up\");\n        }\n        // eslint-disable-next-line no-constant-condition\n        while (true) {\n            if (this._cancelled) {\n                return undefined;\n            }\n\n            const headers: Record<string, string> = {};\n            if (this.etag) {\n                headers[\"if-none-match\"] = this.etag;\n            }\n\n            logger.info(`=> GET ${this.url} if-none-match: ${this.etag}`);\n            const poll = await this.fetch(this.url, { method: Method.Get, headers });\n\n            if (poll.status === 404) {\n                await this.cancel(ClientRendezvousFailureReason.Unknown);\n                return undefined;\n            }\n\n            // rely on server expiring the channel rather than checking ourselves\n\n            const etag = poll.headers.get(\"etag\") ?? undefined;\n            if (poll.headers.get(\"content-type\") !== \"text/plain\") {\n                this.etag = etag;\n            } else if (poll.status === 200) {\n                if (!etag) {\n                    // Some browsers & extensions block the ETag header for anti-tracking purposes\n                    // We try and detect this so the client can give the user a somewhat helpful message\n                    await this.cancel(ClientRendezvousFailureReason.ETagMissing);\n                    return undefined;\n                }\n\n                this.etag = etag;\n                const text = await poll.text();\n                logger.info(`Received: ${text} with etag ${this.etag}`);\n                return text;\n            }\n            await sleep(1000);\n        }\n    }\n\n    /**\n     * Cancels the rendezvous channel.\n     * If the reason is user_declined or user_cancelled then the channel will also be closed.\n     * @param reason the reason to cancel with\n     */\n    public async cancel(reason: MSC4108FailureReason | ClientRendezvousFailureReason): Promise<void> {\n        if (this._cancelled) return;\n        if (this.expiresTimer) {\n            clearTimeout(this.expiresTimer);\n            this.expiresTimer = undefined;\n        }\n\n        if (\n            reason === ClientRendezvousFailureReason.Unknown &&\n            this.expiresAt &&\n            this.expiresAt.getTime() < Date.now()\n        ) {\n            reason = ClientRendezvousFailureReason.Expired;\n        }\n\n        this._cancelled = true;\n        this._ready = false;\n        this.onFailure?.(reason);\n\n        if (reason === ClientRendezvousFailureReason.UserDeclined || reason === MSC4108FailureReason.UserCancelled) {\n            await this.close();\n        }\n    }\n\n    /**\n     * Closes the rendezvous channel.\n     */\n    public async close(): Promise<void> {\n        if (this.expiresTimer) {\n            clearTimeout(this.expiresTimer);\n            this.expiresTimer = undefined;\n        }\n\n        if (!this.url) return;\n        try {\n            await this.fetch(this.url, { method: Method.Delete });\n        } catch (e) {\n            logger.warn(e);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/rendezvous/transports/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./MSC4108RendezvousSession.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/rendezvous/transports/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rendezvous/transports/index.ts"],"names":[],"mappings":"AAgBA,cAAc,+BAA+B,CAAC"}

package/lib/rendezvous/transports/index.js

@@ -0,0 +1,18 @@
+/*
+Copyright 2022 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+export * from "./MSC4108RendezvousSession.js";
+//# sourceMappingURL=index.js.map

package/lib/rendezvous/transports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/rendezvous/transports/index.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\nexport * from \"./MSC4108RendezvousSession.ts\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,cAAc,+BAA+B","ignoreList":[]}

package/lib/room-hierarchy.d.ts

@@ -0,0 +1,35 @@
+import { Room } from "./models/room.ts";
+import { IHierarchyRoom, IHierarchyRelation } from "./@types/spaces.ts";
+export declare class RoomHierarchy {
+    readonly root: Room;
+    private readonly pageSize?;
+    private readonly maxDepth?;
+    private readonly suggestedOnly;
+    readonly viaMap: Map<string, Set<string>>;
+    readonly backRefs: Map<string, string[]>;
+    readonly roomMap: Map<string, IHierarchyRoom>;
+    private loadRequest?;
+    private nextBatch?;
+    private _rooms?;
+    private serverSupportError?;
+    /**
+     * Construct a new RoomHierarchy
+     *
+     * A RoomHierarchy instance allows you to easily make use of the /hierarchy API and paginate it.
+     *
+     * @param root - the root of this hierarchy
+     * @param pageSize - the maximum number of rooms to return per page, can be overridden per load request.
+     * @param maxDepth - the maximum depth to traverse the hierarchy to
+     * @param suggestedOnly - whether to only return rooms with suggested=true.
+     */
+    constructor(root: Room, pageSize?: number | undefined, maxDepth?: number | undefined, suggestedOnly?: boolean);
+    get noSupport(): boolean;
+    get canLoadMore(): boolean;
+    get loading(): boolean;
+    get rooms(): IHierarchyRoom[] | undefined;
+    load(pageSize?: number | undefined): Promise<IHierarchyRoom[]>;
+    getRelation(parentId: string, childId: string): IHierarchyRelation | undefined;
+    isSuggested(parentId: string, childId: string): boolean | undefined;
+    removeRelation(parentId: string, childId: string): void;
+}
+//# sourceMappingURL=room-hierarchy.d.ts.map

package/lib/room-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-hierarchy.d.ts","sourceRoot":"","sources":["../src/room-hierarchy.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAKxE,qBAAa,aAAa;aAuBF,IAAI,EAAE,IAAI;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAxBlC,SAAgB,MAAM,2BAAkC;IAExD,SAAgB,QAAQ,wBAA+B;IAEvD,SAAgB,OAAO,8BAAqC;IAC5D,OAAO,CAAC,WAAW,CAAC,CAA+C;IACnE,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAC,CAAmB;IAClC,OAAO,CAAC,kBAAkB,CAAC,CAAQ;IAEnC;;;;;;;;;OASG;gBAEiB,IAAI,EAAE,IAAI,EACT,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,QAAQ,CAAC,EAAE,MAAM,YAAA,EACjB,aAAa,UAAQ;IAG1C,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED,IAAW,OAAO,IAAI,OAAO,CAE5B;IAED,IAAW,KAAK,IAAI,cAAc,EAAE,GAAG,SAAS,CAE/C;IAEY,IAAI,CAAC,QAAQ,qBAAgB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IA2D/D,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI9E,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAKnE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;CAgBjE"}

package/lib/room-hierarchy.js

@@ -0,0 +1,136 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2021 The Matrix.org Foundation C.I.C.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+*/
+
+import { EventType } from "./@types/event.js";
+export class RoomHierarchy {
+  /**
+   * Construct a new RoomHierarchy
+   *
+   * A RoomHierarchy instance allows you to easily make use of the /hierarchy API and paginate it.
+   *
+   * @param root - the root of this hierarchy
+   * @param pageSize - the maximum number of rooms to return per page, can be overridden per load request.
+   * @param maxDepth - the maximum depth to traverse the hierarchy to
+   * @param suggestedOnly - whether to only return rooms with suggested=true.
+   */
+  constructor(root, pageSize, maxDepth) {
+    var suggestedOnly = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : false;
+    this.root = root;
+    this.pageSize = pageSize;
+    this.maxDepth = maxDepth;
+    this.suggestedOnly = suggestedOnly;
+    // Map from room id to list of servers which are listed as a via somewhere in the loaded hierarchy
+    _defineProperty(this, "viaMap", new Map());
+    // Map from room id to list of rooms which claim this room as their child
+    _defineProperty(this, "backRefs", new Map());
+    // Map from room id to object
+    _defineProperty(this, "roomMap", new Map());
+    _defineProperty(this, "loadRequest", void 0);
+    _defineProperty(this, "nextBatch", void 0);
+    _defineProperty(this, "_rooms", void 0);
+    _defineProperty(this, "serverSupportError", void 0);
+  }
+  get noSupport() {
+    return !!this.serverSupportError;
+  }
+  get canLoadMore() {
+    return !!this.serverSupportError || !!this.nextBatch || !this._rooms;
+  }
+  get loading() {
+    return !!this.loadRequest;
+  }
+  get rooms() {
+    return this._rooms;
+  }
+  load() {
+    var _arguments = arguments,
+      _this = this;
+    return _asyncToGenerator(function* () {
+      var pageSize = _arguments.length > 0 && _arguments[0] !== undefined ? _arguments[0] : _this.pageSize;
+      if (_this.loadRequest) return _this.loadRequest.then(r => r.rooms);
+      _this.loadRequest = _this.root.client.getRoomHierarchy(_this.root.roomId, pageSize, _this.maxDepth, _this.suggestedOnly, _this.nextBatch);
+      var rooms;
+      try {
+        ({
+          rooms,
+          next_batch: _this.nextBatch
+        } = yield _this.loadRequest);
+      } catch (e) {
+        if (e.errcode === "M_UNRECOGNIZED") {
+          _this.serverSupportError = e;
+        } else {
+          throw e;
+        }
+        return [];
+      } finally {
+        _this.loadRequest = undefined;
+      }
+      if (_this._rooms) {
+        _this._rooms = _this._rooms.concat(rooms);
+      } else {
+        _this._rooms = rooms;
+      }
+      rooms.forEach(room => {
+        _this.roomMap.set(room.room_id, room);
+        room.children_state.forEach(ev => {
+          if (ev.type !== EventType.SpaceChild) return;
+          var childRoomId = ev.state_key;
+
+          // track backrefs for quicker hierarchy navigation
+          if (!_this.backRefs.has(childRoomId)) {
+            _this.backRefs.set(childRoomId, []);
+          }
+          _this.backRefs.get(childRoomId).push(room.room_id);
+
+          // fill viaMap
+          if (Array.isArray(ev.content.via)) {
+            if (!_this.viaMap.has(childRoomId)) {
+              _this.viaMap.set(childRoomId, new Set());
+            }
+            var vias = _this.viaMap.get(childRoomId);
+            ev.content.via.forEach(via => vias.add(via));
+          }
+        });
+      });
+      return rooms;
+    })();
+  }
+  getRelation(parentId, childId) {
+    var _this$roomMap$get;
+    return (_this$roomMap$get = this.roomMap.get(parentId)) === null || _this$roomMap$get === void 0 ? void 0 : _this$roomMap$get.children_state.find(e => e.state_key === childId);
+  }
+  isSuggested(parentId, childId) {
+    var _this$getRelation;
+    return (_this$getRelation = this.getRelation(parentId, childId)) === null || _this$getRelation === void 0 ? void 0 : _this$getRelation.content.suggested;
+  }
+
+  // locally remove a relation as a form of local echo
+  removeRelation(parentId, childId) {
+    var backRefs = this.backRefs.get(childId);
+    if ((backRefs === null || backRefs === void 0 ? void 0 : backRefs.length) === 1) {
+      this.backRefs.delete(childId);
+    } else if (backRefs !== null && backRefs !== void 0 && backRefs.length) {
+      this.backRefs.set(childId, backRefs.filter(ref => ref !== parentId));
+    }
+    var room = this.roomMap.get(parentId);
+    if (room) {
+      room.children_state = room.children_state.filter(ev => ev.state_key !== childId);
+    }
+  }
+}
+//# sourceMappingURL=room-hierarchy.js.map

package/lib/room-hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-hierarchy.js","names":["EventType","RoomHierarchy","constructor","root","pageSize","maxDepth","suggestedOnly","arguments","length","undefined","_defineProperty","Map","noSupport","serverSupportError","canLoadMore","nextBatch","_rooms","loading","loadRequest","rooms","load","_arguments","_this","_asyncToGenerator","then","r","client","getRoomHierarchy","roomId","next_batch","e","errcode","concat","forEach","room","roomMap","set","room_id","children_state","ev","type","SpaceChild","childRoomId","state_key","backRefs","has","get","push","Array","isArray","content","via","viaMap","Set","vias","add","getRelation","parentId","childId","_this$roomMap$get","find","isSuggested","_this$getRelation","suggested","removeRelation","delete","filter","ref"],"sources":["../src/room-hierarchy.ts"],"sourcesContent":["/*\nCopyright 2021 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 { Room } from \"./models/room.ts\";\nimport { IHierarchyRoom, IHierarchyRelation } from \"./@types/spaces.ts\";\nimport { MatrixClient } from \"./client.ts\";\nimport { EventType } from \"./@types/event.ts\";\nimport { MatrixError } from \"./http-api/index.ts\";\n\nexport class RoomHierarchy {\n    // Map from room id to list of servers which are listed as a via somewhere in the loaded hierarchy\n    public readonly viaMap = new Map<string, Set<string>>();\n    // Map from room id to list of rooms which claim this room as their child\n    public readonly backRefs = new Map<string, string[]>();\n    // Map from room id to object\n    public readonly roomMap = new Map<string, IHierarchyRoom>();\n    private loadRequest?: ReturnType<MatrixClient[\"getRoomHierarchy\"]>;\n    private nextBatch?: string;\n    private _rooms?: IHierarchyRoom[];\n    private serverSupportError?: Error;\n\n    /**\n     * Construct a new RoomHierarchy\n     *\n     * A RoomHierarchy instance allows you to easily make use of the /hierarchy API and paginate it.\n     *\n     * @param root - the root of this hierarchy\n     * @param pageSize - the maximum number of rooms to return per page, can be overridden per load request.\n     * @param maxDepth - the maximum depth to traverse the hierarchy to\n     * @param suggestedOnly - whether to only return rooms with suggested=true.\n     */\n    public constructor(\n        public readonly root: Room,\n        private readonly pageSize?: number,\n        private readonly maxDepth?: number,\n        private readonly suggestedOnly = false,\n    ) {}\n\n    public get noSupport(): boolean {\n        return !!this.serverSupportError;\n    }\n\n    public get canLoadMore(): boolean {\n        return !!this.serverSupportError || !!this.nextBatch || !this._rooms;\n    }\n\n    public get loading(): boolean {\n        return !!this.loadRequest;\n    }\n\n    public get rooms(): IHierarchyRoom[] | undefined {\n        return this._rooms;\n    }\n\n    public async load(pageSize = this.pageSize): Promise<IHierarchyRoom[]> {\n        if (this.loadRequest) return this.loadRequest.then((r) => r.rooms);\n\n        this.loadRequest = this.root.client.getRoomHierarchy(\n            this.root.roomId,\n            pageSize,\n            this.maxDepth,\n            this.suggestedOnly,\n            this.nextBatch,\n        );\n\n        let rooms: IHierarchyRoom[];\n        try {\n            ({ rooms, next_batch: this.nextBatch } = await this.loadRequest);\n        } catch (e) {\n            if ((<MatrixError>e).errcode === \"M_UNRECOGNIZED\") {\n                this.serverSupportError = <MatrixError>e;\n            } else {\n                throw e;\n            }\n\n            return [];\n        } finally {\n            this.loadRequest = undefined;\n        }\n\n        if (this._rooms) {\n            this._rooms = this._rooms.concat(rooms);\n        } else {\n            this._rooms = rooms;\n        }\n\n        rooms.forEach((room) => {\n            this.roomMap.set(room.room_id, room);\n\n            room.children_state.forEach((ev) => {\n                if (ev.type !== EventType.SpaceChild) return;\n                const childRoomId = ev.state_key;\n\n                // track backrefs for quicker hierarchy navigation\n                if (!this.backRefs.has(childRoomId)) {\n                    this.backRefs.set(childRoomId, []);\n                }\n                this.backRefs.get(childRoomId)!.push(room.room_id);\n\n                // fill viaMap\n                if (Array.isArray(ev.content.via)) {\n                    if (!this.viaMap.has(childRoomId)) {\n                        this.viaMap.set(childRoomId, new Set());\n                    }\n                    const vias = this.viaMap.get(childRoomId)!;\n                    ev.content.via.forEach((via) => vias.add(via));\n                }\n            });\n        });\n\n        return rooms;\n    }\n\n    public getRelation(parentId: string, childId: string): IHierarchyRelation | undefined {\n        return this.roomMap.get(parentId)?.children_state.find((e) => e.state_key === childId);\n    }\n\n    public isSuggested(parentId: string, childId: string): boolean | undefined {\n        return this.getRelation(parentId, childId)?.content.suggested;\n    }\n\n    // locally remove a relation as a form of local echo\n    public removeRelation(parentId: string, childId: string): void {\n        const backRefs = this.backRefs.get(childId);\n        if (backRefs?.length === 1) {\n            this.backRefs.delete(childId);\n        } else if (backRefs?.length) {\n            this.backRefs.set(\n                childId,\n                backRefs.filter((ref) => ref !== parentId),\n            );\n        }\n\n        const room = this.roomMap.get(parentId);\n        if (room) {\n            room.children_state = room.children_state.filter((ev) => ev.state_key !== childId);\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}

package/lib/rust-crypto/CrossSigningIdentity.d.ts

@@ -0,0 +1,33 @@
+import { OlmMachine } from "@matrix-org/matrix-sdk-crypto-wasm";
+import { BootstrapCrossSigningOpts } from "../crypto-api/index.ts";
+import { OutgoingRequestProcessor } from "./OutgoingRequestProcessor.ts";
+import { ServerSideSecretStorage } from "../secret-storage.ts";
+/** Manages the cross-signing keys for our own user.
+ *
+ * @internal
+ */
+export declare class CrossSigningIdentity {
+    private readonly olmMachine;
+    private readonly outgoingRequestProcessor;
+    private readonly secretStorage;
+    constructor(olmMachine: OlmMachine, outgoingRequestProcessor: OutgoingRequestProcessor, secretStorage: ServerSideSecretStorage);
+    /**
+     * Initialise our cross-signing keys by creating new keys if they do not exist, and uploading to the server
+     */
+    bootstrapCrossSigning(opts: BootstrapCrossSigningOpts): Promise<void>;
+    /** Reset our cross-signing keys
+     *
+     * This method will:
+     *   * Tell the OlmMachine to create new keys
+     *   * Upload the new public keys and the device signature to the server
+     *   * Upload the private keys to SSSS, if it is set up
+     */
+    private resetCrossSigning;
+    /**
+     * Extract the cross-signing keys from the olm machine and save them to secret storage, if it is configured
+     *
+     * (If secret storage is *not* configured, we assume that the export will happen when it is set up)
+     */
+    private exportCrossSigningKeysToStorage;
+}
+//# sourceMappingURL=CrossSigningIdentity.d.ts.map