botcast-sdk 1.0.8 → 1.0.10

package/dist/types/socket.d.ts

@@ -0,0 +1,253 @@
+/**
+ * Socket.io Real-Time Event Types for Botcast SDK
+ */
+export interface SocketAuthenticatedEvent {
+    success: boolean;
+    instanceId: string;
+    instanceName?: string;
+    platform?: string;
+    status?: string;
+    phoneNumber?: string | null;
+    timestamp: string;
+}
+export interface SocketMessagesUpsertEvent {
+    instanceId: string;
+    type: string;
+    messages: any[];
+    timestamp?: number;
+}
+export interface SocketMessagesUpdateEvent {
+    instanceId: string;
+    updates: Array<{
+        key: {
+            remoteJid?: string;
+            fromMe?: boolean;
+            id?: string;
+            participant?: string;
+        };
+        update: {
+            status?: number | string;
+            pollUpdates?: any;
+            [key: string]: any;
+        };
+    }>;
+    timestamp?: number;
+}
+export interface SocketMessageStatusEvent {
+    instanceId: string;
+    key: {
+        remoteJid?: string;
+        fromMe?: boolean;
+        id?: string;
+        participant?: string;
+    };
+    status: number | string;
+    update: Record<string, any>;
+    timestamp?: number;
+}
+export interface SocketMessageReactionEvent {
+    instanceId: string;
+    chatJid: string;
+    messageId: string;
+    emoji: string;
+    senderJid: string;
+    fromMe: boolean;
+    timestamp?: number;
+}
+export interface SocketMessageDeletedEvent {
+    instanceId: string;
+    chatJid: string;
+    messageId: string;
+    timestamp?: number;
+}
+export interface SocketChatMessageEvent {
+    instanceId: string;
+    chatJid?: string;
+    fromMe?: number | boolean;
+    body?: string;
+    messageType?: string;
+    timestamp?: number;
+    id?: string;
+}
+export interface SocketChatsUpsertEvent {
+    instanceId: string;
+    chats: any[];
+    timestamp?: number;
+}
+export interface SocketChatsUpdateEvent {
+    instanceId: string;
+    updates: any[];
+    timestamp?: number;
+}
+export interface SocketChatsDeleteEvent {
+    instanceId: string;
+    deletions: any[];
+    timestamp?: number;
+}
+export interface SocketContactsUpsertEvent {
+    instanceId: string;
+    contacts?: any[];
+    timestamp?: number;
+}
+export interface SocketContactsUpdateEvent {
+    instanceId: string;
+    updates?: any[];
+    timestamp?: number;
+}
+export interface SocketPresenceUpdateEvent {
+    instanceId: string;
+    id?: string;
+    presences?: Record<string, {
+        lastKnownPresence?: string;
+        lastSeen?: number;
+    }>;
+    presence?: any;
+    timestamp?: number;
+}
+export interface SocketGroupParticipantsUpdateEvent {
+    instanceId: string;
+    update: {
+        id: string;
+        author?: string;
+        participants: string[];
+        action: "add" | "remove" | "promote" | "demote";
+    };
+    timestamp?: number;
+}
+export interface SocketGroupsUpdateEvent {
+    instanceId: string;
+    updates: any[];
+    timestamp?: number;
+}
+export interface SocketInstanceUpdateEvent {
+    instanceId: string;
+    status?: "disconnected" | "connecting" | "qr_ready" | "connected" | "stopped";
+    qr?: string | null;
+    pairingCode?: string | null;
+    phoneNumber?: string | null;
+    profileName?: string | null;
+    profilePicUrl?: string | null;
+    profileBio?: string | null;
+    expired?: boolean;
+    expires_at?: string | null;
+    timestamp?: number;
+}
+export interface SocketCallEvent {
+    instanceId: string;
+    calls: any[];
+    timestamp?: number;
+}
+export interface SocketPollUpdateEvent {
+    instanceId: string;
+    key: any;
+    pollUpdates: any;
+    timestamp?: number;
+}
+export interface SocketGenericEvent {
+    instanceId: string;
+    event: string;
+    timestamp: number;
+    [key: string]: any;
+}
+export interface SocketTelegramMessageEvent {
+    instanceId: string;
+    messageId: number | string;
+    chatId: string;
+    senderId: string;
+    text: string;
+    fromMe: boolean;
+    timestamp: number;
+}
+export interface SocketTelegramMessageEditedEvent {
+    instanceId: string;
+    messageId: number | string;
+    chatId: string;
+    text: string;
+}
+export interface SocketTelegramMessageDeletedEvent {
+    instanceId: string;
+    deletedIds: Array<number | string>;
+}
+export interface SocketTelegramMessageReadEvent {
+    instanceId: string;
+    chatId: string;
+    maxId?: string | null;
+    out: boolean;
+}
+export interface SocketTelegramUserUpdateEvent {
+    instanceId: string;
+    userId: string;
+    online: boolean;
+    typing: boolean;
+    lastSeen?: any;
+}
+export interface SocketTelegramChatActionEvent {
+    instanceId: string;
+    chatId: string;
+    participants: string[];
+    userJoined: boolean;
+    userLeft: boolean;
+}
+export interface SocketTelegramCallbackQueryEvent {
+    instanceId: string;
+    queryId?: string | null;
+    chatId?: string | null;
+    data?: string | null;
+    senderId?: string | null;
+}
+/**
+ * Event Map for Strong Typing in Socket Listeners
+ */
+export interface BotcastSocketEventMap {
+    authenticated: SocketAuthenticatedEvent;
+    "messages.upsert": SocketMessagesUpsertEvent;
+    "messages.update": SocketMessagesUpdateEvent;
+    "messages.delete": {
+        instanceId: string;
+        item: any;
+        timestamp?: number;
+    };
+    "messages.reaction": {
+        instanceId: string;
+        reactions: any[];
+        timestamp?: number;
+    };
+    message_status: SocketMessageStatusEvent;
+    message_reaction: SocketMessageReactionEvent;
+    message_deleted: SocketMessageDeletedEvent;
+    chat_message: SocketChatMessageEvent;
+    "chats.upsert": SocketChatsUpsertEvent;
+    "chats.update": SocketChatsUpdateEvent;
+    "chats.delete": SocketChatsDeleteEvent;
+    chats_update: {
+        instanceId: string;
+        timestamp?: number;
+    };
+    "contacts.upsert": SocketContactsUpsertEvent;
+    "contacts.update": SocketContactsUpdateEvent;
+    contacts_update: {
+        instanceId: string;
+        timestamp?: number;
+    };
+    "presence.update": SocketPresenceUpdateEvent;
+    presence_update: SocketPresenceUpdateEvent;
+    "group-participants.update": SocketGroupParticipantsUpdateEvent;
+    "groups.update": SocketGroupsUpdateEvent;
+    "connection.update": SocketInstanceUpdateEvent;
+    instance_update: SocketInstanceUpdateEvent;
+    call: SocketCallEvent;
+    poll_update: SocketPollUpdateEvent;
+    instance_event: SocketGenericEvent;
+    "telegram.message": SocketTelegramMessageEvent;
+    "telegram.message_edited": SocketTelegramMessageEditedEvent;
+    "telegram.message_deleted": SocketTelegramMessageDeletedEvent;
+    "telegram.message_read": SocketTelegramMessageReadEvent;
+    "telegram.user_update": SocketTelegramUserUpdateEvent;
+    "telegram.chat_action": SocketTelegramChatActionEvent;
+    "telegram.callback_query": SocketTelegramCallbackQueryEvent;
+    connect: void;
+    disconnect: string;
+    connect_error: Error;
+}
+export type SocketEventHandler<T = any> = (data: T) => void | Promise<void>;
+//# sourceMappingURL=socket.d.ts.map

package/dist/types/socket.d.ts.map

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

package/dist/types/socket.js

@@ -0,0 +1,4 @@
+/**
+ * Socket.io Real-Time Event Types for Botcast SDK
+ */
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botcast-sdk",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "Official TypeScript/JavaScript SDK for Botcast WhatsApp & Telegram MTProto Multi-Instance API Gateway",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -16,6 +16,11 @@
       "types": "./dist/webhooks/index.d.ts",
       "import": "./dist/webhooks/index.js",
       "require": "./dist/webhooks/index.cjs"
+    },
+    "./socket": {
+      "types": "./dist/socket/index.d.ts",
+      "import": "./dist/socket/index.js",
+      "require": "./dist/socket/index.cjs"
     }
   },
   "files": [
@@ -62,5 +67,8 @@
   },
   "devDependencies": {
     "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "socket.io-client": "^4.8.3"
   }
 }