@oxidezap/whatsapp-rust-bridge 0.9.0 → 0.10.0

package/dist/whatsapp_rust_bridge.d.ts

@@ -91,10 +91,13 @@ export interface Jid {
     integrator: number;
 }
 
+/** Any JSON value, as `serde_json::Value` crosses. */
+export type JsonValue = null | boolean | number | string | JsonValue[] | { [key: string]: JsonValue };
+
 /** Addressing mode for a group (phone number vs LID). */
 export type AddressingMode = "pn" | "lid";
 
-/** A batched app-state sync finished without leaving every collection synced.  Collections are named as they appear on the wire (`critical_block`, `regular_high`, …) rather than as an enum, so the payload stays stable if the set of collections changes.  `fatal` is the one a consumer usually has to act on: the server refused the collection, and repeating the request gets the same answer. WhatsApp Web treats that as grounds to notify the primary device and log out; this library will not end a session on its own, so it reports the refusal and keeps the connection. When `connected` is true the client dispatched [`Event::Connected`] anyway and is usable, minus whatever those collections carry — for `critical_block` that includes the push name, so presence stays unavailable until it syncs. */
+/** A batched app-state sync finished without leaving every collection synced.  Collections are named as they appear on the wire (`critical_block`, `regular_high`, …) rather than as an enum, so the payload stays stable if the set of collections changes.  `fatal` is the one a consumer usually has to act on: the server refused the collection, and repeating the request gets the same answer. WhatsApp Web treats that as grounds to notify the primary device and log out; this library will not end a session on its own, so it reports the refusal and keeps the connection. When `connected` is true the client dispatched [`Event::Connected`] anyway and is usable, minus whatever those collections carry — for `critical_block` that includes the push name, so presence stays unavailable until it syncs.  The initial sync that follows pairing normally connects, so its report normally carries `connected: true`. A `false` means no [`Event::Connected`] accompanied this report: a sync that ran before the connection was ready, such as one a `syncd_app_state` dirty bit started while the offline backlog was still being processed, or an initial sync whose connection was paused, superseded or rejected by the server as it finished. */
 export interface AppStateSyncFailed {
     /** Refused outright by the server (400/404). Terminal for this connection. */
     fatal: string[];
@@ -116,8 +119,8 @@ export interface AppStateSyncKey {
 export interface ArchiveUpdate {
     /** The chat being archived or unarchived. */
     jid: Jid;
-    timestamp: number;
-    action: ArchiveChatAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IArchiveChatAction;
     from_full_sync: boolean;
 }
 
@@ -263,6 +266,20 @@ export interface CallLinkPreview {
     is_admin: boolean;
 }
 
+/** A call placed or received on the primary device, synced through app state.  The only channel that carries a call the companion never saw signalling for: a call placed on the phone puts nothing on this socket, so [`Event::IncomingCall`] and friends cannot see it. */
+export interface CallLogSync {
+    /** Who started the call, from the mutation's index.  The index rather than the record: `record.call_creator_jid` is optional and WA Web leaves it unset for calls it received none for, while it fills the index in either way — falling back to this account for a call it placed, or to the peer for one it took. */
+    call_creator_jid: Jid;
+    /** The call's identifier, from the mutation's index (the same value `record.call_id` carries when the record carries one). */
+    call_id: string;
+    /** Whether *this account* placed the call.  Read this rather than `record.is_incoming`, which despite its name holds the same thing rather than its opposite: WA Web writes the record with `isIncoming: fromMe`, so a consumer taking the field at its word files every call backwards. */
+    from_me: boolean;
+    /** When the mutation was written, not when the call happened — the call's own time is `record.start_time`.  This is the field WA Web measures against the pairing timestamp to decide whether a record predates the device, so it is worth having; it is not a time to file the call under. A mutation that arrives without one falls back to the moment it was received, as every other app-state event does. */
+    timestamp: string;
+    record: import('./proto-types').proto.ICallLogRecord;
+    from_full_sync: boolean;
+}
+
 /** Meta Verified subscription state, which is what lifts the cap permanently. */
 export type CappingMvStatus = "NOT_ELIGIBLE" | "NOT_ACTIVE" | "ACTIVE" | "ACTIVE_UPGRADE_AVAILABLE" | string;
 
@@ -299,8 +316,8 @@ export interface ClearChatUpdate {
     delete_starred: boolean;
     /** From the index, not the proto. */
     delete_media: boolean;
-    timestamp: number;
-    action: ClearChatAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IClearChatAction;
     from_full_sync: boolean;
 }
 
@@ -329,28 +346,28 @@ export interface ContactNumberChanged {
     old_lid?: Jid | null;
     /** New LID (if provided by server). */
     new_lid?: Jid | null;
-    timestamp: number;
+    timestamp: string;
 }
 
 /** A saved contact was deleted on a linked device.  Carries no action payload: the mutation is a syncd `Remove`, and WA Web's `WAWebContactSync` ignores the value on that branch and simply drops the contact from the address book. */
 export interface ContactRemoved {
     /** The contact that is no longer saved. */
     jid: Jid;
-    timestamp: number;
+    timestamp: string;
     from_full_sync: boolean;
 }
 
 /** Server requests a full contact re-sync.  Emitted from `<notification type="contacts"><sync after="..."/>`. */
 export interface ContactSyncRequested {
-    after?: number | null;
-    timestamp: number;
+    after?: string | null;
+    timestamp: string;
 }
 
 export interface ContactUpdate {
     /** The chat/contact this sync action applies to. */
     jid: Jid;
-    timestamp: number;
-    action: ContactAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IContactAction;
     from_full_sync: boolean;
 }
 
@@ -358,7 +375,7 @@ export interface ContactUpdate {
 export interface ContactUpdated {
     /** The contact whose profile was updated. */
     jid: Jid;
-    timestamp: number;
+    timestamp: string;
 }
 
 export type DayOfWeek = "sun" | "mon" | "tue" | "wed" | "thu" | "fri" | "sat" | string;
@@ -380,8 +397,8 @@ export interface DeleteChatUpdate {
     jid: Jid;
     /** From the index, not the proto — DeleteChatAction only has messageRange. */
     delete_media: boolean;
-    timestamp: number;
-    action: DeleteChatAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IDeleteChatAction;
     from_full_sync: boolean;
 }
 
@@ -391,8 +408,8 @@ export interface DeleteMessageForMeUpdate {
     participant_jid?: Jid | null;
     message_id: string;
     from_me: boolean;
-    timestamp: number;
-    action: DeleteMessageForMeAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IDeleteMessageForMeAction;
     from_full_sync: boolean;
 }
 
@@ -406,7 +423,7 @@ export interface Device {
     signed_pre_key_id: number;
     signed_pre_key_signature: Uint8Array;
     adv_secret_key: Uint8Array;
-    account?: ADVSignedDeviceIdentity | null;
+    account?: import('./proto-types').proto.IADVSignedDeviceIdentity | null;
     push_name: string;
     app_version_primary: number;
     app_version_secondary: number;
@@ -543,8 +560,8 @@ export type DirtyType = "account_sync" | "groups" | "syncd_app_state" | "newslet
 export interface DisableLinkPreviewsUpdate {
     /** `true` when link previews are now disabled. Only emitted when the wire carried the flag; WA Web treats an absent one as a malformed mutation. */
     previews_disabled: boolean;
-    timestamp: number;
-    action: PrivacySettingDisableLinkPreviewsAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IPrivacySettingDisableLinkPreviewsAction;
     from_full_sync: boolean;
 }
 
@@ -764,7 +781,7 @@ export interface GroupUpdate {
     /** Country code supplied for the participant by the server. */
     participant_country_code?: string | null;
     /** When the change occurred */
-    timestamp: number;
+    timestamp: string;
     /** Whether the group uses LID addressing mode */
     is_lid_addressing_mode: boolean;
     /** Whether participant identity information was incomplete in the source stanza. */
@@ -787,7 +804,7 @@ export interface IdentityChange {
 
 /** One decrypted inbound message. The same items (and order) back both consumer surfaces: the durability hook's batch and [`Event::Messages`]. */
 export interface InboundMessage {
-    message: any;
+    message: import('./proto-types').proto.IMessage;
     info: MessageInfo;
 }
 
@@ -826,8 +843,8 @@ export interface LabelAssociationUpdate {
     label_id: string;
     /** The chat the label was associated with or removed from. */
     chat_jid: Jid;
-    timestamp: number;
-    action: LabelAssociationAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.ILabelAssociationAction;
     from_full_sync: boolean;
 }
 
@@ -835,8 +852,8 @@ export interface LabelAssociationUpdate {
 export interface LabelEditUpdate {
     /** The label identifier (the index key, not a JID). */
     label_id: string;
-    timestamp: number;
-    action: LabelEditAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.ILabelEditAction;
     from_full_sync: boolean;
 }
 
@@ -889,8 +906,8 @@ export interface LogoutMessage {
 export interface MarkChatAsReadUpdate {
     /** The chat being marked as read or unread. */
     jid: Jid;
-    timestamp: number;
-    action: MarkChatAsReadAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IMarkChatAsReadAction;
     from_full_sync: boolean;
 }
 
@@ -944,7 +961,7 @@ export interface MessageInfo {
     /** Envelope `peer_recipient_pn` attr. Present on companion-device self-synced DM stanzas to identify the peer's PN (so the receipt goes to the right routing target). */
     peer_recipient_pn?: Jid | null;
     /** Parent post key when the dispatched message is a decrypted CAG channel comment (`enc_comment_message`). The inner `Message` proto has no slot for the threading link, so it surfaces here. */
-    comment_target?: MessageKey | null;
+    comment_target?: import('./proto-types').proto.IMessageKey | null;
     /** Broadcast-contact-list recipients from `<participants><to jid>` on an incoming broadcast/status stanza. Populated only for broadcasts; used to validate a `deviceSentMessage.phash` (WA Web `validateBclHash`). Empty otherwise. */
     bcl_participants: Jid[];
 }
@@ -957,8 +974,8 @@ export interface MessageLabelAssociationUpdate {
     chat_jid: Jid;
     /** The labelled message's id. */
     message_id: string;
-    timestamp: number;
-    action: LabelAssociationAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.ILabelAssociationAction;
     from_full_sync: boolean;
 }
 
@@ -994,12 +1011,12 @@ export interface MexNotification {
     from?: Jid | null;
     stanza_id?: string | null;
     offline?: string | null;
-    payload: Value;
+    payload: JsonValue;
 }
 
 /** MEX GraphQL response. */
 export interface MexResponse {
-    data?: Value | null;
+    data?: JsonValue | null;
     errors?: MexGraphQLError[] | null;
 }
 
@@ -1018,7 +1035,7 @@ export type MissedReason = "offline" | "remote";
 export interface MsgBotInfo {
     edit_type?: BotEditType | null;
     edit_target_id?: string | null;
-    edit_sender_timestamp_ms?: number | null;
+    edit_sender_timestamp_ms?: string | null;
 }
 
 export interface MsgMetaInfo {
@@ -1049,7 +1066,7 @@ export interface MsgSecretEntry {
     sender: string;
     /** Message identifier. `Arc<str>` keeps entry clones used by buffered persistence cheap without changing the serialized representation. */
     msg_id: string;
-    secret: MessageSecret;
+    secret: Uint8Array;
     /** Absolute unix-seconds retention deadline. `0` means never expire. Computed by the caller from the parent message's event time plus a per-add-on-kind horizon (see `MsgSecretRetention`). The store prunes rows whose deadline has passed; it does not know the horizon itself. */
     expires_at: number | string;
     /** Parent message event time (unix seconds), or `0` when unknown. Kept so the receive path can enforce the edit-processing window (`editTs < message_ts + window`) the same way WhatsApp Web does. */
@@ -1059,8 +1076,8 @@ export interface MsgSecretEntry {
 export interface MuteUpdate {
     /** The chat being muted or unmuted. */
     jid: Jid;
-    timestamp: number;
-    action: MuteAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IMuteAction;
     from_full_sync: boolean;
 }
 
@@ -1185,7 +1202,7 @@ export interface PictureUpdate {
     jid: Jid;
     /** The user who made the change. Present for group picture changes (the admin who changed it). `None` for personal picture updates. */
     author?: Jid | null;
-    timestamp: number;
+    timestamp: string;
     /** Whether the picture was removed (true) or set/updated (false). */
     removed: boolean;
     /** The server-assigned picture ID (from `<set id="..."/>`). `None` for deletions. */
@@ -1195,8 +1212,8 @@ export interface PictureUpdate {
 export interface PinUpdate {
     /** The chat being pinned or unpinned. */
     jid: Jid;
-    timestamp: number;
-    action: PinAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IPinAction;
     from_full_sync: boolean;
 }
 
@@ -1208,7 +1225,7 @@ export interface PresenceUpdate {
     /** The contact whose presence changed. */
     from: Jid;
     unavailable: boolean;
-    last_seen?: number | null;
+    last_seen?: string | null;
 }
 
 export type PrivacyCategory = "last" | "online" | "profile" | "status" | "groupadd" | "readreceipts" | "calladd" | "messages" | "defense" | string;
@@ -1237,20 +1254,36 @@ export type PushPriority = "high" | "high_force";
 export interface QuickReplyUpdate {
     /** The quick reply's identifier (the index key, not a JID). */
     id: string;
-    timestamp: number;
-    action: QuickReplyAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IQuickReplyAction;
     from_full_sync: boolean;
 }
 
 export interface Receipt {
     source: MessageSource;
     message_ids: string[];
-    timestamp: number;
+    timestamp: string;
     type: ReceiptType;
     /** True when the receipt carried the `offline` attribute, i.e. it was drained from the server's offline queue on reconnect rather than delivered live. Mirrors WA Web `incomingMsgReceiptParser` (`offline: maybeAttrString`). */
     offline: boolean;
 }
 
+export type ReceiptType =
+| "Delivered"
+| "Sent"
+| "Sender"
+| "Retry"
+| "EncRekeyRetry"
+| "Read"
+| "ReadSelf"
+| "Played"
+| "PlayedSelf"
+| "ServerError"
+| "Inactive"
+| "PeerMsg"
+| "HistorySync"
+| { "Other": string };
+
 /** Chat state type as received from incoming stanzas.  Aligned with WhatsApp Web's `WAChatState` constants: - `typing` = ACTIVE_CHAT_STATE_TYPE.TYPING - `recording_audio` = ACTIVE_CHAT_STATE_TYPE.RECORDING_AUDIO - `idle` = IDLE_CHAT_STATE_TYPE.IDLE */
 export type ReceivedChatState = "typing" | "recording_audio" | "idle";
 
@@ -1279,7 +1312,7 @@ export interface ServerAck {
     /** Chat/entity the ack refers to, when present and parseable. */
     from?: Jid | null;
     /** Server timestamp from the ack's `t` attribute, when present. For a message ack this is the authoritative send timestamp (whatsmeow reads the same attribute into `SendResponse.Timestamp`). */
-    timestamp?: number | null;
+    timestamp?: string | null;
     /** Nack code (e.g. `"479"`) when the server rejected the stanza; `None` for a plain ack. */
     error?: string | null;
 }
@@ -1294,8 +1327,8 @@ export interface StarUpdate {
     participant_jid?: Jid | null;
     message_id: string;
     from_me: boolean;
-    timestamp: number;
-    action: StarAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IStarAction;
     from_full_sync: boolean;
 }
 
@@ -1345,7 +1378,7 @@ export interface UserAboutUpdate {
     /** The contact whose about text changed. */
     jid: Jid;
     status: string;
-    timestamp: number;
+    timestamp: string;
 }
 
 /** A contact/group/newsletter's status updates were muted/unmuted on a linked device. */
@@ -1354,8 +1387,8 @@ export interface UserStatusMuteUpdate {
     jid: Jid;
     /** `true` = status muted, `false` = unmuted. */
     muted: boolean;
-    timestamp: number;
-    action: UserStatusMuteAction;
+    timestamp: string;
+    action: import('./proto-types').proto.SyncActionValue.IUserStatusMuteAction;
     from_full_sync: boolean;
 }
 
@@ -3268,20 +3301,8 @@ export type WhatsAppEvent =
 | { type: 'contact_number_changed'; data: ContactNumberChanged }
 | { type: 'contact_sync_requested'; data: ContactSyncRequested }
 | { type: 'group_update'; data: GroupUpdate }
-| { type: 'contact_update'; data: ContactUpdate }
 | { type: 'push_name_update'; data: PushNameUpdate }
 | { type: 'self_push_name_updated'; data: SelfPushNameUpdated }
-| { type: 'pin_update'; data: PinUpdate }
-| { type: 'mute_update'; data: MuteUpdate }
-| { type: 'archive_update'; data: ArchiveUpdate }
-| { type: 'star_update'; data: StarUpdate }
-| { type: 'mark_chat_as_read_update'; data: MarkChatAsReadUpdate }
-| { type: 'delete_chat_update'; data: DeleteChatUpdate }
-| { type: 'clear_chat_update'; data: ClearChatUpdate }
-| { type: 'user_status_mute_update'; data: UserStatusMuteUpdate }
-| { type: 'delete_message_for_me_update'; data: DeleteMessageForMeUpdate }
-| { type: 'label_edit_update'; data: LabelEditUpdate }
-| { type: 'label_association_update'; data: LabelAssociationUpdate }
 | { type: 'offline_sync_preview'; data: OfflineSyncPreview }
 | { type: 'offline_sync_completed'; data: OfflineSyncCompleted }
 | { type: 'dirty_state'; data: { dirty_type: DirtyType; timestamp?: number | null } }
@@ -3301,6 +3322,25 @@ export type WhatsAppEvent =
 | { type: 'pair_passkey_request'; data: PairPasskeyRequest }
 | { type: 'pair_passkey_confirmation'; data: PairPasskeyConfirmation }
 | { type: 'pair_passkey_error'; data: PairPasskeyError }
+| { type: 'app_state_sync_failed'; data: AppStateSyncFailed }
+| { type: 'contact_removed'; data: ContactRemoved }
+| { type: 'pairing_qr_codes_exhausted'; data: PairingQrCodesExhausted }
+| { type: 'contact_update'; data: ContactUpdate }
+| { type: 'pin_update'; data: PinUpdate }
+| { type: 'mute_update'; data: MuteUpdate }
+| { type: 'archive_update'; data: ArchiveUpdate }
+| { type: 'star_update'; data: StarUpdate }
+| { type: 'mark_chat_as_read_update'; data: MarkChatAsReadUpdate }
+| { type: 'delete_chat_update'; data: DeleteChatUpdate }
+| { type: 'clear_chat_update'; data: ClearChatUpdate }
+| { type: 'user_status_mute_update'; data: UserStatusMuteUpdate }
+| { type: 'delete_message_for_me_update'; data: DeleteMessageForMeUpdate }
+| { type: 'label_edit_update'; data: LabelEditUpdate }
+| { type: 'label_association_update'; data: LabelAssociationUpdate }
+| { type: 'message_label_association_update'; data: MessageLabelAssociationUpdate }
+| { type: 'quick_reply_update'; data: QuickReplyUpdate }
+| { type: 'disable_link_previews_update'; data: DisableLinkPreviewsUpdate }
+| { type: 'call_log_sync'; data: CallLogSync }
 | { type: 'connected'; data: Record<string, never> }
 | { type: 'disconnected'; data: Record<string, never> }
 | { type: 'qr'; data: { code: string; timeout: number } }
@@ -3315,6 +3355,7 @@ export type WhatsAppEvent =
 | { type: 'client_outdated'; data: Record<string, never> }
 | { type: 'raw_node'; data: { tag: string; attrs: Record<string, string>; content?: unknown } }
 | { type: 'history_sync'; data: import('./proto-types').proto.IHistorySync & { syncType: number; chunkOrder?: number; progress?: number; peerDataRequestSessionId?: string } }
+| { type: 'pairing_code_error'; data: PairingCodeError }
 ;
 
 
@@ -4595,12 +4636,12 @@ export interface InitOutput {
     readonly intounderlyingsink_write: (a: number, b: number) => number;
     readonly intounderlyingsource_cancel: (a: number) => void;
     readonly intounderlyingsource_pull: (a: number, b: number) => number;
-    readonly __wasm_bindgen_func_elem_4245: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_25789: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_25791: (a: number, b: number, c: number, d: number) => void;
-    readonly __wasm_bindgen_func_elem_9069: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_4244: (a: number, b: number, c: number) => void;
-    readonly __wasm_bindgen_func_elem_4243: (a: number, b: number) => void;
+    readonly __wasm_bindgen_func_elem_4319: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_26158: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_26160: (a: number, b: number, c: number, d: number) => void;
+    readonly __wasm_bindgen_func_elem_9212: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_4318: (a: number, b: number, c: number) => void;
+    readonly __wasm_bindgen_func_elem_4317: (a: number, b: number) => void;
     readonly __wbindgen_export: (a: number, b: number) => number;
     readonly __wbindgen_export2: (a: number, b: number, c: number, d: number) => number;
     readonly __wbindgen_export3: (a: number) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@oxidezap/whatsapp-rust-bridge",
-    "version": "0.9.0",
+    "version": "0.10.0",
     "description": "A high-performance utilities for WhatsApp, powered by Rust and WebAssembly.",
     "author": "João Lucas <jlucaso@hotmail.com>",
     "license": "MIT",
@@ -34,7 +34,7 @@
         "gen:bridge-types": "cargo fetch && cd codegen && cargo run -q --bin gen-types --target $(rustc -vV | grep host | cut -d' ' -f2) > ../src/generated_types.rs.tmp && mv ../src/generated_types.rs.tmp ../src/generated_types.rs",
         "gen:proto-codec": "bun run scripts/gen-ts-proto.ts",
         "gen:proto-types": "bun run scripts/gen-protobufjs-dts.ts",
-        "gen": "bun run gen:bridge-types && bun run gen:proto-codec && bun run gen:proto-types",
+        "gen": "bun run gen:proto-codec && bun run gen:proto-types && bun run gen:bridge-types",
         "build:wasm": "wasm-pack build --target web --out-dir pkg --no-pack",
         "build:wasm:dev": "wasm-pack build --target web --out-dir pkg --no-pack --dev",
         "build:ts": "bun build ts/index.ts --minify --outfile dist/index.js --target node && cp pkg/whatsapp_rust_bridge_bg.wasm dist/ && cp ts/proto-types.d.ts dist/proto-types.d.ts && cp ts/proto-types.d.ts pkg/proto-types.d.ts && printf 'export { proto } from \"./index.js\";\\n' > dist/proto-types.js",