@unwanted/matrix-sdk-mini 34.12.0-1

package/lib/rust-crypto/KeyClaimManager.js

@@ -0,0 +1,82 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2023 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.
+*/
+
+/**
+ * KeyClaimManager: linearises calls to OlmMachine.getMissingSessions to avoid races
+ *
+ * We have one of these per `RustCrypto` (and hence per `MatrixClient`).
+ *
+ * @internal
+ */
+export class KeyClaimManager {
+  constructor(olmMachine, outgoingRequestProcessor) {
+    this.olmMachine = olmMachine;
+    this.outgoingRequestProcessor = outgoingRequestProcessor;
+    _defineProperty(this, "currentClaimPromise", void 0);
+    _defineProperty(this, "stopped", false);
+    this.currentClaimPromise = Promise.resolve();
+  }
+
+  /**
+   * Tell the KeyClaimManager to immediately stop processing requests.
+   *
+   * Any further calls, and any still in the queue, will fail with an error.
+   */
+  stop() {
+    this.stopped = true;
+  }
+
+  /**
+   * Given a list of users, attempt to ensure that we have Olm Sessions active with each of their devices
+   *
+   * If we don't have an active olm session, we will claim a one-time key and start one.
+   * @param logger - logger to use
+   * @param userList - list of userIDs to claim
+   */
+  ensureSessionsForUsers(logger, userList) {
+    // The Rust-SDK requires that we only have one getMissingSessions process in flight at once. This little dance
+    // ensures that, by only having one call to ensureSessionsForUsersInner active at once (and making them
+    // queue up in order).
+    var prom = this.currentClaimPromise.catch(() => {
+      // any errors in the previous claim will have been reported already, so there is nothing to do here.
+      // we just throw away the error and start anew.
+    }).then(() => this.ensureSessionsForUsersInner(logger, userList));
+    this.currentClaimPromise = prom;
+    return prom;
+  }
+  ensureSessionsForUsersInner(logger, userList) {
+    var _this = this;
+    return _asyncToGenerator(function* () {
+      // bail out quickly if we've been stopped.
+      if (_this.stopped) {
+        throw new Error("Cannot ensure Olm sessions: shutting down");
+      }
+      logger.info("Checking for missing Olm sessions");
+      // By passing the userId array to rust we transfer ownership of the items to rust, causing
+      // them to be invalidated on the JS side as soon as the method is called.
+      // As we haven't created the `userList` let's clone the users, to not break the caller from re-using it.
+      var claimRequest = yield _this.olmMachine.getMissingSessions(userList.map(u => u.clone()));
+      if (claimRequest) {
+        logger.info("Making /keys/claim request");
+        yield _this.outgoingRequestProcessor.makeOutgoingRequest(claimRequest);
+      }
+      logger.info("Olm sessions prepared");
+    })();
+  }
+}
+//# sourceMappingURL=KeyClaimManager.js.map

