wuzapi 1.0.1 → 1.2.0

package/dist/modules/chat.d.ts

@@ -0,0 +1,68 @@
+import { BaseClient } from '../client.js';
+import { SendMessageResponse, SendTextRequest, SendTemplateRequest, SendAudioRequest, SendImageRequest, SendDocumentRequest, SendVideoRequest, SendStickerRequest, SendLocationRequest, SendContactRequest, ChatPresenceRequest, MarkReadRequest, ReactRequest, DownloadMediaRequest, DownloadMediaResponse } from '../types/chat.js';
+export declare class ChatModule extends BaseClient {
+    /**
+     * Send a text message
+     */
+    sendText(request: SendTextRequest): Promise<SendMessageResponse>;
+    /**
+     * Send a template message with buttons
+     */
+    sendTemplate(request: SendTemplateRequest): Promise<SendMessageResponse>;
+    /**
+     * Send an audio message
+     */
+    sendAudio(request: SendAudioRequest): Promise<SendMessageResponse>;
+    /**
+     * Send an image message
+     */
+    sendImage(request: SendImageRequest): Promise<SendMessageResponse>;
+    /**
+     * Send a document message
+     */
+    sendDocument(request: SendDocumentRequest): Promise<SendMessageResponse>;
+    /**
+     * Send a video message
+     */
+    sendVideo(request: SendVideoRequest): Promise<SendMessageResponse>;
+    /**
+     * Send a sticker message
+     */
+    sendSticker(request: SendStickerRequest): Promise<SendMessageResponse>;
+    /**
+     * Send a location message
+     */
+    sendLocation(request: SendLocationRequest): Promise<SendMessageResponse>;
+    /**
+     * Send a contact message
+     */
+    sendContact(request: SendContactRequest): Promise<SendMessageResponse>;
+    /**
+     * Send chat presence indication (typing indicator)
+     */
+    sendPresence(request: ChatPresenceRequest): Promise<void>;
+    /**
+     * Mark messages as read
+     */
+    markRead(request: MarkReadRequest): Promise<void>;
+    /**
+     * React to a message
+     */
+    react(request: ReactRequest): Promise<SendMessageResponse>;
+    /**
+     * Download an image from a message
+     */
+    downloadImage(request: DownloadMediaRequest): Promise<DownloadMediaResponse>;
+    /**
+     * Download a video from a message
+     */
+    downloadVideo(request: DownloadMediaRequest): Promise<DownloadMediaResponse>;
+    /**
+     * Download an audio from a message
+     */
+    downloadAudio(request: DownloadMediaRequest): Promise<DownloadMediaResponse>;
+    /**
+     * Download a document from a message
+     */
+    downloadDocument(request: DownloadMediaRequest): Promise<DownloadMediaResponse>;
+}

package/dist/modules/group.d.ts

@@ -0,0 +1,40 @@
+import { BaseClient } from '../client.js';
+import { GroupListResponse, GroupInviteLinkResponse, GroupInfo, GroupPhotoResponse, GroupNameResponse, GroupCreateResponse, GroupLockedResponse, GroupEphemeralResponse, GroupPhotoRemoveResponse } from '../types/group.js';
+export declare class GroupModule extends BaseClient {
+    /**
+     * List all subscribed groups
+     */
+    list(): Promise<GroupListResponse>;
+    /**
+     * Get group invite link
+     */
+    getInviteLink(groupJID: string): Promise<GroupInviteLinkResponse>;
+    /**
+     * Get group information
+     */
+    getInfo(groupJID: string): Promise<GroupInfo>;
+    /**
+     * Change group photo (JPEG only)
+     */
+    setPhoto(groupJID: string, image: string): Promise<GroupPhotoResponse>;
+    /**
+     * Change group name
+     */
+    setName(groupJID: string, name: string): Promise<GroupNameResponse>;
+    /**
+     * Create a new group
+     */
+    create(name: string, participants: string[]): Promise<GroupCreateResponse>;
+    /**
+     * Set group locked status
+     */
+    setLocked(groupJID: string, locked: boolean): Promise<GroupLockedResponse>;
+    /**
+     * Set disappearing messages timer
+     */
+    setEphemeral(groupJID: string, duration: "24h" | "7d" | "90d" | "off"): Promise<GroupEphemeralResponse>;
+    /**
+     * Remove group photo
+     */
+    removePhoto(groupJID: string): Promise<GroupPhotoRemoveResponse>;
+}

package/dist/modules/session.d.ts

