zapo-js 0.2.0 → 1.0.0

package/dist/types/message/primitives/peer-data-operation.d.ts

@@ -0,0 +1,23 @@
+import type { WaAuthCredentials } from '../../auth/types';
+import type { PublishProtocolMessageToDeviceFn } from '../../client/messaging/key-protocol';
+import type { WaIncomingProtocolMessageEvent } from '../../client/types';
+import type { Logger } from '../../infra/log/types';
+import { type Proto } from '../..';
+export interface PeerDataOperationRequesterOptions {
+    readonly logger: Logger;
+    readonly publishProtocolMessageToDevice: PublishProtocolMessageToDeviceFn;
+    readonly getCurrentCredentials: () => WaAuthCredentials | null;
+    readonly generateOutgoingMessageId: () => Promise<string>;
+    readonly subscribeToProtocolMessage: (handler: (event: WaIncomingProtocolMessageEvent) => void) => () => void;
+    readonly defaultTimeoutMs?: number;
+    readonly maxPending?: number;
+}
+export interface PeerDataOperationRequester {
+    readonly request: (type: Proto.Message.PeerDataOperationRequestType, body: Proto.Message.IPeerDataOperationRequestMessage, options?: {
+        readonly timeoutMs?: number;
+    }) => Promise<readonly Proto.Message.PeerDataOperationRequestResponseMessage.IPeerDataOperationResult[]>;
+    readonly send: (type: Proto.Message.PeerDataOperationRequestType, body: Proto.Message.IPeerDataOperationRequestMessage) => Promise<{
+        readonly messageId: string;
+    }>;
+}
+export declare function createPeerDataOperationRequester(options: PeerDataOperationRequesterOptions): PeerDataOperationRequester;

package/dist/types/message/types.d.ts

@@ -1,5 +1,8 @@
 import type { Readable } from 'node:stream';
+import type { WaLinkPreviewOverride } from './addons/link-preview/types';
+import type { WaSendContextInfo } from './context-info';
 import type { Proto } from '..';