package/lib/rust-crypto/KeyClaimManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyClaimManager.js","names":["KeyClaimManager","constructor","olmMachine","outgoingRequestProcessor","_defineProperty","currentClaimPromise","Promise","resolve","stop","stopped","ensureSessionsForUsers","logger","userList","prom","catch","then","ensureSessionsForUsersInner","_this","_asyncToGenerator","Error","info","claimRequest","getMissingSessions","map","u","clone","makeOutgoingRequest"],"sources":["../../src/rust-crypto/KeyClaimManager.ts"],"sourcesContent":["/*\nCopyright 2023 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 { OlmMachine, UserId } from \"@matrix-org/matrix-sdk-crypto-wasm\";\n\nimport { OutgoingRequestProcessor } from \"./OutgoingRequestProcessor.ts\";\nimport { LogSpan } from \"../logger.ts\";\n\n/**\n * KeyClaimManager: linearises calls to OlmMachine.getMissingSessions to avoid races\n *\n * We have one of these per `RustCrypto` (and hence per `MatrixClient`).\n *\n * @internal\n */\nexport class KeyClaimManager {\n    private currentClaimPromise: Promise<void>;\n    private stopped = false;\n\n    public constructor(\n        private readonly olmMachine: OlmMachine,\n        private readonly outgoingRequestProcessor: OutgoingRequestProcessor,\n    ) {\n        this.currentClaimPromise = Promise.resolve();\n    }\n\n    /**\n     * Tell the KeyClaimManager to immediately stop processing requests.\n     *\n     * Any further calls, and any still in the queue, will fail with an error.\n     */\n    public stop(): void {\n        this.stopped = true;\n    }\n\n    /**\n     * Given a list of users, attempt to ensure that we have Olm Sessions active with each of their devices\n     *\n     * If we don't have an active olm session, we will claim a one-time key and start one.\n     * @param logger - logger to use\n     * @param userList - list of userIDs to claim\n     */\n    public ensureSessionsForUsers(logger: LogSpan, userList: Array<UserId>): Promise<void> {\n        // The Rust-SDK requires that we only have one getMissingSessions process in flight at once. This little dance\n        // ensures that, by only having one call to ensureSessionsForUsersInner active at once (and making them\n        // queue up in order).\n        const prom = this.currentClaimPromise\n            .catch(() => {\n                // any errors in the previous claim will have been reported already, so there is nothing to do here.\n                // we just throw away the error and start anew.\n            })\n            .then(() => this.ensureSessionsForUsersInner(logger, userList));\n        this.currentClaimPromise = prom;\n        return prom;\n    }\n\n    private async ensureSessionsForUsersInner(logger: LogSpan, userList: Array<UserId>): Promise<void> {\n        // bail out quickly if we've been stopped.\n        if (this.stopped) {\n            throw new Error(`Cannot ensure Olm sessions: shutting down`);\n        }\n        logger.info(\"Checking for missing Olm sessions\");\n        // By passing the userId array to rust we transfer ownership of the items to rust, causing\n        // them to be invalidated on the JS side as soon as the method is called.\n        // As we haven't created the `userList` let's clone the users, to not break the caller from re-using it.\n        const claimRequest = await this.olmMachine.getMissingSessions(userList.map((u) => u.clone()));\n        if (claimRequest) {\n            logger.info(\"Making /keys/claim request\");\n            await this.outgoingRequestProcessor.makeOutgoingRequest(claimRequest);\n        }\n        logger.info(\"Olm sessions prepared\");\n    }\n}\n"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMA,eAAe,CAAC;EAIlBC,WAAWA,CACGC,UAAsB,EACtBC,wBAAkD,EACrE;IAAA,KAFmBD,UAAsB,GAAtBA,UAAsB;IAAA,KACtBC,wBAAkD,GAAlDA,wBAAkD;IAAAC,eAAA;IAAAA,eAAA,kBAJrD,KAAK;IAMnB,IAAI,CAACC,mBAAmB,GAAGC,OAAO,CAACC,OAAO,CAAC,CAAC;EAChD;;EAEA;AACJ;AACA;AACA;AACA;EACWC,IAAIA,CAAA,EAAS;IAChB,IAAI,CAACC,OAAO,GAAG,IAAI;EACvB;;EAEA;AACJ;AACA;AACA;AACA;AACA;AACA;EACWC,sBAAsBA,CAACC,MAAe,EAAEC,QAAuB,EAAiB;IACnF;IACA;IACA;IACA,IAAMC,IAAI,GAAG,IAAI,CAACR,mBAAmB,CAChCS,KAAK,CAAC,MAAM;MACT;MACA;IAAA,CACH,CAAC,CACDC,IAAI,CAAC,MAAM,IAAI,CAACC,2BAA2B,CAACL,MAAM,EAAEC,QAAQ,CAAC,CAAC;IACnE,IAAI,CAACP,mBAAmB,GAAGQ,IAAI;IAC/B,OAAOA,IAAI;EACf;EAEcG,2BAA2BA,CAACL,MAAe,EAAEC,QAAuB,EAAiB;IAAA,IAAAK,KAAA;IAAA,OAAAC,iBAAA;MAC/F;MACA,IAAID,KAAI,CAACR,OAAO,EAAE;QACd,MAAM,IAAIU,KAAK,4CAA4C,CAAC;MAChE;MACAR,MAAM,CAACS,IAAI,CAAC,mCAAmC,CAAC;MAChD;MACA;MACA;MACA,IAAMC,YAAY,SAASJ,KAAI,CAACf,UAAU,CAACoB,kBAAkB,CAACV,QAAQ,CAACW,GAAG,CAAEC,CAAC,IAAKA,CAAC,CAACC,KAAK,CAAC,CAAC,CAAC,CAAC;MAC7F,IAAIJ,YAAY,EAAE;QACdV,MAAM,CAACS,IAAI,CAAC,4BAA4B,CAAC;QACzC,MAAMH,KAAI,CAACd,wBAAwB,CAACuB,mBAAmB,CAACL,YAAY,CAAC;MACzE;MACAV,MAAM,CAACS,IAAI,CAAC,uBAAuB,CAAC;IAAC;EACzC;AACJ","ignoreList":[]}

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

@@ -0,0 +1,43 @@
+import { OlmMachine, PutDehydratedDeviceRequest, UploadSigningKeysRequest } from "@matrix-org/matrix-sdk-crypto-wasm";
+import { IHttpOpts, MatrixHttpApi } from "../http-api/index.ts";
+import { UIAuthCallback } from "../interactive-auth.ts";
+/**
+ * Common interface for all the request types returned by `OlmMachine.outgoingRequests`.
+ *
+ * @internal
+ */
+export interface OutgoingRequest {
+    readonly id: string | undefined;
+    readonly type: number;
+}
+/**
+ * OutgoingRequestManager: turns `OutgoingRequest`s from the rust sdk into HTTP requests
+ *
+ * We have one of these per `RustCrypto` (and hence per `MatrixClient`), not that it does anything terribly complicated.
+ * It's responsible for:
+ *
+ *   * holding the reference to the `MatrixHttpApi`
+ *   * turning `OutgoingRequest`s from the rust backend into HTTP requests, and sending them
+ *   * sending the results of such requests back to the rust backend.
+ *
+ * @internal
+ */
+export declare class OutgoingRequestProcessor {
+    private readonly olmMachine;
+    private readonly http;
+    constructor(olmMachine: OlmMachine, http: MatrixHttpApi<IHttpOpts & {
+        onlyData: true;
+    }>);
+    makeOutgoingRequest<T>(msg: OutgoingRequest | UploadSigningKeysRequest | PutDehydratedDeviceRequest, uiaCallback?: UIAuthCallback<T>): Promise<void>;
+    /**
+     * Send the HTTP request for a `ToDeviceRequest`
+     *
+     * @param request - request to send
+     * @returns JSON-serialized body of the response, if successful
+     */
+    private sendToDeviceRequest;
+    private makeRequestWithUIA;
+    private requestWithRetry;
+    private rawJsonRequest;
+}
+//# sourceMappingURL=OutgoingRequestProcessor.d.ts.map

package/lib/rust-crypto/OutgoingRequestProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutgoingRequestProcessor.d.ts","sourceRoot":"","sources":["../../src/rust-crypto/OutgoingRequestProcessor.ts"],"names":[],"mappings":"AAgBA,OAAO,EAKH,UAAU,EACV,0BAA0B,EAI1B,wBAAwB,EAC3B,MAAM,oCAAoC,CAAC;AAG5C,OAAO,EAAyB,SAAS,EAAE,aAAa,EAAU,MAAM,sBAAsB,CAAC;AAE/F,OAAO,EAAY,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAKlE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;;;GAWG;AACH,qBAAa,wBAAwB;IAE7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBADJ,UAAU,EAAE,UAAU,EACtB,IAAI,EAAE,aAAa,CAAC,SAAS,GAAG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,CAAC;IAG3D,mBAAmB,CAAC,CAAC,EAC9B,GAAG,EAAE,eAAe,GAAG,wBAAwB,GAAG,0BAA0B,EAC5E,WAAW,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAChC,OAAO,CAAC,IAAI,CAAC;IAsEhB;;;;;OAKG;YACW,mBAAmB;YAsBnB,kBAAkB;YA2BlB,gBAAgB;YAyBhB,cAAc;CAiB/B"}

package/lib/rust-crypto/OutgoingRequestProcessor.js

@@ -0,0 +1,195 @@
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+/*
+Copyright 2023 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 { KeysBackupRequest, KeysClaimRequest, KeysQueryRequest, KeysUploadRequest, PutDehydratedDeviceRequest, RoomMessageRequest, SignatureUploadRequest, ToDeviceRequest, UploadSigningKeysRequest } from "@matrix-org/matrix-sdk-crypto-wasm";
+import { logger } from "../logger.js";
+import { calculateRetryBackoff, Method } from "../http-api/index.js";
+import { logDuration, sleep } from "../utils.js";
+import { ToDeviceMessageId } from "../@types/event.js";
+import { UnstablePrefix as DehydrationUnstablePrefix } from "./DehydratedDeviceManager.js";
+
+/**
+ * Common interface for all the request types returned by `OlmMachine.outgoingRequests`.
+ *
+ * @internal
+ */
+
+/**
+ * OutgoingRequestManager: turns `OutgoingRequest`s from the rust sdk into HTTP requests
+ *
+ * We have one of these per `RustCrypto` (and hence per `MatrixClient`), not that it does anything terribly complicated.
+ * It's responsible for:
+ *
+ *   * holding the reference to the `MatrixHttpApi`
+ *   * turning `OutgoingRequest`s from the rust backend into HTTP requests, and sending them
+ *   * sending the results of such requests back to the rust backend.
+ *
+ * @internal
+ */
+export class OutgoingRequestProcessor {
+  constructor(olmMachine, http) {
+    this.olmMachine = olmMachine;
+    this.http = http;
+  }
+  makeOutgoingRequest(msg, uiaCallback) {
+    var _this = this;
+    return _asyncToGenerator(function* () {
+      var resp;
+
+      /* refer https://docs.rs/matrix-sdk-crypto/0.6.0/matrix_sdk_crypto/requests/enum.OutgoingRequests.html
+       * for the complete list of request types
+       */
+      if (msg instanceof KeysUploadRequest) {
+        resp = yield _this.requestWithRetry(Method.Post, "/_matrix/client/v3/keys/upload", {}, msg.body);
+      } else if (msg instanceof KeysQueryRequest) {
+        resp = yield _this.requestWithRetry(Method.Post, "/_matrix/client/v3/keys/query", {}, msg.body);
+      } else if (msg instanceof KeysClaimRequest) {
+        resp = yield _this.requestWithRetry(Method.Post, "/_matrix/client/v3/keys/claim", {}, msg.body);
+      } else if (msg instanceof SignatureUploadRequest) {
+        resp = yield _this.requestWithRetry(Method.Post, "/_matrix/client/v3/keys/signatures/upload", {}, msg.body);
+      } else if (msg instanceof KeysBackupRequest) {
+        resp = yield _this.requestWithRetry(Method.Put, "/_matrix/client/v3/room_keys/keys", {
+          version: msg.version
+        }, msg.body);
+      } else if (msg instanceof ToDeviceRequest) {
+        resp = yield _this.sendToDeviceRequest(msg);
+      } else if (msg instanceof RoomMessageRequest) {
+        var path = "/_matrix/client/v3/rooms/".concat(encodeURIComponent(msg.room_id), "/send/") + "".concat(encodeURIComponent(msg.event_type), "/").concat(encodeURIComponent(msg.txn_id));
+        resp = yield _this.requestWithRetry(Method.Put, path, {}, msg.body);
+      } else if (msg instanceof UploadSigningKeysRequest) {
+        yield _this.makeRequestWithUIA(Method.Post, "/_matrix/client/v3/keys/device_signing/upload", {}, msg.body, uiaCallback);
+        // SigningKeysUploadRequest does not implement OutgoingRequest and does not need to be marked as sent.
+        return;
+      } else if (msg instanceof PutDehydratedDeviceRequest) {
+        var _path = DehydrationUnstablePrefix + "/dehydrated_device";
+        yield _this.rawJsonRequest(Method.Put, _path, {}, msg.body);
+        // PutDehydratedDeviceRequest does not implement OutgoingRequest and does not need to be marked as sent.
+        return;
+      } else {
+        logger.warn("Unsupported outgoing message", Object.getPrototypeOf(msg));
+        resp = "";
+      }
+      if (msg.id) {
+        try {
+          yield logDuration(logger, "Mark Request as sent ".concat(msg.type), /*#__PURE__*/_asyncToGenerator(function* () {
+            yield _this.olmMachine.markRequestAsSent(msg.id, msg.type, resp);
+          }));
+        } catch (e) {
+          // Ignore errors which are caused by the olmMachine having been freed. The exact error message depends
+          // on whether we are using a release or develop build of rust-sdk-crypto-wasm.
+          if (e instanceof Error && (e.message === "Attempt to use a moved value" || e.message === "null pointer passed to rust")) {
+            logger.log("Ignoring error '".concat(e.message, "': client is likely shutting down"));
+          } else {
+            throw e;
+          }
+        }
+      } else {
+        logger.trace("Outgoing request type:".concat(msg.type, " does not have an ID"));
+      }
+    })();
+  }
+
+  /**
+   * Send the HTTP request for a `ToDeviceRequest`
+   *
+   * @param request - request to send
+   * @returns JSON-serialized body of the response, if successful
+   */
+  sendToDeviceRequest(request) {
+    var _this2 = this;
+    return _asyncToGenerator(function* () {
+      // a bit of extra logging, to help trace to-device messages through the system
+      var parsedBody = JSON.parse(request.body);
+      var messageList = [];
+      for (var [userId, perUserMessages] of Object.entries(parsedBody.messages)) {
+        for (var [deviceId, message] of Object.entries(perUserMessages)) {
+          messageList.push("".concat(userId, "/").concat(deviceId, " (msgid ").concat(message[ToDeviceMessageId], ")"));
+        }
+      }
+      logger.info("Sending batch of to-device messages. type=".concat(request.event_type, " txnid=").concat(request.txn_id), messageList);
+      var path = "/_matrix/client/v3/sendToDevice/".concat(encodeURIComponent(request.event_type), "/") + encodeURIComponent(request.txn_id);
+      return yield _this2.requestWithRetry(Method.Put, path, {}, request.body);
+    })();
+  }
+  makeRequestWithUIA(method, path, queryParams, body, uiaCallback) {
+    var _this3 = this;
+    return _asyncToGenerator(function* () {
+      if (!uiaCallback) {
+        return yield _this3.requestWithRetry(method, path, queryParams, body);
+      }
+      var parsedBody = JSON.parse(body);
+      var makeRequest = /*#__PURE__*/function () {
+        var _ref2 = _asyncToGenerator(function* (auth) {
+          var newBody = _objectSpread({}, parsedBody);
+          if (auth !== null) {
+            newBody.auth = auth;
+          }
+          var resp = yield _this3.requestWithRetry(method, path, queryParams, JSON.stringify(newBody));
+          return JSON.parse(resp);
+        });
+        return function makeRequest(_x) {
+          return _ref2.apply(this, arguments);
+        };
+      }();
+      var resp = yield uiaCallback(makeRequest);
+      return JSON.stringify(resp);
+    })();
+  }
+  requestWithRetry(method, path, queryParams, body) {
+    var _this4 = this;
+    return _asyncToGenerator(function* () {
+      var currentRetryCount = 0;
+
+      // eslint-disable-next-line no-constant-condition
+      while (true) {
+        try {
+          return yield _this4.rawJsonRequest(method, path, queryParams, body);
+        } catch (e) {
+          currentRetryCount++;
+          var backoff = calculateRetryBackoff(e, currentRetryCount, true);
+          if (backoff < 0) {
+            // Max number of retries reached, or error is not retryable. rethrow the error
+            throw e;
+          }
+          // wait for the specified time and then retry the request
+          yield sleep(backoff);
+        }
+      }
+    })();
+  }
+  rawJsonRequest(method, path, queryParams, body) {
+    var _this5 = this;
+    return _asyncToGenerator(function* () {
+      var opts = {
+        // inhibit the JSON stringification and parsing within HttpApi.
+        json: false,
+        // nevertheless, we are sending, and accept, JSON.
+        headers: {
+          "Content-Type": "application/json",
+          "Accept": "application/json"
+        },
+        // we use the full prefix
+        prefix: ""
+      };
+      return yield _this5.http.authedRequest(method, path, queryParams, body, opts);
+    })();
+  }
+}
+//# sourceMappingURL=OutgoingRequestProcessor.js.map

package/lib/rust-crypto/OutgoingRequestProcessor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutgoingRequestProcessor.js","names":["KeysBackupRequest","KeysClaimRequest","KeysQueryRequest","KeysUploadRequest","PutDehydratedDeviceRequest","RoomMessageRequest","SignatureUploadRequest","ToDeviceRequest","UploadSigningKeysRequest","logger","calculateRetryBackoff","Method","logDuration","sleep","ToDeviceMessageId","UnstablePrefix","DehydrationUnstablePrefix","OutgoingRequestProcessor","constructor","olmMachine","http","makeOutgoingRequest","msg","uiaCallback","_this","_asyncToGenerator","resp","requestWithRetry","Post","body","Put","version","sendToDeviceRequest","path","concat","encodeURIComponent","room_id","event_type","txn_id","makeRequestWithUIA","rawJsonRequest","warn","Object","getPrototypeOf","id","type","markRequestAsSent","e","Error","message","log","trace","request","_this2","parsedBody","JSON","parse","messageList","userId","perUserMessages","entries","messages","deviceId","push","info","method","queryParams","_this3","makeRequest","_ref2","auth","newBody","_objectSpread","stringify","_x","apply","arguments","_this4","currentRetryCount","backoff","_this5","opts","json","headers","prefix","authedRequest"],"sources":["../../src/rust-crypto/OutgoingRequestProcessor.ts"],"sourcesContent":["/*\nCopyright 2023 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 {\n    KeysBackupRequest,\n    KeysClaimRequest,\n    KeysQueryRequest,\n    KeysUploadRequest,\n    OlmMachine,\n    PutDehydratedDeviceRequest,\n    RoomMessageRequest,\n    SignatureUploadRequest,\n    ToDeviceRequest,\n    UploadSigningKeysRequest,\n} from \"@matrix-org/matrix-sdk-crypto-wasm\";\n\nimport { logger } from \"../logger.ts\";\nimport { calculateRetryBackoff, IHttpOpts, MatrixHttpApi, Method } from \"../http-api/index.ts\";\nimport { logDuration, QueryDict, sleep } from \"../utils.ts\";\nimport { AuthDict, UIAuthCallback } from \"../interactive-auth.ts\";\nimport { UIAResponse } from \"../@types/uia.ts\";\nimport { ToDeviceMessageId } from \"../@types/event.ts\";\nimport { UnstablePrefix as DehydrationUnstablePrefix } from \"./DehydratedDeviceManager.ts\";\n\n/**\n * Common interface for all the request types returned by `OlmMachine.outgoingRequests`.\n *\n * @internal\n */\nexport interface OutgoingRequest {\n    readonly id: string | undefined;\n    readonly type: number;\n}\n\n/**\n * OutgoingRequestManager: turns `OutgoingRequest`s from the rust sdk into HTTP requests\n *\n * We have one of these per `RustCrypto` (and hence per `MatrixClient`), not that it does anything terribly complicated.\n * It's responsible for:\n *\n *   * holding the reference to the `MatrixHttpApi`\n *   * turning `OutgoingRequest`s from the rust backend into HTTP requests, and sending them\n *   * sending the results of such requests back to the rust backend.\n *\n * @internal\n */\nexport class OutgoingRequestProcessor {\n    public constructor(\n        private readonly olmMachine: OlmMachine,\n        private readonly http: MatrixHttpApi<IHttpOpts & { onlyData: true }>,\n    ) {}\n\n    public async makeOutgoingRequest<T>(\n        msg: OutgoingRequest | UploadSigningKeysRequest | PutDehydratedDeviceRequest,\n        uiaCallback?: UIAuthCallback<T>,\n    ): Promise<void> {\n        let resp: string;\n\n        /* refer https://docs.rs/matrix-sdk-crypto/0.6.0/matrix_sdk_crypto/requests/enum.OutgoingRequests.html\n         * for the complete list of request types\n         */\n        if (msg instanceof KeysUploadRequest) {\n            resp = await this.requestWithRetry(Method.Post, \"/_matrix/client/v3/keys/upload\", {}, msg.body);\n        } else if (msg instanceof KeysQueryRequest) {\n            resp = await this.requestWithRetry(Method.Post, \"/_matrix/client/v3/keys/query\", {}, msg.body);\n        } else if (msg instanceof KeysClaimRequest) {\n            resp = await this.requestWithRetry(Method.Post, \"/_matrix/client/v3/keys/claim\", {}, msg.body);\n        } else if (msg instanceof SignatureUploadRequest) {\n            resp = await this.requestWithRetry(Method.Post, \"/_matrix/client/v3/keys/signatures/upload\", {}, msg.body);\n        } else if (msg instanceof KeysBackupRequest) {\n            resp = await this.requestWithRetry(\n                Method.Put,\n                \"/_matrix/client/v3/room_keys/keys\",\n                { version: msg.version },\n                msg.body,\n            );\n        } else if (msg instanceof ToDeviceRequest) {\n            resp = await this.sendToDeviceRequest(msg);\n        } else if (msg instanceof RoomMessageRequest) {\n            const path =\n                `/_matrix/client/v3/rooms/${encodeURIComponent(msg.room_id)}/send/` +\n                `${encodeURIComponent(msg.event_type)}/${encodeURIComponent(msg.txn_id)}`;\n            resp = await this.requestWithRetry(Method.Put, path, {}, msg.body);\n        } else if (msg instanceof UploadSigningKeysRequest) {\n            await this.makeRequestWithUIA(\n                Method.Post,\n                \"/_matrix/client/v3/keys/device_signing/upload\",\n                {},\n                msg.body,\n                uiaCallback,\n            );\n            // SigningKeysUploadRequest does not implement OutgoingRequest and does not need to be marked as sent.\n            return;\n        } else if (msg instanceof PutDehydratedDeviceRequest) {\n            const path = DehydrationUnstablePrefix + \"/dehydrated_device\";\n            await this.rawJsonRequest(Method.Put, path, {}, msg.body);\n            // PutDehydratedDeviceRequest does not implement OutgoingRequest and does not need to be marked as sent.\n            return;\n        } else {\n            logger.warn(\"Unsupported outgoing message\", Object.getPrototypeOf(msg));\n            resp = \"\";\n        }\n\n        if (msg.id) {\n            try {\n                await logDuration(logger, `Mark Request as sent ${msg.type}`, async () => {\n                    await this.olmMachine.markRequestAsSent(msg.id!, msg.type, resp);\n                });\n            } catch (e) {\n                // Ignore errors which are caused by the olmMachine having been freed. The exact error message depends\n                // on whether we are using a release or develop build of rust-sdk-crypto-wasm.\n                if (\n                    e instanceof Error &&\n                    (e.message === \"Attempt to use a moved value\" || e.message === \"null pointer passed to rust\")\n                ) {\n                    logger.log(`Ignoring error '${e.message}': client is likely shutting down`);\n                } else {\n                    throw e;\n                }\n            }\n        } else {\n            logger.trace(`Outgoing request type:${msg.type} does not have an ID`);\n        }\n    }\n\n    /**\n     * Send the HTTP request for a `ToDeviceRequest`\n     *\n     * @param request - request to send\n     * @returns JSON-serialized body of the response, if successful\n     */\n    private async sendToDeviceRequest(request: ToDeviceRequest): Promise<string> {\n        // a bit of extra logging, to help trace to-device messages through the system\n        const parsedBody: { messages: Record<string, Record<string, Record<string, any>>> } = JSON.parse(request.body);\n\n        const messageList = [];\n        for (const [userId, perUserMessages] of Object.entries(parsedBody.messages)) {\n            for (const [deviceId, message] of Object.entries(perUserMessages)) {\n                messageList.push(`${userId}/${deviceId} (msgid ${message[ToDeviceMessageId]})`);\n            }\n        }\n\n        logger.info(\n            `Sending batch of to-device messages. type=${request.event_type} txnid=${request.txn_id}`,\n            messageList,\n        );\n\n        const path =\n            `/_matrix/client/v3/sendToDevice/${encodeURIComponent(request.event_type)}/` +\n            encodeURIComponent(request.txn_id);\n        return await this.requestWithRetry(Method.Put, path, {}, request.body);\n    }\n\n    private async makeRequestWithUIA<T>(\n        method: Method,\n        path: string,\n        queryParams: QueryDict,\n        body: string,\n        uiaCallback: UIAuthCallback<T> | undefined,\n    ): Promise<string> {\n        if (!uiaCallback) {\n            return await this.requestWithRetry(method, path, queryParams, body);\n        }\n\n        const parsedBody = JSON.parse(body);\n        const makeRequest = async (auth: AuthDict | null): Promise<UIAResponse<T>> => {\n            const newBody: Record<string, any> = {\n                ...parsedBody,\n            };\n            if (auth !== null) {\n                newBody.auth = auth;\n            }\n            const resp = await this.requestWithRetry(method, path, queryParams, JSON.stringify(newBody));\n            return JSON.parse(resp) as T;\n        };\n\n        const resp = await uiaCallback(makeRequest);\n        return JSON.stringify(resp);\n    }\n\n    private async requestWithRetry(\n        method: Method,\n        path: string,\n        queryParams: QueryDict,\n        body: string,\n    ): Promise<string> {\n        let currentRetryCount = 0;\n\n        // eslint-disable-next-line no-constant-condition\n        while (true) {\n            try {\n                return await this.rawJsonRequest(method, path, queryParams, body);\n            } catch (e) {\n                currentRetryCount++;\n                const backoff = calculateRetryBackoff(e, currentRetryCount, true);\n                if (backoff < 0) {\n                    // Max number of retries reached, or error is not retryable. rethrow the error\n                    throw e;\n                }\n                // wait for the specified time and then retry the request\n                await sleep(backoff);\n            }\n        }\n    }\n\n    private async rawJsonRequest(method: Method, path: string, queryParams: QueryDict, body: string): Promise<string> {\n        const opts = {\n            // inhibit the JSON stringification and parsing within HttpApi.\n            json: false,\n\n            // nevertheless, we are sending, and accept, JSON.\n            headers: {\n                \"Content-Type\": \"application/json\",\n                \"Accept\": \"application/json\",\n            },\n\n            // we use the full prefix\n            prefix: \"\",\n        };\n\n        return await this.http.authedRequest<string>(method, path, queryParams, body, opts);\n    }\n}\n"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,47 @@
+import { OlmMachine } from "@matrix-org/matrix-sdk-crypto-wasm";
+import { OutgoingRequestProcessor } from "./OutgoingRequestProcessor.ts";
+import { Logger } from "../logger.ts";
+/**
+ * OutgoingRequestsManager: responsible for processing outgoing requests from the OlmMachine.
+ * Ensure that only one loop is going on at once, and that the requests are processed in order.
+ */
+export declare class OutgoingRequestsManager {
+    private readonly logger;
+    private readonly olmMachine;
+    readonly outgoingRequestProcessor: OutgoingRequestProcessor;
+    /** whether {@link stop} has been called */
+    private stopped;
+    /** whether {@link outgoingRequestLoop} is currently running */
+    private outgoingRequestLoopRunning;
+    /**
+     * If there are additional calls to doProcessOutgoingRequests() while there is a current call running
+     * we need to remember in order to call `doProcessOutgoingRequests` again (as there could be new requests).
+     *
+     * If this is defined, it is an indication that we need to do another iteration; in this case the deferred
+     * will resolve once that next iteration completes. If it is undefined, there have been no new calls
+     * to `doProcessOutgoingRequests` since the current iteration started.
+     */
+    private nextLoopDeferred?;
+    constructor(logger: Logger, olmMachine: OlmMachine, outgoingRequestProcessor: OutgoingRequestProcessor);
+    /**
+     * Shut down as soon as possible the current loop of outgoing requests processing.
+     */
+    stop(): void;
+    /**
+     * Process the OutgoingRequests from the OlmMachine.
+     *
+     * This should be called at the end of each sync, to process any OlmMachine OutgoingRequests created by the rust sdk.
+     * In some cases if OutgoingRequests need to be sent immediately, this can be called directly.
+     *
+     * Calls to doProcessOutgoingRequests() are processed synchronously, one after the other, in order.
+     * If doProcessOutgoingRequests() is called while another call is still being processed, it will be queued.
+     * Multiple calls to doProcessOutgoingRequests() when a call is already processing will be batched together.
+     */
+    doProcessOutgoingRequests(): Promise<void>;
+    private outgoingRequestLoop;
+    /**
+     * Make a single request to `olmMachine.outgoingRequests` and do the corresponding requests.
+     */
+    private processOutgoingRequests;
+}
+//# sourceMappingURL=OutgoingRequestsManager.d.ts.map

package/lib/rust-crypto/OutgoingRequestsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutgoingRequestsManager.d.ts","sourceRoot":"","sources":["../../src/rust-crypto/OutgoingRequestsManager.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAAmB,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAC1F,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC;;;GAGG;AACH,qBAAa,uBAAuB;IAkB5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,UAAU;aACX,wBAAwB,EAAE,wBAAwB;IAnBtE,2CAA2C;IAC3C,OAAO,CAAC,OAAO,CAAS;IAExB,+DAA+D;IAC/D,OAAO,CAAC,0BAA0B,CAAS;IAE3C;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB,CAAC,CAAkB;gBAGtB,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,UAAU,EACvB,wBAAwB,EAAE,wBAAwB;IAGtE;;OAEG;IACI,IAAI,IAAI,IAAI;IAInB;;;;;;;;;OASG;IACI,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;YA2BnC,mBAAmB;IA4BjC;;OAEG;YACW,uBAAuB;CAkBxC"}

package/lib/rust-crypto/OutgoingRequestsManager.js

@@ -0,0 +1,148 @@
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
+import _defineProperty from "@babel/runtime/helpers/defineProperty";
+/*
+Copyright 2023 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 { defer, logDuration } from "../utils.js";
+
+/**
+ * OutgoingRequestsManager: responsible for processing outgoing requests from the OlmMachine.
+ * Ensure that only one loop is going on at once, and that the requests are processed in order.
+ */
+export class OutgoingRequestsManager {
+  constructor(logger, olmMachine, outgoingRequestProcessor) {
+    this.logger = logger;
+    this.olmMachine = olmMachine;
+    this.outgoingRequestProcessor = outgoingRequestProcessor;
+    /** whether {@link stop} has been called */
+    _defineProperty(this, "stopped", false);
+    /** whether {@link outgoingRequestLoop} is currently running */
+    _defineProperty(this, "outgoingRequestLoopRunning", false);
+    /**
+     * If there are additional calls to doProcessOutgoingRequests() while there is a current call running
+     * we need to remember in order to call `doProcessOutgoingRequests` again (as there could be new requests).
+     *
+     * If this is defined, it is an indication that we need to do another iteration; in this case the deferred
+     * will resolve once that next iteration completes. If it is undefined, there have been no new calls
+     * to `doProcessOutgoingRequests` since the current iteration started.
+     */
+    _defineProperty(this, "nextLoopDeferred", void 0);
+  }
+
+  /**
+   * Shut down as soon as possible the current loop of outgoing requests processing.
+   */
+  stop() {
+    this.stopped = true;
+  }
+
+  /**
+   * Process the OutgoingRequests from the OlmMachine.
+   *
+   * This should be called at the end of each sync, to process any OlmMachine OutgoingRequests created by the rust sdk.
+   * In some cases if OutgoingRequests need to be sent immediately, this can be called directly.
+   *
+   * Calls to doProcessOutgoingRequests() are processed synchronously, one after the other, in order.
+   * If doProcessOutgoingRequests() is called while another call is still being processed, it will be queued.
+   * Multiple calls to doProcessOutgoingRequests() when a call is already processing will be batched together.
+   */
+  doProcessOutgoingRequests() {
+    // Flag that we need at least one more iteration of the loop.
+    //
+    // It is important that we do this even if the loop is currently running. There is potential for a race whereby
+    // a request is added to the queue *after* `OlmMachine.outgoingRequests` checks the queue, but *before* it
+    // returns. In such a case, the item could sit there unnoticed for some time.
+    //
+    // In order to circumvent the race, we set a flag which tells the loop to go round once again even if the
+    // queue appears to be empty.
+    if (!this.nextLoopDeferred) {
+      this.nextLoopDeferred = defer();
+    }
+
+    // ... and wait for it to complete.
+    var result = this.nextLoopDeferred.promise;
+
+    // set the loop going if it is not already.
+    if (!this.outgoingRequestLoopRunning) {
+      this.outgoingRequestLoop().catch(e => {
+        // this should not happen; outgoingRequestLoop should return any errors via `nextLoopDeferred`.
+        /* istanbul ignore next */
+        this.logger.error("Uncaught error in outgoing request loop", e);
+      });
+    }
+    return result;
+  }
+  outgoingRequestLoop() {
+    var _this = this;
+    return _asyncToGenerator(function* () {
+      /* istanbul ignore if */
+      if (_this.outgoingRequestLoopRunning) {
+        throw new Error("Cannot run two outgoing request loops");
+      }
+      _this.outgoingRequestLoopRunning = true;
+      try {
+        while (!_this.stopped && _this.nextLoopDeferred) {
+          var deferred = _this.nextLoopDeferred;
+
+          // reset `nextLoopDeferred` so that any future calls to `doProcessOutgoingRequests` are queued
+          // for another additional iteration.
+          _this.nextLoopDeferred = undefined;
+
+          // make the requests and feed the results back to the `nextLoopDeferred`
+          yield _this.processOutgoingRequests().then(deferred.resolve, deferred.reject);
+        }
+      } finally {
+        _this.outgoingRequestLoopRunning = false;
+      }
+      if (_this.nextLoopDeferred) {
+        // the loop was stopped, but there was a call to `doProcessOutgoingRequests`. Make sure that
+        // we reject the promise in case anything is waiting for it.
+        _this.nextLoopDeferred.reject(new Error("OutgoingRequestsManager was stopped"));
+      }
+    })();
+  }
+
+  /**
+   * Make a single request to `olmMachine.outgoingRequests` and do the corresponding requests.
+   */
+  processOutgoingRequests() {
+    var _this2 = this;
+    return _asyncToGenerator(function* () {
+      if (_this2.stopped) return;
+      var outgoingRequests = yield _this2.olmMachine.outgoingRequests();
+      var _loop = function* _loop(request) {
+          if (_this2.stopped) return {
+            v: void 0
+          };
+          try {
+            yield logDuration(_this2.logger, "Make outgoing request ".concat(request.type), /*#__PURE__*/_asyncToGenerator(function* () {
+              yield _this2.outgoingRequestProcessor.makeOutgoingRequest(request);
+            }));
+          } catch (e) {
+            // as part of the loop we silently ignore errors, but log them.
+            // The rust sdk will retry the request later as it won't have been marked as sent.
+            _this2.logger.error("Failed to process outgoing request ".concat(request.type, ": ").concat(e));
+          }
+        },
+        _ret;
+      for (var request of outgoingRequests) {
+        _ret = yield* _loop(request);
+        if (_ret) return _ret.v;
+      }
+    })();
+  }
+}
+//# sourceMappingURL=OutgoingRequestsManager.js.map

package/lib/rust-crypto/OutgoingRequestsManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OutgoingRequestsManager.js","names":["defer","logDuration","OutgoingRequestsManager","constructor","logger","olmMachine","outgoingRequestProcessor","_defineProperty","stop","stopped","doProcessOutgoingRequests","nextLoopDeferred","result","promise","outgoingRequestLoopRunning","outgoingRequestLoop","catch","e","error","_this","_asyncToGenerator","Error","deferred","undefined","processOutgoingRequests","then","resolve","reject","_this2","outgoingRequests","_loop","request","v","concat","type","makeOutgoingRequest","_ret"],"sources":["../../src/rust-crypto/OutgoingRequestsManager.ts"],"sourcesContent":["/*\nCopyright 2023 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 { OlmMachine } from \"@matrix-org/matrix-sdk-crypto-wasm\";\n\nimport { OutgoingRequest, OutgoingRequestProcessor } from \"./OutgoingRequestProcessor.ts\";\nimport { Logger } from \"../logger.ts\";\nimport { defer, IDeferred, logDuration } from \"../utils.ts\";\n\n/**\n * OutgoingRequestsManager: responsible for processing outgoing requests from the OlmMachine.\n * Ensure that only one loop is going on at once, and that the requests are processed in order.\n */\nexport class OutgoingRequestsManager {\n    /** whether {@link stop} has been called */\n    private stopped = false;\n\n    /** whether {@link outgoingRequestLoop} is currently running */\n    private outgoingRequestLoopRunning = false;\n\n    /**\n     * If there are additional calls to doProcessOutgoingRequests() while there is a current call running\n     * we need to remember in order to call `doProcessOutgoingRequests` again (as there could be new requests).\n     *\n     * If this is defined, it is an indication that we need to do another iteration; in this case the deferred\n     * will resolve once that next iteration completes. If it is undefined, there have been no new calls\n     * to `doProcessOutgoingRequests` since the current iteration started.\n     */\n    private nextLoopDeferred?: IDeferred<void>;\n\n    public constructor(\n        private readonly logger: Logger,\n        private readonly olmMachine: OlmMachine,\n        public readonly outgoingRequestProcessor: OutgoingRequestProcessor,\n    ) {}\n\n    /**\n     * Shut down as soon as possible the current loop of outgoing requests processing.\n     */\n    public stop(): void {\n        this.stopped = true;\n    }\n\n    /**\n     * Process the OutgoingRequests from the OlmMachine.\n     *\n     * This should be called at the end of each sync, to process any OlmMachine OutgoingRequests created by the rust sdk.\n     * In some cases if OutgoingRequests need to be sent immediately, this can be called directly.\n     *\n     * Calls to doProcessOutgoingRequests() are processed synchronously, one after the other, in order.\n     * If doProcessOutgoingRequests() is called while another call is still being processed, it will be queued.\n     * Multiple calls to doProcessOutgoingRequests() when a call is already processing will be batched together.\n     */\n    public doProcessOutgoingRequests(): Promise<void> {\n        // Flag that we need at least one more iteration of the loop.\n        //\n        // It is important that we do this even if the loop is currently running. There is potential for a race whereby\n        // a request is added to the queue *after* `OlmMachine.outgoingRequests` checks the queue, but *before* it\n        // returns. In such a case, the item could sit there unnoticed for some time.\n        //\n        // In order to circumvent the race, we set a flag which tells the loop to go round once again even if the\n        // queue appears to be empty.\n        if (!this.nextLoopDeferred) {\n            this.nextLoopDeferred = defer();\n        }\n\n        // ... and wait for it to complete.\n        const result = this.nextLoopDeferred.promise;\n\n        // set the loop going if it is not already.\n        if (!this.outgoingRequestLoopRunning) {\n            this.outgoingRequestLoop().catch((e) => {\n                // this should not happen; outgoingRequestLoop should return any errors via `nextLoopDeferred`.\n                /* istanbul ignore next */\n                this.logger.error(\"Uncaught error in outgoing request loop\", e);\n            });\n        }\n        return result;\n    }\n\n    private async outgoingRequestLoop(): Promise<void> {\n        /* istanbul ignore if */\n        if (this.outgoingRequestLoopRunning) {\n            throw new Error(\"Cannot run two outgoing request loops\");\n        }\n        this.outgoingRequestLoopRunning = true;\n        try {\n            while (!this.stopped && this.nextLoopDeferred) {\n                const deferred = this.nextLoopDeferred;\n\n                // reset `nextLoopDeferred` so that any future calls to `doProcessOutgoingRequests` are queued\n                // for another additional iteration.\n                this.nextLoopDeferred = undefined;\n\n                // make the requests and feed the results back to the `nextLoopDeferred`\n                await this.processOutgoingRequests().then(deferred.resolve, deferred.reject);\n            }\n        } finally {\n            this.outgoingRequestLoopRunning = false;\n        }\n\n        if (this.nextLoopDeferred) {\n            // the loop was stopped, but there was a call to `doProcessOutgoingRequests`. Make sure that\n            // we reject the promise in case anything is waiting for it.\n            this.nextLoopDeferred.reject(new Error(\"OutgoingRequestsManager was stopped\"));\n        }\n    }\n\n    /**\n     * Make a single request to `olmMachine.outgoingRequests` and do the corresponding requests.\n     */\n    private async processOutgoingRequests(): Promise<void> {\n        if (this.stopped) return;\n\n        const outgoingRequests: OutgoingRequest[] = await this.olmMachine.outgoingRequests();\n\n        for (const request of outgoingRequests) {\n            if (this.stopped) return;\n            try {\n                await logDuration(this.logger, `Make outgoing request ${request.type}`, async () => {\n                    await this.outgoingRequestProcessor.makeOutgoingRequest(request);\n                });\n            } catch (e) {\n                // as part of the loop we silently ignore errors, but log them.\n                // The rust sdk will retry the request later as it won't have been marked as sent.\n                this.logger.error(`Failed to process outgoing request ${request.type}: ${e}`);\n            }\n        }\n    }\n}\n"],"mappings":"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","ignoreList":[]}