Add widget lifecycle module

This commit is contained in:
David Langley
2026-03-13 15:43:25 +00:00
parent fee5f0633c
commit 6aa454c646
16 changed files with 932 additions and 0 deletions
@@ -0,0 +1,61 @@
<!-- Based on element-modules/modules/opendesk/element-web/tests/fixture/widget.html -->
<html lang="en">
<head>
<title>Demo Widget</title>
<script>
const getCapabilities = () => {
const caps = new URLSearchParams(window.location.search).get("caps");
if (!caps) {
return ["org.matrix.msc2762.receive.state_event:m.room.topic"];
}
if (caps === "none") return [];
return caps
.split(",")
.map((cap) => cap.trim())
.filter(Boolean);
};
let sendEventCount = 0;
window.onmessage = async (ev) => {
if (ev.data.action === "capabilities") {
window.parent.postMessage(
Object.assign(
{
response: {
capabilities: getCapabilities(),
},
},
ev.data,
),
"*",
);
} else if (ev.data.action === "notify_capabilities") {
window.parent.postMessage(
{
api: "fromWidget",
widgetId: ev.data.widgetId,
requestId: "widget-" + sendEventCount,
action: "get_openid",
data: {},
},
"*",
);
} else if (ev.data.action === "get_openid" && ev.data.response?.state === "allowed") {
const { access_token } = ev.data.response;
const hsUrl = new URLSearchParams(window.location.search).get("hsUrl");
const response = await fetch(
`${hsUrl}/_matrix/federation/v1/openid/userinfo?access_token=${access_token}`,
);
const { sub } = await response.json();
const titleElement = document.getElementById("title");
titleElement.innerText = `Hello ${sub}!`;
}
};
</script>
</head>
<body>
<h1 id="title">Hello unknown!</h1>
</body>
</html>
@@ -0,0 +1,210 @@
/*
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 { type SynapseContainer } from "@element-hq/element-web-playwright-common/lib/testcontainers/index.js";
import { test, expect } from "../../../../playwright/element-web-test.ts";
declare module "@element-hq/element-web-module-api" {
interface Config {
"io.element.element-web-modules.widget-lifecycle": {
widget_permissions: {
[url: string]: {
preload_approved?: boolean;
identity_approved?: boolean;
capabilities_approved?: string[];
};
};
};
}
}
const WIDGET_URL = "http://localhost:8080/widget.html";
test.use({
displayName: "Timmy",
synapseConfig: async ({ synapseConfig, _homeserver: homeserver }, use) => {
(homeserver as SynapseContainer).withConfigField("listeners[0].resources[0].names", ["client", "openid"]);
await use(synapseConfig);
},
page: async ({ context, page, moduleDir }, use) => {
await context.route(`${WIDGET_URL}*`, async (route) => {
await route.fulfill({ path: `${moduleDir}/e2e/fixture/widget.html`, contentType: "text/html" });
});
await page.goto("/");
await use(page);
},
bypassCSP: true,
launchOptions: {
args: ["--disable-web-security"],
},
});
test.describe("Widget Lifecycle", () => {
test.describe("trusted widgets", () => {
test.use({
config: {
"io.element.element-web-modules.widget-lifecycle": {
widget_permissions: {
[WIDGET_URL]: {
preload_approved: true,
identity_approved: true,
capabilities_approved: ["org.matrix.msc2762.receive.state_event:m.room.topic"],
},
},
},
},
});
test("auto-approves preload and identity", async ({ page, user, homeserver }, testInfo) => {
const bot = await homeserver.registerUser(`bot_${testInfo.testId}`, "password", "Bot");
const { room_id: roomId } = await homeserver.csApi.request<{ room_id: string }>(
"POST",
"/v3/createRoom",
bot.accessToken,
{
name: "Trusted Widget",
},
);
await homeserver.csApi.request<{ event_id: string }>(
"PUT",
`/v3/rooms/${encodeURIComponent(roomId)}/state/im.vector.modular.widgets/1`,
bot.accessToken,
{
id: "1",
creatorUserId: bot.userId,
type: "custom",
name: "Trusted Widget",
url: `${WIDGET_URL}?hsUrl=${encodeURIComponent(homeserver.baseUrl)}&caps=org.matrix.msc2762.receive.state_event:m.room.topic`,
},
);
await homeserver.csApi.request(
"PUT",
`/v3/rooms/${encodeURIComponent(roomId)}/state/io.element.widgets.layout/`,
bot.accessToken,
{
widgets: {
"1": {
container: "top",
},
},
},
);
await homeserver.csApi.request("POST", `/v3/rooms/${encodeURIComponent(roomId)}/invite`, bot.accessToken, {
user_id: user.userId,
});
await page.getByText("Trusted Widget").click();
await page.getByRole("button", { name: "Accept" }).click();
await expect(
page
.frameLocator('iframe[title="Trusted Widget"]')
.getByRole("heading", { name: `Hello ${user.userId}!` }),
).toBeVisible();
});
test("prompts for capabilities not in the allowlist", async ({ page, user, homeserver }, testInfo) => {
const bot = await homeserver.registerUser(`bot_${testInfo.testId}`, "password", "Bot");
const { room_id: roomId } = await homeserver.csApi.request<{ room_id: string }>(
"POST",
"/v3/createRoom",
bot.accessToken,
{
name: "Capabilities Widget",
},
);
await homeserver.csApi.request<{ event_id: string }>(
"PUT",
`/v3/rooms/${encodeURIComponent(roomId)}/state/im.vector.modular.widgets/1`,
bot.accessToken,
{
id: "1",
creatorUserId: bot.userId,
type: "custom",
name: "Capabilities Widget",
url: `${WIDGET_URL}?hsUrl=${encodeURIComponent(homeserver.baseUrl)}&caps=org.matrix.msc2762.receive.state_event:m.room.topic,org.matrix.msc2762.receive.state_event:m.room.name`,
},
);
await homeserver.csApi.request(
"PUT",
`/v3/rooms/${encodeURIComponent(roomId)}/state/io.element.widgets.layout/`,
bot.accessToken,
{
widgets: {
"1": {
container: "top",
},
},
},
);
await homeserver.csApi.request("POST", `/v3/rooms/${encodeURIComponent(roomId)}/invite`, bot.accessToken, {
user_id: user.userId,
});
await page.getByText("Capabilities Widget").click();
await page.getByRole("button", { name: "Accept" }).click();
await expect(page.getByRole("button", { name: "Approve" })).toBeVisible();
});
});
test.describe("untrusted widgets", () => {
test.use({
config: {
"io.element.element-web-modules.widget-lifecycle": {
widget_permissions: {},
},
},
});
test("shows dialogs for untrusted widgets", async ({ page, user, homeserver }, testInfo) => {
const bot = await homeserver.registerUser(`bot_${testInfo.testId}`, "password", "Bot");
const { room_id: roomId } = await homeserver.csApi.request<{ room_id: string }>(
"POST",
"/v3/createRoom",
bot.accessToken,
{
name: "Untrusted Widget",
},
);
await homeserver.csApi.request<{ event_id: string }>(
"PUT",
`/v3/rooms/${encodeURIComponent(roomId)}/state/im.vector.modular.widgets/1`,
bot.accessToken,
{
id: "1",
creatorUserId: bot.userId,
type: "custom",
name: "Untrusted Widget",
url: `${WIDGET_URL}?hsUrl=${encodeURIComponent(homeserver.baseUrl)}&caps=org.matrix.msc2762.receive.state_event:m.room.topic`,
},
);
await homeserver.csApi.request(
"PUT",
`/v3/rooms/${encodeURIComponent(roomId)}/state/io.element.widgets.layout/`,
bot.accessToken,
{
widgets: {
"1": {
container: "top",
},
},
},
);
await homeserver.csApi.request("POST", `/v3/rooms/${encodeURIComponent(roomId)}/invite`, bot.accessToken, {
user_id: user.userId,
});
await page.getByText("Untrusted Widget").click();
await page.getByRole("button", { name: "Accept" }).click();
await expect(page.getByRole("button", { name: "Continue" })).toBeVisible();
});
});
});