@hieuxyz/rpc 1.2.4 → 1.2.5

package/dist/hieuxyz/gateway/DiscordWebSocket.js

@@ -1,328 +0,0 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DiscordWebSocket = void 0;
-const ws_1 = __importDefault(require("ws"));
-const zlib = __importStar(require("zlib"));
-const logger_1 = require("../utils/logger");
-const identify_1 = require("./entities/identify");
-const OpCode_1 = require("./entities/OpCode");
-/**
- * Manage WebSocket connections to Discord Gateway.
- * Handles low-level operations like heartbeating, identifying, and resuming.
- */
-class DiscordWebSocket {
-    token;
-    ws = null;
-    sequence = null;
-    heartbeatInterval = null;
-    heartbeatIntervalValue = 0;
-    sessionId = null;
-    resumeGatewayUrl = null;
-    options;
-    isReconnecting = false;
-    permanentClose = false;
-    connectTimeout = null;
-    resolveReady = () => { };
-    lastHeartbeatAck = true;
-    /**
-     * Current logged in user info.
-     */
-    user = null;
-    /**
-     * A promise will be resolved when the Gateway connection is ready.
-     * and received the READY event.
-     */
-    readyPromise;
-    /**
-     * Create a DiscordWebSocket instance.
-     * @param {string} token - Discord user token for authentication.
-     * @param {DiscordWebSocketOptions} options - Configuration options for the WebSocket client.
-     * @throws {Error} If the token is invalid.
-     */
-    constructor(token, options) {
-        if (!this.isTokenValid(token)) {
-            throw new Error('Invalid token provided.');
-        }
-        this.token = token;
-        this.options = {
-            alwaysReconnect: options.alwaysReconnect ?? false,
-            properties: options.properties,
-            connectionTimeout: options.connectionTimeout ?? 30000,
-        };
-        this.readyPromise = new Promise((resolve) => (this.resolveReady = resolve));
-    }
-    resetReadyPromise() {
-        this.readyPromise = new Promise((resolve) => (this.resolveReady = resolve));
-    }
-    isTokenValid(token) {
-        return (/^[a-zA-Z0-9_-]{24}\.[a-zA-Z0-9_-]{6}\.[a-zA-Z0-9_-]{38}$/.test(token) ||
-            /^mfa\.[a-zA-Z0-9_-]{84}$/.test(token));
-    }
-    /**
-     * Initiate connection to Discord Gateway.
-     * If there was a previous session, it will try to resume.
-     */
-    connect() {
-        if (this.isReconnecting) {
-            logger_1.logger.info('Connection attempt aborted: reconnection already in progress.');
-            return;
-        }
-        this.permanentClose = false;
-        this.isReconnecting = true;
-        this.resetReadyPromise();
-        const url = this.resumeGatewayUrl || 'wss://gateway.discord.gg/?v=10&encoding=json';
-        logger_1.logger.info(`Attempting to connect to ${url}...`);
-        this.ws = new ws_1.default(url);
-        this.connectTimeout = setTimeout(() => {
-            logger_1.logger.error('Connection timed out. Terminating connection attempt.');
-            if (this.ws) {
-                this.ws.terminate();
-            }
-        }, this.options.connectionTimeout);
-        this.ws.on('open', () => {
-            logger_1.logger.info(`Successfully connected to Discord Gateway at ${url}.`);
-            this.isReconnecting = false;
-            if (this.connectTimeout) {
-                clearTimeout(this.connectTimeout);
-                this.connectTimeout = null;
-            }
-        });
-        this.ws.on('message', this.onMessage.bind(this));
-        this.ws.on('close', this.handleClose.bind(this));
-        this.ws.on('error', (err) => {
-            if (err.message !== 'WebSocket was closed before the connection was established') {
-                logger_1.logger.error(`WebSocket Error: ${err.message}`);
-            }
-        });
-    }
-    handleClose(code, reason) {
-        logger_1.logger.warn(`Connection closed: ${code} - ${reason.toString('utf-8')}`);
-        this.cleanupHeartbeat();
-        if (this.connectTimeout) {
-            clearTimeout(this.connectTimeout);
-            this.connectTimeout = null;
-        }
-        this.isReconnecting = false;
-        if (code === 4004 || code === 4999) {
-            this.sessionId = null;
-            this.sequence = null;
-            this.resumeGatewayUrl = null;
-        }
-        if (this.permanentClose) {
-            logger_1.logger.info('Connection permanently closed by client. Not reconnecting.');
-            return;
-        }
-        if (this.shouldReconnect(code)) {
-            logger_1.logger.info('Attempting to reconnect in 5 seconds...');
-            setTimeout(() => this.connect(), 5000);
-        }
-        else {
-            logger_1.logger.info('Not attempting to reconnect based on close code and client options.');
-        }
-    }
-    onMessage(data, isBinary) {
-        let decompressedData;
-        if (isBinary) {
-            decompressedData = zlib.inflateSync(data).toString('utf-8');
-        }
-        else {
-            decompressedData = data.toString('utf-8');
-        }
-        const payload = JSON.parse(decompressedData);
-        if (payload.s) {
-            this.sequence = payload.s;
-        }
-        switch (payload.op) {
-            case OpCode_1.OpCode.HELLO:
-                if (this.connectTimeout) {
-                    clearTimeout(this.connectTimeout);
-                    this.connectTimeout = null;
-                }
-                this.heartbeatIntervalValue = payload.d.heartbeat_interval;
-                logger_1.logger.info(`Received HELLO. Setting heartbeat interval to ${this.heartbeatIntervalValue}ms.`);
-                this.startHeartbeating();
-                if (this.sessionId && this.sequence) {
-                    this.resume();
-                }
-                else {
-                    this.identify();
-                }
-                break;
-            case OpCode_1.OpCode.DISPATCH:
-                if (payload.t === 'READY') {
-                    this.sessionId = payload.d.session_id;
-                    this.resumeGatewayUrl = payload.d.resume_gateway_url + '/?v=10&encoding=json';
-                    this.user = payload.d.user;
-                    logger_1.logger.info(`Session READY. Session ID: ${this.sessionId}. Resume URL set.`);
-                    this.resolveReady(this.user);
-                }
-                else if (payload.t === 'RESUMED') {
-                    logger_1.logger.info('The session has been successfully resumed.');
-                    if (this.user) {
-                        this.resolveReady(this.user);
-                    }
-                }
-                break;
-            case OpCode_1.OpCode.HEARTBEAT_ACK:
-                logger_1.logger.info('Heartbeat acknowledged.');
-                this.lastHeartbeatAck = true;
-                break;
-            case OpCode_1.OpCode.INVALID_SESSION:
-                logger_1.logger.warn(`Received INVALID_SESSION. Resumable: ${payload.d}`);
-                if (payload.d) {
-                    this.ws?.close(4000, 'Invalid session, attempting to resume.');
-                }
-                else {
-                    this.sessionId = null;
-                    this.sequence = null;
-                    this.ws?.close(4004, 'Invalid session, starting a new session.');
-                }
-                break;
-            case OpCode_1.OpCode.RECONNECT:
-                logger_1.logger.info('Gateway requested RECONNECT. Closing to reconnect and resume.');
-                this.ws?.close(4000, 'Gateway requested reconnect.');
-                break;
-            default:
-                break;
-        }
-    }
-    startHeartbeating() {
-        this.cleanupHeartbeat();
-        this.lastHeartbeatAck = true;
-        setTimeout(() => {
-            if (this.ws?.readyState === ws_1.default.OPEN) {
-                this.sendHeartbeat();
-            }
-            this.heartbeatInterval = setInterval(() => {
-                if (!this.lastHeartbeatAck) {
-                    logger_1.logger.warn('Heartbeat ACK missing. Connection is zombie. Terminating to resume...');
-                    this.ws?.terminate();
-                    return;
-                }
-                if (this.ws?.readyState !== ws_1.default.OPEN) {
-                    logger_1.logger.warn('Heartbeat skipped: WebSocket is not open.');
-                    this.cleanupHeartbeat();
-                    return;
-                }
-                this.lastHeartbeatAck = false;
-                this.sendHeartbeat();
-            }, this.heartbeatIntervalValue);
-        }, this.heartbeatIntervalValue * Math.random());
-    }
-    sendHeartbeat() {
-        if (this.ws?.readyState !== ws_1.default.OPEN)
-            return;
-        this.sendJson({ op: OpCode_1.OpCode.HEARTBEAT, d: this.sequence });
-        logger_1.logger.info(`Heartbeat sent with sequence ${this.sequence}.`);
-    }
-    identify() {
-        const identifyPayload = (0, identify_1.getIdentifyPayload)(this.token, this.options.properties);
-        this.sendJson({ op: OpCode_1.OpCode.IDENTIFY, d: identifyPayload });
-        logger_1.logger.info('Identify payload sent.');
-    }
-    resume() {
-        if (!this.sessionId || this.sequence === null) {
-            logger_1.logger.error('Attempted to resume without session ID or sequence. Falling back to identify.');
-            this.identify();
-            return;
-        }
-        const resumePayload = {
-            token: this.token,
-            session_id: this.sessionId,
-            seq: this.sequence,
-        };
-        this.sendJson({ op: OpCode_1.OpCode.RESUME, d: resumePayload });
-        logger_1.logger.info('Resume payload sent.');
-    }
-    /**
-     * Send presence update payload to Gateway.
-     * @param {PresenceUpdatePayload} presence - Payload update status to send.
-     */
-    sendActivity(presence) {
-        this.sendJson({ op: OpCode_1.OpCode.PRESENCE_UPDATE, d: presence });
-        logger_1.logger.info('Presence update sent.');
-    }
-    sendJson(data) {
-        if (this.ws?.readyState === ws_1.default.OPEN) {
-            this.ws.send(JSON.stringify(data));
-        }
-        else {
-            logger_1.logger.warn('Attempted to send data while WebSocket was not open.');
-        }
-    }
-    /**
-     * Closes the WebSocket connection.
-     * @param {boolean} force If true, prevents any automatic reconnection attempts.
-     */
-    close(force = false) {
-        if (force) {
-            logger_1.logger.info('Forcing permanent closure. Reconnects will be disabled.');
-            this.permanentClose = true;
-        }
-        else {
-            logger_1.logger.info('Closing connection manually...');
-        }
-        if (this.ws) {
-            if (this.ws.readyState === ws_1.default.OPEN) {
-                this.ws.close(1000, 'Client initiated closure');
-            }
-            else {
-                this.ws.terminate();
-            }
-        }
-    }
-    cleanupHeartbeat() {
-        if (this.heartbeatInterval) {
-            clearInterval(this.heartbeatInterval);
-            this.heartbeatInterval = null;
-        }
-    }
-    shouldReconnect(code) {
-        const fatalErrorCodes = [4004, 4010, 4011, 4013, 4014];
-        if (fatalErrorCodes.includes(code)) {
-            logger_1.logger.error(`Fatal WebSocket error received (code: ${code}). Will not reconnect.`);
-            return false;
-        }
-        if (this.options.alwaysReconnect) {
-            return true;
-        }
-        return code !== 1000;
-    }
-}
-exports.DiscordWebSocket = DiscordWebSocket;

