@messegy/mcp 1.0.0

package/README.md

@@ -0,0 +1,133 @@
+# 🚀 Messegy WhatsApp Model Context Protocol (MCP) Server
+
+Official Model Context Protocol (MCP) Server for the **Messegy WhatsApp Business Cloud Platform**. 
+
+Connect any AI Assistant (**Claude Desktop**, **Cursor IDE**, **Antigravity**, **Windsurf**, or custom LLM agents) directly to your WhatsApp Business Cloud API to send messages, manage templates, query live chats, launch broadcasts, and automate customer engagement using natural language.
+
+---
+
+## 📦 Installation & Quickstart
+
+### 1. Run via npx (No install needed)
+```bash
+npx @messegy/mcp
+```
+
+### 2. Local Setup
+```bash
+cd mcp
+npm install
+npm run build
+npm start
+```
+
+---
+
+## ⚙️ Configuration & Environment Variables
+
+| Variable | Description | Required | Default |
+| :--- | :--- | :--- | :--- |
+| `MESSEGY_API_KEY` | Your Messegy Workspace API Key / Bearer Token | **Yes** | - |
+| `MESSEGY_PROJECT_KEY` | Your Active Project / Workspace Key | Optional | - |
+| `MESSEGY_BASE_URL` | Base URL of the Messegy API service | Optional | `https://backend.messegy.com/api` |
+
+---
+
+## 🔑 Zero-Config Interactive Authentication
+
+You **do NOT need to hardcode API keys** into JSON files if you don't want to!
+
+1. Simply add the server with `command: "npx"` and `args: ["-y", "@messegy/mcp"]`.
+2. Start chatting with your AI:
+   > *"Claude, connect my Messegy account"*
+3. The AI will ask for your API Key, validate it with the server, and securely save it in `~/.messegy/config.json`.
+4. To switch accounts or workspaces later, simply say:
+   > *"Disconnect my Messegy account"* or *"Connect with new API key <key>"*
+
+---
+
+## 🤖 Connect to AI Assistants
+
+### 1. Claude Desktop Setup (Zero-Config)
+Add this configuration to your Claude Desktop config file:
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "messegy": {
+      "command": "node",
+      "args": ["/ABSOLUTE/PATH/TO/mcp/dist/index.js"]
+    }
+  }
+}
+```
+*(Optional: You can still provide `"env": { "MESSEGY_API_KEY": "..." }` if you prefer static configuration).*
+
+### 2. Cursor IDE / Antigravity Setup
+Add under `Settings` -> `Features` -> `MCP Servers`:
+- **Name**: `messegy-whatsapp`
+- **Type**: `stdio`
+- **Command**: `node /ABSOLUTE/PATH/TO/mcp/dist/index.js`
+- **Env**: (Leave blank for interactive login or set `MESSEGY_API_KEY=your_key`)
+
+---
+
+## 🛠️ Available MCP Tools
+
+### 💬 Messaging & Live Chat
+* **`messegy_send_whatsapp_message`**: Send a direct WhatsApp text or media (image, video, PDF, audio) message to any phone number.
+* **`messegy_send_interactive_buttons`**: Send clickable quick-reply buttons (up to 3 buttons).
+* **`messegy_send_list_menu`**: Send structured interactive list menus with sections and selectable rows.
+* **`messegy_list_chats`**: Retrieve active customer WhatsApp threads with unread indicators.
+* **`messegy_get_chat_history`**: Fetch full message history of a customer conversation.
+* **`messegy_reply_to_chat`**: Send an agent/AI reply to an active chat thread.
+
+### 📄 WhatsApp Templates (Meta Approved)
+* **`messegy_list_templates`**: List all approved, pending, and rejected WhatsApp templates.
+* **`messegy_send_template_message`**: Send pre-approved templates with dynamic body parameters (`{{1}}`, `{{2}}`) and media headers.
+* **`messegy_create_template`**: Draft and submit new templates directly to Meta for instant review.
+
+### 👥 CRM & Contacts
+* **`messegy_search_contacts`**: Find leads and contacts by phone, name, or assigned tags.
+* **`messegy_create_contact`**: Add new leads with custom fields and metadata.
+* **`messegy_add_tag_to_contact`**: Tag contacts (e.g. `VIP`, `Hot-Lead`, `Pending-Payment`).
+
+### 🚀 Broadcast Campaigns
+* **`messegy_create_broadcast`**: Launch bulk promotional or utility broadcasts to segmented tags or recipient lists.
+* **`messegy_get_broadcast_stats`**: Check real-time campaign delivery, read, and failure metrics.
+
+### 📈 Business Health, Plan Quotas & Analytics
+* **`messegy_get_account_overview`**: Check WhatsApp Phone Number health, Meta quality rating (`GREEN`/`YELLOW`/`RED`), messaging tier limit, and wallet balance.
+* **`messegy_get_plan_limits_and_usage`**: Inspect active subscription plan quotas, message balance, Auto-Reply rule counts, and WhatsApp Flow limits to avoid overages.
+
+### 🤖 Auto-Replies & Keyword Bots
+* **`messegy_list_auto_replies`**: List all keyword triggers, welcome bots, and away messages.
+* **`messegy_create_auto_reply`**: Create keyword-based auto-responders (e.g. "PRICE", "HOURS", "SUPPORT") with text, templates, or buttons.
+* **`messegy_update_auto_reply`**: Edit keywords, modify response text, or toggle active/inactive status.
+* **`messegy_delete_auto_reply`**: Remove an auto-reply rule.
+
+### 📋 WhatsApp Flows (Native Interactive Forms & Surveys)
+* **`messegy_list_flows`**: List all WhatsApp Flows (DRAFT, PUBLISHED, DEPRECATED).
+* **`messegy_get_flow_details`**: Retrieve full schema, screens, and fields of a WhatsApp Flow.
+* **`messegy_create_flow`**: Create a new native WhatsApp Flow for lead generation, surveys, or booking.
+* **`messegy_publish_flow`**: Publish a flow to Meta for live customer access.
+* **`messegy_send_flow_message`**: Send an interactive flow message with a native form/survey action button to a customer.
+* **`messegy_get_flow_submissions`**: Retrieve submitted form responses, lead details, and survey answers.
+
+### 🛍️ Shopify & E-commerce Triggers
+* **`messegy_trigger_shopify_abandoned_cart`**: Trigger abandoned checkout recovery messages with auto-applied discount links.
+* **`messegy_send_order_notification`**: Send order confirmation or fulfillment tracking WhatsApp updates.
+
+---
+
+## 📚 Dynamic Resources
+
+* **`messegy://templates`**: Real-time list of all approved WhatsApp templates for AI prompt context.
+* **`messegy://account-status`**: Real-time health, verified name, and messaging limits of the WhatsApp account.
+
+---
+
+## 📄 License
+MIT © Messegy Platform

