botcast-sdk 1.0.4 → 1.0.7

package/README.md

@@ -16,7 +16,7 @@ Official Node.js and TypeScript SDK for [Botcast](https://botcast.site) — a hi
 - **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.
+  - **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.
@@ -41,33 +41,67 @@ bun add botcast-sdk
 
 ## Quick Start
 
-### 1. WhatsApp Client
+### 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 { BotcastClient } from 'botcast-sdk';
+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 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',
+  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() {
   // Check connectivity
   const status = await whatsappBot.getStatus();
-  console.log(`WhatsApp state: ${status.status} (${status.phoneNumber || 'Unpaired'})`);
+  console.log(
+    `WhatsApp state: ${status.status} (${status.phoneNumber || "Unpaired"})`,
+  );
 
   // Send a text message
-  const res = await whatsappBot.messages.sendText('201012345678', 'Hello from WhatsApp via Botcast SDK!');
-  console.log('Message sent! ID:', res.messageId);
+  const res = await whatsappBot.messages.sendText(
+    "201012345678",
+    "Hello from WhatsApp via Botcast SDK!",
+  );
+  console.log("Message sent! ID:", res.messageId);
 
   // Send a secure 6-digit OTP code
-  const otp = await whatsappBot.messages.sendOTP('201012345678', {
-    appName: 'My App',
+  const otp = await whatsappBot.messages.sendOTP("201012345678", {
+    appName: "My App",
     expiryMinutes: 5,
   });
-  console.log('Dispatched OTP:', otp.codeSent);
+  console.log("Dispatched OTP:", otp.codeSent);
 }
 
 main().catch(console.error);
@@ -78,13 +112,13 @@ main().catch(console.error);
 ### 2. Telegram MTProto Client
 
 ```typescript
-import { BotcastClient } from 'botcast-sdk';
+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',
+  baseUrl: "https://botcast.site",
+  platform: "telegram",
+  instanceId: "your_telegram_instance_id",
+  instanceToken: "your_telegram_instance_token",
 });
 
 async function main() {
@@ -93,20 +127,23 @@ async function main() {
   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);
+  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',
+  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',
+  const otp = await telegramBot.messages.sendOTP("+1234567890", {
+    appName: "Security Portal",
   });
-  console.log('Telegram OTP sent:', otp.codeSent);
+  console.log("Telegram OTP sent:", otp.codeSent);
 }
 
 main().catch(console.error);
@@ -117,12 +154,12 @@ main().catch(console.error);
 ### CommonJS (require)
 
 ```javascript
-const { BotcastClient } = require('botcast-sdk');
+const { BotcastClient } = require("botcast-sdk");
 
 const client = new BotcastClient({
-  platform: 'telegram', // or 'whatsapp'
-  instanceId: 'your_instance_id',
-  instanceToken: 'your_instance_token',
+  platform: "telegram", // or 'whatsapp'
+  instanceId: "your_instance_id",
+  instanceToken: "your_instance_token",
 });
 ```
 
@@ -135,24 +172,24 @@ const client = new BotcastClient({
 ```typescript
 // 1. Get live status
 const status = await client.instances.getStatus();
-console.log('State:', status.status); // 'connected' | 'qr_ready' | 'stopped' | 'connecting'
+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('QR DataURL:', qr.qr);
+console.log("QR DataURL:", qr.qr);
 
 // 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);
+const pair = await client.pairWithCode("+1234567890");
+console.log("Code request status:", pair);
 
 // 4. Complete Telegram Phone Login (with optional 2FA cloud password)
-await client.instances.verifyCode('+1234567890', '12345', 'myCloudPassword2fa');
+await client.instances.verifyCode("+1234567890", "12345", "myCloudPassword2fa");
 
 // 5. Socket engine controls
-await client.instances.start();  // Boots socket / MTProto connection
-await client.instances.stop();   // Suspends socket session
+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
 ```
 
@@ -164,51 +201,51 @@ All messaging methods work across both **WhatsApp** and **Telegram**:
 
 ```typescript
 // 1. Text message
-await client.messages.sendText('+1234567890', 'Hello World', {
-  mentions: ['1234567890'], // WhatsApp mentions
+await client.messages.sendText("+1234567890", "Hello World", {
+  mentions: ["1234567890"], // WhatsApp mentions
 });
 
 // 2. Image / Photo
-await client.messages.sendImage('+1234567890', {
-  url: 'https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?w=800',
-  caption: 'Photo preview',
+await client.messages.sendImage("+1234567890", {
+  url: "https://images.unsplash.com/photo-1618005182384-a83a8bd57fbe?w=800",
+  caption: "Photo preview",
 });
 
 // 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',
+await client.messages.sendVideo("+1234567890", {
+  url: "https://sample-videos.com/video321/mp4/720/big_buck_bunny_720p_1mb.mp4",
+  caption: "Product tutorial video",
 });
 
 // 4. Voice note and audio
-await client.messages.sendVoice('+1234567890', {
-  url: 'https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3',
+await client.messages.sendVoice("+1234567890", {
+  url: "https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3",
 });
 
 // 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',
-  caption: 'Monthly invoice statement',
+await client.messages.sendDocument("+1234567890", {
+  url: "https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf",
+  fileName: "Invoice_2026.pdf",
+  caption: "Monthly invoice statement",
 });
 
 // 6. Location coordinates
-await client.messages.sendLocation('+1234567890', {
+await client.messages.sendLocation("+1234567890", {
   latitude: 24.7136,
   longitude: 46.6753,
-  name: 'Kingdom Tower',
-  address: 'King Fahd Rd, Riyadh, Saudi Arabia',
+  name: "Kingdom Tower",
+  address: "King Fahd Rd, Riyadh, Saudi Arabia",
 });
 
 // 7. Contact Card
-await client.messages.sendContact('+1234567890', {
-  firstName: 'Support Agent',
-  phone: '+1234567890',
+await client.messages.sendContact("+1234567890", {
+  firstName: "Support Agent",
+  phone: "+1234567890",
 });
 
 // 8. Automated OTP verification code
-const otp = await client.messages.sendOTP('+1234567890', {
-  appName: 'Botcast Portal',
+const otp = await client.messages.sendOTP("+1234567890", {
+  appName: "Botcast Portal",
   expiryMinutes: 5,
 });
 ```
@@ -219,28 +256,30 @@ const otp = await client.messages.sendOTP('+1234567890', {
 
 ```typescript
 const msgKey = {
-  remoteJid: '201012345678@s.whatsapp.net',
+  remoteJid: "201012345678@s.whatsapp.net",
   fromMe: true,
-  id: '3EB0ABCDEF1234567890',
+  id: "3EB0ABCDEF1234567890",
 };
 
 // 1. Edit sent message
-await client.messages.edit('201012345678', msgKey, 'Corrected text content');
+await client.messages.edit("201012345678", msgKey, "Corrected text content");
 
 // 2. Delete message for everyone (revoke)
-await client.messages.delete('201012345678', msgKey);
+await client.messages.delete("201012345678", msgKey);
 
 // 3. Mark message as read
 await client.messages.markAsRead(msgKey);
 
 // 4. Emoji reaction
-await client.messages.react('201012345678', msgKey, '👍');
+await client.messages.react("201012345678", msgKey, "👍");
 
 // 5. Pin message
-await client.messages.pin('201012345678', msgKey, 1, 86400);
+await client.messages.pin("201012345678", msgKey, 1, 86400);
 
 // 6. Forward message
-await client.messages.forward('201012345678', { conversation: 'Forwarded message text' });
+await client.messages.forward("201012345678", {
+  conversation: "Forwarded message text",
+});
 ```
 
 ---
@@ -255,12 +294,15 @@ const { chats } = await client.chats.list({ limit: 50 });
 const { contacts } = await client.chats.listContacts({ limit: 100 });
 
 // 3. List messages for a chat
-const { messages } = await client.chats.listMessages({ chatJid: '201012345678@s.whatsapp.net', limit: 50 });
+const { messages } = await client.chats.listMessages({
+  chatJid: "201012345678@s.whatsapp.net",
+  limit: 50,
+});
 
 // 4. Modify WhatsApp chat state (archive, mute, pin, delete)
-await client.chats.archive('201012345678@s.whatsapp.net');
-await client.chats.mute('201012345678@s.whatsapp.net', 8 * 60 * 60 * 1000); // 8 hours
-await client.chats.pin('201012345678@s.whatsapp.net');
+await client.chats.archive("201012345678@s.whatsapp.net");
+await client.chats.mute("201012345678@s.whatsapp.net", 8 * 60 * 60 * 1000); // 8 hours
+await client.chats.pin("201012345678@s.whatsapp.net");
 ```
 
 ---
@@ -272,24 +314,26 @@ The SDK includes a built-in event dispatcher and middleware for handling inbound
 #### Express Example
 
 ```typescript
-import express from 'express';
-import { BotcastClient } from 'botcast-sdk';
+import express from "express";
+import { BotcastClient } from "botcast-sdk";
 
 const app = express();
 app.use(express.json());
 
 const client = new BotcastClient({
-  platform: 'telegram', // or 'whatsapp'
-  instanceId: 'inst_123',
-  instanceToken: 'tok_abc',
+  platform: "telegram", // or 'whatsapp'
+  instanceId: "inst_123",
+  instanceToken: "tok_abc",
 });
 
 // Listen for incoming messages
 client.webhook.onMessage(async (event) => {
-  console.log(`Message from ${event.sender}: ${event.message} [Platform: ${event.platform || 'whatsapp'}]`);
+  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');
+  if (event.message.trim().toLowerCase() === "ping") {
+    await client.messages.sendText(event.sender, "pong");
   }
 });
 
@@ -299,9 +343,9 @@ client.webhook.onConnection(async (event) => {
 });
 
 // Mount middleware on your webhook route
-app.post('/webhook/botcast', client.webhook.middleware());
+app.post("/webhook/botcast", client.webhook.middleware());
 
-app.listen(3000, () => console.log('Webhook server running on port 3000'));
+app.listen(3000, () => console.log("Webhook server running on port 3000"));
 ```
 
 ---
@@ -319,25 +363,25 @@ import {
   BotcastRateLimitError,
   BotcastValidationError,
   BotcastNotFoundError,
-} from 'botcast-sdk';
+} from "botcast-sdk";
 
 try {
-  await client.messages.sendText('+1234567890', 'Hello World');
+  await client.messages.sendText("+1234567890", "Hello World");
 } catch (error) {
   if (error instanceof BotcastAuthError) {
-    console.error('Invalid instance credentials or token.');
+    console.error("Invalid instance credentials or token.");
   } else if (error instanceof BotcastPaymentRequiredError) {
-    console.error('Instance requires payment confirmation.');
+    console.error("Instance requires payment confirmation.");
   } else if (error instanceof BotcastSubscriptionExpiredError) {
-    console.error('Subscription expired on:', error.expiresAt);
+    console.error("Subscription expired on:", error.expiresAt);
   } else if (error instanceof BotcastRateLimitError) {
-    console.error('Daily message limit reached.');
+    console.error("Daily message limit reached.");
   } else if (error instanceof BotcastValidationError) {
-    console.error('Validation error:', error.message, error.details);
+    console.error("Validation error:", error.message, error.details);
   } else if (error instanceof BotcastNotFoundError) {
-    console.error('Resource not found:', error.message);
+    console.error("Resource not found:", error.message);
   } else {
-    console.error('Unexpected error:', error);
+    console.error("Unexpected error:", error);
   }
 }
 ```
@@ -349,7 +393,7 @@ try {
 - Website: [https://botcast.site](https://botcast.site)
 - Documentation: [https://botcast.site/docs](https://botcast.site/docs)
 - 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)
+- GitHub Repository: [https://github.com/alsasoft-web/Botcast](https://github.com/alsasoft-web/Botcast)
 
 ---
 

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botcast-sdk",
-  "version": "1.0.4",
+  "version": "1.0.7",
   "description": "Official TypeScript/JavaScript SDK for Botcast WhatsApp & Telegram MTProto Multi-Instance API Gateway",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -51,7 +51,7 @@
   "homepage": "https://botcast.site",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ANOOBALSA/botcast-sdk.git",
+    "url": "git+https://github.com/alsasoft-web/botcast-sdk.git",
     "directory": "packages/botcast-sdk"
   },
   "bugs": {