@statewavedev/connectors-discord 0.1.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,65 @@
+# @statewavedev/connectors-discord
+
+Discord connector for Statewave — turns server channel + thread activity into normalized episodes under `community:<guild_id>`.
+
+> Part of the [Statewave Connectors](https://github.com/smaramwbc/statewave-connectors) ecosystem.
+
+## What it ingests
+
+| Source event | Episode `kind` |
+|---|---|
+| Top-level channel message | `discord.message.posted` |
+| Reply inside a thread | `discord.thread.replied` |
+
+`v0.1` is pull-mode only — it walks `GET /channels/{id}/messages` for each channel you list, paging back via Discord's snowflake-based `before=<id>` cursor. Real-time ingestion via Discord's Gateway WebSocket (the equivalent of Slack's Socket Mode) is on the roadmap.
+
+## Quickstart
+
+```bash
+export DISCORD_BOT_TOKEN=...
+statewave-connectors sync discord \
+  --guild 1100000000000000000 \
+  --channels general,help \
+  --since 2026-01-01 \
+  --dry-run
+```
+
+`--guild` takes a server snowflake id (enable **Developer Mode** in Discord → right-click the server icon → **Copy Server ID**). `--channels` accepts ids (snowflake) or names (`general` / `#general`); the bot must already be in the guild for the lookup to work.
+
+## Bot setup
+
+1. Create a Discord application + bot at <https://discord.com/developers/applications>.
+2. Under **Bot → Privileged Gateway Intents**, enable **Message Content Intent** if you want to read message text (required for ingestion).
+3. Generate an invite URL via **OAuth2 → URL Generator** with the `bot` scope and these permissions:
+   - `View Channels`
+   - `Read Message History`
+   - `Read Public Threads` (and `Read Private Threads` for private ones, if applicable)
+4. Open the invite URL and add the bot to your server.
+5. Copy the **Bot Token** from the Bot tab and export `DISCORD_BOT_TOKEN`.
+
+## Options
+
+```
+--guild ID            guild (server) snowflake id (required)
+--channels LIST       comma-separated ids (snowflake) or names (required)
+--subject SUBJECT     override the default `community:<guild_id>` subject
+--since YYYY-MM-DD    earliest message to consider
+--max-items N         cap mapped episodes (the client honors this during paging)
+--include LIST        allow-list: messages (default)
+--dry-run             preview mapped episodes without ingesting (recommended for new use)
+```
+
+## Auth
+
+Bot token only (`DISCORD_BOT_TOKEN`). User tokens are explicitly disallowed by Discord's TOS and the connector won't accept them. The token is sent only as the `Authorization: Bot …` header to `discord.com/api/v10/*` and never anywhere else.
+
+## Status
+
+`v0.1.0` — pull-mode ingestion. See [RELEASE_NOTES.md](https://github.com/smaramwbc/statewave-connectors/blob/main/RELEASE_NOTES.md).
+
+Out of scope for v0.1 (planned):
+
+- Realtime ingestion via the Gateway WebSocket protocol
+- Forum channels (different structure: posts with implicit threads)
+- Reactions and pinned messages as signal episodes
+- DM ingestion (out of scope; Discord's privacy posture is different from a workspace tool)

package/dist/client.d.ts

@@ -0,0 +1,42 @@
+import type { DiscordChannel, DiscordGuild, DiscordMessage, DiscordUser } from "./types.js";
+export interface DiscordClientOptions {
+    /** Bot token. Required — there is no useful unauthenticated mode. */
+    token: string;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+    userAgent?: string;
+}
+export declare class DiscordClient {
+    private readonly token;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    private readonly userAgent;
+    constructor(options: DiscordClientOptions);
+    /** Verify the token + return the bot's identity. */
+    authMe(): Promise<DiscordUser>;
+    /** Resolve a guild's display name. Used to build a friendlier subject. */
+    getGuild(guildId: string): Promise<DiscordGuild>;
+    /**
+     * Resolve channel selectors against a guild's channel list. Selectors
+     * may be IDs (snowflake) or names (`general` or `#general`). The bot
+     * must already be in the guild for this to work — Discord's API doesn't
+     * expose channels of guilds the bot can't see.
+     */
+    resolveChannels(guildId: string, selectors: ReadonlyArray<string>): Promise<ReadonlyArray<DiscordChannel>>;
+    /**
+     * Page through `GET /channels/{id}/messages` using snowflake-based
+     * pagination (`before=<id>`). Discord returns messages newest-first;
+     * we reverse the accumulated array so callers see chronological order.
+     *
+     * `since` filters by the message's ISO timestamp (Discord doesn't have a
+     * native "since" param — the conventional approach is to convert your
+     * cutoff to a snowflake via the unix-millis encoding, but that adds
+     * complexity for marginal benefit at v0.1 volumes).
+     */
+    listChannelMessages(channel: DiscordChannel, guild: DiscordGuild, options?: {
+        since?: string;
+        maxItems?: number;
+    }): Promise<ReadonlyArray<DiscordMessage>>;
+    private callJson;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAK5F,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAmCD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,oBAAoB;IAsBzC,oDAAoD;IAC9C,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;IAWpC,0EAA0E;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAKtD;;;;;OAKG;IACG,eAAe,CACnB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,GAC/B,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;IAyCzC;;;;;;;;;OASG;IACG,mBAAmB,CACvB,OAAO,EAAE,cAAc,EACvB,KAAK,EAAE,YAAY,EACnB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAClD,OAAO,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;YA4C3B,QAAQ;CAyCvB"}

package/dist/client.js

@@ -0,0 +1,219 @@
+// Minimal Discord REST API client for the v0.1 pull-mode connector.
+// We hit four endpoints — `GET /users/@me` (auth probe), `GET /guilds/{id}`
+// (guild metadata), `GET /guilds/{id}/channels` (channel resolution), and
+// `GET /channels/{id}/messages` (message pagination by snowflake). The
+// connector does NOT use the realtime Gateway protocol; that's a separate
+// daemon-shape effort similar to Slack's Socket Mode.
+import { ConnectorError } from "@statewavedev/connectors-core";
+const DISCORD_API_BASE = "https://discord.com/api/v10";
+const DEFAULT_PAGE_LIMIT = 100;
+export class DiscordClient {
+    token;
+    baseUrl;
+    fetchImpl;
+    userAgent;
+    constructor(options) {
+        if (!options.token) {
+            throw new ConnectorError("DISCORD_BOT_TOKEN is required for the discord connector", {
+                code: "auth_missing",
+                connector: "discord",
+                hint: "create a Discord bot at https://discord.com/developers/applications, copy the Bot token, then export DISCORD_BOT_TOKEN=…",
+            });
+        }
+        this.token = options.token;
+        this.baseUrl = options.baseUrl ?? DISCORD_API_BASE;
+        this.fetchImpl = options.fetchImpl ?? globalThis.fetch;
+        this.userAgent =
+            options.userAgent ??
+                "DiscordBot (https://github.com/smaramwbc/statewave-connectors, 0.1.0)";
+        if (!this.fetchImpl) {
+            throw new ConnectorError("global fetch is unavailable; pass options.fetchImpl", {
+                code: "config_invalid",
+                connector: "discord",
+            });
+        }
+    }
+    /** Verify the token + return the bot's identity. */
+    async authMe() {
+        const r = await this.callJson(`/users/@me`);
+        if (!r.id) {
+            throw new ConnectorError("discord /users/@me returned no id", {
+                code: "auth_failed",
+                connector: "discord",
+            });
+        }
+        return { id: r.id, username: r.username };
+    }
+    /** Resolve a guild's display name. Used to build a friendlier subject. */
+    async getGuild(guildId) {
+        const r = await this.callJson(`/guilds/${encodeURIComponent(guildId)}`);
+        return { id: r.id, name: r.name };
+    }
+    /**
+     * Resolve channel selectors against a guild's channel list. Selectors
+     * may be IDs (snowflake) or names (`general` or `#general`). The bot
+     * must already be in the guild for this to work — Discord's API doesn't
+     * expose channels of guilds the bot can't see.
+     */
+    async resolveChannels(guildId, selectors) {
+        if (selectors.length === 0)
+            return [];
+        const channels = await this.callJson(`/guilds/${encodeURIComponent(guildId)}/channels`);
+        const byId = new Map(channels.map((c) => [c.id, c]));
+        const byName = new Map();
+        for (const c of channels) {
+            if (c.name)
+                byName.set(c.name, c);
+        }
+        const out = [];
+        const missing = [];
+        for (const sel of selectors) {
+            const cleaned = sel.replace(/^#/, "");
+            const direct = byId.get(cleaned);
+            if (direct) {
+                out.push({ id: direct.id, name: direct.name, type: direct.type, parent_id: direct.parent_id });
+                continue;
+            }
+            const named = byName.get(cleaned);
+            if (named) {
+                out.push({ id: named.id, name: named.name, type: named.type, parent_id: named.parent_id });
+                continue;
+            }
+            missing.push(sel);
+        }
+        if (missing.length > 0) {
+            throw new ConnectorError(`discord: channels not found in guild ${guildId}: ${missing.join(", ")}`, {
+                code: "not_found",
+                connector: "discord",
+                hint: "the bot must be invited to the guild AND have View Channel permission on the channels you want to ingest",
+            });
+        }
+        return out;
+    }
+    /**
+     * Page through `GET /channels/{id}/messages` using snowflake-based
+     * pagination (`before=<id>`). Discord returns messages newest-first;
+     * we reverse the accumulated array so callers see chronological order.
+     *
+     * `since` filters by the message's ISO timestamp (Discord doesn't have a
+     * native "since" param — the conventional approach is to convert your
+     * cutoff to a snowflake via the unix-millis encoding, but that adds
+     * complexity for marginal benefit at v0.1 volumes).
+     */
+    async listChannelMessages(channel, guild, options = {}) {
+        const sinceMs = options.since ? new Date(options.since).getTime() : undefined;
+        const cap = options.maxItems ?? Number.POSITIVE_INFINITY;
+        const out = [];
+        let before;
+        while (out.length < cap) {
+            const path = before
+                ? `/channels/${encodeURIComponent(channel.id)}/messages?limit=${DEFAULT_PAGE_LIMIT}&before=${encodeURIComponent(before)}`
+                : `/channels/${encodeURIComponent(channel.id)}/messages?limit=${DEFAULT_PAGE_LIMIT}`;
+            const page = await this.callJson(path);
+            if (page.length === 0)
+                break;
+            let stop = false;
+            for (const m of page) {
+                if (sinceMs !== undefined) {
+                    const tsMs = new Date(m.timestamp).getTime();
+                    if (Number.isFinite(tsMs) && tsMs < sinceMs) {
+                        stop = true;
+                        break;
+                    }
+                }
+                const adopted = adoptMessage(m, channel, guild);
+                if (adopted)
+                    out.push(adopted);
+                if (out.length >= cap) {
+                    stop = true;
+                    break;
+                }
+            }
+            if (stop)
+                break;
+            // Page back further. Discord returns newest-first, so the oldest id
+            // in this page is the cursor for the next call.
+            const last = page[page.length - 1];
+            if (!last)
+                break;
+            before = last.id;
+            if (page.length < DEFAULT_PAGE_LIMIT)
+                break;
+        }
+        return out.reverse();
+    }
+    // -- internals -----------------------------------------------------------
+    async callJson(path) {
+        const url = `${this.baseUrl}${path}`;
+        const res = await this.fetchImpl(url, {
+            method: "GET",
+            headers: {
+                Authorization: `Bot ${this.token}`,
+                Accept: "application/json",
+                "User-Agent": this.userAgent,
+            },
+        });
+        if (res.status === 401) {
+            throw new ConnectorError(`discord ${path} returned 401`, {
+                code: "auth_failed",
+                connector: "discord",
+                hint: "verify DISCORD_BOT_TOKEN is valid and matches the bot in your application",
+            });
+        }
+        if (res.status === 403) {
+            throw new ConnectorError(`discord ${path} returned 403`, {
+                code: "permission_denied",
+                connector: "discord",
+                hint: "the bot needs 'View Channel' + 'Read Message History' permissions on the target channels; for thread support also 'Read Threads'",
+            });
+        }
+        if (res.status === 429) {
+            throw new ConnectorError(`discord ${path} rate-limited (HTTP 429)`, {
+                code: "rate_limited",
+                connector: "discord",
+                hint: "Discord's per-route limits are tight; back off and retry",
+            });
+        }
+        if (!res.ok) {
+            throw new ConnectorError(`discord ${path} returned HTTP ${res.status}`, {
+                code: "network",
+                connector: "discord",
+            });
+        }
+        return (await res.json());
+    }
+}
+/**
+ * Translate the slice of a raw Discord message we care about into our typed
+ * shape. Returns `null` for messages we deliberately skip — empty content
+ * (embed-only messages), system messages (channel pins, member joins, …),
+ * and bot-author messages where we don't have meaningful text.
+ */
+function adoptMessage(m, channel, guild) {
+    // Skip system messages: types 1-12, 14-21 are member joins, pins,
+    // boost notifications, etc. We only ingest user-authored chat (0) and
+    // replies (19) for v0.1.
+    const t = m.type ?? 0;
+    if (t !== 0 && t !== 19)
+        return null;
+    if (!m.content || m.content.trim() === "")
+        return null;
+    if (!m.author)
+        return null;
+    return {
+        type: "message",
+        id: m.id,
+        channel,
+        guild,
+        author: {
+            id: m.author.id,
+            username: m.author.username,
+            global_name: m.author.global_name,
+        },
+        content: m.content,
+        timestamp: m.timestamp,
+        edited_timestamp: m.edited_timestamp ?? null,
+        message_type: t,
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createDiscordConnector } from "./sync.js";
+export type { DiscordConnectorConfig } from "./sync.js";
+export { DiscordClient } from "./client.js";
+export type { DiscordClientOptions } from "./client.js";
+export { defaultSubject, mapDiscordEvent } from "./mapper.js";
+export type { DiscordChannel, DiscordEvent, DiscordEventKind, DiscordGuild, DiscordMessage, DiscordUser, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnD,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9D,YAAY,EACV,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createDiscordConnector } from "./sync.js";
+export { DiscordClient } from "./client.js";
+export { defaultSubject, mapDiscordEvent } from "./mapper.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAEnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/mapper.d.ts

@@ -0,0 +1,9 @@
+import { type StatewaveEpisode } from "@statewavedev/connectors-core";
+import type { DiscordGuild, DiscordMessage } from "./types.js";
+export interface MapperOptions {
+    /** Override for the default `community:<guild_id>` subject. */
+    subject?: string;
+}
+export declare function defaultSubject(guild: DiscordGuild): string;
+export declare function mapDiscordEvent(message: DiscordMessage, options?: MapperOptions): StatewaveEpisode;
+//# sourceMappingURL=mapper.d.ts.map

package/dist/mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../src/mapper.ts"],"names":[],"mappings":"AAIA,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtF,OAAO,KAAK,EAEV,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAK1D;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EACvB,OAAO,GAAE,aAAkB,GAC1B,gBAAgB,CAkDlB"}

package/dist/mapper.js

@@ -0,0 +1,83 @@
+// Discord-message → Statewave-episode mapping. Side-effect-free; the
+// connector resolves channels and authors before calling this so the
+// mapper itself is a pure transformation.
+import { EpisodeBuilder } from "@statewavedev/connectors-core";
+export function defaultSubject(guild) {
+    // Guild IDs (snowflakes) are stable — using them keeps subject names
+    // safe to reuse across guild renames. Operators who want a friendlier
+    // subject can pass `--subject community:<name>` instead.
+    return `community:${guild.id}`;
+}
+export function mapDiscordEvent(message, options = {}) {
+    const subject = options.subject ?? defaultSubject(message.guild);
+    const isThreadReply = isThreadChannel(message.channel.type);
+    const kind = isThreadReply
+        ? "discord.thread.replied"
+        : "discord.message.posted";
+    const author = resolveAuthorLabel(message);
+    const channelLabel = message.channel.name
+        ? `#${message.channel.name}`
+        : message.channel.id;
+    const text = `${author} in ${channelLabel}: ${message.content}`;
+    const builder = new EpisodeBuilder({
+        subject,
+        metadata: {
+            guild_id: message.guild.id,
+            guild_name: message.guild.name,
+            channel_id: message.channel.id,
+            channel_name: message.channel.name,
+            channel_type: message.channel.type,
+        },
+    });
+    return builder.build({
+        kind,
+        text,
+        occurred_at: message.timestamp,
+        source: {
+            type: isThreadReply ? "discord.thread.reply" : "discord.message",
+            id: `${message.channel.id}:${message.id}`,
+            url: buildPermalink(message),
+        },
+        metadata: {
+            author_id: message.author.id,
+            author_label: author,
+            message_type: message.message_type ?? null,
+            edited_timestamp: message.edited_timestamp ?? null,
+            parent_id: message.channel.parent_id ?? null,
+        },
+        // Channel id + message id is unique within Discord, so this idempotency
+        // shape is safe across re-runs of the same `--since` window.
+        idempotency_parts: [
+            "discord",
+            message.guild.id,
+            message.channel.id,
+            message.id,
+            kind,
+        ],
+    });
+}
+/**
+ * Discord channel types: 0 = text, 5 = announcement, 10 = announcement
+ * thread, 11 = public thread, 12 = private thread, 15 = forum. We treat
+ * any thread-like channel (10/11/12) as a thread reply, and everything
+ * else as a top-level message.
+ */
+function isThreadChannel(type) {
+    return type === 10 || type === 11 || type === 12;
+}
+function resolveAuthorLabel(message) {
+    const a = message.author;
+    if (a.global_name)
+        return a.global_name;
+    if (a.username)
+        return a.username;
+    return `<@${a.id}>`;
+}
+/**
+ * Discord permalinks have the shape `https://discord.com/channels/<guild>/<channel>/<message>`.
+ * Reachable to anyone with View Channel permission on the channel.
+ */
+function buildPermalink(message) {
+    return `https://discord.com/channels/${message.guild.id}/${message.channel.id}/${message.id}`;
+}
+//# sourceMappingURL=mapper.js.map

package/dist/mapper.js.map

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

package/dist/sync.d.ts

@@ -0,0 +1,22 @@
+import { type StatewaveConnector } from "@statewavedev/connectors-core";
+import type { DiscordEvent } from "./types.js";
+export interface DiscordConnectorConfig {
+    /** Bot token (required). Auth + REST calls go through this. */
+    token: string;
+    /** Guild (server) id to scope ingestion to. Required because a bot may
+     * belong to multiple guilds and ingesting all of them would be expensive
+     * + surprising. */
+    guildId: string;
+    /**
+     * Channel selectors — either IDs (snowflakes) or names (`general` /
+     * `#general`). At least one is required so first-run never walks the
+     * entire guild.
+     */
+    channels: ReadonlyArray<string>;
+    /** Override subject. Defaults to `community:<guild_id>`. */
+    subject?: string;
+    baseUrl?: string;
+    fetchImpl?: typeof fetch;
+}
+export declare function createDiscordConnector(config: DiscordConnectorConfig): StatewaveConnector<DiscordConnectorConfig, DiscordEvent>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../src/sync.ts"],"names":[],"mappings":"AAIA,OAAO,EAKL,KAAK,kBAAkB,EAIxB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAkB,YAAY,EAAgC,MAAM,YAAY,CAAC;AAE7F,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd;;uBAEmB;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAChC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAKD,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,sBAAsB,GAC7B,kBAAkB,CAAC,sBAAsB,EAAE,YAAY,CAAC,CA6K1D"}

package/dist/sync.js

@@ -0,0 +1,176 @@
+// `createDiscordConnector` — pull-mode source connector for Discord.
+// Reads channel messages from a single guild via the Discord REST API
+// and emits `discord.message.posted` / `discord.thread.replied` episodes.
+import { ConnectorError, redactEpisodeText, summarizeEpisodes, } from "@statewavedev/connectors-core";
+import { DiscordClient } from "./client.js";
+import { defaultSubject, mapDiscordEvent } from "./mapper.js";
+const DEFAULT_INCLUDE = ["messages"];
+export function createDiscordConnector(config) {
+    if (!config.guildId) {
+        throw new ConnectorError("the discord connector requires a guildId — pass --guild <id>", {
+            code: "config_invalid",
+            connector: "discord",
+            hint: "find the guild id by enabling Developer Mode in Discord, then right-clicking the server icon → Copy Server ID",
+        });
+    }
+    if (!config.channels || config.channels.length === 0) {
+        throw new ConnectorError("the discord connector requires at least one channel — pass --channels <id-or-name>[,…]", {
+            code: "config_invalid",
+            connector: "discord",
+            hint: "ingesting an entire guild by default would be expensive and surprising",
+        });
+    }
+    const clientOptions = {
+        token: config.token,
+        baseUrl: config.baseUrl,
+        fetchImpl: config.fetchImpl,
+    };
+    const client = new DiscordClient(clientOptions);
+    // Cache resolved guild + channels across `check()` and `sync()` to avoid
+    // paying the auth/list cost twice within a single process lifetime.
+    let guild;
+    let resolvedChannels;
+    async function ensureGuild() {
+        if (guild)
+            return guild;
+        guild = await client.getGuild(config.guildId);
+        return guild;
+    }
+    async function ensureChannels() {
+        if (resolvedChannels)
+            return resolvedChannels;
+        resolvedChannels = await client.resolveChannels(config.guildId, config.channels);
+        return resolvedChannels;
+    }
+    return {
+        id: `discord:${config.guildId}`,
+        name: "Discord",
+        source: "discord",
+        async configure(_next) {
+            throw new ConnectorError("discord connector is configured at construction time", {
+                code: "unsupported",
+                connector: "discord",
+            });
+        },
+        async check() {
+            const details = [];
+            let status = "ok";
+            try {
+                const me = await client.authMe();
+                details.push({
+                    name: "auth",
+                    status: "ok",
+                    message: me.username ? `@${me.username} (${me.id})` : me.id,
+                });
+            }
+            catch (err) {
+                status = "error";
+                details.push({
+                    name: "auth",
+                    status: "error",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+                return { connector: "discord", status, details };
+            }
+            try {
+                const g = await ensureGuild();
+                details.push({
+                    name: "guild",
+                    status: "ok",
+                    message: g.name ? `${g.name} (${g.id})` : g.id,
+                });
+            }
+            catch (err) {
+                status = "error";
+                details.push({
+                    name: "guild",
+                    status: "error",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+                return { connector: "discord", status, details };
+            }
+            try {
+                const channels = await ensureChannels();
+                details.push({
+                    name: "channels",
+                    status: "ok",
+                    message: channels.map((c) => c.name ?? c.id).join(", "),
+                });
+            }
+            catch (err) {
+                status = "error";
+                details.push({
+                    name: "channels",
+                    status: "error",
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+            return { connector: "discord", status, details };
+        },
+        async sync(options) {
+            const startedAt = new Date().toISOString();
+            const groups = resolveGroups(options.include, options.exclude);
+            const g = await ensureGuild();
+            const channels = await ensureChannels();
+            const subject = options.subject ?? config.subject ?? defaultSubject(g);
+            const since = options.since ? new Date(options.since).toISOString() : undefined;
+            const events = [];
+            if (groups.has("messages")) {
+                for (const channel of channels) {
+                    const msgs = await client.listChannelMessages(channel, g, {
+                        since,
+                        maxItems: options.maxItems,
+                    });
+                    for (const m of msgs)
+                        events.push(m);
+                }
+            }
+            const max = options.maxItems ?? Number.POSITIVE_INFINITY;
+            const limited = events.slice(0, max);
+            const episodes = limited.map((ev) => {
+                const ep = mapDiscordEvent(ev, { subject });
+                return options.redaction ? redactEpisodeText(ep, options.redaction) : ep;
+            });
+            const dryRun = !!options.dryRun;
+            const ingested = dryRun ? 0 : episodes.length;
+            const finishedAt = new Date().toISOString();
+            const threadReplies = limited.filter((m) => isThreadChannelType(m.channel.type)).length;
+            const topLevel = limited.length - threadReplies;
+            const details = {
+                events_fetched: events.length,
+                events_mapped: episodes.length,
+                events_messages: topLevel,
+                events_thread_replies: threadReplies,
+                channels_synced: channels.length,
+            };
+            return {
+                connector: "discord",
+                source: "discord",
+                subject,
+                episodes,
+                ingested,
+                skipped: events.length - episodes.length,
+                dryRun,
+                startedAt,
+                finishedAt,
+                summary: summarizeEpisodes(episodes, details),
+            };
+        },
+        async mapEvent(event) {
+            return mapDiscordEvent(event, {
+                subject: config.subject ?? defaultSubject(event.guild),
+            });
+        },
+    };
+}
+function resolveGroups(include, exclude) {
+    const base = new Set(include?.length ? include : DEFAULT_INCLUDE);
+    if (exclude)
+        for (const e of exclude)
+            base.delete(e);
+    return base;
+}
+function isThreadChannelType(type) {
+    return type === 10 || type === 11 || type === 12;
+}
+//# sourceMappingURL=sync.js.map

package/dist/sync.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,49 @@
+export type DiscordEventKind = "discord.message.posted" | "discord.thread.replied";
+/** A Discord guild ("server" in the UI). Used to root the default subject. */
+export interface DiscordGuild {
+    id: string;
+    name?: string;
+}
+/** A Discord channel — either a normal text channel or a thread. */
+export interface DiscordChannel {
+    id: string;
+    /** Channel name without leading `#`. May be undefined when the connector
+     * resolved by id only. */
+    name?: string;
+    /** Discord channel types: 0 = text, 11 = public thread, 12 = private thread. */
+    type?: number;
+    /** Set on threads — id of the parent text channel. */
+    parent_id?: string;
+}
+/** Discord user record (we only ingest `id` + `username` in v0.1). */
+export interface DiscordUser {
+    id: string;
+    username?: string;
+    global_name?: string;
+}
+/**
+ * One Discord message we ingest. The mapper picks `discord.message.posted`
+ * vs `discord.thread.replied` based on whether the channel is a thread
+ * (parent_id present) or a top-level text channel.
+ */
+export interface DiscordMessage {
+    type: "message";
+    /** Discord message id (snowflake). Doubles as the timestamp source. */
+    id: string;
+    channel: DiscordChannel;
+    guild: DiscordGuild;
+    author: DiscordUser;
+    /** Message text. Discord allows empty strings for embed-only messages;
+     * the connector skips those. */
+    content: string;
+    /** ISO-8601 timestamp of when Discord stored the message. */
+    timestamp: string;
+    /** Set when the message was edited; we don't ingest edits as separate
+     * episodes in v0.1 but pass it through metadata. */
+    edited_timestamp?: string | null;
+    /** Discord type code: 0 = default, 19 = reply, 21 = thread starter, …
+     * v0.1 ingests only types we recognise as conversational content. */
+    message_type?: number;
+}
+export type DiscordEvent = DiscordMessage;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,gBAAgB,GACxB,wBAAwB,GACxB,wBAAwB,CAAC;AAE7B,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,oEAAoE;AACpE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX;8BAC0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,SAAS,CAAC;IAChB,uEAAuE;IACvE,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,WAAW,CAAC;IACpB;oCACgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB;wDACoD;IACpD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;yEACqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC"}

package/dist/types.js

@@ -0,0 +1,7 @@
+// Public types for the Discord connector. Models the slice of Discord's
+// API the v0.1 pull connector reads — channel messages and active
+// threads. Forum channels, reactions, and the realtime Gateway protocol
+// are deliberately out of scope here; if/when we add them they bring
+// their own event kinds.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,kEAAkE;AAClE,wEAAwE;AACxE,qEAAqE;AACrE,yBAAyB"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@statewavedev/connectors-discord",
+  "version": "0.1.0",
+  "description": "Discord connector for Statewave — server channels and thread replies as normalized episodes",
+  "license": "Apache-2.0",
+  "author": "Statewave <hello@statewave.ai>",
+  "homepage": "https://statewave.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/smaramwbc/statewave-connectors.git",
+    "directory": "packages/discord"
+  },
+  "bugs": {
+    "url": "https://github.com/smaramwbc/statewave-connectors/issues"
+  },
+  "keywords": [
+    "statewave",
+    "connectors",
+    "discord",
+    "ai",
+    "agents",
+    "memory",
+    "community"
+  ],
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "!**/*.tsbuildinfo",
+    "!**/*.test.*"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "sideEffects": false,
+  "dependencies": {
+    "@statewavedev/connectors-core": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0",
+    "@types/node": "^22.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  }
+}