package/api/index.js

@@ -0,0 +1,3 @@
+import app from '../dist/server.js';
+
+export default app;

package/dist/api-client.d.ts

@@ -0,0 +1,10 @@
+export declare class MessegyApiClient {
+    private getHeaders;
+    private checkAuth;
+    get<T = any>(endpoint: string, params?: Record<string, any>, skipAuthCheck?: boolean): Promise<T>;
+    post<T = any>(endpoint: string, data?: Record<string, any>, skipAuthCheck?: boolean): Promise<T>;
+    put<T = any>(endpoint: string, data?: Record<string, any>): Promise<T>;
+    delete<T = any>(endpoint: string, params?: Record<string, any>): Promise<T>;
+    private handleError;
+}
+export declare const api: MessegyApiClient;

package/dist/api-client.js

@@ -0,0 +1,100 @@
+import axios from 'axios';
+import { getConfig } from './config.js';
+export class MessegyApiClient {
+    getHeaders() {
+        const config = getConfig();
+        const headers = {
+            'Content-Type': 'application/json',
+            Accept: 'application/json',
+        };
+        if (config.apiKey) {
+            headers['Authorization'] = `Bearer ${config.apiKey}`;
+            headers['x-api-key'] = config.apiKey;
+        }
+        if (config.projectKey) {
+            headers['x-project-key'] = config.projectKey;
+        }
+        return headers;
+    }
+    checkAuth() {
+        const config = getConfig();
+        if (!config.apiKey) {
+            throw new Error('⚠️ No Messegy account connected! Please provide your Messegy API Key by calling the "messegy_connect_account" tool or by saying: "Connect my Messegy account with API Key <your_key>".');
+        }
+    }
+    async get(endpoint, params, skipAuthCheck = false) {
+        if (!skipAuthCheck)
+            this.checkAuth();
+        const config = getConfig();
+        try {
+            const response = await axios.get(`${config.baseUrl}${endpoint}`, {
+                params,
+                headers: this.getHeaders(),
+                timeout: 15000,
+            });
+            return response.data;
+        }
+        catch (err) {
+            this.handleError(err, `GET ${endpoint}`);
+        }
+    }
+    async post(endpoint, data, skipAuthCheck = false) {
+        if (!skipAuthCheck)
+            this.checkAuth();
+        const config = getConfig();
+        try {
+            const response = await axios.post(`${config.baseUrl}${endpoint}`, data, {
+                headers: this.getHeaders(),
+                timeout: 15000,
+            });
+            return response.data;
+        }
+        catch (err) {
+            this.handleError(err, `POST ${endpoint}`);
+        }
+    }
+    async put(endpoint, data) {
+        this.checkAuth();
+        const config = getConfig();
+        try {
+            const response = await axios.put(`${config.baseUrl}${endpoint}`, data, {
+                headers: this.getHeaders(),
+                timeout: 15000,
+            });
+            return response.data;
+        }
+        catch (err) {
+            this.handleError(err, `PUT ${endpoint}`);
+        }
+    }
+    async delete(endpoint, params) {
+        this.checkAuth();
+        const config = getConfig();
+        try {
+            const response = await axios.delete(`${config.baseUrl}${endpoint}`, {
+                params,
+                headers: this.getHeaders(),
+                timeout: 15000,
+            });
+            return response.data;
+        }
+        catch (err) {
+            this.handleError(err, `DELETE ${endpoint}`);
+        }
+    }
+    handleError(error, action) {
+        if (axios.isAxiosError(error)) {
+            const axiosErr = error;
+            const status = axiosErr.response?.status;
+            const responseData = axiosErr.response?.data;
+            const message = responseData?.message || responseData?.error || axiosErr.message;
+            if (status === 401 || status === 403) {
+                throw new Error(`🔒 Authentication Failed (Status ${status}): Invalid or expired Messegy API Key. Please reconnect using "messegy_connect_account" with a valid key.`);
+            }
+            throw new Error(`Messegy API Error during [${action}]: (Status ${status || 'Unknown'}) ${message}`);
+        }
+        throw new Error(`Messegy Network Error during [${action}]: ${error.message}`);
+    }
+}
+export const api = new MessegyApiClient();
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/cli-setup.d.ts

