wuzapi 1.3.1 → 1.5.0

package/dist/modules/group.d.ts

@@ -1,40 +1,65 @@
 import { BaseClient } from '../client.js';
-import { GroupListResponse, GroupInviteLinkResponse, GroupInfo, GroupPhotoResponse, GroupNameResponse, GroupCreateResponse, GroupLockedResponse, GroupEphemeralResponse, GroupPhotoRemoveResponse } from '../types/group.js';
+import { RequestOptions } from '../types/common.js';
+import { GroupListResponse, GroupInviteLinkResponse, GroupInfo, GroupPhotoResponse, GroupNameResponse, GroupCreateResponse, GroupLockedResponse, GroupEphemeralResponse, GroupPhotoRemoveResponse, GroupLeaveResponse, GroupTopicResponse, GroupAnnounceResponse, GroupJoinResponse, GroupInviteInfoResponse, GroupUpdateParticipantsResponse } from '../types/group.js';
 export declare class GroupModule extends BaseClient {
     /**
      * List all subscribed groups
      */
-    list(): Promise<GroupListResponse>;
+    list(options?: RequestOptions): Promise<GroupListResponse>;
     /**
      * Get group invite link
      */
-    getInviteLink(groupJID: string): Promise<GroupInviteLinkResponse>;
+    getInviteLink(groupJID: string, options?: RequestOptions): Promise<GroupInviteLinkResponse>;
     /**
      * Get group information
      */
-    getInfo(groupJID: string): Promise<GroupInfo>;
+    getInfo(groupJID: string, options?: RequestOptions): Promise<GroupInfo>;
     /**
      * Change group photo (JPEG only)
      */
-    setPhoto(groupJID: string, image: string): Promise<GroupPhotoResponse>;
+    setPhoto(groupJID: string, image: string, options?: RequestOptions): Promise<GroupPhotoResponse>;
     /**
      * Change group name
      */
-    setName(groupJID: string, name: string): Promise<GroupNameResponse>;
+    setName(groupJID: string, name: string, options?: RequestOptions): Promise<GroupNameResponse>;
     /**
      * Create a new group
      */
-    create(name: string, participants: string[]): Promise<GroupCreateResponse>;
+    create(name: string, participants: string[], options?: RequestOptions): Promise<GroupCreateResponse>;
     /**
      * Set group locked status
      */
-    setLocked(groupJID: string, locked: boolean): Promise<GroupLockedResponse>;
+    setLocked(groupJID: string, locked: boolean, options?: RequestOptions): Promise<GroupLockedResponse>;
     /**
      * Set disappearing messages timer
      */
-    setEphemeral(groupJID: string, duration: "24h" | "7d" | "90d" | "off"): Promise<GroupEphemeralResponse>;
+    setEphemeral(groupJID: string, duration: "24h" | "7d" | "90d" | "off", options?: RequestOptions): Promise<GroupEphemeralResponse>;
     /**
      * Remove group photo
      */
-    removePhoto(groupJID: string): Promise<GroupPhotoRemoveResponse>;
+    removePhoto(groupJID: string, options?: RequestOptions): Promise<GroupPhotoRemoveResponse>;
+    /**
+     * Leave a group
+     */
+    leave(groupJID: string, options?: RequestOptions): Promise<GroupLeaveResponse>;
+    /**
+     * Set group topic/description
+     */
+    setTopic(groupJID: string, topic: string, options?: RequestOptions): Promise<GroupTopicResponse>;
+    /**
+     * Set group announcement setting (only admins can send messages)
+     */
+    setAnnounce(groupJID: string, announce: boolean, options?: RequestOptions): Promise<GroupAnnounceResponse>;
+    /**
+     * Join a group using invite link
+     */
+    join(inviteLink: string, options?: RequestOptions): Promise<GroupJoinResponse>;
+    /**
+     * Get group invite information
+     */
+    getInviteInfo(inviteLink: string, options?: RequestOptions): Promise<GroupInviteInfoResponse>;
+    /**
+     * Update group participants (add/remove/promote/demote)
+     */
+    updateParticipants(groupJID: string, action: "add" | "remove" | "promote" | "demote", participants: string[], options?: RequestOptions): Promise<GroupUpdateParticipantsResponse>;
 }