package/dist/hieuxyz/gateway/entities/OpCode.d.ts

@@ -1,13 +0,0 @@
-export declare enum OpCode {
-    DISPATCH = 0,
-    HEARTBEAT = 1,
-    IDENTIFY = 2,
-    PRESENCE_UPDATE = 3,
-    VOICE_STATE_UPDATE = 4,
-    RESUME = 6,
-    RECONNECT = 7,
-    REQUEST_GUILD_MEMBERS = 8,
-    INVALID_SESSION = 9,
-    HELLO = 10,
-    HEARTBEAT_ACK = 11
-}

package/dist/hieuxyz/gateway/entities/OpCode.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.OpCode = void 0;
-var OpCode;
-(function (OpCode) {
-    OpCode[OpCode["DISPATCH"] = 0] = "DISPATCH";
-    OpCode[OpCode["HEARTBEAT"] = 1] = "HEARTBEAT";
-    OpCode[OpCode["IDENTIFY"] = 2] = "IDENTIFY";
-    OpCode[OpCode["PRESENCE_UPDATE"] = 3] = "PRESENCE_UPDATE";
-    OpCode[OpCode["VOICE_STATE_UPDATE"] = 4] = "VOICE_STATE_UPDATE";
-    OpCode[OpCode["RESUME"] = 6] = "RESUME";
-    OpCode[OpCode["RECONNECT"] = 7] = "RECONNECT";
-    OpCode[OpCode["REQUEST_GUILD_MEMBERS"] = 8] = "REQUEST_GUILD_MEMBERS";
-    OpCode[OpCode["INVALID_SESSION"] = 9] = "INVALID_SESSION";
-    OpCode[OpCode["HELLO"] = 10] = "HELLO";
-    OpCode[OpCode["HEARTBEAT_ACK"] = 11] = "HEARTBEAT_ACK";
-})(OpCode || (exports.OpCode = OpCode = {}));

