zapo-js 0.2.0 → 1.0.0

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

@@ -0,0 +1,44 @@
+export declare const WA_CALL_PAYLOAD_TAGS: Readonly<{
+    readonly OFFER: "offer";
+    readonly OFFER_NOTICE: "offer_notice";
+    readonly ACCEPT: "accept";
+    readonly PREACCEPT: "preaccept";
+    readonly REJECT: "reject";
+    readonly TERMINATE: "terminate";
+    readonly TRANSPORT: "transport";
+    readonly MUTE: "mute";
+    readonly VIDEO_STATE: "video_state";
+    readonly GROUP_INFO: "group_info";
+    readonly GROUP_UPDATE: "group_update";
+    readonly ENC_REKEY: "enc_rekey";
+    readonly PEER_STATE: "peer_state";
+    readonly FLOW_CONTROL: "flow_control";
+    readonly WEB_CLIENT: "web_client";
+}>;
+export type WaCallPayloadTag = (typeof WA_CALL_PAYLOAD_TAGS)[keyof typeof WA_CALL_PAYLOAD_TAGS];
+/**
+ * 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 declare const WA_CALL_RECEIPT_PAYLOAD_TAGS: ReadonlySet<WaCallPayloadTag>;
+export declare const WA_CALL_NODE_ATTRS: Readonly<{
+    readonly CALL_ID: "call-id";
+    readonly CALL_CREATOR: "call-creator";
+    readonly GROUP_JID: "group-jid";
+    readonly CALLER_PN: "caller_pn";
+    readonly CALLER_COUNTRY_CODE: "caller_country_code";
+    readonly USERNAME: "username";
+    readonly NOTIFY: "notify";
+    readonly SENDER_LID: "sender_lid";
+    readonly PLATFORM: "platform";
+    readonly VERSION: "version";
+    readonly REASON: "reason";
+    readonly USER_PN: "user_pn";
+    readonly GUEST_NAME: "guest_name";
+}>;
+export declare const WA_CALL_CHILD_TAGS: Readonly<{
+    readonly VIDEO: "video";
+    readonly SILENCE: "silence";
+    readonly GROUP_INFO: "group_info";
+}>;

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

@@ -1,16 +1,33 @@
 export { getWaCompanionPlatformId, WA_BROWSERS, WA_COMPANION_PLATFORM_IDS } from './browser';
 export { WA_SIGNALING, WA_PAIRING_KDF_INFO } from './auth';
 export { WA_CONNECTION_REASONS, WA_DISCONNECT_REASONS, WA_FAILURE_REASONS, WA_LOGOUT_REASONS, WA_READY_STATES, WA_STREAM_SIGNALING } from './stream';
-export type { WaConnectionCode, WaConnectionOpenReason, WaDisconnectReason, WaFailureReasonCode, WaStreamErrorCode } from './stream';
+export type { WaConnectionCode, WaConnectionOpenReason, WaDisconnectReason, WaFailureReasonCode, WaLogoutReason, WaStreamErrorCode } from './stream';
 export { WA_IQ_TYPES, WA_NODE_TAGS, WA_XMLNS } from './nodes';
+export { WA_CALL_CHILD_TAGS, WA_CALL_NODE_ATTRS, WA_CALL_PAYLOAD_TAGS, WA_CALL_RECEIPT_PAYLOAD_TAGS } from './call';
+export type { WaCallPayloadTag } from './call';
 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';
-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';
+export type { WaOutboundReceiptType } from './message';
+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';
 export { getWaMediaHkdfInfo, WA_MEDIA_HKDF_INFO, WA_PREVIEW_MEDIA_HKDF_INFO } from './media';
 export { WA_ACCOUNT_SYNC_PROTOCOLS, WA_DIRTY_PROTOCOLS, WA_DIRTY_TYPES, WA_SUPPORTED_DIRTY_TYPES } from './dirty';
-export { WA_GROUP_NOTIFICATION_TAGS, WA_NOTIFICATION_TYPES } from './notification';
+export { WA_BUSINESS_NOTIFICATION_TAGS, WA_GROUP_NOTIFICATION_TAGS, WA_NEWSLETTER_NOTIFICATION_TAGS, WA_NOTIFICATION_TYPES, WA_REGISTRATION_NOTIFICATION_TAGS } from './notification';
+export { WA_BUSINESS_HOURS_DAYS, WA_BUSINESS_HOURS_MODES } from './business';
+export type { WaBusinessHoursDay, WaBusinessHoursMode } from './business';
+export { WA_CHATSTATE_MEDIA, WA_PRESENCE_LAST_SENTINELS, WA_PRESENCE_TYPES } from './presence';
+export type { WaChatstateMedia, WaPresenceLastSentinel, WaPresenceType } from './presence';
 export { WA_PRIVACY_TOKEN_NOTIFICATION_TYPE, WA_PRIVACY_TOKEN_TAGS, WA_PRIVACY_TOKEN_TYPES, WA_TC_TOKEN_DEFAULTS } from './privacy-token';
 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';
 export type { WaPrivacyCategory, WaPrivacySettingName, WaPrivacyValue } from './privacy';
 export { WA_DEFAULTS } from './defaults';
+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';
+export type { WaBizBotType, WaBotMsgBodyType, WaBotMsgEditType } from './bot';
+export { WA_STATUS_DISTRIBUTION_SETTINGS } from './status';
+export type { WaStatusDistributionSetting } from './status';
+export { WA_EMAIL_CONTEXTS, WA_EMAIL_ERROR_CODES, WA_EMAIL_LIMITS, WA_EMAIL_TAGS, WA_EMAIL_XMLNS } from './email';
+export type { WaEmailContext, WaEmailErrorCode } from './email';
+export { AB_PROP_CONFIGS, resolveAbPropNameByCode, WA_ABPROPS_PROTOCOL_VERSION, WA_ABPROPS_REFRESH_BOUNDS } from './abprops';
+export type { AbPropConfigEntry, AbPropName, AbPropType, AbPropValue } from './abprops';
 export { WA_GROUP_PARTICIPANT_TYPES, type WaGroupSetting } from './group';
 export { WA_USYNC_CONTEXTS, WA_USYNC_DEFAULTS, WA_USYNC_MODES } from './usync';
+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';
+export type { WaNewsletterReceiveType, WaNewsletterRole, WaNewsletterSendType, WaNewsletterStateType } from './newsletter';

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

@@ -8,6 +8,9 @@ export declare const WA_DEFAULTS: Readonly<{
     readonly HOSTED_DEVICE_ID: 99;
     readonly MSGR_SERVER: "msgr";
     readonly INTEROP_SERVER: "interop";
+    readonly NEWSLETTER_SERVER: "newsletter";
+    readonly BOT_SERVER: "bot";
+    readonly STATUS_BROADCAST_JID: "status@broadcast";
     readonly DEVICE_BROWSER: "firefox";
     readonly DEVICE_PLATFORM: string;
     readonly CHAT_SOCKET_URLS: readonly ["wss://web.whatsapp.com/ws/chat", "wss://web.whatsapp.com:5222/ws/chat"];

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

@@ -0,0 +1,32 @@
+export declare const WA_EMAIL_XMLNS = "urn:xmpp:whatsapp:account";
+export declare const WA_EMAIL_TAGS: Readonly<{
+    readonly EMAIL: "email";
+    readonly EMAIL_ADDRESS: "email_address";
+    readonly VERIFY_EMAIL: "verify_email";
+    readonly CONFIRM_EMAIL: "confirm_email";
+    readonly CONTEXT: "context";
+    readonly CODE: "code";
+    readonly LG: "lg";
+    readonly LC: "lc";
+    readonly AUTO_VERIFY: "auto_verify";
+    readonly CONFIRMED: "confirmed";
+}>;
+export declare const WA_EMAIL_CONTEXTS: Readonly<{
+    readonly ONBOARDING: "onboarding";
+    readonly SETTINGS: "settings";
+}>;
+export type WaEmailContext = (typeof WA_EMAIL_CONTEXTS)[keyof typeof WA_EMAIL_CONTEXTS];
+export declare const WA_EMAIL_LIMITS: Readonly<{
+    readonly EMAIL_MAX_LENGTH: 320;
+    readonly CODE_LENGTH: 6;
+    readonly LOCALE_MIN_LENGTH: 2;
+    readonly LOCALE_MAX_LENGTH: 3;
+}>;
+export declare const WA_EMAIL_ERROR_CODES: Readonly<{
+    readonly FORBIDDEN: 403;
+    readonly LOCKOUT: 534;
+    readonly CODE_EXPIRED: 535;
+    readonly CODE_INCORRECT: 536;
+    readonly TOO_MANY_RETRIES: 537;
+}>;
+export type WaEmailErrorCode = (typeof WA_EMAIL_ERROR_CODES)[keyof typeof WA_EMAIL_ERROR_CODES];

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

@@ -3,4 +3,4 @@ export declare const WA_GROUP_PARTICIPANT_TYPES: Readonly<{
     readonly ADMIN: "admin";
     readonly REGULAR: "participant";
 }>;
-export type WaGroupSetting = 'announcement' | 'restrict' | 'ephemeral' | 'membership_approval_mode';
+export type WaGroupSetting = 'announcement' | 'restrict' | 'ephemeral' | 'membership_approval_mode' | 'allow_non_admin_sub_group_creation' | 'group_history' | 'allow_admin_reports' | 'no_frequently_forwarded';

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

@@ -1,2 +1,3 @@
 export * from './constants';
-export { buildDeviceJid, canonicalizeSignalJid, canonicalizeSignalServer, getLoginIdentity, isHostedDeviceId, isHostedDeviceJid, isHostedServer, isGroupJid, normalizeDeviceJid, normalizeRecipientJid, parsePhoneJid, parseSignalAddressFromJid, splitJid, signalAddressKey, toUserJid } from './jid';
+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';
+export type { ParsedJid } from './jid';

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

@@ -1,36 +1,115 @@
 import type { SignalAddress } from '../signal/types';
+/**
+ * Splits a JID into `user` and `server` parts at the `@` separator.
+ * Throws if the input does not contain a valid `user@server` shape.
+ */
 export declare function splitJid(jid: string): {
     readonly user: string;
     readonly server: string;
 };
