zaileys 4.2.1 → 4.4.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { WAMessage, WAMessageKey, AnyMessageContent, MiscMessageGenerationOptions, Chat, Contact, PresenceData, WAPrivacyValue, WAPrivacyOnlineValue, WAReadReceiptsValue, WAPrivacyGroupAddValue, GroupMetadata, ParticipantAction, NewsletterMetadata, WAMediaUpload, AuthenticationCreds, SignalDataTypeMap, SignalDataSet, WASocket, UserFacingSocketConfig, SignalKeyStore, MessageUpsertType } from 'baileys';
-export { GroupMetadata, GroupParticipant, NewsletterMetadata, ParticipantAction, WAMediaUpload, WAPrivacyGroupAddValue, WAPrivacyOnlineValue, WAPrivacyValue, WAReadReceiptsValue } from 'baileys';
+import { WAMessage, WAMessageKey, AnyMessageContent, MiscMessageGenerationOptions, Chat, Contact, PresenceData, WAPrivacyValue, WAPrivacyOnlineValue, WAReadReceiptsValue, WAPrivacyGroupAddValue, GroupMetadata, ParticipantAction, WAMediaUpload, ChatModification, NewsletterMetadata, AuthenticationCreds, SignalDataTypeMap, SignalDataSet, WASocket, UserFacingSocketConfig, SignalKeyStore, MessageUpsertType } from 'baileys';
+export { GroupMetadata, GroupParticipant, NewsletterMetadata, ParticipantAction, WAMediaUpload, WAPrivacyGroupAddValue, WAPrivacyOnlineValue, WAPrivacyValue, WAReadReceiptsValue, areJidsSameUser, getDevice, isJidBroadcast, isJidGroup, isJidNewsletter, isLidUser, isPnUser, jidDecode, jidEncode, jidNormalizedUser } from 'baileys';
 import { Readable } from 'node:stream';
 import { Pool } from 'pg';
 import { RedisClientType } from 'redis';
