wuzapi 1.3.1 → 1.5.0

package/dist/index.js

@@ -17,8 +17,7 @@ class BaseClient {
     this.axios = axios.create({
       baseURL: config.apiUrl,
       headers: {
-        "Content-Type": "application/json",
-        Authorization: config.token
+        "Content-Type": "application/json"
       }
     });
     this.axios.interceptors.response.use(
@@ -39,11 +38,29 @@ class BaseClient {
       }
     );
   }
-  async request(method, endpoint, data) {
+  /**
+   * Resolve the token from request options or instance config
+   * Throws an error if no token is available
+   */
+  resolveToken(options) {
+    const token = options?.token || this.config.token;
+    if (!token) {
+      throw new WuzapiError(
+        401,
+        "No authentication token provided. Either set a token in the client config or provide one in the request options."
+      );
+    }
+    return token;
+  }
+  async request(method, endpoint, data, options) {
+    const token = this.resolveToken(options);
     const response = await this.axios.request({
       method,
       url: endpoint,
-      data
+      data,
+      headers: {
+        Authorization: token
+      }
     });
     if (!response.data.success) {
       throw new WuzapiError(
@@ -54,296 +71,505 @@ class BaseClient {
     }
     return response.data.data;
   }
-  async get(endpoint) {
-    return this.request("GET", endpoint);
+  async get(endpoint, options) {
+    return this.request("GET", endpoint, void 0, options);
+  }
+  async post(endpoint, data, options) {
+    return this.request("POST", endpoint, data, options);
   }
-  async post(endpoint, data) {
-    return this.request("POST", endpoint, data);
+  async put(endpoint, data, options) {
+    return this.request("PUT", endpoint, data, options);
   }
-  async delete(endpoint) {
-    return this.request("DELETE", endpoint);
+  async delete(endpoint, options) {
+    return this.request("DELETE", endpoint, void 0, options);
   }
 }
 class AdminModule extends BaseClient {
   /**
    * List all users
    */
-  async listUsers() {
-    return this.get("/admin/users");
+  async listUsers(options) {
+    return this.get("/admin/users", options);
   }
   /**
    * Add a new user
    */
-  async addUser(user) {
-    return this.post("/admin/users", user);
+  async addUser(user, options) {
+    return this.post("/admin/users", user, options);
+  }
+  /**
+   * Get a specific user by ID
+   */
+  async getUser(id, options) {
+    return this.get(`/admin/users/${id}`, options);
   }
   /**
    * Delete a user by ID
    */
-  async deleteUser(id) {
-    return this.delete(`/admin/users/${id}`);
+  async deleteUser(id, options) {
+    return this.delete(`/admin/users/${id}`, options);
+  }
+  /**
+   * Delete a user completely (full deletion) by ID
+   */
+  async deleteUserComplete(id, options) {
+    return this.delete(`/admin/users/${id}/full`, options);
   }
 }
 class SessionModule extends BaseClient {
   /**
    * Connect to WhatsApp servers
    */
-  async connect(options) {
-    return this.post("/session/connect", options);
+  async connect(request, options) {
+    return this.post("/session/connect", request, options);
   }
   /**
    * Disconnect from WhatsApp servers
    */
-  async disconnect() {
-    return this.post("/session/disconnect");
+  async disconnect(options) {
+    return this.post(
+      "/session/disconnect",
+      void 0,
+      options
+    );
   }
   /**
    * Logout and finish the session
    */
-  async logout() {
-    return this.post("/session/logout");
+  async logout(options) {
+    return this.post("/session/logout", void 0, options);
   }
   /**
    * Get session status
    */
-  async getStatus() {
-    return this.get("/session/status");
+  async getStatus(options) {
+    return this.get("/session/status", options);
   }
   /**
    * Get QR code for scanning
    */
-  async getQRCode() {
-    return this.get("/session/qr");
+  async getQRCode(options) {
+    return this.get("/session/qr", options);
   }
   /**
    * Configure S3 storage
    */
-  async configureS3(config) {
-    return this.post("/session/s3/config", config);
+  async configureS3(config, options) {
+    return this.post("/session/s3/config", config, options);
   }
   /**
    * Get S3 configuration
    */
-  async getS3Config() {
-    return this.get("/session/s3/config");
+  async getS3Config(options) {
+    return this.get("/session/s3/config", options);
   }
   /**
    * Test S3 connection
    */
-  async testS3() {
-    return this.post("/session/s3/test");
+  async testS3(options) {
+    return this.post("/session/s3/test", void 0, options);
   }
   /**
    * Delete S3 configuration
    */
-  async deleteS3Config() {
-    return this.delete("/session/s3/config");
+  async deleteS3Config(options) {
+    return this.delete("/session/s3/config", options);
+  }
+  /**
+   * Pair phone using verification code
+   */
+  async pairPhone(phone, code, options) {
+    const request = { Phone: phone, Code: code };
+    return this.post("/session/pairphone", request, options);
+  }
+  /**
+   * Request history sync from WhatsApp servers
+   */
+  async requestHistory(options) {
+    return this.get("/session/history", options);
+  }
+  /**
+   * Set proxy configuration
+   */
+  async setProxy(proxy, options) {
+    const request = { Proxy: proxy };
+    return this.post("/session/proxy", request, options);
   }
 }
 class UserModule extends BaseClient {
   /**
    * Get user details for specified phone numbers
    */
-  async getInfo(phones) {
+  async getInfo(phones, options) {
     const request = { Phone: phones };
-    return this.post("/user/info", request);
+    return this.post("/user/info", request, options);
   }
   /**
    * Check if phone numbers are registered WhatsApp users
    */
-  async check(phones) {
+  async check(phones, options) {
     const request = { Phone: phones };
-    return this.post("/user/check", request);
+    return this.post("/user/check", request, options);
   }
   /**
    * Get user avatar/profile picture
    */
-  async getAvatar(phone, preview = true) {
+  async getAvatar(phone, preview = true, options) {
     const request = { Phone: phone, Preview: preview };
-    return this.post("/user/avatar", request);
+    return this.post("/user/avatar", request, options);
   }
   /**
    * Get all contacts
    */
-  async getContacts() {
-    return this.get("/user/contacts");
+  async getContacts(options) {
+    return this.get("/user/contacts", options);
+  }
+  /**
+   * Send user presence (available/unavailable status)
+   */
+  async sendPresence(request, options) {
+    await this.post("/user/presence", request, options);
   }
 }
 class ChatModule extends BaseClient {
   /**
    * Send a text message
    */
-  async sendText(request) {
-    return this.post("/chat/send/text", request);
+  async sendText(request, options) {
+    return this.post("/chat/send/text", request, options);
   }
   /**
    * Send a template message with buttons
    */
-  async sendTemplate(request) {
-    return this.post("/chat/send/template", request);
+  async sendTemplate(request, options) {
+    return this.post(
+      "/chat/send/template",
+      request,
+      options
+    );
   }
   /**
    * Send an audio message
    */
-  async sendAudio(request) {
-    return this.post("/chat/send/audio", request);
+  async sendAudio(request, options) {
+    return this.post("/chat/send/audio", request, options);
   }
   /**
    * Send an image message
    */
-  async sendImage(request) {
-    return this.post("/chat/send/image", request);
+  async sendImage(request, options) {
+    return this.post("/chat/send/image", request, options);
   }
   /**
    * Send a document message
    */
-  async sendDocument(request) {
-    return this.post("/chat/send/document", request);
+  async sendDocument(request, options) {
+    return this.post(
+      "/chat/send/document",
+      request,
+      options
+    );
   }
   /**
    * Send a video message
    */
-  async sendVideo(request) {
-    return this.post("/chat/send/video", request);
+  async sendVideo(request, options) {
+    return this.post("/chat/send/video", request, options);
   }
   /**
    * Send a sticker message
    */
-  async sendSticker(request) {
-    return this.post("/chat/send/sticker", request);
+  async sendSticker(request, options) {
+    return this.post(
+      "/chat/send/sticker",
+      request,
+      options
+    );
   }
   /**
    * Send a location message
    */
-  async sendLocation(request) {
-    return this.post("/chat/send/location", request);
+  async sendLocation(request, options) {
+    return this.post(
+      "/chat/send/location",
+      request,
+      options
+    );
   }
   /**
    * Send a contact message
    */
-  async sendContact(request) {
-    return this.post("/chat/send/contact", request);
+  async sendContact(request, options) {
+    return this.post(
+      "/chat/send/contact",
+      request,
+      options
+    );
   }
   /**
    * Send chat presence indication (typing indicator)
    */
-  async sendPresence(request) {
-    await this.post("/chat/presence", request);
+  async sendPresence(request, options) {
+    await this.post("/chat/presence", request, options);
   }
   /**
    * Mark messages as read
    */
-  async markRead(request) {
-    await this.post("/chat/markread", request);
+  async markRead(request, options) {
+    await this.post("/chat/markread", request, options);
   }
   /**
    * React to a message
    */
-  async react(request) {
-    return this.post("/chat/react", request);
+  async react(request, options) {
+    return this.post("/chat/react", request, options);
   }
   /**
    * Download an image from a message
    */
-  async downloadImage(request) {
-    return this.post("/chat/downloadimage", request);
+  async downloadImage(request, options) {
+    return this.post(
+      "/chat/downloadimage",
+      request,
+      options
+    );
   }
   /**
    * Download a video from a message
    */
-  async downloadVideo(request) {
-    return this.post("/chat/downloadvideo", request);
+  async downloadVideo(request, options) {
+    return this.post(
+      "/chat/downloadvideo",
+      request,
+      options
+    );
   }
   /**
    * Download an audio from a message
    */
-  async downloadAudio(request) {
-    return this.post("/chat/downloadaudio", request);
+  async downloadAudio(request, options) {
+    return this.post(
+      "/chat/downloadaudio",
+      request,
+      options
+    );
   }
   /**
    * Download a document from a message
    */
-  async downloadDocument(request) {
-    return this.post("/chat/downloaddocument", request);
+  async downloadDocument(request, options) {
+    return this.post(
+      "/chat/downloaddocument",
+      request,
+      options
+    );
+  }
+  /**
+   * Delete a message
+   */
+  async deleteMessage(request, options) {
+    return this.post("/chat/delete", request, options);
+  }
+  /**
+   * Send interactive buttons message
+   */
+  async sendButtons(request, options) {
+    return this.post(
+      "/chat/send/buttons",
+      request,
+      options
+    );
+  }
+  /**
+   * Send list message
+   */
+  async sendList(request, options) {
+    return this.post("/chat/send/list", request, options);
+  }
+  /**
+   * Send poll message
+   */
+  async sendPoll(request, options) {
+    return this.post("/chat/send/poll", request, options);
+  }
+  /**
+   * Edit a message
+   */
+  async editMessage(request, options) {
+    return this.post("/chat/send/edit", request, options);
   }
 }
 class GroupModule extends BaseClient {
   /**
    * List all subscribed groups
    */
-  async list() {
-    return this.get("/group/list");
+  async list(options) {
+    return this.get("/group/list", options);
   }
   /**
    * Get group invite link
    */
-  async getInviteLink(groupJID) {
+  async getInviteLink(groupJID, options) {
     const request = { GroupJID: groupJID };
-    return this.post("/group/invitelink", request);
+    return this.post(
+      "/group/invitelink",
+      request,
+      options
+    );
   }
   /**
    * Get group information
    */
-  async getInfo(groupJID) {
+  async getInfo(groupJID, options) {
     const request = { GroupJID: groupJID };
-    return this.post("/group/info", request);
+    return this.post("/group/info", request, options);
   }
   /**
    * Change group photo (JPEG only)
    */
-  async setPhoto(groupJID, image) {
+  async setPhoto(groupJID, image, options) {
     const request = { GroupJID: groupJID, Image: image };
-    return this.post("/group/photo", request);
+    return this.post("/group/photo", request, options);
   }
   /**
    * Change group name
    */
-  async setName(groupJID, name) {
+  async setName(groupJID, name, options) {
     const request = { GroupJID: groupJID, Name: name };
-    return this.post("/group/name", request);
+    return this.post("/group/name", request, options);
   }
   /**
    * Create a new group
    */
-  async create(name, participants) {
+  async create(name, participants, options) {
     const request = { name, participants };
-    return this.post("/group/create", request);
+    return this.post("/group/create", request, options);
   }
   /**
    * Set group locked status
    */
-  async setLocked(groupJID, locked) {
+  async setLocked(groupJID, locked, options) {
     const request = { groupjid: groupJID, locked };
-    return this.post("/group/locked", request);
+    return this.post("/group/locked", request, options);
   }
   /**
    * Set disappearing messages timer
    */
-  async setEphemeral(groupJID, duration) {
+  async setEphemeral(groupJID, duration, options) {
     const request = { groupjid: groupJID, duration };
-    return this.post("/group/ephemeral", request);
+    return this.post(
+      "/group/ephemeral",
+      request,
+      options
+    );
   }
   /**
    * Remove group photo
    */
-  async removePhoto(groupJID) {
+  async removePhoto(groupJID, options) {
     const request = { groupjid: groupJID };
-    return this.post("/group/photo/remove", request);
+    return this.post(
+      "/group/photo/remove",
+      request,
+      options
+    );
+  }
+  /**
+   * Leave a group
+   */
+  async leave(groupJID, options) {
+    const request = { GroupJID: groupJID };
+    return this.post("/group/leave", request, options);
+  }
+  /**
+   * Set group topic/description
+   */
+  async setTopic(groupJID, topic, options) {
+    const request = { GroupJID: groupJID, Topic: topic };
+    return this.post("/group/topic", request, options);
+  }
+  /**
+   * Set group announcement setting (only admins can send messages)
+   */
+  async setAnnounce(groupJID, announce, options) {
+    const request = {
+      GroupJID: groupJID,
+      Announce: announce
+    };
+    return this.post(
+      "/group/announce",
+      request,
+      options
+    );
+  }
+  /**
+   * Join a group using invite link
+   */
+  async join(inviteLink, options) {
+    const request = { InviteLink: inviteLink };
+    return this.post("/group/join", request, options);
+  }
+  /**
+   * Get group invite information
+   */
+  async getInviteInfo(inviteLink, options) {
+    const request = { InviteLink: inviteLink };
+    return this.post(
+      "/group/inviteinfo",
+      request,
+      options
+    );
+  }
+  /**
+   * Update group participants (add/remove/promote/demote)
+   */
+  async updateParticipants(groupJID, action, participants, options) {
+    const request = {
+      GroupJID: groupJID,
+      Action: action,
+      Participants: participants
+    };
+    return this.post(
+      "/group/updateparticipants",
+      request,
+      options
+    );
   }
 }
 class WebhookModule extends BaseClient {
   /**
    * Set webhook URL and events to subscribe to
    */
-  async setWebhook(webhookURL) {
+  async setWebhook(webhookURL, options) {
     const request = { webhookURL };
-    return this.post("/webhook", request);
+    return this.post("/webhook", request, options);
   }
   /**
    * Get current webhook configuration
    */
-  async getWebhook() {
-    return this.get("/webhook");
+  async getWebhook(options) {
+    return this.get("/webhook", options);
+  }
+  /**
+   * Update webhook URL
+   */
+  async updateWebhook(webhookURL, options) {
+    const request = { webhookURL };
+    return this.put("/webhook", request, options);
+  }
+  /**
+   * Delete webhook configuration
+   */
+  async deleteWebhook(options) {
+    return this.delete("/webhook", options);
+  }
+}
+class NewsletterModule extends BaseClient {
+  /**
+   * List all subscribed newsletters
+   */
+  async list(options) {
+    return this.get("/newsletter/list", options);
   }
 }
 class WuzapiClient {
@@ -353,6 +579,7 @@ class WuzapiClient {
   chat;
   group;
   webhook;
+  newsletter;
   // Legacy aliases for convenience
   users;
   message;
@@ -363,15 +590,16 @@ class WuzapiClient {
     this.chat = new ChatModule(config);
     this.group = new GroupModule(config);
     this.webhook = new WebhookModule(config);
+    this.newsletter = new NewsletterModule(config);
     this.users = this.user;
     this.message = this.chat;
   }
   /**
    * Test connection to the API
    */
-  async ping() {
+  async ping(options) {
     try {
-      await this.session.getStatus();
+      await this.session.getStatus(options);
       return true;
     } catch {
       return false;
@@ -762,6 +990,7 @@ export {
   ListResponseMessageListType,
   MediaType,
   MessageStatus,
+  NewsletterModule,
   PaymentBackgroundType,
   PeerDataOperationRequestResponseMessagePeerDataOperationResult,
   PeerDataOperationRequestType,