botcast-sdk 1.0.8 → 1.0.10

package/README.md

@@ -273,7 +273,7 @@ await client.messages.delete("201012345678", msgKey);
 await client.messages.markAsRead(msgKey);
 
 // 4. Emoji reaction
-await client.messages.react("201012345678", msgKey, "👍");
+await client.messages.react("201012345678", msgKey, "STAR");
 
 // 5. Pin message
 await client.messages.pin("201012345678", msgKey, 1, 86400);
@@ -286,7 +286,59 @@ await client.messages.forward("201012345678", {
 
 ---
 
-### 4. Chats, Contacts, and History (`client.chats`)
+### 4. Real-Time Socket.io Event Gateway (`client.socket`)
+
+Stream real-time instance events directly with zero latency over **Socket.io**:
+
+```typescript
+import { BotcastClient } from "botcast-sdk";
+
+const client = new BotcastClient({
+  baseUrl: "https://botcast.site",
+  instanceId: "your_instance_id",
+  instanceToken: "your_instance_token",
+  autoConnectSocket: true, // or call client.socket.connect() manually
+});
+
+// 1. Listen for new incoming/outgoing messages
+client.socket.onMessage((msg) => {
+  console.log("Real-time message:", msg);
+});
+
+// 2. Listen for delivery status & read receipts
+client.socket.onMessageStatus((status) => {
+  console.log("Message status update:", status);
+});
+
+// 3. Listen for emoji reactions
+client.socket.onReaction((reaction) => {
+  console.log("Reaction event:", reaction);
+});
+
+// 4. Listen for deleted/revoked messages
+client.socket.onMessageDeleted((del) => {
+  console.log("Message deleted:", del);
+});
+
+// 5. Listen for user presence (typing, recording, online state)
+client.socket.onPresence((presence) => {
+  console.log("Presence update:", presence);
+});
+
+// 6. Listen for instance connection & QR updates
+client.socket.onConnectionUpdate((conn) => {
+  console.log("Connection state:", conn.status, conn.qr || conn.pairingCode);
+});
+
+// 7. Generic event listener
+client.socket.onEvent((event) => {
+  console.log("Instance event received:", event.event, event);
+});
+```
+
+---
+
+### 5. Chats, Contacts, and History (`client.chats`)
 
 ```typescript
 // 1. List chats / dialogs
@@ -309,7 +361,7 @@ await client.chats.pin("201012345678@s.whatsapp.net");
 
 ---
 
-### 5. Webhook Event Handling
+### 6. Webhook Event Handling
 
 The SDK includes a built-in event dispatcher and middleware for handling inbound webhooks from both WhatsApp and Telegram:
 

package/dist/client.cjs

@@ -8,6 +8,7 @@ const groups_js_1 = require("./modules/groups.js");
 const profile_js_1 = require("./modules/profile.js");
 const broadcast_js_1 = require("./modules/broadcast.js");
 const index_js_1 = require("./webhooks/index.js");
+const index_js_2 = require("./socket/index.js");
 class BotcastClient {
     config;
     /** Instance Lifecycle & Connection Management */
@@ -24,10 +25,13 @@ class BotcastClient {
     broadcast;
     /** Webhook Handler & Middleware */
     webhook;
+    /** Real-Time Socket.io Event Gateway Client */
+    socket;
     /**
      * Initializes a new Botcast API Client.
      *
      * @param config Client configuration options
+     * @param socketOptions Optional Socket.io client overrides
      *
      * @example
      * ```ts
@@ -39,11 +43,16 @@ class BotcastClient {
      *   instanceToken: 'token_xyz789'
      * });
      *
+     * // Listen for real-time events via Socket.io
+     * botcast.socket.onMessage((msg) => {
+     *   console.log('Incoming message:', msg);
+     * });
+     *
      * // Send a text message
      * await botcast.messages.sendText('201000000000', 'Hello from Botcast SDK!');
      * ```
      */
-    constructor(config) {
+    constructor(config, socketOptions) {
         if (!config.instanceId) {
             throw new Error('BotcastClient requires a valid "instanceId"');
         }
@@ -58,6 +67,7 @@ class BotcastClient {
             timeout: config.timeout || 30000,
             maxRetries: config.maxRetries ?? 2,
             headers: config.headers || {},
+            autoConnectSocket: config.autoConnectSocket ?? false,
         };
         this.instances = new instances_js_1.InstancesModule(this.config);
         this.messages = new messages_js_1.MessagesModule(this.config);
@@ -66,6 +76,10 @@ class BotcastClient {
         this.profile = new profile_js_1.ProfileModule(this.config);
         this.broadcast = new broadcast_js_1.BroadcastModule(this.config);
         this.webhook = new index_js_1.BotcastWebhook();
+        this.socket = new index_js_2.BotcastSocketClient(this.config, {
+            autoConnect: config.autoConnectSocket,
+            ...socketOptions,
+        });
     }
     // =========================================================================
     // Top-Level Convenience Shortcuts

package/dist/client.d.ts

@@ -6,6 +6,7 @@ import { GroupsModule } from './modules/groups.js';
 import { ProfileModule } from './modules/profile.js';
 import { BroadcastModule } from './modules/broadcast.js';
 import { BotcastWebhook } from './webhooks/index.js';
+import { BotcastSocketClient, BotcastSocketOptions } from './socket/index.js';
 export declare class BotcastClient {
     private config;
     /** Instance Lifecycle & Connection Management */
@@ -22,10 +23,13 @@ export declare class BotcastClient {
     broadcast: BroadcastModule;
     /** Webhook Handler & Middleware */
     webhook: BotcastWebhook;
+    /** Real-Time Socket.io Event Gateway Client */
+    socket: BotcastSocketClient;
     /**
      * Initializes a new Botcast API Client.
      *
      * @param config Client configuration options
+     * @param socketOptions Optional Socket.io client overrides
      *
      * @example
      * ```ts
@@ -37,11 +41,16 @@ export declare class BotcastClient {
      *   instanceToken: 'token_xyz789'
      * });
      *
