@decaf-ts/integrations 0.12.0 → 0.14.2

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.
Files changed (156) hide show
  1. package/dist/integrations.cjs +1 -1
  2. package/lib/cjs/calendar/environment.cjs +48 -0
  3. package/lib/cjs/calendar/environment.cjs.map +1 -0
  4. package/lib/cjs/calendar/google-calendar/GoogleCalendarService.cjs +338 -0
  5. package/lib/cjs/calendar/google-calendar/GoogleCalendarService.cjs.map +1 -0
  6. package/lib/cjs/calendar/google-calendar/index.cjs +20 -0
  7. package/lib/cjs/calendar/google-calendar/index.cjs.map +1 -0
  8. package/lib/cjs/comms/discord/DiscordService.cjs +318 -0
  9. package/lib/cjs/comms/discord/DiscordService.cjs.map +1 -0
  10. package/lib/cjs/comms/discord/index.cjs +19 -0
  11. package/lib/cjs/comms/discord/index.cjs.map +1 -0
  12. package/lib/cjs/comms/environment.cjs +16 -0
  13. package/lib/cjs/comms/environment.cjs.map +1 -1
  14. package/lib/cjs/comms/index.cjs +3 -0
  15. package/lib/cjs/comms/index.cjs.map +1 -1
  16. package/lib/cjs/comms/outlook/MicrosoftOutlookService.cjs +325 -0
  17. package/lib/cjs/comms/outlook/MicrosoftOutlookService.cjs.map +1 -0
  18. package/lib/cjs/comms/outlook/index.cjs +19 -0
  19. package/lib/cjs/comms/outlook/index.cjs.map +1 -0
  20. package/lib/cjs/comms/whatsapp/WhatsAppService.cjs +274 -0
  21. package/lib/cjs/comms/whatsapp/WhatsAppService.cjs.map +1 -0
  22. package/lib/cjs/comms/whatsapp/index.cjs +19 -0
  23. package/lib/cjs/comms/whatsapp/index.cjs.map +1 -0
  24. package/lib/cjs/index.cjs +3 -3
  25. package/lib/cjs/io/confluence/ConfluenceService.cjs +317 -0
  26. package/lib/cjs/io/confluence/ConfluenceService.cjs.map +1 -0
  27. package/lib/cjs/io/confluence/index.cjs +19 -0
  28. package/lib/cjs/io/confluence/index.cjs.map +1 -0
  29. package/lib/cjs/io/environment.cjs +28 -0
  30. package/lib/cjs/io/environment.cjs.map +1 -1
  31. package/lib/cjs/io/google-docs/GoogleDocsService.cjs +275 -0
  32. package/lib/cjs/io/google-docs/GoogleDocsService.cjs.map +1 -0
  33. package/lib/cjs/io/google-docs/index.cjs +19 -0
  34. package/lib/cjs/io/google-docs/index.cjs.map +1 -0
  35. package/lib/cjs/io/index.cjs +5 -0
  36. package/lib/cjs/io/index.cjs.map +1 -1
  37. package/lib/cjs/io/jira/JiraService.cjs +354 -0
  38. package/lib/cjs/io/jira/JiraService.cjs.map +1 -0
  39. package/lib/cjs/io/jira/index.cjs +19 -0
  40. package/lib/cjs/io/jira/index.cjs.map +1 -0
  41. package/lib/cjs/io/microsoft-excel/MicrosoftExcelService.cjs +253 -0
  42. package/lib/cjs/io/microsoft-excel/MicrosoftExcelService.cjs.map +1 -0
  43. package/lib/cjs/io/microsoft-excel/index.cjs +19 -0
  44. package/lib/cjs/io/microsoft-excel/index.cjs.map +1 -0
  45. package/lib/cjs/io/microsoft-sharepoint/MicrosoftSharePointService.cjs +261 -0
  46. package/lib/cjs/io/microsoft-sharepoint/MicrosoftSharePointService.cjs.map +1 -0
  47. package/lib/cjs/io/microsoft-sharepoint/index.cjs +19 -0
  48. package/lib/cjs/io/microsoft-sharepoint/index.cjs.map +1 -0
  49. package/lib/cjs/sftp/aws/index.cjs +24 -0
  50. package/lib/cjs/sftp/aws/index.cjs.map +1 -0
  51. package/lib/cjs/sftp/ssh2/index.cjs +24 -0
  52. package/lib/cjs/sftp/ssh2/index.cjs.map +1 -0
  53. package/lib/esm/calendar/environment.js +44 -0
  54. package/lib/esm/calendar/environment.js.map +1 -0
  55. package/lib/esm/calendar/google-calendar/GoogleCalendarService.js +333 -0
  56. package/lib/esm/calendar/google-calendar/GoogleCalendarService.js.map +1 -0
  57. package/lib/esm/calendar/google-calendar/index.js +3 -0
  58. package/lib/esm/calendar/google-calendar/index.js.map +1 -0
  59. package/lib/esm/comms/discord/DiscordService.js +313 -0
  60. package/lib/esm/comms/discord/DiscordService.js.map +1 -0
  61. package/lib/esm/comms/discord/index.js +2 -0
  62. package/lib/esm/comms/discord/index.js.map +1 -0
  63. package/lib/esm/comms/environment.js +16 -0
  64. package/lib/esm/comms/environment.js.map +1 -1
  65. package/lib/esm/comms/index.js +3 -0
  66. package/lib/esm/comms/index.js.map +1 -1
  67. package/lib/esm/comms/outlook/MicrosoftOutlookService.js +320 -0
  68. package/lib/esm/comms/outlook/MicrosoftOutlookService.js.map +1 -0
  69. package/lib/esm/comms/outlook/index.js +2 -0
  70. package/lib/esm/comms/outlook/index.js.map +1 -0
  71. package/lib/esm/comms/whatsapp/WhatsAppService.js +269 -0
  72. package/lib/esm/comms/whatsapp/WhatsAppService.js.map +1 -0
  73. package/lib/esm/comms/whatsapp/index.js +2 -0
  74. package/lib/esm/comms/whatsapp/index.js.map +1 -0
  75. package/lib/esm/index.js +3 -3
  76. package/lib/esm/io/confluence/ConfluenceService.js +312 -0
  77. package/lib/esm/io/confluence/ConfluenceService.js.map +1 -0
  78. package/lib/esm/io/confluence/index.js +2 -0
  79. package/lib/esm/io/confluence/index.js.map +1 -0
  80. package/lib/esm/io/environment.js +28 -0
  81. package/lib/esm/io/environment.js.map +1 -1
  82. package/lib/esm/io/google-docs/GoogleDocsService.js +270 -0
  83. package/lib/esm/io/google-docs/GoogleDocsService.js.map +1 -0
  84. package/lib/esm/io/google-docs/index.js +2 -0
  85. package/lib/esm/io/google-docs/index.js.map +1 -0
  86. package/lib/esm/io/index.js +5 -0
  87. package/lib/esm/io/index.js.map +1 -1
  88. package/lib/esm/io/jira/JiraService.js +349 -0
  89. package/lib/esm/io/jira/JiraService.js.map +1 -0
  90. package/lib/esm/io/jira/index.js +2 -0
  91. package/lib/esm/io/jira/index.js.map +1 -0
  92. package/lib/esm/io/microsoft-excel/MicrosoftExcelService.js +248 -0
  93. package/lib/esm/io/microsoft-excel/MicrosoftExcelService.js.map +1 -0
  94. package/lib/esm/io/microsoft-excel/index.js +2 -0
  95. package/lib/esm/io/microsoft-excel/index.js.map +1 -0
  96. package/lib/esm/io/microsoft-sharepoint/MicrosoftSharePointService.js +256 -0
  97. package/lib/esm/io/microsoft-sharepoint/MicrosoftSharePointService.js.map +1 -0
  98. package/lib/esm/io/microsoft-sharepoint/index.js +2 -0
  99. package/lib/esm/io/microsoft-sharepoint/index.js.map +1 -0
  100. package/lib/esm/sftp/aws/index.js +7 -0
  101. package/lib/esm/sftp/aws/index.js.map +1 -0
  102. package/lib/esm/sftp/ssh2/index.js +7 -0
  103. package/lib/esm/sftp/ssh2/index.js.map +1 -0
  104. package/lib/types/calendar/environment.d.cts +48 -0
  105. package/lib/types/calendar/environment.d.mts +48 -0
  106. package/lib/types/calendar/google-calendar/GoogleCalendarService.d.cts +316 -0
  107. package/lib/types/calendar/google-calendar/GoogleCalendarService.d.mts +316 -0
  108. package/lib/types/calendar/google-calendar/index.d.cts +2 -0
  109. package/lib/types/calendar/google-calendar/index.d.mts +2 -0
  110. package/lib/types/comms/discord/DiscordService.d.cts +285 -0
  111. package/lib/types/comms/discord/DiscordService.d.mts +285 -0
  112. package/lib/types/comms/discord/index.d.cts +1 -0
  113. package/lib/types/comms/discord/index.d.mts +1 -0
  114. package/lib/types/comms/environment.d.cts +34 -8
  115. package/lib/types/comms/environment.d.mts +34 -8
  116. package/lib/types/comms/index.d.cts +3 -0
  117. package/lib/types/comms/index.d.mts +3 -0
  118. package/lib/types/comms/outlook/MicrosoftOutlookService.d.cts +282 -0
  119. package/lib/types/comms/outlook/MicrosoftOutlookService.d.mts +282 -0
  120. package/lib/types/comms/outlook/index.d.cts +1 -0
  121. package/lib/types/comms/outlook/index.d.mts +1 -0
  122. package/lib/types/comms/whatsapp/WhatsAppService.d.cts +258 -0
  123. package/lib/types/comms/whatsapp/WhatsAppService.d.mts +258 -0
  124. package/lib/types/comms/whatsapp/index.d.cts +1 -0
  125. package/lib/types/comms/whatsapp/index.d.mts +1 -0
  126. package/lib/types/index.d.cts +2 -2
  127. package/lib/types/index.d.mts +2 -2
  128. package/lib/types/io/confluence/ConfluenceService.d.cts +250 -0
  129. package/lib/types/io/confluence/ConfluenceService.d.mts +250 -0
  130. package/lib/types/io/confluence/index.d.cts +1 -0
  131. package/lib/types/io/confluence/index.d.mts +1 -0
  132. package/lib/types/io/environment.d.cts +52 -12
  133. package/lib/types/io/environment.d.mts +52 -12
  134. package/lib/types/io/google-docs/GoogleDocsService.d.cts +188 -0
  135. package/lib/types/io/google-docs/GoogleDocsService.d.mts +188 -0
  136. package/lib/types/io/google-docs/index.d.cts +1 -0
  137. package/lib/types/io/google-docs/index.d.mts +1 -0
  138. package/lib/types/io/index.d.cts +5 -0
  139. package/lib/types/io/index.d.mts +5 -0
  140. package/lib/types/io/jira/JiraService.d.cts +300 -0
  141. package/lib/types/io/jira/JiraService.d.mts +300 -0
  142. package/lib/types/io/jira/index.d.cts +1 -0
  143. package/lib/types/io/jira/index.d.mts +1 -0
  144. package/lib/types/io/microsoft-excel/MicrosoftExcelService.d.cts +230 -0
  145. package/lib/types/io/microsoft-excel/MicrosoftExcelService.d.mts +230 -0
  146. package/lib/types/io/microsoft-excel/index.d.cts +1 -0
  147. package/lib/types/io/microsoft-excel/index.d.mts +1 -0
  148. package/lib/types/io/microsoft-sharepoint/MicrosoftSharePointService.d.cts +226 -0
  149. package/lib/types/io/microsoft-sharepoint/MicrosoftSharePointService.d.mts +226 -0
  150. package/lib/types/io/microsoft-sharepoint/index.d.cts +1 -0
  151. package/lib/types/io/microsoft-sharepoint/index.d.mts +1 -0
  152. package/lib/types/sftp/aws/index.d.cts +6 -0
  153. package/lib/types/sftp/aws/index.d.mts +6 -0
  154. package/lib/types/sftp/ssh2/index.d.cts +6 -0
  155. package/lib/types/sftp/ssh2/index.d.mts +6 -0
  156. package/package.json +263 -59