+/**
+ * Normalizes a user-supplied recipient (phone number, group id, or full JID)
+ * into a canonical JID. Strings already containing `@` are returned as-is;
+ * dashed inputs map to `<input>@g.us` (group); pure-digit inputs map to
+ * `<digits>@s.whatsapp.net`.
+ */
 export declare function normalizeRecipientJid(to: string): string;
+/** Returns `true` for JIDs in the `@lid` server (linked-device identity). */
+export declare function isLidJid(jid: string): boolean;
+/** Returns `true` for JIDs in the `@s.whatsapp.net` server (phone-number user JIDs). */
+export declare function isUserJid(jid: string): boolean;
+/** Returns `true` for JIDs in the `@bot` server. */
+export declare function isBotJid(jid: string): boolean;
+/** Returns `true` for JIDs in the `@g.us` server (groups). */
 export declare function isGroupJid(jid: string): boolean;
+/** Returns `true` for JIDs in the `@broadcast` server (broadcast lists). */
 export declare function isBroadcastJid(jid: string): boolean;
+/** Returns `true` for the special `status@broadcast` JID. */
+export declare function isStatusBroadcastJid(jid: string): boolean;
+/** Returns `true` for JIDs in the `@newsletter` server. */
+export declare function isNewsletterJid(jid: string): boolean;
+/** Returns `true` for any group or broadcast JID. */
 export declare function isGroupOrBroadcastJid(jid: string): boolean;
 export interface ParsedJid {
     readonly address: SignalAddress;
     readonly userJid: string;
     readonly normalizedJid: string;
 }
