@nerxa/socketon 0.0.0-stage → 1.21.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.
Files changed (289) hide show
  1. package/EXPERIMENTAL.md +350 -0
  2. package/LICENSE +24 -0
  3. package/README.md +6317 -2
  4. package/WAProto/index.d.ts +17301 -0
  5. package/WAProto/index.js +125088 -0
  6. package/engine-requirements.js +14 -0
  7. package/package.json +100 -4
  8. package/src/Defaults/index.d.ts +152 -0
  9. package/src/Defaults/index.js +164 -0
  10. package/src/MessageBuilder/bot-signature.d.ts +22 -0
  11. package/src/MessageBuilder/bot-signature.js +122 -0
  12. package/src/MessageBuilder/extras.d.ts +449 -0
  13. package/src/MessageBuilder/extras.js +1356 -0
  14. package/src/MessageBuilder/index.d.ts +210 -0
  15. package/src/MessageBuilder/index.js +3594 -0
  16. package/src/MessageBuilder/metaai.d.ts +438 -0
  17. package/src/MessageBuilder/metaai.js +890 -0
  18. package/src/Signal/Group/ciphertext-message.d.ts +9 -0
  19. package/src/Signal/Group/ciphertext-message.js +11 -0
  20. package/src/Signal/Group/group-session-builder.d.ts +7 -0
  21. package/src/Signal/Group/group-session-builder.js +27 -0
  22. package/src/Signal/Group/group_cipher.d.ts +11 -0
  23. package/src/Signal/Group/group_cipher.js +78 -0
  24. package/src/Signal/Group/index.d.ts +11 -0
  25. package/src/Signal/Group/index.js +11 -0
  26. package/src/Signal/Group/keyhelper.d.ts +6 -0
  27. package/src/Signal/Group/keyhelper.js +17 -0
  28. package/src/Signal/Group/sender-chain-key.d.ts +13 -0
  29. package/src/Signal/Group/sender-chain-key.js +25 -0
  30. package/src/Signal/Group/sender-key-distribution-message.d.ts +16 -0
  31. package/src/Signal/Group/sender-key-distribution-message.js +62 -0
  32. package/src/Signal/Group/sender-key-message.d.ts +18 -0
  33. package/src/Signal/Group/sender-key-message.js +65 -0
  34. package/src/Signal/Group/sender-key-name.d.ts +11 -0
  35. package/src/Signal/Group/sender-key-name.js +47 -0
  36. package/src/Signal/Group/sender-key-record.d.ts +12 -0
  37. package/src/Signal/Group/sender-key-record.js +40 -0
  38. package/src/Signal/Group/sender-key-state.d.ts +16 -0
  39. package/src/Signal/Group/sender-key-state.js +83 -0
  40. package/src/Signal/Group/sender-message-key.d.ts +11 -0
  41. package/src/Signal/Group/sender-message-key.js +25 -0
  42. package/src/Signal/libsignal.d.ts +54 -0
  43. package/src/Signal/libsignal.js +427 -0
  44. package/src/Signal/lid-mapping.d.ts +20 -0
  45. package/src/Signal/lid-mapping.js +274 -0
  46. package/src/Socket/Client/index.d.ts +2 -0
  47. package/src/Socket/Client/index.js +3 -0
  48. package/src/Socket/Client/tcp.js +177 -0
  49. package/src/Socket/Client/types.d.ts +5 -0
  50. package/src/Socket/Client/types.js +9 -0
  51. package/src/Socket/Client/websocket.d.ts +12 -0
  52. package/src/Socket/Client/websocket.js +53 -0
  53. package/src/Socket/business.d.ts +431 -0
  54. package/src/Socket/business.js +379 -0
  55. package/src/Socket/chats.d.ts +247 -0
  56. package/src/Socket/chats.js +1484 -0
  57. package/src/Socket/communities.d.ts +598 -0
  58. package/src/Socket/communities.js +421 -0
  59. package/src/Socket/email.js +145 -0
  60. package/src/Socket/groups.d.ts +298 -0
  61. package/src/Socket/groups.js +339 -0
  62. package/src/Socket/index.d.ts +581 -0
  63. package/src/Socket/index.js +37 -0
  64. package/src/Socket/messages-recv.d.ts +370 -0
  65. package/src/Socket/messages-recv.js +1864 -0
  66. package/src/Socket/messages-send.d.ts +390 -0
  67. package/src/Socket/messages-send.js +1574 -0
  68. package/src/Socket/mex.d.ts +1 -0
  69. package/src/Socket/mex.js +44 -0
  70. package/src/Socket/mobile-builders.js +72 -0
  71. package/src/Socket/mobile.js +424 -0
  72. package/src/Socket/newsletter.d.ts +468 -0
  73. package/src/Socket/newsletter.js +671 -0
  74. package/src/Socket/socket.d.ts +77 -0
  75. package/src/Socket/socket.js +1106 -0
  76. package/src/Store/index.d.ts +3 -0
  77. package/src/Store/index.js +3 -0
  78. package/src/Store/make-in-memory-store.d.ts +62 -0
  79. package/src/Store/make-in-memory-store.js +396 -0
  80. package/src/Store/make-ordered-dictionary.d.ts +12 -0
  81. package/src/Store/make-ordered-dictionary.js +78 -0
  82. package/src/Store/object-repository.d.ts +10 -0
  83. package/src/Store/object-repository.js +23 -0
  84. package/src/Types/Auth.d.ts +1 -0
  85. package/src/Types/Auth.js +1 -0
  86. package/src/Types/Bussines.d.ts +1 -0
  87. package/src/Types/Bussines.js +1 -0
  88. package/src/Types/Call.d.ts +1 -0
  89. package/src/Types/Call.js +1 -0
  90. package/src/Types/Chat.d.ts +2 -0
  91. package/src/Types/Chat.js +24 -0
  92. package/src/Types/Contact.d.ts +1 -0
  93. package/src/Types/Contact.js +1 -0
  94. package/src/Types/Events.d.ts +1 -0
  95. package/src/Types/Events.js +0 -0
  96. package/src/Types/GroupMetadata.d.ts +5 -0
  97. package/src/Types/GroupMetadata.js +6 -0
  98. package/src/Types/Label.d.ts +2 -0
  99. package/src/Types/Label.js +24 -0
  100. package/src/Types/LabelAssociation.d.ts +2 -0
  101. package/src/Types/LabelAssociation.js +6 -0
  102. package/src/Types/Message.d.ts +13 -0
  103. package/src/Types/Message.js +23 -0
  104. package/src/Types/Mex.d.ts +2 -0
  105. package/src/Types/Mex.js +95 -0
  106. package/src/Types/Product.d.ts +1 -0
  107. package/src/Types/Product.js +1 -0
  108. package/src/Types/Signal.d.ts +1 -0
  109. package/src/Types/Signal.js +0 -0
  110. package/src/Types/Socket.d.ts +1 -0
  111. package/src/Types/Socket.js +0 -0
  112. package/src/Types/State.d.ts +5 -0
  113. package/src/Types/State.js +54 -0
  114. package/src/Types/USync.d.ts +1 -0
  115. package/src/Types/USync.js +0 -0
  116. package/src/Types/index.d.ts +13 -0
  117. package/src/Types/index.js +25 -0
  118. package/src/Utils/auth-store.d.ts +29 -0
  119. package/src/Utils/auth-store.js +76 -0
  120. package/src/Utils/auth-utils.d.ts +58 -0
  121. package/src/Utils/auth-utils.js +273 -0
  122. package/src/Utils/browser-utils.d.ts +9 -0
  123. package/src/Utils/browser-utils.js +28 -0
  124. package/src/Utils/business.d.ts +49 -0
  125. package/src/Utils/business.js +226 -0
  126. package/src/Utils/chat-utils.d.ts +408 -0
  127. package/src/Utils/chat-utils.js +846 -0
  128. package/src/Utils/companion-reg-client-utils.d.ts +4 -0
  129. package/src/Utils/companion-reg-client-utils.js +39 -0
  130. package/src/Utils/crypto.d.ts +39 -0
  131. package/src/Utils/crypto.js +110 -0
  132. package/src/Utils/decode-wa-message.d.ts +99 -0
  133. package/src/Utils/decode-wa-message.js +373 -0
  134. package/src/Utils/event-buffer.d.ts +22 -0
  135. package/src/Utils/event-buffer.js +624 -0
  136. package/src/Utils/generics.d.ts +63 -0
  137. package/src/Utils/generics.js +375 -0
  138. package/src/Utils/group-metadata-cache.d.ts +4 -0
  139. package/src/Utils/group-metadata-cache.js +25 -0
  140. package/src/Utils/history.d.ts +75 -0
  141. package/src/Utils/history.js +131 -0
  142. package/src/Utils/html-app.d.ts +19 -0
  143. package/src/Utils/html-app.js +96 -0
  144. package/src/Utils/html-multiplayer.d.ts +10 -0
  145. package/src/Utils/html-multiplayer.js +94 -0
  146. package/src/Utils/identity-change-handler.d.ts +13 -0
  147. package/src/Utils/identity-change-handler.js +48 -0
  148. package/src/Utils/index.d.ts +44 -0
  149. package/src/Utils/index.js +44 -0
  150. package/src/Utils/link-preview-metadata.d.ts +47 -0
  151. package/src/Utils/link-preview-metadata.js +88 -0
  152. package/src/Utils/link-preview.d.ts +12 -0
  153. package/src/Utils/link-preview.js +79 -0
  154. package/src/Utils/logger.d.ts +2 -0
  155. package/src/Utils/logger.js +2 -0
  156. package/src/Utils/lt-hash.d.ts +6 -0
  157. package/src/Utils/lt-hash.js +3 -0
  158. package/src/Utils/make-mutex.d.ts +6 -0
  159. package/src/Utils/make-mutex.js +32 -0
  160. package/src/Utils/message-retry-manager.d.ts +79 -0
  161. package/src/Utils/message-retry-manager.js +255 -0
  162. package/src/Utils/messages-media.d.ts +136 -0
  163. package/src/Utils/messages-media.js +814 -0
  164. package/src/Utils/messages.d.ts +62 -0
  165. package/src/Utils/messages.js +2223 -0
  166. package/src/Utils/mobile-companion-crypto.js +191 -0
  167. package/src/Utils/modern-messages.d.ts +150 -0
  168. package/src/Utils/modern-messages.js +496 -0
  169. package/src/Utils/native-flow.d.ts +11 -0
  170. package/src/Utils/native-flow.js +115 -0
  171. package/src/Utils/newsletter-status.d.ts +158 -0
  172. package/src/Utils/newsletter-status.js +651 -0
  173. package/src/Utils/noise-handler.d.ts +20 -0
  174. package/src/Utils/noise-handler.js +200 -0
  175. package/src/Utils/offline-node-processor.d.ts +9 -0
  176. package/src/Utils/offline-node-processor.js +33 -0
  177. package/src/Utils/optional-media.d.ts +3 -0
  178. package/src/Utils/optional-media.js +45 -0
  179. package/src/Utils/payment-messages.d.ts +66 -0
  180. package/src/Utils/payment-messages.js +160 -0
  181. package/src/Utils/pre-key-manager.d.ts +25 -0
  182. package/src/Utils/pre-key-manager.js +95 -0
  183. package/src/Utils/process-message.d.ts +60 -0
  184. package/src/Utils/process-message.js +688 -0
  185. package/src/Utils/reporting-utils.d.ts +12 -0
  186. package/src/Utils/reporting-utils.js +256 -0
  187. package/src/Utils/scheduled-message.d.ts +51 -0
  188. package/src/Utils/scheduled-message.js +112 -0
  189. package/src/Utils/sender-key-memory.d.ts +19 -0
  190. package/src/Utils/sender-key-memory.js +51 -0
  191. package/src/Utils/signal.d.ts +82 -0
  192. package/src/Utils/signal.js +193 -0
  193. package/src/Utils/stanza-ack.d.ts +16 -0
  194. package/src/Utils/stanza-ack.js +30 -0
  195. package/src/Utils/status-stickers.d.ts +127 -0
  196. package/src/Utils/status-stickers.js +260 -0
  197. package/src/Utils/sync-action-utils.d.ts +2 -0
  198. package/src/Utils/sync-action-utils.js +44 -0
  199. package/src/Utils/tc-token-utils.d.ts +29 -0
  200. package/src/Utils/tc-token-utils.js +155 -0
  201. package/src/Utils/ttl-cache.d.ts +28 -0
  202. package/src/Utils/ttl-cache.js +120 -0
  203. package/src/Utils/use-mongo-auth-state.d.ts +21 -0
  204. package/src/Utils/use-mongo-auth-state.js +67 -0
  205. package/src/Utils/use-multi-file-auth-state.d.ts +11 -0
  206. package/src/Utils/use-multi-file-auth-state.js +106 -0
  207. package/src/Utils/use-mysql-auth-state.d.ts +19 -0
  208. package/src/Utils/use-mysql-auth-state.js +79 -0
  209. package/src/Utils/use-postgres-auth-state.d.ts +19 -0
  210. package/src/Utils/use-postgres-auth-state.js +79 -0
  211. package/src/Utils/use-redis-auth-state.d.ts +19 -0
  212. package/src/Utils/use-redis-auth-state.js +89 -0
  213. package/src/Utils/use-single-file-auth-state.d.ts +10 -0
  214. package/src/Utils/use-single-file-auth-state.js +108 -0
  215. package/src/Utils/use-sqlite-auth-state.d.ts +12 -0
  216. package/src/Utils/use-sqlite-auth-state.js +120 -0
  217. package/src/Utils/useNekoDBAuth.d.ts +19 -0
  218. package/src/Utils/useNekoDBAuth.js +111 -0
  219. package/src/Utils/username.d.ts +12 -0
  220. package/src/Utils/username.js +58 -0
  221. package/src/Utils/validate-connection.d.ts +43 -0
  222. package/src/Utils/validate-connection.js +277 -0
  223. package/src/Utils/voice-recognition.d.ts +53 -0
  224. package/src/Utils/voice-recognition.js +219 -0
  225. package/src/Voip/audio-feeder.d.ts +24 -0
  226. package/src/Voip/audio-feeder.js +268 -0
  227. package/src/Voip/index.d.ts +88 -0
  228. package/src/Voip/index.js +936 -0
  229. package/src/Voip/relay-transport.d.ts +5 -0
  230. package/src/Voip/relay-transport.js +824 -0
  231. package/src/Voip/signaling.d.ts +11 -0
  232. package/src/Voip/signaling.js +1099 -0
  233. package/src/Voip/types.d.ts +2 -0
  234. package/src/Voip/types.js +12 -0
  235. package/src/Voip/video-feeder.d.ts +24 -0
  236. package/src/Voip/video-feeder.js +268 -0
  237. package/src/Voip/wasm-engine.d.ts +26 -0
  238. package/src/Voip/wasm-engine.js +1307 -0
  239. package/src/Voip/worker-bootstrap.js +1023 -0
  240. package/src/WABinary/constants.d.ts +22 -0
  241. package/src/WABinary/constants.js +1300 -0
  242. package/src/WABinary/decode.d.ts +9 -0
  243. package/src/WABinary/decode.js +261 -0
  244. package/src/WABinary/encode.d.ts +2 -0
  245. package/src/WABinary/encode.js +219 -0
  246. package/src/WABinary/generic-utils.d.ts +76 -0
  247. package/src/WABinary/generic-utils.js +214 -0
  248. package/src/WABinary/index.d.ts +5 -0
  249. package/src/WABinary/index.js +5 -0
  250. package/src/WABinary/jid-utils.d.ts +30 -0
  251. package/src/WABinary/jid-utils.js +97 -0
  252. package/src/WABinary/types.d.ts +1 -0
  253. package/src/WABinary/types.js +0 -0
  254. package/src/WAM/BinaryInfo.d.ts +7 -0
  255. package/src/WAM/BinaryInfo.js +9 -0
  256. package/src/WAM/constants.d.ts +34926 -0
  257. package/src/WAM/constants.js +22852 -0
  258. package/src/WAM/encode.d.ts +1 -0
  259. package/src/WAM/encode.js +148 -0
  260. package/src/WAM/index.d.ts +3 -0
  261. package/src/WAM/index.js +3 -0
  262. package/src/WAUSync/Protocols/USyncContactProtocol.d.ts +36 -0
  263. package/src/WAUSync/Protocols/USyncContactProtocol.js +50 -0
  264. package/src/WAUSync/Protocols/USyncDeviceProtocol.d.ts +22 -0
  265. package/src/WAUSync/Protocols/USyncDeviceProtocol.js +51 -0
  266. package/src/WAUSync/Protocols/USyncDisappearingModeProtocol.d.ts +12 -0
  267. package/src/WAUSync/Protocols/USyncDisappearingModeProtocol.js +26 -0
  268. package/src/WAUSync/Protocols/USyncStatusProtocol.d.ts +12 -0
  269. package/src/WAUSync/Protocols/USyncStatusProtocol.js +37 -0
  270. package/src/WAUSync/Protocols/USyncUsernameProtocol.d.ts +9 -0
  271. package/src/WAUSync/Protocols/USyncUsernameProtocol.js +23 -0
  272. package/src/WAUSync/Protocols/UsyncBotProfileProtocol.d.ts +38 -0
  273. package/src/WAUSync/Protocols/UsyncBotProfileProtocol.js +49 -0
  274. package/src/WAUSync/Protocols/UsyncLIDProtocol.d.ts +14 -0
  275. package/src/WAUSync/Protocols/UsyncLIDProtocol.js +28 -0
  276. package/src/WAUSync/Protocols/index.d.ts +5 -0
  277. package/src/WAUSync/Protocols/index.js +5 -0
  278. package/src/WAUSync/USyncQuery.d.ts +20 -0
  279. package/src/WAUSync/USyncQuery.js +93 -0
  280. package/src/WAUSync/USyncUser.d.ts +16 -0
  281. package/src/WAUSync/USyncUser.js +30 -0
  282. package/src/WAUSync/index.d.ts +3 -0
  283. package/src/WAUSync/index.js +3 -0
  284. package/src/assets/wasm/README.md +76 -0
  285. package/src/assets/wasm/loader.js +5 -0
  286. package/src/assets/wasm/whatsapp.wasm +0 -0
  287. package/src/assets/wasm/worker-modules.js +273 -0
  288. package/src/index.d.ts +43 -0
  289. package/src/index.js +48 -0
