@theokit/gateway-discord 0.1.4 → 0.2.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 CHANGED
@@ -1,5 +1,67 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.2.0
4
+
5
+ ### Minor Changes
6
+
7
+ - b38172b: **The peer floor on `@theokit/gateway` rises with this release.** Every adapter now implements
8
+ `deliver` over `runHandler`, and neither exists in an older core — an adapter installed against one
9
+ does not build. `dep-check` caught that by building the whole workspace against the floor each
10
+ package claimed, which is the one thing a version range cannot tell you by reading it.
11
+
12
+ The floor is set in the version commit rather than here, because a range cannot name a version that
13
+ does not exist yet: raised in the workspace, the same gate then fails the other way round — every
14
+ adapter declaring a floor above the core installed beside it. That is the shape `fa70153` used when
15
+ these ranges were first written.
16
+
17
+ `deliver(event)` — every adapter can now be handed an event that arrived out of band (#83).
18
+
19
+ `onInbound` was the seam every adapter implemented and it had no public counterpart. Six platforms
20
+ self-deliver once connected — long polling, a gateway socket, Socket Mode, a sync loop, IMAP — so
21
+ the asymmetry stayed invisible: `GatewayRunner` worked for eight platforms and silently did nothing
22
+ for LINE and WhatsApp Cloud, whose payloads arrive on an HTTP route the application owns. Every app
23
+ wired those two by hand, beside the runner rather than through it.
24
+
25
+ ```ts
26
+ const outcome = await adapter.deliver(event); // "ok" | "no_handler" | "handler_threw"
27
+ ```
28
+
29
+ The three outcomes are distinguished because a caller acts on them differently: answering a webhook
30
+ 200 when nobody was subscribed tells the provider to stop retrying a message nothing received.
31
+
32
+ `BasePlatformAdapter.runHandler` holds the containment once, where ten copies of it used to live —
33
+ a handler is user code, its throw is named as the handler's failure rather than the platform's, and
34
+ delivery continues. Each adapter's `deliver` is one line over it.
35
+
36
+ Also: `gateway-sms`'s `createWebhookServer` now signs against the configured `publicUrl` (#90).
37
+ Twilio verifies against the URL it POSTed to, and behind a proxy that rewrites `host` — a tunnel, an
38
+ ingress, a load balancer terminating TLS — the reconstruction from headers yields the internal
39
+ address, so a correct signature fails on every delivery. `publicUrl` is required by all three
40
+ backend option shapes and documented as "used by signature verifier"; until now no source file read
41
+ it. The header reconstruction stays as the fallback for an app served directly.
42
+
43
+ ## 0.1.5
44
+
45
+ ### Patch Changes
46
+
47
+ - Every credential field now says what the platform calls it and where it is issued.
48
+
49
+ Measured: a developer who wires one adapter and carries its field name to the next gets
50
+ `error TS2353: … 'token' does not exist in type 'SlackAdapterOptions'`. That names the wrong field
51
+ and the type, and never the right one — so the answer was always one file away.
52
+
53
+ These docblocks are on published option types, so an editor now shows the answer on hover and
54
+ completion. All 15 credential-bearing fields across the ten packages are covered, including the ones
55
+ beyond each adapter's primary token: Slack's `appToken`, LINE's `channelSecret`, Vonage's
56
+ `apiSecret` and `signatureSecret`, WhatsApp's `appSecret`.
57
+
58
+ **Nothing was renamed.** Six of the ten primary names are the platform's own key, pinned against the
59
+ SDK's own declaration — `channelAccessToken` in `@line/bot-sdk`, `clientSecret` in
60
+ `@microsoft/teams.apps`, `accessToken` in `matrix-js-sdk`, `token` in `grammy` and `discord.js`,
61
+ `authToken` in `twilio`. Where ours diverges, the docblock says so rather than implying otherwise:
62
+ `botToken` (deliberate — the adapter also takes an `appToken`), Mattermost's `accessToken` against
63
+ its client's `token`, and `password` against nodemailer's `pass`.
64
+
3
65
  ## 0.1.4
4
66
 
5
67
  ### Patch Changes
package/README.md CHANGED
@@ -4,6 +4,11 @@ Discord platform adapter for `@theokit/gateway`. Wraps [discord.js](https://disc
4
4
 
5
5
  > **Status: 0.1.0 — pre-release.**
6
6
 
7
+
8
+ ## How inbound arrives
9
+
10
+ **Gateway WebSocket.** discord.js holds the connection; events reach `onInbound` once `connect()`
11
+ resolves. There is no webhook to host and nothing for an application to authenticate.
7
12
  ## Install
8
13
 
9
14
  ```bash
@@ -39,6 +44,53 @@ await runner.start();
39
44
  - **WebSocket only** (ADR D179). No webhook-based bot mode.
40
45
  - **Voice channels** not exposed via `MessageEvent`. Use `event.discord?.raw` for advanced cases.
41
46
 
47
+ ## Known issue: `@types/node@26` and type-aware lint
48
+
49
+ If you install `@types/node@26` (the current `latest`) and run **type-aware lint**, or
50
+ `tsc` with `skipLibCheck: false`, you will see an error from a package you never
51
+ installed:
52
+
53
+ ```
54
+ @sapphire/shapeshift/dist/esm/index.d.mts(1,10): error TS2305:
55
+ Module '"util"' has no exported member 'InspectOptionsStylized'.
56
+ ```
57
+
58
+ It is not this adapter, and it is not `discord.js` misbehaving. `@types/node@26`
59
+ renamed `util.InspectOptionsStylized` to `InspectContext`; `@sapphire/shapeshift@4`
60
+ — which `discord.js` pulls through `@discordjs/builders` — still imports the old
61
+ name. Measured 2026-08-29:
62
+
63
+ | `@sapphire/shapeshift` | imports | works on `@types/node` |
64
+ |---|---|---|
65
+ | 4.0.0 (what `discord.js` installs) | `InspectOptionsStylized` | ≤ 22 |
66
+ | 5.0.0 | `InspectContext` | 26 |
67
+
68
+ `@discordjs/builders@1.14.1`, the current release, declares `^4.0.0` — so no
69
+ `discord.js` version reaches shapeshift 5 yet, and there is no combination that
70
+ satisfies both type lines.
71
+
72
+ **Fix — one line in your `tsconfig.json`:**
73
+
74
+ ```jsonc
75
+ { "include": ["src", "node_modules/@theokit/gateway-discord/shims/types-node-26.d.ts"] }
76
+ ```
77
+
78
+ That file ships with this package and restores the renamed type. It is **opt-in and
79
+ loaded by nothing** — a library that augments Node's own types for everyone changes
80
+ the type environment of people who never asked. Measured 2026-08-29 in a scratch
81
+ consumer: `@types/node@26` fails to compile without it and passes with it, and
82
+ `@types/node@22` passes either way, since the declaration merges with the interface
83
+ that already exists there.
84
+
85
+ Two alternatives, if you would rather not add the file: pin `@types/node` to `^22`,
86
+ which is what `engines.node: >=22.12.0` here is typechecked against, or set
87
+ `skipLibCheck: true` — most scaffolds do, though TypeScript's own default is `false`,
88
+ which is why this is reachable at all.
89
+
90
+ Tracked in [#81](https://github.com/usetheokit/theokit-gateways/issues/81). It closes
91
+ when `@discordjs/builders` moves to shapeshift 5; the shim's own header says how you
92
+ will find out without having to watch for it.
93
+
42
94
  ## License
43
95
 
44
96
  Apache-2.0
package/dist/index.cjs CHANGED
@@ -104,7 +104,7 @@ var DiscordAdapter = class extends gateway.BasePlatformAdapter {
104
104
  }
105
105
  };
106
106
  }
107
- const chunks = splitForDiscord(out.text);
107
+ const chunks = splitForDiscord(out.text).map((chunk) => bodyFor(out.format, chunk));
108
108
  let lastId;
109
109
  for (const chunk of chunks) {
110
110
  try {
@@ -156,6 +156,15 @@ var DiscordAdapter = class extends gateway.BasePlatformAdapter {
156
156
  }
157
157
  return "ok";
158
158
  }
159
+ /**
160
+ * Deliver an event that arrived out of band — the ingest `onInbound` had no counterpart for (#83).
161
+ *
162
+ * One line over `runHandler`, which owns the containment: a handler is user code, its throw is
163
+ * named as the handler's failure rather than the platform's, and delivery continues.
164
+ */
165
+ async deliver(event) {
166
+ return this.runHandler(this.handler, event);
167
+ }
159
168
  };
160
169
  function normalizeEvent(msg) {
161
170
  let channelType;
@@ -207,6 +216,12 @@ function mapSendError(err) {
207
216
  }
208
217
  return { ok: false, error: { code: "unknown", message: err.message } };
209
218
  }
219
+ function bodyFor(format, text) {
220
+ return format === "plain" ? escapeMarkdown(text) : text;
221
+ }
222
+ function escapeMarkdown(text) {
223
+ return text.replace(/([\\*_`~])/g, "\\$1");
224
+ }
210
225
 