package/dist/hieuxyz/gateway/entities/identify.d.ts

@@ -1,13 +0,0 @@
-import { IdentifyPayload } from './types';
-/**
- * @typedef {object} ClientProperties
- * @property {string} [os] - The operating system. (e.g., 'Windows', 'Android')
- * @property {string} [browser] - The browser or client. (e.g., 'Discord Client', 'Discord Android')
- * @property {string} [device] - The device. (e.g., 'Android16')
- */
-export interface ClientProperties {
-    os?: string;
-    browser?: string;
-    device?: string;
-}
-export declare function getIdentifyPayload(token: string, properties?: ClientProperties): IdentifyPayload;

package/dist/hieuxyz/gateway/entities/identify.js

@@ -1,17 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getIdentifyPayload = getIdentifyPayload;
-function getIdentifyPayload(token, properties) {
-    const defaultProperties = {
-        os: 'Windows',
-        browser: 'Discord Client',
-        device: 'hieuxyz©rpc',
-    };
-    return {
-        token: token,
-        capabilities: 65,
-        largeThreshold: 50,
-        properties: { ...defaultProperties, ...properties },
-        compress: true,
-    };
-}

package/dist/hieuxyz/gateway/entities/types.d.ts

@@ -1,151 +0,0 @@
-import { OpCode } from './OpCode';
-export declare enum ActivityType {
-    Playing = 0,
-    Streaming = 1,
-    Listening = 2,
-    Watching = 3,
-    Custom = 4,
-    Competing = 5
-}
-export type ActivityTypeName = 'playing' | 'streaming' | 'listening' | 'watching' | 'custom' | 'competing';
-export type SettableActivityType = ActivityType | ActivityTypeName | number;
-export interface GatewayPayload {
-    op: OpCode;
-    d: any;
-    s?: number | null;
-    t?: string | null;
-}
-export interface IdentifyProperties {
-    os: string;
-    browser: string;
-    device: string;
-}
-export interface IdentifyPayload {
-    token: string;
-    capabilities: number;
-    largeThreshold: number;
-    properties: IdentifyProperties;
-    compress: boolean;
-}
-export declare enum UserFlags {
-    STAFF = 1,
-    PARTNER = 2,
-    HYPESQUAD = 4,
-    BUG_HUNTER_LEVEL_1 = 8,
-    HYPESQUAD_ONLINE_HOUSE_1 = 64,// Bravery
-    HYPESQUAD_ONLINE_HOUSE_2 = 128,// Brilliance
-    HYPESQUAD_ONLINE_HOUSE_3 = 256,// Balance
-    PREMIUM_EARLY_SUPPORTER = 512,
-    TEAM_PSEUDO_USER = 1024,
-    BUG_HUNTER_LEVEL_2 = 16384,
-    VERIFIED_BOT = 65536,
-    VERIFIED_DEVELOPER = 131072,
-    CERTIFIED_MODERATOR = 262144,
-    BOT_HTTP_INTERACTIONS = 524288,
-    ACTIVE_DEVELOPER = 4194304
-}
-export interface DiscordUser {
-    id: string;
-    username: string;
-    discriminator: string;
-    global_name?: string | null;
-    avatar?: string | null;
-    bot?: boolean;
-    system?: boolean;
-    mfa_enabled?: boolean;
-    banner?: string | null;
-    accent_color?: number | null;
-    locale?: string;
-    verified?: boolean;
-    email?: string | null;
-    flags?: number;
-    premium_type?: number;
-    public_flags?: number;
-    bio?: string;
-    phone?: string | null;
-    nsfw_allowed?: boolean;
-    pronouns?: string;
-    mobile?: boolean;
-    desktop?: boolean;
-    clan?: {
-        tag: string;
-        identity_guild_id: string;
-        badge: string;
-        identity_enabled?: boolean;
-    } | null;
-    primary_guild?: {
-        tag: string;
-        identity_guild_id: string;
-        badge: string;
-        identity_enabled?: boolean;
-    } | null;
-    purchased_flags?: number;
-    premium_usage_flags?: number;
-    premium?: boolean;
-    premium_state?: {
-        premium_subscription_type?: number;
-        premium_subscription_group_role?: number;
-        premium_source?: number;
-    } | null;
-    avatar_decoration_data?: {
-        asset: string;
-        sku_id: string;
-        expires_at: number | null;
-    } | null;
-    collectibles?: {
-        nameplate?: {
-            asset: string;
-            label: string;
-            sku_id: string;
-            palette?: string;
-            expires_at?: number | null;
-        };
-    } | null;
-    display_name_styles?: {
-        font_id?: number;
-        effect_id?: number;
-        colors?: number[];
-    } | null;
-    banner_color?: string | null;
-    age_verification_status?: number;
-}
-export interface Activity {
-    name: string;
-    type: number;
-    application_id?: string;
-    details?: string;
-    state?: string;
-    platform?: string;
-    instance?: boolean;
-    flags?: number;
-    sync_id?: string;
-    party?: {
-        id?: string;
-        size?: [number, number];
-    };
-    timestamps?: {
-        start?: number;
-        end?: number;
-    };
-    assets?: {
-        large_image?: string;
-        large_text?: string;
-        small_image?: string;
-        small_text?: string;
-    };
-    secrets?: {
-        join?: string;
-        spectate?: string;
-        match?: string;
-    };
-    buttons?: string[];
-    metadata?: {
-        button_urls?: string[];
-    };
-}
-export interface PresenceUpdatePayload {
-    since: number;
-    activities: Activity[];
-    status: 'online' | 'dnd' | 'idle' | 'invisible' | 'offline';
-    afk: boolean;
-}

