zapo-js 0.2.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +103 -179
- package/dist/appstate/{WaAppStateCrypto.js → crypto/WaAppStateCrypto.js} +79 -62
- package/dist/appstate/index.js +8 -7
- package/dist/appstate/{encoding.js → parsers/encoding.js} +11 -4
- package/dist/appstate/{WaAppStateSyncResponseParser.js → parsers/response-parser.js} +20 -8
- package/dist/appstate/{WaAppStateSyncClient.js → sync/WaAppStateSyncClient.js} +246 -88
- package/dist/appstate/utils.js +16 -0
- package/dist/appstate-spec.js +89 -0
- package/dist/auth/WaAuthClient.js +117 -13
- package/dist/auth/credentials-flow.js +207 -0
- package/dist/auth/pairing/WaPairingFlow.js +53 -47
- package/dist/auth/pairing/pairing-code-crypto.js +91 -0
- package/dist/client/WaClient.js +369 -460
- package/dist/client/WaClientFactory.js +377 -93
- package/dist/client/connection/WaConnectionManager.js +31 -11
- package/dist/client/coordinators/WaAbPropsCoordinator.js +140 -0
- package/dist/client/coordinators/WaAppStateMutationCoordinator.js +663 -143
- package/dist/client/coordinators/WaBotCoordinator.js +345 -0
- package/dist/client/coordinators/WaBroadcastListCoordinator.js +20 -0
- package/dist/client/coordinators/WaBusinessCoordinator.js +81 -180
- package/dist/client/coordinators/WaEmailCoordinator.js +64 -0
- package/dist/client/coordinators/WaGroupCoordinator.js +529 -52
- package/dist/client/coordinators/WaIncomingNodeCoordinator.js +130 -20
- package/dist/client/coordinators/WaLowLevelCoordinator.js +41 -0
- package/dist/client/coordinators/WaMessageCoordinator.js +365 -0
- package/dist/client/coordinators/WaMessageDispatchCoordinator.js +724 -216
- package/dist/client/coordinators/WaNewsletterCoordinator.js +18 -0
- package/dist/client/coordinators/WaOfflineResumeCoordinator.js +114 -0
- package/dist/client/coordinators/WaPassiveTasksCoordinator.js +53 -22
- package/dist/client/coordinators/WaPresenceCoordinator.js +21 -0
- package/dist/client/coordinators/WaPrivacyCoordinator.js +7 -5
- package/dist/client/coordinators/WaProfileCoordinator.js +223 -50
- package/dist/client/coordinators/WaRetryCoordinator.js +256 -123
- package/dist/client/coordinators/WaStatusCoordinator.js +49 -0
- package/dist/client/coordinators/WaStreamControlCoordinator.js +6 -6
- package/dist/client/coordinators/WaTrustedContactTokenCoordinator.js +29 -10
- package/dist/client/events/abprops.js +43 -0
- package/dist/client/events/appstate-mutation.js +133 -0
- package/dist/client/events/business.js +375 -0
- package/dist/client/events/call.js +58 -0
- package/dist/client/events/chatstate.js +23 -0
- package/dist/client/events/devices.js +15 -16
- package/dist/client/{dirty.js → events/dirty.js} +34 -20
- package/dist/client/events/group.js +13 -24
- package/dist/client/events/identity.js +2 -1
- package/dist/client/events/incoming.js +502 -0
- package/dist/client/events/mex-notification.js +181 -0
- package/dist/client/events/picture.js +33 -0
- package/dist/client/events/presence.js +44 -0
- package/dist/client/events/privacy-token.js +1 -2
- package/dist/client/events/receipt.js +26 -0
- package/dist/client/events/registration.js +42 -0
- package/dist/client/media.js +400 -0
- package/dist/client/messaging/fanout.js +9 -10
- package/dist/client/messaging/{participants.js → group-metadata.js} +73 -35
- package/dist/client/messaging/ignore-key.js +132 -0
- package/dist/client/messaging/key-protocol.js +3 -17
- package/dist/client/messaging/link-preview.js +159 -0
- package/dist/client/messaging/messages.js +671 -0
- package/dist/client/newsletter/admin.js +165 -0
- package/dist/client/newsletter/content.js +253 -0
- package/dist/client/newsletter/discovery.js +115 -0
- package/dist/client/newsletter/messaging.js +197 -0
- package/dist/client/newsletter/mex.js +41 -0
- package/dist/client/newsletter/parse.js +217 -0
- package/dist/client/persistence/WriteBehindPersistence.js +31 -4
- package/dist/client/{history-sync.js → persistence/history-sync.js} +125 -18
- package/dist/client/persistence/mailbox.js +104 -0
- package/dist/client/tokens/cs-token.js +11 -17
- package/dist/crypto/core/hkdf.js +12 -12
- package/dist/crypto/core/index.js +9 -8
- package/dist/crypto/core/keys.js +1 -8
- package/dist/crypto/core/nonce.js +12 -12
- package/dist/crypto/core/primitives.js +123 -93
- package/dist/crypto/core/random.js +9 -9
- package/dist/crypto/core/xeddsa.js +59 -0
- package/dist/crypto/curves/Ed25519.js +32 -21
- package/dist/crypto/curves/X25519.js +71 -17
- package/dist/crypto/curves/constants.js +3 -1
- package/dist/crypto/math/constants.js +1 -2
- package/dist/crypto/math/mod.js +0 -33
- package/dist/esm/appstate/{WaAppStateCrypto.js → crypto/WaAppStateCrypto.js} +72 -55
- package/dist/esm/appstate/index.js +5 -5
- package/dist/esm/appstate/{encoding.js → parsers/encoding.js} +11 -4
- package/dist/esm/appstate/{WaAppStateSyncResponseParser.js → parsers/response-parser.js} +20 -8
- package/dist/esm/appstate/{WaAppStateSyncClient.js → sync/WaAppStateSyncClient.js} +235 -76
- package/dist/esm/appstate/utils.js +16 -0
- package/dist/esm/appstate-spec.js +79 -0
- package/dist/esm/auth/WaAuthClient.js +114 -10
- package/dist/esm/auth/credentials-flow.js +202 -0
- package/dist/esm/auth/pairing/WaPairingFlow.js +52 -46
- package/dist/esm/auth/pairing/pairing-code-crypto.js +85 -0
- package/dist/esm/client/WaClient.js +372 -463
- package/dist/esm/client/WaClientFactory.js +380 -96
- package/dist/esm/client/connection/WaConnectionManager.js +31 -11
- package/dist/esm/client/coordinators/WaAbPropsCoordinator.js +136 -0
- package/dist/esm/client/coordinators/WaAppStateMutationCoordinator.js +665 -145
- package/dist/esm/client/coordinators/WaBotCoordinator.js +342 -0
- package/dist/esm/client/coordinators/WaBroadcastListCoordinator.js +17 -0
- package/dist/esm/client/coordinators/WaBusinessCoordinator.js +78 -177
- package/dist/esm/client/coordinators/WaEmailCoordinator.js +61 -0
- package/dist/esm/client/coordinators/WaGroupCoordinator.js +532 -55
- package/dist/esm/client/coordinators/WaIncomingNodeCoordinator.js +132 -22
- package/dist/esm/client/coordinators/WaLowLevelCoordinator.js +38 -0
- package/dist/esm/client/coordinators/WaMessageCoordinator.js +361 -0
- package/dist/esm/client/coordinators/WaMessageDispatchCoordinator.js +719 -211
- package/dist/esm/client/coordinators/WaNewsletterCoordinator.js +13 -0
- package/dist/esm/client/coordinators/WaOfflineResumeCoordinator.js +110 -0
- package/dist/esm/client/coordinators/WaPassiveTasksCoordinator.js +54 -23
- package/dist/esm/client/coordinators/WaPresenceCoordinator.js +18 -0
- package/dist/esm/client/coordinators/WaPrivacyCoordinator.js +7 -5
- package/dist/esm/client/coordinators/WaProfileCoordinator.js +226 -53
- package/dist/esm/client/coordinators/WaRetryCoordinator.js +258 -125
- package/dist/esm/client/coordinators/WaStatusCoordinator.js +46 -0
- package/dist/esm/client/coordinators/WaStreamControlCoordinator.js +6 -6
- package/dist/esm/client/coordinators/WaTrustedContactTokenCoordinator.js +31 -12
- package/dist/esm/client/events/abprops.js +40 -0
- package/dist/esm/client/events/appstate-mutation.js +130 -0
- package/dist/esm/client/events/business.js +370 -0
- package/dist/esm/client/events/call.js +55 -0
- package/dist/esm/client/events/chatstate.js +20 -0
- package/dist/esm/client/events/devices.js +15 -16
- package/dist/esm/client/{dirty.js → events/dirty.js} +34 -20
- package/dist/esm/client/events/group.js +14 -25
- package/dist/esm/client/events/identity.js +2 -1
- package/dist/esm/client/events/incoming.js +487 -0
- package/dist/esm/client/events/mex-notification.js +178 -0
- package/dist/esm/client/events/picture.js +30 -0
- package/dist/esm/client/events/presence.js +41 -0
- package/dist/esm/client/events/privacy-token.js +1 -2
- package/dist/esm/client/events/receipt.js +23 -0
- package/dist/esm/client/events/registration.js +39 -0
- package/dist/esm/client/media.js +384 -0
- package/dist/esm/client/messaging/fanout.js +10 -11
- package/dist/esm/client/messaging/{participants.js → group-metadata.js} +72 -34
- package/dist/esm/client/messaging/ignore-key.js +126 -0
- package/dist/esm/client/messaging/key-protocol.js +3 -17
- package/dist/esm/client/messaging/link-preview.js +156 -0
- package/dist/esm/client/messaging/messages.js +667 -0
- package/dist/esm/client/newsletter/admin.js +162 -0
- package/dist/esm/client/newsletter/content.js +249 -0
- package/dist/esm/client/newsletter/discovery.js +112 -0
- package/dist/esm/client/newsletter/messaging.js +194 -0
- package/dist/esm/client/newsletter/mex.js +37 -0
- package/dist/esm/client/newsletter/parse.js +200 -0
- package/dist/esm/client/persistence/WriteBehindPersistence.js +31 -4
- package/dist/esm/client/{history-sync.js → persistence/history-sync.js} +124 -18
- package/dist/esm/client/persistence/mailbox.js +101 -0
- package/dist/esm/client/tokens/cs-token.js +12 -18
- package/dist/esm/crypto/core/hkdf.js +14 -14
- package/dist/esm/crypto/core/index.js +3 -2
- package/dist/esm/crypto/core/keys.js +1 -7
- package/dist/esm/crypto/core/nonce.js +11 -11
- package/dist/esm/crypto/core/primitives.js +121 -88
- package/dist/esm/crypto/core/random.js +8 -7
- package/dist/esm/crypto/core/xeddsa.js +55 -0
- package/dist/esm/crypto/curves/Ed25519.js +35 -24
- package/dist/esm/crypto/curves/X25519.js +74 -20
- package/dist/esm/crypto/curves/constants.js +2 -0
- package/dist/esm/crypto/math/constants.js +1 -2
- package/dist/esm/crypto/math/mod.js +0 -32
- package/dist/esm/index.js +7 -2
- package/dist/esm/infra/log/ConsoleLogger.js +30 -6
- package/dist/esm/infra/log/PinoLogger.js +64 -0
- package/dist/esm/infra/log/types.js +4 -2
- package/dist/esm/infra/perf/BackgroundQueue.js +55 -13
- package/dist/esm/infra/perf/StoreLock.js +7 -4
- package/dist/esm/media/constants.js +35 -2
- package/dist/esm/media/crypto/WaMediaCrypto.js +374 -0
- package/dist/esm/media/index.js +4 -3
- package/dist/esm/media/processor.js +1 -0
- package/dist/esm/media/sticker/sticker-pack.js +133 -0
- package/dist/esm/media/{WaMediaTransferClient.js → transfer/WaMediaTransferClient.js} +84 -196
- package/dist/esm/media/{conn.js → transfer/conn.js} +10 -5
- package/dist/esm/message/WaMessageClient.js +46 -15
- package/dist/esm/message/addons/link-preview/builder.js +36 -0
- package/dist/esm/message/addons/link-preview/detect.js +55 -0
- package/dist/esm/message/addons/link-preview/fetcher.js +391 -0
- package/dist/esm/message/addons/link-preview/types.js +1 -0
- package/dist/esm/message/context-info.js +123 -0
- package/dist/esm/message/crypto/addon-crypto.js +244 -0
- package/dist/esm/message/{icdc.js → crypto/icdc.js} +11 -13
- package/dist/esm/message/crypto/phash.js +133 -0
- package/dist/esm/message/{reporting-token.js → crypto/reporting-token.js} +7 -7
- package/dist/esm/message/{use-case-secret.js → crypto/use-case-secret.js} +21 -4
- package/dist/esm/message/{content.js → encode/content.js} +183 -8
- package/dist/esm/message/encode/media-payload.js +42 -0
- package/dist/esm/message/{padding.js → encode/padding.js} +9 -3
- package/dist/esm/message/index.js +2 -2
- package/dist/esm/message/kinds/bot.js +111 -0
- package/dist/esm/message/kinds/newsletter.js +244 -0
- package/dist/esm/message/kinds/sticker-pack.js +29 -0
- package/dist/esm/message/{ack.js → primitives/ack.js} +8 -1
- package/dist/esm/message/primitives/incoming.js +511 -0
- package/dist/esm/message/primitives/peer-data-operation.js +93 -0
- package/dist/esm/mex.js +1 -0
- package/dist/esm/protocol/abprops.js +169 -0
- package/dist/esm/protocol/appstate.js +6 -30
- package/dist/esm/protocol/auth.js +3 -2
- package/dist/esm/protocol/bot.js +77 -0
- package/dist/esm/protocol/browser.js +22 -0
- package/dist/esm/protocol/business.js +19 -0
- package/dist/esm/protocol/call.js +48 -0
- package/dist/esm/protocol/constants.js +10 -2
- package/dist/esm/protocol/defaults.js +3 -0
- package/dist/esm/protocol/email.js +30 -0
- package/dist/esm/protocol/index.js +1 -1
- package/dist/esm/protocol/jid.js +142 -11
- package/dist/esm/protocol/media.js +25 -12
- package/dist/esm/protocol/message.js +4 -1
- package/dist/esm/protocol/newsletter.js +61 -0
- package/dist/esm/protocol/nodes.js +26 -2
- package/dist/esm/protocol/notification.js +24 -2
- package/dist/esm/protocol/presence.js +13 -0
- package/dist/esm/protocol/status.js +6 -0
- package/dist/esm/retry/codec.js +5 -0
- package/dist/esm/retry/parse.js +20 -38
- package/dist/esm/retry/reason.js +6 -1
- package/dist/esm/retry/replay.js +131 -37
- package/dist/esm/retry/tracker.js +4 -8
- package/dist/esm/signal/api/SignalDeviceSyncApi.js +71 -21
- package/dist/esm/signal/api/SignalDigestSyncApi.js +15 -8
- package/dist/esm/signal/api/SignalIdentitySyncApi.js +13 -4
- package/dist/esm/signal/api/SignalMissingPreKeysSyncApi.js +24 -63
- package/dist/esm/signal/api/SignalRotateKeyApi.js +10 -0
- package/dist/esm/signal/api/SignalSessionSyncApi.js +23 -51
- package/dist/esm/signal/api/codec.js +52 -1
- package/dist/esm/signal/api/prekeys.js +4 -0
- package/dist/esm/signal/attestation/WaAdvSignature.js +17 -0
- package/dist/esm/signal/{crypto → attestation}/constants.js +0 -4
- package/dist/esm/signal/constants.js +3 -0
- package/dist/esm/signal/encoding.js +6 -332
- package/dist/esm/signal/group/SenderKeyChain.js +20 -35
- package/dist/esm/signal/group/SenderKeyCodec.js +5 -6
- package/dist/esm/signal/group/SenderKeyManager.js +37 -17
- package/dist/esm/signal/group/encoding.js +96 -0
- package/dist/esm/signal/index.js +4 -1
- package/dist/esm/signal/registration/encoding.js +34 -0
- package/dist/esm/signal/registration/keygen.js +12 -3
- package/dist/esm/signal/registration/utils.js +8 -2
- package/dist/esm/signal/session/SignalProtocol.js +129 -26
- package/dist/esm/signal/session/SignalRatchet.js +46 -64
- package/dist/esm/signal/session/SignalSerializer.js +5 -6
- package/dist/esm/signal/session/SignalSession.js +14 -19
- package/dist/esm/signal/session/encoding.js +173 -0
- package/dist/esm/signal/session/resolver.js +144 -35
- package/dist/esm/store/cache/identity.cache.js +75 -0
- package/dist/esm/store/cache/privacy-token.cache.js +57 -0
- package/dist/esm/store/cache/sender-key.cache.js +101 -0
- package/dist/esm/store/cache/session.cache.js +92 -0
- package/dist/esm/store/contracts/group-metadata.store.js +1 -0
- package/dist/esm/store/contracts/identity.store.js +1 -0
- package/dist/esm/store/contracts/message-secret.store.js +1 -0
- package/dist/esm/store/contracts/pre-key.store.js +1 -0
- package/dist/esm/store/contracts/session.store.js +1 -0
- package/dist/esm/store/createStore.js +129 -39
- package/dist/esm/store/index.js +15 -10
- package/dist/esm/store/locks/contact.lock.js +1 -0
- package/dist/esm/store/locks/device-list.lock.js +1 -0
- package/dist/esm/store/locks/group-metadata.lock.js +20 -0
- package/dist/esm/store/locks/identity.lock.js +16 -0
- package/dist/esm/store/locks/message-secret.lock.js +17 -0
- package/dist/esm/store/locks/pre-key.lock.js +27 -0
- package/dist/esm/store/locks/session.lock.js +19 -0
- package/dist/esm/store/locks/signal.lock.js +0 -24
- package/dist/esm/store/{providers/memory → memory}/appstate.store.js +5 -5
- package/dist/esm/store/memory/auth.store.js +24 -0
- package/dist/esm/store/memory/contact.store.js +79 -0
- package/dist/esm/store/memory/device-list.store.js +103 -0
- package/dist/esm/store/{providers/memory/participants.store.js → memory/group-metadata.store.js} +24 -12
- package/dist/esm/store/memory/identity.store.js +31 -0
- package/dist/esm/store/memory/message-secret.store.js +90 -0
- package/dist/esm/store/{providers/memory → memory}/message.store.js +2 -2
- package/dist/esm/store/memory/pre-key.store.js +97 -0
- package/dist/esm/store/{providers/memory → memory}/privacy-token.store.js +1 -1
- package/dist/esm/store/{providers/memory → memory}/retry.store.js +49 -14
- package/dist/esm/store/{providers/memory → memory}/sender-key.store.js +3 -3
- package/dist/esm/store/memory/session.store.js +45 -0
- package/dist/esm/store/memory/signal.store.js +36 -0
- package/dist/esm/store/{providers/memory → memory}/thread.store.js +2 -2
- package/dist/esm/store/noop.store.js +26 -4
- package/dist/esm/transport/WaComms.js +18 -8
- package/dist/esm/transport/WaWebSocket.js +41 -9
- package/dist/esm/transport/binary/constants.js +10 -4
- package/dist/esm/transport/binary/decoder.js +21 -15
- package/dist/esm/transport/binary/encoder.js +96 -21
- package/dist/esm/transport/binary/tokens.js +12 -12
- package/dist/esm/transport/index.js +7 -0
- package/dist/esm/transport/keepalive/WaKeepAlive.js +35 -12
- package/dist/esm/transport/node/WaMobileTcpSocket.js +120 -0
- package/dist/esm/transport/node/WaNodeOrchestrator.js +26 -13
- package/dist/esm/transport/node/WaNodeTransport.js +13 -0
- package/dist/esm/transport/node/builders/abprops.js +20 -0
- package/dist/esm/transport/node/builders/account-sync.js +7 -15
- package/dist/esm/transport/node/builders/bot.js +38 -0
- package/dist/esm/transport/node/builders/business.js +30 -30
- package/dist/esm/transport/node/builders/chatstate.js +28 -0
- package/dist/esm/transport/node/builders/community.js +53 -0
- package/dist/esm/transport/node/builders/device.js +11 -0
- package/dist/esm/transport/node/builders/email.js +66 -0
- package/dist/esm/transport/node/builders/global.js +1 -1
- package/dist/esm/transport/node/builders/group.js +114 -4
- package/dist/esm/transport/node/builders/media.js +2 -2
- package/dist/esm/transport/node/builders/message.js +83 -49
- package/dist/esm/transport/node/builders/newsletter.js +176 -0
- package/dist/esm/transport/node/builders/offline.js +14 -0
- package/dist/esm/transport/node/builders/passive.js +7 -0
- package/dist/esm/transport/node/builders/prekeys.js +40 -43
- package/dist/esm/transport/node/builders/presence.js +39 -0
- package/dist/esm/transport/node/builders/privacy-token.js +19 -23
- package/dist/esm/transport/node/builders/privacy.js +6 -6
- package/dist/esm/transport/node/builders/profile.js +28 -8
- package/dist/esm/transport/node/builders/retry.js +1 -1
- package/dist/esm/transport/node/builders/tos.js +58 -0
- package/dist/esm/transport/node/builders/usync.js +51 -2
- package/dist/esm/transport/node/helpers.js +27 -1
- package/dist/esm/transport/node/mex/argo-decoder.js +152 -0
- package/dist/esm/transport/node/mex/client.js +105 -0
- package/dist/esm/transport/node/query.js +17 -0
- package/dist/esm/transport/node/usync.js +12 -0
- package/dist/esm/transport/noise/WaClientPayload.js +23 -18
- package/dist/esm/transport/noise/WaFrameCodec.js +2 -2
- package/dist/esm/transport/noise/WaMobileClientPayload.js +58 -0
- package/dist/esm/transport/noise/WaNoiseCert.js +14 -27
- package/dist/esm/transport/noise/WaNoiseHandshake.js +27 -25
- package/dist/esm/transport/noise/WaNoiseSession.js +48 -67
- package/dist/esm/transport/noise/WaNoiseSocket.js +19 -13
- package/dist/esm/transport/noise/constants.js +0 -1
- package/dist/esm/transport/proxy.js +5 -0
- package/dist/esm/transport/stream/parse.js +3 -7
- package/dist/esm/transport/wa-web-version-fetcher.js +91 -0
- package/dist/esm/util/async.js +4 -0
- package/dist/esm/util/bytes.js +37 -2
- package/dist/esm/util/clock.js +15 -0
- package/dist/esm/util/coercion.js +45 -3
- package/dist/esm/util/collections.js +11 -0
- package/dist/esm/util/index.js +2 -2
- package/dist/esm/util/primitives.js +19 -0
- package/dist/esm/util/runtime.js +5 -0
- package/dist/esm/version-spec.js +1 -0
- package/dist/index.js +31 -1
- package/dist/infra/log/ConsoleLogger.js +30 -6
- package/dist/infra/log/PinoLogger.js +64 -0
- package/dist/infra/log/types.js +4 -2
- package/dist/infra/perf/BackgroundQueue.js +55 -13
- package/dist/infra/perf/StoreLock.js +7 -4
- package/dist/media/constants.js +36 -3
- package/dist/media/crypto/WaMediaCrypto.js +378 -0
- package/dist/media/index.js +9 -4
- package/dist/media/processor.js +2 -0
- package/dist/media/sticker/sticker-pack.js +136 -0
- package/dist/media/{WaMediaTransferClient.js → transfer/WaMediaTransferClient.js} +87 -229
- package/dist/media/{conn.js → transfer/conn.js} +10 -5
- package/dist/message/WaMessageClient.js +46 -15
- package/dist/message/addons/link-preview/builder.js +39 -0
- package/dist/message/addons/link-preview/detect.js +58 -0
- package/dist/message/addons/link-preview/fetcher.js +394 -0
- package/dist/message/addons/link-preview/types.js +2 -0
- package/dist/message/context-info.js +129 -0
- package/dist/message/crypto/addon-crypto.js +254 -0
- package/dist/message/{icdc.js → crypto/icdc.js} +11 -13
- package/dist/message/crypto/phash.js +136 -0
- package/dist/message/{reporting-token.js → crypto/reporting-token.js} +7 -7
- package/dist/message/{use-case-secret.js → crypto/use-case-secret.js} +21 -4
- package/dist/message/{content.js → encode/content.js} +200 -7
- package/dist/message/encode/media-payload.js +45 -0
- package/dist/message/{padding.js → encode/padding.js} +9 -3
- package/dist/message/index.js +2 -2
- package/dist/message/kinds/bot.js +120 -0
- package/dist/message/kinds/newsletter.js +248 -0
- package/dist/message/kinds/sticker-pack.js +34 -0
- package/dist/message/{ack.js → primitives/ack.js} +8 -1
- package/dist/message/{incoming.js → primitives/incoming.js} +225 -38
- package/dist/message/primitives/peer-data-operation.js +96 -0
- package/dist/mex.js +6 -0
- package/dist/proto.js +1 -1
- package/dist/protocol/abprops.js +173 -0
- package/dist/protocol/appstate.js +7 -31
- package/dist/protocol/auth.js +3 -2
- package/dist/protocol/bot.js +81 -0
- package/dist/protocol/browser.js +23 -0
- package/dist/protocol/business.js +22 -0
- package/dist/protocol/call.js +51 -0
- package/dist/protocol/constants.js +51 -3
- package/dist/protocol/defaults.js +3 -0
- package/dist/protocol/email.js +33 -0
- package/dist/protocol/index.js +12 -3
- package/dist/protocol/jid.js +148 -11
- package/dist/protocol/media.js +25 -12
- package/dist/protocol/message.js +4 -1
- package/dist/protocol/newsletter.js +64 -0
- package/dist/protocol/nodes.js +26 -2
- package/dist/protocol/notification.js +25 -3
- package/dist/protocol/presence.js +16 -0
- package/dist/protocol/status.js +9 -0
- package/dist/retry/codec.js +5 -0
- package/dist/retry/parse.js +16 -34
- package/dist/retry/reason.js +6 -1
- package/dist/retry/replay.js +129 -35
- package/dist/retry/tracker.js +3 -7
- package/dist/signal/api/SignalDeviceSyncApi.js +69 -19
- package/dist/signal/api/SignalDigestSyncApi.js +14 -7
- package/dist/signal/api/SignalIdentitySyncApi.js +13 -4
- package/dist/signal/api/SignalMissingPreKeysSyncApi.js +21 -60
- package/dist/signal/api/SignalRotateKeyApi.js +10 -0
- package/dist/signal/api/SignalSessionSyncApi.js +20 -48
- package/dist/signal/api/codec.js +52 -0
- package/dist/signal/api/prekeys.js +4 -0
- package/dist/signal/attestation/WaAdvSignature.js +26 -0
- package/dist/signal/{crypto → attestation}/constants.js +1 -5
- package/dist/signal/constants.js +4 -1
- package/dist/signal/encoding.js +5 -341
- package/dist/signal/group/SenderKeyChain.js +19 -34
- package/dist/signal/group/SenderKeyCodec.js +4 -5
- package/dist/signal/group/SenderKeyManager.js +36 -16
- package/dist/signal/group/encoding.js +101 -0
- package/dist/signal/index.js +13 -10
- package/dist/signal/registration/encoding.js +39 -0
- package/dist/signal/registration/keygen.js +11 -2
- package/dist/signal/registration/utils.js +8 -2
- package/dist/signal/session/SignalProtocol.js +128 -25
- package/dist/signal/session/SignalRatchet.js +41 -60
- package/dist/signal/session/SignalSerializer.js +5 -6
- package/dist/signal/session/SignalSession.js +13 -19
- package/dist/signal/session/encoding.js +183 -0
- package/dist/signal/session/resolver.js +144 -35
- package/dist/store/cache/identity.cache.js +78 -0
- package/dist/store/cache/privacy-token.cache.js +60 -0
- package/dist/store/cache/sender-key.cache.js +104 -0
- package/dist/store/cache/session.cache.js +95 -0
- package/dist/store/contracts/group-metadata.store.js +2 -0
- package/dist/store/contracts/identity.store.js +2 -0
- package/dist/store/contracts/message-secret.store.js +2 -0
- package/dist/store/contracts/pre-key.store.js +2 -0
- package/dist/store/contracts/session.store.js +2 -0
- package/dist/store/createStore.js +128 -38
- package/dist/store/index.js +22 -12
- package/dist/store/locks/contact.lock.js +1 -0
- package/dist/store/locks/device-list.lock.js +1 -0
- package/dist/store/locks/group-metadata.lock.js +23 -0
- package/dist/store/locks/identity.lock.js +19 -0
- package/dist/store/locks/message-secret.lock.js +20 -0
- package/dist/store/locks/pre-key.lock.js +30 -0
- package/dist/store/locks/session.lock.js +22 -0
- package/dist/store/locks/signal.lock.js +0 -24
- package/dist/store/{providers/memory → memory}/appstate.store.js +5 -5
- package/dist/store/memory/auth.store.js +28 -0
- package/dist/store/memory/contact.store.js +83 -0
- package/dist/store/memory/device-list.store.js +107 -0
- package/dist/store/{providers/memory/participants.store.js → memory/group-metadata.store.js} +26 -14
- package/dist/store/memory/identity.store.js +35 -0
- package/dist/store/memory/message-secret.store.js +94 -0
- package/dist/store/{providers/memory → memory}/message.store.js +2 -2
- package/dist/store/memory/pre-key.store.js +101 -0
- package/dist/store/{providers/memory → memory}/privacy-token.store.js +1 -1
- package/dist/store/{providers/memory → memory}/retry.store.js +49 -14
- package/dist/store/{providers/memory → memory}/sender-key.store.js +3 -3
- package/dist/store/memory/session.store.js +49 -0
- package/dist/store/memory/signal.store.js +40 -0
- package/dist/store/{providers/memory → memory}/thread.store.js +2 -2
- package/dist/store/noop.store.js +27 -5
- package/dist/transport/WaComms.js +18 -8
- package/dist/transport/WaWebSocket.js +41 -9
- package/dist/transport/binary/constants.js +11 -5
- package/dist/transport/binary/decoder.js +24 -18
- package/dist/transport/binary/encoder.js +109 -34
- package/dist/transport/binary/tokens.js +12 -12
- package/dist/transport/index.js +19 -1
- package/dist/transport/keepalive/WaKeepAlive.js +35 -12
- package/dist/transport/node/WaMobileTcpSocket.js +124 -0
- package/dist/transport/node/WaNodeOrchestrator.js +25 -12
- package/dist/transport/node/WaNodeTransport.js +13 -0
- package/dist/transport/node/builders/abprops.js +23 -0
- package/dist/transport/node/builders/account-sync.js +7 -16
- package/dist/transport/node/builders/bot.js +43 -0
- package/dist/transport/node/builders/business.js +31 -31
- package/dist/transport/node/builders/chatstate.js +31 -0
- package/dist/transport/node/builders/community.js +59 -0
- package/dist/transport/node/builders/device.js +14 -0
- package/dist/transport/node/builders/email.js +73 -0
- package/dist/transport/node/builders/global.js +1 -1
- package/dist/transport/node/builders/group.js +121 -3
- package/dist/transport/node/builders/media.js +1 -1
- package/dist/transport/node/builders/message.js +84 -49
- package/dist/transport/node/builders/newsletter.js +183 -0
- package/dist/transport/node/builders/offline.js +17 -0
- package/dist/transport/node/builders/passive.js +10 -0
- package/dist/transport/node/builders/prekeys.js +38 -41
- package/dist/transport/node/builders/presence.js +43 -0
- package/dist/transport/node/builders/privacy-token.js +18 -22
- package/dist/transport/node/builders/privacy.js +5 -5
- package/dist/transport/node/builders/profile.js +30 -7
- package/dist/transport/node/builders/retry.js +1 -1
- package/dist/transport/node/builders/tos.js +63 -0
- package/dist/transport/node/builders/usync.js +52 -1
- package/dist/transport/node/helpers.js +28 -1
- package/dist/transport/node/mex/argo-decoder.js +189 -0
- package/dist/transport/node/mex/client.js +109 -0
- package/dist/transport/node/query.js +17 -0
- package/dist/transport/node/usync.js +13 -0
- package/dist/transport/noise/WaClientPayload.js +22 -17
- package/dist/transport/noise/WaFrameCodec.js +1 -1
- package/dist/transport/noise/WaMobileClientPayload.js +61 -0
- package/dist/transport/noise/WaNoiseCert.js +13 -26
- package/dist/transport/noise/WaNoiseHandshake.js +25 -23
- package/dist/transport/noise/WaNoiseSession.js +47 -66
- package/dist/transport/noise/WaNoiseSocket.js +18 -12
- package/dist/transport/noise/constants.js +1 -2
- package/dist/transport/proxy.js +5 -0
- package/dist/transport/stream/parse.js +3 -7
- package/dist/transport/wa-web-version-fetcher.js +94 -0
- package/dist/types/appstate/constants.d.ts +1 -1
- package/dist/types/appstate/{WaAppStateCrypto.d.ts → crypto/WaAppStateCrypto.d.ts} +29 -9
- package/dist/types/appstate/index.d.ts +5 -5
- package/dist/types/appstate/{encoding.d.ts → parsers/encoding.d.ts} +8 -1
- package/dist/types/appstate/{WaAppStateSyncResponseParser.d.ts → parsers/response-parser.d.ts} +13 -3
- package/dist/types/appstate/sync/WaAppStateSyncClient.d.ts +105 -0
- package/dist/types/appstate/types.d.ts +1 -1
- package/dist/types/appstate/utils.d.ts +17 -1
- package/dist/types/appstate-spec.d.ts +24 -0
- package/dist/types/auth/WaAuthClient.d.ts +95 -3
- package/dist/types/auth/credentials-flow.d.ts +21 -0
- package/dist/types/auth/pairing/WaPairingFlow.d.ts +3 -2
- package/dist/types/auth/pairing/{WaPairingCodeCrypto.d.ts → pairing-code-crypto.d.ts} +5 -1
- package/dist/types/auth/types.d.ts +88 -1
- package/dist/types/client/WaClient.d.ts +183 -65
- package/dist/types/client/WaClientFactory.d.ts +40 -9
- package/dist/types/client/connection/WaConnectionManager.d.ts +4 -2
- package/dist/types/client/connection/WaReceiptQueue.d.ts +1 -1
- package/dist/types/client/coordinators/WaAbPropsCoordinator.d.ts +26 -0
- package/dist/types/client/coordinators/WaAppStateMutationCoordinator.d.ts +215 -5
- package/dist/types/client/coordinators/WaBotCoordinator.d.ts +117 -0
- package/dist/types/client/coordinators/WaBroadcastListCoordinator.d.ts +39 -0
- package/dist/types/client/coordinators/WaBusinessCoordinator.d.ts +45 -44
- package/dist/types/client/coordinators/WaEmailCoordinator.d.ts +40 -0
- package/dist/types/client/coordinators/WaGroupCoordinator.d.ts +311 -9
- package/dist/types/client/coordinators/WaIncomingNodeCoordinator.d.ts +16 -4
- package/dist/types/client/coordinators/WaLowLevelCoordinator.d.ts +47 -0
- package/dist/types/client/coordinators/WaMessageCoordinator.d.ts +232 -0
- package/dist/types/client/coordinators/WaMessageDispatchCoordinator.d.ts +65 -29
- package/dist/types/client/coordinators/WaNewsletterCoordinator.d.ts +13 -0
- package/dist/types/client/coordinators/WaOfflineResumeCoordinator.d.ts +31 -0
- package/dist/types/client/coordinators/WaPassiveTasksCoordinator.d.ts +15 -3
- package/dist/types/client/coordinators/WaPresenceCoordinator.d.ts +27 -0
- package/dist/types/client/coordinators/WaPrivacyCoordinator.d.ts +28 -1
- package/dist/types/client/coordinators/WaProfileCoordinator.d.ts +117 -2
- package/dist/types/client/coordinators/WaRetryCoordinator.d.ts +23 -15
- package/dist/types/client/coordinators/WaStatusCoordinator.d.ts +42 -0
- package/dist/types/client/coordinators/WaTrustedContactTokenCoordinator.d.ts +16 -2
- package/dist/types/client/events/abprops.d.ts +15 -0
- package/dist/types/client/events/appstate-mutation.d.ts +3 -0
- package/dist/types/client/events/business.d.ts +10 -0
- package/dist/types/client/events/call.d.ts +31 -0
- package/dist/types/client/events/chatstate.d.ts +9 -0
- package/dist/types/client/events/devices.d.ts +5 -4
- package/dist/types/client/{dirty.d.ts → events/dirty.d.ts} +7 -4
- package/dist/types/client/events/group.d.ts +2 -1
- package/dist/types/client/events/identity.d.ts +2 -1
- package/dist/types/client/events/incoming.d.ts +65 -0
- package/dist/types/client/events/mex-notification.d.ts +6 -0
- package/dist/types/client/events/picture.d.ts +8 -0
- package/dist/types/client/events/presence.d.ts +28 -0
- package/dist/types/client/events/receipt.d.ts +14 -0
- package/dist/types/client/events/registration.d.ts +18 -0
- package/dist/types/client/index.d.ts +1 -1
- package/dist/types/client/media.d.ts +65 -0
- package/dist/types/client/messaging/fanout.d.ts +2 -2
- package/dist/types/client/messaging/group-metadata.d.ts +19 -0
- package/dist/types/client/messaging/ignore-key.d.ts +11 -0
- package/dist/types/client/messaging/key-protocol.d.ts +9 -7
- package/dist/types/client/messaging/link-preview.d.ts +19 -0
- package/dist/types/client/messaging/messages.d.ts +28 -0
- package/dist/types/client/newsletter/admin.d.ts +71 -0
- package/dist/types/client/newsletter/content.d.ts +42 -0
- package/dist/types/client/newsletter/discovery.d.ts +33 -0
- package/dist/types/client/newsletter/messaging.d.ts +66 -0
- package/dist/types/client/newsletter/mex.d.ts +14 -0
- package/dist/types/client/newsletter/parse.d.ts +19 -0
- package/dist/types/client/newsletter/types.d.ts +190 -0
- package/dist/types/client/persistence/WriteBehindPersistence.d.ts +13 -2
- package/dist/types/client/persistence/history-sync.d.ts +29 -0
- package/dist/types/client/persistence/mailbox.d.ts +12 -0
- package/dist/types/client/tokens/cs-token.d.ts +1 -3
- package/dist/types/client/types.d.ts +926 -55
- package/dist/types/crypto/core/hkdf.d.ts +10 -2
- package/dist/types/crypto/core/index.d.ts +3 -2
- package/dist/types/crypto/core/keys.d.ts +0 -4
- package/dist/types/crypto/core/nonce.d.ts +4 -5
- package/dist/types/crypto/core/primitives.d.ts +31 -20
- package/dist/types/crypto/core/random.d.ts +7 -1
- package/dist/types/crypto/core/xeddsa.d.ts +11 -0
- package/dist/types/crypto/curves/Ed25519.d.ts +7 -1
- package/dist/types/crypto/curves/X25519.d.ts +20 -1
- package/dist/types/crypto/curves/constants.d.ts +4 -2
- package/dist/types/crypto/curves/types.d.ts +0 -5
- package/dist/types/crypto/index.d.ts +1 -0
- package/dist/types/crypto/math/constants.d.ts +0 -1
- package/dist/types/crypto/math/mod.d.ts +0 -1
- package/dist/types/index.d.ts +32 -5
- package/dist/types/infra/log/ConsoleLogger.d.ts +19 -2
- package/dist/types/infra/log/PinoLogger.d.ts +56 -2
- package/dist/types/infra/log/types.d.ts +6 -0
- package/dist/types/infra/perf/BackgroundQueue.d.ts +19 -0
- package/dist/types/infra/perf/StoreLock.d.ts +1 -0
- package/dist/types/media/constants.d.ts +9 -2
- package/dist/types/media/crypto/WaMediaCrypto.d.ts +59 -0
- package/dist/types/media/index.d.ts +7 -4
- package/dist/types/media/processor.d.ts +50 -0
- package/dist/types/media/sticker/sticker-pack.d.ts +6 -0
- package/dist/types/media/{WaMediaTransferClient.d.ts → transfer/WaMediaTransferClient.d.ts} +33 -12
- package/dist/types/media/transfer/conn.d.ts +7 -0
- package/dist/types/media/types.d.ts +10 -5
- package/dist/types/message/WaMessageClient.d.ts +14 -0
- package/dist/types/message/addons/link-preview/builder.d.ts +13 -0
- package/dist/types/message/addons/link-preview/detect.d.ts +5 -0
- package/dist/types/message/addons/link-preview/fetcher.d.ts +13 -0
- package/dist/types/message/addons/link-preview/types.d.ts +51 -0
- package/dist/types/message/context-info.d.ts +66 -0
- package/dist/types/message/crypto/addon-crypto.d.ts +78 -0
- package/dist/types/message/{icdc.d.ts → crypto/icdc.d.ts} +6 -6
- package/dist/types/message/{phash.d.ts → crypto/phash.d.ts} +1 -1
- package/dist/types/message/{reporting-token.d.ts → crypto/reporting-token.d.ts} +2 -2
- package/dist/types/message/{use-case-secret.d.ts → crypto/use-case-secret.d.ts} +17 -1
- package/dist/types/message/encode/content.d.ts +43 -0
- package/dist/types/message/{device-sent.d.ts → encode/device-sent.d.ts} +1 -1
- package/dist/types/message/encode/media-payload.d.ts +12 -0
- package/dist/types/message/index.d.ts +2 -2
- package/dist/types/message/kinds/bot.d.ts +31 -0
- package/dist/types/message/kinds/newsletter.d.ts +12 -0
- package/dist/types/message/kinds/sticker-pack.d.ts +6 -0
- package/dist/types/message/{ack.d.ts → primitives/ack.d.ts} +1 -1
- package/dist/types/message/primitives/incoming.d.ts +21 -0
- package/dist/types/message/primitives/peer-data-operation.d.ts +23 -0
- package/dist/types/message/types.d.ts +218 -28
- package/dist/types/mex.d.ts +2 -0
- package/dist/types/proto.d.ts +2 -2
- package/dist/types/protocol/abprops.d.ts +151 -0
- package/dist/types/protocol/appstate.d.ts +4 -49
- package/dist/types/protocol/auth.d.ts +2 -2
- package/dist/types/protocol/bot.d.ts +45 -0
- package/dist/types/protocol/browser.d.ts +9 -0
- package/dist/types/protocol/business.d.ts +21 -0
- package/dist/types/protocol/call.d.ts +44 -0
- package/dist/types/protocol/constants.d.ts +20 -3
- package/dist/types/protocol/defaults.d.ts +3 -0
- package/dist/types/protocol/email.d.ts +32 -0
- package/dist/types/protocol/group.d.ts +1 -1
- package/dist/types/protocol/index.d.ts +2 -1
- package/dist/types/protocol/jid.d.ts +79 -0
- package/dist/types/protocol/media.d.ts +21 -13
- package/dist/types/protocol/message.d.ts +4 -0
- package/dist/types/protocol/newsletter.d.ts +65 -0
- package/dist/types/protocol/nodes.d.ts +24 -0
- package/dist/types/protocol/notification.d.ts +22 -0
- package/dist/types/protocol/presence.d.ts +16 -0
- package/dist/types/protocol/status.d.ts +7 -0
- package/dist/types/protocol/stream.d.ts +1 -0
- package/dist/types/retry/codec.d.ts +5 -0
- package/dist/types/retry/index.d.ts +1 -1
- package/dist/types/retry/parse.d.ts +9 -0
- package/dist/types/retry/reason.d.ts +6 -1
- package/dist/types/retry/replay.d.ts +19 -5
- package/dist/types/retry/tracker.d.ts +10 -3
- package/dist/types/retry/types.d.ts +3 -8
- package/dist/types/signal/api/SignalDeviceSyncApi.d.ts +20 -0
- package/dist/types/signal/api/SignalDigestSyncApi.d.ts +13 -0
- package/dist/types/signal/api/SignalIdentitySyncApi.d.ts +12 -3
- package/dist/types/signal/api/SignalMissingPreKeysSyncApi.d.ts +8 -0
- package/dist/types/signal/api/SignalRotateKeyApi.d.ts +10 -0
- package/dist/types/signal/api/SignalSessionSyncApi.d.ts +13 -0
- package/dist/types/signal/api/codec.d.ts +20 -0
- package/dist/types/signal/api/constants.d.ts +1 -1
- package/dist/types/signal/api/prekeys.d.ts +4 -0
- package/dist/types/signal/{crypto → attestation}/WaAdvSignature.d.ts +2 -4
- package/dist/types/signal/attestation/constants.d.ts +4 -0
- package/dist/types/signal/constants.d.ts +7 -4
- package/dist/types/signal/encoding.d.ts +6 -62
- package/dist/types/signal/group/SenderKeyChain.d.ts +2 -2
- package/dist/types/signal/group/SenderKeyManager.d.ts +24 -2
- package/dist/types/signal/group/encoding.d.ts +25 -0
- package/dist/types/signal/index.d.ts +4 -1
- package/dist/types/signal/registration/encoding.d.ts +30 -0
- package/dist/types/signal/registration/keygen.d.ts +10 -0
- package/dist/types/signal/registration/utils.d.ts +7 -1
- package/dist/types/signal/session/SignalProtocol.d.ts +66 -2
- package/dist/types/signal/session/SignalRatchet.d.ts +2 -3
- package/dist/types/signal/session/SignalSerializer.d.ts +2 -1
- package/dist/types/signal/session/SignalSession.d.ts +0 -1
- package/dist/types/signal/session/encoding.d.ts +28 -0
- package/dist/types/signal/session/resolver.d.ts +18 -2
- package/dist/types/signal/types.d.ts +16 -4
- package/dist/types/store/cache/identity.cache.d.ts +15 -0
- package/dist/types/store/cache/privacy-token.cache.d.ts +15 -0
- package/dist/types/store/cache/sender-key.cache.d.ts +18 -0
- package/dist/types/store/cache/session.cache.d.ts +23 -0
- package/dist/types/store/contracts/contact.store.d.ts +14 -0
- package/dist/types/store/contracts/device-list.store.d.ts +13 -0
- package/dist/types/store/contracts/group-metadata.store.d.ts +14 -0
- package/dist/types/store/contracts/identity.store.d.ts +11 -0
- package/dist/types/store/contracts/message-secret.store.d.ts +16 -0
- package/dist/types/store/contracts/message.store.d.ts +0 -2
- package/dist/types/store/contracts/pre-key.store.d.ts +13 -0
- package/dist/types/store/contracts/session.store.d.ts +14 -0
- package/dist/types/store/contracts/signal.store.d.ts +1 -34
- package/dist/types/store/createStore.d.ts +54 -2
- package/dist/types/store/index.d.ts +22 -13
- package/dist/types/store/locks/group-metadata.lock.d.ts +2 -0
- package/dist/types/store/locks/identity.lock.d.ts +3 -0
- package/dist/types/store/locks/message-secret.lock.d.ts +3 -0
- package/dist/types/store/locks/pre-key.lock.d.ts +3 -0
- package/dist/types/store/locks/session.lock.d.ts +3 -0
- package/dist/types/store/{providers/memory → memory}/appstate.store.d.ts +2 -2
- package/dist/types/store/memory/auth.store.d.ts +18 -0
- package/dist/types/store/{providers/memory → memory}/contact.store.d.ts +6 -1
- package/dist/types/store/{providers/memory → memory}/device-list.store.d.ts +15 -2
- package/dist/types/store/memory/group-metadata.store.d.ts +27 -0
- package/dist/types/store/memory/identity.store.d.ts +18 -0
- package/dist/types/store/memory/message-secret.store.d.ts +31 -0
- package/dist/types/store/{providers/memory → memory}/message.store.d.ts +1 -1
- package/dist/types/store/memory/pre-key.store.d.ts +23 -0
- package/dist/types/store/{providers/memory → memory}/privacy-token.store.d.ts +1 -1
- package/dist/types/store/{providers/memory → memory}/retry.store.d.ts +23 -4
- package/dist/types/store/{providers/memory → memory}/sender-key.store.d.ts +2 -2
- package/dist/types/store/memory/session.store.d.ts +21 -0
- package/dist/types/store/memory/signal.store.d.ts +16 -0
- package/dist/types/store/{providers/memory → memory}/thread.store.d.ts +1 -1
- package/dist/types/store/noop.store.d.ts +6 -2
- package/dist/types/store/types.d.ts +271 -7
- package/dist/types/transport/WaComms.d.ts +5 -0
- package/dist/types/transport/WaWebSocket.d.ts +6 -0
- package/dist/types/transport/binary/constants.d.ts +8 -2
- package/dist/types/transport/binary/decoder.d.ts +5 -0
- package/dist/types/transport/binary/encoder.d.ts +5 -0
- package/dist/types/transport/binary/tokens.d.ts +6 -6
- package/dist/types/transport/index.d.ts +9 -0
- package/dist/types/transport/keepalive/WaKeepAlive.d.ts +11 -1
- package/dist/types/transport/node/WaMobileTcpSocket.d.ts +24 -0
- package/dist/types/transport/node/WaNodeOrchestrator.d.ts +11 -2
- package/dist/types/transport/node/WaNodeTransport.d.ts +13 -0
- package/dist/types/transport/node/builders/abprops.d.ts +5 -0
- package/dist/types/transport/node/builders/account-sync.d.ts +1 -2
- package/dist/types/transport/node/builders/bot.d.ts +4 -0
- package/dist/types/transport/node/builders/business.d.ts +21 -4
- package/dist/types/transport/node/builders/chatstate.d.ts +11 -0
- package/dist/types/transport/node/builders/community.d.ts +17 -0
- package/dist/types/transport/node/builders/device.d.ts +2 -0
- package/dist/types/transport/node/builders/email.d.ts +11 -0
- package/dist/types/transport/node/builders/group.d.ts +44 -2
- package/dist/types/transport/node/builders/message.d.ts +11 -6
- package/dist/types/transport/node/builders/newsletter.d.ts +73 -0
- package/dist/types/transport/node/builders/offline.d.ts +2 -0
- package/dist/types/transport/node/builders/passive.d.ts +3 -0
- package/dist/types/transport/node/builders/prekeys.d.ts +4 -3
- package/dist/types/transport/node/builders/presence.d.ts +13 -0
- package/dist/types/transport/node/builders/profile.d.ts +3 -0
- package/dist/types/transport/node/builders/tos.d.ts +12 -0
- package/dist/types/transport/node/builders/usync.d.ts +16 -0
- package/dist/types/transport/node/helpers.d.ts +3 -1
- package/dist/types/transport/node/mex/argo-decoder.d.ts +11 -0
- package/dist/types/transport/node/mex/client.d.ts +29 -0
- package/dist/types/transport/node/query.d.ts +19 -1
- package/dist/types/transport/node/usync.d.ts +3 -0
- package/dist/types/transport/noise/WaMobileClientPayload.d.ts +34 -0
- package/dist/types/transport/noise/WaNoiseCert.d.ts +12 -1
- package/dist/types/transport/noise/WaNoiseHandshake.d.ts +12 -6
- package/dist/types/transport/noise/WaNoiseSession.d.ts +1 -1
- package/dist/types/transport/noise/WaNoiseSocket.d.ts +12 -6
- package/dist/types/transport/noise/constants.d.ts +4 -5
- package/dist/types/transport/proxy.d.ts +5 -0
- package/dist/types/transport/types.d.ts +15 -0
- package/dist/types/transport/wa-web-version-fetcher.d.ts +44 -0
- package/dist/types/util/async.d.ts +4 -0
- package/dist/types/util/bytes.d.ts +36 -1
- package/dist/types/util/clock.d.ts +6 -0
- package/dist/types/util/coercion.d.ts +25 -0
- package/dist/types/util/collections.d.ts +8 -0
- package/dist/types/util/index.d.ts +2 -2
- package/dist/types/util/primitives.d.ts +11 -0
- package/dist/types/util/runtime.d.ts +5 -0
- package/dist/types/version-spec.d.ts +1 -0
- package/dist/util/async.js +4 -0
- package/dist/util/bytes.js +37 -2
- package/dist/util/clock.js +18 -0
- package/dist/util/coercion.js +48 -3
- package/dist/util/collections.js +12 -0
- package/dist/util/index.js +7 -1
- package/dist/util/primitives.js +20 -0
- package/dist/util/runtime.js +5 -0
- package/dist/version-spec.js +5 -0
- package/package.json +37 -11
- package/spec/appstate/index.d.ts +188 -0
- package/spec/appstate/index.js +850 -0
- package/spec/mex/index.d.ts +4172 -0
- package/spec/mex/index.js +261 -0
- package/spec/proto/index.d.ts +16305 -0
- package/spec/proto/index.js +1 -0
- package/spec/version/index.d.ts +4 -0
- package/spec/version/index.js +9 -0
- package/spec/version/version.json +3 -0
- package/dist/auth/flow/WaAuthCredentialsFlow.js +0 -130
- package/dist/auth/pairing/WaPairingCodeCrypto.js +0 -77
- package/dist/auth/pairing/constants.js +0 -5
- package/dist/client/connection/WaKeyShareCoordinator.js +0 -63
- package/dist/client/events/chat.js +0 -227
- package/dist/client/incoming.js +0 -269
- package/dist/client/mailbox.js +0 -50
- package/dist/client/messages.js +0 -228
- package/dist/esm/auth/flow/WaAuthCredentialsFlow.js +0 -125
- package/dist/esm/auth/pairing/WaPairingCodeCrypto.js +0 -73
- package/dist/esm/auth/pairing/constants.js +0 -2
- package/dist/esm/client/connection/WaKeyShareCoordinator.js +0 -59
- package/dist/esm/client/events/chat.js +0 -224
- package/dist/esm/client/incoming.js +0 -260
- package/dist/esm/client/mailbox.js +0 -47
- package/dist/esm/client/messages.js +0 -224
- package/dist/esm/media/WaMediaCrypto.js +0 -304
- package/dist/esm/message/addon-crypto.js +0 -59
- package/dist/esm/message/incoming.js +0 -325
- package/dist/esm/message/phash.js +0 -27
- package/dist/esm/signal/crypto/WaAdvSignature.js +0 -64
- package/dist/esm/store/locks/participants.lock.js +0 -20
- package/dist/esm/store/providers/memory/contact.store.js +0 -28
- package/dist/esm/store/providers/memory/device-list.store.js +0 -64
- package/dist/esm/store/providers/memory/signal.store.js +0 -199
- package/dist/esm/transport/node/builders/index.js +0 -11
- package/dist/media/WaMediaCrypto.js +0 -308
- package/dist/message/addon-crypto.js +0 -65
- package/dist/message/phash.js +0 -30
- package/dist/signal/crypto/WaAdvSignature.js +0 -76
- package/dist/store/locks/participants.lock.js +0 -23
- package/dist/store/providers/memory/contact.store.js +0 -32
- package/dist/store/providers/memory/device-list.store.js +0 -68
- package/dist/store/providers/memory/signal.store.js +0 -203
- package/dist/transport/node/builders/index.js +0 -51
- package/dist/types/appstate/WaAppStateSyncClient.d.ts +0 -66
- package/dist/types/auth/flow/WaAuthCredentialsFlow.d.ts +0 -14
- package/dist/types/auth/pairing/constants.d.ts +0 -2
- package/dist/types/client/connection/WaKeyShareCoordinator.d.ts +0 -14
- package/dist/types/client/events/chat.d.ts +0 -3
- package/dist/types/client/history-sync.d.ts +0 -20
- package/dist/types/client/incoming.d.ts +0 -37
- package/dist/types/client/mailbox.d.ts +0 -10
- package/dist/types/client/messages.d.ts +0 -16
- package/dist/types/client/messaging/participants.d.ts +0 -13
- package/dist/types/media/WaMediaCrypto.d.ts +0 -13
- package/dist/types/media/conn.d.ts +0 -3
- package/dist/types/message/addon-crypto.d.ts +0 -25
- package/dist/types/message/content.d.ts +0 -12
- package/dist/types/message/incoming.d.ts +0 -18
- package/dist/types/signal/crypto/constants.d.ts +0 -5
- package/dist/types/store/contracts/participants.store.d.ts +0 -13
- package/dist/types/store/locks/participants.lock.d.ts +0 -2
- package/dist/types/store/providers/memory/participants.store.d.ts +0 -17
- package/dist/types/store/providers/memory/signal.store.d.ts +0 -58
- package/dist/types/transport/node/builders/index.d.ts +0 -11
- package/proto/index.d.ts +0 -10903
- package/proto/index.js +0 -1
- /package/dist/{store/contracts/participants.store.js → client/newsletter/types.js} +0 -0
- /package/dist/esm/{store/contracts/participants.store.js → client/newsletter/types.js} +0 -0
- /package/dist/esm/message/{device-sent.js → encode/device-sent.js} +0 -0
- /package/dist/message/{device-sent.js → encode/device-sent.js} +0 -0
- /package/dist/types/message/{padding.d.ts → encode/padding.d.ts} +0 -0
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.WA_APPSTATE_SCHEMA_BY_ACTION_NAME = exports.WA_APPSTATE_SCHEMAS = exports.WA_APPSTATE_COLLECTIONS = void 0;
|
|
4
|
+
exports.getAppstateSchemaByActionName = getAppstateSchemaByActionName;
|
|
5
|
+
exports.resolveEnumObject = resolveEnumObject;
|
|
6
|
+
exports.encodeEnumValue = encodeEnumValue;
|
|
7
|
+
exports.decodeEnumValue = decodeEnumValue;
|
|
8
|
+
exports.decodeIndexArgsFromSchema = decodeIndexArgsFromSchema;
|
|
9
|
+
const _proto_1 = require("./proto.js");
|
|
10
|
+
const appstate_1 = require("../spec/appstate");
|
|
11
|
+
var appstate_2 = require("../spec/appstate");
|
|
12
|
+
Object.defineProperty(exports, "WA_APPSTATE_COLLECTIONS", { enumerable: true, get: function () { return appstate_2.WA_APPSTATE_COLLECTIONS; } });
|
|
13
|
+
Object.defineProperty(exports, "WA_APPSTATE_SCHEMAS", { enumerable: true, get: function () { return appstate_2.WA_APPSTATE_SCHEMAS; } });
|
|
14
|
+
const SCHEMA_BY_ACTION_NAME_BUILDER = {};
|
|
15
|
+
for (const key of Object.keys(appstate_1.WA_APPSTATE_SCHEMAS)) {
|
|
16
|
+
SCHEMA_BY_ACTION_NAME_BUILDER[appstate_1.WA_APPSTATE_SCHEMAS[key].name] = key;
|
|
17
|
+
}
|
|
18
|
+
exports.WA_APPSTATE_SCHEMA_BY_ACTION_NAME = Object.freeze(SCHEMA_BY_ACTION_NAME_BUILDER);
|
|
19
|
+
function getAppstateSchemaByActionName(actionName) {
|
|
20
|
+
const key = exports.WA_APPSTATE_SCHEMA_BY_ACTION_NAME[actionName];
|
|
21
|
+
if (!key) {
|
|
22
|
+
return null;
|
|
23
|
+
}
|
|
24
|
+
return { key, schema: appstate_1.WA_APPSTATE_SCHEMAS[key] };
|
|
25
|
+
}
|
|
26
|
+
function resolveEnumObject(protoEnumPath) {
|
|
27
|
+
const segments = protoEnumPath.split('.');
|
|
28
|
+
let cursor = _proto_1.proto.SyncActionValue;
|
|
29
|
+
for (const seg of segments) {
|
|
30
|
+
if (cursor === null || cursor === undefined)
|
|
31
|
+
return null;
|
|
32
|
+
if (typeof cursor !== 'object' && typeof cursor !== 'function')
|
|
33
|
+
return null;
|
|
34
|
+
cursor = cursor[seg];
|
|
35
|
+
}
|
|
36
|
+
if (cursor === null || cursor === undefined)
|
|
37
|
+
return null;
|
|
38
|
+
if (typeof cursor !== 'object' && typeof cursor !== 'function')
|
|
39
|
+
return null;
|
|
40
|
+
return cursor;
|
|
41
|
+
}
|
|
42
|
+
function encodeEnumValue(protoEnumPath, name) {
|
|
43
|
+
const enumObj = resolveEnumObject(protoEnumPath);
|
|
44
|
+
if (!enumObj)
|
|
45
|
+
return null;
|
|
46
|
+
const value = enumObj[name];
|
|
47
|
+
return typeof value === 'number' ? value : null;
|
|
48
|
+
}
|
|
49
|
+
function decodeEnumValue(protoEnumPath, value) {
|
|
50
|
+
const enumObj = resolveEnumObject(protoEnumPath);
|
|
51
|
+
if (!enumObj)
|
|
52
|
+
return null;
|
|
53
|
+
for (const key of Object.keys(enumObj)) {
|
|
54
|
+
if (enumObj[key] === value)
|
|
55
|
+
return key;
|
|
56
|
+
}
|
|
57
|
+
return null;
|
|
58
|
+
}
|
|
59
|
+
function decodeIndexArgsFromSchema(schema, parts) {
|
|
60
|
+
if (parts.length !== schema.indexParts.length) {
|
|
61
|
+
return null;
|
|
62
|
+
}
|
|
63
|
+
const args = {};
|
|
64
|
+
for (let i = 0; i < schema.indexParts.length; i += 1) {
|
|
65
|
+
const part = schema.indexParts[i];
|
|
66
|
+
const raw = parts[i];
|
|
67
|
+
if (part.type === 'literal') {
|
|
68
|
+
continue;
|
|
69
|
+
}
|
|
70
|
+
if (part.type === 'boolString') {
|
|
71
|
+
if (raw !== '0' && raw !== '1')
|
|
72
|
+
return null;
|
|
73
|
+
args[part.name] = raw === '1';
|
|
74
|
+
continue;
|
|
75
|
+
}
|
|
76
|
+
if (part.type === 'jidOrZero') {
|
|
77
|
+
args[part.name] = raw === '0' ? null : raw;
|
|
78
|
+
continue;
|
|
79
|
+
}
|
|
80
|
+
if (part.type === 'enum') {
|
|
81
|
+
const numeric = Number(raw);
|
|
82
|
+
const name = Number.isFinite(numeric) ? decodeEnumValue(part.protoEnum, numeric) : null;
|
|
83
|
+
args[part.name] = name ?? raw;
|
|
84
|
+
continue;
|
|
85
|
+
}
|
|
86
|
+
args[part.name] = raw;
|
|
87
|
+
}
|
|
88
|
+
return args;
|
|
89
|
+
}
|
|
@@ -1,15 +1,25 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
3
|
exports.WaAuthClient = void 0;
|
|
4
|
-
const
|
|
4
|
+
const credentials_flow_1 = require("./credentials-flow");
|
|
5
5
|
const WaPairingFlow_1 = require("./pairing/WaPairingFlow");
|
|
6
6
|
const WaQrFlow_1 = require("./pairing/WaQrFlow");
|
|
7
7
|
const constants_1 = require("../protocol/constants");
|
|
8
8
|
const bytes_1 = require("../util/bytes");
|
|
9
9
|
const primitives_1 = require("../util/primitives");
|
|
10
10
|
const runtime_1 = require("../util/runtime");
|
|
11
|
+
/**
|
|
12
|
+
* Owns the auth/pairing lifecycle and persistence of {@link WaAuthCredentials}.
|
|
13
|
+
* Exposed as `client.auth` on a {@link WaClient}.
|
|
14
|
+
*
|
|
15
|
+
* Lifecycle: construct with options + dependencies, call
|
|
16
|
+
* {@link loadOrCreateCredentials} to bring credentials online, then either
|
|
17
|
+
* follow the QR flow (`onQr` callback) or call {@link requestPairingCode} for
|
|
18
|
+
* the link-code flow.
|
|
19
|
+
*/
|
|
11
20
|
class WaAuthClient {
|
|
12
21
|
constructor(options, deps) {
|
|
22
|
+
this.versionOverride = null;
|
|
13
23
|
const deviceBrowser = options.deviceBrowser ?? constants_1.WA_DEFAULTS.DEVICE_BROWSER;
|
|
14
24
|
const device = Object.freeze({
|
|
15
25
|
browser: deviceBrowser,
|
|
@@ -27,6 +37,8 @@ class WaAuthClient {
|
|
|
27
37
|
this.callbacks = deps.callbacks ?? {};
|
|
28
38
|
this.authStore = deps.authStore;
|
|
29
39
|
this.signalStore = deps.signalStore;
|
|
40
|
+
this.preKeyStore = deps.preKeyStore;
|
|
41
|
+
this.isConnected = deps.isConnected;
|
|
30
42
|
this.credentials = null;
|
|
31
43
|
this.qrFlow = new WaQrFlow_1.WaQrFlow({
|
|
32
44
|
logger: this.logger,
|
|
@@ -47,9 +59,14 @@ class WaAuthClient {
|
|
|
47
59
|
emitPairingCode: (code) => this.callbacks.onPairingCode?.(code),
|
|
48
60
|
emitPairingRefresh: (forceManual) => this.callbacks.onPairingRefresh?.(forceManual),
|
|
49
61
|
emitPaired: (credentials) => this.callbacks.onPaired?.(credentials)
|
|
50
|
-
}
|
|
62
|
+
},
|
|
63
|
+
dangerous: options.dangerous
|
|
51
64
|
});
|
|
52
65
|
}
|
|
66
|
+
/**
|
|
67
|
+
* Returns a snapshot of auth readiness flags (connection, registration,
|
|
68
|
+
* pending QR/pairing prompts).
|
|
69
|
+
*/
|
|
53
70
|
getState(connected = false) {
|
|
54
71
|
return {
|
|
55
72
|
connected,
|
|
@@ -58,16 +75,23 @@ class WaAuthClient {
|
|
|
58
75
|
hasPairingCode: this.pairingFlow.hasPairingSession()
|
|
59
76
|
};
|
|
60
77
|
}
|
|
78
|
+
/** Returns the currently-loaded credentials, or `null` before initialization. */
|
|
61
79
|
getCurrentCredentials() {
|
|
62
80
|
return this.credentials;
|
|
63
81
|
}
|
|
82
|
+
/**
|
|
83
|
+
* Loads persisted credentials from the auth store, or generates a fresh
|
|
84
|
+
* set when none exist. Must be called before connecting.
|
|
85
|
+
*/
|
|
64
86
|
async loadOrCreateCredentials() {
|
|
65
87
|
return this.runHandled(async () => {
|
|
66
88
|
this.logger.debug('auth client loadOrCreateCredentials start');
|
|
67
|
-
this.credentials = await (0,
|
|
89
|
+
this.credentials = await (0, credentials_flow_1.loadOrCreateCredentials)({
|
|
68
90
|
logger: this.logger,
|
|
69
91
|
authStore: this.authStore,
|
|
70
|
-
signalStore: this.signalStore
|
|
92
|
+
signalStore: this.signalStore,
|
|
93
|
+
preKeyStore: this.preKeyStore,
|
|
94
|
+
skipSignedPreKeySignatureVerification: this.options.dangerous?.disableSignedPreKeySignatureVerification
|
|
71
95
|
});
|
|
72
96
|
this.logger.info('auth client credentials ready', {
|
|
73
97
|
registered: this.credentials?.meJid !== null && this.credentials?.meJid !== undefined
|
|
@@ -75,25 +99,56 @@ class WaAuthClient {
|
|
|
75
99
|
return this.credentials;
|
|
76
100
|
});
|
|
77
101
|
}
|
|
78
|
-
|
|
102
|
+
/**
|
|
103
|
+
* Builds a {@link WaCommsConfig} from the current credentials and the
|
|
104
|
+
* runtime device/transport options – feeds {@link WaComms}.
|
|
105
|
+
*/
|
|
106
|
+
async buildCommsConfig(socketOptions, overrides = {}) {
|
|
79
107
|
this.logger.trace('auth client building comms config');
|
|
80
|
-
|
|
108
|
+
const override = this.versionOverride;
|
|
109
|
+
this.versionOverride = null;
|
|
110
|
+
return (0, credentials_flow_1.buildCommsConfig)(this.logger, this.requireCredentials(), socketOptions, {
|
|
81
111
|
deviceBrowser: this.options.deviceBrowser,
|
|
82
112
|
deviceOsDisplayName: this.options.deviceOsDisplayName,
|
|
83
113
|
requireFullSync: this.options.requireFullSync,
|
|
84
|
-
version: this.options.version
|
|
114
|
+
version: override ?? this.options.version,
|
|
115
|
+
mobileTransport: this.options.mobileTransport,
|
|
116
|
+
noiseTrustedRootCa: overrides.noiseTrustedRootCa,
|
|
117
|
+
disableNoiseCertificateChainVerification: overrides.disableNoiseCertificateChainVerification ??
|
|
118
|
+
this.options.dangerous?.disableNoiseCertificateChainVerification
|
|
85
119
|
});
|
|
86
120
|
}
|
|
121
|
+
/**
|
|
122
|
+
* One-shot override for the next {@link buildCommsConfig} call: takes
|
|
123
|
+
* precedence over the user-supplied `version` option, then clears. Used
|
|
124
|
+
* by the `recoverFromClientTooOld` auto-retry to inject a fresh version
|
|
125
|
+
* string fetched from `web.whatsapp.com` without mutating the user's
|
|
126
|
+
* options.
|
|
127
|
+
*/
|
|
128
|
+
setNextConnectVersion(version) {
|
|
129
|
+
this.versionOverride = version;
|
|
130
|
+
}
|
|
131
|
+
/** Clears the in-memory QR and pairing sessions without touching storage. */
|
|
132
|
+
// eslint-disable-next-line @typescript-eslint/require-await
|
|
87
133
|
async clearTransientState() {
|
|
88
134
|
this.logger.trace('auth client clear transient state');
|
|
89
135
|
this.qrFlow.clear();
|
|
90
136
|
this.pairingFlow.clearSession();
|
|
91
137
|
}
|
|
138
|
+
/**
|
|
139
|
+
* Wipes credentials from memory **and** from the auth store. Does
|
|
140
|
+
* **not** touch the other store domains (signal, app-state, ...) -
|
|
141
|
+
* those are cleared separately when {@link WaClient.logout} triggers
|
|
142
|
+
* the server-side logout path, honoring `options.logoutStoreClear`.
|
|
143
|
+
* Call this manually only when you want to force a re-pair without
|
|
144
|
+
* going through the server logout IQ.
|
|
145
|
+
*/
|
|
92
146
|
async clearStoredCredentials() {
|
|
93
147
|
this.logger.warn('auth client clearing stored credentials');
|
|
94
148
|
this.credentials = null;
|
|
95
149
|
await Promise.all([this.authStore.clear(), this.clearTransientState()]);
|
|
96
150
|
}
|
|
151
|
+
/** Stores the server's noise static key for subsequent handshakes. */
|
|
97
152
|
async persistServerStaticKey(serverStaticKey) {
|
|
98
153
|
this.logger.debug('persisting server static key', {
|
|
99
154
|
keyLength: serverStaticKey.byteLength
|
|
@@ -103,6 +158,7 @@ class WaAuthClient {
|
|
|
103
158
|
serverStaticKey
|
|
104
159
|
}));
|
|
105
160
|
}
|
|
161
|
+
/** Stores the "server holds prekeys" flag; persists only when the value changes. */
|
|
106
162
|
async persistServerHasPreKeys(serverHasPreKeys) {
|
|
107
163
|
await this.patchCredentials((credentials) => ({
|
|
108
164
|
...credentials,
|
|
@@ -116,6 +172,10 @@ class WaAuthClient {
|
|
|
116
172
|
}
|
|
117
173
|
});
|
|
118
174
|
}
|
|
175
|
+
/**
|
|
176
|
+
* Stores the routing-info blob received from the server. Skips persistence
|
|
177
|
+
* when the value matches the one already on disk.
|
|
178
|
+
*/
|
|
119
179
|
async persistRoutingInfo(routingInfo) {
|
|
120
180
|
this.logger.trace('persisting routing info', {
|
|
121
181
|
byteLength: routingInfo.byteLength
|
|
@@ -133,6 +193,7 @@ class WaAuthClient {
|
|
|
133
193
|
}
|
|
134
194
|
});
|
|
135
195
|
}
|
|
196
|
+
/** Clears the persisted routing-info blob (used after a routing error). */
|
|
136
197
|
async clearRoutingInfo() {
|
|
137
198
|
return this.patchCredentials((credentials) => ({
|
|
138
199
|
...credentials,
|
|
@@ -144,6 +205,11 @@ class WaAuthClient {
|
|
|
144
205
|
}
|
|
145
206
|
});
|
|
146
207
|
}
|
|
208
|
+
/**
|
|
209
|
+
* Persists the per-connection success attributes from the server (LID,
|
|
210
|
+
* display name, companion key, last-success ts, props versions, ...). Only
|
|
211
|
+
* persists when at least one attribute actually changed.
|
|
212
|
+
*/
|
|
147
213
|
async persistSuccessAttributes(attributes) {
|
|
148
214
|
let persistDiff;
|
|
149
215
|
const computeDiff = (current, next) => ({
|
|
@@ -180,24 +246,56 @@ class WaAuthClient {
|
|
|
180
246
|
}
|
|
181
247
|
});
|
|
182
248
|
}
|
|
183
|
-
|
|
249
|
+
/**
|
|
250
|
+
* Requests an 8-character pairing code for `phoneNumber` (link-code flow).
|
|
251
|
+
* Pass `customCode` to suggest a specific code; the server still validates
|
|
252
|
+
* and may return a different one.
|
|
253
|
+
*
|
|
254
|
+
* The client must already be connected – kick off `WaClient.connect()` in
|
|
255
|
+
* parallel, wait for the `auth_pairing_required` event (or any QR), then
|
|
256
|
+
* call this. The user then enters the returned code in WhatsApp on their
|
|
257
|
+
* phone under *Linked Devices → Link with phone number instead*.
|
|
258
|
+
*
|
|
259
|
+
* @example
|
|
260
|
+
* ```ts
|
|
261
|
+
* // Start the handshake; do NOT await – connect() resolves only after pairing
|
|
262
|
+
* void client.connect()
|
|
263
|
+
*
|
|
264
|
+
* // Wait until the pairing screen is ready on the server side
|
|
265
|
+
* await new Promise<void>((resolve) => client.once('auth_pairing_required', () => resolve()))
|
|
266
|
+
*
|
|
267
|
+
* // Phone number in international format, digits only
|
|
268
|
+
* const code = await client.auth.requestPairingCode('5511999999999')
|
|
269
|
+
* console.log(`enter this on your phone: ${code.match(/.{1,4}/g)!.join('-')}`)
|
|
270
|
+
*
|
|
271
|
+
* // The `connect()` promise resolves after the user types the code:
|
|
272
|
+
* await new Promise<void>((resolve) => client.once('auth_paired', () => resolve()))
|
|
273
|
+
* ```
|
|
274
|
+
*/
|
|
275
|
+
async requestPairingCode(phoneNumber, shouldShowPushNotification = true, customCode) {
|
|
276
|
+
this.requireConnected();
|
|
184
277
|
this.requireCredentials();
|
|
185
|
-
this.logger.
|
|
186
|
-
return this.runHandled(() => this.pairingFlow.requestPairingCode(phoneNumber, shouldShowPushNotification));
|
|
278
|
+
this.logger.debug('auth client requesting pairing code');
|
|
279
|
+
return this.runHandled(() => this.pairingFlow.requestPairingCode(phoneNumber, shouldShowPushNotification, customCode));
|
|
187
280
|
}
|
|
281
|
+
/** Fetches the ISO country code the server resolved for the current account. */
|
|
188
282
|
async fetchPairingCountryCodeIso() {
|
|
283
|
+
this.requireConnected();
|
|
189
284
|
this.requireCredentials();
|
|
190
285
|
this.logger.trace('auth client fetching pairing country code ISO');
|
|
191
286
|
return this.runHandled(() => this.pairingFlow.fetchPairingCountryCodeIso());
|
|
192
287
|
}
|
|
288
|
+
/** Dispatcher: returns `true` when `node` is a pairing-related IQ-set we handled. */
|
|
193
289
|
async handleIncomingIqSet(node) {
|
|
194
290
|
this.logger.trace('auth client handleIncomingIqSet', { id: node.attrs.id });
|
|
195
291
|
return this.runHandled(() => this.pairingFlow.handleIncomingIqSet(node));
|
|
196
292
|
}
|
|
293
|
+
/** Dispatcher: returns `true` when `node` is a link-code companion notification. */
|
|
197
294
|
async handleLinkCodeNotification(node) {
|
|
198
295
|
this.logger.trace('auth client handleLinkCodeNotification', { id: node.attrs.id });
|
|
199
296
|
return this.runHandled(() => this.pairingFlow.handleLinkCodeNotification(node));
|
|
200
297
|
}
|
|
298
|
+
/** Dispatcher: returns `true` when `node` is a companion-registration refresh notification. */
|
|
201
299
|
async handleCompanionRegRefreshNotification(node) {
|
|
202
300
|
this.logger.trace('auth client handleCompanionRegRefreshNotification', {
|
|
203
301
|
id: node.attrs.id
|
|
@@ -225,15 +323,21 @@ class WaAuthClient {
|
|
|
225
323
|
}
|
|
226
324
|
async updateCredentials(credentials) {
|
|
227
325
|
this.logger.trace('auth client update credentials', {
|
|
228
|
-
registered: credentials?.meJid
|
|
326
|
+
registered: !!credentials?.meJid
|
|
229
327
|
});
|
|
230
328
|
this.credentials = credentials;
|
|
231
|
-
await (0,
|
|
329
|
+
await (0, credentials_flow_1.persistCredentials)({
|
|
232
330
|
logger: this.logger,
|
|
233
331
|
authStore: this.authStore,
|
|
234
|
-
signalStore: this.signalStore
|
|
332
|
+
signalStore: this.signalStore,
|
|
333
|
+
preKeyStore: this.preKeyStore
|
|
235
334
|
}, credentials);
|
|
236
335
|
}
|
|
336
|
+
requireConnected() {
|
|
337
|
+
if (this.isConnected && !this.isConnected()) {
|
|
338
|
+
throw new Error('client is not connected');
|
|
339
|
+
}
|
|
340
|
+
}
|
|
237
341
|
requireCredentials() {
|
|
238
342
|
if (!this.credentials) {
|
|
239
343
|
throw new Error('credentials are not initialized');
|
|
@@ -0,0 +1,207 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.loadOrCreateCredentials = loadOrCreateCredentials;
|
|
4
|
+
exports.persistCredentials = persistCredentials;
|
|
5
|
+
exports.buildCommsConfig = buildCommsConfig;
|
|
6
|
+
const _crypto_1 = require("../crypto/index.js");
|
|
7
|
+
const keys_1 = require("../crypto/core/keys");
|
|
8
|
+
const X25519_1 = require("../crypto/curves/X25519");
|
|
9
|
+
const jid_1 = require("../protocol/jid");
|
|
10
|
+
const _signal_1 = require("../signal/index.js");
|
|
11
|
+
const WaMobileTcpSocket_1 = require("../transport/node/WaMobileTcpSocket");
|
|
12
|
+
const WaMobileClientPayload_1 = require("../transport/noise/WaMobileClientPayload");
|
|
13
|
+
const proxy_1 = require("../transport/proxy");
|
|
14
|
+
const primitives_1 = require("../util/primitives");
|
|
15
|
+
async function loadOrCreateCredentials(args) {
|
|
16
|
+
args.logger.trace('auth credentials loadOrCreate start');
|
|
17
|
+
const existing = await args.authStore.load();
|
|
18
|
+
if (!existing) {
|
|
19
|
+
const credentials = await createFreshAndPersistCredentials(args);
|
|
20
|
+
args.logger.info('created fresh auth credentials');
|
|
21
|
+
return credentials;
|
|
22
|
+
}
|
|
23
|
+
args.logger.debug('auth credentials loaded from store', {
|
|
24
|
+
registered: existing.meJid !== null && existing.meJid !== undefined,
|
|
25
|
+
hasServerStaticKey: existing.serverStaticKey !== null && existing.serverStaticKey !== undefined
|
|
26
|
+
});
|
|
27
|
+
const skipSignedPreKeyCheck = args.skipSignedPreKeySignatureVerification === true;
|
|
28
|
+
if (!existing.meJid &&
|
|
29
|
+
!skipSignedPreKeyCheck &&
|
|
30
|
+
!(await hasValidSignedPreKey(args.logger, existing))) {
|
|
31
|
+
args.logger.warn('signed pre-key is invalid, regenerating credentials');
|
|
32
|
+
const fresh = await createFreshAndPersistCredentials(args);
|
|
33
|
+
args.logger.info('regenerated credentials due to invalid signed pre-key');
|
|
34
|
+
return fresh;
|
|
35
|
+
}
|
|
36
|
+
await restoreSignalStore(args.signalStore, args.preKeyStore, existing);
|
|
37
|
+
args.logger.trace('auth credentials restored into signal store');
|
|
38
|
+
return existing;
|
|
39
|
+
}
|
|
40
|
+
async function persistCredentials(args, credentials) {
|
|
41
|
+
args.logger.trace('persisting auth credentials', {
|
|
42
|
+
registered: credentials.meJid !== null && credentials.meJid !== undefined
|
|
43
|
+
});
|
|
44
|
+
await args.authStore.save(credentials);
|
|
45
|
+
}
|
|
46
|
+
function mobileTransportFromCredentials(credentials) {
|
|
47
|
+
if (!credentials.deviceInfo)
|
|
48
|
+
return undefined;
|
|
49
|
+
return {
|
|
50
|
+
deviceInfo: credentials.deviceInfo,
|
|
51
|
+
...(credentials.pushName !== undefined ? { pushName: credentials.pushName } : {}),
|
|
52
|
+
...(credentials.yearClass !== undefined ? { yearClass: credentials.yearClass } : {}),
|
|
53
|
+
...(credentials.memClass !== undefined ? { memClass: credentials.memClass } : {})
|
|
54
|
+
};
|
|
55
|
+
}
|
|
56
|
+
async function resolveVersion(version) {
|
|
57
|
+
if (version === undefined)
|
|
58
|
+
return undefined;
|
|
59
|
+
if (typeof version === 'string')
|
|
60
|
+
return version;
|
|
61
|
+
const resolved = await version();
|
|
62
|
+
if (typeof resolved !== 'string' || resolved.length === 0) {
|
|
63
|
+
throw new Error('version resolver returned a non-string value');
|
|
64
|
+
}
|
|
65
|
+
return resolved;
|
|
66
|
+
}
|
|
67
|
+
async function buildCommsConfig(logger, credentials, socketOptions, clientOptions) {
|
|
68
|
+
const meJid = credentials.meJid;
|
|
69
|
+
const registered = meJid !== null && meJid !== undefined;
|
|
70
|
+
const loginIdentity = registered ? (0, jid_1.getLoginIdentity)(meJid) : null;
|
|
71
|
+
const wsProxy = socketOptions.proxy?.ws;
|
|
72
|
+
// Resolve the effective mobile transport: explicit option wins, otherwise
|
|
73
|
+
// synthesize one from persisted credentials.deviceInfo so a registered
|
|
74
|
+
// mobile session boots in mobile mode without the caller re-passing
|
|
75
|
+
// deviceInfo on every `new WaClient(...)` call.
|
|
76
|
+
const effectiveMobileTransport = clientOptions.mobileTransport ?? mobileTransportFromCredentials(credentials);
|
|
77
|
+
logger.debug('building comms config from credentials', {
|
|
78
|
+
registered,
|
|
79
|
+
hasServerStaticKey: credentials.serverStaticKey !== null && credentials.serverStaticKey !== undefined,
|
|
80
|
+
mobile: Boolean(effectiveMobileTransport),
|
|
81
|
+
mobileSource: clientOptions.mobileTransport
|
|
82
|
+
? 'option'
|
|
83
|
+
: effectiveMobileTransport
|
|
84
|
+
? 'credentials'
|
|
85
|
+
: 'none'
|
|
86
|
+
});
|
|
87
|
+
if (effectiveMobileTransport) {
|
|
88
|
+
if (wsProxy) {
|
|
89
|
+
throw new Error('mobileTransport does not support socketOptions.proxy.ws – remove the proxy option or open an issue to add TCP proxy support');
|
|
90
|
+
}
|
|
91
|
+
if (!loginIdentity) {
|
|
92
|
+
throw new Error('mobileTransport requires registered credentials (meJid) – run the mobile bridge flow first');
|
|
93
|
+
}
|
|
94
|
+
const loginPayload = (0, WaMobileClientPayload_1.buildMobileLoginPayload)({
|
|
95
|
+
username: loginIdentity.username,
|
|
96
|
+
device: loginIdentity.device,
|
|
97
|
+
passive: effectiveMobileTransport.passive ?? false,
|
|
98
|
+
deviceInfo: effectiveMobileTransport.deviceInfo,
|
|
99
|
+
pushName: effectiveMobileTransport.pushName,
|
|
100
|
+
yearClass: effectiveMobileTransport.yearClass,
|
|
101
|
+
memClass: effectiveMobileTransport.memClass
|
|
102
|
+
});
|
|
103
|
+
return {
|
|
104
|
+
url: effectiveMobileTransport.tcpUrl ?? 'tcp://g.whatsapp.net:443',
|
|
105
|
+
rawWebSocketConstructor: WaMobileTcpSocket_1.WaMobileTcpSocketCtor,
|
|
106
|
+
connectTimeoutMs: socketOptions.connectTimeoutMs,
|
|
107
|
+
reconnectIntervalMs: socketOptions.reconnectIntervalMs,
|
|
108
|
+
timeoutIntervalMs: socketOptions.timeoutIntervalMs,
|
|
109
|
+
maxReconnectAttempts: socketOptions.maxReconnectAttempts,
|
|
110
|
+
noise: {
|
|
111
|
+
clientStaticKeyPair: credentials.noiseKeyPair,
|
|
112
|
+
isRegistered: true,
|
|
113
|
+
serverStaticKey: credentials.serverStaticKey,
|
|
114
|
+
routingInfo: credentials.routingInfo,
|
|
115
|
+
trustedRootCa: clientOptions.noiseTrustedRootCa,
|
|
116
|
+
verifyCertificateChain: clientOptions.disableNoiseCertificateChainVerification
|
|
117
|
+
? false
|
|
118
|
+
: undefined,
|
|
119
|
+
loginPayload
|
|
120
|
+
}
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
const versionBase = await resolveVersion(clientOptions.version);
|
|
124
|
+
return {
|
|
125
|
+
url: socketOptions.url,
|
|
126
|
+
urls: socketOptions.urls,
|
|
127
|
+
protocols: socketOptions.protocols,
|
|
128
|
+
dispatcher: (0, proxy_1.toProxyDispatcher)(wsProxy),
|
|
129
|
+
agent: (0, proxy_1.toProxyAgent)(wsProxy),
|
|
130
|
+
connectTimeoutMs: socketOptions.connectTimeoutMs,
|
|
131
|
+
reconnectIntervalMs: socketOptions.reconnectIntervalMs,
|
|
132
|
+
timeoutIntervalMs: socketOptions.timeoutIntervalMs,
|
|
133
|
+
maxReconnectAttempts: socketOptions.maxReconnectAttempts,
|
|
134
|
+
noise: {
|
|
135
|
+
clientStaticKeyPair: credentials.noiseKeyPair,
|
|
136
|
+
isRegistered: registered,
|
|
137
|
+
serverStaticKey: credentials.serverStaticKey,
|
|
138
|
+
routingInfo: credentials.routingInfo,
|
|
139
|
+
trustedRootCa: clientOptions.noiseTrustedRootCa,
|
|
140
|
+
verifyCertificateChain: clientOptions.disableNoiseCertificateChainVerification
|
|
141
|
+
? false
|
|
142
|
+
: undefined,
|
|
143
|
+
loginPayloadConfig: loginIdentity
|
|
144
|
+
? {
|
|
145
|
+
username: loginIdentity.username,
|
|
146
|
+
device: loginIdentity.device,
|
|
147
|
+
deviceBrowser: clientOptions.deviceBrowser,
|
|
148
|
+
deviceOsDisplayName: clientOptions.deviceOsDisplayName,
|
|
149
|
+
versionBase
|
|
150
|
+
}
|
|
151
|
+
: undefined,
|
|
152
|
+
registrationPayloadConfig: !loginIdentity
|
|
153
|
+
? {
|
|
154
|
+
registrationInfo: credentials.registrationInfo,
|
|
155
|
+
signedPreKey: credentials.signedPreKey,
|
|
156
|
+
deviceBrowser: clientOptions.deviceBrowser,
|
|
157
|
+
deviceOsDisplayName: clientOptions.deviceOsDisplayName,
|
|
158
|
+
requireFullSync: clientOptions.requireFullSync,
|
|
159
|
+
versionBase
|
|
160
|
+
}
|
|
161
|
+
: undefined
|
|
162
|
+
}
|
|
163
|
+
};
|
|
164
|
+
}
|
|
165
|
+
async function createFreshCredentials(signalStore, preKeyStore, logger) {
|
|
166
|
+
logger.trace('creating fresh credentials');
|
|
167
|
+
const [noiseKeyPair, registrationBundle, advSecretKey] = await Promise.all([
|
|
168
|
+
X25519_1.X25519.generateKeyPair(),
|
|
169
|
+
(0, _signal_1.createAndStoreInitialKeys)(signalStore, preKeyStore),
|
|
170
|
+
(0, _crypto_1.randomBytesAsync)(32)
|
|
171
|
+
]);
|
|
172
|
+
return {
|
|
173
|
+
noiseKeyPair,
|
|
174
|
+
registrationInfo: registrationBundle.registrationInfo,
|
|
175
|
+
signedPreKey: registrationBundle.signedPreKey,
|
|
176
|
+
serverHasPreKeys: false,
|
|
177
|
+
advSecretKey
|
|
178
|
+
};
|
|
179
|
+
}
|
|
180
|
+
async function createFreshAndPersistCredentials(args) {
|
|
181
|
+
const credentials = await createFreshCredentials(args.signalStore, args.preKeyStore, args.logger);
|
|
182
|
+
// Persist credentials first so signal restore never commits state for credentials that failed to save.
|
|
183
|
+
await args.authStore.save(credentials);
|
|
184
|
+
await restoreSignalStore(args.signalStore, args.preKeyStore, credentials);
|
|
185
|
+
return credentials;
|
|
186
|
+
}
|
|
187
|
+
async function hasValidSignedPreKey(logger, credentials) {
|
|
188
|
+
try {
|
|
189
|
+
const serializedPubKey = (0, keys_1.toSerializedPubKey)(credentials.signedPreKey.keyPair.pubKey);
|
|
190
|
+
const valid = await (0, _crypto_1.xeddsaVerify)((0, _crypto_1.toRawPubKey)(credentials.registrationInfo.identityKeyPair.pubKey), serializedPubKey, credentials.signedPreKey.signature);
|
|
191
|
+
logger.trace('signed pre-key validation completed', { valid });
|
|
192
|
+
return valid;
|
|
193
|
+
}
|
|
194
|
+
catch (error) {
|
|
195
|
+
logger.warn('signed pre-key validation failed with exception', {
|
|
196
|
+
message: (0, primitives_1.toError)(error).message
|
|
197
|
+
});
|
|
198
|
+
return false;
|
|
199
|
+
}
|
|
200
|
+
}
|
|
201
|
+
async function restoreSignalStore(signalStore, preKeyStore, credentials) {
|
|
202
|
+
await Promise.all([
|
|
203
|
+
signalStore.setRegistrationInfo(credentials.registrationInfo),
|
|
204
|
+
signalStore.setSignedPreKey(credentials.signedPreKey),
|
|
205
|
+
preKeyStore.setServerHasPreKeys(credentials.serverHasPreKeys === true)
|
|
206
|
+
]);
|
|
207
|
+
}
|