211
226
  exports.DiscordAdapter = DiscordAdapter;
212
227
  //# sourceMappingURL=index.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/split.ts","../src/adapter.ts"],"names":["chunkText","GatewayIntentBits","BasePlatformAdapter","Client","Events","DiscordAPIError"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Discord's 2000-char per-message hard limit. Split agent responses on safe\n * boundaries before sending (T6.1).\n *\n * Thin wrapper over core `chunkText` (roadmap M1). Telegram family (minus\n * markdown balancing): 2000 hard cap, 1900 soft window, `\\n\\n` → `\\n` → window\n * boundary preference, newline-only leading strip, no surrogate guard. Output\n * is byte-identical to the previous implementation (pinned by\n * `tests/split.test.ts`).\n *\n * @internal\n */\n\nimport { chunkText } from \"@theokit/gateway\";\n\nconst DISCORD_MAX_MESSAGE = 2000;\nconst SAFE_DISCORD_CHUNK = 1900;\n\nexport function splitForDiscord(text: string): string[] {\n return chunkText(text, {\n limit: DISCORD_MAX_MESSAGE,\n safeLimit: SAFE_DISCORD_CHUNK,\n boundaries: [\"\\n\\n\", \"\\n\"],\n lastResort: \"window\",\n stripLeading: /^\\n+/,\n });\n}\n","/**\n * `DiscordAdapter` — wraps discord.js in the `@theokit/gateway`\n * `BasePlatformAdapter` contract (T6.1, ADRs D171, D179).\n *\n * - `connect()` calls `client.login(token)` and awaits the `ready` event.\n * - WebSocket Gateway only (D179) — no webhook variant in v0.1.\n * - Default intents include `MessageContent` (EC-C silent-failure guard).\n * - Bot-to-bot messages ignored at adapter level (`msg.author.bot`).\n * - 2000-char message split (Discord's hard limit).\n *\n * @public\n */\n\nimport type { DiscordMessageEvent, MessageEvent as GatewayMessageEvent } from \"@theokit/gateway\";\nimport { BasePlatformAdapter, type OutboundMessage, type SendResult } from \"@theokit/gateway\";\nimport { Client, DiscordAPIError, Events, GatewayIntentBits, type Message } from \"discord.js\";\n\nimport { splitForDiscord } from \"./split.js\";\n\nexport interface DiscordAdapterOptions {\n readonly token: string;\n /**\n * Default: [Guilds, GuildMessages, MessageContent, DirectMessages,\n * DirectMessageReactions]. Without MessageContent the bot receives\n * empty `msg.content` (EC-C silent failure).\n */\n readonly intents?: GatewayIntentBits[];\n}\n\nexport const DEFAULT_DISCORD_INTENTS: ReadonlyArray<GatewayIntentBits> = [\n GatewayIntentBits.Guilds,\n GatewayIntentBits.GuildMessages,\n GatewayIntentBits.MessageContent,\n GatewayIntentBits.DirectMessages,\n GatewayIntentBits.DirectMessageReactions,\n];\n\n/**\n * Discord gateway adapter — holds a websocket the bot opens, so inbound needs no public URL.\n *\n * Reading message CONTENT requires the privileged `MessageContent` intent, which must be enabled in\n * the Discord developer portal as well as requested here; without it every `event.text` arrives\n * empty and nothing in the API says why. `DEFAULT_DISCORD_INTENTS` requests it.\n */\nexport class DiscordAdapter extends BasePlatformAdapter {\n readonly platform = \"discord\" as const;\n private readonly client: Client;\n private readonly token: string;\n private handler?: (event: GatewayMessageEvent) => Promise<void>;\n private connected = false;\n\n constructor(opts: DiscordAdapterOptions) {\n super();\n this.token = opts.token;\n const intents = (opts.intents ?? DEFAULT_DISCORD_INTENTS) as GatewayIntentBits[];\n if (intents.length === 0) {\n process.stderr.write(\n \"[discord] WARN — intents:[] passed; bot will not receive message content. Pass at least [Guilds, GuildMessages, MessageContent] (EC-C).\\n\",\n );\n }\n this.client = new Client({ intents });\n this.client.on(Events.MessageCreate, async (msg) => this.handleInbound(msg));\n this.client.on(Events.Error, (err) => {\n process.stderr.write(`[discord] client error: ${err.message}\\n`);\n });\n }\n\n override async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n await new Promise<void>((resolve, reject) => {\n this.client.once(Events.ClientReady, () => resolve());\n this.client.login(this.token).catch(reject);\n });\n this.connected = true;\n return true;\n } catch (err) {\n process.stderr.write(`[discord] connect failed: ${(err as Error).message}\\n`);\n return false;\n }\n }\n\n override async disconnect(): Promise<void> {\n if (!this.connected) return;\n this.connected = false;\n try {\n await this.client.destroy();\n } catch {\n /* ignore */\n }\n }\n\n /**\n * Expose the underlying discord.js `Client` so consumers can register\n * platform-specific events that don't fit the portable contract —\n * `interactionCreate` (slash commands via Application Commands),\n * `error` event boundary, presence updates, etc. Register BEFORE\n * calling `runner.start()`.\n *\n * @public\n */\n getBot(): Client {\n return this.client;\n }\n\n override async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"text is empty\" } };\n }\n let channel: unknown;\n try {\n channel = await this.client.channels.fetch(out.channel.id);\n } catch (err) {\n return {\n ok: false,\n error: { code: \"channel_fetch_failed\", message: (err as Error).message },\n };\n }\n const sendable = channel as {\n send?: (input: { content: string; reply?: unknown }) => Promise<Message>;\n };\n if (sendable === null || typeof sendable.send !== \"function\") {\n return {\n ok: false,\n error: {\n code: \"channel_not_sendable\",\n message: `channel \"${out.channel.id}\" not text-based or missing`,\n },\n };\n }\n const chunks = splitForDiscord(out.text);\n let lastId: string | undefined;\n for (const chunk of chunks) {\n try {\n const msg = await sendable.send({\n content: chunk,\n ...(out.replyTo !== undefined ? { reply: { messageReference: out.replyTo } } : {}),\n });\n lastId = msg.id;\n } catch (err) {\n return mapSendError(err);\n }\n }\n return { ok: true, ...(lastId !== undefined ? { messageId: lastId } : {}) };\n }\n\n override onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace previous handler.\n this.handler = handler;\n return () => {\n if (this.handler === handler) this.handler = undefined;\n };\n }\n\n private async handleInbound(msg: Message): Promise<void> {\n if (this.handler === undefined) return;\n if (msg.author.bot) return;\n await this.dispatchEvent(normalizeEvent(msg));\n }\n\n /**\n * Dispatch a pre-built event to the current handler, honouring EC-H replace\n * semantics.\n *\n * Mirrors the seam `gateway-sms` already exposes. It exists because the EC-H\n * contract had no honest test without it: a real `discord.js` Message cannot\n * be synthesized, `handler` is private, and the test that claimed to cover\n * replacement asserted two counters were 0 — true whether onInbound replaces,\n * stacks, or discards. If it had regressed to `handlers.push(handler)`, the\n * agent would have replied twice to every message, double-billing tokens,\n * with the suite green.\n *\n * @internal\n */\n async dispatchEvent(event: GatewayMessageEvent): Promise<\"ok\" | \"no_handler\" | \"handler_threw\"> {\n if (this.handler === undefined) return \"no_handler\";\n try {\n await this.handler(event);\n } catch (err) {\n // Left uncaught, the rejection escaped into the platform's own error channel and was reported\n // as a client error — so a bug in the consumer's handler read as a fault in the platform\n // library, sending whoever debugged it to the wrong repository (#41). A handler is user code:\n // its failure is named as such, and delivery continues.\n const m = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[discord] handler threw: ${m}\\n`);\n return \"handler_threw\";\n }\n return \"ok\";\n }\n}\n\nfunction normalizeEvent(msg: Message): DiscordMessageEvent {\n let channelType: \"dm\" | \"group\" | \"thread\";\n if (msg.guildId === null) {\n channelType = \"dm\";\n } else if (msg.channel.isThread()) {\n channelType = \"thread\";\n } else {\n channelType = \"group\";\n }\n\n const displayName = msg.author.globalName !== null ? msg.author.globalName : msg.author.username;\n\n return {\n id: `dc-${msg.channelId}-${msg.id}`,\n platform: \"discord\",\n sender: {\n id: msg.author.id,\n username: msg.author.username,\n displayName,\n },\n channel: {\n id: msg.channelId,\n type: channelType,\n ...(msg.channel.isThread() ? { topicId: msg.channel.id } : {}),\n },\n text: msg.content,\n receivedAt: msg.createdTimestamp,\n ...(msg.reference?.messageId !== undefined ? { replyTo: msg.reference.messageId } : {}),\n discord: {\n guildId: msg.guildId,\n channelId: msg.channelId,\n messageId: msg.id,\n raw: msg,\n },\n };\n}\n\nfunction mapSendError(err: unknown): SendResult {\n if (err instanceof DiscordAPIError) {\n const codeStr = String(err.code);\n if (codeStr === \"50007\") {\n return { ok: false, error: { code: \"dm_blocked\", message: err.message } };\n }\n if (codeStr === \"50001\" || codeStr === \"50013\") {\n return { ok: false, error: { code: \"no_permission\", message: err.message } };\n }\n if (err.status === 429) {\n return { ok: false, error: { code: \"rate_limited\", message: err.message } };\n }\n return { ok: false, error: { code: `discord_${codeStr}`, message: err.message } };\n }\n return { ok: false, error: { code: \"unknown\", message: (err as Error).message } };\n}\n"]}
