@matrix-widget-toolkit/api 3.4.2 → 4.1.0

package/build/cjs/{index.js → index.cjs}

@@ -1,9 +1,14 @@
 'use strict';
 
 var matrixWidgetApi = require('matrix-widget-api');
+var Joi = require('joi');
 var qs = require('qs');
 var rxjs = require('rxjs');
 
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var Joi__default = /*#__PURE__*/_interopDefault(Joi);
+
 /*
  * Copyright 2022 Nordeck IT + Consulting GmbH
  *
@@ -108,6 +113,17 @@ function getRoomMemberDisplayName(member, allRoomMembers) {
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+var __assign$2 = (undefined && undefined.__assign) || function () {
+    __assign$2 = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign$2.apply(this, arguments);
+};
 /**
  * Check if the given event is a {@link StateEvent}.
  *
@@ -126,6 +142,58 @@ function isStateEvent(event) {
 function isRoomEvent(event) {
     return !('state_key' in event);
 }
+/**
+ * Check if the given value is a valid {@link RoomEvent}.
+ *
+ * @param event - The value to check
+ * @returns true if value is a valid room event, else false.
+ */
+// Allow any here, so that the validation works for every event
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function isValidRoomEvent(event) {
+    return roomEventSchema.validate(event).error === undefined;
+}
+/**
+ * Check if the given value is a valid {@link StateEvent}.
+ *
+ * @param event - The value to check
+ * @returns true if value is a valid state event, else false.
+ */
+// Allow any here, so that the validation works for every event
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function isValidStateEvent(event) {
+    return stateEventSchema.validate(event).error === undefined;
+}
+/**
+ * Check if the given value is a valid {@link ToDeviceMessageEvent}.
+ *
+ * @param event - The value to check
+ * @returns true if value is a valid to device message, else false.
+ */
+function isValidToDeviceMessageEvent(event) {
+    return toDeviceMessageSchema.validate(event).error === undefined;
+}
+/**
+ * Base properties to validate for all events.
+ */
+var eventSchemaProps = {
+    type: Joi__default.default.string().required(),
+    // Do roughly check against the format
+    // https://spec.matrix.org/v1.13/appendices/#common-identifier-format
+    sender: Joi__default.default.string().pattern(new RegExp('^@[^\\s:]*:\\S*$')).required(),
+    event_id: Joi__default.default.string().pattern(new RegExp('^\\$.*')).required(),
+    room_id: Joi__default.default.string().pattern(new RegExp('^![^:]*:\\S*')).required(),
+    origin_server_ts: Joi__default.default.date().timestamp('javascript').required(),
+    content: Joi__default.default.object().required(),
+};
+var roomEventSchema = Joi__default.default.object(__assign$2({}, eventSchemaProps)).unknown();
+var stateEventSchema = Joi__default.default.object(__assign$2(__assign$2({}, eventSchemaProps), { state_key: Joi__default.default.string().allow('').required() })).unknown();
+var toDeviceMessageSchema = Joi__default.default.object({
+    type: Joi__default.default.string().required(),
+    sender: Joi__default.default.string().required(),
+    encrypted: Joi__default.default.boolean().required(),
+    content: Joi__default.default.object().required(),
+}).unknown();
 
 /*
  * Copyright 2022 Nordeck IT + Consulting GmbH
@@ -142,7 +210,7 @@ function isRoomEvent(event) {
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-var __awaiter$3 = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+var __awaiter$4 = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
         function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
@@ -151,7 +219,7 @@ var __awaiter$3 = (undefined && undefined.__awaiter) || function (thisArg, _argu
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __generator$3 = (undefined && undefined.__generator) || function (thisArg, body) {
+var __generator$4 = (undefined && undefined.__generator) || function (thisArg, body) {
     var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
     return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
     function verb(n) { return function (v) { return step([n, v]); }; }
@@ -192,10 +260,10 @@ var WIDGET_CAPABILITY_NAVIGATE = 'org.matrix.msc2931.navigate';
  * @param opts - {@link NavigateToRoomOptions}
  */
 function navigateToRoom(widgetApi_1, roomId_1) {
-    return __awaiter$3(this, arguments, void 0, function (widgetApi, roomId, opts) {
+    return __awaiter$4(this, arguments, void 0, function (widgetApi, roomId, opts) {
         var _a, via, params, url;
         if (opts === void 0) { opts = {}; }
-        return __generator$3(this, function (_b) {
+        return __generator$4(this, function (_b) {
             switch (_b.label) {
                 case 0:
                     _a = opts.via, via = _a === void 0 ? [] : _a;
@@ -439,7 +507,7 @@ function calculateActionPowerLevel(powerLevelStateEvent, action) {
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-var __awaiter$2 = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+var __awaiter$3 = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
         function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
@@ -448,7 +516,7 @@ var __awaiter$2 = (undefined && undefined.__awaiter) || function (thisArg, _argu
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __generator$2 = (undefined && undefined.__generator) || function (thisArg, body) {
+var __generator$3 = (undefined && undefined.__generator) || function (thisArg, body) {
     var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
     return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
     function verb(n) { return function (v) { return step([n, v]); }; }
@@ -498,9 +566,9 @@ function isValidRedactionEvent(event) {
  * @returns The redaction event that was send to the room.
  */
 function redactEvent(widgetApi, eventId) {
-    return __awaiter$2(this, void 0, void 0, function () {
+    return __awaiter$3(this, void 0, void 0, function () {
         var result;
-        return __generator$2(this, function (_a) {
+        return __generator$3(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, widgetApi.sendRoomEvent(ROOM_EVENT_REDACTION, { redacts: eventId })];
                 case 1:
@@ -713,6 +781,7 @@ function extractWidgetParameters() {
         clientId: params['matrix_client_id'],
         clientLanguage: params['matrix_client_language'],
         baseUrl: params['matrix_base_url'],
+        deviceId: params['matrix_device_id'],
         isOpenedByClient: isOpenedByClient,
     };
 }
@@ -765,7 +834,7 @@ var __assign = (undefined && undefined.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
-var __awaiter$1 = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+var __awaiter$2 = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
     return new (P || (P = Promise))(function (resolve, reject) {
         function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
@@ -774,7 +843,7 @@ var __awaiter$1 = (undefined && undefined.__awaiter) || function (thisArg, _argu
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-var __generator$1 = (undefined && undefined.__generator) || function (thisArg, body) {
+var __generator$2 = (undefined && undefined.__generator) || function (thisArg, body) {
     var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
     return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
     function verb(n) { return function (v) { return step([n, v]); }; }
@@ -813,12 +882,12 @@ var __rest = (undefined && undefined.__rest) || function (s, e) {
     return t;
 };
 /**
- * Checks whether all widget parameters were provided to the widget.
+ * Checks whether the necessary widget parameters were provided to the widget.
  *
  * @param widgetApi - The widget api to read the parameters from
  * @returns True, if all parameters were provided.
  */
-function hasRequiredWidgetParameters(widgetApi) {
+function hasWidgetParameters(widgetApi) {
     return (typeof widgetApi.widgetParameters.userId === 'string' &&
         typeof widgetApi.widgetParameters.displayName === 'string' &&
         typeof widgetApi.widgetParameters.avatarUrl === 'string' &&
@@ -838,13 +907,13 @@ function hasRequiredWidgetParameters(widgetApi) {
  * @returns The generated URL.
  */
 function generateWidgetRegistrationUrl(options) {
-    var _a, _b, _c, _d, _e, _f, _g, _h;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j;
     if (options === void 0) { options = {}; }
-    var pathName = options.pathName, _j = options.includeParameters, includeParameters = _j === void 0 ? true : _j, widgetParameters = options.widgetParameters;
+    var pathName = options.pathName, _k = options.includeParameters, includeParameters = _k === void 0 ? true : _k, widgetParameters = options.widgetParameters;
     // don't forward widgetId and parentUrl as they will be generated by the client
     // eslint-disable-next-line
-    var _k = extractRawWidgetParameters(); _k.widgetId; _k.parentUrl; var rawWidgetParameters = __rest(_k, ["widgetId", "parentUrl"]);
-    var parameters = Object.entries(__assign(__assign({}, rawWidgetParameters), { theme: (_a = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.theme) !== null && _a !== void 0 ? _a : '$org.matrix.msc2873.client_theme', matrix_user_id: (_b = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.userId) !== null && _b !== void 0 ? _b : '$matrix_user_id', matrix_display_name: (_c = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.displayName) !== null && _c !== void 0 ? _c : '$matrix_display_name', matrix_avatar_url: (_d = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.avatarUrl) !== null && _d !== void 0 ? _d : '$matrix_avatar_url', matrix_room_id: (_e = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.roomId) !== null && _e !== void 0 ? _e : '$matrix_room_id', matrix_client_id: (_f = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.clientId) !== null && _f !== void 0 ? _f : '$org.matrix.msc2873.client_id', matrix_client_language: (_g = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.clientLanguage) !== null && _g !== void 0 ? _g : '$org.matrix.msc2873.client_language', matrix_base_url: (_h = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.baseUrl) !== null && _h !== void 0 ? _h : '$org.matrix.msc4039.matrix_base_url' }))
+    var _l = extractRawWidgetParameters(); _l.widgetId; _l.parentUrl; var rawWidgetParameters = __rest(_l, ["widgetId", "parentUrl"]);
+    var parameters = Object.entries(__assign(__assign({}, rawWidgetParameters), { theme: (_a = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.theme) !== null && _a !== void 0 ? _a : '$org.matrix.msc2873.client_theme', matrix_user_id: (_b = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.userId) !== null && _b !== void 0 ? _b : '$matrix_user_id', matrix_display_name: (_c = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.displayName) !== null && _c !== void 0 ? _c : '$matrix_display_name', matrix_avatar_url: (_d = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.avatarUrl) !== null && _d !== void 0 ? _d : '$matrix_avatar_url', matrix_room_id: (_e = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.roomId) !== null && _e !== void 0 ? _e : '$matrix_room_id', matrix_client_id: (_f = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.clientId) !== null && _f !== void 0 ? _f : '$org.matrix.msc2873.client_id', matrix_client_language: (_g = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.clientLanguage) !== null && _g !== void 0 ? _g : '$org.matrix.msc2873.client_language', matrix_device_id: (_h = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.deviceId) !== null && _h !== void 0 ? _h : '$org.matrix.msc3819.matrix_device_id', matrix_base_url: (_j = widgetParameters === null || widgetParameters === void 0 ? void 0 : widgetParameters.baseUrl) !== null && _j !== void 0 ? _j : '$org.matrix.msc4039.matrix_base_url' }))
         .map(function (_a) {
         var k = _a[0], v = _a[1];
         return "".concat(k, "=").concat(v);
@@ -873,10 +942,10 @@ var STATE_EVENT_WIDGETS = 'im.vector.modular.widgets';
  *                       registration, like the display name of the widget.
  */
 function repairWidgetRegistration(widgetApi_1) {
-    return __awaiter$1(this, arguments, void 0, function (widgetApi, registration) {
+    return __awaiter$2(this, arguments, void 0, function (widgetApi, registration) {
         var readResult, url, name, type, data;
         if (registration === void 0) { registration = {}; }
-        return __generator$1(this, function (_a) {
+        return __generator$2(this, function (_a) {
             switch (_a.label) {
                 case 0: return [4 /*yield*/, widgetApi.requestCapabilities([
                         matrixWidgetApi.WidgetEventCapability.forStateEvent(matrixWidgetApi.EventDirection.Send, STATE_EVENT_WIDGETS, widgetApi.widgetId),
@@ -938,6 +1007,73 @@ function repairWidgetRegistration(widgetApi_1) {
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
+/**
+ * Enumeration of widget parameters that can be checked if they are available upon registration.
+ */
+exports.WidgetParameter = void 0;
+(function (WidgetParameter) {
+    WidgetParameter["UserId"] = "userId";
+    WidgetParameter["DisplayName"] = "displayName";
+    WidgetParameter["AvatarUrl"] = "avatarUrl";
+    WidgetParameter["RoomId"] = "roomId";
+    WidgetParameter["Theme"] = "theme";
+    WidgetParameter["ClientId"] = "clientId";
+    WidgetParameter["ClientLanguage"] = "clientLanguage";
+    WidgetParameter["DeviceId"] = "deviceId";
+    WidgetParameter["BaseUrl"] = "baseUrl";
+})(exports.WidgetParameter || (exports.WidgetParameter = {}));
+
+/*
+ * Copyright 2022 Nordeck IT + Consulting GmbH
+ *
+ * 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.
+ */
+var __awaiter$1 = (undefined && undefined.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator$1 = (undefined && undefined.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 function convertToRawCapabilities(rawCapabilities) {
     return rawCapabilities.map(function (c) { return (typeof c === 'string' ? c : c.raw); });
 }
@@ -964,6 +1100,47 @@ function isInRoom(matrixEvent, currentRoomId, roomIds) {
     }
     return roomIds.includes(matrixEvent.room_id);
 }
+/**
+ * Create a state event from the arguments.
+ *
+ * @returns A state event with current timestamp origin_server_ts.
+ */
+function makeEventFromSendStateEventResult(type, stateKey, content, sender, sendResult) {
+    if (sendResult.event_id === undefined) {
+        throw new Error('Send state event did not return an event ID');
+    }
+    return {
+        content: content,
+        event_id: sendResult.event_id,
+        origin_server_ts: Date.now(),
+        room_id: sendResult.room_id,
+        sender: sender,
+        state_key: stateKey,
+        type: type,
+    };
+}
+/**
+ * Send a state event and resolve to a "virtual" state event.
+ *
+ * @returns Promise, that resolves to a state event with current timestamp origin_server_ts.
+ */
+function sendStateEventWithEventResult(widgetApi, type, stateKey, content) {
+    return __awaiter$1(this, void 0, void 0, function () {
+        var response;
+        return __generator$1(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    if (widgetApi.widgetParameters.userId === undefined) {
+                        throw new Error('Own user ID is undefined');
+                    }
+                    return [4 /*yield*/, widgetApi.sendStateEvent(type, content, { stateKey: stateKey })];
+                case 1:
+                    response = _a.sent();
+                    return [2 /*return*/, makeEventFromSendStateEventResult(type, stateKey, content, widgetApi.widgetParameters.userId, response)];
+            }
+        });
+    });
+}
 
 /*
  * Copyright 2022 Nordeck IT + Consulting GmbH
@@ -1069,7 +1246,9 @@ var WidgetApiImpl = /** @class */ (function () {
                 // Ignore errors while replying
             }
             return event;
-        }).pipe(rxjs.share());
+        })
+            .pipe(rxjs.filter(function (event) { return isValidToDeviceMessageEvent(event.detail.data); }))
+            .pipe(rxjs.share());
         this.initialCapabilities = __spreadArray(__spreadArray([], capabilities, true), (supportStandalone ? [] : [matrixWidgetApi.MatrixCapabilities.RequiresClient]), true);
     }
     /**
@@ -1304,11 +1483,15 @@ var WidgetApiImpl = /** @class */ (function () {
     /** {@inheritDoc WidgetApi.receiveStateEvents} */
     WidgetApiImpl.prototype.receiveStateEvents = function (eventType_1) {
         return __awaiter(this, arguments, void 0, function (eventType, _a) {
+            var unvalidatedEvents, validatedEvents;
             var _b = _a === void 0 ? {} : _a, stateKey = _b.stateKey, roomIds = _b.roomIds;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0: return [4 /*yield*/, this.matrixWidgetApi.readStateEvents(eventType, Number.MAX_SAFE_INTEGER, stateKey, typeof roomIds === 'string' ? [matrixWidgetApi.Symbols.AnyRoom] : roomIds)];
-                    case 1: return [2 /*return*/, (_c.sent())];
+                    case 1:
+                        unvalidatedEvents = (_c.sent());
+                        validatedEvents = unvalidatedEvents.filter(isValidStateEvent);
+                        return [2 /*return*/, validatedEvents];
                 }
             });
         });
@@ -1331,48 +1514,25 @@ var WidgetApiImpl = /** @class */ (function () {
             }
             return undefined;
         }), rxjs.filter(isDefined));
-        return rxjs.concat(historyEvent$, futureEvent$);
+        return rxjs.concat(historyEvent$, futureEvent$).pipe(rxjs.filter(isValidStateEvent));
     };
     /** {@inheritDoc WidgetApi.sendStateEvent} */
-    WidgetApiImpl.prototype.sendStateEvent = function (eventType_1, content_1) {
-        return __awaiter(this, arguments, void 0, function (eventType, content, _a) {
-            var subject, subscription, _b, event_id_1, room_id_1, event_1;
-            var _c = _a === void 0 ? {} : _a, roomId = _c.roomId, _d = _c.stateKey, stateKey = _d === void 0 ? '' : _d;
-            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:
-                        _b = _e.sent(), event_id_1 = _b.event_id, room_id_1 = _b.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*/];
-                }
-            });
-        });
+    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 this.matrixWidgetApi.sendStateEvent(eventType, stateKey, content, roomId);
     };
     /** {@inheritDoc WidgetApi.receiveRoomEvents} */
     WidgetApiImpl.prototype.receiveRoomEvents = function (eventType_1) {
         return __awaiter(this, arguments, void 0, function (eventType, _a) {
+            var unvalidatedEvents, validatedEvents;
             var _b = _a === void 0 ? {} : _a, messageType = _b.messageType, roomIds = _b.roomIds;
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0: return [4 /*yield*/, this.matrixWidgetApi.readRoomEvents(eventType, Number.MAX_SAFE_INTEGER, messageType, typeof roomIds === 'string' ? [matrixWidgetApi.Symbols.AnyRoom] : roomIds)];
-                    case 1: return [2 /*return*/, (_c.sent())];
+                    case 1:
+                        unvalidatedEvents = (_c.sent());
+                        validatedEvents = unvalidatedEvents.filter(isValidRoomEvent);
+                        return [2 /*return*/, validatedEvents];
                 }
             });
         });
@@ -1395,12 +1555,12 @@ var WidgetApiImpl = /** @class */ (function () {
             }
             return undefined;
         }), rxjs.filter(isDefined));
-        return rxjs.concat(historyEvent$, futureEvent$);
+        return rxjs.concat(historyEvent$, futureEvent$).pipe(rxjs.filter(isValidRoomEvent));
     };
     /** {@inheritDoc WidgetApi.sendRoomEvent} */
     WidgetApiImpl.prototype.sendRoomEvent = function (eventType_1, content_1) {
         return __awaiter(this, arguments, void 0, function (eventType, content, _a) {
-            var subject, subscription, _b, event_id_2, room_id_2, event_2;
+            var subject, subscription, _b, event_id_1, room_id_1, event_1;
             var _c = _a === void 0 ? {} : _a, roomId = _c.roomId;
             return __generator(this, function (_d) {
                 switch (_d.label) {
@@ -1412,15 +1572,15 @@ var WidgetApiImpl = /** @class */ (function () {
                         _d.trys.push([1, , 4, 5]);
                         return [4 /*yield*/, this.matrixWidgetApi.sendRoomEvent(eventType, content, roomId)];
                     case 2:
-                        _b = _d.sent(), event_id_2 = _b.event_id, room_id_2 = _b.room_id;
+                        _b = _d.sent(), event_id_1 = _b.event_id, room_id_1 = _b.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);
+                                return (matrixEvent.event_id === event_id_1 &&
+                                    matrixEvent.room_id === room_id_1);
                             }), rxjs.map(function (event) { return event.detail.data; })))];
                     case 3:
-                        event_2 = _d.sent();
-                        return [2 /*return*/, event_2];
+                        event_1 = _d.sent();
+                        return [2 /*return*/, event_1];
                     case 4:
                         subscription.unsubscribe();
                         return [7 /*endfinally*/];
@@ -1461,7 +1621,7 @@ var WidgetApiImpl = /** @class */ (function () {
     };
     /** {@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; }));
+        return this.toDeviceMessages$.pipe(rxjs.map(function (e) { return e.detail.data; }), rxjs.filter(isValidToDeviceMessageEvent), rxjs.filter(function (e) { return e.type === eventType; }));
     };
     /** {@inheritDoc WidgetApi.openModal} */
     WidgetApiImpl.prototype.openModal = function (pathName, name, options) {
@@ -1712,17 +1872,22 @@ exports.getContent = getContent;
 exports.getOriginalEventId = getOriginalEventId;
 exports.getRoomMemberDisplayName = getRoomMemberDisplayName;
 exports.hasActionPower = hasActionPower;
-exports.hasRequiredWidgetParameters = hasRequiredWidgetParameters;
 exports.hasRoomEventPower = hasRoomEventPower;
 exports.hasStateEventPower = hasStateEventPower;
+exports.hasWidgetParameters = hasWidgetParameters;
 exports.isRoomEvent = isRoomEvent;
 exports.isStateEvent = isStateEvent;
 exports.isValidEventWithRelatesTo = isValidEventWithRelatesTo;
 exports.isValidPowerLevelStateEvent = isValidPowerLevelStateEvent;
 exports.isValidRedactionEvent = isValidRedactionEvent;
+exports.isValidRoomEvent = isValidRoomEvent;
 exports.isValidRoomMemberStateEvent = isValidRoomMemberStateEvent;
+exports.isValidStateEVent = isValidStateEvent;
+exports.isValidToDeviceMessageEvent = isValidToDeviceMessageEvent;
+exports.makeEventFromSendStateEventResult = makeEventFromSendStateEventResult;
 exports.navigateToRoom = navigateToRoom;
 exports.observeRedactionEvents = observeRedactionEvents;
 exports.parseWidgetId = parseWidgetId;
 exports.redactEvent = redactEvent;
 exports.repairWidgetRegistration = repairWidgetRegistration;
+exports.sendStateEventWithEventResult = sendStateEventWithEventResult;

package/build/cjs/index.d.cts

@@ -0,0 +1,5 @@
+/**
+ * @packageDocumentation This is package that wraps `matrix-widget-api` to
+ *                       provide a more convenient API.
+ */
+export * from './api';