zapo-js 0.3.0 → 1.0.0

package/dist/esm/client/WaClientFactory.js

@@ -1,34 +1,46 @@
-import { WaAppStateSyncClient } from '../appstate/WaAppStateSyncClient.js';
+import { WaAppStateSyncClient } from '../appstate/sync/WaAppStateSyncClient.js';
 import { WaAuthClient } from '../auth/WaAuthClient.js';
 import { WaConnectionManager } from './connection/WaConnectionManager.js';
 import { WaReceiptQueue } from './connection/WaReceiptQueue.js';
 import { WaAbPropsCoordinator } from './coordinators/WaAbPropsCoordinator.js';
 import { WaAppStateMutationCoordinator } from './coordinators/WaAppStateMutationCoordinator.js';
+import { createBotCoordinator } from './coordinators/WaBotCoordinator.js';
+import { createBroadcastListCoordinator } from './coordinators/WaBroadcastListCoordinator.js';
 import { createBusinessCoordinator } from './coordinators/WaBusinessCoordinator.js';
 import { createEmailCoordinator } from './coordinators/WaEmailCoordinator.js';
 import { createGroupCoordinator } from './coordinators/WaGroupCoordinator.js';
 import { WaIncomingNodeCoordinator } from './coordinators/WaIncomingNodeCoordinator.js';
+import { createLowLevelCoordinator } from './coordinators/WaLowLevelCoordinator.js';
+import { WaMessageCoordinator } from './coordinators/WaMessageCoordinator.js';
 import { WaMessageDispatchCoordinator } from './coordinators/WaMessageDispatchCoordinator.js';
+import { createNewsletterCoordinator } from './coordinators/WaNewsletterCoordinator.js';
 import { WaOfflineResumeCoordinator } from './coordinators/WaOfflineResumeCoordinator.js';
 import { WaPassiveTasksCoordinator } from './coordinators/WaPassiveTasksCoordinator.js';
+import { createPresenceCoordinator } from './coordinators/WaPresenceCoordinator.js';
 import { createPrivacyCoordinator } from './coordinators/WaPrivacyCoordinator.js';
 import { createProfileCoordinator } from './coordinators/WaProfileCoordinator.js';
 import { WaRetryCoordinator } from './coordinators/WaRetryCoordinator.js';
+import { createStatusCoordinator } from './coordinators/WaStatusCoordinator.js';
 import { createStreamControlHandler } from './coordinators/WaStreamControlCoordinator.js';
 import { WaTrustedContactTokenCoordinator } from './coordinators/WaTrustedContactTokenCoordinator.js';
-import { handleDirtyBits, parseDirtyBits } from './dirty.js';
 import { DEVICE_NOTIFICATION_ACTIONS, parseDeviceNotification } from './events/devices.js';
+import { handleDirtyBits, parseDirtyBits } from './events/dirty.js';
 import { parseIdentityChangeNotification } from './events/identity.js';
 import { parsePrivacyTokenNotification } from './events/privacy-token.js';
-import { buildMediaMessageContent, getMediaConn as getClientMediaConn } from './messages.js';
 import { createDeviceFanoutResolver } from './messaging/fanout.js';
+import { createGroupMetadataCache } from './messaging/group-metadata.js';
 import { createAppStateSyncKeyProtocol } from './messaging/key-protocol.js';
-import { createGroupParticipantsCache } from './messaging/participants.js';
-import { WaMediaTransferClient } from '../media/WaMediaTransferClient.js';
-import { handleIncomingMessageAck } from '../message/incoming.js';
+import { resolveLinkPreview } from './messaging/link-preview.js';
+import { buildMediaMessageContent, getMediaConn as getClientMediaConn } from './messaging/messages.js';
+import { WaMediaTransferClient } from '../media/transfer/WaMediaTransferClient.js';
+import { createDefaultLinkPreviewFetcher } from '../message/addons/link-preview/fetcher.js';
+import { processNewsletterLiveUpdates } from '../message/kinds/newsletter.js';
+import { handleIncomingMessageAck } from '../message/primitives/incoming.js';
+import { createPeerDataOperationRequester } from '../message/primitives/peer-data-operation.js';
 import { WaMessageClient } from '../message/WaMessageClient.js';