package/dist/hieuxyz/gateway/entities/types.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UserFlags = exports.ActivityType = void 0;
-var ActivityType;
-(function (ActivityType) {
-    ActivityType[ActivityType["Playing"] = 0] = "Playing";
-    ActivityType[ActivityType["Streaming"] = 1] = "Streaming";
-    ActivityType[ActivityType["Listening"] = 2] = "Listening";
-    ActivityType[ActivityType["Watching"] = 3] = "Watching";
-    ActivityType[ActivityType["Custom"] = 4] = "Custom";
-    ActivityType[ActivityType["Competing"] = 5] = "Competing";
-})(ActivityType || (exports.ActivityType = ActivityType = {}));
-var UserFlags;
-(function (UserFlags) {
-    UserFlags[UserFlags["STAFF"] = 1] = "STAFF";
-    UserFlags[UserFlags["PARTNER"] = 2] = "PARTNER";
-    UserFlags[UserFlags["HYPESQUAD"] = 4] = "HYPESQUAD";
-    UserFlags[UserFlags["BUG_HUNTER_LEVEL_1"] = 8] = "BUG_HUNTER_LEVEL_1";
-    UserFlags[UserFlags["HYPESQUAD_ONLINE_HOUSE_1"] = 64] = "HYPESQUAD_ONLINE_HOUSE_1";
-    UserFlags[UserFlags["HYPESQUAD_ONLINE_HOUSE_2"] = 128] = "HYPESQUAD_ONLINE_HOUSE_2";
-    UserFlags[UserFlags["HYPESQUAD_ONLINE_HOUSE_3"] = 256] = "HYPESQUAD_ONLINE_HOUSE_3";
-    UserFlags[UserFlags["PREMIUM_EARLY_SUPPORTER"] = 512] = "PREMIUM_EARLY_SUPPORTER";
-    UserFlags[UserFlags["TEAM_PSEUDO_USER"] = 1024] = "TEAM_PSEUDO_USER";
-    UserFlags[UserFlags["BUG_HUNTER_LEVEL_2"] = 16384] = "BUG_HUNTER_LEVEL_2";
-    UserFlags[UserFlags["VERIFIED_BOT"] = 65536] = "VERIFIED_BOT";
-    UserFlags[UserFlags["VERIFIED_DEVELOPER"] = 131072] = "VERIFIED_DEVELOPER";
-    UserFlags[UserFlags["CERTIFIED_MODERATOR"] = 262144] = "CERTIFIED_MODERATOR";
-    UserFlags[UserFlags["BOT_HTTP_INTERACTIONS"] = 524288] = "BOT_HTTP_INTERACTIONS";
-    UserFlags[UserFlags["ACTIVE_DEVELOPER"] = 4194304] = "ACTIVE_DEVELOPER";
-})(UserFlags || (exports.UserFlags = UserFlags = {}));