zaileys 4.8.4 → 4.8.6

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,7 @@ 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;
+    /** 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,8 @@ 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";
 export type HeaderMedia = {
     kind: 'image' | 'video';
     src: MediaSource;

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

@@ -0,0 +1,12 @@
+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 text message as a group status. Media sources are rejected — see `MEDIA_KEYS`. */
+export declare const buildGroupStatusRepost: (source: GroupStatusSource, opts?: GroupStatusRepostOptions) => AnyMessageContent;

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,21 @@ 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;
+};
+/** A message to repost as a group status — a `MessageContext` or a raw `WAMessage`. */
+export type GroupStatusSource = WAMessage | {
+    message: () => WAMessage;
+};
+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/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>;