+     * // Listen for real-time events via Socket.io
+     * botcast.socket.onMessage((msg) => {
+     *   console.log('Incoming message:', msg);
+     * });
+     *
      * // Send a text message
      * await botcast.messages.sendText('201000000000', 'Hello from Botcast SDK!');
      * ```
      */
-    constructor(config: BotcastClientConfig);
+    constructor(config: BotcastClientConfig, socketOptions?: BotcastSocketOptions);
     /**
      * Shortcut to send a text message.
      */

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgC;IAE9C,iDAAiD;IAC1C,SAAS,EAAE,eAAe,CAAC;IAElC,6EAA6E;IACtE,QAAQ,EAAE,cAAc,CAAC;IAEhC,0DAA0D;IACnD,KAAK,EAAE,WAAW,CAAC;IAE1B,iDAAiD;IAC1C,MAAM,EAAE,YAAY,CAAC;IAE5B,0DAA0D;IACnD,OAAO,EAAE,aAAa,CAAC;IAE9B,gDAAgD;IACzC,SAAS,EAAE,eAAe,CAAC;IAElC,mCAAmC;IAC5B,OAAO,EAAE,cAAc,CAAC;IAE/B;;;;;;;;;;;;;;;;;;OAkBG;gBACS,MAAM,EAAE,mBAAmB;IA+BvC;;OAEG;IACU,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIrD;;OAEG;IACU,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;;;IAI7G;;OAEG;IACU,SAAS;IAItB;;OAEG;IACU,KAAK;IAIlB;;;;OAIG;IACU,YAAY,CAAC,WAAW,EAAE,MAAM;IAI7C;;;;OAIG;IACU,WAAW,CAAC,WAAW,EAAE,MAAM;CAG7C"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAgC;IAE9C,iDAAiD;IAC1C,SAAS,EAAE,eAAe,CAAC;IAElC,6EAA6E;IACtE,QAAQ,EAAE,cAAc,CAAC;IAEhC,0DAA0D;IACnD,KAAK,EAAE,WAAW,CAAC;IAE1B,iDAAiD;IAC1C,MAAM,EAAE,YAAY,CAAC;IAE5B,0DAA0D;IACnD,OAAO,EAAE,aAAa,CAAC;IAE9B,gDAAgD;IACzC,SAAS,EAAE,eAAe,CAAC;IAElC,mCAAmC;IAC5B,OAAO,EAAE,cAAc,CAAC;IAE/B,+CAA+C;IACxC,MAAM,EAAE,mBAAmB,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;gBACS,MAAM,EAAE,mBAAmB,EAAE,aAAa,CAAC,EAAE,oBAAoB;IAoC7E;;OAEG;IACU,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAIrD;;OAEG;IACU,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE;;;IAI7G;;OAEG;IACU,SAAS;IAItB;;OAEG;IACU,KAAK;IAIlB;;;;OAIG;IACU,YAAY,CAAC,WAAW,EAAE,MAAM;IAI7C;;;;OAIG;IACU,WAAW,CAAC,WAAW,EAAE,MAAM;CAG7C"}

package/dist/client.js

@@ -5,6 +5,7 @@ import { GroupsModule } from './modules/groups.js';
 import { ProfileModule } from './modules/profile.js';
 import { BroadcastModule } from './modules/broadcast.js';
 import { BotcastWebhook } from './webhooks/index.js';
+import { BotcastSocketClient } from './socket/index.js';
 export class BotcastClient {
     config;
     /** Instance Lifecycle & Connection Management */
@@ -21,10 +22,13 @@ export class BotcastClient {
     broadcast;
     /** Webhook Handler & Middleware */
     webhook;
+    /** Real-Time Socket.io Event Gateway Client */
+    socket;
     /**
      * Initializes a new Botcast API Client.
      *
      * @param config Client configuration options
+     * @param socketOptions Optional Socket.io client overrides
      *
      * @example
      * ```ts
