Let widget driver send error details

Author: AndrewFerr

src/stores/widgets/StopGapWidgetDriver.ts

@@ -9,6 +9,7 @@
 import {
     Capability,
     EventDirection,
+    IMatrixApiError as IWidgetMatrixError,
     IOpenIDCredentials,
     IOpenIDUpdate,
     ISendDelayedEventDetails,
@@ -33,6 +34,7 @@ import {
     ITurnServer as IClientTurnServer,
     EventType,
     IContent,
+    MatrixError,
     MatrixEvent,
     Room,
     Direction,
@@ -689,4 +691,15 @@ export class StopGapWidgetDriver extends WidgetDriver {
         const blob = await response.blob();
         return { file: blob };
     }
+
+    /**
+     * Expresses a {@link MatrixError} as a {@link IWidgetMatrixError}
+     * for use by Widget API error responses.
+     * @param error The error to handle.
+     * @returns The error expressed as a {@link IWidgetMatrixError},
+     * or undefined if it is not a {@link MatrixError}.
+     */
+    public processError(error: unknown): IWidgetMatrixError | undefined {
+        return error instanceof MatrixError ? error.asWidgetApiErrorData() : undefined;
+    }
 }