+/**
+ * Parses a JID into a Signal-style `{ user, server, device }` address.
+ * `device` is `0` when the JID has no `:device` segment.
+ */
 export declare function parseSignalAddressFromJid(jid: string): SignalAddress;
+/**
+ * Parses a JID and returns the Signal address plus the user-only and
+ * fully-normalized device JID forms in a single pass.
+ */
 export declare function parseJidFull(jid: string): ParsedJid;
+/**
+ * Maps the hosted-account server variants (`hosted` / `hosted.lid`) back to
+ * their canonical Signal server (`hostDomain` / `lid`). Other servers are
+ * returned unchanged.
+ */
 export declare function canonicalizeSignalServer(server: string, hostDomain?: string): string;
+/**
+ * Returns the JID rewritten with its server canonicalized via
+ * {@link canonicalizeSignalServer} – used to derive the address Signal
+ * sessions are keyed by.
+ */
 export declare function canonicalizeSignalJid(jid: string, hostDomain?: string): string;
+/**
+ * Strips the `:device` segment from a JID, returning the bare `user@server`
+ * form. Set `options.canonicalizeSignalServer` to also rewrite hosted servers
+ * via {@link canonicalizeSignalServer}.
+ */
 export declare function toUserJid(jid: string, options?: {
     readonly canonicalizeSignalServer?: boolean;
     readonly hostDomain?: string;
 }): string;
+/**
+ * Returns the JID in its full device form. JIDs with `device === 0` lose the
+ * device segment (`user@server`); all others keep `user:device@server`.
+ */
 export declare function normalizeDeviceJid(jid: string): string;
+/**
+ * Appends `:device` to a bare user JID. A falsy `device` returns the input
+ * unchanged.
+ */
+export declare function applyDeviceToJid(userJid: string, device: number | undefined): string;
+/** Returns `true` when `deviceId` matches the WhatsApp hosted-device id. */
 export declare function isHostedDeviceId(deviceId: number): boolean;
+/** Returns `true` for the hosted server variants (`hosted` and `hosted.lid`). */
 export declare function isHostedServer(server: string): boolean;