1
+ {"version":3,"sources":["../src/split.ts","../src/adapter.ts"],"names":["chunkText","GatewayIntentBits","BasePlatformAdapter","Client","Events","DiscordAPIError"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * Discord's 2000-char per-message hard limit. Split agent responses on safe\n * boundaries before sending (T6.1).\n *\n * Thin wrapper over core `chunkText` (roadmap M1). Telegram family (minus\n * markdown balancing): 2000 hard cap, 1900 soft window, `\\n\\n` → `\\n` → window\n * boundary preference, newline-only leading strip, no surrogate guard. Output\n * is byte-identical to the previous implementation (pinned by\n * `tests/split.test.ts`).\n *\n * @internal\n */\n\nimport { chunkText } from \"@theokit/gateway\";\n\nconst DISCORD_MAX_MESSAGE = 2000;\nconst SAFE_DISCORD_CHUNK = 1900;\n\nexport function splitForDiscord(text: string): string[] {\n return chunkText(text, {\n limit: DISCORD_MAX_MESSAGE,\n safeLimit: SAFE_DISCORD_CHUNK,\n boundaries: [\"\\n\\n\", \"\\n\"],\n lastResort: \"window\",\n stripLeading: /^\\n+/,\n });\n}\n","/**\n * `DiscordAdapter` — wraps discord.js in the `@theokit/gateway`\n * `BasePlatformAdapter` contract (T6.1, ADRs D171, D179).\n *\n * - `connect()` calls `client.login(token)` and awaits the `ready` event.\n * - WebSocket Gateway only (D179) — no webhook variant in v0.1.\n * - Default intents include `MessageContent` (EC-C silent-failure guard).\n * - Bot-to-bot messages ignored at adapter level (`msg.author.bot`).\n * - 2000-char message split (Discord's hard limit).\n *\n * @public\n */\n\nimport type { DiscordMessageEvent, MessageEvent as GatewayMessageEvent } from \"@theokit/gateway\";\nimport { BasePlatformAdapter, type OutboundMessage, type SendResult } from \"@theokit/gateway\";\nimport { Client, DiscordAPIError, Events, GatewayIntentBits, type Message } from \"discord.js\";\n\nimport { splitForDiscord } from \"./split.js\";\n\nexport interface DiscordAdapterOptions {\n /**\n * The Discord bot token.\n *\n * @platform-term Discord calls this a **bot token** and `discord.js` names the field `token`, so\n * the name here is theirs.\n * @issued-at The Discord Developer Portal, under the application's Bot tab.\n */\n readonly token: string;\n /**\n * Default: [Guilds, GuildMessages, MessageContent, DirectMessages,\n * DirectMessageReactions]. Without MessageContent the bot receives\n * empty `msg.content` (EC-C silent failure).\n */\n readonly intents?: GatewayIntentBits[];\n}\n\nexport const DEFAULT_DISCORD_INTENTS: ReadonlyArray<GatewayIntentBits> = [\n GatewayIntentBits.Guilds,\n GatewayIntentBits.GuildMessages,\n GatewayIntentBits.MessageContent,\n GatewayIntentBits.DirectMessages,\n GatewayIntentBits.DirectMessageReactions,\n];\n\n/**\n * Discord gateway adapter — holds a websocket the bot opens, so inbound needs no public URL.\n *\n * Reading message CONTENT requires the privileged `MessageContent` intent, which must be enabled in\n * the Discord developer portal as well as requested here; without it every `event.text` arrives\n * empty and nothing in the API says why. `DEFAULT_DISCORD_INTENTS` requests it.\n */\nexport class DiscordAdapter extends BasePlatformAdapter {\n readonly platform = \"discord\" as const;\n private readonly client: Client;\n private readonly token: string;\n private handler?: (event: GatewayMessageEvent) => Promise<void>;\n private connected = false;\n\n constructor(opts: DiscordAdapterOptions) {\n super();\n this.token = opts.token;\n const intents = (opts.intents ?? DEFAULT_DISCORD_INTENTS) as GatewayIntentBits[];\n if (intents.length === 0) {\n process.stderr.write(\n \"[discord] WARN — intents:[] passed; bot will not receive message content. Pass at least [Guilds, GuildMessages, MessageContent] (EC-C).\\n\",\n );\n }\n this.client = new Client({ intents });\n this.client.on(Events.MessageCreate, async (msg) => this.handleInbound(msg));\n this.client.on(Events.Error, (err) => {\n process.stderr.write(`[discord] client error: ${err.message}\\n`);\n });\n }\n\n override async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n await new Promise<void>((resolve, reject) => {\n this.client.once(Events.ClientReady, () => resolve());\n this.client.login(this.token).catch(reject);\n });\n this.connected = true;\n return true;\n } catch (err) {\n process.stderr.write(`[discord] connect failed: ${(err as Error).message}\\n`);\n return false;\n }\n }\n\n override async disconnect(): Promise<void> {\n if (!this.connected) return;\n this.connected = false;\n try {\n await this.client.destroy();\n } catch {\n /* ignore */\n }\n }\n\n /**\n * Expose the underlying discord.js `Client` so consumers can register\n * platform-specific events that don't fit the portable contract —\n * `interactionCreate` (slash commands via Application Commands),\n * `error` event boundary, presence updates, etc. Register BEFORE\n * calling `runner.start()`.\n *\n * @public\n */\n getBot(): Client {\n return this.client;\n }\n\n override async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"text is empty\" } };\n }\n let channel: unknown;\n try {\n channel = await this.client.channels.fetch(out.channel.id);\n } catch (err) {\n return {\n ok: false,\n error: { code: \"channel_fetch_failed\", message: (err as Error).message },\n };\n }\n const sendable = channel as {\n send?: (input: { content: string; reply?: unknown }) => Promise<Message>;\n };\n if (sendable === null || typeof sendable.send !== \"function\") {\n return {\n ok: false,\n error: {\n code: \"channel_not_sendable\",\n message: `channel \"${out.channel.id}\" not text-based or missing`,\n },\n };\n }\n // Split FIRST, escape each chunk. The other order lets `splitForDiscord`'s hard window cut\n // land between a backslash and the character it guards: message 1 ends in a stray backslash\n // the user never typed, and message 2 opens with a bare `*` that Discord parses as markup.\n // Demonstrated in review against the real splitter.\n const chunks = splitForDiscord(out.text).map((chunk) => bodyFor(out.format, chunk));\n let lastId: string | undefined;\n for (const chunk of chunks) {\n try {\n const msg = await sendable.send({\n content: chunk,\n ...(out.replyTo !== undefined ? { reply: { messageReference: out.replyTo } } : {}),\n });\n lastId = msg.id;\n } catch (err) {\n return mapSendError(err);\n }\n }\n return { ok: true, ...(lastId !== undefined ? { messageId: lastId } : {}) };\n }\n\n override onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace previous handler.\n this.handler = handler;\n return () => {\n if (this.handler === handler) this.handler = undefined;\n };\n }\n\n private async handleInbound(msg: Message): Promise<void> {\n if (this.handler === undefined) return;\n if (msg.author.bot) return;\n await this.dispatchEvent(normalizeEvent(msg));\n }\n\n /**\n * Dispatch a pre-built event to the current handler, honouring EC-H replace\n * semantics.\n *\n * Mirrors the seam `gateway-sms` already exposes. It exists because the EC-H\n * contract had no honest test without it: a real `discord.js` Message cannot\n * be synthesized, `handler` is private, and the test that claimed to cover\n * replacement asserted two counters were 0 — true whether onInbound replaces,\n * stacks, or discards. If it had regressed to `handlers.push(handler)`, the\n * agent would have replied twice to every message, double-billing tokens,\n * with the suite green.\n *\n * @internal\n */\n async dispatchEvent(event: GatewayMessageEvent): Promise<\"ok\" | \"no_handler\" | \"handler_threw\"> {\n if (this.handler === undefined) return \"no_handler\";\n try {\n await this.handler(event);\n } catch (err) {\n // Left uncaught, the rejection escaped into the platform's own error channel and was reported\n // as a client error — so a bug in the consumer's handler read as a fault in the platform\n // library, sending whoever debugged it to the wrong repository (#41). A handler is user code:\n // its failure is named as such, and delivery continues.\n const m = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[discord] handler threw: ${m}\\n`);\n return \"handler_threw\";\n }\n return \"ok\";\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.handler, event);\n }\n}\n\nfunction normalizeEvent(msg: Message): DiscordMessageEvent {\n let channelType: \"dm\" | \"group\" | \"thread\";\n if (msg.guildId === null) {\n channelType = \"dm\";\n } else if (msg.channel.isThread()) {\n channelType = \"thread\";\n } else {\n channelType = \"group\";\n }\n\n const displayName = msg.author.globalName !== null ? msg.author.globalName : msg.author.username;\n\n return {\n id: `dc-${msg.channelId}-${msg.id}`,\n platform: \"discord\",\n sender: {\n id: msg.author.id,\n username: msg.author.username,\n displayName,\n },\n channel: {\n id: msg.channelId,\n type: channelType,\n ...(msg.channel.isThread() ? { topicId: msg.channel.id } : {}),\n },\n text: msg.content,\n receivedAt: msg.createdTimestamp,\n ...(msg.reference?.messageId !== undefined ? { replyTo: msg.reference.messageId } : {}),\n discord: {\n guildId: msg.guildId,\n channelId: msg.channelId,\n messageId: msg.id,\n raw: msg,\n },\n };\n}\n\nfunction mapSendError(err: unknown): SendResult {\n if (err instanceof DiscordAPIError) {\n const codeStr = String(err.code);\n if (codeStr === \"50007\") {\n return { ok: false, error: { code: \"dm_blocked\", message: err.message } };\n }\n if (codeStr === \"50001\" || codeStr === \"50013\") {\n return { ok: false, error: { code: \"no_permission\", message: err.message } };\n }\n if (err.status === 429) {\n return { ok: false, error: { code: \"rate_limited\", message: err.message } };\n }\n return { ok: false, error: { code: `discord_${codeStr}`, message: err.message } };\n }\n return { ok: false, error: { code: \"unknown\", message: (err as Error).message } };\n}\n\n/**\n * The text to send, with the caller's declared format applied.\n *\n * Discord parses markdown natively, so `markdown` needs no flag. `plain` is the caller stating\n * the text is NOT markup, and sending it raw would parse it anyway — a user's literal\n * `*asterisks*` arriving as italic.\n */\nfunction bodyFor(format: OutboundMessage[\"format\"], text: string): string {\n return format === \"plain\" ? escapeMarkdown(text) : text;\n}\n\n/**\n * Escape the characters this platform would otherwise parse as markup.\n *\n * Called only when the caller declared `format: \"plain\"` — an explicit statement that the text\n * is NOT markup. Without it, a user's literal `*asterisks*` render as italic on a platform that\n * parses markdown natively, which is the caller's intent being silently inverted.\n *\n * Deliberately narrow: the four characters that open an inline span. A full markdown escaper\n * would also touch `#`, `>` and `-` at line starts, which are far more common in ordinary prose\n * and whose escaping is more visible than the problem it solves.\n */\nfunction escapeMarkdown(text: string): string {\n // The backslash comes FIRST, and that ordering is the whole correctness of this function.\n // Without it a backslash already in the caller's text is left bare: `a\\*b` escapes to `a\\\\*b`,\n // the renderer consumes `\\\\` as one literal backslash, and the `*` it was guarding is left\n // naked — so text sent explicitly as `plain` arrives italicised, the exact inversion this\n // function exists to prevent. Caught in review.\n return text.replace(/([\\\\*_`~])/g, \"\\\\$1\");\n}\n"]}
package/dist/index.d.cts CHANGED
@@ -15,6 +15,13 @@ import { GatewayIntentBits, Client } from 'discord.js';
15
15
  */