@@ -0,0 +1 @@
+export declare function runInteractiveCliSetup(): Promise<void>;

package/dist/cli-setup.js

@@ -0,0 +1,74 @@
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import readline from 'readline';
+function getClaudeConfigPath() {
+    const home = os.homedir();
+    if (process.platform === 'darwin') {
+        return path.join(home, 'Library', 'Application Support', 'Claude', 'claude_desktop_config.json');
+    }
+    else if (process.platform === 'win32') {
+        const appData = process.env.APPDATA || path.join(home, 'AppData', 'Roaming');
+        return path.join(appData, 'Claude', 'claude_desktop_config.json');
+    }
+    else {
+        return path.join(home, '.config', 'Claude', 'claude_desktop_config.json');
+    }
+}
+export async function runInteractiveCliSetup() {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    const question = (query) => new Promise((resolve) => rl.question(query, resolve));
+    console.log('\n======================================================');
+    console.log('  🚀 Messegy WhatsApp MCP 1-Click Auto-Setup');
+    console.log('======================================================\n');
+    try {
+        const apiKey = (await question('🔑 Enter your Messegy API Key (from Messegy Portal -> Settings): ')).trim();
+        if (!apiKey) {
+            console.log('\n❌ Error: API Key is required. Setup cancelled.\n');
+            rl.close();
+            process.exit(1);
+        }
+        const projectKey = (await question('📁 Enter Project Key (Optional, press Enter to skip): ')).trim();
+        const configPath = getClaudeConfigPath();
+        const configDir = path.dirname(configPath);
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        let existingConfig = {};
+        if (fs.existsSync(configPath)) {
+            try {
+                const raw = fs.readFileSync(configPath, 'utf-8');
+                existingConfig = JSON.parse(raw);
+            }
+            catch {
+                existingConfig = {};
+            }
+        }
+        if (!existingConfig.mcpServers) {
+            existingConfig.mcpServers = {};
+        }
+        existingConfig.mcpServers.messegy = {
+            command: 'npx',
+            args: ['-y', '@messegy/mcp'],
+            env: {
+                MESSEGY_API_KEY: apiKey,
+                ...(projectKey ? { MESSEGY_PROJECT_KEY: projectKey } : {}),
+            },
+        };
+        fs.writeFileSync(configPath, JSON.stringify(existingConfig, null, 2), 'utf-8');
+        console.log('\n✅ SUCCESS! Messegy MCP Server has been configured automatically.');
+        console.log(`📂 Updated Config: ${configPath}`);
+        console.log('\n👉 Next Step: Open or Restart Claude Desktop, and start chatting with your WhatsApp business!\n');
+    }
+    catch (err) {
+        console.error('\n❌ Setup failed:', err.message);
+    }
+    finally {
+        rl.close();
+        process.exit(0);
+    }
+}
+//# sourceMappingURL=cli-setup.js.map

