@hostwebhook/node-types 1.28.0 → 1.30.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', 'vectorStore', 'loop',
+    'emailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', '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', 'vectorStore'];
+const CHAINABLE_ACTIONS = ['httpAction', 'mongoAction', 'postgresAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', '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', 'vectorStore'], special: { hasRejectionOutputNodes: true } },
+    approval: { acceptsInputFrom: ['endpoint', 'filter', 'transform'], canOutputTo: ['endpoint', 'filter', 'transform', 'emailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', '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') },
@@ -72,6 +72,7 @@ exports.NODE_CONNECTIONS = {
     docsAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     driveAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     firecrawlAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
+    telegramAction: { 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

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

package/dist/dispatch.js

@@ -47,6 +47,7 @@ exports.NODE_DISPATCH = {
     docsAction: { service: 'docsActionsService', collection: 'docsactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     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' },
     // ── 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

@@ -11,5 +11,7 @@ export { GOOGLE_CALENDAR_OPERATIONS, isGoogleCalendarOperation, } from './calend
 export type { GoogleCalendarOperation } from './calendar-operations';
 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 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.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.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; } });
@@ -41,6 +41,9 @@ Object.defineProperty(exports, "isGoogleCalendarOperation", { enumerable: true,
 var drive_operations_1 = require("./drive-operations");
 Object.defineProperty(exports, "DRIVE_OPERATIONS", { enumerable: true, get: function () { return drive_operations_1.DRIVE_OPERATIONS; } });
 Object.defineProperty(exports, "isDriveOperation", { enumerable: true, get: function () { return drive_operations_1.isDriveOperation; } });
+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 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

@@ -216,6 +216,18 @@ exports.NODE_REGISTRY = {
         stateKey: 'firecrawlActions', allStateKey: 'allFirecrawlActions',
         color: '#f97316', testable: true,
     },
+    telegramAction: {
+        type: 'telegramAction', prefix: 'tg', label: 'Telegram Action',
+        group: 'Actions', detailPath: '/dashboard/telegram-actions', apiPath: '/telegram-actions',
+        stateKey: 'telegramActions', allStateKey: 'allTelegramActions',
+        color: '#0ea5e9', testable: true,
+        // AI Toolkit mode — same pattern as emailAction. One aiEnabled
+        // telegramAction expands into N MCP tools (one per operation) in
+        // the upstream AI Node's tool list, so we hide canvas handles to
+        // prevent accidental misrouting that would silently fire with
+        // empty fields.
+        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/telegram-operations.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Telegram Bot API operation enum — single source of truth across the API,
+ * Dashboard, and any future consumers (Message Broker, MCP server). Used by:
+ *   - telegramAction entity / DTO (api): operation field + validation
+ *   - dashboard TelegramAction operation picker
+ *   - MCP toolkit-specs expansion (one aiEnabled telegramAction → N tools)
+ *
+ * Phase 1 covers the eight ops that handle ~95% of bot send use cases.
+ * Phase 2 candidates (sendMediaGroup, voice/video uploads, chat admin,
+ * setMyCommands, message reactions, inline-mode answers) get added by
+ * extending this list, bumping the package, and re-installing in
+ * consumers — same pattern as Gmail / Calendar / Drive.
+ */
+export declare const TELEGRAM_OPERATIONS: readonly ["sendMessage", "sendPhoto", "sendDocument", "editMessageText", "deleteMessage", "answerCallbackQuery", "forwardMessage", "sendPoll"];
+export type TelegramOperation = (typeof TELEGRAM_OPERATIONS)[number];
+/** Type guard — useful when validating untrusted input (DTOs, tool calls). */
+export declare function isTelegramOperation(value: unknown): value is TelegramOperation;

package/dist/telegram-operations.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TELEGRAM_OPERATIONS = void 0;
+exports.isTelegramOperation = isTelegramOperation;
+/**
+ * Telegram Bot API operation enum — single source of truth across the API,
+ * Dashboard, and any future consumers (Message Broker, MCP server). Used by:
+ *   - telegramAction entity / DTO (api): operation field + validation
+ *   - dashboard TelegramAction operation picker
+ *   - MCP toolkit-specs expansion (one aiEnabled telegramAction → N tools)
+ *
+ * Phase 1 covers the eight ops that handle ~95% of bot send use cases.
+ * Phase 2 candidates (sendMediaGroup, voice/video uploads, chat admin,
+ * setMyCommands, message reactions, inline-mode answers) get added by
+ * extending this list, bumping the package, and re-installing in
+ * consumers — same pattern as Gmail / Calendar / Drive.
+ */
+exports.TELEGRAM_OPERATIONS = [
+    'sendMessage',
+    'sendPhoto',
+    'sendDocument',
+    'editMessageText',
+    'deleteMessage',
+    'answerCallbackQuery',
+    'forwardMessage',
+    'sendPoll',
+];
+/** Type guard — useful when validating untrusted input (DTOs, tool calls). */
+function isTelegramOperation(value) {
+    return (typeof value === 'string' &&
+        exports.TELEGRAM_OPERATIONS.includes(value));
+}

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' | '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' | '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

@@ -49,6 +49,7 @@ exports.NODE_UI = {
     docsAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
     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' } },
     vectorStore: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
     // ── Annotations ──
     stickyNote: { fromNodes: false, toNodes: false },
@@ -61,6 +62,7 @@ exports.PREFIX_TO_TYPE = [
     { prefix: 'svc-', type: 'serviceTrigger', canvasType: 'serviceTrigger' },
     { prefix: 'va-', type: 'voiceAgent', canvasType: 'voiceAgent' },
     { prefix: 'ea-', type: 'emailAction', canvasType: 'emailAction' },
+    { prefix: 'tg-', type: 'telegramAction', canvasType: 'telegramAction' },
     { prefix: 'ha-', type: 'httpAction', canvasType: 'httpAction' },
     { prefix: 'ma-', type: 'mongoAction', canvasType: 'mongoAction' },
     { prefix: 'pg-', type: 'postgresAction', canvasType: 'postgresAction' },

package/package.json

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