-import { getWaCompanionPlatformId, WA_DEFAULTS, WA_DISCONNECT_REASONS, WA_NODE_TAGS, WA_NOTIFICATION_TYPES, WA_PRIVACY_TOKEN_NOTIFICATION_TYPE } from '../protocol/constants.js';
-import { parseSignalAddressFromJid, toUserJid } from '../protocol/jid.js';
+import { getWaCompanionPlatformId, WA_DEFAULTS, WA_DISCONNECT_REASONS, WA_NEWSLETTER_NOTIFICATION_TAGS, WA_NODE_TAGS, WA_NOTIFICATION_TYPES, WA_PRIVACY_TOKEN_NOTIFICATION_TYPE } from '../protocol/constants.js';
+import { isNewsletterJid, parseSignalAddressFromJid, toUserJid } from '../protocol/jid.js';
+import { WA_PRESENCE_TYPES } from '../protocol/presence.js';
 import { createOutboundRetryTracker } from '../retry/tracker.js';
 import { SignalDeviceSyncApi } from '../signal/api/SignalDeviceSyncApi.js';
 import { SignalDigestSyncApi } from '../signal/api/SignalDigestSyncApi.js';
@@ -47,6 +59,7 @@ import { createUsyncSidGenerator } from '../transport/node/usync.js';
 import { WaNodeOrchestrator } from '../transport/node/WaNodeOrchestrator.js';
 import { WaNodeTransport } from '../transport/node/WaNodeTransport.js';
 import { isProxyTransport, toProxyAgent } from '../transport/proxy.js';