@@ -0,0 +1,9 @@
1
+ export class CiphertextMessage {
2
+ UNSUPPORTED_VERSION: number;
3
+ CURRENT_VERSION: number;
4
+ WHISPER_TYPE: number;
5
+ PREKEY_TYPE: number;
6
+ SENDERKEY_TYPE: number;
7
+ SENDERKEY_DISTRIBUTION_TYPE: number;
8
+ ENCRYPTED_MESSAGE_OVERHEAD: number;
9
+ }
@@ -0,0 +1,11 @@
1
+ export class CiphertextMessage {
2
+ constructor() {
3
+ this.UNSUPPORTED_VERSION = 1;
4
+ this.CURRENT_VERSION = 3;
5
+ this.WHISPER_TYPE = 2;
6
+ this.PREKEY_TYPE = 3;
7
+ this.SENDERKEY_TYPE = 4;
8
+ this.SENDERKEY_DISTRIBUTION_TYPE = 5;
9
+ this.ENCRYPTED_MESSAGE_OVERHEAD = 53;
10
+ }
11
+ }
@@ -0,0 +1,7 @@
1
+ export class GroupSessionBuilder {
2
+ constructor(senderKeyStore: any);
3
+ senderKeyStore: any;
4
+ process(senderKeyName: any, senderKeyDistributionMessage: any): Promise<void>;
5
+ create(senderKeyName: any): Promise<SenderKeyDistributionMessage>;
6
+ }
7
+ import { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
@@ -0,0 +1,27 @@
1
+ import * as keyhelper from './keyhelper.js';
2
+ import { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
3
+ export class GroupSessionBuilder {
4
+ constructor(senderKeyStore) {
5
+ this.senderKeyStore = senderKeyStore;
6
+ }
7
+ async process(senderKeyName, senderKeyDistributionMessage) {
8
+ const senderKeyRecord = await this.senderKeyStore.loadSenderKey(senderKeyName);
9
+ senderKeyRecord.addSenderKeyState(senderKeyDistributionMessage.getId(), senderKeyDistributionMessage.getIteration(), senderKeyDistributionMessage.getChainKey(), senderKeyDistributionMessage.getSignatureKey());
10
+ await this.senderKeyStore.storeSenderKey(senderKeyName, senderKeyRecord);
11
+ }
12
+ async create(senderKeyName) {
13
+ const senderKeyRecord = await this.senderKeyStore.loadSenderKey(senderKeyName);
14
+ if (senderKeyRecord.isEmpty()) {
15
+ const keyId = keyhelper.generateSenderKeyId();
16
+ const senderKey = keyhelper.generateSenderKey();
17
+ const signingKey = keyhelper.generateSenderSigningKey();
18
+ senderKeyRecord.setSenderKeyState(keyId, 0, senderKey, signingKey);
19
+ await this.senderKeyStore.storeSenderKey(senderKeyName, senderKeyRecord);
20
+ }
21
+ const state = senderKeyRecord.getSenderKeyState();
22
+ if (!state) {
23
+ throw new Error('No session state available');
24
+ }
25
+ return new SenderKeyDistributionMessage(state.getKeyId(), state.getSenderChainKey().getIteration(), state.getSenderChainKey().getSeed(), state.getSigningKeyPublic());
26
+ }
27
+ }
@@ -0,0 +1,11 @@
1
+
2
+ export class GroupCipher {
3
+ constructor(senderKeyStore: any, senderKeyName: any);
4
+ senderKeyStore: any;
5
+ senderKeyName: any;
6
+ encrypt(paddedPlaintext: any): Promise<any>;
7
+ decrypt(senderKeyMessageBytes: any): Promise<any>;
8
+ getSenderKey(senderKeyState: any, iteration: any): any;
9
+ getPlainText(iv: any, key: any, ciphertext: any): Promise<any>;
10
+ getCipherText(iv: any, key: any, plaintext: any): Promise<any>;
11
+ }
@@ -0,0 +1,78 @@
1
+ import { decrypt, encrypt } from 'libsignal/src/crypto.js';
2
+ import { SenderKeyMessage } from './sender-key-message.js';
3
+ export class GroupCipher {
4
+ constructor(senderKeyStore, senderKeyName) {
5
+ this.senderKeyStore = senderKeyStore;
6
+ this.senderKeyName = senderKeyName;
7
+ }
8
+ async encrypt(paddedPlaintext) {
9
+ const record = await this.senderKeyStore.loadSenderKey(this.senderKeyName);
10
+ if (!record) {
11
+ throw new Error('No SenderKeyRecord found for encryption');
12
+ }
13
+ const senderKeyState = record.getSenderKeyState();
14
+ if (!senderKeyState) {
15
+ throw new Error('No session to encrypt message');
16
+ }
17
+ const iteration = senderKeyState.getSenderChainKey().getIteration();
18
+ const senderKey = this.getSenderKey(senderKeyState, iteration === 0 ? 0 : iteration + 1);
19
+ const ciphertext = await this.getCipherText(senderKey.getIv(), senderKey.getCipherKey(), paddedPlaintext);
20
+ const senderKeyMessage = new SenderKeyMessage(senderKeyState.getKeyId(), senderKey.getIteration(), ciphertext, senderKeyState.getSigningKeyPrivate());
21
+ await this.senderKeyStore.storeSenderKey(this.senderKeyName, record);
22
+ return senderKeyMessage.serialize();
23
+ }
24
+ async decrypt(senderKeyMessageBytes) {
25
+ const record = await this.senderKeyStore.loadSenderKey(this.senderKeyName);
26
+ if (!record) {
27
+ throw new Error('No SenderKeyRecord found for decryption');
28
+ }
29
+ const senderKeyMessage = new SenderKeyMessage(null, null, null, null, senderKeyMessageBytes);
30
+ const senderKeyState = record.getSenderKeyState(senderKeyMessage.getKeyId());
31
+ if (!senderKeyState) {
32
+ throw new Error('No session found to decrypt message');
33
+ }
34
+ senderKeyMessage.verifySignature(senderKeyState.getSigningKeyPublic());
35
+ const senderKey = this.getSenderKey(senderKeyState, senderKeyMessage.getIteration());
36
+ const plaintext = await this.getPlainText(senderKey.getIv(), senderKey.getCipherKey(), senderKeyMessage.getCipherText());
37
+ await this.senderKeyStore.storeSenderKey(this.senderKeyName, record);
38
+ return plaintext;
39
+ }
40
+ getSenderKey(senderKeyState, iteration) {
41
+ let senderChainKey = senderKeyState.getSenderChainKey();
42
+ if (senderChainKey.getIteration() > iteration) {
43
+ if (senderKeyState.hasSenderMessageKey(iteration)) {
44
+ const messageKey = senderKeyState.removeSenderMessageKey(iteration);
45
+ if (!messageKey) {
46
+ throw new Error('No sender message key found for iteration');
47
+ }
48
+ return messageKey;
49
+ }
50
+ throw new Error(`Received message with old counter: ${senderChainKey.getIteration()}, ${iteration}`);
51
+ }
52
+ if (iteration - senderChainKey.getIteration() > 2000) {
53
+ throw new Error('Over 2000 messages into the future!');
54
+ }
55
+ while (senderChainKey.getIteration() < iteration) {
56
+ senderKeyState.addSenderMessageKey(senderChainKey.getSenderMessageKey());
57
+ senderChainKey = senderChainKey.getNext();
58
+ }
59
+ senderKeyState.setSenderChainKey(senderChainKey.getNext());
60
+ return senderChainKey.getSenderMessageKey();
61
+ }
62
+ async getPlainText(iv, key, ciphertext) {
63
+ try {
64
+ return decrypt(key, ciphertext, iv);
65
+ }
66
+ catch (e) {
67
+ throw new Error('InvalidMessageException');
68
+ }
69
+ }
70
+ async getCipherText(iv, key, plaintext) {
71
+ try {
72
+ return encrypt(key, plaintext, iv);
73
+ }
74
+ catch (e) {
75
+ throw new Error('InvalidMessageException');
76
+ }
77
+ }
78
+ }
@@ -0,0 +1,11 @@
1
+ export { GroupSessionBuilder } from "./group-session-builder.js";
2
+ export { SenderKeyDistributionMessage } from "./sender-key-distribution-message.js";
3
+ export { SenderKeyRecord } from "./sender-key-record.js";
4
+ export { SenderKeyName } from "./sender-key-name.js";
5
+ export { GroupCipher } from "./group_cipher.js";
6
+ export { SenderKeyState } from "./sender-key-state.js";
7
+ export { SenderKeyMessage } from "./sender-key-message.js";
8
+ export { SenderMessageKey } from "./sender-message-key.js";
9
+ export { SenderChainKey } from "./sender-chain-key.js";
10
+ export { CiphertextMessage } from "./ciphertext-message.js";
11
+ export * as keyhelper from "./keyhelper.js";
@@ -0,0 +1,11 @@
1
+ export { GroupSessionBuilder } from './group-session-builder.js';
2
+ export { SenderKeyDistributionMessage } from './sender-key-distribution-message.js';
3
+ export { SenderKeyRecord } from './sender-key-record.js';
4
+ export { SenderKeyName } from './sender-key-name.js';
5
+ export { GroupCipher } from './group_cipher.js';
6
+ export { SenderKeyState } from './sender-key-state.js';
7
+ export { SenderKeyMessage } from './sender-key-message.js';
8
+ export { SenderMessageKey } from './sender-message-key.js';
9
+ export { SenderChainKey } from './sender-chain-key.js';
10
+ export { CiphertextMessage } from './ciphertext-message.js';
11
+ export * as keyhelper from './keyhelper.js';
@@ -0,0 +1,6 @@
1
+ export function generateSenderKey(): any;
2
+ export function generateSenderKeyId(): any;
3
+ export function generateSenderSigningKey(key: any): {
4
+ public: any;
5
+ private: any;
6
+ };
@@ -0,0 +1,17 @@
1
+ import * as nodeCrypto from 'crypto';
2
+ import { generateKeyPair } from 'libsignal/src/curve.js';
3
+ export function generateSenderKey() {
4
+ return nodeCrypto.randomBytes(32);
5
+ }
6
+ export function generateSenderKeyId() {
7
+ return nodeCrypto.randomInt(2147483647);
8
+ }
9
+ export function generateSenderSigningKey(key) {
10
+ if (!key) {
11
+ key = generateKeyPair();
12
+ }
13
+ return {
14
+ public: Buffer.from(key.pubKey),
15
+ private: Buffer.from(key.privKey)
16
+ };
17
+ }
@@ -0,0 +1,13 @@
1
+ export class SenderChainKey {
2
+ constructor(iteration: any, chainKey: any);
3
+ MESSAGE_KEY_SEED: any;
4
+ CHAIN_KEY_SEED: any;
5
+ iteration: any;
6
+ chainKey: any;
7
+ getIteration(): any;
8
+ getSenderMessageKey(): SenderMessageKey;
9
+ getNext(): SenderChainKey;
10
+ getSeed(): any;
11
+ getDerivative(seed: any, key: any): any;
12
+ }
13
+ import { SenderMessageKey } from './sender-message-key.js';
@@ -0,0 +1,25 @@
1
+ import { calculateMAC } from 'libsignal/src/crypto.js';
2
+ import { SenderMessageKey } from './sender-message-key.js';
3
+ export class SenderChainKey {
4
+ constructor(iteration, chainKey) {
5
+ this.MESSAGE_KEY_SEED = Buffer.from([0x01]);
6
+ this.CHAIN_KEY_SEED = Buffer.from([0x02]);
7
+ this.iteration = iteration;
8
+ this.chainKey = Buffer.from(chainKey);
9
+ }
10
+ getIteration() {
11
+ return this.iteration;
12
+ }
13
+ getSenderMessageKey() {
14
+ return new SenderMessageKey(this.iteration, this.getDerivative(this.MESSAGE_KEY_SEED, this.chainKey));
15
+ }
16
+ getNext() {
17
+ return new SenderChainKey(this.iteration + 1, this.getDerivative(this.CHAIN_KEY_SEED, this.chainKey));
18
+ }
19
+ getSeed() {
20
+ return this.chainKey;
21
+ }
22
+ getDerivative(seed, key) {
23
+ return calculateMAC(key, seed);
24
+ }
25
+ }
@@ -0,0 +1,16 @@
1
+ export class SenderKeyDistributionMessage extends CiphertextMessage {
2
+ constructor(id: any, iteration: any, chainKey: any, signatureKey: any, serialized: any);
3
+ serialized: any;
4
+ id: any;
5
+ iteration: any;
6
+ chainKey: any;
7
+ signatureKey: any;
8
+ intsToByteHighAndLow(highValue: any, lowValue: any): number;
9
+ serialize(): any;
10
+ getType(): number;
11
+ getIteration(): any;
12
+ getChainKey(): any;
13
+ getSignatureKey(): any;
14
+ getId(): any;
15
+ }
16
+ import { CiphertextMessage } from './ciphertext-message.js';
@@ -0,0 +1,62 @@
1
+ import { proto } from '../../../WAProto/index.js';
2
+ import { CiphertextMessage } from './ciphertext-message.js';
3
+ export class SenderKeyDistributionMessage extends CiphertextMessage {
4
+ constructor(id, iteration, chainKey, signatureKey, serialized) {
5
+ super();
6
+ if (serialized) {
7
+ try {
8
+ const message = serialized.slice(1);
9
+ const distributionMessage = proto.SenderKeyDistributionMessage.decode(message).toJSON();
10
+ this.serialized = serialized;
11
+ this.id = distributionMessage.id;
12
+ this.iteration = distributionMessage.iteration;
13
+ this.chainKey =
14
+ typeof distributionMessage.chainKey === 'string'
15
+ ? Buffer.from(distributionMessage.chainKey, 'base64')
16
+ : distributionMessage.chainKey;
17
+ this.signatureKey =
18
+ typeof distributionMessage.signingKey === 'string'
19
+ ? Buffer.from(distributionMessage.signingKey, 'base64')
20
+ : distributionMessage.signingKey;
21
+ }
22
+ catch (e) {
23
+ throw new Error(String(e));
24
+ }
25
+ }
26
+ else {
27
+ const version = this.intsToByteHighAndLow(this.CURRENT_VERSION, this.CURRENT_VERSION);
28
+ this.id = id;
29
+ this.iteration = iteration;
30
+ this.chainKey = chainKey;
31
+ this.signatureKey = signatureKey;
32
+ const message = proto.SenderKeyDistributionMessage.encode(proto.SenderKeyDistributionMessage.create({
33
+ id,
34
+ iteration,
35
+ chainKey,
36
+ signingKey: this.signatureKey
37
+ })).finish();
38
+ this.serialized = Buffer.concat([Buffer.from([version]), message]);
39
+ }
40
+ }
41
+ intsToByteHighAndLow(highValue, lowValue) {
42
+ return (((highValue << 4) | lowValue) & 0xff) % 256;
43
+ }
44
+ serialize() {
45
+ return this.serialized;
46
+ }
47
+ getType() {
48
+ return this.SENDERKEY_DISTRIBUTION_TYPE;
49
+ }
50
+ getIteration() {
51
+ return this.iteration;
52
+ }
53
+ getChainKey() {
54
+ return this.chainKey;
55
+ }
56
+ getSignatureKey() {
57
+ return this.signatureKey;
58
+ }
59
+ getId() {
60
+ return this.id;
61
+ }
62
+ }
@@ -0,0 +1,18 @@
1
+ export class SenderKeyMessage extends CiphertextMessage {
2
+ constructor(keyId: any, iteration: any, ciphertext: any, signatureKey: any, serialized: any);
3
+ SIGNATURE_LENGTH: number;
4
+ serialized: any;
5
+ messageVersion: number;
6
+ keyId: any;
7
+ iteration: any;
8
+ ciphertext: any;
9
+ signature: any;
10
+ getKeyId(): any;
11
+ getIteration(): any;
12
+ getCipherText(): any;
13
+ verifySignature(signatureKey: any): void;
14
+ getSignature(signatureKey: any, serialized: any): any;
15
+ serialize(): any;
16
+ getType(): number;
17
+ }
18
+ import { CiphertextMessage } from './ciphertext-message.js';
@@ -0,0 +1,65 @@
1
+ import { calculateSignature, verifySignature } from 'libsignal/src/curve.js';
2
+ import { proto } from '../../../WAProto/index.js';
3
+ import { CiphertextMessage } from './ciphertext-message.js';
4
+ export class SenderKeyMessage extends CiphertextMessage {
5
+ constructor(keyId, iteration, ciphertext, signatureKey, serialized) {
6
+ super();
7
+ this.SIGNATURE_LENGTH = 64;
8
+ if (serialized) {
9
+ const version = serialized[0];
10
+ const message = serialized.slice(1, serialized.length - this.SIGNATURE_LENGTH);
11
+ const signature = serialized.slice(-1 * this.SIGNATURE_LENGTH);
12
+ const senderKeyMessage = proto.SenderKeyMessage.decode(message).toJSON();
13
+ this.serialized = serialized;
14
+ this.messageVersion = (version & 0xff) >> 4;
15
+ this.keyId = senderKeyMessage.id;
16
+ this.iteration = senderKeyMessage.iteration;
17
+ this.ciphertext =
18
+ typeof senderKeyMessage.ciphertext === 'string'
19
+ ? Buffer.from(senderKeyMessage.ciphertext, 'base64')
20
+ : senderKeyMessage.ciphertext;
21
+ this.signature = signature;
22
+ }
23
+ else {
24
+ const version = (((this.CURRENT_VERSION << 4) | this.CURRENT_VERSION) & 0xff) % 256;
25
+ const ciphertextBuffer = Buffer.from(ciphertext);
26
+ const message = proto.SenderKeyMessage.encode(proto.SenderKeyMessage.create({
27
+ id: keyId,
28
+ iteration: iteration,
29
+ ciphertext: ciphertextBuffer
30
+ })).finish();
31
+ const signature = this.getSignature(signatureKey, Buffer.concat([Buffer.from([version]), message]));
32
+ this.serialized = Buffer.concat([Buffer.from([version]), message, Buffer.from(signature)]);
33
+ this.messageVersion = this.CURRENT_VERSION;
34
+ this.keyId = keyId;
35
+ this.iteration = iteration;
36
+ this.ciphertext = ciphertextBuffer;
37
+ this.signature = signature;
38
+ }
39
+ }
40
+ getKeyId() {
41
+ return this.keyId;
42
+ }
43
+ getIteration() {
44
+ return this.iteration;
45
+ }
46
+ getCipherText() {
47
+ return this.ciphertext;
48
+ }
49
+ verifySignature(signatureKey) {
50
+ const part1 = this.serialized.slice(0, this.serialized.length - this.SIGNATURE_LENGTH);
51
+ const part2 = this.serialized.slice(-1 * this.SIGNATURE_LENGTH);
52
+ const res = verifySignature(signatureKey, part1, part2);
53
+ if (!res)
54
+ throw new Error('Invalid signature!');
55
+ }
56
+ getSignature(signatureKey, serialized) {
57
+ return Buffer.from(calculateSignature(signatureKey, serialized));
58
+ }
59
+ serialize() {
60
+ return this.serialized;
61
+ }
62
+ getType() {
63
+ return 4;
64
+ }
65
+ }
@@ -0,0 +1,11 @@
1
+ export class SenderKeyName {
2
+ constructor(groupId: any, sender: any);
3
+ groupId: any;
4
+ sender: any;
5
+ getGroupId(): any;
6
+ getSender(): any;
7
+ serialize(): string;
8
+ toString(): string;
9
+ equals(other: any): boolean;
10
+ hashCode(): number;
11
+ }
@@ -0,0 +1,47 @@
1
+ function isNull(str) {
2
+ return str === null || str === '';
3
+ }
4
+ function intValue(num) {
5
+ const MAX_VALUE = 0x7fffffff;
6
+ const MIN_VALUE = -0x80000000;
7
+ if (num > MAX_VALUE || num < MIN_VALUE) {
8
+ return num & 0xffffffff;
9
+ }
10
+ return num;
11
+ }
12
+ function hashCode(strKey) {
13
+ let hash = 0;
14
+ if (!isNull(strKey)) {
15
+ for (let i = 0; i < strKey.length; i++) {
16
+ hash = hash * 31 + strKey.charCodeAt(i);
17
+ hash = intValue(hash);
18
+ }
19
+ }
20
+ return hash;
21
+ }
22
+ export class SenderKeyName {
23
+ constructor(groupId, sender) {
24
+ this.groupId = groupId;
25
+ this.sender = sender;
26
+ }
27
+ getGroupId() {
28
+ return this.groupId;
29
+ }
30
+ getSender() {
31
+ return this.sender;
32
+ }
33
+ serialize() {
34
+ return `${this.groupId}::${this.sender.id}::${this.sender.deviceId}`;
35
+ }
36
+ toString() {
37
+ return this.serialize();
38
+ }
39
+ equals(other) {
40
+ if (other === null)
41
+ return false;
42
+ return this.groupId === other.groupId && this.sender.toString() === other.sender.toString();
43
+ }
44
+ hashCode() {
45
+ return hashCode(this.groupId) ^ hashCode(this.sender.toString());
46
+ }
47
+ }
@@ -0,0 +1,12 @@
1
+ export class SenderKeyRecord {
2
+ static deserialize(data: any): SenderKeyRecord;
3
+ constructor(serialized: any);
4
+ MAX_STATES: number;
5
+ senderKeyStates: SenderKeyState[];
6
+ isEmpty(): boolean;
7
+ getSenderKeyState(keyId: any): SenderKeyState | undefined;
8
+ addSenderKeyState(id: any, iteration: any, chainKey: any, signatureKey: any): void;
9
+ setSenderKeyState(id: any, iteration: any, chainKey: any, keyPair: any): void;
10
+ serialize(): any[];
11
+ }
12
+ import { SenderKeyState } from './sender-key-state.js';
@@ -0,0 +1,40 @@
1
+ import { BufferJSON } from '../../Utils/generics.js';
2
+ import { SenderKeyState } from './sender-key-state.js';
3
+ export class SenderKeyRecord {
4
+ constructor(serialized) {
5
+ this.MAX_STATES = 5;
6
+ this.senderKeyStates = [];
7
+ if (serialized) {
8
+ for (const structure of serialized) {
9
+ this.senderKeyStates.push(new SenderKeyState(null, null, null, null, null, null, structure));
10
+ }
11
+ }
12
+ }
13
+ isEmpty() {
14
+ return this.senderKeyStates.length === 0;
15
+ }
16
+ getSenderKeyState(keyId) {
17
+ if (keyId === undefined && this.senderKeyStates.length) {
18
+ return this.senderKeyStates[this.senderKeyStates.length - 1];
19
+ }
20
+ return this.senderKeyStates.find(state => state.getKeyId() === keyId);
21
+ }
22
+ addSenderKeyState(id, iteration, chainKey, signatureKey) {
23
+ this.senderKeyStates.push(new SenderKeyState(id, iteration, chainKey, null, signatureKey));
24
+ if (this.senderKeyStates.length > this.MAX_STATES) {
25
+ this.senderKeyStates.shift();
26
+ }
27
+ }
28
+ setSenderKeyState(id, iteration, chainKey, keyPair) {
29
+ this.senderKeyStates.length = 0;
30
+ this.senderKeyStates.push(new SenderKeyState(id, iteration, chainKey, keyPair));
31
+ }
32
+ serialize() {
33
+ return this.senderKeyStates.map(state => state.getStructure());
34
+ }
35
+ static deserialize(data) {
36
+ const str = Buffer.from(data).toString('utf-8');
37
+ const parsed = JSON.parse(str, BufferJSON.reviver);
38
+ return new SenderKeyRecord(parsed);
39
+ }
40
+ }
@@ -0,0 +1,16 @@
1
+ export class SenderKeyState {
2
+ constructor(id: any, iteration: any, chainKey: any, signatureKeyPair: any, signatureKeyPublic: any, signatureKeyPrivate: any, senderKeyStateStructure: any);
3
+ MAX_MESSAGE_KEYS: number;
4
+ senderKeyStateStructure: any;
5
+ getKeyId(): any;
6
+ getSenderChainKey(): SenderChainKey;
7
+ setSenderChainKey(chainKey: any): void;
8
+ getSigningKeyPublic(): any;
9
+ getSigningKeyPrivate(): any;
10
+ hasSenderMessageKey(iteration: any): any;
11
+ addSenderMessageKey(senderMessageKey: any): void;
12
+ removeSenderMessageKey(iteration: any): SenderMessageKey | null;
13
+ getStructure(): any;
14
+ }
15
+ import { SenderChainKey } from './sender-chain-key.js';
16
+ import { SenderMessageKey } from './sender-message-key.js';
@@ -0,0 +1,83 @@
1
+ import { SenderChainKey } from './sender-chain-key.js';
2
+ import { SenderMessageKey } from './sender-message-key.js';
3
+ export class SenderKeyState {
4
+ constructor(id, iteration, chainKey, signatureKeyPair, signatureKeyPublic, signatureKeyPrivate, senderKeyStateStructure) {
5
+ this.MAX_MESSAGE_KEYS = 2000;
6
+ if (senderKeyStateStructure) {
7
+ this.senderKeyStateStructure = {
8
+ ...senderKeyStateStructure,
9
+ senderMessageKeys: Array.isArray(senderKeyStateStructure.senderMessageKeys)
10
+ ? senderKeyStateStructure.senderMessageKeys
11
+ : []
12
+ };
13
+ }
14
+ else {
15
+ if (signatureKeyPair) {
16
+ signatureKeyPublic = signatureKeyPair.public;
17
+ signatureKeyPrivate = signatureKeyPair.private;
18
+ }
19
+ this.senderKeyStateStructure = {
20
+ senderKeyId: id || 0,
21
+ senderChainKey: {
22
+ iteration: iteration || 0,
23
+ seed: Buffer.from(chainKey || [])
24
+ },
25
+ senderSigningKey: {
26
+ public: Buffer.from(signatureKeyPublic || []),
27
+ private: Buffer.from(signatureKeyPrivate || [])
28
+ },
29
+ senderMessageKeys: []
30
+ };
31
+ }
32
+ }
33
+ getKeyId() {
34
+ return this.senderKeyStateStructure.senderKeyId;
35
+ }
36
+ getSenderChainKey() {
37
+ return new SenderChainKey(this.senderKeyStateStructure.senderChainKey.iteration, this.senderKeyStateStructure.senderChainKey.seed);
38
+ }
39
+ setSenderChainKey(chainKey) {
40
+ this.senderKeyStateStructure.senderChainKey = {
41
+ iteration: chainKey.getIteration(),
42
+ seed: chainKey.getSeed()
43
+ };
44
+ }
45
+ getSigningKeyPublic() {
46
+ const publicKey = Buffer.from(this.senderKeyStateStructure.senderSigningKey.public);
47
+ if (publicKey.length === 32) {
48
+ const fixed = Buffer.alloc(33);
49
+ fixed[0] = 0x05;
50
+ publicKey.copy(fixed, 1);
51
+ return fixed;
52
+ }
53
+ return publicKey;
54
+ }
55
+ getSigningKeyPrivate() {
56
+ const privateKey = this.senderKeyStateStructure.senderSigningKey.private;
57
+ return Buffer.from(privateKey || []);
58
+ }
59
+ hasSenderMessageKey(iteration) {
60
+ return this.senderKeyStateStructure.senderMessageKeys.some(key => key.iteration === iteration);
61
+ }
62
+ addSenderMessageKey(senderMessageKey) {
63
+ this.senderKeyStateStructure.senderMessageKeys.push({
64
+ iteration: senderMessageKey.getIteration(),
65
+ seed: senderMessageKey.getSeed()
66
+ });
67
+ if (this.senderKeyStateStructure.senderMessageKeys.length > this.MAX_MESSAGE_KEYS) {
68
+ this.senderKeyStateStructure.senderMessageKeys.shift();
69
+ }
70
+ }
71
+ removeSenderMessageKey(iteration) {
72
+ const index = this.senderKeyStateStructure.senderMessageKeys.findIndex(key => key.iteration === iteration);
73
+ if (index !== -1) {
74
+ const messageKey = this.senderKeyStateStructure.senderMessageKeys[index];
75
+ this.senderKeyStateStructure.senderMessageKeys.splice(index, 1);
76
+ return new SenderMessageKey(messageKey.iteration, messageKey.seed);
77
+ }
78
+ return null;
79
+ }
80
+ getStructure() {
81
+ return this.senderKeyStateStructure;
82
+ }
83
+ }
@@ -0,0 +1,11 @@
1
+ export class SenderMessageKey {
2
+ constructor(iteration: any, seed: any);
3
+ iv: any;
4
+ cipherKey: any;
5
+ iteration: any;
6
+ seed: any;
7
+ getIteration(): any;
8
+ getIv(): any;
9
+ getCipherKey(): any;
10
+ getSeed(): any;
11
+ }
@@ -0,0 +1,25 @@
1
+ import { deriveSecrets } from 'libsignal/src/crypto.js';
2
+ export class SenderMessageKey {
3
+ constructor(iteration, seed) {
4
+ const derivative = deriveSecrets(seed, Buffer.alloc(32), Buffer.from('WhisperGroup'));
5
+ const keys = new Uint8Array(32);
6
+ keys.set(new Uint8Array(derivative[0].slice(16)));
7
+ keys.set(new Uint8Array(derivative[1].slice(0, 16)), 16);
8
+ this.iv = Buffer.from(derivative[0].slice(0, 16));
9
+ this.cipherKey = Buffer.from(keys.buffer);
10
+ this.iteration = iteration;
11
+ this.seed = seed;
12
+ }
13
+ getIteration() {
14
+ return this.iteration;
15
+ }
16
+ getIv() {
17
+ return this.iv;
18
+ }
19
+ getCipherKey() {
20
+ return this.cipherKey;
21
+ }
22
+ getSeed() {
23
+ return this.seed;
24
+ }
25
+ }