@hostwebhook/node-types 1.55.3 → 1.57.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', 'vectorStore', 'rssAction', 'socialMediaAction', 'loop',
+    'emailAction', 'gmailAction', 'httpAction', 'mongoAction', 'postgresAction', 'notificationAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'discordAction', 'slackAction', 'googleContactsAction', 'googleAnalyticsAction', 'vectorStore', 'rssAction', 'socialMediaAction', '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', 'vectorStore', 'rssAction', 'socialMediaAction'];
+const CHAINABLE_ACTIONS = ['httpAction', 'mongoAction', 'postgresAction', 'sheetsAction', 'calendarAction', 'docsAction', 'driveAction', 'firecrawlAction', 'telegramAction', 'whatsappAction', 'discordAction', 'slackAction', 'googleContactsAction', 'googleAnalyticsAction', 'vectorStore', 'rssAction', 'socialMediaAction'];
 /** Full input list for action nodes (standard + chainable actions) */
 const ACTION_INPUTS = [...STANDARD_INPUTS, ...CHAINABLE_ACTIONS];
 exports.NODE_CONNECTIONS = {
@@ -78,6 +78,7 @@ exports.NODE_CONNECTIONS = {
     discordAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     slackAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     googleContactsAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
+    googleAnalyticsAction: { 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/dispatch.js

@@ -54,6 +54,7 @@ exports.NODE_DISPATCH = {
     discordAction: { service: 'discordActionsService', collection: 'discordactions', 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' },
     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/google-analytics-operations.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Google Analytics 4 operation enum — single source of truth across the API,
+ * Dashboard, and Message Broker. Used by:
+ *   - googleAnalyticsAction entity / DTO (api): operation field + validation
+ *   - dashboard GoogleAnalyticsAction operation type
+ *   - MCP toolkit specs, si algún día el nodo gana modo toolkit
+ *
+ * Mismo patrón que `drive-operations.ts` y `sheets-operations.ts`.
+ *
+ * ── Por qué sólo dos operaciones ──
+ *
+ * GA4 tiene más superficie (`runPivotReport`, `batchRunReports`,
+ * `checkCompatibility`), pero declarar una op que el servicio todavía no
+ * implementa la pinta en el desplegable y la deja fallar al ejecutarse: el
+ * enum ES el contrato de la pantalla. Entran cuando entre su código.
+ *
+ * ── Lo que NO es una operación ──
+ *
+ * Listar propiedades y listar las dimensiones/métricas disponibles NO son
+ * ops del nodo: son endpoints del controlador, que es como Drive alimenta su
+ * `DriveFilePicker` (`@Get('files/:credentialId')`). Una op existe para
+ * producir payload en una corrida; esto otro es para rellenar el formulario.
+ *
+ * ── Decisiones propias de GA (anti-n8n) ──
+ *
+ *   - La propiedad se ELIGE de una lista, no se teclea. `properties/123456789`
+ *     y `G-XXXXXXX` se confunden todo el rato y el error de GA no lo aclara.
+ *   - Las fechas admiten `NdaysAgo` / `yesterday` / `today` además de
+ *     `YYYY-MM-DD`, que es lo que acepta la API, y son el sitio donde avisar
+ *     de que el dato no está cerrado hasta pasadas ~48 h.
+ *   - El filtro común (una dimensión, un valor) son tres campos; la
+ *     `FilterExpression` cruda queda de escape en Advanced y gana si está.
+ */
+export declare const GOOGLE_ANALYTICS_OPERATIONS: readonly ["runReport", "runRealtimeReport"];
+export type GoogleAnalyticsOperation = (typeof GOOGLE_ANALYTICS_OPERATIONS)[number];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+export declare function isGoogleAnalyticsOperation(value: unknown): value is GoogleAnalyticsOperation;
+export type GoogleAnalyticsParamType = 
+/** Selector vivo de propiedades GA4 (necesita credencial). */
+'analyticsProperty'
+/** Multi-selección de métricas, con las opciones vivas del metadata. */
+ | 'analyticsMetrics'
+/** Multi-selección de dimensiones, igual que las métricas. */
+ | 'analyticsDimensions'
+/** Texto con autocompletado de `{{payload.*}}`. */
+ | 'template'
+/** `<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 `''`. Mismo motivo que el `starred` de Drive: "— sin
+ * tocar —" tiene que significar que la clave no viaja.
+ */
+ | 'booleanSelect'
+/** Área de texto para JSON crudo (la FilterExpression de escape). */
+ | 'json';
+export interface GoogleAnalyticsParamSpec {
+    /** La clave de `operationConfig`. Es lo que lee la api, no un nombre de UI. */
+    name: string;
+    label: string;
+    type: GoogleAnalyticsParamType;
+    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 GoogleAnalyticsOperationSpec {
+    /** Etiqueta de la fila en el desplegable de operación. */
+    label: string;
+    /** Sub-línea bajo la etiqueta. */
+    description: string;
+    /** Método de la API al que mapea (developers.google.com/analytics/devguides/reporting/data/v1). */
+    apiMethod: string;
+    /** Esquema de parámetros. El orden ES el orden en pantalla. */
+    params: GoogleAnalyticsParamSpec[];
+}
+export declare const GOOGLE_ANALYTICS_OPERATION_SPECS: Record<GoogleAnalyticsOperation, GoogleAnalyticsOperationSpec>;
+/**
+ * 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 GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS: readonly GoogleAnalyticsOperation[];

package/dist/google-analytics-operations.js

@@ -0,0 +1,226 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = exports.GOOGLE_ANALYTICS_OPERATION_SPECS = exports.GOOGLE_ANALYTICS_OPERATIONS = void 0;
+exports.isGoogleAnalyticsOperation = isGoogleAnalyticsOperation;
+/**
+ * Google Analytics 4 operation enum — single source of truth across the API,
+ * Dashboard, and Message Broker. Used by:
+ *   - googleAnalyticsAction entity / DTO (api): operation field + validation
+ *   - dashboard GoogleAnalyticsAction operation type
+ *   - MCP toolkit specs, si algún día el nodo gana modo toolkit
+ *
+ * Mismo patrón que `drive-operations.ts` y `sheets-operations.ts`.
+ *
+ * ── Por qué sólo dos operaciones ──
+ *
+ * GA4 tiene más superficie (`runPivotReport`, `batchRunReports`,
+ * `checkCompatibility`), pero declarar una op que el servicio todavía no
+ * implementa la pinta en el desplegable y la deja fallar al ejecutarse: el
+ * enum ES el contrato de la pantalla. Entran cuando entre su código.
+ *
+ * ── Lo que NO es una operación ──
+ *
+ * Listar propiedades y listar las dimensiones/métricas disponibles NO son
+ * ops del nodo: son endpoints del controlador, que es como Drive alimenta su
+ * `DriveFilePicker` (`@Get('files/:credentialId')`). Una op existe para
+ * producir payload en una corrida; esto otro es para rellenar el formulario.
+ *
+ * ── Decisiones propias de GA (anti-n8n) ──
+ *
+ *   - La propiedad se ELIGE de una lista, no se teclea. `properties/123456789`
+ *     y `G-XXXXXXX` se confunden todo el rato y el error de GA no lo aclara.
+ *   - Las fechas admiten `NdaysAgo` / `yesterday` / `today` además de
+ *     `YYYY-MM-DD`, que es lo que acepta la API, y son el sitio donde avisar
+ *     de que el dato no está cerrado hasta pasadas ~48 h.
+ *   - El filtro común (una dimensión, un valor) son tres campos; la
+ *     `FilterExpression` cruda queda de escape en Advanced y gana si está.
+ */
+exports.GOOGLE_ANALYTICS_OPERATIONS = [
+    'runReport', // informe estándar sobre un rango de fechas
+    'runRealtimeReport', // los últimos ~30 minutos, sin rango de fechas
+];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+function isGoogleAnalyticsOperation(value) {
+    return (typeof value === 'string' &&
+        exports.GOOGLE_ANALYTICS_OPERATIONS.includes(value));
+}
+/* Fábricas de los campos que se repiten, para que un cambio de copy no haya
+   que perseguirlo por las dos operaciones —y por las que vengan. */
+const propertyId = () => ({
+    name: 'propertyId',
+    label: 'GA4 Property',
+    type: 'analyticsProperty',
+    required: true,
+    description: 'Pick a property from the connected account, or paste a templated value like {{payload.propertyId}}. This is the numeric property id (properties/123456789), not the G-XXXXXXX measurement id.',
+});
+const metrics = () => ({
+    name: 'metrics',
+    label: 'Metrics',
+    type: 'analyticsMetrics',
+    required: true,
+    description: 'What to measure — activeUsers, sessions, screenPageViews, conversions. At least one is required.',
+});
+const dimensions = () => ({
+    name: 'dimensions',
+    label: 'Dimensions',
+    type: 'analyticsDimensions',
+    description: 'How to break the metrics down — date, country, pagePath, sessionSource. Leave empty for a single total row.',
+});
+const limit = (max, def) => ({
+    name: 'limit',
+    label: 'Row limit',
+    type: 'number',
+    default: def,
+    min: 1,
+    max,
+    description: `Maximum rows to return. The API caps a single request at ${max.toLocaleString('en-US')}.`,
+});
+/** Los tipos de coincidencia de una `stringFilter` de GA4. */
+const MATCH_TYPE_OPTIONS = [
+    { value: 'EXACT', label: 'is exactly' },
+    { value: 'CONTAINS', label: 'contains' },
+    { value: 'BEGINS_WITH', label: 'begins with' },
+    { value: 'ENDS_WITH', label: 'ends with' },
+    { value: 'FULL_REGEXP', label: 'matches regex' },
+];
+/* El filtro simple: una dimensión, una comparación, un valor. Cubre el caso
+   que pide todo el mundo ("country es Spain") sin obligar a escribir una
+   FilterExpression anidada. Quien necesite más tiene `dimensionFilterJson`. */
+const simpleFilter = () => [
+    {
+        name: 'filterDimension',
+        label: 'Filter by dimension',
+        type: 'analyticsDimensions',
+        description: 'Optional. Restrict the report to rows where this dimension matches the value below.',
+    },
+    {
+        name: 'filterMatchType',
+        label: 'Match',
+        type: 'select',
+        default: 'EXACT',
+        options: MATCH_TYPE_OPTIONS,
+        showWhen: { field: 'filterDimension', in: ['*'] },
+    },
+    {
+        name: 'filterValue',
+        label: 'Value',
+        type: 'template',
+        placeholder: 'Spain',
+        description: 'Templates work — e.g. {{payload.country}}.',
+        showWhen: { field: 'filterDimension', in: ['*'] },
+    },
+];
+const dimensionFilterJson = () => ({
+    name: 'dimensionFilterJson',
+    label: 'Raw dimension filter (FilterExpression JSON)',
+    type: 'json',
+    advanced: true,
+    placeholder: '{"andGroup":{"expressions":[{"filter":{"fieldName":"country","stringFilter":{"value":"Spain"}}}]}}',
+    description: 'Escape hatch for AND / OR / NOT groups the simple filter above cannot express. When set, this WINS and the three simple filter fields are ignored.',
+});
+const orderBy = () => [
+    {
+        name: 'orderByField',
+        label: 'Sort by',
+        type: 'template',
+        advanced: true,
+        placeholder: 'activeUsers',
+        description: 'Metric or dimension name to sort on. Must be one of the metrics or dimensions selected above. Empty = the API default order.',
+    },
+    {
+        name: 'orderByDesc',
+        label: 'Sort direction',
+        type: 'booleanSelect',
+        advanced: true,
+        options: [
+            { value: '', label: '— API default —' },
+            { value: 'true', label: 'Descending (highest first)' },
+            { value: 'false', label: 'Ascending (lowest first)' },
+        ],
+        showWhen: { field: 'orderByField', in: ['*'] },
+    },
+];
+exports.GOOGLE_ANALYTICS_OPERATION_SPECS = {
+    runReport: {
+        label: 'Run report',
+        description: 'Metrics over a date range, broken down by dimensions.',
+        apiMethod: 'properties.runReport',
+        params: [
+            propertyId(),
+            metrics(),
+            dimensions(),
+            {
+                name: 'startDate',
+                label: 'Start date',
+                type: 'template',
+                required: true,
+                default: '28daysAgo',
+                description: 'YYYY-MM-DD, or a relative value: today, yesterday, NdaysAgo. Note GA4 keeps refining recent data for up to 48h, so a window ending at "today" can change between two runs.',
+            },
+            {
+                name: 'endDate',
+                label: 'End date',
+                type: 'template',
+                required: true,
+                default: 'today',
+                description: 'Same formats as the start date. Inclusive.',
+            },
+            ...simpleFilter(),
+            limit(250000, 100),
+            {
+                name: 'offset',
+                label: 'Row offset',
+                type: 'number',
+                advanced: true,
+                default: 0,
+                min: 0,
+                description: 'Skip this many rows before returning. Use with the row limit to page through a large report.',
+            },
+            ...orderBy(),
+            dimensionFilterJson(),
+            {
+                name: 'keepEmptyRows',
+                label: 'Keep empty rows',
+                type: 'booleanSelect',
+                advanced: true,
+                options: [
+                    { value: '', label: '— API default (drop them) —' },
+                    { value: 'true', label: 'Keep rows whose metrics are all zero' },
+                    { value: 'false', label: 'Drop rows whose metrics are all zero' },
+                ],
+            },
+        ],
+    },
+    runRealtimeReport: {
+        label: 'Run realtime report',
+        description: 'What is happening right now — the last 30 minutes.',
+        apiMethod: 'properties.runRealtimeReport',
+        params: [
+            propertyId(),
+            metrics(),
+            dimensions(),
+            {
+                name: 'minutesAgo',
+                label: 'Window',
+                type: 'select',
+                default: '29',
+                options: [
+                    { value: '4', label: 'Last 5 minutes' },
+                    { value: '14', label: 'Last 15 minutes' },
+                    { value: '29', label: 'Last 30 minutes' },
+                ],
+                description: 'Realtime has no date range — it always looks back from now, and GA4 caps the lookback at 30 minutes.',
+            },
+            ...simpleFilter(),
+            limit(100000, 100),
+            ...orderBy(),
+            dimensionFilterJson(),
+        ],
+    },
+};
+/**
+ * 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.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = exports.GOOGLE_ANALYTICS_OPERATIONS;

package/dist/index.d.ts

@@ -3,8 +3,9 @@ export { singleMeta, iterableMeta } from './types';
 export { NODE_CONNECTIONS, canReceiveFrom, canReceiveFromNodes, canSendToNodes, isTerminal, isNodeType, ALL_NODE_TYPES, } from './connections';
 export { NODE_UI, PREFIX_TO_TYPE, resolveNodeId, } from './ui';
 export { NODE_DISPATCH, getAllNodeCollections, getNodeDispatchConfig, } from './dispatch';
-export type { NodeRegistryEntry, NodeGroup } from './registry';
+export type { NodeRegistryEntry, NodeGroup, NodeVersionSpec, VersionCatalog, } from './registry';
 export { NODE_REGISTRY, getNodeRegistryEntry, NODE_DETAIL_PATHS, NODE_COLORS, NODE_STATE_KEYS, PREFIX_TO_NODE_TYPE, NODE_TYPE_TO_PREFIX, } from './registry';
+export { isVersioned, versionsOf, versionSpec, currentVersion, fieldsLostBetween, fieldsLost, versionCatalogErrors, } from './registry';
 export { GMAIL_OPERATIONS, GMAIL_OPERATION_SPECS, GMAIL_OPERATION_GROUPS, GMAIL_DROPDOWN_OPERATIONS, GMAIL_TOOLKIT_OPERATIONS, GMAIL_TOOLKIT_SPECS, GMAIL_ALL_TOOLKIT_SPECS, GMAIL_SEND_AND_WAIT_TOOL_SPEC, NATIVE_EMAIL_TOOLKIT_SPECS, GMAIL_TOOLKIT_BY_TOOL_NAME, NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME, GMAIL_SEND_LEGACY_FIELDS, resolveGmailSendFields, isGmailOperation, } from './gmail-operations';
 export type { GmailOperation, GmailOperationGroup, GmailParamType, GmailParamSpec, GmailOperationSpec, GmailToolkitParameter, GmailToolkitSpec, GmailSendFieldSource, GmailSendFields, } from './gmail-operations';
 export { GOOGLE_CALENDAR_OPERATIONS, GOOGLE_CALENDAR_OPERATION_SPECS, isGoogleCalendarOperation, } from './calendar-operations';
@@ -31,6 +32,8 @@ export { SHEETS_TOOLKIT_SPECS, SHEETS_TOOLKIT_BY_TOOL_NAME, SHEETS_TOOLKIT_DEFAU
 export type { SheetsToolkitSpec, SheetsToolkitParameter, } from './sheets-toolkit';
 export { GOOGLE_CONTACTS_OPERATIONS, GOOGLE_CONTACTS_OPERATIONS_V1, GOOGLE_CONTACTS_OPERATIONS_V2, GOOGLE_CONTACTS_OPERATION_SPECS, GOOGLE_CONTACTS_OPERATION_GROUPS, GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS, isGoogleContactsOperation, } from './google-contacts-operations';
 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 { 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,7 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-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 = 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.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.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 = 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.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 = void 0;
+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;
 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; } });
@@ -32,6 +33,16 @@ Object.defineProperty(exports, "NODE_COLORS", { enumerable: true, get: function
 Object.defineProperty(exports, "NODE_STATE_KEYS", { enumerable: true, get: function () { return registry_1.NODE_STATE_KEYS; } });
 Object.defineProperty(exports, "PREFIX_TO_NODE_TYPE", { enumerable: true, get: function () { return registry_1.PREFIX_TO_NODE_TYPE; } });
 Object.defineProperty(exports, "NODE_TYPE_TO_PREFIX", { enumerable: true, get: function () { return registry_1.NODE_TYPE_TO_PREFIX; } });
+// ── Node version catalog (ALL repos) ──
+// See docs/ADR-0002-node-versioning.md in the api repo.
+var registry_2 = require("./registry");
+Object.defineProperty(exports, "isVersioned", { enumerable: true, get: function () { return registry_2.isVersioned; } });
+Object.defineProperty(exports, "versionsOf", { enumerable: true, get: function () { return registry_2.versionsOf; } });
+Object.defineProperty(exports, "versionSpec", { enumerable: true, get: function () { return registry_2.versionSpec; } });
+Object.defineProperty(exports, "currentVersion", { enumerable: true, get: function () { return registry_2.currentVersion; } });
+Object.defineProperty(exports, "fieldsLostBetween", { enumerable: true, get: function () { return registry_2.fieldsLostBetween; } });
+Object.defineProperty(exports, "fieldsLost", { enumerable: true, get: function () { return registry_2.fieldsLost; } });
+Object.defineProperty(exports, "versionCatalogErrors", { enumerable: true, get: function () { return registry_2.versionCatalogErrors; } });
 // ── Per-service operation enums (ALL repos) ──
 var gmail_operations_1 = require("./gmail-operations");
 Object.defineProperty(exports, "GMAIL_OPERATIONS", { enumerable: true, get: function () { return gmail_operations_1.GMAIL_OPERATIONS; } });
@@ -96,6 +107,11 @@ Object.defineProperty(exports, "GOOGLE_CONTACTS_OPERATION_SPECS", { enumerable:
 Object.defineProperty(exports, "GOOGLE_CONTACTS_OPERATION_GROUPS", { enumerable: true, get: function () { return google_contacts_operations_1.GOOGLE_CONTACTS_OPERATION_GROUPS; } });
 Object.defineProperty(exports, "GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS", { enumerable: true, get: function () { return google_contacts_operations_1.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS; } });
 Object.defineProperty(exports, "isGoogleContactsOperation", { enumerable: true, get: function () { return google_contacts_operations_1.isGoogleContactsOperation; } });
+var google_analytics_operations_1 = require("./google-analytics-operations");
+Object.defineProperty(exports, "GOOGLE_ANALYTICS_OPERATIONS", { enumerable: true, get: function () { return google_analytics_operations_1.GOOGLE_ANALYTICS_OPERATIONS; } });
+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 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/registry.d.ts

@@ -41,6 +41,51 @@ export interface NodeRegistryEntry {
      * Predicate must be pure (no side effects) — called on every render.
      */
     isToolOnly?: (entity: Record<string, unknown>) => boolean;
+    /**
+     * The versions this node type ships, when it ships more than one.
+     *
+     * Absent means the type does not version, which is true of every type
+     * today. A node type only declares this the day its provider deprecates
+     * something and a second version has to live alongside the first.
+     *
+     * See `docs/ADR-0002-node-versioning.md` in the api repo.
+     */
+    versions?: NodeVersionSpec[];
+}
+/**
+ * One version of a node type.
+ *
+ * Deliberately NOT a schema. The api's DTO stays the validator; all this
+ * needs to know is WHICH config fields a version understands, because that
+ * is what answers the only question the UI has to ask: switching from here
+ * to there, what does the user lose?
+ */
+export interface NodeVersionSpec {
+    /** The number the user sees. Unique within a type. */
+    v: number;
+    /** Shown next to the number in the picker, e.g. "Discord API v10". */
+    label?: string;
+    /**
+     * `current` is what a new node is born on — exactly one per type.
+     * `legacy` still runs but is on its way out. `beta` is opt-in.
+     */
+    status: 'current' | 'legacy' | 'beta';
+    /**
+     * The config fields this version understands.
+     *
+     * Only fields the user configures. Identity and topology — name,
+     * inputNodes, outputNodes, isActive, canvas position — never belong
+     * here: they survive a version change untouched, and listing them
+     * would put them at risk of being unset.
+     */
+    fields: string[];
+    /**
+     * Entering this version keeps nothing. For the case where "v2" is
+     * really a different integration wearing the same node's name.
+     */
+    cleanBreak?: boolean;
+    /** Why it was retired, or what it brings. Shown in picker and dialog. */
+    note?: string;
 }
 export declare const NODE_REGISTRY: Record<NodeType, NodeRegistryEntry>;
 /** Get registry entry by canonical type */
@@ -55,3 +100,61 @@ export declare const NODE_STATE_KEYS: Record<string, [string, string]>;
 export declare const PREFIX_TO_NODE_TYPE: Record<string, NodeType>;
 /** type → prefix */
 export declare const NODE_TYPE_TO_PREFIX: Record<string, string>;
+/**
+ * The catalog these helpers read. Every one of them takes it as an
+ * optional last argument defaulting to the real registry: consumers never
+ * pass it, and the tests can exercise a versioned type without waiting
+ * for a real one to exist.
+ */
+export type VersionCatalog = Record<string, Pick<NodeRegistryEntry, 'type' | 'versions'>>;
+/** True when this type ships more than one version. False for every type today. */
+export declare function isVersioned(type: string, catalog?: VersionCatalog): boolean;
+/**
+ * Every declared version, newest first — the order a picker wants.
+ * Empty for a type that does not version.
+ */
+export declare function versionsOf(type: string, catalog?: VersionCatalog): NodeVersionSpec[];
+/** One version's spec, or undefined when the type or the number is unknown. */
+export declare function versionSpec(type: string, v: number, catalog?: VersionCatalog): NodeVersionSpec | undefined;
+/**
+ * The version a new node of this type is born on.
+ *
+ * Returns 1 for a type that does not version, which is also how an entity
+ * with no `nodeVersion` is read. A node created before its type ever
+ * versioned was calling the original endpoints, so calling it version 1
+ * is not a convention — it is the truth.
+ */
+export declare function currentVersion(type: string, catalog?: VersionCatalog): number;
+/**
+ * Config fields present in `from` that `to` does not declare — the exact
+ * list a confirmation dialog should name, and the exact list the server
+ * should unset.
+ *
+ * Returns `null` when the question cannot be answered: the type does not
+ * version, or one of the two versions is not declared. `null` is not the
+ * same as "nothing is lost", and callers must not treat it that way — a
+ * dialog should refuse to offer the switch, and the api should reject the
+ * request. Returning `null` rather than `[]` is what stops "I don't know"
+ * from being read as "nothing".
+ *
+ * This lives here rather than in each consumer because the dialog that
+ * ANNOUNCES the loss and the server that PERFORMS it have to give the
+ * same answer. Two implementations would agree right until the day they
+ * did not, and that day the dialog lies.
+ */
+export declare function fieldsLostBetween(type: string, from: number, to: number, catalog?: VersionCatalog): string[] | null;
+/**
+ * The same answer for two specs already in hand — what `fieldsLostBetween`
+ * delegates to once it has resolved both, and what a caller that already
+ * holds them from `versionsOf()` can use without a second lookup.
+ */
+export declare function fieldsLost(from: NodeVersionSpec, to: NodeVersionSpec): string[];
+/**
+ * Declaration mistakes in the version catalogs, as readable lines.
+ *
+ * A guard rather than a line in a document: what this codebase learned
+ * from fifteen nodes skipping a checklist point everyone had read is that
+ * the written rule prevented nothing and the guard did. Empty means every
+ * catalog is well-formed.
+ */
+export declare function versionCatalogErrors(catalog?: VersionCatalog): string[];

package/dist/registry.js

@@ -9,6 +9,13 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.NODE_REGISTRY = void 0;
 exports.getNodeRegistryEntry = getNodeRegistryEntry;
+exports.isVersioned = isVersioned;
+exports.versionsOf = versionsOf;
+exports.versionSpec = versionSpec;
+exports.currentVersion = currentVersion;
+exports.fieldsLostBetween = fieldsLostBetween;
+exports.fieldsLost = fieldsLost;
+exports.versionCatalogErrors = versionCatalogErrors;
 exports.NODE_REGISTRY = {
     // ── Sources ──
     webhook: {
@@ -320,6 +327,19 @@ exports.NODE_REGISTRY = {
         // handles to keep manual + tool modes from being mixed.
         isToolOnly: (e) => e.aiEnabled === true,
     },
+    googleAnalyticsAction: {
+        type: 'googleAnalyticsAction', prefix: 'gaa', label: 'Google Analytics',
+        group: 'Actions', detailPath: '/dashboard/google-analytics-actions', apiPath: '/google-analytics-actions',
+        stateKey: 'googleAnalyticsActions', allStateKey: 'allGoogleAnalyticsActions',
+        // Naranja de marca de Google Analytics (#E37400). No reutiliza el
+        // #ff9933 de RSS ni el orange-500 de Tailwind que ya llevan tres nodos:
+        // en el minimapa lo unico que distingue a un nodo es el color.
+        color: '#E37400', 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, sin nada que las ate-- y esa duplicacion no se paga antes de ver
+           el nodo funcionando en pantalla. */
+    },
     vectorStore: {
         type: 'vectorStore', prefix: 'vs', label: 'Vector Store',
         group: 'Actions', detailPath: '/dashboard/vector-store-nodes', apiPath: '/vector-store-nodes',
@@ -370,3 +390,108 @@ exports.NODE_STATE_KEYS = Object.fromEntries(Object.values(exports.NODE_REGISTRY
 exports.PREFIX_TO_NODE_TYPE = Object.fromEntries(Object.values(exports.NODE_REGISTRY).map(n => [n.prefix, n.type]));
 /** type → prefix */
 exports.NODE_TYPE_TO_PREFIX = Object.fromEntries(Object.values(exports.NODE_REGISTRY).map(n => [n.type, n.prefix]));
+function specsFor(type, catalog) {
+    return catalog[type]?.versions;
+}
+/** True when this type ships more than one version. False for every type today. */
+function isVersioned(type, catalog = exports.NODE_REGISTRY) {
+    return (specsFor(type, catalog)?.length ?? 0) > 0;
+}
+/**
+ * Every declared version, newest first — the order a picker wants.
+ * Empty for a type that does not version.
+ */
+function versionsOf(type, catalog = exports.NODE_REGISTRY) {
+    const declared = specsFor(type, catalog);
+    if (!declared)
+        return [];
+    return [...declared].sort((a, b) => b.v - a.v);
+}
+/** One version's spec, or undefined when the type or the number is unknown. */
+function versionSpec(type, v, catalog = exports.NODE_REGISTRY) {
+    return specsFor(type, catalog)?.find(s => s.v === v);
+}
+/**
+ * The version a new node of this type is born on.
+ *
+ * Returns 1 for a type that does not version, which is also how an entity
+ * with no `nodeVersion` is read. A node created before its type ever
+ * versioned was calling the original endpoints, so calling it version 1
+ * is not a convention — it is the truth.
+ */
+function currentVersion(type, catalog = exports.NODE_REGISTRY) {
+    const current = specsFor(type, catalog)?.find(s => s.status === 'current');
+    return current?.v ?? 1;
+}
+/**
+ * Config fields present in `from` that `to` does not declare — the exact
+ * list a confirmation dialog should name, and the exact list the server
+ * should unset.
+ *
+ * Returns `null` when the question cannot be answered: the type does not
+ * version, or one of the two versions is not declared. `null` is not the
+ * same as "nothing is lost", and callers must not treat it that way — a
+ * dialog should refuse to offer the switch, and the api should reject the
+ * request. Returning `null` rather than `[]` is what stops "I don't know"
+ * from being read as "nothing".
+ *
+ * This lives here rather than in each consumer because the dialog that
+ * ANNOUNCES the loss and the server that PERFORMS it have to give the
+ * same answer. Two implementations would agree right until the day they
+ * did not, and that day the dialog lies.
+ */
+function fieldsLostBetween(type, from, to, catalog = exports.NODE_REGISTRY) {
+    const a = versionSpec(type, from, catalog);
+    const b = versionSpec(type, to, catalog);
+    if (!a || !b)
+        return null;
+    return fieldsLost(a, b);
+}
+/**
+ * The same answer for two specs already in hand — what `fieldsLostBetween`
+ * delegates to once it has resolved both, and what a caller that already
+ * holds them from `versionsOf()` can use without a second lookup.
+ */
+function fieldsLost(from, to) {
+    if (from.v === to.v)
+        return [];
+    if (to.cleanBreak)
+        return [...from.fields];
+    const kept = new Set(to.fields);
+    return from.fields.filter(f => !kept.has(f));
+}
+/**
+ * Declaration mistakes in the version catalogs, as readable lines.
+ *
+ * A guard rather than a line in a document: what this codebase learned
+ * from fifteen nodes skipping a checklist point everyone had read is that
+ * the written rule prevented nothing and the guard did. Empty means every
+ * catalog is well-formed.
+ */
+function versionCatalogErrors(catalog = exports.NODE_REGISTRY) {
+    const errors = [];
+    for (const entry of Object.values(catalog)) {
+        const versions = entry.versions;
+        if (!versions)
+            continue;
+        if (versions.length === 0) {
+            errors.push(`${entry.type}: declares an empty versions array — omit the field instead`);
+            continue;
+        }
+        const numbers = versions.map(s => s.v);
+        const repeatedNumbers = [...new Set(numbers.filter((n, i) => numbers.indexOf(n) !== i))];
+        if (repeatedNumbers.length)
+            errors.push(`${entry.type}: repeated version number ${repeatedNumbers.join(', ')}`);
+        for (const spec of versions) {
+            if (!Number.isInteger(spec.v) || spec.v < 1)
+                errors.push(`${entry.type}: version "${spec.v}" is not a positive integer`);
+            const repeatedFields = [...new Set(spec.fields.filter((f, i) => spec.fields.indexOf(f) !== i))];
+            if (repeatedFields.length)
+                errors.push(`${entry.type} v${spec.v}: repeated field ${repeatedFields.join(', ')}`);
+        }
+        const current = versions.filter(s => s.status === 'current');
+        if (current.length !== 1)
+            errors.push(`${entry.type}: needs exactly one version with status "current", found ${current.length}`);
+    }
+    return errors;
+}

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' | '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' | 'vectorStore' | 'rssAction' | 'socialMediaAction' | '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

@@ -77,6 +77,7 @@ exports.NODE_UI = {
     discordAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'discord' } },
     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 } },
     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,6 +98,7 @@ exports.PREFIX_TO_TYPE = [
     { prefix: 'dc-', type: 'discordAction', canvasType: 'discordAction' },
     { prefix: 'sl-', type: 'slackAction', canvasType: 'slackAction' },
     { prefix: 'gc-', type: 'googleContactsAction', canvasType: 'googleContactsAction' },
+    { prefix: 'gaa-', type: 'googleAnalyticsAction', canvasType: 'googleAnalyticsAction' },
     { 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.55.3",
+  "version": "1.57.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,6 +9,7 @@
   ],
   "scripts": {
     "build": "tsc",
+    "test": "vitest run",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -18,6 +19,7 @@
   ],
   "license": "MIT",
   "devDependencies": {
-    "typescript": "^5.0.0"
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
   }
 }