@ariaflowagents/messaging-meta 0.8.1

package/dist/whatsapp/types.d.ts

@@ -0,0 +1,440 @@
+/**
+ * @module whatsapp/types
+ *
+ * Comprehensive TypeScript types mirroring Meta's WhatsApp Cloud API.
+ *
+ * These types cover configuration, message payloads (text, media, interactive,
+ * template, location, contacts), business profile management, WhatsApp Flows,
+ * and API response shapes.
+ */
+import type { MediaCache } from '@ariaflowagents/messaging';
+import type { Logger } from '../graph-api/client.js';
+import type { RetryConfig } from '../graph-api/retry.js';
+import type { RateLimiterConfig } from '../graph-api/rate-limiter.js';
+/**
+ * Configuration for creating a {@link WhatsAppClient}.
+ *
+ * The `accessToken` and `appSecret` are obtained from the Meta Developer
+ * Dashboard. The `phoneNumberId` identifies which WhatsApp Business phone
+ * number to send messages from, and `verifyToken` is the custom string
+ * you set when configuring the webhook subscription.
+ */
+export interface WhatsAppClientConfig {
+    /** Long-lived or system-user access token for the Graph API. */
+    accessToken: string;
+    /** App secret for webhook signature verification. */
+    appSecret: string;
+    /** WhatsApp Business phone number ID (sender identity). */
+    phoneNumberId: string;
+    /** Custom verify token for webhook subscription validation. */
+    verifyToken: string;
+    /** Graph API version (e.g. `"v21.0"`). Default `"v21.0"`. */
+    apiVersion?: string;
+    /** Base URL for the Graph API. Default `"https://graph.facebook.com"`. */
+    baseUrl?: string;
+    /** Optional structured logger. */
+    logger?: Logger;
+    /** Retry behaviour configuration. */
+    retry?: Partial<RetryConfig>;
+    /** Rate limiter configuration. */
+    rateLimiter?: Partial<RateLimiterConfig>;
+    /** Optional in-memory media cache for downloaded attachments. */
+    mediaCache?: MediaCache;
+}
+/**
+ * Composite thread identifier for a WhatsApp conversation.
+ *
+ * Uniquely identifies a conversation between a specific WhatsApp Business
+ * phone number and a user.
+ */
+export interface WhatsAppThreadId {
+    /** The WhatsApp Business phone number ID. */
+    phoneNumberId: string;
+    /** The user's WhatsApp ID (E.164 phone number). */
+    userWaId: string;
+}
+/** Raw response from the WhatsApp Cloud API messages endpoint. */
+export interface WhatsAppSendResponse {
+    /** Always `"whatsapp"`. */
+    messaging_product: 'whatsapp';
+    /** Contact mapping between input numbers and WhatsApp IDs. */
+    contacts: Array<{
+        input: string;
+        wa_id: string;
+    }>;
+    /** The sent message(s) with their platform-assigned IDs. */
+    messages: Array<{
+        id: string;
+    }>;
+}
+/**
+ * A template message to send via the WhatsApp Cloud API.
+ *
+ * Templates must be pre-approved by Meta before they can be used.
+ * They are the only message type allowed outside the 24-hour
+ * customer service window.
+ */
+export interface TemplateMessage {
+    /** The approved template name. */
+    name: string;
+    /** Language configuration. */
+    language: TemplateLanguage;
+    /** Optional template components (header, body, buttons). */
+    components?: TemplateComponent[];
+}
+/** Language specification for a template message. */
+export interface TemplateLanguage {
+    /** BCP 47 language code (e.g. `"en_US"`, `"es"`). */
+    code: string;
+    /** Language fallback policy. Default `"deterministic"`. */
+    policy?: string;
+}
+/** A single component within a template message. */
+export interface TemplateComponent {
+    /** Component type. */
+    type: 'header' | 'body' | 'button';
+    /** Dynamic parameters to fill into the component. */
+    parameters?: TemplateParameter[];
+    /** Button sub-type (e.g. `"quick_reply"`, `"url"`). Required for buttons. */
+    sub_type?: string;
+    /** Button index (0-based). Required for buttons. */
+    index?: number;
+}
+/** A dynamic parameter within a template component. */
+export interface TemplateParameter {
+    /** The parameter data type. */
+    type: 'text' | 'image' | 'video' | 'document' | 'currency' | 'date_time' | 'payload' | 'action';
+    /** Text value (when `type` is `"text"`). */
+    text?: string;
+    /** Image media object (when `type` is `"image"`). */
+    image?: MediaObject;
+    /** Video media object (when `type` is `"video"`). */
+    video?: MediaObject;
+    /** Document media object (when `type` is `"document"`). */
+    document?: MediaObject & {
+        filename?: string;
+    };
+    /** Currency value (when `type` is `"currency"`). */
+    currency?: {
+        fallback_value: string;
+        code: string;
+        amount_1000: number;
+    };
+    /** Date/time value (when `type` is `"date_time"`). */
+    date_time?: {
+        fallback_value: string;
+    };
+    /** Quick-reply button payload (when `type` is `"payload"`). */
+    payload?: string;
+    /** Action payload (when `type` is `"action"`). */
+    action?: Record<string, unknown>;
+}
+/**
+ * A media object used within WhatsApp messages.
+ *
+ * Specify either `id` (for previously uploaded media) or `link` (for
+ * publicly accessible URLs). Both should not be provided simultaneously.
+ */
+export interface MediaObject {
+    /** Media ID from a previous upload. */
+    id?: string;
+    /** Public URL to the media file. */
+    link?: string;
+    /** Caption text displayed alongside the media. */
+    caption?: string;
+    /** Filename for document media. */
+    filename?: string;
+    /** MIME type of the media. */
+    mime_type?: string;
+}
+/**
+ * A list-style interactive message with expandable sections.
+ *
+ * Supports up to 10 sections with up to 10 rows each. The `button` text
+ * appears on the collapsed list control.
+ */
+export interface ListMessage {
+    /** Optional header (text only for lists). */
+    header?: {
+        type: 'text';
+        text: string;
+    };
+    /** Body text (required, max 1024 chars). */
+    body: {
+        text: string;
+    };
+    /** Optional footer text (max 60 chars). */
+    footer?: {
+        text: string;
+    };
+    /** Text displayed on the list expand button (max 20 chars). */
+    button: string;
+    /** List sections containing selectable rows. */
+    sections: ListSection[];
+}
+/** A section within a list interactive message. */
+export interface ListSection {
+    /** Section title. */
+    title: string;
+    /** Rows within this section. */
+    rows: ListRow[];
+}
+/** A single row within a list section. */
+export interface ListRow {
+    /** Unique row identifier (returned in the interactive reply). */
+    id: string;
+    /** Row title (max 24 chars). */
+    title: string;
+    /** Optional description (max 72 chars). */
+    description?: string;
+}
+/**
+ * A button-style interactive message with up to 3 reply buttons.
+ *
+ * Supports text, image, video, or document headers.
+ */
+export interface ButtonMessage {
+    /** Optional header content. */
+    header?: {
+        type: 'text';
+        text: string;
+    } | {
+        type: 'image';
+        image: MediaObject;
+    } | {
+        type: 'video';
+        video: MediaObject;
+    } | {
+        type: 'document';
+        document: MediaObject;
+    };
+    /** Body text (required, max 1024 chars). */
+    body: {
+        text: string;
+    };
+    /** Optional footer text (max 60 chars). */
+    footer?: {
+        text: string;
+    };
+    /** Reply buttons (max 3). */
+    buttons: ReplyButton[];
+}
+/** A reply button within a button interactive message. */
+export interface ReplyButton {
+    /** Unique button identifier (returned in the interactive reply). */
+    id: string;
+    /** Button display text (max 20 chars). */
+    title: string;
+}
+/**
+ * A call-to-action URL button interactive message.
+ *
+ * Opens the specified URL when the user taps the button.
+ */
+export interface CTAButtonMessage {
+    /** Optional header (text only). */
+    header?: {
+        type: 'text';
+        text: string;
+    };
+    /** Body text (required). */
+    body: {
+        text: string;
+    };
+    /** Optional footer text. */
+    footer?: {
+        text: string;
+    };
+    /** Must be `"cta_url"`. */
+    name: 'cta_url';
+    /** URL button parameters. */
+    parameters: {
+        /** Text displayed on the button. */
+        display_text: string;
+        /** URL to open when the button is tapped. */
+        url: string;
+    };
+}
+/**
+ * Input for sending a WhatsApp Flow as an interactive message.
+ *
+ * WhatsApp Flows are multi-screen forms that run natively within WhatsApp.
+ */
+export interface FlowInteractiveInput {
+    /** Body text for the flow message. */
+    body: {
+        text: string;
+    };
+    /** Optional footer text. */
+    footer?: {
+        text: string;
+    };
+    /** The WhatsApp Flow ID. */
+    flowId: string;
+    /** Call-to-action button text that opens the flow. */
+    flowCta: string;
+    /** Unique token for this flow session. */
+    flowToken: string;
+    /** Flow action type. */
+    flowAction: 'navigate' | 'data_exchange';
+    /** Optional initial data for the flow. */
+    flowActionPayload?: Record<string, unknown>;
+}
+/** A location payload for sending a map pin. */
+export interface LocationPayload {
+    /** Latitude in decimal degrees. */
+    latitude: number;
+    /** Longitude in decimal degrees. */
+    longitude: number;
+    /** Location name (displayed as title). */
+    name?: string;
+    /** Street address. */
+    address?: string;
+}
+/** A contact card payload for sending contact information. */
+export interface ContactPayload {
+    /** Contact name (at least `formatted_name` is required). */
+    name: {
+        formatted_name: string;
+        first_name?: string;
+        last_name?: string;
+    };
+    /** Phone numbers. */
+    phones?: Array<{
+        phone: string;
+        type?: string;
+    }>;
+    /** Email addresses. */
+    emails?: Array<{
+        email: string;
+        type?: string;
+    }>;
+}
+/** WhatsApp Business profile fields. */
+export interface BusinessProfile {
+    /** About text (max 139 chars). */
+    about?: string;
+    /** Business address. */
+    address?: string;
+    /** Business description (max 256 chars). */
+    description?: string;
+    /** Business email. */
+    email?: string;
+    /** Always `"whatsapp"`. */
+    messaging_product?: string;
+    /** URL of the profile picture. */
+    profile_picture_url?: string;
+    /** Business vertical/industry. */
+    vertical?: string;
+    /** Website URLs (max 2). */
+    websites?: string[];
+}
+/**
+ * A template definition for creating or updating message templates
+ * via the WhatsApp Business Management API.
+ */
+export interface TemplateDefinition {
+    /** Template name (lowercase, underscores only). */
+    name: string;
+    /** BCP 47 language code. */
+    language: string;
+    /** Template category. */
+    category: 'AUTHENTICATION' | 'MARKETING' | 'UTILITY';
+    /** Template components (header, body, footer, buttons). */
+    components: TemplateDefinitionComponent[];
+    /** Whether Meta can auto-recategorize the template. */
+    allow_category_change?: boolean;
+}
+/** A component within a template definition. */
+export interface TemplateDefinitionComponent {
+    /** Component type (e.g. `"HEADER"`, `"BODY"`, `"FOOTER"`, `"BUTTONS"`). */
+    type: string;
+    /** Text content for text-based components. */
+    text?: string;
+    /** Header format (`"TEXT"`, `"IMAGE"`, `"VIDEO"`, `"DOCUMENT"`). */
+    format?: string;
+    /** Button definitions for button components. */
+    buttons?: Array<{
+        type: string;
+        text?: string;
+        url?: string;
+        phone_number?: string;
+    }>;
+    /** Example data for template approval. */
+    example?: Record<string, unknown>;
+    /** Additional component-specific fields. */
+    [key: string]: unknown;
+}
+/** Information about an existing message template. */
+export interface TemplateInfo {
+    /** Template ID. */
+    id: string;
+    /** Template name. */
+    name: string;
+    /** BCP 47 language code. */
+    language: string;
+    /** Approval status (e.g. `"APPROVED"`, `"PENDING"`, `"REJECTED"`). */
+    status: string;
+    /** Template category. */
+    category: string;
+    /** Template components. */
+    components: TemplateDefinitionComponent[];
+}
+/** Input for creating a new WhatsApp Flow. */
+export interface FlowDefinition {
+    /** Flow name. */
+    name: string;
+    /** Flow categories. */
+    categories?: string[];
+    /** Clone from an existing flow. */
+    clone_flow_id?: string;
+}
+/** Information about an existing WhatsApp Flow. */
+export interface FlowInfo {
+    /** Flow ID. */
+    id: string;
+    /** Flow name. */
+    name: string;
+    /** Flow status (e.g. `"DRAFT"`, `"PUBLISHED"`, `"DEPRECATED"`). */
+    status: string;
+    /** Flow categories. */
+    categories: string[];
+}
+/** Assets associated with a WhatsApp Flow. */
+export interface FlowAssets {
+    /** Array of flow asset entries. */
+    data: Array<{
+        /** Asset name (usually `"flow.json"`). */
+        name: string;
+        /** Asset type identifier. */
+        asset_type: string;
+        /** URL to download the asset. */
+        download_url: string;
+    }>;
+}
+/** Response from the WhatsApp media info endpoint. */
+export interface WhatsAppMediaResponse {
+    /** Media ID. */
+    id: string;
+    /** Temporary download URL (valid for a short period). */
+    url: string;
+    /** MIME type of the media. */
+    mime_type: string;
+    /** SHA-256 hash of the media content. */
+    sha256: string;
+    /** File size in bytes. */
+    file_size: number;
+}
+/**
+ * Options for the {@link WhatsAppClient.sendTextOrTemplate} method.
+ *
+ * Attempts to send a free-form text message first; if the 24-hour window
+ * has closed, falls back to the specified template.
+ */
+export interface TextOrTemplateOptions {
+    /** The text message to attempt first. */
+    text: string;
+    /** The template to fall back to if the messaging window is closed. */
+    fallbackTemplate: TemplateMessage;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/whatsapp/types.d.ts.map

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

package/dist/whatsapp/types.js

@@ -0,0 +1,11 @@
+/**
+ * @module whatsapp/types
+ *
+ * Comprehensive TypeScript types mirroring Meta's WhatsApp Cloud API.
+ *
+ * These types cover configuration, message payloads (text, media, interactive,
+ * template, location, contacts), business profile management, WhatsApp Flows,
+ * and API response shapes.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/whatsapp/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/whatsapp/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@ariaflowagents/messaging-meta",
+  "version": "0.8.1",
+  "description": "Meta platform clients (WhatsApp, Messenger, Instagram) for AriaFlow messaging",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+    "./whatsapp": { "types": "./dist/whatsapp/index.d.ts", "default": "./dist/whatsapp/index.js" },
+    "./messenger": { "types": "./dist/messenger/index.d.ts", "default": "./dist/messenger/index.js" },
+    "./instagram": { "types": "./dist/instagram/index.d.ts", "default": "./dist/instagram/index.js" },
+    "./server": { "types": "./dist/server.d.ts", "default": "./dist/server.js" }
+  },
+  "publishConfig": { "access": "public" },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "test": "bun test",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "dependencies": {
+    "@ariaflowagents/messaging": "^0.8.0"
+  },
+  "devDependencies": {
+    "@ariaflowagents/messaging": "workspace:*",
+    "typescript": "^5.8.2",
+    "@types/node": "^22.13.4"
+  }
+}