@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 +62 -0
- package/README.md +52 -0
- package/dist/index.cjs +16 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +14 -0
- package/dist/index.d.ts +14 -0
- package/dist/index.js +16 -1
- package/dist/index.js.map +1 -1
- package/package.json +11 -7
- package/shims/types-node-26.d.ts +42 -0
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
|
package/dist/index.cjs.map
CHANGED
|
@@ -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.
|
|
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
|
-
"@
|
|
42
|
-
"
|
|
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": "
|
|
45
|
-
"vitest": "^4.1.
|
|
47
|
+
"typescript": "5.9.3",
|
|
48
|
+
"vitest": "^4.1.11",
|
|
46
49
|
"zod": "^4.0.0",
|
|
47
|
-
"@theokit/gateway": "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
|
+
}
|