@neelegirly/baileys 2.2.18 → 2.2.19

package/lib/Socket/messages-recv.js

@@ -364,7 +364,8 @@ const makeMessagesRecvSocket = (config) => {
     child,
     msg,
     participantPhoneNumber,
-    mode
+    mode,
+    participantUsername
   ) => {
     if (participant && participant.endsWith("@lid") && participantPhoneNumber) {
       participant = participantPhoneNumber;
@@ -411,7 +412,7 @@ const makeMessagesRecvSocket = (config) => {
         const metadata = groups_1.extractGroupMetadata(child);
         msg.messageStubType = Types_1.WAMessageStubType.GROUP_CREATE;
         msg.messageStubParameters = [metadata.subject];
-        msg.key = { participant: metadata.owner };
+        msg.key = { participant: metadata.owner, participantUsername: metadata.ownerUsername };
         ev.emit("chats.upsert", [
           {
             id: metadata.id,
@@ -423,6 +424,8 @@ const makeMessagesRecvSocket = (config) => {
           {
             ...metadata,
             author: participant,
+            authorPn: participantPhoneNumber,
+            authorUsername: participantUsername,
           },
         ]);
         break;
@@ -457,7 +460,7 @@ const makeMessagesRecvSocket = (config) => {
       case "leave":
         let stubType = `GROUP_PARTICIPANT_${child.tag.toUpperCase()}`;
         if (child.attrs?.reason === "linked_group_join") {
-          stubType = GROUP_PARTICIPANT_LINKED_GROUP_JOIN;
+          stubType = "GROUP_PARTICIPANT_LINKED_GROUP_JOIN";
         }
         msg.messageStubType = Types_1.WAMessageStubType[stubType];
         const participants = (0, WABinary_1.getBinaryNodeChildren)(
@@ -494,7 +497,7 @@ const makeMessagesRecvSocket = (config) => {
         msg.messageStubType = Types_1.WAMessageStubType.GROUP_CHANGE_SUBJECT;
         msg.messageStubType =
           Types_1.WAMessageStubType.COMMUNITY_PARENT_GROUP_SUBJECT_CHANGED;
-        msg.messageStubParameters = [participantJid, child.attrs.subject];
+        msg.messageStubParameters = [child.attrs.subject, participantJid];
         break;
       case "description":
         const description = WABinary_1.getBinaryNodeChild(
@@ -614,7 +617,7 @@ const makeMessagesRecvSocket = (config) => {
           child,
           "sub_group_suggestions"
         );
-        const reason = res.attrs?.reason;
+        const reason = res[0]?.attrs?.reason;
         if (reason === "approved")
           msg.messageStubType = Types_1.WAMessageStubType.GROUP_CREATE;
         else
@@ -633,10 +636,10 @@ const makeMessagesRecvSocket = (config) => {
     const serverId = node.attrs.server_id;
 
     const reactionsList = WABinary_1.getBinaryNodeChild(node, "reactions");
-    const viewsList = WABinary_1.getBinaryNodeChild(node, "views_count");
+    const viewsList = WABinary_1.getBinaryNodeChildren(node, "views_count");
 
     if (reactionsList) {
-      const reactions = WABinary_1.getBinaryNodeChild(
+      const reactions = WABinary_1.getBinaryNodeChildren(
         reactionsList,
         "reaction"
       );
@@ -766,7 +769,8 @@ const makeMessagesRecvSocket = (config) => {
           child,
           result,
           node.attrs.participant_pn,
-          mode
+          mode,
+          node.attrs.participant_username
         );
         break;
       case "newsletter":
@@ -1175,6 +1179,7 @@ const makeMessagesRecvSocket = (config) => {
               remoteJid,
               fromMe,
               participant: node.attrs.participant,
+              participantUsername: node.attrs.participant_username,
               id: node.attrs.id,
               ...(msg.key || {}),
             };
@@ -1557,12 +1562,24 @@ const makeMessagesRecvSocket = (config) => {
     const call = {
       chatId: attrs.from,
       from,
+      callerPn: infoChild.attrs["caller_pn"],
       id: callId,
       date: new Date(+attrs.t * 1000),
       offline: !!attrs.offline,
       status,
     };
 
+    if (status === "relaylatency") {
+      const latencyValue =
+        infoChild.attrs.latency ||
+        infoChild.attrs["latency_ms"] ||
+        infoChild.attrs["latency-ms"];
+      const latencyMs = latencyValue ? Number(latencyValue) : undefined;
+      if (Number.isFinite(latencyMs)) {
+        call.latencyMs = latencyMs;
+      }
+    }
+
     if (status === "offer") {
       call.isVideo = !!WABinary_1.getBinaryNodeChild(infoChild, "video");
       call.isGroup =
@@ -1577,6 +1594,7 @@ const makeMessagesRecvSocket = (config) => {
     if (existingCall) {
       call.isVideo = existingCall.isVideo;
       call.isGroup = existingCall.isGroup;
+      call.callerPn = call.callerPn || existingCall.callerPn;
     }
 
     // delete data once call has ended

package/lib/Socket/messages-send.d.ts

@@ -123,6 +123,11 @@ export declare const makeMessagesSocket: (config: SocketConfig) => {
     resyncAppState: (collections: readonly ("critical_block" | "critical_unblock_low" | "regular_high" | "regular_low" | "regular")[], isInitialSync: boolean) => Promise<void>
     chatModify: (mod: import("../Types").ChatModification, jid: string) => Promise<void>
     cleanDirtyBits: (type: "account_sync" | "groups", fromTimestamp?: string | number | undefined) => Promise<void>
+    serverProps: {
+        privacyTokenOn1to1: boolean
+        profilePicPrivacyToken: boolean
+        lidTrustedTokenIssueToLid: boolean
+    }
     addLabel: (jid: string, labels: import("../Types/Label").LabelActionBody) => Promise<void>
     addChatLabel: (jid: string, labelId: string) => Promise<void>
     removeChatLabel: (jid: string, labelId: string) => Promise<void>
@@ -165,4 +170,4 @@ export declare const makeMessagesSocket: (config: SocketConfig) => {
     requestPairingCode: (phoneNumber: string, code?: string) => Promise<string>
     waitForConnectionUpdate: (check: (u: Partial<import("../Types").ConnectionState>) => boolean | undefined, timeoutMs?: number | undefined) => Promise<void>
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
-}
+}

package/lib/Socket/newsletter.d.ts

@@ -101,6 +101,11 @@ export declare const makeNewsletterSocket: (config: SocketConfig) => {
     resyncAppState: (collections: readonly ("critical_block" | "critical_unblock_low" | "regular_high" | "regular_low" | "regular")[], isInitialSync: boolean) => Promise<void>
     chatModify: (mod: import("../Types").ChatModification, jid: string) => Promise<void>
     cleanDirtyBits: (type: "account_sync" | "groups", fromTimestamp?: string | number | undefined) => Promise<void>
+    serverProps: {
+        privacyTokenOn1to1: boolean
+        profilePicPrivacyToken: boolean
+        lidTrustedTokenIssueToLid: boolean
+    }
     addChatLabel: (jid: string, labelId: string) => Promise<void>
     removeChatLabel: (jid: string, labelId: string) => Promise<void>
     addMessageLabel: (jid: string, messageId: string, labelId: string) => Promise<void>
@@ -144,4 +149,4 @@ export declare const makeNewsletterSocket: (config: SocketConfig) => {
     sendWAMBuffer: (wamBuffer: Buffer) => Promise<BinaryNode>
 }
 
-export declare const extractNewsletterMetadata: (node: BinaryNode, isCreate?: boolean) => NewsletterMetadata
+export declare const extractNewsletterMetadata: (node: BinaryNode, isCreate?: boolean) => NewsletterMetadata

package/lib/Socket/registration.d.ts

@@ -133,6 +133,11 @@ export declare const makeRegistrationSocket: (config: SocketConfig) => {
     resyncAppState: (collections: readonly ("critical_block" | "critical_unblock_low" | "regular_high" | "regular_low" | "regular")[], isInitialSync: boolean) => Promise<void>;
     chatModify: (mod: import("../Types").ChatModification, jid: string) => Promise<void>;
     cleanDirtyBits: (type: "account_sync" | "groups", fromTimestamp?: number | string) => Promise<void>;
+    serverProps: {
+        privacyTokenOn1to1: boolean;
+        profilePicPrivacyToken: boolean;
+        lidTrustedTokenIssueToLid: boolean;
+    };
     addChatLabel: (jid: string, labelId: string) => Promise<void>;
     removeChatLabel: (jid: string, labelId: string) => Promise<void>;
     addMessageLabel: (jid: string, messageId: string, labelId: string) => Promise<void>;

package/lib/Socket/socket.js

@@ -403,43 +403,69 @@ const makeSocket = (config) => {
         }
     }
     
+    const isNoiseDecryptAuthError = (error) => {
+        const combined = `${error?.message || ''}\n${error?.stack || ''}`.toLowerCase()
+        return /unsupported state or unable to authenticate data|aesdecryptgcm|noise-handler|decipheriv\.final/.test(combined)
+    }
+
     const onMessageReceived = async (data) => {
-        await noise.decodeFrame(data, frame => {
-            // reset ping timeout
-            lastDateRecv = new Date()
-            let anyTriggered = false
-            anyTriggered = ws.emit('frame', frame)
-            
-            // if it's a binary node
-            if (!(frame instanceof Uint8Array)) {
-                const msgId = frame.attrs.id
+        try {
+            await noise.decodeFrame(data, frame => {
+                // reset ping timeout
+                lastDateRecv = new Date()
+                let anyTriggered = false
+                anyTriggered = ws.emit('frame', frame)
                 
-                if (logger.level === 'trace') {
-                    logger.trace({ xml: WABinary_1.binaryNodeToString(frame), msg: 'recv xml' })
-                }
+                // if it's a binary node
+                if (!(frame instanceof Uint8Array)) {
+                    const msgId = frame.attrs.id
+
+                    if (logger.level === 'trace') {
+                        logger.trace({ xml: WABinary_1.binaryNodeToString(frame), msg: 'recv xml' })
+                    }
                 
-                /* Check if this is a response to a message we sent */
-                anyTriggered = ws.emit(`${Defaults_1.DEF_TAG_PREFIX}${msgId}`, frame) || anyTriggered
+                    /* Check if this is a response to a message we sent */
+                    anyTriggered = ws.emit(`${Defaults_1.DEF_TAG_PREFIX}${msgId}`, frame) || anyTriggered
                 
-                /* Check if this is a response to a message we are expecting */
-                const l0 = frame.tag
-                const l1 = frame.attrs || {}
-                const l2 = Array.isArray(frame.content) ? frame.content[0]?.tag : ''
+                    /* Check if this is a response to a message we are expecting */
+                    const l0 = frame.tag
+                    const l1 = frame.attrs || {}
+                    const l2 = Array.isArray(frame.content) ? frame.content[0]?.tag : ''
                 
-                for (const key of Object.keys(l1)) {
-                    anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0},${key}:${l1[key]},${l2}`, frame) || anyTriggered
-                    anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0},${key}:${l1[key]}`, frame) || anyTriggered
-                    anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0},${key}`, frame) || anyTriggered
-                }
+                    for (const key of Object.keys(l1)) {
+                        anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0},${key}:${l1[key]},${l2}`, frame) || anyTriggered
+                        anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0},${key}:${l1[key]}`, frame) || anyTriggered
+                        anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0},${key}`, frame) || anyTriggered
+                    }
                 
-                anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0},,${l2}`, frame) || anyTriggered
-                anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0}`, frame) || anyTriggered
+                    anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0},,${l2}`, frame) || anyTriggered
+                    anyTriggered = ws.emit(`${Defaults_1.DEF_CALLBACK_PREFIX}${l0}`, frame) || anyTriggered
                 
-                if (!anyTriggered && logger.level === 'debug') {
-                    logger.debug({ unhandled: true, msgId, fromMe: false, frame }, 'communication recv')
+                    if (!anyTriggered && logger.level === 'debug') {
+                        logger.debug({ unhandled: true, msgId, fromMe: false, frame }, 'communication recv')
+                    }
                 }
-            }
-        })
+            })
+        } catch (error) {
+            const isNoiseDecryptError = isNoiseDecryptAuthError(error)
+            logger.warn(
+                { trace: error?.stack, msg: error?.message },
+                isNoiseDecryptError
+                    ? 'noise decrypt failed, closing socket for retry'
+                    : 'incoming frame decode failed, closing socket'
+            )
+            end(
+                error instanceof boom_1.Boom
+                    ? error
+                    : new boom_1.Boom(
+                        isNoiseDecryptError ? 'Noise decrypt failed' : 'Failed to decode incoming frame',
+                        {
+                            statusCode: Types_1.DisconnectReason.connectionClosed,
+                            data: { cause: error?.message || String(error || '') }
+                        }
+                    )
+            )
+        }
     }
     
     const end = (error) => {

package/lib/Types/Call.d.ts

@@ -1,8 +1,9 @@
-export type WACallUpdateType = 'offer' | 'ringing' | 'timeout' | 'reject' | 'accept' | 'terminate'
+export type WACallUpdateType = 'offer' | 'ringing' | 'preaccept' | 'transport' | 'relaylatency' | 'timeout' | 'reject' | 'accept' | 'terminate'
 
 export type WACallEvent = {
     chatId: string
     from: string
+    callerPn?: string
     isGroup?: boolean
     groupJid?: string
     id: string
@@ -11,4 +12,4 @@ export type WACallEvent = {
     status: WACallUpdateType
     offline: boolean
     latencyMs?: number
-}
+}

package/lib/Types/Contact.d.ts

@@ -6,6 +6,8 @@ export interface Contact {
     name?: string
     /** name of the contact, the contact has set on their own on WA */
     notify?: string
+    /** username associated with this contact, when provided by WA */
+    username?: string
     /** I have no idea */
     verifiedName?: string
     /**
@@ -17,4 +19,4 @@ export interface Contact {
      */
     imgUrl?: string | null
     status?: string
-}
+}

package/lib/Types/Events.d.ts

@@ -24,8 +24,15 @@ export type BaileysEventMap = {
         isLatest?: boolean
         progress?: number | null
         syncType?: proto.HistorySync.HistorySyncType
+        chunkOrder?: number | null
         peerDataRequestSessionId?: string | null
     }
+    /** signals history sync milestones (completion or stall) per sync type */
+    'messaging-history.status': {
+        syncType: proto.HistorySync.HistorySyncType
+        status: 'complete' | 'paused'
+        explicit: boolean
+    }
     /** upsert chats */
     'chats.upsert': Chat[]
     /** update the given chats */
@@ -86,13 +93,18 @@ export type BaileysEventMap = {
     'group-participants.update': {
         id: string
         author: string
+        authorPn?: string
+        authorUsername?: string
         participants: string[]
         action: ParticipantAction
     }
     'group.join-request': {
         id: string
         author: string
+        authorPn?: string
+        authorUsername?: string
         participant: string
+        participantPn?: string
         action: RequestJoinAction
         method: RequestJoinMethod
     }
@@ -174,6 +186,7 @@ export type BufferedEventData = {
         isLatest: boolean
         progress?: number | null
         syncType?: proto.HistorySync.HistorySyncType
+        chunkOrder?: number | null
         peerDataRequestSessionId?: string
     }
     chatUpserts: {
@@ -234,4 +247,4 @@ export interface BaileysEventEmitter {
     off<T extends keyof BaileysEventMap>(event: T, listener: (arg: BaileysEventMap[T]) => void): void
     removeAllListeners<T extends keyof BaileysEventMap>(event: T): void
     emit<T extends keyof BaileysEventMap>(event: T, arg: BaileysEventMap[T]): boolean
-}
+}

package/lib/Types/GroupMetadata.d.ts

@@ -16,15 +16,21 @@ export interface GroupMetadata {
     id: string
     addressingMode: string
     owner: string | undefined
+    ownerPn?: string
+    ownerUsername?: string
     ownerCountry: string, 
     subject: string
     /** group subject owner */
     subjectOwner?: string
+    subjectOwnerPn?: string
+    subjectOwnerUsername?: string
     /** group subject modification date */
     subjectTime?: number
     creation?: number
     desc?: string
     descOwner?: string
+    descOwnerPn?: string
+    descOwnerUsername?: string
     descId?: string
     /** if this group is part of a community, it returns the jid of the community to which it belongs */
     linkedParent?: string
@@ -48,6 +54,8 @@ export interface GroupMetadata {
     inviteCode?: string
     /** the person who added you to group or changed some setting in group */
     author?: string
+    authorPn?: string
+    authorUsername?: string
 }
 
 export interface WAGroupCreateResponse {
@@ -63,4 +71,4 @@ export interface GroupModificationResponse {
     participants?: {
         [key: string]: {}
     }
-}
+}

package/lib/Types/Message.d.ts

@@ -19,6 +19,12 @@ export type WAContactMessage = proto.Message.IContactMessage
 export type WAContactsArrayMessage = proto.Message.IContactsArrayMessage
 
 export type WAMessageKey = proto.IMessageKey & {
+    remoteJidAlt?: string
+    remoteJidUsername?: string
+    participantAlt?: string
+    participantUsername?: string
+    participant_pn?: string
+    participant_lid?: string
     newsletter_server_id?: string
 }
 
@@ -199,6 +205,13 @@ export type PollResultOptions = {
     values: string[]
 }
 
+export type AlbumMessageOptions = {
+    /** Number of images expected in the album */
+    expectedImageCount?: number
+    /** Number of videos expected in the album */
+    expectedVideoCount?: number
+}
+
 type SharePhoneNumber = {
     sharePhoneNumber: boolean
 }
@@ -234,7 +247,10 @@ export type AnyMediaMessageContent = (({
     caption?: string
 } & Contextable & Buttonable & Templatable & Interactiveable )) & {
     mimetype?: string
-} & Editable
+} & Editable & {
+    /** key of the parent albumMessage to associate this media with */
+    albumParentKey?: WAMessageKey
+}
 
 export type ButtonReplyInfo = {
     displayText: string
@@ -332,7 +348,9 @@ export type AnyRegularMessageContent = (({
     }
 } | {
     pollResult: PollResultOptions
-} | {
+} | ({
+    album: AlbumMessageOptions
+} & Contextable & Mentionable) | {
     order: WAOrderMessage
 } | {
     product: WASendableProduct
@@ -470,4 +488,4 @@ export type MediaDecryptionKeyInfo = {
     macKey?: Buffer
 }
 
-export type MinimalMessage = Pick<proto.IWebMessageInfo, 'key' | 'messageTimestamp'>
+export type MinimalMessage = Pick<proto.IWebMessageInfo, 'key' | 'messageTimestamp'>

package/lib/Types/Signal.d.ts

@@ -49,7 +49,19 @@ type E2ESessionOpts = {
     session: E2ESession
 }
 
+type LIDPNMapping = {
+    lid: string
+    pn: string
+}
+
 export type SignalRepository = {
+    lidMapping: {
+        storeLIDPNMappings(mappings: LIDPNMapping[]): Promise<boolean>
+        getPNForLID(lid: string): Promise<string | null>
+        getLIDForPN(pn: string): Promise<string | null>
+        getLIDsForPNs(pns: string[]): Promise<LIDPNMapping[]>
+    }
+    migrateSession(fromJid: string, toJid: string): Promise<boolean>
     decryptGroupMessage(opts: DecryptGroupSignalOpts): Promise<Uint8Array>
     processSenderKeyDistributionMessage(opts: ProcessSenderKeyDistributionMessageOpts): Promise<void>
     decryptMessage(opts: DecryptSignalProtoOpts): Promise<Uint8Array>
@@ -63,6 +75,10 @@ export type SignalRepository = {
     }>
     injectE2ESession(opts: E2ESessionOpts): Promise<void>
     jidToSignalProtocolAddress(jid: string): string
+    validateSession(jid: string): Promise<{
+        exists: boolean
+        reason?: string
+    }>
 }
 
-export {}
+export {}

package/lib/Utils/chat-utils.d.ts

@@ -10,8 +10,28 @@ export type ChatMutationMap = {
     [index: string]: ChatMutation
 }
 
+export declare const makeLtHashGenerator: ({ indexValueMap, hash }: Pick<LTHashState, 'hash' | 'indexValueMap'>) => {
+    mix: (mac: {
+        indexMac: Uint8Array
+        valueMac: Uint8Array
+        operation: proto.SyncdMutation.SyncdOperation
+    }) => void
+    finish: () => Promise<{
+        hash: Buffer
+        indexValueMap: LTHashState['indexValueMap']
+    }>
+}
+
 export declare const newLTHashState: () => LTHashState
 
+export declare const ensureLTHashStateVersion: (state: LTHashState) => LTHashState
+
+export declare const MAX_SYNC_ATTEMPTS: 2
+
+export declare const isMissingKeyError: (error: any) => boolean
+
+export declare const isAppStateSyncIrrecoverable: (error: any, attempts: number) => boolean
+
 export declare const encodeSyncdPatch: ({ type, index, syncAction, apiVersion, operation }: WAPatchCreate, myAppStateKeyId: string, state: LTHashState, getAppStateSyncKey: FetchAppStateSyncKey) => Promise<{
     patch: proto.ISyncdPatch
     state: LTHashState
@@ -79,4 +99,4 @@ export declare const chatModificationToAppPatch: (mod: ChatModification, jid: st
 
 export declare const processSyncAction: (syncAction: ChatMutation, ev: BaileysEventEmitter, me: Contact, initialSyncOpts?: InitialAppStateSyncOptions, logger?: ILogger) => void
 
-export {}
+export {}

package/lib/Utils/chat-utils.js

@@ -60,7 +60,7 @@ const makeLtHashGenerator = ({ indexValueMap, hash }) => {
             const prevOp = indexValueMap[indexMacBase64]
             if (operation === WAProto_1.proto.SyncdMutation.SyncdOperation.REMOVE) {
                 if (!prevOp) {
-                    throw new boom_1.Boom('tried remove, but no previous op', { data: { indexMac, valueMac } })
+                    return
                 }
                 // remove from index value mac, since this mutation is erased
                 delete indexValueMap[indexMacBase64]
@@ -107,10 +107,23 @@ const generatePatchMac = (snapshotMac, valueMacs, version, type, key) => {
 
 const newLTHashState = () => ({ version: 0, hash: Buffer.alloc(128), indexValueMap: {} })
 
+const ensureLTHashStateVersion = (state) => {
+    if (typeof state.version !== 'number' || Number.isNaN(state.version)) {
+        state.version = 0
+    }
+    return state
+}
+
+const MAX_SYNC_ATTEMPTS = 2
+
+const isMissingKeyError = (error) => error?.data?.isMissingKey === true
+
+const isAppStateSyncIrrecoverable = (error, attempts) => attempts >= MAX_SYNC_ATTEMPTS || error?.name === 'TypeError'
+
 const encodeSyncdPatch = async ({ type, index, syncAction, apiVersion, operation }, myAppStateKeyId, state, getAppStateSyncKey) => {
     const key = !!myAppStateKeyId ? await getAppStateSyncKey(myAppStateKeyId) : undefined
     if (!key) {
-        throw new boom_1.Boom(`myAppStateKey ("${myAppStateKeyId}") not present`, { statusCode: 404 })
+        throw new boom_1.Boom(`myAppStateKey ("${myAppStateKeyId}") not present`, { data: { isMissingKey: true } })
     }
     const encKeyId = Buffer.from(myAppStateKeyId, 'base64')
     state = { ...state, indexValueMap: { ...state.indexValueMap } }
@@ -197,7 +210,7 @@ const decodeSyncdMutations = async (msgMutations, initialState, getAppStateSyncK
         const base64Key = Buffer.from(keyId).toString('base64')
         const keyEnc = await getAppStateSyncKey(base64Key)
         if (!keyEnc) {
-            throw new boom_1.Boom(`failed to find key "${base64Key}" to decode mutation`, { statusCode: 404, data: { msgMutations } })
+            throw new boom_1.Boom(`failed to find key "${base64Key}" to decode mutation`, { data: { isMissingKey: true, msgMutations } })
         }
         return mutationKeys(keyEnc.keyData)
     }
@@ -208,7 +221,7 @@ const decodeSyncdPatch = async (msg, name, initialState, getAppStateSyncKey, onM
         const base64Key = Buffer.from(msg.keyId.id).toString('base64')
         const mainKeyObj = await getAppStateSyncKey(base64Key)
         if (!mainKeyObj) {
-            throw new boom_1.Boom(`failed to find key "${base64Key}" to decode patch`, { statusCode: 404, data: { msg } })
+            throw new boom_1.Boom(`failed to find key "${base64Key}" to decode patch`, { data: { isMissingKey: true, msg } })
         }
         const mainKey = await mutationKeys(mainKeyObj.keyData)
         const mutationmacs = msg.mutations.map(mutation => mutation.record.value.blob.slice(-32))
@@ -291,7 +304,7 @@ const decodeSyncdSnapshot = async (name, snapshot, getAppStateSyncKey, minimumVe
         const base64Key = Buffer.from(snapshot.keyId.id).toString('base64')
         const keyEnc = await getAppStateSyncKey(base64Key)
         if (!keyEnc) {
-            throw new boom_1.Boom(`failed to find key "${base64Key}" to decode mutation`)
+            throw new boom_1.Boom(`failed to find key "${base64Key}" to decode mutation`, { data: { isMissingKey: true } })
         }
         const result = await mutationKeys(keyEnc.keyData)
         const computedSnapshotMac = generateSnapshotMac(newState.hash, newState.version, name, result.snapshotMacKey)
@@ -335,7 +348,7 @@ const decodePatches = async (name, syncds, initial, getAppStateSyncKey, options,
             const base64Key = Buffer.from(keyId.id).toString('base64')
             const keyEnc = await getAppStateSyncKey(base64Key)
             if (!keyEnc) {
-                throw new boom_1.Boom(`failed to find key "${base64Key}" to decode mutation`)
+                throw new boom_1.Boom(`failed to find key "${base64Key}" to decode mutation`, { data: { isMissingKey: true } })
             }
             const result = await mutationKeys(keyEnc.keyData)
             const computedSnapshotMac = generateSnapshotMac(newState.hash, newState.version, name, result.snapshotMacKey)
@@ -690,7 +703,8 @@ const processSyncAction = (syncAction, ev, me, initialSyncOpts, logger) => {
     else if (action?.contactAction) {
             ev.emit('contacts.upsert', [{
             id, 
-            name: action.contactAction.fullName, 
+            name: action.contactAction.fullName || action.contactAction.firstName || action.contactAction.username || undefined,
+            username: action.contactAction.username || undefined,
             lid: action.contactAction.lidJid || undefined, 
             jid: WABinary_1.isJidUser(id) ? id : undefined
         }]) 
@@ -784,7 +798,12 @@ const processSyncAction = (syncAction, ev, me, initialSyncOpts, logger) => {
 
 module.exports = {
   mutationKeys, 
+  makeLtHashGenerator,
   newLTHashState, 
+  ensureLTHashStateVersion,
+  MAX_SYNC_ATTEMPTS,
+  isMissingKeyError,
+  isAppStateSyncIrrecoverable,
   encodeSyncdPatch, 
   decodeSyncdMutations, 
   decodeSyncdPatch, 
@@ -795,4 +814,4 @@ module.exports = {
   decodePatches, 
   chatModificationToAppPatch, 
   processSyncAction
-}
+}

package/lib/Utils/decode-wa-message.js

@@ -112,9 +112,13 @@ const fromMe = WABinary_1.isJidNewsletter(stanza.attrs.from)
     const pushname = stanza?.attrs?.notify
     const key = {
         remoteJid: chatId,
+        remoteJidUsername: !WABinary_1.isJidGroup(chatId)
+            ? stanza.attrs.peer_recipient_username || stanza.attrs.recipient_username
+            : undefined,
         fromMe,
         id: msgId,
         ...(participant !== undefined && { participant: fromMe ? meId : participant }),
+        ...(stanza.attrs.participant !== undefined && { participantUsername: stanza.attrs.participant_username }),
         ...(stanza.attrs.participant_pn !== undefined && { participant_pn: fromMe ? meId : stanza.attrs.participant_pn }),
         ...(stanza.attrs.participant_lid !== undefined && { participant_lid: fromMe ? meLid : stanza.attrs.participant_lid }),
     }
@@ -285,4 +289,4 @@ const decryptMessageNode = (stanza, meId, meLid, repository, logger) => {
 module.exports = {
   decodeMessageNode, 
   decryptMessageNode
-}
+}

package/lib/Utils/event-buffer.js

@@ -188,6 +188,7 @@ function append(data, historyCache, event, eventData, logger) {
             data.historySets.empty = false
             data.historySets.syncType = eventData.syncType
             data.historySets.progress = eventData.progress
+            data.historySets.chunkOrder = eventData.chunkOrder
             data.historySets.peerDataRequestSessionId = eventData.peerDataRequestSessionId
             data.historySets.isLatest = eventData.isLatest || data.historySets.isLatest
             break
@@ -483,6 +484,7 @@ function consolidateEvents(data) {
             syncType: data.historySets.syncType,
             progress: data.historySets.progress,
             isLatest: data.historySets.isLatest,
+            chunkOrder: data.historySets.chunkOrder,
             peerDataRequestSessionId: data.historySets.peerDataRequestSessionId
         }
     }
@@ -562,4 +564,4 @@ const stringifyMessageKey = (key) => `${key.remoteJid},${key.id},${key.fromMe ?
 
 module.exports = {
   makeEventBuffer
-}
+}

package/lib/Utils/generics.js

@@ -507,6 +507,15 @@ const getCallStatusFromNode = ({ tag, attrs }) => {
                 status = 'terminate'
             }
             break
+        case 'preaccept':
+            status = 'preaccept'
+            break
+        case 'transport':
+            status = 'transport'
+            break
+        case 'relaylatency':
+            status = 'relaylatency'
+            break
         case 'reject':
             status = 'reject'
             break