botcast-sdk 1.0.0

package/dist/modules/chats.js

@@ -0,0 +1,109 @@
+import { BaseModule } from './base.js';
+export class ChatsModule extends BaseModule {
+    /**
+     * Lists synced WhatsApp chats with optional search and pagination.
+     */
+    async list(params) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('chats'),
+            query: params,
+        });
+    }
+    /**
+     * Lists synced WhatsApp contacts.
+     */
+    async listContacts(params) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('contacts'),
+            query: params,
+        });
+    }
+    /**
+     * Lists synced chat messages.
+     */
+    async listMessages(params) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('messages'),
+            query: params,
+        });
+    }
+    /**
+     * Modifies a chat state (archive, mute, read, pin, star, delete).
+     */
+    async modify(options) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('chats/modify'),
+            body: options,
+        });
+    }
+    /**
+     * Archives a chat.
+     */
+    async archive(targetJid) {
+        return this.modify({ jid: targetJid, action: 'archive' });
+    }
+    /**
+     * Unarchives a chat.
+     */
+    async unarchive(targetJid) {
+        return this.modify({ jid: targetJid, action: 'unarchive' });
+    }
+    /**
+     * Mutes chat notifications for a specified duration in milliseconds (default: 8 hours).
+     */
+    async mute(targetJid, durationMs = 8 * 60 * 60 * 1000) {
+        return this.modify({ jid: targetJid, action: 'mute', duration: durationMs });
+    }
+    /**
+     * Unmutes chat notifications.
+     */
+    async unmute(targetJid) {
+        return this.modify({ jid: targetJid, action: 'unmute' });
+    }
+    /**
+     * Pins a chat to the top of the chat list.
+     */
+    async pin(targetJid) {
+        return this.modify({ jid: targetJid, action: 'pin', isPin: true });
+    }
+    /**
+     * Unpins a chat from the top.
+     */
+    async unpin(targetJid) {
+        return this.modify({ jid: targetJid, action: 'unpin' });
+    }
+    /**
+     * Deletes an entire chat conversation.
+     */
+    async deleteChat(targetJid) {
+        return this.modify({ jid: targetJid, action: 'delete_chat' });
+    }
+    /**
+     * Configures disappearing messages for a chat.
+     *
+     * @param recipient Target chat JID or phone number
+     * @param duration Duration in seconds (86400: 24h, 604800: 7d, 7776000: 90d)
+     * @param enabled Whether disappearing messages is enabled (default: true)
+     */
+    async setDisappearing(recipient, duration = 86400, enabled = true) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('chats/disappearing'),
+            body: { recipient, duration, enabled },
+        });
+    }
+    /**
+     * Requests older chat history from the linked phone.
+     */
+    async fetchHistory(options) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('chats/fetch-history'),
+            body: options || {},
+        });
+    }
+}

package/dist/modules/groups.cjs

