zapo-js 0.2.0 → 1.0.0

package/dist/esm/protocol/abprops.js

@@ -0,0 +1,169 @@
+export const WA_ABPROPS_PROTOCOL_VERSION = '1';
+export const WA_ABPROPS_REFRESH_BOUNDS = Object.freeze({
+    MIN_S: 600,
+    MAX_S: 604800,
+    DEFAULT_S: 86400
+});
+function prop(configCode, type, defaultValue) {
+    return { configCode, type, defaultValue };
+}
+export const AB_PROP_CONFIGS = Object.freeze({
+    // --- app state sync (syncd) ---
+    syncd_key_max_use_days: prop(5498, 'int', 90),
+    syncd_wait_for_key_timeout_days: prop(5499, 'int', 30),
+    syncd_sentinel_timeout_seconds: prop(5500, 'int', 60),
+    syncd_inline_mutations_max_count: prop(5501, 'int', 1000),
+    syncd_patch_protobuf_max_size: prop(5502, 'int', 1048576),
+    syncd_additional_mutations_count: prop(2777, 'int', 1),
+    syncd_periodic_sync_days: prop(1400, 'int', 0),
+    syncd_mutation_and_bundle_logging: prop(11821, 'string', '{"allowlist": []}'),
+    wa_web_enable_syncd_key_persistence_only_after_server_ack: prop(27069, 'bool', false),
+    web_request_missing_keys_for_removes: prop(11695, 'bool', false),
+    web_syncd_max_mutations_to_process_during_resume: prop(15808, 'int', 10000),
+    web_syncd_fatal_fields_from_L1104589PRV2: prop(1808, 'bool', false),
+    web_enable_improved_bulk_merge: prop(19854, 'bool', false),
+    snapshot_recovery_max_mutations_count_allowed: prop(18786, 'int', 2000),
+    md_syncd_logging_spec_enabled: prop(14499, 'bool', false),
+    kmp_syncd_engine_crypto_enabled: prop(15909, 'bool', false),
+    enable_syncd_debug_data_in_patch: prop(6614, 'bool', false),
+    enable_mention_everyone_syncd_sender: prop(24244, 'bool', false),
+    username_contact_syncd_support_enable: prop(17614, 'bool', false),
+    // --- newsletter ToS / NUX notice ids ---
+    newsletter_tos_notice_id: prop(3810, 'string', '20601216'),
+    newsletter_tos_notice_id_smb_web: prop(5597, 'string', '20601216'),
+    newsletter_creation_tos_id: prop(3834, 'string', '20601217'),
+    newsletter_creation_tos_id_smb_web: prop(5598, 'string', '20601217'),
+    newsletter_admin_invite_tos_id: prop(6498, 'string', '20610101'),
+    newsletter_admin_invite_tos_id_smb_web: prop(6536, 'string', '20610104'),
+    newsletter_creation_nux_id: prop(3835, 'string', '20601218'),
+    newsletter_nux_notice_id: prop(15255, 'string', '20610210'),
+    newsletter_admin_invite_nux_id: prop(15256, 'string', '20610220'),
+    // --- message sending / encryption ---
+    after_read_sending_enabled: prop(7293, 'bool', false),
+    after_read_fallback_duration: prop(7294, 'int', 86400),
+    after_read_receiver_enabled: prop(7295, 'bool', false),
+    privacy_token_sending_on_all_1_on_1_messages: prop(9281, 'bool', false),
+    flows_termination_message_v2_sending_enabled: prop(9157, 'bool', false),
+    dm_initiator_trigger_groups: prop(7141, 'bool', false),
+    placeholder_message_resend_maximum_days_limit: prop(3639, 'int', 14),
+    message_edit_to_message_secret_sender_enabled: prop(16057, 'bool', false),
+    message_edit_to_message_secret_receiver_enabled: prop(17811, 'bool', false),
+    top_level_message_secret_check: prop(23796, 'bool', false),
+    parse_encrypted_dsm_msg_fix: prop(26772, 'bool', false),
+    rt_sender_dual_encrypted_msg_enabled: prop(12623, 'bool', true),
+    rt_receiver_dual_encrypted_msg_enabled: prop(15258, 'bool', true),
+    lid_one_to_one_migration_event_response_force_pn_jid: prop(15791, 'bool', false),
+    web_anr_async_msg_send_handler: prop(27249, 'bool', false),
+    message_keys_async_chunk_size: prop(22815, 'int', 50),
+    synced_message_keys_processing_type: prop(22825, 'string', 'control'),
+    limit_sharing_protocol_message_receiver_enabled: prop(15129, 'bool', false),
+    web_pnless_stanzas: prop(26211, 'bool', false),
+    // --- NCT tokens ---
+    wa_nct_token_send_enabled: prop(24941, 'bool', false),
+    wa_nct_token_syncd_enabled: prop(25253, 'bool', false),
+    wa_nct_token_history_sync_enabled: prop(25189, 'bool', false),
+    // --- group ---
+    community_announcement_group_size_limit: prop(2774, 'int', 5000),
+    group_size_limit: prop(1304, 'int', 257),
+    group_max_subject: prop(3597, 'int', 100),
+    group_description_length: prop(14778, 'int', 2048),
+    anyone_can_link_to_groups: prop(3978, 'bool', false),
+    group_call_max_participants: prop(4190, 'int', 32),
+    group_history_receive: prop(15311, 'bool', false),
+    group_history_send: prop(15313, 'bool', false),
+    group_history_settings: prop(21261, 'bool', false),
+    group_history_settings_query: prop(22230, 'bool', false),
+    group_history_message_count_limit: prop(18405, 'int', 100),
+    group_history_message_count_receiver_upper_limit: prop(19811, 'int', 100),
+    group_history_messages_time_limit_receiver_enforcement_secs: prop(21313, 'int', 1209600),
+    group_history_bundle_time_limit_receiver_enforcement_secs: prop(25910, 'int', 1209600),
+    group_history_notice_receive: prop(15722, 'bool', false),
+    group_history_out_of_window_pin_sender: prop(26037, 'bool', false),
+    group_history_out_of_window_pins_receiver: prop(26039, 'bool', false),
+    group_history_reporting: prop(22329, 'bool', true),
+    group_create_add_using_lid_jids: prop(16192, 'bool', false),
+    group_member_updates_hide_in_thread_enabled: prop(24584, 'bool', false),
+    group_status_receiver_enabled: prop(13956, 'bool', false),
+    web_send_invisible_msg_max_group_size: prop(13289, 'int', 256),
+    web_send_invisible_msg_min_group_size: prop(13290, 'int', 50),
+    admin_only_mention_everyone_group_size: prop(18500, 'int', 0),
+    // --- history sync ---
+    web_abprop_drop_full_history_sync: prop(13034, 'bool', false),
+    wa_web_history_sync_dynamic_throttling: prop(19110, 'bool', true),
+    web_e2e_backfill_expire_time: prop(3234, 'int', 5),
+    history_sync_on_demand: prop(3337, 'bool', false),
+    history_sync_on_demand_message_count: prop(3811, 'int', 50),
+    history_sync_on_demand_failure_limit: prop(4364, 'int', 10),
+    history_sync_on_demand_cooldown_sec: prop(4365, 'int', 7200),
+    history_sync_on_demand_complete_companion: prop(21024, 'bool', false),
+    history_sync_on_demand_with_android_beta: prop(4135, 'bool', false),
+    web_anr_throttle_history_sync_db_writes: prop(19298, 'bool', false),
+    web_force_lid_chats_in_history: prop(24343, 'bool', false),
+    web_history_sync_allow_duplicate_in_bulk_error: prop(10842, 'bool', false),
+    // --- media ---
+    default_media_limit_mb: prop(3660, 'int', 16),
+    web_image_max_edge: prop(10371, 'int', 1600),
+    web_image_max_hd_edge: prop(3204, 'int', 2560),
+    web_channel_video_server_transcode_upload: prop(19920, 'bool', false),
+    web_deprecate_mms4_hash_based_download: prop(3152, 'bool', false),
+    kaleidoscope_thumbnail_validation: prop(18114, 'bool', false),
+    web_use_kaleidoscope_media_check_enabled: prop(20375, 'bool', false),
+    low_cache_hit_rate_media_types: prop(4836, 'string', 'ptt,audio,document,ppic'),
+    web_anr_async_media_decryption_enabled: prop(23200, 'bool', false),
+    web_anr_media_chunk_enc_delay_enabled: prop(22931, 'bool', false),
+    web_media_compute_in_worker_enabled: prop(25641, 'bool', false),
+    // --- device management / auth ---
+    adv_accept_hosted_devices: prop(6939, 'bool', false),
+    num_days_key_index_list_expiration: prop(730, 'int', 35),
+    num_days_before_device_expiry_check: prop(731, 'int', 7),
+    web_adv_logout_on_self_device_list_expired: prop(11011, 'bool', false),
+    md_icdc_hash_length: prop(310, 'int', 10),
+    noise_pq_mode: prop(20161, 'int', 0),
+    // --- trusted contacts / privacy tokens ---
+    tctoken_duration: prop(865, 'int', 604800),
+    tctoken_num_buckets: prop(909, 'int', 4),
+    tctoken_num_buckets_sender: prop(997, 'int', 4),
+    tctoken_duration_sender: prop(996, 'int', 604800),
+    // --- connection / offline ---
+    heartbeat_interval_s: prop(1430, 'int', 10),
+    web_offline_message_processor_timeout_seconds: prop(12834, 'int', 15),
+    web_offline_resume_wait_for_ping_response_enabled: prop(14567, 'bool', false),
+    web_offline_resume_wait_for_ping_timeout_seconds: prop(14568, 'int', 5),
+    web_comms_socket_reconnect_enabled: prop(7854, 'bool', false),
+    // --- receipts ---
+    web_resume_optimized_read_receipt_send_interval: prop(13978, 'int', 3000),
+    web_reaction_inactive_receipt: prop(25954, 'bool', false),
+    lid_status_non_soaked_client_support_enabled: prop(19696, 'bool', true),
+    // --- signal protocol ---
+    s567418_mitigation_enabled: prop(22029, 'bool', true),
+    web_signal_future_messages_max: prop(12509, 'int', 20000),
+    // --- polls ---
+    poll_add_option_enabled: prop(24517, 'bool', false),
+    poll_add_option_receiving_enabled: prop(25758, 'int', 0),
+    poll_creator_edit_enabled: prop(24887, 'bool', false),
+    poll_creator_edit_receiving_version: prop(24886, 'int', 0),
+    poll_end_time_enabled: prop(24405, 'bool', false),
+    poll_end_time_receiving_enabled: prop(24884, 'bool', false),
+    poll_hide_voters_enabled: prop(24518, 'bool', false),
+    poll_hide_voters_receiving_enabled: prop(24885, 'int', 0),
+    // --- status / ephemeral ---
+    text_status_ttl_seconds_allowlist: prop(6153, 'string', '1800,3600,7200,14400,28800,86400'),
+    // --- username ---
+    username_enabled_on_companion: prop(23817, 'bool', false),
+    username_max_length: prop(20459, 'int', 35),
+    username_min_length: prop(20494, 'int', 3),
+    // --- message capping ---
+    wa_individual_new_chat_msg_capping_enabled: prop(20865, 'bool', false),
+    wa_individual_new_chat_msg_capping_limit: prop(17845, 'int', 0),
+    wa_individual_new_chat_msg_capping_fetch_ttl_seconds: prop(20649, 'int', 3600),
+    // --- calling ---
+    enable_web_calling: prop(15461, 'bool', false),
+    calling_lid_version: prop(3358, 'int', 0)
+});
+const CONFIG_CODE_TO_NAME = new Map();
+for (const [name, entry] of Object.entries(AB_PROP_CONFIGS)) {
+    CONFIG_CODE_TO_NAME.set(entry.configCode, name);
+}
+export function resolveAbPropNameByCode(configCode) {
+    return CONFIG_CODE_TO_NAME.get(configCode);
+}

