@theokit/gateway-matrix 0.4.0 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +54 -0
- package/README.md +14 -0
- package/dist/index.cjs +140 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +61 -6
- package/dist/index.d.ts +61 -6
- package/dist/index.js +140 -3
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,59 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.6.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- fab6127: Join room and DM invites. A new `acceptInvite(inviter, roomId)` option decides which invites the
|
|
8
|
+
bot joins, both live ones and those pending at start; without it nothing is joined, so a stranger
|
|
9
|
+
cannot pull the bot into a room.
|
|
10
|
+
- 00af16f: `BasePlatformAdapter` gains `react(channelId, messageId, emoji)`, which adds an emoji reaction to an inbound message. The default resolves `react_unsupported`; the Discord, Slack, Telegram and Matrix adapters implement it.
|
|
11
|
+
|
|
12
|
+
## 0.5.0
|
|
13
|
+
|
|
14
|
+
### Minor Changes
|
|
15
|
+
|
|
16
|
+
- e5a2603: Group messages that do not mention the bot are no longer delivered by default on Discord, Matrix
|
|
17
|
+
and Teams; pass `requireMention: false` to keep the old behaviour.
|
|
18
|
+
|
|
19
|
+
Discord, Matrix and Teams gain a `requireMention` option that defaults to `true`. With it on, a
|
|
20
|
+
group or thread message reaches the handler only when it mentions the bot, and a DM always does.
|
|
21
|
+
Discord reads the bot's id in `mentions.users` (a direct mention or a reply that pings it; not
|
|
22
|
+
`@everyone`, `@here` or roles), and drops group messages with one stderr line until the client is
|
|
23
|
+
ready. Matrix reads `m.mentions.user_ids`, and falls back to the full user id in `body` or
|
|
24
|
+
`formatted_body` when a client sends no `m.mentions`. Teams reads `mention` entities against the
|
|
25
|
+
activity's `recipient.id`, and drops a group activity that names no recipient with one stderr line.
|
|
26
|
+
|
|
27
|
+
LINE's `deliver()` now applies the mention guard its webhook route already applied.
|
|
28
|
+
|
|
29
|
+
On all four adapters `deliver()` and the adapter's own inbound path use one rule, and `deliver()`
|
|
30
|
+
answers `"ok"` for an event the rule drops, with or without a handler subscribed.
|
|
31
|
+
|
|
32
|
+
### Patch Changes
|
|
33
|
+
|
|
34
|
+
- 3f1788d: Send an image from a gateway handler, and refuse it wherever a platform cannot show one.
|
|
35
|
+
|
|
36
|
+
`@theokit/gateway` exports `OutboundAttachment` (`kind: "image"`, `mediaType`, `data`, optional
|
|
37
|
+
`filename`). `OutboundMessage` gains an optional `attachments` list, `ctx.reply(text, { attachments })`
|
|
38
|
+
carries it to the adapter (an empty list is left out), and `BasePlatformAdapter` declares
|
|
39
|
+
`supportsAttachments`, `false` by default. `DeliveryRouter.send` takes the same `attachments`
|
|
40
|
+
field. The runner and the router refuse an outbound carrying attachments as
|
|
41
|
+
`attachments_unsupported`, with no `sendMessage` call, when the adapter does not declare
|
|
42
|
+
`supportsAttachments`.
|
|
43
|
+
|
|
44
|
+
`@theokit/gateway-telegram` reports `supportsAttachments: true` and sends each image through
|
|
45
|
+
`sendPhoto`, the text as the first photo's caption up to 1024 UTF-16 units and after the photos
|
|
46
|
+
when longer. A non-image kind is refused as `attachments_unsupported`; a missing image, more
|
|
47
|
+
than 10 images or an image over 10 MiB as `invalid_attachment`; all with no request.
|
|
48
|
+
|
|
49
|
+
Every other adapter, and every adapter's `editMessage`, refuses an outbound carrying attachments
|
|
50
|
+
with `attachments_unsupported` and makes no platform call, instead of sending the text and
|
|
51
|
+
dropping the image.
|
|
52
|
+
|
|
53
|
+
The runner's auto-reply to a blocking `pre_inbound` hook no longer discards a `sendMessage` that
|
|
54
|
+
throws: the error reaches the `on_error` hooks with the event and is written to stderr, redacted,
|
|
55
|
+
as a handler error is. Dispatch still does not throw.
|
|
56
|
+
|
|
3
57
|
## 0.4.0
|
|
4
58
|
|
|
5
59
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -62,6 +62,20 @@ room.getJoinedMemberCount() === 2 → channel.type: "dm"
|
|
|
62
62
|
|
|
63
63
|
Edge case: a user who creates a 2-person room intended as a small group will still be detected as a DM. Use `event.matrix.roomId` + Matrix's `m.direct` account-data to override if you need precision.
|
|
64
64
|
|
|
65
|
+
## Group messages and mentions
|
|
66
|
+
|
|
67
|
+
`requireMention` decides which messages in a group room (3 or more members) reach your handler.
|
|
68
|
+
It defaults to `true`: a message is delivered only when it mentions the bot. A mention is the
|
|
69
|
+
adapter's `userId` in the content's `m.mentions.user_ids`, which current clients send. When a
|
|
70
|
+
client sends no `m.mentions`, the full user id in `body` or in a `formatted_body` mention pill
|
|
71
|
+
counts instead. A mention by display name alone from such a client is not seen, so mention the bot
|
|
72
|
+
with a client that sends `m.mentions` or with its full id. `@room` does not count. A DM is always
|
|
73
|
+
delivered. `deliver()` and the sync path apply the same rule, and `deliver()` answers `"ok"` for a
|
|
74
|
+
message it drops.
|
|
75
|
+
|
|
76
|
+
**Upgrading:** before this option the adapter delivered every group message. Pass
|
|
77
|
+
`requireMention: false` to keep that behaviour.
|
|
78
|
+
|
|
65
79
|
## Initial sync flood guard (EC-3 absorbed)
|
|
66
80
|
|
|
67
81
|
On startup, `matrix-js-sdk` delivers the most recent ~10 events per room. A bot in 50 rooms = 500 events fired in seconds → 500 LLM calls = cost explosion. **The adapter filters events older than 60s** (`event.getTs() < Date.now() - 60_000`) so initial sync only delivers genuinely live messages. To replay history programmatically, use the raw `MatrixClient` via `adapter.getClient()`.
|
package/dist/index.cjs
CHANGED
|
@@ -65,6 +65,49 @@ async function loadMatrixSdk() {
|
|
|
65
65
|
}
|
|
66
66
|
}
|
|
67
67
|
|
|
68
|
+
// src/invite.ts
|
|
69
|
+
function warn(msg) {
|
|
70
|
+
process.stderr.write(`[gateway-matrix] ${msg}
|
|
71
|
+
`);
|
|
72
|
+
}
|
|
73
|
+
async function handleInvite(client, opts, inviter, roomId, seen) {
|
|
74
|
+
if (seen.has(roomId)) return;
|
|
75
|
+
seen.add(roomId);
|
|
76
|
+
try {
|
|
77
|
+
if (!await opts.acceptInvite(inviter, roomId)) return;
|
|
78
|
+
await client.joinRoom(roomId);
|
|
79
|
+
} catch (err) {
|
|
80
|
+
seen.delete(roomId);
|
|
81
|
+
warn(`join of ${roomId} failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
82
|
+
}
|
|
83
|
+
}
|
|
84
|
+
function subscribeToInvites(client, opts) {
|
|
85
|
+
const seen = /* @__PURE__ */ new Set();
|
|
86
|
+
const run = (inviter, roomId) => {
|
|
87
|
+
void handleInvite(client, opts, inviter, roomId, seen).catch((err) => {
|
|
88
|
+
warn(`invite handling failed: ${err instanceof Error ? err.message : String(err)}`);
|
|
89
|
+
});
|
|
90
|
+
};
|
|
91
|
+
const onMember = (event, member) => {
|
|
92
|
+
if (member.userId !== opts.botUserId || member.membership !== "invite") return;
|
|
93
|
+
run(event.getSender() ?? "", member.roomId);
|
|
94
|
+
};
|
|
95
|
+
const scanPending = () => {
|
|
96
|
+
for (const room of client.getRooms?.() ?? []) {
|
|
97
|
+
if (room.getMyMembership?.() !== "invite") continue;
|
|
98
|
+
const inviter = room.getMember?.(opts.botUserId)?.events?.member?.getSender() ?? "";
|
|
99
|
+
run(inviter, room.roomId);
|
|
100
|
+
}
|
|
101
|
+
};
|
|
102
|
+
client.on("RoomMember.membership", onMember);
|
|
103
|
+
client.on("sync", scanPending);
|
|
104
|
+
scanPending();
|
|
105
|
+
return () => {
|
|
106
|
+
client.off("RoomMember.membership", onMember);
|
|
107
|
+
client.off("sync", scanPending);
|
|
108
|
+
};
|
|
109
|
+
}
|
|
110
|
+
|
|
68
111
|
// src/room-state.ts
|
|
69
112
|
function detectChannelType(room) {
|
|
70
113
|
if (room === void 0) return "group";
|
|
@@ -98,6 +141,15 @@ function matrixEventToMessageEvent(event, room) {
|
|
|
98
141
|
};
|
|
99
142
|
}
|
|
100
143
|
|
|
144
|
+
// src/refuse-attachments.ts
|
|
145
|
+
function refuseAttachments(out) {
|
|
146
|
+
if (out.attachments == null || out.attachments.length === 0) return void 0;
|
|
147
|
+
return {
|
|
148
|
+
ok: false,
|
|
149
|
+
error: { code: "attachments_unsupported", message: "matrix adapter cannot send attachments" }
|
|
150
|
+
};
|
|
151
|
+
}
|
|
152
|
+
|
|
101
153
|
// src/replace-content.ts
|
|
102
154
|
var HTML_FORMAT = "org.matrix.custom.html";
|
|
103
155
|
function textContent(text, html) {
|
|
@@ -141,6 +193,7 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
141
193
|
opts;
|
|
142
194
|
client;
|
|
143
195
|
subscription;
|
|
196
|
+
unsubscribeInvites;
|
|
144
197
|
inboundHandler;
|
|
145
198
|
aliasCache = new AliasCache();
|
|
146
199
|
connected = false;
|
|
@@ -212,7 +265,11 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
212
265
|
const msg = err instanceof Error ? err.message : String(err);
|
|
213
266
|
process.stderr.write(`[gateway-matrix] connect failed: ${msg}
|
|
214
267
|
`);
|
|
215
|
-
|
|
268
|
+
const rest = err;
|
|
269
|
+
if (rest?.httpStatus === 401 || rest?.httpStatus === 403 || rest?.errcode === "M_UNKNOWN_TOKEN") {
|
|
270
|
+
return false;
|
|
271
|
+
}
|
|
272
|
+
throw err;
|
|
216
273
|
}
|
|
217
274
|
}
|
|
218
275
|
async disconnect() {
|
|
@@ -220,6 +277,8 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
220
277
|
this.tearingDown = true;
|
|
221
278
|
this.subscription?.unsubscribe();
|
|
222
279
|
this.subscription = void 0;
|
|
280
|
+
this.unsubscribeInvites?.();
|
|
281
|
+
this.unsubscribeInvites = void 0;
|
|
223
282
|
this.client?.stopClient();
|
|
224
283
|
this.client = void 0;
|
|
225
284
|
this.connected = false;
|
|
@@ -227,6 +286,9 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
227
286
|
this.aliasCache.clear();
|
|
228
287
|
}
|
|
229
288
|
async sendMessage(out) {
|
|
289
|
+
return refuseAttachments(out) ?? this.sendText(out);
|
|
290
|
+
}
|
|
291
|
+
async sendText(out) {
|
|
230
292
|
if (out.text.length === 0) {
|
|
231
293
|
return { ok: false, error: { code: "empty_text", message: "outbound text is empty" } };
|
|
232
294
|
}
|
|
@@ -270,6 +332,9 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
270
332
|
* Unlike `sendMessage`, a refused markup is not retried as plain text: one request, one answer.
|
|
271
333
|
*/
|
|
272
334
|
async editMessage(messageId, out) {
|
|
335
|
+
return refuseAttachments(out) ?? this.editText(messageId, out);
|
|
336
|
+
}
|
|
337
|
+
async editText(messageId, out) {
|
|
273
338
|
if (out.text.length === 0) {
|
|
274
339
|
return { ok: false, error: { code: "empty_text", message: "outbound text is empty" } };
|
|
275
340
|
}
|
|
@@ -311,6 +376,52 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
311
376
|
}
|
|
312
377
|
return { ok: true, messageId };
|
|
313
378
|
}
|
|
379
|
+
/** Matrix expires a typing notice after its timeout; the runner renews it while the turn runs. */
|
|
380
|
+
async startTyping(channelId) {
|
|
381
|
+
await this.setTyping(channelId, true);
|
|
382
|
+
}
|
|
383
|
+
async stopTyping(channelId) {
|
|
384
|
+
await this.setTyping(channelId, false);
|
|
385
|
+
}
|
|
386
|
+
async setTyping(channelId, typing) {
|
|
387
|
+
const client = this.client;
|
|
388
|
+
if (channelId.length === 0 || client?.sendTyping === void 0) return;
|
|
389
|
+
try {
|
|
390
|
+
const roomId = await this.aliasCache.resolve(client, channelId);
|
|
391
|
+
await client.sendTyping(roomId, typing, 1e4);
|
|
392
|
+
} catch {
|
|
393
|
+
}
|
|
394
|
+
}
|
|
395
|
+
async react(channelId, messageId, emoji) {
|
|
396
|
+
if (channelId.length === 0 || messageId.length === 0 || emoji.length === 0) {
|
|
397
|
+
return {
|
|
398
|
+
ok: false,
|
|
399
|
+
error: { code: "invalid_reaction", message: "room, event id and emoji are required" }
|
|
400
|
+
};
|
|
401
|
+
}
|
|
402
|
+
const client = this.client;
|
|
403
|
+
if (client === void 0) {
|
|
404
|
+
return {
|
|
405
|
+
ok: false,
|
|
406
|
+
error: { code: "not_connected", message: "MatrixAdapter.connect() not called" }
|
|
407
|
+
};
|
|
408
|
+
}
|
|
409
|
+
if (client.sendEvent === void 0) {
|
|
410
|
+
return {
|
|
411
|
+
ok: false,
|
|
412
|
+
error: { code: "react_unsupported", message: "matrix client has no sendEvent" }
|
|
413
|
+
};
|
|
414
|
+
}
|
|
415
|
+
try {
|
|
416
|
+
const roomId = await this.aliasCache.resolve(client, channelId);
|
|
417
|
+
await client.sendEvent(roomId, "m.reaction", {
|
|
418
|
+
"m.relates_to": { rel_type: "m.annotation", event_id: messageId, key: emoji }
|
|
419
|
+
});
|
|
420
|
+
} catch (err) {
|
|
421
|
+
return mapMatrixError(err);
|
|
422
|
+
}
|
|
423
|
+
return { ok: true, messageId };
|
|
424
|
+
}
|
|
314
425
|
/**
|
|
315
426
|
* Send `out`, letting the caller's declared `format` decide the shape.
|
|
316
427
|
*
|
|
@@ -397,6 +508,14 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
397
508
|
botUserId: this.opts.userId,
|
|
398
509
|
freshnessWindowMs: this.opts.freshnessWindowMs ?? DEFAULT_FRESHNESS_MS
|
|
399
510
|
};
|
|
511
|
+
const acceptInvite = this.opts.acceptInvite;
|
|
512
|
+
if (acceptInvite !== void 0 && client.joinRoom !== void 0) {
|
|
513
|
+
this.unsubscribeInvites?.();
|
|
514
|
+
this.unsubscribeInvites = subscribeToInvites(
|
|
515
|
+
client,
|
|
516
|
+
{ botUserId: this.opts.userId, acceptInvite }
|
|
517
|
+
);
|
|
518
|
+
}
|
|
400
519
|
this.subscription = subscribeToTimeline(
|
|
401
520
|
client,
|
|
402
521
|
(ev, room) => {
|
|
@@ -416,6 +535,7 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
416
535
|
}
|
|
417
536
|
const normalized = matrixEventToMessageEvent(event, room);
|
|
418
537
|
if (normalized === void 0) return;
|
|
538
|
+
if (!this.passesMentionGate(normalized)) return;
|
|
419
539
|
if (this.inboundHandler === void 0) return;
|
|
420
540
|
try {
|
|
421
541
|
await this.inboundHandler(normalized);
|
|
@@ -425,6 +545,21 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
425
545
|
`);
|
|
426
546
|
}
|
|
427
547
|
}
|
|
548
|
+
/**
|
|
549
|
+
* Whether an event may reach the handler: always for a DM or with `requireMention` off,
|
|
550
|
+
* otherwise only when the content mentions the bot. Both `deliver()` and the sync path call it,
|
|
551
|
+
* so the two entries cannot disagree.
|
|
552
|
+
*/
|
|
553
|
+
passesMentionGate(event) {
|
|
554
|
+
if (event.channel.type === "dm" || !(this.opts.requireMention ?? true)) return true;
|
|
555
|
+
const botId = this.opts.userId;
|
|
556
|
+
const raw = event.platform === "matrix" ? event.matrix.raw : void 0;
|
|
557
|
+
const content = raw?.getContent?.();
|
|
558
|
+
if (content === void 0) return event.text.includes(botId);
|
|
559
|
+
const mentions = content["m.mentions"];
|
|
560
|
+
if (mentions !== void 0) return mentions.user_ids?.includes(botId) ?? false;
|
|
561
|
+
return (content.body ?? "").includes(botId) || (content.formatted_body ?? "").includes(botId);
|
|
562
|
+
}
|
|
428
563
|
isEncrypted(roomId) {
|
|
429
564
|
if (this.client === void 0) return false;
|
|
430
565
|
if (this.client.isRoomEncrypted === void 0) return false;
|
|
@@ -445,10 +580,12 @@ var MatrixAdapter = class extends gateway.BasePlatformAdapter {
|
|
|
445
580
|
/**
|
|
446
581
|
* Deliver an event that arrived out of band — the ingest `onInbound` had no counterpart for (#83).
|
|
447
582
|
*
|
|
448
|
-
*
|
|
449
|
-
*
|
|
583
|
+
* The mention gate runs first, as on the sync path: an event it drops answers `"ok"`, with or
|
|
584
|
+
* without a handler subscribed. `runHandler` owns the containment: a handler is user code, its
|
|
585
|
+
* throw is named as the handler's failure rather than the platform's, and delivery continues.
|
|
450
586
|
*/
|
|
451
587
|
async deliver(event) {
|
|
588
|
+
if (!this.passesMentionGate(event)) return "ok";
|
|
452
589
|
return this.runHandler(this.inboundHandler, event);
|
|
453
590
|
}
|
|
454
591
|
};
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/errors.ts","../src/alias.ts","../src/client.ts","../src/room-state.ts","../src/normalize.ts","../src/replace-content.ts","../src/sync.ts","../src/adapter.ts"],"names":["GatewayConfigurationError","BasePlatformAdapter"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-matrix`.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2). Behavior byte-identical (pinned by `tests/errors.test.ts`).\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\n/**\n * Misconfiguration of this adapter, raised before any network call.\n *\n * Extends the shared core base so every gateway package reports configuration faults in one shape:\n * a structured `code` the caller can branch on, tagged with `\"gateway-matrix\"` as the origin. A\n * missing credential or an unsupported option is a programmer error, not a transient failure —\n * these are never retried.\n */\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-matrix\", opts);\n }\n}\n\n/**\n * The platform SDK this adapter needs is declared as a peer dependency and is not installed.\n *\n * Raised at connect time rather than at import, so a project that installs several gateway packages\n * only pays for the SDKs of the ones it actually starts. The message names the exact package and\n * the command that installs it.\n */\nexport class SDKNotInstalledError extends ConfigurationError {\n constructor() {\n super({\n code: \"sdk_not_installed\",\n message:\n 'gateway-matrix: peer-dep \"matrix-js-sdk\" not installed. Run: pnpm add matrix-js-sdk',\n detail: \"matrix-js-sdk\",\n });\n }\n}\n\n/**\n * The room is end-to-end encrypted, which this adapter cannot read.\n *\n * E2EE is deferred to v0.2. Raised rather than silently ignoring the room, because a bot that\n * appears connected and never sees a message is far harder to diagnose than one that says why.\n */\nexport class EncryptedRoomError extends ConfigurationError {\n constructor(roomId: string) {\n super({\n code: \"encrypted_room_unsupported\",\n message: `gateway-matrix: room ${roomId} is end-to-end encrypted (E2EE deferred to v0.2)`,\n detail: roomId,\n });\n }\n}\n","/**\n * Matrix alias resolution + caching (D419).\n *\n * Accepts:\n * - Room id (`!abc123:server`) — pass-through.\n * - Alias (`#general:server`) — resolved via `client.getRoomIdForAlias`.\n *\n * Other shapes throw `ConfigurationError({ code: \"invalid_room_ref\" })`.\n */\n\nimport { ConfigurationError } from \"./errors.js\";\n\n/** @knipignore — minimal Client interface `AliasCache.resolve` accepts; useful for callers building their own resolver. */\nexport interface AliasResolverClient {\n getRoomIdForAlias(alias: string): Promise<{ room_id: string }>;\n}\n\n/**\n * Resolves a Matrix room alias (`#room:server`) to its room id, remembering the answer.\n *\n * An alias resolves through a server round-trip, and the mapping effectively never changes, so\n * repeating it once per outbound message is pure latency. A value that is already a room id is\n * returned untouched, which lets callers pass either form.\n */\nexport class AliasCache {\n private readonly cache = new Map<string, string>();\n\n /** Returns the room id; resolves aliases via the client + caches. */\n async resolve(client: AliasResolverClient, refOrId: string): Promise<string> {\n if (refOrId.startsWith(\"!\")) return refOrId;\n if (!refOrId.startsWith(\"#\")) {\n throw new ConfigurationError({\n code: \"invalid_room_ref\",\n message: `gateway-matrix: invalid room reference ${JSON.stringify(refOrId)} — expected '!' (room id) or '#' (alias)`,\n });\n }\n const cached = this.cache.get(refOrId);\n if (cached !== undefined) return cached;\n const { room_id } = await client.getRoomIdForAlias(refOrId);\n this.cache.set(refOrId, room_id);\n return room_id;\n }\n\n /** Drop all cached resolutions. Useful for tests + admin-rename recovery. */\n clear(): void {\n this.cache.clear();\n }\n\n size(): number {\n return this.cache.size;\n }\n}\n","/**\n * Lazy `matrix-js-sdk` loader.\n */\n\nimport { SDKNotInstalledError } from \"./errors.js\";\nimport type { MatrixClientLike } from \"./sync.js\";\nimport type { MatrixRoomLike } from \"./types.js\";\n\nexport interface MatrixSdkClient extends MatrixClientLike {\n startClient(opts: { initialSyncLimit: number }): Promise<void>;\n stopClient(): void;\n sendTextMessage(roomId: string, text: string): Promise<{ event_id: string }>;\n /**\n * Send a message whose content object the caller composes.\n *\n * `sendTextMessage` is a convenience that hard-codes `msgtype: m.text` and a bare `body`, so\n * it has nowhere to put `formatted_body` — the field Matrix documents for markup. Honouring\n * `OutboundMessage.format` therefore needs the general call, not a new argument on the\n * convenience one.\n */\n sendMessage?(roomId: string, content: Record<string, unknown>): Promise<{ event_id: string }>;\n getRoomIdForAlias(alias: string): Promise<{ room_id: string }>;\n getRoom(roomId: string): MatrixRoomLike | null;\n isRoomEncrypted?(roomId: string): boolean;\n /** Best-effort current user id; matrix-js-sdk returns `string | null`. */\n getUserId(): string | null;\n /**\n * `/_matrix/client/v3/account/whoami` — the cheapest call that makes the\n * server judge the access token. `startClient` does not: it begins syncing\n * asynchronously and resolves regardless, so without this an invalid token\n * produces a connected-looking adapter that never receives anything.\n */\n whoami(): Promise<{ user_id: string }>;\n}\n\ninterface MatrixSdkModule {\n createClient(opts: { baseUrl: string; accessToken: string; userId: string }): MatrixSdkClient;\n}\n\nexport async function loadMatrixSdk(): Promise<MatrixSdkModule> {\n try {\n const mod = await import(\"matrix-js-sdk\");\n return mod as unknown as MatrixSdkModule;\n } catch {\n throw new SDKNotInstalledError();\n }\n}\n","/**\n * Room state helpers (D416).\n *\n * Matrix has no native \"DM\" concept — DMs are rooms with 2 members.\n * The canonical heuristic: `member_count === 2 → \"dm\"`, else `\"group\"`.\n */\n\nimport type { MatrixRoomLike } from \"./types.js\";\n\nexport function detectChannelType(room: MatrixRoomLike | undefined): \"dm\" | \"group\" {\n if (room === undefined) return \"group\";\n return room.getJoinedMemberCount() === 2 ? \"dm\" : \"group\";\n}\n","/**\n * Inbound normalization: MatrixEvent + Room → MatrixMessageEvent.\n *\n * @public\n */\n\nimport type { MatrixMessageEvent } from \"@theokit/gateway\";\n\nimport { detectChannelType } from \"./room-state.js\";\nimport type { MatrixEventLike, MatrixRoomLike } from \"./types.js\";\n\nexport function matrixEventToMessageEvent(\n event: MatrixEventLike,\n room: MatrixRoomLike,\n): MatrixMessageEvent | undefined {\n const eventId = event.getId();\n const sender = event.getSender();\n if (eventId === undefined || sender === undefined) return undefined;\n const channelType = detectChannelType(room);\n const content = event.getContent();\n const body = content.body ?? \"\";\n return {\n id: eventId,\n platform: \"matrix\",\n sender: { id: sender },\n channel: {\n id: room.roomId,\n type: channelType,\n },\n text: body,\n receivedAt: event.getTs(),\n matrix: {\n roomId: room.roomId,\n eventId,\n memberCount: room.getJoinedMemberCount(),\n raw: event,\n },\n };\n}\n","/**\n * The content of a Matrix `m.replace` event — how an edit is expressed on Matrix.\n *\n * Matrix has no call that changes an event. An edit is a NEW event whose `m.relates_to` names the\n * original with `rel_type: \"m.replace\"` and whose `m.new_content` holds the replacement; clients\n * that understand replacements render `m.new_content` over the original, and the rest show the\n * outer `body`, which carries the conventional `* ` prefix (Matrix Client-Server API v1.12,\n * § Event replacements).\n *\n * `formatted_body` follows the rule `sendMessage` follows: only `format: \"html\"` may declare\n * `org.matrix.custom.html`, because the declaration promises every client the field IS HTML.\n *\n * @internal\n */\n\nimport type { OutboundMessage } from \"@theokit/gateway\";\n\nconst HTML_FORMAT = \"org.matrix.custom.html\";\n\n/** The `m.text` content for `text`, with `formatted_body` only when the caller declared html. */\nfunction textContent(text: string, html: boolean): Record<string, unknown> {\n return html\n ? { msgtype: \"m.text\", body: text, format: HTML_FORMAT, formatted_body: text }\n : { msgtype: \"m.text\", body: text };\n}\n\n/** Build the content of an event that replaces `originalEventId` with `out.text`. */\nexport function replaceContent(\n originalEventId: string,\n out: OutboundMessage,\n): Record<string, unknown> {\n const html = out.format === \"html\";\n return {\n ...textContent(`* ${out.text}`, html),\n \"m.new_content\": textContent(out.text, html),\n \"m.relates_to\": { rel_type: \"m.replace\", event_id: originalEventId },\n };\n}\n","/**\n * Sync timeline filter (D415, EC-3 absorbed).\n *\n * Wraps `client.on(\"Room.timeline\", listener)` with 3 filters:\n *\n * 1. Drop non-`m.room.message` events (D413).\n * 2. Drop bot's own messages (loop guard, D275 mirror).\n * 3. **EC-3**: drop events older than `freshnessWindowMs` (default 60s)\n * — initial sync from `matrix-js-sdk` delivers ~10 historical events\n * per joined room, which would otherwise trigger an LLM-call storm.\n */\n\nimport type { MatrixEventLike, MatrixRoomLike } from \"./types.js\";\n\nexport interface SyncFilterOpts {\n readonly botUserId: string;\n readonly freshnessWindowMs: number;\n}\n\n/**\n * Decide whether a timeline event should reach the handler.\n *\n * Matrix replays room history on sync, so a freshly started bot would otherwise answer every message\n * it can still see — which is a reply storm in a busy room and an infinite loop in a quiet one. This\n * drops the bot's own events and anything older than the freshness window. `now` is injectable so\n * the decision is testable without waiting.\n */\nexport function shouldDispatchSyncEvent(\n event: MatrixEventLike,\n opts: SyncFilterOpts,\n now = Date.now(),\n): boolean {\n if (event.getType() !== \"m.room.message\") return false;\n const sender = event.getSender();\n if (sender === opts.botUserId) return false;\n if (event.getTs() < now - opts.freshnessWindowMs) return false;\n return true;\n}\n\n/** A live timeline listener, with the handle that detaches it again. */\nexport interface TimelineSubscription {\n unsubscribe(): void;\n}\n\n/**\n * The slice of `matrix-js-sdk`'s client this adapter actually uses.\n *\n * Narrow on purpose: it is what lets the sync logic be tested against a few lines of fake rather\n * than a running homeserver, and it states the real coupling to the SDK — two event methods.\n */\nexport interface MatrixClientLike {\n on(event: \"Room.timeline\", listener: (e: MatrixEventLike, r: MatrixRoomLike) => void): void;\n off(event: \"Room.timeline\", listener: (e: MatrixEventLike, r: MatrixRoomLike) => void): void;\n}\n\n/**\n * Attach `handler` to the client's room timeline, filtered by {@link shouldDispatchSyncEvent}.\n *\n * Returns the subscription rather than leaving the listener attached forever: an adapter that\n * reconnects without detaching accumulates listeners, and every inbound message is then handled\n * once per reconnect.\n */\nexport function subscribeToTimeline(\n client: MatrixClientLike,\n handler: (event: MatrixEventLike, room: MatrixRoomLike) => void,\n opts: SyncFilterOpts,\n): TimelineSubscription {\n const wrapped = (event: MatrixEventLike, room: MatrixRoomLike): void => {\n if (!shouldDispatchSyncEvent(event, opts)) return;\n handler(event, room);\n };\n client.on(\"Room.timeline\", wrapped);\n return {\n unsubscribe(): void {\n client.off(\"Room.timeline\", wrapped);\n },\n };\n}\n","/**\n * `MatrixAdapter` — implements BasePlatformAdapter over matrix-js-sdk.\n * ADRs D413-D421.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\n\nimport { AliasCache } from \"./alias.js\";\nimport { loadMatrixSdk, type MatrixSdkClient } from \"./client.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { matrixEventToMessageEvent } from \"./normalize.js\";\nimport { replaceContent } from \"./replace-content.js\";\nimport { subscribeToTimeline, type TimelineSubscription } from \"./sync.js\";\nimport type { MatrixAdapterOptions, MatrixEventLike, MatrixRoomLike } from \"./types.js\";\n\nconst DEFAULT_FRESHNESS_MS = 60_000;\nconst INITIAL_SYNC_LIMIT = 10;\n\nexport class MatrixAdapter extends BasePlatformAdapter {\n readonly platform = \"matrix\" as const;\n private readonly opts: MatrixAdapterOptions;\n private client: MatrixSdkClient | undefined;\n private subscription: TimelineSubscription | undefined;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private readonly aliasCache = new AliasCache();\n private connected = false;\n private readonly warnedEncrypted = new Set<string>();\n /** True only between disconnect() and the next connect() — see #12. */\n private tearingDown = false;\n\n /**\n * `fetch` for the SDK that leaves teardown aborts unsettled instead of\n * rejecting (#12).\n *\n * A request aborted while we are tearing the client down has no consumer left\n * that could act on the outcome, so an unsettled promise costs a continuation\n * and nothing else; the alternative is a rejection with no handler anywhere,\n * which ends the host process. It is scoped to the teardown window on purpose:\n * a consumer using the `getClient()` escape hatch (D421) may pass its own\n * abort signal to `search()` or `slidingSync()` and MUST still see those\n * rejections, so outside teardown every error propagates untouched.\n */\n private teardownSafeFetch(): typeof globalThis.fetch {\n const base = globalThis.fetch.bind(globalThis);\n return (input, init) =>\n base(input, init).catch((err: unknown) => {\n if (this.tearingDown && isAbortError(err)) {\n return new Promise<Response>(() => {\n /* deliberately never settles — see the doc comment */\n });\n }\n throw err;\n });\n }\n\n constructor(opts: MatrixAdapterOptions) {\n super();\n if (opts.homeserverUrl.length === 0) {\n throw new ConfigurationError({\n code: \"homeserver_url_required\",\n message: 'gateway-matrix: opts.homeserverUrl is empty (e.g. \"https://matrix.org\")',\n });\n }\n if (opts.accessToken.length === 0) {\n throw new ConfigurationError({\n code: \"access_token_required\",\n message:\n \"gateway-matrix: opts.accessToken is empty (Element → Settings → Help & About → Advanced → Access Token)\",\n });\n }\n if (opts.userId.length === 0 || !opts.userId.startsWith(\"@\")) {\n throw new ConfigurationError({\n code: \"user_id_required\",\n message: 'gateway-matrix: opts.userId must be a Matrix user id (e.g. \"@bot:matrix.org\")',\n });\n }\n this.opts = opts;\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n this.tearingDown = false;\n try {\n const cfg = {\n baseUrl: this.opts.homeserverUrl,\n accessToken: this.opts.accessToken,\n userId: this.opts.userId,\n fetchFn: this.teardownSafeFetch(),\n };\n const factory = this.opts.__clientFactory;\n this.client =\n factory === undefined\n ? (await loadMatrixSdk()).createClient(cfg)\n : (factory(cfg) as MatrixSdkClient);\n // Validate the credential BEFORE reporting success. `startClient` kicks\n // off the sync loop asynchronously and resolves whether or not the token\n // is any good — so connect() used to answer `true` for a token the server\n // rejects, leaving an operator with a healthy-looking adapter and total\n // silence. Every sibling adapter returns false here; this one did not,\n // and only a real homeserver could show it.\n await this.client.whoami();\n await this.client.startClient({ initialSyncLimit: INITIAL_SYNC_LIMIT });\n this.attachSync();\n this.connected = true;\n return true;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-matrix] connect failed: ${msg}\\n`);\n return false;\n }\n }\n\n async disconnect(): Promise<void> {\n if (!this.connected) return;\n // Issue #12. `stopClient()` aborts the requests still in flight, and the\n // AbortError escapes as an UNHANDLED rejection — the rejecting promise is\n // the SDK's own `authedRequest` wrapper, which no caller catches and which\n // we cannot reach. Node has terminated on unhandled rejections by default\n // since v15, so an application calling disconnect() inside a reconnect loop\n // could be killed by its own clean shutdown. Measured against a real\n // homeserver: 7 occurrences in 8 connect/disconnect cycles.\n //\n // `teardownSafeFetch` closes it at the only seam the SDK offers. The flag is\n // set here, before the abort, and cleared by the next connect().\n this.tearingDown = true;\n this.subscription?.unsubscribe();\n this.subscription = undefined;\n this.client?.stopClient();\n this.client = undefined;\n this.connected = false;\n this.inboundHandler = undefined;\n this.aliasCache.clear();\n }\n\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"MatrixAdapter.connect() not called\" },\n };\n }\n try {\n const roomId = await this.aliasCache.resolve(this.client, out.channel.id);\n if (this.isEncrypted(roomId)) {\n this.warnEncryptedOnce(roomId);\n return {\n ok: false,\n error: {\n code: \"encrypted_room_unsupported\",\n message: `Matrix room ${roomId} is encrypted; E2EE deferred to v0.2`,\n },\n };\n }\n const res = await this.sendHonouringFormat(roomId, out);\n return { ok: true, messageId: res.event_id };\n } catch (err) {\n return mapMatrixError(err);\n }\n }\n\n /**\n * Matrix edits through an `m.replace` event, so the capability holds from construction: it does\n * not depend on a connection or on which client is injected later.\n */\n override readonly supportsEdit = true;\n\n /**\n * Replace a message this bot sent with an `m.replace` event, and return the ORIGINAL event id.\n *\n * Returning the original id lets a second edit target the same message: clients apply the\n * newest replacement of the original, not a replacement of a replacement. There is no length\n * check, since Matrix has no splitter. An injected client without `sendMessage` cannot carry\n * the relation and answers `edit_unsupported`. The room resolves through the same alias cache\n * as `sendMessage`, so a `#alias` this adapter never resolved costs one lookup before the event.\n * Unlike `sendMessage`, a refused markup is not retried as plain text: one request, one answer.\n */\n override async editMessage(messageId: string, out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n const client = this.client;\n if (client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"MatrixAdapter.connect() not called\" },\n };\n }\n if (messageId.length === 0) {\n return { ok: false, error: { code: \"invalid_message_id\", message: \"message id is empty\" } };\n }\n if (client.sendMessage === undefined) {\n return {\n ok: false,\n error: {\n code: \"edit_unsupported\",\n message: \"matrix client has no sendMessage, so it cannot send an m.replace event\",\n },\n };\n }\n try {\n const roomId = await this.aliasCache.resolve(client, out.channel.id);\n if (this.isEncrypted(roomId)) {\n this.warnEncryptedOnce(roomId);\n return {\n ok: false,\n error: {\n code: \"encrypted_room_unsupported\",\n message: `Matrix room ${roomId} is encrypted; E2EE deferred to v0.2`,\n },\n };\n }\n this.warnFormatUnsupported(out.format);\n await client.sendMessage(roomId, replaceContent(messageId, out));\n } catch (err) {\n return mapMatrixError(err);\n }\n return { ok: true, messageId };\n }\n\n /**\n * Send `out`, letting the caller's declared `format` decide the shape.\n *\n * Matrix carries markup in `formatted_body` and declares its type in `format`, whose only\n * value is `org.matrix.custom.html`. That declaration is a promise to every client that the\n * field IS HTML — so only `format: \"html\"` may use it.\n *\n * **`markdown` deliberately does not.** The first version of this method put the caller's\n * markdown into `formatted_body` and declared it HTML, which was worse than the bug it meant\n * to fix: `**bold**` still rendered as literal asterisks because markdown is not HTML, AND a\n * `<div>` anywhere in the text was parsed as a tag and dropped, so the reader received words\n * the sender never wrote and lost the ones they did. Caught in review; the test that\n * \"proved\" it was asserting the defect.\n *\n * So Matrix joins LINE, SMS and WhatsApp: it has no markdown mode, and the honest handling is\n * to say once that the declaration is being dropped rather than to fake it.\n *\n * Falls back to `sendTextMessage` when the client does not expose `sendMessage`: it is\n * optional on {@link MatrixSdkClient} because a consumer may inject a narrower double, and\n * losing the formatting is better than losing the message.\n *\n * @internal\n */\n private async sendHonouringFormat(\n roomId: string,\n out: OutboundMessage,\n ): Promise<{ event_id: string }> {\n const client = this.client as MatrixSdkClient;\n if (out.format !== \"html\" || client.sendMessage === undefined) {\n this.warnFormatUnsupported(out.format);\n return await client.sendTextMessage(roomId, out.text);\n }\n try {\n return await client.sendMessage(roomId, {\n msgtype: \"m.text\",\n body: out.text,\n format: \"org.matrix.custom.html\",\n formatted_body: out.text,\n });\n } catch (err) {\n // ADR-2: an undelivered message is worse than an unformatted one — the caller loses the\n // content and the user sees nothing, which is strictly worse than losing the markup.\n //\n // The discrimination is the whole guard. A bare `catch` would swallow an expired token as\n // a formatting problem and retry into the same 401, turning an actionable error into a\n // silent double failure. Only a request the server judged malformed is retried.\n if (!isMalformedRequest(err)) throw err;\n process.stderr.write(\n \"[gateway-matrix] homeserver rejected the formatted body; retrying as plain text\\n\",\n );\n return await client.sendTextMessage(roomId, out.text);\n }\n }\n\n /** Whether the \"no markdown mode here\" warning has already been emitted. */\n private warnedAboutFormat = false;\n\n /**\n * Say, once, that a declared `markdown` has nowhere to go on this platform.\n *\n * Matrix's only markup type is HTML. A caller declaring `markdown` is asking for something\n * the protocol does not have, and putting the markdown in the HTML field would corrupt it.\n *\n * @internal\n */\n private warnFormatUnsupported(format: OutboundMessage[\"format\"]): void {\n if (format === undefined || format === \"plain\" || format === \"html\") return;\n if (this.warnedAboutFormat) return;\n this.warnedAboutFormat = true;\n process.stderr.write(\n `[gateway-matrix] format=\"${format}\" was declared, and Matrix has no markdown mode — ` +\n \"its only markup type is HTML. Sending as plain text; this is logged once.\\n\",\n );\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /** Escape hatch (D421) — caller can drive matrix-js-sdk directly for advanced features. */\n getClient(): MatrixSdkClient | undefined {\n return this.client;\n }\n\n /** Used by tests to install a mock SDK client + flip connected flag. */\n _installClient(client: MatrixSdkClient): void {\n this.client = client;\n this.connected = true;\n this.attachSync();\n }\n\n private attachSync(): void {\n if (this.client === undefined) return;\n const client = this.client;\n const opts = {\n botUserId: this.opts.userId,\n freshnessWindowMs: this.opts.freshnessWindowMs ?? DEFAULT_FRESHNESS_MS,\n };\n this.subscription = subscribeToTimeline(\n client,\n (ev: MatrixEventLike, room: MatrixRoomLike) => {\n void this.dispatchTimelineEvent(ev, room).catch((err: unknown) => {\n const m = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-matrix] dispatchTimelineEvent failed: ${m}\\n`);\n });\n },\n opts,\n );\n }\n\n private async dispatchTimelineEvent(event: MatrixEventLike, room: MatrixRoomLike): Promise<void> {\n if (this.isEncrypted(room.roomId)) {\n this.warnEncryptedOnce(room.roomId);\n return;\n }\n const normalized = matrixEventToMessageEvent(event, room);\n if (normalized === undefined) return;\n if (this.inboundHandler === undefined) return;\n try {\n await this.inboundHandler(normalized);\n } catch (err) {\n const m = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-matrix] handler threw: ${m}\\n`);\n }\n }\n\n private isEncrypted(roomId: string): boolean {\n if (this.client === undefined) return false;\n if (this.client.isRoomEncrypted === undefined) return false;\n try {\n return this.client.isRoomEncrypted(roomId);\n } catch {\n return false;\n }\n }\n\n private warnEncryptedOnce(roomId: string): void {\n if (this.warnedEncrypted.has(roomId)) return;\n this.warnedEncrypted.add(roomId);\n process.stderr.write(\n `[gateway-matrix] room ${roomId} is end-to-end encrypted; skipping (E2EE deferred to v0.2)\\n`,\n );\n }\n\n /**\n * Deliver an event that arrived out of band — the ingest `onInbound` had no counterpart for (#83).\n *\n * One line over `runHandler`, which owns the containment: a handler is user code, its throw is\n * named as the handler's failure rather than the platform's, and delivery continues.\n */\n override async deliver(\n event: GatewayMessageEvent,\n ): Promise<\"ok\" | \"no_handler\" | \"handler_threw\"> {\n return this.runHandler(this.inboundHandler, event);\n }\n}\n\n/**\n * Narrow abort detection. `DOMException.ABORT_ERR` is 20; the message check\n * covers runtimes that report the abort without the standard name or code.\n */\nfunction isAbortError(err: unknown): boolean {\n if (typeof err !== \"object\" || err === null) return false;\n const e = err as { name?: unknown; code?: unknown; message?: unknown };\n if (e.name === \"AbortError\") return true;\n if (e.code === 20) return true;\n return typeof e.message === \"string\" && /aborted/i.test(e.message);\n}\n\ninterface MatrixRestError {\n httpStatus?: number;\n errcode?: string;\n message?: string;\n name?: string;\n}\n\n/**\n * Did the homeserver judge the REQUEST malformed, as opposed to refusing the sender?\n *\n * Narrow by construction: a 400 with `M_BAD_JSON` or `M_INVALID_PARAM` is the server saying it\n * could not parse what it was given. A 401, 403 or 429 is about who is asking or how often,\n * and retrying those without markup would fail identically while reporting the wrong cause.\n */\nfunction isMalformedRequest(err: unknown): boolean {\n const e = err as MatrixRestError;\n if (e.httpStatus !== 400) return false;\n return e.errcode === \"M_BAD_JSON\" || e.errcode === \"M_INVALID_PARAM\";\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: error mapping ladder is exhaustive — each branch maps one Matrix errcode/HTTP status to one canonical code; splitting hurts traceability.\nfunction mapMatrixError(err: unknown): SendResult {\n const e = err as MatrixRestError;\n const status = e.httpStatus ?? 0;\n if (status === 429 || e.errcode === \"M_LIMIT_EXCEEDED\") {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Matrix rate limit\" } };\n }\n if (status === 401 || status === 403 || e.errcode === \"M_FORBIDDEN\") {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Matrix permission error\" },\n };\n }\n if (status === 404 || e.errcode === \"M_NOT_FOUND\") {\n return {\n ok: false,\n error: { code: \"not_found\", message: e.message ?? \"Matrix resource not found\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n"]}
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/alias.ts","../src/client.ts","../src/invite.ts","../src/room-state.ts","../src/normalize.ts","../src/refuse-attachments.ts","../src/replace-content.ts","../src/sync.ts","../src/adapter.ts"],"names":["GatewayConfigurationError","BasePlatformAdapter"],"mappings":";;;;;AAoBO,IAAM,kBAAA,GAAN,cAAiCA,iCAAA,CAA0B;AAAA,EAC9C,IAAA,GAAO,oBAAA;AAAA,EACzB,YAAY,IAAA,EAAiC;AAC3C,IAAA,KAAA,CAAM,kBAAkB,IAAI,CAAA;AAAA,EAC9B;AACF;AASO,IAAM,oBAAA,GAAN,cAAmC,kBAAA,CAAmB;AAAA,EAC3D,WAAA,GAAc;AACZ,IAAA,KAAA,CAAM;AAAA,MACJ,IAAA,EAAM,mBAAA;AAAA,MACN,OAAA,EACE,qFAAA;AAAA,MACF,MAAA,EAAQ;AAAA,KACT,CAAA;AAAA,EACH;AACF;AAQO,IAAM,kBAAA,GAAN,cAAiC,kBAAA,CAAmB;AAAA,EACzD,YAAY,MAAA,EAAgB;AAC1B,IAAA,KAAA,CAAM;AAAA,MACJ,IAAA,EAAM,4BAAA;AAAA,MACN,OAAA,EAAS,wBAAwB,MAAM,CAAA,gDAAA,CAAA;AAAA,MACvC,MAAA,EAAQ;AAAA,KACT,CAAA;AAAA,EACH;AACF;;;ACnCO,IAAM,aAAN,MAAiB;AAAA,EACL,KAAA,uBAAY,GAAA,EAAoB;AAAA;AAAA,EAGjD,MAAM,OAAA,CAAQ,MAAA,EAA6B,OAAA,EAAkC;AAC3E,IAAA,IAAI,OAAA,CAAQ,UAAA,CAAW,GAAG,CAAA,EAAG,OAAO,OAAA;AACpC,IAAA,IAAI,CAAC,OAAA,CAAQ,UAAA,CAAW,GAAG,CAAA,EAAG;AAC5B,MAAA,MAAM,IAAI,kBAAA,CAAmB;AAAA,QAC3B,IAAA,EAAM,kBAAA;AAAA,QACN,OAAA,EAAS,CAAA,uCAAA,EAA0C,IAAA,CAAK,SAAA,CAAU,OAAO,CAAC,CAAA,6CAAA;AAAA,OAC3E,CAAA;AAAA,IACH;AACA,IAAA,MAAM,MAAA,GAAS,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,OAAO,CAAA;AACrC,IAAA,IAAI,MAAA,KAAW,QAAW,OAAO,MAAA;AACjC,IAAA,MAAM,EAAE,OAAA,EAAQ,GAAI,MAAM,MAAA,CAAO,kBAAkB,OAAO,CAAA;AAC1D,IAAA,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,OAAA,EAAS,OAAO,CAAA;AAC/B,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA,EAGA,KAAA,GAAc;AACZ,IAAA,IAAA,CAAK,MAAM,KAAA,EAAM;AAAA,EACnB;AAAA,EAEA,IAAA,GAAe;AACb,IAAA,OAAO,KAAK,KAAA,CAAM,IAAA;AAAA,EACpB;AACF;;;ACDA,eAAsB,aAAA,GAA0C;AAC9D,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,GAAM,MAAM,OAAO,eAAe,CAAA;AACxC,IAAA,OAAO,GAAA;AAAA,EACT,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,oBAAA,EAAqB;AAAA,EACjC;AACF;;;AClBA,SAAS,KAAK,GAAA,EAAmB;AAC/B,EAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,iBAAA,EAAoB,GAAG;AAAA,CAAI,CAAA;AAClD;AAGA,eAAsB,YAAA,CACpB,MAAA,EACA,IAAA,EACA,OAAA,EACA,QACA,IAAA,EACe;AACf,EAAA,IAAI,IAAA,CAAK,GAAA,CAAI,MAAM,CAAA,EAAG;AACtB,EAAA,IAAA,CAAK,IAAI,MAAM,CAAA;AACf,EAAA,IAAI;AACF,IAAA,IAAI,CAAE,MAAM,IAAA,CAAK,YAAA,CAAa,OAAA,EAAS,MAAM,CAAA,EAAI;AACjD,IAAA,MAAM,MAAA,CAAO,SAAS,MAAM,CAAA;AAAA,EAC9B,SAAS,GAAA,EAAK;AAEZ,IAAA,IAAA,CAAK,OAAO,MAAM,CAAA;AAClB,IAAA,IAAA,CAAK,CAAA,QAAA,EAAW,MAAM,CAAA,SAAA,EAAY,GAAA,YAAe,KAAA,GAAQ,IAAI,OAAA,GAAU,MAAA,CAAO,GAAG,CAAC,CAAA,CAAE,CAAA;AAAA,EACtF;AACF;AAKO,SAAS,kBAAA,CAAmB,QAA0B,IAAA,EAA8B;AACzF,EAAA,MAAM,IAAA,uBAAW,GAAA,EAAY;AAC7B,EAAA,MAAM,GAAA,GAAM,CAAC,OAAA,EAAiB,MAAA,KAAyB;AACrD,IAAA,KAAK,YAAA,CAAa,QAAQ,IAAA,EAAM,OAAA,EAAS,QAAQ,IAAI,CAAA,CAAE,KAAA,CAAM,CAAC,GAAA,KAAiB;AAC7E,MAAA,IAAA,CAAK,CAAA,wBAAA,EAA2B,eAAe,KAAA,GAAQ,GAAA,CAAI,UAAU,MAAA,CAAO,GAAG,CAAC,CAAA,CAAE,CAAA;AAAA,IACpF,CAAC,CAAA;AAAA,EACH,CAAA;AACA,EAAA,MAAM,QAAA,GAAW,CAAC,KAAA,EAAwB,MAAA,KAAmC;AAC3E,IAAA,IAAI,OAAO,MAAA,KAAW,IAAA,CAAK,SAAA,IAAa,MAAA,CAAO,eAAe,QAAA,EAAU;AACxE,IAAA,GAAA,CAAI,KAAA,CAAM,SAAA,EAAU,IAAK,EAAA,EAAI,OAAO,MAAM,CAAA;AAAA,EAC5C,CAAA;AACA,EAAA,MAAM,cAAc,MAAY;AAC9B,IAAA,KAAA,MAAW,IAAA,IAAQ,MAAA,CAAO,QAAA,IAAW,IAAK,EAAC,EAAG;AAC5C,MAAA,IAAI,IAAA,CAAK,eAAA,IAAkB,KAAM,QAAA,EAAU;AAC3C,MAAA,MAAM,OAAA,GAAU,KAAK,SAAA,GAAY,IAAA,CAAK,SAAS,CAAA,EAAG,MAAA,EAAQ,MAAA,EAAQ,SAAA,EAAU,IAAK,EAAA;AACjF,MAAA,GAAA,CAAI,OAAA,EAAS,KAAK,MAAM,CAAA;AAAA,IAC1B;AAAA,EACF,CAAA;AAGA,EAAA,MAAA,CAAO,EAAA,CAAG,yBAAyB,QAAiB,CAAA;AACpD,EAAA,MAAA,CAAO,EAAA,CAAG,QAAQ,WAAoB,CAAA;AACtC,EAAA,WAAA,EAAY;AACZ,EAAA,OAAO,MAAM;AACX,IAAA,MAAA,CAAO,GAAA,CAAI,yBAAyB,QAAiB,CAAA;AACrD,IAAA,MAAA,CAAO,GAAA,CAAI,QAAQ,WAAoB,CAAA;AAAA,EACzC,CAAA;AACF;;;ACpFO,SAAS,kBAAkB,IAAA,EAAkD;AAClF,EAAA,IAAI,IAAA,KAAS,QAAW,OAAO,OAAA;AAC/B,EAAA,OAAO,IAAA,CAAK,oBAAA,EAAqB,KAAM,CAAA,GAAI,IAAA,GAAO,OAAA;AACpD;;;ACDO,SAAS,yBAAA,CACd,OACA,IAAA,EACgC;AAChC,EAAA,MAAM,OAAA,GAAU,MAAM,KAAA,EAAM;AAC5B,EAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,EAAA,IAAI,OAAA,KAAY,MAAA,IAAa,MAAA,KAAW,MAAA,EAAW,OAAO,MAAA;AAC1D,EAAA,MAAM,WAAA,GAAc,kBAAkB,IAAI,CAAA;AAC1C,EAAA,MAAM,OAAA,GAAU,MAAM,UAAA,EAAW;AACjC,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,EAAA;AAC7B,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,OAAA;AAAA,IACJ,QAAA,EAAU,QAAA;AAAA,IACV,MAAA,EAAQ,EAAE,EAAA,EAAI,MAAA,EAAO;AAAA,IACrB,OAAA,EAAS;AAAA,MACP,IAAI,IAAA,CAAK,MAAA;AAAA,MACT,IAAA,EAAM;AAAA,KACR;AAAA,IACA,IAAA,EAAM,IAAA;AAAA,IACN,UAAA,EAAY,MAAM,KAAA,EAAM;AAAA,IACxB,MAAA,EAAQ;AAAA,MACN,QAAQ,IAAA,CAAK,MAAA;AAAA,MACb,OAAA;AAAA,MACA,WAAA,EAAa,KAAK,oBAAA,EAAqB;AAAA,MACvC,GAAA,EAAK;AAAA;AACP,GACF;AACF;;;ACnBO,SAAS,kBAAkB,GAAA,EAA8C;AAC9E,EAAA,IAAI,IAAI,WAAA,IAAe,IAAA,IAAQ,IAAI,WAAA,CAAY,MAAA,KAAW,GAAG,OAAO,MAAA;AACpE,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,KAAA;AAAA,IACJ,KAAA,EAAO,EAAE,IAAA,EAAM,yBAAA,EAA2B,SAAS,wCAAA;AAAyC,GAC9F;AACF;;;ACRA,IAAM,WAAA,GAAc,wBAAA;AAGpB,SAAS,WAAA,CAAY,MAAc,IAAA,EAAwC;AACzE,EAAA,OAAO,IAAA,GACH,EAAE,OAAA,EAAS,QAAA,EAAU,MAAM,IAAA,EAAM,MAAA,EAAQ,WAAA,EAAa,cAAA,EAAgB,MAAK,GAC3E,EAAE,OAAA,EAAS,QAAA,EAAU,MAAM,IAAA,EAAK;AACtC;AAGO,SAAS,cAAA,CACd,iBACA,GAAA,EACyB;AACzB,EAAA,MAAM,IAAA,GAAO,IAAI,MAAA,KAAW,MAAA;AAC5B,EAAA,OAAO;AAAA,IACL,GAAG,WAAA,CAAY,CAAA,EAAA,EAAK,GAAA,CAAI,IAAI,IAAI,IAAI,CAAA;AAAA,IACpC,eAAA,EAAiB,WAAA,CAAY,GAAA,CAAI,IAAA,EAAM,IAAI,CAAA;AAAA,IAC3C,cAAA,EAAgB,EAAE,QAAA,EAAU,WAAA,EAAa,UAAU,eAAA;AAAgB,GACrE;AACF;;;ACVO,SAAS,wBACd,KAAA,EACA,IAAA,EACA,GAAA,GAAM,IAAA,CAAK,KAAI,EACN;AACT,EAAA,IAAI,KAAA,CAAM,OAAA,EAAQ,KAAM,gBAAA,EAAkB,OAAO,KAAA;AACjD,EAAA,MAAM,MAAA,GAAS,MAAM,SAAA,EAAU;AAC/B,EAAA,IAAI,MAAA,KAAW,IAAA,CAAK,SAAA,EAAW,OAAO,KAAA;AACtC,EAAA,IAAI,MAAM,KAAA,EAAM,GAAI,GAAA,GAAM,IAAA,CAAK,mBAAmB,OAAO,KAAA;AACzD,EAAA,OAAO,IAAA;AACT;AAyBO,SAAS,mBAAA,CACd,MAAA,EACA,OAAA,EACA,IAAA,EACsB;AACtB,EAAA,MAAM,OAAA,GAAU,CAAC,KAAA,EAAwB,IAAA,KAA+B;AACtE,IAAA,IAAI,CAAC,uBAAA,CAAwB,KAAA,EAAO,IAAI,CAAA,EAAG;AAC3C,IAAA,OAAA,CAAQ,OAAO,IAAI,CAAA;AAAA,EACrB,CAAA;AACA,EAAA,MAAA,CAAO,EAAA,CAAG,iBAAiB,OAAO,CAAA;AAClC,EAAA,OAAO;AAAA,IACL,WAAA,GAAoB;AAClB,MAAA,MAAA,CAAO,GAAA,CAAI,iBAAiB,OAAO,CAAA;AAAA,IACrC;AAAA,GACF;AACF;;;ACrDA,IAAM,oBAAA,GAAuB,GAAA;AAC7B,IAAM,kBAAA,GAAqB,EAAA;AAEpB,IAAM,aAAA,GAAN,cAA4BC,2BAAA,CAAoB;AAAA,EAC5C,QAAA,GAAW,QAAA;AAAA,EACH,IAAA;AAAA,EACT,MAAA;AAAA,EACA,YAAA;AAAA,EACA,kBAAA;AAAA,EACA,cAAA;AAAA,EACS,UAAA,GAAa,IAAI,UAAA,EAAW;AAAA,EACrC,SAAA,GAAY,KAAA;AAAA,EACH,eAAA,uBAAsB,GAAA,EAAY;AAAA;AAAA,EAE3C,WAAA,GAAc,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcd,iBAAA,GAA6C;AACnD,IAAA,MAAM,IAAA,GAAO,UAAA,CAAW,KAAA,CAAM,IAAA,CAAK,UAAU,CAAA;AAC7C,IAAA,OAAO,CAAC,OAAO,IAAA,KACb,IAAA,CAAK,OAAO,IAAI,CAAA,CAAE,KAAA,CAAM,CAAC,GAAA,KAAiB;AACxC,MAAA,IAAI,IAAA,CAAK,WAAA,IAAe,YAAA,CAAa,GAAG,CAAA,EAAG;AACzC,QAAA,OAAO,IAAI,QAAkB,MAAM;AAAA,QAEnC,CAAC,CAAA;AAAA,MACH;AACA,MAAA,MAAM,GAAA;AAAA,IACR,CAAC,CAAA;AAAA,EACL;AAAA,EAEA,YAAY,IAAA,EAA4B;AACtC,IAAA,KAAA,EAAM;AACN,IAAA,IAAI,IAAA,CAAK,aAAA,CAAc,MAAA,KAAW,CAAA,EAAG;AACnC,MAAA,MAAM,IAAI,kBAAA,CAAmB;AAAA,QAC3B,IAAA,EAAM,yBAAA;AAAA,QACN,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AACA,IAAA,IAAI,IAAA,CAAK,WAAA,CAAY,MAAA,KAAW,CAAA,EAAG;AACjC,MAAA,MAAM,IAAI,kBAAA,CAAmB;AAAA,QAC3B,IAAA,EAAM,uBAAA;AAAA,QACN,OAAA,EACE;AAAA,OACH,CAAA;AAAA,IACH;AACA,IAAA,IAAI,IAAA,CAAK,OAAO,MAAA,KAAW,CAAA,IAAK,CAAC,IAAA,CAAK,MAAA,CAAO,UAAA,CAAW,GAAG,CAAA,EAAG;AAC5D,MAAA,MAAM,IAAI,kBAAA,CAAmB;AAAA,QAC3B,IAAA,EAAM,kBAAA;AAAA,QACN,OAAA,EAAS;AAAA,OACV,CAAA;AAAA,IACH;AACA,IAAA,IAAA,CAAK,IAAA,GAAO,IAAA;AAAA,EACd;AAAA,EAEA,MAAM,OAAA,GAA4B;AAChC,IAAA,IAAI,IAAA,CAAK,WAAW,OAAO,IAAA;AAC3B,IAAA,IAAA,CAAK,WAAA,GAAc,KAAA;AACnB,IAAA,IAAI;AACF,MAAA,MAAM,GAAA,GAAM;AAAA,QACV,OAAA,EAAS,KAAK,IAAA,CAAK,aAAA;AAAA,QACnB,WAAA,EAAa,KAAK,IAAA,CAAK,WAAA;AAAA,QACvB,MAAA,EAAQ,KAAK,IAAA,CAAK,MAAA;AAAA,QAClB,OAAA,EAAS,KAAK,iBAAA;AAAkB,OAClC;AACA,MAAA,MAAM,OAAA,GAAU,KAAK,IAAA,CAAK,eAAA;AAC1B,MAAA,IAAA,CAAK,MAAA,GACH,OAAA,KAAY,KAAA,CAAA,GAAA,CACP,MAAM,aAAA,IAAiB,YAAA,CAAa,GAAG,CAAA,GACvC,OAAA,CAAQ,GAAG,CAAA;AAOlB,MAAA,MAAM,IAAA,CAAK,OAAO,MAAA,EAAO;AACzB,MAAA,MAAM,KAAK,MAAA,CAAO,WAAA,CAAY,EAAE,gBAAA,EAAkB,oBAAoB,CAAA;AACtE,MAAA,IAAA,CAAK,UAAA,EAAW;AAChB,MAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,MAAA,OAAO,IAAA;AAAA,IACT,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,MAAM,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAC3D,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,iCAAA,EAAoC,GAAG;AAAA,CAAI,CAAA;AAGhE,MAAA,MAAM,IAAA,GAAO,GAAA;AACb,MAAA,IACE,IAAA,EAAM,eAAe,GAAA,IACrB,IAAA,EAAM,eAAe,GAAA,IACrB,IAAA,EAAM,YAAY,iBAAA,EAClB;AACA,QAAA,OAAO,KAAA;AAAA,MACT;AACA,MAAA,MAAM,GAAA;AAAA,IACR;AAAA,EACF;AAAA,EAEA,MAAM,UAAA,GAA4B;AAChC,IAAA,IAAI,CAAC,KAAK,SAAA,EAAW;AAWrB,IAAA,IAAA,CAAK,WAAA,GAAc,IAAA;AACnB,IAAA,IAAA,CAAK,cAAc,WAAA,EAAY;AAC/B,IAAA,IAAA,CAAK,YAAA,GAAe,MAAA;AACpB,IAAA,IAAA,CAAK,kBAAA,IAAqB;AAC1B,IAAA,IAAA,CAAK,kBAAA,GAAqB,MAAA;AAC1B,IAAA,IAAA,CAAK,QAAQ,UAAA,EAAW;AACxB,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,SAAA,GAAY,KAAA;AACjB,IAAA,IAAA,CAAK,cAAA,GAAiB,MAAA;AACtB,IAAA,IAAA,CAAK,WAAW,KAAA,EAAM;AAAA,EACxB;AAAA,EAEA,MAAM,YAAY,GAAA,EAA2C;AAC3D,IAAA,OAAO,iBAAA,CAAkB,GAAG,CAAA,IAAK,IAAA,CAAK,SAAS,GAAG,CAAA;AAAA,EACpD;AAAA,EAEA,MAAc,SAAS,GAAA,EAA2C;AAChE,IAAA,IAAI,GAAA,CAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG;AACzB,MAAA,OAAO,EAAE,IAAI,KAAA,EAAO,KAAA,EAAO,EAAE,IAAA,EAAM,YAAA,EAAc,OAAA,EAAS,wBAAA,EAAyB,EAAE;AAAA,IACvF;AACA,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC7B,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,SAAS,oCAAA;AAAqC,OAChF;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,UAAA,CAAW,QAAQ,IAAA,CAAK,MAAA,EAAQ,GAAA,CAAI,OAAA,CAAQ,EAAE,CAAA;AACxE,MAAA,IAAI,IAAA,CAAK,WAAA,CAAY,MAAM,CAAA,EAAG;AAC5B,QAAA,IAAA,CAAK,kBAAkB,MAAM,CAAA;AAC7B,QAAA,OAAO;AAAA,UACL,EAAA,EAAI,KAAA;AAAA,UACJ,KAAA,EAAO;AAAA,YACL,IAAA,EAAM,4BAAA;AAAA,YACN,OAAA,EAAS,eAAe,MAAM,CAAA,oCAAA;AAAA;AAChC,SACF;AAAA,MACF;AACA,MAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,mBAAA,CAAoB,QAAQ,GAAG,CAAA;AACtD,MAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,SAAA,EAAW,IAAI,QAAA,EAAS;AAAA,IAC7C,SAAS,GAAA,EAAK;AACZ,MAAA,OAAO,eAAe,GAAG,CAAA;AAAA,IAC3B;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMkB,YAAA,GAAe,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYjC,MAAe,WAAA,CAAY,SAAA,EAAmB,GAAA,EAA2C;AACvF,IAAA,OAAO,kBAAkB,GAAG,CAAA,IAAK,IAAA,CAAK,QAAA,CAAS,WAAW,GAAG,CAAA;AAAA,EAC/D;AAAA,EAEA,MAAc,QAAA,CAAS,SAAA,EAAmB,GAAA,EAA2C;AACnF,IAAA,IAAI,GAAA,CAAI,IAAA,CAAK,MAAA,KAAW,CAAA,EAAG;AACzB,MAAA,OAAO,EAAE,IAAI,KAAA,EAAO,KAAA,EAAO,EAAE,IAAA,EAAM,YAAA,EAAc,OAAA,EAAS,wBAAA,EAAyB,EAAE;AAAA,IACvF;AACA,IAAA,MAAM,SAAS,IAAA,CAAK,MAAA;AACpB,IAAA,IAAI,WAAW,MAAA,EAAW;AACxB,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,SAAS,oCAAA;AAAqC,OAChF;AAAA,IACF;AACA,IAAA,IAAI,SAAA,CAAU,WAAW,CAAA,EAAG;AAC1B,MAAA,OAAO,EAAE,IAAI,KAAA,EAAO,KAAA,EAAO,EAAE,IAAA,EAAM,oBAAA,EAAsB,OAAA,EAAS,qBAAA,EAAsB,EAAE;AAAA,IAC5F;AACA,IAAA,IAAI,MAAA,CAAO,gBAAgB,MAAA,EAAW;AACpC,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO;AAAA,UACL,IAAA,EAAM,kBAAA;AAAA,UACN,OAAA,EAAS;AAAA;AACX,OACF;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,UAAA,CAAW,QAAQ,MAAA,EAAQ,GAAA,CAAI,QAAQ,EAAE,CAAA;AACnE,MAAA,IAAI,IAAA,CAAK,WAAA,CAAY,MAAM,CAAA,EAAG;AAC5B,QAAA,IAAA,CAAK,kBAAkB,MAAM,CAAA;AAC7B,QAAA,OAAO;AAAA,UACL,EAAA,EAAI,KAAA;AAAA,UACJ,KAAA,EAAO;AAAA,YACL,IAAA,EAAM,4BAAA;AAAA,YACN,OAAA,EAAS,eAAe,MAAM,CAAA,oCAAA;AAAA;AAChC,SACF;AAAA,MACF;AACA,MAAA,IAAA,CAAK,qBAAA,CAAsB,IAAI,MAAM,CAAA;AACrC,MAAA,MAAM,OAAO,WAAA,CAAY,MAAA,EAAQ,cAAA,CAAe,SAAA,EAAW,GAAG,CAAC,CAAA;AAAA,IACjE,SAAS,GAAA,EAAK;AACZ,MAAA,OAAO,eAAe,GAAG,CAAA;AAAA,IAC3B;AACA,IAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,SAAA,EAAU;AAAA,EAC/B;AAAA;AAAA,EAGA,MAAe,YAAY,SAAA,EAAkC;AAC3D,IAAA,MAAM,IAAA,CAAK,SAAA,CAAU,SAAA,EAAW,IAAI,CAAA;AAAA,EACtC;AAAA,EAEA,MAAe,WAAW,SAAA,EAAkC;AAC1D,IAAA,MAAM,IAAA,CAAK,SAAA,CAAU,SAAA,EAAW,KAAK,CAAA;AAAA,EACvC;AAAA,EAEA,MAAc,SAAA,CAAU,SAAA,EAAmB,MAAA,EAAgC;AACzE,IAAA,MAAM,SAAS,IAAA,CAAK,MAAA;AACpB,IAAA,IAAI,SAAA,CAAU,MAAA,KAAW,CAAA,IAAK,MAAA,EAAQ,eAAe,MAAA,EAAW;AAChE,IAAA,IAAI;AACF,MAAA,MAAM,SAAS,MAAM,IAAA,CAAK,UAAA,CAAW,OAAA,CAAQ,QAAQ,SAAS,CAAA;AAC9D,MAAA,MAAM,MAAA,CAAO,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,GAAM,CAAA;AAAA,IAChD,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,MAAe,KAAA,CAAM,SAAA,EAAmB,SAAA,EAAmB,KAAA,EAAoC;AAC7F,IAAA,IAAI,SAAA,CAAU,WAAW,CAAA,IAAK,SAAA,CAAU,WAAW,CAAA,IAAK,KAAA,CAAM,WAAW,CAAA,EAAG;AAC1E,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO,EAAE,IAAA,EAAM,kBAAA,EAAoB,SAAS,uCAAA;AAAwC,OACtF;AAAA,IACF;AACA,IAAA,MAAM,SAAS,IAAA,CAAK,MAAA;AACpB,IAAA,IAAI,WAAW,MAAA,EAAW;AACxB,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO,EAAE,IAAA,EAAM,eAAA,EAAiB,SAAS,oCAAA;AAAqC,OAChF;AAAA,IACF;AACA,IAAA,IAAI,MAAA,CAAO,cAAc,MAAA,EAAW;AAClC,MAAA,OAAO;AAAA,QACL,EAAA,EAAI,KAAA;AAAA,QACJ,KAAA,EAAO,EAAE,IAAA,EAAM,mBAAA,EAAqB,SAAS,gCAAA;AAAiC,OAChF;AAAA,IACF;AACA,IAAA,IAAI;AACF,MAAA,MAAM,SAAS,MAAM,IAAA,CAAK,UAAA,CAAW,OAAA,CAAQ,QAAQ,SAAS,CAAA;AAC9D,MAAA,MAAM,MAAA,CAAO,SAAA,CAAU,MAAA,EAAQ,YAAA,EAAc;AAAA,QAC3C,gBAAgB,EAAE,QAAA,EAAU,gBAAgB,QAAA,EAAU,SAAA,EAAW,KAAK,KAAA;AAAM,OAC7E,CAAA;AAAA,IACH,SAAS,GAAA,EAAK;AACZ,MAAA,OAAO,eAAe,GAAG,CAAA;AAAA,IAC3B;AACA,IAAA,OAAO,EAAE,EAAA,EAAI,IAAA,EAAM,SAAA,EAAU;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAyBA,MAAc,mBAAA,CACZ,MAAA,EACA,GAAA,EAC+B;AAC/B,IAAA,MAAM,SAAS,IAAA,CAAK,MAAA;AACpB,IAAA,IAAI,GAAA,CAAI,MAAA,KAAW,MAAA,IAAU,MAAA,CAAO,gBAAgB,MAAA,EAAW;AAC7D,MAAA,IAAA,CAAK,qBAAA,CAAsB,IAAI,MAAM,CAAA;AACrC,MAAA,OAAO,MAAM,MAAA,CAAO,eAAA,CAAgB,MAAA,EAAQ,IAAI,IAAI,CAAA;AAAA,IACtD;AACA,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,MAAA,CAAO,WAAA,CAAY,MAAA,EAAQ;AAAA,QACtC,OAAA,EAAS,QAAA;AAAA,QACT,MAAM,GAAA,CAAI,IAAA;AAAA,QACV,MAAA,EAAQ,wBAAA;AAAA,QACR,gBAAgB,GAAA,CAAI;AAAA,OACrB,CAAA;AAAA,IACH,SAAS,GAAA,EAAK;AAOZ,MAAA,IAAI,CAAC,kBAAA,CAAmB,GAAG,CAAA,EAAG,MAAM,GAAA;AACpC,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,QACb;AAAA,OACF;AACA,MAAA,OAAO,MAAM,MAAA,CAAO,eAAA,CAAgB,MAAA,EAAQ,IAAI,IAAI,CAAA;AAAA,IACtD;AAAA,EACF;AAAA;AAAA,EAGQ,iBAAA,GAAoB,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUpB,sBAAsB,MAAA,EAAyC;AACrE,IAAA,IAAI,MAAA,KAAW,MAAA,IAAa,MAAA,KAAW,OAAA,IAAW,WAAW,MAAA,EAAQ;AACrE,IAAA,IAAI,KAAK,iBAAA,EAAmB;AAC5B,IAAA,IAAA,CAAK,iBAAA,GAAoB,IAAA;AACzB,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb,4BAA4B,MAAM,CAAA;AAAA;AAAA,KAEpC;AAAA,EACF;AAAA,EAEA,UAAU,OAAA,EAAoE;AAE5E,IAAA,IAAA,CAAK,cAAA,GAAiB,OAAA;AACtB,IAAA,OAAO,MAAM;AACX,MAAA,IAAI,IAAA,CAAK,cAAA,KAAmB,OAAA,EAAS,IAAA,CAAK,cAAA,GAAiB,MAAA;AAAA,IAC7D,CAAA;AAAA,EACF;AAAA;AAAA,EAGA,SAAA,GAAyC;AACvC,IAAA,OAAO,IAAA,CAAK,MAAA;AAAA,EACd;AAAA;AAAA,EAGA,eAAe,MAAA,EAA+B;AAC5C,IAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AACd,IAAA,IAAA,CAAK,SAAA,GAAY,IAAA;AACjB,IAAA,IAAA,CAAK,UAAA,EAAW;AAAA,EAClB;AAAA,EAEQ,UAAA,GAAmB;AACzB,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAW;AAC/B,IAAA,MAAM,SAAS,IAAA,CAAK,MAAA;AACpB,IAAA,MAAM,IAAA,GAAO;AAAA,MACX,SAAA,EAAW,KAAK,IAAA,CAAK,MAAA;AAAA,MACrB,iBAAA,EAAmB,IAAA,CAAK,IAAA,CAAK,iBAAA,IAAqB;AAAA,KACpD;AACA,IAAA,MAAM,YAAA,GAAe,KAAK,IAAA,CAAK,YAAA;AAC/B,IAAA,IAAI,YAAA,KAAiB,MAAA,IAAa,MAAA,CAAO,QAAA,KAAa,MAAA,EAAW;AAC/D,MAAA,IAAA,CAAK,kBAAA,IAAqB;AAC1B,MAAA,IAAA,CAAK,kBAAA,GAAqB,kBAAA;AAAA,QACxB,MAAA;AAAA,QACA,EAAE,SAAA,EAAW,IAAA,CAAK,IAAA,CAAK,QAAQ,YAAA;AAAa,OAC9C;AAAA,IACF;AACA,IAAA,IAAA,CAAK,YAAA,GAAe,mBAAA;AAAA,MAClB,MAAA;AAAA,MACA,CAAC,IAAqB,IAAA,KAAyB;AAC7C,QAAA,KAAK,KAAK,qBAAA,CAAsB,EAAA,EAAI,IAAI,CAAA,CAAE,KAAA,CAAM,CAAC,GAAA,KAAiB;AAChE,UAAA,MAAM,IAAI,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AACzD,UAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,+CAAA,EAAkD,CAAC;AAAA,CAAI,CAAA;AAAA,QAC9E,CAAC,CAAA;AAAA,MACH,CAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAAA,EAEA,MAAc,qBAAA,CAAsB,KAAA,EAAwB,IAAA,EAAqC;AAC/F,IAAA,IAAI,IAAA,CAAK,WAAA,CAAY,IAAA,CAAK,MAAM,CAAA,EAAG;AACjC,MAAA,IAAA,CAAK,iBAAA,CAAkB,KAAK,MAAM,CAAA;AAClC,MAAA;AAAA,IACF;AACA,IAAA,MAAM,UAAA,GAAa,yBAAA,CAA0B,KAAA,EAAO,IAAI,CAAA;AACxD,IAAA,IAAI,eAAe,MAAA,EAAW;AAC9B,IAAA,IAAI,CAAC,IAAA,CAAK,iBAAA,CAAkB,UAAU,CAAA,EAAG;AACzC,IAAA,IAAI,IAAA,CAAK,mBAAmB,MAAA,EAAW;AACvC,IAAA,IAAI;AACF,MAAA,MAAM,IAAA,CAAK,eAAe,UAAU,CAAA;AAAA,IACtC,SAAS,GAAA,EAAK;AACZ,MAAA,MAAM,IAAI,GAAA,YAAe,KAAA,GAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AACzD,MAAA,OAAA,CAAQ,MAAA,CAAO,KAAA,CAAM,CAAA,gCAAA,EAAmC,CAAC;AAAA,CAAI,CAAA;AAAA,IAC/D;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOQ,kBAAkB,KAAA,EAAqC;AAC7D,IAAA,IAAI,KAAA,CAAM,QAAQ,IAAA,KAAS,IAAA,IAAQ,EAAE,IAAA,CAAK,IAAA,CAAK,cAAA,IAAkB,IAAA,CAAA,EAAO,OAAO,IAAA;AAC/E,IAAA,MAAM,KAAA,GAAQ,KAAK,IAAA,CAAK,MAAA;AACxB,IAAA,MAAM,MAAM,KAAA,CAAM,QAAA,KAAa,QAAA,GAAW,KAAA,CAAM,OAAO,GAAA,GAAM,MAAA;AAC7D,IAAA,MAAM,OAAA,GAAW,KAA8C,UAAA,IAAa;AAC5E,IAAA,IAAI,YAAY,MAAA,EAAW,OAAO,KAAA,CAAM,IAAA,CAAK,SAAS,KAAK,CAAA;AAC3D,IAAA,MAAM,QAAA,GAAW,QAAQ,YAAY,CAAA;AACrC,IAAA,IAAI,aAAa,MAAA,EAAW,OAAO,SAAS,QAAA,EAAU,QAAA,CAAS,KAAK,CAAA,IAAK,KAAA;AACzE,IAAA,OAAA,CAAQ,OAAA,CAAQ,IAAA,IAAQ,EAAA,EAAI,QAAA,CAAS,KAAK,MAAM,OAAA,CAAQ,cAAA,IAAkB,EAAA,EAAI,QAAA,CAAS,KAAK,CAAA;AAAA,EAC9F;AAAA,EAEQ,YAAY,MAAA,EAAyB;AAC3C,IAAA,IAAI,IAAA,CAAK,MAAA,KAAW,MAAA,EAAW,OAAO,KAAA;AACtC,IAAA,IAAI,IAAA,CAAK,MAAA,CAAO,eAAA,KAAoB,MAAA,EAAW,OAAO,KAAA;AACtD,IAAA,IAAI;AACF,MAAA,OAAO,IAAA,CAAK,MAAA,CAAO,eAAA,CAAgB,MAAM,CAAA;AAAA,IAC3C,CAAA,CAAA,MAAQ;AACN,MAAA,OAAO,KAAA;AAAA,IACT;AAAA,EACF;AAAA,EAEQ,kBAAkB,MAAA,EAAsB;AAC9C,IAAA,IAAI,IAAA,CAAK,eAAA,CAAgB,GAAA,CAAI,MAAM,CAAA,EAAG;AACtC,IAAA,IAAA,CAAK,eAAA,CAAgB,IAAI,MAAM,CAAA;AAC/B,IAAA,OAAA,CAAQ,MAAA,CAAO,KAAA;AAAA,MACb,yBAAyB,MAAM,CAAA;AAAA;AAAA,KACjC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAe,QACb,KAAA,EACgD;AAChD,IAAA,IAAI,CAAC,IAAA,CAAK,iBAAA,CAAkB,KAAK,GAAG,OAAO,IAAA;AAC3C,IAAA,OAAO,IAAA,CAAK,UAAA,CAAW,IAAA,CAAK,cAAA,EAAgB,KAAK,CAAA;AAAA,EACnD;AACF;AAMA,SAAS,aAAa,GAAA,EAAuB;AAC3C,EAAA,IAAI,OAAO,GAAA,KAAQ,QAAA,IAAY,GAAA,KAAQ,MAAM,OAAO,KAAA;AACpD,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,IAAI,CAAA,CAAE,IAAA,KAAS,YAAA,EAAc,OAAO,IAAA;AACpC,EAAA,IAAI,CAAA,CAAE,IAAA,KAAS,EAAA,EAAI,OAAO,IAAA;AAC1B,EAAA,OAAO,OAAO,CAAA,CAAE,OAAA,KAAY,YAAY,UAAA,CAAW,IAAA,CAAK,EAAE,OAAO,CAAA;AACnE;AAgBA,SAAS,mBAAmB,GAAA,EAAuB;AACjD,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,IAAI,CAAA,CAAE,UAAA,KAAe,GAAA,EAAK,OAAO,KAAA;AACjC,EAAA,OAAO,CAAA,CAAE,OAAA,KAAY,YAAA,IAAgB,CAAA,CAAE,OAAA,KAAY,iBAAA;AACrD;AAGA,SAAS,eAAe,GAAA,EAA0B;AAChD,EAAA,MAAM,CAAA,GAAI,GAAA;AACV,EAAA,MAAM,MAAA,GAAS,EAAE,UAAA,IAAc,CAAA;AAC/B,EAAA,IAAI,MAAA,KAAW,GAAA,IAAO,CAAA,CAAE,OAAA,KAAY,kBAAA,EAAoB;AACtD,IAAA,OAAO,EAAE,EAAA,EAAI,KAAA,EAAO,KAAA,EAAO,EAAE,IAAA,EAAM,YAAA,EAAc,OAAA,EAAS,CAAA,CAAE,OAAA,IAAW,mBAAA,EAAoB,EAAE;AAAA,EAC/F;AACA,EAAA,IAAI,WAAW,GAAA,IAAO,MAAA,KAAW,GAAA,IAAO,CAAA,CAAE,YAAY,aAAA,EAAe;AACnE,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,KAAA;AAAA,MACJ,OAAO,EAAE,IAAA,EAAM,qBAAqB,OAAA,EAAS,CAAA,CAAE,WAAW,yBAAA;AAA0B,KACtF;AAAA,EACF;AACA,EAAA,IAAI,MAAA,KAAW,GAAA,IAAO,CAAA,CAAE,OAAA,KAAY,aAAA,EAAe;AACjD,IAAA,OAAO;AAAA,MACL,EAAA,EAAI,KAAA;AAAA,MACJ,OAAO,EAAE,IAAA,EAAM,aAAa,OAAA,EAAS,CAAA,CAAE,WAAW,2BAAA;AAA4B,KAChF;AAAA,EACF;AACA,EAAA,OAAO;AAAA,IACL,EAAA,EAAI,KAAA;AAAA,IACJ,KAAA,EAAO;AAAA,MACL,IAAA,EAAM,aAAA;AAAA,MACN,OAAA,EAAS,EAAE,OAAA,KAAY,GAAA,YAAe,QAAQ,GAAA,CAAI,OAAA,GAAU,OAAO,GAAG,CAAA;AAAA;AACxE,GACF;AACF","file":"index.cjs","sourcesContent":["/**\n * Typed errors for `@theokit/gateway-matrix`.\n *\n * `ConfigurationError` extends the shared core `GatewayConfigurationError`\n * base (roadmap M2). Behavior byte-identical (pinned by `tests/errors.test.ts`).\n */\n\nimport { GatewayConfigurationError, type GatewayConfigurationErrorOptions } from \"@theokit/gateway\";\n\n/** @knipignore — public input shape for `ConfigurationError` constructor (caller-extensible). */\nexport type ConfigurationErrorOptions = GatewayConfigurationErrorOptions;\n\n/**\n * Misconfiguration of this adapter, raised before any network call.\n *\n * Extends the shared core base so every gateway package reports configuration faults in one shape:\n * a structured `code` the caller can branch on, tagged with `\"gateway-matrix\"` as the origin. A\n * missing credential or an unsupported option is a programmer error, not a transient failure —\n * these are never retried.\n */\nexport class ConfigurationError extends GatewayConfigurationError {\n override readonly name = \"ConfigurationError\";\n constructor(opts: ConfigurationErrorOptions) {\n super(\"gateway-matrix\", opts);\n }\n}\n\n/**\n * The platform SDK this adapter needs is declared as a peer dependency and is not installed.\n *\n * Raised at connect time rather than at import, so a project that installs several gateway packages\n * only pays for the SDKs of the ones it actually starts. The message names the exact package and\n * the command that installs it.\n */\nexport class SDKNotInstalledError extends ConfigurationError {\n constructor() {\n super({\n code: \"sdk_not_installed\",\n message:\n 'gateway-matrix: peer-dep \"matrix-js-sdk\" not installed. Run: pnpm add matrix-js-sdk',\n detail: \"matrix-js-sdk\",\n });\n }\n}\n\n/**\n * The room is end-to-end encrypted, which this adapter cannot read.\n *\n * E2EE is deferred to v0.2. Raised rather than silently ignoring the room, because a bot that\n * appears connected and never sees a message is far harder to diagnose than one that says why.\n */\nexport class EncryptedRoomError extends ConfigurationError {\n constructor(roomId: string) {\n super({\n code: \"encrypted_room_unsupported\",\n message: `gateway-matrix: room ${roomId} is end-to-end encrypted (E2EE deferred to v0.2)`,\n detail: roomId,\n });\n }\n}\n","/**\n * Matrix alias resolution + caching (D419).\n *\n * Accepts:\n * - Room id (`!abc123:server`) — pass-through.\n * - Alias (`#general:server`) — resolved via `client.getRoomIdForAlias`.\n *\n * Other shapes throw `ConfigurationError({ code: \"invalid_room_ref\" })`.\n */\n\nimport { ConfigurationError } from \"./errors.js\";\n\n/** @knipignore — minimal Client interface `AliasCache.resolve` accepts; useful for callers building their own resolver. */\nexport interface AliasResolverClient {\n getRoomIdForAlias(alias: string): Promise<{ room_id: string }>;\n}\n\n/**\n * Resolves a Matrix room alias (`#room:server`) to its room id, remembering the answer.\n *\n * An alias resolves through a server round-trip, and the mapping effectively never changes, so\n * repeating it once per outbound message is pure latency. A value that is already a room id is\n * returned untouched, which lets callers pass either form.\n */\nexport class AliasCache {\n private readonly cache = new Map<string, string>();\n\n /** Returns the room id; resolves aliases via the client + caches. */\n async resolve(client: AliasResolverClient, refOrId: string): Promise<string> {\n if (refOrId.startsWith(\"!\")) return refOrId;\n if (!refOrId.startsWith(\"#\")) {\n throw new ConfigurationError({\n code: \"invalid_room_ref\",\n message: `gateway-matrix: invalid room reference ${JSON.stringify(refOrId)} — expected '!' (room id) or '#' (alias)`,\n });\n }\n const cached = this.cache.get(refOrId);\n if (cached !== undefined) return cached;\n const { room_id } = await client.getRoomIdForAlias(refOrId);\n this.cache.set(refOrId, room_id);\n return room_id;\n }\n\n /** Drop all cached resolutions. Useful for tests + admin-rename recovery. */\n clear(): void {\n this.cache.clear();\n }\n\n size(): number {\n return this.cache.size;\n }\n}\n","/**\n * Lazy `matrix-js-sdk` loader.\n */\n\nimport { SDKNotInstalledError } from \"./errors.js\";\nimport type { MatrixClientLike } from \"./sync.js\";\nimport type { MatrixRoomLike } from \"./types.js\";\n\nexport interface MatrixSdkClient extends MatrixClientLike {\n startClient(opts: { initialSyncLimit: number }): Promise<void>;\n stopClient(): void;\n sendTextMessage(roomId: string, text: string): Promise<{ event_id: string }>;\n /**\n * Send a message whose content object the caller composes.\n *\n * `sendTextMessage` is a convenience that hard-codes `msgtype: m.text` and a bare `body`, so\n * it has nowhere to put `formatted_body` — the field Matrix documents for markup. Honouring\n * `OutboundMessage.format` therefore needs the general call, not a new argument on the\n * convenience one.\n */\n sendMessage?(roomId: string, content: Record<string, unknown>): Promise<{ event_id: string }>;\n /** Send a room event of `eventType` (used for `m.reaction`). */\n sendEvent?(\n roomId: string,\n eventType: string,\n content: Record<string, unknown>,\n ): Promise<{ event_id: string }>;\n /** `PUT /rooms/{roomId}/typing/{userId}`; present on matrix-js-sdk's client. */\n sendTyping?(roomId: string, isTyping: boolean, timeoutMs: number): Promise<unknown>;\n getRoomIdForAlias(alias: string): Promise<{ room_id: string }>;\n /** Join a room (used to accept an invite). */\n joinRoom?(roomId: string): Promise<unknown>;\n getRooms?(): import(\"./invite.js\").InviteRoomLike[];\n getRoom(roomId: string): MatrixRoomLike | null;\n isRoomEncrypted?(roomId: string): boolean;\n /** Best-effort current user id; matrix-js-sdk returns `string | null`. */\n getUserId(): string | null;\n /**\n * `/_matrix/client/v3/account/whoami` — the cheapest call that makes the\n * server judge the access token. `startClient` does not: it begins syncing\n * asynchronously and resolves regardless, so without this an invalid token\n * produces a connected-looking adapter that never receives anything.\n */\n whoami(): Promise<{ user_id: string }>;\n}\n\ninterface MatrixSdkModule {\n createClient(opts: { baseUrl: string; accessToken: string; userId: string }): MatrixSdkClient;\n}\n\nexport async function loadMatrixSdk(): Promise<MatrixSdkModule> {\n try {\n const mod = await import(\"matrix-js-sdk\");\n return mod as unknown as MatrixSdkModule;\n } catch {\n throw new SDKNotInstalledError();\n }\n}\n","/**\n * Auto-join for room invites.\n *\n * Matrix delivers an invite as the bot's own `m.room.member` event with `membership: invite`.\n * `matrix-js-sdk` surfaces it as `RoomMember.membership` (live) and leaves invited rooms in\n * `getRooms()` with `getMyMembership() === \"invite\"` (the ones pending at start). Both paths end\n * in {@link handleInvite}, which asks the host's `acceptInvite` and joins only on `true`.\n */\n\nexport interface InviteMemberLike {\n readonly userId: string;\n readonly roomId: string;\n readonly membership?: string;\n}\n\nexport interface InviteEventLike {\n getSender(): string | undefined;\n}\n\nexport interface InviteRoomLike {\n readonly roomId: string;\n getMyMembership?(): string;\n /** The inviter is the sender of the bot's own member event. */\n getMember?(userId: string): { events?: { member?: InviteEventLike } } | null;\n}\n\n/** The slice of the SDK client the invite path uses. */\nexport interface InviteClientLike {\n on(event: string, listener: (...args: never[]) => void): void;\n off(event: string, listener: (...args: never[]) => void): void;\n joinRoom(roomId: string): Promise<unknown>;\n getRooms?(): InviteRoomLike[];\n}\n\nexport interface InviteOpts {\n readonly botUserId: string;\n readonly acceptInvite: (inviter: string, roomId: string) => boolean | Promise<boolean>;\n}\n\nfunction warn(msg: string): void {\n process.stderr.write(`[gateway-matrix] ${msg}\\n`);\n}\n\n/** Join `roomId` when the host accepts `inviter`; a refusal or a failure leaves the invite pending. */\nexport async function handleInvite(\n client: InviteClientLike,\n opts: InviteOpts,\n inviter: string,\n roomId: string,\n seen: Set<string>,\n): Promise<void> {\n if (seen.has(roomId)) return;\n seen.add(roomId);\n try {\n if (!(await opts.acceptInvite(inviter, roomId))) return;\n await client.joinRoom(roomId);\n } catch (err) {\n // Forget it so a later sync can retry.\n seen.delete(roomId);\n warn(`join of ${roomId} failed: ${err instanceof Error ? err.message : String(err)}`);\n }\n}\n\n/**\n * Watch for invites to the bot: live ones and those already pending. Returns the detach function.\n */\nexport function subscribeToInvites(client: InviteClientLike, opts: InviteOpts): () => void {\n const seen = new Set<string>();\n const run = (inviter: string, roomId: string): void => {\n void handleInvite(client, opts, inviter, roomId, seen).catch((err: unknown) => {\n warn(`invite handling failed: ${err instanceof Error ? err.message : String(err)}`);\n });\n };\n const onMember = (event: InviteEventLike, member: InviteMemberLike): void => {\n if (member.userId !== opts.botUserId || member.membership !== \"invite\") return;\n run(event.getSender() ?? \"\", member.roomId);\n };\n const scanPending = (): void => {\n for (const room of client.getRooms?.() ?? []) {\n if (room.getMyMembership?.() !== \"invite\") continue;\n const inviter = room.getMember?.(opts.botUserId)?.events?.member?.getSender() ?? \"\";\n run(inviter, room.roomId);\n }\n };\n // `sync` fires on every sync state change, so invites pending at start are caught once the\n // first sync has produced the room list.\n client.on(\"RoomMember.membership\", onMember as never);\n client.on(\"sync\", scanPending as never);\n scanPending();\n return () => {\n client.off(\"RoomMember.membership\", onMember as never);\n client.off(\"sync\", scanPending as never);\n };\n}\n","/**\n * Room state helpers (D416).\n *\n * Matrix has no native \"DM\" concept — DMs are rooms with 2 members.\n * The canonical heuristic: `member_count === 2 → \"dm\"`, else `\"group\"`.\n */\n\nimport type { MatrixRoomLike } from \"./types.js\";\n\nexport function detectChannelType(room: MatrixRoomLike | undefined): \"dm\" | \"group\" {\n if (room === undefined) return \"group\";\n return room.getJoinedMemberCount() === 2 ? \"dm\" : \"group\";\n}\n","/**\n * Inbound normalization: MatrixEvent + Room → MatrixMessageEvent.\n *\n * @public\n */\n\nimport type { MatrixMessageEvent } from \"@theokit/gateway\";\n\nimport { detectChannelType } from \"./room-state.js\";\nimport type { MatrixEventLike, MatrixRoomLike } from \"./types.js\";\n\nexport function matrixEventToMessageEvent(\n event: MatrixEventLike,\n room: MatrixRoomLike,\n): MatrixMessageEvent | undefined {\n const eventId = event.getId();\n const sender = event.getSender();\n if (eventId === undefined || sender === undefined) return undefined;\n const channelType = detectChannelType(room);\n const content = event.getContent();\n const body = content.body ?? \"\";\n return {\n id: eventId,\n platform: \"matrix\",\n sender: { id: sender },\n channel: {\n id: room.roomId,\n type: channelType,\n },\n text: body,\n receivedAt: event.getTs(),\n matrix: {\n roomId: room.roomId,\n eventId,\n memberCount: room.getJoinedMemberCount(),\n raw: event,\n },\n };\n}\n","/**\n * The refusal this adapter answers for an outbound that carries attachments (B-674).\n *\n * This adapter sends text only, so an outbound carrying attachments is refused rather than sent without its images.\n *\n * The check runs before any other, so a refusal makes no platform call. It lives in this package\n * rather than in `@theokit/gateway` so that the adapter calls nothing its declared core floor\n * lacks; only the `OutboundMessage` type is imported.\n */\n\nimport type { OutboundMessage, SendResult } from \"@theokit/gateway\";\n\n/**\n * `attachments_unsupported` when `out` carries attachments, otherwise `undefined`.\n *\n * Absent, `null` and an empty list carry nothing. `!== 0`, not `> 0`: any other non-array value\n * from a JavaScript caller has no numeric length and is refused rather than taken for an empty\n * list (EC-1).\n */\nexport function refuseAttachments(out: OutboundMessage): SendResult | undefined {\n if (out.attachments == null || out.attachments.length === 0) return undefined;\n return {\n ok: false,\n error: { code: \"attachments_unsupported\", message: \"matrix adapter cannot send attachments\" },\n };\n}\n","/**\n * The content of a Matrix `m.replace` event — how an edit is expressed on Matrix.\n *\n * Matrix has no call that changes an event. An edit is a NEW event whose `m.relates_to` names the\n * original with `rel_type: \"m.replace\"` and whose `m.new_content` holds the replacement; clients\n * that understand replacements render `m.new_content` over the original, and the rest show the\n * outer `body`, which carries the conventional `* ` prefix (Matrix Client-Server API v1.12,\n * § Event replacements).\n *\n * `formatted_body` follows the rule `sendMessage` follows: only `format: \"html\"` may declare\n * `org.matrix.custom.html`, because the declaration promises every client the field IS HTML.\n *\n * @internal\n */\n\nimport type { OutboundMessage } from \"@theokit/gateway\";\n\nconst HTML_FORMAT = \"org.matrix.custom.html\";\n\n/** The `m.text` content for `text`, with `formatted_body` only when the caller declared html. */\nfunction textContent(text: string, html: boolean): Record<string, unknown> {\n return html\n ? { msgtype: \"m.text\", body: text, format: HTML_FORMAT, formatted_body: text }\n : { msgtype: \"m.text\", body: text };\n}\n\n/** Build the content of an event that replaces `originalEventId` with `out.text`. */\nexport function replaceContent(\n originalEventId: string,\n out: OutboundMessage,\n): Record<string, unknown> {\n const html = out.format === \"html\";\n return {\n ...textContent(`* ${out.text}`, html),\n \"m.new_content\": textContent(out.text, html),\n \"m.relates_to\": { rel_type: \"m.replace\", event_id: originalEventId },\n };\n}\n","/**\n * Sync timeline filter (D415, EC-3 absorbed).\n *\n * Wraps `client.on(\"Room.timeline\", listener)` with 3 filters:\n *\n * 1. Drop non-`m.room.message` events (D413).\n * 2. Drop bot's own messages (loop guard, D275 mirror).\n * 3. **EC-3**: drop events older than `freshnessWindowMs` (default 60s)\n * — initial sync from `matrix-js-sdk` delivers ~10 historical events\n * per joined room, which would otherwise trigger an LLM-call storm.\n */\n\nimport type { MatrixEventLike, MatrixRoomLike } from \"./types.js\";\n\nexport interface SyncFilterOpts {\n readonly botUserId: string;\n readonly freshnessWindowMs: number;\n}\n\n/**\n * Decide whether a timeline event should reach the handler.\n *\n * Matrix replays room history on sync, so a freshly started bot would otherwise answer every message\n * it can still see — which is a reply storm in a busy room and an infinite loop in a quiet one. This\n * drops the bot's own events and anything older than the freshness window. `now` is injectable so\n * the decision is testable without waiting.\n */\nexport function shouldDispatchSyncEvent(\n event: MatrixEventLike,\n opts: SyncFilterOpts,\n now = Date.now(),\n): boolean {\n if (event.getType() !== \"m.room.message\") return false;\n const sender = event.getSender();\n if (sender === opts.botUserId) return false;\n if (event.getTs() < now - opts.freshnessWindowMs) return false;\n return true;\n}\n\n/** A live timeline listener, with the handle that detaches it again. */\nexport interface TimelineSubscription {\n unsubscribe(): void;\n}\n\n/**\n * The slice of `matrix-js-sdk`'s client this adapter actually uses.\n *\n * Narrow on purpose: it is what lets the sync logic be tested against a few lines of fake rather\n * than a running homeserver, and it states the real coupling to the SDK — two event methods.\n */\nexport interface MatrixClientLike {\n on(event: \"Room.timeline\", listener: (e: MatrixEventLike, r: MatrixRoomLike) => void): void;\n off(event: \"Room.timeline\", listener: (e: MatrixEventLike, r: MatrixRoomLike) => void): void;\n}\n\n/**\n * Attach `handler` to the client's room timeline, filtered by {@link shouldDispatchSyncEvent}.\n *\n * Returns the subscription rather than leaving the listener attached forever: an adapter that\n * reconnects without detaching accumulates listeners, and every inbound message is then handled\n * once per reconnect.\n */\nexport function subscribeToTimeline(\n client: MatrixClientLike,\n handler: (event: MatrixEventLike, room: MatrixRoomLike) => void,\n opts: SyncFilterOpts,\n): TimelineSubscription {\n const wrapped = (event: MatrixEventLike, room: MatrixRoomLike): void => {\n if (!shouldDispatchSyncEvent(event, opts)) return;\n handler(event, room);\n };\n client.on(\"Room.timeline\", wrapped);\n return {\n unsubscribe(): void {\n client.off(\"Room.timeline\", wrapped);\n },\n };\n}\n","/**\n * `MatrixAdapter` — implements BasePlatformAdapter over matrix-js-sdk.\n * ADRs D413-D421.\n *\n * @public\n */\n\nimport {\n BasePlatformAdapter,\n type MessageEvent as GatewayMessageEvent,\n type OutboundMessage,\n type SendResult,\n} from \"@theokit/gateway\";\n\nimport { AliasCache } from \"./alias.js\";\nimport { loadMatrixSdk, type MatrixSdkClient } from \"./client.js\";\nimport { ConfigurationError } from \"./errors.js\";\nimport { subscribeToInvites } from \"./invite.js\";\nimport { matrixEventToMessageEvent } from \"./normalize.js\";\nimport { refuseAttachments } from \"./refuse-attachments.js\";\nimport { replaceContent } from \"./replace-content.js\";\nimport { subscribeToTimeline, type TimelineSubscription } from \"./sync.js\";\nimport type { MatrixAdapterOptions, MatrixEventLike, MatrixRoomLike } from \"./types.js\";\n\nconst DEFAULT_FRESHNESS_MS = 60_000;\nconst INITIAL_SYNC_LIMIT = 10;\n\nexport class MatrixAdapter extends BasePlatformAdapter {\n readonly platform = \"matrix\" as const;\n private readonly opts: MatrixAdapterOptions;\n private client: MatrixSdkClient | undefined;\n private subscription: TimelineSubscription | undefined;\n private unsubscribeInvites: (() => void) | undefined;\n private inboundHandler: ((event: GatewayMessageEvent) => Promise<void>) | undefined;\n private readonly aliasCache = new AliasCache();\n private connected = false;\n private readonly warnedEncrypted = new Set<string>();\n /** True only between disconnect() and the next connect() — see #12. */\n private tearingDown = false;\n\n /**\n * `fetch` for the SDK that leaves teardown aborts unsettled instead of\n * rejecting (#12).\n *\n * A request aborted while we are tearing the client down has no consumer left\n * that could act on the outcome, so an unsettled promise costs a continuation\n * and nothing else; the alternative is a rejection with no handler anywhere,\n * which ends the host process. It is scoped to the teardown window on purpose:\n * a consumer using the `getClient()` escape hatch (D421) may pass its own\n * abort signal to `search()` or `slidingSync()` and MUST still see those\n * rejections, so outside teardown every error propagates untouched.\n */\n private teardownSafeFetch(): typeof globalThis.fetch {\n const base = globalThis.fetch.bind(globalThis);\n return (input, init) =>\n base(input, init).catch((err: unknown) => {\n if (this.tearingDown && isAbortError(err)) {\n return new Promise<Response>(() => {\n /* deliberately never settles — see the doc comment */\n });\n }\n throw err;\n });\n }\n\n constructor(opts: MatrixAdapterOptions) {\n super();\n if (opts.homeserverUrl.length === 0) {\n throw new ConfigurationError({\n code: \"homeserver_url_required\",\n message: 'gateway-matrix: opts.homeserverUrl is empty (e.g. \"https://matrix.org\")',\n });\n }\n if (opts.accessToken.length === 0) {\n throw new ConfigurationError({\n code: \"access_token_required\",\n message:\n \"gateway-matrix: opts.accessToken is empty (Element → Settings → Help & About → Advanced → Access Token)\",\n });\n }\n if (opts.userId.length === 0 || !opts.userId.startsWith(\"@\")) {\n throw new ConfigurationError({\n code: \"user_id_required\",\n message: 'gateway-matrix: opts.userId must be a Matrix user id (e.g. \"@bot:matrix.org\")',\n });\n }\n this.opts = opts;\n }\n\n async connect(): Promise<boolean> {\n if (this.connected) return true;\n this.tearingDown = false;\n try {\n const cfg = {\n baseUrl: this.opts.homeserverUrl,\n accessToken: this.opts.accessToken,\n userId: this.opts.userId,\n fetchFn: this.teardownSafeFetch(),\n };\n const factory = this.opts.__clientFactory;\n this.client =\n factory === undefined\n ? (await loadMatrixSdk()).createClient(cfg)\n : (factory(cfg) as MatrixSdkClient);\n // Validate the credential BEFORE reporting success. `startClient` kicks\n // off the sync loop asynchronously and resolves whether or not the token\n // is any good — so connect() used to answer `true` for a token the server\n // rejects, leaving an operator with a healthy-looking adapter and total\n // silence. Every sibling adapter returns false here; this one did not,\n // and only a real homeserver could show it.\n await this.client.whoami();\n await this.client.startClient({ initialSyncLimit: INITIAL_SYNC_LIMIT });\n this.attachSync();\n this.connected = true;\n return true;\n } catch (err) {\n const msg = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-matrix] connect failed: ${msg}\\n`);\n // A credential refusal is final: `false` tells the runner not to retry. Anything else (the\n // homeserver is down, DNS, 5xx) is thrown so a runner with a reconnect policy retries it.\n const rest = err as MatrixRestError | null;\n if (\n rest?.httpStatus === 401 ||\n rest?.httpStatus === 403 ||\n rest?.errcode === \"M_UNKNOWN_TOKEN\"\n ) {\n return false;\n }\n throw err;\n }\n }\n\n async disconnect(): Promise<void> {\n if (!this.connected) return;\n // Issue #12. `stopClient()` aborts the requests still in flight, and the\n // AbortError escapes as an UNHANDLED rejection — the rejecting promise is\n // the SDK's own `authedRequest` wrapper, which no caller catches and which\n // we cannot reach. Node has terminated on unhandled rejections by default\n // since v15, so an application calling disconnect() inside a reconnect loop\n // could be killed by its own clean shutdown. Measured against a real\n // homeserver: 7 occurrences in 8 connect/disconnect cycles.\n //\n // `teardownSafeFetch` closes it at the only seam the SDK offers. The flag is\n // set here, before the abort, and cleared by the next connect().\n this.tearingDown = true;\n this.subscription?.unsubscribe();\n this.subscription = undefined;\n this.unsubscribeInvites?.();\n this.unsubscribeInvites = undefined;\n this.client?.stopClient();\n this.client = undefined;\n this.connected = false;\n this.inboundHandler = undefined;\n this.aliasCache.clear();\n }\n\n async sendMessage(out: OutboundMessage): Promise<SendResult> {\n return refuseAttachments(out) ?? this.sendText(out);\n }\n\n private async sendText(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n if (this.client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"MatrixAdapter.connect() not called\" },\n };\n }\n try {\n const roomId = await this.aliasCache.resolve(this.client, out.channel.id);\n if (this.isEncrypted(roomId)) {\n this.warnEncryptedOnce(roomId);\n return {\n ok: false,\n error: {\n code: \"encrypted_room_unsupported\",\n message: `Matrix room ${roomId} is encrypted; E2EE deferred to v0.2`,\n },\n };\n }\n const res = await this.sendHonouringFormat(roomId, out);\n return { ok: true, messageId: res.event_id };\n } catch (err) {\n return mapMatrixError(err);\n }\n }\n\n /**\n * Matrix edits through an `m.replace` event, so the capability holds from construction: it does\n * not depend on a connection or on which client is injected later.\n */\n override readonly supportsEdit = true;\n\n /**\n * Replace a message this bot sent with an `m.replace` event, and return the ORIGINAL event id.\n *\n * Returning the original id lets a second edit target the same message: clients apply the\n * newest replacement of the original, not a replacement of a replacement. There is no length\n * check, since Matrix has no splitter. An injected client without `sendMessage` cannot carry\n * the relation and answers `edit_unsupported`. The room resolves through the same alias cache\n * as `sendMessage`, so a `#alias` this adapter never resolved costs one lookup before the event.\n * Unlike `sendMessage`, a refused markup is not retried as plain text: one request, one answer.\n */\n override async editMessage(messageId: string, out: OutboundMessage): Promise<SendResult> {\n return refuseAttachments(out) ?? this.editText(messageId, out);\n }\n\n private async editText(messageId: string, out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"outbound text is empty\" } };\n }\n const client = this.client;\n if (client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"MatrixAdapter.connect() not called\" },\n };\n }\n if (messageId.length === 0) {\n return { ok: false, error: { code: \"invalid_message_id\", message: \"message id is empty\" } };\n }\n if (client.sendMessage === undefined) {\n return {\n ok: false,\n error: {\n code: \"edit_unsupported\",\n message: \"matrix client has no sendMessage, so it cannot send an m.replace event\",\n },\n };\n }\n try {\n const roomId = await this.aliasCache.resolve(client, out.channel.id);\n if (this.isEncrypted(roomId)) {\n this.warnEncryptedOnce(roomId);\n return {\n ok: false,\n error: {\n code: \"encrypted_room_unsupported\",\n message: `Matrix room ${roomId} is encrypted; E2EE deferred to v0.2`,\n },\n };\n }\n this.warnFormatUnsupported(out.format);\n await client.sendMessage(roomId, replaceContent(messageId, out));\n } catch (err) {\n return mapMatrixError(err);\n }\n return { ok: true, messageId };\n }\n\n /** Matrix expires a typing notice after its timeout; the runner renews it while the turn runs. */\n override async startTyping(channelId: string): Promise<void> {\n await this.setTyping(channelId, true);\n }\n\n override async stopTyping(channelId: string): Promise<void> {\n await this.setTyping(channelId, false);\n }\n\n private async setTyping(channelId: string, typing: boolean): Promise<void> {\n const client = this.client;\n if (channelId.length === 0 || client?.sendTyping === undefined) return;\n try {\n const roomId = await this.aliasCache.resolve(client, channelId);\n await client.sendTyping(roomId, typing, 10_000);\n } catch {\n /* cosmetic — swallow */\n }\n }\n\n override async react(channelId: string, messageId: string, emoji: string): Promise<SendResult> {\n if (channelId.length === 0 || messageId.length === 0 || emoji.length === 0) {\n return {\n ok: false,\n error: { code: \"invalid_reaction\", message: \"room, event id and emoji are required\" },\n };\n }\n const client = this.client;\n if (client === undefined) {\n return {\n ok: false,\n error: { code: \"not_connected\", message: \"MatrixAdapter.connect() not called\" },\n };\n }\n if (client.sendEvent === undefined) {\n return {\n ok: false,\n error: { code: \"react_unsupported\", message: \"matrix client has no sendEvent\" },\n };\n }\n try {\n const roomId = await this.aliasCache.resolve(client, channelId);\n await client.sendEvent(roomId, \"m.reaction\", {\n \"m.relates_to\": { rel_type: \"m.annotation\", event_id: messageId, key: emoji },\n });\n } catch (err) {\n return mapMatrixError(err);\n }\n return { ok: true, messageId };\n }\n\n /**\n * Send `out`, letting the caller's declared `format` decide the shape.\n *\n * Matrix carries markup in `formatted_body` and declares its type in `format`, whose only\n * value is `org.matrix.custom.html`. That declaration is a promise to every client that the\n * field IS HTML — so only `format: \"html\"` may use it.\n *\n * **`markdown` deliberately does not.** The first version of this method put the caller's\n * markdown into `formatted_body` and declared it HTML, which was worse than the bug it meant\n * to fix: `**bold**` still rendered as literal asterisks because markdown is not HTML, AND a\n * `<div>` anywhere in the text was parsed as a tag and dropped, so the reader received words\n * the sender never wrote and lost the ones they did. Caught in review; the test that\n * \"proved\" it was asserting the defect.\n *\n * So Matrix joins LINE, SMS and WhatsApp: it has no markdown mode, and the honest handling is\n * to say once that the declaration is being dropped rather than to fake it.\n *\n * Falls back to `sendTextMessage` when the client does not expose `sendMessage`: it is\n * optional on {@link MatrixSdkClient} because a consumer may inject a narrower double, and\n * losing the formatting is better than losing the message.\n *\n * @internal\n */\n private async sendHonouringFormat(\n roomId: string,\n out: OutboundMessage,\n ): Promise<{ event_id: string }> {\n const client = this.client as MatrixSdkClient;\n if (out.format !== \"html\" || client.sendMessage === undefined) {\n this.warnFormatUnsupported(out.format);\n return await client.sendTextMessage(roomId, out.text);\n }\n try {\n return await client.sendMessage(roomId, {\n msgtype: \"m.text\",\n body: out.text,\n format: \"org.matrix.custom.html\",\n formatted_body: out.text,\n });\n } catch (err) {\n // ADR-2: an undelivered message is worse than an unformatted one — the caller loses the\n // content and the user sees nothing, which is strictly worse than losing the markup.\n //\n // The discrimination is the whole guard. A bare `catch` would swallow an expired token as\n // a formatting problem and retry into the same 401, turning an actionable error into a\n // silent double failure. Only a request the server judged malformed is retried.\n if (!isMalformedRequest(err)) throw err;\n process.stderr.write(\n \"[gateway-matrix] homeserver rejected the formatted body; retrying as plain text\\n\",\n );\n return await client.sendTextMessage(roomId, out.text);\n }\n }\n\n /** Whether the \"no markdown mode here\" warning has already been emitted. */\n private warnedAboutFormat = false;\n\n /**\n * Say, once, that a declared `markdown` has nowhere to go on this platform.\n *\n * Matrix's only markup type is HTML. A caller declaring `markdown` is asking for something\n * the protocol does not have, and putting the markdown in the HTML field would corrupt it.\n *\n * @internal\n */\n private warnFormatUnsupported(format: OutboundMessage[\"format\"]): void {\n if (format === undefined || format === \"plain\" || format === \"html\") return;\n if (this.warnedAboutFormat) return;\n this.warnedAboutFormat = true;\n process.stderr.write(\n `[gateway-matrix] format=\"${format}\" was declared, and Matrix has no markdown mode — ` +\n \"its only markup type is HTML. Sending as plain text; this is logged once.\\n\",\n );\n }\n\n onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H replace, not stack.\n this.inboundHandler = handler;\n return () => {\n if (this.inboundHandler === handler) this.inboundHandler = undefined;\n };\n }\n\n /** Escape hatch (D421) — caller can drive matrix-js-sdk directly for advanced features. */\n getClient(): MatrixSdkClient | undefined {\n return this.client;\n }\n\n /** Used by tests to install a mock SDK client + flip connected flag. */\n _installClient(client: MatrixSdkClient): void {\n this.client = client;\n this.connected = true;\n this.attachSync();\n }\n\n private attachSync(): void {\n if (this.client === undefined) return;\n const client = this.client;\n const opts = {\n botUserId: this.opts.userId,\n freshnessWindowMs: this.opts.freshnessWindowMs ?? DEFAULT_FRESHNESS_MS,\n };\n const acceptInvite = this.opts.acceptInvite;\n if (acceptInvite !== undefined && client.joinRoom !== undefined) {\n this.unsubscribeInvites?.();\n this.unsubscribeInvites = subscribeToInvites(\n client as unknown as Parameters<typeof subscribeToInvites>[0],\n { botUserId: this.opts.userId, acceptInvite },\n );\n }\n this.subscription = subscribeToTimeline(\n client,\n (ev: MatrixEventLike, room: MatrixRoomLike) => {\n void this.dispatchTimelineEvent(ev, room).catch((err: unknown) => {\n const m = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-matrix] dispatchTimelineEvent failed: ${m}\\n`);\n });\n },\n opts,\n );\n }\n\n private async dispatchTimelineEvent(event: MatrixEventLike, room: MatrixRoomLike): Promise<void> {\n if (this.isEncrypted(room.roomId)) {\n this.warnEncryptedOnce(room.roomId);\n return;\n }\n const normalized = matrixEventToMessageEvent(event, room);\n if (normalized === undefined) return;\n if (!this.passesMentionGate(normalized)) return;\n if (this.inboundHandler === undefined) return;\n try {\n await this.inboundHandler(normalized);\n } catch (err) {\n const m = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[gateway-matrix] handler threw: ${m}\\n`);\n }\n }\n\n /**\n * Whether an event may reach the handler: always for a DM or with `requireMention` off,\n * otherwise only when the content mentions the bot. Both `deliver()` and the sync path call it,\n * so the two entries cannot disagree.\n */\n private passesMentionGate(event: GatewayMessageEvent): boolean {\n if (event.channel.type === \"dm\" || !(this.opts.requireMention ?? true)) return true;\n const botId = this.opts.userId;\n const raw = event.platform === \"matrix\" ? event.matrix.raw : undefined;\n const content = (raw as Partial<MatrixEventLike> | undefined)?.getContent?.();\n if (content === undefined) return event.text.includes(botId);\n const mentions = content[\"m.mentions\"];\n if (mentions !== undefined) return mentions.user_ids?.includes(botId) ?? false;\n return (content.body ?? \"\").includes(botId) || (content.formatted_body ?? \"\").includes(botId);\n }\n\n private isEncrypted(roomId: string): boolean {\n if (this.client === undefined) return false;\n if (this.client.isRoomEncrypted === undefined) return false;\n try {\n return this.client.isRoomEncrypted(roomId);\n } catch {\n return false;\n }\n }\n\n private warnEncryptedOnce(roomId: string): void {\n if (this.warnedEncrypted.has(roomId)) return;\n this.warnedEncrypted.add(roomId);\n process.stderr.write(\n `[gateway-matrix] room ${roomId} is end-to-end encrypted; skipping (E2EE deferred to v0.2)\\n`,\n );\n }\n\n /**\n * Deliver an event that arrived out of band — the ingest `onInbound` had no counterpart for (#83).\n *\n * The mention gate runs first, as on the sync path: an event it drops answers `\"ok\"`, with or\n * without a handler subscribed. `runHandler` owns the containment: a handler is user code, its\n * throw is named as the handler's failure rather than the platform's, and delivery continues.\n */\n override async deliver(\n event: GatewayMessageEvent,\n ): Promise<\"ok\" | \"no_handler\" | \"handler_threw\"> {\n if (!this.passesMentionGate(event)) return \"ok\";\n return this.runHandler(this.inboundHandler, event);\n }\n}\n\n/**\n * Narrow abort detection. `DOMException.ABORT_ERR` is 20; the message check\n * covers runtimes that report the abort without the standard name or code.\n */\nfunction isAbortError(err: unknown): boolean {\n if (typeof err !== \"object\" || err === null) return false;\n const e = err as { name?: unknown; code?: unknown; message?: unknown };\n if (e.name === \"AbortError\") return true;\n if (e.code === 20) return true;\n return typeof e.message === \"string\" && /aborted/i.test(e.message);\n}\n\ninterface MatrixRestError {\n httpStatus?: number;\n errcode?: string;\n message?: string;\n name?: string;\n}\n\n/**\n * Did the homeserver judge the REQUEST malformed, as opposed to refusing the sender?\n *\n * Narrow by construction: a 400 with `M_BAD_JSON` or `M_INVALID_PARAM` is the server saying it\n * could not parse what it was given. A 401, 403 or 429 is about who is asking or how often,\n * and retrying those without markup would fail identically while reporting the wrong cause.\n */\nfunction isMalformedRequest(err: unknown): boolean {\n const e = err as MatrixRestError;\n if (e.httpStatus !== 400) return false;\n return e.errcode === \"M_BAD_JSON\" || e.errcode === \"M_INVALID_PARAM\";\n}\n\n// biome-ignore lint/complexity/noExcessiveCognitiveComplexity: error mapping ladder is exhaustive — each branch maps one Matrix errcode/HTTP status to one canonical code; splitting hurts traceability.\nfunction mapMatrixError(err: unknown): SendResult {\n const e = err as MatrixRestError;\n const status = e.httpStatus ?? 0;\n if (status === 429 || e.errcode === \"M_LIMIT_EXCEEDED\") {\n return { ok: false, error: { code: \"rate_limit\", message: e.message ?? \"Matrix rate limit\" } };\n }\n if (status === 401 || status === 403 || e.errcode === \"M_FORBIDDEN\") {\n return {\n ok: false,\n error: { code: \"permission_denied\", message: e.message ?? \"Matrix permission error\" },\n };\n }\n if (status === 404 || e.errcode === \"M_NOT_FOUND\") {\n return {\n ok: false,\n error: { code: \"not_found\", message: e.message ?? \"Matrix resource not found\" },\n };\n }\n return {\n ok: false,\n error: {\n code: \"send_failed\",\n message: e.message ?? (err instanceof Error ? err.message : String(err)),\n },\n };\n}\n"]}
|