From c24cfb63110a3382a5df9d4754aadb8c936ab0e9 Mon Sep 17 00:00:00 2001
From: R Midhun Suresh <hi@midhun.dev>
Date: Thu, 23 Oct 2025 12:18:33 +0530
Subject: [PATCH] Introduce an abstraction for Room

All APIs that need to return a room will use this type.
---
 packages/element-web-module-api/src/index.ts  |  1 +
 .../element-web-module-api/src/models/Room.ts | 28 +++++++++++++++++++
 2 files changed, 29 insertions(+)
 create mode 100644 packages/element-web-module-api/src/models/Room.ts

diff --git a/packages/element-web-module-api/src/index.ts b/packages/element-web-module-api/src/index.ts
index e89adc482d..4935d10681 100644
--- a/packages/element-web-module-api/src/index.ts
+++ b/packages/element-web-module-api/src/index.ts
@@ -10,6 +10,7 @@ export type { Api, Module, ModuleFactory } from "./api";
 export type { Config, ConfigApi } from "./api/config";
 export type { I18nApi, Variables, Translations } from "./api/i18n";
 export type * from "./models/event";
+export type * from "./models/Room";
 export type * from "./api/custom-components";
 export type * from "./api/extras";
 export type * from "./api/legacy-modules";
diff --git a/packages/element-web-module-api/src/models/Room.ts b/packages/element-web-module-api/src/models/Room.ts
new file mode 100644
index 0000000000..df2f1c8643
--- /dev/null
+++ b/packages/element-web-module-api/src/models/Room.ts
@@ -0,0 +1,28 @@
+/*
+Copyright 2025 New Vector Ltd.
+
+SPDX-License-Identifier: AGPL-3.0-only OR LicenseRef-Element-Commercial
+Please see LICENSE files in the repository root for full details.
+*/
+
+import { Watchable } from "../api/watchable";
+
+/**
+ * Represents a room from element-web.
+ * @public
+ */
+export interface Room {
+    /**
+     * Id of this room.
+     */
+    id: string;
+    /**
+     * {@link Watchable} holding the name for this room.
+     */
+    name: Watchable<string>;
+    /**
+     * Get the timestamp of the last message in this room.
+     * @returns last active timestamp
+     */
+    getLastActiveTimestamp: () => number;
+}