+/**
+ * Returns `true` when the JID refers to a hosted device – either by server
+ * (`@hosted` / `@hosted.lid`) or by a `:HOSTED_DEVICE_ID@…` device segment.
+ */
 export declare function isHostedDeviceJid(jid: string): boolean;
+/**
+ * Builds a device JID from its parts. When `options.isHosted` is set, the
+ * hosted-server variant is selected (preserving LID vs phone) and the canonical
+ * hosted device id is used.
+ */
 export declare function buildDeviceJid(user: string, normalizedServer: string, deviceId: number, options?: {
     readonly rawServer?: string;
     readonly isHosted?: boolean;
 }): string;
+/**
+ * Extracts the numeric username and device id from the authenticated user's
+ * own JID. Throws when either segment is missing, non-numeric, or out of the
+ * safe-integer range.
+ */
 export declare function getLoginIdentity(meJid: string): {
     readonly username: number;
     readonly device: number;
 };
+/**
+ * Builds a `<digits>@s.whatsapp.net` JID from a free-form phone number,
+ * stripping non-digit characters. Throws when no digits are found.
+ */
 export declare function parsePhoneJid(input: string): string;
+/**
+ * Returns a stable `user|server|device` key for a Signal address, suitable
+ * as a Map/Set key.
+ */
 export declare function signalAddressKey(address: SignalAddress): string;

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

@@ -1,15 +1,23 @@
 export declare const WA_MEDIA_HKDF_INFO: Readonly<{
-    readonly document: "WhatsApp Document Keys";
-    readonly image: "WhatsApp Image Keys";
-    readonly sticker: "WhatsApp Image Keys";
-    readonly 'xma-image': "WhatsApp Image Keys";
-    readonly video: "WhatsApp Video Keys";
-    readonly gif: "WhatsApp Video Keys";
-    readonly audio: "WhatsApp Audio Keys";
-    readonly ptt: "WhatsApp Audio Keys";
-    readonly 'md-app-state': "WhatsApp App State Keys";
-    readonly 'md-msg-hist': "WhatsApp History Keys";
-    readonly history: "WhatsApp History Keys";
+    readonly document: NodeJS.NonSharedUint8Array;
+    readonly image: NodeJS.NonSharedUint8Array;
+    readonly sticker: NodeJS.NonSharedUint8Array;
+    readonly 'xma-image': NodeJS.NonSharedUint8Array;
+    readonly video: NodeJS.NonSharedUint8Array;
+    readonly gif: NodeJS.NonSharedUint8Array;
+    readonly audio: NodeJS.NonSharedUint8Array;
+    readonly ptt: NodeJS.NonSharedUint8Array;
+    readonly 'md-app-state': NodeJS.NonSharedUint8Array;
+    readonly 'md-msg-hist': NodeJS.NonSharedUint8Array;
+    readonly history: NodeJS.NonSharedUint8Array;
+    readonly 'sticker-pack': NodeJS.NonSharedUint8Array;
+    readonly 'thumbnail-sticker-pack': NodeJS.NonSharedUint8Array;
+    readonly 'thumbnail-link': NodeJS.NonSharedUint8Array;
 }>;
-export declare const WA_PREVIEW_MEDIA_HKDF_INFO = "Messenger Preview Keys";
-export declare function getWaMediaHkdfInfo(mediaType: string): string;
+export declare const WA_PREVIEW_MEDIA_HKDF_INFO: NodeJS.NonSharedUint8Array;
+/**
+ * Returns the HKDF `info` bytes used to derive per-media keys for a given
+ * media type. Throws for unsupported types – see {@link WA_MEDIA_HKDF_INFO}
+ * for the supported set.
+ */
+export declare function getWaMediaHkdfInfo(mediaType: string): Uint8Array;

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