@@ -0,0 +1,313 @@
1
+ /**
2
+ * @module integrations/comms/discord/service
3
+ * @summary Discord Bot API integration service for messages, channels, and reactions.
4
+ * @description Exposes the Discord Bot REST API (v10) as an undecorated
5
+ * client-based service built on {@link HttpApiService}. Configuration comes
6
+ * from an explicit `DiscordServiceConfig` or the `comms.discord` environment
7
+ * slice, and the bot token is sent as `Authorization: Bot <token>` on every
8
+ * call. Credentials are referenced from configuration (and, from as-graph
9
+ * nodes, from the resolved `discord` credential secret) and are never embedded
10
+ * in source. Failures are mapped to decaf errors via {@link httpError}.
11
+ *
12
+ * `core.comms.discord` is a callable messaging service/node. It is distinct
13
+ * from the mastra agent channel kinds `core.agent.trigger.discord` and
14
+ * `core.agent.response.discord`, which receive inbound conversations and post
15
+ * agent replies through host-supplied channel adapters.
16
+ */
17
+ import { InternalError } from "@decaf-ts/db-decorators";
18
+ import { CommsEnvironment } from "./../environment.js";
19
+ import { envNumber, envString } from "./../../shared/environmentValue.js";
20
+ import { HttpApiService, httpError, } from "./../../shared/http/index.js";
21
+ const DEFAULT_CHANNEL_TYPE = 0;
22
+ /**
23
+ * @description Discord Bot API integration service
24
+ * @summary An undecorated HTTP service for channel messages
25
+ * (`sendMessage`, `getMessage`, `listMessages`), channels (`getChannel`,
26
+ * `listChannels`, `createChannel`, `deleteChannel`), and reactions
27
+ * (`addReaction`). Every operation requires a bot token and throws
28
+ * `InternalError` when it is missing or a required identifier is empty;
29
+ * transport failures are mapped to decaf errors via {@link httpError}. This is
30
+ * the callable comms surface (`core.comms.discord`), not the mastra agent
31
+ * trigger/response kinds.
32
+ * @class DiscordService
33
+ * @extends HttpApiService
34
+ * @category Comms
35
+ * @example
36
+ * ```ts
37
+ * import { DiscordService } from "@decaf-ts/integrations/comms/discord";
38
+ *
39
+ * const discord = new DiscordService();
40
+ * await discord.initialize({ token: process.env.GRAPH_CREDENTIAL_DISCORD_TOKEN });
41
+ * await discord.sendMessage({
42
+ * channelId: process.env.DISCORD_CHANNEL_ID ?? "",
43
+ * content: "Deployment finished",
44
+ * });
45
+ * ```
46
+ * @mermaid
47
+ * sequenceDiagram
48
+ * autonumber
49
+ * participant Caller
50
+ * participant Service as DiscordService
51
+ * participant Discord as Discord Bot API
52
+ * Caller->>Service: sendMessage(input)
53
+ * activate Service
54
+ * Service->>Service: requireBotToken()
55
+ * Service->>Discord: POST /channels/{id}/messages
56
+ * activate Discord
57
+ * Discord-->>Service: message payload
58
+ * deactivate Discord
59
+ * Service-->>Caller: message payload
60
+ * deactivate Service
61
+ * @memberOf module:integrations/comms/discord/service
62
+ */
63
+ export class DiscordService extends HttpApiService {
64
+ constructor() {
65
+ super(...arguments);
66
+ /**
67
+ * @description The provider name used in error messages
68
+ */
69
+ this.serviceName = "Discord";
70
+ }
71
+ /**
72
+ * @description The Discord Bot API base URL
73
+ * @summary Used when the resolved config carries no `baseUrl`.
74
+ * @returns {string} `"https://discord.com/api/v10"`.
75
+ */
76
+ defaultBaseUrl() {
77
+ return "https://discord.com/api/v10";
78
+ }
79
+ /**
80
+ * @description Builds the Discord bot authorization header
81
+ * @summary Returns `Authorization: Bot <token>` when the config carries a
82
+ * token, and no headers otherwise.
83
+ * @param {DiscordServiceConfig} config - The resolved service configuration.
84
+ * @returns {Record<string, string>} The authorization headers (empty without a token).
85
+ */
86
+ authHeaders(config) {
87
+ return config.token ? { Authorization: `Bot ${config.token}` } : {};
88
+ }
89
+ /**
90
+ * @description Reads the Discord credentials and defaults from the environment
91
+ * @summary Reads the `comms.discord` environment slice and returns a partial
92
+ * config when a bot token is configured, `undefined` otherwise. Values pass
93
+ * through `envString`/`envNumber` to reject unset-leaf proxies.
94
+ * @returns {Partial<DiscordServiceConfig> | undefined} A partial config, or `undefined` when no Discord token is configured.
95
+ */
96
+ configFromEnvironment() {
97
+ const env = CommsEnvironment.comms.discord;
98
+ const token = envString(env?.token);
99
+ if (!token)
100
+ return undefined;
101
+ return {
102
+ token,
103
+ baseUrl: envString(env.baseUrl),
104
+ timeout: envNumber(env.timeout),
105
+ };
106
+ }
107
+ /**
108
+ * @description Asserts that a Discord bot token is configured
109
+ * @summary Called by every operation before it touches the network.
110
+ * @returns {void}
111
+ * @throws {InternalError} When the resolved config has no `token`.
112
+ */
113
+ requireBotToken() {
114
+ if (!this.config.token) {
115
+ throw new InternalError("Discord requires a bot token");
116
+ }
117
+ }
118
+ /**
119
+ * @description Builds the encoded path for a channel resource
120
+ * @summary Validates the channel ID and URL-encodes it into `/channels/<id>`.
121
+ * @param {string} channelId - The Discord channel ID.
122
+ * @returns {string} The channel API path.
123
+ * @throws {InternalError} When `channelId` is empty.
124
+ */
125
+ channelPath(channelId) {
126
+ if (!channelId) {
127
+ throw new InternalError("Discord requires a channel id");
128
+ }
129
+ return `/channels/${encodeURIComponent(channelId)}`;
130
+ }
131
+ /**
132
+ * @description Sends a message to a Discord channel
133
+ * @summary `POST`s the content (and optional `tts`/`embeds`) to the channel
134
+ * messages endpoint and returns Discord's message payload.
135
+ * @param {DiscordMessageInput} input - The destination channel and message content.
136
+ * @returns {Promise<unknown>} The created message payload.
137
+ * @throws {InternalError} When no bot token is configured.
138
+ * @throws {BadRequestError} When Discord rejects the request.
139
+ * @example
140
+ * ```ts
141
+ * await discord.sendMessage({ channelId: "1234567890", content: "Hello" });
142
+ * ```
143
+ */
144
+ async sendMessage(input) {
145
+ this.requireBotToken();
146
+ try {
147
+ const response = await this.client.post(`${this.channelPath(input.channelId)}/messages`, {
148
+ content: input.content,
149
+ tts: input.tts ?? false,
150
+ ...(input.embeds ? { embeds: input.embeds } : {}),
151
+ });
152
+ return response.data;
153
+ }
154
+ catch (error) {
155
+ throw httpError("Discord", "send message", error);
156
+ }
157
+ }
158
+ /**
159
+ * @description Fetches a single Discord message
160
+ * @summary `GET`s the message by channel and message ID and returns the
161
+ * message payload.
162
+ * @param {string} channelId - The channel containing the message.
163
+ * @param {string} messageId - The message ID to fetch.
164
+ * @returns {Promise<unknown>} The message payload.
165
+ * @throws {InternalError} When no bot token is configured or the message ID is empty.
166
+ * @throws {NotFoundError} When the message does not exist (HTTP 404).
167
+ * @throws {BadRequestError} When Discord rejects the request.
168
+ */
169
+ async getMessage(channelId, messageId) {
170
+ this.requireBotToken();
171
+ if (!messageId) {
172
+ throw new InternalError("Discord requires a message id");
173
+ }
174
+ try {
175
+ const response = await this.client.get(`${this.channelPath(channelId)}/messages/${encodeURIComponent(messageId)}`);
176
+ return response.data;
177
+ }
178
+ catch (error) {
179
+ throw httpError("Discord", "get message", error);
180
+ }
181
+ }
182
+ /**
183
+ * @description Lists messages in a Discord channel
184
+ * @summary `GET`s the channel messages with the optional `limit` and
185
+ * `before` cursor and returns Discord's message page.
186
+ * @param {DiscordMessageListInput} input - The channel and paging options.
187
+ * @returns {Promise<unknown>} The message page payload.
188
+ * @throws {InternalError} When no bot token is configured.
189
+ * @throws {BadRequestError} When Discord rejects the request.
190
+ */
191
+ async listMessages(input) {
192
+ this.requireBotToken();
193
+ try {
194
+ const response = await this.client.get(`${this.channelPath(input.channelId)}/messages`, {
195
+ params: {
196
+ ...(input.limit !== undefined ? { limit: input.limit } : {}),
197
+ ...(input.before ? { before: input.before } : {}),
198
+ },
199
+ });
200
+ return response.data;
201
+ }
202
+ catch (error) {
203
+ throw httpError("Discord", "list messages", error);
204
+ }
205
+ }
206
+ /**
207
+ * @description Fetches a Discord channel
208
+ * @summary `GET`s the channel by ID and returns its payload.
209
+ * @param {string} channelId - The channel ID to fetch.
210
+ * @returns {Promise<unknown>} The channel payload.
211
+ * @throws {InternalError} When no bot token is configured or the channel ID is empty.
212
+ * @throws {NotFoundError} When the channel does not exist (HTTP 404).
213
+ * @throws {BadRequestError} When Discord rejects the request.
214
+ */
215
+ async getChannel(channelId) {
216
+ this.requireBotToken();
217
+ try {
218
+ const response = await this.client.get(this.channelPath(channelId));
219
+ return response.data;
220
+ }
221
+ catch (error) {
222
+ throw httpError("Discord", "get channel", error);
223
+ }
224
+ }
225
+ /**
226
+ * @description Lists every channel in a Discord guild
227
+ * @summary `GET`s `/guilds/<id>/channels` and returns the channel list.
228
+ * @param {string} guildId - The guild whose channels are listed.
229
+ * @returns {Promise<unknown>} The guild channel list payload.
230
+ * @throws {InternalError} When no bot token is configured or the guild ID is empty.
231
+ * @throws {BadRequestError} When Discord rejects the request.
232
+ */
233
+ async listChannels(guildId) {
234
+ this.requireBotToken();
235
+ if (!guildId) {
236
+ throw new InternalError("Discord requires a guild id");
237
+ }
238
+ try {
239
+ const response = await this.client.get(`/guilds/${encodeURIComponent(guildId)}/channels`);
240
+ return response.data;
241
+ }
242
+ catch (error) {
243
+ throw httpError("Discord", "list channels", error);
244
+ }
245
+ }
246
+ /**
247
+ * @description Creates a channel in a Discord guild
248
+ * @summary `POST`s the channel `name`, numeric `type` (default text), and
249
+ * optional `topic`/`parentId` to the guild channels endpoint.
250
+ * @param {DiscordChannelInput} input - The guild and new channel definition.
251
+ * @returns {Promise<unknown>} The created channel payload.
252
+ * @throws {InternalError} When no bot token is configured.
253
+ * @throws {BadRequestError} When Discord rejects the request.
254
+ */
255
+ async createChannel(input) {
256
+ this.requireBotToken();
257
+ try {
258
+ const response = await this.client.post(`/guilds/${encodeURIComponent(input.guildId)}/channels`, {
259
+ name: input.name,
260
+ type: input.type ?? DEFAULT_CHANNEL_TYPE,
261
+ ...(input.topic ? { topic: input.topic } : {}),
262
+ ...(input.parentId ? { parent_id: input.parentId } : {}),
263
+ });
264
+ return response.data;
265
+ }
266
+ catch (error) {
267
+ throw httpError("Discord", "create channel", error);
268
+ }
269
+ }
270
+ /**
271
+ * @description Deletes a Discord channel
272
+ * @summary `DELETE`s the channel and returns the response payload, falling
273
+ * back to `{ deleted: true, channelId }` when Discord returns no body.
274
+ * @param {string} channelId - The channel ID to delete.
275
+ * @returns {Promise<unknown>} The deletion payload.
276
+ * @throws {InternalError} When no bot token is configured or the channel ID is empty.
277
+ * @throws {NotFoundError} When the channel does not exist (HTTP 404).
278
+ * @throws {BadRequestError} When Discord rejects the request.
279
+ */
280
+ async deleteChannel(channelId) {
281
+ this.requireBotToken();
282
+ try {
283
+ const response = await this.client.delete(this.channelPath(channelId));
284
+ return response.data ?? { deleted: true, channelId };
285
+ }
286
+ catch (error) {
287
+ throw httpError("Discord", "delete channel", error);
288
+ }
289
+ }
290
+ /**
291
+ * @description Adds a reaction to a Discord message as the bot
292
+ * @summary `PUT`s the emoji to the message's `@me` reaction endpoint and
293
+ * echoes the channel and message IDs on success.
294
+ * @param {DiscordReactionInput} input - The channel, message, and emoji.
295
+ * @returns {Promise<unknown>} `{ channelId, messageId }` on success.
296
+ * @throws {InternalError} When no bot token is configured, or the message ID or emoji is empty.
297
+ * @throws {BadRequestError} When Discord rejects the request.
298
+ */
299
+ async addReaction(input) {
300
+ this.requireBotToken();
301
+ if (!input.messageId || !input.emoji) {
302
+ throw new InternalError("Discord requires a message id and emoji");
303
+ }
304
+ try {
305
+ await this.client.put(`${this.channelPath(input.channelId)}/messages/${encodeURIComponent(input.messageId)}/reactions/${encodeURIComponent(input.emoji)}/@me`);
306
+ return { channelId: input.channelId, messageId: input.messageId };
307
+ }
308
+ catch (error) {
309
+ throw httpError("Discord", "add reaction", error);
310
+ }
311
+ }
312
+ }
313
+ //# sourceMappingURL=DiscordService.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"DiscordService.js","sourceRoot":"","sources":["../../../../src/comms/discord/DiscordService.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,2 @@
1
+ export * from "./DiscordService.js";
2
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/comms/discord/index.ts"],"names":[],"mappings":"AAAA,oCAAiC"}
@@ -54,6 +54,22 @@ export const CommsEnvironment = LoggedEnvironment.accumulate({
54
54
  baseUrl: "",
55
55
  timeout: undefined,
56
56
  },
57
+ discord: {
58
+ token: "",
59
+ baseUrl: "",
60
+ timeout: undefined,
61
+ },
62
+ whatsApp: {
63
+ token: "",
64
+ phoneNumberId: "",
65
+ baseUrl: "",
66
+ timeout: undefined,
67
+ },
68
+ outlook: {
69
+ token: "",
70
+ baseUrl: "",
71
+ timeout: undefined,
72
+ },
57
73
  },