@@ -0,0 +1,200 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GroupsModule = void 0;
+const base_js_1 = require("./base.js");
+class GroupsModule extends base_js_1.BaseModule {
+    /**
+     * Creates a new WhatsApp group.
+     *
+     * @param subject Group title / name
+     * @param participants Array of participant phone numbers with country codes
+     */
+    async create(subject, participants) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/create'),
+            body: { subject, participants },
+        });
+    }
+    /**
+     * Fetches all WhatsApp groups that the connected instance is participating in.
+     */
+    async list() {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('groups/list'),
+        });
+    }
+    /**
+     * Retrieves complete group metadata (participants, description, settings, admins).
+     */
+    async getMetadata(groupJid) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('groups/metadata'),
+            query: { jid: groupJid },
+        });
+    }
+    /**
+     * Updates participants in a group (add, remove, promote to admin, demote).
+     */
+    async updateParticipants(groupJid, participants, action) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/participants'),
+            body: { jid: groupJid, participants, action },
+        });
+    }
+    /**
+     * Adds members to a group.
+     */
+    async addParticipants(groupJid, participants) {
+        return this.updateParticipants(groupJid, participants, 'add');
+    }
+    /**
+     * Removes members from a group.
+     */
+    async removeParticipants(groupJid, participants) {
+        return this.updateParticipants(groupJid, participants, 'remove');
+    }
+    /**
+     * Promotes members to group administrators.
+     */
+    async promoteParticipants(groupJid, participants) {
+        return this.updateParticipants(groupJid, participants, 'promote');
+    }
+    /**
+     * Demotes group administrators back to regular members.
+     */
+    async demoteParticipants(groupJid, participants) {
+        return this.updateParticipants(groupJid, participants, 'demote');
+    }
+    /**
+     * Changes the group subject / title.
+     */
+    async updateSubject(groupJid, subject) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/subject'),
+            body: { jid: groupJid, subject },
+        });
+    }
+    /**
+     * Updates the group description.
+     */
+    async updateDescription(groupJid, description) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/description'),
+            body: { jid: groupJid, description },
+        });
+    }
+    /**
+     * Updates group permissions / settings:
+     * - `announcement`: Only admins can send messages
+     * - `not_announcement`: All members can send messages
+     * - `locked`: Only admins can edit group info
+     * - `unlocked`: All members can edit group info
+     */
+    async updateSettings(groupJid, setting) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/settings'),
+            body: { jid: groupJid, setting },
+        });
+    }
+    /**
+     * Leaves a WhatsApp group.
+     */
+    async leave(groupJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/leave'),
+            body: { jid: groupJid },
+        });
+    }
+    /**
+     * Gets the invite code and shareable invite link for a group.
+     */
+    async getInviteCode(groupJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/invite'),
+            body: { action: 'get_code', jid: groupJid },
+        });
+    }
+    /**
+     * Revokes the current invite code and creates a new one.
+     */
+    async revokeInviteCode(groupJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/invite'),
+            body: { action: 'revoke', jid: groupJid },
+        });
+    }
+    /**
+     * Joins a group using an invite code.
+     */
+    async acceptInvite(code) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/invite'),
+            body: { action: 'accept', code },
+        });
+    }
+    /**
+     * Inspects group metadata using an invite code before joining.
+     */
+    async getInviteInfo(code) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/invite'),
+            body: { action: 'inspect', code },
+        });
+    }
+    /**
+     * Gets pending participant join requests (for groups with admin approval enabled).
+     */
+    async getJoinRequests(groupJid) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('groups/join-requests'),
+            query: { jid: groupJid },
+        });
+    }
+    /**
+     * Approves or rejects participant join requests.
+     */
+    async updateJoinRequests(groupJid, participants, action) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/join-requests'),
+            body: { jid: groupJid, participants, action },
+        });
+    }
+    /**
+     * Configures disappearing messages for a group.
+     *
+     * @param groupJid Group JID
+     * @param durationSeconds 0 for off, 86400 (24h), 604800 (7d), 7776000 (90d)
+     */
+    async setEphemeral(groupJid, durationSeconds) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/ephemeral'),
+            body: { jid: groupJid, duration: durationSeconds },
+        });
+    }
+    /**
+     * Configures member add mode (`all_member_add` or `admin_add`).
+     */
+    async setMemberAddMode(groupJid, mode) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/member-add-mode'),
+            body: { jid: groupJid, mode },
+        });
+    }
+}
+exports.GroupsModule = GroupsModule;

package/dist/modules/groups.d.ts

