@owlmeans/bot-whatsapp 0.0.0-stage → 0.2.0-alpha.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 (60) hide show
  1. package/README.md +74 -2
  2. package/agent-meta/manifest.json +16 -0
  3. package/agent-meta/skills/bot-whatsapp/SKILL.md +104 -0
  4. package/build/api.d.ts +7 -0
  5. package/build/api.d.ts.map +1 -0
  6. package/build/api.js +50 -0
  7. package/build/api.js.map +1 -0
  8. package/build/append.d.ts +10 -0
  9. package/build/append.d.ts.map +1 -0
  10. package/build/append.js +13 -0
  11. package/build/append.js.map +1 -0
  12. package/build/consts.d.ts +57 -0
  13. package/build/consts.d.ts.map +1 -0
  14. package/build/consts.js +183 -0
  15. package/build/consts.js.map +1 -0
  16. package/build/errors.d.ts +22 -0
  17. package/build/errors.d.ts.map +1 -0
  18. package/build/errors.js +34 -0
  19. package/build/errors.js.map +1 -0
  20. package/build/index.d.ts +7 -0
  21. package/build/index.d.ts.map +1 -0
  22. package/build/index.js +6 -0
  23. package/build/index.js.map +1 -0
  24. package/build/mock.d.ts +9 -0
  25. package/build/mock.d.ts.map +1 -0
  26. package/build/mock.js +198 -0
  27. package/build/mock.js.map +1 -0
  28. package/build/normalize.d.ts +4 -0
  29. package/build/normalize.d.ts.map +1 -0
  30. package/build/normalize.js +109 -0
  31. package/build/normalize.js.map +1 -0
  32. package/build/plugin.d.ts +13 -0
  33. package/build/plugin.d.ts.map +1 -0
  34. package/build/plugin.js +147 -0
  35. package/build/plugin.js.map +1 -0
  36. package/build/signature.d.ts +4 -0
  37. package/build/signature.d.ts.map +1 -0
  38. package/build/signature.js +20 -0
  39. package/build/signature.js.map +1 -0
  40. package/build/types.d.ts +179 -0
  41. package/build/types.d.ts.map +1 -0
  42. package/build/types.js +2 -0
  43. package/build/types.js.map +1 -0
  44. package/package.json +56 -4
  45. package/src/api.ts +62 -0
  46. package/src/append.ts +18 -0
  47. package/src/consts.ts +206 -0
  48. package/src/errors.ts +37 -0
  49. package/src/index.ts +6 -0
  50. package/src/mock.ts +243 -0
  51. package/src/normalize.ts +131 -0
  52. package/src/plugin.ts +183 -0
  53. package/src/signature.ts +27 -0
  54. package/src/types.ts +174 -0
  55. package/tests/context.ts +85 -0
  56. package/tests/descriptor.spec.ts +64 -0
  57. package/tests/mock-ids.spec.ts +38 -0
  58. package/tests/tsconfig.json +12 -0
  59. package/tests/whatsapp.spec.ts +485 -0
  60. package/tsconfig.json +16 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;;;;GAOG;AACH,MAAM,OAAO,gBAAiB,SAAQ,gBAAgB;IACpD,8CAA8C;IACvC,MAAM,CAAU,EAAE,CAAC,IAAqB,EAAE,WAAmB,EAAE,MAAe;QACnF,MAAM,KAAK,GAAG,IAAI,gBAAgB,CAAC,GAAG,IAAI,IAAI,WAAW,EAAE,CAAC,CAAA;QAC5D,KAAK,CAAC,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAA;QAC9C,OAAO,KAAK,CAAA;IACd,CAAC;IAED,qEAAqE;IAC9D,IAAI,GAAW,GAAG,CAAA;IACzB,iGAAiG;IAC1F,MAAM,GAAW,GAAG,CAAA;IAE3B,gFAAgF;IAChF,YAAY,OAAO,GAAW,WAAW;QACvC,KAAK,CAAC,GAAG,iBAAiB,IAAI,OAAO,EAAE,CAAC,CAAA;QACxC,IAAI,CAAC,iBAAiB,EAAE,CAAA;IAC1B,CAAC;IAED,6CAA6C;IAC7B,iBAAiB;QAC/B,KAAK,CAAC,iBAAiB,EAAE,CAAA;QACzB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACrD,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAA;IAChD,CAAC;CACF"}