58
74
  });
59
75
  //# sourceMappingURL=environment.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/comms/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA+DtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,UAAU,CAAC;IAC3D,KAAK,EAAE;QACL,KAAK,EAAE;YACL,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,QAAQ,EAAE;YACR,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,KAAK,EAAE;YACL,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,KAAK,EAAE;YACL,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,SAA8B;YACpC,MAAM,EAAE,SAA+B;YACvC,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,EAAE;YACT,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,SAA8B;SACxC;QACD,KAAK,EAAE;YACL,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;KACF;CACuB,CAAC,CAAC"}
1
+ {"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/comms/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAyFtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,UAAU,CAAC;IAC3D,KAAK,EAAE;QACL,KAAK,EAAE;YACL,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,QAAQ,EAAE;YACR,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,KAAK,EAAE;YACL,KAAK,EAAE,EAAE;YACT,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,KAAK,EAAE;YACL,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,EAAE;YACR,IAAI,EAAE,SAA8B;YACpC,MAAM,EAAE,SAA+B;YACvC,QAAQ,EAAE,EAAE;YACZ,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,EAAE;YACR,KAAK,EAAE,EAAE;YACT,YAAY,EAAE,EAAE;YAChB,OAAO,EAAE,SAA8B;SACxC;QACD,KAAK,EAAE;YACL,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,OAAO,EAAE;YACP,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,QAAQ,EAAE;YACR,KAAK,EAAE,EAAE;YACT,aAAa,EAAE,EAAE;YACjB,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;QACD,OAAO,EAAE;YACP,KAAK,EAAE,EAAE;YACT,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;KACF;CACuB,CAAC,CAAC"}
@@ -10,5 +10,8 @@ export * from "./gmail/index.js";
10
10
  export * from "./slack/index.js";
11
11
  export * from "./teams/index.js";
12
12
  export * from "./telegram/index.js";
13
+ export * from "./discord/index.js";
14
+ export * from "./whatsapp/index.js";
15
+ export * from "./outlook/index.js";
13
16
  export * from "./environment.js";
14
17
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/comms/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,iCAAwB;AACxB,iCAAwB;AACxB,iCAAwB;AACxB,iCAAwB;AACxB,oCAA2B;AAC3B,iCAA8B"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/comms/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,iCAAwB;AACxB,iCAAwB;AACxB,iCAAwB;AACxB,iCAAwB;AACxB,oCAA2B;AAC3B,mCAA0B;AAC1B,oCAA2B;AAC3B,mCAA0B;AAC1B,iCAA8B"}