package/dist/esm/protocol/appstate.js

@@ -1,3 +1,4 @@
+import { TEXT_ENCODER } from '../util/bytes.js';
 export const WA_APP_STATE_COLLECTIONS = Object.freeze({
     REGULAR: 'regular',
     REGULAR_LOW: 'regular_low',
@@ -17,7 +18,9 @@ export const WA_APP_STATE_COLLECTION_STATES = Object.freeze({
 export const WA_APP_STATE_ERROR_CODES = Object.freeze({
     CONFLICT: '409',
     BAD_REQUEST: '400',
-    NOT_FOUND: '404'
+    NOT_FOUND: '404',
+    NOT_ALLOWED: '405',
+    NOT_ACCEPTABLE: '406'
 });
 export const WA_APP_STATE_SYNC_DATA_TYPE = Object.freeze({
     PATCH: 'Patch',
@@ -29,33 +32,6 @@ export const WA_APP_STATE_KEY_TYPES = Object.freeze({
     MD_MSG_HIST: 'md-msg-hist'
 });
 export const WA_APP_STATE_KDF_INFO = Object.freeze({
-    MUTATION_KEYS: 'WhatsApp Mutation Keys',
-    PATCH_INTEGRITY: 'WhatsApp Patch Integrity'
-});
-export const WA_APP_STATE_CHAT_MUTATION_SPECS = Object.freeze({
-    STAR: { collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH, action: 'star', version: 2 },
-    MUTE: { collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH, action: 'mute', version: 2 },
-    PIN: { collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW, action: 'pin_v1', version: 5 },
-    ARCHIVE: { collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW, action: 'archive', version: 3 },
-    DELETE_MESSAGE_FOR_ME: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH,
-        action: 'deleteMessageForMe',
-        version: 3
-    },
-    MARK_CHAT_AS_READ: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW,
-        action: 'markChatAsRead',
-        version: 3
-    },
-    CLEAR_CHAT: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH,
-        action: 'clearChat',
-        version: 6
-    },
-    DELETE_CHAT: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH,
-        action: 'deleteChat',
-        version: 6
-    },
-    LOCK_CHAT: { collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW, action: 'lock', version: 7 }
+    MUTATION_KEYS: TEXT_ENCODER.encode('WhatsApp Mutation Keys'),
+    PATCH_INTEGRITY: TEXT_ENCODER.encode('WhatsApp Patch Integrity')
 });

package/dist/esm/protocol/auth.js

@@ -1,3 +1,4 @@
+import { TEXT_ENCODER } from '../util/bytes.js';
 export const WA_SIGNALING = Object.freeze({
     LINK_CODE_STAGE_COMPANION_HELLO: 'companion_hello',
     LINK_CODE_STAGE_GET_COUNTRY_CODE: 'get_country_code',
@@ -7,6 +8,6 @@ export const WA_SIGNALING = Object.freeze({
     COMPANION_REG_REFRESH_NOTIFICATION: 'companion_reg_refresh'
 });
 export const WA_PAIRING_KDF_INFO = Object.freeze({
-    LINK_CODE_BUNDLE: 'link_code_pairing_key_bundle_encryption_key',
-    ADV_SECRET: 'adv_secret'
+    LINK_CODE_BUNDLE: TEXT_ENCODER.encode('link_code_pairing_key_bundle_encryption_key'),
+    ADV_SECRET: TEXT_ENCODER.encode('adv_secret')
 });

package/dist/esm/protocol/bot.js

@@ -0,0 +1,77 @@
+import { proto } from '../proto.js';
+import { WA_DEFAULTS } from './defaults.js';
+import { isBotJid } from './jid.js';
+import { TEXT_ENCODER } from '../util/bytes.js';
+export const WA_BOT_MSG_EDIT_TYPES = Object.freeze({
+    FIRST: 'first',
+    INNER: 'inner',
+    LAST: 'last',
+    FULL: 'full'
+});
+export const WA_BOT_MSG_BODY_TYPES = Object.freeze({
+    PROMPT: 'prompt',
+    COMMAND: 'command',
+    VOICE: 'voice'
+});
+export const WA_BIZ_BOT_TYPES = Object.freeze({
+    ONE_P: '1',
+    THREE_P: '3'
+});
+const META_AI_PN_USER = '13135550002';
+const META_AI_FBID_USER = '867051314767696';
+const META_AI_TEE_FBID_USER = '1273596044787272';
+const META_AI_SIDECHAT_FBID_USER = '867051314767696555';
+const MANUS_FBID_USER = '1807055946647696';
+const HATCH_FBID_USER = '1807055946647697';
+export const WA_BOT_KNOWN_JIDS = Object.freeze({
+    META_AI_PN: `${META_AI_PN_USER}@${WA_DEFAULTS.HOST_DOMAIN}`,
+    META_AI_FBID: `${META_AI_FBID_USER}@${WA_DEFAULTS.BOT_SERVER}`,
+    META_AI_TEE_FBID: `${META_AI_TEE_FBID_USER}@${WA_DEFAULTS.BOT_SERVER}`,
+    META_AI_SIDECHAT_FBID: `${META_AI_SIDECHAT_FBID_USER}@${WA_DEFAULTS.BOT_SERVER}`,
+    MANUS_FBID: `${MANUS_FBID_USER}@${WA_DEFAULTS.BOT_SERVER}`,
+    HATCH_FBID: `${HATCH_FBID_USER}@${WA_DEFAULTS.BOT_SERVER}`
+});
+const PN_TO_FBID_BOT = Object.freeze({
+    [WA_BOT_KNOWN_JIDS.META_AI_PN]: WA_BOT_KNOWN_JIDS.META_AI_FBID
+});
+export function resolveBotFbidJid(jid) {
+    if (isBotJid(jid))
+        return jid;
+    return PN_TO_FBID_BOT[jid] ?? null;
+}
+export const WA_BOT_NODE_ATTRS = Object.freeze({
+    EDIT: 'edit',
+    EDIT_TARGET_ID: 'edit_target_id',
+    SENDER_TIMESTAMP_MS: 'sender_timestamp_ms',
+    BIZ_BOT: 'biz_bot',
+    TYPE: 'type'
+});
+export const WA_META_NODE_ATTRS_BOT = Object.freeze({
+    TARGET_ID: 'target_id',
+    TARGET_SENDER_JID: 'target_sender_jid',
+    TARGET_CHAT_JID: 'target_chat_jid'
+});
+export const WA_BOT_HKDF_INFO = TEXT_ENCODER.encode('Bot Message');
+export const WA_BOT_MSG_SECRET_BYTES = 32;
+// Without a matching Bloks hash, Meta AI silently drops invoke mentions.
+// Bump alongside the Bloks bundle versions shipped by WA Web.
+export const WA_BLOKS_VERSIONING_ID = '98153664e5d904059a94ea08a59fc7eeaf977544cec64ab3ab793c0ce001eb92';
+export const WA_BOT_RENDERING_PIXEL_DENSITY = 2.8125;
+// Default rich-response capability set; bots may reject prompts without one.
+export const WA_BOT_DEFAULT_CAPABILITIES = Object.freeze([
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_HEADING,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_NESTED_LIST,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_TABLE,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_CODE,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_STRUCTURED_RESPONSE,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_SUB_HEADING,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_LATEX,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_INLINE_REELS,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_LATEX_INLINE,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_UNIFIED_RESPONSE,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_SOURCES_IN_MESSAGE,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_UNIFIED_TEXT_COMPONENT,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_UNIFIED_SOURCES,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_UNIFIED_DOMAIN_CITATIONS,
+    proto.BotCapabilityMetadata.BotCapabilityType.RICH_RESPONSE_UR_INLINE_REELS_ENABLED
+]);

package/dist/esm/protocol/browser.js

@@ -7,6 +7,8 @@ export const WA_BROWSERS = Object.freeze({
     OPERA: 'opera',
     EDGE: 'edge'
 });
+// Distinct from proto.DeviceProps.PlatformType: these are the string IDs sent
+// as companionPlatformId in the pairing link_code XML stanza, not the proto enum.
 export const WA_COMPANION_PLATFORM_IDS = Object.freeze({
     UNKNOWN: '0',
     CHROME: '1',
@@ -27,7 +29,27 @@ const BROWSER_TO_PLATFORM_ID = {
     [WA_BROWSERS.SAFARI]: WA_COMPANION_PLATFORM_IDS.SAFARI,
     [WA_BROWSERS.EDGE]: WA_COMPANION_PLATFORM_IDS.EDGE
 };
+const BROWSER_TO_DISPLAY_NAME = {
+    [WA_BROWSERS.CHROME]: 'Chrome',
+    [WA_BROWSERS.CHROMIUM]: 'Chromium',
+    [WA_BROWSERS.FIREFOX]: 'Firefox',
+    [WA_BROWSERS.IE]: 'IE',
+    [WA_BROWSERS.OPERA]: 'Opera',
+    [WA_BROWSERS.SAFARI]: 'Safari',
+    [WA_BROWSERS.EDGE]: 'Edge'
+};
+/**
+ * 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 function getWaCompanionPlatformId(browser) {
     return (BROWSER_TO_PLATFORM_ID[browser.trim().toLowerCase()] ??
         WA_COMPANION_PLATFORM_IDS.OTHER_WEB_CLIENT);
 }
+/**
+ * Returns the human-readable browser name advertised during pairing.
+ * Unknown inputs are echoed back unchanged.
+ */
+export function getWaBrowserDisplayName(browser) {
+    return BROWSER_TO_DISPLAY_NAME[browser.trim().toLowerCase()] ?? browser;
+}

package/dist/esm/protocol/business.js

@@ -0,0 +1,19 @@
+export const WA_BUSINESS_HOURS_DAYS = Object.freeze({
+    SUN: 'sun',
+    MON: 'mon',
+    TUE: 'tue',
+    WED: 'wed',
+    THU: 'thu',
+    FRI: 'fri',
+    SAT: 'sat'
+});
+/**
+ * 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 const WA_BUSINESS_HOURS_MODES = Object.freeze({
+    OPEN_24H: 'open_24h',
+    SPECIFIC_HOURS: 'specific_hours',
+    APPOINTMENT_ONLY: 'appointment_only'
+});

package/dist/esm/protocol/call.js

@@ -0,0 +1,48 @@
+export const WA_CALL_PAYLOAD_TAGS = Object.freeze({
+    OFFER: 'offer',
+    OFFER_NOTICE: 'offer_notice',
+    ACCEPT: 'accept',
+    PREACCEPT: 'preaccept',
+    REJECT: 'reject',
+    TERMINATE: 'terminate',
+    TRANSPORT: 'transport',
+    MUTE: 'mute',
+    VIDEO_STATE: 'video_state',
+    GROUP_INFO: 'group_info',
+    GROUP_UPDATE: 'group_update',
+    ENC_REKEY: 'enc_rekey',
+    PEER_STATE: 'peer_state',
+    FLOW_CONTROL: 'flow_control',
+    WEB_CLIENT: 'web_client'
+});
+/**
+ * Payload tags that wa-web responds to with a `<receipt>` carrying a typed
+ * child node (`<offer call-id call-creator/>`, etc.) instead of a plain
+ * `<ack class="call"/>`. Source: `WAWebHandleVoipCall.js`.
+ */
+export const WA_CALL_RECEIPT_PAYLOAD_TAGS = new Set([
+    WA_CALL_PAYLOAD_TAGS.OFFER,
+    WA_CALL_PAYLOAD_TAGS.ACCEPT,
+    WA_CALL_PAYLOAD_TAGS.REJECT,
+    WA_CALL_PAYLOAD_TAGS.ENC_REKEY
+]);
+export const WA_CALL_NODE_ATTRS = Object.freeze({
+    CALL_ID: 'call-id',
+    CALL_CREATOR: 'call-creator',
+    GROUP_JID: 'group-jid',
+    CALLER_PN: 'caller_pn',
+    CALLER_COUNTRY_CODE: 'caller_country_code',
+    USERNAME: 'username',
+    NOTIFY: 'notify',
+    SENDER_LID: 'sender_lid',
+    PLATFORM: 'platform',
+    VERSION: 'version',
+    REASON: 'reason',
+    USER_PN: 'user_pn',
+    GUEST_NAME: 'guest_name'
+});
+export const WA_CALL_CHILD_TAGS = Object.freeze({
+    VIDEO: 'video',
+    SILENCE: 'silence',
+    GROUP_INFO: 'group_info'
+});

package/dist/esm/protocol/constants.js

@@ -2,13 +2,21 @@ export { getWaCompanionPlatformId, WA_BROWSERS, WA_COMPANION_PLATFORM_IDS } from
 export { WA_SIGNALING, WA_PAIRING_KDF_INFO } from './auth.js';
 export { WA_CONNECTION_REASONS, WA_DISCONNECT_REASONS, WA_FAILURE_REASONS, WA_LOGOUT_REASONS, WA_READY_STATES, WA_STREAM_SIGNALING } from './stream.js';
 export { WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from './nodes.js';
+export { WA_CALL_CHILD_TAGS, WA_CALL_NODE_ATTRS, WA_CALL_PAYLOAD_TAGS, WA_CALL_RECEIPT_PAYLOAD_TAGS } from './call.js';
 export { WA_EDIT_ATTRS, WA_ENC_MEDIA_TYPES, WA_EVENT_META_TYPES, WA_MESSAGE_TAGS, WA_MESSAGE_TYPES, WA_POLL_META_TYPES, WA_RETRYABLE_ACK_CODES, WA_STANZA_MSG_TYPES } from './message.js';
-export { WA_APP_STATE_COLLECTIONS, WA_APP_STATE_COLLECTION_STATES, WA_APP_STATE_CHAT_MUTATION_SPECS, WA_APP_STATE_ERROR_CODES, WA_APP_STATE_KDF_INFO, WA_APP_STATE_KEY_TYPES, WA_APP_STATE_SYNC_DATA_TYPE } from './appstate.js';
+export { WA_APP_STATE_COLLECTIONS, WA_APP_STATE_COLLECTION_STATES, WA_APP_STATE_ERROR_CODES, WA_APP_STATE_KDF_INFO, WA_APP_STATE_KEY_TYPES, WA_APP_STATE_SYNC_DATA_TYPE } from './appstate.js';
 export { getWaMediaHkdfInfo, WA_MEDIA_HKDF_INFO, WA_PREVIEW_MEDIA_HKDF_INFO } from './media.js';
 export { WA_ACCOUNT_SYNC_PROTOCOLS, WA_DIRTY_PROTOCOLS, WA_DIRTY_TYPES, WA_SUPPORTED_DIRTY_TYPES } from './dirty.js';
-export { WA_GROUP_NOTIFICATION_TAGS, WA_NOTIFICATION_TYPES } from './notification.js';
+export { WA_BUSINESS_NOTIFICATION_TAGS, WA_GROUP_NOTIFICATION_TAGS, WA_NEWSLETTER_NOTIFICATION_TAGS, WA_NOTIFICATION_TYPES, WA_REGISTRATION_NOTIFICATION_TAGS } from './notification.js';
+export { WA_BUSINESS_HOURS_DAYS, WA_BUSINESS_HOURS_MODES } from './business.js';
+export { WA_CHATSTATE_MEDIA, WA_PRESENCE_LAST_SENTINELS, WA_PRESENCE_TYPES } from './presence.js';
 export { WA_PRIVACY_TOKEN_NOTIFICATION_TYPE, WA_PRIVACY_TOKEN_TAGS, WA_PRIVACY_TOKEN_TYPES, WA_TC_TOKEN_DEFAULTS } from './privacy-token.js';
 export { WA_PRIVACY_CATEGORIES, WA_PRIVACY_CATEGORY_TO_SETTING, WA_PRIVACY_DISALLOWED_LIST_CATEGORIES, WA_PRIVACY_SETTING_TO_CATEGORY, WA_PRIVACY_TAGS, WA_PRIVACY_VALUES } from './privacy.js';
 export { WA_DEFAULTS } from './defaults.js';
+export { WA_BIZ_BOT_TYPES, WA_BOT_DEFAULT_CAPABILITIES, WA_BOT_HKDF_INFO, WA_BOT_KNOWN_JIDS, WA_BOT_MSG_BODY_TYPES, WA_BOT_MSG_EDIT_TYPES, WA_BOT_MSG_SECRET_BYTES, WA_BOT_NODE_ATTRS, WA_META_NODE_ATTRS_BOT } from './bot.js';
+export { WA_STATUS_DISTRIBUTION_SETTINGS } from './status.js';
+export { WA_EMAIL_CONTEXTS, WA_EMAIL_ERROR_CODES, WA_EMAIL_LIMITS, WA_EMAIL_TAGS, WA_EMAIL_XMLNS } from './email.js';
+export { AB_PROP_CONFIGS, resolveAbPropNameByCode, WA_ABPROPS_PROTOCOL_VERSION, WA_ABPROPS_REFRESH_BOUNDS } from './abprops.js';
 export { WA_GROUP_PARTICIPANT_TYPES } from './group.js';
 export { WA_USYNC_CONTEXTS, WA_USYNC_DEFAULTS, WA_USYNC_MODES } from './usync.js';
+export { WA_NEWSLETTER_FETCH_KEY_TYPES, WA_NEWSLETTER_MUTE_TYPES, WA_NEWSLETTER_MUTE_VALUES, WA_NEWSLETTER_PICTURE_TYPES, WA_NEWSLETTER_RECEIVE_TYPES, WA_NEWSLETTER_ROLES, WA_NEWSLETTER_SEND_TYPES, WA_NEWSLETTER_STATE_TYPES, WA_NEWSLETTER_VERIFICATION_STATES, WA_NEWSLETTER_VIEW_ROLES } from './newsletter.js';

package/dist/esm/protocol/defaults.js

@@ -9,6 +9,9 @@ export const WA_DEFAULTS = Object.freeze({
     HOSTED_DEVICE_ID: 99,
     MSGR_SERVER: 'msgr',
     INTEROP_SERVER: 'interop',
+    NEWSLETTER_SERVER: 'newsletter',
+    BOT_SERVER: 'bot',
+    STATUS_BROADCAST_JID: 'status@broadcast',
     DEVICE_BROWSER: WA_BROWSERS.FIREFOX,
     DEVICE_PLATFORM: getWaCompanionPlatformId(WA_BROWSERS.FIREFOX),
     CHAT_SOCKET_URLS: ['wss://web.whatsapp.com/ws/chat', 'wss://web.whatsapp.com:5222/ws/chat'],

package/dist/esm/protocol/email.js

@@ -0,0 +1,30 @@
+export const WA_EMAIL_XMLNS = 'urn:xmpp:whatsapp:account';
+export const WA_EMAIL_TAGS = Object.freeze({
+    EMAIL: 'email',
+    EMAIL_ADDRESS: 'email_address',
+    VERIFY_EMAIL: 'verify_email',
+    CONFIRM_EMAIL: 'confirm_email',
+    CONTEXT: 'context',
+    CODE: 'code',
+    LG: 'lg',
+    LC: 'lc',
+    AUTO_VERIFY: 'auto_verify',
+    CONFIRMED: 'confirmed'
+});
+export const WA_EMAIL_CONTEXTS = Object.freeze({
+    ONBOARDING: 'onboarding',
+    SETTINGS: 'settings'
+});
+export const WA_EMAIL_LIMITS = Object.freeze({
+    EMAIL_MAX_LENGTH: 320,
+    CODE_LENGTH: 6,
+    LOCALE_MIN_LENGTH: 2,
+    LOCALE_MAX_LENGTH: 3
+});
+export const WA_EMAIL_ERROR_CODES = Object.freeze({
+    FORBIDDEN: 403,
+    LOCKOUT: 534,
+    CODE_EXPIRED: 535,
+    CODE_INCORRECT: 536,
+    TOO_MANY_RETRIES: 537
+});

package/dist/esm/protocol/index.js

@@ -1,2 +1,2 @@
 export * from './constants.js';
-export { buildDeviceJid, canonicalizeSignalJid, canonicalizeSignalServer, getLoginIdentity, isHostedDeviceId, isHostedDeviceJid, isHostedServer, isGroupJid, normalizeDeviceJid, normalizeRecipientJid, parsePhoneJid, parseSignalAddressFromJid, splitJid, signalAddressKey, toUserJid } from './jid.js';
+export { applyDeviceToJid, buildDeviceJid, canonicalizeSignalJid, canonicalizeSignalServer, getLoginIdentity, isBotJid, isBroadcastJid, isGroupJid, isGroupOrBroadcastJid, isHostedDeviceId, isHostedDeviceJid, isHostedServer, isLidJid, isNewsletterJid, isStatusBroadcastJid, isUserJid, normalizeDeviceJid, normalizeRecipientJid, parseJidFull, parsePhoneJid, parseSignalAddressFromJid, signalAddressKey, splitJid, toUserJid } from './jid.js';