@marktoflow/integrations 2.0.1 → 2.0.3

package/dist/services/whatsapp.d.ts

@@ -0,0 +1,311 @@
+/**
+ * WhatsApp Integration
+ *
+ * Messaging platform via WhatsApp Business API.
+ * API Docs: https://developers.facebook.com/docs/whatsapp/cloud-api
+ */
+import { SDKInitializer } from '@marktoflow/core';
+export interface WhatsAppMessage {
+    messagingProduct: 'whatsapp';
+    to: string;
+    type: 'text' | 'template' | 'image' | 'video' | 'document' | 'audio' | 'location' | 'contacts' | 'interactive';
+    text?: {
+        body: string;
+        previewUrl?: boolean;
+    };
+    template?: WhatsAppTemplate;
+    image?: {
+        link?: string;
+        id?: string;
+        caption?: string;
+    };
+    video?: {
+        link?: string;
+        id?: string;
+        caption?: string;
+    };
+    document?: {
+        link?: string;
+        id?: string;
+        caption?: string;
+        filename?: string;
+    };
+    audio?: {
+        link?: string;
+        id?: string;
+    };
+    location?: {
+        longitude: number;
+        latitude: number;
+        name?: string;
+        address?: string;
+    };
+    interactive?: WhatsAppInteractive;
+}
+export interface WhatsAppTemplate {
+    name: string;
+    language: {
+        code: string;
+    };
+    components?: WhatsAppTemplateComponent[];
+}
+export interface WhatsAppTemplateComponent {
+    type: 'header' | 'body' | 'button';
+    parameters: WhatsAppTemplateParameter[];
+}
+export interface WhatsAppTemplateParameter {
+    type: 'text' | 'currency' | 'date_time' | 'image' | 'document' | 'video';
+    text?: string;
+    currency?: {
+        fallbackValue: string;
+        code: string;
+        amount1000: number;
+    };
+    dateTime?: {
+        fallbackValue: string;
+    };
+    image?: {
+        link: string;
+    };
+    document?: {
+        link: string;
+        filename?: string;
+    };
+    video?: {
+        link: string;
+    };
+}
+export interface WhatsAppInteractive {
+    type: 'button' | 'list' | 'product' | 'product_list';
+    header?: {
+        type: 'text' | 'image' | 'video' | 'document';
+        text?: string;
+        image?: {
+            link: string;
+        };
+        video?: {
+            link: string;
+        };
+        document?: {
+            link: string;
+        };
+    };
+    body: {
+        text: string;
+    };
+    footer?: {
+        text: string;
+    };
+    action: WhatsAppAction;
+}
+export interface WhatsAppAction {
+    buttons?: WhatsAppButton[];
+    button?: string;
+    sections?: WhatsAppSection[];
+}
+export interface WhatsAppButton {
+    type: 'reply';
+    reply: {
+        id: string;
+        title: string;
+    };
+}
+export interface WhatsAppSection {
+    title?: string;
+    rows: WhatsAppRow[];
+}
+export interface WhatsAppRow {
+    id: string;
+    title: string;
+    description?: string;
+}
+export interface SendTextOptions {
+    to: string;
+    text: string;
+    previewUrl?: boolean;
+}
+export interface SendTemplateOptions {
+    to: string;
+    templateName: string;
+    languageCode: string;
+    components?: WhatsAppTemplateComponent[];
+}
+export interface SendMediaOptions {
+    to: string;
+    mediaUrl?: string;
+    mediaId?: string;
+    caption?: string;
+    filename?: string;
+}
+export interface SendLocationOptions {
+    to: string;
+    longitude: number;
+    latitude: number;
+    name?: string;
+    address?: string;
+}
+export interface SendInteractiveOptions {
+    to: string;
+    type: 'button' | 'list';
+    bodyText: string;
+    headerText?: string;
+    footerText?: string;
+    buttons?: {
+        id: string;
+        title: string;
+    }[];
+    listButton?: string;
+    sections?: WhatsAppSection[];
+}
+export interface WhatsAppWebhookMessage {
+    from: string;
+    id: string;
+    timestamp: string;
+    type: string;
+    text?: {
+        body: string;
+    };
+    image?: {
+        id: string;
+        mimeType: string;
+        sha256: string;
+    };
+    video?: {
+        id: string;
+        mimeType: string;
+        sha256: string;
+    };
+    document?: {
+        id: string;
+        mimeType: string;
+        sha256: string;
+        filename: string;
+    };
+    audio?: {
+        id: string;
+        mimeType: string;
+        sha256: string;
+    };
+    location?: {
+        longitude: number;
+        latitude: number;
+        name?: string;
+        address?: string;
+    };
+}
+/**
+ * WhatsApp Business API client for workflow integration
+ */
+export declare class WhatsAppClient {
+    private accessToken;
+    private apiUrl;
+    constructor(phoneNumberId: string, accessToken: string);
+    private request;
+    /**
+     * Send a text message
+     */
+    sendText(options: SendTextOptions): Promise<{
+        messagingProduct: string;
+        contacts: unknown[];
+        messages: {
+            id: string;
+        }[];
+    }>;
+    /**
+     * Send a template message
+     */
+    sendTemplate(options: SendTemplateOptions): Promise<{
+        messagingProduct: string;
+        contacts: unknown[];
+        messages: {
+            id: string;
+        }[];
+    }>;
+    /**
+     * Send an image
+     */
+    sendImage(options: SendMediaOptions): Promise<{
+        messagingProduct: string;
+        contacts: unknown[];
+        messages: {
+            id: string;
+        }[];
+    }>;
+    /**
+     * Send a video
+     */
+    sendVideo(options: SendMediaOptions): Promise<{
+        messagingProduct: string;
+        contacts: unknown[];
+        messages: {
+            id: string;
+        }[];
+    }>;
+    /**
+     * Send a document
+     */
+    sendDocument(options: SendMediaOptions): Promise<{
+        messagingProduct: string;
+        contacts: unknown[];
+        messages: {
+            id: string;
+        }[];
+    }>;
+    /**
+     * Send an audio
+     */
+    sendAudio(options: Omit<SendMediaOptions, 'caption' | 'filename'>): Promise<{
+        messagingProduct: string;
+        contacts: unknown[];
+        messages: {
+            id: string;
+        }[];
+    }>;
+    /**
+     * Send a location
+     */
+    sendLocation(options: SendLocationOptions): Promise<{
+        messagingProduct: string;
+        contacts: unknown[];
+        messages: {
+            id: string;
+        }[];
+    }>;
+    /**
+     * Send an interactive message (buttons or list)
+     */
+    sendInteractive(options: SendInteractiveOptions): Promise<{
+        messagingProduct: string;
+        contacts: unknown[];
+        messages: {
+            id: string;
+        }[];
+    }>;
+    /**
+     * Mark a message as read
+     */
+    markAsRead(messageId: string): Promise<{
+        success: boolean;
+    }>;
+    /**
+     * Get media URL
+     */
+    getMediaUrl(mediaId: string): Promise<{
+        url: string;
+        mimeType: string;
+        sha256: string;
+        fileSize: number;
+    }>;
+    /**
+     * Download media
+     */
+    downloadMedia(mediaId: string): Promise<Buffer>;
+    /**
+     * Upload media
+     */
+    uploadMedia(file: Buffer, mimeType: string): Promise<{
+        id: string;
+    }>;
+}
+export declare const WhatsAppInitializer: SDKInitializer;
+//# sourceMappingURL=whatsapp.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marktoflow/integrations",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Standard integrations for marktoflow",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,11 +30,12 @@
     "@aws-sdk/client-s3": "^3.712.0",
     "@github/copilot-sdk": "^0.1.18",
     "@mailchimp/mailchimp_marketing": "^3.0.80",
-    "@marktoflow/core": "2.0.1",
+    "@marktoflow/core": "2.0.3",
     "@microsoft/microsoft-graph-client": "^3.0.7",
     "@octokit/rest": "^22.0.1",
     "@openai/codex-sdk": "^0.91.0",
-    "@opencode-ai/sdk": "^1.1.34",
+    "@opencode-ai/sdk": "^1.1.53",
+    "openai": "^4.73.0",
     "@sendgrid/mail": "^8.1.4",
     "@shopify/shopify-api": "^11.7.1",
     "@slack/bolt": "^4.0.0",