package/dist/cli-setup.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,18 @@
+export interface MessegyConfig {
+    apiKey: string;
+    projectKey?: string;
+    baseUrl: string;
+}
+export declare function getConfig(): MessegyConfig;
+/**
+ * Save new credentials interactively and persist to ~/.messegy/config.json
+ */
+export declare function saveConfig(newConfig: {
+    apiKey: string;
+    projectKey?: string;
+    baseUrl?: string;
+}): MessegyConfig;
+/**
+ * Disconnect & remove saved credentials
+ */
+export declare function clearConfig(): void;

package/dist/config.js

@@ -0,0 +1,88 @@
+import dotenv from 'dotenv';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+dotenv.config();
+const CONFIG_DIR = path.join(os.homedir(), '.messegy');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+// In-memory configuration cache
+let activeConfig = null;
+function ensureConfigDir() {
+    if (!fs.existsSync(CONFIG_DIR)) {
+        try {
+            fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+        catch { }
+    }
+}
+function loadSavedFileConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            const data = fs.readFileSync(CONFIG_FILE, 'utf-8');
+            return JSON.parse(data);
+        }
+    }
+    catch (err) {
+        console.error('Error reading saved Messegy config:', err);
+    }
+    return null;
+}
+export function getConfig() {
+    if (activeConfig) {
+        return activeConfig;
+    }
+    const fileConfig = loadSavedFileConfig();
+    const apiKey = process.env.MESSEGY_API_KEY ||
+        fileConfig?.apiKey ||
+        '';
+    const projectKey = process.env.MESSEGY_PROJECT_KEY ||
+        fileConfig?.projectKey ||
+        undefined;
+    const baseUrl = (process.env.MESSEGY_BASE_URL ||
+        fileConfig?.baseUrl ||
+        'https://backend.messegy.com/api').replace(/\/$/, '');
+    activeConfig = {
+        apiKey,
+        projectKey,
+        baseUrl,
+    };
+    return activeConfig;
+}
+/**
+ * Save new credentials interactively and persist to ~/.messegy/config.json
+ */
+export function saveConfig(newConfig) {
+    ensureConfigDir();
+    const updated = {
+        apiKey: newConfig.apiKey.trim(),
+        projectKey: newConfig.projectKey?.trim() || undefined,
+        baseUrl: (newConfig.baseUrl || 'https://backend.messegy.com/api').replace(/\/$/, ''),
+    };
+    try {
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(updated, null, 2), 'utf-8');
+    }
+    catch (err) {
+        console.error('Failed to write ~/.messegy/config.json:', err);
+    }
+    activeConfig = updated;
+    return updated;
+}
+/**
+ * Disconnect & remove saved credentials
+ */
+export function clearConfig() {
+    try {
+        if (fs.existsSync(CONFIG_FILE)) {
+            fs.unlinkSync(CONFIG_FILE);
+        }
+    }
+    catch (err) {
+        console.error('Failed to delete ~/.messegy/config.json:', err);
+    }
+    activeConfig = {
+        apiKey: '',
+        projectKey: undefined,
+        baseUrl: 'https://backend.messegy.com/api',
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { runInteractiveCliSetup } from './cli-setup.js';
+import { startHttpMcpServer } from './server.js';
+import { registerAuthTools } from './tools/auth.js';
+import { registerMessageTools } from './tools/messages.js';
+import { registerTemplateTools } from './tools/templates.js';
+import { registerChatTools } from './tools/chats.js';
+import { registerContactTools } from './tools/contacts.js';
+import { registerBroadcastTools } from './tools/broadcasts.js';
+import { registerAnalyticsTools } from './tools/analytics.js';
+import { registerAutoReplyTools } from './tools/auto-replies.js';
+import { registerFlowTools } from './tools/flows.js';
+import { registerShopifyTools } from './tools/shopify.js';
+import { registerResources } from './resources/index.js';
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('init') || args.includes('--init') || args.includes('setup') || args.includes('--setup')) {
+        await runInteractiveCliSetup();
+        return;
+    }
+    if (args.includes('server') || args.includes('--server') || args.includes('--http') || process.env.MESSEGY_MCP_MODE === 'http') {
+        const port = process.env.PORT || 3001;
+        startHttpMcpServer(port);
+        return;
+    }
+    // Initialize official Messegy MCP Server
+    const server = new McpServer({
+        name: 'messegy-whatsapp',
+        version: '1.0.0',
+    });
+    // Register interactive Auth & Account Switching tools (1st priority)
+    registerAuthTools(server);
+    // Register all tool suites
+    registerMessageTools(server);
+    registerTemplateTools(server);
+    registerChatTools(server);
+    registerContactTools(server);
+    registerBroadcastTools(server);
+    registerAutoReplyTools(server);
+    registerFlowTools(server);
+    registerAnalyticsTools(server);
+    registerShopifyTools(server);
+    // Register dynamic LLM context resources
+    registerResources(server);
+    // Connect via standard input/output transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error('🚀 Messegy WhatsApp MCP Server is running on stdio');
+}
+main().catch((error) => {
+    console.error('Fatal error in Messegy MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/lib/quota-guard.d.ts

@@ -0,0 +1,19 @@
+export interface PlanUsageInfo {
+    planName: string;
+    status: string;
+    messagesRemaining: number;
+    dailyTierLimit: number;
+    maxAutoReplies: number;
+    currentAutoReplies: number;
+    maxFlows: number;
+    currentFlows: number;
+    isTrial: boolean;
+    trialDaysLeft?: number;
+    expiresAt?: string;
+}
+export declare function fetchCurrentPlanUsage(forceRefresh?: boolean): Promise<PlanUsageInfo>;
+/**
+ * Validates requested action against plan quotas before executing.
+ * Throws friendly user error if limit exceeded.
+ */
+export declare function enforcePlanQuota(action: 'send_message' | 'send_broadcast' | 'create_auto_reply' | 'create_flow', quantity?: number): Promise<void>;

package/dist/lib/quota-guard.js

@@ -0,0 +1,101 @@
+import { api } from '../api-client.js';
+let cachedUsage = null;
+const CACHE_TTL_MS = 30000; // 30 seconds cache to keep tools fast
+export async function fetchCurrentPlanUsage(forceRefresh = false) {
+    const now = Date.now();
+    if (!forceRefresh && cachedUsage && now - cachedUsage.timestamp < CACHE_TTL_MS) {
+        return cachedUsage.data;
+    }
+    try {
+        const [planRes, dashRes] = await Promise.all([
+            api.get('/billing/my-plan').catch(() => null),
+            api.get('/dashboard').catch(() => null),
+        ]);
+        const plan = planRes?.data?.plan || planRes?.plan || planRes?.data || {};
+        const dash = dashRes?.data || dashRes || {};
+        const meta = dash?.meta || {};
+        const stats = dash?.stats || {};
+        const planName = plan?.name || meta?.plan_name || 'Starter Plan';
+        const isTrial = Boolean(dash?.trial_days_left && dash.trial_days_left > 0);
+        const usage = {
+            planName,
+            status: plan?.status || 'active',
+            messagesRemaining: typeof stats?.messages_remaining === 'number' ? stats.messages_remaining : (plan?.message_limit ?? 1000),
+            dailyTierLimit: parseTierLimit(meta?.throughput || meta?.tier),
+            maxAutoReplies: plan?.max_auto_replies ?? (planName.toLowerCase().includes('enterprise') ? 9999 : planName.toLowerCase().includes('pro') ? 50 : 5),
+            currentAutoReplies: typeof stats?.active_auto_replies === 'number' ? stats.active_auto_replies : 0,
+            maxFlows: plan?.max_flows ?? (planName.toLowerCase().includes('enterprise') ? 9999 : planName.toLowerCase().includes('pro') ? 20 : 2),
+            currentFlows: typeof stats?.active_flows === 'number' ? stats.active_flows : 0,
+            isTrial,
+            trialDaysLeft: dash?.trial_days_left,
+            expiresAt: plan?.expires_at || plan?.renewal_date,
+        };
+        cachedUsage = { data: usage, timestamp: now };
+        return usage;
+    }
+    catch (err) {
+        // Fallback safe limits if billing API is unreachable
+        return {
+            planName: 'Standard Plan',
+            status: 'active',
+            messagesRemaining: 500,
+            dailyTierLimit: 1000,
+            maxAutoReplies: 10,
+            currentAutoReplies: 0,
+            maxFlows: 5,
+            currentFlows: 0,
+            isTrial: false,
+        };
+    }
+}
+function parseTierLimit(throughputOrTier) {
+    if (typeof throughputOrTier === 'number')
+        return throughputOrTier;
+    const str = String(throughputOrTier || '').toLowerCase();
+    if (str.includes('100k') || str.includes('tier 3'))
+        return 100000;
+    if (str.includes('10k') || str.includes('tier 2'))
+        return 10000;
+    if (str.includes('1k') || str.includes('tier 1'))
+        return 1000;
+    return 1000; // default Meta tier 1
+}
+/**
+ * Validates requested action against plan quotas before executing.
+ * Throws friendly user error if limit exceeded.
+ */
+export async function enforcePlanQuota(action, quantity = 1) {
+    const usage = await fetchCurrentPlanUsage();
+    // Check if account status is active
+    if (usage.status.toLowerCase() === 'expired' || usage.status.toLowerCase() === 'suspended') {
+        throw new Error(`🚫 Action Blocked: Your Messegy subscription [${usage.planName}] is currently ${usage.status.toUpperCase()}. Please renew your plan on the Messegy Billing portal.`);
+    }
+    // 1. Message sending check
+    if (action === 'send_message') {
+        if (usage.messagesRemaining <= 0) {
+            throw new Error(`🚫 Message Limit Reached: You have 0 messages remaining on your [${usage.planName}]. Please top up message credits on Messegy Dashboard.`);
+        }
+    }
+    // 2. Broadcast bulk recipient check
+    if (action === 'send_broadcast') {
+        if (quantity > usage.messagesRemaining) {
+            throw new Error(`🚫 Broadcast Quota Exceeded: You are trying to send ${quantity} messages, but your current plan [${usage.planName}] only has ${usage.messagesRemaining} credits remaining. Please reduce recipient count or purchase additional credits.`);
+        }
+        if (quantity > usage.dailyTierLimit) {
+            throw new Error(`⚠️ Meta Daily Tier Limit Warning: Your current WhatsApp number tier allows max ${usage.dailyTierLimit.toLocaleString()} messages/day. Batch size ${quantity} exceeds this limit.`);
+        }
+    }
+    // 3. Auto-reply rule limit check
+    if (action === 'create_auto_reply') {
+        if (usage.currentAutoReplies >= usage.maxAutoReplies) {
+            throw new Error(`🚫 Auto-Reply Rule Limit Reached: Your [${usage.planName}] allows a maximum of ${usage.maxAutoReplies} automated rules (${usage.currentAutoReplies}/${usage.maxAutoReplies} used). Please upgrade your plan or delete unused rules.`);
+        }
+    }
+    // 4. WhatsApp Flow creation limit check
+    if (action === 'create_flow') {
+        if (usage.currentFlows >= usage.maxFlows) {
+            throw new Error(`🚫 WhatsApp Flow Limit Reached: Your [${usage.planName}] allows a maximum of ${usage.maxFlows} active flows (${usage.currentFlows}/${usage.maxFlows} used). Please upgrade your plan on Messegy Dashboard to create more flows.`);
+        }
+    }
+}
+//# sourceMappingURL=quota-guard.js.map

package/dist/lib/quota-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"quota-guard.js","sourceRoot":"","sources":["../../src/lib/quota-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAgBvC,IAAI,WAAW,GAAsD,IAAI,CAAC;AAC1E,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,sCAAsC;AAElE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,YAAY,GAAG,KAAK;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,IAAI,CAAC,YAAY,IAAI,WAAW,IAAI,GAAG,GAAG,WAAW,CAAC,SAAS,GAAG,YAAY,EAAE,CAAC;QAC/E,OAAO,WAAW,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC3C,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YAC7C,GAAG,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SACxC,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,IAAI,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;QACzE,MAAM,IAAI,GAAG,OAAO,EAAE,IAAI,IAAI,OAAO,IAAI,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAEhC,MAAM,QAAQ,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,EAAE,SAAS,IAAI,cAAc,CAAC;QACjE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,eAAe,IAAI,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;QAE3E,MAAM,KAAK,GAAkB;YAC3B,QAAQ;YACR,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,QAAQ;YAChC,iBAAiB,EAAE,OAAO,KAAK,EAAE,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC;YAC3H,cAAc,EAAE,cAAc,CAAC,IAAI,EAAE,UAAU,IAAI,IAAI,EAAE,IAAI,CAAC;YAC9D,cAAc,EAAE,IAAI,EAAE,gBAAgB,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YAClJ,kBAAkB,EAAE,OAAO,KAAK,EAAE,mBAAmB,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;YAClG,QAAQ,EAAE,IAAI,EAAE,SAAS,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACrI,YAAY,EAAE,OAAO,KAAK,EAAE,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YAC9E,OAAO;YACP,aAAa,EAAE,IAAI,EAAE,eAAe;YACpC,SAAS,EAAE,IAAI,EAAE,UAAU,IAAI,IAAI,EAAE,YAAY;SAClD,CAAC;QAEF,WAAW,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QAC9C,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,qDAAqD;QACrD,OAAO;YACL,QAAQ,EAAE,eAAe;YACzB,MAAM,EAAE,QAAQ;YAChB,iBAAiB,EAAE,GAAG;YACtB,cAAc,EAAE,IAAI;YACpB,cAAc,EAAE,EAAE;YAClB,kBAAkB,EAAE,CAAC;YACrB,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,CAAC;YACf,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CAAC,gBAAqB;IAC3C,IAAI,OAAO,gBAAgB,KAAK,QAAQ;QAAE,OAAO,gBAAgB,CAAC;IAClE,MAAM,GAAG,GAAG,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACzD,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,MAAM,CAAC;IAClE,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,KAAK,CAAC;IAChE,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9D,OAAO,IAAI,CAAC,CAAC,sBAAsB;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAA+E,EAC/E,QAAQ,GAAG,CAAC;IAEZ,MAAM,KAAK,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAE5C,oCAAoC;IACpC,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,WAAW,EAAE,CAAC;QAC3F,MAAM,IAAI,KAAK,CACb,iDAAiD,KAAK,CAAC,QAAQ,kBAAkB,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,yDAAyD,CACrK,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;QAC9B,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CACb,oEAAoE,KAAK,CAAC,QAAQ,wDAAwD,CAC3I,CAAC;QACJ,CAAC;IACH,CAAC;IAED,oCAAoC;IACpC,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChC,IAAI,QAAQ,GAAG,KAAK,CAAC,iBAAiB,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CACb,uDAAuD,QAAQ,qCAAqC,KAAK,CAAC,QAAQ,cAAc,KAAK,CAAC,iBAAiB,mFAAmF,CAC3O,CAAC;QACJ,CAAC;QACD,IAAI,QAAQ,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,kFAAkF,KAAK,CAAC,cAAc,CAAC,cAAc,EAAE,6BAA6B,QAAQ,sBAAsB,CACnL,CAAC;QACJ,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,IAAI,MAAM,KAAK,mBAAmB,EAAE,CAAC;QACnC,IAAI,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CACb,2CAA2C,KAAK,CAAC,QAAQ,yBAAyB,KAAK,CAAC,cAAc,qBAAqB,KAAK,CAAC,kBAAkB,IAAI,KAAK,CAAC,cAAc,0DAA0D,CACtO,CAAC;QACJ,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,IAAI,MAAM,KAAK,aAAa,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACb,yCAAyC,KAAK,CAAC,QAAQ,yBAAyB,KAAK,CAAC,QAAQ,kBAAkB,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,QAAQ,6EAA6E,CAClO,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}