@@ -0,0 +1,7 @@
1
+ export type * from './types.js';
2
+ export * from './consts.js';
3
+ export * from './errors.js';
4
+ export * from './signature.js';
5
+ export * from './plugin.js';
6
+ export * from './append.js';
7
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}
package/build/index.js ADDED
@@ -0,0 +1,6 @@
1
+ export * from './consts.js';
2
+ export * from './errors.js';
3
+ export * from './signature.js';
4
+ export * from './plugin.js';
5
+ export * from './append.js';
6
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA"}
@@ -0,0 +1,9 @@
1
+ import type { WhatsAppMock } from './types.js';
2
+ /**
3
+ * The Cloud API, faked per connection and in process: the same paths, answers and `{ error }`
4
+ * refusals the Graph API gives, no network. `GET /<phone-number-id>` answers the connection's test
5
+ * number, `POST /<phone-number-id>/messages` answers a random `wamid.…` per text or reaction, and the inbound
6
+ * builder writes Meta's webhook payload signed with the app secret (the hook secret when there is none).
7
+ */
8
+ export declare const makeWhatsAppMock: () => WhatsAppMock;
9
+ //# sourceMappingURL=mock.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAC8B,YAAY,EAErD,MAAM,YAAY,CAAA;AAEnB;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAO,YA6NnC,CAAA"}
package/build/mock.js ADDED
@@ -0,0 +1,198 @@
1
+ import { createHash, randomBytes, randomInt } from 'node:crypto';
2
+ import { WHATSAPP_HUB_MODE, WHATSAPP_MESSAGES_FIELD, WHATSAPP_MESSAGING_PRODUCT, WHATSAPP_MOCK_BUSINESS_NAME, WHATSAPP_MOCK_ID_BYTES, WHATSAPP_MOCK_NUMBER_PREFIX, WHATSAPP_MOCK_PHONE_ID_BASE, WHATSAPP_MOCK_SENDER_ID, WHATSAPP_MOCK_SENDER_NAME, WHATSAPP_SIGNATURE_HEADER, WHATSAPP_TEXT_MAX, WHATSAPP_WEBHOOK_OBJECT, } from './consts.js';
3
+ import { whatsappSignatureHelper } from './signature.js';
4
+ /**
5
+ * The Cloud API, faked per connection and in process: the same paths, answers and `{ error }`
6
+ * refusals the Graph API gives, no network. `GET /<phone-number-id>` answers the connection's test
7
+ * number, `POST /<phone-number-id>/messages` answers a random `wamid.…` per text or reaction, and the inbound
8
+ * builder writes Meta's webhook payload signed with the app secret (the hook secret when there is none).
9
+ */
10
+ export const makeWhatsAppMock = () => {
11
+ const states = new Map();
12
+ const stateOf = (connection) => {
13
+ let state = states.get(connection);
14
+ if (state == null) {
15
+ state = { calls: [], sent: new Set(), fed: [] };
16
+ states.set(connection, state);
17
+ }
18
+ return state;
19
+ };
20
+ /** A stable non-negative integer below `modulo`, derived from a text. */
21
+ const hashOf = (text, modulo) => Number.parseInt(createHash('sha256').update(text).digest('hex').slice(0, 13), 16) % modulo;
22
+ const digitsOf = (value) => (value ?? '').replace(/\D/g, '');
23
+ const phoneNumberIdOf = (connection) => {
24
+ const given = connection.credentials.phoneNumberId ?? '';
25
+ return given !== '' ? given : `${WHATSAPP_MOCK_PHONE_ID_BASE + hashOf(connection.id, 9 * WHATSAPP_MOCK_PHONE_ID_BASE)}`;
26
+ };
27
+ const displayNumberOf = (connection) => `${WHATSAPP_MOCK_NUMBER_PREFIX}${`${hashOf(`${connection.id}:number`, 10_000_000)}`.padStart(7, '0')}`;
28
+ const businessAccountOf = (connection) => `${WHATSAPP_MOCK_PHONE_ID_BASE + hashOf(`${connection.id}:account`, 9 * WHATSAPP_MOCK_PHONE_ID_BASE)}`;
29
+ /** A customer's `wa_id` from a simulated id: a phone number stays itself, any other text maps to a stable number. */
30
+ const waIdOf = (value) => {
31
+ if (value == null || value === '') {
32
+ return WHATSAPP_MOCK_SENDER_ID;
33
+ }
34
+ if (/^\+?\d{6,15}$/.test(value)) {
35
+ return digitsOf(value);
36
+ }
37
+ return `1${`${hashOf(value, 10_000_000_000)}`.padStart(10, '0')}`;
38
+ };
39
+ /** A fresh `wamid.…`: random, so no restart and no other process hands out one an inbox already holds. */
40
+ const wamidOf = (connection) => `wamid.${Buffer.from(`mock:${connection}:${randomBytes(WHATSAPP_MOCK_ID_BYTES).toString('hex').toUpperCase()}`, 'utf8').toString('base64')}`;
41
+ const answer = (status, body) => new Response(JSON.stringify(body), { status, headers: { 'content-type': 'application/json' } });
42
+ const refuse = (message, code = 100, subcode) => {
43
+ const envelope = {
44
+ error: {
45
+ message: `(#${code}) ${message}`, type: 'OAuthException', code,
46
+ ...(subcode != null ? { error_subcode: subcode } : {}), fbtrace_id: 'AMockTraceId',
47
+ },
48
+ };
49
+ return answer(400, envelope);
50
+ };
51
+ const unknownObject = (id) => refuse(`Unsupported request. Object with ID '${id}' does not exist, cannot be loaded due to missing permissions, or does not support this operation`, 100, 33);
52
+ const aborted = () => {
53
+ const error = new Error('The operation was aborted.');
54
+ error.name = 'AbortError';
55
+ return error;
56
+ };
57
+ const phoneNumber = (connection, id, fields) => {
58
+ const full = {
59
+ id,
60
+ display_phone_number: displayNumberOf(connection),
61
+ verified_name: connection.label !== '' ? connection.label : WHATSAPP_MOCK_BUSINESS_NAME,
62
+ quality_rating: 'GREEN',
63
+ code_verification_status: 'VERIFIED',
64
+ };
65
+ const wanted = fields != null && fields.trim() !== '' ? fields.split(',').map(field => field.trim()) : Object.keys(full);
66
+ return answer(200, Object.fromEntries(Object.entries(full).filter(([key]) => key === 'id' || wanted.includes(key))));
67
+ };
68
+ const messages = (connection, state, params) => {
69
+ if (params.messaging_product !== WHATSAPP_MESSAGING_PRODUCT) {
70
+ return refuse('The parameter messaging_product is required.');
71
+ }
72
+ const to = typeof params.to === 'string' ? params.to : '';
73
+ if (to.trim() === '') {
74
+ return refuse('The parameter to is required.');
75
+ }
76
+ const type = typeof params.type === 'string' ? params.type : 'text';
77
+ if (type === 'text') {
78
+ const body = params.text?.body;
79
+ if (typeof body !== 'string' || body.trim() === '') {
80
+ return refuse('The parameter text[\'body\'] is required.');
81
+ }
82
+ if (body.length > WHATSAPP_TEXT_MAX) {
83
+ return refuse(`Param text['body'] must be at most ${WHATSAPP_TEXT_MAX} characters long.`);
84
+ }
85
+ }
86
+ else if (type === 'reaction') {
87
+ const reaction = params.reaction;
88
+ if (typeof reaction?.message_id !== 'string' || reaction.message_id === '') {
89
+ return refuse('The parameter reaction[\'message_id\'] is required.');
90
+ }
91
+ if (typeof reaction.emoji !== 'string') {
92
+ return refuse('The parameter reaction[\'emoji\'] is required.');
93
+ }
94
+ }
95
+ else {
96
+ return refuse(`Param type must be one of {TEXT, REACTION} in this mock — got ${type}.`);
97
+ }
98
+ const id = wamidOf(connection.id);
99
+ if (type === 'text') {
100
+ state.sent.add(id);
101
+ }
102
+ const sent = {
103
+ messaging_product: WHATSAPP_MESSAGING_PRODUCT,
104
+ contacts: [{ input: to, wa_id: digitsOf(to) }],
105
+ messages: [{ id }],
106
+ };
107
+ return answer(200, sent);
108
+ };
109
+ const fetch = (connection) => async (url, init) => {
110
+ if (init?.signal?.aborted === true) {
111
+ throw aborted();
112
+ }
113
+ const parsed = new URL(url);
114
+ // `/<version>/<phone-number-id>` or `/<version>/<phone-number-id>/messages`.
115
+ const [, node, edge, ...rest] = parsed.pathname.split('/').filter(segment => segment !== '');
116
+ const method = (init?.method ?? 'GET').toUpperCase();
117
+ const state = stateOf(connection.id);
118
+ const number = phoneNumberIdOf(connection);
119
+ if (method === 'GET' && node != null && edge == null) {
120
+ state.calls.push({ method: 'phone-number', params: Object.fromEntries(parsed.searchParams), at: new Date().toISOString() });
121
+ return node === number ? phoneNumber(connection, node, parsed.searchParams.get('fields')) : unknownObject(node);
122
+ }
123
+ if (method === 'POST' && node != null && edge === WHATSAPP_MESSAGES_FIELD && rest.length === 0) {
124
+ let params;
125
+ try {
126
+ params = init?.body != null && init.body !== '' ? JSON.parse(init.body) : {};
127
+ }
128
+ catch {
129
+ return refuse('Invalid JSON for postcontent');
130
+ }
131
+ state.calls.push({ method: 'messages', params, at: new Date().toISOString() });
132
+ return node === number ? messages(connection, state, params) : unknownObject(node);
133
+ }
134
+ return refuse(`Unknown path components: /${[edge, ...rest].filter(part => part != null).join('/')}`, 2500);
135
+ };
136
+ const inbound = (input, connection) => {
137
+ const state = stateOf(connection.id);
138
+ const from = waIdOf(input.sender?.id);
139
+ const display = digitsOf(connection.identity?.username) !== '' ? digitsOf(connection.identity?.username) : displayNumberOf(connection);
140
+ const message = {
141
+ from,
142
+ id: wamidOf(connection.id),
143
+ timestamp: `${Math.floor(Date.now() / 1000)}`,
144
+ type: 'text',
145
+ text: { body: input.text },
146
+ // The quoted message's author: the business when the fake API sent it, else the customer.
147
+ ...(input.replyTo != null ? { context: { from: state.sent.has(input.replyTo.id) ? display : from, id: input.replyTo.id } } : {}),
148
+ };
149
+ const body = {
150
+ object: WHATSAPP_WEBHOOK_OBJECT,
151
+ entry: [{
152
+ id: businessAccountOf(connection),
153
+ changes: [{
154
+ value: {
155
+ messaging_product: WHATSAPP_MESSAGING_PRODUCT,
156
+ metadata: { display_phone_number: display, phone_number_id: connection.identity?.id ?? phoneNumberIdOf(connection) },
157
+ contacts: [{ profile: { name: input.sender?.name ?? WHATSAPP_MOCK_SENDER_NAME }, wa_id: from }],
158
+ messages: [message],
159
+ },
160
+ field: WHATSAPP_MESSAGES_FIELD,
161
+ }],
162
+ }],
163
+ };
164
+ const rawBody = JSON.stringify(body);
165
+ const appSecret = connection.credentials.appSecret ?? '';
166
+ return {
167
+ body,
168
+ rawBody,
169
+ headers: {
170
+ 'content-type': 'application/json',
171
+ [WHATSAPP_SIGNATURE_HEADER]: whatsappSignatureHelper.sign(rawBody, appSecret !== '' ? appSecret : connection.hookSecret),
172
+ },
173
+ };
174
+ };
175
+ const challenge = (connection, opts = {}) => ({
176
+ method: 'GET',
177
+ headers: {},
178
+ query: {
179
+ 'hub.mode': WHATSAPP_HUB_MODE,
180
+ 'hub.challenge': opts.challenge ?? `${randomInt(1_000_000_000, 2_000_000_000)}`,
181
+ 'hub.verify_token': opts.verifyToken ?? (connection.credentials.verifyToken || connection.hookSecret),
182
+ },
183
+ });
184
+ /** WhatsApp has no receiver (webhook only): a fed payload is kept, never delivered — `simulate` posts instead. */
185
+ const feed = (connection, payload) => {
186
+ stateOf(connection).fed.push(payload);
187
+ };
188
+ const calls = (connection) => [...(states.get(connection)?.calls ?? [])];
189
+ const reset = (connection) => {
190
+ if (connection == null) {
191
+ states.clear();
192
+ return;
193
+ }
194
+ states.delete(connection);
195
+ };
196
+ return { fetch, inbound, feed, calls, reset, phoneNumberIdOf, displayNumberOf, challenge };
197
+ };
198
+ //# sourceMappingURL=mock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mock.js","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { WhatsAppNormalizer } from './types.js';
2
+ export declare const createWhatsAppNormalizer: () => WhatsAppNormalizer;
3
+ export declare const whatsappNormalizer: WhatsAppNormalizer;
4
+ //# sourceMappingURL=normalize.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAC0C,kBAAkB,EACvE,MAAM,YAAY,CAAA;AAEnB,eAAO,MAAM,wBAAwB,QAAO,kBAuH3C,CAAA;AAED,eAAO,MAAM,kBAAkB,oBAA6B,CAAA"}
@@ -0,0 +1,109 @@
1
+ import { botCommandHelper, BotChatKind, BotUpdateKind, } from '@owlmeans/bot';
2
+ import { WHATSAPP_CAPTIONED_TYPES, WHATSAPP_MESSAGES_FIELD, WHATSAPP_WEBHOOK_OBJECT } from './consts.js';
3
+ export const createWhatsAppNormalizer = () => {
4
+ const iso = (unix) => {
5
+ const seconds = Number(unix);
6
+ return new Date((Number.isFinite(seconds) && seconds > 0 ? seconds : Date.now() / 1000) * 1000).toISOString();
7
+ };
8
+ const digitsOf = (value) => (value ?? '').replace(/\D/g, '');
9
+ /** The text a message carries: a text body, a tapped button or list row, a media caption; none for other kinds. */
10
+ const textOf = (message) => {
11
+ switch (message.type) {
12
+ case 'text':
13
+ return typeof message.text?.body === 'string' ? message.text.body : undefined;
14
+ case 'interactive':
15
+ return message.interactive?.button_reply?.title ?? message.interactive?.list_reply?.title;
16
+ case 'button':
17
+ return message.button?.text ?? message.button?.payload;
18
+ default:
19
+ if (WHATSAPP_CAPTIONED_TYPES.includes(message.type)) {
20
+ const media = message[message.type];
21
+ return media != null ? media.caption ?? '' : undefined;
22
+ }
23
+ return undefined;
24
+ }
25
+ };
26
+ /** The profile of the customer who wrote — by `wa_id`, else the only contact of the change. */
27
+ const contactOf = (value, message) => {
28
+ const contacts = Array.isArray(value.contacts) ? value.contacts : [];
29
+ return contacts.find(contact => contact.wa_id === message.from) ?? (contacts.length === 1 ? contacts[0] : undefined);
30
+ };
31
+ /** The business number of the change — the bot — as a sender. */
32
+ const botOf = (metadata, connection) => {
33
+ const id = connection.identity?.id ?? metadata?.phone_number_id ?? '';
34
+ const username = metadata?.display_phone_number ?? connection.identity?.username;
35
+ const name = connection.identity?.name;
36
+ return { id, ...(name != null ? { name } : {}), ...(username != null ? { username } : {}), bot: true };
37
+ };
38
+ const isBotNumber = (number, metadata, connection) => {
39
+ const digits = digitsOf(number);
40
+ return digits !== '' && (digits === digitsOf(metadata?.display_phone_number) || digits === digitsOf(connection.identity?.username));
41
+ };
42
+ const messageOf = (value, message, text, sender, connection) => {
43
+ const context = message.context;
44
+ const quoted = context?.id != null && context.id !== ''
45
+ ? isBotNumber(context.from, value.metadata, connection)
46
+ ? botOf(value.metadata, connection)
47
+ : context.from != null && context.from !== ''
48
+ ? context.from === message.from ? sender : { id: context.from, bot: false }
49
+ : undefined
50
+ : undefined;
51
+ return {
52
+ ref: { chat: message.from, id: message.id },
53
+ text,
54
+ date: iso(message.timestamp),
55
+ ...(context?.id != null && context.id !== ''
56
+ ? { replyTo: { chat: message.from, id: context.id, ...(quoted != null ? { sender: quoted } : {}) } }
57
+ : {}),
58
+ };
59
+ };
60
+ const changeOf = (value, connection) => {
61
+ const own = connection.identity?.id;
62
+ const number = value.metadata?.phone_number_id;
63
+ // One app posts every number's messages to one URL: another number's are not this connection's.
64
+ if (own != null && own !== '' && number != null && number !== '' && number !== own) {
65
+ return [];
66
+ }
67
+ const updates = [];
68
+ for (const message of Array.isArray(value.messages) ? value.messages : []) {
69
+ if (message == null || typeof message.id !== 'string' || typeof message.from !== 'string') {
70
+ continue;
71
+ }
72
+ const text = textOf(message);
73
+ if (text == null) {
74
+ continue;
75
+ }
76
+ const contact = contactOf(value, message);
77
+ const name = contact?.profile?.name;
78
+ const sender = { id: message.from, ...(name != null && name !== '' ? { name } : {}), bot: false };
79
+ const command = botCommandHelper.parse(text) ?? undefined;
80
+ updates.push({
81
+ platformId: message.id,
82
+ update: {
83
+ kind: command != null ? BotUpdateKind.Command : BotUpdateKind.Message,
84
+ chat: { id: message.from, kind: BotChatKind.Private, ...(sender.name != null ? { title: sender.name } : {}) },
85
+ sender,
86
+ message: messageOf(value, message, text, sender, connection),
87
+ ...(command != null ? { command } : {}),
88
+ // Cloud API messages are one-to-one: every one is written to the bot.
89
+ addressed: true,
90
+ raw: { metadata: value.metadata, ...(contact != null ? { contact } : {}), message },
91
+ },
92
+ });
93
+ }
94
+ return updates;
95
+ };
96
+ const normalize = (payload, connection) => {
97
+ const webhook = payload;
98
+ if (webhook == null || typeof webhook !== 'object' || webhook.object !== WHATSAPP_WEBHOOK_OBJECT
99
+ || !Array.isArray(webhook.entry)) {
100
+ return [];
101
+ }
102
+ return webhook.entry.flatMap(entry => (Array.isArray(entry?.changes) ? entry.changes : [])
103
+ .filter(change => change?.field === WHATSAPP_MESSAGES_FIELD && change.value != null && typeof change.value === 'object')
104
+ .flatMap(change => changeOf(change.value, connection)));
105
+ };
106
+ return { normalize };
107
+ };
108
+ export const whatsappNormalizer = createWhatsAppNormalizer();
109
+ //# sourceMappingURL=normalize.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"normalize.js","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,13 @@
1
+ import type { BotPlatformPlugin } from '@owlmeans/server-bot';
2
+ import type { WhatsAppBotPlatformOptions } from './types.js';
3
+ /**
4
+ * The WhatsApp plugin over the Cloud API (https://developers.facebook.com/docs/whatsapp/cloud-api):
5
+ * `GET /<phone-number-id>` verifies, a person sets the callback URL and verify token in Meta's
6
+ * console (no hook registration), Meta's `hub.challenge` handshake and its `X-Hub-Signature-256`
7
+ * authenticate, and `POST /<phone-number-id>/messages` replies, sends and reacts. Chats are
8
+ * one-to-one with a customer's `wa_id`; nothing can be deleted, muted or banned.
9
+ */
10
+ export declare const makeWhatsAppBotPlatform: (opts?: WhatsAppBotPlatformOptions) => BotPlatformPlugin;
11
+ /** The built-in instance (`https://graph.facebook.com/v26.0`) — its `mock` is the one simulated connections use. */
12
+ export declare const whatsappBotPlatform: BotPlatformPlugin;
13
+ //# sourceMappingURL=plugin.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,iBAAiB,EAClB,MAAM,sBAAsB,CAAA;AAY7B,OAAO,KAAK,EAAE,0BAA0B,EAA2C,MAAM,YAAY,CAAA;AAErG;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,UAAU,0BAA0B,KAAQ,iBAuJ/E,CAAA;AAED,oHAAoH;AACpH,eAAO,MAAM,mBAAmB,mBAA4B,CAAA"}
@@ -0,0 +1,147 @@
1
+ import { BotActionKind, BotCredentialsRejected, BotTransport, BotUnsupportedAction, } from '@owlmeans/bot';
2
+ import { botHookHelper } from '@owlmeans/server-bot';
3
+ import { makeWhatsAppApi } from './api.js';
4
+ import { WHATSAPP_API_BASE, WHATSAPP_API_VERSION, WHATSAPP_CREDENTIAL_ERROR_CODES, WHATSAPP_CREDENTIAL_STATUSES, WHATSAPP_DESCRIPTOR, WHATSAPP_HUB_MODE, WHATSAPP_MESSAGES_FIELD, WHATSAPP_MESSAGING_PRODUCT, WHATSAPP_PHONE_FIELDS, WHATSAPP_PLATFORM, WHATSAPP_SETUP_CONSOLE, WHATSAPP_SETUP_STEPS, WHATSAPP_SIGNATURE_HEADER, WHATSAPP_TEXT_MAX, WHATSAPP_VERIFY_CREDENTIALS, } from './consts.js';
5
+ import { WhatsAppApiError } from './errors.js';
6
+ import { makeWhatsAppMock } from './mock.js';
7
+ import { whatsappNormalizer } from './normalize.js';
8
+ import { whatsappSignatureHelper } from './signature.js';
9
+ /**
10
+ * The WhatsApp plugin over the Cloud API (https://developers.facebook.com/docs/whatsapp/cloud-api):
11
+ * `GET /<phone-number-id>` verifies, a person sets the callback URL and verify token in Meta's
12
+ * console (no hook registration), Meta's `hub.challenge` handshake and its `X-Hub-Signature-256`
13
+ * authenticate, and `POST /<phone-number-id>/messages` replies, sends and reacts. Chats are
14
+ * one-to-one with a customer's `wa_id`; nothing can be deleted, muted or banned.
15
+ */
16
+ export const makeWhatsAppBotPlatform = (opts = {}) => {
17
+ const root = `${(opts.base ?? WHATSAPP_API_BASE).replace(/\/+$/, '')}/${(opts.version ?? WHATSAPP_API_VERSION).replace(/^\/+|\/+$/g, '')}`;
18
+ const mock = makeWhatsAppMock();
19
+ const api = (session) => makeWhatsAppApi(session, root);
20
+ /** The business number calls go out from — a mock connection without one gets its fake number. */
21
+ const numberOf = (session) => {
22
+ const given = session.connection.credentials.phoneNumberId ?? '';
23
+ if (given !== '' || session.transport !== BotTransport.Mock) {
24
+ return given;
25
+ }
26
+ return mock.phoneNumberIdOf(session.connection);
27
+ };
28
+ /** Clipped to the text limit without splitting a surrogate pair. */
29
+ const clip = (text) => {
30
+ if (text.length <= WHATSAPP_TEXT_MAX) {
31
+ return text;
32
+ }
33
+ const cut = text.slice(0, WHATSAPP_TEXT_MAX - 1);
34
+ return `${/[\uD800-\uDBFF]$/.test(cut) ? cut.slice(0, -1) : cut}…`;
35
+ };
36
+ /** The verify token Meta's handshake must present: the typed one, else the hook secret (the core defaults it). */
37
+ const verifyTokenOf = (connection) => (connection.credentials.verifyToken ?? '') !== '' ? connection.credentials.verifyToken : connection.hookSecret;
38
+ /** The key Meta signs with: the app secret; a mock connection without one signs with its hook secret. */
39
+ const signingKeyOf = (connection) => {
40
+ const appSecret = connection.credentials.appSecret ?? '';
41
+ return appSecret !== '' || connection.transport !== BotTransport.Mock ? appSecret : connection.hookSecret;
42
+ };
43
+ const verify = async (session) => {
44
+ const number = numberOf(session);
45
+ if (session.transport === BotTransport.Live) {
46
+ const missing = WHATSAPP_VERIFY_CREDENTIALS.filter(key => (session.connection.credentials[key] ?? '') === '');
47
+ if (missing.length > 0) {
48
+ throw new BotCredentialsRejected(`missing:${missing.join(',')}`);
49
+ }
50
+ }
51
+ let phone;
52
+ try {
53
+ phone = await api(session).get(encodeURIComponent(number), { fields: WHATSAPP_PHONE_FIELDS });
54
+ }
55
+ catch (error) {
56
+ if (error instanceof WhatsAppApiError
57
+ && (WHATSAPP_CREDENTIAL_ERROR_CODES.includes(error.code) || WHATSAPP_CREDENTIAL_STATUSES.includes(error.status))) {
58
+ throw new BotCredentialsRejected(`whatsapp:${error.code}`);
59
+ }
60
+ throw error;
61
+ }
62
+ return {
63
+ id: `${phone.id ?? number}`,
64
+ ...(phone.display_phone_number != null && phone.display_phone_number !== '' ? { username: phone.display_phone_number } : {}),
65
+ ...(phone.verified_name != null && phone.verified_name !== '' ? { name: phone.verified_name } : {}),
66
+ };
67
+ };
68
+ const setup = (connection) => [
69
+ WHATSAPP_SETUP_CONSOLE,
70
+ connection.hookUrl != null && connection.hookUrl !== ''
71
+ ? `Set the Callback URL to ${connection.hookUrl}`
72
+ : 'Set the Callback URL to this connection\'s hook URL — save the connection from the application\'s public address to see it.',
73
+ `Set the Verify token to ${verifyTokenOf(connection)}`,
74
+ ...WHATSAPP_SETUP_STEPS,
75
+ ];
76
+ /** A query value as text — the first of a repeated one; a `hub[mode]`-style nested parse is read too. */
77
+ const hubParam = (query, name) => {
78
+ const flat = query?.[`hub.${name}`];
79
+ const nested = query?.hub?.[name];
80
+ const value = flat ?? nested;
81
+ return Array.isArray(value) ? (typeof value[0] === 'string' ? value[0] : undefined) : typeof value === 'string' ? value : undefined;
82
+ };
83
+ const authenticate = (request, connection) => {
84
+ const method = request.method.toUpperCase();
85
+ if (method === 'GET') {
86
+ if (hubParam(request.query, 'mode') !== WHATSAPP_HUB_MODE) {
87
+ return { result: 'reject', reason: 'hub-mode' };
88
+ }
89
+ if (!botHookHelper.sameSecret(hubParam(request.query, 'verify_token'), verifyTokenOf(connection))) {
90
+ return { result: 'reject', reason: 'verify-token' };
91
+ }
92
+ const challenge = hubParam(request.query, 'challenge');
93
+ if (challenge == null || challenge === '') {
94
+ return { result: 'reject', reason: 'hub-challenge' };
95
+ }
96
+ return { result: 'challenge', text: challenge };
97
+ }
98
+ if (method !== 'POST') {
99
+ return { result: 'reject', reason: 'method' };
100
+ }
101
+ const key = signingKeyOf(connection);
102
+ if (key === '') {
103
+ return { result: 'reject', reason: 'app-secret-missing' };
104
+ }
105
+ return whatsappSignatureHelper.verify(botHookHelper.header(request, WHATSAPP_SIGNATURE_HEADER), botHookHelper.rawText(request), key)
106
+ ? { result: 'ok' }
107
+ : { result: 'reject', reason: 'signature' };
108
+ };
109
+ const message = async (session, to, content) => await api(session).post(`${encodeURIComponent(numberOf(session))}/${WHATSAPP_MESSAGES_FIELD}`, { messaging_product: WHATSAPP_MESSAGING_PRODUCT, recipient_type: 'individual', to, ...content });
110
+ const createdOf = (answer, chat) => {
111
+ const id = answer?.messages?.[0]?.id;
112
+ return typeof id === 'string' && id !== '' ? { message: { chat, id } } : {};
113
+ };
114
+ const act = async (session, action) => {
115
+ switch (action.kind) {
116
+ case BotActionKind.Reply:
117
+ return createdOf(await message(session, action.to.chat, {
118
+ context: { message_id: action.to.id }, type: 'text', text: { body: clip(action.text) },
119
+ }), action.to.chat);
120
+ case BotActionKind.Send:
121
+ return createdOf(await message(session, action.chat.id, {
122
+ type: 'text', text: { body: clip(action.text) },
123
+ }), action.chat.id);
124
+ case BotActionKind.React:
125
+ await message(session, action.message.chat, {
126
+ type: 'reaction', reaction: { message_id: action.message.id, emoji: action.emoji },
127
+ });
128
+ return {};
129
+ default:
130
+ // The Cloud API cannot delete a customer's message, mute or ban — the core refuses first.
131
+ throw new BotUnsupportedAction(action.kind);
132
+ }
133
+ };
134
+ return {
135
+ platform: WHATSAPP_PLATFORM,
136
+ descriptor: WHATSAPP_DESCRIPTOR,
137
+ verify,
138
+ setup,
139
+ authenticate,
140
+ normalize: whatsappNormalizer.normalize,
141
+ act,
142
+ mock,
143
+ };
144
+ };
145
+ /** The built-in instance (`https://graph.facebook.com/v26.0`) — its `mock` is the one simulated connections use. */
146
+ export const whatsappBotPlatform = makeWhatsAppBotPlatform();
147
+ //# sourceMappingURL=plugin.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,4 @@
1
+ import type { WhatsAppSignatureHelper } from './types.js';
2
+ export declare const createWhatsAppSignatureHelper: () => WhatsAppSignatureHelper;
3
+ export declare const whatsappSignatureHelper: WhatsAppSignatureHelper;
4
+ //# sourceMappingURL=signature.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signature.d.ts","sourceRoot":"","sources":["../src/signature.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAA;AAEzD,eAAO,MAAM,6BAA6B,QAAO,uBAmBhD,CAAA;AAED,eAAO,MAAM,uBAAuB,yBAAkC,CAAA"}
@@ -0,0 +1,20 @@
1
+ import { createHmac } from 'node:crypto';
2
+ import { botHookHelper } from '@owlmeans/server-bot';
3
+ import { WHATSAPP_SIGNATURE_PREFIX } from './consts.js';
4
+ export const createWhatsAppSignatureHelper = () => {
5
+ const digestOf = (rawBody, secret) => createHmac('sha256', secret).update(rawBody, 'utf8').digest('hex');
6
+ const sign = (rawBody, secret) => `${WHATSAPP_SIGNATURE_PREFIX}${digestOf(rawBody, secret)}`;
7
+ const verify = (header, rawBody, secret) => {
8
+ if (typeof header !== 'string' || secret === '') {
9
+ return false;
10
+ }
11
+ const presented = header.trim();
12
+ if (!presented.toLowerCase().startsWith(WHATSAPP_SIGNATURE_PREFIX)) {
13
+ return false;
14
+ }
15
+ return botHookHelper.sameSecret(presented.slice(WHATSAPP_SIGNATURE_PREFIX.length).toLowerCase(), digestOf(rawBody, secret));
16
+ };
17
+ return { sign, verify };
18
+ };
19
+ export const whatsappSignatureHelper = createWhatsAppSignatureHelper();
20
+ //# sourceMappingURL=signature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"signature.js","sourceRoot":"","sources":["../src/signature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAA;AAGvD,MAAM,CAAC,MAAM,6BAA6B,GAAG,GAA4B,EAAE;IACzE,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAE,MAAc,EAAU,EAAE,CAC3D,UAAU,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAEpE,MAAM,IAAI,GAAG,CAAC,OAAe,EAAE,MAAc,EAAU,EAAE,CAAC,GAAG,yBAAyB,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAA;IAEpH,MAAM,MAAM,GAAG,CAAC,MAA0B,EAAE,OAAe,EAAE,MAAc,EAAW,EAAE;QACtF,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,EAAE,EAAE,CAAC;YAChD,OAAO,KAAK,CAAA;QACd,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,EAAE,CAAA;QAC/B,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,yBAAyB,CAAC,EAAE,CAAC;YACnE,OAAO,KAAK,CAAA;QACd,CAAC;QAED,OAAO,aAAa,CAAC,UAAU,CAAC,SAAS,CAAC,KAAK,CAAC,yBAAyB,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAA;IAC7H,CAAC,CAAA;IAED,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAA;AACzB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAG,6BAA6B,EAAE,CAAA"}