copilotz 1.0.0-rc.20 → 1.0.0-rc.21
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/CHANGELOG.md +417 -0
- package/README.md +295 -19
- package/hosts/orgs/mod.d.ts +4 -1
- package/hosts/orgs/mod.js +2 -2
- package/hosts/web/files.d.ts +6 -2
- package/hosts/web/files.js +36 -3
- package/hosts/web/node/mod.d.ts +1 -1
- package/hosts/web/node/mod.js +1 -1
- package/hosts/web/node/serve.d.ts +26 -0
- package/hosts/web/node/serve.js +23 -1
- package/hosts/web/routes.d.ts +28 -1
- package/hosts/web/routes.js +65 -10
- package/hosts/web/server.d.ts +5 -4
- package/hosts/web/server.js +1 -1
- package/package.json +2 -2
- package/plugins/access/accounts/collections/account.d.ts +2 -2
- package/plugins/access/contacts/actions/chat.d.ts +1 -0
- package/plugins/access/contacts/actions/chat.js +45 -0
- package/plugins/access/contacts/actions/forget.d.ts +1 -0
- package/plugins/access/contacts/actions/forget.js +56 -0
- package/plugins/access/contacts/actions/start.d.ts +1 -0
- package/plugins/access/contacts/actions/start.js +50 -0
- package/plugins/access/contacts/collections/contact.d.ts +81 -0
- package/plugins/access/contacts/collections/contact.js +58 -0
- package/plugins/access/contacts/contract.d.ts +10 -0
- package/plugins/access/contacts/contract.js +10 -0
- package/plugins/access/contacts/mod.d.ts +27 -0
- package/plugins/access/contacts/mod.js +49 -0
- package/plugins/access/contacts/views/contact.d.ts +8 -0
- package/plugins/access/contacts/views/contact.js +25 -0
- package/plugins/access/contacts/web.d.ts +7 -0
- package/plugins/access/contacts/web.js +11 -0
- package/plugins/access/directory/collections/credit-code.d.ts +1 -1
- package/plugins/access/directory/collections/invite.d.ts +1 -1
- package/plugins/access/identity/mod.js +8 -6
- package/plugins/access/mod.d.ts +7 -1
- package/plugins/access/mod.js +7 -2
- package/plugins/access/spaces/actions/agents.js +12 -6
- package/plugins/access/spaces/actions/create.js +10 -1
- package/plugins/access/spaces/actions/invitation.js +5 -2
- package/plugins/access/spaces/actions/keep.d.ts +1 -0
- package/plugins/access/spaces/actions/keep.js +55 -0
- package/plugins/access/spaces/actions/member.js +17 -4
- package/plugins/access/spaces/actions/rename.js +4 -0
- package/plugins/access/spaces/collections/member.d.ts +1 -1
- package/plugins/access/spaces/collections/request.d.ts +1 -1
- package/plugins/access/spaces/collections/space.d.ts +9 -0
- package/plugins/access/spaces/collections/space.js +2 -0
- package/plugins/access/spaces/contract.d.ts +4 -3
- package/plugins/access/spaces/contract.js +1 -1
- package/plugins/access/spaces/mod.d.ts +7 -1
- package/plugins/access/spaces/mod.js +8 -1
- package/plugins/access/spaces/resources/tools.d.ts +0 -5
- package/plugins/access/spaces/resources/tools.js +11 -1
- package/plugins/access/spaces/shared/agents.js +2 -2
- package/plugins/access/spaces/shared/can.d.ts +18 -3
- package/plugins/access/spaces/shared/can.js +32 -5
- package/plugins/access/spaces/shared/declared.d.ts +21 -0
- package/plugins/access/spaces/shared/declared.js +8 -0
- package/plugins/access/spaces/shared/labels.d.ts +7 -1
- package/plugins/access/spaces/shared/labels.js +56 -8
- package/plugins/access/spaces/shared/managers.js +2 -2
- package/plugins/access/spaces/shared/names.d.ts +9 -5
- package/plugins/access/spaces/shared/names.js +36 -19
- package/plugins/access/spaces/shared/reach.d.ts +20 -6
- package/plugins/access/spaces/shared/reach.js +62 -20
- package/plugins/access/spaces/shared/rules.d.ts +10 -5
- package/plugins/access/spaces/shared/rules.js +35 -10
- package/plugins/access/spaces/shared/seat.d.ts +3 -2
- package/plugins/access/spaces/shared/seat.js +9 -2
- package/plugins/access/spaces/views/where.d.ts +4 -2
- package/plugins/access/spaces/views/where.js +9 -0
- package/plugins/access/spaces/web.js +1 -1
- package/plugins/access/web.d.ts +1 -0
- package/plugins/access/web.js +1 -0
- package/plugins/agents/chat/actions/erase.d.ts +1 -0
- package/plugins/agents/chat/actions/erase.js +51 -0
- package/plugins/agents/chat/actions/open.d.ts +1 -0
- package/plugins/agents/chat/actions/open.js +49 -0
- package/plugins/agents/chat/actions/quiet.d.ts +1 -0
- package/plugins/agents/chat/actions/quiet.js +33 -0
- package/plugins/agents/chat/actions/say.d.ts +1 -0
- package/plugins/agents/chat/actions/say.js +82 -0
- package/plugins/agents/chat/actions/send.js +57 -19
- package/plugins/agents/chat/actions/shown.d.ts +1 -0
- package/plugins/agents/chat/actions/shown.js +35 -0
- package/plugins/agents/chat/collections/intent.d.ts +124 -0
- package/plugins/agents/chat/collections/intent.js +52 -0
- package/plugins/agents/chat/collections/message.d.ts +74 -1
- package/plugins/agents/chat/collections/message.js +23 -1
- package/plugins/agents/chat/collections/shown.d.ts +105 -0
- package/plugins/agents/chat/collections/shown.js +34 -0
- package/plugins/agents/chat/contract.d.ts +15 -7
- package/plugins/agents/chat/contract.js +7 -1
- package/plugins/agents/chat/mod.d.ts +20 -2
- package/plugins/agents/chat/mod.js +43 -4
- package/plugins/agents/chat/processors/failed.js +15 -5
- package/plugins/agents/chat/processors/turn.d.ts +1 -1
- package/plugins/agents/chat/processors/turn.js +95 -35
- package/plugins/agents/chat/shared/delivery.d.ts +16 -2
- package/plugins/agents/chat/shared/delivery.js +62 -7
- package/plugins/agents/chat/shared/send.d.ts +1 -3
- package/plugins/agents/chat/shared/send.js +2 -9
- package/plugins/agents/chat/shared/tools.d.ts +33 -0
- package/plugins/agents/chat/shared/tools.js +28 -0
- package/plugins/agents/chat/shared/types.d.ts +59 -1
- package/plugins/agents/chat/views/message.d.ts +4 -2
- package/plugins/agents/chat/views/message.js +22 -4
- package/plugins/agents/chat/views/prompt.js +38 -4
- package/plugins/agents/history/collections/outline.d.ts +1 -1
- package/plugins/agents/history/collections/summary.d.ts +1 -1
- package/plugins/agents/history/mod.js +2 -1
- package/plugins/agents/history/processors/erase.d.ts +3 -0
- package/plugins/agents/history/processors/erase.js +11 -0
- package/plugins/agents/memory/mod.js +2 -1
- package/plugins/agents/memory/processors/extract.d.ts +1 -1
- package/plugins/agents/memory/processors/extract.js +5 -0
- package/plugins/agents/memory/resources/tools.js +1 -1
- package/plugins/agents/memory/shared/settings.d.ts +7 -2
- package/plugins/agents/memory/shared/settings.js +9 -1
- package/plugins/agents/routines/collections/routine.d.ts +1 -1
- package/plugins/agents/routines/collections/run.d.ts +1 -1
- package/plugins/compute/apps/collections/app.d.ts +2 -2
- package/plugins/compute/cloud/resources/tools.js +3 -3
- package/plugins/compute/computers/collections/approval.d.ts +2 -2
- package/plugins/compute/computers/collections/grant.d.ts +1 -1
- package/plugins/compute/computers/collections/preview.d.ts +2 -2
- package/plugins/compute/computers/program/version.d.ts +1 -1
- package/plugins/compute/computers/program/version.js +1 -1
- package/plugins/compute/computers/resources/downloads.js +1 -1
- package/plugins/compute/computers/shared/wake.d.ts +1 -1
- package/plugins/compute/computers/shared/wake.js +17 -0
- package/plugins/interfaces/api/collections/key.d.ts +1 -1
- package/plugins/interfaces/api/shared/events.js +5 -4
- package/plugins/interfaces/maintenance/actions/read.d.ts +4 -0
- package/plugins/interfaces/maintenance/actions/read.js +76 -0
- package/plugins/interfaces/maintenance/actions/write.d.ts +4 -0
- package/plugins/interfaces/maintenance/actions/write.js +64 -0
- package/plugins/interfaces/maintenance/contract.d.ts +60 -0
- package/plugins/interfaces/maintenance/contract.js +2 -0
- package/plugins/interfaces/maintenance/mod.d.ts +52 -0
- package/plugins/interfaces/maintenance/mod.js +66 -0
- package/plugins/interfaces/maintenance/resources/routes.d.ts +71 -0
- package/plugins/interfaces/maintenance/resources/routes.js +457 -0
- package/plugins/interfaces/maintenance/shared/ops.d.ts +4 -0
- package/plugins/interfaces/maintenance/shared/ops.js +19 -0
- package/plugins/interfaces/mcp/actions/call.d.ts +11 -0
- package/plugins/interfaces/mcp/actions/call.js +304 -0
- package/plugins/interfaces/mcp/actions/prune.d.ts +1 -0
- package/plugins/interfaces/mcp/actions/prune.js +18 -0
- package/plugins/interfaces/mcp/collections/closed.d.ts +23 -0
- package/plugins/interfaces/mcp/collections/closed.js +17 -0
- package/plugins/interfaces/mcp/collections/rate.d.ts +27 -0
- package/plugins/interfaces/mcp/collections/rate.js +18 -0
- package/plugins/interfaces/mcp/collections/receipt.d.ts +46 -0
- package/plugins/interfaces/mcp/collections/receipt.js +46 -0
- package/plugins/interfaces/mcp/contract.d.ts +9 -0
- package/plugins/interfaces/mcp/contract.js +9 -0
- package/plugins/interfaces/mcp/mod.d.ts +84 -0
- package/plugins/interfaces/mcp/mod.js +122 -0
- package/plugins/interfaces/mcp/processors/closed.d.ts +13 -0
- package/plugins/interfaces/mcp/processors/closed.js +16 -0
- package/plugins/interfaces/mcp/resources/running.d.ts +21 -0
- package/plugins/interfaces/mcp/resources/running.js +36 -0
- package/plugins/interfaces/mcp/resources/server.d.ts +54 -0
- package/plugins/interfaces/mcp/resources/server.js +423 -0
- package/plugins/interfaces/mcp/resources/tools.d.ts +114 -0
- package/plugins/interfaces/mcp/resources/tools.js +324 -0
- package/plugins/interfaces/mcp/shared/caller.d.ts +45 -0
- package/plugins/interfaces/mcp/shared/caller.js +99 -0
- package/plugins/interfaces/mcp/shared/keys.d.ts +50 -0
- package/plugins/interfaces/mcp/shared/keys.js +53 -0
- package/plugins/interfaces/mcp/shared/settings.d.ts +187 -0
- package/plugins/interfaces/mcp/shared/settings.js +176 -0
- package/plugins/interfaces/mcp/views/offered.d.ts +20 -0
- package/plugins/interfaces/mcp/views/offered.js +20 -0
- package/plugins/interfaces/mod.d.ts +5 -1
- package/plugins/interfaces/mod.js +5 -1
- package/plugins/interfaces/terminal/actions/print.js +1 -1
- package/plugins/interfaces/terminal/actions/set.js +1 -1
- package/plugins/interfaces/terminal/collections/output.d.ts +1 -1
- package/plugins/interfaces/terminal/collections/shell.js +1 -1
- package/plugins/interfaces/voice/actions/block.d.ts +2 -0
- package/plugins/interfaces/voice/actions/block.js +74 -0
- package/plugins/interfaces/voice/actions/call.d.ts +19 -0
- package/plugins/interfaces/voice/actions/call.js +253 -0
- package/plugins/interfaces/voice/actions/hook.d.ts +5 -0
- package/plugins/interfaces/voice/actions/hook.js +225 -0
- package/plugins/interfaces/voice/actions/prune.d.ts +1 -0
- package/plugins/interfaces/voice/actions/prune.js +35 -0
- package/plugins/interfaces/voice/collections/blocked.d.ts +87 -0
- package/plugins/interfaces/voice/collections/blocked.js +34 -0
- package/plugins/interfaces/voice/collections/call.d.ts +279 -0
- package/plugins/interfaces/voice/collections/call.js +77 -0
- package/plugins/interfaces/voice/collections/phone.d.ts +74 -0
- package/plugins/interfaces/voice/collections/phone.js +26 -0
- package/plugins/interfaces/voice/contract.d.ts +14 -0
- package/plugins/interfaces/voice/contract.js +2 -0
- package/plugins/interfaces/voice/mod.d.ts +57 -0
- package/plugins/interfaces/voice/mod.js +118 -0
- package/plugins/interfaces/voice/processors/forget.d.ts +13 -0
- package/plugins/interfaces/voice/processors/forget.js +27 -0
- package/plugins/interfaces/voice/resources/relay.d.ts +77 -0
- package/plugins/interfaces/voice/resources/relay.js +428 -0
- package/plugins/interfaces/voice/resources/tools.d.ts +1 -0
- package/plugins/interfaces/voice/resources/tools.js +25 -0
- package/plugins/interfaces/voice/shared/caller.d.ts +27 -0
- package/plugins/interfaces/voice/shared/caller.js +38 -0
- package/plugins/interfaces/voice/shared/settings.d.ts +136 -0
- package/plugins/interfaces/voice/shared/settings.js +121 -0
- package/plugins/interfaces/voice/shared/signature.d.ts +11 -0
- package/plugins/interfaces/voice/shared/signature.js +34 -0
- package/plugins/interfaces/voice/views/call.d.ts +41 -0
- package/plugins/interfaces/voice/views/call.js +30 -0
- package/plugins/interfaces/voice/views/context.d.ts +9 -0
- package/plugins/interfaces/voice/views/context.js +14 -0
- package/plugins/interfaces/voice/views/message.d.ts +17 -0
- package/plugins/interfaces/voice/views/message.js +41 -0
- package/plugins/interfaces/whatsapp/actions/connect.js +3 -0
- package/plugins/interfaces/whatsapp/actions/disconnect.js +4 -1
- package/plugins/interfaces/whatsapp/actions/hook.js +27 -11
- package/plugins/interfaces/whatsapp/actions/set.d.ts +8 -0
- package/plugins/interfaces/whatsapp/actions/set.js +121 -0
- package/plugins/interfaces/whatsapp/collections/blocked.d.ts +29 -0
- package/plugins/interfaces/whatsapp/collections/blocked.js +22 -0
- package/plugins/interfaces/whatsapp/collections/code.d.ts +1 -1
- package/plugins/interfaces/whatsapp/collections/number.d.ts +90 -4
- package/plugins/interfaces/whatsapp/collections/number.js +36 -4
- package/plugins/interfaces/whatsapp/collections/phone.d.ts +13 -3
- package/plugins/interfaces/whatsapp/collections/phone.js +9 -3
- package/plugins/interfaces/whatsapp/collections/rate.d.ts +27 -0
- package/plugins/interfaces/whatsapp/collections/rate.js +13 -0
- package/plugins/interfaces/whatsapp/collections/sent.d.ts +24 -12
- package/plugins/interfaces/whatsapp/collections/sent.js +11 -7
- package/plugins/interfaces/whatsapp/collections/thread.d.ts +14 -6
- package/plugins/interfaces/whatsapp/collections/thread.js +7 -5
- package/plugins/interfaces/whatsapp/collections/typing.d.ts +70 -0
- package/plugins/interfaces/whatsapp/collections/typing.js +21 -0
- package/plugins/interfaces/whatsapp/contract.d.ts +27 -4
- package/plugins/interfaces/whatsapp/contract.js +34 -1
- package/plugins/interfaces/whatsapp/events/undelivered.d.ts +8 -0
- package/plugins/interfaces/whatsapp/events/undelivered.js +17 -0
- package/plugins/interfaces/whatsapp/mod.d.ts +28 -2
- package/plugins/interfaces/whatsapp/mod.js +65 -6
- package/plugins/interfaces/whatsapp/processors/forget.d.ts +6 -0
- package/plugins/interfaces/whatsapp/processors/forget.js +11 -0
- package/plugins/interfaces/whatsapp/processors/receive.d.ts +17 -3
- package/plugins/interfaces/whatsapp/processors/receive.js +264 -81
- package/plugins/interfaces/whatsapp/processors/reply.d.ts +25 -5
- package/plugins/interfaces/whatsapp/processors/reply.js +216 -20
- package/plugins/interfaces/whatsapp/processors/typing.d.ts +8 -0
- package/plugins/interfaces/whatsapp/processors/typing.js +25 -0
- package/plugins/interfaces/whatsapp/shared/customers.d.ts +13 -0
- package/plugins/interfaces/whatsapp/shared/customers.js +16 -0
- package/plugins/interfaces/whatsapp/shared/graph.d.ts +31 -6
- package/plugins/interfaces/whatsapp/shared/graph.js +117 -10
- package/plugins/interfaces/whatsapp/shared/media.d.ts +23 -0
- package/plugins/interfaces/whatsapp/shared/media.js +46 -0
- package/plugins/interfaces/whatsapp/shared/number.d.ts +19 -8
- package/plugins/interfaces/whatsapp/shared/number.js +64 -7
- package/plugins/interfaces/whatsapp/shared/parts.d.ts +94 -0
- package/plugins/interfaces/whatsapp/shared/parts.js +184 -0
- package/plugins/interfaces/whatsapp/shared/payload.d.ts +27 -1
- package/plugins/interfaces/whatsapp/shared/payload.js +36 -1
- package/plugins/interfaces/whatsapp/shared/settings.d.ts +49 -1
- package/plugins/interfaces/whatsapp/shared/settings.js +11 -0
- package/plugins/interfaces/whatsapp/views/message.d.ts +13 -0
- package/plugins/interfaces/whatsapp/views/message.js +13 -0
- package/plugins/interfaces/whatsapp/views/web/line.d.ts +24 -0
- package/plugins/interfaces/whatsapp/views/web/line.js +44 -0
- package/plugins/interfaces/whatsapp/views/web/space.d.ts +7 -5
- package/plugins/interfaces/whatsapp/views/web/space.js +17 -10
- package/plugins/interfaces/whatsapp/views/web/style.d.ts +1 -1
- package/plugins/interfaces/whatsapp/views/web/style.js +8 -0
- package/plugins/models/adapters/llm/anthropic.d.ts +1 -1
- package/plugins/models/adapters/llm/anthropic.js +28 -15
- package/plugins/models/adapters/llm/gemini.d.ts +1 -1
- package/plugins/models/adapters/llm/gemini.js +2 -1
- package/plugins/models/adapters/llm/openai-compatible.d.ts +1 -1
- package/plugins/models/adapters/llm/openai-compatible.js +2 -1
- package/plugins/models/adapters/llm/openai.d.ts +1 -1
- package/plugins/models/adapters/llm/openai.js +16 -4
- package/plugins/models/shared/types.d.ts +8 -0
- package/plugins/models/shared/types.js +10 -0
- package/runtime/actor.d.ts +6 -0
- package/runtime/actor.js +9 -4
- package/runtime/aggregate.js +8 -2
- package/runtime/blobs.d.ts +15 -12
- package/runtime/blobs.js +58 -11
- package/runtime/cache.d.ts +6 -0
- package/runtime/cache.js +19 -1
- package/runtime/define.d.ts +10 -0
- package/runtime/errors.d.ts +20 -2
- package/runtime/errors.js +7 -1
- package/runtime/executor.js +27 -11
- package/runtime/links.d.ts +31 -0
- package/runtime/links.js +60 -0
- package/runtime/maintain.d.ts +88 -0
- package/runtime/maintain.js +120 -0
- package/runtime/memory.js +7 -4
- package/runtime/mod.d.ts +6 -4
- package/runtime/mod.js +5 -2
- package/runtime/mongo.d.ts +13 -0
- package/runtime/mongo.js +39 -8
- package/runtime/observe.d.ts +2 -0
- package/runtime/observe.js +14 -10
- package/runtime/ops.d.ts +5 -0
- package/runtime/ops.js +10 -1
- package/runtime/owner.d.ts +18 -1
- package/runtime/owner.js +127 -61
- package/runtime/presence.d.ts +18 -0
- package/runtime/presence.js +25 -0
- package/runtime/registry.d.ts +5 -0
- package/runtime/registry.js +18 -0
- package/runtime/runtime.js +9 -3
- package/runtime/store.d.ts +48 -1
- package/runtime/wire.d.ts +1 -0
- package/runtime/wire.js +3 -1
- package/stores/blobs/files/mod.js +4 -2
- package/stores/blobs/gcs/mod.d.ts +3 -0
- package/stores/blobs/gcs/mod.js +6 -5
- package/stores/blobs/http/mod.d.ts +1 -1
- package/stores/blobs/http/mod.js +2 -1
- package/stores/latency/mod.js +5 -1
- package/stores/sql/postgres/maintenance.d.ts +24 -0
- package/stores/sql/postgres/maintenance.js +258 -0
- package/stores/sql/postgres/mod.d.ts +20 -4
- package/stores/sql/postgres/mod.js +363 -96
- package/stores/sql/postgres/update.js +3 -1
- package/stores/sql/shared/capped.d.ts +2 -0
- package/stores/sql/shared/capped.js +22 -0
- package/stores/sql/shared/rows.d.ts +14 -0
- package/stores/sql/shared/rows.js +29 -0
- package/stores/sql/shared/statement.d.ts +12 -0
- package/stores/sql/shared/statement.js +244 -0
- package/stores/sql/sqlite/apart.d.ts +11 -0
- package/stores/sql/sqlite/apart.js +219 -0
- package/stores/sql/sqlite/mod.d.ts +16 -2
- package/stores/sql/sqlite/mod.js +246 -51
- package/testing/mod.js +1 -1
|
@@ -1,12 +1,20 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
|
|
1
|
+
import { sendPart, tokenRefused } from "./graph.js";
|
|
2
|
+
import { sendable } from "./media.js";
|
|
3
|
+
import { linesOf, settingsOf } from "./settings.js";
|
|
4
|
+
/**
|
|
5
|
+
* A number and its Graph API, read as the system (its token); null once it's
|
|
6
|
+
* disconnected. A line the app declares (its settings' `lines`) is kept as
|
|
7
|
+
* they say first: written when it isn't yet, or changed.
|
|
8
|
+
*/
|
|
4
9
|
export async function connected(ctx, id) {
|
|
5
10
|
const db = ctx.as().db;
|
|
6
|
-
|
|
11
|
+
let [number, own] = await Promise.all([
|
|
7
12
|
db.collection("whatsapp_number").findOne({ _id: id }),
|
|
8
13
|
db.collection("whatsapp_secret").findOne({ _id: id }),
|
|
9
14
|
]);
|
|
15
|
+
const line = linesOf(ctx)[id];
|
|
16
|
+
if (line)
|
|
17
|
+
[number, own] = await kept(ctx, id, line, number, own);
|
|
10
18
|
if (!number || !own)
|
|
11
19
|
return null;
|
|
12
20
|
return {
|
|
@@ -14,11 +22,60 @@ export async function connected(ctx, id) {
|
|
|
14
22
|
graph: { base: settingsOf(ctx).graph, phoneId: number.phoneId, token: own.token },
|
|
15
23
|
};
|
|
16
24
|
}
|
|
17
|
-
/**
|
|
18
|
-
|
|
25
|
+
/** A declared line's documents, as its settings say: written only when they don't yet. */
|
|
26
|
+
async function kept(ctx, id, line, number, own) {
|
|
27
|
+
const said = {
|
|
28
|
+
in: line.in,
|
|
29
|
+
phoneId: line.phoneId,
|
|
30
|
+
phone: line.phone ?? line.phoneId,
|
|
31
|
+
...(line.name ? { name: line.name } : {}),
|
|
32
|
+
open: true,
|
|
33
|
+
declared: true,
|
|
34
|
+
...(line.agent ? { agent: line.agent } : {}),
|
|
35
|
+
...(line.gap !== undefined ? { gap: line.gap } : {}),
|
|
36
|
+
...(line.rate !== undefined ? { rate: line.rate } : {}),
|
|
37
|
+
...(line.quiet !== undefined ? { quiet: line.quiet } : {}),
|
|
38
|
+
...(line.language ? { language: line.language } : {}),
|
|
39
|
+
by: "app",
|
|
40
|
+
};
|
|
41
|
+
const secret = { token: line.token, secret: line.secret, verify: line.verify };
|
|
42
|
+
// Its space, when the app declares that too (the spaces plugin's `spaces`): made, or kept, first.
|
|
43
|
+
const spaces = (ctx.resources.spaces ?? {});
|
|
44
|
+
const space = Object.hasOwn(spaces, line.in) ? spaces[line.in] : undefined;
|
|
45
|
+
if (space) {
|
|
46
|
+
const found = await ctx.as().db.collection("space")
|
|
47
|
+
.findOne({ _id: line.in });
|
|
48
|
+
if (!found?.declared || found.name !== space.name) {
|
|
49
|
+
await ctx.as().call("space.keep", { id: line.in });
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
const same = (a, b) => !!a && Object.keys(b).every((k) => JSON.stringify(a[k]) === JSON.stringify(b[k])) &&
|
|
53
|
+
["agent", "gap", "rate", "quiet", "language", "name"].every((k) => (k in b) || !(k in a));
|
|
54
|
+
const system = ctx.as().db;
|
|
55
|
+
if (!same(number, said)) {
|
|
56
|
+
const at = number?.at ?? new Date().toISOString();
|
|
57
|
+
await system.collection("whatsapp_number").replaceOne({ _id: id }, { ...said, at }, {
|
|
58
|
+
upsert: true,
|
|
59
|
+
});
|
|
60
|
+
number = { _id: id, ...said, at };
|
|
61
|
+
}
|
|
62
|
+
if (!same(own, secret)) {
|
|
63
|
+
await system.collection("whatsapp_secret").replaceOne({ _id: id }, secret, { upsert: true });
|
|
64
|
+
own = { _id: id, ...secret };
|
|
65
|
+
}
|
|
66
|
+
return [number, own];
|
|
67
|
+
}
|
|
68
|
+
/**
|
|
69
|
+
* Sends text or a part from the number, noting on it when Meta refuses its
|
|
70
|
+
* token; returns WhatsApp's id.
|
|
71
|
+
*/
|
|
72
|
+
export async function send(ctx, on, to, what,
|
|
73
|
+
/** Who it's for (a person, a contact): what it sends of theirs, they must read. */
|
|
74
|
+
reader) {
|
|
19
75
|
const numbers = ctx.as().db.collection("whatsapp_number");
|
|
76
|
+
const part = typeof what === "string" ? { type: "text", text: what } : what;
|
|
20
77
|
try {
|
|
21
|
-
const id = await
|
|
78
|
+
const id = await sendPart(on.graph, to, part, (media, linked) => sendable(ctx, on.graph, media, reader, linked));
|
|
22
79
|
if (on.number.problem) {
|
|
23
80
|
await numbers.updateOne({ _id: on.number._id }, { $unset: { problem: "" } });
|
|
24
81
|
delete on.number.problem;
|
|
@@ -0,0 +1,94 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A picture or a file to send: a `file` document of the chat (slice 3), a
|
|
3
|
+
* public https address as it is, or a signed link to one of the app's routes.
|
|
4
|
+
*/
|
|
5
|
+
export type WaMedia = {
|
|
6
|
+
file: string;
|
|
7
|
+
} | {
|
|
8
|
+
link: string;
|
|
9
|
+
} | {
|
|
10
|
+
route: string;
|
|
11
|
+
params: Record<string, string>;
|
|
12
|
+
};
|
|
13
|
+
/** A choice someone taps: what comes back (`id`) and what they read (`title`). */
|
|
14
|
+
export type Choice = {
|
|
15
|
+
id: string;
|
|
16
|
+
title: string;
|
|
17
|
+
};
|
|
18
|
+
export type Row = Choice & {
|
|
19
|
+
description?: string;
|
|
20
|
+
};
|
|
21
|
+
export type Section = {
|
|
22
|
+
title?: string;
|
|
23
|
+
rows: Row[];
|
|
24
|
+
};
|
|
25
|
+
export type Card = {
|
|
26
|
+
image: WaMedia;
|
|
27
|
+
body?: string;
|
|
28
|
+
buttons: Choice[];
|
|
29
|
+
};
|
|
30
|
+
export type WaPart = {
|
|
31
|
+
type: "text";
|
|
32
|
+
text: string;
|
|
33
|
+
} | {
|
|
34
|
+
type: "buttons";
|
|
35
|
+
text: string;
|
|
36
|
+
buttons: Choice[];
|
|
37
|
+
header?: string | WaMedia;
|
|
38
|
+
footer?: string;
|
|
39
|
+
} | {
|
|
40
|
+
type: "list";
|
|
41
|
+
text: string;
|
|
42
|
+
button: string;
|
|
43
|
+
sections: Section[];
|
|
44
|
+
header?: string;
|
|
45
|
+
footer?: string;
|
|
46
|
+
} | {
|
|
47
|
+
type: "carousel";
|
|
48
|
+
text: string;
|
|
49
|
+
cards: Card[];
|
|
50
|
+
} | {
|
|
51
|
+
type: "image";
|
|
52
|
+
image: WaMedia;
|
|
53
|
+
caption?: string;
|
|
54
|
+
} | {
|
|
55
|
+
type: "document";
|
|
56
|
+
document: WaMedia;
|
|
57
|
+
filename: string;
|
|
58
|
+
caption?: string;
|
|
59
|
+
};
|
|
60
|
+
/** How much text each part carries, at most: its body, or its caption. */
|
|
61
|
+
export declare const BODY: Record<WaPart["type"], number>;
|
|
62
|
+
/** `text`, cut to `max` characters with an ellipsis when it's longer: for titles. */
|
|
63
|
+
export declare const clip: (text: string, max: number) => string;
|
|
64
|
+
export declare function text(body: string): WaPart;
|
|
65
|
+
/** Up to three buttons under a text (with a header, text or a picture, and a footer). */
|
|
66
|
+
export declare function buttons(body: string, choices: Choice[], more?: {
|
|
67
|
+
header?: string | WaMedia;
|
|
68
|
+
footer?: string;
|
|
69
|
+
}): WaPart;
|
|
70
|
+
/** A list someone opens with `button`, of up to ten rows in all, in sections. */
|
|
71
|
+
export declare function list(body: string, button: string, sections: Section[], more?: {
|
|
72
|
+
header?: string;
|
|
73
|
+
footer?: string;
|
|
74
|
+
}): WaPart;
|
|
75
|
+
/**
|
|
76
|
+
* Cards side by side, each a picture (a public https link: Meta takes no
|
|
77
|
+
* uploaded one here), a short text and its quick replies (1 to 3, as many
|
|
78
|
+
* on each).
|
|
79
|
+
*/
|
|
80
|
+
export declare function carousel(body: string, cards: Card[]): WaPart;
|
|
81
|
+
/** A picture (jpeg or png, up to 5 MB), with a caption. */
|
|
82
|
+
export declare function image(picture: WaMedia, caption?: string): WaPart;
|
|
83
|
+
/** A file (up to 100 MB) by its name, with a caption. */
|
|
84
|
+
export declare function document(file: WaMedia, filename: string, caption?: string): WaPart;
|
|
85
|
+
/** What a part says in text: its body or caption (what an answer before it joins). */
|
|
86
|
+
export declare const wordsIn: (part: WaPart) => string;
|
|
87
|
+
/**
|
|
88
|
+
* Text before a part (an answer), as one message with it when the part can
|
|
89
|
+
* say it (its body or caption has room): undefined when it can't. The answer
|
|
90
|
+
* is the body: a part's own words are what it says without one (a question
|
|
91
|
+
* the answer asks already), unless they're kept (`keep`: a text, or a
|
|
92
|
+
* fallback, where they're what's shown).
|
|
93
|
+
*/
|
|
94
|
+
export declare function joined(before: string, part: WaPart, keep?: boolean): WaPart | undefined;
|
|
@@ -0,0 +1,184 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* WhatsApp as a medium: what a `whatsapp` View returns is a list of parts,
|
|
3
|
+
* each one WhatsApp message (text, buttons, a list, a carousel, an image, a
|
|
4
|
+
* document), built with these functions. Each checks Meta's limits and
|
|
5
|
+
* throws `invalid`, saying what's wrong: nothing is cut short silently, as
|
|
6
|
+
* ids and counts must be right (`clip` shortens a title on purpose).
|
|
7
|
+
*
|
|
8
|
+
* ```ts
|
|
9
|
+
* buttons("Pay with PIX or card?", [{ id: "pay:pix", title: "PIX" }, { id: "pay:card", title: "Card" }])
|
|
10
|
+
* carousel("Some trips for 12/11", trips.map((t) => ({
|
|
11
|
+
* image: { link: t.picture }, body: `${t.time} ${t.company}`, buttons: [{ id: `trip:${t.id}`, title: "Choose" }],
|
|
12
|
+
* })))
|
|
13
|
+
* ```
|
|
14
|
+
*/
|
|
15
|
+
import { invalid } from "../../../../runtime/mod.js";
|
|
16
|
+
import { LIMIT } from "./text.js";
|
|
17
|
+
/** How much text each part carries, at most: its body, or its caption. */
|
|
18
|
+
export const BODY = {
|
|
19
|
+
text: LIMIT,
|
|
20
|
+
buttons: 1024,
|
|
21
|
+
list: 4096,
|
|
22
|
+
carousel: 1024,
|
|
23
|
+
image: 1024,
|
|
24
|
+
document: 1024,
|
|
25
|
+
};
|
|
26
|
+
const fail = (what) => {
|
|
27
|
+
throw invalid(`WhatsApp: ${what}`);
|
|
28
|
+
};
|
|
29
|
+
/** Throws unless `value` is text of 1 to `max` characters (or empty, when it may be). */
|
|
30
|
+
function sized(what, value, max, empty = false) {
|
|
31
|
+
if (typeof value !== "string")
|
|
32
|
+
fail(`${what} must be text.`);
|
|
33
|
+
const text = value;
|
|
34
|
+
if (!text.trim() && !empty)
|
|
35
|
+
fail(`${what} is empty.`);
|
|
36
|
+
if (text.length > max)
|
|
37
|
+
fail(`${what} is ${text.length} characters: at most ${max}.`);
|
|
38
|
+
}
|
|
39
|
+
/** Throws unless every id is set, within `max`, and different from the others. */
|
|
40
|
+
function unique(what, choices, max) {
|
|
41
|
+
const seen = new Set();
|
|
42
|
+
for (const { id } of choices) {
|
|
43
|
+
sized(`${what} id`, id, max);
|
|
44
|
+
if (seen.has(id))
|
|
45
|
+
fail(`${what} id "${id}" is used twice.`);
|
|
46
|
+
seen.add(id);
|
|
47
|
+
}
|
|
48
|
+
}
|
|
49
|
+
function media(what, value) {
|
|
50
|
+
if ("link" in value) {
|
|
51
|
+
if (!/^https:\/\/\S+$/.test(value.link))
|
|
52
|
+
fail(`${what} must be a public https link.`);
|
|
53
|
+
}
|
|
54
|
+
else if ("file" in value)
|
|
55
|
+
sized(`${what} file`, value.file, 200);
|
|
56
|
+
else if ("route" in value)
|
|
57
|
+
sized(`${what} route`, value.route, 100);
|
|
58
|
+
else
|
|
59
|
+
fail(`${what} is a file, a link or a route.`);
|
|
60
|
+
}
|
|
61
|
+
/** `text`, cut to `max` characters with an ellipsis when it's longer: for titles. */
|
|
62
|
+
export const clip = (text, max) => text.length <= max ? text : `${text.slice(0, Math.max(0, max - 1)).trimEnd()}…`;
|
|
63
|
+
export function text(body) {
|
|
64
|
+
sized("A text", body, LIMIT);
|
|
65
|
+
return { type: "text", text: body };
|
|
66
|
+
}
|
|
67
|
+
/** Up to three buttons under a text (with a header, text or a picture, and a footer). */
|
|
68
|
+
export function buttons(body, choices, more = {}) {
|
|
69
|
+
sized("Buttons' text", body, BODY.buttons);
|
|
70
|
+
if (choices.length < 1 || choices.length > 3)
|
|
71
|
+
fail("Buttons are 1 to 3.");
|
|
72
|
+
for (const c of choices)
|
|
73
|
+
sized("A button's title", c.title, 20);
|
|
74
|
+
unique("A button's", choices, 256);
|
|
75
|
+
if (typeof more.header === "string")
|
|
76
|
+
sized("Buttons' header", more.header, 60);
|
|
77
|
+
else if (more.header)
|
|
78
|
+
media("Buttons' header", more.header);
|
|
79
|
+
if (more.footer !== undefined)
|
|
80
|
+
sized("Buttons' footer", more.footer, 60);
|
|
81
|
+
return {
|
|
82
|
+
type: "buttons",
|
|
83
|
+
text: body,
|
|
84
|
+
buttons: choices,
|
|
85
|
+
...(more.header ? { header: more.header } : {}),
|
|
86
|
+
...(more.footer ? { footer: more.footer } : {}),
|
|
87
|
+
};
|
|
88
|
+
}
|
|
89
|
+
/** A list someone opens with `button`, of up to ten rows in all, in sections. */
|
|
90
|
+
export function list(body, button, sections, more = {}) {
|
|
91
|
+
sized("A list's text", body, BODY.list);
|
|
92
|
+
sized("A list's button", button, 20);
|
|
93
|
+
if (sections.length < 1 || sections.length > 10)
|
|
94
|
+
fail("A list has 1 to 10 sections.");
|
|
95
|
+
const rows = sections.flatMap((s) => s.rows);
|
|
96
|
+
if (rows.length < 1 || rows.length > 10)
|
|
97
|
+
fail("A list has 1 to 10 rows in all.");
|
|
98
|
+
if (sections.length > 1 && sections.some((s) => !s.title)) {
|
|
99
|
+
fail("A list of several sections titles each one.");
|
|
100
|
+
}
|
|
101
|
+
for (const s of sections)
|
|
102
|
+
if (s.title !== undefined)
|
|
103
|
+
sized("A section's title", s.title, 24);
|
|
104
|
+
for (const r of rows) {
|
|
105
|
+
sized("A row's title", r.title, 24);
|
|
106
|
+
if (r.description !== undefined)
|
|
107
|
+
sized("A row's description", r.description, 72);
|
|
108
|
+
}
|
|
109
|
+
unique("A row's", rows, 200);
|
|
110
|
+
if (more.header !== undefined)
|
|
111
|
+
sized("A list's header", more.header, 60);
|
|
112
|
+
if (more.footer !== undefined)
|
|
113
|
+
sized("A list's footer", more.footer, 60);
|
|
114
|
+
return {
|
|
115
|
+
type: "list",
|
|
116
|
+
text: body,
|
|
117
|
+
button,
|
|
118
|
+
sections,
|
|
119
|
+
...(more.header ? { header: more.header } : {}),
|
|
120
|
+
...(more.footer ? { footer: more.footer } : {}),
|
|
121
|
+
};
|
|
122
|
+
}
|
|
123
|
+
/**
|
|
124
|
+
* Cards side by side, each a picture (a public https link: Meta takes no
|
|
125
|
+
* uploaded one here), a short text and its quick replies (1 to 3, as many
|
|
126
|
+
* on each).
|
|
127
|
+
*/
|
|
128
|
+
export function carousel(body, cards) {
|
|
129
|
+
sized("A carousel's text", body, BODY.carousel);
|
|
130
|
+
if (cards.length < 2 || cards.length > 10)
|
|
131
|
+
fail("A carousel has 2 to 10 cards.");
|
|
132
|
+
const count = cards[0].buttons.length;
|
|
133
|
+
for (const [i, card] of cards.entries()) {
|
|
134
|
+
media(`Card ${i + 1}'s picture`, card.image);
|
|
135
|
+
if (card.body !== undefined) {
|
|
136
|
+
sized(`Card ${i + 1}'s text`, card.body, 160);
|
|
137
|
+
if ((card.body.match(/\n/g) ?? []).length > 2) {
|
|
138
|
+
fail(`Card ${i + 1}'s text has over 2 breaks.`);
|
|
139
|
+
}
|
|
140
|
+
}
|
|
141
|
+
if (card.buttons.length < 1 || card.buttons.length > 3) {
|
|
142
|
+
fail(`Card ${i + 1} has 1 to 3 quick replies.`);
|
|
143
|
+
}
|
|
144
|
+
if (card.buttons.length !== count)
|
|
145
|
+
fail("Every card has as many quick replies.");
|
|
146
|
+
for (const b of card.buttons)
|
|
147
|
+
sized(`Card ${i + 1}'s reply title`, b.title, 20);
|
|
148
|
+
}
|
|
149
|
+
unique("A quick reply's", cards.flatMap((c) => c.buttons), 256);
|
|
150
|
+
return { type: "carousel", text: body, cards };
|
|
151
|
+
}
|
|
152
|
+
/** A picture (jpeg or png, up to 5 MB), with a caption. */
|
|
153
|
+
export function image(picture, caption) {
|
|
154
|
+
media("An image", picture);
|
|
155
|
+
if (caption !== undefined)
|
|
156
|
+
sized("An image's caption", caption, BODY.image, true);
|
|
157
|
+
return { type: "image", image: picture, ...(caption ? { caption } : {}) };
|
|
158
|
+
}
|
|
159
|
+
/** A file (up to 100 MB) by its name, with a caption. */
|
|
160
|
+
export function document(file, filename, caption) {
|
|
161
|
+
media("A document", file);
|
|
162
|
+
sized("A document's file name", filename, 240);
|
|
163
|
+
if (caption !== undefined)
|
|
164
|
+
sized("A document's caption", caption, BODY.document, true);
|
|
165
|
+
return { type: "document", document: file, filename, ...(caption ? { caption } : {}) };
|
|
166
|
+
}
|
|
167
|
+
/** What a part says in text: its body or caption (what an answer before it joins). */
|
|
168
|
+
export const wordsIn = (part) => part.type === "image" || part.type === "document" ? part.caption ?? "" : part.text;
|
|
169
|
+
/**
|
|
170
|
+
* Text before a part (an answer), as one message with it when the part can
|
|
171
|
+
* say it (its body or caption has room): undefined when it can't. The answer
|
|
172
|
+
* is the body: a part's own words are what it says without one (a question
|
|
173
|
+
* the answer asks already), unless they're kept (`keep`: a text, or a
|
|
174
|
+
* fallback, where they're what's shown).
|
|
175
|
+
*/
|
|
176
|
+
export function joined(before, part, keep = part.type === "text") {
|
|
177
|
+
const own = keep ? wordsIn(part) : "";
|
|
178
|
+
const words = own ? `${before}\n\n${own}` : before;
|
|
179
|
+
if (words.length > BODY[part.type])
|
|
180
|
+
return undefined;
|
|
181
|
+
return part.type === "image" || part.type === "document"
|
|
182
|
+
? { ...part, caption: words }
|
|
183
|
+
: { ...part, text: words };
|
|
184
|
+
}
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
* What a webhook delivery says, as WhatsApp's Cloud API sends it: for each
|
|
3
3
|
* business number (by its phone number id), the messages people sent it,
|
|
4
4
|
* with who sent each (their WhatsApp id, the phone number they write from)
|
|
5
|
-
* and the name their profile shows
|
|
5
|
+
* and the name their profile shows; and what was sent that failed to arrive
|
|
6
|
+
* (its `failed` statuses). Other statuses of what was sent are left out.
|
|
6
7
|
*
|
|
7
8
|
* ```json
|
|
8
9
|
* { "object": "whatsapp_business_account", "entry": [{ "changes": [{ "field": "messages",
|
|
@@ -40,14 +41,20 @@ export type WaMessage = {
|
|
|
40
41
|
name?: string;
|
|
41
42
|
address?: string;
|
|
42
43
|
};
|
|
44
|
+
/** A template's quick reply, tapped. */
|
|
43
45
|
button?: {
|
|
44
46
|
text?: string;
|
|
47
|
+
payload?: string;
|
|
45
48
|
};
|
|
49
|
+
/** A button, a list's row or a carousel card's quick reply, tapped. */
|
|
46
50
|
interactive?: {
|
|
51
|
+
type?: string;
|
|
47
52
|
button_reply?: {
|
|
53
|
+
id?: string;
|
|
48
54
|
title?: string;
|
|
49
55
|
};
|
|
50
56
|
list_reply?: {
|
|
57
|
+
id?: string;
|
|
51
58
|
title?: string;
|
|
52
59
|
description?: string;
|
|
53
60
|
};
|
|
@@ -66,6 +73,15 @@ export type Inbound = {
|
|
|
66
73
|
};
|
|
67
74
|
/** The messages a delivery carries, each with the number it was sent to. */
|
|
68
75
|
export declare function inboundOf(payload: unknown): Inbound[];
|
|
76
|
+
/** A message the number sent that Meta couldn't deliver: its id, whom to, and why. */
|
|
77
|
+
export type Undelivered = {
|
|
78
|
+
phoneId: string;
|
|
79
|
+
wamid: string;
|
|
80
|
+
to: string;
|
|
81
|
+
errors?: unknown[];
|
|
82
|
+
};
|
|
83
|
+
/** The failed statuses a delivery carries (what was sent and didn't arrive), each with its number. */
|
|
84
|
+
export declare function undeliveredOf(payload: unknown): Undelivered[];
|
|
69
85
|
/** The media a message carries, if any: what to fetch, and what to call it. */
|
|
70
86
|
export declare function mediaOf(m: WaMessage): {
|
|
71
87
|
id: string;
|
|
@@ -74,3 +90,13 @@ export declare function mediaOf(m: WaMessage): {
|
|
|
74
90
|
} | undefined;
|
|
75
91
|
/** What a message says in words: its text, a caption, a button's title, a place. */
|
|
76
92
|
export declare function wordsOf(m: WaMessage): string;
|
|
93
|
+
/**
|
|
94
|
+
* The choice a message taps, if it's one: a button's, a list row's or a
|
|
95
|
+
* carousel card's (they come as a button's), or a template's quick reply,
|
|
96
|
+
* with what it meant (`id`) and said (`title`). Typing a button's title is
|
|
97
|
+
* just text.
|
|
98
|
+
*/
|
|
99
|
+
export declare function tapOf(m: WaMessage): {
|
|
100
|
+
id: string;
|
|
101
|
+
title: string;
|
|
102
|
+
} | undefined;
|
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
* What a webhook delivery says, as WhatsApp's Cloud API sends it: for each
|
|
3
3
|
* business number (by its phone number id), the messages people sent it,
|
|
4
4
|
* with who sent each (their WhatsApp id, the phone number they write from)
|
|
5
|
-
* and the name their profile shows
|
|
5
|
+
* and the name their profile shows; and what was sent that failed to arrive
|
|
6
|
+
* (its `failed` statuses). Other statuses of what was sent are left out.
|
|
6
7
|
*
|
|
7
8
|
* ```json
|
|
8
9
|
* { "object": "whatsapp_business_account", "entry": [{ "changes": [{ "field": "messages",
|
|
@@ -34,6 +35,26 @@ export function inboundOf(payload) {
|
|
|
34
35
|
: []);
|
|
35
36
|
}));
|
|
36
37
|
}
|
|
38
|
+
/** The failed statuses a delivery carries (what was sent and didn't arrive), each with its number. */
|
|
39
|
+
export function undeliveredOf(payload) {
|
|
40
|
+
if (!isObject(payload) || !Array.isArray(payload.entry))
|
|
41
|
+
return [];
|
|
42
|
+
return payload.entry.flatMap((entry) => (isObject(entry) && Array.isArray(entry.changes) ? entry.changes : []).flatMap((change) => {
|
|
43
|
+
const value = isObject(change) && isObject(change.value) ? change.value : undefined;
|
|
44
|
+
const phoneId = isObject(value?.metadata) ? value.metadata.phone_number_id : undefined;
|
|
45
|
+
if (typeof phoneId !== "string" || !Array.isArray(value?.statuses))
|
|
46
|
+
return [];
|
|
47
|
+
return value.statuses.flatMap((st) => isObject(st) && st.status === "failed" && typeof st.id === "string" &&
|
|
48
|
+
typeof st.recipient_id === "string"
|
|
49
|
+
? [{
|
|
50
|
+
phoneId,
|
|
51
|
+
wamid: st.id,
|
|
52
|
+
to: st.recipient_id,
|
|
53
|
+
...(Array.isArray(st.errors) ? { errors: st.errors } : {}),
|
|
54
|
+
}]
|
|
55
|
+
: []);
|
|
56
|
+
}));
|
|
57
|
+
}
|
|
37
58
|
/** The media a message carries, if any: what to fetch, and what to call it. */
|
|
38
59
|
export function mediaOf(m) {
|
|
39
60
|
const extension = (type, fallback) => ({
|
|
@@ -92,3 +113,17 @@ export function wordsOf(m) {
|
|
|
92
113
|
}
|
|
93
114
|
return "";
|
|
94
115
|
}
|
|
116
|
+
/**
|
|
117
|
+
* The choice a message taps, if it's one: a button's, a list row's or a
|
|
118
|
+
* carousel card's (they come as a button's), or a template's quick reply,
|
|
119
|
+
* with what it meant (`id`) and said (`title`). Typing a button's title is
|
|
120
|
+
* just text.
|
|
121
|
+
*/
|
|
122
|
+
export function tapOf(m) {
|
|
123
|
+
const reply = m.type === "interactive"
|
|
124
|
+
? m.interactive?.button_reply ?? m.interactive?.list_reply
|
|
125
|
+
: m.type === "button"
|
|
126
|
+
? { id: m.button?.payload, title: m.button?.text }
|
|
127
|
+
: undefined;
|
|
128
|
+
return reply?.id ? { id: reply.id, title: reply.title ?? "" } : undefined;
|
|
129
|
+
}
|
|
@@ -1,14 +1,62 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* The WhatsApp plugin's settings (the `whatsapp` resource): where Meta's
|
|
3
3
|
* Graph API is (its version; a test's fake), how long a code to link a
|
|
4
|
-
* phone lasts,
|
|
4
|
+
* phone lasts, the largest file a message may bring, and the app's own
|
|
5
|
+
* customer lines (`lines`), by name: numbers it opens from its settings,
|
|
6
|
+
* with no person connecting them.
|
|
5
7
|
*/
|
|
6
8
|
import type { Resources } from "../../../../runtime/mod.js";
|
|
9
|
+
/**
|
|
10
|
+
* A customer line the app declares: a number open to anyone, kept as its
|
|
11
|
+
* settings say at every use (no person connects it, nor changes it).
|
|
12
|
+
*/
|
|
13
|
+
export type WhatsAppLine = {
|
|
14
|
+
/**
|
|
15
|
+
* The space its customers' chats live in: one the app declares too (the
|
|
16
|
+
* spaces plugin's `spaces` resource) is made and kept with the line.
|
|
17
|
+
*/
|
|
18
|
+
in: string;
|
|
19
|
+
/** Meta's id for the number, its access token, and the Meta app's secret (signing its webhook). */
|
|
20
|
+
phoneId: string;
|
|
21
|
+
token: string;
|
|
22
|
+
secret: string;
|
|
23
|
+
/** What Meta shows to check its webhook, the app's own. */
|
|
24
|
+
verify: string;
|
|
25
|
+
/**
|
|
26
|
+
* Where its webhook is: `/hooks/whatsapp/<name>` unless the app routes
|
|
27
|
+
* another path to `whatsapp.hook` (its `routes` resource).
|
|
28
|
+
*/
|
|
29
|
+
path?: string;
|
|
30
|
+
/**
|
|
31
|
+
* Who answers its customers; a quiet chat's hours; messages a minute;
|
|
32
|
+
* seconds a burst may go on before the answer; customers' language.
|
|
33
|
+
*/
|
|
34
|
+
agent?: string;
|
|
35
|
+
gap?: number;
|
|
36
|
+
rate?: number;
|
|
37
|
+
quiet?: number;
|
|
38
|
+
language?: "en" | "pt";
|
|
39
|
+
/** The number as people dial it, and the business's name, as shown. */
|
|
40
|
+
phone?: string;
|
|
41
|
+
name?: string;
|
|
42
|
+
/** With the orgs host, the org it's for (its id): no other org has it. */
|
|
43
|
+
org?: string;
|
|
44
|
+
};
|
|
7
45
|
export type WhatsAppSettings = {
|
|
8
46
|
graph?: string;
|
|
9
47
|
codeMinutes?: number;
|
|
10
48
|
maxFileMb?: number;
|
|
49
|
+
lines?: Record<string, WhatsAppLine>;
|
|
11
50
|
};
|
|
51
|
+
/**
|
|
52
|
+
* The app's own lines, by name, here: with the orgs host (each org's runtime
|
|
53
|
+
* knows its org, `resources.org`), only those that name this org (`org`); a
|
|
54
|
+
* line naming none is the single-org app's. An org never answers, nor
|
|
55
|
+
* writes, another's line.
|
|
56
|
+
*/
|
|
57
|
+
export declare const linesOf: (ctx: {
|
|
58
|
+
resources: Resources;
|
|
59
|
+
}) => Record<string, WhatsAppLine>;
|
|
12
60
|
export declare const settingsOf: (ctx: {
|
|
13
61
|
resources: Resources;
|
|
14
62
|
}) => {
|
|
@@ -1,3 +1,14 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The app's own lines, by name, here: with the orgs host (each org's runtime
|
|
3
|
+
* knows its org, `resources.org`), only those that name this org (`org`); a
|
|
4
|
+
* line naming none is the single-org app's. An org never answers, nor
|
|
5
|
+
* writes, another's line.
|
|
6
|
+
*/
|
|
7
|
+
export const linesOf = (ctx) => {
|
|
8
|
+
const all = (ctx.resources.whatsapp ?? {}).lines ?? {};
|
|
9
|
+
const org = ctx.resources.org?.id;
|
|
10
|
+
return Object.fromEntries(Object.entries(all).filter(([, line]) => line && (org ? line.org === org : !line.org)));
|
|
11
|
+
};
|
|
1
12
|
export const settingsOf = (ctx) => {
|
|
2
13
|
const set = (ctx.resources.whatsapp ?? {});
|
|
3
14
|
return {
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A chat message on WhatsApp (the `message` View, renderer `whatsapp`): its
|
|
3
|
+
* Markdown as WhatsApp formats it, in parts of at most 4096 characters split
|
|
4
|
+
* where a reader would pause, then its files: pictures (jpeg or png, up to
|
|
5
|
+
* 5 MB) as images, anything else as documents. A short text goes as the
|
|
6
|
+
* first file's caption: one message, not two. An app shows its messages
|
|
7
|
+
* otherwise with a `message` View of its own in this medium (the last
|
|
8
|
+
* plugin's wins).
|
|
9
|
+
*/
|
|
10
|
+
import type { ViewContext } from "../../../../runtime/mod.js";
|
|
11
|
+
import type { Message } from "../../../agents/chat/contract.js";
|
|
12
|
+
import { type WaPart } from "../shared/parts.js";
|
|
13
|
+
export declare const messageView: (m: Message, _ctx: ViewContext) => WaPart[];
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
import { joined } from "../shared/parts.js";
|
|
2
|
+
import { split, toWhatsApp } from "../shared/text.js";
|
|
3
|
+
const PICTURE = 5 * 1024 * 1024;
|
|
4
|
+
export const messageView = (m, _ctx) => {
|
|
5
|
+
const texts = split(toWhatsApp(m.text ?? "")).filter(Boolean);
|
|
6
|
+
const files = (m.files ?? []).map((f) => /^image\/(jpeg|png)$/.test(f.type) && f.size <= PICTURE
|
|
7
|
+
? { type: "image", image: { file: f.id } }
|
|
8
|
+
: { type: "document", document: { file: f.id }, filename: f.name });
|
|
9
|
+
const words = texts.map((text) => ({ type: "text", text }));
|
|
10
|
+
// A short text and its files: the text as the first one's caption.
|
|
11
|
+
const captioned = texts.length === 1 && files.length ? joined(texts[0], files[0]) : undefined;
|
|
12
|
+
return captioned ? [captioned, ...files.slice(1)] : [...words, ...files];
|
|
13
|
+
};
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A number as a customer line: open to anyone who writes to it, each in a
|
|
3
|
+
* chat of their own in the number's space, answered by one of its agents.
|
|
4
|
+
* Those who manage the space open and close it, choose who answers, and
|
|
5
|
+
* after how long a quiet chat is over (the customer's next message starts
|
|
6
|
+
* a new one). Everyone else is told it's open, and what that means.
|
|
7
|
+
*/
|
|
8
|
+
import { type ReactNode } from "react";
|
|
9
|
+
import type { Agent } from "../../../../agents/chat/contract.js";
|
|
10
|
+
import { type WhatsAppNumber } from "../../contract.js";
|
|
11
|
+
type Call = <R = unknown>(action: string, input?: unknown) => Promise<R>;
|
|
12
|
+
export declare function CustomerLine({ number, where, manage, here, agents, fallback, call }: {
|
|
13
|
+
number: WhatsAppNumber;
|
|
14
|
+
/** The space's name, as people read it. */
|
|
15
|
+
where: string;
|
|
16
|
+
manage: boolean;
|
|
17
|
+
/** The agents answering in the space, and what each is. */
|
|
18
|
+
here: string[];
|
|
19
|
+
agents: Record<string, Agent>;
|
|
20
|
+
/** Who answers the space's new chats, when the number names nobody. */
|
|
21
|
+
fallback?: string;
|
|
22
|
+
call: Call;
|
|
23
|
+
}): ReactNode;
|
|
24
|
+
export {};
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
|
|
2
|
+
/**
|
|
3
|
+
* A number as a customer line: open to anyone who writes to it, each in a
|
|
4
|
+
* chat of their own in the number's space, answered by one of its agents.
|
|
5
|
+
* Those who manage the space open and close it, choose who answers, and
|
|
6
|
+
* after how long a quiet chat is over (the customer's next message starts
|
|
7
|
+
* a new one). Everyone else is told it's open, and what that means.
|
|
8
|
+
*/
|
|
9
|
+
import { useState } from "react";
|
|
10
|
+
import { Button, Icon, message, Notice, Select } from "../../../../../hosts/web/mod.js";
|
|
11
|
+
import { GAP } from "../../contract.js";
|
|
12
|
+
/** How long a quiet chat lasts, as managers choose it, in hours. */
|
|
13
|
+
const GAPS = [4, 8, 12, 24, 48, 72];
|
|
14
|
+
const hours = (n) => n % 24 === 0 ? `${n / 24} ${n === 24 ? "day" : "days"}` : `${n} hours`;
|
|
15
|
+
export function CustomerLine({ number, where, manage, here, agents, fallback, call }) {
|
|
16
|
+
const [busy, setBusy] = useState();
|
|
17
|
+
const [error, setError] = useState();
|
|
18
|
+
const set = async (what, input) => {
|
|
19
|
+
setBusy(what);
|
|
20
|
+
setError(undefined);
|
|
21
|
+
try {
|
|
22
|
+
await call("whatsapp.set", { number: number._id, ...input });
|
|
23
|
+
}
|
|
24
|
+
catch (e) {
|
|
25
|
+
setError(message(e));
|
|
26
|
+
}
|
|
27
|
+
finally {
|
|
28
|
+
setBusy(undefined);
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
const named = (name) => agents[name]?.name ?? name;
|
|
32
|
+
const failed = error ? _jsx(Notice, { tone: "destructive", role: "alert", children: error }) : null;
|
|
33
|
+
const gap = number.gap ?? GAP;
|
|
34
|
+
if (!manage) {
|
|
35
|
+
if (!number.open)
|
|
36
|
+
return null;
|
|
37
|
+
return (_jsxs("div", { className: "wa-line", children: [_jsxs("div", { className: "wa-line-head", children: [_jsx(Icon, { name: "users", size: 18 }), _jsx("b", { children: "Open to customers" })] }), _jsxs("p", { className: "wa-note", children: ["Anyone can write to this number. Each person gets a chat of their own in", " ", where, ", answered by", " ", named(number.agent ?? fallback ?? "its agent"), "; they see only that chat."] })] }));
|
|
38
|
+
}
|
|
39
|
+
if (!number.open) {
|
|
40
|
+
return (_jsxs("div", { className: "wa-line", children: [_jsxs("div", { className: "wa-offer", children: [_jsxs("div", { className: "wa-offer-text", children: [_jsx("b", { children: "Open it to customers" }), _jsxs("span", { className: "wa-note", children: ["Anyone who writes gets a chat of their own in", " ", where, ", answered by an agent. They see only that chat; everyone in ", where, " ", "can read it."] })] }), _jsx(Button, { icon: "users", loading: busy === "open", disabled: !here.length, onClick: () => set("open", { open: true }), children: "Open to customers" })] }), here.length ? null : (_jsxs("p", { className: "wa-note", children: ["No agent answers in ", where, " yet: add one as an editor under Members first."] })), failed] }));
|
|
41
|
+
}
|
|
42
|
+
const answering = number.agent && here.includes(number.agent) ? number.agent : "";
|
|
43
|
+
return (_jsxs("div", { className: "wa-line", children: [_jsxs("div", { className: "wa-line-head", children: [_jsx(Icon, { name: "users", size: 18 }), _jsx("b", { children: "Open to customers" })] }), _jsxs("p", { className: "wa-note", children: ["Anyone can write to this number. Each person gets a chat of their own in", " ", where, "'s chats; they see only that chat."] }), _jsxs("div", { className: "wa-line-fields", children: [_jsxs("div", { className: "wa-where", children: [_jsx("label", { htmlFor: `wa-agent-${number._id}`, children: "Answered by" }), _jsxs(Select, { id: `wa-agent-${number._id}`, value: answering, disabled: busy === "agent", onChange: (event) => void set("agent", { agent: event.target.value || null }), children: [_jsx("option", { value: "", children: fallback ? `${named(fallback)}, who answers new chats here` : "Who answers here" }), here.map((name) => _jsx("option", { value: name, children: named(name) }, name))] })] }), _jsxs("div", { className: "wa-where", children: [_jsx("label", { htmlFor: `wa-gap-${number._id}`, children: "New chat after" }), _jsx(Select, { id: `wa-gap-${number._id}`, value: String(gap), disabled: busy === "gap", onChange: (event) => void set("gap", { gap: Number(event.target.value) }), children: [...new Set([...GAPS, gap])].sort((a, b) => a - b).map((n) => (_jsxs("option", { value: String(n), children: [hours(n), " of quiet", n === GAP ? " (default)" : ""] }, n))) })] })] }), failed, _jsx("div", { className: "wa-actions", children: _jsx(Button, { variant: "ghost", loading: busy === "close", onClick: () => set("close", { open: false }), children: "Close to customers" }) })] }));
|
|
44
|
+
}
|