@@ -11,6 +11,7 @@ export declare const WA_MESSAGE_TYPES: Readonly<{
     readonly ACK_TYPE_ERROR: "error";
     readonly ACK_CLASS_ERROR: "error";
     readonly ACK_CLASS_MESSAGE: "message";
+    readonly ACK_CLASS_CALL: "call";
     readonly RECEIPT_TYPE_DELIVERY: "delivery";
     readonly RECEIPT_TYPE_SENDER: "sender";
     readonly RECEIPT_TYPE_INACTIVE: "inactive";
@@ -22,7 +23,9 @@ export declare const WA_MESSAGE_TYPES: Readonly<{
     readonly RECEIPT_TYPE_PEER: "peer_msg";
     readonly RECEIPT_TYPE_SERVER_ERROR: "server-error";
     readonly RECEIPT_TYPE_RETRY: "retry";
+    readonly RECEIPT_TYPE_ENC_REKEY_RETRY: "enc_rekey_retry";
 }>;
+export type WaOutboundReceiptType = typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_READ | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_READ_SELF | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_PLAYED | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_PLAYED_SELF | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_INACTIVE | typeof WA_MESSAGE_TYPES.RECEIPT_TYPE_HISTORY_SYNC;
 export declare const WA_RETRYABLE_ACK_CODES: readonly ["408", "429", "500", "503"];
 export declare const WA_STANZA_MSG_TYPES: Readonly<{
     readonly TEXT: "text";
@@ -36,6 +39,7 @@ export declare const WA_STANZA_MSG_TYPES: Readonly<{
 export declare const WA_EDIT_ATTRS: Readonly<{
     readonly MESSAGE_EDIT: "1";
     readonly PIN_IN_CHAT: "2";
+    readonly NEWSLETTER_EDIT: "3";
     readonly SENDER_REVOKE: "7";
     readonly ADMIN_REVOKE: "8";
 }>;

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

@@ -0,0 +1,65 @@
+export declare const WA_NEWSLETTER_ROLES: Readonly<{
+    readonly SUBSCRIBER: "SUBSCRIBER";
+    readonly GUEST: "GUEST";
+    readonly ADMIN: "ADMIN";
+    readonly OWNER: "OWNER";
+}>;
+export type WaNewsletterRole = (typeof WA_NEWSLETTER_ROLES)[keyof typeof WA_NEWSLETTER_ROLES];
+export declare const WA_NEWSLETTER_STATE_TYPES: Readonly<{
+    readonly ACTIVE: "ACTIVE";
+    readonly SUSPENDED: "SUSPENDED";
+    readonly GEOSUSPENDED: "GEOSUSPENDED";
+    readonly DELETED: "DELETED";
+    readonly NON_EXISTING: "NON_EXISTING";
+}>;
+export type WaNewsletterStateType = (typeof WA_NEWSLETTER_STATE_TYPES)[keyof typeof WA_NEWSLETTER_STATE_TYPES];
+export declare const WA_NEWSLETTER_PICTURE_TYPES: Readonly<{
+    readonly IMAGE: "IMAGE";
+    readonly PREVIEW: "PREVIEW";
+}>;
+export declare const WA_NEWSLETTER_FETCH_KEY_TYPES: Readonly<{
+    readonly JID: "JID";
+    readonly INVITE: "INVITE";
+}>;
+export declare const WA_NEWSLETTER_VIEW_ROLES: Readonly<{
+    readonly GUEST: "GUEST";
+    readonly SUBSCRIBER: "SUBSCRIBER";
+    readonly ADMIN: "ADMIN";
+    readonly OWNER: "OWNER";
+}>;
+export declare const WA_NEWSLETTER_MUTE_TYPES: Readonly<{
+    readonly ADMIN_ACTIVITY: "MUTE_ADMIN_ACTIVITY";
+    readonly FOLLOWER_ACTIVITY: "MUTE_FOLLOWER_ACTIVITY";
+}>;
+export declare const WA_NEWSLETTER_MUTE_VALUES: Readonly<{
+    readonly ON: "ON";
+    readonly OFF: "OFF";
+}>;
+export declare const WA_NEWSLETTER_SEND_TYPES: Readonly<{
+    readonly TEXT: "text";
+    readonly MEDIA: "media";
+    readonly REACTION: "reaction";
+    readonly REVOKE: "revoke";
+}>;
+export type WaNewsletterSendType = (typeof WA_NEWSLETTER_SEND_TYPES)[keyof typeof WA_NEWSLETTER_SEND_TYPES];
+export declare const WA_NEWSLETTER_RECEIVE_TYPES: Readonly<{
+    readonly TEXT: "NewsletterText";
+    readonly MEDIA: "NewsletterMedia";
+    readonly REACTION: "NewsletterReaction";
+    readonly REACTION_REVOKE: "NewsletterReactionRevoke";
+    readonly REVOKE: "NewsletterRevoke";
+    readonly EDIT: "NewsletterEdit";
+    readonly POLL_CREATION: "NewsletterPollCreation";
+    readonly POLL_VOTE: "NewsletterPollVote";
+    readonly POLL_RESULT_SNAPSHOT: "NewsletterPollResultSnapshot";
+    readonly QUIZ_CREATION: "NewsletterQuizCreation";
+    readonly QUESTION: "NewsletterQuestion";
+    readonly QUESTION_REPLY: "NewsletterQuestionReply";
+    readonly QUESTION_RESPONSE: "NewsletterQuestionResponse";
+    readonly WAMO_EMPTY: "NewsletterWAMOEmpty";
+}>;
+export type WaNewsletterReceiveType = (typeof WA_NEWSLETTER_RECEIVE_TYPES)[keyof typeof WA_NEWSLETTER_RECEIVE_TYPES];
+export declare const WA_NEWSLETTER_VERIFICATION_STATES: Readonly<{
+    readonly VERIFIED: "VERIFIED";
+    readonly UNVERIFIED: "UNVERIFIED";
+}>;

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

@@ -32,6 +32,7 @@ export declare const WA_NODE_TAGS: Readonly<{
     readonly DESCRIPTION: "description";
     readonly MY_ADDONS: "my_addons";
     readonly KEY: "key";
+    readonly OP: "op";
     readonly REGISTRATION: "registration";
     readonly TYPE: "type";
     readonly IDENTITY: "identity";
@@ -61,6 +62,23 @@ export declare const WA_NODE_TAGS: Readonly<{
     readonly EPHEMERAL: "ephemeral";
     readonly MEMBERSHIP_APPROVAL_MODE: "membership_approval_mode";
     readonly GROUP_JOIN: "group_join";
+    readonly ABPROPS: "abprops";
+    readonly PLAINTEXT: "plaintext";
+    readonly PRESENCE: "presence";
+    readonly CHATSTATE: "chatstate";
+    readonly CALL: "call";
+    readonly COMPOSING: "composing";
+    readonly PAUSED: "paused";
+    readonly BIZ: "biz";
+    readonly INTERACTIVE: "interactive";
+    readonly NATIVE_FLOW: "native_flow";
+    readonly BOT: "bot";
+    readonly META: "meta";
+    readonly STATUS: "status";
+    readonly USERNAME: "username";
+    readonly TEXT_STATUS: "text_status";
+    readonly DISAPPEARING_MODE: "disappearing_mode";
+    readonly BUSINESS: "business";
 }>;
 export declare const WA_IQ_TYPES: Readonly<{
     readonly GET: "get";
@@ -82,6 +100,12 @@ export declare const WA_XMLNS: Readonly<{
     readonly STATUS: "status";
     readonly GROUPS: "w:g2";
     readonly NEWSLETTER: "newsletter";
+    readonly TOS: "tos";
     readonly XMPP_PING: "urn:xmpp:ping";
     readonly WHATSAPP_PING: "w:p";
+    readonly ABPROPS: "abt";
+    readonly MEX: "w:mex";
+    readonly BOT: "bot";
+    readonly DISAPPEARING_MODE: "disappearing_mode";
+    readonly PASSIVE: "passive";
 }>;

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

@@ -2,6 +2,26 @@ export declare const WA_NOTIFICATION_TYPES: Readonly<{
     readonly GROUP: "w:gp2";
     readonly ENCRYPT: "encrypt";
     readonly DEVICES: "devices";
+    readonly SERVER: "server";
+    readonly REGISTRATION: "registration";
+    readonly NEWSLETTER: "newsletter";
+    readonly BUSINESS: "business";
+    readonly PICTURE: "picture";
+}>;
+export declare const WA_BUSINESS_NOTIFICATION_TAGS: Readonly<{
+    readonly VERIFIED_NAME: "verified_name";
+    readonly REMOVE: "remove";
+    readonly PROFILE: "profile";
+    readonly PRODUCT_CATALOG: "product_catalog";
+    readonly SUBSCRIPTIONS: "subscriptions";
+    readonly FEATURE_FLAGS: "feature_flags";
+}>;
+export declare const WA_NEWSLETTER_NOTIFICATION_TAGS: Readonly<{
+    readonly LIVE_UPDATES: "live_updates";
+}>;
+export declare const WA_REGISTRATION_NOTIFICATION_TAGS: Readonly<{
+    readonly WA_OLD_REGISTRATION: "wa_old_registration";
+    readonly DEVICE_LOGOUT: "device_logout";
 }>;
 export declare const WA_GROUP_NOTIFICATION_TAGS: Readonly<{
     readonly REMOVE: "remove";
@@ -49,4 +69,6 @@ export declare const WA_GROUP_NOTIFICATION_TAGS: Readonly<{
     readonly GROUP_SAFETY_CHECK: "group_safety_check";
     readonly LIMIT_SHARING_ENABLED: "limit_sharing_enabled";
     readonly MISSING_PARTICIPANT_IDENTIFICATION: "missing_participant_identification";
+    readonly GROUP_HISTORY: "group_history";
+    readonly NO_GROUP_HISTORY: "no_group_history";
 }>;

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

@@ -0,0 +1,16 @@
+export declare const WA_PRESENCE_TYPES: Readonly<{
+    readonly AVAILABLE: "available";
+    readonly UNAVAILABLE: "unavailable";
+    readonly SUBSCRIBE: "subscribe";
+}>;
+export declare const WA_PRESENCE_LAST_SENTINELS: Readonly<{
+    readonly DENY: "deny";
+    readonly NONE: "none";
+    readonly ERROR: "error";
+}>;
+export declare const WA_CHATSTATE_MEDIA: Readonly<{
+    readonly AUDIO: "audio";
+}>;
+export type WaPresenceType = (typeof WA_PRESENCE_TYPES)[keyof typeof WA_PRESENCE_TYPES];
+export type WaPresenceLastSentinel = (typeof WA_PRESENCE_LAST_SENTINELS)[keyof typeof WA_PRESENCE_LAST_SENTINELS];
+export type WaChatstateMedia = (typeof WA_CHATSTATE_MEDIA)[keyof typeof WA_CHATSTATE_MEDIA];

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

@@ -0,0 +1,7 @@
+export declare const WA_STATUS_DISTRIBUTION_SETTINGS: Readonly<{
+    readonly CONTACTS: "contacts";
+    readonly ALLOWLIST: "allowlist";
+    readonly DENYLIST: "denylist";
+    readonly CLOSE_FRIENDS: "close_friends";
+}>;
+export type WaStatusDistributionSetting = (typeof WA_STATUS_DISTRIBUTION_SETTINGS)[keyof typeof WA_STATUS_DISTRIBUTION_SETTINGS];

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

@@ -39,6 +39,7 @@ export declare const WA_LOGOUT_REASONS: Readonly<{
     readonly WEB_FAIL_ENC_SALT: "web_fail_enc_salt";
     readonly CACHE_STORAGE_OPEN_FAILED: "cache_storage_open_failed";
 }>;
+export type WaLogoutReason = (typeof WA_LOGOUT_REASONS)[keyof typeof WA_LOGOUT_REASONS];
 export declare const WA_STREAM_SIGNALING: Readonly<{
     readonly STREAM_ERROR_TAG: "stream:error";
     readonly XML_STREAM_END_TAG: "xmlstreamend";

package/dist/types/retry/codec.d.ts

@@ -1,3 +1,8 @@
 import type { WaRetryReplayPayload } from './types';
+/**
+ * Encodes a {@link WaRetryReplayPayload} into the on-disk codec format used
+ * by the retry store. Supports the `plaintext`/`encrypted`/`opaque_node` modes.
+ */
 export declare function encodeRetryReplayPayload(payload: WaRetryReplayPayload): Uint8Array;
+/** Inverse of {@link encodeRetryReplayPayload}. Throws on bad magic/version. */
 export declare function decodeRetryReplayPayload(raw: Uint8Array): WaRetryReplayPayload;

package/dist/types/retry/index.d.ts

@@ -2,7 +2,7 @@ export { MAX_RETRY_ATTEMPTS, RETRY_KEYS_MIN_COUNT, RETRY_OUTBOUND_TTL_MS, RETRY_
 export type { WaRetryReasonCode } from './constants';
 export { mapRetryReasonFromError } from './reason';
 export { parseRetryReceiptRequest, pickRetryStateMax } from './parse';
-export type { WaParsedRetryRequest, WaRetryDecryptFailureContext, WaRetryEncryptedReplayPayload, WaRetryKey, WaRetryKeyBundle, WaRetryOpaqueNodeReplayPayload, WaRetryOutboundMessageRecord, WaRetryOutboundMode, WaRetryOutboundState, WaRetryPlaintextReplayPayload, WaRetryReceiptType, WaRetryReplayPayload, WaRetryStoredReplayPayload, WaRetrySignedKey } from './types';
+export type { WaParsedRetryRequest, WaRetryDecryptFailureContext, WaRetryEncryptedReplayPayload, WaRetryKey, WaRetryKeyBundle, WaRetryOpaqueNodeReplayPayload, WaRetryOutboundMessageRecord, WaRetryOutboundMode, WaRetryOutboundState, WaRetryPlaintextReplayPayload, WaRetryReceiptType, WaRetryReplayPayload, WaRetryStoredReplayPayload } from './types';
 export { decodeRetryReplayPayload, encodeRetryReplayPayload } from './codec';
 export { WaRetryReplayService, type WaRetryReplayServiceOptions, type WaRetryResendResult } from './replay';
 export { createOutboundRetryTracker, type OutboundRetryTrackHint, type OutboundRetryTracker } from './tracker';

package/dist/types/retry/parse.d.ts

@@ -1,6 +1,15 @@
 import type { WaParsedRetryRequest, WaRetryOutboundState } from './types';
 import type { BinaryNode } from '../transport/types';
+/**
+ * Parses an incoming `receipt` stanza into a {@link WaParsedRetryRequest}.
+ * Returns `null` when the stanza is not a retry/rekey-retry receipt; throws
+ * when required attrs/children are missing.
+ */
 export declare function parseRetryReceiptRequest(node: BinaryNode, options?: {
     readonly expectedToJids?: readonly string[];
 }): WaParsedRetryRequest | null;
+/**
+ * Returns whichever of `left`/`right` represents the more advanced retry
+ * state (according to the internal precedence rank).
+ */
 export declare function pickRetryStateMax(left: WaRetryOutboundState, right: WaRetryOutboundState): WaRetryOutboundState;

package/dist/types/retry/reason.d.ts

@@ -1,2 +1,7 @@
 import { type WaRetryReasonCode } from './constants';
-export declare function mapRetryReasonFromError(error: unknown): WaRetryReasonCode;
+/**
+ * Maps a decryption/Signal error to the appropriate {@link WaRetryReasonCode}
+ * so an outbound retry receipt carries the correct `error` attribute.
+ * Returns `undefined` when no known reason matches.
+ */
+export declare function mapRetryReasonFromError(error: unknown): WaRetryReasonCode | undefined;

package/dist/types/retry/replay.d.ts

@@ -1,26 +1,40 @@
+import type { WaAuthCredentials } from '../auth/types';
 import type { Logger } from '../infra/log/types';
+import { type IcdcMeta } from '../message/crypto/icdc';
 import type { WaMessageClient } from '../message/WaMessageClient';
-import { type Proto } from '..';
 import type { WaRetryOutboundMessageRecord } from './types';
+import type { SignalSessionResolver } from '../signal/session/resolver';
 import type { SignalProtocol } from '../signal/session/SignalProtocol';
 export interface WaRetryReplayServiceOptions {
     readonly logger: Logger;
     readonly messageClient: WaMessageClient;
     readonly signalProtocol: SignalProtocol;
-    readonly getCurrentMeJid: () => string | null | undefined;
-    readonly getCurrentMeLid: () => string | null | undefined;
-    readonly getCurrentSignedIdentity: () => Proto.IADVSignedDeviceIdentity | null | undefined;
+    readonly sessionResolver: SignalSessionResolver;
+    readonly getCurrentCredentials: () => WaAuthCredentials | null;
+    readonly resolveUserIcdc?: (userJid: string) => Promise<IcdcMeta | null>;
 }
 export type WaRetryResendResult = 'resent' | 'ineligible';
+/**
+ * Replays a previously-sent outbound message in response to an incoming
+ * retry receipt. Dispatches to plaintext/encrypted/opaque-node handlers
+ * based on the stored payload shape.
+ */
 export declare class WaRetryReplayService {
     private readonly options;
     constructor(options: WaRetryReplayServiceOptions);
+    /**
+     * Resends `outbound` to `requesterJid`. Returns `'resent'` on a fresh
+     * send or `'ineligible'` when the cached payload cannot satisfy the
+     * request (e.g. requester not in the original device list).
+     */
     resendOutboundMessage(outbound: WaRetryOutboundMessageRecord, requesterJid: string, retryCount: number): Promise<WaRetryResendResult>;
     private resendPlaintextPayload;
+    private resolveSignedDeviceIdentity;
+    private refreshRetryPlaintext;
+    private safeUserJid;
     private resendGroupPlaintextPayload;
     private resendEncryptedPayload;
     private resendOpaquePayload;
-    private maybeWrapGroupRetryPlaintextForSelfDevice;
     private isRequesterCurrentAccount;
     private isOpaqueReplayCompatible;
 }

package/dist/types/retry/tracker.d.ts

@@ -5,15 +5,22 @@ import type { WaRetryStore } from '../store/contracts/retry.store';
 export type OutboundRetryTrackHint = {
     readonly messageIdHint?: string;
     readonly toJid?: string;
-    readonly type: string;
     readonly replayPayload: WaRetryReplayPayload;
-    readonly participantJid?: string;
-    readonly recipientJid?: string;
     readonly eligibleRequesterDeviceJids?: readonly string[];
 };
+/**
+ * Wraps message publishes and persists a replay record so the
+ * {@link WaRetryReplayService} can re-send the message later if a retry
+ * receipt arrives.
+ */
 export type OutboundRetryTracker = {
+    /**
+     * Runs `publish`, then upserts a retry-outbound record built from the
+     * tracking `hint`. Returns the publish result unchanged.
+     */
     track(hint: OutboundRetryTrackHint, publish: () => Promise<WaMessagePublishResult>): Promise<WaMessagePublishResult>;
 };
+/** Builds an {@link OutboundRetryTracker} backed by a {@link WaRetryStore}. */
 export declare function createOutboundRetryTracker(options: {
     readonly retryStore: WaRetryStore;
     readonly logger: Logger;