zapo-js 0.1.2 → 0.3.0

package/dist/esm/protocol/abprops.js

@@ -0,0 +1,159 @@
+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),
+    // --- 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

@@ -32,61 +32,30 @@ 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_ACTIONS = Object.freeze({
-    STAR: 'star',
-    MUTE: 'mute',
-    PIN: 'pin_v1',
-    ARCHIVE: 'archive',
-    DELETE_MESSAGE_FOR_ME: 'deleteMessageForMe',
-    MARK_CHAT_AS_READ: 'markChatAsRead',
-    CLEAR_CHAT: 'clearChat',
-    DELETE_CHAT: 'deleteChat',
-    LOCK_CHAT: 'lock'
-});
 export const WA_APP_STATE_CHAT_MUTATION_SPECS = Object.freeze({
-    STAR: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH,
-        action: WA_APP_STATE_CHAT_MUTATION_ACTIONS.STAR,
-        version: 2
-    },
-    MUTE: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH,
-        action: WA_APP_STATE_CHAT_MUTATION_ACTIONS.MUTE,
-        version: 2
-    },
-    PIN: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW,
-        action: WA_APP_STATE_CHAT_MUTATION_ACTIONS.PIN,
-        version: 5
-    },
-    ARCHIVE: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW,
-        action: WA_APP_STATE_CHAT_MUTATION_ACTIONS.ARCHIVE,
-        version: 3
-    },
+    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: WA_APP_STATE_CHAT_MUTATION_ACTIONS.DELETE_MESSAGE_FOR_ME,
+        action: 'deleteMessageForMe',
         version: 3
     },
     MARK_CHAT_AS_READ: {
         collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW,
-        action: WA_APP_STATE_CHAT_MUTATION_ACTIONS.MARK_CHAT_AS_READ,
+        action: 'markChatAsRead',
         version: 3
     },
     CLEAR_CHAT: {
         collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH,
-        action: WA_APP_STATE_CHAT_MUTATION_ACTIONS.CLEAR_CHAT,
+        action: 'clearChat',
         version: 6
     },
     DELETE_CHAT: {
         collection: WA_APP_STATE_COLLECTIONS.REGULAR_HIGH,
-        action: WA_APP_STATE_CHAT_MUTATION_ACTIONS.DELETE_CHAT,
+        action: 'deleteChat',
         version: 6
     },
-    LOCK_CHAT: {
-        collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW,
-        action: WA_APP_STATE_CHAT_MUTATION_ACTIONS.LOCK_CHAT,
-        version: 7
-    }
+    LOCK_CHAT: { collection: WA_APP_STATE_COLLECTIONS.REGULAR_LOW, action: 'lock', version: 7 }
 });

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',
@@ -19,23 +21,27 @@ export const WA_COMPANION_PLATFORM_IDS = Object.freeze({
     UWP: '8',
     OTHER_WEB_CLIENT: '9'
 });
