botcast-sdk 1.0.3 → 1.0.6

package/README.md

@@ -1,6 +1,6 @@
 # botcast-sdk
 
-Node.js and TypeScript client for [Botcast](https://botcast.site), a multi-instance WhatsApp REST API gateway.
+Official Node.js and TypeScript SDK for [Botcast](https://botcast.site) — a high-performance, multi-instance API gateway supporting both **WhatsApp** and **Telegram MTProto** (`teleproto`).
 
 [![npm version](https://img.shields.io/npm/v/botcast-sdk.svg?color=blue)](https://www.npmjs.com/package/botcast-sdk)
 [![npm downloads](https://img.shields.io/npm/dm/botcast-sdk.svg)](https://www.npmjs.com/package/botcast-sdk)
@@ -11,14 +11,17 @@ Node.js and TypeScript client for [Botcast](https://botcast.site), a multi-insta
 
 ## Features
 
-- Zero runtime dependencies: built on native `fetch`.
-- Full TypeScript types for every request payload, response model, and error class.
-- Dual device pairing: scan a QR code string or request an 8-digit phone PIN to link without a camera.
-- 42 WhatsApp REST endpoints: text messages with mentions, OTPs, images, videos, audio, voice notes (PTT), documents, stickers, locations, contact vCards, and interactive polls.
-- Message controls: edit, delete for everyone, mark as read, reactions, pin messages, and forward.
-- Group management: create groups, manage participants, update subjects and descriptions, configure settings, and handle join requests.
-- Safety controls: configure daily caps on sent messages and new contacts.
-- Built-in webhook router: parse and handle inbound messages and connection events in Express, Fastify, Next.js, or raw Node HTTP.
+- **Multi-Platform Support**: Connect and control both **WhatsApp** and **Telegram MTProto** instances with a single unified SDK.
+- **Zero Runtime Dependencies**: Built directly on native `fetch` and modern standard web APIs.
+- **Strict TypeScript Types**: Fully typed request parameters, response models, error classes, and event payloads.
+- **Dual Authentication**:
+  - **WhatsApp**: Scan QR code string or request an 8-digit PIN code without a camera.
+  - **Telegram**: Scan QR code via *Telegram > Settings > Devices > Link Desktop Device* or authenticate via phone verification code with optional Cloud 2FA password.
+- **Unified Messaging**: Send text messages, automated OTP codes, images, videos, audio, voice notes (PTT), documents, stickers, locations, contact cards, and interactive polls.
+- **Message Operations**: Edit sent messages, delete for everyone (revoke), mark as read, reactions, pin messages, and forward.
+- **Chat & History Management**: Query dialogs, contact lists, and message history for both platforms.
+- **Group Administration**: Create groups, manage participants, configure permission modes, and share invite links (WhatsApp).
+- **Real-Time Webhooks**: Built-in router and middleware for processing inbound messages and connection events across Express, Fastify, Next.js, or raw Node HTTP.
 
 ---
 
@@ -36,30 +39,60 @@ bun add botcast-sdk
 
 ---
 
-## Quick start
+## Quick Start
+
+### 1. Admin & Fleet Management (Create, Manage & Renew Instances)
+
+Use `BotcastAdminClient` with your Master Partner API Key (`bcast_live_...`) to programmatically create and manage customer instances:
+
+```typescript
+import { BotcastAdminClient } from 'botcast-sdk';
+
+const admin = new BotcastAdminClient({
+  baseUrl: 'https://botcast.site',
+  apiKey: process.env.BOTCAST_API_KEY!, // Master API Key
+});
+
+// List all instances
+const { instances } = await admin.listInstances();
+
+// Create a new WhatsApp or Telegram instance for a customer
+const { instance } = await admin.createInstance({
+  name: 'Customer Store 1',
+  platform: 'whatsapp',
+  type: 'paid',
+  plan_months: 12,
+});
+
+// Renew subscription
+await admin.renewInstance(instance.id, { months: 12 });
+```
+
+---
+
+### 2. WhatsApp Client
 
 ```typescript
 import { BotcastClient } from 'botcast-sdk';
 
-const client = new BotcastClient({
+const whatsappBot = new BotcastClient({
   baseUrl: 'https://botcast.site', // or your self-hosted server URL
+  platform: 'whatsapp',           // 'whatsapp' (default) or 'telegram'
   instanceId: 'your_instance_id',
   instanceToken: 'your_instance_token',
 });
 
 async function main() {
-  // 1. Check instance connectivity
-  const status = await client.getStatus();
-  console.log(`Connected phone: ${status.phoneNumber || 'Not linked'}`);
+  // Check connectivity
+  const status = await whatsappBot.getStatus();
+  console.log(`WhatsApp state: ${status.status} (${status.phoneNumber || 'Unpaired'})`);
 
-  // 2. Send a text message with user mentions
-  const result = await client.messages.sendText('201012345678', 'Hello @201012345678!', {
-    mentions: ['201012345678'],
-  });
-  console.log('Message ID:', result.messageId);
+  // Send a text message
+  const res = await whatsappBot.messages.sendText('201012345678', 'Hello from WhatsApp via Botcast SDK!');
+  console.log('Message sent! ID:', res.messageId);
 
-  // 3. Send a secure 6-digit OTP code
-  const otp = await client.messages.sendOTP('201012345678', {
+  // Send a secure 6-digit OTP code
+  const otp = await whatsappBot.messages.sendOTP('201012345678', {
     appName: 'My App',
     expiryMinutes: 5,
   });
@@ -69,12 +102,54 @@ async function main() {
 main().catch(console.error);
 ```
 
+---
+
+### 2. Telegram MTProto Client
+
+```typescript
+import { BotcastClient } from 'botcast-sdk';
+
+const telegramBot = new BotcastClient({
+  baseUrl: 'https://botcast.site',
+  platform: 'telegram',
+  instanceId: 'your_telegram_instance_id',
+  instanceToken: 'your_telegram_instance_token',
+});
+
+async function main() {
+  // Check connectivity
+  const status = await telegramBot.getStatus();
+  console.log(`Telegram state: ${status.status}`);
+
+  // Send a text message to a phone number or @username
+  const res = await telegramBot.messages.sendText('+1234567890', 'Hello from Telegram MTProto!');
+  console.log('Message ID:', res.messageId);
+
+  // Send a photo
+  await telegramBot.messages.sendImage('+1234567890', {
+    url: 'https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?w=800',
+    caption: 'Welcome flyer',
+  });
+
+  // Send OTP
+  const otp = await telegramBot.messages.sendOTP('+1234567890', {
+    appName: 'Security Portal',
+  });
+  console.log('Telegram OTP sent:', otp.codeSent);
+}
+
+main().catch(console.error);
+```
+
+---
+
 ### CommonJS (require)
 
 ```javascript
 const { BotcastClient } = require('botcast-sdk');
 
 const client = new BotcastClient({
+  platform: 'telegram', // or 'whatsapp'
   instanceId: 'your_instance_id',
   instanceToken: 'your_instance_token',
 });
@@ -82,108 +157,86 @@ const client = new BotcastClient({
 
 ---
 
-## API reference
+## API Reference
 
-### 1. Device pairing and lifecycle (`client.instances`)
+### 1. Device Pairing and Lifecycle (`client.instances`)
 
 ```typescript
 // 1. Get live status
 const status = await client.instances.getStatus();
-console.log('Socket state:', status.status); // 'connected' | 'pairing' | 'disconnected'
+console.log('State:', status.status); // 'connected' | 'qr_ready' | 'stopped' | 'connecting'
 
 // 2. Option A: Get QR code string for camera scanning
+// (WhatsApp: Linked Devices | Telegram: Settings > Devices > Link Desktop Device)
 const qr = await client.getQR(); // or client.instances.getQR()
-console.log('Scan QR:', qr.qr);
-
-// 3. Option B: Request 8-digit phone PIN code (link without scanning)
-const pair = await client.pairWithCode('201012345678'); // or client.instances.pairWithCode(...)
-console.log('Enter this PIN on WhatsApp notification:', pair.code); // e.g. "8492-0193"
+console.log('QR DataURL:', qr.qr);
 
-// 4. Start, stop, or log out
-await client.instances.start(); // Boots socket connection
-await client.instances.stop();  // Suspends socket session
-await client.instances.logout(); // Unlinks device and deletes session
+// 3. Option B: Request Phone Pairing / Login Code
+// (WhatsApp sends 8-digit PIN | Telegram sends verification code into app)
+const pair = await client.pairWithCode('+1234567890');
+console.log('Code request status:', pair);
 
-// 5. Verify phone number on WhatsApp
-const check = await client.checkNumber('201012345678');
-console.log('Exists on WhatsApp:', check.exists, 'JID:', check.jid);
+// 4. Complete Telegram Phone Login (with optional 2FA cloud password)
+await client.instances.verifyCode('+1234567890', '12345', 'myCloudPassword2fa');
 
-// 6. Set presence state
-await client.instances.setPresence({
-  presence: 'composing', // 'available' | 'unavailable' | 'composing' | 'recording' | 'paused'
-  recipient: '201012345678',
-});
-
-// 7. Manage sandbox allowed numbers (developer tier)
-const allowed = await client.instances.getAllowedNumbers();
-await client.instances.setAllowedNumbers(['201012345678', '966500000000']);
+// 5. Socket engine controls
+await client.instances.start();  // Boots socket / MTProto connection
+await client.instances.stop();   // Suspends socket session
+await client.instances.logout(); // Unlinks device and clears session credentials
 ```
 
 ---
 
-### 2. Message and media dispatching (`client.messages`)
+### 2. Message Dispatching (`client.messages`)
+
+All messaging methods work across both **WhatsApp** and **Telegram**:
 
 ```typescript
-// 1. Text message with mentions and quoted replies
-await client.messages.sendText('201012345678', 'Hello World', {
-  mentions: ['201012345678'],
-  quotedMsgId: 'MSG_ID_TO_REPLY_TO',
+// 1. Text message
+await client.messages.sendText('+1234567890', 'Hello World', {
+  mentions: ['1234567890'], // WhatsApp mentions
 });
 
-// 2. Image
-await client.messages.sendImage('201012345678', {
+// 2. Image / Photo
+await client.messages.sendImage('+1234567890', {
   url: 'https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?w=800',
   caption: 'Photo preview',
 });
 
-// 3. Video (or round PTV message)
-await client.messages.sendVideo('201012345678', {
+// 3. Video
+await client.messages.sendVideo('+1234567890', {
   url: 'https://sample-videos.com/video321/mp4/720/big_buck_bunny_720p_1mb.mp4',
   caption: 'Product tutorial video',
-  ptv: false,
 });
 
-// 4. Voice note (PTT waveform) and audio
-await client.messages.sendVoice('201012345678', {
+// 4. Voice note and audio
+await client.messages.sendVoice('+1234567890', {
   url: 'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3',
 });
 
-// 5. Document, PDF, or file attachment
-await client.messages.sendDocument('201012345678', {
+// 5. Document / PDF / File
+await client.messages.sendDocument('+1234567890', {
   url: 'https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf',
   fileName: 'Invoice_2026.pdf',
-  mimetype: 'application/pdf',
   caption: 'Monthly invoice statement',
 });
 
-// 6. Sticker
-await client.messages.sendSticker('201012345678', {
-  url: 'https://raw.githubusercontent.com/WhatsApp/stickers/main/Android/app/src/main/assets/1/01_Cider_Happy.webp',
-});
-
-// 7. Location coordinates
-await client.messages.sendLocation('201012345678', {
+// 6. Location coordinates
+await client.messages.sendLocation('+1234567890', {
   latitude: 24.7136,
   longitude: 46.6753,
   name: 'Kingdom Tower',
   address: 'King Fahd Rd, Riyadh, Saudi Arabia',
 });
 
-// 8. Contact vCard
-await client.messages.sendContact('201012345678', {
-  displayName: 'Support Team',
-  vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:Support Team\nTEL;TYPE=CELL:+201012345678\nEND:VCARD',
+// 7. Contact Card
+await client.messages.sendContact('+1234567890', {
+  firstName: 'Support Agent',
+  phone: '+1234567890',
 });
 
-// 9. Interactive poll
-await client.messages.sendPoll('201012345678', {
-  name: 'How do you rate Botcast API speed?',
-  values: ['Fast', 'Good', 'Needs improvement'],
-  selectableCount: 1,
-});
-
-// 10. OTP verification code
-const otp = await client.messages.sendOTP('201012345678', {
+// 8. Automated OTP verification code
+const otp = await client.messages.sendOTP('+1234567890', {
   appName: 'Botcast Portal',
   expiryMinutes: 5,
 });
@@ -191,7 +244,7 @@ const otp = await client.messages.sendOTP('201012345678', {
 
 ---
 
-### 3. Message operations (`client.messages`)
+### 3. Message Operations (`client.messages`)
 
 ```typescript
 const msgKey = {
@@ -200,19 +253,19 @@ const msgKey = {
   id: '3EB0ABCDEF1234567890',
 };
 
-// 1. Edit sent message (within 15 minutes)
+// 1. Edit sent message
 await client.messages.edit('201012345678', msgKey, 'Corrected text content');
 
 // 2. Delete message for everyone (revoke)
 await client.messages.delete('201012345678', msgKey);
 
-// 3. Mark message as read (blue tick)
+// 3. Mark message as read
 await client.messages.markAsRead(msgKey);
 
-// 4. Emoji reaction (pass empty string to remove)
+// 4. Emoji reaction
 await client.messages.react('201012345678', msgKey, '👍');
 
-// 5. Pin message (86400 = 24h, 604800 = 7d, 2592000 = 30d)
+// 5. Pin message
 await client.messages.pin('201012345678', msgKey, 1, 86400);
 
 // 6. Forward message
@@ -221,173 +274,31 @@ await client.messages.forward('201012345678', { conversation: 'Forwarded message
 
 ---
 
-### 4. Chats, contacts, and sync (`client.chats`)
+### 4. Chats, Contacts, and History (`client.chats`)
 
 ```typescript
-// 1. List synced chats
-const { chats, total } = await client.chats.list({ limit: 50, offset: 0 });
+// 1. List chats / dialogs
+const { chats } = await client.chats.list({ limit: 50 });
 
-// 2. List synced contacts
+// 2. List contacts
 const { contacts } = await client.chats.listContacts({ limit: 100 });
 
-// 3. List synced messages
+// 3. List messages for a chat
 const { messages } = await client.chats.listMessages({ chatJid: '201012345678@s.whatsapp.net', limit: 50 });
 
-// 4. Modify chat state (archive, mute, pin, delete)
+// 4. Modify WhatsApp chat state (archive, mute, pin, delete)
 await client.chats.archive('201012345678@s.whatsapp.net');
-await client.chats.unarchive('201012345678@s.whatsapp.net');
 await client.chats.mute('201012345678@s.whatsapp.net', 8 * 60 * 60 * 1000); // 8 hours
-await client.chats.unmute('201012345678@s.whatsapp.net');
 await client.chats.pin('201012345678@s.whatsapp.net');
-await client.chats.unpin('201012345678@s.whatsapp.net');
-await client.chats.deleteChat('201012345678@s.whatsapp.net');
-
-// 5. Set disappearing messages timer
-await client.chats.setDisappearing('201012345678', 86400, true);
-
-// 6. Request older history from linked phone
-await client.chats.fetchHistory({ count: 50 });
-
-// 7. Trigger immediate sync
-await client.instances.sync();
-```
-
----
-
-### 5. Profile, presence, and business details (`client.profile`)
-
-```typescript
-// 1. Get and update bio status
-const bio = await client.profile.getStatus('201012345678');
-await client.profile.setStatus('Available via Botcast API');
-
-// 2. Update display name
-await client.profile.setName('Botcast Agent');
-
-// 3. Profile picture management
-const pic = await client.profile.getPicture('201012345678', true); // High-res
-await client.profile.setPicture({ url: 'https://botcast.site/logo.png' });
-await client.profile.removePicture();
-
-// 4. Inspect WhatsApp Business profile
-const biz = await client.profile.getBusinessProfile('201012345678');
-console.log('Business category:', biz.businessProfile.category);
-```
-
----
-
-### 6. Group administration (`client.groups`)
-
-```typescript
-// 1. Create a WhatsApp group
-const group = await client.groups.create('VIP Customers', ['201012345678', '966500000000']);
-const groupJid = group.group.id;
-
-// 2. List groups and fetch metadata
-const { groups } = await client.groups.list();
-const { metadata } = await client.groups.getMetadata(groupJid);
-
-// 3. Participant management (add, remove, promote, demote)
-await client.groups.addParticipants(groupJid, ['201099999999']);
-await client.groups.removeParticipants(groupJid, ['201099999999']);
-await client.groups.promoteParticipants(groupJid, ['201012345678']);
-await client.groups.demoteParticipants(groupJid, ['201012345678']);
-
-// 4. Update group subject and description
-await client.groups.updateSubject(groupJid, 'New Group Title');
-await client.groups.updateDescription(groupJid, 'Official VIP discussion group.');
-
-// 5. Update group settings
-await client.groups.updateSettings(groupJid, 'announcement'); // Admins only send messages
-await client.groups.updateSettings(groupJid, 'not_announcement'); // All members can chat
-await client.groups.updateSettings(groupJid, 'locked'); // Admins only edit info
-await client.groups.updateSettings(groupJid, 'unlocked');
-
-// 6. Shareable invite codes and links
-const invite = await client.groups.getInviteCode(groupJid);
-console.log('Invite link:', invite.link);
-await client.groups.revokeInviteCode(groupJid);
-await client.groups.acceptInvite('InviteCodeString');
-const info = await client.groups.getInviteInfo('InviteCodeString');
-
-// 7. Join requests moderation (admin approval mode)
-const pending = await client.groups.getJoinRequests(groupJid);
-await client.groups.updateJoinRequests(groupJid, ['201012345678'], 'approve');
-
-// 8. Ephemeral messages and member add mode
-await client.groups.setEphemeral(groupJid, 86400); // 24h
-await client.groups.setMemberAddMode(groupJid, 'admin_add'); // Only admins add
-
-// 9. Leave group
-await client.groups.leave(groupJid);
-```
-
----
-
-### 7. Privacy and blocklist (`client.profile`)
-
-```typescript
-// 1. Block and unblock contacts
-await client.profile.block('201012345678');
-await client.profile.unblock('201012345678');
-
-// 2. Get blocklist
-const { blocklist } = await client.profile.getBlocklist();
-
-// 3. Get and update privacy visibility settings
-const privacy = await client.profile.getPrivacySettings();
-// Options: 'all' | 'contacts' | 'contact_blacklist' | 'none'
-await client.profile.updatePrivacySetting('lastSeen', 'all');
-await client.profile.updatePrivacySetting('online', 'all');
-await client.profile.updatePrivacySetting('profilePicture', 'contacts');
-await client.profile.updatePrivacySetting('status', 'contacts');
-await client.profile.updatePrivacySetting('readReceipts', 'all');
-```
-
----
-
-### 8. 24-hour status stories and broadcasts (`client.broadcast`)
-
-```typescript
-// 1. Publish status story (text, image, video, or audio)
-await client.broadcast.sendStatusStory({
-  type: 'text',
-  text: 'New update available on Botcast.',
-  backgroundColor: '#10b981',
-});
-
-// 2. Get broadcast list info
-const list = await client.broadcast.getListInfo('1234567890@broadcast');
-```
-
----
-
-### 9. Rate limits and safety controls (`client.instances`)
-
-```typescript
-// 1. Read current limits
-const limits = await client.instances.getLimits();
-console.log('Daily message limit:', limits.daily_message_limit);
-console.log('Daily new contacts limit:', limits.daily_new_contacts_limit);
-
-// 2. Update limits (pass 0 to disable)
-await client.instances.setDailyMessageLimit(1000);
-await client.instances.setDailyNewContactsLimit(100);
-
-// Or update both at once
-await client.instances.updateLimits({
-  daily_message_limit: 500,
-  daily_new_contacts_limit: 50,
-});
 ```
 
 ---
 
-### 10. Webhook event handling
+### 5. Webhook Event Handling
 
-The SDK includes an event dispatcher and middleware for handling inbound webhooks:
+The SDK includes a built-in event dispatcher and middleware for handling inbound webhooks from both WhatsApp and Telegram:
 
-#### Express example
+#### Express Example
 
 ```typescript
 import express from 'express';
@@ -397,13 +308,14 @@ const app = express();
 app.use(express.json());
 
 const client = new BotcastClient({
+  platform: 'telegram', // or 'whatsapp'
   instanceId: 'inst_123',
   instanceToken: 'tok_abc',
 });
 
 // Listen for incoming messages
 client.webhook.onMessage(async (event) => {
-  console.log(`Message from ${event.pushName || event.sender}: ${event.message}`);
+  console.log(`Message from ${event.sender}: ${event.message} [Platform: ${event.platform || 'whatsapp'}]`);
 
   if (event.message.trim().toLowerCase() === 'ping') {
     await client.messages.sendText(event.sender, 'pong');
@@ -412,7 +324,7 @@ client.webhook.onMessage(async (event) => {
 
 // Listen for connection changes
 client.webhook.onConnection(async (event) => {
-  console.log(`Instance state updated: ${event.status}`);
+  console.log(`Instance status updated: ${event.status}`);
 });
 
 // Mount middleware on your webhook route
@@ -423,7 +335,7 @@ app.listen(3000, () => console.log('Webhook server running on port 3000'));
 
 ---
 
-## Error handling
+## Error Handling
 
 `botcast-sdk` maps API status codes to typed error classes:
 
@@ -439,16 +351,16 @@ import {
 } from 'botcast-sdk';
 
 try {
-  await client.messages.sendText('201012345678', 'Hello World');
+  await client.messages.sendText('+1234567890', 'Hello World');
 } catch (error) {
   if (error instanceof BotcastAuthError) {
     console.error('Invalid instance credentials or token.');
   } else if (error instanceof BotcastPaymentRequiredError) {
-    console.error('Instance requires subscription activation.');
+    console.error('Instance requires payment confirmation.');
   } else if (error instanceof BotcastSubscriptionExpiredError) {
-    console.error('Instance subscription expired on:', error.expiresAt);
+    console.error('Subscription expired on:', error.expiresAt);
   } else if (error instanceof BotcastRateLimitError) {
-    console.error('Daily sending limit reached. Please wait before retrying.');
+    console.error('Daily message limit reached.');
   } else if (error instanceof BotcastValidationError) {
     console.error('Validation error:', error.message, error.details);
   } else if (error instanceof BotcastNotFoundError) {
@@ -465,12 +377,11 @@ try {
 
 - Website: [https://botcast.site](https://botcast.site)
 - Documentation: [https://botcast.site/docs](https://botcast.site/docs)
-- Postman collection: [https://botcast.site/botcast.postman_collection.json](https://botcast.site/botcast.postman_collection.json)
-- NPM package: [https://www.npmjs.com/package/botcast-sdk](https://www.npmjs.com/package/botcast-sdk)
-- GitHub repository: [https://github.com/ANOOBALSA/Botcast](https://github.com/ANOOBALSA/Botcast)
+- NPM Package: [https://www.npmjs.com/package/botcast-sdk](https://www.npmjs.com/package/botcast-sdk)
+- GitHub Repository: [https://github.com/ANOOBALSA/Botcast](https://github.com/ANOOBALSA/Botcast)
 
 ---
 
 ## License
 
-MIT (c) [Botcast](https://botcast.site)
+MIT © [Botcast](https://botcast.site)

package/dist/admin.cjs

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotcastAdminClient = void 0;
+const errors_js_1 = require("./errors.js");
+class BotcastAdminClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    headers;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('BotcastAdminClient requires a valid "apiKey" (e.g. bcast_live_...)');
+        }
+        this.baseUrl = (config.baseUrl || 'https://botcast.site').replace(/\/+$/, '');
+        this.apiKey = config.apiKey.trim();
+        this.timeout = config.timeout || 30000;
+        this.headers = config.headers || {};
+    }
+    async request(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint.startsWith('/') ? '' : '/'}${endpoint}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        const mergedHeaders = {
+            'Content-Type': 'application/json',
+            'x-api-key': this.apiKey,
+            ...this.headers,
+            ...(options.headers || {}),
+        };
+        try {
+            const res = await fetch(url, {
+                ...options,
+                headers: mergedHeaders,
+                signal: controller.signal,
+            });
+            const body = await res.json().catch(() => ({}));
+            if (!res.ok) {
+                throw new errors_js_1.BotcastError(body.message || body.error || `HTTP ${res.status}: ${res.statusText}`, res.status, body);
+            }
+            return body;
+        }
+        catch (err) {
+            if (err.name === 'AbortError') {
+                throw new errors_js_1.BotcastError(`Request timed out after ${this.timeout}ms`, 408);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Lists all instances under this admin/partner account with live statuses and stats.
+     */
+    async listInstances() {
+        return this.request('/api/instances', { method: 'GET' });
+    }
+    /**
+     * Retrieves single instance details including QR code, pairing code, status, and expiry.
+     */
+    async getInstance(instanceId) {
+        return this.request(`/api/instances/${instanceId}`, { method: 'GET' });
+    }
+    /**
+     * Creates and immediately provisions a new WhatsApp or Telegram instance.
+     * Admins are zero-payment, so instances are provisioned as active paid instances.
+     */
+    async createInstance(options) {
+        return this.request('/api/instances', {
+            method: 'POST',
+            body: JSON.stringify({
+                name: options.name,
+                platform: options.platform || 'whatsapp',
+                type: options.type || 'paid',
+                plan_months: options.plan_months || 12,
+                allowed_numbers: options.allowed_numbers || [],
+                webhook_url: options.webhook_url || '',
+                target_user_id: options.target_user_id,
+            }),
+        });
+    }
+    /**
+     * Programmatically renews an instance's subscription without payment transactions.
+     */
+    async renewInstance(instanceId, options) {
+        return this.request(`/api/instances/${instanceId}/renew`, {
+            method: 'POST',
+            body: JSON.stringify({
+                months: options?.months || options?.plan_months || 12,
+            }),
+        });
+    }
+    /**
+     * Updates instance configuration (name, webhook URL, allowed recipient numbers).
+     */
+    async updateInstance(instanceId, updates) {
+        return this.request(`/api/instances/${instanceId}`, {
+            method: 'PUT',
+            body: JSON.stringify(updates),
+        });
+    }
+    /**
+     * Regenerates secret instance token for an instance.
+     */
+    async regenerateInstanceToken(instanceId) {
+        return this.request(`/api/instances/${instanceId}/regenerate-token`, {
+            method: 'POST',
+        });
+    }
+    /**
+     * Deletes and cleans up an instance.
+     */
+    async deleteInstance(instanceId) {
+        return this.request(`/api/instances/${instanceId}`, {
+            method: 'DELETE',
+        });
+    }
+}
+exports.BotcastAdminClient = BotcastAdminClient;

package/dist/admin.d.ts

@@ -0,0 +1,97 @@
+export interface BotcastAdminConfig {
+    baseUrl?: string;
+    apiKey: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+export interface CreateAdminInstanceOptions {
+    name: string;
+    platform?: 'whatsapp' | 'telegram';
+    type?: 'dev' | 'paid';
+    plan_months?: number;
+    allowed_numbers?: string[];
+    webhook_url?: string;
+    target_user_id?: number;
+}
+export interface AdminInstanceRecord {
+    id: string;
+    user_id: number;
+    name: string;
+    instance_token: string;
+    platform: 'whatsapp' | 'telegram';
+    type: 'dev' | 'paid';
+    status: string;
+    allowed_numbers: string[];
+    webhook_url: string | null;
+    plan_months: number;
+    expires_at: string | null;
+    is_expired?: boolean;
+    qr?: string | null;
+    pairingCode?: string | null;
+    created_at: string;
+}
+export declare class BotcastAdminClient {
+    private baseUrl;
+    private apiKey;
+    private timeout;
+    private headers;
+    constructor(config: BotcastAdminConfig);
+    private request;
+    /**
+     * Lists all instances under this admin/partner account with live statuses and stats.
+     */
+    listInstances(): Promise<{
+        instances: AdminInstanceRecord[];
+    }>;
+    /**
+     * Retrieves single instance details including QR code, pairing code, status, and expiry.
+     */
+    getInstance(instanceId: string): Promise<{
+        instance: AdminInstanceRecord;
+    }>;
+    /**
+     * Creates and immediately provisions a new WhatsApp or Telegram instance.
+     * Admins are zero-payment, so instances are provisioned as active paid instances.
+     */
+    createInstance(options: CreateAdminInstanceOptions): Promise<{
+        message: string;
+        instance: AdminInstanceRecord;
+    }>;
+    /**
+     * Programmatically renews an instance's subscription without payment transactions.
+     */
+    renewInstance(instanceId: string, options?: {
+        months?: number;
+        plan_months?: number;
+    }): Promise<{
+        success: boolean;
+        message: string;
+        instance: AdminInstanceRecord;
+    }>;
+    /**
+     * Updates instance configuration (name, webhook URL, allowed recipient numbers).
+     */
+    updateInstance(instanceId: string, updates: {
+        name?: string;
+        webhook_url?: string;
+        allowed_numbers?: string[];
+    }): Promise<{
+        message: string;
+        instance: AdminInstanceRecord;
+    }>;
+    /**
+     * Regenerates secret instance token for an instance.
+     */
+    regenerateInstanceToken(instanceId: string): Promise<{
+        message: string;
+        instance_token: string;
+    }>;
+    /**
+     * Deletes and cleans up an instance.
+     */
+    deleteInstance(instanceId: string): Promise<{
+        message: string;
+        instanceId: string;
+    }>;
+}
+//# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

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

package/dist/admin.js

@@ -0,0 +1,114 @@
+import { BotcastError } from './errors.js';
+export class BotcastAdminClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    headers;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('BotcastAdminClient requires a valid "apiKey" (e.g. bcast_live_...)');
+        }
+        this.baseUrl = (config.baseUrl || 'https://botcast.site').replace(/\/+$/, '');
+        this.apiKey = config.apiKey.trim();
+        this.timeout = config.timeout || 30000;
+        this.headers = config.headers || {};
+    }
+    async request(endpoint, options = {}) {
+        const url = `${this.baseUrl}${endpoint.startsWith('/') ? '' : '/'}${endpoint}`;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeout);
+        const mergedHeaders = {
+            'Content-Type': 'application/json',
+            'x-api-key': this.apiKey,
+            ...this.headers,
+            ...(options.headers || {}),
+        };
+        try {
+            const res = await fetch(url, {
+                ...options,
+                headers: mergedHeaders,
+                signal: controller.signal,
+            });
+            const body = await res.json().catch(() => ({}));
+            if (!res.ok) {
+                throw new BotcastError(body.message || body.error || `HTTP ${res.status}: ${res.statusText}`, res.status, body);
+            }
+            return body;
+        }
+        catch (err) {
+            if (err.name === 'AbortError') {
+                throw new BotcastError(`Request timed out after ${this.timeout}ms`, 408);
+            }
+            throw err;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    /**
+     * Lists all instances under this admin/partner account with live statuses and stats.
+     */
+    async listInstances() {
+        return this.request('/api/instances', { method: 'GET' });
+    }
+    /**
+     * Retrieves single instance details including QR code, pairing code, status, and expiry.
+     */
+    async getInstance(instanceId) {
+        return this.request(`/api/instances/${instanceId}`, { method: 'GET' });
+    }
+    /**
+     * Creates and immediately provisions a new WhatsApp or Telegram instance.
+     * Admins are zero-payment, so instances are provisioned as active paid instances.
+     */
+    async createInstance(options) {
+        return this.request('/api/instances', {
+            method: 'POST',
+            body: JSON.stringify({
+                name: options.name,
+                platform: options.platform || 'whatsapp',
+                type: options.type || 'paid',
+                plan_months: options.plan_months || 12,
+                allowed_numbers: options.allowed_numbers || [],
+                webhook_url: options.webhook_url || '',
+                target_user_id: options.target_user_id,
+            }),
+        });
+    }
+    /**
+     * Programmatically renews an instance's subscription without payment transactions.
+     */
+    async renewInstance(instanceId, options) {
+        return this.request(`/api/instances/${instanceId}/renew`, {
+            method: 'POST',
+            body: JSON.stringify({
+                months: options?.months || options?.plan_months || 12,
+            }),
+        });
+    }
+    /**
+     * Updates instance configuration (name, webhook URL, allowed recipient numbers).
+     */
+    async updateInstance(instanceId, updates) {
+        return this.request(`/api/instances/${instanceId}`, {
+            method: 'PUT',
+            body: JSON.stringify(updates),
+        });
+    }
+    /**
+     * Regenerates secret instance token for an instance.
+     */
+    async regenerateInstanceToken(instanceId) {
+        return this.request(`/api/instances/${instanceId}/regenerate-token`, {
+            method: 'POST',
+        });
+    }
+    /**
+     * Deletes and cleans up an instance.
+     */
+    async deleteInstance(instanceId) {
+        return this.request(`/api/instances/${instanceId}`, {
+            method: 'DELETE',
+        });
+    }
+}

package/dist/client.cjs

@@ -52,6 +52,7 @@ class BotcastClient {
         }
         this.config = {
             baseUrl: config.baseUrl || 'https://botcast.site',
+            platform: config.platform || 'whatsapp',
             instanceId: config.instanceId,
             instanceToken: config.instanceToken,
             timeout: config.timeout || 30000,

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;IA8BvC;;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;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"}

package/dist/client.js

@@ -49,6 +49,7 @@ export class BotcastClient {
         }
         this.config = {
             baseUrl: config.baseUrl || 'https://botcast.site',
+            platform: config.platform || 'whatsapp',
             instanceId: config.instanceId,
             instanceToken: config.instanceToken,
             timeout: config.timeout || 30000,

package/dist/index.cjs

@@ -14,9 +14,11 @@ 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.BotcastClient = void 0;
+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; } });
 __exportStar(require("./errors.js"), exports);

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { BotcastClient } from './client.js';
+export { BotcastAdminClient, BotcastAdminConfig, CreateAdminInstanceOptions, AdminInstanceRecord } from './admin.js';
 export { BotcastWebhook } from './webhooks/index.js';
 export * from './errors.js';
 export * from './types/index.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,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,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AAGjC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,eAAe,aAAa,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { BotcastClient } from './client.js';
+export { BotcastAdminClient } from './admin.js';
 export { BotcastWebhook } from './webhooks/index.js';
 export * from './errors.js';
 export * from './types/index.js';

package/dist/modules/base.cjs

@@ -8,11 +8,12 @@ class BaseModule {
         this.config = config;
     }
     /**
-     * Builds the instance-specific URL path prefix: `/whatsapp/:instanceId/:instanceToken/...`
+     * Builds the instance-specific URL path prefix: `/:platform/:instanceId/:instanceToken/...`
      */
     buildPath(subPath) {
+        const platform = this.config.platform || 'whatsapp';
         const cleanSubPath = subPath.startsWith('/') ? subPath.slice(1) : subPath;
-        return `/whatsapp/${encodeURIComponent(this.config.instanceId)}/${encodeURIComponent(this.config.instanceToken)}/${cleanSubPath}`;
+        return `/${platform}/${encodeURIComponent(this.config.instanceId)}/${encodeURIComponent(this.config.instanceToken)}/${cleanSubPath}`;
     }
     /**
      * Executes an HTTP request against the Botcast API Gateway with retry & error translation.

package/dist/modules/base.d.ts

@@ -10,7 +10,7 @@ export declare class BaseModule {
     protected config: Required<BotcastClientConfig>;
     constructor(config: Required<BotcastClientConfig>);
     /**
-     * Builds the instance-specific URL path prefix: `/whatsapp/:instanceId/:instanceToken/...`
+     * Builds the instance-specific URL path prefix: `/:platform/:instanceId/:instanceToken/...`
      */
     protected buildPath(subPath: string): string;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IACrE,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,UAAU;IACrB,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;gBAEpC,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC;IAIjD;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAK5C;;OAEG;IACU,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAyFlE,OAAO,CAAC,eAAe;CAuBxB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/modules/base.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IACrE,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,UAAU;IACrB,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC,CAAC;gBAEpC,MAAM,EAAE,QAAQ,CAAC,mBAAmB,CAAC;IAIjD;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAM5C;;OAEG;IACU,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAyFlE,OAAO,CAAC,eAAe;CAuBxB"}

package/dist/modules/base.js

@@ -5,11 +5,12 @@ export class BaseModule {
         this.config = config;
     }
     /**
-     * Builds the instance-specific URL path prefix: `/whatsapp/:instanceId/:instanceToken/...`
+     * Builds the instance-specific URL path prefix: `/:platform/:instanceId/:instanceToken/...`
      */
     buildPath(subPath) {
+        const platform = this.config.platform || 'whatsapp';
         const cleanSubPath = subPath.startsWith('/') ? subPath.slice(1) : subPath;
-        return `/whatsapp/${encodeURIComponent(this.config.instanceId)}/${encodeURIComponent(this.config.instanceToken)}/${cleanSubPath}`;
+        return `/${platform}/${encodeURIComponent(this.config.instanceId)}/${encodeURIComponent(this.config.instanceToken)}/${cleanSubPath}`;
     }
     /**
      * Executes an HTTP request against the Botcast API Gateway with retry & error translation.

package/dist/modules/instances.cjs

@@ -22,9 +22,9 @@ class InstancesModule extends base_js_1.BaseModule {
         });
     }
     /**
-     * Generates an 8-digit phone pairing code for headless WhatsApp linking without scanning QR.
+     * Generates a pairing / login code for phone number authentication.
      *
-     * @param phoneNumber Recipient phone number with country code (e.g. `201000000000` or `15551234567`)
+     * @param phoneNumber Phone number with country code (e.g. `201000000000` or `15551234567`)
      */
     async pairWithCode(phoneNumber) {
         return this.request({
@@ -33,6 +33,16 @@ class InstancesModule extends base_js_1.BaseModule {
             body: { phoneNumber },
         });
     }
+    /**
+     * Completes phone code verification (e.g. for Telegram login with optional 2FA password).
+     */
+    async verifyCode(phoneNumber, code, password) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('verify-code'),
+            body: { phoneNumber, code, password },
+        });
+    }
     /**
      * Boots up the WhatsApp socket connection.
      *

package/dist/modules/instances.d.ts

@@ -10,11 +10,20 @@ export declare class InstancesModule extends BaseModule {
      */
     getQR(): Promise<InstanceQRResponse>;
     /**
-     * Generates an 8-digit phone pairing code for headless WhatsApp linking without scanning QR.
+     * Generates a pairing / login code for phone number authentication.
      *
-     * @param phoneNumber Recipient phone number with country code (e.g. `201000000000` or `15551234567`)
+     * @param phoneNumber Phone number with country code (e.g. `201000000000` or `15551234567`)
      */
     pairWithCode(phoneNumber: string): Promise<PairCodeResponse>;
+    /**
+     * Completes phone code verification (e.g. for Telegram login with optional 2FA password).
+     */
+    verifyCode(phoneNumber: string, code: string, password?: string): Promise<{
+        success: boolean;
+        status: string;
+        user?: any;
+        message?: string;
+    }>;
     /**
      * Boots up the WhatsApp socket connection.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../src/modules/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,eAAgB,SAAQ,UAAU;IAC7C;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAOzD;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAOjD;;;;OAIG;IACU,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQzE;;;;OAIG;IACU,KAAK,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ9H;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAOvG;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzG;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAOjE;;;;OAIG;IACU,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAQ5F;;;;OAIG;IACU,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQ3E;;OAEG;IACU,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQlG;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAOzD;;;;OAIG;IACU,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAcjI;;;;OAIG;IACU,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3H;;;;OAIG;IACU,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/H;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAM5F"}
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../src/modules/instances.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,gBAAgB,EAChB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,eAAgB,SAAQ,UAAU;IAC7C;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAOzD;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAOjD;;;;OAIG;IACU,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAQzE;;OAEG;IACU,UAAU,CACrB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,GAAG,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ9E;;;;OAIG;IACU,KAAK,CAAC,KAAK,GAAE,OAAe,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ9H;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAOvG;;OAEG;IACU,MAAM,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAOzG;;OAEG;IACU,iBAAiB,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAOjE;;;;OAIG;IACU,iBAAiB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAQ5F;;;;OAIG;IACU,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAQ3E;;OAEG;IACU,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAQlG;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAOzD;;;;OAIG;IACU,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAcjI;;;;OAIG;IACU,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI3H;;;;OAIG;IACU,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAI/H;;OAEG;IACU,IAAI,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAM5F"}

package/dist/modules/instances.js

@@ -19,9 +19,9 @@ export class InstancesModule extends BaseModule {
         });
     }
     /**
-     * Generates an 8-digit phone pairing code for headless WhatsApp linking without scanning QR.
+     * Generates a pairing / login code for phone number authentication.
      *
-     * @param phoneNumber Recipient phone number with country code (e.g. `201000000000` or `15551234567`)
+     * @param phoneNumber Phone number with country code (e.g. `201000000000` or `15551234567`)
      */
     async pairWithCode(phoneNumber) {
         return this.request({
@@ -30,6 +30,16 @@ export class InstancesModule extends BaseModule {
             body: { phoneNumber },
         });
     }
+    /**
+     * Completes phone code verification (e.g. for Telegram login with optional 2FA password).
+     */
+    async verifyCode(phoneNumber, code, password) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('verify-code'),
+            body: { phoneNumber, code, password },
+        });
+    }
     /**
      * Boots up the WhatsApp socket connection.
      *

package/dist/modules/messages.cjs

@@ -35,6 +35,13 @@ class MessagesModule extends base_js_1.BaseModule {
      * @param options OTP configuration (code, app name, expiry minutes)
      */
     async sendOTP(recipient, options) {
+        if (this.config.platform === 'telegram') {
+            return this.send({
+                recipient,
+                type: 'otp',
+                ...options,
+            });
+        }
         return this.request({
             method: 'POST',
             path: this.buildPath('otp'),
@@ -126,6 +133,14 @@ class MessagesModule extends base_js_1.BaseModule {
      * Sends a contact vCard card.
      */
     async sendContact(recipient, contact, options) {
+        if (this.config.platform === 'telegram') {
+            return this.send({
+                recipient,
+                type: 'contact',
+                ...contact,
+                ...options,
+            });
+        }
         return this.request({
             method: 'POST',
             path: this.buildPath('messages/contact'),

package/dist/modules/messages.d.ts

@@ -83,7 +83,9 @@ export declare class MessagesModule extends BaseModule {
      * Sends a contact vCard card.
      */
     sendContact(recipient: string, contact: {
-        displayName: string;
+        displayName?: string;
+        firstName?: string;
+        phone?: string;
         vcard?: string;
         contacts?: Array<{
             displayName: string;

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

@@ -32,6 +32,13 @@ export class MessagesModule extends BaseModule {
      * @param options OTP configuration (code, app name, expiry minutes)
      */
     async sendOTP(recipient, options) {
+        if (this.config.platform === 'telegram') {
+            return this.send({
+                recipient,
+                type: 'otp',
+                ...options,
+            });
+        }
         return this.request({
             method: 'POST',
             path: this.buildPath('otp'),
@@ -123,6 +130,14 @@ export class MessagesModule extends BaseModule {
      * Sends a contact vCard card.
      */
     async sendContact(recipient, contact, options) {
+        if (this.config.platform === 'telegram') {
+            return this.send({
+                recipient,
+                type: 'contact',
+                ...contact,
+                ...options,
+            });
+        }
         return this.request({
             method: 'POST',
             path: this.buildPath('messages/contact'),

package/dist/types/index.d.ts

@@ -10,6 +10,10 @@ export interface BotcastClientConfig {
      * Default: `https://botcast.site`
      */
     baseUrl?: string;
+    /**
+     * Platform type: 'whatsapp' or 'telegram'. Default: 'whatsapp'.
+     */
+    platform?: 'whatsapp' | 'telegram';
     /**
      * Your unique Botcast Instance ID.
      */

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;IAEnC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "botcast-sdk",
-  "version": "1.0.3",
-  "description": "Official TypeScript/JavaScript SDK for Botcast WhatsApp Multi-Instance API Gateway",
+  "version": "1.0.6",
+  "description": "Official TypeScript/JavaScript SDK for Botcast WhatsApp & Telegram MTProto Multi-Instance API Gateway",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -33,9 +33,14 @@
     "whatsapp",
     "whatsapp-api",
     "whatsapp-gateway",
+    "telegram",
+    "telegram-api",
+    "mtproto",
+    "teleproto",
     "baileys",
     "multi-instance",
     "whatsapp-bot",
+    "telegram-bot",
     "otp",
     "messaging",
     "sms-alternative",