16
16
 
17
17
  interface DiscordAdapterOptions {
18
+ /**
19
+ * The Discord bot token.
20
+ *
21
+ * @platform-term Discord calls this a **bot token** and `discord.js` names the field `token`, so
22
+ * the name here is theirs.
23
+ * @issued-at The Discord Developer Portal, under the application's Bot tab.
24
+ */
18
25
  readonly token: string;
19
26
  /**
20
27
  * Default: [Guilds, GuildMessages, MessageContent, DirectMessages,
@@ -52,6 +59,13 @@ declare class DiscordAdapter extends BasePlatformAdapter {
52
59
  sendMessage(out: OutboundMessage): Promise<SendResult>;
53
60
  onInbound(handler: (event: MessageEvent) => Promise<void>): () => void;
54
61
  private handleInbound;
62
+ /**
63
+ * Deliver an event that arrived out of band — the ingest `onInbound` had no counterpart for (#83).
64
+ *
65
+ * One line over `runHandler`, which owns the containment: a handler is user code, its throw is
66
+ * named as the handler's failure rather than the platform's, and delivery continues.
67
+ */
68
+ deliver(event: MessageEvent): Promise<"ok" | "no_handler" | "handler_threw">;
55
69
  }
56
70
 
57
71
  export { DiscordAdapter, type DiscordAdapterOptions };
