@wirecat/whatsapp-cli 0.4.0 → 0.7.0

package/dist/app.js

@@ -1,4 +1,5 @@
 import { settingsFor } from "@wirecat/cli-core/cli";
+import * as v from "valibot";
 import { REASONS } from "./reasons.js";
 import { VERSION } from "./version.js";
 export const WA = {
@@ -11,6 +12,24 @@ export const WA = {
     locale: "en-GB",
     errors: { reasons: REASONS },
 };
-export const CONFIG = settingsFor(WA);
+/** The Graph API version the generated commands were built from; a newer one is a setting away. */
+export const GRAPH_VERSION = "v23.0";
+const metaId = v.pipe(v.string("has to be Meta's id, in quotes"), v.regex(/^\d+$/, "has to be digits only"));
+export const CONFIG = settingsFor(WA, {
+    profile: {
+        phone_number_id: v.optional(metaId),
+        waba_id: v.optional(metaId),
+        graph_version: v.optional(v.pipe(v.string(), v.regex(/^v\d+\.\d+$/, "has to be a Graph version like v23.0"))),
+    },
+    resolve: ({ fromLayers }) => {
+        const phone = fromLayers("phone_number_id", undefined);
+        const waba = fromLayers("waba_id", undefined);
+        const version = fromLayers("graph_version", GRAPH_VERSION);
+        return {
+            values: { phoneNumberId: phone.value, wabaId: waba.value, graphVersion: version.value },
+            sources: { phone_number_id: phone.from, waba_id: waba.from, graph_version: version.from },
+        };
+    },
+});
 export const { resolveSettings } = CONFIG;
 //# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACvE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,EAAE,GAAgB;IAC7B,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,+FAA+F;IAC5G,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,wDAAwD;IAChE,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;CAC7B,CAAA;AAED,MAAM,CAAC,MAAM,MAAM,GAAkB,WAAW,CAAC,EAAE,CAAC,CAAA;AACpD,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAA"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACvE,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,MAAM,CAAC,MAAM,EAAE,GAAgB;IAC7B,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,cAAc;IACvB,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,+FAA+F;IAC5G,OAAO,EAAE,OAAO;IAChB,MAAM,EAAE,wDAAwD;IAChE,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE;CAC7B,CAAA;AAED,mGAAmG;AACnG,MAAM,CAAC,MAAM,aAAa,GAAG,OAAO,CAAA;AASpC,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAA;AAE5G,MAAM,CAAC,MAAM,MAAM,GAAkB,WAAW,CAAc,EAAE,EAAE;IAChE,OAAO,EAAE;QACP,eAAe,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QACnC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC3B,aAAa,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,aAAa,EAAE,sCAAsC,CAAC,CAAC,CAAC;KAC9G;IACD,OAAO,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;QAC1B,MAAM,KAAK,GAAG,UAAU,CAAqB,iBAAiB,EAAE,SAAS,CAAC,CAAA;QAC1E,MAAM,IAAI,GAAG,UAAU,CAAqB,SAAS,EAAE,SAAS,CAAC,CAAA;QACjE,MAAM,OAAO,GAAG,UAAU,CAAC,eAAe,EAAE,aAAa,CAAC,CAAA;QAC1D,OAAO;YACL,MAAM,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,CAAC,KAAK,EAAE;YACvF,OAAO,EAAE,EAAE,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,CAAC,IAAI,EAAE;SAC1F,CAAA;IACH,CAAC;CACF,CAAC,CAAA;AACF,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAA"}

package/dist/bot/adapter.d.ts

@@ -0,0 +1,18 @@
+import type { BotAdapter, BotChatRef } from "@wirecat/cli-core/cli";
+import type { GraphTransport } from "./graph.js";
+import { type WebhookSecrets } from "./webhook.js";
+export interface BotIds {
+    phoneNumberId: string | undefined;
+    wabaId: string | undefined;
+}
+/** The setting a command needs, or a refusal that says how to set it. */
+export declare const required: (value: string | undefined, setting: "phone_number_id" | "waba_id", profile: string) => string;
+export interface AdapterSeams {
+    secrets: () => WebhookSecrets;
+    /** Keeps the verify token `bot webhooks set --secret-stdin` was given, so the receiver can answer Meta with it. */
+    keepVerifyToken: (token: string) => void;
+    lastInbound?: (chat: BotChatRef) => Promise<Date | undefined>;
+}
+/** A Cloud API business number as cli-core's bot port sees it. */
+export declare const whatsappBotAdapter: (graph: GraphTransport, ids: BotIds, profile: string, seams: AdapterSeams) => BotAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/bot/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/bot/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAc,MAAM,uBAAuB,CAAA;AAC/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEhD,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,cAAc,CAAA;AAEjE,MAAM,WAAW,MAAM;IACrB,aAAa,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;CAC3B;AAED,yEAAyE;AACzE,eAAO,MAAM,QAAQ,UACZ,MAAM,GAAG,SAAS,WAChB,iBAAiB,GAAG,SAAS,WAC7B,MAAM,KACd,MAMF,CAAA;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,cAAc,CAAA;IAC7B,mHAAmH;IACnH,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACxC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAAA;CAC9D;AAED,kEAAkE;AAClE,eAAO,MAAM,kBAAkB,UACtB,cAAc,OAChB,MAAM,WACF,MAAM,SACR,YAAY,KAClB,UA0EF,CAAA"}

package/dist/bot/adapter.js

@@ -0,0 +1,74 @@
+import { CliError } from "@wirecat/cli-base";
+import { sendMessage } from "./messaging.js";
+import { webhookIntake } from "./webhook.js";
+/** The setting a command needs, or a refusal that says how to set it. */
+export const required = (value, setting, profile) => {
+    if (value)
+        return value;
+    throw new CliError("configuration_error", `the bot profile has no ${setting} — set it with \`wa ${profile} config set --bot ${setting} <id>\`, from the app's WhatsApp → API setup page`);
+};
+/** A Cloud API business number as cli-core's bot port sees it. */
+export const whatsappBotAdapter = (graph, ids, profile, seams) => {
+    const phoneNumberId = () => required(ids.phoneNumberId, "phone_number_id", profile);
+    const configure = (configuration) => graph.call({
+        path: `/${phoneNumberId()}`,
+        method: "POST",
+        json: JSON.stringify({ webhook_configuration: configuration }),
+        reads: false,
+        operation: "updatePhoneNumber",
+    });
+    const intake = webhookIntake({
+        get appSecret() {
+            return seams.secrets().appSecret;
+        },
+        get verifyToken() {
+            return seams.secrets().verifyToken;
+        },
+    });
+    return {
+        ...intake,
+        me: async () => {
+            const number = (await graph.call({
+                path: `/${phoneNumberId()}`,
+                method: "GET",
+                query: { fields: "id,display_phone_number,verified_name" },
+                reads: true,
+                operation: "getPhoneNumber",
+            }));
+            return {
+                id: number.id ?? phoneNumberId(),
+                name: number.verified_name ?? null,
+                username: null,
+                phone: number.display_phone_number ?? null,
+            };
+        },
+        send: (chat, text, options) => sendMessage({ graph, phoneNumberId: phoneNumberId(), ...(seams.lastInbound ? { lastInbound: seams.lastInbound } : {}) }, chat, text, options),
+        // The number's own override only: the app's callback is set in the App Dashboard and holds template and account events.
+        webhooks: async () => {
+            const answer = (await graph.call({
+                path: `/${phoneNumberId()}`,
+                method: "GET",
+                query: { fields: "webhook_configuration" },
+                reads: true,
+                operation: "getPhoneNumber",
+            }));
+            const url = answer.webhook_configuration?.phone_number;
+            return url ? [{ url, types: null }] : [];
+        },
+        setWebhook: async (url, { types, secret }) => {
+            if (types?.length)
+                throw new CliError("validation_error", "WhatsApp sends every subscribed field; pick fields in the App Dashboard, not with --types");
+            const token = secret ?? seams.secrets().verifyToken;
+            if (!token)
+                throw new CliError("configuration_error", `no verify token — give one with --secret-stdin, or keep it with \`wa ${profile} bot auth set --secret verify-token\``);
+            await configure({ override_callback_uri: url, verify_token: token });
+            if (secret)
+                seams.keepVerifyToken(secret);
+        },
+        deleteWebhook: async () => {
+            await configure({ override_callback_uri: "" });
+        },
+        close: async () => { },
+    };
+};
+//# sourceMappingURL=adapter.js.map

package/dist/bot/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../src/bot/adapter.ts"],"names":[],"mappings":"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"}

package/dist/bot/generated/definitions.d.ts

@@ -0,0 +1,3 @@
+import type { SchemaNode } from "@wirecat/cli-base/codegen";
+export declare const definitions: Readonly<Record<string, SchemaNode>>;
+//# sourceMappingURL=definitions.d.ts.map

package/dist/bot/generated/definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../../src/bot/generated/definitions.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAA;AAE3D,eAAO,MAAM,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAolS5D,CAAA"}