package/dist/modules/newsletter.d.ts

@@ -0,0 +1,9 @@
+import { BaseClient } from '../client.js';
+import { RequestOptions } from '../types/common.js';
+import { NewsletterListResponse } from '../types/newsletter.js';
+export declare class NewsletterModule extends BaseClient {
+    /**
+     * List all subscribed newsletters
+     */
+    list(options?: RequestOptions): Promise<NewsletterListResponse>;
+}

package/dist/modules/session.d.ts

@@ -1,43 +1,55 @@
 import { BaseClient } from '../client.js';
-import { ConnectRequest, ConnectResponse, DisconnectResponse, LogoutResponse, StatusResponse, QRCodeResponse, S3ConfigResponse, S3TestResponse } from '../types/session.js';
-import { S3Config } from '../types/common.js';
+import { ConnectRequest, ConnectResponse, DisconnectResponse, LogoutResponse, StatusResponse, QRCodeResponse, S3ConfigResponse, S3TestResponse, PairPhoneResponse, HistoryResponse, ProxyResponse } from '../types/session.js';
+import { S3Config, RequestOptions } from '../types/common.js';
 export declare class SessionModule extends BaseClient {
     /**
      * Connect to WhatsApp servers
      */
-    connect(options: ConnectRequest): Promise<ConnectResponse>;
+    connect(request: ConnectRequest, options?: RequestOptions): Promise<ConnectResponse>;
     /**
      * Disconnect from WhatsApp servers
      */
-    disconnect(): Promise<DisconnectResponse>;
+    disconnect(options?: RequestOptions): Promise<DisconnectResponse>;
     /**
      * Logout and finish the session
      */
-    logout(): Promise<LogoutResponse>;
+    logout(options?: RequestOptions): Promise<LogoutResponse>;
     /**
      * Get session status
      */
-    getStatus(): Promise<StatusResponse>;
+    getStatus(options?: RequestOptions): Promise<StatusResponse>;
     /**
      * Get QR code for scanning
      */
-    getQRCode(): Promise<QRCodeResponse>;
+    getQRCode(options?: RequestOptions): Promise<QRCodeResponse>;
     /**
      * Configure S3 storage
      */
-    configureS3(config: S3Config): Promise<S3ConfigResponse>;
+    configureS3(config: S3Config, options?: RequestOptions): Promise<S3ConfigResponse>;
     /**
      * Get S3 configuration
      */
-    getS3Config(): Promise<S3ConfigResponse>;
+    getS3Config(options?: RequestOptions): Promise<S3ConfigResponse>;
     /**
      * Test S3 connection
      */
-    testS3(): Promise<S3TestResponse>;
+    testS3(options?: RequestOptions): Promise<S3TestResponse>;
     /**
      * Delete S3 configuration
      */
-    deleteS3Config(): Promise<{
+    deleteS3Config(options?: RequestOptions): Promise<{
         Details: string;
     }>;
+    /**
+     * Pair phone using verification code
+     */
+    pairPhone(phone: string, code: string, options?: RequestOptions): Promise<PairPhoneResponse>;
+    /**
+     * Request history sync from WhatsApp servers
+     */
+    requestHistory(options?: RequestOptions): Promise<HistoryResponse>;
+    /**
+     * Set proxy configuration
+     */
+    setProxy(proxy: string, options?: RequestOptions): Promise<ProxyResponse>;
 }

package/dist/modules/user.d.ts

@@ -1,20 +1,25 @@
 import { BaseClient } from '../client.js';
-import { UserInfoResponse, UserCheckResponse, UserAvatarResponse, ContactsResponse } from '../types/user.js';
+import { RequestOptions } from '../types/common.js';
+import { UserInfoResponse, UserCheckResponse, UserAvatarResponse, ContactsResponse, UserPresenceRequest } from '../types/user.js';
 export declare class UserModule extends BaseClient {
     /**
      * Get user details for specified phone numbers
      */
-    getInfo(phones: string[]): Promise<UserInfoResponse>;
+    getInfo(phones: string[], options?: RequestOptions): Promise<UserInfoResponse>;
     /**
      * Check if phone numbers are registered WhatsApp users
      */
-    check(phones: string[]): Promise<UserCheckResponse>;
+    check(phones: string[], options?: RequestOptions): Promise<UserCheckResponse>;
     /**
      * Get user avatar/profile picture
      */
-    getAvatar(phone: string, preview?: boolean): Promise<UserAvatarResponse>;
+    getAvatar(phone: string, preview?: boolean, options?: RequestOptions): Promise<UserAvatarResponse>;
     /**
      * Get all contacts
      */
-    getContacts(): Promise<ContactsResponse>;
+    getContacts(options?: RequestOptions): Promise<ContactsResponse>;
+    /**
+     * Send user presence (available/unavailable status)
+     */
+    sendPresence(request: UserPresenceRequest, options?: RequestOptions): Promise<void>;
 }

package/dist/modules/webhook.d.ts

@@ -1,12 +1,21 @@
 import { BaseClient } from '../client.js';
-import { SetWebhookResponse, GetWebhookResponse } from '../types/webhook.js';
+import { RequestOptions } from '../types/common.js';
+import { SetWebhookResponse, GetWebhookResponse, UpdateWebhookResponse, DeleteWebhookResponse } from '../types/webhook.js';
 export declare class WebhookModule extends BaseClient {
     /**
      * Set webhook URL and events to subscribe to
      */
-    setWebhook(webhookURL: string): Promise<SetWebhookResponse>;
+    setWebhook(webhookURL: string, options?: RequestOptions): Promise<SetWebhookResponse>;
     /**
      * Get current webhook configuration
      */
-    getWebhook(): Promise<GetWebhookResponse>;
+    getWebhook(options?: RequestOptions): Promise<GetWebhookResponse>;
+    /**
+     * Update webhook URL
+     */
+    updateWebhook(webhookURL: string, options?: RequestOptions): Promise<UpdateWebhookResponse>;
+    /**
+     * Delete webhook configuration
+     */
+    deleteWebhook(options?: RequestOptions): Promise<DeleteWebhookResponse>;
 }

package/dist/types/chat.d.ts

@@ -92,3 +92,58 @@ export interface DownloadMediaRequest {
 export interface DownloadMediaResponse {
     [key: string]: unknown;
 }
+export interface DeleteMessageRequest {
+    Phone: string;
+    Id: string;
+    Remote?: boolean;
+}
+export interface DeleteMessageResponse {
+    Details: string;
+}
+export interface ChatButton {
+    ButtonId: string;
+    ButtonText: {
+        DisplayText: string;
+    };
+    Type: number;
+}
+export interface SendButtonsRequest {
+    Phone: string;
+    Body: string;
+    Footer?: string;
+    Buttons: ChatButton[];
+    ContextInfo?: SimpleContextInfo;
+}
+export interface ListItem {
+    Title: string;
+    Description?: string;
+    RowId: string;
+}
+export interface ListSection {
+    Title: string;
+    Rows: ListItem[];
+}
+export interface SendListRequest {
+    Phone: string;
+    Body: string;
+    Footer?: string;
+    Title: string;
+    ButtonText: string;
+    Sections: ListSection[];
+    ContextInfo?: SimpleContextInfo;
+}
+export interface ChatPollOption {
+    Name: string;
+}
+export interface SendPollRequest {
+    Phone: string;
+    Name: string;
+    Options: ChatPollOption[];
+    SelectableCount?: number;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface EditMessageRequest {
+    Phone: string;
+    MessageId: string;
+    NewText: string;
+}

package/dist/types/common.d.ts

@@ -1,6 +1,9 @@
 export interface WuzapiConfig {
     apiUrl: string;
-    token: string;
+    token?: string;
+}
+export interface RequestOptions {
+    token?: string;
 }
 export interface WuzapiResponse<T = unknown> {
     code: number;

package/dist/types/group.d.ts

@@ -74,3 +74,55 @@ export interface GroupPhotoRemoveRequest {
 export interface GroupPhotoRemoveResponse {
     Details: string;
 }
+export interface GroupLeaveRequest {
+    GroupJID: string;
+}
+export interface GroupLeaveResponse {
+    Details: string;
+}
+export interface GroupTopicRequest {
+    GroupJID: string;
+    Topic: string;
+}
+export interface GroupTopicResponse {
+    Details: string;
+}
+export interface GroupAnnounceRequest {
+    GroupJID: string;
+    Announce: boolean;
+}
+export interface GroupAnnounceResponse {
+    Details: string;
+}
+export interface GroupJoinRequest {
+    InviteLink: string;
+}
+export interface GroupJoinResponse {
+    GroupJID: string;
+    Details: string;
+}
+export interface GroupInviteInfoRequest {
+    InviteLink: string;
+}
+export interface GroupInviteInfoResponse {
+    GroupJID: string;
+    Name: string;
+    Description: string;
+    Subject: string;
+    Owner: string;
+    Creation: string;
+    ParticipantsCount: number;
+}
+export interface GroupUpdateParticipantsRequest {
+    GroupJID: string;
+    Action: "add" | "remove" | "promote" | "demote";
+    Participants: string[];
+}
+export interface ParticipantUpdate {
+    JID: string;
+    Status: string;
+    Code: number;
+}
+export interface GroupUpdateParticipantsResponse {
+    Updates: ParticipantUpdate[];
+}

package/dist/types/index.d.ts

@@ -5,5 +5,6 @@ export * from './user.js';
 export * from './chat.js';
 export * from './group.js';
 export * from './webhook.js';
+export * from './newsletter.js';
 export * from './message.js';
 export * from './events.js';

package/dist/types/newsletter.d.ts

@@ -0,0 +1,17 @@
+export interface Newsletter {
+    ID: string;
+    Name: string;
+    Description: string;
+    ThreadJID: string;
+    InviteCode: string;
+    CreationTime: number;
+    Handle: string;
+    State: string;
+    ViewerMetadata: {
+        View: string;
+        Mute: string;
+    };
+}
+export interface NewsletterListResponse {
+    Newsletters: Newsletter[];
+}

package/dist/types/session.d.ts

@@ -30,3 +30,19 @@ export interface S3TestResponse {
     Bucket: string;
     Region: string;
 }
+export interface PairPhoneRequest {
+    Phone: string;
+    Code: string;
+}
+export interface PairPhoneResponse {
+    Details: string;
+}
+export interface HistoryResponse {
+    Details: string;
+}
+export interface ProxyRequest {
+    Proxy: string;
+}
+export interface ProxyResponse {
+    Details: string;
+}

package/dist/types/user.d.ts

@@ -53,3 +53,8 @@ export interface Contact {
 export interface ContactsResponse {
     [jid: string]: Contact;
 }
+export interface UserPresenceRequest {
+    Phone: string;
+    State: "available" | "unavailable";
+    LastSeen?: number;
+}

package/dist/types/webhook.d.ts

@@ -8,6 +8,15 @@ export interface GetWebhookResponse {
     subscribe: string[];
     webhook: string;
 }
+export interface UpdateWebhookRequest {
+    webhookURL: string;
+}
+export interface UpdateWebhookResponse {
+    webhook: string;
+}
+export interface DeleteWebhookResponse {
+    Details: string;
+}
 export interface S3MediaInfo {
     url: string;
     key: string;

package/dist/wuzapi-client.d.ts

@@ -1,10 +1,11 @@
-import { WuzapiConfig } from './types/common.js';
+import { WuzapiConfig, RequestOptions } from './types/common.js';
 import { AdminModule } from './modules/admin.js';
 import { SessionModule } from './modules/session.js';
 import { UserModule } from './modules/user.js';
 import { ChatModule } from './modules/chat.js';
 import { GroupModule } from './modules/group.js';
 import { WebhookModule } from './modules/webhook.js';
+import { NewsletterModule } from './modules/newsletter.js';
 export declare class WuzapiClient {
     readonly admin: AdminModule;
     readonly session: SessionModule;
@@ -12,11 +13,12 @@ export declare class WuzapiClient {
     readonly chat: ChatModule;
     readonly group: GroupModule;
     readonly webhook: WebhookModule;
+    readonly newsletter: NewsletterModule;
     readonly users: UserModule;
     readonly message: ChatModule;
     constructor(config: WuzapiConfig);
     /**
      * Test connection to the API
      */
-    ping(): Promise<boolean>;
+    ping(options?: RequestOptions): Promise<boolean>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wuzapi",
-  "version": "1.3.1",
+  "version": "1.5.0",
   "description": "TypeScript client library for WuzAPI WhatsApp API",
   "type": "module",
   "main": "./dist/index.js",