zaileys 4.8.5 → 4.8.7

package/dist/builder/builder.d.ts

@@ -3,7 +3,7 @@ import { type ButtonsContentOptions } from './content/buttons.js';
 import { type CarouselCard } from './content/carousel.js';
 import { type AIRichOptions } from './content/airich.js';
 import { type BuilderInternalState } from './state.js';
-import type { AlbumItem, AudioOptions, BuilderState, ButtonDef, DocumentOptions, EventOptions, GroupInviteOptions, ImageOptions, InteractiveButton, ListOptions, LocationOptions, MediaSource, PollOptions, ProductOptions, StickerOptions, TemplateOptions, VideoNoteOptions, VideoOptions } from './types.js';
+import type { AlbumItem, AudioOptions, BuilderState, ButtonDef, DocumentOptions, EventOptions, GroupInviteOptions, GroupStatusOptions, GroupStatusRepostOptions, GroupStatusSource, ImageOptions, InteractiveButton, ListOptions, LocationOptions, MediaSource, PollOptions, ProductOptions, StickerOptions, TemplateOptions, VideoNoteOptions, VideoOptions } from './types.js';
 export interface BuilderSocketLike {
     sendMessage(jid: string, content: AnyMessageContent, options?: MiscMessageGenerationOptions): Promise<WAMessage | undefined>;
     relayMessage?(jid: string, message: unknown, options: {
@@ -44,6 +44,9 @@ export declare class MessageBuilder<State extends BuilderState> {
     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'>;
+    /** Post a group status. Pass text, or an existing message to repost it without re-uploading its media. */
+    groupStatus(this: MessageBuilder<'init'>, text: string, opts?: GroupStatusOptions): MessageBuilder<'content-set'>;
+    groupStatus(this: MessageBuilder<'init'>, source: GroupStatusSource, opts?: GroupStatusRepostOptions): 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'>;
@@ -55,5 +58,13 @@ export declare class MessageBuilder<State extends BuilderState> {
     disappearing(seconds: number): MessageBuilder<State>;
     then<T = WAMessageKey>(this: MessageBuilder<'content-set'>, onResolved: (key: WAMessageKey) => T, onRejected?: (err: unknown) => T | PromiseLike<T>): Promise<T>;
     private uploadHeaderMedia;
+    /**
+     * Uploads the status media and returns it at the TOP level, not inside the envelope. baileys derives
+     * the stanza's `mediatype` attribute from the raw message before `patchMessageBeforeSending` runs, and
+     * the server drops a media status that lacks it — so the wrapping happens later, in that hook.
+     */
+    private buildStatusMedia;
+    /** Relay skips baileys' contextInfo pass, so mentions and mentionAll are applied to the unwrapped node here. */
+    private applyRelayMentions;
     private sendRelay;
 }

package/dist/builder/content/buttons.d.ts

@@ -2,6 +2,16 @@ import { proto, type AnyMessageContent } from 'baileys';
 import type { BottomSheetOptions, ButtonDef, InteractiveButton, LimitedTimeOfferOptions, MediaSource } from '../types.js';
 export declare const RELAY_CONTENT_KEY = "__zaileysRelayMessage";
 export declare const RELAY_MEDIA_KEY = "__zaileysHeaderMedia";
+/** Marks relay content that may only target a group jid; the value is the method label used in the error. */
+export declare const RELAY_REQUIRE_GROUP_KEY = "__zaileysRequireGroupJid";
+/** Carries a downloaded media buffer that `sendRelay` re-uploads and injects into the status envelope. */
+export declare const RELAY_STATUS_MEDIA_KEY = "__zaileysStatusMedia";
+export type StatusMedia = {
+    kind: 'image' | 'video' | 'audio';
+    buffer: Buffer;
+    caption?: string;
+    ptt?: boolean;
+};
 export type HeaderMedia = {
     kind: 'image' | 'video';
     src: MediaSource;

package/dist/builder/content/group-status.d.ts

@@ -0,0 +1,15 @@
+import { type AnyMessageContent } from 'baileys';
+import type { GroupStatusFont, GroupStatusOptions, GroupStatusRepostOptions, GroupStatusSource } from '../types.js';
+/**
+ * Parses a group status background into an ARGB integer. Unlike baileys' `assertColor` this keeps
+ * numeric input (which that helper silently turns into `undefined`) and reads `#RGB` as CSS shorthand.
+ */
+export declare const parseStatusArgb: (value: string | number) => number;
+/** Resolves a named font to its WhatsApp `FontType`; raw integers pass through for forward compatibility. */
+export declare const resolveStatusFont: (value: GroupStatusFont | number) => number;
+export declare const buildGroupStatusContent: (text: string, opts?: GroupStatusOptions) => AnyMessageContent;
+/**
+ * Reposts an existing message as a group status. Media cannot be carried by copying pointers — the
+ * bytes are downloaded here and re-uploaded at dispatch, because a status needs its own upload.
+ */
+export declare const buildGroupStatusRepost: (source: GroupStatusSource, opts?: GroupStatusRepostOptions) => Promise<AnyMessageContent>;

package/dist/builder/status-wrap.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Marks a media message to be wrapped into a group status envelope at send time.
+ *
+ * baileys reads `getMediaType()` from the raw message to set the stanza's `mediatype` attribute, and
+ * only calls `patchMessageBeforeSending` afterwards. A media message nested inside
+ * `groupStatusMessageV2` is therefore invisible to that check and the server drops it. Relaying the
+ * media at the top level and wrapping it in the patch hook gets both the attribute and the envelope.
+ */
+export declare const markAsGroupStatus: (message: object) => void;
+/** Wraps a marked message into the group status envelope; returns it untouched otherwise. */
+export declare const applyGroupStatusWrap: <T extends object>(message: T) => T;

package/dist/builder/types.d.ts

@@ -1,4 +1,5 @@
 import type { WAMessage, WAMessageKey } from 'baileys';
+import type { StickerMetadataType } from '../media/ffmpeg/sticker.js';
 export type BuilderState = 'init' | 'content-set';
 export type MediaSource = string | Buffer | URL;
 export type ImageOptions = {
@@ -24,7 +25,7 @@ export type DocumentOptions = {
     mimetype?: string;
     caption?: string;
 };
-export type StickerOptions = {
+export type StickerOptions = StickerMetadataType & {
     animated?: boolean;
 };
 export type AlbumItem = {
@@ -155,6 +156,30 @@ export type GroupInviteOptions = {
     /** Optional JPEG thumbnail (group avatar) — improves how the card renders. */
     thumbnail?: Buffer;
 };
+export type GroupStatusFont = 'system' | 'system-text' | 'fb-script' | 'system-bold' | 'morningbreeze' | 'calistoga' | 'exo2' | 'courierprime';
+export type GroupStatusOptions = {
+    /** Background as `#RGB`, `#RRGGBB`, `#AARRGGBB` (with or without `#`), or a raw ARGB integer. */
+    backgroundColor?: string | number;
+    /** Font face. Accepts a named font or a raw FontType integer for forward compatibility. */
+    font?: GroupStatusFont | number;
+};
+/** Media posted directly as a group status, without an existing message to repost. */
+export type GroupStatusMedia = {
+    image?: MediaSource;
+    video?: MediaSource;
+    audio?: MediaSource;
+    caption?: string;
+    /** Send an audio status as a voice note. */
+    ptt?: boolean;
+};
+/** What a group status can be built from: a `MessageContext`, a raw `WAMessage`, or fresh media. */
+export type GroupStatusSource = WAMessage | {
+    message: () => WAMessage;
+} | GroupStatusMedia;
+export type GroupStatusRepostOptions = {
+    /** Replaces the original caption. Ignored for voice notes, which have none. */
+    caption?: string;
+};
 export type BuilderContext = {
     recipient: string;
     quoted?: WAMessage | WAMessageKey;

package/dist/client/client.d.ts

@@ -142,6 +142,8 @@ export declare class Client extends TypedEventEmitter<ClientEventMap> {
     pin(key: WAMessageKey, opts?: PinOptions): Promise<WAMessageKey>;
     unpin(key: WAMessageKey): Promise<WAMessageKey>;
     setDisappearing(to: string, seconds: number): Promise<void>;
+    /** Group status media must be wrapped after baileys computes the stanza's mediatype; see status-wrap. */
+    private readonly patchOutgoing;
     private resolveRecipient;
     private requireSocket;
     /** Messaging seam: baileys socket or the cloud transport, whichever the provider dictates. */

package/dist/client/types.d.ts

@@ -11,6 +11,7 @@ import type { InboundEventMap } from '../events/types.js';
 import type { MessageStore } from '../store/types.js';
 import type { PluginsOptions } from '../plugin/types.js';
 import type { CloudOptions } from '../cloud/types.js';
+import type { StickerMetadataType } from '../media/ffmpeg/sticker.js';
 import type { CloudFlowResponseEvent, CloudOrderEvent, CloudStatusEvent, CloudTemplateStatusEvent } from '../cloud/translate/inbound.js';
 export type ProviderKind = 'baileys' | 'cloud';
 export type ConnectionState = 'idle' | 'connecting' | 'qr-pending' | 'pairing-pending' | 'connected' | 'reconnecting' | 'disconnecting' | 'disconnected';
@@ -65,6 +66,8 @@ export interface ClientOptions {
     autoDelete?: AutoDeleteOptions | false;
     /** Load and manage plugins from a directory. */
     plugins?: PluginsOptions;
+    /** Global default sticker metadata configuration (pack name, author, etc). */
+    sticker?: StickerMetadataType;
 }
 export type ConnectionEventMap = {
     connect: {

package/dist/events/context.d.ts

@@ -182,6 +182,7 @@ export interface MessageContext {
     isHideTags: boolean;
     isStatusMention: boolean;
     isGroupStatusMention: boolean;
+    isGroupStatus: boolean;
     isStory: boolean;
     roomName(): Promise<string | null>;
     receiverName(): Promise<string | null>;

package/dist/events/decoders/_shared.d.ts

@@ -24,3 +24,10 @@ export declare const extractMentions: (contextInfo: WAContextInfo | null | undef
 export declare const mapAddressing: (key: WAMessageKey) => AddressingAliases;
 export declare const isGroupJid: (jid: string) => boolean;
 export declare const safeNumber: (n: number | LongLike | null | undefined) => number | null;
+export declare const asRecord: (value: unknown) => Record<string, unknown> | null;
+/** Order matters: unwrap() breaks on the first match, so new entries go at the end. */
+export declare const WRAPPER_FIELDS: readonly ['ephemeralMessage', 'viewOnceMessage', 'viewOnceMessageV2', 'viewOnceMessageV2Extension', 'documentWithCaptionMessage', 'editedMessage', 'lottieStickerMessage', 'groupStatusMessage', 'groupStatusMessageV2'];
+export declare const GROUP_STATUS_FIELDS: readonly ['groupStatusMessage', 'groupStatusMessageV2'];
+/** True when any level of the bounded wrapper chain carries one of the given fields. */
+export declare const wrapperChainHas: (content: Record<string, unknown>, fields: readonly string[]) => boolean;
+export declare const unwrap: (content: Record<string, unknown>) => Record<string, unknown>;