+const BROWSER_TO_PLATFORM_ID = {
+    [WA_BROWSERS.CHROME]: WA_COMPANION_PLATFORM_IDS.CHROME,
+    [WA_BROWSERS.FIREFOX]: WA_COMPANION_PLATFORM_IDS.FIREFOX,
+    [WA_BROWSERS.IE]: WA_COMPANION_PLATFORM_IDS.IE,
+    [WA_BROWSERS.OPERA]: WA_COMPANION_PLATFORM_IDS.OPERA,
+    [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'
+};
 export function getWaCompanionPlatformId(browser) {
-    const normalized = browser.trim().toLowerCase();
-    switch (normalized) {
-        case WA_BROWSERS.CHROME:
-            return WA_COMPANION_PLATFORM_IDS.CHROME;
-        case WA_BROWSERS.FIREFOX:
-            return WA_COMPANION_PLATFORM_IDS.FIREFOX;
-        case WA_BROWSERS.IE:
-            return WA_COMPANION_PLATFORM_IDS.IE;
-        case WA_BROWSERS.OPERA:
-            return WA_COMPANION_PLATFORM_IDS.OPERA;
-        case WA_BROWSERS.SAFARI:
-            return WA_COMPANION_PLATFORM_IDS.SAFARI;
-        case WA_BROWSERS.EDGE:
-            return WA_COMPANION_PLATFORM_IDS.EDGE;
-        case WA_BROWSERS.CHROMIUM:
-        default:
-            return WA_COMPANION_PLATFORM_IDS.OTHER_WEB_CLIENT;
-    }
+    return (BROWSER_TO_PLATFORM_ID[browser.trim().toLowerCase()] ??
+        WA_COMPANION_PLATFORM_IDS.OTHER_WEB_CLIENT);
+}
+export function getWaBrowserDisplayName(browser) {
+    return BROWSER_TO_DISPLAY_NAME[browser.trim().toLowerCase()] ?? browser;
 }

package/dist/esm/protocol/constants.js

@@ -1,12 +1,16 @@
 export { getWaCompanionPlatformId, WA_BROWSERS, WA_COMPANION_PLATFORM_IDS } from './browser.js';
 export { WA_SIGNALING, WA_PAIRING_KDF_INFO } from './auth.js';
-export { WA_DISCONNECT_REASONS, WA_LOGOUT_REASONS, WA_READY_STATES, WA_STREAM_SIGNALING } from './stream.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_MESSAGE_TAGS, WA_MESSAGE_TYPES, WA_RETRYABLE_ACK_CODES } from './message.js';
-export { WA_APP_STATE_COLLECTIONS, WA_APP_STATE_COLLECTION_STATES, WA_APP_STATE_CHAT_MUTATION_ACTIONS, 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_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 { 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_GROUP_NOTIFICATION_TAGS, WA_NOTIFICATION_TYPES, WA_REGISTRATION_NOTIFICATION_TAGS } from './notification.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_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';

package/dist/esm/protocol/defaults.js

@@ -3,6 +3,12 @@ export const WA_DEFAULTS = Object.freeze({
     HOST_DOMAIN: 's.whatsapp.net',
     GROUP_SERVER: 'g.us',
     BROADCAST_SERVER: 'broadcast',
+    LID_SERVER: 'lid',
+    HOSTED_SERVER: 'hosted',
+    HOSTED_LID_SERVER: 'hosted.lid',
+    HOSTED_DEVICE_ID: 99,
+    MSGR_SERVER: 'msgr',
+    INTEROP_SERVER: 'interop',
     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,3 +1,2 @@
 export * from './constants.js';
-export { getLoginIdentity, isGroupJid, normalizeDeviceJid, normalizeRecipientJid, parsePhoneJid, parseSignalAddressFromJid, splitJid, toUserJid } from './jid.js';
-export { WA_USYNC_CONTEXTS, WA_USYNC_DEFAULTS, WA_USYNC_MODES } from './usync.js';
+export { buildDeviceJid, canonicalizeSignalJid, canonicalizeSignalServer, getLoginIdentity, isHostedDeviceId, isHostedDeviceJid, isHostedServer, isGroupJid, normalizeDeviceJid, normalizeRecipientJid, parsePhoneJid, parseSignalAddressFromJid, splitJid, signalAddressKey, toUserJid } from './jid.js';

package/dist/esm/protocol/jid.js

@@ -1,53 +1,70 @@
 import { WA_DEFAULTS } from './constants.js';
-function scanJid(jid) {
-    let atIndex = -1;
-    let colonIndex = -1;
-    let dotIndex = -1;
-    for (let index = 0; index < jid.length; index++) {
-        const code = jid.charCodeAt(index);
-        if (code === 64) {
-            atIndex = index;
-            break;
-        }
-        if (code === 58 && colonIndex === -1)
-            colonIndex = index;
-        else if (code === 46 && dotIndex === -1 && colonIndex === -1)
-            dotIndex = index;
+const KNOWN_SERVERS = {
+    [WA_DEFAULTS.HOST_DOMAIN]: WA_DEFAULTS.HOST_DOMAIN,
+    [WA_DEFAULTS.GROUP_SERVER]: WA_DEFAULTS.GROUP_SERVER,
+    [WA_DEFAULTS.BROADCAST_SERVER]: WA_DEFAULTS.BROADCAST_SERVER,
+    [WA_DEFAULTS.LID_SERVER]: WA_DEFAULTS.LID_SERVER,
+    [WA_DEFAULTS.HOSTED_SERVER]: WA_DEFAULTS.HOSTED_SERVER,
+    [WA_DEFAULTS.HOSTED_LID_SERVER]: WA_DEFAULTS.HOSTED_LID_SERVER,
+    [WA_DEFAULTS.MSGR_SERVER]: WA_DEFAULTS.MSGR_SERVER,
+    [WA_DEFAULTS.INTEROP_SERVER]: WA_DEFAULTS.INTEROP_SERVER
+};
+/**
+ * Returns the canonical reference for known server strings, avoiding
+ * thousands of duplicate sliced copies (e.g. "lid", "s.whatsapp.net")
+ * that would otherwise be created by repeated JID parsing.
+ */
+function internServer(server) {
+    return KNOWN_SERVERS[server] ?? server;
+}
+function extractDigits(input) {
+    let digits = '';
+    for (let index = 0; index < input.length; index += 1) {
+        const code = input.charCodeAt(index);
+        if (code >= 48 && code <= 57)
+            digits += input[index];
     }
+    return digits;
+}
+function findAtIndex(jid) {
+    const atIndex = jid.indexOf('@');
     if (atIndex < 1 || atIndex >= jid.length - 1)
         throw new Error(`invalid jid: ${jid}`);
-    return { atIndex, colonIndex, dotIndex };
+    return atIndex;
 }
 export function splitJid(jid) {
-    const { atIndex } = scanJid(jid);
-    return { user: jid.slice(0, atIndex), server: jid.slice(atIndex + 1) };
+    const atIndex = findAtIndex(jid);
+    return { user: jid.slice(0, atIndex), server: internServer(jid.slice(atIndex + 1)) };
 }
 export function normalizeRecipientJid(to) {
     const input = to.trim();
     if (input.length === 0)
         throw new Error('recipient cannot be empty');
     let hasDash = false;
-    let digits = '';
     for (let index = 0; index < input.length; index += 1) {
         const code = input.charCodeAt(index);
         if (code === 64)
             return input;
         if (code === 45) {
             hasDash = true;
-            continue;
         }
-        if (code >= 48 && code <= 57)
-            digits += input[index];
     }
+    const digits = extractDigits(input);
     if (hasDash)
         return `${input}@${WA_DEFAULTS.GROUP_SERVER}`;
     if (digits.length === 0)
         throw new Error(`invalid recipient: ${to}`);
     return `${digits}@${WA_DEFAULTS.HOST_DOMAIN}`;
 }
-export function isJidType(jid, type) {
+function isJidType(jid, type) {
     const atIndex = jid.length - type.length - 1;
-    return atIndex >= 1 && jid.charCodeAt(atIndex) === 64 && jid.endsWith(type);
+    return (atIndex >= 1 &&
+        jid.charCodeAt(atIndex) === 64 &&
+        jid.indexOf('@') === atIndex &&
+        jid.endsWith(type));
+}
+export function isLidJid(jid) {
+    return isJidType(jid, WA_DEFAULTS.LID_SERVER);
 }
 export function isGroupJid(jid) {
     return isJidType(jid, WA_DEFAULTS.GROUP_SERVER);
@@ -59,18 +76,61 @@ export function isGroupOrBroadcastJid(jid) {
     return isGroupJid(jid) || isBroadcastJid(jid);
 }
 export function parseSignalAddressFromJid(jid) {
-    const { atIndex, colonIndex } = scanJid(jid);
-    const server = jid.slice(atIndex + 1);
-    if (colonIndex === -1)
+    const atIndex = findAtIndex(jid);
+    const colonIndex = jid.indexOf(':', 0);
+    const server = internServer(jid.slice(atIndex + 1));
+    if (colonIndex === -1 || colonIndex > atIndex) {
         return { user: jid.slice(0, atIndex), server, device: 0 };
-    const device = Number.parseInt(jid.slice(colonIndex + 1, atIndex), 10);
-    if (!Number.isFinite(device) || device < 0)
+    }
+    if (colonIndex >= atIndex - 1)
         throw new Error(`invalid jid device: ${jid}`);
+    let device = 0;
+    for (let i = colonIndex + 1; i < atIndex; i += 1) {
+        const digit = jid.charCodeAt(i) - 48;
+        if (digit < 0 || digit > 9)
+            throw new Error(`invalid jid device: ${jid}`);
+        device = device * 10 + digit;
+        if (device > Number.MAX_SAFE_INTEGER)
+            throw new Error(`invalid jid device: ${jid}`);
+    }
     return { user: jid.slice(0, colonIndex), server, device };
 }
-export function toUserJid(jid) {
+export function parseJidFull(jid) {
+    const address = parseSignalAddressFromJid(jid);
+    const userJid = `${address.user}@${address.server}`;
+    const normalizedJid = address.device === 0 ? userJid : `${address.user}:${address.device}@${address.server}`;
+    return { address, userJid, normalizedJid };
+}
+export function canonicalizeSignalServer(server, hostDomain = WA_DEFAULTS.HOST_DOMAIN) {
+    if (server === WA_DEFAULTS.HOSTED_SERVER)
+        return hostDomain;
+    if (server === WA_DEFAULTS.HOSTED_LID_SERVER)
+        return WA_DEFAULTS.LID_SERVER;
+    return server;
+}
+export function canonicalizeSignalJid(jid, hostDomain = WA_DEFAULTS.HOST_DOMAIN) {
+    const address = parseSignalAddressFromJid(jid);
+    const server = canonicalizeSignalServer(address.server ?? WA_DEFAULTS.HOST_DOMAIN, hostDomain);
+    if (address.device === 0)
+        return `${address.user}@${server}`;
+    return `${address.user}:${address.device}@${server}`;
+}
+export function toUserJid(jid, options = {}) {
+    const canonicalize = options.canonicalizeSignalServer === true;
+    if (!canonicalize) {
+        const atIndex = jid.indexOf('@');
+        if (atIndex >= 1 && atIndex < jid.length - 1) {
+            const colonIndex = jid.indexOf(':', 0);
+            if (colonIndex === -1 || colonIndex > atIndex) {
+                return jid;
+            }
+        }
+    }
     const address = parseSignalAddressFromJid(jid);
-    return `${address.user}@${address.server}`;
+    const server = canonicalize
+        ? canonicalizeSignalServer(address.server ?? WA_DEFAULTS.HOST_DOMAIN, options.hostDomain ?? WA_DEFAULTS.HOST_DOMAIN)
+        : address.server;
+    return `${address.user}@${server}`;
 }
 export function normalizeDeviceJid(jid) {
     const address = parseSignalAddressFromJid(jid);
@@ -78,11 +138,59 @@ export function normalizeDeviceJid(jid) {
         return `${address.user}@${address.server}`;
     return `${address.user}:${address.device}@${address.server}`;
 }
+export function isHostedDeviceId(deviceId) {
+    return deviceId === WA_DEFAULTS.HOSTED_DEVICE_ID;
+}
+export function isHostedServer(server) {
+    return server === WA_DEFAULTS.HOSTED_SERVER || server === WA_DEFAULTS.HOSTED_LID_SERVER;
+}
+export function isHostedDeviceJid(jid) {
+    if (isJidType(jid, WA_DEFAULTS.HOSTED_SERVER) ||
+        isJidType(jid, WA_DEFAULTS.HOSTED_LID_SERVER)) {
+        return true;
+    }
+    const atIndex = jid.indexOf('@');
+    if (atIndex < 1 || atIndex >= jid.length - 1)
+        return false;
+    const colonIndex = jid.indexOf(':');
+    if (colonIndex < 0 || colonIndex >= atIndex - 1)
+        return false;
+    let deviceId = 0;
+    for (let i = colonIndex + 1; i < atIndex; i += 1) {
+        const digit = jid.charCodeAt(i) - 48;
+        if (digit < 0 || digit > 9)
+            return false;
+        deviceId = deviceId * 10 + digit;
+        if (deviceId > Number.MAX_SAFE_INTEGER)
+            return false;
+    }
+    return isHostedDeviceId(deviceId);
+}
+export function buildDeviceJid(user, normalizedServer, deviceId, options = {}) {
+    if (options.isHosted === true) {
+        if (!isHostedDeviceId(deviceId)) {
+            return `${user}:${deviceId}@${normalizedServer}`;
+        }
+        const hostedServer = options.rawServer === WA_DEFAULTS.HOSTED_LID_SERVER ||
+            normalizedServer === WA_DEFAULTS.LID_SERVER
+            ? WA_DEFAULTS.HOSTED_LID_SERVER
+            : WA_DEFAULTS.HOSTED_SERVER;
+        return `${user}:${WA_DEFAULTS.HOSTED_DEVICE_ID}@${hostedServer}`;
+    }
+    if (deviceId === 0) {
+        return `${user}@${normalizedServer}`;
+    }
+    return `${user}:${deviceId}@${normalizedServer}`;
+}
 export function getLoginIdentity(meJid) {
-    const { atIndex, colonIndex, dotIndex } = scanJid(meJid);
-    const userEndIndex = dotIndex === -1 ? (colonIndex === -1 ? atIndex : colonIndex) : dotIndex;
+    const atIndex = findAtIndex(meJid);
+    const colonIndex = meJid.indexOf(':', 0);
+    const dotIndex = meJid.indexOf('.', 0);
+    const hasColon = colonIndex !== -1 && colonIndex < atIndex;
+    const hasDot = dotIndex !== -1 && dotIndex < atIndex && (colonIndex === -1 || dotIndex < colonIndex);
+    const userEndIndex = hasDot ? dotIndex : hasColon ? colonIndex : atIndex;
     const username = Number.parseInt(meJid.slice(0, userEndIndex), 10);
-    const device = colonIndex === -1 ? 0 : Number.parseInt(meJid.slice(colonIndex + 1, atIndex), 10);
+    const device = hasColon ? Number.parseInt(meJid.slice(colonIndex + 1, atIndex), 10) : 0;
     if (!Number.isSafeInteger(username) || username <= 0)
         throw new Error(`invalid numeric username from ${meJid}`);
     if (!Number.isSafeInteger(device) || device < 0)
@@ -90,12 +198,7 @@ export function getLoginIdentity(meJid) {
     return { username, device };
 }
 export function parsePhoneJid(input) {
-    let digits = '';
-    for (let index = 0; index < input.length; index += 1) {
-        const code = input.charCodeAt(index);
-        if (code >= 48 && code <= 57)
-            digits += input[index];
-    }
+    const digits = extractDigits(input);
     if (!digits)
         throw new Error('phone number is empty after normalization');
     return `${digits}@${WA_DEFAULTS.HOST_DOMAIN}`;