Michael TelatynskiandGitHub
b6859885a3
* Upgrade to TypeScript 7 for massive tsc speed gains Those on WebStorm will want to upgrade to EAP to reap the benefits of the new TSGo compiler Some things (module-api & shared-components) which utilise unplugin-dts (and api-extractor) need to hold a copy of ts6 for its conventional lib format and API. TS7 ships with no API until TS7.1. Other things which use eslint also need ts6 for typescript-eslint. Some type changes were necessary as TS7 caught some issues. * Add knip exception * Fix bad merge
@element-hq/element-web-module-api
API surface for extending Element Web in a safe & predictable way.
This project is still in early development but aims to replace matrix-react-sdk-module-api and Element Web deprecated customisations.
Using the API
Modules are loaded by Element Web at runtime via a dynamic ecmascript import, but can be bundled into a webapp for deployment convenience.
The module's default export MUST be a class which accepts a single argument, an instance of ModuleApi.
This class must also bear a static property moduleApiVersion which is a semver range string
and a load method which is called when the module is to be loaded.
import type { Module, Api, ModuleFactory } from "@element-hq/element-web-module-api";
class ExampleModule implements Module {
public static readonly moduleApiVersion = "^0.1.0";
public constructor(private api: Api) {}
public async load(): Promise<void> {
// Your extension code goes here
}
}
export default ExampleModule satisfies ModuleFactory;
Accessing application configuration
The api object passed to the module constructor provides access to the application configuration.
You can extend the Config types using declaration merging, though please ensure that you do not trust the types you specify,
and opt for runtime validation due to the dynamic nature of the configuration.
// ...
declare module "@element-hq/element-web-module-api" {
interface Config {
"this.is.my.config.key": string;
}
}
class ExampleModule implements Module {
// ...
public async load(): Promise<void> {
const configValue = this.api.config.get("this.is.my.config.key");
// Your extension code goes here
}
}
// ...
Releases
The API is versioned using semver, with the major version incremented for breaking changes.
Copyright & License
Copyright (c) 2025 New Vector Ltd
This software is multi licensed by New Vector Ltd (Element). It can be used either:
(1) for free under the terms of the GNU Affero General Public License (as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version); OR
(2) under the terms of a paid-for Element Commercial License agreement between you and Element (the terms of which may vary depending on what you and Element have agreed to). Unless required by applicable law or agreed to in writing, software distributed under the Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.