package/dist/index.d.ts CHANGED
@@ -15,6 +15,13 @@ import { GatewayIntentBits, Client } from 'discord.js';
15
15
  */
16
16
 
17
17
  interface DiscordAdapterOptions {
18
+ /**
19
+ * The Discord bot token.
20
+ *
21
+ * @platform-term Discord calls this a **bot token** and `discord.js` names the field `token`, so
22
+ * the name here is theirs.
23
+ * @issued-at The Discord Developer Portal, under the application's Bot tab.
24
+ */
18
25
  readonly token: string;
19
26
  /**
20
27
  * Default: [Guilds, GuildMessages, MessageContent, DirectMessages,
@@ -52,6 +59,13 @@ declare class DiscordAdapter extends BasePlatformAdapter {
52
59
  sendMessage(out: OutboundMessage): Promise<SendResult>;
53
60
  onInbound(handler: (event: MessageEvent) => Promise<void>): () => void;
54
61
  private handleInbound;
62
+ /**
63
+ * Deliver an event that arrived out of band — the ingest `onInbound` had no counterpart for (#83).
64
+ *
65
+ * One line over `runHandler`, which owns the containment: a handler is user code, its throw is
66
+ * named as the handler's failure rather than the platform's, and delivery continues.
67
+ */
68
+ deliver(event: MessageEvent): Promise<"ok" | "no_handler" | "handler_threw">;
55
69
  }
56
70
 
57
71
  export { DiscordAdapter, type DiscordAdapterOptions };
package/dist/index.js CHANGED
@@ -102,7 +102,7 @@ var DiscordAdapter = class extends BasePlatformAdapter {
102
102
  }
103
103
  };
104
104
  }
105
- const chunks = splitForDiscord(out.text);
105
+ const chunks = splitForDiscord(out.text).map((chunk) => bodyFor(out.format, chunk));
106
106
  let lastId;
107
107
  for (const chunk of chunks) {
108
108
  try {
@@ -154,6 +154,15 @@ var DiscordAdapter = class extends BasePlatformAdapter {
154
154
  }
155
155
  return "ok";
156
156
  }
157
+ /**
158
+ * Deliver an event that arrived out of band — the ingest `onInbound` had no counterpart for (#83).
159
+ *
160
+ * One line over `runHandler`, which owns the containment: a handler is user code, its throw is
161
+ * named as the handler's failure rather than the platform's, and delivery continues.
162
+ */
163
+ async deliver(event) {
164
+ return this.runHandler(this.handler, event);
165
+ }
157
166
  };
158
167
  function normalizeEvent(msg) {
159
168
  let channelType;
@@ -205,6 +214,12 @@ function mapSendError(err) {
205
214
  }
206
215
  return { ok: false, error: { code: "unknown", message: err.message } };
207
216
  }
