@buape/carbon 0.6.1 → 0.8.0

package/dist/src/plugins/gateway/GatewayPlugin.js

@@ -0,0 +1,249 @@
+import { EventEmitter } from "node:events";
+import WebSocket from "ws";
+import { Plugin } from "../../abstracts/Plugin.js";
+import { ListenerEvent } from "../../types/index.js";
+import { GatewayCloseCodes, GatewayOpcodes } from "./types.js";
+import { startHeartbeat, stopHeartbeat } from "./utils/heartbeat.js";
+import { ConnectionMonitor } from "./utils/monitor.js";
+import { createIdentifyPayload, createResumePayload, validatePayload } from "./utils/payload.js";
+export class GatewayPlugin extends Plugin {
+    id = "gateway";
+    client;
+    config;
+    state;
+    ws = null;
+    monitor;
+    heartbeatInterval;
+    sequence = null;
+    lastHeartbeatAck = true;
+    emitter;
+    reconnectAttempts = 0;
+    shardId;
+    totalShards;
+    gatewayInfo;
+    constructor(options, gatewayInfo) {
+        super();
+        this.config = {
+            reconnect: {
+                maxAttempts: 5,
+                baseDelay: 1000,
+                maxDelay: 30000
+            },
+            ...options
+        };
+        this.state = {
+            sequence: null,
+            sessionId: null,
+            resumeGatewayUrl: null
+        };
+        this.monitor = new ConnectionMonitor();
+        this.emitter = new EventEmitter();
+        this.gatewayInfo = gatewayInfo;
+        this.monitor.on("metrics", (metrics) => this.emitter.emit("metrics", metrics));
+        this.monitor.on("warning", (warning) => this.emitter.emit("warning", warning));
+    }
+    async registerClient(client) {
+        this.client = client;
+        if (!this.gatewayInfo) {
+            try {
+                const response = await fetch("https://discord.com/api/v10/gateway/bot", {
+                    headers: {
+                        Authorization: `Bot ${client.options.token}`
+                    }
+                });
+                this.gatewayInfo = (await response.json());
+            }
+            catch (error) {
+                throw new Error(`Failed to get gateway information from Discord: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        this.connect();
+    }
+    connect(resume = false) {
+        const url = resume && this.state.resumeGatewayUrl
+            ? this.state.resumeGatewayUrl
+            : (this.gatewayInfo?.url ??
+                this.config.url ??
+                "wss://gateway.discord.gg/?v=10&encoding=json");
+        this.ws = this.createWebSocket(url);
+        this.setupWebSocket();
+    }
+    disconnect() {
+        stopHeartbeat(this);
+        this.ws?.close();
+        this.ws = null;
+        this.monitor.destroy();
+    }
+    createWebSocket(url) {
+        if (!url) {
+            throw new Error("Gateway URL is required");
+        }
+        return new WebSocket(url);
+    }
+    setupWebSocket() {
+        if (!this.ws)
+            return;
+        this.ws.on("open", () => {
+            this.reconnectAttempts = 0;
+            this.emitter.emit("debug", "WebSocket connection opened");
+        });
+        this.ws.on("message", (data) => {
+            this.monitor.recordMessageReceived();
+            const payload = validatePayload(data.toString());
+            if (!payload) {
+                this.monitor.recordError();
+                this.emitter.emit("error", new Error("Invalid gateway payload received"));
+                return;
+            }
+            const { op, d, s, t } = payload;
+            if (s)
+                this.sequence = s;
+            switch (op) {
+                case GatewayOpcodes.Hello: {
+                    const helloData = d;
+                    const interval = helloData.heartbeat_interval;
+                    startHeartbeat(this, {
+                        interval,
+                        reconnectCallback: () => this.handleZombieConnection()
+                    });
+                    if (this.canResume()) {
+                        this.resume();
+                    }
+                    else {
+                        this.identify();
+                    }
+                    break;
+                }
+                case GatewayOpcodes.HeartbeatAck:
+                    this.lastHeartbeatAck = true;
+                    this.monitor.recordHeartbeatAck();
+                    break;
+                case GatewayOpcodes.Dispatch: {
+                    const payload1 = payload;
+                    const t1 = payload1.t;
+                    if (!Object.values(ListenerEvent).includes(t1))
+                        throw new Error(`Unknown event type: ${t1}`);
+                    if (t1 === "READY") {
+                        const readyData = d;
+                        this.state.sessionId = readyData.session_id;
+                        this.state.resumeGatewayUrl = readyData.resume_gateway_url;
+                    }
+                    if (t && this.client) {
+                        if (!this.config.eventFilter || this.config.eventFilter?.(t1)) {
+                            this.client.eventHandler.handleEvent(payload1.d, t1);
+                        }
+                    }
+                    break;
+                }
+                case GatewayOpcodes.InvalidSession: {
+                    const canResume = Boolean(d);
+                    setTimeout(() => {
+                        if (canResume && this.canResume()) {
+                            this.connect(true);
+                        }
+                        else {
+                            this.state.sessionId = null;
+                            this.state.resumeGatewayUrl = null;
+                            this.sequence = null;
+                            this.connect(false);
+                        }
+                    }, 5000);
+                    break;
+                }
+                case GatewayOpcodes.Reconnect:
+                    this.handleReconnect();
+                    break;
+            }
+        });
+        this.ws.on("close", (code) => {
+            this.emitter.emit("debug", `WebSocket connection closed with code ${code}`);
+            this.monitor.recordReconnect();
+            this.handleClose(code);
+        });
+        this.ws.on("error", (error) => {
+            this.monitor.recordError();
+            this.emitter.emit("error", error);
+        });
+    }
+    handleReconnectionAttempt(options) {
+        const { maxAttempts = 5, baseDelay = 1000, maxDelay = 30000 } = this.config.reconnect ?? {};
+        if (this.reconnectAttempts >= maxAttempts) {
+            this.emitter.emit("error", new Error(`Max reconnect attempts (${maxAttempts}) reached${options.code ? ` after code ${options.code}` : ""}`));
+            return;
+        }
+        if (options.code) {
+            switch (options.code) {
+                case GatewayCloseCodes.AuthenticationFailed:
+                case GatewayCloseCodes.InvalidAPIVersion:
+                case GatewayCloseCodes.InvalidIntents:
+                case GatewayCloseCodes.DisallowedIntents:
+                case GatewayCloseCodes.ShardingRequired: {
+                    this.emitter.emit("error", new Error(`Fatal Gateway error: ${options.code}`));
+                    this.reconnectAttempts = maxAttempts;
+                    return;
+                }
+                case GatewayCloseCodes.InvalidSeq:
+                case GatewayCloseCodes.SessionTimedOut: {
+                    this.state.sessionId = null;
+                    this.state.resumeGatewayUrl = null;
+                    this.sequence = null;
+                    options.forceNoResume = true;
+                    break;
+                }
+            }
+        }
+        this.reconnectAttempts++;
+        const backoffTime = Math.min(baseDelay * 2 ** this.reconnectAttempts, maxDelay);
+        if (options.isZombieConnection) {
+            this.monitor.recordZombieConnection();
+        }
+        this.disconnect();
+        const shouldResume = !options.forceNoResume && this.canResume();
+        this.emitter.emit("debug", `${shouldResume ? "Attempting resume" : "Reconnecting"} with backoff: ${backoffTime}ms${options.code ? ` after code ${options.code}` : ""}`);
+        setTimeout(() => this.connect(shouldResume), backoffTime);
+    }
+    handleClose(code) {
+        this.handleReconnectionAttempt({ code });
+    }
+    handleZombieConnection() {
+        this.handleReconnectionAttempt({ isZombieConnection: true });
+    }
+    handleReconnect() {
+        this.handleReconnectionAttempt({});
+    }
+    canResume() {
+        return Boolean(this.state.sessionId && this.sequence);
+    }
+    resume() {
+        if (!this.client || !this.state.sessionId || this.sequence === null)
+            return;
+        const payload = createResumePayload({
+            token: this.client.options.token,
+            sessionId: this.state.sessionId,
+            sequence: this.sequence
+        });
+        this.send(payload);
+    }
+    send(payload) {
+        if (this.ws && this.ws.readyState === 1) {
+            this.ws.send(JSON.stringify(payload));
+            this.monitor.recordMessageSent();
+        }
+    }
+    identify() {
+        if (!this.client)
+            return;
+        const payload = createIdentifyPayload({
+            token: this.client.options.token,
+            intents: this.config.intents,
+            properties: {
+                os: process.platform,
+                browser: "@buape/carbon - https://carbon.buape.com",
+                device: "@buape/carbon - https://carbon.buape.com"
+            },
+            ...(this.config.shard ? { shard: this.config.shard } : {})
+        });
+        this.send(payload);
+    }
+}
+//# sourceMappingURL=GatewayPlugin.js.map

package/dist/src/plugins/gateway/GatewayPlugin.js.map

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

package/dist/src/plugins/gateway/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./GatewayPlugin.js";
+export * from "./types.js";
+export * from "./utils/heartbeat.js";
+export * from "./utils/monitor.js";
+export * from "./utils/payload.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/plugins/gateway/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/dist/src/plugins/gateway/index.js

@@ -0,0 +1,6 @@
+export * from "./GatewayPlugin.js";
+export * from "./types.js";
+export * from "./utils/heartbeat.js";
+export * from "./utils/monitor.js";
+export * from "./utils/payload.js";
+//# sourceMappingURL=index.js.map

package/dist/src/plugins/gateway/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/plugins/gateway/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,YAAY,CAAA;AAC1B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,oBAAoB,CAAA"}

package/dist/src/plugins/gateway/types.d.ts

@@ -0,0 +1,62 @@
+import { type APIGatewayBotInfo, GatewayCloseCodes as DiscordGatewayCloseCodes, GatewayOpcodes as DiscordGatewayOpcodes, GatewayIntentBits, type GatewayReadyDispatchData } from "discord-api-types/v10";
+import type { ListenerEventType } from "../../types/index.js";
+export interface GatewayPluginOptions {
+    /**
+     * The intents to use for the client
+     */
+    intents: number;
+    /**
+     * The URL of the gateway to connect to
+     */
+    url?: string;
+    /**
+     * The shard to connect to
+     * [shard_id, num_shards]
+     */
+    shard?: [number, number];
+    /**
+     * The reconnect options
+     */
+    reconnect?: {
+        /**
+         * The maximum number of reconnect attempts
+         */
+        maxAttempts?: number;
+        /**
+         * The base delay between reconnect attempts
+         */
+        baseDelay?: number;
+        /**
+         * The maximum delay between reconnect attempts after it scales exponentially
+         */
+        maxDelay?: number;
+    };
+    /**
+     * This is a custom function you can provide that will filter events.
+     * If this function is present, the plugin will only process events that return `true`.
+     */
+    eventFilter?: (event: ListenerEventType) => boolean;
+}
+/**
+ * Represents the current state of the Gateway connection
+ */
+export interface GatewayState {
+    /** Last sequence number received from Gateway - used for resuming connections */
+    sequence: number | null;
+    /** Current session ID - used for resuming connections */
+    sessionId: string | null;
+    /** URL for resuming the Gateway connection if disconnected */
+    resumeGatewayUrl: string | null;
+}
+export declare const GatewayOpcodes: typeof DiscordGatewayOpcodes;
+export declare const GatewayCloseCodes: typeof DiscordGatewayCloseCodes;
+export interface GatewayPayload {
+    op: (typeof GatewayOpcodes)[keyof typeof GatewayOpcodes];
+    d?: unknown;
+    s?: number | null;
+    t?: string | null;
+}
+export type ReadyEventData = GatewayReadyDispatchData;
+export declare const GatewayIntents: typeof GatewayIntentBits;
+export type { APIGatewayBotInfo };
+//# sourceMappingURL=types.d.ts.map

package/dist/src/plugins/gateway/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/gateway/types.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,KAAK,iBAAiB,EACtB,iBAAiB,IAAI,wBAAwB,EAC7C,cAAc,IAAI,qBAAqB,EACvC,iBAAiB,EACjB,KAAK,wBAAwB,EAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAE7D,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACxB;;OAEG;IACH,SAAS,CAAC,EAAE;QACX;;WAEG;QACH,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB;;WAEG;QACH,QAAQ,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAA;CACnD;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC5B,iFAAiF;IACjF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,yDAAyD;IACzD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,8DAA8D;IAC9D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED,eAAO,MAAM,cAAc,8BAAwB,CAAA;AACnD,eAAO,MAAM,iBAAiB,iCAA2B,CAAA;AAEzD,MAAM,WAAW,cAAc;IAC9B,EAAE,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;IACxD,CAAC,CAAC,EAAE,OAAO,CAAA;IACX,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACjB,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,wBAAwB,CAAA;AAErD,eAAO,MAAM,cAAc,0BAAoB,CAAA;AAE/C,YAAY,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/src/plugins/gateway/types.js

@@ -0,0 +1,5 @@
+import { GatewayCloseCodes as DiscordGatewayCloseCodes, GatewayOpcodes as DiscordGatewayOpcodes, GatewayIntentBits } from "discord-api-types/v10";
+export const GatewayOpcodes = DiscordGatewayOpcodes;
+export const GatewayCloseCodes = DiscordGatewayCloseCodes;
+export const GatewayIntents = GatewayIntentBits;
+//# sourceMappingURL=types.js.map

package/dist/src/plugins/gateway/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/plugins/gateway/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,iBAAiB,IAAI,wBAAwB,EAC7C,cAAc,IAAI,qBAAqB,EACvC,iBAAiB,EAEjB,MAAM,uBAAuB,CAAA;AAqD9B,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAA;AACnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,wBAAwB,CAAA;AAWzD,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAA"}

package/dist/src/plugins/gateway/utils/heartbeat.d.ts

@@ -0,0 +1,17 @@
+import { GatewayOpcodes } from "../types.js";
+export interface HeartbeatManager {
+    sequence: number | null;
+    lastHeartbeatAck: boolean;
+    heartbeatInterval?: NodeJS.Timeout;
+    send(payload: {
+        op: (typeof GatewayOpcodes)[keyof typeof GatewayOpcodes];
+        d: number | null;
+    }): void;
+}
+export interface HeartbeatOptions {
+    interval: number;
+    reconnectCallback: () => void;
+}
+export declare function startHeartbeat(manager: HeartbeatManager, options: HeartbeatOptions): void;
+export declare function stopHeartbeat(manager: HeartbeatManager): void;
+//# sourceMappingURL=heartbeat.d.ts.map

package/dist/src/plugins/gateway/utils/heartbeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/gateway/utils/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,gBAAgB,EAAE,OAAO,CAAA;IACzB,iBAAiB,CAAC,EAAE,MAAM,CAAC,OAAO,CAAA;IAClC,IAAI,CAAC,OAAO,EAAE;QACb,EAAE,EAAE,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,OAAO,cAAc,CAAC,CAAA;QACxD,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAChB,GAAG,IAAI,CAAA;CACR;AAED,MAAM,WAAW,gBAAgB;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,iBAAiB,EAAE,MAAM,IAAI,CAAA;CAC7B;AAED,wBAAgB,cAAc,CAC7B,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,gBAAgB,GACvB,IAAI,CAuBN;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAK7D"}

package/dist/src/plugins/gateway/utils/heartbeat.js

@@ -0,0 +1,28 @@
+import { GatewayOpcodes } from "../types.js";
+export function startHeartbeat(manager, options) {
+    stopHeartbeat(manager);
+    const jitter = Math.random() * 1000;
+    const interval = options.interval + jitter;
+    manager.heartbeatInterval = setInterval(() => {
+        if (!manager.lastHeartbeatAck) {
+            options.reconnectCallback();
+            return;
+        }
+        manager.lastHeartbeatAck = false;
+        manager.send({
+            op: GatewayOpcodes.Heartbeat,
+            d: manager.sequence
+        });
+    }, interval);
+    manager.send({
+        op: GatewayOpcodes.Heartbeat,
+        d: manager.sequence
+    });
+}
+export function stopHeartbeat(manager) {
+    if (manager.heartbeatInterval) {
+        clearInterval(manager.heartbeatInterval);
+        manager.heartbeatInterval = undefined;
+    }
+}
+//# sourceMappingURL=heartbeat.js.map

package/dist/src/plugins/gateway/utils/heartbeat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat.js","sourceRoot":"","sources":["../../../../../src/plugins/gateway/utils/heartbeat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAiB5C,MAAM,UAAU,cAAc,CAC7B,OAAyB,EACzB,OAAyB;IAEzB,aAAa,CAAC,OAAO,CAAC,CAAA;IAEtB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAA;IACnC,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAA;IAE1C,OAAO,CAAC,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5C,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;YAC/B,OAAO,CAAC,iBAAiB,EAAE,CAAA;YAC3B,OAAM;QACP,CAAC;QAED,OAAO,CAAC,gBAAgB,GAAG,KAAK,CAAA;QAChC,OAAO,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,cAAc,CAAC,SAAS;YAC5B,CAAC,EAAE,OAAO,CAAC,QAAQ;SACnB,CAAC,CAAA;IACH,CAAC,EAAE,QAAQ,CAAC,CAAA;IAEZ,OAAO,CAAC,IAAI,CAAC;QACZ,EAAE,EAAE,cAAc,CAAC,SAAS;QAC5B,CAAC,EAAE,OAAO,CAAC,QAAQ;KACnB,CAAC,CAAA;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAyB;IACtD,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;QAC/B,aAAa,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAA;QACxC,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAA;IACtC,CAAC;AACF,CAAC"}

package/dist/src/plugins/gateway/utils/monitor.d.ts

@@ -0,0 +1,35 @@
+import { EventEmitter } from "node:events";
+export interface ConnectionMetrics {
+    latency: number;
+    uptime: number;
+    reconnects: number;
+    zombieConnections: number;
+    messagesReceived: number;
+    messagesSent: number;
+    errors: number;
+}
+export interface MonitorConfig {
+    /** Monitoring interval in milliseconds (default: 60000) */
+    interval?: number;
+    /** Warning threshold for latency in milliseconds (default: 1000) */
+    latencyThreshold?: number;
+}
+export declare class ConnectionMonitor extends EventEmitter {
+    private metrics;
+    private startTime;
+    private lastHeartbeat;
+    private metricsInterval;
+    private readonly config;
+    constructor(config?: MonitorConfig);
+    recordError(): void;
+    recordZombieConnection(): void;
+    recordHeartbeat(): void;
+    recordHeartbeatAck(): void;
+    recordReconnect(): void;
+    recordMessageReceived(): void;
+    recordMessageSent(): void;
+    getMetrics(): ConnectionMetrics;
+    reset(): void;
+    destroy(): void;
+}
+//# sourceMappingURL=monitor.d.ts.map

package/dist/src/plugins/gateway/utils/monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/gateway/utils/monitor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,iBAAiB,EAAE,MAAM,CAAA;IACzB,gBAAgB,EAAE,MAAM,CAAA;IACxB,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,aAAa;IAC7B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,qBAAa,iBAAkB,SAAQ,YAAY;IAClD,OAAO,CAAC,OAAO,CAQd;IAED,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,eAAe,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;gBAEpC,MAAM,GAAE,aAAkB;IA2B/B,WAAW,IAAI,IAAI;IAInB,sBAAsB,IAAI,IAAI;IAI9B,eAAe,IAAI,IAAI;IAIvB,kBAAkB,IAAI,IAAI;IAM1B,eAAe,IAAI,IAAI;IAIvB,qBAAqB,IAAI,IAAI;IAI7B,iBAAiB,IAAI,IAAI;IAIzB,UAAU,IAAI,iBAAiB;IAI/B,KAAK,IAAI,IAAI;IAcb,OAAO,IAAI,IAAI;CAItB"}

package/dist/src/plugins/gateway/utils/monitor.js

@@ -0,0 +1,79 @@
+import { EventEmitter } from "node:events";
+export class ConnectionMonitor extends EventEmitter {
+    metrics = {
+        latency: 0,
+        uptime: 0,
+        reconnects: 0,
+        zombieConnections: 0,
+        messagesReceived: 0,
+        messagesSent: 0,
+        errors: 0
+    };
+    startTime = Date.now();
+    lastHeartbeat = 0;
+    metricsInterval;
+    config;
+    constructor(config = {}) {
+        super();
+        this.config = {
+            interval: config.interval ?? 60000,
+            latencyThreshold: config.latencyThreshold ?? 1000
+        };
+        this.metricsInterval = setInterval(() => {
+            this.metrics.uptime = Date.now() - this.startTime;
+            this.emit("metrics", this.getMetrics());
+            if (this.metrics.latency > this.config.latencyThreshold) {
+                this.emit("warning", `High latency detected: ${this.metrics.latency}ms`);
+            }
+            const errorRate = (this.metrics.errors /
+                (this.metrics.uptime / 60000)).toFixed(1);
+            if (Number(errorRate) > 5) {
+                this.emit("warning", `High error rate detected: ${errorRate} errors/minute`);
+            }
+        }, this.config.interval);
+    }
+    recordError() {
+        this.metrics.errors++;
+    }
+    recordZombieConnection() {
+        this.metrics.zombieConnections++;
+    }
+    recordHeartbeat() {
+        this.lastHeartbeat = Date.now();
+    }
+    recordHeartbeatAck() {
+        if (this.lastHeartbeat > 0) {
+            this.metrics.latency = Date.now() - this.lastHeartbeat;
+        }
+    }
+    recordReconnect() {
+        this.metrics.reconnects++;
+    }
+    recordMessageReceived() {
+        this.metrics.messagesReceived++;
+    }
+    recordMessageSent() {
+        this.metrics.messagesSent++;
+    }
+    getMetrics() {
+        return { ...this.metrics };
+    }
+    reset() {
+        this.metrics = {
+            latency: 0,
+            uptime: 0,
+            reconnects: 0,
+            zombieConnections: 0,
+            messagesReceived: 0,
+            messagesSent: 0,
+            errors: 0
+        };
+        this.startTime = Date.now();
+        this.lastHeartbeat = 0;
+    }
+    destroy() {
+        clearInterval(this.metricsInterval);
+        this.removeAllListeners();
+    }
+}
+//# sourceMappingURL=monitor.js.map

package/dist/src/plugins/gateway/utils/monitor.js.map

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

package/dist/src/plugins/gateway/utils/payload.d.ts

@@ -0,0 +1,21 @@
+import { type GatewayPayload } from "../types.js";
+interface IdentifyProperties {
+    os: string;
+    browser: string;
+    device: string;
+}
+interface IdentifyData {
+    token: string;
+    properties: IdentifyProperties;
+    intents: number;
+}
+interface ResumeData {
+    token: string;
+    sessionId: string;
+    sequence: number;
+}
+export declare function validatePayload(data: string): GatewayPayload | null;
+export declare function createIdentifyPayload(data: IdentifyData): GatewayPayload;
+export declare function createResumePayload(data: ResumeData): GatewayPayload;
+export {};
+//# sourceMappingURL=payload.d.ts.map

package/dist/src/plugins/gateway/utils/payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/gateway/utils/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjE,UAAU,kBAAkB;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACd;AAED,UAAU,YAAY;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,kBAAkB,CAAA;IAC9B,OAAO,EAAE,MAAM,CAAA;CACf;AAED,UAAU,UAAU;IACnB,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CA0BnE;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,CASxE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CASpE"}

package/dist/src/plugins/gateway/utils/payload.js

@@ -0,0 +1,46 @@
+import { GatewayOpcodes } from "../types.js";
+export function validatePayload(data) {
+    try {
+        const payload = JSON.parse(data);
+        if (!payload || typeof payload !== "object") {
+            console.error("[Gateway] Invalid payload: Not an object", { data });
+            return null;
+        }
+        if (!("op" in payload) || typeof payload.op !== "number") {
+            console.error("[Gateway] Invalid payload: Missing or invalid op code", {
+                data
+            });
+            return null;
+        }
+        if (!("d" in payload)) {
+            console.error("[Gateway] Invalid payload: Missing data field", { data });
+            return null;
+        }
+        return payload;
+    }
+    catch (error) {
+        console.error("[Gateway] Failed to validate payload:", error, { data });
+        return null;
+    }
+}
+export function createIdentifyPayload(data) {
+    return {
+        op: GatewayOpcodes.Identify,
+        d: {
+            token: data.token,
+            properties: data.properties,
+            intents: data.intents
+        }
+    };
+}
+export function createResumePayload(data) {
+    return {
+        op: GatewayOpcodes.Resume,
+        d: {
+            token: data.token,
+            session_id: data.sessionId,
+            seq: data.sequence
+        }
+    };
+}
+//# sourceMappingURL=payload.js.map

package/dist/src/plugins/gateway/utils/payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.js","sourceRoot":"","sources":["../../../../../src/plugins/gateway/utils/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,aAAa,CAAA;AAoBjE,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAmB,CAAA;QAElD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7C,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;YACnE,OAAO,IAAI,CAAA;QACZ,CAAC;QAED,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC1D,OAAO,CAAC,KAAK,CAAC,uDAAuD,EAAE;gBACtE,IAAI;aACJ,CAAC,CAAA;YACF,OAAO,IAAI,CAAA;QACZ,CAAC;QAED,IAAI,CAAC,CAAC,GAAG,IAAI,OAAO,CAAC,EAAE,CAAC;YACvB,OAAO,CAAC,KAAK,CAAC,+CAA+C,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;YACxE,OAAO,IAAI,CAAA;QACZ,CAAC;QAED,OAAO,OAAO,CAAA;IACf,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;QACvE,OAAO,IAAI,CAAA;IACZ,CAAC;AACF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAkB;IACvD,OAAO;QACN,EAAE,EAAE,cAAc,CAAC,QAAQ;QAC3B,CAAC,EAAE;YACF,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB;KACD,CAAA;AACF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAgB;IACnD,OAAO;QACN,EAAE,EAAE,cAAc,CAAC,MAAM;QACzB,CAAC,EAAE;YACF,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,UAAU,EAAE,IAAI,CAAC,SAAS;YAC1B,GAAG,EAAE,IAAI,CAAC,QAAQ;SAClB;KACD,CAAA;AACF,CAAC"}

package/dist/src/plugins/gateway-forwarder/GatewayForwarderPlugin.d.ts

@@ -0,0 +1,26 @@
+import { GatewayPlugin } from "../gateway/GatewayPlugin.js";
+import type { GatewayPluginOptions } from "../gateway/types.js";
+export interface GatewayForwarderPluginOptions extends GatewayPluginOptions {
+    /**
+     * The URL to forward webhook events to.
+     * Typically this is your base URL in the client, and then `/events`
+     */
+    webhookUrl: string;
+    /**
+     * The ed25519 private key in PEM format, used to sign forwarded events.
+     * This should include the BEGIN/END markers. When loading from an environment
+     * variable, the newlines can be escaped (\\n).
+     *
+     * For instructions on generating keys and setting up the forwarder,
+     * see the documentation at: https://carbon.buape.com/plugins/gateway-forwarder
+     */
+    privateKey: string;
+}
+export declare class GatewayForwarderPlugin extends GatewayPlugin {
+    readonly id = "gateway-forwarder";
+    protected config: GatewayForwarderPluginOptions;
+    private privateKey;
+    constructor(options: GatewayForwarderPluginOptions);
+    protected setupWebSocket(): void;
+}
+//# sourceMappingURL=GatewayForwarderPlugin.d.ts.map