@@ -36,11 +40,16 @@ export class BotcastClient {
      *   instanceToken: 'token_xyz789'
      * });
      *
+     * // Listen for real-time events via Socket.io
+     * botcast.socket.onMessage((msg) => {
+     *   console.log('Incoming message:', msg);
+     * });
+     *
      * // Send a text message
      * await botcast.messages.sendText('201000000000', 'Hello from Botcast SDK!');
      * ```
      */
-    constructor(config) {
+    constructor(config, socketOptions) {
         if (!config.instanceId) {
             throw new Error('BotcastClient requires a valid "instanceId"');
         }
@@ -55,6 +64,7 @@ export class BotcastClient {
             timeout: config.timeout || 30000,
             maxRetries: config.maxRetries ?? 2,
             headers: config.headers || {},
+            autoConnectSocket: config.autoConnectSocket ?? false,
         };
         this.instances = new InstancesModule(this.config);
         this.messages = new MessagesModule(this.config);
@@ -63,6 +73,10 @@ export class BotcastClient {
         this.profile = new ProfileModule(this.config);
         this.broadcast = new BroadcastModule(this.config);
         this.webhook = new BotcastWebhook();
+        this.socket = new BotcastSocketClient(this.config, {
+            autoConnect: config.autoConnectSocket,
+            ...socketOptions,
+        });
     }
     // =========================================================================
     // Top-Level Convenience Shortcuts

package/dist/index.cjs

@@ -14,13 +14,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BotcastWebhook = exports.BotcastAdminClient = exports.BotcastClient = void 0;
+exports.BotcastSocketClient = exports.BotcastWebhook = exports.BotcastAdminClient = exports.BotcastClient = void 0;
 var client_js_1 = require("./client.js");
 Object.defineProperty(exports, "BotcastClient", { enumerable: true, get: function () { return client_js_1.BotcastClient; } });
 var admin_js_1 = require("./admin.js");
 Object.defineProperty(exports, "BotcastAdminClient", { enumerable: true, get: function () { return admin_js_1.BotcastAdminClient; } });
 var index_js_1 = require("./webhooks/index.js");
 Object.defineProperty(exports, "BotcastWebhook", { enumerable: true, get: function () { return index_js_1.BotcastWebhook; } });
+var index_js_2 = require("./socket/index.js");
+Object.defineProperty(exports, "BotcastSocketClient", { enumerable: true, get: function () { return index_js_2.BotcastSocketClient; } });
 __exportStar(require("./errors.js"), exports);
 __exportStar(require("./types/index.js"), exports);
 // Default export

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { BotcastClient } from './client.js';
 export { BotcastAdminClient, BotcastAdminConfig, CreateAdminInstanceOptions, AdminInstanceRecord } from './admin.js';
 export { BotcastWebhook } from './webhooks/index.js';
+export { BotcastSocketClient, BotcastSocketOptions } from './socket/index.js';
 export * from './errors.js';
 export * from './types/index.js';
 import { BotcastClient } from './client.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACrH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,eAAe,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACrH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9E,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -1,6 +1,7 @@
 export { BotcastClient } from './client.js';
 export { BotcastAdminClient } from './admin.js';
 export { BotcastWebhook } from './webhooks/index.js';
+export { BotcastSocketClient } from './socket/index.js';
 export * from './errors.js';
 export * from './types/index.js';
 // Default export

package/dist/modules/messages.cjs

@@ -13,6 +13,23 @@ class MessagesModule extends base_js_1.BaseModule {
             body: payload,
         });
     }
+    /**
+     * Sends modern WhatsApp interactive native flow buttons (Quick Reply, CTA URL, Call, Copy Code).
+     *
+     * @param recipient Target phone number or JID
+     * @param buttonsOptions Buttons configuration (body, title, footer, buttons array)
+     */
+    async sendButtons(recipient, buttonsOptions) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('buttons'),
+            body: {
+                recipient,
+                type: 'buttons',
+                ...buttonsOptions,
+            },
+        });
+    }
     /**
      * Sends a plain text message.
      *

package/dist/modules/messages.d.ts

@@ -1,10 +1,17 @@
 import { BaseModule } from './base.js';
-import { SendMessageResponse, SendOTPOptions, MessageKey, BaseMessageOptions } from '../types/index.js';
+import { SendMessageResponse, SendOTPOptions, SendButtonsOptions, MessageKey, BaseMessageOptions } from '../types/index.js';
 export declare class MessagesModule extends BaseModule {
     /**
      * Sends a raw message payload to the Botcast gateway.
      */
     send(payload: Record<string, any>): Promise<SendMessageResponse>;
+    /**
+     * Sends modern WhatsApp interactive native flow buttons (Quick Reply, CTA URL, Call, Copy Code).
+     *
+     * @param recipient Target phone number or JID
+     * @param buttonsOptions Buttons configuration (body, title, footer, buttons array)
+     */
+    sendButtons(recipient: string, buttonsOptions: SendButtonsOptions): Promise<SendMessageResponse>;
     /**
      * Sends a plain text message.
      *

package/dist/modules/messages.d.ts.map

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

package/dist/modules/messages.js

@@ -10,6 +10,23 @@ export class MessagesModule extends BaseModule {
             body: payload,
         });
     }
+    /**
+     * Sends modern WhatsApp interactive native flow buttons (Quick Reply, CTA URL, Call, Copy Code).
+     *
+     * @param recipient Target phone number or JID
+     * @param buttonsOptions Buttons configuration (body, title, footer, buttons array)
+     */
+    async sendButtons(recipient, buttonsOptions) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('buttons'),
+            body: {
+                recipient,
+                type: 'buttons',
+                ...buttonsOptions,
+            },
+        });
+    }
     /**
      * Sends a plain text message.
      *

package/dist/socket/index.cjs

@@ -0,0 +1,240 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotcastSocketClient = void 0;
+const socket_io_client_1 = require("socket.io-client");
+/**
+ * BotcastSocketClient
+ * Real-time event streaming client powered by Socket.io.
+ * Provides authenticated multi-tenant real-time subscriptions to WhatsApp and Telegram instance events.
+ */
+class BotcastSocketClient {
+    socket = null;
+    config;
+    socketOptions;
+    constructor(config, options = {}) {
+        this.config = config;
+        this.socketOptions = options;
+        if (options.autoConnect) {
+            this.connect();
+        }
+    }
+    /**
+     * Establish the real-time Socket.io connection to the Botcast Gateway.
+     */
+    connect() {
+        if (this.socket && this.socket.connected) {
+            return this.socket;
+        }
+        const { baseUrl, instanceId, instanceToken } = this.config;
+        const cleanBaseUrl = baseUrl.replace(/\/+$/, '');
+        this.socket = (0, socket_io_client_1.io)(cleanBaseUrl, {
+            path: '/socket.io',
+            transports: ['websocket', 'polling'],
+            autoConnect: true,
+            reconnection: true,
+            reconnectionAttempts: Infinity,
+            reconnectionDelay: 1000,
+            reconnectionDelayMax: 5000,
+            auth: {
+                instanceId,
+                token: instanceToken,
+            },
+            query: {
+                instanceId,
+                token: instanceToken,
+            },
+            extraHeaders: {
+                'x-instance-id': instanceId,
+                'x-instance-token': instanceToken,
+            },
+            ...this.socketOptions,
+        });
+        return this.socket;
+    }
+    /**
+     * Disconnect the active Socket.io connection.
+     */
+    disconnect() {
+        if (this.socket) {
+            this.socket.disconnect();
+        }
+        return this;
+    }
+    /**
+     * Check whether the socket is currently connected.
+     */
+    isConnected() {
+        return Boolean(this.socket && this.socket.connected);
+    }
+    /**
+     * Retrieve the underlying Socket.io-client Socket instance.
+     */
+    getRawSocket() {
+        return this.socket;
+    }
+    /**
+     * Register a typed event listener for instance events.
+     *
+     * @param event The event name
+     * @param handler The event callback function
+     */
+    on(event, handler) {
+        const s = this.ensureSocket();
+        s.on(event, handler);
+        return this;
+    }
+    /**
+     * Register a one-time event listener.
+     */
+    once(event, handler) {
+        const s = this.ensureSocket();
+        s.once(event, handler);
+        return this;
+    }
+    /**
+     * Remove an event listener.
+     */
+    off(event, handler) {
+        if (this.socket) {
+            if (handler) {
+                this.socket.off(event, handler);
+            }
+            else {
+                this.socket.off(event);
+            }
+        }
+        return this;
+    }
+    /**
+     * Register a wildcard listener for all incoming events.
+     */
+    onAny(handler) {
+        const s = this.ensureSocket();
+        s.onAny(handler);
+        return this;
+    }
+    /**
+     * Remove a wildcard listener.
+     */
+    offAny(handler) {
+        if (this.socket) {
+            this.socket.offAny(handler);
+        }
+        return this;
+    }
+    // =========================================================================
+    // High-Level Convenience Event Listeners
+    // =========================================================================
+    /**
+     * Listen for incoming and outgoing messages (messages.upsert or chat_message).
+     */
+    onMessage(handler) {
+        this.on('messages.upsert', handler);
+        this.on('chat_message', handler);
+        return this;
+    }
+    /**
+     * Listen for message delivery status updates (sent, delivered, read receipts).
+     */
+    onMessageStatus(handler) {
+        return this.on('message_status', handler);
+    }
+    /**
+     * Listen for message reactions (emoji added/removed).
+     */
+    onReaction(handler) {
+        return this.on('message_reaction', handler);
+    }
+    /**
+     * Listen for message revocations/deletions.
+     */
+    onMessageDeleted(handler) {
+        return this.on('message_deleted', handler);
+    }
+    /**
+     * Listen for user presence changes (composing, recording, online, offline).
+     */
+    onPresence(handler) {
+        this.on('presence.update', handler);
+        this.on('presence_update', handler);
+        return this;
+    }
+    /**
+     * Listen for instance connection changes, QR code generation, and pairing codes.
+     */
+    onConnectionUpdate(handler) {
+        this.on('connection.update', handler);
+        this.on('instance_update', handler);
+        return this;
+    }
+    /**
+     * Listen for WhatsApp group participant changes (add, remove, promote, demote).
+     */
+    onGroupParticipants(handler) {
+        return this.on('group-participants.update', handler);
+    }
+    /**
+     * Listen for incoming WhatsApp calls.
+     */
+    onCall(handler) {
+        return this.on('call', handler);
+    }
+    /**
+     * Listen for generic instance event stream.
+     */
+    onEvent(handler) {
+        return this.on('instance_event', handler);
+    }
+    // =========================================================================
+    // Telegram-Specific Event Listeners
+    // =========================================================================
+    /**
+     * Listen for Telegram new messages.
+     */
+    onTelegramMessage(handler) {
+        return this.on('telegram.message', handler);
+    }
+    /**
+     * Listen for Telegram message edits.
+     */
+    onTelegramMessageEdited(handler) {
+        return this.on('telegram.message_edited', handler);
+    }
+    /**
+     * Listen for Telegram message deletions.
+     */
+    onTelegramMessageDeleted(handler) {
+        return this.on('telegram.message_deleted', handler);
+    }
+    /**
+     * Listen for Telegram message read receipts.
+     */
+    onTelegramMessageRead(handler) {
+        return this.on('telegram.message_read', handler);
+    }
+    /**
+     * Listen for Telegram user updates (presence, typing, online status).
+     */
+    onTelegramUserUpdate(handler) {
+        return this.on('telegram.user_update', handler);
+    }
+    /**
+     * Listen for Telegram chat actions (user joined, user left, etc.).
+     */
+    onTelegramChatAction(handler) {
+        return this.on('telegram.chat_action', handler);
+    }
+    /**
+     * Listen for Telegram inline & callback button queries.
+     */
+    onTelegramCallbackQuery(handler) {
+        return this.on('telegram.callback_query', handler);
+    }
+    ensureSocket() {
+        if (!this.socket) {
+            this.connect();
+        }
+        return this.socket;
+    }
+}
+exports.BotcastSocketClient = BotcastSocketClient;