@@ -0,0 +1,43 @@
+import { BaseClient } from '../client.js';
+import { ConnectRequest, ConnectResponse, DisconnectResponse, LogoutResponse, StatusResponse, QRCodeResponse, S3ConfigResponse, S3TestResponse } from '../types/session.js';
+import { S3Config } from '../types/common.js';
+export declare class SessionModule extends BaseClient {
+    /**
+     * Connect to WhatsApp servers
+     */
+    connect(options: ConnectRequest): Promise<ConnectResponse>;
+    /**
+     * Disconnect from WhatsApp servers
+     */
+    disconnect(): Promise<DisconnectResponse>;
+    /**
+     * Logout and finish the session
+     */
+    logout(): Promise<LogoutResponse>;
+    /**
+     * Get session status
+     */
+    getStatus(): Promise<StatusResponse>;
+    /**
+     * Get QR code for scanning
+     */
+    getQRCode(): Promise<QRCodeResponse>;
+    /**
+     * Configure S3 storage
+     */
+    configureS3(config: S3Config): Promise<S3ConfigResponse>;
+    /**
+     * Get S3 configuration
+     */
+    getS3Config(): Promise<S3ConfigResponse>;
+    /**
+     * Test S3 connection
+     */
+    testS3(): Promise<S3TestResponse>;
+    /**
+     * Delete S3 configuration
+     */
+    deleteS3Config(): Promise<{
+        Details: string;
+    }>;
+}

package/dist/modules/user.d.ts

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

package/dist/modules/webhook.d.ts

@@ -0,0 +1,12 @@
+import { BaseClient } from '../client.js';
+import { SetWebhookResponse, GetWebhookResponse } from '../types/webhook.js';
+export declare class WebhookModule extends BaseClient {
+    /**
+     * Set webhook URL and events to subscribe to
+     */
+    setWebhook(webhookURL: string): Promise<SetWebhookResponse>;
+    /**
+     * Get current webhook configuration
+     */
+    getWebhook(): Promise<GetWebhookResponse>;
+}

package/dist/types/admin.d.ts

@@ -0,0 +1,27 @@
+import { ProxyConfig, S3Config } from './common.js';
+export interface User {
+    id: number;
+    name: string;
+    token: string;
+    webhook: string;
+    jid: string;
+    qrcode: string;
+    connected: boolean;
+    expiration: number;
+    events: string;
+}
+export interface CreateUserRequest {
+    name: string;
+    token: string;
+    webhook?: string;
+    events: string;
+    expiration?: number;
+    proxyConfig?: ProxyConfig;
+    s3Config?: S3Config;
+}
+export interface CreateUserResponse {
+    id: number;
+}
+export interface DeleteUserResponse {
+    Details: string;
+}

package/dist/types/chat.d.ts

@@ -0,0 +1,94 @@
+import { SimpleContextInfo } from './common.js';
+export interface SendMessageResponse {
+    Details: string;
+    Id: string;
+    Timestamp: string;
+}
+export interface SendTextRequest {
+    Phone: string;
+    Body: string;
+    Id?: string;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface TemplateButton {
+    DisplayText: string;
+    Type: "quickreply" | "url" | "call";
+    Url?: string;
+    PhoneNumber?: string;
+}
+export interface SendTemplateRequest {
+    Phone: string;
+    Content: string;
+    Footer?: string;
+    Buttons: TemplateButton[];
+    ContextInfo?: SimpleContextInfo;
+}
+export interface SendAudioRequest {
+    Phone: string;
+    Audio: string;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface SendImageRequest {
+    Phone: string;
+    Image: string;
+    Caption?: string;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface SendDocumentRequest {
+    Phone: string;
+    Document: string;
+    FileName: string;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface SendVideoRequest {
+    Phone: string;
+    Video: string;
+    Caption?: string;
+    JpegThumbnail?: string;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface SendStickerRequest {
+    Phone: string;
+    Sticker: string;
+    PngThumbnail?: string;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface SendLocationRequest {
+    Phone: string;
+    Latitude: number;
+    Longitude: number;
+    Name?: string;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface SendContactRequest {
+    Phone: string;
+    Name: string;
+    Vcard: string;
+    ContextInfo?: SimpleContextInfo;
+}
+export interface ChatPresenceRequest {
+    Phone: string;
+    State: "composing" | "paused";
+    Media?: string;
+}
+export interface MarkReadRequest {
+    Id: string[];
+    Chat: string;
+    Sender?: string;
+}
+export interface ReactRequest {
+    Phone: string;
+    Body: string;
+    Id: string;
+}
+export interface DownloadMediaRequest {
+    Url: string;
+    MediaKey: string;
+    Mimetype: string;
+    FileSHA256: string;
+    FileLength: number;
+    FileEncSHA256?: string;
+}
+export interface DownloadMediaResponse {
+    [key: string]: unknown;
+}

package/dist/types/common.d.ts

@@ -0,0 +1,29 @@
+export interface WuzapiConfig {
+    apiUrl: string;
+    token: string;
+}
+export interface WuzapiResponse<T = unknown> {
+    code: number;
+    data: T;
+    success: boolean;
+}
+export interface SimpleContextInfo {
+    StanzaId: string;
+    Participant: string;
+}
+export interface ProxyConfig {
+    enabled: boolean;
+    proxyURL: string;
+}
+export interface S3Config {
+    enabled: boolean;
+    endpoint: string;
+    region: string;
+    bucket: string;
+    accessKey: string;
+    secretKey: string;
+    pathStyle: boolean;
+    publicURL?: string;
+    mediaDelivery: "base64" | "s3" | "both";
+    retentionDays: number;
+}