sync: dev with v4

[1Lucas1apk]

No description provided.

[gemini-code-assist]

Code Review

This pull request appears to be a large synchronization, introducing a wide range of improvements and refactorings. Key enhancements include a more robust WebSocket implementation with support for both Node.js and Bun, a new player health check mechanism to handle stale tracks and unresponsive nodes, and significantly improved voice state handling in the manager. While these changes greatly improve the library's stability and feature set, I've identified a critical issue in the new WebSocket implementation where client-sent frames are not being masked, which will cause connections to fail. Additionally, IDE-specific configuration files are being added to the repository, which should be avoided by updating the .gitignore file.

[gemini-code-assist]

The WebSocket frames sent from the client to the server must be masked according to RFC 6455, Section 5.1. This implementation is missing the payload masking. A server must close the connection upon receiving an unmasked frame from a client, which will cause this implementation to fail. You need to set the MASK bit in the header, generate a 4-byte masking key, include it in the header, and XOR the payload with the key before sending.

    sendFrame(opcode, payload) {
        const payloadLength = payload.length;
        let header;
        let headerLength = 2;
        if (payloadLength < 126) {
            headerLength += 4;
            header = Buffer.alloc(headerLength);
            header[1] = 0x80 | payloadLength;
        }
        else if (payloadLength < 65536) {
            headerLength = 4 + 4;
            header = Buffer.alloc(headerLength);
            header[1] = 0x80 | 126;
            header.writeUInt16BE(payloadLength, 2);
        }
        else {
            headerLength = 10 + 4;
            header = Buffer.alloc(headerLength);
            header[1] = 0x80 | 127;
            header.writeBigUInt64BE(BigInt(payloadLength), 2);
        }
        header[0] = 0x80 | opcode;
        const mask = (0, node_crypto_1.randomBytes)(4);
        mask.copy(header, headerLength - 4);
        const maskedPayload = Buffer.alloc(payloadLength);
        for (let i = 0; i < payloadLength; i++) {
            maskedPayload[i] = payload[i] ^ mask[i % 4];
        }
        this.netSocket.write(Buffer.concat([header, maskedPayload]));
    }