@@ -0,0 +1,139 @@
+import { BaseModule } from './base.js';
+import { CreateGroupResponse, GroupMetadata, GroupParticipantAction, GroupSetting, GroupMemberAddMode, GroupInviteCodeResponse, JoinRequestItem } from '../types/index.js';
+export declare class GroupsModule extends BaseModule {
+    /**
+     * Creates a new WhatsApp group.
+     *
+     * @param subject Group title / name
+     * @param participants Array of participant phone numbers with country codes
+     */
+    create(subject: string, participants: string[]): Promise<CreateGroupResponse>;
+    /**
+     * Fetches all WhatsApp groups that the connected instance is participating in.
+     */
+    list(): Promise<{
+        success: boolean;
+        total: number;
+        groups: Record<string, GroupMetadata>;
+    }>;
+    /**
+     * Retrieves complete group metadata (participants, description, settings, admins).
+     */
+    getMetadata(groupJid: string): Promise<{
+        success: boolean;
+        metadata: GroupMetadata;
+    }>;
+    /**
+     * Updates participants in a group (add, remove, promote to admin, demote).
+     */
+    updateParticipants(groupJid: string, participants: string[], action: GroupParticipantAction): Promise<{
+        success: boolean;
+        message: string;
+        result?: any;
+    }>;
+    /**
+     * Adds members to a group.
+     */
+    addParticipants(groupJid: string, participants: string[]): Promise<any>;
+    /**
+     * Removes members from a group.
+     */
+    removeParticipants(groupJid: string, participants: string[]): Promise<any>;
+    /**
+     * Promotes members to group administrators.
+     */
+    promoteParticipants(groupJid: string, participants: string[]): Promise<any>;
+    /**
+     * Demotes group administrators back to regular members.
+     */
+    demoteParticipants(groupJid: string, participants: string[]): Promise<any>;
+    /**
+     * Changes the group subject / title.
+     */
+    updateSubject(groupJid: string, subject: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Updates the group description.
+     */
+    updateDescription(groupJid: string, description: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Updates group permissions / settings:
+     * - `announcement`: Only admins can send messages
+     * - `not_announcement`: All members can send messages
+     * - `locked`: Only admins can edit group info
+     * - `unlocked`: All members can edit group info
+     */
+    updateSettings(groupJid: string, setting: GroupSetting): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Leaves a WhatsApp group.
+     */
+    leave(groupJid: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Gets the invite code and shareable invite link for a group.
+     */
+    getInviteCode(groupJid: string): Promise<GroupInviteCodeResponse>;
+    /**
+     * Revokes the current invite code and creates a new one.
+     */
+    revokeInviteCode(groupJid: string): Promise<GroupInviteCodeResponse>;
+    /**
+     * Joins a group using an invite code.
+     */
+    acceptInvite(code: string): Promise<{
+        success: boolean;
+        message: string;
+        result?: any;
+    }>;
+    /**
+     * Inspects group metadata using an invite code before joining.
+     */
+    getInviteInfo(code: string): Promise<{
+        success: boolean;
+        groupInfo: any;
+    }>;
+    /**
+     * Gets pending participant join requests (for groups with admin approval enabled).
+     */
+    getJoinRequests(groupJid: string): Promise<{
+        success: boolean;
+        groupJid: string;
+        pendingRequests: JoinRequestItem[];
+    }>;
+    /**
+     * Approves or rejects participant join requests.
+     */
+    updateJoinRequests(groupJid: string, participants: string[], action: 'approve' | 'reject'): Promise<{
+        success: boolean;
+        message: string;
+        result?: any;
+    }>;
+    /**
+     * Configures disappearing messages for a group.
+     *
+     * @param groupJid Group JID
+     * @param durationSeconds 0 for off, 86400 (24h), 604800 (7d), 7776000 (90d)
+     */
+    setEphemeral(groupJid: string, durationSeconds: number): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /**
+     * Configures member add mode (`all_member_add` or `admin_add`).
+     */
+    setMemberAddMode(groupJid: string, mode: GroupMemberAddMode): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=groups.d.ts.map

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

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

package/dist/modules/groups.js

@@ -0,0 +1,196 @@
+import { BaseModule } from './base.js';
+export class GroupsModule extends BaseModule {
+    /**
+     * Creates a new WhatsApp group.
+     *
+     * @param subject Group title / name
+     * @param participants Array of participant phone numbers with country codes
+     */
+    async create(subject, participants) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/create'),
+            body: { subject, participants },
+        });
+    }
+    /**
+     * Fetches all WhatsApp groups that the connected instance is participating in.
+     */
+    async list() {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('groups/list'),
+        });
+    }
+    /**
+     * Retrieves complete group metadata (participants, description, settings, admins).
+     */
+    async getMetadata(groupJid) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('groups/metadata'),
+            query: { jid: groupJid },
+        });
+    }
+    /**
+     * Updates participants in a group (add, remove, promote to admin, demote).
+     */
+    async updateParticipants(groupJid, participants, action) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/participants'),
+            body: { jid: groupJid, participants, action },
+        });
+    }
+    /**
+     * Adds members to a group.
+     */
+    async addParticipants(groupJid, participants) {
+        return this.updateParticipants(groupJid, participants, 'add');
+    }
+    /**
+     * Removes members from a group.
+     */
+    async removeParticipants(groupJid, participants) {
+        return this.updateParticipants(groupJid, participants, 'remove');
+    }
+    /**
+     * Promotes members to group administrators.
+     */
+    async promoteParticipants(groupJid, participants) {
+        return this.updateParticipants(groupJid, participants, 'promote');
+    }
+    /**
+     * Demotes group administrators back to regular members.
+     */
+    async demoteParticipants(groupJid, participants) {
+        return this.updateParticipants(groupJid, participants, 'demote');
+    }
+    /**
+     * Changes the group subject / title.
+     */
+    async updateSubject(groupJid, subject) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/subject'),
+            body: { jid: groupJid, subject },
+        });
+    }
+    /**
+     * Updates the group description.
+     */
+    async updateDescription(groupJid, description) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/description'),
+            body: { jid: groupJid, description },
+        });
+    }
+    /**
+     * Updates group permissions / settings:
+     * - `announcement`: Only admins can send messages
+     * - `not_announcement`: All members can send messages
+     * - `locked`: Only admins can edit group info
+     * - `unlocked`: All members can edit group info
+     */
+    async updateSettings(groupJid, setting) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/settings'),
+            body: { jid: groupJid, setting },
+        });
+    }
+    /**
+     * Leaves a WhatsApp group.
+     */
+    async leave(groupJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/leave'),
+            body: { jid: groupJid },
+        });
+    }
+    /**
+     * Gets the invite code and shareable invite link for a group.
+     */
+    async getInviteCode(groupJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/invite'),
+            body: { action: 'get_code', jid: groupJid },
+        });
+    }
+    /**
+     * Revokes the current invite code and creates a new one.
+     */
+    async revokeInviteCode(groupJid) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/invite'),
+            body: { action: 'revoke', jid: groupJid },
+        });
+    }
+    /**
+     * Joins a group using an invite code.
+     */
+    async acceptInvite(code) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/invite'),
+            body: { action: 'accept', code },
+        });
+    }
+    /**
+     * Inspects group metadata using an invite code before joining.
+     */
+    async getInviteInfo(code) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/invite'),
+            body: { action: 'inspect', code },
+        });
+    }
+    /**
+     * Gets pending participant join requests (for groups with admin approval enabled).
+     */
+    async getJoinRequests(groupJid) {
+        return this.request({
+            method: 'GET',
+            path: this.buildPath('groups/join-requests'),
+            query: { jid: groupJid },
+        });
+    }
+    /**
+     * Approves or rejects participant join requests.
+     */
+    async updateJoinRequests(groupJid, participants, action) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/join-requests'),
+            body: { jid: groupJid, participants, action },
+        });
+    }
+    /**
+     * Configures disappearing messages for a group.
+     *
+     * @param groupJid Group JID
+     * @param durationSeconds 0 for off, 86400 (24h), 604800 (7d), 7776000 (90d)
+     */
+    async setEphemeral(groupJid, durationSeconds) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/ephemeral'),
+            body: { jid: groupJid, duration: durationSeconds },
+        });
+    }
+    /**
+     * Configures member add mode (`all_member_add` or `admin_add`).
+     */
+    async setMemberAddMode(groupJid, mode) {
+        return this.request({
+            method: 'POST',
+            path: this.buildPath('groups/member-add-mode'),
+            body: { jid: groupJid, mode },
+        });
+    }
+}