Absorb remainder of element-modules into monorepo

2026-06-08 10:32:12 +01:00
parent cd8a1012c8 cb8c90c295
commit 799d33278f
112 changed files with 4569 additions and 8 deletions
@@ -0,0 +1,140 @@
+/*
+Copyright 2026 Element Creations Ltd.
+
+SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial
+Please see LICENSE files in the repository root for full details.
+*/
+
+import { describe, expect, it } from "vitest";
+
+import WidgetLifecycleModule, { type WidgetLifecycleApiAdapter } from "../src/WidgetLifecycleModule";
+import type {
+    CapabilitiesApprover,
+    IdentityApprover,
+    PreloadApprover,
+    WidgetDescriptor,
+} from "@element-hq/element-web-module-api";
+
+const createApi = (config: unknown = {}) => {
+    const handlers: {
+        preload?: PreloadApprover;
+        identity?: IdentityApprover;
+        capabilities?: CapabilitiesApprover;
+    } = {};
+
+    const widgetLifecycle: WidgetLifecycleApiAdapter = {
+        registerPreloadApprover: (approver) => {
+            handlers.preload = approver;
+        },
+        registerIdentityApprover: (approver) => {
+            handlers.identity = approver;
+        },
+        registerCapabilitiesApprover: (approver) => {
+            handlers.capabilities = approver;
+        },
+    };
+
+    return {
+        api: {
+            config: {
+                get: () => config,
+            },
+            widgetLifecycle,
+        },
+        handlers,
+    };
+};
+
+const widget: WidgetDescriptor = {
+    id: "widget-id",
+    templateUrl: "https://example.com/",
+    creatorUserId: "@user-id",
+    kind: "room",
+};
+
+describe("WidgetLifecycleModule", () => {
+    it("approves preload when configured", async () => {
+        const { api, handlers } = createApi({
+            widget_permissions: {
+                "https://example.com/": { preload_approved: true },
+            },
+        });
+
+        const module = new WidgetLifecycleModule(api);
+        await module.load();
+
+        expect(await handlers.preload?.(widget)).toBe(true);
+    });
+
+    it("approves identity when configured", async () => {
+        const { api, handlers } = createApi({
+            widget_permissions: {
+                "https://example.com/": { identity_approved: true },
+            },
+        });
+
+        const module = new WidgetLifecycleModule(api);
+        await module.load();
+
+        expect(await handlers.identity?.(widget)).toBe(true);
+    });
+
+    it("approves configured capabilities", async () => {
+        const { api, handlers } = createApi({
+            widget_permissions: {
+                "https://example.com/": {
+                    capabilities_approved: ["org.matrix.msc2931.navigate"],
+                },
+            },
+        });
+
+        const module = new WidgetLifecycleModule(api);
+        await module.load();
+
+        const approved = await handlers.capabilities?.(
+            widget,
+            new Set(["org.matrix.msc2931.navigate", "org.matrix.msc2762.timeline:*"]),
+        );
+
+        expect(approved).toEqual(new Set(["org.matrix.msc2931.navigate"]));
+    });
+
+    it("returns no approvals when not configured", async () => {
+        const { api, handlers } = createApi({});
+
+        const module = new WidgetLifecycleModule(api);
+        await module.load();
+
+        expect(await handlers.preload?.(widget)).toBe(false);
+        expect(await handlers.identity?.(widget)).toBe(false);
+        expect(await handlers.capabilities?.(widget, new Set(["org.matrix.msc2931.navigate"]))).toBeUndefined();
+    });
+
+    it("returns no approvals when config is missing", async () => {
+        const { api, handlers } = createApi(undefined);
+
+        const module = new WidgetLifecycleModule(api);
+        await module.load();
+
+        expect(await handlers.preload?.(widget)).toBe(false);
+        expect(await handlers.identity?.(widget)).toBe(false);
+        expect(await handlers.capabilities?.(widget, new Set(["org.matrix.msc2931.navigate"]))).toBeUndefined();
+    });
+
+    it("fails closed on invalid config", async () => {
+        const { api, handlers } = createApi({
+            widget_permissions: {
+                "https://example.com/": {
+                    preload_approved: null,
+                },
+            },
+        });
+
+        const module = new WidgetLifecycleModule(api);
+        await module.load();
+
+        expect(await handlers.preload?.(widget)).toBe(false);
+        expect(await handlers.identity?.(widget)).toBe(false);
+        expect(await handlers.capabilities?.(widget, new Set(["org.matrix.msc2931.navigate"]))).toBeUndefined();
+    });
+});