botcast-sdk 1.0.0

package/dist/modules/profile.js

@@ -0,0 +1,125 @@
+import { BaseModule } from './base.js';
+export class ProfileModule extends BaseModule {
+    /**
+     * Fetches the bio / text status of a phone number or the current instance.
+     */
+    async getStatus(targetPhoneOrJid) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('profile/status'),
+            query: targetPhoneOrJid ? { phone: targetPhoneOrJid } : undefined,
+        });
+    }
+    /**
+     * Updates the about / bio status of the connected WhatsApp instance.
+     */
+    async setStatus(status) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('profile/status'),
+            body: { status },
+        });
+    }
+    /**
+     * Updates the public display name of the instance.
+     */
+    async setName(name) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('profile/name'),
+            body: { name },
+        });
+    }
+    /**
+     * Fetches the profile picture URL of a contact or group.
+     */
+    async getPicture(targetPhoneOrJid, highRes = false) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('profile/picture'),
+            query: {
+                phone: targetPhoneOrJid,
+                highRes,
+            },
+        });
+    }
+    /**
+     * Updates the profile picture for the instance or a group.
+     */
+    async setPicture(imageSource, targetJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('profile/picture'),
+            body: { jid: targetJid, ...imageSource },
+        });
+    }
+    /**
+     * Removes the profile picture.
+     */
+    async removePicture(targetJid) {
+        return this.request({
+            method: 'DELETE',
+            path: this.buildPath('profile/picture'),
+            body: { jid: targetJid },
+        });
+    }
+    /**
+     * Fetches WhatsApp Business profile information (category, email, hours).
+     */
+    async getBusinessProfile(targetPhoneOrJid) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('profile/business'),
+            query: { phone: targetPhoneOrJid },
+        });
+    }
+    /**
+     * Blocks a user on WhatsApp.
+     */
+    async block(targetPhoneOrJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('privacy/block'),
+            body: { phone: targetPhoneOrJid, action: 'block' },
+        });
+    }
+    /**
+     * Unblocks a previously blocked user.
+     */
+    async unblock(targetPhoneOrJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('privacy/block'),
+            body: { phone: targetPhoneOrJid, action: 'unblock' },
+        });
+    }
+    /**
+     * Fetches the full blocklist.
+     */
+    async getBlocklist() {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('privacy/blocklist'),
+        });
+    }
+    /**
+     * Fetches WhatsApp privacy settings.
+     */
+    async getPrivacySettings(force = false) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('privacy/settings'),
+            query: { force },
+        });
+    }
+    /**
+     * Updates a WhatsApp privacy configuration (lastSeen, online, profilePicture, status, readReceipts).
+     */
+    async updatePrivacySetting(type, value) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('privacy/update'),
+            body: { type, value },
+        });
+    }
+}

package/dist/types/chats.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/chats.d.ts

