@decaf-ts/integrations 0.12.0 → 0.14.0

package/lib/esm/calendar/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/calendar/environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AA0BtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC,UAAU,CAAC;IAC9D,QAAQ,EAAE;QACR,cAAc,EAAE;YACd,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,EAAE;YACV,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,OAAO,EAAE,SAA8B;SACxC;KACF;CAC0B,CAAC,CAAC"}

package/lib/esm/calendar/google-calendar/GoogleCalendarService.js

@@ -0,0 +1,333 @@
+/**
+ * @module integrations/calendar/google-calendar/service
+ * @summary Google Calendar API integration service for calendars and events.
+ * @description Exposes Google Calendar `v3` operations (calendar list, event
+ * list/get/create/update/delete) as an undecorated client-based service built
+ * on {@link HttpApiService}. Configuration comes from an explicit
+ * `GoogleCalendarServiceConfig` or the `calendar.googleCalendar` environment
+ * slice. An OAuth access token is sent as a bearer token when present; an API
+ * key is added as the `key` query parameter when no token is available. A
+ * default `calendarId` may be configured and falls back to `"primary"`.
+ * Credentials are referenced from configuration (and, from as-graph nodes, from
+ * the resolved `google-calendar` credential secret) and are never embedded in
+ * source. Failures are mapped to decaf errors via {@link httpError}.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { CalendarEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+/**
+ * @description Google Calendar API integration service
+ * @summary An undecorated HTTP service for listing calendars and events and
+ * for creating, reading, updating, and deleting events. Every operation needs
+ * either an OAuth token or an API key; missing credentials or identifiers raise
+ * `InternalError`, and transport failures are mapped to decaf errors via
+ * {@link httpError}.
+ * @class GoogleCalendarService
+ * @extends HttpApiService
+ * @category Calendar
+ * @example
+ * ```ts
+ * import { GoogleCalendarService } from "@decaf-ts/integrations/calendar/google-calendar";
+ *
+ * const calendar = new GoogleCalendarService();
+ * await calendar.initialize({
+ *   token: process.env.GRAPH_CREDENTIAL_GOOGLE_CALENDAR_TOKEN,
+ *   calendarId: "primary",
+ * });
+ * await calendar.listEvents({ timeMin: new Date().toISOString() });
+ * ```
+ * @mermaid
+ * sequenceDiagram
+ *   autonumber
+ *   participant Caller
+ *   participant Service as GoogleCalendarService
+ *   participant API as Google Calendar API
+ *   Caller->>Service: createEvent(input)
+ *   activate Service
+ *   Service->>Service: requireAuth()
+ *   Service->>API: POST /calendars/{id}/events
+ *   activate API
+ *   API-->>Service: created event
+ *   deactivate API
+ *   Service-->>Caller: created event
+ *   deactivate Service
+ * @memberOf module:integrations/calendar/google-calendar/service
+ */
+export class GoogleCalendarService extends HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Google Calendar";
+    }
+    /**
+     * @description The Google Calendar API base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://www.googleapis.com/calendar/v3"`.
+     */
+    defaultBaseUrl() {
+        return "https://www.googleapis.com/calendar/v3";
+    }
+    /**
+     * @description Builds the Google Calendar authorization headers
+     * @summary Returns `Authorization: Bearer <token>` when an OAuth token is
+     * configured, and no headers otherwise (API keys travel as query parameters).
+     * @param {GoogleCalendarServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization headers (empty without a token).
+     */
+    authHeaders(config) {
+        if (config.token)
+            return { Authorization: `Bearer ${config.token}` };
+        return {};
+    }
+    /**
+     * @description Reads the Google Calendar credentials and defaults from the environment
+     * @summary Reads the `calendar.googleCalendar` slice and returns a partial
+     * config when a token or API key is configured, `undefined` otherwise. Values
+     * pass through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<GoogleCalendarServiceConfig> | undefined} A partial config, or `undefined` when no credential is configured.
+     */
+    configFromEnvironment() {
+        const env = CalendarEnvironment.calendar.googleCalendar;
+        const token = envString(env?.token);
+        const apiKey = envString(env?.apiKey);
+        if (!token && !apiKey)
+            return undefined;
+        return {
+            token,
+            apiKey,
+            calendarId: envString(env.calendarId),
+            baseUrl: envString(env.baseUrl),
+            timeout: envNumber(env.timeout),
+        };
+    }
+    /**
+     * @description Asserts that an OAuth token or API key is configured
+     * @summary Called by every operation before it touches the network.
+     * @returns {void}
+     * @throws {InternalError} When neither a token nor an API key is configured.
+     */
+    requireAuth() {
+        if (!this.config.token && !this.config.apiKey) {
+            throw new InternalError("Google Calendar requires an OAuth token or an API key");
+        }
+    }
+    /**
+     * @description Builds API-key query parameters when no OAuth token is set
+     * @summary Returns `{ key }` for API-key authentication, and an empty object
+     * when an OAuth token is used (or no API key is configured).
+     * @returns {Record<string, string>} The query parameters carrying the API key, if any.
+     */
+    authParams() {
+        return this.config.token || !this.config.apiKey
+            ? {}
+            : { key: this.config.apiKey };
+    }
+    /**
+     * @description Builds the encoded events path for a calendar
+     * @summary Resolves the calendar ID from the argument, the configured
+     * default, or `"primary"`, then encodes it into
+     * `/calendars/<id>/events`.
+     * @param {string} [calendarId] - Optional per-call calendar ID.
+     * @returns {string} The calendar events API path.
+     */
+    calendarPath(calendarId) {
+        const id = calendarId ?? this.config.calendarId ?? "primary";
+        return `/calendars/${encodeURIComponent(id)}/events`;
+    }
+    /**
+     * @description Builds the Google Calendar start/end object
+     * @summary Emits `{ date }` for all-day values and `{ dateTime, timeZone? }`
+     * for values containing a `T` separator.
+     * @param {string} value - The date or date-time value.
+     * @param {string} [timeZone] - Optional IANA time zone for date-time values.
+     * @returns {Record<string, string>} The Calendar API time object.
+     */
+    eventTime(value, timeZone) {
+        if (value.includes("T")) {
+            return { dateTime: value, ...(timeZone ? { timeZone } : {}) };
+        }
+        return { date: value };
+    }
+    /**
+     * @description Lists the calendars visible to the authenticated user
+     * @summary `GET`s `/users/me/calendarList` and returns the calendar list.
+     * @returns {Promise<unknown>} The calendar list payload.
+     * @throws {InternalError} When no credential is configured.
+     * @throws {BadRequestError} When Google rejects the request.
+     */
+    async listCalendars() {
+        this.requireAuth();
+        try {
+            const response = await this.client.get("/users/me/calendarList", {
+                params: this.authParams(),
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Google Calendar", "list calendars", error);
+        }
+    }
+    /**
+     * @description Lists events in a calendar
+     * @summary `GET`s the calendar's events applying the optional time window,
+     * result cap, free-text query, and single-events flag.
+     * @param {GoogleCalendarListEventsInput} [input] - The calendar and event query options.
+     * @returns {Promise<unknown>} The event collection payload.
+     * @throws {InternalError} When no credential is configured.
+     * @throws {NotFoundError} When the calendar does not exist (HTTP 404).
+     * @throws {BadRequestError} When Google rejects the query.
+     */
+    async listEvents(input = {}) {
+        this.requireAuth();
+        try {
+            const response = await this.client.get(this.calendarPath(input.calendarId), {
+                params: {
+                    ...this.authParams(),
+                    ...(input.timeMin ? { timeMin: input.timeMin } : {}),
+                    ...(input.timeMax ? { timeMax: input.timeMax } : {}),
+                    ...(input.maxResults !== undefined
+                        ? { maxResults: input.maxResults }
+                        : {}),
+                    ...(input.q ? { q: input.q } : {}),
+                    ...(input.singleEvents !== undefined
+                        ? { singleEvents: input.singleEvents }
+                        : {}),
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Google Calendar", "list events", error);
+        }
+    }
+    /**
+     * @description Creates a Google Calendar event
+     * @summary `POST`s the event to the resolved calendar; start/end values are
+     * normalized to Calendar time objects and attendees are mapped to
+     * `{ email }` entries.
+     * @param {GoogleCalendarEventInput} input - The event definition.
+     * @returns {Promise<unknown>} The created event payload.
+     * @throws {InternalError} When no credential is configured, or the summary, start, or end is missing.
+     * @throws {NotFoundError} When the calendar does not exist (HTTP 404).
+     * @throws {BadRequestError} When Google rejects the event.
+     * @example
+     * ```ts
+     * await calendar.createEvent({
+     *   summary: "Release review",
+     *   start: "2026-11-01T09:00:00Z",
+     *   end: "2026-11-01T10:00:00Z",
+     *   attendees: ["team@example.com"],
+     * });
+     * ```
+     */
+    async createEvent(input) {
+        this.requireAuth();
+        if (!input.summary || !input.start || !input.end) {
+            throw new InternalError("Google Calendar createEvent requires summary, start, and end");
+        }
+        try {
+            const response = await this.client.post(this.calendarPath(input.calendarId), {
+                summary: input.summary,
+                ...(input.description ? { description: input.description } : {}),
+                ...(input.location ? { location: input.location } : {}),
+                start: this.eventTime(input.start, input.timeZone),
+                end: this.eventTime(input.end, input.timeZone),
+                ...(input.attendees?.length
+                    ? { attendees: input.attendees.map((email) => ({ email })) }
+                    : {}),
+            }, { params: this.authParams() });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Google Calendar", "create event", error);
+        }
+    }
+    /**
+     * @description Fetches a single Google Calendar event
+     * @summary `GET`s the event from the given calendar.
+     * @param {string} calendarId - The calendar ID (empty falls back to the configured value or `primary`).
+     * @param {string} eventId - The event ID.
+     * @returns {Promise<unknown>} The event payload.
+     * @throws {InternalError} When no credential is configured or the event ID is empty.
+     * @throws {NotFoundError} When the event does not exist (HTTP 404).
+     * @throws {BadRequestError} When Google rejects the request.
+     */
+    async getEvent(calendarId, eventId) {
+        this.requireAuth();
+        if (!eventId) {
+            throw new InternalError("Google Calendar requires an event id");
+        }
+        try {
+            const response = await this.client.get(`${this.calendarPath(calendarId)}/${encodeURIComponent(eventId)}`, { params: this.authParams() });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Google Calendar", "get event", error);
+        }
+    }
+    /**
+     * @description Partially updates a Google Calendar event
+     * @summary `PATCH`es only the supplied fields on the event, normalizing
+     * start/end and attendee values; omitted fields are left unchanged.
+     * @param {string} eventId - The event ID to update.
+     * @param {GoogleCalendarEventUpdate} input - The fields to change.
+     * @returns {Promise<unknown>} The updated event payload.
+     * @throws {InternalError} When no credential is configured or the event ID is empty.
+     * @throws {NotFoundError} When the event does not exist (HTTP 404).
+     * @throws {BadRequestError} When Google rejects the update.
+     */
+    async updateEvent(eventId, input) {
+        this.requireAuth();
+        if (!eventId) {
+            throw new InternalError("Google Calendar requires an event id");
+        }
+        try {
+            const response = await this.client.patch(`${this.calendarPath(input.calendarId)}/${encodeURIComponent(eventId)}`, {
+                ...(input.summary ? { summary: input.summary } : {}),
+                ...(input.description ? { description: input.description } : {}),
+                ...(input.location ? { location: input.location } : {}),
+                ...(input.start
+                    ? { start: this.eventTime(input.start, input.timeZone) }
+                    : {}),
+                ...(input.end
+                    ? { end: this.eventTime(input.end, input.timeZone) }
+                    : {}),
+                ...(input.attendees?.length
+                    ? { attendees: input.attendees.map((email) => ({ email })) }
+                    : {}),
+            }, { params: this.authParams() });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Google Calendar", "update event", error);
+        }
+    }
+    /**
+     * @description Deletes a Google Calendar event
+     * @summary `DELETE`s the event from the given calendar and returns
+     * `{ deleted: true, eventId }`.
+     * @param {string} calendarId - The calendar ID (empty falls back to the configured value or `primary`).
+     * @param {string} eventId - The event ID to delete.
+     * @returns {Promise<unknown>} `{ deleted: true, eventId }` on success.
+     * @throws {InternalError} When no credential is configured or the event ID is empty.
+     * @throws {NotFoundError} When the event does not exist (HTTP 404).
+     * @throws {BadRequestError} When Google rejects the deletion.
+     */
+    async deleteEvent(calendarId, eventId) {
+        this.requireAuth();
+        if (!eventId) {
+            throw new InternalError("Google Calendar requires an event id");
+        }
+        try {
+            await this.client.delete(`${this.calendarPath(calendarId)}/${encodeURIComponent(eventId)}`, { params: this.authParams() });
+            return { deleted: true, eventId };
+        }
+        catch (error) {
+            throw httpError("Google Calendar", "delete event", error);
+        }
+    }
+}
+//# sourceMappingURL=GoogleCalendarService.js.map

package/lib/esm/calendar/google-calendar/GoogleCalendarService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GoogleCalendarService.js","sourceRoot":"","sources":["../../../../src/calendar/google-calendar/GoogleCalendarService.ts"],"names":[],"mappings":"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"}

package/lib/esm/calendar/google-calendar/index.js

@@ -0,0 +1,3 @@
+export * from "./../environment.js";
+export * from "./GoogleCalendarService.js";
+//# sourceMappingURL=index.js.map

package/lib/esm/calendar/google-calendar/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/calendar/google-calendar/index.ts"],"names":[],"mappings":"AAAA,oCAA+B;AAC/B,2CAAwC"}

package/lib/esm/comms/discord/DiscordService.js

@@ -0,0 +1,313 @@
+/**
+ * @module integrations/comms/discord/service
+ * @summary Discord Bot API integration service for messages, channels, and reactions.
+ * @description Exposes the Discord Bot REST API (v10) as an undecorated
+ * client-based service built on {@link HttpApiService}. Configuration comes
+ * from an explicit `DiscordServiceConfig` or the `comms.discord` environment
+ * slice, and the bot token is sent as `Authorization: Bot <token>` on every
+ * call. Credentials are referenced from configuration (and, from as-graph
+ * nodes, from the resolved `discord` credential secret) and are never embedded
+ * in source. Failures are mapped to decaf errors via {@link httpError}.
+ *
+ * `core.comms.discord` is a callable messaging service/node. It is distinct
+ * from the mastra agent channel kinds `core.agent.trigger.discord` and
+ * `core.agent.response.discord`, which receive inbound conversations and post
+ * agent replies through host-supplied channel adapters.
+ */
+import { InternalError } from "@decaf-ts/db-decorators";
+import { CommsEnvironment } from "./../environment.js";
+import { envNumber, envString } from "./../../shared/environmentValue.js";
+import { HttpApiService, httpError, } from "./../../shared/http/index.js";
+const DEFAULT_CHANNEL_TYPE = 0;
+/**
+ * @description Discord Bot API integration service
+ * @summary An undecorated HTTP service for channel messages
+ * (`sendMessage`, `getMessage`, `listMessages`), channels (`getChannel`,
+ * `listChannels`, `createChannel`, `deleteChannel`), and reactions
+ * (`addReaction`). Every operation requires a bot token and throws
+ * `InternalError` when it is missing or a required identifier is empty;
+ * transport failures are mapped to decaf errors via {@link httpError}. This is
+ * the callable comms surface (`core.comms.discord`), not the mastra agent
+ * trigger/response kinds.
+ * @class DiscordService
+ * @extends HttpApiService
+ * @category Comms
+ * @example
+ * ```ts
+ * import { DiscordService } from "@decaf-ts/integrations/comms/discord";
+ *
+ * const discord = new DiscordService();
+ * await discord.initialize({ token: process.env.GRAPH_CREDENTIAL_DISCORD_TOKEN });
+ * await discord.sendMessage({
+ *   channelId: process.env.DISCORD_CHANNEL_ID ?? "",
+ *   content: "Deployment finished",
+ * });
+ * ```
+ * @mermaid
+ * sequenceDiagram
+ *   autonumber
+ *   participant Caller
+ *   participant Service as DiscordService
+ *   participant Discord as Discord Bot API
+ *   Caller->>Service: sendMessage(input)
+ *   activate Service
+ *   Service->>Service: requireBotToken()
+ *   Service->>Discord: POST /channels/{id}/messages
+ *   activate Discord
+ *   Discord-->>Service: message payload
+ *   deactivate Discord
+ *   Service-->>Caller: message payload
+ *   deactivate Service
+ * @memberOf module:integrations/comms/discord/service
+ */
+export class DiscordService extends HttpApiService {
+    constructor() {
+        super(...arguments);
+        /**
+         * @description The provider name used in error messages
+         */
+        this.serviceName = "Discord";
+    }
+    /**
+     * @description The Discord Bot API base URL
+     * @summary Used when the resolved config carries no `baseUrl`.
+     * @returns {string} `"https://discord.com/api/v10"`.
+     */
+    defaultBaseUrl() {
+        return "https://discord.com/api/v10";
+    }
+    /**
+     * @description Builds the Discord bot authorization header
+     * @summary Returns `Authorization: Bot <token>` when the config carries a
+     * token, and no headers otherwise.
+     * @param {DiscordServiceConfig} config - The resolved service configuration.
+     * @returns {Record<string, string>} The authorization headers (empty without a token).
+     */
+    authHeaders(config) {
+        return config.token ? { Authorization: `Bot ${config.token}` } : {};
+    }
+    /**
+     * @description Reads the Discord credentials and defaults from the environment
+     * @summary Reads the `comms.discord` environment slice and returns a partial
+     * config when a bot token is configured, `undefined` otherwise. Values pass
+     * through `envString`/`envNumber` to reject unset-leaf proxies.
+     * @returns {Partial<DiscordServiceConfig> | undefined} A partial config, or `undefined` when no Discord token is configured.
+     */
+    configFromEnvironment() {
+        const env = CommsEnvironment.comms.discord;
+        const token = envString(env?.token);
+        if (!token)
+            return undefined;
+        return {
+            token,
+            baseUrl: envString(env.baseUrl),
+            timeout: envNumber(env.timeout),
+        };
+    }
+    /**
+     * @description Asserts that a Discord bot token is configured
+     * @summary Called by every operation before it touches the network.
+     * @returns {void}
+     * @throws {InternalError} When the resolved config has no `token`.
+     */
+    requireBotToken() {
+        if (!this.config.token) {
+            throw new InternalError("Discord requires a bot token");
+        }
+    }
+    /**
+     * @description Builds the encoded path for a channel resource
+     * @summary Validates the channel ID and URL-encodes it into `/channels/<id>`.
+     * @param {string} channelId - The Discord channel ID.
+     * @returns {string} The channel API path.
+     * @throws {InternalError} When `channelId` is empty.
+     */
+    channelPath(channelId) {
+        if (!channelId) {
+            throw new InternalError("Discord requires a channel id");
+        }
+        return `/channels/${encodeURIComponent(channelId)}`;
+    }
+    /**
+     * @description Sends a message to a Discord channel
+     * @summary `POST`s the content (and optional `tts`/`embeds`) to the channel
+     * messages endpoint and returns Discord's message payload.
+     * @param {DiscordMessageInput} input - The destination channel and message content.
+     * @returns {Promise<unknown>} The created message payload.
+     * @throws {InternalError} When no bot token is configured.
+     * @throws {BadRequestError} When Discord rejects the request.
+     * @example
+     * ```ts
+     * await discord.sendMessage({ channelId: "1234567890", content: "Hello" });
+     * ```
+     */
+    async sendMessage(input) {
+        this.requireBotToken();
+        try {
+            const response = await this.client.post(`${this.channelPath(input.channelId)}/messages`, {
+                content: input.content,
+                tts: input.tts ?? false,
+                ...(input.embeds ? { embeds: input.embeds } : {}),
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Discord", "send message", error);
+        }
+    }
+    /**
+     * @description Fetches a single Discord message
+     * @summary `GET`s the message by channel and message ID and returns the
+     * message payload.
+     * @param {string} channelId - The channel containing the message.
+     * @param {string} messageId - The message ID to fetch.
+     * @returns {Promise<unknown>} The message payload.
+     * @throws {InternalError} When no bot token is configured or the message ID is empty.
+     * @throws {NotFoundError} When the message does not exist (HTTP 404).
+     * @throws {BadRequestError} When Discord rejects the request.
+     */
+    async getMessage(channelId, messageId) {
+        this.requireBotToken();
+        if (!messageId) {
+            throw new InternalError("Discord requires a message id");
+        }
+        try {
+            const response = await this.client.get(`${this.channelPath(channelId)}/messages/${encodeURIComponent(messageId)}`);
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Discord", "get message", error);
+        }
+    }
+    /**
+     * @description Lists messages in a Discord channel
+     * @summary `GET`s the channel messages with the optional `limit` and
+     * `before` cursor and returns Discord's message page.
+     * @param {DiscordMessageListInput} input - The channel and paging options.
+     * @returns {Promise<unknown>} The message page payload.
+     * @throws {InternalError} When no bot token is configured.
+     * @throws {BadRequestError} When Discord rejects the request.
+     */
+    async listMessages(input) {
+        this.requireBotToken();
+        try {
+            const response = await this.client.get(`${this.channelPath(input.channelId)}/messages`, {
+                params: {
+                    ...(input.limit !== undefined ? { limit: input.limit } : {}),
+                    ...(input.before ? { before: input.before } : {}),
+                },
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Discord", "list messages", error);
+        }
+    }
+    /**
+     * @description Fetches a Discord channel
+     * @summary `GET`s the channel by ID and returns its payload.
+     * @param {string} channelId - The channel ID to fetch.
+     * @returns {Promise<unknown>} The channel payload.
+     * @throws {InternalError} When no bot token is configured or the channel ID is empty.
+     * @throws {NotFoundError} When the channel does not exist (HTTP 404).
+     * @throws {BadRequestError} When Discord rejects the request.
+     */
+    async getChannel(channelId) {
+        this.requireBotToken();
+        try {
+            const response = await this.client.get(this.channelPath(channelId));
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Discord", "get channel", error);
+        }
+    }
+    /**
+     * @description Lists every channel in a Discord guild
+     * @summary `GET`s `/guilds/<id>/channels` and returns the channel list.
+     * @param {string} guildId - The guild whose channels are listed.
+     * @returns {Promise<unknown>} The guild channel list payload.
+     * @throws {InternalError} When no bot token is configured or the guild ID is empty.
+     * @throws {BadRequestError} When Discord rejects the request.
+     */
+    async listChannels(guildId) {
+        this.requireBotToken();
+        if (!guildId) {
+            throw new InternalError("Discord requires a guild id");
+        }
+        try {
+            const response = await this.client.get(`/guilds/${encodeURIComponent(guildId)}/channels`);
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Discord", "list channels", error);
+        }
+    }
+    /**
+     * @description Creates a channel in a Discord guild
+     * @summary `POST`s the channel `name`, numeric `type` (default text), and
+     * optional `topic`/`parentId` to the guild channels endpoint.
+     * @param {DiscordChannelInput} input - The guild and new channel definition.
+     * @returns {Promise<unknown>} The created channel payload.
+     * @throws {InternalError} When no bot token is configured.
+     * @throws {BadRequestError} When Discord rejects the request.
+     */
+    async createChannel(input) {
+        this.requireBotToken();
+        try {
+            const response = await this.client.post(`/guilds/${encodeURIComponent(input.guildId)}/channels`, {
+                name: input.name,
+                type: input.type ?? DEFAULT_CHANNEL_TYPE,
+                ...(input.topic ? { topic: input.topic } : {}),
+                ...(input.parentId ? { parent_id: input.parentId } : {}),
+            });
+            return response.data;
+        }
+        catch (error) {
+            throw httpError("Discord", "create channel", error);
+        }
+    }
+    /**
+     * @description Deletes a Discord channel
+     * @summary `DELETE`s the channel and returns the response payload, falling
+     * back to `{ deleted: true, channelId }` when Discord returns no body.
+     * @param {string} channelId - The channel ID to delete.
+     * @returns {Promise<unknown>} The deletion payload.
+     * @throws {InternalError} When no bot token is configured or the channel ID is empty.
+     * @throws {NotFoundError} When the channel does not exist (HTTP 404).
+     * @throws {BadRequestError} When Discord rejects the request.
+     */
+    async deleteChannel(channelId) {
+        this.requireBotToken();
+        try {
+            const response = await this.client.delete(this.channelPath(channelId));
+            return response.data ?? { deleted: true, channelId };
+        }
+        catch (error) {
+            throw httpError("Discord", "delete channel", error);
+        }
+    }
+    /**
+     * @description Adds a reaction to a Discord message as the bot
+     * @summary `PUT`s the emoji to the message's `@me` reaction endpoint and
+     * echoes the channel and message IDs on success.
+     * @param {DiscordReactionInput} input - The channel, message, and emoji.
+     * @returns {Promise<unknown>} `{ channelId, messageId }` on success.
+     * @throws {InternalError} When no bot token is configured, or the message ID or emoji is empty.
+     * @throws {BadRequestError} When Discord rejects the request.
+     */
+    async addReaction(input) {
+        this.requireBotToken();
+        if (!input.messageId || !input.emoji) {
+            throw new InternalError("Discord requires a message id and emoji");
+        }
+        try {
+            await this.client.put(`${this.channelPath(input.channelId)}/messages/${encodeURIComponent(input.messageId)}/reactions/${encodeURIComponent(input.emoji)}/@me`);
+            return { channelId: input.channelId, messageId: input.messageId };
+        }
+        catch (error) {
+            throw httpError("Discord", "add reaction", error);
+        }
+    }
+}
+//# sourceMappingURL=DiscordService.js.map