@hostwebhook/node-types 1.57.0 → 1.59.0

package/dist/connections.js

@@ -18,7 +18,7 @@ exports.isNodeType = isNodeType;
 const PROCESSING_OUTPUTS = [
     'webhook', 'router', 'filter', 'transform', 'cache', 'code', 'rateLimiter',
     'aggregator', 'conditional', 'delay', 'schemaValidator', 'split', 'markdown', 'fileTransform', 'limit',
-    'emailAction', 'gmailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'discordAction', 'slackAction', 'googleContactsAction', 'googleAnalyticsAction', 'vectorStore', 'rssAction', 'socialMediaAction', 'loop',
+    'emailAction', 'gmailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'discordAction', 'slackAction', 'googleContactsAction', 'googleAnalyticsAction', 'notionAction', 'vectorStore', 'rssAction', 'socialMediaAction', 'mailchimpAction', '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', 'limit',
 ];
 /** Action nodes that can chain (non-terminal) */
-const CHAINABLE_ACTIONS = ['httpAction', 'mongoAction', 'postgresAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'discordAction', 'slackAction', 'googleContactsAction', 'googleAnalyticsAction', 'vectorStore', 'rssAction', 'socialMediaAction'];
+const CHAINABLE_ACTIONS = ['httpAction', 'mongoAction', 'postgresAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'discordAction', 'slackAction', 'googleContactsAction', 'googleAnalyticsAction', 'notionAction', 'vectorStore', 'rssAction', 'socialMediaAction', 'mailchimpAction'];
 /** Full input list for action nodes (standard + chainable actions) */
 const ACTION_INPUTS = [...STANDARD_INPUTS, ...CHAINABLE_ACTIONS];
 exports.NODE_CONNECTIONS = {
@@ -77,8 +77,10 @@ exports.NODE_CONNECTIONS = {
     whatsappAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     discordAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     slackAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
+    mailchimpAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     googleContactsAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     googleAnalyticsAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
+    notionAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     vectorStore: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     rssAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     socialMediaAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },

package/dist/credentials.js

@@ -48,6 +48,18 @@ exports.CREDENTIAL_TYPES = [
     { type: 'threads_oauth2' },
     { type: 'instagram_oauth2' },
     { type: 'facebook_oauth2' },
+    // El secreto de una integración INTERNA de Notion (empieza por `ntn_`),
+    // pegado por el usuario. Un solo workspace, no caduca.
+    //
+    // Va aparte de un futuro `notion_oauth` por la misma razón que
+    // `discord_bot` va aparte de `discord_oauth`: lo que guardan es distinto.
+    // Aquí hay un secreto del usuario; en OAuth habría un access_token y un
+    // refresh_token de una app de HostWebhook.
+    //
+    // Y el orden importa: la URL de autorización de una integración PÚBLICA de
+    // Notion sólo se rellena tras mandarla a revisión de Notion, así que el
+    // camino interno es el único que funciona el primer día.
+    { type: 'notion_internal' },
 ];
 /**
  * Plain string array — what the Mongoose `enum` field and the

package/dist/dispatch.js

@@ -52,9 +52,11 @@ exports.NODE_DISPATCH = {
     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' },
     discordAction: { service: 'discordActionsService', collection: 'discordactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    mailchimpAction: { service: 'mailchimpActionsService', collection: 'mailchimpactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     slackAction: { service: 'slackActionsService', collection: 'slackactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     googleContactsAction: { service: 'googleContactsActionsService', collection: 'googlecontactsactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     googleAnalyticsAction: { service: 'googleAnalyticsActionsService', collection: 'googleanalyticsactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    notionAction: { service: 'notionActionsService', collection: 'notionactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     rssAction: { service: 'rssActionsService', collection: 'rssactions', hasFilters: false, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     socialMediaAction: { service: 'socialMediaActionsService', collection: 'socialmediaactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     // ── Sources — start the flow themselves, not dispatched ──

package/dist/index.d.ts

@@ -24,6 +24,8 @@ export { WHATSAPP_OPERATIONS, isWhatsAppOperation, } from './whatsapp-operations
 export type { WhatsAppOperation } from './whatsapp-operations';
 export { DISCORD_OPERATIONS, DISCORD_OPERATION_SPECS, isDiscordOperation, } from './discord-operations';
 export type { DiscordOperation, DiscordParamSpec, DiscordOperationSpec, } from './discord-operations';
+export { MAILCHIMP_OPERATIONS, MAILCHIMP_OPERATION_SPECS, MAILCHIMP_CONTACT_STATUSES, isMailchimpOperation, } from './mailchimp-operations';
+export type { MailchimpOperation, MailchimpContactStatus, MailchimpParamSpec, MailchimpOperationSpec, } from './mailchimp-operations';
 export { SLACK_OPERATIONS, SLACK_OPERATION_SPECS, isSlackOperation, } from './slack-operations';
 export type { SlackOperation, SlackParamSpec, SlackOperationSpec, } from './slack-operations';
 export { SHEETS_OPERATIONS, SHEETS_OPERATION_SPECS, isSheetsOperation, } from './sheets-operations';
@@ -34,6 +36,8 @@ export { GOOGLE_CONTACTS_OPERATIONS, GOOGLE_CONTACTS_OPERATIONS_V1, GOOGLE_CONTA
 export type { GoogleContactsOperation, GoogleContactsParamSpec, GoogleContactsOperationSpec, GoogleContactsOperationGroup, } from './google-contacts-operations';
 export { GOOGLE_ANALYTICS_OPERATIONS, GOOGLE_ANALYTICS_OPERATION_SPECS, GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS, isGoogleAnalyticsOperation, } from './google-analytics-operations';
 export type { GoogleAnalyticsOperation, GoogleAnalyticsParamType, GoogleAnalyticsParamSpec, GoogleAnalyticsOperationSpec, } from './google-analytics-operations';
+export { NOTION_OPERATIONS, NOTION_OPERATION_SPECS, NOTION_DROPDOWN_OPERATIONS, isNotionOperation, } from './notion-operations';
+export type { NotionOperation, NotionParamType, NotionParamSpec, NotionOperationSpec, } from './notion-operations';
 export { POSTGRES_OPERATIONS, POSTGRES_MODES, POSTGRES_OPERATION_SPECS, isPostgresOperation, } from './postgres-operations';
 export type { PostgresOperation, PostgresMode, PostgresOperationSpec, } from './postgres-operations';
 export { MONGO_OPERATIONS, MONGO_OPERATION_SPECS, isMongoOperation, } from './mongo-operations';

package/dist/index.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DRIVE_OPERATION_SPECS = exports.DRIVE_OPERATIONS = exports.GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME = exports.GOOGLE_CALENDAR_TOOLKIT_SPECS = exports.isGoogleCalendarOperation = exports.GOOGLE_CALENDAR_OPERATION_SPECS = exports.GOOGLE_CALENDAR_OPERATIONS = exports.isGmailOperation = exports.resolveGmailSendFields = exports.GMAIL_SEND_LEGACY_FIELDS = exports.NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME = exports.GMAIL_TOOLKIT_BY_TOOL_NAME = exports.NATIVE_EMAIL_TOOLKIT_SPECS = exports.GMAIL_SEND_AND_WAIT_TOOL_SPEC = exports.GMAIL_ALL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_SPECS = exports.GMAIL_TOOLKIT_OPERATIONS = exports.GMAIL_DROPDOWN_OPERATIONS = exports.GMAIL_OPERATION_GROUPS = exports.GMAIL_OPERATION_SPECS = exports.GMAIL_OPERATIONS = exports.versionCatalogErrors = exports.fieldsLost = exports.fieldsLostBetween = exports.currentVersion = exports.versionSpec = exports.versionsOf = exports.isVersioned = 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.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = exports.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isGoogleAnalyticsOperation = exports.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = exports.GOOGLE_ANALYTICS_OPERATION_SPECS = exports.GOOGLE_ANALYTICS_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = void 0;
-exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.getModelLabel = exports.getDefaultModel = void 0;
+exports.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isNotionOperation = exports.NOTION_DROPDOWN_OPERATIONS = exports.NOTION_OPERATION_SPECS = exports.NOTION_OPERATIONS = exports.isGoogleAnalyticsOperation = exports.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = exports.GOOGLE_ANALYTICS_OPERATION_SPECS = exports.GOOGLE_ANALYTICS_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isMailchimpOperation = exports.MAILCHIMP_CONTACT_STATUSES = exports.MAILCHIMP_OPERATION_SPECS = exports.MAILCHIMP_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = void 0;
+exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.getModelLabel = exports.getDefaultModel = exports.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = 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; } });
@@ -87,6 +87,11 @@ var discord_operations_1 = require("./discord-operations");
 Object.defineProperty(exports, "DISCORD_OPERATIONS", { enumerable: true, get: function () { return discord_operations_1.DISCORD_OPERATIONS; } });
 Object.defineProperty(exports, "DISCORD_OPERATION_SPECS", { enumerable: true, get: function () { return discord_operations_1.DISCORD_OPERATION_SPECS; } });
 Object.defineProperty(exports, "isDiscordOperation", { enumerable: true, get: function () { return discord_operations_1.isDiscordOperation; } });
+var mailchimp_operations_1 = require("./mailchimp-operations");
+Object.defineProperty(exports, "MAILCHIMP_OPERATIONS", { enumerable: true, get: function () { return mailchimp_operations_1.MAILCHIMP_OPERATIONS; } });
+Object.defineProperty(exports, "MAILCHIMP_OPERATION_SPECS", { enumerable: true, get: function () { return mailchimp_operations_1.MAILCHIMP_OPERATION_SPECS; } });
+Object.defineProperty(exports, "MAILCHIMP_CONTACT_STATUSES", { enumerable: true, get: function () { return mailchimp_operations_1.MAILCHIMP_CONTACT_STATUSES; } });
+Object.defineProperty(exports, "isMailchimpOperation", { enumerable: true, get: function () { return mailchimp_operations_1.isMailchimpOperation; } });
 var slack_operations_1 = require("./slack-operations");
 Object.defineProperty(exports, "SLACK_OPERATIONS", { enumerable: true, get: function () { return slack_operations_1.SLACK_OPERATIONS; } });
 Object.defineProperty(exports, "SLACK_OPERATION_SPECS", { enumerable: true, get: function () { return slack_operations_1.SLACK_OPERATION_SPECS; } });
@@ -112,6 +117,11 @@ Object.defineProperty(exports, "GOOGLE_ANALYTICS_OPERATIONS", { enumerable: true
 Object.defineProperty(exports, "GOOGLE_ANALYTICS_OPERATION_SPECS", { enumerable: true, get: function () { return google_analytics_operations_1.GOOGLE_ANALYTICS_OPERATION_SPECS; } });
 Object.defineProperty(exports, "GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS", { enumerable: true, get: function () { return google_analytics_operations_1.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS; } });
 Object.defineProperty(exports, "isGoogleAnalyticsOperation", { enumerable: true, get: function () { return google_analytics_operations_1.isGoogleAnalyticsOperation; } });
+var notion_operations_1 = require("./notion-operations");
+Object.defineProperty(exports, "NOTION_OPERATIONS", { enumerable: true, get: function () { return notion_operations_1.NOTION_OPERATIONS; } });
+Object.defineProperty(exports, "NOTION_OPERATION_SPECS", { enumerable: true, get: function () { return notion_operations_1.NOTION_OPERATION_SPECS; } });
+Object.defineProperty(exports, "NOTION_DROPDOWN_OPERATIONS", { enumerable: true, get: function () { return notion_operations_1.NOTION_DROPDOWN_OPERATIONS; } });
+Object.defineProperty(exports, "isNotionOperation", { enumerable: true, get: function () { return notion_operations_1.isNotionOperation; } });
 var postgres_operations_1 = require("./postgres-operations");
 Object.defineProperty(exports, "POSTGRES_OPERATIONS", { enumerable: true, get: function () { return postgres_operations_1.POSTGRES_OPERATIONS; } });
 Object.defineProperty(exports, "POSTGRES_MODES", { enumerable: true, get: function () { return postgres_operations_1.POSTGRES_MODES; } });

package/dist/mailchimp-operations.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Mailchimp Marketing API operations — single source of truth across the
+ * api, the dashboard and downstream consumers (MCP server).
+ *
+ * ## Three, out of one hundred and eighty-one
+ *
+ * The Marketing API has 181 routes. This node exposes three, and the choice
+ * is argued in `api/docs/ADR-0003-mailchimp.md`: a menu of 181 is how a node
+ * becomes unusable, and these three cover what people actually automate —
+ * put someone in a list, tag them, drop them into a journey.
+ *
+ * Campaign creation and sending were considered and left out of v1: a
+ * campaign needs a template, a segment and a schedule, which is a
+ * configuration surface of its own and not something anyone drives from a
+ * webhook on day one.
+ *
+ * ## Every field here exists in Mailchimp's OpenAPI schema
+ *
+ * Taken from `api.mailchimp.com/schema/3.0/Swagger.json`, not from memory.
+ * If you add a parameter, check it there first — an invented field is
+ * accepted, ignored, and then read back by the next maintainer as if it did
+ * something.
+ */
+export declare const MAILCHIMP_OPERATIONS: readonly ["upsertContact", "setTags", "triggerJourney"];
+export type MailchimpOperation = (typeof MAILCHIMP_OPERATIONS)[number];
+/** Type guard — for DTOs and AI tool calls, where the input is untrusted. */
+export declare function isMailchimpOperation(value: unknown): value is MailchimpOperation;
+/**
+ * Contact status. `pending` is the default everywhere on purpose.
+ *
+ * Writing `subscribed` for someone who never consented is a legal problem,
+ * not a technical one — and a default of `subscribed` is exactly what makes
+ * it easy. `pending` sends Mailchimp's confirmation email, which is the
+ * behaviour someone should have to opt *out* of.
+ */
+export declare const MAILCHIMP_CONTACT_STATUSES: readonly ["pending", "subscribed", "unsubscribed", "cleaned", "transactional"];
+export type MailchimpContactStatus = (typeof MAILCHIMP_CONTACT_STATUSES)[number];
+export interface MailchimpParamSpec {
+    /** Field key — also the property name on operationConfig. */
+    name: string;
+    label: string;
+    /** Param type, so the dashboard renders the right control. `audience`
+     *  and `journeyStep` are pickers backed by live Mailchimp lookups. */
+    type: 'audience' | 'journeyStep' | 'email' | 'string' | 'status' | 'tags' | 'json' | 'boolean';
+    required?: boolean;
+    description: string;
+    placeholder?: string;
+}
+export interface MailchimpOperationSpec {
+    label: string;
+    description: string;
+    /** The Marketing API route this maps to, so the mapping is checkable. */
+    apiRoute: string;
+    params: MailchimpParamSpec[];
+}
+export declare const MAILCHIMP_OPERATION_SPECS: Record<MailchimpOperation, MailchimpOperationSpec>;

package/dist/mailchimp-operations.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Mailchimp Marketing API operations — single source of truth across the
+ * api, the dashboard and downstream consumers (MCP server).
+ *
+ * ## Three, out of one hundred and eighty-one
+ *
+ * The Marketing API has 181 routes. This node exposes three, and the choice
+ * is argued in `api/docs/ADR-0003-mailchimp.md`: a menu of 181 is how a node
+ * becomes unusable, and these three cover what people actually automate —
+ * put someone in a list, tag them, drop them into a journey.
+ *
+ * Campaign creation and sending were considered and left out of v1: a
+ * campaign needs a template, a segment and a schedule, which is a
+ * configuration surface of its own and not something anyone drives from a
+ * webhook on day one.
+ *
+ * ## Every field here exists in Mailchimp's OpenAPI schema
+ *
+ * Taken from `api.mailchimp.com/schema/3.0/Swagger.json`, not from memory.
+ * If you add a parameter, check it there first — an invented field is
+ * accepted, ignored, and then read back by the next maintainer as if it did
+ * something.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAILCHIMP_OPERATION_SPECS = exports.MAILCHIMP_CONTACT_STATUSES = exports.MAILCHIMP_OPERATIONS = void 0;
+exports.isMailchimpOperation = isMailchimpOperation;
+exports.MAILCHIMP_OPERATIONS = [
+    'upsertContact',
+    'setTags',
+    'triggerJourney',
+];
+/** Type guard — for DTOs and AI tool calls, where the input is untrusted. */
+function isMailchimpOperation(value) {
+    return (typeof value === 'string' &&
+        exports.MAILCHIMP_OPERATIONS.includes(value));
+}
+/**
+ * Contact status. `pending` is the default everywhere on purpose.
+ *
+ * Writing `subscribed` for someone who never consented is a legal problem,
+ * not a technical one — and a default of `subscribed` is exactly what makes
+ * it easy. `pending` sends Mailchimp's confirmation email, which is the
+ * behaviour someone should have to opt *out* of.
+ */
+exports.MAILCHIMP_CONTACT_STATUSES = [
+    'pending',
+    'subscribed',
+    'unsubscribed',
+    'cleaned',
+    'transactional',
+];
+exports.MAILCHIMP_OPERATION_SPECS = {
+    upsertContact: {
+        label: 'Add or update contact',
+        description: 'Add a contact to an audience, or update them if the email is already there.',
+        apiRoute: 'PUT /lists/{list_id}/members/{subscriber_hash}',
+        params: [
+            {
+                name: 'audienceId',
+                label: 'Audience',
+                type: 'audience',
+                required: true,
+                description: 'The audience the contact belongs to.',
+            },
+            {
+                name: 'email',
+                label: 'Email address',
+                type: 'email',
+                required: true,
+                description: 'The contact. Mailchimp accepts the address itself here, so no hashing is needed.',
+                placeholder: '{{payload.email}}',
+            },
+            {
+                name: 'statusIfNew',
+                label: 'Status if new',
+                type: 'status',
+                required: true,
+                description: 'Only applies when the contact does not exist yet. An existing contact keeps the status it already had.',
+            },
+            {
+                name: 'mergeFields',
+                label: 'Merge fields',
+                type: 'json',
+                description: 'Mailchimp merge tags, e.g. {"FNAME":"Ada","LNAME":"Lovelace"}. The tags are defined per audience.',
+                placeholder: '{\n  "FNAME": "{{payload.firstName}}"\n}',
+            },
+            {
+                name: 'language',
+                label: 'Language',
+                type: 'string',
+                description: 'Two-letter language code, e.g. "es". Optional.',
+            },
+            {
+                name: 'vip',
+                label: 'Mark as VIP',
+                type: 'boolean',
+                description: 'Mailchimp caps VIP contacts at 5,000 per audience.',
+            },
+        ],
+    },
+    setTags: {
+        label: 'Add or remove tags',
+        description: 'Set tags on a contact. Adding and removing happen in the same call.',
+        apiRoute: 'POST /lists/{list_id}/members/{subscriber_hash}/tags',
+        params: [
+            {
+                name: 'audienceId',
+                label: 'Audience',
+                type: 'audience',
+                required: true,
+                description: 'Tags are scoped to an audience, not to the account.',
+            },
+            {
+                name: 'email',
+                label: 'Email address',
+                type: 'email',
+                required: true,
+                description: 'The contact to tag.',
+                placeholder: '{{payload.email}}',
+            },
+            {
+                name: 'tags',
+                label: 'Tags',
+                type: 'tags',
+                required: true,
+                description: 'Each tag is set active (add) or inactive (remove). One call can do both.',
+            },
+            {
+                name: 'isSyncing',
+                label: 'Skip automations',
+                type: 'boolean',
+                description: 'When on, automations that watch these tags do NOT fire. Use it for a bulk backfill you do not want to trigger emails.',
+            },
+        ],
+    },
+    triggerJourney: {
+        label: 'Add contact to a journey',
+        description: 'Drop a contact into a Customer Journey at a specific step.',
+        apiRoute: 'POST /customer-journeys/journeys/{journey_id}/steps/{step_id}/actions/trigger',
+        params: [
+            {
+                name: 'journeyStep',
+                label: 'Journey step',
+                type: 'journeyStep',
+                required: true,
+                description: 'The journey and the step inside it. The journey must already be running in Mailchimp.',
+            },
+            {
+                name: 'email',
+                label: 'Email address',
+                type: 'email',
+                required: true,
+                description: 'The contact to enrol. They must already exist in the journey audience — this operation does not create them.',
+                placeholder: '{{payload.email}}',
+            },
+        ],
+    },
+};

package/dist/notion-operations.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Notion operation enum — single source of truth across the API, Dashboard y
+ * Message Broker. Lo usan:
+ *   - notionAction entity / DTO (api): campo `operation` + validación
+ *   - la página de detalle del dashboard
+ *   - specs de toolkit MCP, si algún día el nodo gana modo herramienta
+ *
+ * Mismo patrón que `google-analytics-operations.ts` y `drive-operations.ts`.
+ *
+ * ── Contra qué versión está escrito ──
+ *
+ * `Notion-Version: 2026-03-11`. Importa más de lo normal porque Notion movió
+ * cosas de sitio dos veces seguidas y los ejemplos que hay por internet están
+ * casi todos contra la API anterior:
+ *
+ *   - 2025-09-03 partió `database` en database + **data source**. El query
+ *     dejó de vivir en `databases/{id}/query` y pasó a
+ *     `data_sources/{id}/query`. Una database contiene N data sources.
+ *   - 2026-03-11 quitó el alias `archived` (ahora es **`in_trash`**), cambió
+ *     el `after` de append blocks por un objeto **`position`**, y renombró el
+ *     bloque `transcription` a `meeting_notes`.
+ *
+ * ── Por qué hay operaciones de markdown ──
+ *
+ * Escribir contenido en Notion era construir un árbol de bloques a mano, que
+ * es con diferencia lo más pesado de su API. Desde 2026-03-11 hay
+ * `GET/PATCH /v1/pages/{id}/markdown`, disponible —lo dicen los docs con esas
+ * palabras— para "all connection types (public, internal, and personal access
+ * tokens)". Con eso, escribir una página es mandar texto.
+ *
+ * Y el markdown cubre también el añadir-sin-pisar, vía el comando
+ * `insert_content` con `position: end`. `PATCH /v1/blocks/{id}/children` NO
+ * acepta markdown —sólo objetos de bloque—, así que la única op de bloques que
+ * queda es la de LEER la estructura cruda, que es lo que markdown no da.
+ *
+ * ── Lo que NO es una operación ──
+ *
+ * Listar las databases/data sources a las que la credencial tiene acceso, y
+ * leer el esquema para pintar un selector, NO son ops del nodo: son endpoints
+ * del controlador, como Drive alimenta su `DriveFilePicker`. Una op existe
+ * para producir payload en una corrida; esto otro es para rellenar el
+ * formulario.
+ *
+ * ── Decisiones propias de Notion (anti-n8n) ──
+ *
+ *   - La database/data source y la página se ELIGEN de una lista viva, no se
+ *     teclean. Un id de Notion es un UUID sin guiones dentro de una URL larga;
+ *     pedirle eso al usuario es pedirle que se equivoque.
+ *   - Las propiedades de una página van en JSON crudo salvo el título, que es
+ *     el 90% de los casos y tiene campo propio. Cada tipo de propiedad de
+ *     Notion tiene una forma distinta (`rich_text`, `select`, `date`,
+ *     `relation`…) y fingir que caben en tres campos genéricos produce un 400
+ *     que no explica nada.
+ *   - Ninguna op declarada sin implementar. El enum ES el contrato de la
+ *     pantalla: una op declarada se pinta en el desplegable y falla al
+ *     ejecutarse. Entran cuando entre su código.
+ */
+export declare const NOTION_OPERATIONS: readonly ["createPage", "getPage", "getPageMarkdown", "updatePageProperties", "updatePageMarkdown", "archivePage", "queryDataSource", "getDataSource", "appendToPage", "getBlockChildren", "search", "createComment"];
+export type NotionOperation = (typeof NOTION_OPERATIONS)[number];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+export declare function isNotionOperation(value: unknown): value is NotionOperation;
+export type NotionParamType = 
+/** Selector vivo de data sources accesibles (necesita credencial). */
+'notionDataSource'
+/** Selector vivo de páginas accesibles; admite pegar un id o una URL. */
+ | 'notionPage'
+/** Cualquier bloque contenedor: una página vale como bloque. */
+ | 'notionBlock'
+/** Texto con autocompletado de `{{payload.*}}`. */
+ | 'template'
+/** Área de texto larga, también con autocompletado. */
+ | 'textarea'
+/** `<select>` normal; las etiquetas no son los valores, `options` obliga. */
+ | 'select' | 'number'
+/**
+ * `<select>` de `''` / `'true'` / `'false'` que se guarda como BOOLEANO, o
+ * no se guarda si es `''`. "— sin tocar —" tiene que significar que la
+ * clave no viaja, no que viaja en `false`.
+ */
+ | 'booleanSelect'
+/** Área de texto para JSON crudo (propiedades, filtros, orden). */
+ | 'json';
+export interface NotionParamSpec {
+    /** La clave de `operationConfig`. Es lo que lee la api, no un nombre de UI. */
+    name: string;
+    label: string;
+    type: NotionParamType;
+    required?: boolean;
+    /** Ayuda bajo el campo. Texto plano: el paquete no lleva React. */
+    description?: string;
+    placeholder?: string;
+    /** Prerrellenado cuando la config guardada no trae valor para esta clave. */
+    default?: string | number;
+    /** Obligatorio en `select` y `booleanSelect` — etiqueta y valor difieren. */
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+    min?: number;
+    max?: number;
+    /** Se pinta en la pestaña "Advanced" en vez de en "Config". */
+    advanced?: boolean;
+    /** Sólo visible cuando un campo hermano vale uno de estos. */
+    showWhen?: {
+        field: string;
+        in: ReadonlyArray<string>;
+    };
+}
+export interface NotionOperationSpec {
+    /** Etiqueta de la fila en el desplegable de operación. */
+    label: string;
+    /** Sub-línea bajo la etiqueta. */
+    description: string;
+    /** Endpoint al que mapea, tal cual, para poder cotejarlo con los docs. */
+    apiMethod: string;
+    /** Esquema de parámetros. El orden ES el orden en pantalla. */
+    params: NotionParamSpec[];
+}
+export declare const NOTION_OPERATION_SPECS: Record<NotionOperation, NotionOperationSpec>;
+/**
+ * Las operaciones tal y como se listan en el desplegable. Hoy es el enum
+ * entero; existe para que añadir una op interna (sin fila propia) no obligue
+ * a que la página vuelva a decidir por su cuenta qué enseñar.
+ */
+export declare const NOTION_DROPDOWN_OPERATIONS: readonly NotionOperation[];

package/dist/notion-operations.js

@@ -0,0 +1,515 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOTION_DROPDOWN_OPERATIONS = exports.NOTION_OPERATION_SPECS = exports.NOTION_OPERATIONS = void 0;
+exports.isNotionOperation = isNotionOperation;
+/**
+ * Notion operation enum — single source of truth across the API, Dashboard y
+ * Message Broker. Lo usan:
+ *   - notionAction entity / DTO (api): campo `operation` + validación
+ *   - la página de detalle del dashboard
+ *   - specs de toolkit MCP, si algún día el nodo gana modo herramienta
+ *
+ * Mismo patrón que `google-analytics-operations.ts` y `drive-operations.ts`.
+ *
+ * ── Contra qué versión está escrito ──
+ *
+ * `Notion-Version: 2026-03-11`. Importa más de lo normal porque Notion movió
+ * cosas de sitio dos veces seguidas y los ejemplos que hay por internet están
+ * casi todos contra la API anterior:
+ *
+ *   - 2025-09-03 partió `database` en database + **data source**. El query
+ *     dejó de vivir en `databases/{id}/query` y pasó a
+ *     `data_sources/{id}/query`. Una database contiene N data sources.
+ *   - 2026-03-11 quitó el alias `archived` (ahora es **`in_trash`**), cambió
+ *     el `after` de append blocks por un objeto **`position`**, y renombró el
+ *     bloque `transcription` a `meeting_notes`.
+ *
+ * ── Por qué hay operaciones de markdown ──
+ *
+ * Escribir contenido en Notion era construir un árbol de bloques a mano, que
+ * es con diferencia lo más pesado de su API. Desde 2026-03-11 hay
+ * `GET/PATCH /v1/pages/{id}/markdown`, disponible —lo dicen los docs con esas
+ * palabras— para "all connection types (public, internal, and personal access
+ * tokens)". Con eso, escribir una página es mandar texto.
+ *
+ * Y el markdown cubre también el añadir-sin-pisar, vía el comando
+ * `insert_content` con `position: end`. `PATCH /v1/blocks/{id}/children` NO
+ * acepta markdown —sólo objetos de bloque—, así que la única op de bloques que
+ * queda es la de LEER la estructura cruda, que es lo que markdown no da.
+ *
+ * ── Lo que NO es una operación ──
+ *
+ * Listar las databases/data sources a las que la credencial tiene acceso, y
+ * leer el esquema para pintar un selector, NO son ops del nodo: son endpoints
+ * del controlador, como Drive alimenta su `DriveFilePicker`. Una op existe
+ * para producir payload en una corrida; esto otro es para rellenar el
+ * formulario.
+ *
+ * ── Decisiones propias de Notion (anti-n8n) ──
+ *
+ *   - La database/data source y la página se ELIGEN de una lista viva, no se
+ *     teclean. Un id de Notion es un UUID sin guiones dentro de una URL larga;
+ *     pedirle eso al usuario es pedirle que se equivoque.
+ *   - Las propiedades de una página van en JSON crudo salvo el título, que es
+ *     el 90% de los casos y tiene campo propio. Cada tipo de propiedad de
+ *     Notion tiene una forma distinta (`rich_text`, `select`, `date`,
+ *     `relation`…) y fingir que caben en tres campos genéricos produce un 400
+ *     que no explica nada.
+ *   - Ninguna op declarada sin implementar. El enum ES el contrato de la
+ *     pantalla: una op declarada se pinta en el desplegable y falla al
+ *     ejecutarse. Entran cuando entre su código.
+ */
+exports.NOTION_OPERATIONS = [
+    // Páginas
+    'createPage', // POST   /v1/pages
+    'getPage', // GET    /v1/pages/{id}
+    'getPageMarkdown', // GET    /v1/pages/{id}/markdown
+    'updatePageProperties', // PATCH  /v1/pages/{id}
+    'updatePageMarkdown', // PATCH  /v1/pages/{id}/markdown
+    'archivePage', // PATCH  /v1/pages/{id}  { in_trash: true }
+    // Data sources (lo que antes era "la database")
+    'queryDataSource', // POST   /v1/data_sources/{id}/query
+    'getDataSource', // GET    /v1/data_sources/{id}
+    // Bloques
+    'appendToPage', // PATCH  /v1/pages/{id}/markdown  (insert_content)
+    'getBlockChildren', // GET    /v1/blocks/{id}/children
+    // Transversales
+    'search', // POST   /v1/search
+    'createComment', // POST   /v1/comments
+];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+function isNotionOperation(value) {
+    return (typeof value === 'string' &&
+        exports.NOTION_OPERATIONS.includes(value));
+}
+/* Fábricas de los campos que se repiten, para que un cambio de copy no haya
+   que perseguirlo por doce operaciones. */
+const pageId = (label = 'Page') => ({
+    name: 'pageId',
+    label,
+    type: 'notionPage',
+    required: true,
+    description: 'Pick a page the connection can see, or paste a page URL or id — a templated value like {{payload.pageId}} works too. Notion only shows pages that were explicitly shared with this connection.',
+});
+const dataSourceId = () => ({
+    name: 'dataSourceId',
+    label: 'Data source',
+    type: 'notionDataSource',
+    required: true,
+    description: 'Since API version 2025-09-03 a database holds one or more data sources, and rows live in the data source — not in the database. Most databases have exactly one.',
+});
+/** El JSON de propiedades, con el aviso que ahorra el 400 más común. */
+const propertiesJson = () => ({
+    name: 'properties',
+    label: 'Properties (JSON)',
+    type: 'json',
+    advanced: true,
+    placeholder: '{ "Status": { "select": { "name": "In progress" } }, "Due": { "date": { "start": "2026-09-01" } } }',
+    description: 'Raw Notion property values, keyed by property name. Every property type has its own shape (rich_text, select, date, relation, …) — check the data source schema. Leave empty to only set the title.',
+});
+const notionVersionNote = 'Runs against Notion-Version 2026-03-11.';
+exports.NOTION_OPERATION_SPECS = {
+    createPage: {
+        label: 'Create page',
+        description: 'A new page — as a row in a data source, or under another page.',
+        apiMethod: 'POST /v1/pages',
+        params: [
+            {
+                name: 'parentType',
+                label: 'Create it in',
+                type: 'select',
+                required: true,
+                default: 'data_source',
+                options: [
+                    { value: 'data_source', label: 'A data source (adds a row)' },
+                    { value: 'page', label: 'Another page (adds a subpage)' },
+                ],
+                description: 'A row in a database IS a page in Notion — same object, different parent.',
+            },
+            {
+                ...dataSourceId(),
+                showWhen: { field: 'parentType', in: ['data_source'] },
+            },
+            {
+                ...pageId('Parent page'),
+                name: 'parentPageId',
+                showWhen: { field: 'parentType', in: ['page'] },
+            },
+            {
+                name: 'title',
+                label: 'Title',
+                type: 'template',
+                required: true,
+                placeholder: '{{payload.subject}}',
+                description: 'Goes into the title property, whatever it is called in this data source.',
+            },
+            {
+                name: 'markdown',
+                label: 'Content (Markdown)',
+                type: 'textarea',
+                placeholder: '## Summary\n\n{{payload.body}}',
+                description: 'The page body, as Notion-flavored Markdown. This is the shortcut that avoids building a block tree by hand.',
+            },
+            {
+                name: 'icon',
+                label: 'Icon',
+                type: 'template',
+                advanced: true,
+                placeholder: '🚀',
+                description: 'A single emoji, or an external image URL.',
+            },
+            propertiesJson(),
+        ],
+    },
+    getPage: {
+        label: 'Get page',
+        description: 'The page object and its properties — not its content.',
+        apiMethod: 'GET /v1/pages/{page_id}',
+        params: [
+            pageId(),
+            {
+                name: 'filterProperties',
+                label: 'Only these properties',
+                type: 'template',
+                advanced: true,
+                placeholder: 'title,Status,Due',
+                description: 'Comma-separated property names. Notion returns every property by default, which on a wide database is a lot of payload for nothing.',
+            },
+        ],
+    },
+    getPageMarkdown: {
+        label: 'Get page as Markdown',
+        description: 'The whole page content as one Markdown string.',
+        apiMethod: 'GET /v1/pages/{page_id}/markdown',
+        params: [
+            pageId(),
+            {
+                name: 'includeTranscript',
+                label: 'Include meeting transcript',
+                type: 'booleanSelect',
+                advanced: true,
+                options: [
+                    { value: '', label: '— leave alone —' },
+                    { value: 'true', label: 'Yes' },
+                    { value: 'false', label: 'No' },
+                ],
+                description: 'Only matters on pages holding meeting notes. Transcripts can be very long.',
+            },
+        ],
+    },
+    updatePageProperties: {
+        label: 'Update page properties',
+        description: 'Change property values — status, dates, relations.',
+        apiMethod: 'PATCH /v1/pages/{page_id}',
+        params: [
+            pageId(),
+            {
+                name: 'title',
+                label: 'New title',
+                type: 'template',
+                description: 'Leave empty to keep the current title.',
+            },
+            {
+                ...propertiesJson(),
+                advanced: false,
+                description: 'Raw Notion property values, keyed by property name. Only the properties you list are touched; the rest keep their value. Every property type has its own shape (rich_text, select, date, relation, …).',
+            },
+            {
+                name: 'icon',
+                label: 'Icon',
+                type: 'template',
+                advanced: true,
+                placeholder: '✅',
+                description: 'A single emoji, or an external image URL.',
+            },
+        ],
+    },
+    updatePageMarkdown: {
+        label: 'Update page content',
+        description: 'Rewrite the body, or search and replace inside it.',
+        apiMethod: 'PATCH /v1/pages/{page_id}/markdown',
+        params: [
+            pageId(),
+            {
+                name: 'mode',
+                label: 'How',
+                type: 'select',
+                required: true,
+                default: 'replace_content',
+                options: [
+                    { value: 'replace_content', label: 'Replace the whole body' },
+                    { value: 'update_content', label: 'Find and replace' },
+                ],
+                description: 'Replacing drops everything currently on the page — including blocks this flow did not write.',
+            },
+            {
+                name: 'markdown',
+                label: 'New content (Markdown)',
+                type: 'textarea',
+                required: true,
+                showWhen: { field: 'mode', in: ['replace_content'] },
+                placeholder: '## Report\n\n{{payload.summary}}',
+            },
+            {
+                name: 'find',
+                label: 'Find',
+                type: 'template',
+                required: true,
+                showWhen: { field: 'mode', in: ['update_content'] },
+                description: 'The exact text to look for. Notion matches it literally, not as a regex.',
+            },
+            {
+                name: 'replace',
+                label: 'Replace with',
+                type: 'textarea',
+                showWhen: { field: 'mode', in: ['update_content'] },
+                description: 'Leave empty to delete the matched text.',
+            },
+        ],
+    },
+    archivePage: {
+        label: 'Archive page',
+        description: 'Send it to the trash, or bring it back.',
+        apiMethod: 'PATCH /v1/pages/{page_id}',
+        params: [
+            pageId(),
+            {
+                name: 'inTrash',
+                label: 'Trashed',
+                type: 'booleanSelect',
+                required: true,
+                default: 'true',
+                options: [
+                    { value: 'true', label: 'Move to trash' },
+                    { value: 'false', label: 'Restore from trash' },
+                ],
+                description: 'Notion calls this in_trash since API version 2026-03-11; the old archived field is gone. Trashed pages are recoverable for 30 days.',
+            },
+        ],
+    },
+    queryDataSource: {
+        label: 'Query data source',
+        description: 'Rows matching a filter, in the order you ask for.',
+        apiMethod: 'POST /v1/data_sources/{data_source_id}/query',
+        params: [
+            dataSourceId(),
+            {
+                name: 'filterProperty',
+                label: 'Filter — property',
+                type: 'template',
+                placeholder: 'Status',
+                description: 'The property name as it reads in Notion. Leave the three filter fields empty to get everything.',
+            },
+            {
+                name: 'filterCondition',
+                label: 'Filter — condition',
+                type: 'select',
+                default: 'equals',
+                options: [
+                    { value: 'equals', label: 'equals' },
+                    { value: 'does_not_equal', label: 'does not equal' },
+                    { value: 'contains', label: 'contains' },
+                    { value: 'does_not_contain', label: 'does not contain' },
+                    { value: 'is_empty', label: 'is empty' },
+                    { value: 'is_not_empty', label: 'is not empty' },
+                    { value: 'after', label: 'is after (date)' },
+                    { value: 'before', label: 'is before (date)' },
+                    { value: 'on_or_after', label: 'is on or after (date)' },
+                ],
+            },
+            {
+                name: 'filterValue',
+                label: 'Filter — value',
+                type: 'template',
+                placeholder: 'In progress',
+                showWhen: {
+                    field: 'filterCondition',
+                    in: [
+                        'equals',
+                        'does_not_equal',
+                        'contains',
+                        'does_not_contain',
+                        'after',
+                        'before',
+                        'on_or_after',
+                    ],
+                },
+            },
+            {
+                name: 'sortProperty',
+                label: 'Sort by',
+                type: 'template',
+                placeholder: 'last_edited_time',
+                description: 'A property name, or the built-ins created_time / last_edited_time.',
+            },
+            {
+                name: 'sortDirection',
+                label: 'Direction',
+                type: 'select',
+                default: 'descending',
+                options: [
+                    { value: 'descending', label: 'Newest first' },
+                    { value: 'ascending', label: 'Oldest first' },
+                ],
+            },
+            {
+                name: 'pageSize',
+                label: 'How many',
+                type: 'number',
+                default: 25,
+                min: 1,
+                max: 100,
+                description: 'Notion caps a single query at 100 rows. Past that it paginates, and this node returns the first page only.',
+            },
+            {
+                name: 'filterJson',
+                label: 'Filter (raw JSON)',
+                type: 'json',
+                advanced: true,
+                placeholder: '{ "and": [ { "property": "Status", "select": { "equals": "Done" } } ] }',
+                description: 'The escape hatch for anything the three fields above cannot say — compound and/or, rollups, formulas. When this is filled in, it WINS and the simple filter is ignored.',
+            },
+        ],
+    },
+    getDataSource: {
+        label: 'Get data source schema',
+        description: 'Which properties exist and what type each one is.',
+        apiMethod: 'GET /v1/data_sources/{data_source_id}',
+        params: [dataSourceId()],
+    },
+    appendToPage: {
+        label: 'Append content',
+        description: 'Add to a page without touching what is already there.',
+        apiMethod: 'PATCH /v1/pages/{page_id}/markdown (insert_content)',
+        params: [
+            pageId(),
+            {
+                name: 'markdown',
+                label: 'Content (Markdown)',
+                type: 'textarea',
+                required: true,
+                placeholder: '- [ ] {{payload.task}}',
+                description: 'Appended as new blocks. Nothing already on the page is touched — this is the safe alternative to replacing the body.',
+            },
+            {
+                name: 'position',
+                label: 'Where',
+                type: 'select',
+                default: 'end',
+                options: [
+                    { value: 'end', label: 'At the end' },
+                    { value: 'start', label: 'At the top' },
+                ],
+            },
+        ],
+    },
+    getBlockChildren: {
+        label: 'Get block children',
+        description: 'The raw block tree, one level down.',
+        apiMethod: 'GET /v1/blocks/{block_id}/children',
+        params: [
+            {
+                name: 'blockId',
+                label: 'Page or block',
+                type: 'notionBlock',
+                required: true,
+                description: 'For reading a whole page as text, "Get page as Markdown" is almost always the one you want instead.',
+            },
+            {
+                name: 'pageSize',
+                label: 'How many',
+                type: 'number',
+                default: 50,
+                min: 1,
+                max: 100,
+            },
+        ],
+    },
+    search: {
+        label: 'Search',
+        description: 'Find pages and data sources by title.',
+        apiMethod: 'POST /v1/search',
+        params: [
+            {
+                name: 'query',
+                label: 'Query',
+                type: 'template',
+                placeholder: '{{payload.customerName}}',
+                description: 'Matches against titles only, not page content. Empty returns everything shared with the connection.',
+            },
+            {
+                name: 'filterObject',
+                label: 'Only',
+                type: 'select',
+                default: '',
+                options: [
+                    { value: '', label: 'Pages and data sources' },
+                    { value: 'page', label: 'Pages' },
+                    { value: 'data_source', label: 'Data sources' },
+                ],
+            },
+            {
+                name: 'sortDirection',
+                label: 'Sort by last edited',
+                type: 'select',
+                default: 'descending',
+                options: [
+                    { value: 'descending', label: 'Newest first' },
+                    { value: 'ascending', label: 'Oldest first' },
+                ],
+            },
+            {
+                name: 'pageSize',
+                label: 'How many',
+                type: 'number',
+                default: 25,
+                min: 1,
+                max: 100,
+            },
+        ],
+    },
+    createComment: {
+        label: 'Add comment',
+        description: 'A comment on a page, or a reply in an existing thread.',
+        apiMethod: 'POST /v1/comments',
+        params: [
+            {
+                name: 'target',
+                label: 'Comment on',
+                type: 'select',
+                required: true,
+                default: 'page',
+                options: [
+                    { value: 'page', label: 'A page' },
+                    { value: 'discussion', label: 'An existing thread' },
+                ],
+            },
+            {
+                ...pageId(),
+                showWhen: { field: 'target', in: ['page'] },
+            },
+            {
+                name: 'discussionId',
+                label: 'Discussion id',
+                type: 'template',
+                required: true,
+                showWhen: { field: 'target', in: ['discussion'] },
+                description: 'Comes from a comment.created trigger payload, or from Get page comments.',
+            },
+            {
+                name: 'text',
+                label: 'Comment',
+                type: 'textarea',
+                required: true,
+                placeholder: 'Handled automatically — {{payload.result}}',
+                description: `Plain text. ${notionVersionNote}`,
+            },
+        ],
+    },
+};
+/**
+ * Las operaciones tal y como se listan en el desplegable. Hoy es el enum
+ * entero; existe para que añadir una op interna (sin fila propia) no obligue
+ * a que la página vuelva a decidir por su cuenta qué enseñar.
+ */
+exports.NOTION_DROPDOWN_OPERATIONS = exports.NOTION_OPERATIONS;

package/dist/registry.js

@@ -265,6 +265,14 @@ exports.NODE_REGISTRY = {
         stateKey: 'firecrawlActions', allStateKey: 'allFirecrawlActions',
         color: '#f97316', testable: true,
     },
+    mailchimpAction: {
+        type: 'mailchimpAction', prefix: 'mc', label: 'Mailchimp',
+        group: 'Actions', detailPath: '/dashboard/mailchimp-actions', apiPath: '/mailchimp-actions',
+        stateKey: 'mailchimpActions', allStateKey: 'allMailchimpActions',
+        // Mailchimp's Cavendish yellow, darkened until it holds contrast on a
+        // light canvas. The brand value (#ffe01b) reads as a highlighter there.
+        color: '#c9a227', testable: true,
+    },
     telegramAction: {
         type: 'telegramAction', prefix: 'tg', label: 'Telegram Action',
         group: 'Actions', detailPath: '/dashboard/telegram-actions', apiPath: '/telegram-actions',
@@ -340,6 +348,20 @@ exports.NODE_REGISTRY = {
            MCP, sin nada que las ate-- y esa duplicacion no se paga antes de ver
            el nodo funcionando en pantalla. */
     },
+    notionAction: {
+        type: 'notionAction', prefix: 'ntn', label: 'Notion',
+        group: 'Actions', detailPath: '/dashboard/notion-actions', apiPath: '/notion-actions',
+        stateKey: 'notionActions', allStateKey: 'allNotionActions',
+        // Notion es monocromo de marca (su negro es #37352F), y un punto negro
+        // en el minimapa desaparece en modo oscuro. Este stone-500 es el gris
+        // CÁLIDO más cercano a esa marca, y no choca con el #94a3b8 (slate, gris
+        // frío) que ya llevan tres nodos: en el minimapa lo único que distingue
+        // a un nodo es el color.
+        color: '#78716c', testable: true,
+        /* Sin isToolOnly: la v1 no trae modo toolkit de IA. Cada toolkit vive dos
+           veces --specs del dashboard para el AI Node y specs de la api para
+           MCP-- y esa duplicación no se paga antes de ver el nodo en pantalla. */
+    },
     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 = 'webhook' | 'scheduledWorkflow' | 'chatTrigger' | 'trigger' | 'voiceAgent' | 'filter' | 'transform' | 'schemaValidator' | 'conditional' | 'delay' | 'rateLimiter' | 'aggregator' | 'cache' | 'code' | 'ai' | 'merge' | 'approval' | 'split' | 'loop' | 'markdown' | 'fileTransform' | 'limit' | 'router' | 'emailAction' | 'gmailAction' | 'httpAction' | 'mongoAction' | 'postgresAction' | 'notificationAction' | 'sheetsAction' | 'calendarAction' | 'docsAction' | 'driveAction' | 'firecrawlAction' | 'telegramAction' | 'whatsappAction' | 'discordAction' | 'slackAction' | 'googleContactsAction' | 'googleAnalyticsAction' | 'vectorStore' | 'rssAction' | 'socialMediaAction' | 'stickyNote';
+export type NodeType = 'webhook' | 'scheduledWorkflow' | 'chatTrigger' | 'trigger' | 'voiceAgent' | 'filter' | 'transform' | 'schemaValidator' | 'conditional' | 'delay' | 'rateLimiter' | 'aggregator' | 'cache' | 'code' | 'ai' | 'merge' | 'approval' | 'split' | 'loop' | 'markdown' | 'fileTransform' | 'limit' | 'router' | 'emailAction' | 'gmailAction' | 'httpAction' | 'mongoAction' | 'postgresAction' | 'notificationAction' | 'sheetsAction' | 'calendarAction' | 'docsAction' | 'driveAction' | 'firecrawlAction' | 'telegramAction' | 'whatsappAction' | 'discordAction' | 'slackAction' | 'googleContactsAction' | 'googleAnalyticsAction' | 'notionAction' | 'vectorStore' | 'rssAction' | 'socialMediaAction' | 'mailchimpAction' | '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

@@ -75,9 +75,11 @@ exports.NODE_UI = {
     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' } },
     discordAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'discord' } },
+    mailchimpAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'mailchimp' } },
     slackAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'slack' } },
     googleContactsAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
     googleAnalyticsAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    notionAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'notion' } },
     vectorStore: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
     rssAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
     socialMediaAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
@@ -97,8 +99,10 @@ exports.PREFIX_TO_TYPE = [
     { prefix: 'wa-', type: 'whatsappAction', canvasType: 'whatsappAction' },
     { prefix: 'dc-', type: 'discordAction', canvasType: 'discordAction' },
     { prefix: 'sl-', type: 'slackAction', canvasType: 'slackAction' },
+    { prefix: 'mc-', type: 'mailchimpAction', canvasType: 'mailchimpAction' },
     { prefix: 'gc-', type: 'googleContactsAction', canvasType: 'googleContactsAction' },
     { prefix: 'gaa-', type: 'googleAnalyticsAction', canvasType: 'googleAnalyticsAction' },
+    { prefix: 'ntn-', type: 'notionAction', canvasType: 'notionAction' },
     { 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.57.0",
+  "version": "1.59.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",