@matrix-widget-toolkit/api 3.0.0 → 3.1.0

package/build/cjs/index.js

@@ -1043,12 +1043,28 @@ var WidgetApiImpl = /** @class */ (function () {
     /** {@inheritDoc WidgetApi.widgetParameters} */
     widgetParameters, _a) {
         var _b = _a === void 0 ? {} : _a, _c = _b.capabilities, capabilities = _c === void 0 ? [] : _c, _d = _b.supportStandalone, supportStandalone = _d === void 0 ? false : _d;
+        var _this = this;
         this.matrixWidgetApi = matrixWidgetApi$1;
         this.widgetId = widgetId;
         this.widgetParameters = widgetParameters;
-        var eventName = "action:".concat(matrixWidgetApi.WidgetApiToWidgetAction.SendEvent);
-        this.events$ = rxjs.fromEvent(this.matrixWidgetApi, eventName, function (event) {
+        this.events$ = rxjs.fromEvent(this.matrixWidgetApi, "action:".concat(matrixWidgetApi.WidgetApiToWidgetAction.SendEvent), function (event) {
             event.preventDefault();
+            try {
+                _this.matrixWidgetApi.transport.reply(event.detail, {});
+            }
+            catch (_) {
+                // Ignore errors while replying
+            }
+            return event;
+        }).pipe(rxjs.share());
+        this.toDeviceMessages$ = rxjs.fromEvent(this.matrixWidgetApi, 'action:send_to_device', function (event) {
+            event.preventDefault();
+            try {
+                matrixWidgetApi$1.transport.reply(event.detail, {});
+            }
+            catch (_) {
+                // Ignore errors while replying
+            }
             return event;
         }).pipe(rxjs.share());
         this.initialCapabilities = __spreadArray(__spreadArray([], capabilities, true), (supportStandalone ? [] : [matrixWidgetApi.MatrixCapabilities.RequiresClient]), true);
@@ -1294,7 +1310,6 @@ var WidgetApiImpl = /** @class */ (function () {
     };
     /** {@inheritDoc WidgetApi.observeStateEvents} */
     WidgetApiImpl.prototype.observeStateEvents = function (eventType, _a) {
-        var _this = this;
         var _b = _a === void 0 ? {} : _a, stateKey = _b.stateKey, roomIds = _b.roomIds;
         var currentRoomId = this.widgetParameters.roomId;
         if (!currentRoomId) {
@@ -1307,7 +1322,6 @@ var WidgetApiImpl = /** @class */ (function () {
                 matrixEvent.state_key !== undefined &&
                 (stateKey === undefined || matrixEvent.state_key === stateKey) &&
                 isInRoom(matrixEvent, currentRoomId, roomIds)) {
-                _this.matrixWidgetApi.transport.reply(event.detail, {});
                 return event.detail.data;
             }
             return undefined;
@@ -1318,45 +1332,31 @@ var WidgetApiImpl = /** @class */ (function () {
     WidgetApiImpl.prototype.sendStateEvent = function (eventType, content, _a) {
         var _b = _a === void 0 ? {} : _a, roomId = _b.roomId, _c = _b.stateKey, stateKey = _c === void 0 ? '' : _c;
         return __awaiter(this, void 0, void 0, function () {
-            var firstEvent$;
-            var _this = this;
-            return __generator(this, function (_d) {
-                firstEvent$ = this.events$.pipe(rxjs.map(function (event) {
-                    var matrixEvent = event.detail.data;
-                    if (matrixEvent.sender === _this.widgetParameters.userId &&
-                        matrixEvent.state_key !== undefined &&
-                        matrixEvent.type === eventType &&
-                        (!roomId || matrixEvent.room_id === roomId)) {
-                        _this.matrixWidgetApi.transport.reply(event.detail, {});
-                        return event.detail.data;
-                    }
-                    return undefined;
-                }), rxjs.filter(isDefined), rxjs.first());
-                return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(_this, void 0, void 0, function () {
-                        var subscription, err_2;
-                        return __generator(this, function (_a) {
-                            switch (_a.label) {
-                                case 0:
-                                    subscription = firstEvent$.subscribe({
-                                        next: function (event) { return resolve(event); },
-                                        error: function (err) { return reject(err); },
-                                    });
-                                    _a.label = 1;
-                                case 1:
-                                    _a.trys.push([1, 3, , 4]);
-                                    return [4 /*yield*/, this.matrixWidgetApi.sendStateEvent(eventType, stateKey, content, roomId)];
-                                case 2:
-                                    _a.sent();
-                                    return [3 /*break*/, 4];
-                                case 3:
-                                    err_2 = _a.sent();
-                                    subscription.unsubscribe();
-                                    reject(err_2);
-                                    return [3 /*break*/, 4];
-                                case 4: return [2 /*return*/];
-                            }
-                        });
-                    }); })];
+            var subject, subscription, _d, event_id_1, room_id_1, event_1;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        subject = new rxjs.ReplaySubject();
+                        subscription = this.events$.subscribe(function (e) { return subject.next(e); });
+                        _e.label = 1;
+                    case 1:
+                        _e.trys.push([1, , 4, 5]);
+                        return [4 /*yield*/, this.matrixWidgetApi.sendStateEvent(eventType, stateKey, content, roomId)];
+                    case 2:
+                        _d = _e.sent(), event_id_1 = _d.event_id, room_id_1 = _d.room_id;
+                        return [4 /*yield*/, rxjs.firstValueFrom(subject.pipe(rxjs.filter(function (event) {
+                                var matrixEvent = event.detail.data;
+                                return (matrixEvent.event_id === event_id_1 &&
+                                    matrixEvent.room_id === room_id_1);
+                            }), rxjs.map(function (event) { return event.detail.data; })))];
+                    case 3:
+                        event_1 = _e.sent();
+                        return [2 /*return*/, event_1];
+                    case 4:
+                        subscription.unsubscribe();
+                        return [7 /*endfinally*/];
+                    case 5: return [2 /*return*/];
+                }
             });
         });
     };
@@ -1374,7 +1374,6 @@ var WidgetApiImpl = /** @class */ (function () {
     };
     /** {@inheritDoc WidgetApi.observeRoomEvents} */
     WidgetApiImpl.prototype.observeRoomEvents = function (eventType, _a) {
-        var _this = this;
         var _b = _a === void 0 ? {} : _a, messageType = _b.messageType, roomIds = _b.roomIds;
         var currentRoomId = this.widgetParameters.roomId;
         if (!currentRoomId) {
@@ -1387,7 +1386,6 @@ var WidgetApiImpl = /** @class */ (function () {
                 matrixEvent.state_key === undefined &&
                 (!messageType || matrixEvent.content.msgtype === messageType) &&
                 isInRoom(matrixEvent, currentRoomId, roomIds)) {
-                _this.matrixWidgetApi.transport.reply(event.detail, {});
                 return event.detail.data;
             }
             return undefined;
@@ -1398,45 +1396,31 @@ var WidgetApiImpl = /** @class */ (function () {
     WidgetApiImpl.prototype.sendRoomEvent = function (eventType, content, _a) {
         var _b = _a === void 0 ? {} : _a, roomId = _b.roomId;
         return __awaiter(this, void 0, void 0, function () {
-            var firstEvents$;
-            var _this = this;
-            return __generator(this, function (_c) {
-                firstEvents$ = this.events$.pipe(rxjs.map(function (event) {
-                    var matrixEvent = event.detail.data;
-                    if (matrixEvent.sender === _this.widgetParameters.userId &&
-                        matrixEvent.state_key === undefined &&
-                        matrixEvent.type === eventType &&
-                        (!roomId || matrixEvent.room_id === roomId)) {
-                        _this.matrixWidgetApi.transport.reply(event.detail, {});
-                        return event.detail.data;
-                    }
-                    return undefined;
-                }), rxjs.filter(isDefined), rxjs.first());
-                return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(_this, void 0, void 0, function () {
-                        var subscription, err_3;
-                        return __generator(this, function (_a) {
-                            switch (_a.label) {
-                                case 0:
-                                    subscription = firstEvents$.subscribe({
-                                        next: function (event) { return resolve(event); },
-                                        error: function (err) { return reject(err); },
-                                    });
-                                    _a.label = 1;
-                                case 1:
-                                    _a.trys.push([1, 3, , 4]);
-                                    return [4 /*yield*/, this.matrixWidgetApi.sendRoomEvent(eventType, content, roomId)];
-                                case 2:
-                                    _a.sent();
-                                    return [3 /*break*/, 4];
-                                case 3:
-                                    err_3 = _a.sent();
-                                    subscription.unsubscribe();
-                                    reject(err_3);
-                                    return [3 /*break*/, 4];
-                                case 4: return [2 /*return*/];
-                            }
-                        });
-                    }); })];
+            var subject, subscription, _c, event_id_2, room_id_2, event_2;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        subject = new rxjs.ReplaySubject();
+                        subscription = this.events$.subscribe(function (e) { return subject.next(e); });
+                        _d.label = 1;
+                    case 1:
+                        _d.trys.push([1, , 4, 5]);
+                        return [4 /*yield*/, this.matrixWidgetApi.sendRoomEvent(eventType, content, roomId)];
+                    case 2:
+                        _c = _d.sent(), event_id_2 = _c.event_id, room_id_2 = _c.room_id;
+                        return [4 /*yield*/, rxjs.firstValueFrom(subject.pipe(rxjs.filter(function (event) {
+                                var matrixEvent = event.detail.data;
+                                return (matrixEvent.event_id === event_id_2 &&
+                                    matrixEvent.room_id === room_id_2);
+                            }), rxjs.map(function (event) { return event.detail.data; })))];
+                    case 3:
+                        event_2 = _d.sent();
+                        return [2 /*return*/, event_2];
+                    case 4:
+                        subscription.unsubscribe();
+                        return [7 /*endfinally*/];
+                    case 5: return [2 /*return*/];
+                }
             });
         });
     };
@@ -1457,6 +1441,23 @@ var WidgetApiImpl = /** @class */ (function () {
             });
         });
     };
+    /** {@inheritDoc WidgetApi.sendToDeviceMessage} */
+    WidgetApiImpl.prototype.sendToDeviceMessage = function (eventType, encrypted, content) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.matrixWidgetApi.sendToDevice(eventType, encrypted, content)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /** {@inheritDoc WidgetApi.observeToDeviceMessages} */
+    WidgetApiImpl.prototype.observeToDeviceMessages = function (eventType) {
+        return this.toDeviceMessages$.pipe(rxjs.map(function (e) { return e.detail.data; }), rxjs.filter(function (e) { return e.type === eventType; }));
+    };
     /** {@inheritDoc WidgetApi.openModal} */
     WidgetApiImpl.prototype.openModal = function (pathName, name, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -1588,7 +1589,7 @@ var WidgetApiImpl = /** @class */ (function () {
     WidgetApiImpl.prototype.requestOpenIDConnectTokenInternal = function () {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var leywayMilliseconds, openIdToken, err_4;
+            var leywayMilliseconds, openIdToken, err_2;
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
@@ -1609,14 +1610,28 @@ var WidgetApiImpl = /** @class */ (function () {
                         };
                         return [2 /*return*/, openIdToken];
                     case 3:
-                        err_4 = _b.sent();
+                        err_2 = _b.sent();
                         this.cachedOpenIdToken = undefined;
-                        throw err_4;
+                        throw err_2;
                     case 4: return [2 /*return*/];
                 }
             });
         });
     };
+    /** {@inheritdoc WidgetApi.observeTurnServers} */
+    WidgetApiImpl.prototype.observeTurnServers = function () {
+        return rxjs.from(this.matrixWidgetApi.getTurnServers()).pipe(
+        // For some reason a different naming was chosen for the API, but
+        // we already convert them to the right type for WebRTC consumers.
+        rxjs.map(function (_a) {
+            var uris = _a.uris, username = _a.username, password = _a.password;
+            return ({
+                urls: uris,
+                username: username,
+                credential: password,
+            });
+        }));
+    };
     return WidgetApiImpl;
 }());
 

package/build/esm/index.js

@@ -1,6 +1,6 @@
 import { Symbols, WidgetEventCapability, EventDirection, WidgetApi, WidgetApiToWidgetAction, MatrixCapabilities } from 'matrix-widget-api';
 import { stringify, parse } from 'qs';
-import { filter, fromEvent, firstValueFrom, map, first, throwError, from, mergeAll, concat, share } from 'rxjs';
+import { filter, fromEvent, firstValueFrom, map, first, throwError, from, mergeAll, concat, ReplaySubject, share } from 'rxjs';
 
 /*
  * Copyright 2022 Nordeck IT + Consulting GmbH
@@ -1041,12 +1041,28 @@ var WidgetApiImpl = /** @class */ (function () {
     /** {@inheritDoc WidgetApi.widgetParameters} */
     widgetParameters, _a) {
         var _b = _a === void 0 ? {} : _a, _c = _b.capabilities, capabilities = _c === void 0 ? [] : _c, _d = _b.supportStandalone, supportStandalone = _d === void 0 ? false : _d;
+        var _this = this;
         this.matrixWidgetApi = matrixWidgetApi;
         this.widgetId = widgetId;
         this.widgetParameters = widgetParameters;
-        var eventName = "action:".concat(WidgetApiToWidgetAction.SendEvent);
-        this.events$ = fromEvent(this.matrixWidgetApi, eventName, function (event) {
+        this.events$ = fromEvent(this.matrixWidgetApi, "action:".concat(WidgetApiToWidgetAction.SendEvent), function (event) {
             event.preventDefault();
+            try {
+                _this.matrixWidgetApi.transport.reply(event.detail, {});
+            }
+            catch (_) {
+                // Ignore errors while replying
+            }
+            return event;
+        }).pipe(share());
+        this.toDeviceMessages$ = fromEvent(this.matrixWidgetApi, 'action:send_to_device', function (event) {
+            event.preventDefault();
+            try {
+                matrixWidgetApi.transport.reply(event.detail, {});
+            }
+            catch (_) {
+                // Ignore errors while replying
+            }
             return event;
         }).pipe(share());
         this.initialCapabilities = __spreadArray(__spreadArray([], capabilities, true), (supportStandalone ? [] : [MatrixCapabilities.RequiresClient]), true);
@@ -1292,7 +1308,6 @@ var WidgetApiImpl = /** @class */ (function () {
     };
     /** {@inheritDoc WidgetApi.observeStateEvents} */
     WidgetApiImpl.prototype.observeStateEvents = function (eventType, _a) {
-        var _this = this;
         var _b = _a === void 0 ? {} : _a, stateKey = _b.stateKey, roomIds = _b.roomIds;
         var currentRoomId = this.widgetParameters.roomId;
         if (!currentRoomId) {
@@ -1305,7 +1320,6 @@ var WidgetApiImpl = /** @class */ (function () {
                 matrixEvent.state_key !== undefined &&
                 (stateKey === undefined || matrixEvent.state_key === stateKey) &&
                 isInRoom(matrixEvent, currentRoomId, roomIds)) {
-                _this.matrixWidgetApi.transport.reply(event.detail, {});
                 return event.detail.data;
             }
             return undefined;
@@ -1316,45 +1330,31 @@ var WidgetApiImpl = /** @class */ (function () {
     WidgetApiImpl.prototype.sendStateEvent = function (eventType, content, _a) {
         var _b = _a === void 0 ? {} : _a, roomId = _b.roomId, _c = _b.stateKey, stateKey = _c === void 0 ? '' : _c;
         return __awaiter(this, void 0, void 0, function () {
-            var firstEvent$;
-            var _this = this;
-            return __generator(this, function (_d) {
-                firstEvent$ = this.events$.pipe(map(function (event) {
-                    var matrixEvent = event.detail.data;
-                    if (matrixEvent.sender === _this.widgetParameters.userId &&
-                        matrixEvent.state_key !== undefined &&
-                        matrixEvent.type === eventType &&
-                        (!roomId || matrixEvent.room_id === roomId)) {
-                        _this.matrixWidgetApi.transport.reply(event.detail, {});
-                        return event.detail.data;
-                    }
-                    return undefined;
-                }), filter(isDefined), first());
-                return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(_this, void 0, void 0, function () {
-                        var subscription, err_2;
-                        return __generator(this, function (_a) {
-                            switch (_a.label) {
-                                case 0:
-                                    subscription = firstEvent$.subscribe({
-                                        next: function (event) { return resolve(event); },
-                                        error: function (err) { return reject(err); },
-                                    });
-                                    _a.label = 1;
-                                case 1:
-                                    _a.trys.push([1, 3, , 4]);
-                                    return [4 /*yield*/, this.matrixWidgetApi.sendStateEvent(eventType, stateKey, content, roomId)];
-                                case 2:
-                                    _a.sent();
-                                    return [3 /*break*/, 4];
-                                case 3:
-                                    err_2 = _a.sent();
-                                    subscription.unsubscribe();
-                                    reject(err_2);
-                                    return [3 /*break*/, 4];
-                                case 4: return [2 /*return*/];
-                            }
-                        });
-                    }); })];
+            var subject, subscription, _d, event_id_1, room_id_1, event_1;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        subject = new ReplaySubject();
+                        subscription = this.events$.subscribe(function (e) { return subject.next(e); });
+                        _e.label = 1;
+                    case 1:
+                        _e.trys.push([1, , 4, 5]);
+                        return [4 /*yield*/, this.matrixWidgetApi.sendStateEvent(eventType, stateKey, content, roomId)];
+                    case 2:
+                        _d = _e.sent(), event_id_1 = _d.event_id, room_id_1 = _d.room_id;
+                        return [4 /*yield*/, firstValueFrom(subject.pipe(filter(function (event) {
+                                var matrixEvent = event.detail.data;
+                                return (matrixEvent.event_id === event_id_1 &&
+                                    matrixEvent.room_id === room_id_1);
+                            }), map(function (event) { return event.detail.data; })))];
+                    case 3:
+                        event_1 = _e.sent();
+                        return [2 /*return*/, event_1];
+                    case 4:
+                        subscription.unsubscribe();
+                        return [7 /*endfinally*/];
+                    case 5: return [2 /*return*/];
+                }
             });
         });
     };
@@ -1372,7 +1372,6 @@ var WidgetApiImpl = /** @class */ (function () {
     };
     /** {@inheritDoc WidgetApi.observeRoomEvents} */
     WidgetApiImpl.prototype.observeRoomEvents = function (eventType, _a) {
-        var _this = this;
         var _b = _a === void 0 ? {} : _a, messageType = _b.messageType, roomIds = _b.roomIds;
         var currentRoomId = this.widgetParameters.roomId;
         if (!currentRoomId) {
@@ -1385,7 +1384,6 @@ var WidgetApiImpl = /** @class */ (function () {
                 matrixEvent.state_key === undefined &&
                 (!messageType || matrixEvent.content.msgtype === messageType) &&
                 isInRoom(matrixEvent, currentRoomId, roomIds)) {
-                _this.matrixWidgetApi.transport.reply(event.detail, {});
                 return event.detail.data;
             }
             return undefined;
@@ -1396,45 +1394,31 @@ var WidgetApiImpl = /** @class */ (function () {
     WidgetApiImpl.prototype.sendRoomEvent = function (eventType, content, _a) {
         var _b = _a === void 0 ? {} : _a, roomId = _b.roomId;
         return __awaiter(this, void 0, void 0, function () {
-            var firstEvents$;
-            var _this = this;
-            return __generator(this, function (_c) {
-                firstEvents$ = this.events$.pipe(map(function (event) {
-                    var matrixEvent = event.detail.data;
-                    if (matrixEvent.sender === _this.widgetParameters.userId &&
-                        matrixEvent.state_key === undefined &&
-                        matrixEvent.type === eventType &&
-                        (!roomId || matrixEvent.room_id === roomId)) {
-                        _this.matrixWidgetApi.transport.reply(event.detail, {});
-                        return event.detail.data;
-                    }
-                    return undefined;
-                }), filter(isDefined), first());
-                return [2 /*return*/, new Promise(function (resolve, reject) { return __awaiter(_this, void 0, void 0, function () {
-                        var subscription, err_3;
-                        return __generator(this, function (_a) {
-                            switch (_a.label) {
-                                case 0:
-                                    subscription = firstEvents$.subscribe({
-                                        next: function (event) { return resolve(event); },
-                                        error: function (err) { return reject(err); },
-                                    });
-                                    _a.label = 1;
-                                case 1:
-                                    _a.trys.push([1, 3, , 4]);
-                                    return [4 /*yield*/, this.matrixWidgetApi.sendRoomEvent(eventType, content, roomId)];
-                                case 2:
-                                    _a.sent();
-                                    return [3 /*break*/, 4];
-                                case 3:
-                                    err_3 = _a.sent();
-                                    subscription.unsubscribe();
-                                    reject(err_3);
-                                    return [3 /*break*/, 4];
-                                case 4: return [2 /*return*/];
-                            }
-                        });
-                    }); })];
+            var subject, subscription, _c, event_id_2, room_id_2, event_2;
+            return __generator(this, function (_d) {
+                switch (_d.label) {
+                    case 0:
+                        subject = new ReplaySubject();
+                        subscription = this.events$.subscribe(function (e) { return subject.next(e); });
+                        _d.label = 1;
+                    case 1:
+                        _d.trys.push([1, , 4, 5]);
+                        return [4 /*yield*/, this.matrixWidgetApi.sendRoomEvent(eventType, content, roomId)];
+                    case 2:
+                        _c = _d.sent(), event_id_2 = _c.event_id, room_id_2 = _c.room_id;
+                        return [4 /*yield*/, firstValueFrom(subject.pipe(filter(function (event) {
+                                var matrixEvent = event.detail.data;
+                                return (matrixEvent.event_id === event_id_2 &&
+                                    matrixEvent.room_id === room_id_2);
+                            }), map(function (event) { return event.detail.data; })))];
+                    case 3:
+                        event_2 = _d.sent();
+                        return [2 /*return*/, event_2];
+                    case 4:
+                        subscription.unsubscribe();
+                        return [7 /*endfinally*/];
+                    case 5: return [2 /*return*/];
+                }
             });
         });
     };
@@ -1455,6 +1439,23 @@ var WidgetApiImpl = /** @class */ (function () {
             });
         });
     };
+    /** {@inheritDoc WidgetApi.sendToDeviceMessage} */
+    WidgetApiImpl.prototype.sendToDeviceMessage = function (eventType, encrypted, content) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0: return [4 /*yield*/, this.matrixWidgetApi.sendToDevice(eventType, encrypted, content)];
+                    case 1:
+                        _a.sent();
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    /** {@inheritDoc WidgetApi.observeToDeviceMessages} */
+    WidgetApiImpl.prototype.observeToDeviceMessages = function (eventType) {
+        return this.toDeviceMessages$.pipe(map(function (e) { return e.detail.data; }), filter(function (e) { return e.type === eventType; }));
+    };
     /** {@inheritDoc WidgetApi.openModal} */
     WidgetApiImpl.prototype.openModal = function (pathName, name, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -1586,7 +1587,7 @@ var WidgetApiImpl = /** @class */ (function () {
     WidgetApiImpl.prototype.requestOpenIDConnectTokenInternal = function () {
         var _a;
         return __awaiter(this, void 0, void 0, function () {
-            var leywayMilliseconds, openIdToken, err_4;
+            var leywayMilliseconds, openIdToken, err_2;
             return __generator(this, function (_b) {
                 switch (_b.label) {
                     case 0:
@@ -1607,14 +1608,28 @@ var WidgetApiImpl = /** @class */ (function () {
                         };
                         return [2 /*return*/, openIdToken];
                     case 3:
-                        err_4 = _b.sent();
+                        err_2 = _b.sent();
                         this.cachedOpenIdToken = undefined;
-                        throw err_4;
+                        throw err_2;
                     case 4: return [2 /*return*/];
                 }
             });
         });
     };
+    /** {@inheritdoc WidgetApi.observeTurnServers} */
+    WidgetApiImpl.prototype.observeTurnServers = function () {
+        return from(this.matrixWidgetApi.getTurnServers()).pipe(
+        // For some reason a different naming was chosen for the API, but
+        // we already convert them to the right type for WebRTC consumers.
+        map(function (_a) {
+            var uris = _a.uris, username = _a.username, password = _a.password;
+            return ({
+                urls: uris,
+                username: username,
+                credential: password,
+            });
+        }));
+    };
     return WidgetApiImpl;
 }());
 

package/build/index.d.ts

@@ -395,6 +395,29 @@ export declare type StateEvent<T = unknown> = Omit<IRoomEvent, 'content' | 'unsi
     content: T;
 };
 
+/**
+ * Generic type for to device message events.
+ */
+export declare type ToDeviceMessageEvent<T = unknown> = {
+    type: string;
+    sender: string;
+    encrypted: boolean;
+    content: T;
+};
+
+/**
+ * WebRTC Ice server credentials like turn servers, type is compatible to
+ * `RTCIceServer` from WebRTC.
+ */
+export declare type TurnServer = {
+    /** One or more URLs for this turn server. */
+    urls: string[];
+    /** Username for this turn server. */
+    username: string;
+    /** Credentials for this turn server. */
+    credential: string;
+};
+
 /**
  * The capability that needs to be requested in order to navigate to another room.
  */
@@ -420,13 +443,13 @@ export declare type WidgetApi = {
      */
     getWidgetConfig<T extends IWidgetApiRequestData>(): Readonly<WidgetConfig<T> | undefined>;
     /**
-     * Rerequests the initialy in the constructor passed capabilities.
+     * Rerequests capabilities initially passed in the constructor.
      *
      * This is useful in case the user denied one or all of them.
      */
     rerequestInitialCapabilities(): Promise<void>;
     /**
-     * True, if the initial capabilties passed via the constructor were granted.
+     * True, if the initial capabilities passed via the constructor were granted.
      */
     hasInitialCapabilities(): boolean;
     /**
@@ -526,7 +549,7 @@ export declare type WidgetApi = {
      *
      * @param eventType - The type of the event to receive.
      * @param options - Options for receiving the room event.
-     *                  Use `messageType` to receive events with a specifc
+     *                  Use `messageType` to receive events with a specific
      *                  message type.
      *                  Use `roomIds` to receive the state events from other
      *                  rooms.
@@ -548,7 +571,7 @@ export declare type WidgetApi = {
      *
      * @param eventType - The type of the event to receive.
      * @param options - Options for receiving the room event.
-     *                  Use `messageType` to receive events with a specifc
+     *                  Use `messageType` to receive events with a specific
      *                  message type.
      *                  Use `roomIds` to receive the state events from other
      *                  rooms.
@@ -605,6 +628,27 @@ export declare type WidgetApi = {
         chunk: Array<RoomEvent | StateEvent>;
         nextToken?: string;
     }>;
+    /**
+     * Send a message to a device of a user (or multiple users / devices).
+     *
+     * @param eventType - The type of the event.
+     * @param encrypted - Whether the event should be encrypted.
+     * @param content - The content to send. This is a map of user ids, to device
+     *                  ids, to the content that should be send. It is possible to
+     *                  specify a `'*'` device, to send the content to all devices
+     *                  of a user.
+     */
+    sendToDeviceMessage<T>(eventType: string, encrypted: boolean, content: {
+        [userId: string]: {
+            [deviceId: string | '*']: T;
+        };
+    }): Promise<void>;
+    /**
+     * Observes all to device messages send to the current device.
+     *
+     * @param eventType - The type of the event.
+     */
+    observeToDeviceMessages<T>(eventType: string): Observable<ToDeviceMessageEvent<T>>;
     /**
      * Open a new modal, wait until the modal closes, and return the result.
      *
@@ -678,6 +722,11 @@ export declare type WidgetApi = {
      *          old one expired.
      */
     requestOpenIDConnectToken(): Promise<IOpenIDCredentials>;
+    /**
+     * Returns an observable containing WebRTC Ice server credentials, like turn
+     * servers, if available.
+     */
+    observeTurnServers(): Observable<TurnServer>;
 };
 
 /**
@@ -717,6 +766,7 @@ export declare class WidgetApiImpl implements WidgetApi {
     private outstandingOpenIDConnectTokenRequest;
     private cachedOpenIdToken;
     private readonly events$;
+    private readonly toDeviceMessages$;
     private readonly initialCapabilities;
     constructor(
     /**
@@ -797,6 +847,14 @@ export declare class WidgetApiImpl implements WidgetApi {
         chunk: Array<RoomEvent | StateEvent>;
         nextToken?: string;
     }>;
+    /** {@inheritDoc WidgetApi.sendToDeviceMessage} */
+    sendToDeviceMessage<T>(eventType: string, encrypted: boolean, content: {
+        [userId: string]: {
+            [deviceId: string | '*']: T;
+        };
+    }): Promise<void>;
+    /** {@inheritDoc WidgetApi.observeToDeviceMessages} */
+    observeToDeviceMessages<T>(eventType: string): Observable<ToDeviceMessageEvent<T>>;
     /** {@inheritDoc WidgetApi.openModal} */
     openModal<T extends Record<string, unknown> = Record<string, unknown>, U extends IModalWidgetCreateData = IModalWidgetCreateData>(pathName: string, name: string, options?: {
         buttons?: IModalWidgetOpenRequestDataButton[];
@@ -813,6 +871,8 @@ export declare class WidgetApiImpl implements WidgetApi {
     /** {@inheritdoc WidgetApi.requestOpenIDConnectToken} */
     requestOpenIDConnectToken(): Promise<IOpenIDCredentials>;
     private requestOpenIDConnectTokenInternal;
+    /** {@inheritdoc WidgetApi.observeTurnServers} */
+    observeTurnServers(): Observable<TurnServer>;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matrix-widget-toolkit/api",
-  "version": "3.0.0",
+  "version": "3.1.0",
   "description": "A simplified layer on top of matrix-widget-api to use build widgets.",
   "author": "Nordeck IT + Consulting GmbH",
   "license": "Apache-2.0",