@queenanya/baileys 9.2.1 → 9.4.1

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

@@ -1,4 +1,17 @@
 import type { BrowsersMap } from '../Types/index.js';
 export declare const Browsers: BrowsersMap;
+/**
+ * Checks if the browser tuple represents an Android companion device.
+ */
+export declare const isAndroidBrowser: (browser: [string, string, string]) => boolean;
+/**
+ * Returns a numeric platform ID string for the given browser name.
+ * Falls back to Chrome (1) for unknown/non-browser platforms.
+ */
 export declare const getPlatformId: (browser: string) => string;
+/**
+ * Returns the display name for the given browser type.
+ * Falls back to 'Chrome' if browser type is not a known platform type.
+ */
+export declare const getPlatformDisplayName: (browser: string) => string;
 //# sourceMappingURL=browser-utils.d.ts.map

package/lib/Utils/browser-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser-utils.d.ts","sourceRoot":"","sources":["../../src/Utils/browser-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAgB3C,eAAO,MAAM,QAAQ,EAAE,WAOtB,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,WAG5C,CAAA"}
+{"version":3,"file":"browser-utils.d.ts","sourceRoot":"","sources":["../../src/Utils/browser-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAmD3C,eAAO,MAAM,QAAQ,EAAE,WAyBtB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,KAAG,OAEpE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,WAe5C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,SAAS,MAAM,WAGrD,CAAA"}

package/lib/Utils/browser-utils.js

@@ -8,21 +8,101 @@ const PLATFORM_MAP = {
     freebsd: 'FreeBSD',
     openbsd: 'OpenBSD',
     sunos: 'Solaris',
-    linux: undefined,
-    haiku: undefined,
-    cygwin: undefined,
-    netbsd: undefined
+    linux: 'Linux',
+    ubuntu: 'Ubuntu',
+    ios: 'iOS',
+    baileys: 'Baileys',
+    chromeos: 'Chrome OS',
+    tizen: 'Tizen',
+    watchos: 'watchOS',
+    wearos: 'Wear OS',
+    harmonyos: 'HarmonyOS',
+    kaios: 'KaiOS',
+    smarttv: 'Smart TV',
+    raspberrypi: 'Raspberry Pi OS',
+    symbian: 'Symbian',
+    blackberry: 'Blackberry OS',
+    windowsphone: 'Windows Phone'
+};
+const PLATFORM_VERSIONS = {
+    ubuntu: '22.04.4',
+    darwin: '18.5',
+    win32: '10.0.22631',
+    android: '14.0.0',
+    freebsd: '13.2',
+    openbsd: '7.3',
+    sunos: '11',
+    linux: '6.5',
+    ios: '18.2',
+    baileys: '6.5.0',
+    chromeos: '117.0.5938.132',
+    tizen: '6.5',
+    watchos: '10.1',
+    wearos: '4.1',
+    harmonyos: '4.0.0',
+    kaios: '3.1',
+    smarttv: '23.3.1',
+    raspberrypi: '11 (Bullseye)',
+    symbian: '3',
+    blackberry: '10.3.3',
+    windowsphone: '8.1'
 };
 export const Browsers = {
-    ubuntu: browser => ['Ubuntu', browser, '22.04.4'],
-    macOS: browser => ['Mac OS', browser, '14.4.1'],
-    baileys: browser => ['Baileys', browser, '6.5.0'],
-    windows: browser => ['Windows', browser, '10.0.22631'],
+    ubuntu: browser => ['Ubuntu', browser, PLATFORM_VERSIONS['ubuntu']],
+    macOS: browser => ['Mac OS', browser, PLATFORM_VERSIONS['darwin']],
+    baileys: browser => ['Baileys', browser, PLATFORM_VERSIONS['baileys']],
+    windows: browser => ['Windows', browser, PLATFORM_VERSIONS['win32']],
+    linux: browser => ['Linux', browser, PLATFORM_VERSIONS['linux']],
+    /** iOS device */
+    iOS: browser => ['iOS', browser, PLATFORM_VERSIONS['ios']],
+    /** Android companion device — apiLevel is the Android API level e.g. '14' */
+    android: (apiLevel) => [apiLevel, 'Android', ''],
+    /** Alias for android companion used by pairing code flow */
+    androidCompanion: (apiLevel) => [apiLevel, 'Android', ''],
+    kaiOS: browser => ['KaiOS', browser, PLATFORM_VERSIONS['kaios']],
+    chromeOS: browser => ['Chrome OS', browser, PLATFORM_VERSIONS['chromeos']],
     /** The appropriate browser based on your OS & release */
-    appropriate: browser => [PLATFORM_MAP[platform()] || 'Ubuntu', browser, release()]
+    appropriate: browser => {
+        const os = platform();
+        const platformName = PLATFORM_MAP[os] || 'Unknown OS';
+        return [platformName, browser, PLATFORM_VERSIONS[os] || release()];
+    },
+    /** Fully custom browser tuple */
+    custom: (os, browser, version) => {
+        const platformName = PLATFORM_MAP[os.toLowerCase()] || os;
+        return [platformName, browser, version || PLATFORM_VERSIONS[os] || 'latest'];
+    }
+};
+/**
+ * Checks if the browser tuple represents an Android companion device.
+ */
+export const isAndroidBrowser = (browser) => {
+    return browser[1]?.toUpperCase() === 'ANDROID';
 };
+/**
+ * Returns a numeric platform ID string for the given browser name.
+ * Falls back to Chrome (1) for unknown/non-browser platforms.
+ */
 export const getPlatformId = (browser) => {
     const platformType = proto.DeviceProps.PlatformType[browser.toUpperCase()];
-    return platformType ? platformType.toString() : '1'; //chrome
+    if (platformType !== undefined) {
+        return platformType.toString();
+    }
+    // 'ANDROID' not in PlatformType enum — map to ANDROID_PHONE
+    if (browser.toUpperCase() === 'ANDROID') {
+        const androidPhone = proto.DeviceProps.PlatformType['ANDROID_PHONE'];
+        if (androidPhone !== undefined) {
+            return androidPhone.toString();
+        }
+    }
+    return (proto.DeviceProps.PlatformType.CHROME || 1).toString();
+};
+/**
+ * Returns the display name for the given browser type.
+ * Falls back to 'Chrome' if browser type is not a known platform type.
+ */
+export const getPlatformDisplayName = (browser) => {
+    const platformType = proto.DeviceProps.PlatformType[browser.toUpperCase()];
+    return platformType !== undefined ? browser : 'Chrome';
 };
 //# sourceMappingURL=browser-utils.js.map

package/lib/Utils/browser-utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-utils.js","sourceRoot":"","sources":["../../src/Utils/browser-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,IAAI,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAG9C,MAAM,YAAY,GAAG;IACpB,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;CACjB,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACpC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC;IACjD,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC;IACjD,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,YAAY,CAAC;IACtD,yDAAyD;IACzD,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;CAClF,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAe,EAAE,EAAE;IAChD,MAAM,YAAY,GAAG,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAS,CAAC,CAAA;IACjF,OAAO,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA,CAAC,QAAQ;AAC7D,CAAC,CAAA"}
+{"version":3,"file":"browser-utils.js","sourceRoot":"","sources":["../../src/Utils/browser-utils.ts"],"names":[],"mappings":"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"}

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

@@ -6,7 +6,37 @@ type FetchAppStateSyncKey = (keyId: string) => Promise<proto.Message.IAppStateSy
 export type ChatMutationMap = {
     [index: string]: ChatMutation;
 };
+type Mac = {
+    indexMac: Uint8Array;
+    valueMac: Uint8Array;
+    operation: proto.SyncdMutation.SyncdOperation;
+};
+export declare const makeLtHashGenerator: ({ indexValueMap, hash }: Pick<LTHashState, "hash" | "indexValueMap">) => {
+    mix: ({ indexMac, valueMac, operation }: Mac) => void;
+    finish: () => {
+        hash: Buffer<ArrayBuffer>;
+        indexValueMap: {
+            [indexMacBase64: string]: {
+                valueMac: Uint8Array | Buffer;
+            };
+        };
+    };
+};
 export declare const newLTHashState: () => LTHashState;
+export declare const ensureLTHashStateVersion: (state: LTHashState) => LTHashState;
+export declare const MAX_SYNC_ATTEMPTS = 2;
+/**
+ * Check if an error is a missing app state sync key.
+ * WA Web treats these as "Blocked" (waits for key arrival), not fatal.
+ * In Baileys we retry with a snapshot which may use a different key.
+ */
+export declare const isMissingKeyError: (error: any) => boolean;
+/**
+ * Determines if an app state sync error is unrecoverable.
+ * TypeError indicates a WASM crash; otherwise we give up after MAX_SYNC_ATTEMPTS.
+ * Missing keys are NOT checked here — they are handled separately as "Blocked".
+ */
+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;

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

@@ -1 +1 @@
-{"version":3,"file":"chat-utils.d.ts","sourceRoot":"","sources":["../../src/Utils/chat-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAA;AAC9C,OAAO,KAAK,EACX,mBAAmB,EAEnB,gBAAgB,EAChB,YAAY,EAEZ,OAAO,EACP,0BAA0B,EAE1B,WAAW,EACX,aAAa,EACb,WAAW,EACX,MAAM,UAAU,CAAA;AAMjB,OAAO,EAAE,KAAK,UAAU,EAA4E,MAAM,aAAa,CAAA;AAGvH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAA;AAIvC,KAAK,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,oBAAoB,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAE7G,MAAM,MAAM,eAAe,GAAG;IAAE,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,CAAA;CAAE,CAAA;AA4G/D,eAAO,MAAM,cAAc,QAAO,WAA2E,CAAA;AAE7G,eAAO,MAAM,gBAAgB,GAC5B,oDAAoD,aAAa,EACjE,iBAAiB,MAAM,EACvB,OAAO,WAAW,EAClB,oBAAoB,oBAAoB;;;EA2DxC,CAAA;AAED,eAAO,MAAM,oBAAoB,GAChC,cAAc,CAAC,KAAK,CAAC,cAAc,GAAG,KAAK,CAAC,YAAY,CAAC,EAAE,EAC3D,cAAc,WAAW,EACzB,oBAAoB,oBAAoB,EACxC,YAAY,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,EAC5C,cAAc,OAAO;;;;;;;EA0DrB,CAAA;AAED,eAAO,MAAM,gBAAgB,GAC5B,KAAK,KAAK,CAAC,WAAW,EACtB,MAAM,WAAW,EACjB,cAAc,WAAW,EACzB,oBAAoB,oBAAoB,EACxC,YAAY,CAAC,QAAQ,EAAE,YAAY,KAAK,IAAI,EAC5C,cAAc,OAAO;;;;;;;EA0BrB,CAAA;AAED,eAAO,MAAM,mBAAmB,GAAU,QAAQ,UAAU,EAAE,SAAS,WAAW;;iBAKjD,KAAK,CAAC,WAAW,EAAE;wBAAkB,OAAO;mBAAa,KAAK,CAAC,cAAc;;;iBAA7E,KAAK,CAAC,WAAW,EAAE;wBAAkB,OAAO;mBAAa,KAAK,CAAC,cAAc;;;iBAA7E,KAAK,CAAC,WAAW,EAAE;wBAAkB,OAAO;mBAAa,KAAK,CAAC,cAAc;;;iBAA7E,KAAK,CAAC,WAAW,EAAE;wBAAkB,OAAO;mBAAa,KAAK,CAAC,cAAc;;;iBAA7E,KAAK,CAAC,WAAW,EAAE;wBAAkB,OAAO;mBAAa,KAAK,CAAC,cAAc;;EA6C7G,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAU,MAAM,KAAK,CAAC,sBAAsB,EAAE,SAAS,WAAW,iCAQlG,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAU,MAAM,KAAK,CAAC,sBAAsB,EAAE,SAAS,WAAW,kCAInG,CAAA;AAED,eAAO,MAAM,mBAAmB,GAC/B,MAAM,WAAW,EACjB,UAAU,KAAK,CAAC,cAAc,EAC9B,oBAAoB,oBAAoB,EACxC,sBAAsB,MAAM,GAAG,SAAS,EACxC,sBAAmB;;;EAyCnB,CAAA;AAED,eAAO,MAAM,aAAa,GACzB,MAAM,WAAW,EACjB,QAAQ,KAAK,CAAC,WAAW,EAAE,EAC3B,SAAS,WAAW,EACpB,oBAAoB,oBAAoB,EACxC,SAAS,WAAW,EACpB,uBAAuB,MAAM,EAC7B,SAAS,OAAO,EAChB,sBAAmB;;;EA2DnB,CAAA;AAED,eAAO,MAAM,0BAA0B,GAAI,KAAK,gBAAgB,EAAE,KAAK,MAAM,kBAyQ5E,CAAA;AAED,eAAO,MAAM,iBAAiB,GAC7B,YAAY,YAAY,EACxB,IAAI,mBAAmB,EACvB,IAAI,OAAO,EACX,kBAAkB,0BAA0B,EAC5C,SAAS,OAAO,SA4KhB,CAAA"}
+{"version":3,"file":"chat-utils.d.ts","sourceRoot":"","sources":["../../src/Utils/chat-utils.ts"],"names":[],"mappings":"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"}

package/lib/Utils/chat-utils.js

@@ -1,48 +1,44 @@
 import { Boom } from '@hapi/boom';
+import { expandAppStateKeys } from 'whatsapp-rust-bridge';
 import { proto } from '../../WAProto/index.js';
 import { LabelAssociationType } from '../Types/LabelAssociation.js';
 import { getBinaryNodeChild, getBinaryNodeChildren, isJidGroup, jidNormalizedUser } from '../WABinary/index.js';
-import { aesDecrypt, aesEncrypt, hkdf, hmacSign } from './crypto.js';
+import { aesDecrypt, aesEncrypt, hmacSign } from './crypto.js';
 import { toNumber } from './generics.js';
 import { LT_HASH_ANTI_TAMPERING } from './lt-hash.js';
 import { downloadContentFromMessage } from './messages-media.js';
-const mutationKeys = async (keydata) => {
-    const expanded = await hkdf(keydata, 160, { info: 'WhatsApp Mutation Keys' });
+import { emitSyncActionResults, processContactAction } from './sync-action-utils.js';
+const mutationKeys = (keydata) => {
+    const keys = expandAppStateKeys(keydata);
     return {
-        indexKey: expanded.slice(0, 32),
-        valueEncryptionKey: expanded.slice(32, 64),
-        valueMacKey: expanded.slice(64, 96),
-        snapshotMacKey: expanded.slice(96, 128),
-        patchMacKey: expanded.slice(128, 160)
+        indexKey: keys.indexKey,
+        valueEncryptionKey: keys.valueEncryptionKey,
+        valueMacKey: keys.valueMacKey,
+        snapshotMacKey: keys.snapshotMacKey,
+        patchMacKey: keys.patchMacKey
     };
 };
 const generateMac = (operation, data, keyId, key) => {
-    const getKeyData = () => {
-        let r;
-        switch (operation) {
-            case proto.SyncdMutation.SyncdOperation.SET:
-                r = 0x01;
-                break;
-            case proto.SyncdMutation.SyncdOperation.REMOVE:
-                r = 0x02;
-                break;
-        }
-        const buff = Buffer.from([r]);
-        return Buffer.concat([buff, Buffer.from(keyId, 'base64')]);
-    };
-    const keyData = getKeyData();
-    const last = Buffer.alloc(8); // 8 bytes
-    last.set([keyData.length], last.length - 1);
-    const total = Buffer.concat([keyData, data, last]);
+    const opByte = operation === proto.SyncdMutation.SyncdOperation.SET ? 0x01 : 0x02;
+    const keyIdBuffer = typeof keyId === 'string' ? Buffer.from(keyId, 'base64') : keyId;
+    const keyData = new Uint8Array(1 + keyIdBuffer.length);
+    keyData[0] = opByte;
+    keyData.set(keyIdBuffer, 1);
+    const last = new Uint8Array(8);
+    last[7] = keyData.length;
+    const total = new Uint8Array(keyData.length + data.length + last.length);
+    total.set(keyData, 0);
+    total.set(data, keyData.length);
+    total.set(last, keyData.length + data.length);
     const hmac = hmacSign(total, key, 'sha512');
-    return hmac.slice(0, 32);
+    return hmac.subarray(0, 32);
 };
 const to64BitNetworkOrder = (e) => {
     const buff = Buffer.alloc(8);
     buff.writeUint32BE(e, 4);
     return buff;
 };
-const makeLtHashGenerator = ({ indexValueMap, hash }) => {
+export const makeLtHashGenerator = ({ indexValueMap, hash }) => {
     indexValueMap = { ...indexValueMap };
     const addBuffs = [];
     const subBuffs = [];
@@ -52,26 +48,27 @@ const makeLtHashGenerator = ({ indexValueMap, hash }) => {
             const prevOp = indexValueMap[indexMacBase64];
             if (operation === proto.SyncdMutation.SyncdOperation.REMOVE) {
                 if (!prevOp) {
-                    throw new Boom('tried remove, but no previous op', { data: { indexMac, valueMac } });
+                    // WA Web does not throw here — it logs a warning and skips the subtract.
+                    // The missing REMOVE will cause an LTHash mismatch, which is handled
+                    // by the MAC validation layer (snapshot recovery or retry).
+                    return;
                 }
                 // remove from index value mac, since this mutation is erased
                 delete indexValueMap[indexMacBase64];
             }
             else {
-                addBuffs.push(new Uint8Array(valueMac).buffer);
+                addBuffs.push(valueMac);
                 // add this index into the history map
                 indexValueMap[indexMacBase64] = { valueMac };
             }
             if (prevOp) {
-                subBuffs.push(new Uint8Array(prevOp.valueMac).buffer);
+                subBuffs.push(prevOp.valueMac);
             }
         },
-        finish: async () => {
-            const hashArrayBuffer = new Uint8Array(hash).buffer;
-            const result = await LT_HASH_ANTI_TAMPERING.subtractThenAdd(hashArrayBuffer, addBuffs, subBuffs);
-            const buffer = Buffer.from(result);
+        finish: () => {
+            const result = LT_HASH_ANTI_TAMPERING.subtractThenAdd(hash, subBuffs, addBuffs);
             return {
-                hash: buffer,
+                hash: Buffer.from(result),
                 indexValueMap
             };
         }
@@ -86,10 +83,33 @@ const generatePatchMac = (snapshotMac, valueMacs, version, type, key) => {
     return hmacSign(total, key);
 };
 export const newLTHashState = () => ({ version: 0, hash: Buffer.alloc(128), indexValueMap: {} });
+export const ensureLTHashStateVersion = (state) => {
+    if (typeof state.version !== 'number' || isNaN(state.version)) {
+        state.version = 0;
+    }
+    return state;
+};
+export const MAX_SYNC_ATTEMPTS = 2;
+/**
+ * Check if an error is a missing app state sync key.
+ * WA Web treats these as "Blocked" (waits for key arrival), not fatal.
+ * In Baileys we retry with a snapshot which may use a different key.
+ */
+export const isMissingKeyError = (error) => {
+    return error?.data?.isMissingKey === true;
+};
+/**
+ * Determines if an app state sync error is unrecoverable.
+ * TypeError indicates a WASM crash; otherwise we give up after MAX_SYNC_ATTEMPTS.
+ * Missing keys are NOT checked here — they are handled separately as "Blocked".
+ */
+export const isAppStateSyncIrrecoverable = (error, attempts) => {
+    return attempts >= MAX_SYNC_ATTEMPTS || error?.name === 'TypeError';
+};
 export const encodeSyncdPatch = async ({ type, index, syncAction, apiVersion, operation }, myAppStateKeyId, state, getAppStateSyncKey) => {
     const key = !!myAppStateKeyId ? await getAppStateSyncKey(myAppStateKeyId) : undefined;
     if (!key) {
-        throw new Boom(`myAppStateKey ("${myAppStateKeyId}") not present`, { statusCode: 404 });
+        throw new Boom(`myAppStateKey ("${myAppStateKeyId}") not present`, { data: { isMissingKey: true } });
     }
     const encKeyId = Buffer.from(myAppStateKeyId, 'base64');
     state = { ...state, indexValueMap: { ...state.indexValueMap } };
@@ -101,14 +121,14 @@ export const encodeSyncdPatch = async ({ type, index, syncAction, apiVersion, op
         version: apiVersion
     });
     const encoded = proto.SyncActionData.encode(dataProto).finish();
-    const keyValue = await mutationKeys(key.keyData);
+    const keyValue = mutationKeys(key.keyData);
     const encValue = aesEncrypt(encoded, keyValue.valueEncryptionKey);
     const valueMac = generateMac(operation, encValue, encKeyId, keyValue.valueMacKey);
     const indexMac = hmacSign(indexBuffer, keyValue.indexKey);
     // update LT hash
     const generator = makeLtHashGenerator(state);
     generator.mix({ indexMac, valueMac, operation });
-    Object.assign(state, await generator.finish());
+    Object.assign(state, generator.finish());
     state.version += 1;
     const snapshotMac = generateSnapshotMac(state.hash, state.version, type, keyValue.snapshotMacKey);
     const patch = {
@@ -136,6 +156,7 @@ export const encodeSyncdPatch = async ({ type, index, syncAction, apiVersion, op
 };
 export const decodeSyncdMutations = async (msgMutations, initialState, getAppStateSyncKey, onMutation, validateMacs) => {
     const ltGenerator = makeLtHashGenerator(initialState);
+    const derivedKeyCache = new Map();
     // indexKey used to HMAC sign record.index.blob
     // valueEncryptionKey used to AES-256-CBC encrypt record.value.blob[0:-32]
     // the remaining record.value.blob[0:-32] is the mac, it the HMAC sign of key.keyId + decoded proto data + length of bytes in keyId
@@ -145,9 +166,9 @@ export const decodeSyncdMutations = async (msgMutations, initialState, getAppSta
         const operation = 'operation' in msgMutation ? msgMutation.operation : proto.SyncdMutation.SyncdOperation.SET;
         const record = 'record' in msgMutation && !!msgMutation.record ? msgMutation.record : msgMutation;
         const key = await getKey(record.keyId.id);
-        const content = Buffer.from(record.value.blob);
-        const encContent = content.slice(0, -32);
-        const ogValueMac = content.slice(-32);
+        const content = record.value.blob;
+        const encContent = content.subarray(0, -32);
+        const ogValueMac = content.subarray(-32);
         if (validateMacs) {
             const contentHmac = generateMac(operation, encContent, record.keyId.id, key.valueMacKey);
             if (Buffer.compare(contentHmac, ogValueMac) !== 0) {
@@ -170,17 +191,22 @@ export const decodeSyncdMutations = async (msgMutations, initialState, getAppSta
             operation: operation
         });
     }
-    return await ltGenerator.finish();
+    return ltGenerator.finish();
     async function getKey(keyId) {
         const base64Key = Buffer.from(keyId).toString('base64');
+        const cached = derivedKeyCache.get(base64Key);
+        if (cached) {
+            return cached;
+        }
         const keyEnc = await getAppStateSyncKey(base64Key);
         if (!keyEnc) {
             throw new Boom(`failed to find key "${base64Key}" to decode mutation`, {
-                statusCode: 404,
-                data: { msgMutations }
+                data: { isMissingKey: true, msgMutations }
             });
         }
-        return mutationKeys(keyEnc.keyData);
+        const keys = mutationKeys(keyEnc.keyData);
+        derivedKeyCache.set(base64Key, keys);
+        return keys;
     }
 };
 export const decodeSyncdPatch = async (msg, name, initialState, getAppStateSyncKey, onMutation, validateMacs) => {
@@ -188,9 +214,9 @@ export const decodeSyncdPatch = async (msg, name, initialState, getAppStateSyncK
         const base64Key = Buffer.from(msg.keyId.id).toString('base64');
         const mainKeyObj = await getAppStateSyncKey(base64Key);
         if (!mainKeyObj) {
-            throw new Boom(`failed to find key "${base64Key}" to decode patch`, { statusCode: 404, data: { msg } });
+            throw new Boom(`failed to find key "${base64Key}" to decode patch`, { data: { isMissingKey: true, msg } });
         }
-        const mainKey = await mutationKeys(mainKeyObj.keyData);
+        const mainKey = mutationKeys(mainKeyObj.keyData);
         const mutationmacs = msg.mutations.map(mutation => mutation.record.value.blob.slice(-32));
         const patchMac = generatePatchMac(msg.snapshotMac, mutationmacs, toNumber(msg.version.version), name, mainKey.patchMacKey);
         if (Buffer.compare(patchMac, msg.patchMac) !== 0) {
@@ -266,9 +292,9 @@ export const decodeSyncdSnapshot = async (name, snapshot, getAppStateSyncKey, mi
         const base64Key = Buffer.from(snapshot.keyId.id).toString('base64');
         const keyEnc = await getAppStateSyncKey(base64Key);
         if (!keyEnc) {
-            throw new Boom(`failed to find key "${base64Key}" to decode mutation`);
+            throw new Boom(`failed to find key "${base64Key}" to decode mutation`, { data: { isMissingKey: true } });
         }
-        const result = await mutationKeys(keyEnc.keyData);
+        const result = mutationKeys(keyEnc.keyData);
         const computedSnapshotMac = generateSnapshotMac(newState.hash, newState.version, name, result.snapshotMacKey);
         if (Buffer.compare(snapshot.mac, computedSnapshotMac) !== 0) {
             throw new Boom(`failed to verify LTHash at ${newState.version} of ${name} from snapshot`);
@@ -308,9 +334,9 @@ export const decodePatches = async (name, syncds, initial, getAppStateSyncKey, o
             const base64Key = Buffer.from(keyId.id).toString('base64');
             const keyEnc = await getAppStateSyncKey(base64Key);
             if (!keyEnc) {
-                throw new Boom(`failed to find key "${base64Key}" to decode mutation`);
+                throw new Boom(`failed to find key "${base64Key}" to decode mutation`, { data: { isMissingKey: true } });
             }
-            const result = await mutationKeys(keyEnc.keyData);
+            const result = mutationKeys(keyEnc.keyData);
             const computedSnapshotMac = generateSnapshotMac(newState.hash, newState.version, name, result.snapshotMacKey);
             if (Buffer.compare(snapshotMac, computedSnapshotMac) !== 0) {
                 throw new Boom(`failed to verify LTHash at ${newState.version} of ${name}`);
@@ -665,14 +691,8 @@ export const processSyncAction = (syncAction, ev, me, initialSyncOpts, logger) =
         });
     }
     else if (action?.contactAction) {
-        ev.emit('contacts.upsert', [
-            {
-                id: id,
-                name: action.contactAction.fullName,
-                lid: action.contactAction.lidJid || undefined,
-                phoneNumber: action.contactAction.pnJid || undefined
-            }
-        ]);
+        const results = processContactAction(action.contactAction, id, logger);
+        emitSyncActionResults(ev, results);
     }
     else if (action?.pushNameSetting) {
         const name = action?.pushNameSetting?.name;
@@ -741,6 +761,61 @@ export const processSyncAction = (syncAction, ev, me, initialSyncOpts, logger) =
                 }
         });
     }
+    else if (action?.localeSetting?.locale) {
+        ev.emit('settings.update', { setting: 'locale', value: action.localeSetting.locale });
+    }
+    else if (action?.timeFormatAction) {
+        ev.emit('settings.update', { setting: 'timeFormat', value: action.timeFormatAction });
+    }
+    else if (action?.pnForLidChatAction) {
+        if (action.pnForLidChatAction.pnJid) {
+            ev.emit('lid-mapping.update', { lid: id, pn: action.pnForLidChatAction.pnJid });
+        }
+    }
+    else if (action?.privacySettingRelayAllCalls) {
+        ev.emit('settings.update', {
+            setting: 'privacySettingRelayAllCalls',
+            value: action.privacySettingRelayAllCalls
+        });
+    }
+    else if (action?.statusPrivacy) {
+        ev.emit('settings.update', { setting: 'statusPrivacy', value: action.statusPrivacy });
+    }
+    else if (action?.lockChatAction) {
+        ev.emit('chats.lock', { id: id, locked: !!action.lockChatAction.locked });
+    }
+    else if (action?.privacySettingDisableLinkPreviewsAction) {
+        ev.emit('settings.update', {
+            setting: 'disableLinkPreviews',
+            value: action.privacySettingDisableLinkPreviewsAction
+        });
+    }
+    else if (action?.notificationActivitySettingAction?.notificationActivitySetting) {
+        ev.emit('settings.update', {
+            setting: 'notificationActivitySetting',
+            value: action.notificationActivitySettingAction.notificationActivitySetting
+        });
+    }
+    else if (action?.lidContactAction) {
+        ev.emit('contacts.upsert', [
+            {
+                id: id,
+                name: action.lidContactAction.fullName ||
+                    action.lidContactAction.firstName ||
+                    action.lidContactAction.username ||
+                    undefined,
+                username: action.lidContactAction.username || undefined,
+                lid: id,
+                phoneNumber: undefined
+            }
+        ]);
+    }
+    else if (action?.privacySettingChannelsPersonalisedRecommendationAction) {
+        ev.emit('settings.update', {
+            setting: 'channelsPersonalisedRecommendation',
+            value: action.privacySettingChannelsPersonalisedRecommendationAction
+        });
+    }
     else {
         logger?.debug({ syncAction, id }, 'unprocessable update');
     }