217
+ function bodyFor(format, text) {
218
+ return format === "plain" ? escapeMarkdown(text) : text;
219
+ }
220
+ function escapeMarkdown(text) {
221
+ return text.replace(/([\\*_`~])/g, "\\$1");
222
+ }
208
223
 
209
224
  export { DiscordAdapter };
210
225
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/split.ts","../src/adapter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Discord's 2000-char per-message hard limit. Split agent responses on safe\n * boundaries before sending (T6.1).\n *\n * Thin wrapper over core `chunkText` (roadmap M1). Telegram family (minus\n * markdown balancing): 2000 hard cap, 1900 soft window, `\\n\\n` → `\\n` → window\n * boundary preference, newline-only leading strip, no surrogate guard. Output\n * is byte-identical to the previous implementation (pinned by\n * `tests/split.test.ts`).\n *\n * @internal\n */\n\nimport { chunkText } from \"@theokit/gateway\";\n\nconst DISCORD_MAX_MESSAGE = 2000;\nconst SAFE_DISCORD_CHUNK = 1900;\n\nexport function splitForDiscord(text: string): string[] {\n return chunkText(text, {\n limit: DISCORD_MAX_MESSAGE,\n safeLimit: SAFE_DISCORD_CHUNK,\n boundaries: [\"\\n\\n\", \"\\n\"],\n lastResort: \"window\",\n stripLeading: /^\\n+/,\n });\n}\n","/**\n * `DiscordAdapter` — wraps discord.js in the `@theokit/gateway`\n * `BasePlatformAdapter` contract (T6.1, ADRs D171, D179).\n *\n * - `connect()` calls `client.login(token)` and awaits the `ready` event.\n * - WebSocket Gateway only (D179) — no webhook variant in v0.1.\n * - Default intents include `MessageContent` (EC-C silent-failure guard).\n * - Bot-to-bot messages ignored at adapter level (`msg.author.bot`).\n * - 2000-char message split (Discord's hard limit).\n *\n * @public\n */\n\nimport type { DiscordMessageEvent, MessageEvent as GatewayMessageEvent } from \"@theokit/gateway\";\nimport { BasePlatformAdapter, type OutboundMessage, type SendResult } from \"@theokit/gateway\";\nimport { Client, DiscordAPIError, Events, GatewayIntentBits, type Message } from \"discord.js\";\n\nimport { splitForDiscord } from \"./split.js\";\n\nexport interface DiscordAdapterOptions {\n readonly token: string;\n /**\n * Default: [Guilds, GuildMessages, MessageContent, DirectMessages,\n * DirectMessageReactions]. Without MessageContent the bot receives\n * empty `msg.content` (EC-C silent failure).\n */\n readonly intents?: GatewayIntentBits[];\n}\n\nexport const DEFAULT_DISCORD_INTENTS: ReadonlyArray<GatewayIntentBits> = [\n GatewayIntentBits.Guilds,\n GatewayIntentBits.GuildMessages,\n GatewayIntentBits.MessageContent,\n GatewayIntentBits.DirectMessages,\n GatewayIntentBits.DirectMessageReactions,\n];\n\n/**\n * Discord gateway adapter — holds a websocket the bot opens, so inbound needs no public URL.\n *\n * Reading message CONTENT requires the privileged `MessageContent` intent, which must be enabled in\n * the Discord developer portal as well as requested here; without it every `event.text` arrives\n * empty and nothing in the API says why. `DEFAULT_DISCORD_INTENTS` requests it.\n */\nexport class DiscordAdapter extends BasePlatformAdapter {\n readonly platform = \"discord\" as const;\n private readonly client: Client;\n private readonly token: string;\n private handler?: (event: GatewayMessageEvent) => Promise<void>;\n private connected = false;\n\n constructor(opts: DiscordAdapterOptions) {\n super();\n this.token = opts.token;\n const intents = (opts.intents ?? DEFAULT_DISCORD_INTENTS) as GatewayIntentBits[];\n if (intents.length === 0) {\n process.stderr.write(\n \"[discord] WARN — intents:[] passed; bot will not receive message content. Pass at least [Guilds, GuildMessages, MessageContent] (EC-C).\\n\",\n );\n }\n this.client = new Client({ intents });\n this.client.on(Events.MessageCreate, async (msg) => this.handleInbound(msg));\n this.client.on(Events.Error, (err) => {\n process.stderr.write(`[discord] client error: ${err.message}\\n`);\n });\n }\n\n override async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n await new Promise<void>((resolve, reject) => {\n this.client.once(Events.ClientReady, () => resolve());\n this.client.login(this.token).catch(reject);\n });\n this.connected = true;\n return true;\n } catch (err) {\n process.stderr.write(`[discord] connect failed: ${(err as Error).message}\\n`);\n return false;\n }\n }\n\n override async disconnect(): Promise<void> {\n if (!this.connected) return;\n this.connected = false;\n try {\n await this.client.destroy();\n } catch {\n /* ignore */\n }\n }\n\n /**\n * Expose the underlying discord.js `Client` so consumers can register\n * platform-specific events that don't fit the portable contract —\n * `interactionCreate` (slash commands via Application Commands),\n * `error` event boundary, presence updates, etc. Register BEFORE\n * calling `runner.start()`.\n *\n * @public\n */\n getBot(): Client {\n return this.client;\n }\n\n override async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"text is empty\" } };\n }\n let channel: unknown;\n try {\n channel = await this.client.channels.fetch(out.channel.id);\n } catch (err) {\n return {\n ok: false,\n error: { code: \"channel_fetch_failed\", message: (err as Error).message },\n };\n }\n const sendable = channel as {\n send?: (input: { content: string; reply?: unknown }) => Promise<Message>;\n };\n if (sendable === null || typeof sendable.send !== \"function\") {\n return {\n ok: false,\n error: {\n code: \"channel_not_sendable\",\n message: `channel \"${out.channel.id}\" not text-based or missing`,\n },\n };\n }\n const chunks = splitForDiscord(out.text);\n let lastId: string | undefined;\n for (const chunk of chunks) {\n try {\n const msg = await sendable.send({\n content: chunk,\n ...(out.replyTo !== undefined ? { reply: { messageReference: out.replyTo } } : {}),\n });\n lastId = msg.id;\n } catch (err) {\n return mapSendError(err);\n }\n }\n return { ok: true, ...(lastId !== undefined ? { messageId: lastId } : {}) };\n }\n\n override onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace previous handler.\n this.handler = handler;\n return () => {\n if (this.handler === handler) this.handler = undefined;\n };\n }\n\n private async handleInbound(msg: Message): Promise<void> {\n if (this.handler === undefined) return;\n if (msg.author.bot) return;\n await this.dispatchEvent(normalizeEvent(msg));\n }\n\n /**\n * Dispatch a pre-built event to the current handler, honouring EC-H replace\n * semantics.\n *\n * Mirrors the seam `gateway-sms` already exposes. It exists because the EC-H\n * contract had no honest test without it: a real `discord.js` Message cannot\n * be synthesized, `handler` is private, and the test that claimed to cover\n * replacement asserted two counters were 0 — true whether onInbound replaces,\n * stacks, or discards. If it had regressed to `handlers.push(handler)`, the\n * agent would have replied twice to every message, double-billing tokens,\n * with the suite green.\n *\n * @internal\n */\n async dispatchEvent(event: GatewayMessageEvent): Promise<\"ok\" | \"no_handler\" | \"handler_threw\"> {\n if (this.handler === undefined) return \"no_handler\";\n try {\n await this.handler(event);\n } catch (err) {\n // Left uncaught, the rejection escaped into the platform's own error channel and was reported\n // as a client error — so a bug in the consumer's handler read as a fault in the platform\n // library, sending whoever debugged it to the wrong repository (#41). A handler is user code:\n // its failure is named as such, and delivery continues.\n const m = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[discord] handler threw: ${m}\\n`);\n return \"handler_threw\";\n }\n return \"ok\";\n }\n}\n\nfunction normalizeEvent(msg: Message): DiscordMessageEvent {\n let channelType: \"dm\" | \"group\" | \"thread\";\n if (msg.guildId === null) {\n channelType = \"dm\";\n } else if (msg.channel.isThread()) {\n channelType = \"thread\";\n } else {\n channelType = \"group\";\n }\n\n const displayName = msg.author.globalName !== null ? msg.author.globalName : msg.author.username;\n\n return {\n id: `dc-${msg.channelId}-${msg.id}`,\n platform: \"discord\",\n sender: {\n id: msg.author.id,\n username: msg.author.username,\n displayName,\n },\n channel: {\n id: msg.channelId,\n type: channelType,\n ...(msg.channel.isThread() ? { topicId: msg.channel.id } : {}),\n },\n text: msg.content,\n receivedAt: msg.createdTimestamp,\n ...(msg.reference?.messageId !== undefined ? { replyTo: msg.reference.messageId } : {}),\n discord: {\n guildId: msg.guildId,\n channelId: msg.channelId,\n messageId: msg.id,\n raw: msg,\n },\n };\n}\n\nfunction mapSendError(err: unknown): SendResult {\n if (err instanceof DiscordAPIError) {\n const codeStr = String(err.code);\n if (codeStr === \"50007\") {\n return { ok: false, error: { code: \"dm_blocked\", message: err.message } };\n }\n if (codeStr === \"50001\" || codeStr === \"50013\") {\n return { ok: false, error: { code: \"no_permission\", message: err.message } };\n }\n if (err.status === 429) {\n return { ok: false, error: { code: \"rate_limited\", message: err.message } };\n }\n return { ok: false, error: { code: `discord_${codeStr}`, message: err.message } };\n }\n return { ok: false, error: { code: \"unknown\", message: (err as Error).message } };\n}\n"]}
1
+ {"version":3,"sources":["../src/split.ts","../src/adapter.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Discord's 2000-char per-message hard limit. Split agent responses on safe\n * boundaries before sending (T6.1).\n *\n * Thin wrapper over core `chunkText` (roadmap M1). Telegram family (minus\n * markdown balancing): 2000 hard cap, 1900 soft window, `\\n\\n` → `\\n` → window\n * boundary preference, newline-only leading strip, no surrogate guard. Output\n * is byte-identical to the previous implementation (pinned by\n * `tests/split.test.ts`).\n *\n * @internal\n */\n\nimport { chunkText } from \"@theokit/gateway\";\n\nconst DISCORD_MAX_MESSAGE = 2000;\nconst SAFE_DISCORD_CHUNK = 1900;\n\nexport function splitForDiscord(text: string): string[] {\n return chunkText(text, {\n limit: DISCORD_MAX_MESSAGE,\n safeLimit: SAFE_DISCORD_CHUNK,\n boundaries: [\"\\n\\n\", \"\\n\"],\n lastResort: \"window\",\n stripLeading: /^\\n+/,\n });\n}\n","/**\n * `DiscordAdapter` — wraps discord.js in the `@theokit/gateway`\n * `BasePlatformAdapter` contract (T6.1, ADRs D171, D179).\n *\n * - `connect()` calls `client.login(token)` and awaits the `ready` event.\n * - WebSocket Gateway only (D179) — no webhook variant in v0.1.\n * - Default intents include `MessageContent` (EC-C silent-failure guard).\n * - Bot-to-bot messages ignored at adapter level (`msg.author.bot`).\n * - 2000-char message split (Discord's hard limit).\n *\n * @public\n */\n\nimport type { DiscordMessageEvent, MessageEvent as GatewayMessageEvent } from \"@theokit/gateway\";\nimport { BasePlatformAdapter, type OutboundMessage, type SendResult } from \"@theokit/gateway\";\nimport { Client, DiscordAPIError, Events, GatewayIntentBits, type Message } from \"discord.js\";\n\nimport { splitForDiscord } from \"./split.js\";\n\nexport interface DiscordAdapterOptions {\n /**\n * The Discord bot token.\n *\n * @platform-term Discord calls this a **bot token** and `discord.js` names the field `token`, so\n * the name here is theirs.\n * @issued-at The Discord Developer Portal, under the application's Bot tab.\n */\n readonly token: string;\n /**\n * Default: [Guilds, GuildMessages, MessageContent, DirectMessages,\n * DirectMessageReactions]. Without MessageContent the bot receives\n * empty `msg.content` (EC-C silent failure).\n */\n readonly intents?: GatewayIntentBits[];\n}\n\nexport const DEFAULT_DISCORD_INTENTS: ReadonlyArray<GatewayIntentBits> = [\n GatewayIntentBits.Guilds,\n GatewayIntentBits.GuildMessages,\n GatewayIntentBits.MessageContent,\n GatewayIntentBits.DirectMessages,\n GatewayIntentBits.DirectMessageReactions,\n];\n\n/**\n * Discord gateway adapter — holds a websocket the bot opens, so inbound needs no public URL.\n *\n * Reading message CONTENT requires the privileged `MessageContent` intent, which must be enabled in\n * the Discord developer portal as well as requested here; without it every `event.text` arrives\n * empty and nothing in the API says why. `DEFAULT_DISCORD_INTENTS` requests it.\n */\nexport class DiscordAdapter extends BasePlatformAdapter {\n readonly platform = \"discord\" as const;\n private readonly client: Client;\n private readonly token: string;\n private handler?: (event: GatewayMessageEvent) => Promise<void>;\n private connected = false;\n\n constructor(opts: DiscordAdapterOptions) {\n super();\n this.token = opts.token;\n const intents = (opts.intents ?? DEFAULT_DISCORD_INTENTS) as GatewayIntentBits[];\n if (intents.length === 0) {\n process.stderr.write(\n \"[discord] WARN — intents:[] passed; bot will not receive message content. Pass at least [Guilds, GuildMessages, MessageContent] (EC-C).\\n\",\n );\n }\n this.client = new Client({ intents });\n this.client.on(Events.MessageCreate, async (msg) => this.handleInbound(msg));\n this.client.on(Events.Error, (err) => {\n process.stderr.write(`[discord] client error: ${err.message}\\n`);\n });\n }\n\n override async connect(): Promise<boolean> {\n if (this.connected) return true;\n try {\n await new Promise<void>((resolve, reject) => {\n this.client.once(Events.ClientReady, () => resolve());\n this.client.login(this.token).catch(reject);\n });\n this.connected = true;\n return true;\n } catch (err) {\n process.stderr.write(`[discord] connect failed: ${(err as Error).message}\\n`);\n return false;\n }\n }\n\n override async disconnect(): Promise<void> {\n if (!this.connected) return;\n this.connected = false;\n try {\n await this.client.destroy();\n } catch {\n /* ignore */\n }\n }\n\n /**\n * Expose the underlying discord.js `Client` so consumers can register\n * platform-specific events that don't fit the portable contract —\n * `interactionCreate` (slash commands via Application Commands),\n * `error` event boundary, presence updates, etc. Register BEFORE\n * calling `runner.start()`.\n *\n * @public\n */\n getBot(): Client {\n return this.client;\n }\n\n override async sendMessage(out: OutboundMessage): Promise<SendResult> {\n if (out.text.length === 0) {\n return { ok: false, error: { code: \"empty_text\", message: \"text is empty\" } };\n }\n let channel: unknown;\n try {\n channel = await this.client.channels.fetch(out.channel.id);\n } catch (err) {\n return {\n ok: false,\n error: { code: \"channel_fetch_failed\", message: (err as Error).message },\n };\n }\n const sendable = channel as {\n send?: (input: { content: string; reply?: unknown }) => Promise<Message>;\n };\n if (sendable === null || typeof sendable.send !== \"function\") {\n return {\n ok: false,\n error: {\n code: \"channel_not_sendable\",\n message: `channel \"${out.channel.id}\" not text-based or missing`,\n },\n };\n }\n // Split FIRST, escape each chunk. The other order lets `splitForDiscord`'s hard window cut\n // land between a backslash and the character it guards: message 1 ends in a stray backslash\n // the user never typed, and message 2 opens with a bare `*` that Discord parses as markup.\n // Demonstrated in review against the real splitter.\n const chunks = splitForDiscord(out.text).map((chunk) => bodyFor(out.format, chunk));\n let lastId: string | undefined;\n for (const chunk of chunks) {\n try {\n const msg = await sendable.send({\n content: chunk,\n ...(out.replyTo !== undefined ? { reply: { messageReference: out.replyTo } } : {}),\n });\n lastId = msg.id;\n } catch (err) {\n return mapSendError(err);\n }\n }\n return { ok: true, ...(lastId !== undefined ? { messageId: lastId } : {}) };\n }\n\n override onInbound(handler: (event: GatewayMessageEvent) => Promise<void>): () => void {\n // EC-H: replace previous handler.\n this.handler = handler;\n return () => {\n if (this.handler === handler) this.handler = undefined;\n };\n }\n\n private async handleInbound(msg: Message): Promise<void> {\n if (this.handler === undefined) return;\n if (msg.author.bot) return;\n await this.dispatchEvent(normalizeEvent(msg));\n }\n\n /**\n * Dispatch a pre-built event to the current handler, honouring EC-H replace\n * semantics.\n *\n * Mirrors the seam `gateway-sms` already exposes. It exists because the EC-H\n * contract had no honest test without it: a real `discord.js` Message cannot\n * be synthesized, `handler` is private, and the test that claimed to cover\n * replacement asserted two counters were 0 — true whether onInbound replaces,\n * stacks, or discards. If it had regressed to `handlers.push(handler)`, the\n * agent would have replied twice to every message, double-billing tokens,\n * with the suite green.\n *\n * @internal\n */\n async dispatchEvent(event: GatewayMessageEvent): Promise<\"ok\" | \"no_handler\" | \"handler_threw\"> {\n if (this.handler === undefined) return \"no_handler\";\n try {\n await this.handler(event);\n } catch (err) {\n // Left uncaught, the rejection escaped into the platform's own error channel and was reported\n // as a client error — so a bug in the consumer's handler read as a fault in the platform\n // library, sending whoever debugged it to the wrong repository (#41). A handler is user code:\n // its failure is named as such, and delivery continues.\n const m = err instanceof Error ? err.message : String(err);\n process.stderr.write(`[discord] handler threw: ${m}\\n`);\n return \"handler_threw\";\n }\n return \"ok\";\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.handler, event);\n }\n}\n\nfunction normalizeEvent(msg: Message): DiscordMessageEvent {\n let channelType: \"dm\" | \"group\" | \"thread\";\n if (msg.guildId === null) {\n channelType = \"dm\";\n } else if (msg.channel.isThread()) {\n channelType = \"thread\";\n } else {\n channelType = \"group\";\n }\n\n const displayName = msg.author.globalName !== null ? msg.author.globalName : msg.author.username;\n\n return {\n id: `dc-${msg.channelId}-${msg.id}`,\n platform: \"discord\",\n sender: {\n id: msg.author.id,\n username: msg.author.username,\n displayName,\n },\n channel: {\n id: msg.channelId,\n type: channelType,\n ...(msg.channel.isThread() ? { topicId: msg.channel.id } : {}),\n },\n text: msg.content,\n receivedAt: msg.createdTimestamp,\n ...(msg.reference?.messageId !== undefined ? { replyTo: msg.reference.messageId } : {}),\n discord: {\n guildId: msg.guildId,\n channelId: msg.channelId,\n messageId: msg.id,\n raw: msg,\n },\n };\n}\n\nfunction mapSendError(err: unknown): SendResult {\n if (err instanceof DiscordAPIError) {\n const codeStr = String(err.code);\n if (codeStr === \"50007\") {\n return { ok: false, error: { code: \"dm_blocked\", message: err.message } };\n }\n if (codeStr === \"50001\" || codeStr === \"50013\") {\n return { ok: false, error: { code: \"no_permission\", message: err.message } };\n }\n if (err.status === 429) {\n return { ok: false, error: { code: \"rate_limited\", message: err.message } };\n }\n return { ok: false, error: { code: `discord_${codeStr}`, message: err.message } };\n }\n return { ok: false, error: { code: \"unknown\", message: (err as Error).message } };\n}\n\n/**\n * The text to send, with the caller's declared format applied.\n *\n * Discord parses markdown natively, so `markdown` needs no flag. `plain` is the caller stating\n * the text is NOT markup, and sending it raw would parse it anyway — a user's literal\n * `*asterisks*` arriving as italic.\n */\nfunction bodyFor(format: OutboundMessage[\"format\"], text: string): string {\n return format === \"plain\" ? escapeMarkdown(text) : text;\n}\n\n/**\n * Escape the characters this platform would otherwise parse as markup.\n *\n * Called only when the caller declared `format: \"plain\"` — an explicit statement that the text\n * is NOT markup. Without it, a user's literal `*asterisks*` render as italic on a platform that\n * parses markdown natively, which is the caller's intent being silently inverted.\n *\n * Deliberately narrow: the four characters that open an inline span. A full markdown escaper\n * would also touch `#`, `>` and `-` at line starts, which are far more common in ordinary prose\n * and whose escaping is more visible than the problem it solves.\n */\nfunction escapeMarkdown(text: string): string {\n // The backslash comes FIRST, and that ordering is the whole correctness of this function.\n // Without it a backslash already in the caller's text is left bare: `a\\*b` escapes to `a\\\\*b`,\n // the renderer consumes `\\\\` as one literal backslash, and the `*` it was guarding is left\n // naked — so text sent explicitly as `plain` arrives italicised, the exact inversion this\n // function exists to prevent. Caught in review.\n return text.replace(/([\\\\*_`~])/g, \"\\\\$1\");\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@theokit/gateway-discord",
3
- "version": "0.1.4",
3
+ "version": "0.2.0",
4
4
  "description": "Discord (discord.js) platform adapter for @theokit/gateway. ADRs D171, D179.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -29,6 +29,7 @@
29
29
  },
30
30
  "files": [
31
31
  "dist",
32
+ "shims",
32
33
  "README.md",
33
34
  "LICENSE",
34
35
  "CHANGELOG.md"
@@ -38,13 +39,15 @@
38
39
  "discord.js": "^14.16.0"
39
40
  },
40
41
  "devDependencies": {
41
- "@theokit/sdk": "^4.53.1",
42
- "discord.js": "^14.16.0",
42
+ "@stryker-mutator/core": "10",
43
+ "@stryker-mutator/vitest-runner": "10",
44
+ "@theokit/sdk": "^4.62.0",
45
+ "discord.js": "^14.27.0",
43
46
  "tsup": "^8.5.0",
44
- "typescript": "^5.8.0",
45
- "vitest": "^4.1.8",
47
+ "typescript": "5.9.3",
48
+ "vitest": "^4.1.11",
46
49
  "zod": "^4.0.0",
47
- "@theokit/gateway": "0.7.0"
50
+ "@theokit/gateway": "0.9.0"
48
51
  },
49
52
  "publishConfig": {
50
53
  "access": "public",
@@ -53,6 +56,7 @@
53
56
  "scripts": {
54
57
  "build": "tsup",
55
58
  "typecheck": "tsc --noEmit",
56
- "test": "vitest run"
59
+ "test": "vitest run",
60
+ "test:mutation": "stryker run"
57
61
  }
58
62
  }
@@ -0,0 +1,42 @@
1
+ // Optional shim — restores the `util` type that `@types/node@26` renamed (#81).
2
+ //
3
+ // NOT loaded by this package. Nothing here references it, and a consumer who does not need it is
4
+ // unaffected. That is deliberate: a library that augments Node's own types for everyone changes the
5
+ // type environment of people who never asked, and a conflict from it would surface far from here.
6
+ //
7
+ // WHEN YOU NEED IT
8
+ //
9
+ // You installed `@types/node@26` (the current `latest`) and typechecking fails inside a package you
10
+ // never installed:
11
+ //
12
+ // @sapphire/shapeshift/dist/esm/index.d.mts(1,10): error TS2305:
13
+ // Module '"util"' has no exported member 'InspectOptionsStylized'.
14
+ //
15
+ // `@types/node@26` renamed `util.InspectOptionsStylized` to `InspectContext`. `@sapphire/shapeshift@4`
16
+ // — which `discord.js` pulls through `@discordjs/builders` — still imports the old name, and
17
+ // `@sapphire/shapeshift@5` imports the new one and so breaks on `@types/node@22`. No release
18
+ // satisfies both lines, and `@discordjs/builders@1.14.1` still declares `^4.0.0`, so nothing in the
19
+ // discord.js chain reaches v5 yet.
20
+ //
21
+ // HOW TO USE IT
22
+ //
23
+ // // tsconfig.json
24
+ // { "include": ["src", "node_modules/@theokit/gateway-discord/shims/types-node-26.d.ts"] }
25
+ //
26
+ // Measured 2026-08-29 in a scratch consumer: with `@types/node@26` the project fails to compile and
27
+ // passes with this file included; with `@types/node@22` it passes either way — the declaration below
28
+ // merges with the interface that already exists there and adds nothing.
29
+ //
30
+ // WHEN TO DELETE IT
31
+ //
32
+ // When `@discordjs/builders` moves to `@sapphire/shapeshift@5`. You will not have to remember: on
33
+ // that day `pnpm quality:dts-typechecks` starts failing for the opposite reason — v5 imports
34
+ // `InspectContext`, which the `@types/node@22` this repository pins does not have — so the gate
35
+ // raises its hand rather than leaving a stale shim shipping forever.
36
+ import type { InspectOptions } from "node:util";
37
+
38
+ declare module "util" {
39
+ interface InspectOptionsStylized extends InspectOptions {
40
+ stylize(text: string, styleType: string): string;
41
+ }
42
+ }