@@ -0,0 +1,62 @@
+import { MessageKey } from './messages.js';
+export interface ChatItem {
+    id: string;
+    name?: string;
+    unreadCount?: number;
+    readOnly?: boolean;
+    ephemeralExpiration?: number;
+    lastMessageTimestamp?: number;
+}
+export interface ContactItem {
+    id: string;
+    jid: string;
+    phoneNumber: string;
+    name?: string;
+    notify?: string;
+    updated_at?: string;
+}
+export interface SyncedMessageItem {
+    id: string;
+    instance_id: string;
+    chat_jid: string;
+    sender_jid: string;
+    from_me: number;
+    message_type: string;
+    body: string;
+    timestamp: number;
+}
+export interface ListChatsParams {
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ListContactsParams {
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+export interface ListMessagesParams {
+    chatJid?: string;
+    limit?: number;
+    offset?: number;
+}
+export type ChatAction = 'archive' | 'unarchive' | 'mute' | 'unmute' | 'mark_read' | 'mark_unread' | 'delete_chat' | 'delete_for_me' | 'clear' | 'pin' | 'unpin' | 'star';
+export interface ChatModifyOptions {
+    jid?: string;
+    chatJid?: string;
+    recipient?: string;
+    phone?: string;
+    action?: ChatAction;
+    modification?: any;
+    duration?: number;
+    isPin?: boolean;
+    isStar?: boolean;
+    lastMessages?: any[];
+    messages?: any[];
+}
+export interface FetchHistoryOptions {
+    count?: number;
+    oldestMsgKey?: MessageKey;
+    oldestMsgTimestamp?: number;
+}
+//# sourceMappingURL=chats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chats.d.ts","sourceRoot":"","sources":["../../../src/types/chats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,WAAW,GACX,MAAM,GACN,QAAQ,GACR,WAAW,GACX,aAAa,GACb,aAAa,GACb,eAAe,GACf,OAAO,GACP,KAAK,GACL,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,GAAG,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,UAAU,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B"}

package/dist/types/chats.js

@@ -0,0 +1 @@
+export {};

package/dist/types/groups.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/groups.d.ts

@@ -0,0 +1,47 @@
+export type GroupParticipantAction = 'add' | 'remove' | 'promote' | 'demote';
+export type GroupSetting = 'announcement' | 'not_announcement' | 'locked' | 'unlocked';
+export type GroupMemberAddMode = 'all_member_add' | 'admin_add';
+export interface GroupParticipant {
+    id: string;
+    admin?: 'admin' | 'superadmin' | null;
+}
+export interface GroupMetadata {
+    id: string;
+    subject: string;
+    subjectOwner?: string;
+    subjectTime?: number;
+    size?: number;
+    creation?: number;
+    owner?: string;
+    desc?: string;
+    descId?: string;
+    descOwner?: string;
+    descTime?: number;
+    restrict?: boolean;
+    announce?: boolean;
+    participants: GroupParticipant[];
+    ephemeralDuration?: number;
+    inviteCode?: string;
+    memberAddMode?: boolean;
+}
+export interface CreateGroupResponse {
+    success: boolean;
+    message: string;
+    group: {
+        id: string;
+        subject: string;
+        participants: GroupParticipant[];
+    };
+}
+export interface GroupInviteCodeResponse {
+    success: boolean;
+    code?: string;
+    link?: string;
+    inviteCode?: string;
+    inviteLink?: string;
+}
+export interface JoinRequestItem {
+    jid: string;
+    requested_at: number;
+}
+//# sourceMappingURL=groups.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"groups.d.ts","sourceRoot":"","sources":["../../../src/types/groups.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAAG,KAAK,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,cAAc,GAAG,kBAAkB,GAAG,QAAQ,GAAG,UAAU,CAAC;AACvF,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAEhE,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,gBAAgB,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,MAAM,CAAC;QAChB,YAAY,EAAE,gBAAgB,EAAE,CAAC;KAClC,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types/groups.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.cjs

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
+__exportStar(require("./instances.js"), exports);
+__exportStar(require("./messages.js"), exports);
+__exportStar(require("./chats.js"), exports);
+__exportStar(require("./groups.js"), exports);
+__exportStar(require("./profile.js"), exports);
+__exportStar(require("./webhooks.js"), exports);

package/dist/types/index.d.ts

@@ -0,0 +1,34 @@
+export * from './instances.js';
+export * from './messages.js';
+export * from './chats.js';
+export * from './groups.js';
+export * from './profile.js';
+export * from './webhooks.js';
+export interface BotcastClientConfig {
+    /**
+     * The base URL of your Botcast instance or cloud gateway.
+     * Default: `https://botcast.site`
+     */
+    baseUrl?: string;
+    /**
+     * Your unique Botcast Instance ID.
+     */
+    instanceId: string;
+    /**
+     * The secret Instance Token for authentication.
+     */
+    instanceToken: string;
+    /**
+     * Request timeout in milliseconds (default: 30000ms).
+     */
+    timeout?: number;
+    /**
+     * Maximum retry attempts on network / rate limit errors (default: 2).
+     */
+    maxRetries?: number;
+    /**
+     * Custom HTTP headers to include with every request.
+     */
+    headers?: Record<string, string>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+export * from './instances.js';
+export * from './messages.js';
+export * from './chats.js';
+export * from './groups.js';
+export * from './profile.js';
+export * from './webhooks.js';

package/dist/types/instances.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/instances.d.ts

@@ -0,0 +1,65 @@
+export type InstanceStatus = 'connected' | 'disconnected' | 'connecting' | 'qr_ready' | 'stopped';
+export type InstanceType = 'dev' | 'paid' | 'custom';
+export interface InstanceStatusResponse {
+    instanceId: string;
+    name: string;
+    type: InstanceType;
+    status: InstanceStatus;
+    phoneNumber?: string | null;
+    profileName?: string | null;
+    avatarUrl?: string | null;
+    profilePicUrl?: string | null;
+    allowedNumbers?: string[] | 'unlimited';
+    hasQRCode: boolean;
+    hasPairingCode: boolean;
+    pairingCode?: string | null;
+    uptime: number;
+}
+export interface InstanceQRResponse {
+    status: InstanceStatus;
+    qr?: string;
+    message: string;
+    phoneNumber?: string;
+}
+export interface PairCodeResponse {
+    success: boolean;
+    phoneNumber: string;
+    pairingCode: string;
+    formattedCode: string;
+    instructions: string;
+}
+export interface AllowedNumbersResponse {
+    instanceId: string;
+    type: InstanceType;
+    allowedNumbers: string[];
+    limit: number | 'unlimited';
+}
+export interface SetAllowedNumbersResponse {
+    success: boolean;
+    message: string;
+    allowedNumbers: string[];
+}
+export interface CheckNumberResponse {
+    exists: boolean;
+    phone: string;
+    jid: string;
+    avatarUrl?: string | null;
+}
+export interface PresenceOptions {
+    presence: 'available' | 'unavailable' | 'composing' | 'recording' | 'paused';
+    to?: string;
+    phone?: string;
+    recipient?: string;
+}
+export interface InstanceLimitsResponse {
+    instanceId: string;
+    daily_message_limit: number;
+    daily_new_contacts_limit: number;
+    is_message_limit_active: boolean;
+    is_new_contacts_limit_active: boolean;
+}
+export interface UpdateLimitsPayload {
+    daily_message_limit?: number;
+    daily_new_contacts_limit?: number;
+}
+//# sourceMappingURL=instances.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"instances.d.ts","sourceRoot":"","sources":["../../../src/types/instances.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,cAAc,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAC;AAClG,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;AAErD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,YAAY,CAAC;IACnB,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC;CAC7B;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,WAAW,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC7E,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,uBAAuB,EAAE,OAAO,CAAC;IACjC,4BAA4B,EAAE,OAAO,CAAC;CACvC;AAED,MAAM,WAAW,mBAAmB;IAClC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC"}

package/dist/types/instances.js

@@ -0,0 +1 @@
+export {};

package/dist/types/messages.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/messages.d.ts

@@ -0,0 +1,86 @@
+export type MessageType = 'text' | 'image' | 'video' | 'audio' | 'voice' | 'document' | 'sticker' | 'location' | 'contact' | 'reaction' | 'pin' | 'poll' | 'forward' | 'otp' | 'disappearing';
+export interface MessageKey {
+    remoteJid?: string;
+    fromMe?: boolean;
+    id: string;
+    participant?: string;
+}
+export interface QuotedMessageOptions {
+    key?: MessageKey;
+    message?: any;
+    quotedKey?: MessageKey;
+    quotedText?: string;
+}
+export interface BaseMessageOptions {
+    quoted?: any;
+    quotedKey?: MessageKey;
+    quotedText?: string;
+    ephemeralExpiration?: number;
+    mentions?: string[];
+}
+export interface SendTextOptions extends BaseMessageOptions {
+    text: string;
+}
+export interface SendMediaOptions extends BaseMessageOptions {
+    url?: string;
+    base64?: string;
+    caption?: string;
+    fileName?: string;
+    mimetype?: string;
+    ptt?: boolean;
+}
+export interface SendLocationOptions extends BaseMessageOptions {
+    latitude: number;
+    longitude: number;
+    name?: string;
+    address?: string;
+}
+export interface SendContactOptions extends BaseMessageOptions {
+    displayName: string;
+    vcard?: string;
+    contacts?: Array<{
+        displayName: string;
+        vcard: string;
+    }>;
+}
+export interface SendPollOptions extends BaseMessageOptions {
+    name: string;
+    values: string[];
+    selectableCount?: number;
+}
+export interface SendOTPOptions {
+    code?: string;
+    otp?: string;
+    appName?: string;
+    service?: string;
+    expiryMinutes?: number;
+}
+export interface SendMessageResponse {
+    success: boolean;
+    messageId: string;
+    status: string;
+    timestamp?: number;
+    codeSent?: string;
+    result?: any;
+}
+export interface EditMessagePayload {
+    recipient: string;
+    key: MessageKey;
+    text: string;
+}
+export interface DeleteMessagePayload {
+    recipient: string;
+    key: MessageKey;
+}
+export interface ReactMessagePayload {
+    recipient: string;
+    key: MessageKey;
+    emoji: string;
+}
+export interface PinMessagePayload {
+    recipient: string;
+    key: MessageKey;
+    type?: 1 | 0;
+    time?: number;
+}
+//# sourceMappingURL=messages.d.ts.map

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

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

package/dist/types/messages.js

@@ -0,0 +1 @@
+export {};

package/dist/types/profile.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/profile.d.ts

@@ -0,0 +1,25 @@
+export interface BusinessProfile {
+    description?: string;
+    email?: string;
+    websites?: string[];
+    category?: string;
+    business_hours?: any;
+}
+export type PrivacySettingType = 'lastSeen' | 'online' | 'profilePicture' | 'status' | 'readReceipts' | 'groupsAdd' | 'defaultDisappearing';
+export type PrivacyValue = 'all' | 'contacts' | 'contact_blacklist' | 'match_last_seen' | 'none' | boolean | number;
+export interface PrivacySettings {
+    readreceipts?: string;
+    profile?: string;
+    status?: string;
+    online?: string;
+    last?: string;
+    groupadd?: string;
+    calladd?: string;
+}
+export interface BroadcastStoryOptions {
+    statusJidList?: string[];
+    backgroundColor?: string;
+    font?: number;
+    caption?: string;
+}
+//# sourceMappingURL=profile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../../src/types/profile.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,GAAG,CAAC;CACtB;AAED,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,QAAQ,GACR,gBAAgB,GAChB,QAAQ,GACR,cAAc,GACd,WAAW,GACX,qBAAqB,CAAC;AAE1B,MAAM,MAAM,YAAY,GACpB,KAAK,GACL,UAAU,GACV,mBAAmB,GACnB,iBAAiB,GACjB,MAAM,GACN,OAAO,GACP,MAAM,CAAC;AAEX,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/types/profile.js

@@ -0,0 +1 @@
+export {};

package/dist/types/webhooks.cjs

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/webhooks.d.ts

@@ -0,0 +1,17 @@
+export interface WebhookMessageReceivedEvent {
+    event: 'message_received';
+    instanceId: string;
+    sender: string;
+    senderJid: string;
+    pushName?: string;
+    message: string;
+    raw?: any;
+    timestamp: string;
+}
+export type WebhookEvent = WebhookMessageReceivedEvent | {
+    event: string;
+    instanceId: string;
+    [key: string]: any;
+};
+export type WebhookHandler<T = WebhookEvent> = (event: T) => void | Promise<void>;
+//# sourceMappingURL=webhooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/types/webhooks.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,2BAA2B,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAAC;AAEnH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,YAAY,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/types/webhooks.js

@@ -0,0 +1 @@
+export {};

package/dist/webhooks/index.cjs

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BotcastWebhook = void 0;
+class BotcastWebhook {
+    handlers = new Map();
+    /**
+     * Registers a callback for incoming messages.
+     */
+    onMessage(handler) {
+        return this.on('message_received', handler);
+    }
+    /**
+     * Registers a callback for any event type.
+     */
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return this;
+    }
+    /**
+     * Dispatches and processes a raw webhook event body.
+     */
+    async handleEvent(event) {
+        if (!event || !event.event)
+            return;
+        // Trigger specific event handlers
+        const specificHandlers = this.handlers.get(event.event);
+        if (specificHandlers) {
+            for (const handler of specificHandlers) {
+                await handler(event);
+            }
+        }
+        // Trigger wildcard '*' handlers
+        const wildcardHandlers = this.handlers.get('*');
+        if (wildcardHandlers) {
+            for (const handler of wildcardHandlers) {
+                await handler(event);
+            }
+        }
+    }
+    /**
+     * Express / Connect compatible middleware:
+     *
+     * @example
+     * ```ts
+     * app.post('/webhook', botcast.webhook.middleware());
+     * ```
+     */
+    middleware() {
+        return async (req, res, next) => {
+            try {
+                const body = req.body;
+                if (body && body.event) {
+                    await this.handleEvent(body);
+                }
+                res.status(200).json({ received: true });
+            }
+            catch (err) {
+                if (typeof next === 'function') {
+                    next(err);
+                }
+                else {
+                    res.status(500).json({ error: 'Webhook processing failed', message: err.message });
+                }
+            }
+        };
+    }
+}
+exports.BotcastWebhook = BotcastWebhook;