+import { createServerClock } from '../util/clock.js';
 import { toError } from '../util/primitives.js';
 import { getRuntimeOsDisplayName } from '../util/runtime.js';
 function assertProxyTransport(value, path) {
@@ -104,13 +117,13 @@ export function resolveWaClientBase(options, logger) {
     };
 }
 function createIncomingNodeRuntime(input) {
-    const { logger, emitEvent, authClient, connectionManager, nodeOrchestrator, streamControl, mediaMessageBuildOptions, retryCoordinator, messageDispatch, sendNode, syncAppState, disconnect, clearStoredCredentials, getCurrentMeJid, handleClientDirtyBits, incomingMessageAckOptions } = input;
+    const { logger, emitEvent, authClient, connectionManager, nodeOrchestrator, streamControl, mediaMessageBuildOptions, retryCoordinator, messageDispatch, sendNode, syncAppState, disconnect, clearStoredCredentials, getCurrentCredentials, handleClientDirtyBits, incomingMessageAckOptions } = input;
     return {
         handleStreamControlResult: streamControl.handleStreamControlResult,
         persistSuccessAttributes: (attributes) => authClient.persistSuccessAttributes(attributes),
-        emitSuccessNode: (node) => emitEvent('connection_success', { node }),
+        emitSuccessNode: (node) => emitEvent('debug_connection_success', { node }),
         updateClockSkewFromSuccess: (serverUnixSeconds) => connectionManager.updateClockSkewFromSuccess(serverUnixSeconds),
-        shouldWarmupMediaConn: () => !!(getCurrentMeJid() && connectionManager.isConnected()),
+        shouldWarmupMediaConn: () => !!(getCurrentCredentials()?.meJid && connectionManager.isConnected()),
         warmupMediaConn: async () => {
             await getClientMediaConn(mediaMessageBuildOptions, true);
         },
@@ -124,19 +137,21 @@ function createIncomingNodeRuntime(input) {
         sendNode,
         handleIncomingRetryReceipt: (node) => retryCoordinator.handleIncomingRetryReceipt(node),
         trackOutboundReceipt: (node) => retryCoordinator.trackOutboundReceipt(node),
-        emitIncomingReceipt: (event) => emitEvent('message_receipt', event),
+        emitIncomingReceipt: (event) => emitEvent('receipt', event),
         emitIncomingPresence: (event) => emitEvent('presence', event),
         emitIncomingChatstate: (event) => emitEvent('chatstate', event),
         emitIncomingCall: (event) => emitEvent('call', event),
-        emitIncomingFailure: (event) => emitEvent('failure', event),
+        getCurrentCredentials,
+        emitIncomingFailure: (event) => emitEvent('stream_failure', event),
         emitIncomingErrorStanza: (event) => emitEvent('stanza_error', event),
-        emitIncomingNotification: (event) => emitEvent('notification', event),
-        emitRegistrationCode: (event) => emitEvent('registration_code_received', event),
-        emitAccountTakeoverNotice: (event) => emitEvent('account_takeover_notice', event),
+        emitIncomingNotification: (event) => emitEvent('debug_notification', event),
+        emitMexNotification: (event) => emitEvent('mex_notification', event),
+        emitRegistrationCode: (event) => emitEvent('mobile_registration_code', event),
+        emitAccountTakeoverNotice: (event) => emitEvent('mobile_account_takeover_notice', event),
         emitGroupEvent: (event) => {
-            emitEvent('group_event', event);
-            void messageDispatch.mutateParticipantsCacheFromGroupEvent(event).catch((error) => {
-                logger.warn('failed to mutate participants cache from group event', {
+            emitEvent('group', event);
+            void messageDispatch.mutateGroupMetadataCacheFromGroupEvent(event).catch((error) => {
+                logger.warn('failed to mutate group metadata cache from group event', {
                     action: event.action,
                     groupJid: event.groupJid,
                     contextGroupJid: event.contextGroupJid,
@@ -144,7 +159,9 @@ function createIncomingNodeRuntime(input) {
                 });
             });
         },
-        emitUnhandledIncomingNode: (event) => emitEvent('stanza_unhandled', event),
+        emitBusinessEvent: (event) => emitEvent('business', event),
+        emitPictureEvent: (event) => emitEvent('picture', event),
+        emitUnhandledIncomingNode: (event) => emitEvent('debug_unhandled_stanza', event),
         syncAppState,
         stopComms: () => {
             void connectionManager.getComms()?.stopComms();
@@ -156,7 +173,7 @@ function createIncomingNodeRuntime(input) {
     };
 }
 function createPassiveTasksRuntime(input) {
-    const { queryWithContext, authClient, nodeOrchestrator, receiptQueue, getCurrentCredentials, abPropsCoordinator } = input;
+    const { queryWithContext, authClient, nodeOrchestrator, receiptQueue, getCurrentCredentials, abPropsCoordinator, markOnlineOnConnect } = input;
     return {
         queryWithContext,
         getCurrentCredentials,
@@ -166,9 +183,13 @@ function createPassiveTasksRuntime(input) {
         requeueDanglingReceipt: (node) => receiptQueue.enqueue(node),
         shouldQueueDanglingReceipt: (node, error) => receiptQueue.shouldQueue(node, error),
         syncAbProps: () => abPropsCoordinator.sync(),
-        sendPresenceAvailable: async () => {
+        sendInitialPresence: async () => {
             const credentials = getCurrentCredentials();
-            await nodeOrchestrator.sendNode(buildPresenceNode({ name: credentials?.meDisplayName ?? undefined }), false);
+            const name = credentials?.meDisplayName ?? undefined;
+            const node = markOnlineOnConnect
+                ? buildPresenceNode({ name })
+                : buildPresenceNode({ type: WA_PRESENCE_TYPES.UNAVAILABLE, name });
+            await nodeOrchestrator.sendNode(node, false);
         }
     };
 }
@@ -180,6 +201,7 @@ export function buildWaClientDependencies(input) {
     let passiveTasks = null;
     let mediaConnCacheFallback = null;
     let scheduleReconnectAfterPairing = () => undefined;
+    const serverClock = createServerClock(() => connectionManager?.getClockSkewMs() ?? null);
     const nodeTransport = new WaNodeTransport(logger);
     const nodeOrchestrator = new WaNodeOrchestrator({
         sendNode: async (node) => nodeTransport.sendNode(node),
@@ -195,7 +217,8 @@ export function buildWaClientDependencies(input) {
         intervalMs: options.keepAliveIntervalMs,
         getIntervalMs: () => abPropsCoordinator.getConfigValue('heartbeat_interval_s') * 1000,
         timeoutMs: options.deadSocketTimeoutMs,
-        hostDomain: WA_DEFAULTS.HOST_DOMAIN
+        hostDomain: WA_DEFAULTS.HOST_DOMAIN,
+        onClockSkewMs: (clockSkewMs) => connectionManager?.setClockSkewMs(clockSkewMs, 'keepalive')
     });
     const mediaTransfer = new WaMediaTransferClient({
         logger,
@@ -204,6 +227,17 @@ export function buildWaClientDependencies(input) {
         defaultDownloadAgent: toProxyAgent(options.proxy?.mediaDownload),
         skipMacVerification: options.dangerous?.disableMediaMacVerification
     });
+    const linkPreviewOptions = options.linkPreview ?? {};
+    const linkPreviewFetcher = linkPreviewOptions.fetcher ??
+        createDefaultLinkPreviewFetcher({
+            mediaTransfer,
+            userAgent: linkPreviewOptions.userAgent,
+            fetchTimeoutMs: linkPreviewOptions.fetchTimeoutMs,
+            maxHtmlBytes: linkPreviewOptions.maxHtmlBytes,
+            maxThumbnailBytes: linkPreviewOptions.maxThumbnailBytes,
+            allowPrivateHosts: linkPreviewOptions.allowPrivateHosts,
+            proxy: linkPreviewOptions.proxy ?? options.proxy?.linkPreview
+        });
     const mediaMessageBuildOptions = {
         logger,
         mediaTransfer,
@@ -219,7 +253,16 @@ export function buildWaClientDependencies(input) {
             mediaConnCacheFallback = mediaConn;
             connectionManager?.setMediaConnCache(mediaConn);
         },
-        media: options.media
+        serverClock,
+        media: options.media,
+        linkPreviewResolver: (content) => resolveLinkPreview(content.text, content.linkPreview, {
+            logger,
+            mediaTransfer,
+            getMediaConn: () => getClientMediaConn(mediaMessageBuildOptions),
+            fetcher: linkPreviewFetcher,
+            options: linkPreviewOptions,
+            serverClock
+        })
     };
     const messageClient = new WaMessageClient({
         logger,
@@ -294,10 +337,11 @@ export function buildWaClientDependencies(input) {
             sendNode: runtime.sendNode,
             query: runtime.query
         },
+        isConnected: () => connectionManager?.isConnected() ?? false,
         callbacks: {
             onQr: (qr, ttlMs) => runtime.emitEvent('auth_qr', { qr, ttlMs }),
             onPairingCode: (code) => runtime.emitEvent('auth_pairing_code', { code }),
-            onPairingRefresh: (forceManual) => runtime.emitEvent('auth_pairing_refresh', { forceManual }),
+            onPairingRefresh: (forceManual) => runtime.emitEvent('auth_pairing_required', { forceManual }),
             onPaired: (credentials) => {
                 runtime.emitEvent('auth_paired', { credentials });
                 scheduleReconnectAfterPairing();
@@ -306,22 +350,31 @@ export function buildWaClientDependencies(input) {
         }
     });
     const getCurrentCredentials = authClient.getCurrentCredentials.bind(authClient);
-    const getCurrentMeJid = () => getCurrentCredentials()?.meJid;
-    const getCurrentMeLid = () => getCurrentCredentials()?.meLid;
-    const getCurrentSignedIdentity = () => getCurrentCredentials()?.signedIdentity;
     const groupCoordinator = createGroupCoordinator({
-        queryWithContext: runtime.queryWithContext
+        queryWithContext: runtime.queryWithContext,
+        mexSocket: { query: runtime.query }
+    });
+    const newsletterCoordinator = createNewsletterCoordinator({
+        mexSocket: { query: runtime.query },
+        sendNode: runtime.sendNode,
+        publishMessageNode: (node, opts) => messageDispatch.publishMessageNode(node, opts),
+        queryWithContext: runtime.queryWithContext,
+        generateStanzaId: () => messageDispatch.generateOutgoingMessageId(),
+        mediaTransfer,
+        getMediaConn: () => getClientMediaConn(mediaMessageBuildOptions),
+        getAbPropString: (name) => abPropsCoordinator.getConfigValue(name),
+        logger
     });
     const privacyCoordinator = createPrivacyCoordinator({
         queryWithContext: runtime.queryWithContext
     });
-    const profileCoordinator = createProfileCoordinator({
+    const businessCoordinator = createBusinessCoordinator({
         queryWithContext: runtime.queryWithContext,
+        mediaTransfer,
+        getMediaConn: () => getClientMediaConn(mediaMessageBuildOptions),
+        logger,
         generateSid: generateUsyncSid
     });
-    const businessCoordinator = createBusinessCoordinator({
-        queryWithContext: runtime.queryWithContext
-    });
     const emailCoordinator = createEmailCoordinator({
         queryWithContext: runtime.queryWithContext
     });
@@ -339,19 +392,21 @@ export function buildWaClientDependencies(input) {
     });
     const fanoutResolver = createDeviceFanoutResolver({
         signalDeviceSync,
-        getCurrentMeJid,
-        getCurrentMeLid,
+        getCurrentCredentials,
         logger
     });
-    const participantsCache = createGroupParticipantsCache({
-        participantsStore: sessionStore.participants,
-        queryGroupParticipantJids: async (groupJid) => {
+    const groupMetadataCache = createGroupMetadataCache({
+        groupMetadataStore: sessionStore.groupMetadata,
+        queryGroupMetadata: async (groupJid) => {
             const metadata = await groupCoordinator.queryGroupMetadata(groupJid);
             const participantJids = new Array(metadata.participants.length);
             for (let index = 0; index < metadata.participants.length; index += 1) {
                 participantJids[index] = metadata.participants[index].jid;
             }
-            return participantJids;
+            return {
+                participants: participantJids,
+                ephemeral: metadata.ephemeral
+            };
         },
         logger
     });
@@ -361,8 +416,9 @@ export function buildWaClientDependencies(input) {
         runtime: {
             queryWithContext: runtime.queryWithContext,
             emitEvent: runtime.emitEvent,
-            getCurrentMeLid: () => getCurrentMeLid() ?? null
+            getCurrentCredentials
         },
+        serverClock,
         durationS: options.privacyToken?.tcTokenDurationS,
         numBuckets: options.privacyToken?.tcTokenNumBuckets,
         senderDurationS: options.privacyToken?.tcTokenSenderDurationS,
@@ -383,10 +439,9 @@ export function buildWaClientDependencies(input) {
     });
     let messageDispatch;
     const appStateSyncKeyProtocol = createAppStateSyncKeyProtocol({
-        publishSignalMessage: (signalInput, publishOptions) => messageDispatch.publishSignalMessage(signalInput, publishOptions),
+        publishProtocolMessageToDevice: (deviceJid, protocolMessage, opts) => messageDispatch.publishProtocolMessageToDevice(deviceJid, protocolMessage, opts),
         fanoutResolver,
-        getCurrentMeJid,
-        getCurrentMeLid,
+        getCurrentCredentials,
         logger
     });
     messageDispatch = new WaMessageDispatchCoordinator({
@@ -395,19 +450,18 @@ export function buildWaClientDependencies(input) {
         retryTracker,
         sessionResolver,
         fanoutResolver,
-        participantsCache,
+        groupMetadataCache,
         appStateSyncKeyProtocol,
-        buildMessageContent: async (content) => buildMediaMessageContent(mediaMessageBuildOptions, content),
+        buildMessageContent: async (content, ctx) => buildMediaMessageContent(mediaMessageBuildOptions, content, ctx),
         senderKeyManager,
         signalProtocol,
         signalStore: sessionStore.signal,
         sessionStore: sessionStore.session,
         identityStore: sessionStore.identity,
         deviceListStore: sessionStore.deviceList,
+        signalDeviceSync,
         messageSecretStore: sessionStore.messageSecret,
-        getCurrentMeJid,
-        getCurrentMeLid,
-        getCurrentSignedIdentity,
+        getCurrentCredentials,
         resolvePrivacyTokenNode: (recipientJid) => trustedContactToken.resolveTokenForMessage(recipientJid),
         onDirectMessageSent: (recipientJid) => {
             trustedContactToken.maybeIssueSenderToken(recipientJid).catch((err) => logger.warn('sender token issue failed', {
@@ -415,8 +469,36 @@ export function buildWaClientDependencies(input) {
                 message: toError(err).message
             }));
         },
+        sendNewsletterMessage: (newsletterJid, content, sendOptions, contextInfo) => newsletterCoordinator.send(newsletterJid, content, {
+            stanzaId: sendOptions.id,
+            contextInfo,
+            additionalAttributes: sendOptions.additionalAttributes
+        }),
         getIcdcHashLength: () => abPropsCoordinator.getConfigValue('md_icdc_hash_length'),
-        mobileMessageIdFormat: options.mobileTransport !== undefined
+        mobileMessageIdFormat: options.mobileTransport !== undefined,
+        serverClock
+    });
+    const presenceCoordinator = createPresenceCoordinator({
+        sendNode: (node) => nodeOrchestrator.sendNode(node, false),
+        getCurrentCredentials
+    });
+    const peerDataOperation = createPeerDataOperationRequester({
+        logger,
+        publishProtocolMessageToDevice: (deviceJid, protocolMessage, opts) => messageDispatch.publishProtocolMessageToDevice(deviceJid, protocolMessage, opts),
+        getCurrentCredentials,
+        generateOutgoingMessageId: () => messageDispatch.generateOutgoingMessageId(),
+        subscribeToProtocolMessage: runtime.subscribeProtocolMessage
+    });
+    const messageCoordinator = new WaMessageCoordinator({
+        messageDispatch,
+        mediaTransfer,
+        logger,
+        messageStore: sessionStore.messages,
+        messageSecretStore: sessionStore.messageSecret,
+        trustedContactToken,
+        emitAddon: (event) => runtime.emitEvent('message_addon', event),
+        mexSocket: { query: runtime.query },
+        peerDataOperation
     });
     const retryCoordinator = new WaRetryCoordinator({
         logger,
@@ -426,30 +508,85 @@ export function buildWaClientDependencies(input) {
         sessionStore: sessionStore.session,
         senderKeyStore: sessionStore.senderKey,
         signalProtocol,
+        sessionResolver,
         signalDeviceSync,
         signalMissingPreKeysSync,
         messageClient,
         sendNode: runtime.sendNode,
-        getCurrentMeJid,
-        getCurrentMeLid,
-        getCurrentSignedIdentity
+        getCurrentCredentials,
+        resolveUserIcdc: (userJid) => messageDispatch.resolveUserIcdc(userJid),
+        peerDataOperation,
+        emitIncomingMessage: (event) => {
+            void runtime
+                .handleIncomingMessageEvent(event)
+                .catch((err) => runtime.handleError(toError(err)));
+        }
+    });
+    const botCoordinator = createBotCoordinator({
+        logger,
+        queryWithContext: runtime.queryWithContext,
+        buildMessageContent: async (content) => buildMediaMessageContent(mediaMessageBuildOptions, content),
+        sendMessage: (to, content, sendOptions) => messageDispatch.sendMessage(to, content, sendOptions ?? {}),
+        messageStore: sessionStore.messages,
+        messageSecretStore: sessionStore.messageSecret,
+        getCurrentCredentials,
+        emitBotChunk: (event) => runtime.emitEvent('message_bot_chunk', event),
+        generateSid: generateUsyncSid
     });
     const appStateSync = new WaAppStateSyncClient({
         logger,
         query: runtime.query,
-        getCurrentMeJid,
+        getCurrentMeJid: () => getCurrentCredentials()?.meJid,
         defaultTimeoutMs: options.appStateSyncTimeoutMs,
         store: sessionStore.appState,
+        serverClock,
         onMissingKeys: async ({ keyIds }) => {
             await messageDispatch.requestAppStateSyncKeys(keyIds);
         },
         skipMacVerification: options.dangerous?.disableAppStateMacVerification,
-        mobilePrimary: options.mobileTransport !== undefined
+        mobilePrimary: options.mobileTransport !== undefined,
+        isOwnAccountDevice: (deviceJid) => {
+            const credentials = getCurrentCredentials();
+            if (!credentials)
+                return false;
+            const candidateUser = toUserJid(deviceJid);
+            return ((!!credentials.meJid && toUserJid(credentials.meJid) === candidateUser) ||
+                (!!credentials.meLid && toUserJid(credentials.meLid) === candidateUser));
+        },
+        sendKeyShare: (toDeviceJid, keys, missingKeyIds) => messageDispatch.sendAppStateSyncKeyShare(toDeviceJid, keys, missingKeyIds),
+        triggerSync: async () => {
+            await runtime.syncAppState();
+        }
     });
     const appStateMutations = new WaAppStateMutationCoordinator({
         logger,
         messageStore: sessionStore.messages,
-        syncAppState: runtime.syncAppStateWithOptions
+        appStateSync,
+        mediaTransfer,
+        isConnected: () => connectionManager?.isConnected() ?? false,
+        serverClock,
+        emitSnapshotMutations: options.chatEvents?.emitSnapshotMutations === true,
+        emitMutation: (event) => runtime.emitEvent('mutation', event),
+        nctSaltSink: (salt) => trustedContactToken.handleNctSaltSync(salt),
+        contactSink: runtime.persistContact
+    });
+    const profileCoordinator = createProfileCoordinator({
+        queryWithContext: runtime.queryWithContext,
+        generateSid: generateUsyncSid,
+        mexSocket: { query: runtime.query },
+        queryLidsByPhoneJids: (phoneJids) => signalDeviceSync.queryLidsByPhoneJids(phoneJids),
+        mutations: appStateMutations,
+        logger
+    });
+    const statusCoordinator = createStatusCoordinator({
+        appStateMutations,
+        buildMessageContent: async (content) => buildMediaMessageContent(mediaMessageBuildOptions, content),
+        publishStatusMessage: (input) => messageDispatch.publishStatusMessage(input)
+    });
+    const broadcastListCoordinator = createBroadcastListCoordinator({
+        appStateMutations,
+        buildMessageContent: async (content) => buildMediaMessageContent(mediaMessageBuildOptions, content),
+        publishBroadcastListMessage: (input) => messageDispatch.publishBroadcastListMessage(input)
     });
     connectionManager = new WaConnectionManager({
         logger,
@@ -459,7 +596,16 @@ export function buildWaClientDependencies(input) {
         nodeOrchestrator,
         nodeTransport,
         getPassiveTasks: () => passiveTasks,
-        clearStoredCredentials: runtime.clearStoredState
+        clearStoredCredentials: runtime.clearStoredState,
+        onPostPairReconnected: () => {
+            runtime.emitEvent('connection', {
+                status: 'open',
+                reason: 'connected',
+                code: null,
+                isLogout: false,
+                isNewLogin: true
+            });
+        }
     });
     if (mediaConnCacheFallback !== null) {
         connectionManager.setMediaConnCache(mediaConnCacheFallback);
@@ -480,12 +626,15 @@ export function buildWaClientDependencies(input) {
     const connectWithClientSideEffects = async (reason) => {
         runtime.resumeIncomingEvents();
         await connectionManager?.connect(runtime.handleIncomingFrame);
+        if (!authClient.getCurrentCredentials()?.meJid) {
+            return;
+        }
         runtime.emitEvent('connection', {
             status: 'open',
             reason,
             code: null,
             isLogout: false,
-            isNewLogin: connectionManager?.wasNewLogin() ?? false
+            isNewLogin: false
         });
     };
     const clearStoredCredentialsWithClientSideEffects = async () => {
@@ -506,7 +655,7 @@ export function buildWaClientDependencies(input) {
     const incomingMessageAckOptions = {
         logger,
         sendNode: runtime.sendNode,
-        getMeJid: getCurrentMeJid,
+        getMeJid: () => getCurrentCredentials()?.meJid,
         signalProtocol,
         senderKeyManager,
         onDecryptFailure: (context, error) => retryCoordinator.onDecryptFailure(context, error),
@@ -515,14 +664,16 @@ export function buildWaClientDependencies(input) {
                 .handleIncomingMessageEvent(event)
                 .catch((err) => runtime.handleError(toError(err)));
         },
-        emitUnhandledStanza: (event) => runtime.emitEvent('stanza_unhandled', event)
+        emitNewsletterMessageUpdate: (event) => runtime.emitEvent('newsletter_message_update', event),
+        emitUnhandledStanza: (event) => runtime.emitEvent('debug_unhandled_stanza', event)
     };
     const handleClientDirtyBits = (dirtyBits) => handleDirtyBits({
         logger,
         queryWithContext: runtime.queryWithContext,
         getCurrentCredentials,
         syncAppState: runtime.syncAppState,
-        generateUsyncSid
+        generateUsyncSid,
+        newsletterListSubscribed: () => newsletterCoordinator.listSubscribed()
     }, dirtyBits);
     const offlineResume = new WaOfflineResumeCoordinator({
         logger,
@@ -548,11 +699,47 @@ export function buildWaClientDependencies(input) {
             syncAppState: runtime.syncAppState,
             disconnect: disconnectWithClientSideEffects,
             clearStoredCredentials: clearStoredCredentialsWithClientSideEffects,
-            getCurrentMeJid,
+            getCurrentCredentials,
             handleClientDirtyBits,
             incomingMessageAckOptions
         })
     });
+    incomingNode.registerIncomingHandler({
+        tag: WA_NODE_TAGS.NOTIFICATION,
+        subtype: WA_NOTIFICATION_TYPES.NEWSLETTER,
+        prepend: true,
+        // eslint-disable-next-line @typescript-eslint/require-await
+        handler: async (node) => {
+            const newsletterJid = node.attrs.from;
+            if (!newsletterJid || !isNewsletterJid(newsletterJid)) {
+                return false;
+            }
+            const firstChild = getFirstNodeChild(node);
+            const childTag = firstChild?.tag;
+            const action = childTag === WA_NEWSLETTER_NOTIFICATION_TAGS.LIVE_UPDATES
+                ? 'live_updates'
+                : 'unknown';
+            runtime.emitEvent('newsletter', {
+                rawNode: node,
+                stanzaId: node.attrs.id,
+                chatJid: newsletterJid,
+                stanzaType: node.attrs.type,
+                offline: node.attrs.offline !== undefined,
+                newsletterJid,
+                action,
+                subType: childTag
+            });
+            if (action === 'live_updates') {
+                processNewsletterLiveUpdates(node, {
+                    logger,
+                    emitIncomingMessage: incomingMessageAckOptions.emitIncomingMessage,
+                    emitNewsletterMessageUpdate: incomingMessageAckOptions.emitNewsletterMessageUpdate,
+                    emitUnhandledStanza: incomingMessageAckOptions.emitUnhandledStanza
+                });
+            }
+            return false;
+        }
+    });
     incomingNode.registerIncomingHandler({
         tag: WA_NODE_TAGS.NOTIFICATION,
         subtype: WA_NOTIFICATION_TYPES.ENCRYPT,
@@ -563,7 +750,7 @@ export function buildWaClientDependencies(input) {
                 return false;
             }
             const childTag = firstChild.tag;
-            // <count value="N"/> — server prekeys running low
+            // <count value="N"/> – server prekeys running low
             if (childTag === 'count') {
                 const ackNode = buildAckNode({
                     kind: 'notification',
@@ -583,7 +770,7 @@ export function buildWaClientDependencies(input) {
                 });
                 return true;
             }
-            // <digest/> — digest key sync
+            // <digest/> – digest key sync
             if (childTag === 'digest') {
                 const ackNode = buildAckNode({
                     kind: 'notification',
@@ -603,7 +790,7 @@ export function buildWaClientDependencies(input) {
                 });
                 return true;
             }
-            // <identity/> — contact identity key changed
+            // <identity/> – contact identity key changed
             if (childTag === 'identity') {
                 const parsed = parseIdentityChangeNotification(node);
                 if (!parsed) {
@@ -616,15 +803,13 @@ export function buildWaClientDependencies(input) {
                 });
                 await runtime.sendNode(ackNode);
                 const address = parseSignalAddressFromJid(parsed.fromJid);
-                // ignore companion devices (non-primary)
                 if (address.device !== 0) {
                     logger.debug('identity-change: ignoring companion device', {
                         jid: parsed.fromJid
                     });
                     return true;
                 }
-                // self-primary identity change → must disconnect
-                const meJid = getCurrentMeJid();
+                const meJid = getCurrentCredentials()?.meJid;
                 if (meJid) {
                     const meUser = toUserJid(meJid);
                     const fromUser = toUserJid(parsed.fromJid);
@@ -649,12 +834,13 @@ export function buildWaClientDependencies(input) {
                         });
                     });
                 }
-                runtime.emitEvent('notification', {
+                runtime.emitEvent('debug_notification', {
                     rawNode: node,
                     stanzaId: parsed.stanzaId,
                     chatJid: parsed.fromJid,
-                    stanzaType: 'encrypt',
-                    notificationType: 'encrypt',
+                    stanzaType: WA_NOTIFICATION_TYPES.ENCRYPT,
+                    offline: node.attrs.offline !== undefined,
+                    notificationType: WA_NOTIFICATION_TYPES.ENCRYPT,
                     classification: 'core',
                     details: {
                         kind: 'identity_change',
@@ -699,7 +885,6 @@ export function buildWaClientDependencies(input) {
                     });
                 }
             }
-            // invalidate device list cache so next fanout fetches fresh list
             if (sessionStore.deviceList) {
                 await sessionStore.deviceList.deleteUserDevices(userJid).catch((error) => {
                     logger.warn('devices-notification: invalidate cache failed', {
@@ -707,7 +892,6 @@ export function buildWaClientDependencies(input) {
                     });
                 });
             }
-            // for update notifications, re-sync immediately
             if (parsed.action === DEVICE_NOTIFICATION_ACTIONS.UPDATE) {
                 signalDeviceSync.syncDeviceList([userJid]).catch((error) => {
                     logger.warn('devices-notification: sync device list failed', {
@@ -715,12 +899,13 @@ export function buildWaClientDependencies(input) {
                     });
                 });
             }
-            runtime.emitEvent('notification', {
+            runtime.emitEvent('debug_notification', {
                 rawNode: node,
                 stanzaId: parsed.stanzaId,
                 chatJid: parsed.fromJid,
-                stanzaType: 'devices',
-                notificationType: 'devices',
+                stanzaType: WA_NOTIFICATION_TYPES.DEVICES,
+                offline: node.attrs.offline !== undefined,
+                notificationType: WA_NOTIFICATION_TYPES.DEVICES,
                 classification: 'core',
                 details: {
                     kind: 'device_list_change',
@@ -754,7 +939,6 @@ export function buildWaClientDependencies(input) {
             return true;
         }
     });
-    // AB Props: sync after successful login and on server notification
     incomingNode.registerIncomingHandler({
         tag: WA_NODE_TAGS.NOTIFICATION,
         subtype: WA_NOTIFICATION_TYPES.SERVER,
@@ -786,11 +970,20 @@ export function buildWaClientDependencies(input) {
             nodeOrchestrator,
             receiptQueue,
             getCurrentCredentials,
-            abPropsCoordinator
+            abPropsCoordinator,
+            markOnlineOnConnect: options.markOnlineOnConnect ?? false
         }),
         mobilePrimary: options.mobileTransport !== undefined,
         appStateSync
     });
+    const lowLevelCoordinator = createLowLevelCoordinator({
+        logger,
+        nodeOrchestrator,
+        incomingNode,
+        receiptQueue,
+        isConnected: () => connectionManager?.isConnected() ?? false,
+        defaultIqTimeoutMs: options.iqTimeoutMs
+    });
     return {
         nodeTransport,
         nodeOrchestrator,
@@ -808,20 +1001,28 @@ export function buildWaClientDependencies(input) {
         signalSessionSync,
         authClient,
         messageDispatch,
+        messageCoordinator,
+        presenceCoordinator,
         retryCoordinator,
         appStateSync,
         chatCoordinator: appStateMutations,
         streamControl,
         incomingNode,
+        lowLevelCoordinator,
         passiveTasks,
         groupCoordinator,
+        statusCoordinator,
+        broadcastListCoordinator,
+        newsletterCoordinator,
         privacyCoordinator,
         profileCoordinator,
         businessCoordinator,
+        botCoordinator,
         emailCoordinator,
         receiptQueue,
         connectionManager,
         trustedContactToken,
-        abPropsCoordinator
+        abPropsCoordinator,
+        peerDataOperation
     };
 }