+import type { WaOutboundReceiptType } from '../protocol/message';
 import type { BinaryNode } from '../transport/types';
 export interface WaMessagePublishOptions {
     readonly ackTimeoutMs?: number;
@@ -20,50 +23,235 @@ export interface WaMessagePublishResult {
     readonly attempts: number;
     readonly ackNode: BinaryNode;
     readonly ack: WaMessageAckMetadata;
+    readonly upload?: WaMessageUploadInfo;
 }
-type MediaInput = Uint8Array | ArrayBuffer | Readable;
+export interface WaMessageUploadInfo {
+    readonly url: string;
+    readonly directPath: string;
+    readonly fileSha256: Uint8Array;
+    readonly fileLength: number;
+    readonly metadataUrl?: string;
+}
+export interface WaMessageBuildResult {
+    readonly message: Proto.IMessage;
+    readonly upload?: WaMessageUploadInfo;
+}
+type MediaInput = Uint8Array | ArrayBuffer | Readable | string;
+type MediaFieldsFilledByBuilder = 'url' | 'mimetype' | 'fileSha256' | 'fileLength' | 'mediaKey' | 'fileEncSha256' | 'directPath' | 'mediaKeyTimestamp' | 'streamingSidecar' | 'metadataUrl' | 'contextInfo';
+type UserMediaFields<T> = {
+    readonly [K in keyof Omit<T, MediaFieldsFilledByBuilder>]?: T[K];
+};
 interface WaSendMediaBase {
     readonly media: MediaInput;
-    readonly mimetype: string;
+    /**
+     * Mime type of the media. Optional when a {@link WaMediaProcessor} with
+     * `detectMimetype` is configured (e.g. `@zapo-js/media-utils` with
+     * `file-type` installed): the builder infers it from the input. Required
+     * otherwise; a missing mimetype throws at build time.
+     */
+    readonly mimetype?: string;
     readonly fileLength?: number;
+    readonly contextInfo?: WaSendContextInfo;
+}
+export interface WaSendTextMessage {
+    readonly type: 'text';
+    readonly text: string;
+    readonly contextInfo?: WaSendContextInfo;
+    /**
+     * Link preview control: `undefined` follows the global `linkPreview.enabled`
+     * default; `false` disables; `true` forces auto-fetch; an object skips the
+     * fetch and uses the provided fields directly.
+     */
+    readonly linkPreview?: boolean | WaLinkPreviewOverride;
+}
+/**
+ * A message key in the protobuf {@link Proto.IMessageKey} shape, used to target
+ * an existing message (reply / edit / reaction / revoke / pin / keep). Every
+ * field is filled on a received `message` event's `key`, so they are required
+ * here (and assignable to the looser `Proto.IMessageKey`). When sending, the
+ * builder forces `remoteJid` to the recipient and drops `participant` in 1:1
+ * chats.
+ */
+export interface WaMessageKey {
+    readonly remoteJid: string;
+    readonly id: string;
+    readonly fromMe: boolean;
+    /** The author - set in groups/broadcasts; omitted in 1:1 (the author is `remoteJid`). */
+    readonly participant?: string;
+}
+/**
+ * A received `message` event passed verbatim as a target. Its `key` (a
+ * {@link WaMessageKey}, the same shape the event exposes) is what gets used;
+ * `rawNode` - always present on real events - discriminates it from an explicit
+ * {@link WaMessageKey}.
+ */
+export interface WaMessageRef {
+    readonly key?: WaMessageKey;
+    readonly rawNode: unknown;
+}
+/** An explicit {@link WaMessageKey}, or a received `message` event ({@link WaMessageRef}). */
+export type WaMessageTargetInput = WaMessageKey | WaMessageRef;
+export interface WaSendReactionMessage {
+    readonly type: 'reaction';
+    /** Emoji to attach. Pass an empty string to revoke an existing reaction. */
+    readonly emoji: string;
+    /** An explicit {@link WaMessageKey} or a received `message` event passed verbatim. */
+    readonly target: WaMessageTargetInput;
+    /** Defaults to `Date.now()` when omitted. */
+    readonly senderTimestampMs?: number;
+}
+export interface WaSendRevokeMessage {
+    readonly type: 'revoke';
+    /** An explicit {@link WaMessageKey} or a received `message` event passed verbatim. */
+    readonly target: WaMessageTargetInput;
+}
+export interface WaSendPinMessage {
+    readonly type: 'pin' | 'unpin';
+    /** An explicit {@link WaMessageKey} or a received `message` event passed verbatim. */
+    readonly target: WaMessageTargetInput;
+    readonly senderTimestampMs?: number;
+    /**
+     * Pin expiry in seconds. wa-web's UI offers three presets: 86_400 (24h),
+     * 604_800 (7d), 2_592_000 (30d). Defaults to 86_400 on `pin` and is
+     * ignored on `unpin`. Without it the receiving clients drop the pin
+     * silently, so this is effectively required to make the pin visible.
+     */
+    readonly durationSecs?: number;
+}
+export interface WaSendEditKey {
+    /** Id of the message being edited (`fromMe` is forced true, `remoteJid` is the recipient). */
+    readonly id: string;
+    /** Required in groups when the original message uses lid/pn addressing on the participant. */
+    readonly participant?: string;
+    /** Defaults to `Date.now()` when omitted. */
+    readonly timestampMs?: number;
+}
+export interface WaSendKeepMessage {
+    readonly type: 'keep' | 'unkeep';
+    /** An explicit {@link WaMessageKey} or a received `message` event passed verbatim. */
+    readonly target: WaMessageTargetInput;
+    /** Defaults to `Date.now()` when omitted. */
+    readonly timestampMs?: number;
+}
+export interface WaSendPollOptionInput {
+    readonly name: string;
 }
-interface WaSendImageMessage extends WaSendMediaBase {
+export interface WaSendPollMessage {
+    readonly type: 'poll';
+    readonly name: string;
+    /** Option names (strings) or `{ name }` objects. Order matters for vote hashing. */
+    readonly options: readonly (string | WaSendPollOptionInput)[];
+    /** How many options a voter may pick. Defaults to 1. */
+    readonly selectableCount?: number;
+    readonly allowAddOption?: boolean;
+    readonly hideParticipantName?: boolean;
+    readonly contextInfo?: WaSendContextInfo;
+}
+export interface WaSendPollParent {
+    /** Id of the original poll creation message. */
+    readonly id: string;
+    readonly fromMe: boolean;
+    /** Group participant jid; required outside 1:1 chats. */
+    readonly participant?: string;
+    /** Author of the original poll (parentMsgOriginalSender for the use-case secret). */
+    readonly authorJid: string;
+    /** The poll's `messageContextInfo.messageSecret` (32 bytes). */
+    readonly messageSecret: Uint8Array;
+}
+export interface WaSendPollVoteMessage {
+    readonly type: 'poll-vote';
+    readonly poll: WaSendPollParent;
+    /** Option names exactly as they appeared in the poll. Hashed with SHA-256 internally. */
+    readonly selectedOptionNames: readonly string[];
+    /** Defaults to `Date.now()` when omitted. */
+    readonly senderTimestampMs?: number;
+}
+export interface WaSendEventLocation {
+    readonly latitude: number;
+    readonly longitude: number;
+    readonly name?: string;
+    readonly address?: string;
+}
+export interface WaSendEventMessage {
+    readonly type: 'event';
+    readonly name: string;
+    readonly description?: string;
+    /** Unix seconds. */
+    readonly startTime: number;
+    /** Unix seconds. */
+    readonly endTime?: number;
+    readonly location?: WaSendEventLocation;
+    readonly joinLink?: string;
+    readonly extraGuestsAllowed?: boolean;
+    readonly isScheduleCall?: boolean;
+    readonly isCanceled?: boolean;
+    readonly hasReminder?: boolean;
+    /** Reminder offset in seconds before `startTime`. */
+    readonly reminderOffsetSec?: number;
+    readonly contextInfo?: WaSendContextInfo;
+}
+export type WaSendEventResponseType = 'going' | 'not_going' | 'maybe';
+export interface WaSendEventParent {
+    /** Id of the original event creation message. */
+    readonly id: string;
+    readonly fromMe: boolean;
+    readonly participant?: string;
+    /** Creator of the event (parentMsgOriginalSender for the use-case secret). */
+    readonly authorJid: string;
+    /** The event's `messageContextInfo.messageSecret` (32 bytes). */
+    readonly messageSecret: Uint8Array;
+}
+export interface WaSendEventResponseMessage {
+    readonly type: 'event-response';
+    readonly event: WaSendEventParent;
+    readonly response: WaSendEventResponseType;
+    readonly extraGuestCount?: number;
+    /** Defaults to `Date.now()` when omitted. */
+    readonly timestampMs?: number;
+}
+interface WaSendImageMessage extends WaSendMediaBase, UserMediaFields<Proto.Message.IImageMessage> {
     readonly type: 'image';
-    readonly caption?: string;
-    readonly width?: number;
-    readonly height?: number;
 }
-interface WaSendVideoMessage extends WaSendMediaBase {
+interface WaSendVideoMessage extends WaSendMediaBase, UserMediaFields<Proto.Message.IVideoMessage> {
     readonly type: 'video';
-    readonly caption?: string;
-    readonly gifPlayback?: boolean;
-    readonly seconds?: number;
-    readonly width?: number;
-    readonly height?: number;
 }
-interface WaSendPtvMessage extends WaSendMediaBase {
+interface WaSendPtvMessage extends WaSendMediaBase, UserMediaFields<Proto.Message.IVideoMessage> {
     readonly type: 'ptv';
-    readonly seconds?: number;
-    readonly width?: number;
-    readonly height?: number;
 }
-interface WaSendAudioMessage extends WaSendMediaBase {
+interface WaSendAudioMessage extends WaSendMediaBase, UserMediaFields<Proto.Message.IAudioMessage> {
     readonly type: 'audio';
-    readonly ptt?: boolean;
-    readonly seconds?: number;
 }
-interface WaSendDocumentMessage extends WaSendMediaBase {
+interface WaSendDocumentMessage extends WaSendMediaBase, UserMediaFields<Proto.Message.IDocumentMessage> {
     readonly type: 'document';
-    readonly caption?: string;
-    readonly fileName?: string;
 }
-interface WaSendStickerMessage extends WaSendMediaBase {
+interface WaSendStickerMessage extends WaSendMediaBase, UserMediaFields<Proto.Message.IStickerMessage> {
     readonly type: 'sticker';
-    readonly width?: number;
-    readonly height?: number;
 }
-export type WaSendMediaMessage = WaSendImageMessage | WaSendVideoMessage | WaSendPtvMessage | WaSendAudioMessage | WaSendDocumentMessage | WaSendStickerMessage;
-export type WaSendMessageContent = string | Proto.IMessage | WaSendMediaMessage;
+export interface WaSendStickerPackStickerInput {
+    readonly media: Uint8Array | string;
+    readonly fileName: string;
+    readonly emojis: readonly string[];
+    readonly isAnimated?: boolean;
+    readonly isLottie?: boolean;
+    readonly mimetype?: string;
+}
+export interface WaSendStickerPackTrayIcon {
+    readonly media: Uint8Array | string;
+    readonly fileName: string;
+}
+type StickerPackBuilderFilled = 'stickers' | 'trayIconFileName' | 'thumbnailDirectPath' | 'thumbnailSha256' | 'thumbnailEncSha256' | 'stickerPackSize' | 'imageDataHash' | 'stickerPackOrigin';
+export interface WaSendStickerPackMessage extends UserMediaFields<Omit<Proto.Message.IStickerPackMessage, StickerPackBuilderFilled | 'stickerPackId' | 'name' | 'publisher'>> {
+    readonly type: 'sticker-pack';
+    readonly stickerPackId: string;
+    readonly name: string;
+    readonly publisher: string;
+    readonly stickers: readonly WaSendStickerPackStickerInput[];
+    readonly trayIcon: WaSendStickerPackTrayIcon;
+    readonly coverThumbnail?: Uint8Array | string;
+    readonly contextInfo?: WaSendContextInfo;
+}
+export type WaSendMediaMessage = WaSendImageMessage | WaSendVideoMessage | WaSendPtvMessage | WaSendAudioMessage | WaSendDocumentMessage | WaSendStickerMessage | WaSendStickerPackMessage;
+export type WaSendMessageContent = string | WaSendTextMessage | WaSendReactionMessage | WaSendRevokeMessage | WaSendPinMessage | WaSendKeepMessage | WaSendPollMessage | WaSendPollVoteMessage | WaSendEventMessage | WaSendEventResponseMessage | Proto.IMessage | WaSendMediaMessage;
 export interface WaEncryptedMessageInput {
     readonly to: string;
     readonly encType: 'msg' | 'pkmsg' | 'skmsg';
@@ -84,7 +272,7 @@ export interface WaEncryptedMessageInput {
 export interface WaSendReceiptInput {
     readonly to: string;
     readonly id: string;
-    readonly type?: string;
+    readonly type?: WaOutboundReceiptType;
     readonly participant?: string;
     readonly recipient?: string;
     readonly category?: string;
@@ -94,4 +282,6 @@ export interface WaSendReceiptInput {
     readonly listIds?: readonly string[];
     readonly content?: readonly BinaryNode[];
 }
+export type WaSendReceiptOptions = Omit<WaSendReceiptInput, 'to' | 'id' | 'listIds'>;
+export type WaSendReceiptEventOptions = Omit<WaSendReceiptOptions, 'participant'>;
 export {};

package/dist/types/mex.d.ts

@@ -0,0 +1,2 @@
+export { WA_MEX_PERSIST_IDS, WA_MEX_OPERATION_SCHEMAS } from '../spec/mex';
+export type { WaMexPersistId, WaMexOperationSchema, WaMexOperationVariables, WaMexOperationResponses } from '../spec/mex';

package/dist/types/proto.d.ts

@@ -1,2 +1,2 @@
-export { waproto as proto } from '../proto';
-export type { waproto as Proto } from '../proto';
+export { waproto as proto } from '../spec/proto';
+export type { waproto as Proto } from '../spec/proto';

package/dist/types/protocol/abprops.d.ts

@@ -0,0 +1,151 @@
+export declare const WA_ABPROPS_PROTOCOL_VERSION = "1";
+export declare const WA_ABPROPS_REFRESH_BOUNDS: Readonly<{
+    readonly MIN_S: 600;
+    readonly MAX_S: 604800;
+    readonly DEFAULT_S: 86400;
+}>;
+export type AbPropType = 'bool' | 'int' | 'string';
+export type AbPropValue = boolean | number | string;
+export interface AbPropConfigEntry {
+    readonly configCode: number;
+    readonly type: AbPropType;
+    readonly defaultValue: AbPropValue;
+}
+export declare const AB_PROP_CONFIGS: Readonly<{
+    readonly syncd_key_max_use_days: AbPropConfigEntry;
+    readonly syncd_wait_for_key_timeout_days: AbPropConfigEntry;
+    readonly syncd_sentinel_timeout_seconds: AbPropConfigEntry;
+    readonly syncd_inline_mutations_max_count: AbPropConfigEntry;
+    readonly syncd_patch_protobuf_max_size: AbPropConfigEntry;
+    readonly syncd_additional_mutations_count: AbPropConfigEntry;
+    readonly syncd_periodic_sync_days: AbPropConfigEntry;
+    readonly syncd_mutation_and_bundle_logging: AbPropConfigEntry;
+    readonly wa_web_enable_syncd_key_persistence_only_after_server_ack: AbPropConfigEntry;
+    readonly web_request_missing_keys_for_removes: AbPropConfigEntry;
+    readonly web_syncd_max_mutations_to_process_during_resume: AbPropConfigEntry;
+    readonly web_syncd_fatal_fields_from_L1104589PRV2: AbPropConfigEntry;
+    readonly web_enable_improved_bulk_merge: AbPropConfigEntry;
+    readonly snapshot_recovery_max_mutations_count_allowed: AbPropConfigEntry;
+    readonly md_syncd_logging_spec_enabled: AbPropConfigEntry;
+    readonly kmp_syncd_engine_crypto_enabled: AbPropConfigEntry;
+    readonly enable_syncd_debug_data_in_patch: AbPropConfigEntry;
+    readonly enable_mention_everyone_syncd_sender: AbPropConfigEntry;
+    readonly username_contact_syncd_support_enable: AbPropConfigEntry;
+    readonly newsletter_tos_notice_id: AbPropConfigEntry;
+    readonly newsletter_tos_notice_id_smb_web: AbPropConfigEntry;
+    readonly newsletter_creation_tos_id: AbPropConfigEntry;
+    readonly newsletter_creation_tos_id_smb_web: AbPropConfigEntry;
+    readonly newsletter_admin_invite_tos_id: AbPropConfigEntry;
+    readonly newsletter_admin_invite_tos_id_smb_web: AbPropConfigEntry;
+    readonly newsletter_creation_nux_id: AbPropConfigEntry;
+    readonly newsletter_nux_notice_id: AbPropConfigEntry;
+    readonly newsletter_admin_invite_nux_id: AbPropConfigEntry;
+    readonly after_read_sending_enabled: AbPropConfigEntry;
+    readonly after_read_fallback_duration: AbPropConfigEntry;
+    readonly after_read_receiver_enabled: AbPropConfigEntry;
+    readonly privacy_token_sending_on_all_1_on_1_messages: AbPropConfigEntry;
+    readonly flows_termination_message_v2_sending_enabled: AbPropConfigEntry;
+    readonly dm_initiator_trigger_groups: AbPropConfigEntry;
+    readonly placeholder_message_resend_maximum_days_limit: AbPropConfigEntry;
+    readonly message_edit_to_message_secret_sender_enabled: AbPropConfigEntry;
+    readonly message_edit_to_message_secret_receiver_enabled: AbPropConfigEntry;
+    readonly top_level_message_secret_check: AbPropConfigEntry;
+    readonly parse_encrypted_dsm_msg_fix: AbPropConfigEntry;
+    readonly rt_sender_dual_encrypted_msg_enabled: AbPropConfigEntry;
+    readonly rt_receiver_dual_encrypted_msg_enabled: AbPropConfigEntry;
+    readonly lid_one_to_one_migration_event_response_force_pn_jid: AbPropConfigEntry;
+    readonly web_anr_async_msg_send_handler: AbPropConfigEntry;
+    readonly message_keys_async_chunk_size: AbPropConfigEntry;
+    readonly synced_message_keys_processing_type: AbPropConfigEntry;
+    readonly limit_sharing_protocol_message_receiver_enabled: AbPropConfigEntry;
+    readonly web_pnless_stanzas: AbPropConfigEntry;
+    readonly wa_nct_token_send_enabled: AbPropConfigEntry;
+    readonly wa_nct_token_syncd_enabled: AbPropConfigEntry;
+    readonly wa_nct_token_history_sync_enabled: AbPropConfigEntry;
+    readonly community_announcement_group_size_limit: AbPropConfigEntry;
+    readonly group_size_limit: AbPropConfigEntry;
+    readonly group_max_subject: AbPropConfigEntry;
+    readonly group_description_length: AbPropConfigEntry;
+    readonly anyone_can_link_to_groups: AbPropConfigEntry;
+    readonly group_call_max_participants: AbPropConfigEntry;
+    readonly group_history_receive: AbPropConfigEntry;
+    readonly group_history_send: AbPropConfigEntry;
+    readonly group_history_settings: AbPropConfigEntry;
+    readonly group_history_settings_query: AbPropConfigEntry;
+    readonly group_history_message_count_limit: AbPropConfigEntry;
+    readonly group_history_message_count_receiver_upper_limit: AbPropConfigEntry;
+    readonly group_history_messages_time_limit_receiver_enforcement_secs: AbPropConfigEntry;
+    readonly group_history_bundle_time_limit_receiver_enforcement_secs: AbPropConfigEntry;
+    readonly group_history_notice_receive: AbPropConfigEntry;
+    readonly group_history_out_of_window_pin_sender: AbPropConfigEntry;
+    readonly group_history_out_of_window_pins_receiver: AbPropConfigEntry;
+    readonly group_history_reporting: AbPropConfigEntry;
+    readonly group_create_add_using_lid_jids: AbPropConfigEntry;
+    readonly group_member_updates_hide_in_thread_enabled: AbPropConfigEntry;
+    readonly group_status_receiver_enabled: AbPropConfigEntry;
+    readonly web_send_invisible_msg_max_group_size: AbPropConfigEntry;
+    readonly web_send_invisible_msg_min_group_size: AbPropConfigEntry;
+    readonly admin_only_mention_everyone_group_size: AbPropConfigEntry;
+    readonly web_abprop_drop_full_history_sync: AbPropConfigEntry;
+    readonly wa_web_history_sync_dynamic_throttling: AbPropConfigEntry;
+    readonly web_e2e_backfill_expire_time: AbPropConfigEntry;
+    readonly history_sync_on_demand: AbPropConfigEntry;
+    readonly history_sync_on_demand_message_count: AbPropConfigEntry;
+    readonly history_sync_on_demand_failure_limit: AbPropConfigEntry;
+    readonly history_sync_on_demand_cooldown_sec: AbPropConfigEntry;
+    readonly history_sync_on_demand_complete_companion: AbPropConfigEntry;
+    readonly history_sync_on_demand_with_android_beta: AbPropConfigEntry;
+    readonly web_anr_throttle_history_sync_db_writes: AbPropConfigEntry;
+    readonly web_force_lid_chats_in_history: AbPropConfigEntry;
+    readonly web_history_sync_allow_duplicate_in_bulk_error: AbPropConfigEntry;
+    readonly default_media_limit_mb: AbPropConfigEntry;
+    readonly web_image_max_edge: AbPropConfigEntry;
+    readonly web_image_max_hd_edge: AbPropConfigEntry;
+    readonly web_channel_video_server_transcode_upload: AbPropConfigEntry;
+    readonly web_deprecate_mms4_hash_based_download: AbPropConfigEntry;
+    readonly kaleidoscope_thumbnail_validation: AbPropConfigEntry;
+    readonly web_use_kaleidoscope_media_check_enabled: AbPropConfigEntry;
+    readonly low_cache_hit_rate_media_types: AbPropConfigEntry;
+    readonly web_anr_async_media_decryption_enabled: AbPropConfigEntry;
+    readonly web_anr_media_chunk_enc_delay_enabled: AbPropConfigEntry;
+    readonly web_media_compute_in_worker_enabled: AbPropConfigEntry;
+    readonly adv_accept_hosted_devices: AbPropConfigEntry;
+    readonly num_days_key_index_list_expiration: AbPropConfigEntry;
+    readonly num_days_before_device_expiry_check: AbPropConfigEntry;
+    readonly web_adv_logout_on_self_device_list_expired: AbPropConfigEntry;
+    readonly md_icdc_hash_length: AbPropConfigEntry;
+    readonly noise_pq_mode: AbPropConfigEntry;
+    readonly tctoken_duration: AbPropConfigEntry;
+    readonly tctoken_num_buckets: AbPropConfigEntry;
+    readonly tctoken_num_buckets_sender: AbPropConfigEntry;
+    readonly tctoken_duration_sender: AbPropConfigEntry;
+    readonly heartbeat_interval_s: AbPropConfigEntry;
+    readonly web_offline_message_processor_timeout_seconds: AbPropConfigEntry;
+    readonly web_offline_resume_wait_for_ping_response_enabled: AbPropConfigEntry;
+    readonly web_offline_resume_wait_for_ping_timeout_seconds: AbPropConfigEntry;
+    readonly web_comms_socket_reconnect_enabled: AbPropConfigEntry;
+    readonly web_resume_optimized_read_receipt_send_interval: AbPropConfigEntry;
+    readonly web_reaction_inactive_receipt: AbPropConfigEntry;
+    readonly lid_status_non_soaked_client_support_enabled: AbPropConfigEntry;
+    readonly s567418_mitigation_enabled: AbPropConfigEntry;
+    readonly web_signal_future_messages_max: AbPropConfigEntry;
+    readonly poll_add_option_enabled: AbPropConfigEntry;
+    readonly poll_add_option_receiving_enabled: AbPropConfigEntry;
+    readonly poll_creator_edit_enabled: AbPropConfigEntry;
+    readonly poll_creator_edit_receiving_version: AbPropConfigEntry;
+    readonly poll_end_time_enabled: AbPropConfigEntry;
+    readonly poll_end_time_receiving_enabled: AbPropConfigEntry;
+    readonly poll_hide_voters_enabled: AbPropConfigEntry;
+    readonly poll_hide_voters_receiving_enabled: AbPropConfigEntry;
+    readonly text_status_ttl_seconds_allowlist: AbPropConfigEntry;
+    readonly username_enabled_on_companion: AbPropConfigEntry;
+    readonly username_max_length: AbPropConfigEntry;
+    readonly username_min_length: AbPropConfigEntry;
+    readonly wa_individual_new_chat_msg_capping_enabled: AbPropConfigEntry;
+    readonly wa_individual_new_chat_msg_capping_limit: AbPropConfigEntry;
+    readonly wa_individual_new_chat_msg_capping_fetch_ttl_seconds: AbPropConfigEntry;
+    readonly enable_web_calling: AbPropConfigEntry;
+    readonly calling_lid_version: AbPropConfigEntry;
+}>;
+export type AbPropName = keyof typeof AB_PROP_CONFIGS;
+export declare function resolveAbPropNameByCode(configCode: number): AbPropName | undefined;

package/dist/types/protocol/appstate.d.ts

@@ -18,6 +18,8 @@ export declare const WA_APP_STATE_ERROR_CODES: Readonly<{
     readonly CONFLICT: "409";
     readonly BAD_REQUEST: "400";
     readonly NOT_FOUND: "404";
+    readonly NOT_ALLOWED: "405";
+    readonly NOT_ACCEPTABLE: "406";
 }>;
 export declare const WA_APP_STATE_SYNC_DATA_TYPE: Readonly<{
     readonly PATCH: "Patch";
@@ -29,53 +31,6 @@ export declare const WA_APP_STATE_KEY_TYPES: Readonly<{
     readonly MD_MSG_HIST: "md-msg-hist";
 }>;
 export declare const WA_APP_STATE_KDF_INFO: Readonly<{
-    readonly MUTATION_KEYS: "WhatsApp Mutation Keys";
-    readonly PATCH_INTEGRITY: "WhatsApp Patch Integrity";
-}>;
-export declare const WA_APP_STATE_CHAT_MUTATION_SPECS: Readonly<{
-    readonly STAR: {
-        readonly collection: "regular_high";
-        readonly action: "star";
-        readonly version: 2;
-    };
-    readonly MUTE: {
-        readonly collection: "regular_high";
-        readonly action: "mute";
-        readonly version: 2;
-    };
-    readonly PIN: {
-        readonly collection: "regular_low";
-        readonly action: "pin_v1";
-        readonly version: 5;
-    };
-    readonly ARCHIVE: {
-        readonly collection: "regular_low";
-        readonly action: "archive";
-        readonly version: 3;
-    };
-    readonly DELETE_MESSAGE_FOR_ME: {
-        readonly collection: "regular_high";
-        readonly action: "deleteMessageForMe";
-        readonly version: 3;
-    };
-    readonly MARK_CHAT_AS_READ: {
-        readonly collection: "regular_low";
-        readonly action: "markChatAsRead";
-        readonly version: 3;
-    };
-    readonly CLEAR_CHAT: {
-        readonly collection: "regular_high";
-        readonly action: "clearChat";
-        readonly version: 6;
-    };
-    readonly DELETE_CHAT: {
-        readonly collection: "regular_high";
-        readonly action: "deleteChat";
-        readonly version: 6;
-    };
-    readonly LOCK_CHAT: {
-        readonly collection: "regular_low";
-        readonly action: "lock";
-        readonly version: 7;
-    };
+    readonly MUTATION_KEYS: NodeJS.NonSharedUint8Array;
+    readonly PATCH_INTEGRITY: NodeJS.NonSharedUint8Array;
 }>;

package/dist/types/protocol/auth.d.ts

@@ -7,6 +7,6 @@ export declare const WA_SIGNALING: Readonly<{
     readonly COMPANION_REG_REFRESH_NOTIFICATION: "companion_reg_refresh";
 }>;
 export declare const WA_PAIRING_KDF_INFO: Readonly<{
-    readonly LINK_CODE_BUNDLE: "link_code_pairing_key_bundle_encryption_key";
-    readonly ADV_SECRET: "adv_secret";
+    readonly LINK_CODE_BUNDLE: NodeJS.NonSharedUint8Array;
+    readonly ADV_SECRET: NodeJS.NonSharedUint8Array;
 }>;

package/dist/types/protocol/bot.d.ts

@@ -0,0 +1,45 @@
+import { proto } from '..';
+export declare const WA_BOT_MSG_EDIT_TYPES: Readonly<{
+    readonly FIRST: "first";
+    readonly INNER: "inner";
+    readonly LAST: "last";
+    readonly FULL: "full";
+}>;
+export type WaBotMsgEditType = (typeof WA_BOT_MSG_EDIT_TYPES)[keyof typeof WA_BOT_MSG_EDIT_TYPES];
+export declare const WA_BOT_MSG_BODY_TYPES: Readonly<{
+    readonly PROMPT: "prompt";
+    readonly COMMAND: "command";
+    readonly VOICE: "voice";
+}>;
+export type WaBotMsgBodyType = (typeof WA_BOT_MSG_BODY_TYPES)[keyof typeof WA_BOT_MSG_BODY_TYPES];
+export declare const WA_BIZ_BOT_TYPES: Readonly<{
+    readonly ONE_P: "1";
+    readonly THREE_P: "3";
+}>;
+export type WaBizBotType = (typeof WA_BIZ_BOT_TYPES)[keyof typeof WA_BIZ_BOT_TYPES];
+export declare const WA_BOT_KNOWN_JIDS: Readonly<{
+    readonly META_AI_PN: "13135550002@s.whatsapp.net";
+    readonly META_AI_FBID: "867051314767696@bot";
+    readonly META_AI_TEE_FBID: "1273596044787272@bot";
+    readonly META_AI_SIDECHAT_FBID: "867051314767696555@bot";
+    readonly MANUS_FBID: "1807055946647696@bot";
+    readonly HATCH_FBID: "1807055946647697@bot";
+}>;
+export declare function resolveBotFbidJid(jid: string): string | null;
+export declare const WA_BOT_NODE_ATTRS: Readonly<{
+    readonly EDIT: "edit";
+    readonly EDIT_TARGET_ID: "edit_target_id";
+    readonly SENDER_TIMESTAMP_MS: "sender_timestamp_ms";
+    readonly BIZ_BOT: "biz_bot";
+    readonly TYPE: "type";
+}>;
+export declare const WA_META_NODE_ATTRS_BOT: Readonly<{
+    readonly TARGET_ID: "target_id";
+    readonly TARGET_SENDER_JID: "target_sender_jid";
+    readonly TARGET_CHAT_JID: "target_chat_jid";
+}>;
+export declare const WA_BOT_HKDF_INFO: NodeJS.NonSharedUint8Array;
+export declare const WA_BOT_MSG_SECRET_BYTES = 32;
+export declare const WA_BLOKS_VERSIONING_ID = "98153664e5d904059a94ea08a59fc7eeaf977544cec64ab3ab793c0ce001eb92";
+export declare const WA_BOT_RENDERING_PIXEL_DENSITY = 2.8125;
+export declare const WA_BOT_DEFAULT_CAPABILITIES: readonly proto.BotCapabilityMetadata.BotCapabilityType[];

package/dist/types/protocol/browser.d.ts

@@ -19,4 +19,13 @@ export declare const WA_COMPANION_PLATFORM_IDS: Readonly<{
     readonly UWP: "8";
     readonly OTHER_WEB_CLIENT: "9";
 }>;
+/**
+ * Maps a {@link WA_BROWSERS} value to the companion platform id sent in the
+ * pairing `link_code` stanza. Unknown inputs fall back to `OTHER_WEB_CLIENT`.
+ */
 export declare function getWaCompanionPlatformId(browser: string): string;
+/**
+ * Returns the human-readable browser name advertised during pairing.
+ * Unknown inputs are echoed back unchanged.
+ */
+export declare function getWaBrowserDisplayName(browser: string): string;

package/dist/types/protocol/business.d.ts

@@ -0,0 +1,21 @@
+export declare const WA_BUSINESS_HOURS_DAYS: Readonly<{
+    readonly SUN: "sun";
+    readonly MON: "mon";
+    readonly TUE: "tue";
+    readonly WED: "wed";
+    readonly THU: "thu";
+    readonly FRI: "fri";
+    readonly SAT: "sat";
+}>;
+export type WaBusinessHoursDay = (typeof WA_BUSINESS_HOURS_DAYS)[keyof typeof WA_BUSINESS_HOURS_DAYS];
+/**
+ * Per-day open mode accepted by the `business_profile` edit IQ. A closed day is
+ * expressed by omitting it from the config entirely, not by a dedicated mode.
+ * `open_time` / `close_time` are only meaningful for `specific_hours`.
+ */
+export declare const WA_BUSINESS_HOURS_MODES: Readonly<{
+    readonly OPEN_24H: "open_24h";
+    readonly SPECIFIC_HOURS: "specific_hours";
+    readonly APPOINTMENT_ONLY: "appointment_only";
+}>;
+export type WaBusinessHoursMode = (typeof WA_BUSINESS_HOURS_MODES)[keyof typeof WA_BUSINESS_HOURS_MODES];