matrix-appservice

import { AppService, AppServiceRegistration, AppserviceHttpError } from 'matrix-appservice'; import * as fs from 'node:fs'; // Step 1: Generate an app service registration file (only needed once) const reg = new AppServiceRegistration(); reg.setAppServiceUrl('http://localhost:8010'); reg.setHomeserverToken(AppServiceRegistration.generateToken()); reg.setAppServiceToken(AppServiceRegistration.generateToken()); reg.setSenderLocalpart('example-appservice'); reg.addRegexPattern('users', '@example-.*', true); reg.addRegexPattern('aliases', '#example_.*', true); reg.setProtocols(['exampleservice']); // For 3PID lookups reg.setId('example-service'); const registrationFilePath = 'registration.yaml'; reg.outputAsYaml(registrationFilePath); console.log(`Generated registration file: ${registrationFilePath}`); // Step 2: Run the app service const as = new AppService({ homeserverToken: process.env.HOMESERVER_TOKEN ?? 'your_homeserver_token_here', appServiceToken: process.env.APPSERVICE_TOKEN ?? 'your_appservice_token_here' }); as.on('type:m.room.message', (event) => { console.log(`Received message from ${event.sender}: ${event.content.body}`); // Handle the incoming message }); as.onUserQuery = async function(userId) { console.log(`Received user query for: ${userId}`); // Example: Validate or create the user if (userId.startsWith('@baduser-')) { throw new AppserviceHttpError( { errcode: 'M_FORBIDDEN', error: 'User query or creation failed for this user ID.' }, 403 ); } console.log(`User ${userId} can be created or queried.`); // In a real app, you would provision the user on the AS side here. }; as.onAliasQuery = async function(alias) { console.log(`Received alias query for: ${alias}`); // Handle the incoming alias query then respond }; const port = 8010; as.listen(port); console.log(`Matrix Application Service listening on port ${port}`); console.log('Ensure your homeserver is configured with registration.yaml'); // Optional: Set up TLS if environment variables are present if (process.env.MATRIX_AS_TLS_KEY && process.env.MATRIX_AS_TLS_CERT) { console.log('TLS keys found, AppService will attempt to listen with HTTPS.'); // AppService.listen handles HTTPS automatically if these env vars are set }