@@ -15,6 +15,11 @@ type VideoOptions = {
     caption?: string;
     gifPlayback?: boolean;
     viewOnce?: boolean;
+    /** Send as a round video note (PTV). */
+    ptv?: boolean;
+};
+type VideoNoteOptions = {
+    viewOnce?: boolean;
 };
 type AudioOptions = {
     ptt?: boolean;
@@ -118,6 +123,44 @@ type TemplateOptions = {
     footer?: string;
     buttons: ButtonDef[];
 };
+type EventOptions = {
+    name: string;
+    description?: string;
+    startAt: Date | number;
+    endAt?: Date | number;
+    location?: {
+        latitude: number;
+        longitude: number;
+        name?: string;
+        address?: string;
+    };
+    call?: 'audio' | 'video';
+    canceled?: boolean;
+};
+type ProductOptions = {
+    image: MediaSource;
+    title: string;
+    businessOwnerId: string;
+    description?: string;
+    /** Price in currency units (e.g. 50 = 50.00); mapped to priceAmount1000. */
+    price?: number;
+    currency?: string;
+    productId?: string;
+    retailerId?: string;
+    url?: string;
+    body?: string;
+    footer?: string;
+};
+type GroupInviteOptions = {
+    jid: string;
+    code: string;
+    subject?: string;
+    caption?: string;
+    /** Unix seconds when the invite expires. Defaults to ~3 days from now. WhatsApp reads this as seconds. */
+    expiresAt?: number;
+    /** Optional JPEG thumbnail (group avatar) — improves how the card renders. */
+    thumbnail?: Buffer;
+};
 type BuilderContext = {
     recipient: string;
     quoted?: WAMessage | WAMessageKey;
@@ -199,6 +242,7 @@ declare class MessageBuilder<State extends BuilderState> {
     to(this: MessageBuilder<'init'>, recipient: string): MessageBuilder<'init'>;
     text(this: MessageBuilder<'init'>, content: string, opts?: TextOptions): MessageBuilder<'content-set'>;
     image(this: MessageBuilder<'init'>, src: MediaSource, opts?: ImageOptions): MessageBuilder<'content-set'>;
+    videoNote(this: MessageBuilder<'init'>, src: MediaSource, opts?: VideoNoteOptions): MessageBuilder<'content-set'>;
     video(this: MessageBuilder<'init'>, src: MediaSource, opts?: VideoOptions): MessageBuilder<'content-set'>;
     audio(this: MessageBuilder<'init'>, src: MediaSource, opts?: AudioOptions): MessageBuilder<'content-set'>;
     document(this: MessageBuilder<'init'>, src: MediaSource, opts: DocumentOptions): MessageBuilder<'content-set'>;
@@ -212,6 +256,12 @@ declare class MessageBuilder<State extends BuilderState> {
     location(this: MessageBuilder<'init'>, lat: number, lon: number, opts?: LocationOptions): MessageBuilder<'content-set'>;
     contact(this: MessageBuilder<'init'>, vcard: string): MessageBuilder<'content-set'>;
     template(this: MessageBuilder<'init'>, opts: TemplateOptions): MessageBuilder<'content-set'>;
+    event(this: MessageBuilder<'init'>, opts: EventOptions): MessageBuilder<'content-set'>;
+    groupInvite(this: MessageBuilder<'init'>, opts: GroupInviteOptions): MessageBuilder<'content-set'>;
+    product(this: MessageBuilder<'init'>, opts: ProductOptions): MessageBuilder<'content-set'>;
+    requestPhoneNumber(this: MessageBuilder<'init'>): MessageBuilder<'content-set'>;
+    sharePhoneNumber(this: MessageBuilder<'init'>): MessageBuilder<'content-set'>;
+    limitSharing(this: MessageBuilder<'init'>, enabled?: boolean): MessageBuilder<'content-set'>;
     album(this: MessageBuilder<'init'>, items: AlbumItem[]): MessageBuilder<'content-set'>;
     reply(quoted: WAMessage | WAMessageKey): MessageBuilder<State>;
     mentions(jids: string[]): MessageBuilder<State>;
@@ -276,9 +326,14 @@ interface MessageStore {
 type DeleteOptions = {
     forEveryone?: boolean;
 };
+type PinOptions = {
+    /** Pin duration in seconds (WhatsApp offers 86400 / 604800 / 2592000). Defaults to 24h. */
+    duration?: number;
+};
 declare const deleteMessage: (socket: BuilderSocketLike, key: WAMessageKey, opts?: DeleteOptions) => Promise<void>;
 declare const reactToMessage: (socket: BuilderSocketLike, key: WAMessageKey, emoji: string) => Promise<WAMessageKey>;
 declare const forwardMessage: (socket: BuilderSocketLike, store: Pick<MessageStore, "getMessage">, key: WAMessageKey, to: string) => Promise<WAMessageKey>;
+declare const pinMessage: (socket: BuilderSocketLike, key: WAMessageKey, pin: boolean, opts?: PinOptions) => Promise<WAMessageKey>;
 
 interface UsernameResolveSocketLike {
     onWhatsApp(...phoneNumber: string[]): Promise<Array<{
@@ -359,6 +414,43 @@ interface DomainSocketLike {
     groupToggleEphemeral(jid: string, ephemeralExpiration: number): Promise<void>;
     groupSettingUpdate(jid: string, setting: 'announcement' | 'not_announcement' | 'locked' | 'unlocked'): Promise<void>;
     updateMemberLabel(jid: string, memberLabel: string): Promise<unknown>;
+    groupFetchAllParticipating(): Promise<{
+        [jid: string]: GroupMetadata;
+    }>;
+    groupGetInviteInfo(code: string): Promise<GroupMetadata>;
+    groupRequestParticipantsList(jid: string): Promise<Array<{
+        [k: string]: string;
+    }>>;
+    groupRequestParticipantsUpdate(jid: string, participants: string[], action: 'approve' | 'reject'): Promise<{
+        status: string;
+        jid: string;
+    }[]>;
+    groupJoinApprovalMode(jid: string, mode: 'on' | 'off'): Promise<void>;
+    groupMemberAddMode(jid: string, mode: 'admin_add' | 'all_member_add'): Promise<void>;
+    onWhatsApp(...jids: string[]): Promise<Array<{
+        jid: string;
+        exists: boolean;
+        lid?: string;
+    }> | undefined>;
+    addOrEditContact(jid: string, contact: {
+        firstName?: string;
+        lastName?: string;
+        fullName?: string;
+    }): Promise<unknown>;
+    removeContact(jid: string): Promise<unknown>;
+    getBusinessProfile(jid: string): Promise<unknown>;
+    getCatalog(opts: {
+        jid?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<unknown>;
+    getCollections(jid?: string, limit?: number): Promise<unknown>;
+    getOrderDetails(orderId: string, tokenBase64: string): Promise<unknown>;
+    productCreate(create: Record<string, unknown>): Promise<unknown>;
+    productUpdate(productId: string, update: Record<string, unknown>): Promise<unknown>;
+    productDelete(productIds: string[]): Promise<{
+        deleted: number;
+    }>;
     updateLastSeenPrivacy(value: WAPrivacyValue): Promise<void>;
     updateOnlinePrivacy(value: WAPrivacyOnlineValue): Promise<void>;
     updateProfilePicturePrivacy(value: WAPrivacyValue): Promise<void>;
@@ -371,6 +463,13 @@ interface DomainSocketLike {
     }>;
     updateBlockStatus(jid: string, action: 'block' | 'unblock'): Promise<void>;
     fetchBlocklist(): Promise<string[]>;
+    updateProfileName(name: string): Promise<void>;
+    updateProfileStatus(status: string): Promise<void>;
+    updateProfilePicture(jid: string, content: WAMediaUpload): Promise<void>;
+    removeProfilePicture(jid: string): Promise<void>;
+    profilePictureUrl(jid: string, type?: 'image' | 'preview', timeoutMs?: number): Promise<string | undefined>;
+    fetchStatus(jid: string): Promise<unknown>;
+    chatModify(mod: ChatModification, jid: string): Promise<void>;
     newsletterCreate(name: string, description?: string): Promise<NewsletterMetadata>;
     newsletterFollow(jid: string): Promise<unknown>;
     newsletterUnfollow(jid: string): Promise<unknown>;
@@ -381,6 +480,13 @@ interface DomainSocketLike {
     newsletterMute(jid: string): Promise<unknown>;
     newsletterUnmute(jid: string): Promise<unknown>;
     newsletterDelete(jid: string): Promise<void>;
+    newsletterSubscribers(jid: string): Promise<unknown>;
+    newsletterRemovePicture(jid: string): Promise<unknown>;
+    newsletterReactMessage(jid: string, serverId: string, reaction?: string): Promise<void>;
+    newsletterFetchMessages(jid: string, count: number, since?: number, after?: number): Promise<unknown>;
+    newsletterAdminCount(jid: string): Promise<number>;
+    newsletterChangeOwner(jid: string, newOwnerJid: string): Promise<void>;
+    newsletterDemote(jid: string, userJid: string): Promise<void>;
     communityCreate(subject: string, body: string): Promise<GroupMetadata>;
     communityCreateGroup(subject: string, participants: string[], parentCommunityJid: string): Promise<GroupMetadata>;
     communityLinkGroup(groupJid: string, parentCommunityJid: string): Promise<void>;
@@ -396,6 +502,15 @@ interface DomainSocketLike {
     communityInviteCode(jid: string): Promise<string | undefined>;
     communityRevokeInvite(jid: string): Promise<string | undefined>;
     communityAcceptInvite(code: string): Promise<string | undefined>;
+    communityMetadata(jid: string): Promise<GroupMetadata>;
+    communityFetchAllParticipating(): Promise<{
+        [jid: string]: GroupMetadata;
+    }>;
+    communityGetInviteInfo(code: string): Promise<GroupMetadata>;
+    communityToggleEphemeral(jid: string, ephemeralExpiration: number): Promise<void>;
+    communitySettingUpdate(jid: string, setting: 'announcement' | 'not_announcement'): Promise<void>;
+    communityMemberAddMode(jid: string, mode: 'admin_add' | 'all_member_add'): Promise<void>;
+    communityJoinApprovalMode(jid: string, mode: 'on' | 'off'): Promise<void>;
 }
 
 declare class GroupModule {
@@ -420,6 +535,15 @@ declare class GroupModule {
     acceptInvite(code: string): Promise<string>;
     toggleEphemeral(groupId: string, seconds: number): Promise<void>;
     setting(groupId: string, setting: 'announcement' | 'not_announcement' | 'locked' | 'unlocked'): Promise<void>;
+    list(): Promise<GroupMetadata[]>;
+    inviteInfo(code: string): Promise<GroupMetadata>;
+    joinRequests(groupId: string): Promise<Array<{
+        [k: string]: string;
+    }>>;
+    approveJoin(groupId: string, jids: string[]): Promise<ParticipantUpdateResult[]>;
+    rejectJoin(groupId: string, jids: string[]): Promise<ParticipantUpdateResult[]>;
+    joinApproval(groupId: string, enabled: boolean): Promise<void>;
+    memberAddMode(groupId: string, adminsOnly: boolean): Promise<void>;
 }
 
 declare class PrivacyModule {
@@ -455,6 +579,18 @@ declare class NewsletterModule {
     mute(jid: string): Promise<void>;
     unmute(jid: string): Promise<void>;
     delete(jid: string): Promise<void>;
+    removePicture(jid: string): Promise<void>;
+    react(jid: string, serverId: string, emoji: string): Promise<void>;
+    /** Remove a reaction from a newsletter message. */
+    unreact(jid: string, serverId: string): Promise<void>;
+    subscribers(jid: string): Promise<unknown>;
+    messages(jid: string, count?: number, opts?: {
+        since?: number;
+        after?: number;
+    }): Promise<unknown>;
+    adminCount(jid: string): Promise<number>;
+    changeOwner(jid: string, newOwnerJid: string): Promise<void>;
+    demote(jid: string, userJid: string): Promise<void>;
 }
 
 declare class CommunityModule {
@@ -474,10 +610,97 @@ declare class CommunityModule {
     inviteCode(communityId: string): Promise<string | undefined>;
     revokeInvite(communityId: string): Promise<string | undefined>;
     acceptInvite(code: string): Promise<string | undefined>;
+    metadata(communityId: string): Promise<GroupMetadata>;
+    list(): Promise<GroupMetadata[]>;
+    inviteInfo(code: string): Promise<GroupMetadata>;
+    toggleEphemeral(communityId: string, seconds: number): Promise<void>;
+    setting(communityId: string, setting: 'announcement' | 'not_announcement'): Promise<void>;
+    memberAddMode(communityId: string, adminsOnly: boolean): Promise<void>;
+    joinApproval(communityId: string, enabled: boolean): Promise<void>;
+}
+
+declare class ProfileModule {
+    private readonly getSocket;
+    constructor(getSocket: () => DomainSocketLike | undefined);
+    protected requireSocket(): DomainSocketLike;
+    setName(name: string): Promise<void>;
+    setStatus(status: string): Promise<void>;
+    /** Set the profile/group picture. `jid` defaults to self; pass a group jid to set a group avatar. */
+    setPicture(jid: string, image: WAMediaUpload): Promise<void>;
+    removePicture(jid: string): Promise<void>;
+    getPicture(jid: string, hd?: boolean): Promise<string | null>;
+    getStatus(jid: string): Promise<unknown>;
+}
+
+type LastMessage = {
+    key: WAMessageKey;
+    messageTimestamp: number;
+};
+type LastMessageResolver = (jid: string) => Promise<LastMessage[]>;
+declare class ChatModule {
+    private readonly getSocket;
+    private readonly resolveLast?;
+    constructor(getSocket: () => DomainSocketLike | undefined, resolveLast?: LastMessageResolver | undefined);
+    protected requireSocket(): DomainSocketLike;
+    private last;
+    archive(jid: string): Promise<void>;
+    unarchive(jid: string): Promise<void>;
+    pin(jid: string): Promise<void>;
+    unpin(jid: string): Promise<void>;
+    /** Mute for `durationMs` (e.g. 8h = 28_800_000). Omit to mute indefinitely. */
+    mute(jid: string, durationMs?: number): Promise<void>;
+    unmute(jid: string): Promise<void>;
+    markRead(jid: string): Promise<void>;
+    markUnread(jid: string): Promise<void>;
+    star(key: WAMessageKey, starred?: boolean): Promise<void>;
+    unstar(key: WAMessageKey): Promise<void>;
+    delete(jid: string): Promise<void>;
+    clear(jid: string): Promise<void>;
+}
+
+type ContactCheckResult = {
+    jid: string;
+    exists: boolean;
+    lid?: string;
+};
+declare class ContactModule {
+    private readonly getSocket;
+    private readonly normalize;
+    constructor(getSocket: () => DomainSocketLike | undefined, normalize: (input: string) => string);
+    protected requireSocket(): DomainSocketLike;
+    /** Check whether phone numbers are on WhatsApp; returns the resolved jid + existence per input. */
+    check(...numbers: string[]): Promise<ContactCheckResult[]>;
+    exists(number: string): Promise<boolean>;
+    save(jid: string, name: {
+        firstName?: string;
+        lastName?: string;
+        fullName?: string;
+    }): Promise<void>;
+    remove(jid: string): Promise<void>;
+}
+
+declare class BusinessModule {
+    private readonly getSocket;
+    constructor(getSocket: () => DomainSocketLike | undefined);
+    protected requireSocket(): DomainSocketLike;
+    profile(jid: string): Promise<unknown>;
+    catalog(opts?: {
+        jid?: string;
+        limit?: number;
+        cursor?: string;
+    }): Promise<unknown>;
+    collections(jid?: string, limit?: number): Promise<unknown>;
+    orderDetails(orderId: string, tokenBase64: string): Promise<unknown>;
+    createProduct(create: Record<string, unknown>): Promise<unknown>;
+    updateProduct(productId: string, update: Record<string, unknown>): Promise<unknown>;
+    deleteProduct(...productIds: string[]): Promise<{
+        deleted: number;
+    }>;
 }
 
 interface SenderInfo {
     jid: string;
+    deviceJid?: string;
     lid?: string;
     pn?: string;
     username?: string;
@@ -629,6 +852,7 @@ type NewsletterPayload = {
     update?: Record<string, unknown>;
 });
 type InboundEventMap = {
+    message: MessageContext;
     text: MessageContext;
     image: MessageContext;
     video: MessageContext;
@@ -660,7 +884,7 @@ type InboundEventMap = {
 };
 type InboundEventName = keyof InboundEventMap;
 
-type ChatType = 'text' | 'image' | 'video' | 'audio' | 'document' | 'sticker' | 'poll' | 'contact' | 'location' | 'live-location' | 'event' | 'buttons' | 'list' | 'interactive' | 'template' | 'unknown';
+type ChatType = 'text' | 'image' | 'video' | 'audio' | 'document' | 'sticker' | 'poll' | 'contact' | 'location' | 'live-location' | 'event' | 'album' | 'group-invite' | 'product' | 'order' | 'payment' | 'buttons' | 'list' | 'interactive' | 'template' | 'unknown';
 type SenderDevice = 'unknown' | 'android' | 'ios' | 'web' | 'desktop' | string;
 interface CitationConfig {
     authors?: string[] | ((jid: string) => boolean | Promise<boolean>);
@@ -706,6 +930,54 @@ interface LocationMedia {
     speed: number | null;
     caption: string | null;
 }
+interface AlbumMedia {
+    type: 'album';
+    expectedImageCount: number | null;
+    expectedVideoCount: number | null;
+}
+interface GroupInviteMedia {
+    type: 'group-invite';
+    groupId: string | null;
+    groupName: string | null;
+    inviteCode: string | null;
+    caption: string | null;
+    expiresAt: number | null;
+}
+interface ProductMedia {
+    type: 'product';
+    productId: string | null;
+    title: string | null;
+    description: string | null;
+    price: number | null;
+    currency: string | null;
+    retailerId: string | null;
+    url: string | null;
+    businessOwnerId: string | null;
+}
+interface OrderMedia {
+    type: 'order';
+    orderId: string | null;
+    title: string | null;
+    itemCount: number | null;
+    total: number | null;
+    currency: string | null;
+    status: string | null;
+    message: string | null;
+}
+interface PaymentMedia {
+    type: 'payment';
+    kind: 'request' | 'send' | 'invite';
+    amount: number | null;
+    currency: string | null;
+    note: string | null;
+    expiresAt: number | null;
+}
+interface LinkPreviewMedia {
+    type: 'link';
+    url: string | null;
+    title: string | null;
+    description: string | null;
+}
 interface EventMedia {
     type: 'event';
     name: string | null;
@@ -756,9 +1028,10 @@ interface TemplateMedia {
     text: string | null;
     buttons: MessageButton[];
 }
-type ContextMedia = MediaAttachment | PollMedia | ContactMedia | LocationMedia | EventMedia | ButtonsMedia | ListMedia | InteractiveMedia | TemplateMedia;
+type ContextMedia = MediaAttachment | PollMedia | ContactMedia | LocationMedia | EventMedia | AlbumMedia | GroupInviteMedia | ProductMedia | OrderMedia | PaymentMedia | LinkPreviewMedia | ButtonsMedia | ListMedia | InteractiveMedia | TemplateMedia;
 interface MessageContext {
     uniqueId: string;
+    staticId: string;
     channelId: string;
     chatId: string;
     chatType: ChatType;
@@ -827,6 +1100,7 @@ interface BuildContextInput {
     isNewsletter: boolean;
     prefixes: string[];
     citationConfig?: CitationConfig;
+    lidMap?: Map<string, string>;
     resolveRoomName: () => Promise<string | null>;
     resolveReceiverName: () => Promise<string | null>;
     resolveReplied: () => Promise<MessageContext | null>;
@@ -834,6 +1108,11 @@ interface BuildContextInput {
     react: (emoji: string) => Promise<WAMessageKey>;
     media?: ContextMedia;
 }
+declare const extractLinks: (text: string) => string[];
+declare const computeUniqueId: (key: WAMessageKey) => string;
+declare const computeStaticId: (roomId: string | null, senderId: string) => string;
+declare const epochSecondsToMs: (value: unknown) => number;
+declare const senderDeviceOf: (jid: string) => SenderDevice;
 declare const buildMessageContext: (input: BuildContextInput) => MessageContext;
 
 type CommandPrefix = string | string[];
@@ -1278,6 +1557,10 @@ declare class Client extends TypedEventEmitter<ClientEventMap> {
     private _privacy?;
     private _newsletter?;
     private _community?;
+    private _profile?;
+    private _chat?;
+    private _contact?;
+    private _business?;
     private commandRegistry?;
     private readonly commandMiddleware;
     private readonly commandPrefixes;
@@ -1299,6 +1582,10 @@ declare class Client extends TypedEventEmitter<ClientEventMap> {
     get privacy(): PrivacyModule;
     get newsletter(): NewsletterModule;
     get community(): CommunityModule;
+    get profile(): ProfileModule;
+    get chat(): ChatModule;
+    get contact(): ContactModule;
+    get business(): BusinessModule;
     get presence(): PresenceModule;
     broadcast(jids: string[], build: (b: MessageBuilder<'init'>) => MessageBuilder<'content-set'>, options?: BroadcastOptions): Promise<BroadcastResult>;
     scheduleAt(date: Date, build: (b: MessageBuilder<'init'>) => MessageBuilder<'content-set'>): Promise<ScheduleHandle>;
@@ -1317,6 +1604,9 @@ declare class Client extends TypedEventEmitter<ClientEventMap> {
     delete(key: WAMessageKey, opts?: DeleteOptions): Promise<void>;
     react(key: WAMessageKey, emoji: string): Promise<WAMessageKey>;
     forward(key: WAMessageKey, to: string): Promise<WAMessageKey>;
+    pin(key: WAMessageKey, opts?: PinOptions): Promise<WAMessageKey>;
+    unpin(key: WAMessageKey): Promise<WAMessageKey>;
+    setDisappearing(to: string, seconds: number): Promise<void>;
     private resolveRecipient;
     private requireSocket;
     private attachEmitterLogger;
@@ -1326,6 +1616,11 @@ declare class Client extends TypedEventEmitter<ClientEventMap> {
     private handleAuthExhausted;
     private handleOpen;
     private resolveMessageForResend;
+    private lidMapping;
+    /** Resolve a `@lid` JID to its phone-number JID (uses WhatsApp's LID mapping; may hit the network). */
+    lidToPn(lid: string): Promise<string | null>;
+    /** Resolve a phone-number JID to its `@lid` JID (uses WhatsApp's LID mapping; may hit the network). */
+    pnToLid(pn: string): Promise<string | null>;
     private lookupQuoted;
     private handleClose;
     private rejectPendingConnect;
@@ -1683,6 +1978,26 @@ type ZaileysLogger = Logger$1;
 declare function createLogger(options?: CreateLoggerOptions): ZaileysLogger;
 declare function adoptLogger(maybe: Logger | Partial<Logger> | undefined, fallback?: Logger): Logger;
 
+declare const extractJid: (remoteJid: string | undefined | null) => string | null;
+declare const isLidJid: (jid: string) => boolean;
+declare const isPnJid: (jid: string) => boolean;
+
+/** Digits-only phone number from a JID (e.g. `628xx@s.whatsapp.net` → `628xx`). Empty for groups/lids. */
+declare const jidToPhone: (jid: string) => string;
+/** Build a user JID from a phone number or digits (e.g. `+62 812` → `62812@s.whatsapp.net`). */
+declare const phoneToJid: (phone: string) => string;
+
+type LoadedMedia = {
+    buffer: Buffer;
+    mime: string;
+    size: number;
+};
+type LoadMediaOptions = {
+    timeoutMs?: number;
+};
+declare const detectMimeFromBuffer: (buffer: Buffer) => Promise<string>;
+declare const loadMedia: (src: MediaSource, options?: LoadMediaOptions) => Promise<LoadedMedia>;
+
 interface LIDMapping {
     readonly lid: string;
     readonly pn: string;
@@ -1856,4 +2171,4 @@ declare class Media {
     toBuffer(): Promise<Buffer>;
 }
 
-export { type AddressButton, type AlbumItem, type AudioOptions, AudioProcessor, type AudioType, type AuthAttemptBlockReason, type AuthAttemptDecision, type AuthCredsStore, type AuthGuard, type AuthGuardOptions, type AuthStore, type AuthStoreBundle, type AuthStoreKey, type AuthStoreValue, type AutomationErrorCode, type AutomationSocketLike, type BaileysSocket, type BaileysSocketLike, type BottomSheetOptions, type BroadcastDeps, type BroadcastOptions, type BroadcastResult, BufferConverter, type BuildContextInput, type BuilderContext, type BuilderErrorCode, type BuilderSocketLike, type BuilderState, type ButtonClickPayload, type ButtonDef, type CacheableAuthStoreOptions, type CallBase, type CallButton, type CallPayload, type CancelReminderButton, type ChatType, type CitationConfig, type CitationPredicates, Client, type ClientEventMap, type ClientEventName, type ClientOptions, type CommandContext, type CommandDefinition, type CommandErrorCode, type CommandHandler, type CommandPrefix, CommandRegistry, CommunityModule, type ConnectionAuthType, type ConnectionEventHandler, type ConnectionEventMap, type ConnectionEventName, type ConnectionState, type ConnectionStateMachine, type ContextMedia, ConvexAuthStore, type ConvexAuthStoreOptions, ConvexMessageStore, type ConvexMessageStoreOptions, type CopyButton, type CreateLoggerOptions, type DeleteOptions, type DeletePayload, type DisconnectReasonDomain, type DispatcherDeps, type DispatcherHandle, type DocumentOptions, DocumentProcessor, type DomainErrorCode, type DomainSocketLike, EditBuilder, type EditPayload, FFMPEG_CONSTANTS, type FFmpegConfig, FFmpegProcessor, FileAuthStore, type FileAuthStoreOptions, type FileExtension, FileManager, type GroupJoinPayload, type GroupLeavePayload, GroupModule, type GroupParticipantInfo, type GroupUpdatePayload, type HistorySyncPayload, type ImageOptions, ImageProcessor, type InboundEventMap, type InboundEventName, type InteractiveButton, type LIDMapping, type LIDMappingUpdatePayload, type LimitedPayload, type LimitedTimeOfferOptions, type LinkedGroup, type ListOptions, type ListSection$1 as ListSection, type ListSelectPayload, type LocationOptions, type LocationRequestButton, type Logger, type LoggerLevel, Media, type MediaDescriptor, type MediaDownloadResult, type MediaInput, type MediaKind, type MediaSource, type MemberTagPayload, MemoryAuthStore, MemoryMessageStore, type MentionAllContext, type MentionContext, MessageBuilder, type MessageContext, type MessageStore, type MessageStoreListOptions, type Middleware, MimeValidator, NewsletterModule, type NewsletterPayload, type OperationCategory, type OperationGuard, type OperationGuardClock, type OperationGuardOptions, type PairingFlow, type PairingFlowOptions, type PairingFlowResult, type ParsedArgs, type ParticipantUpdateResult, type PollOptions, type PollVotePayload, PostgresAuthStore, type PostgresAuthStoreOptions, PostgresMessageStore, type PostgresMessageStoreOptions, type PresenceClock, PresenceModule, type PresencePayload, type PresenceThrottleOptions, type PrivacyConfig, PrivacyModule, type PrivacySettings, type QuotedRef, RateLimiter, type RateLimiterClock, type RateLimiterOptions, type ReactionPayload, type ReconnectDecision, type ReconnectOptions, type ReconnectStrategy, type ReconnectStrategyDeps, RedisAuthStore, type RedisAuthStoreOptions, RedisMessageStore, type RedisMessageStoreOptions, type ReminderButton, type ReplyButton, type ResolvedCommand, type RetryPolicy, SELF_ONLY_PROTOCOL_TYPES, type ScheduleHandle, type ScheduledContentSnapshot, type ScheduledJob, type ScheduledJobRecord, Scheduler, type SchedulerDeps, type SchedulerTimer, type SelfOnlyProtocolType, type SenderDevice, type SenderInfo, SqliteAuthStore, type SqliteAuthStoreOptions, SqliteMessageStore, type SqliteMessageStoreOptions, type StateTransitionListener, type StickerMetadataType, type StickerOptions, StickerProcessor, type StickerShapeType, type StoreErrorCode, TaskQueue, type TaskQueueClock, type TaskQueueOptions, type TemplateOptions, type TextOptions, TypedEventEmitter, type TypedEventEmitterOptions, type UpsertPayload, type UrlButton, type UsernameResolveSocketLike, type VideoOptions, VideoProcessor, type WAPresence, ZaileysAutomationError, ZaileysBuilderError, ZaileysCommandError, ZaileysDomainError, type ZaileysLogger, ZaileysStoreError, adoptLogger, attachCommandDispatcher, buildMessageContext, chunk, createAuthGuard, createConnectionStateMachine, createLogger, createOperationGuard, createPairingFlow, createReconnectStrategy, deleteMessage, detectFileType, dropSpoofedSelfOnly, ffmpegTransform, forwardMessage, generateId, initializeFFmpeg, isFatalDisconnect, isJid, isRateLimited, makeCacheableAuthStore, mapDisconnectReason, normalizePhoneNumber, parseCommand, printQrToTerminal, reactToMessage, renderQrInTerminal, resolveUsername, runBroadcast, runMiddleware, shouldClearAuth, shouldReconnect, signalKeyStoreFromAuthStore, validateE164 };
+export { type AddressButton, type AlbumItem, type AudioOptions, AudioProcessor, type AudioType, type AuthAttemptBlockReason, type AuthAttemptDecision, type AuthCredsStore, type AuthGuard, type AuthGuardOptions, type AuthStore, type AuthStoreBundle, type AuthStoreKey, type AuthStoreValue, type AutomationErrorCode, type AutomationSocketLike, type BaileysSocket, type BaileysSocketLike, type BottomSheetOptions, type BroadcastDeps, type BroadcastOptions, type BroadcastResult, BufferConverter, type BuildContextInput, type BuilderContext, type BuilderErrorCode, type BuilderSocketLike, type BuilderState, BusinessModule, type ButtonClickPayload, type ButtonDef, type CacheableAuthStoreOptions, type CallBase, type CallButton, type CallPayload, type CancelReminderButton, ChatModule, type ChatType, type CitationConfig, type CitationPredicates, Client, type ClientEventMap, type ClientEventName, type ClientOptions, type CommandContext, type CommandDefinition, type CommandErrorCode, type CommandHandler, type CommandPrefix, CommandRegistry, CommunityModule, type ConnectionAuthType, type ConnectionEventHandler, type ConnectionEventMap, type ConnectionEventName, type ConnectionState, type ConnectionStateMachine, ContactModule, type ContextMedia, ConvexAuthStore, type ConvexAuthStoreOptions, ConvexMessageStore, type ConvexMessageStoreOptions, type CopyButton, type CreateLoggerOptions, type DeleteOptions, type DeletePayload, type DisconnectReasonDomain, type DispatcherDeps, type DispatcherHandle, type DocumentOptions, DocumentProcessor, type DomainErrorCode, type DomainSocketLike, EditBuilder, type EditPayload, type EventOptions, FFMPEG_CONSTANTS, type FFmpegConfig, FFmpegProcessor, FileAuthStore, type FileAuthStoreOptions, type FileExtension, FileManager, type GroupInviteOptions, type GroupJoinPayload, type GroupLeavePayload, GroupModule, type GroupParticipantInfo, type GroupUpdatePayload, type HistorySyncPayload, type ImageOptions, ImageProcessor, type InboundEventMap, type InboundEventName, type InteractiveButton, type LIDMapping, type LIDMappingUpdatePayload, type LimitedPayload, type LimitedTimeOfferOptions, type LinkedGroup, type ListOptions, type ListSection$1 as ListSection, type ListSelectPayload, type LoadMediaOptions, type LoadedMedia, type LocationOptions, type LocationRequestButton, type Logger, type LoggerLevel, Media, type MediaDescriptor, type MediaDownloadResult, type MediaInput, type MediaKind, type MediaSource, type MemberTagPayload, MemoryAuthStore, MemoryMessageStore, type MentionAllContext, type MentionContext, MessageBuilder, type MessageContext, type MessageStore, type MessageStoreListOptions, type Middleware, MimeValidator, NewsletterModule, type NewsletterPayload, type OperationCategory, type OperationGuard, type OperationGuardClock, type OperationGuardOptions, type PairingFlow, type PairingFlowOptions, type PairingFlowResult, type ParsedArgs, type ParticipantUpdateResult, type PinOptions, type PollOptions, type PollVotePayload, PostgresAuthStore, type PostgresAuthStoreOptions, PostgresMessageStore, type PostgresMessageStoreOptions, type PresenceClock, PresenceModule, type PresencePayload, type PresenceThrottleOptions, type PrivacyConfig, PrivacyModule, type PrivacySettings, type ProductOptions, ProfileModule, type QuotedRef, RateLimiter, type RateLimiterClock, type RateLimiterOptions, type ReactionPayload, type ReconnectDecision, type ReconnectOptions, type ReconnectStrategy, type ReconnectStrategyDeps, RedisAuthStore, type RedisAuthStoreOptions, RedisMessageStore, type RedisMessageStoreOptions, type ReminderButton, type ReplyButton, type ResolvedCommand, type RetryPolicy, SELF_ONLY_PROTOCOL_TYPES, type ScheduleHandle, type ScheduledContentSnapshot, type ScheduledJob, type ScheduledJobRecord, Scheduler, type SchedulerDeps, type SchedulerTimer, type SelfOnlyProtocolType, type SenderDevice, type SenderInfo, SqliteAuthStore, type SqliteAuthStoreOptions, SqliteMessageStore, type SqliteMessageStoreOptions, type StateTransitionListener, type StickerMetadataType, type StickerOptions, StickerProcessor, type StickerShapeType, type StoreErrorCode, TaskQueue, type TaskQueueClock, type TaskQueueOptions, type TemplateOptions, type TextOptions, TypedEventEmitter, type TypedEventEmitterOptions, type UpsertPayload, type UrlButton, type UsernameResolveSocketLike, type VideoNoteOptions, type VideoOptions, VideoProcessor, type WAPresence, ZaileysAutomationError, ZaileysBuilderError, ZaileysCommandError, ZaileysDomainError, type ZaileysLogger, ZaileysStoreError, adoptLogger, attachCommandDispatcher, buildMessageContext, chunk, computeStaticId, computeUniqueId, createAuthGuard, createConnectionStateMachine, createLogger, createOperationGuard, createPairingFlow, createReconnectStrategy, deleteMessage, detectFileType, detectMimeFromBuffer, dropSpoofedSelfOnly, epochSecondsToMs, extractLinks, ffmpegTransform, forwardMessage, generateId, initializeFFmpeg, isFatalDisconnect, isJid, isLidJid, isPnJid, isRateLimited, jidToPhone, loadMedia, makeCacheableAuthStore, mapDisconnectReason, extractJid as normalizeJid, normalizePhoneNumber, parseCommand, phoneToJid, pinMessage, printQrToTerminal, reactToMessage, renderQrInTerminal, resolveUsername, runBroadcast, runMiddleware, senderDeviceOf, shouldClearAuth, shouldReconnect, signalKeyStoreFromAuthStore, validateE164 };