@hostwebhook/node-types 1.32.0 → 1.33.0

package/dist/connections.js

@@ -18,7 +18,7 @@ exports.isNodeType = isNodeType;
 const PROCESSING_OUTPUTS = [
     'endpoint', 'router', 'filter', 'transform', 'cache', 'code', 'rateLimiter',
     'aggregator', 'conditional', 'delay', 'schemaValidator', 'split', 'markdown', 'fileTransform',
-    'emailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'vectorStore', 'loop',
+    'emailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'vectorStore', 'loop',
 ];
 /** Standard processing input sources */
 const STANDARD_INPUTS = [
@@ -26,7 +26,7 @@ const STANDARD_INPUTS = [
     'cache', 'code', 'rateLimiter', 'aggregator', 'conditional', 'delay', 'schemaValidator', 'split', 'loop', 'markdown', 'fileTransform',
 ];
 /** Action nodes that can chain (non-terminal) */
-const CHAINABLE_ACTIONS = ['httpAction', 'mongoAction', 'postgresAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'vectorStore'];
+const CHAINABLE_ACTIONS = ['httpAction', 'mongoAction', 'postgresAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'vectorStore'];
 /** Full input list for action nodes (standard + chainable actions) */
 const ACTION_INPUTS = [...STANDARD_INPUTS, ...CHAINABLE_ACTIONS];
 exports.NODE_CONNECTIONS = {
@@ -57,7 +57,7 @@ exports.NODE_CONNECTIONS = {
     // approval is the generic "human-in-the-loop gate" — it should be
     // able to gate ANY action, not the hand-picked subset that existed
     // when this entry was last touched. Same staleness pattern as merge.
-    approval: { acceptsInputFrom: ['endpoint', 'filter', 'transform'], canOutputTo: ['endpoint', 'filter', 'transform', 'emailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'vectorStore'], special: { hasRejectionOutputNodes: true } },
+    approval: { acceptsInputFrom: ['endpoint', 'filter', 'transform'], canOutputTo: ['endpoint', 'filter', 'transform', 'emailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'vectorStore'], special: { hasRejectionOutputNodes: true } },
     loop: { acceptsInputFrom: STANDARD_INPUTS, canOutputTo: PROCESSING_OUTPUTS, special: { hasLoopBack: true } },
     // ── Routing nodes ──
     router: { acceptsInputFrom: ['endpoint', 'scheduledWebhook', 'filter', 'transform'], canOutputTo: PROCESSING_OUTPUTS.filter(t => t !== 'endpoint') },
@@ -73,6 +73,7 @@ exports.NODE_CONNECTIONS = {
     driveAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     firecrawlAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     telegramAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
+    whatsappAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     vectorStore: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     // ── Processing (transform-like) ──
     markdown: { acceptsInputFrom: STANDARD_INPUTS, canOutputTo: PROCESSING_OUTPUTS },

package/dist/credentials.js

@@ -27,6 +27,7 @@ exports.CREDENTIAL_TYPES = [
     { type: 'mcp_server' },
     { type: 'voice_agent' },
     { type: 'telegram_bot' },
+    { type: 'whatsapp_business' },
 ];
 /**
  * Plain string array — what the Mongoose `enum` field and the

package/dist/dispatch.js

@@ -48,6 +48,7 @@ exports.NODE_DISPATCH = {
     driveAction: { service: 'driveActionsService', collection: 'driveactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     firecrawlAction: { service: 'firecrawlActionsService', collection: 'firecrawlactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     telegramAction: { service: 'telegramActionsService', collection: 'telegramactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    whatsappAction: { service: 'whatsappActionsService', collection: 'whatsappactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     // ── Sources — start the flow themselves, not dispatched ──
     endpoint: { service: 'endpointsService', collection: 'endpoints', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     scheduledWebhook: { service: 'scheduledWebhooksService', collection: 'scheduledwebhooks', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },

package/dist/index.d.ts

@@ -13,5 +13,7 @@ export { DRIVE_OPERATIONS, isDriveOperation, } from './drive-operations';
 export type { DriveOperation } from './drive-operations';
 export { TELEGRAM_OPERATIONS, isTelegramOperation, } from './telegram-operations';
 export type { TelegramOperation } from './telegram-operations';
+export { WHATSAPP_OPERATIONS, isWhatsAppOperation, } from './whatsapp-operations';
+export type { WhatsAppOperation } from './whatsapp-operations';
 export type { CredentialTypeRegistration, CredentialType } from './credentials';
 export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials';

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.isTelegramOperation = exports.TELEGRAM_OPERATIONS = exports.isDriveOperation = exports.DRIVE_OPERATIONS = exports.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.GMAIL_OPERATIONS = exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.getNodeRegistryEntry = exports.NODE_REGISTRY = exports.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.resolveNodeId = exports.PREFIX_TO_TYPE = exports.NODE_UI = exports.ALL_NODE_TYPES = exports.isNodeType = exports.isTerminal = exports.canSendToNodes = exports.canReceiveFromNodes = exports.canReceiveFrom = exports.NODE_CONNECTIONS = exports.iterableMeta = exports.singleMeta = void 0;
+exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.isTelegramOperation = exports.TELEGRAM_OPERATIONS = exports.isDriveOperation = exports.DRIVE_OPERATIONS = exports.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.GMAIL_OPERATIONS = exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.getNodeRegistryEntry = exports.NODE_REGISTRY = exports.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.resolveNodeId = exports.PREFIX_TO_TYPE = exports.NODE_UI = exports.ALL_NODE_TYPES = exports.isNodeType = exports.isTerminal = exports.canSendToNodes = exports.canReceiveFromNodes = exports.canReceiveFrom = exports.NODE_CONNECTIONS = exports.iterableMeta = exports.singleMeta = void 0;
 var types_1 = require("./types");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_1.iterableMeta; } });
@@ -44,6 +44,9 @@ Object.defineProperty(exports, "isDriveOperation", { enumerable: true, get: func
 var telegram_operations_1 = require("./telegram-operations");
 Object.defineProperty(exports, "TELEGRAM_OPERATIONS", { enumerable: true, get: function () { return telegram_operations_1.TELEGRAM_OPERATIONS; } });
 Object.defineProperty(exports, "isTelegramOperation", { enumerable: true, get: function () { return telegram_operations_1.isTelegramOperation; } });
+var whatsapp_operations_1 = require("./whatsapp-operations");
+Object.defineProperty(exports, "WHATSAPP_OPERATIONS", { enumerable: true, get: function () { return whatsapp_operations_1.WHATSAPP_OPERATIONS; } });
+Object.defineProperty(exports, "isWhatsAppOperation", { enumerable: true, get: function () { return whatsapp_operations_1.isWhatsAppOperation; } });
 var credentials_1 = require("./credentials");
 Object.defineProperty(exports, "CREDENTIAL_TYPES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPES; } });
 Object.defineProperty(exports, "CREDENTIAL_TYPE_VALUES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPE_VALUES; } });

package/dist/registry.js

@@ -228,6 +228,19 @@ exports.NODE_REGISTRY = {
         // empty fields.
         isToolOnly: (e) => e.aiEnabled === true,
     },
+    whatsappAction: {
+        type: 'whatsappAction', prefix: 'wa', label: 'WhatsApp Action',
+        group: 'Actions', detailPath: '/dashboard/whatsapp-actions', apiPath: '/whatsapp-actions',
+        stateKey: 'whatsappActions', allStateKey: 'allWhatsappActions',
+        // WhatsApp brand green (#25d366) — instantly recognisable on the canvas.
+        color: '#25d366', testable: true,
+        // Same toolkit pattern as telegramAction — when aiEnabled the
+        // entity stops being a manually-wired single-op action and becomes
+        // a multi-op tool surface for an upstream AI Node. Hide canvas
+        // handles to prevent accidental wiring that would fire with empty
+        // fields the LLM is supposed to populate.
+        isToolOnly: (e) => e.aiEnabled === true,
+    },
     vectorStore: {
         type: 'vectorStore', prefix: 'vs', label: 'Vector Store',
         group: 'Actions', detailPath: '/dashboard/vector-store-nodes', apiPath: '/vector-store-nodes',

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 /** All valid node type identifiers */
-export type NodeType = 'endpoint' | 'scheduledWebhook' | 'chatTrigger' | 'serviceTrigger' | 'voiceAgent' | 'filter' | 'transform' | 'schemaValidator' | 'conditional' | 'delay' | 'rateLimiter' | 'aggregator' | 'cache' | 'code' | 'ai' | 'merge' | 'approval' | 'split' | 'loop' | 'markdown' | 'fileTransform' | 'router' | 'emailAction' | 'httpAction' | 'mongoAction' | 'postgresAction' | 'notificationAction' | 'sheetsAction' | 'calendarAction' | 'docsAction' | 'driveAction' | 'firecrawlAction' | 'telegramAction' | 'vectorStore' | 'stickyNote';
+export type NodeType = 'endpoint' | 'scheduledWebhook' | 'chatTrigger' | 'serviceTrigger' | 'voiceAgent' | 'filter' | 'transform' | 'schemaValidator' | 'conditional' | 'delay' | 'rateLimiter' | 'aggregator' | 'cache' | 'code' | 'ai' | 'merge' | 'approval' | 'split' | 'loop' | 'markdown' | 'fileTransform' | 'router' | 'emailAction' | 'httpAction' | 'mongoAction' | 'postgresAction' | 'notificationAction' | 'sheetsAction' | 'calendarAction' | 'docsAction' | 'driveAction' | 'firecrawlAction' | 'telegramAction' | 'whatsappAction' | 'vectorStore' | 'stickyNote';
 /** Node role in the pipeline */
 export type NodeRole = 'source' | 'processing' | 'flowControl' | 'routing' | 'action' | 'monitoring';
 /** Handle positions on the canvas node */

package/dist/ui.js

@@ -50,6 +50,7 @@ exports.NODE_UI = {
     driveAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
     firecrawlAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
     telegramAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'telegram' } },
+    whatsappAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'whatsapp' } },
     vectorStore: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
     // ── Annotations ──
     stickyNote: { fromNodes: false, toNodes: false },
@@ -63,6 +64,7 @@ exports.PREFIX_TO_TYPE = [
     { prefix: 'va-', type: 'voiceAgent', canvasType: 'voiceAgent' },
     { prefix: 'ea-', type: 'emailAction', canvasType: 'emailAction' },
     { prefix: 'tg-', type: 'telegramAction', canvasType: 'telegramAction' },
+    { prefix: 'wa-', type: 'whatsappAction', canvasType: 'whatsappAction' },
     { prefix: 'ha-', type: 'httpAction', canvasType: 'httpAction' },
     { prefix: 'ma-', type: 'mongoAction', canvasType: 'mongoAction' },
     { prefix: 'pg-', type: 'postgresAction', canvasType: 'postgresAction' },

package/dist/whatsapp-operations.d.ts

@@ -0,0 +1,23 @@
+/**
+ * WhatsApp Business Cloud API operation enum — single source of truth
+ * across the API, Dashboard, and any future consumers (Message Broker,
+ * MCP server). Used by:
+ *   - whatsappAction entity / DTO (api): operation field + validation
+ *   - dashboard WhatsAppAction operation picker
+ *   - MCP toolkit-specs expansion (one aiEnabled whatsappAction → N tools)
+ *
+ * Targets Meta Cloud API v21+ (the only supported variant after the
+ * On-Premises sunset on 2025-10-23). Each op maps to a single POST to
+ * `https://graph.facebook.com/v21.0/<phone_number_id>/messages` with
+ * a different `type` discriminator in the body.
+ *
+ * Phase 1 covers the ten ops that handle ~95% of business messaging.
+ * Phase 2 candidates (sendInteractiveButtons, sendInteractiveList,
+ * sendSticker, sendContacts) extend this list — bump the package and
+ * re-install in consumers, same pattern as Gmail / Calendar / Drive
+ * / Telegram.
+ */
+export declare const WHATSAPP_OPERATIONS: readonly ["sendText", "sendImage", "sendAudio", "sendVideo", "sendDocument", "sendLocation", "sendTemplate", "replyToMessage", "markAsRead", "sendReaction"];
+export type WhatsAppOperation = (typeof WHATSAPP_OPERATIONS)[number];
+/** Type guard — useful when validating untrusted input (DTOs, tool calls). */
+export declare function isWhatsAppOperation(value: unknown): value is WhatsAppOperation;

package/dist/whatsapp-operations.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WHATSAPP_OPERATIONS = void 0;
+exports.isWhatsAppOperation = isWhatsAppOperation;
+/**
+ * WhatsApp Business Cloud API operation enum — single source of truth
+ * across the API, Dashboard, and any future consumers (Message Broker,
+ * MCP server). Used by:
+ *   - whatsappAction entity / DTO (api): operation field + validation
+ *   - dashboard WhatsAppAction operation picker
+ *   - MCP toolkit-specs expansion (one aiEnabled whatsappAction → N tools)
+ *
+ * Targets Meta Cloud API v21+ (the only supported variant after the
+ * On-Premises sunset on 2025-10-23). Each op maps to a single POST to
+ * `https://graph.facebook.com/v21.0/<phone_number_id>/messages` with
+ * a different `type` discriminator in the body.
+ *
+ * Phase 1 covers the ten ops that handle ~95% of business messaging.
+ * Phase 2 candidates (sendInteractiveButtons, sendInteractiveList,
+ * sendSticker, sendContacts) extend this list — bump the package and
+ * re-install in consumers, same pattern as Gmail / Calendar / Drive
+ * / Telegram.
+ */
+exports.WHATSAPP_OPERATIONS = [
+    'sendText',
+    'sendImage',
+    'sendAudio',
+    'sendVideo',
+    'sendDocument',
+    'sendLocation',
+    'sendTemplate',
+    'replyToMessage',
+    'markAsRead',
+    'sendReaction',
+];
+/** Type guard — useful when validating untrusted input (DTOs, tool calls). */
+function isWhatsAppOperation(value) {
+    return (typeof value === 'string' &&
+        exports.WHATSAPP_OPERATIONS.includes(value));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostwebhook/node-types",
-  "version": "1.32.0",
+  "version": "1.33.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",