botcast-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Botcast (https://botcast.site)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,257 @@
+# botcast-sdk
+
+Node.js and TypeScript client for [Botcast](https://botcast.site), a multi-instance WhatsApp API gateway.
+
+Connect WhatsApp numbers, send messages (text, OTP, media, documents, polls), manage group chats, and process incoming webhooks.
+
+[![npm version](https://img.shields.io/npm/v/botcast-sdk.svg?color=blue)](https://www.npmjs.com/package/botcast-sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
+
+---
+
+## Installation
+
+```bash
+npm install botcast-sdk
+# or
+yarn add botcast-sdk
+# or
+pnpm add botcast-sdk
+```
+
+---
+
+## Quick start
+
+```typescript
+import { BotcastClient } from 'botcast-sdk';
+
+const botcast = new BotcastClient({
+  baseUrl: 'https://botcast.site', // or your self-hosted server URL
+  instanceId: 'your_instance_id',
+  instanceToken: 'your_instance_token',
+});
+
+async function main() {
+  // 1. Check WhatsApp connection status
+  const status = await botcast.instances.getStatus();
+  console.log('Status:', status.status, 'Phone:', status.phoneNumber);
+
+  // 2. Send a text message
+  const result = await botcast.messages.sendText('201000000000', 'Hello from Botcast SDK');
+  console.log('Sent message ID:', result.messageId);
+
+  // 3. Send an OTP verification code
+  const otp = await botcast.messages.sendOTP('201000000000', {
+    code: '849201',
+    appName: 'My SaaS App',
+    expiryMinutes: 5,
+  });
+  console.log('OTP dispatched:', otp.codeSent);
+}
+
+main().catch(console.error);
+```
+
+---
+
+## CommonJS usage
+
+```javascript
+const { BotcastClient } = require('botcast-sdk');
+
+const botcast = new BotcastClient({
+  instanceId: 'your_instance_id',
+  instanceToken: 'your_instance_token',
+});
+```
+
+---
+
+## API reference
+
+### 1. Instance management
+
+```typescript
+// Get status and phone profile details
+const status = await botcast.instances.getStatus();
+
+// Get QR code string for scanning
+const qr = await botcast.instances.getQR();
+
+// Generate an 8-digit phone pairing code (no camera scan needed)
+const pair = await botcast.instances.pairWithCode('201000000000');
+console.log('Enter this code in WhatsApp:', pair.formattedCode); // e.g. 1234-5678
+
+// Start, stop, or log out
+await botcast.instances.start();
+await botcast.instances.stop();
+await botcast.instances.logout();
+
+// Check whether a phone number is on WhatsApp
+const check = await botcast.instances.checkNumber('201000000000');
+console.log('Exists:', check.exists, 'JID:', check.jid);
+
+// Set presence (typing, recording audio, online/offline)
+await botcast.instances.setPresence({
+  presence: 'composing', // 'available' | 'unavailable' | 'composing' | 'recording' | 'paused'
+  recipient: '201000000000',
+});
+```
+
+---
+
+### 2. Messaging
+
+```typescript
+// 1. Text message with mentions
+await botcast.messages.sendText('201000000000', 'Hello @user', {
+  mentions: ['201000000000'],
+});
+
+// 2. Image with caption
+await botcast.messages.sendImage('201000000000', {
+  url: 'https://example.com/invoice.png',
+  caption: 'Here is your monthly invoice.',
+});
+
+// 3. Document / PDF
+await botcast.messages.sendDocument('201000000000', {
+  url: 'https://example.com/statement.pdf',
+  fileName: 'Statement_August.pdf',
+  mimetype: 'application/pdf',
+});
+
+// 4. Voice note (PTT waveform)
+await botcast.messages.sendVoice('201000000000', {
+  url: 'https://example.com/audio-note.mp3',
+});
+
+// 5. Interactive poll
+await botcast.messages.sendPoll('201000000000', {
+  name: 'How was our service?',
+  values: ['Great', 'Average', 'Needs work'],
+  selectableCount: 1,
+});
+
+// 6. Contact card (vCard)
+await botcast.messages.sendContact('201000000000', {
+  displayName: 'Customer Support',
+  vcard: 'BEGIN:VCARD\nVERSION:3.0\nFN:Customer Support\nTEL;TYPE=CELL:+201000000000\nEND:VCARD',
+});
+
+// 7. Message actions: react, pin, edit, delete for everyone
+await botcast.messages.react('201000000000', msgKey, '👍');
+await botcast.messages.pin('201000000000', msgKey, 1, 86400); // pin for 24 hours
+await botcast.messages.edit('201000000000', msgKey, 'Updated text message');
+await botcast.messages.delete('201000000000', msgKey); // Revoke for everyone
+```
+
+---
+
+### 3. Group administration
+
+```typescript
+// Create a group
+const newGroup = await botcast.groups.create('VIP Customers', ['201000000000', '201111111111']);
+
+// List joined groups
+const groups = await botcast.groups.list();
+
+// Add or remove participants
+await botcast.groups.addParticipants('group-jid@g.us', ['201222222222']);
+await botcast.groups.removeParticipants('group-jid@g.us', ['201222222222']);
+
+// Promote or demote admins
+await botcast.groups.promoteParticipants('group-jid@g.us', ['201000000000']);
+
+// Update permissions and settings
+await botcast.groups.updateSettings('group-jid@g.us', 'announcement'); // Only admins can send messages
+await botcast.groups.updateSubject('group-jid@g.us', 'New Group Name');
+await botcast.groups.updateDescription('group-jid@g.us', 'Official VIP group discussion.');
+
+// Get invite link
+const invite = await botcast.groups.getInviteCode('group-jid@g.us');
+console.log('Invite link:', invite.link);
+```
+
+---
+
+### 4. Webhook handling
+
+The package includes a helper for parsing incoming events in Express, Fastify, Next.js, or plain Node HTTP:
+
+#### Express example:
+```typescript
+import express from 'express';
+import { BotcastClient } from 'botcast-sdk';
+
+const app = express();
+app.use(express.json());
+
+const botcast = new BotcastClient({
+  instanceId: 'inst_123',
+  instanceToken: 'tok_abc',
+});
+
+// Listen for incoming messages
+botcast.webhook.onMessage(async (event) => {
+  console.log(`Incoming message from +${event.sender}: ${event.message}`);
+
+  if (event.message.toLowerCase() === 'ping') {
+    await botcast.messages.sendText(event.sender, 'pong');
+  }
+});
+
+// Mount the webhook handler
+app.post('/webhook', botcast.webhook.middleware());
+
+app.listen(3000, () => console.log('Webhook server listening on port 3000'));
+```
+
+---
+
+### 5. Error handling
+
+The SDK maps API status codes to typed error classes:
+
+```typescript
+import {
+  BotcastClient,
+  BotcastAuthError,
+  BotcastPaymentRequiredError,
+  BotcastSubscriptionExpiredError,
+  BotcastRateLimitError,
+} from 'botcast-sdk';
+
+try {
+  await botcast.messages.sendText('201000000000', 'Test');
+} catch (error) {
+  if (error instanceof BotcastAuthError) {
+    console.error('Invalid instance token or instance ID');
+  } else if (error instanceof BotcastPaymentRequiredError) {
+    console.error('Instance requires payment confirmation before sending messages');
+  } else if (error instanceof BotcastSubscriptionExpiredError) {
+    console.error('Instance subscription expired on:', error.expiresAt);
+  } else if (error instanceof BotcastRateLimitError) {
+    console.error('Rate limit reached. Reduce request frequency.');
+  } else {
+    console.error('Request error:', error.message);
+  }
+}
+```
+
+---
+
+## Links
+
+- Website: [https://botcast.site](https://botcast.site)
+- Dashboard: [https://botcast.site/?lang=en](https://botcast.site/?lang=en)
+- Service health: [https://botcast.site/health](https://botcast.site/health)
+
+---
+
+## License
+
+MIT (c) [Botcast](https://botcast.site)

package/dist/client.cjs

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotcastClient = void 0;
+const instances_js_1 = require("./modules/instances.js");
+const messages_js_1 = require("./modules/messages.js");
+const chats_js_1 = require("./modules/chats.js");
+const groups_js_1 = require("./modules/groups.js");
+const profile_js_1 = require("./modules/profile.js");
+const broadcast_js_1 = require("./modules/broadcast.js");
+const index_js_1 = require("./webhooks/index.js");
+class BotcastClient {
+    config;
+    /** Instance Lifecycle & Connection Management */
+    instances;
+    /** WhatsApp Message Dispatcher (Text, OTP, Media, Polls, Reactions, etc.) */
+    messages;
+    /** Chats, Contacts, History, and Chat State Management */
+    chats;
+    /** WhatsApp Group Operations & Administration */
+    groups;
+    /** Profile, Avatar, About Status, and Privacy Settings */
+    profile;
+    /** WhatsApp Status Stories & Broadcast Lists */
+    broadcast;
+    /** Webhook Handler & Middleware */
+    webhook;
+    /**
+     * Initializes a new Botcast API Client.
+     *
+     * @param config Client configuration options
+     *
+     * @example
+     * ```ts
+     * import { BotcastClient } from 'botcast-sdk';
+     *
+     * const botcast = new BotcastClient({
+     *   baseUrl: 'https://botcast.site',
+     *   instanceId: 'inst_abc123',
+     *   instanceToken: 'token_xyz789'
+     * });
+     *
+     * // Send a text message
+     * await botcast.messages.sendText('201000000000', 'Hello from Botcast SDK!');
+     * ```
+     */
+    constructor(config) {
+        if (!config.instanceId) {
+            throw new Error('BotcastClient requires a valid "instanceId"');
+        }
+        if (!config.instanceToken) {
+            throw new Error('BotcastClient requires a valid "instanceToken"');
+        }
+        this.config = {
+            baseUrl: config.baseUrl || 'https://botcast.site',
+            instanceId: config.instanceId,
+            instanceToken: config.instanceToken,
+            timeout: config.timeout || 30000,
+            maxRetries: config.maxRetries ?? 2,
+            headers: config.headers || {},
+        };
+        this.instances = new instances_js_1.InstancesModule(this.config);
+        this.messages = new messages_js_1.MessagesModule(this.config);
+        this.chats = new chats_js_1.ChatsModule(this.config);
+        this.groups = new groups_js_1.GroupsModule(this.config);
+        this.profile = new profile_js_1.ProfileModule(this.config);
+        this.broadcast = new broadcast_js_1.BroadcastModule(this.config);
+        this.webhook = new index_js_1.BotcastWebhook();
+    }
+    // =========================================================================
+    // Top-Level Convenience Shortcuts
+    // =========================================================================
+    /**
+     * Shortcut to send a text message.
+     */
+    async sendText(recipient, text) {
+        return this.messages.sendText(recipient, text);
+    }
+    /**
+     * Shortcut to send an automated OTP verification code.
+     */
+    async sendOTP(recipient, options) {
+        return this.messages.sendOTP(recipient, options);
+    }
+    /**
+     * Shortcut to check instance connectivity status.
+     */
+    async getStatus() {
+        return this.instances.getStatus();
+    }
+}
+exports.BotcastClient = BotcastClient;

package/dist/client.d.ts

@@ -0,0 +1,64 @@
+import { BotcastClientConfig } from './types/index.js';
+import { InstancesModule } from './modules/instances.js';
+import { MessagesModule } from './modules/messages.js';
+import { ChatsModule } from './modules/chats.js';
+import { GroupsModule } from './modules/groups.js';
+import { ProfileModule } from './modules/profile.js';
+import { BroadcastModule } from './modules/broadcast.js';
+import { BotcastWebhook } from './webhooks/index.js';
+export declare class BotcastClient {
+    private config;
+    /** Instance Lifecycle & Connection Management */
+    instances: InstancesModule;
+    /** WhatsApp Message Dispatcher (Text, OTP, Media, Polls, Reactions, etc.) */
+    messages: MessagesModule;
+    /** Chats, Contacts, History, and Chat State Management */
+    chats: ChatsModule;
+    /** WhatsApp Group Operations & Administration */
+    groups: GroupsModule;
+    /** Profile, Avatar, About Status, and Privacy Settings */
+    profile: ProfileModule;
+    /** WhatsApp Status Stories & Broadcast Lists */
+    broadcast: BroadcastModule;
+    /** Webhook Handler & Middleware */
+    webhook: BotcastWebhook;
+    /**
+     * Initializes a new Botcast API Client.
+     *
+     * @param config Client configuration options
+     *
+     * @example
+     * ```ts
+     * import { BotcastClient } from 'botcast-sdk';
+     *
+     * const botcast = new BotcastClient({
+     *   baseUrl: 'https://botcast.site',
+     *   instanceId: 'inst_abc123',
+     *   instanceToken: 'token_xyz789'
+     * });
+     *
+     * // Send a text message
+     * await botcast.messages.sendText('201000000000', 'Hello from Botcast SDK!');
+     * ```
+     */
+    constructor(config: BotcastClientConfig);
+    /**
+     * Shortcut to send a text message.
+     */
+    sendText(recipient: string, text: string): Promise<import("./types/messages.js").SendMessageResponse>;
+    /**
+     * Shortcut to send an automated OTP verification code.
+     */
+    sendOTP(recipient: string, options?: {
+        code?: string;
+        appName?: string;
+        expiryMinutes?: number;
+    }): Promise<import("./types/messages.js").SendMessageResponse & {
+        codeSent: string;
+    }>;
+    /**
+     * Shortcut to check instance connectivity status.
+     */
+    getStatus(): Promise<import("./types/instances.js").InstanceStatusResponse>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +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;IACH,YAAY,MAAM,EAAE,mBAAmB,EAwBtC;IAMD;;OAEG;IACU,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,8DAEpD;IAED;;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;;OAE5G;IAED;;OAEG;IACU,SAAS,mEAErB;CACF"}

package/dist/client.js

@@ -0,0 +1,87 @@
+import { InstancesModule } from './modules/instances.js';
+import { MessagesModule } from './modules/messages.js';
+import { ChatsModule } from './modules/chats.js';
+import { GroupsModule } from './modules/groups.js';
+import { ProfileModule } from './modules/profile.js';
+import { BroadcastModule } from './modules/broadcast.js';
+import { BotcastWebhook } from './webhooks/index.js';
+export class BotcastClient {
+    config;
+    /** Instance Lifecycle & Connection Management */
+    instances;
+    /** WhatsApp Message Dispatcher (Text, OTP, Media, Polls, Reactions, etc.) */
+    messages;
+    /** Chats, Contacts, History, and Chat State Management */
+    chats;
+    /** WhatsApp Group Operations & Administration */
+    groups;
+    /** Profile, Avatar, About Status, and Privacy Settings */
+    profile;
+    /** WhatsApp Status Stories & Broadcast Lists */
+    broadcast;
+    /** Webhook Handler & Middleware */
+    webhook;
+    /**
+     * Initializes a new Botcast API Client.
+     *
+     * @param config Client configuration options
+     *
+     * @example
+     * ```ts
+     * import { BotcastClient } from 'botcast-sdk';
+     *
+     * const botcast = new BotcastClient({
+     *   baseUrl: 'https://botcast.site',
+     *   instanceId: 'inst_abc123',
+     *   instanceToken: 'token_xyz789'
+     * });
+     *
+     * // Send a text message
+     * await botcast.messages.sendText('201000000000', 'Hello from Botcast SDK!');
+     * ```
+     */
+    constructor(config) {
+        if (!config.instanceId) {
+            throw new Error('BotcastClient requires a valid "instanceId"');
+        }
+        if (!config.instanceToken) {
+            throw new Error('BotcastClient requires a valid "instanceToken"');
+        }
+        this.config = {
+            baseUrl: config.baseUrl || 'https://botcast.site',
+            instanceId: config.instanceId,
+            instanceToken: config.instanceToken,
+            timeout: config.timeout || 30000,
+            maxRetries: config.maxRetries ?? 2,
+            headers: config.headers || {},
+        };
+        this.instances = new InstancesModule(this.config);
+        this.messages = new MessagesModule(this.config);
+        this.chats = new ChatsModule(this.config);
+        this.groups = new GroupsModule(this.config);
+        this.profile = new ProfileModule(this.config);
+        this.broadcast = new BroadcastModule(this.config);
+        this.webhook = new BotcastWebhook();
+    }
+    // =========================================================================
+    // Top-Level Convenience Shortcuts
+    // =========================================================================
+    /**
+     * Shortcut to send a text message.
+     */
+    async sendText(recipient, text) {
+        return this.messages.sendText(recipient, text);
+    }
+    /**
+     * Shortcut to send an automated OTP verification code.
+     */
+    async sendOTP(recipient, options) {
+        return this.messages.sendOTP(recipient, options);
+    }
+    /**
+     * Shortcut to check instance connectivity status.
+     */
+    async getStatus() {
+        return this.instances.getStatus();
+    }
+}

package/dist/errors.cjs

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotcastNotFoundError = exports.BotcastValidationError = exports.BotcastRateLimitError = exports.BotcastSubscriptionExpiredError = exports.BotcastPaymentRequiredError = exports.BotcastAuthError = exports.BotcastError = void 0;
+class BotcastError extends Error {
+    statusCode;
+    details;
+    constructor(message, statusCode, details) {
+        super(message);
+        this.name = 'BotcastError';
+        this.statusCode = statusCode;
+        this.details = details;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.BotcastError = BotcastError;
+class BotcastAuthError extends BotcastError {
+    constructor(message = 'Unauthorized: Invalid instance credentials', details) {
+        super(message, 401, details);
+        this.name = 'BotcastAuthError';
+    }
+}
+exports.BotcastAuthError = BotcastAuthError;
+class BotcastPaymentRequiredError extends BotcastError {
+    constructor(message = 'Payment Required: Instance is awaiting payment confirmation', details) {
+        super(message, 402, details);
+        this.name = 'BotcastPaymentRequiredError';
+    }
+}
+exports.BotcastPaymentRequiredError = BotcastPaymentRequiredError;
+class BotcastSubscriptionExpiredError extends BotcastError {
+    expiresAt;
+    constructor(message = 'Subscription Expired', expiresAt, details) {
+        super(message, 403, details);
+        this.name = 'BotcastSubscriptionExpiredError';
+        this.expiresAt = expiresAt;
+    }
+}
+exports.BotcastSubscriptionExpiredError = BotcastSubscriptionExpiredError;
+class BotcastRateLimitError extends BotcastError {
+    constructor(message = 'Rate limit exceeded', details) {
+        super(message, 429, details);
+        this.name = 'BotcastRateLimitError';
+    }
+}
+exports.BotcastRateLimitError = BotcastRateLimitError;
+class BotcastValidationError extends BotcastError {
+    constructor(message = 'Validation Error: Invalid parameters provided', details) {
+        super(message, 400, details);
+        this.name = 'BotcastValidationError';
+    }
+}
+exports.BotcastValidationError = BotcastValidationError;
+class BotcastNotFoundError extends BotcastError {
+    constructor(message = 'Not Found: Resource or instance does not exist', details) {
+        super(message, 404, details);
+        this.name = 'BotcastNotFoundError';
+    }
+}
+exports.BotcastNotFoundError = BotcastNotFoundError;

package/dist/errors.d.ts

@@ -0,0 +1,25 @@
+export declare class BotcastError extends Error {
+    statusCode?: number;
+    details?: any;
+    constructor(message: string, statusCode?: number, details?: any);
+}
+export declare class BotcastAuthError extends BotcastError {
+    constructor(message?: string, details?: any);
+}
+export declare class BotcastPaymentRequiredError extends BotcastError {
+    constructor(message?: string, details?: any);
+}
+export declare class BotcastSubscriptionExpiredError extends BotcastError {
+    expiresAt?: string;
+    constructor(message?: string, expiresAt?: string, details?: any);
+}
+export declare class BotcastRateLimitError extends BotcastError {
+    constructor(message?: string, details?: any);
+}
+export declare class BotcastValidationError extends BotcastError {
+    constructor(message?: string, details?: any);
+}
+export declare class BotcastNotFoundError extends BotcastError {
+    constructor(message?: string, details?: any);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,YAAa,SAAQ,KAAK;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,GAAG,CAAC;IAErB,YAAY,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAM9D;CACF;AAED,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,YAAY,OAAO,GAAE,MAAqD,EAAE,OAAO,CAAC,EAAE,GAAG,EAGxF;CACF;AAED,qBAAa,2BAA4B,SAAQ,YAAY;IAC3D,YAAY,OAAO,GAAE,MAAsE,EAAE,OAAO,CAAC,EAAE,GAAG,EAGzG;CACF;AAED,qBAAa,+BAAgC,SAAQ,YAAY;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IAE1B,YAAY,OAAO,GAAE,MAA+B,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAItF;CACF;AAED,qBAAa,qBAAsB,SAAQ,YAAY;IACrD,YAAY,OAAO,GAAE,MAA8B,EAAE,OAAO,CAAC,EAAE,GAAG,EAGjE;CACF;AAED,qBAAa,sBAAuB,SAAQ,YAAY;IACtD,YAAY,OAAO,GAAE,MAAwD,EAAE,OAAO,CAAC,EAAE,GAAG,EAG3F;CACF;AAED,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,YAAY,OAAO,GAAE,MAAyD,EAAE,OAAO,CAAC,EAAE,GAAG,EAG5F;CACF"}

package/dist/errors.js

@@ -0,0 +1,49 @@
+export class BotcastError extends Error {
+    statusCode;
+    details;
+    constructor(message, statusCode, details) {
+        super(message);
+        this.name = 'BotcastError';
+        this.statusCode = statusCode;
+        this.details = details;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+export class BotcastAuthError extends BotcastError {
+    constructor(message = 'Unauthorized: Invalid instance credentials', details) {
+        super(message, 401, details);
+        this.name = 'BotcastAuthError';
+    }
+}
+export class BotcastPaymentRequiredError extends BotcastError {
+    constructor(message = 'Payment Required: Instance is awaiting payment confirmation', details) {
+        super(message, 402, details);
+        this.name = 'BotcastPaymentRequiredError';
+    }
+}
+export class BotcastSubscriptionExpiredError extends BotcastError {
+    expiresAt;
+    constructor(message = 'Subscription Expired', expiresAt, details) {
+        super(message, 403, details);
+        this.name = 'BotcastSubscriptionExpiredError';
+        this.expiresAt = expiresAt;
+    }
+}
+export class BotcastRateLimitError extends BotcastError {
+    constructor(message = 'Rate limit exceeded', details) {
+        super(message, 429, details);
+        this.name = 'BotcastRateLimitError';
+    }
+}
+export class BotcastValidationError extends BotcastError {
+    constructor(message = 'Validation Error: Invalid parameters provided', details) {
+        super(message, 400, details);
+        this.name = 'BotcastValidationError';
+    }
+}
+export class BotcastNotFoundError extends BotcastError {
+    constructor(message = 'Not Found: Resource or instance does not exist', details) {
+        super(message, 404, details);
+        this.name = 'BotcastNotFoundError';
+    }
+}