lunibee 0.3.1 → 0.3.3

package/dist/voice/index.js

@@ -54,16 +54,20 @@ class VoiceConnection {
     this.#listeners[event]?.delete(listener);
     return this;
   }
+  #listening = new WeakSet;
   attachTransports(gateway, udp) {
     this.assertUsable();
     if (!gateway || !udp)
       throw new TypeError("Both voice gateway and UDP transports are required.");
+    if (this.gateway === gateway && this.udp === udp)
+      return this;
     if (this.gateway || this.udp)
       this.#closeTransports();
     this.gateway = gateway;
     this.udp = udp;
     const attachedUdp = udp;
-    if (attachedUdp.onMessage) {
+    if (attachedUdp.onMessage && !this.#listening.has(attachedUdp)) {
+      this.#listening.add(attachedUdp);
       attachedUdp.onMessage((packet) => {
         if (this.udp === attachedUdp)
           this.receiver.onPacket(packet);
@@ -109,13 +113,13 @@ class VoiceConnection {
     if (options.selfDeaf !== undefined)
       this.selfDeaf = options.selfDeaf;
   }
-  setSpeaking(flags = SpeakingFlags.Microphone) {
+  setSpeaking(flags = SpeakingFlags.Microphone, ssrc = 0) {
     this.assertUsable();
     if (!this.gateway) {
       throw new VoiceError("A voice gateway transport is required to change speaking state.");
     }
-    this.gateway.send({ op: 5, d: { speaking: flags, delay: 0, ssrc: 0 } });
-    this.#emit("speaking", flags, 0);
+    this.gateway.send({ op: 5, d: { speaking: flags, delay: 0, ssrc } });
+    this.#emit("speaking", flags, ssrc);
   }
   #assertUsable() {
     if (this.state === "destroyed" /* Destroyed */) {
@@ -185,6 +189,8 @@ class AudioPlayer {
   #stream;
   #reader;
   #resumeSignal;
+  #generation = 0;
+  #ticket = 0;
   #playerListeners = {};
   get state() {
     return this.#state;
@@ -193,12 +199,20 @@ class AudioPlayer {
     return this.#stream;
   }
   async play(audioStream) {
+    const ticket = ++this.#ticket;
     if (this.#state === "playing" || this.#state === "paused")
       await this.stop();
+    if (ticket !== this.#ticket) {
+      audioStream.stream.cancel().catch(() => {
+        return;
+      });
+      return;
+    }
+    const generation = ++this.#generation;
     this.#stream = audioStream;
     this.#reader = audioStream.stream.getReader();
     this.#transition("playing");
-    this.#pump().catch((err) => this.#emitError(err));
+    this.#pump(generation).catch((err) => this.#emitError(err));
   }
   pause() {
     if (this.#state !== "playing")
@@ -216,6 +230,7 @@ class AudioPlayer {
   async stop() {
     if (this.#state === "idle" || this.#state === "stopped")
       return;
+    this.#generation++;
     const reader = this.#reader;
     this.#reader = undefined;
     this.#stream = undefined;
@@ -238,7 +253,7 @@ class AudioPlayer {
     return this;
   }
   onChunk(chunk) {}
-  async#pump() {
+  async#pump(generation) {
     const reader = this.#reader;
     if (!reader)
       return;
@@ -248,9 +263,11 @@ class AudioPlayer {
           this.#resumeSignal = resolve;
         });
       }
-      if (this.#state !== "playing")
+      if (generation !== this.#generation || this.#state !== "playing")
         return;
       const { done, value } = await reader.read();
+      if (generation !== this.#generation)
+        return;
       if (done) {
         if (this.#state === "playing" || this.#state === "paused") {
           this.#transition("idle");
@@ -314,7 +331,7 @@ class VoiceReceiver {
             this.#streams.delete(userId);
         }
       }
-    });
+    }, { highWaterMark: 50 });
     return new AudioStream(stream, { title: `User ${userId} Audio` });
   }
   close() {
@@ -331,6 +348,8 @@ class VoiceReceiver {
     if (packet.length < 12)
       return;
     const view = new DataView(packet.buffer, packet.byteOffset, packet.byteLength);
+    if ((packet[0] & 192) !== 128)
+      return;
     const ssrc = view.getUint32(8, false);
     const userId = this.#ssrcMap.get(ssrc);
     if (!userId)
@@ -353,6 +372,8 @@ class VoiceReceiver {
     const payload = packet.slice(offset);
     for (const controller of controllers) {
       try {
+        if ((controller.desiredSize ?? 1) <= 0)
+          continue;
         controller.enqueue(payload);
       } catch {}
     }
@@ -360,6 +381,8 @@ class VoiceReceiver {
 }
 var voiceConnections = new Map;
 function joinVoiceChannel(options) {
+  if (typeof options.channelId !== "string" || !options.channelId.trim())
+    throw new TypeError("A voice channel ID is required.");
   let connection = voiceConnections.get(options.guildId);
   if (!connection) {
     connection = new VoiceConnection(options);
@@ -400,7 +423,7 @@ function entersState(target, status, timeoutMs) {
     const timer = setTimeout(() => {
       emitter.off("stateChange", onChange);
       reject(new VoiceError(`Did not enter state "${String(status)}" within ${timeoutMs}ms.`));
-    }, timeoutMs);
+    }, Math.min(timeoutMs, 2147483647));
     emitter.on("stateChange", onChange);
   });
 }
@@ -420,4 +443,4 @@ export {
   joinVoiceChannel
 };
 
-//# debugId=854FAC176777C99264756E2164756E21
+//# debugId=0DF7DB68FBFCF1FC64756E2164756E21

package/dist/voice/index.js.map

@@ -2,9 +2,9 @@
   "version": 3,
   "sources": ["../../packages/voice/src/index.ts"],
   "sourcesContent": [
-    "/** Voice session lifecycle states. */\nexport enum VoiceConnectionState {\n    Disconnected = \"disconnected\",\n    Connecting = \"connecting\",\n    Connected = \"connected\",\n    Destroyed = \"destroyed\",\n}\n\n/** Voice protocol transport errors. */\nexport class VoiceError extends Error {\n    /** Creates a voice error. @param message Error message. @param options Optional native error options. */\n    public constructor(message: string, options?: ErrorOptions) {\n        super(message, options);\n        this.name = \"VoiceError\";\n    }\n}\n\n/** Options used to establish a voice session. */\nexport interface VoiceConnectionOptions {\n    /** Guild containing the voice channel. */\n    guildId: string;\n    /** Voice channel to join. */\n    channelId?: string;\n    /** Whether the self user should be muted. */\n    selfMute?: boolean;\n    /** Whether the self user should be deafened. */\n    selfDeaf?: boolean;\n}\n\n/** UDP transport supplied by the runtime-specific voice implementation. */\nexport interface VoiceUdpTransport {\n    /** Sends an RTP/RTCP packet. @param packet Packet bytes. @param host Destination host. @param port Destination port. @returns Optional completion promise. */\n    send(packet: Uint8Array, host: string, port: number): Promise<void> | void;\n    /** Closes the UDP socket. @returns Nothing. */\n    close(): void;\n    /** Optional listener for incoming UDP packets. */\n    onMessage?(listener: (packet: Uint8Array) => void): void;\n}\n\n/** A JSON frame for the voice gateway, e.g. `{ op: 5, d: { speaking, delay, ssrc } }`. */\nexport interface VoiceGatewayPayload {\n    op: number;\n    d: Record<string, string | number | boolean | null>;\n}\n\n/** Voice Gateway transport abstraction. */\nexport interface VoiceGatewayTransport {\n    /** Opens the voice gateway. @param endpoint Voice gateway endpoint. @param sessionId Voice session identifier. @returns Promise fulfilled when connected. */\n    connect(endpoint: string, sessionId: string): Promise<void>;\n    /** Sends a voice gateway payload. @param payload Gateway payload. @returns Nothing. */\n    send(payload: VoiceGatewayPayload): void;\n    /** Closes the voice gateway. @param code Optional close code. @param reason Optional close reason. @returns Nothing. */\n    close(code?: number, reason?: string): void;\n}\n\n/** Speaking flags used by the voice gateway. */\nexport const SpeakingFlags = {\n    Microphone: 1,\n    Soundshare: 2,\n    Priority: 4,\n} as const;\n\n/** Voice session event payloads. */\nexport interface VoiceEvents {\n    /** State transition event. */\n    stateChange: [VoiceConnectionState, VoiceConnectionState];\n    /** Speaking flag event. */\n    speaking: [number, number];\n    /** Voice transport error event. */\n    error: [VoiceError];\n}\n\ntype ListenerSets<E extends Record<keyof E, unknown[]>> = {\n    [K in keyof E]?: Set<(...args: E[K]) => unknown>;\n};\n\n/** Returns the listener set for `event`, creating it on first use. */\nfunction listenerSet<E extends Record<keyof E, unknown[]>, K extends keyof E>(\n    sets: ListenerSets<E>,\n    event: K,\n): Set<(...args: E[K]) => unknown> {\n    return (sets[event] ??= new Set());\n}\n\n/** Tracks a Discord voice session and exposes transport-independent lifecycle controls. */\nexport class VoiceConnection {\n    /** Current voice connection state. */\n    public state: VoiceConnectionState = VoiceConnectionState.Disconnected;\n    /** Guild associated with this voice session. */\n    public readonly guildId: string;\n    /** Voice channel associated with this session. */\n    public channelId?: string;\n    /** Whether the client is self-muted. */\n    public selfMute: boolean;\n    /** Whether the client is self-deafened. */\n    public selfDeaf: boolean;\n    /** Active voice gateway transport, when attached. */\n    public gateway?: VoiceGatewayTransport;\n    /** Active UDP transport, when attached. */\n    public udp?: VoiceUdpTransport;\n    /** Registered lifecycle listeners. */\n    #listeners: ListenerSets<VoiceEvents> = {};\n    /** Receives incoming audio. */\n    public readonly receiver: VoiceReceiver;\n\n    /** Creates a voice connection state manager. @param options Guild ID or connection options. @throws {TypeError} If the guild ID is empty. */\n    public constructor(options: string | VoiceConnectionOptions) {\n        const resolved =\n            typeof options === \"string\" ? { guildId: options } : options;\n        if (!resolved.guildId?.trim()) {\n            throw new TypeError(\n                \"A guild ID is required for a voice connection.\",\n            );\n        }\n        this.guildId = resolved.guildId;\n        this.channelId = resolved.channelId;\n        this.selfMute = resolved.selfMute ?? false;\n        this.selfDeaf = resolved.selfDeaf ?? false;\n        this.receiver = new VoiceReceiver(this);\n    }\n\n    /** Registers a voice lifecycle listener. @param event Event name. @param listener Listener callback. @returns This connection. @throws {TypeError} If listener is not callable. */\n    public on<K extends keyof VoiceEvents>(\n        event: K,\n        listener: (...args: VoiceEvents[K]) => unknown,\n    ): this {\n        if (typeof listener !== \"function\")\n            throw new TypeError(\"Voice listener must be a function.\");\n        listenerSet(this.#listeners, event).add(listener);\n        return this;\n    }\n\n    /** Removes a voice lifecycle listener. @param event Event name. @param listener Listener callback. @returns This connection. */\n    public off<K extends keyof VoiceEvents>(\n        event: K,\n        listener: (...args: VoiceEvents[K]) => unknown,\n    ): this {\n        this.#listeners[event]?.delete(listener);\n        return this;\n    }\n\n    /** Attaches protocol transports, replacing and cleaning up the old pair when present. @param gateway Voice gateway transport. @param udp UDP transport. @returns This connection. @throws {VoiceError} If the connection is destroyed. @throws {TypeError} If a transport is missing. */\n    public attachTransports(\n        gateway: VoiceGatewayTransport,\n        udp: VoiceUdpTransport,\n    ): this {\n        this.assertUsable();\n        if (!gateway || !udp)\n            throw new TypeError(\n                \"Both voice gateway and UDP transports are required.\",\n            );\n        if (this.gateway || this.udp) this.#closeTransports();\n        this.gateway = gateway;\n        this.udp = udp;\n        // Capture the transport this listener belongs to so that packets from a\n        // later-replaced transport (whose listener cannot be unregistered — the\n        // VoiceUdpTransport interface exposes no removal API) are ignored.\n        const attachedUdp = udp;\n        if (attachedUdp.onMessage) {\n            attachedUdp.onMessage((packet) => {\n                if (this.udp === attachedUdp) this.receiver.onPacket(packet);\n            });\n        }\n        return this;\n    }\n\n    /** Begins the connection lifecycle. @returns Nothing. @throws {VoiceError} If the connection is destroyed. */\n    public connect(): void {\n        this.assertUsable();\n        if (this.state === VoiceConnectionState.Connected) return;\n        this.#transition(VoiceConnectionState.Connecting);\n        if (this.state !== VoiceConnectionState.Connecting) return;\n        this.#transition(VoiceConnectionState.Connected);\n    }\n\n    /** Disconnects the current voice session. @returns Nothing. */\n    public disconnect(): void {\n        if (this.state === VoiceConnectionState.Destroyed) return;\n        this.#closeTransports();\n        this.receiver.close();\n        this.#transition(VoiceConnectionState.Disconnected);\n    }\n\n    /** Permanently destroys this voice connection. @returns Nothing. */\n    public destroy(): void {\n        if (this.state === VoiceConnectionState.Destroyed) return;\n        this.#closeTransports();\n        this.receiver.close();\n        this.channelId = undefined;\n        this.#transition(VoiceConnectionState.Destroyed);\n        this.#listeners = {};\n    }\n\n    /** Updates the voice channel and connection state. @param channelId Voice channel identifier. @returns Nothing. @throws {VoiceError} If the connection is destroyed. @throws {TypeError} If channelId is empty. */\n    public setChannel(channelId: string): void {\n        this.assertUsable();\n        if (!channelId?.trim())\n            throw new TypeError(\"A voice channel ID is required.\");\n        this.channelId = channelId;\n    }\n\n    /** Updates self mute/deaf state. @param options Suppression flags. @returns Nothing. @throws {VoiceError} If the connection is destroyed. */\n    public setSuppression(options: {\n        selfMute?: boolean;\n        selfDeaf?: boolean;\n    }): void {\n        this.assertUsable();\n        if (options.selfMute !== undefined) this.selfMute = options.selfMute;\n        if (options.selfDeaf !== undefined) this.selfDeaf = options.selfDeaf;\n    }\n\n    /** Publishes a speaking state through the attached voice gateway. @param flags Speaking flags. @returns Nothing. @throws {VoiceError} If the connection is destroyed or has no gateway transport. */\n    public setSpeaking(flags: number = SpeakingFlags.Microphone): void {\n        this.assertUsable();\n        if (!this.gateway) {\n            throw new VoiceError(\n                \"A voice gateway transport is required to change speaking state.\",\n            );\n        }\n        this.gateway.send({ op: 5, d: { speaking: flags, delay: 0, ssrc: 0 } });\n        this.#emit(\"speaking\", flags, 0);\n    }\n\n    /** Ensures the connection is still usable. @returns Nothing. @throws {VoiceError} If destroyed. */\n    #assertUsable(): void {\n        if (this.state === VoiceConnectionState.Destroyed) {\n            throw new VoiceError(\"Voice connection has been destroyed.\");\n        }\n    }\n\n    /** Closes both active transports while isolating cleanup failures. @returns Nothing. */\n    #closeTransports(): void {\n        try {\n            this.gateway?.close(1000, \"Voice connection replaced or closed\");\n        } catch (error) {\n            this.#emit(\n                \"error\",\n                error instanceof VoiceError\n                    ? error\n                    : new VoiceError(\"Voice gateway cleanup failed.\", {\n                          cause: error,\n                      }),\n            );\n        }\n        try {\n            this.udp?.close();\n        } catch (error) {\n            this.#emit(\n                \"error\",\n                error instanceof VoiceError\n                    ? error\n                    : new VoiceError(\"Voice UDP cleanup failed.\", {\n                          cause: error,\n                      }),\n            );\n        }\n        this.gateway = undefined;\n        this.udp = undefined;\n    }\n\n    /** Transitions to a new lifecycle state and emits the transition event. @param next Next state. @returns Nothing. */\n    #transition(next: VoiceConnectionState): void {\n        const previous = this.state;\n        this.state = next;\n        if (previous === next) return;\n        for (const listener of this.#listeners.stateChange ?? []) {\n            try {\n                void listener(next, previous);\n            } catch (error) {\n                this.#emit(\n                    \"error\",\n                    error instanceof VoiceError\n                        ? error\n                        : new VoiceError(\"Voice event listener failed.\", {\n                              cause: error,\n                          }),\n                );\n            }\n            if (this.state !== next && next !== VoiceConnectionState.Destroyed)\n                return;\n        }\n    }\n\n    /** Emits a voice event while isolating consumer failures. @param event Event name. @param args Event arguments. @returns Nothing. */\n    #emit<K extends keyof VoiceEvents>(\n        event: K,\n        ...args: VoiceEvents[K]\n    ): void {\n        for (const listener of this.#listeners[event] ?? []) {\n            try {\n                void listener(...args);\n            } catch {\n                /* Consumer failures are isolated. */\n            }\n        }\n    }\n\n    /** Ensures the connection is still usable. @returns Nothing. @throws {VoiceError} If destroyed. */\n    private assertUsable(): void {\n        this.#assertUsable();\n    }\n}\n\n// ─── Audio Pipeline ───────────────────────────────────────────────────────────\n\n/** Audio player lifecycle states. */\nexport type AudioPlayerState = \"idle\" | \"playing\" | \"paused\" | \"stopped\";\n\n/** An audio stream — wraps a `ReadableStream<Uint8Array>` with optional metadata. */\nexport class AudioStream {\n    /** Underlying binary stream. */\n    public readonly stream: ReadableStream<Uint8Array>;\n    /** Optional human-readable title for the stream. */\n    public readonly title?: string;\n    /** Optional duration hint in seconds. */\n    public readonly duration?: number;\n\n    /** Creates an audio stream.\n     * @param stream Binary audio data stream.\n     * @param metadata Optional metadata: title and duration in seconds.\n     */\n    public constructor(\n        stream: ReadableStream<Uint8Array>,\n        metadata?: { title?: string; duration?: number },\n    ) {\n        this.stream = stream;\n        this.title = metadata?.title;\n        this.duration = metadata?.duration;\n    }\n}\n\ntype AudioPlayerListener<K extends keyof AudioPlayerEvents> = (\n    ...args: AudioPlayerEvents[K]\n) => unknown;\n\ninterface AudioPlayerEvents {\n    stateChange: [from: AudioPlayerState, to: AudioPlayerState];\n    error: [error: Error];\n    finish: [];\n}\n\n/**\n * Lightweight audio player with a simple state machine.\n *\n * States:\n * - `idle` — no stream loaded.\n * - `playing` — actively feeding audio data.\n * - `paused` — temporarily suspended; can be resumed.\n * - `stopped` — stream was stopped and discarded; load a new stream to play again.\n *\n * Events: `stateChange(from, to)`, `error(err)`, `finish()`.\n */\nexport class AudioPlayer {\n    #state: AudioPlayerState = \"idle\";\n    #stream?: AudioStream;\n    #reader?: ReadableStreamDefaultReader<Uint8Array>;\n    /** Resolves the pump's pause await when the player is resumed or stopped. */\n    #resumeSignal?: () => void;\n    readonly #playerListeners: ListenerSets<AudioPlayerEvents> = {};\n\n    /** Current player state. */\n    public get state(): AudioPlayerState {\n        return this.#state;\n    }\n\n    /** The audio stream currently loaded, if any. */\n    public get current(): AudioStream | undefined {\n        return this.#stream;\n    }\n\n    /**\n     * Begins playing an audio stream.\n     * If a stream is already playing, it is stopped first; the previous\n     * stream's reader cancellation is awaited before the new stream starts so\n     * the old and new pump loops cannot run concurrently.\n     * @param audioStream Stream to play.\n     */\n    public async play(audioStream: AudioStream): Promise<void> {\n        if (this.#state === \"playing\" || this.#state === \"paused\")\n            await this.stop();\n        this.#stream = audioStream;\n        this.#reader = audioStream.stream.getReader();\n        this.#transition(\"playing\");\n        this.#pump().catch((err) => this.#emitError(err));\n    }\n\n    /** Pauses a currently-playing stream. No-op if not playing. */\n    public pause(): void {\n        if (this.#state !== \"playing\") return;\n        this.#transition(\"paused\");\n    }\n\n    /** Resumes a paused stream. No-op if not paused. */\n    public resume(): void {\n        if (this.#state !== \"paused\") return;\n        this.#transition(\"playing\");\n        // Wake the existing pump loop rather than starting a second one.\n        const signal = this.#resumeSignal;\n        this.#resumeSignal = undefined;\n        signal?.();\n    }\n\n    /**\n     * Stops and discards the current stream. The returned promise resolves once\n     * the underlying reader's cancellation has settled, so a subsequent `play`\n     * never overlaps with the previous pump loop.\n     */\n    public async stop(): Promise<void> {\n        if (this.#state === \"idle\" || this.#state === \"stopped\") return;\n        const reader = this.#reader;\n        this.#reader = undefined;\n        this.#stream = undefined;\n        this.#transition(\"stopped\");\n        // Release a pump loop that is currently awaiting a resume.\n        const signal = this.#resumeSignal;\n        this.#resumeSignal = undefined;\n        signal?.();\n        if (reader) {\n            try {\n                await reader.cancel();\n            } catch {\n                /* Cancellation failures are non-fatal. */\n            }\n        }\n    }\n\n    /** Registers an event listener. @returns `this` for chaining. */\n    public on<K extends keyof AudioPlayerEvents>(\n        event: K,\n        listener: AudioPlayerListener<K>,\n    ): this {\n        listenerSet(this.#playerListeners, event).add(listener);\n        return this;\n    }\n\n    /** Removes an event listener. @returns `this` for chaining. */\n    public off<K extends keyof AudioPlayerEvents>(\n        event: K,\n        listener: AudioPlayerListener<K>,\n    ): this {\n        this.#playerListeners[event]?.delete(listener);\n        return this;\n    }\n\n    /**\n     * Handles a decoded audio chunk. The base implementation is a no-op;\n     * subclasses override this to pipe audio to a UDP socket or other sink.\n     * @param chunk A chunk of audio bytes read from the current stream.\n     */\n    protected onChunk(chunk: Uint8Array): void {\n        void chunk;\n    }\n\n    /** Reads chunks from the reader while the player is in a playing state. */\n    async #pump(): Promise<void> {\n        const reader = this.#reader;\n        if (!reader) return;\n        while (true) {\n            // Suspend without polling: park until resume()/stop() signals us.\n            if (this.#state === \"paused\") {\n                await new Promise<void>((resolve) => {\n                    this.#resumeSignal = resolve;\n                });\n            }\n            // Abort if stopped/idle (e.g. resolved by stop()).\n            if (this.#state !== \"playing\") return;\n            const { done, value } = await reader.read();\n            if (done) {\n                if (this.#state === \"playing\" || this.#state === \"paused\") {\n                    this.#transition(\"idle\");\n                    this.#stream = undefined;\n                    this.#reader = undefined;\n                    this.#emit(\"finish\");\n                }\n                return;\n            }\n            // A stop() during the read wins — drop the chunk and exit.\n            if (this.#state !== \"playing\" && this.#state !== \"paused\") return;\n            // Deliver the chunk to the sink hook; loop back to honour pause state.\n            this.onChunk(value);\n        }\n    }\n\n    #transition(next: AudioPlayerState): void {\n        if (this.#state === next) return;\n        const from = this.#state;\n        this.#state = next;\n        this.#emit(\"stateChange\", from, next);\n    }\n\n    #emitError(err: unknown): void {\n        this.#emit(\n            \"error\",\n            err instanceof Error ? err : new VoiceError(String(err)),\n        );\n    }\n\n    #emit<K extends keyof AudioPlayerEvents>(\n        event: K,\n        ...args: AudioPlayerEvents[K]\n    ): void {\n        for (const listener of this.#playerListeners[event] ?? []) {\n            try {\n                void listener(...args);\n            } catch {\n                /* Listener failures are isolated. */\n            }\n        }\n    }\n}\n\n// ─── Audio Receive Pipeline ───────────────────────────────────────────────────\n\n/** Tracks incoming audio and maps SSRCs to readable streams per user. */\nexport class VoiceReceiver {\n    /** The connection this receiver is attached to. */\n    public readonly connection: VoiceConnection;\n    readonly #ssrcMap = new Map<number, string>();\n    /** Active stream controllers per user; a Set so multiple subscribers to the\n     * same user all receive audio instead of the last one overwriting earlier ones. */\n    readonly #streams = new Map<\n        string,\n        Set<ReadableStreamDefaultController<Uint8Array>>\n    >();\n\n    /** Creates a VoiceReceiver. @param connection Voice connection. */\n    public constructor(connection: VoiceConnection) {\n        this.connection = connection;\n    }\n\n    /** Maps an SSRC to a User ID (usually from gateway speaking events). */\n    public mapSsrc(ssrc: number, userId: string): void {\n        this.#ssrcMap.set(ssrc, userId);\n    }\n\n    /** Subscribes to incoming audio from a specific user. @param userId User identifier. @returns A binary readable stream of the audio. */\n    public subscribe(userId: string): AudioStream {\n        // A destroyed connection never closes its receiver again, so a late\n        // subscriber would wait forever.\n        if (this.connection.state === VoiceConnectionState.Destroyed)\n            throw new VoiceError(\"Voice connection has been destroyed.\");\n        let controllerRef: ReadableStreamDefaultController<Uint8Array>;\n        const stream = new ReadableStream<Uint8Array>({\n            start: (controller) => {\n                controllerRef = controller;\n                let set = this.#streams.get(userId);\n                if (!set) this.#streams.set(userId, (set = new Set()));\n                set.add(controller);\n            },\n            cancel: () => {\n                const set = this.#streams.get(userId);\n                if (set) {\n                    set.delete(controllerRef);\n                    if (set.size === 0) this.#streams.delete(userId);\n                }\n            },\n        });\n        return new AudioStream(stream, { title: `User ${userId} Audio` });\n    }\n\n    /** Ends every subscriber stream and forgets SSRC mappings. Called when the\n     * connection disconnects or is destroyed, so readers do not wait forever. */\n    public close(): void {\n        for (const controllers of this.#streams.values())\n            for (const controller of controllers) {\n                try {\n                    controller.close();\n                } catch {\n                    // Already closed or errored by the consumer.\n                }\n            }\n        this.#streams.clear();\n        this.#ssrcMap.clear();\n    }\n\n    /** Processes an incoming UDP packet, extracting SSRC and routing the audio\n     * payload (RTP header stripped) to every subscriber for the mapped user. */\n    public onPacket(packet: Uint8Array): void {\n        if (packet.length < 12) return;\n\n        const view = new DataView(\n            packet.buffer,\n            packet.byteOffset,\n            packet.byteLength,\n        );\n        const ssrc = view.getUint32(8, false);\n\n        const userId = this.#ssrcMap.get(ssrc);\n        if (!userId) return;\n        const controllers = this.#streams.get(userId);\n        if (!controllers || controllers.size === 0) return;\n\n        // Compute the RTP payload offset: 12-byte fixed header + CSRC list, plus\n        // the extension header when the X bit is set.\n        const first = view.getUint8(0);\n        const csrcCount = first & 0x0f;\n        let offset = 12 + csrcCount * 4;\n        const hasExtension = (first & 0x10) !== 0;\n        if (hasExtension) {\n            if (packet.length < offset + 4) return;\n            const extWords = view.getUint16(offset + 2, false);\n            offset += 4 + extWords * 4;\n        }\n        if (packet.length < offset) return;\n        const payload = packet.slice(offset);\n\n        for (const controller of controllers) {\n            try {\n                controller.enqueue(payload);\n            } catch {\n                // Ignore errors on closed streams.\n            }\n        }\n    }\n}\n\n// ─── Discord.js-familiar helpers (@discordjs/voice) ───────────────────────────\n\n/** Discord.js-familiar alias for {@link VoiceConnectionState}. Member values are Lunibee's. */\nexport { VoiceConnectionState as VoiceConnectionStatus };\n\n/** Active connections by guild, as tracked by {@link joinVoiceChannel}. */\nconst voiceConnections = new Map<string, VoiceConnection>();\n\n/**\n * Joins (or moves to) a voice channel, reusing the guild's tracked connection.\n * Mirrors `@discordjs/voice`'s `joinVoiceChannel`; transports are still attached\n * with {@link VoiceConnection.attachTransports}.\n * @param options Guild, channel and self mute/deaf flags.\n * @returns The guild's voice connection.\n * @throws {TypeError} If the guild or channel ID is empty.\n */\nexport function joinVoiceChannel(\n    options: VoiceConnectionOptions & { channelId: string },\n): VoiceConnection {\n    let connection = voiceConnections.get(options.guildId);\n    if (!connection) {\n        connection = new VoiceConnection(options);\n        const created = connection;\n        // VoiceConnection emits stateChange as (next, previous).\n        created.on(\"stateChange\", (next) => {\n            if (\n                next === VoiceConnectionState.Destroyed &&\n                voiceConnections.get(created.guildId) === created\n            )\n                voiceConnections.delete(created.guildId);\n        });\n        voiceConnections.set(options.guildId, connection);\n    }\n    connection.setChannel(options.channelId);\n    connection.setSuppression(options);\n    connection.connect();\n    return connection;\n}\n\n/** Returns the connection tracked by {@link joinVoiceChannel} for a guild, if any. */\nexport function getVoiceConnection(\n    guildId: string,\n): VoiceConnection | undefined {\n    return voiceConnections.get(guildId);\n}\n\n/** Creates an {@link AudioPlayer}. Mirrors `@discordjs/voice`'s `createAudioPlayer`. */\nexport function createAudioPlayer(): AudioPlayer {\n    return new AudioPlayer();\n}\n\n/** Creates an {@link AudioStream}. Mirrors `@discordjs/voice`'s `createAudioResource`. */\nexport function createAudioResource(\n    stream: ReadableStream<Uint8Array>,\n    metadata?: { title?: string; duration?: number },\n): AudioStream {\n    return new AudioStream(stream, metadata);\n}\n\n/**\n * Resolves once a connection or player reaches `status`, or rejects after `timeoutMs`.\n * Mirrors `@discordjs/voice`'s `entersState`.\n * @returns The same target, for chaining.\n * @throws {VoiceError} If the state is not reached in time.\n */\nexport function entersState<T extends VoiceConnection | AudioPlayer>(\n    target: T,\n    status: T extends VoiceConnection ? VoiceConnectionState : AudioPlayerState,\n    timeoutMs: number,\n): Promise<T> {\n    if (target.state === status) return Promise.resolve(target);\n    const emitter = target as unknown as {\n        on(\n            event: \"stateChange\",\n            fn: (from: unknown, to: unknown) => void,\n        ): unknown;\n        off(\n            event: \"stateChange\",\n            fn: (from: unknown, to: unknown) => void,\n        ): unknown;\n    };\n    // VoiceConnection emits (next, previous); AudioPlayer emits (from, to).\n    const isConnection = target instanceof VoiceConnection;\n    return new Promise<T>((resolve, reject) => {\n        const onChange = (first: unknown, second: unknown): void => {\n            if ((isConnection ? first : second) !== status) return;\n            clearTimeout(timer);\n            emitter.off(\"stateChange\", onChange);\n            resolve(target);\n        };\n        const timer = setTimeout(() => {\n            emitter.off(\"stateChange\", onChange);\n            reject(\n                new VoiceError(\n                    `Did not enter state \"${String(status)}\" within ${timeoutMs}ms.`,\n                ),\n            );\n        }, timeoutMs);\n        emitter.on(\"stateChange\", onChange);\n    });\n}\n"
+    "/** Voice session lifecycle states. */\nexport enum VoiceConnectionState {\n    Disconnected = \"disconnected\",\n    Connecting = \"connecting\",\n    Connected = \"connected\",\n    Destroyed = \"destroyed\",\n}\n\n/** Voice protocol transport errors. */\nexport class VoiceError extends Error {\n    /** Creates a voice error. @param message Error message. @param options Optional native error options. */\n    public constructor(message: string, options?: ErrorOptions) {\n        super(message, options);\n        this.name = \"VoiceError\";\n    }\n}\n\n/** Options used to establish a voice session. */\nexport interface VoiceConnectionOptions {\n    /** Guild containing the voice channel. */\n    guildId: string;\n    /** Voice channel to join. */\n    channelId?: string;\n    /** Whether the self user should be muted. */\n    selfMute?: boolean;\n    /** Whether the self user should be deafened. */\n    selfDeaf?: boolean;\n}\n\n/** UDP transport supplied by the runtime-specific voice implementation. */\nexport interface VoiceUdpTransport {\n    /** Sends an RTP/RTCP packet. @param packet Packet bytes. @param host Destination host. @param port Destination port. @returns Optional completion promise. */\n    send(packet: Uint8Array, host: string, port: number): Promise<void> | void;\n    /** Closes the UDP socket. @returns Nothing. */\n    close(): void;\n    /** Optional listener for incoming UDP packets. */\n    onMessage?(listener: (packet: Uint8Array) => void): void;\n}\n\n/** A JSON frame for the voice gateway, e.g. `{ op: 5, d: { speaking, delay, ssrc } }`. */\nexport interface VoiceGatewayPayload {\n    op: number;\n    d: Record<string, string | number | boolean | null>;\n}\n\n/** Voice Gateway transport abstraction. */\nexport interface VoiceGatewayTransport {\n    /** Opens the voice gateway. @param endpoint Voice gateway endpoint. @param sessionId Voice session identifier. @returns Promise fulfilled when connected. */\n    connect(endpoint: string, sessionId: string): Promise<void>;\n    /** Sends a voice gateway payload. @param payload Gateway payload. @returns Nothing. */\n    send(payload: VoiceGatewayPayload): void;\n    /** Closes the voice gateway. @param code Optional close code. @param reason Optional close reason. @returns Nothing. */\n    close(code?: number, reason?: string): void;\n}\n\n/** Speaking flags used by the voice gateway. */\nexport const SpeakingFlags = {\n    Microphone: 1,\n    Soundshare: 2,\n    Priority: 4,\n} as const;\n\n/** Voice session event payloads. */\nexport interface VoiceEvents {\n    /** State transition event. */\n    stateChange: [VoiceConnectionState, VoiceConnectionState];\n    /** Speaking flag event. */\n    speaking: [number, number];\n    /** Voice transport error event. */\n    error: [VoiceError];\n}\n\ntype ListenerSets<E extends Record<keyof E, unknown[]>> = {\n    [K in keyof E]?: Set<(...args: E[K]) => unknown>;\n};\n\n/** Returns the listener set for `event`, creating it on first use. */\nfunction listenerSet<E extends Record<keyof E, unknown[]>, K extends keyof E>(\n    sets: ListenerSets<E>,\n    event: K,\n): Set<(...args: E[K]) => unknown> {\n    return (sets[event] ??= new Set());\n}\n\n/** Tracks a Discord voice session and exposes transport-independent lifecycle controls. */\nexport class VoiceConnection {\n    /** Current voice connection state. */\n    public state: VoiceConnectionState = VoiceConnectionState.Disconnected;\n    /** Guild associated with this voice session. */\n    public readonly guildId: string;\n    /** Voice channel associated with this session. */\n    public channelId?: string;\n    /** Whether the client is self-muted. */\n    public selfMute: boolean;\n    /** Whether the client is self-deafened. */\n    public selfDeaf: boolean;\n    /** Active voice gateway transport, when attached. */\n    public gateway?: VoiceGatewayTransport;\n    /** Active UDP transport, when attached. */\n    public udp?: VoiceUdpTransport;\n    /** Registered lifecycle listeners. */\n    #listeners: ListenerSets<VoiceEvents> = {};\n    /** Receives incoming audio. */\n    public readonly receiver: VoiceReceiver;\n\n    /** Creates a voice connection state manager. @param options Guild ID or connection options. @throws {TypeError} If the guild ID is empty. */\n    public constructor(options: string | VoiceConnectionOptions) {\n        const resolved =\n            typeof options === \"string\" ? { guildId: options } : options;\n        if (!resolved.guildId?.trim()) {\n            throw new TypeError(\n                \"A guild ID is required for a voice connection.\",\n            );\n        }\n        this.guildId = resolved.guildId;\n        this.channelId = resolved.channelId;\n        this.selfMute = resolved.selfMute ?? false;\n        this.selfDeaf = resolved.selfDeaf ?? false;\n        this.receiver = new VoiceReceiver(this);\n    }\n\n    /** Registers a voice lifecycle listener. @param event Event name. @param listener Listener callback. @returns This connection. @throws {TypeError} If listener is not callable. */\n    public on<K extends keyof VoiceEvents>(\n        event: K,\n        listener: (...args: VoiceEvents[K]) => unknown,\n    ): this {\n        if (typeof listener !== \"function\")\n            throw new TypeError(\"Voice listener must be a function.\");\n        listenerSet(this.#listeners, event).add(listener);\n        return this;\n    }\n\n    /** Removes a voice lifecycle listener. @param event Event name. @param listener Listener callback. @returns This connection. */\n    public off<K extends keyof VoiceEvents>(\n        event: K,\n        listener: (...args: VoiceEvents[K]) => unknown,\n    ): this {\n        this.#listeners[event]?.delete(listener);\n        return this;\n    }\n\n    readonly #listening = new WeakSet<VoiceUdpTransport>();\n\n    /** Attaches protocol transports, replacing and cleaning up the old pair when present. @param gateway Voice gateway transport. @param udp UDP transport. @returns This connection. @throws {VoiceError} If the connection is destroyed. @throws {TypeError} If a transport is missing. */\n    public attachTransports(\n        gateway: VoiceGatewayTransport,\n        udp: VoiceUdpTransport,\n    ): this {\n        this.assertUsable();\n        if (!gateway || !udp)\n            throw new TypeError(\n                \"Both voice gateway and UDP transports are required.\",\n            );\n        // The same pair again is a no-op: closing it first would end the\n        // transports just attached.\n        if (this.gateway === gateway && this.udp === udp) return this;\n        if (this.gateway || this.udp) this.#closeTransports();\n        this.gateway = gateway;\n        this.udp = udp;\n        // Capture the transport this listener belongs to so that packets from a\n        // later-replaced transport (whose listener cannot be unregistered — the\n        // VoiceUdpTransport interface exposes no removal API) are ignored.\n        const attachedUdp = udp;\n        // A transport that comes back must not get a second listener (it\n        // cannot be removed), or every datagram would be delivered twice.\n        if (attachedUdp.onMessage && !this.#listening.has(attachedUdp)) {\n            this.#listening.add(attachedUdp);\n            attachedUdp.onMessage((packet) => {\n                if (this.udp === attachedUdp) this.receiver.onPacket(packet);\n            });\n        }\n        return this;\n    }\n\n    /** Begins the connection lifecycle. @returns Nothing. @throws {VoiceError} If the connection is destroyed. */\n    public connect(): void {\n        this.assertUsable();\n        if (this.state === VoiceConnectionState.Connected) return;\n        this.#transition(VoiceConnectionState.Connecting);\n        if (this.state !== VoiceConnectionState.Connecting) return;\n        this.#transition(VoiceConnectionState.Connected);\n    }\n\n    /** Disconnects the current voice session. @returns Nothing. */\n    public disconnect(): void {\n        if (this.state === VoiceConnectionState.Destroyed) return;\n        this.#closeTransports();\n        this.receiver.close();\n        this.#transition(VoiceConnectionState.Disconnected);\n    }\n\n    /** Permanently destroys this voice connection. @returns Nothing. */\n    public destroy(): void {\n        if (this.state === VoiceConnectionState.Destroyed) return;\n        this.#closeTransports();\n        this.receiver.close();\n        this.channelId = undefined;\n        this.#transition(VoiceConnectionState.Destroyed);\n        this.#listeners = {};\n    }\n\n    /** Updates the voice channel and connection state. @param channelId Voice channel identifier. @returns Nothing. @throws {VoiceError} If the connection is destroyed. @throws {TypeError} If channelId is empty. */\n    public setChannel(channelId: string): void {\n        this.assertUsable();\n        if (!channelId?.trim())\n            throw new TypeError(\"A voice channel ID is required.\");\n        this.channelId = channelId;\n    }\n\n    /** Updates self mute/deaf state. @param options Suppression flags. @returns Nothing. @throws {VoiceError} If the connection is destroyed. */\n    public setSuppression(options: {\n        selfMute?: boolean;\n        selfDeaf?: boolean;\n    }): void {\n        this.assertUsable();\n        if (options.selfMute !== undefined) this.selfMute = options.selfMute;\n        if (options.selfDeaf !== undefined) this.selfDeaf = options.selfDeaf;\n    }\n\n    /** Publishes a speaking state through the attached voice gateway. @param flags Speaking flags. @returns Nothing. @throws {VoiceError} If the connection is destroyed or has no gateway transport. */\n    /**\n     * Sends a speaking update (voice op 5). Pass the `ssrc` your voice gateway\n     * assigned in READY; Discord uses it to match the audio to this user.\n     */\n    public setSpeaking(\n        flags: number = SpeakingFlags.Microphone,\n        ssrc = 0,\n    ): void {\n        this.assertUsable();\n        if (!this.gateway) {\n            throw new VoiceError(\n                \"A voice gateway transport is required to change speaking state.\",\n            );\n        }\n        this.gateway.send({ op: 5, d: { speaking: flags, delay: 0, ssrc } });\n        this.#emit(\"speaking\", flags, ssrc);\n    }\n\n    /** Ensures the connection is still usable. @returns Nothing. @throws {VoiceError} If destroyed. */\n    #assertUsable(): void {\n        if (this.state === VoiceConnectionState.Destroyed) {\n            throw new VoiceError(\"Voice connection has been destroyed.\");\n        }\n    }\n\n    /** Closes both active transports while isolating cleanup failures. @returns Nothing. */\n    #closeTransports(): void {\n        try {\n            this.gateway?.close(1000, \"Voice connection replaced or closed\");\n        } catch (error) {\n            this.#emit(\n                \"error\",\n                error instanceof VoiceError\n                    ? error\n                    : new VoiceError(\"Voice gateway cleanup failed.\", {\n                          cause: error,\n                      }),\n            );\n        }\n        try {\n            this.udp?.close();\n        } catch (error) {\n            this.#emit(\n                \"error\",\n                error instanceof VoiceError\n                    ? error\n                    : new VoiceError(\"Voice UDP cleanup failed.\", {\n                          cause: error,\n                      }),\n            );\n        }\n        this.gateway = undefined;\n        this.udp = undefined;\n    }\n\n    /** Transitions to a new lifecycle state and emits the transition event. @param next Next state. @returns Nothing. */\n    #transition(next: VoiceConnectionState): void {\n        const previous = this.state;\n        this.state = next;\n        if (previous === next) return;\n        for (const listener of this.#listeners.stateChange ?? []) {\n            try {\n                void listener(next, previous);\n            } catch (error) {\n                this.#emit(\n                    \"error\",\n                    error instanceof VoiceError\n                        ? error\n                        : new VoiceError(\"Voice event listener failed.\", {\n                              cause: error,\n                          }),\n                );\n            }\n            if (this.state !== next && next !== VoiceConnectionState.Destroyed)\n                return;\n        }\n    }\n\n    /** Emits a voice event while isolating consumer failures. @param event Event name. @param args Event arguments. @returns Nothing. */\n    #emit<K extends keyof VoiceEvents>(\n        event: K,\n        ...args: VoiceEvents[K]\n    ): void {\n        for (const listener of this.#listeners[event] ?? []) {\n            try {\n                void listener(...args);\n            } catch {\n                /* Consumer failures are isolated. */\n            }\n        }\n    }\n\n    /** Ensures the connection is still usable. @returns Nothing. @throws {VoiceError} If destroyed. */\n    private assertUsable(): void {\n        this.#assertUsable();\n    }\n}\n\n// ─── Audio Pipeline ───────────────────────────────────────────────────────────\n\n/** Audio player lifecycle states. */\nexport type AudioPlayerState = \"idle\" | \"playing\" | \"paused\" | \"stopped\";\n\n/** An audio stream — wraps a `ReadableStream<Uint8Array>` with optional metadata. */\nexport class AudioStream {\n    /** Underlying binary stream. */\n    public readonly stream: ReadableStream<Uint8Array>;\n    /** Optional human-readable title for the stream. */\n    public readonly title?: string;\n    /** Optional duration hint in seconds. */\n    public readonly duration?: number;\n\n    /** Creates an audio stream.\n     * @param stream Binary audio data stream.\n     * @param metadata Optional metadata: title and duration in seconds.\n     */\n    public constructor(\n        stream: ReadableStream<Uint8Array>,\n        metadata?: { title?: string; duration?: number },\n    ) {\n        this.stream = stream;\n        this.title = metadata?.title;\n        this.duration = metadata?.duration;\n    }\n}\n\ntype AudioPlayerListener<K extends keyof AudioPlayerEvents> = (\n    ...args: AudioPlayerEvents[K]\n) => unknown;\n\ninterface AudioPlayerEvents {\n    stateChange: [from: AudioPlayerState, to: AudioPlayerState];\n    error: [error: Error];\n    finish: [];\n}\n\n/**\n * Lightweight audio player with a simple state machine.\n *\n * States:\n * - `idle` — no stream loaded.\n * - `playing` — actively feeding audio data.\n * - `paused` — temporarily suspended; can be resumed.\n * - `stopped` — stream was stopped and discarded; load a new stream to play again.\n *\n * Events: `stateChange(from, to)`, `error(err)`, `finish()`.\n */\nexport class AudioPlayer {\n    #state: AudioPlayerState = \"idle\";\n    #stream?: AudioStream;\n    #reader?: ReadableStreamDefaultReader<Uint8Array>;\n    /** Resolves the pump's pause await when the player is resumed or stopped. */\n    #resumeSignal?: () => void;\n    /** Identifies the pump loop that owns the player; a stop or a new `play()` retires the old loop. */\n    #generation = 0;\n    /** The latest `play()` call; an earlier call still waiting for `stop()` gives way to it. */\n    #ticket = 0;\n    readonly #playerListeners: ListenerSets<AudioPlayerEvents> = {};\n\n    /** Current player state. */\n    public get state(): AudioPlayerState {\n        return this.#state;\n    }\n\n    /** The audio stream currently loaded, if any. */\n    public get current(): AudioStream | undefined {\n        return this.#stream;\n    }\n\n    /**\n     * Begins playing an audio stream.\n     * If a stream is already playing, it is stopped first; the previous\n     * stream's reader cancellation is awaited before the new stream starts so\n     * the old and new pump loops cannot run concurrently.\n     * @param audioStream Stream to play.\n     */\n    public async play(audioStream: AudioStream): Promise<void> {\n        const ticket = ++this.#ticket;\n        if (this.#state === \"playing\" || this.#state === \"paused\")\n            await this.stop();\n        if (ticket !== this.#ticket) {\n            // A newer play() arrived while this one waited for stop(): it wins,\n            // and this stream is never read, so release it.\n            audioStream.stream.cancel().catch(() => undefined);\n            return;\n        }\n        const generation = ++this.#generation;\n        this.#stream = audioStream;\n        this.#reader = audioStream.stream.getReader();\n        this.#transition(\"playing\");\n        this.#pump(generation).catch((err) => this.#emitError(err));\n    }\n\n    /** Pauses a currently-playing stream. No-op if not playing. */\n    public pause(): void {\n        if (this.#state !== \"playing\") return;\n        this.#transition(\"paused\");\n    }\n\n    /** Resumes a paused stream. No-op if not paused. */\n    public resume(): void {\n        if (this.#state !== \"paused\") return;\n        this.#transition(\"playing\");\n        // Wake the existing pump loop rather than starting a second one.\n        const signal = this.#resumeSignal;\n        this.#resumeSignal = undefined;\n        signal?.();\n    }\n\n    /**\n     * Stops and discards the current stream. The returned promise resolves once\n     * the underlying reader's cancellation has settled, so a subsequent `play`\n     * never overlaps with the previous pump loop.\n     */\n    public async stop(): Promise<void> {\n        if (this.#state === \"idle\" || this.#state === \"stopped\") return;\n        // The loop reading the old stream must not outlive this call, whatever\n        // state a following play() puts the player in.\n        this.#generation++;\n        const reader = this.#reader;\n        this.#reader = undefined;\n        this.#stream = undefined;\n        this.#transition(\"stopped\");\n        // Release a pump loop that is currently awaiting a resume.\n        const signal = this.#resumeSignal;\n        this.#resumeSignal = undefined;\n        signal?.();\n        if (reader) {\n            try {\n                await reader.cancel();\n            } catch {\n                /* Cancellation failures are non-fatal. */\n            }\n        }\n    }\n\n    /** Registers an event listener. @returns `this` for chaining. */\n    public on<K extends keyof AudioPlayerEvents>(\n        event: K,\n        listener: AudioPlayerListener<K>,\n    ): this {\n        listenerSet(this.#playerListeners, event).add(listener);\n        return this;\n    }\n\n    /** Removes an event listener. @returns `this` for chaining. */\n    public off<K extends keyof AudioPlayerEvents>(\n        event: K,\n        listener: AudioPlayerListener<K>,\n    ): this {\n        this.#playerListeners[event]?.delete(listener);\n        return this;\n    }\n\n    /**\n     * Handles a decoded audio chunk. The base implementation is a no-op;\n     * subclasses override this to pipe audio to a UDP socket or other sink.\n     * @param chunk A chunk of audio bytes read from the current stream.\n     */\n    protected onChunk(chunk: Uint8Array): void {\n        void chunk;\n    }\n\n    /** Reads chunks from the reader while the player is in a playing state. */\n    async #pump(generation: number): Promise<void> {\n        const reader = this.#reader;\n        if (!reader) return;\n        while (true) {\n            // Suspend without polling: park until resume()/stop() signals us.\n            if (this.#state === \"paused\") {\n                await new Promise<void>((resolve) => {\n                    this.#resumeSignal = resolve;\n                });\n            }\n            // Abort if stopped/idle (e.g. resolved by stop()) or replaced.\n            if (generation !== this.#generation || this.#state !== \"playing\")\n                return;\n            const { done, value } = await reader.read();\n            // A stop() or a newer play() retired this loop during the read:\n            // drop what it read and leave the new stream's state alone.\n            if (generation !== this.#generation) return;\n            if (done) {\n                if (this.#state === \"playing\" || this.#state === \"paused\") {\n                    this.#transition(\"idle\");\n                    this.#stream = undefined;\n                    this.#reader = undefined;\n                    this.#emit(\"finish\");\n                }\n                return;\n            }\n            // A stop() during the read wins — drop the chunk and exit.\n            if (this.#state !== \"playing\" && this.#state !== \"paused\") return;\n            // Deliver the chunk to the sink hook; loop back to honour pause state.\n            this.onChunk(value);\n        }\n    }\n\n    #transition(next: AudioPlayerState): void {\n        if (this.#state === next) return;\n        const from = this.#state;\n        this.#state = next;\n        this.#emit(\"stateChange\", from, next);\n    }\n\n    #emitError(err: unknown): void {\n        this.#emit(\n            \"error\",\n            err instanceof Error ? err : new VoiceError(String(err)),\n        );\n    }\n\n    #emit<K extends keyof AudioPlayerEvents>(\n        event: K,\n        ...args: AudioPlayerEvents[K]\n    ): void {\n        for (const listener of this.#playerListeners[event] ?? []) {\n            try {\n                void listener(...args);\n            } catch {\n                /* Listener failures are isolated. */\n            }\n        }\n    }\n}\n\n// ─── Audio Receive Pipeline ───────────────────────────────────────────────────\n\n/** Tracks incoming audio and maps SSRCs to readable streams per user. */\nexport class VoiceReceiver {\n    /** The connection this receiver is attached to. */\n    public readonly connection: VoiceConnection;\n    readonly #ssrcMap = new Map<number, string>();\n    /** Active stream controllers per user; a Set so multiple subscribers to the\n     * same user all receive audio instead of the last one overwriting earlier ones. */\n    readonly #streams = new Map<\n        string,\n        Set<ReadableStreamDefaultController<Uint8Array>>\n    >();\n\n    /** Creates a VoiceReceiver. @param connection Voice connection. */\n    public constructor(connection: VoiceConnection) {\n        this.connection = connection;\n    }\n\n    /** Maps an SSRC to a User ID (usually from gateway speaking events). */\n    public mapSsrc(ssrc: number, userId: string): void {\n        this.#ssrcMap.set(ssrc, userId);\n    }\n\n    /** Subscribes to incoming audio from a specific user. @param userId User identifier. @returns A binary readable stream of the audio. */\n    public subscribe(userId: string): AudioStream {\n        // A destroyed connection never closes its receiver again, so a late\n        // subscriber would wait forever.\n        if (this.connection.state === VoiceConnectionState.Destroyed)\n            throw new VoiceError(\"Voice connection has been destroyed.\");\n        let controllerRef: ReadableStreamDefaultController<Uint8Array>;\n        const stream = new ReadableStream<Uint8Array>(\n            {\n                start: (controller) => {\n                    controllerRef = controller;\n                    let set = this.#streams.get(userId);\n                    if (!set) this.#streams.set(userId, (set = new Set()));\n                    set.add(controller);\n                },\n                cancel: () => {\n                    const set = this.#streams.get(userId);\n                    if (set) {\n                        set.delete(controllerRef);\n                        if (set.size === 0) this.#streams.delete(userId);\n                    }\n                },\n            },\n            // About a second of 20 ms packets; a reader that falls further\n            // behind loses the newest packets instead of growing the heap.\n            { highWaterMark: 50 },\n        );\n        return new AudioStream(stream, { title: `User ${userId} Audio` });\n    }\n\n    /** Ends every subscriber stream and forgets SSRC mappings. Called when the\n     * connection disconnects or is destroyed, so readers do not wait forever. */\n    public close(): void {\n        for (const controllers of this.#streams.values())\n            for (const controller of controllers) {\n                try {\n                    controller.close();\n                } catch {\n                    // Already closed or errored by the consumer.\n                }\n            }\n        this.#streams.clear();\n        this.#ssrcMap.clear();\n    }\n\n    /** Processes an incoming UDP packet, extracting SSRC and routing the audio\n     * payload (RTP header stripped) to every subscriber for the mapped user. */\n    public onPacket(packet: Uint8Array): void {\n        if (packet.length < 12) return;\n\n        const view = new DataView(\n            packet.buffer,\n            packet.byteOffset,\n            packet.byteLength,\n        );\n        // RTP version 2 only: anything else is not audio for this stream.\n        if ((packet[0]! & 0xc0) !== 0x80) return;\n        const ssrc = view.getUint32(8, false);\n\n        const userId = this.#ssrcMap.get(ssrc);\n        if (!userId) return;\n        const controllers = this.#streams.get(userId);\n        if (!controllers || controllers.size === 0) return;\n\n        // Compute the RTP payload offset: 12-byte fixed header + CSRC list, plus\n        // the extension header when the X bit is set.\n        const first = view.getUint8(0);\n        const csrcCount = first & 0x0f;\n        let offset = 12 + csrcCount * 4;\n        const hasExtension = (first & 0x10) !== 0;\n        if (hasExtension) {\n            if (packet.length < offset + 4) return;\n            const extWords = view.getUint16(offset + 2, false);\n            offset += 4 + extWords * 4;\n        }\n        if (packet.length < offset) return;\n        const payload = packet.slice(offset);\n\n        for (const controller of controllers) {\n            try {\n                if ((controller.desiredSize ?? 1) <= 0) continue;\n                controller.enqueue(payload);\n            } catch {\n                // Ignore errors on closed streams.\n            }\n        }\n    }\n}\n\n// ─── Discord.js-familiar helpers (@discordjs/voice) ───────────────────────────\n\n/** Discord.js-familiar alias for {@link VoiceConnectionState}. Member values are Lunibee's. */\nexport { VoiceConnectionState as VoiceConnectionStatus };\n\n/** Active connections by guild, as tracked by {@link joinVoiceChannel}. */\nconst voiceConnections = new Map<string, VoiceConnection>();\n\n/**\n * Joins (or moves to) a voice channel, reusing the guild's tracked connection.\n * Mirrors `@discordjs/voice`'s `joinVoiceChannel`; transports are still attached\n * with {@link VoiceConnection.attachTransports}.\n * The connection stays tracked after `disconnect()` (a later join reuses it) and\n * leaves the registry only on `destroy()`.\n * @param options Guild, channel and self mute/deaf flags.\n * @returns The guild's voice connection.\n * @throws {TypeError} If the guild or channel ID is empty.\n */\nexport function joinVoiceChannel(\n    options: VoiceConnectionOptions & { channelId: string },\n): VoiceConnection {\n    // Checked before anything is registered, so a bad call leaves no entry behind.\n    if (typeof options.channelId !== \"string\" || !options.channelId.trim())\n        throw new TypeError(\"A voice channel ID is required.\");\n    let connection = voiceConnections.get(options.guildId);\n    if (!connection) {\n        connection = new VoiceConnection(options);\n        const created = connection;\n        // VoiceConnection emits stateChange as (next, previous).\n        created.on(\"stateChange\", (next) => {\n            if (\n                next === VoiceConnectionState.Destroyed &&\n                voiceConnections.get(created.guildId) === created\n            )\n                voiceConnections.delete(created.guildId);\n        });\n        voiceConnections.set(options.guildId, connection);\n    }\n    connection.setChannel(options.channelId);\n    connection.setSuppression(options);\n    connection.connect();\n    return connection;\n}\n\n/** Returns the connection tracked by {@link joinVoiceChannel} for a guild, if any. */\nexport function getVoiceConnection(\n    guildId: string,\n): VoiceConnection | undefined {\n    return voiceConnections.get(guildId);\n}\n\n/** Creates an {@link AudioPlayer}. Mirrors `@discordjs/voice`'s `createAudioPlayer`. */\nexport function createAudioPlayer(): AudioPlayer {\n    return new AudioPlayer();\n}\n\n/** Creates an {@link AudioStream}. Mirrors `@discordjs/voice`'s `createAudioResource`. */\nexport function createAudioResource(\n    stream: ReadableStream<Uint8Array>,\n    metadata?: { title?: string; duration?: number },\n): AudioStream {\n    return new AudioStream(stream, metadata);\n}\n\n/**\n * Resolves once a connection or player reaches `status`, or rejects after `timeoutMs`.\n * Mirrors `@discordjs/voice`'s `entersState`.\n * @returns The same target, for chaining.\n * @throws {VoiceError} If the state is not reached in time.\n */\nexport function entersState<T extends VoiceConnection | AudioPlayer>(\n    target: T,\n    status: T extends VoiceConnection ? VoiceConnectionState : AudioPlayerState,\n    timeoutMs: number,\n): Promise<T> {\n    if (target.state === status) return Promise.resolve(target);\n    const emitter = target as unknown as {\n        on(\n            event: \"stateChange\",\n            fn: (from: unknown, to: unknown) => void,\n        ): unknown;\n        off(\n            event: \"stateChange\",\n            fn: (from: unknown, to: unknown) => void,\n        ): unknown;\n    };\n    // VoiceConnection emits (next, previous); AudioPlayer emits (from, to).\n    const isConnection = target instanceof VoiceConnection;\n    return new Promise<T>((resolve, reject) => {\n        const onChange = (first: unknown, second: unknown): void => {\n            if ((isConnection ? first : second) !== status) return;\n            clearTimeout(timer);\n            emitter.off(\"stateChange\", onChange);\n            resolve(target);\n        };\n        const timer = setTimeout(\n            () => {\n                emitter.off(\"stateChange\", onChange);\n                reject(\n                    new VoiceError(\n                        `Did not enter state \"${String(status)}\" within ${timeoutMs}ms.`,\n                    ),\n                );\n            },\n            Math.min(timeoutMs, 2_147_483_647),\n        );\n        emitter.on(\"stateChange\", onChange);\n    });\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "854FAC176777C99264756E2164756E21",
+  "mappings": "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",
+  "debugId": "0DF7DB68FBFCF1FC64756E2164756E21",
   "names": []
 }

package/dist/ws/index.d.ts

@@ -27,6 +27,8 @@ export interface GatewayOptions {
     reconnect?: boolean;
     /** Maximum reconnect attempts. */
     maxReconnectAttempts?: number;
+    /** How long a socket may stay connecting before it is closed and retried, in ms. Default 30000. */
+    connectTimeout?: number;
     /** Initial reconnect delay. */
     reconnectBaseDelay?: number;
     /** Maximum reconnect delay. */

package/dist/ws/index.js

@@ -535,6 +535,7 @@ class WebSocketTransport {
         decoded = this.#decoder.push(event.data);
       } catch (error) {
         this.#handlers.onError(this.#asError(error));
+        this.#failDecoding(generation);
         return;
       }
       if (!(decoded instanceof Promise)) {
@@ -552,6 +553,7 @@ class WebSocketTransport {
         if (!this.#owns(generation))
           return;
         this.#handlers.onError(this.#asError(error));
+        this.#failDecoding(generation);
       });
     });
     socket.addEventListener("close", (event) => {
@@ -580,6 +582,10 @@ class WebSocketTransport {
       return false;
     }
   }
+  #failDecoding(generation) {
+    if (this.#owns(generation))
+      this.close(4000, "decoder failure");
+  }
   close(code = 1000, reason = "") {
     const socket = this.#socket;
     if (!socket)
@@ -935,6 +941,13 @@ class Gateway {
   constructor(options) {
     if (!options.token?.trim())
       throw new TypeError("A Gateway token is required.");
+    for (const key of [
+      "reconnectBaseDelay",
+      "reconnectMaxDelay",
+      "connectTimeout"
+    ])
+      if (options[key] !== undefined && !(options[key] > 0))
+        throw new RangeError(`Gateway ${key} must be greater than 0.`);
     const resolvedIntents = resolveGatewayIntents(options.intents);
     if (!Number.isInteger(resolvedIntents) || resolvedIntents < 0)
       throw new TypeError("Gateway intents must be a non-negative integer.");
@@ -943,6 +956,7 @@ class Gateway {
       shardCount: 1,
       reconnect: true,
       maxReconnectAttempts: Infinity,
+      connectTimeout: 30000,
       reconnectBaseDelay: 1000,
       reconnectMaxDelay: 30000,
       heartbeatAckTimeout: 1e4,
@@ -1018,7 +1032,7 @@ class Gateway {
     this.#reconnect.cancel();
     this.#closed = false;
     this.#setState("CONNECT" /* Connect */);
-    const connectURL = this.#options.compress ? url.includes("compress=") ? url : `${url}&compress=zlib-stream` : url;
+    const connectURL = this.#options.compress ? url.includes("compress=") ? url : `${url}${url.includes("?") ? "&" : "?"}compress=zlib-stream` : url;
     return this.#reconnect.attempt(() => this.#open(connectURL));
   }
   close() {
@@ -1104,6 +1118,8 @@ class Gateway {
     const count = this.#options.shardCount;
     if (count <= 1)
       return true;
+    if (!/^\d{1,20}$/.test(guildId))
+      return false;
     return Number((BigInt(guildId) >> 22n) % BigInt(count)) === this.#options.shardId;
   }
   requestGuildMembers(data) {
@@ -1119,8 +1135,16 @@ class Gateway {
       return;
     this.#token = this.#session.beginConnection();
     const result = this.#transport.connect(url);
-    if (result.ok)
+    if (result.ok) {
+      const token = this.#token;
+      clearTimeout(this.#connectTimer);
+      this.#connectTimer = setTimeout(() => {
+        if (token === this.#token && !this.#closed)
+          this.#transport.close(4000, "connect timeout");
+      }, this.#options.connectTimeout);
+      this.#connectTimer.unref?.();
       return;
+    }
     const failure = this.#normalizeError(result.error);
     this.#emitError(failure);
     if (this.#options.reconnect) {
@@ -1130,7 +1154,9 @@ class Gateway {
       this.#settleConnect(failure);
     }
   }
+  #connectTimer;
   #onOpen() {
+    clearTimeout(this.#connectTimer);
     this.#heartbeat.watch();
     this.#emit("open", undefined);
     this.#settleConnect();
@@ -1198,7 +1224,8 @@ class Gateway {
     this.#emit("RAW", { event: event ?? "UNKNOWN", data });
     if (this.#closed)
       return;
-    this.#emit(event ?? "dispatch", data);
+    if (event == null || /^[A-Z][A-Z0-9_]*$/.test(event))
+      this.#emit(event ?? "dispatch", data);
   }
   #handleHello(interval) {
     this.#setState(this.#session.canResume ? "RESUME" /* Resume */ : "HELLO" /* Hello */);
@@ -1261,6 +1288,7 @@ class Gateway {
     this.#reconnect.settle(error);
   }
   #clearTimers() {
+    clearTimeout(this.#connectTimer);
     this.#reconnect.cancel();
     this.#heartbeat.stop();
   }
@@ -1310,4 +1338,4 @@ export {
   resumePayload
 };
 
-//# debugId=E098D30D7AE9366264756E2164756E21
+//# debugId=49D265E85C1E654C64756E2164756E21