@hostwebhook/node-types 1.64.0 → 1.65.0

package/dist/connections.js

@@ -80,6 +80,7 @@ exports.NODE_CONNECTIONS = {
     mailchimpAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     shopifyAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     githubAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
+    jiraAction: { 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 },

package/dist/dispatch.js

@@ -55,6 +55,7 @@ exports.NODE_DISPATCH = {
     mailchimpAction: { service: 'mailchimpActionsService', collection: 'mailchimpactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     shopifyAction: { service: 'shopifyActionsService', collection: 'shopifyactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     githubAction: { service: 'githubActionsService', collection: 'githubactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    jiraAction: { service: 'jiraActionsService', collection: 'jiraactions', 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' },

package/dist/index.d.ts

@@ -30,6 +30,8 @@ export { SHOPIFY_OPERATIONS, SHOPIFY_OPERATION_SPECS, SHOPIFY_TAGGABLE_RESOURCES
 export type { ShopifyOperation, ShopifyTaggableResource, ShopifySearchableResource, ShopifyParamSpec, ShopifyOperationSpec, } from './shopify-operations';
 export { GITHUB_OPERATIONS, GITHUB_OPERATION_SPECS, GITHUB_DROPDOWN_OPERATIONS, GITHUB_ITERABLE_OPERATIONS, isGithubOperation, } from './github-operations';
 export type { GithubOperation, GithubParamType, GithubParamSpec, GithubOperationSpec, } from './github-operations';
+export { JIRA_OPERATIONS, JIRA_OPERATION_SPECS, JIRA_DROPDOWN_OPERATIONS, JIRA_ITERABLE_OPERATIONS, isJiraOperation, } from './jira-operations';
+export type { JiraOperation, JiraParamType, JiraParamSpec, JiraOperationSpec, } from './jira-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';

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.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.isGithubOperation = exports.GITHUB_ITERABLE_OPERATIONS = exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATION_SPECS = exports.GITHUB_OPERATIONS = exports.isShopifyOperation = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SPECS = exports.SHOPIFY_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 = 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 = void 0;
+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.isJiraOperation = exports.JIRA_ITERABLE_OPERATIONS = exports.JIRA_DROPDOWN_OPERATIONS = exports.JIRA_OPERATION_SPECS = exports.JIRA_OPERATIONS = exports.isGithubOperation = exports.GITHUB_ITERABLE_OPERATIONS = exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATION_SPECS = exports.GITHUB_OPERATIONS = exports.isShopifyOperation = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SPECS = exports.SHOPIFY_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 = 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 = 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; } });
@@ -104,6 +104,12 @@ Object.defineProperty(exports, "GITHUB_OPERATION_SPECS", { enumerable: true, get
 Object.defineProperty(exports, "GITHUB_DROPDOWN_OPERATIONS", { enumerable: true, get: function () { return github_operations_1.GITHUB_DROPDOWN_OPERATIONS; } });
 Object.defineProperty(exports, "GITHUB_ITERABLE_OPERATIONS", { enumerable: true, get: function () { return github_operations_1.GITHUB_ITERABLE_OPERATIONS; } });
 Object.defineProperty(exports, "isGithubOperation", { enumerable: true, get: function () { return github_operations_1.isGithubOperation; } });
+var jira_operations_1 = require("./jira-operations");
+Object.defineProperty(exports, "JIRA_OPERATIONS", { enumerable: true, get: function () { return jira_operations_1.JIRA_OPERATIONS; } });
+Object.defineProperty(exports, "JIRA_OPERATION_SPECS", { enumerable: true, get: function () { return jira_operations_1.JIRA_OPERATION_SPECS; } });
+Object.defineProperty(exports, "JIRA_DROPDOWN_OPERATIONS", { enumerable: true, get: function () { return jira_operations_1.JIRA_DROPDOWN_OPERATIONS; } });
+Object.defineProperty(exports, "JIRA_ITERABLE_OPERATIONS", { enumerable: true, get: function () { return jira_operations_1.JIRA_ITERABLE_OPERATIONS; } });
+Object.defineProperty(exports, "isJiraOperation", { enumerable: true, get: function () { return jira_operations_1.isJiraOperation; } });
 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; } });

package/dist/jira-operations.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Las operaciones del nodo `jiraAction` — la lista que comparten la api, el
+ * dashboard y el broker.
+ *
+ * Mismo patrón que `github-operations.ts` y `shopify-operations.ts`.
+ *
+ * ── Contra qué está escrito ──
+ *
+ * Jira Cloud, **REST API v3**, servida en
+ * `https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/…`. El `cloudId` sale
+ * de la credencial `oauth2_atlassian`, que ya existe: la montó el trigger de
+ * Jira y aquí se reutiliza entera.
+ *
+ * El permiso que hace falta para escribir es **`write:jira-work`**. Se añadió a
+ * los de por defecto en api#384; toda credencial anterior a eso es de sólo
+ * lectura hasta que su dueño la reconecte, y el síntoma es un 403 al ejecutar,
+ * no un fallo al guardar.
+ *
+ * ── La decisión que ordena todo lo demás: ADF ──
+ *
+ * En la v3, `description` y el `body` de un comentario **no son texto**: son
+ * Atlassian Document Format, un árbol JSON de nodos tipados. Mandar una cadena
+ * da 400.
+ *
+ * La salida fácil sería escribir con la v2, que sí acepta texto plano y sigue
+ * soportada. No se hace, y el motivo está escrito en nuestro propio repositorio
+ * desde antes de este nodo: `jira-watch.service.ts` excluye `description` al
+ * hidratar campos y explica por qué — *"la REST devuelve ADF —un objeto— pero
+ * el webhook manda texto plano; mezclar formas rompería las plantillas de
+ * abajo, que esperan cadenas"*.
+ *
+ * O sea: si este nodo leyera con una versión y escribiera con otra,
+ * `{{payload.fields.description}}` significaría una cosa cuando el flujo lo
+ * dispara un trigger de Jira y otra cuando lo consulta este nodo. Por eso:
+ *
+ *   - **Todo en v3**, para leer y para escribir.
+ *   - Al escribir, el texto del usuario se envuelve en ADF.
+ *   - Al leer, el ADF se aplana a texto, y el árbol original viaja en una clave
+ *     hermana para quien lo necesite.
+ *   - `bodyFormat` deja pegar ADF crudo a quien quiera tablas o paneles.
+ *
+ * ── La otra trampa: la búsqueda cambió de sitio ──
+ *
+ * `GET/POST /rest/api/3/search` está **deprecado**. El sustituto es
+ * `POST /rest/api/3/search/jql`, y no es un renombre: pagina con
+ * `nextPageToken` en vez de `startAt`, **no devuelve `total`** (para contar hay
+ * `/search/approximate-count`) y los campos hay que pedirlos explícitamente.
+ * Casi todo ejemplo que hay por internet usa el endpoint muerto.
+ *
+ * ── Lo que NO es una operación ──
+ *
+ * Listar proyectos, tipos de incidencia, transiciones, estados o usuarios
+ * asignables **no** son operaciones: son endpoints del controlador que alimentan
+ * los selectores, como Drive alimenta su selector de ficheros. Una operación
+ * existe para producir payload en una corrida; esto otro es para rellenar el
+ * formulario. Mezclarlos llena el desplegable de cosas que nadie quiere
+ * ejecutar.
+ *
+ * ── Decisiones propias de Jira ──
+ *
+ *   - El proyecto y el tipo de incidencia se ELIGEN de una lista viva. Un
+ *     `issuetype` se identifica por un id numérico que nadie sabe de memoria.
+ *   - **Las transiciones no son una lista fija.** Dependen del flujo de trabajo
+ *     Y del estado actual de la incidencia, así que el selector las pide para
+ *     esa incidencia concreta. Ofrecer una lista global sería ofrecer
+ *     transiciones que fallan al ejecutarse.
+ *   - Los campos personalizados van en JSON crudo. Cada tipo tiene su forma
+ *     (`select`, `date`, `relation`, usuario…) y fingir que caben en tres
+ *     campos genéricos produce un 400 que no nombra el campo.
+ *   - Ninguna operación declarada sin implementar: el enum ES el contrato de la
+ *     pantalla, y una operación declarada se pinta en el desplegable y falla al
+ *     ejecutarse.
+ */
+export declare const JIRA_OPERATIONS: readonly ["createIssue", "getIssue", "updateIssue", "deleteIssue", "assignIssue", "transitionIssue", "addComment", "getComments", "addAttachment", "addWorklog", "linkIssues", "searchIssues"];
+export type JiraOperation = (typeof JIRA_OPERATIONS)[number];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+export declare function isJiraOperation(value: unknown): value is JiraOperation;
+/**
+ * Las operaciones que devuelven un ARRAY y por tanto obligan a marcar
+ * `_meta.iterable` en `getOutputPayload`.
+ *
+ * Vive aquí y no sólo en la api porque olvidarlo no falla al compilar: falla
+ * en producción, callado, con el nodo de abajo recibiendo el sobre entero en
+ * vez de un elemento y el PayloadViewer pintando rutas con corchetes que nadie
+ * puede usar.
+ */
+export declare const JIRA_ITERABLE_OPERATIONS: readonly JiraOperation[];
+export type JiraParamType = 
+/** Selector vivo de proyectos que alcanza la credencial. Guarda la CLAVE
+ *  (`ACME`), no el id: es lo que se lee en las URLs y en el JQL. */
+'jiraProject'
+/** Selector de tipos de incidencia del proyecto elegido. Guarda el id, que
+ *  es lo que pide la API — el nombre no es único entre proyectos. */
+ | 'jiraIssueType'
+/** La incidencia sobre la que se actúa. Se escribe o se resuelve de una
+ *  plantilla: `{{payload.issueKey}}` es el caso del 90%. */
+ | 'jiraIssueKey'
+/** Transiciones legales para la incidencia elegida. Depende del flujo de
+ *  trabajo Y del estado actual, así que se piden en el momento. */
+ | 'jiraTransition'
+/** Usuarios asignables en el proyecto elegido. Guarda el `accountId`. */
+ | 'jiraUser'
+/** Tipos de enlace entre incidencias (`Blocks`, `Relates`…). */
+ | 'jiraLinkType'
+/** 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 (campos personalizados, ADF). */
+ | 'json';
+export interface JiraParamSpec {
+    /** La clave de `operationConfig`. Es lo que lee la api, no un nombre de UI. */
+    name: string;
+    label: string;
+    type: JiraParamType;
+    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 JiraOperationSpec {
+    /** Etiqueta de la fila en el desplegable de operación. */
+    label: string;
+    /** Sub-línea bajo la etiqueta. */
+    description: string;
+    /** Ruta a la que mapea, tal cual, para poder cotejarla con los docs. */
+    apiRoute: string;
+    /** Esquema de parámetros. El orden ES el orden en pantalla. */
+    params: JiraParamSpec[];
+}
+export declare const JIRA_OPERATION_SPECS: Record<JiraOperation, JiraOperationSpec>;
+/**
+ * Lo que se ofrece en el desplegable de operación.
+ *
+ * Hoy son todas. Existe como constante aparte —y no como alias de
+ * `JIRA_OPERATIONS`— porque es el punto donde otros nodos han necesitado
+ * esconder una operación sin sacarla del enum: retirarla del enum rompe las que
+ * ya estaban guardadas en la base de datos.
+ */
+export declare const JIRA_DROPDOWN_OPERATIONS: readonly JiraOperation[];

package/dist/jira-operations.js

@@ -0,0 +1,474 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JIRA_DROPDOWN_OPERATIONS = exports.JIRA_OPERATION_SPECS = exports.JIRA_ITERABLE_OPERATIONS = exports.JIRA_OPERATIONS = void 0;
+exports.isJiraOperation = isJiraOperation;
+/**
+ * Las operaciones del nodo `jiraAction` — la lista que comparten la api, el
+ * dashboard y el broker.
+ *
+ * Mismo patrón que `github-operations.ts` y `shopify-operations.ts`.
+ *
+ * ── Contra qué está escrito ──
+ *
+ * Jira Cloud, **REST API v3**, servida en
+ * `https://api.atlassian.com/ex/jira/{cloudId}/rest/api/3/…`. El `cloudId` sale
+ * de la credencial `oauth2_atlassian`, que ya existe: la montó el trigger de
+ * Jira y aquí se reutiliza entera.
+ *
+ * El permiso que hace falta para escribir es **`write:jira-work`**. Se añadió a
+ * los de por defecto en api#384; toda credencial anterior a eso es de sólo
+ * lectura hasta que su dueño la reconecte, y el síntoma es un 403 al ejecutar,
+ * no un fallo al guardar.
+ *
+ * ── La decisión que ordena todo lo demás: ADF ──
+ *
+ * En la v3, `description` y el `body` de un comentario **no son texto**: son
+ * Atlassian Document Format, un árbol JSON de nodos tipados. Mandar una cadena
+ * da 400.
+ *
+ * La salida fácil sería escribir con la v2, que sí acepta texto plano y sigue
+ * soportada. No se hace, y el motivo está escrito en nuestro propio repositorio
+ * desde antes de este nodo: `jira-watch.service.ts` excluye `description` al
+ * hidratar campos y explica por qué — *"la REST devuelve ADF —un objeto— pero
+ * el webhook manda texto plano; mezclar formas rompería las plantillas de
+ * abajo, que esperan cadenas"*.
+ *
+ * O sea: si este nodo leyera con una versión y escribiera con otra,
+ * `{{payload.fields.description}}` significaría una cosa cuando el flujo lo
+ * dispara un trigger de Jira y otra cuando lo consulta este nodo. Por eso:
+ *
+ *   - **Todo en v3**, para leer y para escribir.
+ *   - Al escribir, el texto del usuario se envuelve en ADF.
+ *   - Al leer, el ADF se aplana a texto, y el árbol original viaja en una clave
+ *     hermana para quien lo necesite.
+ *   - `bodyFormat` deja pegar ADF crudo a quien quiera tablas o paneles.
+ *
+ * ── La otra trampa: la búsqueda cambió de sitio ──
+ *
+ * `GET/POST /rest/api/3/search` está **deprecado**. El sustituto es
+ * `POST /rest/api/3/search/jql`, y no es un renombre: pagina con
+ * `nextPageToken` en vez de `startAt`, **no devuelve `total`** (para contar hay
+ * `/search/approximate-count`) y los campos hay que pedirlos explícitamente.
+ * Casi todo ejemplo que hay por internet usa el endpoint muerto.
+ *
+ * ── Lo que NO es una operación ──
+ *
+ * Listar proyectos, tipos de incidencia, transiciones, estados o usuarios
+ * asignables **no** son operaciones: son endpoints del controlador que alimentan
+ * los selectores, como Drive alimenta su selector de ficheros. Una operación
+ * existe para producir payload en una corrida; esto otro es para rellenar el
+ * formulario. Mezclarlos llena el desplegable de cosas que nadie quiere
+ * ejecutar.
+ *
+ * ── Decisiones propias de Jira ──
+ *
+ *   - El proyecto y el tipo de incidencia se ELIGEN de una lista viva. Un
+ *     `issuetype` se identifica por un id numérico que nadie sabe de memoria.
+ *   - **Las transiciones no son una lista fija.** Dependen del flujo de trabajo
+ *     Y del estado actual de la incidencia, así que el selector las pide para
+ *     esa incidencia concreta. Ofrecer una lista global sería ofrecer
+ *     transiciones que fallan al ejecutarse.
+ *   - Los campos personalizados van en JSON crudo. Cada tipo tiene su forma
+ *     (`select`, `date`, `relation`, usuario…) y fingir que caben en tres
+ *     campos genéricos produce un 400 que no nombra el campo.
+ *   - Ninguna operación declarada sin implementar: el enum ES el contrato de la
+ *     pantalla, y una operación declarada se pinta en el desplegable y falla al
+ *     ejecutarse.
+ */
+exports.JIRA_OPERATIONS = [
+    // Incidencias
+    'createIssue', // POST   /issue
+    'getIssue', // GET    /issue/{key}
+    'updateIssue', // PUT    /issue/{key}
+    'deleteIssue', // DELETE /issue/{key}
+    'assignIssue', // PUT    /issue/{key}/assignee
+    'transitionIssue', // POST   /issue/{key}/transitions
+    // Comentarios
+    'addComment', // POST   /issue/{key}/comment
+    'getComments', // GET    /issue/{key}/comment      → iterable
+    // Adjuntos y trabajo
+    'addAttachment', // POST   /issue/{key}/attachments
+    'addWorklog', // POST   /issue/{key}/worklog
+    // Relaciones
+    'linkIssues', // POST   /issueLink
+    // Transversal
+    'searchIssues', // POST   /search/jql              → iterable
+];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+function isJiraOperation(value) {
+    return (typeof value === 'string' &&
+        exports.JIRA_OPERATIONS.includes(value));
+}
+/**
+ * Las operaciones que devuelven un ARRAY y por tanto obligan a marcar
+ * `_meta.iterable` en `getOutputPayload`.
+ *
+ * Vive aquí y no sólo en la api porque olvidarlo no falla al compilar: falla
+ * en producción, callado, con el nodo de abajo recibiendo el sobre entero en
+ * vez de un elemento y el PayloadViewer pintando rutas con corchetes que nadie
+ * puede usar.
+ */
+exports.JIRA_ITERABLE_OPERATIONS = [
+    'getComments',
+    'searchIssues',
+];
+/* Ayudantes — repetir el mismo objeto doce veces es cómo se desincronizan las
+   descripciones. */
+const project = (required = true) => ({
+    name: 'projectKey',
+    label: 'Project',
+    type: 'jiraProject',
+    required,
+    description: 'De la lista de proyectos que alcanza esta credencial. Se guarda la clave (ACME).',
+});
+const issueKey = (label = 'Issue') => ({
+    name: 'issueKey',
+    label,
+    type: 'jiraIssueKey',
+    required: true,
+    placeholder: '{{payload.issueKey}}',
+    description: 'La clave que se ve en la URL (ACME-42), no el id interno. El trigger de Jira la deja en issueKey.',
+});
+/**
+ * El interruptor de formato para todo campo que Jira quiere en ADF.
+ *
+ * Por defecto `text`: se escribe normal y el nodo lo envuelve. `adf` es la
+ * salida para quien necesita tablas, paneles o menciones — cosas que el texto
+ * plano no sabe expresar y que no vale la pena inventarse un lenguaje para
+ * cubrir.
+ */
+const bodyFormat = () => ({
+    name: 'bodyFormat',
+    label: 'Format',
+    type: 'select',
+    default: 'text',
+    advanced: true,
+    options: [
+        { value: 'text', label: 'Plain text (se convierte a ADF)' },
+        { value: 'adf', label: 'Atlassian Document Format en crudo' },
+    ],
+    description: 'Jira v3 guarda estos campos como ADF. En "plain text" el nodo lo envuelve por ti: un párrafo por bloque y salto de línea donde lo escribas.',
+});
+const customFields = () => ({
+    name: 'customFields',
+    label: 'Other fields (JSON)',
+    type: 'json',
+    advanced: true,
+    placeholder: '{ "customfield_10042": { "accountId": "..." }, "labels": ["urgente"] }',
+    description: 'Se mezcla tal cual dentro de `fields`. Cada tipo de campo de Jira tiene su forma; el esquema real se lee con el selector de campos de la pantalla.',
+});
+const maxResults = () => ({
+    name: 'maxResults',
+    label: 'How many at most',
+    type: 'number',
+    default: 50,
+    min: 1,
+    max: 100,
+    advanced: true,
+    description: 'Jira no devuelve más de 100 por página.',
+});
+exports.JIRA_OPERATION_SPECS = {
+    createIssue: {
+        label: 'Create issue',
+        description: 'Crea una incidencia en un proyecto.',
+        apiRoute: 'POST /rest/api/3/issue',
+        params: [
+            project(),
+            {
+                name: 'issueTypeId',
+                label: 'Issue type',
+                type: 'jiraIssueType',
+                required: true,
+                description: 'Los tipos son del proyecto, no globales: se piden después de elegirlo.',
+            },
+            {
+                name: 'summary',
+                label: 'Summary',
+                type: 'template',
+                required: true,
+                placeholder: 'Fallo al exportar el informe',
+                description: 'El título. Es el único campo que Jira exige siempre.',
+            },
+            {
+                name: 'description',
+                label: 'Description',
+                type: 'textarea',
+                placeholder: 'Lo que pasó, con {{payload.x}} si hace falta.',
+            },
+            bodyFormat(),
+            {
+                name: 'assigneeAccountId',
+                label: 'Assignee',
+                type: 'jiraUser',
+                advanced: true,
+                description: 'Se guarda el accountId, que es como lo pide Jira.',
+            },
+            {
+                name: 'parentKey',
+                label: 'Parent issue',
+                type: 'template',
+                advanced: true,
+                placeholder: 'ACME-10',
+                description: 'Sólo para subtareas: la incidencia padre. Con un tipo que no sea subtarea, Jira lo rechaza.',
+            },
+            customFields(),
+        ],
+    },
+    getIssue: {
+        label: 'Get issue',
+        description: 'Lee una incidencia por su clave.',
+        apiRoute: 'GET /rest/api/3/issue/{issueIdOrKey}',
+        params: [
+            issueKey(),
+            {
+                name: 'fields',
+                label: 'Fields',
+                type: 'template',
+                advanced: true,
+                placeholder: 'summary,status,assignee',
+                description: 'Separados por comas. Vacío trae los de siempre. Pedir sólo lo que usas hace la respuesta mucho más pequeña.',
+            },
+        ],
+    },
+    updateIssue: {
+        label: 'Update issue',
+        description: 'Cambia campos de una incidencia.',
+        apiRoute: 'PUT /rest/api/3/issue/{issueIdOrKey}',
+        params: [
+            issueKey(),
+            {
+                name: 'summary',
+                label: 'Summary',
+                type: 'template',
+                description: 'Vacío = no se toca.',
+            },
+            {
+                name: 'description',
+                label: 'Description',
+                type: 'textarea',
+                description: 'Vacío = no se toca. REEMPLAZA la descripción entera.',
+            },
+            bodyFormat(),
+            customFields(),
+        ],
+    },
+    deleteIssue: {
+        label: 'Delete issue',
+        description: 'Borra una incidencia. No hay papelera.',
+        apiRoute: 'DELETE /rest/api/3/issue/{issueIdOrKey}',
+        params: [
+            issueKey(),
+            {
+                name: 'deleteSubtasks',
+                label: 'Delete its subtasks too',
+                type: 'booleanSelect',
+                options: [
+                    { value: '', label: '— sin tocar —' },
+                    { value: 'true', label: 'Sí, borrar las subtareas' },
+                    { value: 'false', label: 'No' },
+                ],
+                description: 'Con subtareas y sin esto, Jira se niega a borrar y devuelve 400.',
+            },
+        ],
+    },
+    assignIssue: {
+        label: 'Assign issue',
+        description: 'Cambia a quién está asignada.',
+        apiRoute: 'PUT /rest/api/3/issue/{issueIdOrKey}/assignee',
+        params: [
+            issueKey(),
+            {
+                name: 'accountId',
+                label: 'Assignee',
+                type: 'jiraUser',
+                required: true,
+                description: 'Vacío deja la incidencia sin asignar.',
+            },
+        ],
+    },
+    transitionIssue: {
+        label: 'Move issue',
+        description: 'Mueve la incidencia de columna (transición del flujo).',
+        apiRoute: 'POST /rest/api/3/issue/{issueIdOrKey}/transitions',
+        params: [
+            issueKey(),
+            {
+                name: 'transitionId',
+                label: 'Transition',
+                type: 'jiraTransition',
+                required: true,
+                description: 'Las transiciones legales dependen del flujo de trabajo Y del estado actual, así que se piden para esta incidencia. Una que no aplique falla al ejecutarse.',
+            },
+            {
+                name: 'comment',
+                label: 'Comment (optional)',
+                type: 'textarea',
+                advanced: true,
+                description: 'Jira permite comentar en el mismo paso de la transición.',
+            },
+            bodyFormat(),
+        ],
+    },
+    addComment: {
+        label: 'Add comment',
+        description: 'Comenta en una incidencia.',
+        apiRoute: 'POST /rest/api/3/issue/{issueIdOrKey}/comment',
+        params: [
+            issueKey(),
+            {
+                name: 'body',
+                label: 'Comment',
+                type: 'textarea',
+                required: true,
+                placeholder: 'Desplegado en producción: {{payload.version}}',
+            },
+            bodyFormat(),
+        ],
+    },
+    getComments: {
+        label: 'Get comments',
+        description: 'Trae los comentarios de una incidencia.',
+        apiRoute: 'GET /rest/api/3/issue/{issueIdOrKey}/comment',
+        params: [
+            issueKey(),
+            {
+                name: 'orderBy',
+                label: 'Order',
+                type: 'select',
+                default: '-created',
+                advanced: true,
+                options: [
+                    { value: '-created', label: 'Los más nuevos primero' },
+                    { value: 'created', label: 'Los más viejos primero' },
+                ],
+            },
+            maxResults(),
+        ],
+    },
+    addAttachment: {
+        label: 'Attach file',
+        description: 'Sube un fichero a una incidencia.',
+        apiRoute: 'POST /rest/api/3/issue/{issueIdOrKey}/attachments',
+        params: [
+            issueKey(),
+            {
+                name: 'fileField',
+                label: 'File from payload',
+                type: 'template',
+                required: true,
+                placeholder: '{{payload.file}}',
+                description: 'La ruta del payload donde viene el fichero — lo que dejan el nodo de ficheros o un adjunto de Gmail.',
+            },
+            {
+                name: 'fileName',
+                label: 'File name',
+                type: 'template',
+                advanced: true,
+                placeholder: 'informe.pdf',
+                description: 'Vacío usa el nombre que traiga el propio fichero.',
+            },
+        ],
+    },
+    addWorklog: {
+        label: 'Log work',
+        description: 'Apunta tiempo trabajado en una incidencia.',
+        apiRoute: 'POST /rest/api/3/issue/{issueIdOrKey}/worklog',
+        params: [
+            issueKey(),
+            {
+                name: 'timeSpent',
+                label: 'Time spent',
+                type: 'template',
+                required: true,
+                placeholder: '3h 30m',
+                description: 'En el formato de Jira: 2d, 3h, 30m, o combinados. No admite decimales.',
+            },
+            {
+                name: 'comment',
+                label: 'Comment',
+                type: 'textarea',
+                advanced: true,
+            },
+            bodyFormat(),
+            {
+                name: 'started',
+                label: 'When',
+                type: 'template',
+                advanced: true,
+                placeholder: '{{payload.timestamp}}',
+                description: 'Vacío usa el momento de la ejecución.',
+            },
+        ],
+    },
+    linkIssues: {
+        label: 'Link issues',
+        description: 'Relaciona dos incidencias entre sí.',
+        apiRoute: 'POST /rest/api/3/issueLink',
+        params: [
+            {
+                name: 'inwardIssueKey',
+                label: 'From issue',
+                type: 'jiraIssueKey',
+                required: true,
+                placeholder: '{{payload.issueKey}}',
+            },
+            {
+                name: 'linkType',
+                label: 'Relationship',
+                type: 'jiraLinkType',
+                required: true,
+                description: 'Los tipos los define cada sitio: "Blocks", "Relates", "Duplicates"… Se piden a Jira.',
+            },
+            {
+                name: 'outwardIssueKey',
+                label: 'To issue',
+                type: 'jiraIssueKey',
+                required: true,
+                placeholder: 'ACME-99',
+            },
+        ],
+    },
+    searchIssues: {
+        label: 'Search issues (JQL)',
+        description: 'Busca incidencias con JQL. Devuelve una lista iterable.',
+        /* ⚠️ `/search/jql`, NO `/search`. El viejo está deprecado y pagina distinto:
+           `nextPageToken` en vez de `startAt`, y sin `total` en la respuesta. */
+        apiRoute: 'POST /rest/api/3/search/jql',
+        params: [
+            {
+                name: 'jql',
+                label: 'JQL',
+                type: 'textarea',
+                required: true,
+                placeholder: 'project = ACME AND status != Done ORDER BY created DESC',
+                description: 'La misma consulta que escribirías en el buscador de Jira. Admite {{payload.x}}.',
+            },
+            {
+                name: 'fields',
+                label: 'Fields',
+                type: 'template',
+                advanced: true,
+                placeholder: 'summary,status,assignee',
+                description: 'Separados por comas. En este endpoint los campos hay que pedirlos: sin esto sólo llegan las claves.',
+            },
+            maxResults(),
+            {
+                name: 'nextPageToken',
+                label: 'Page token',
+                type: 'template',
+                advanced: true,
+                placeholder: '{{payload.nextPageToken}}',
+                description: 'Para pedir la página siguiente desde un Loop. La salida de esta operación lo devuelve.',
+            },
+        ],
+    },
+};
+/**
+ * Lo que se ofrece en el desplegable de operación.
+ *
+ * Hoy son todas. Existe como constante aparte —y no como alias de
+ * `JIRA_OPERATIONS`— porque es el punto donde otros nodos han necesitado
+ * esconder una operación sin sacarla del enum: retirarla del enum rompe las que
+ * ya estaban guardadas en la base de datos.
+ */
+exports.JIRA_DROPDOWN_OPERATIONS = exports.JIRA_OPERATIONS;

package/dist/registry.js

@@ -301,6 +301,25 @@ exports.NODE_REGISTRY = {
            ningún otro nodo — el MCP oficial de GitHub ya cubre ese caso dentro del
            AI Node. Los rieles son este nodo; la improvisación es el MCP. */
     },
+    jiraAction: {
+        type: 'jiraAction', prefix: 'jr', label: 'Jira',
+        group: 'Actions', detailPath: '/dashboard/jira-actions', apiPath: '/jira-actions',
+        stateKey: 'jiraActions', allStateKey: 'allJiraActions',
+        // El azul de marca de Jira, y estaba libre. La banda azul es la segunda
+        // mas poblada de este registro —nueve nodos— pero ninguno tan profundo:
+        // #3b82f6 y #60a5fa son claramente mas claros, y el #336791 de Postgres es
+        // mas apagado. En el minimapa es el azul oscuro, y eso lo distingue.
+        //
+        // Sigue valiendo lo que escribio GitHub aqui al lado: **la decision se
+        // cierra mirando el minimapa**, no leyendo este comentario.
+        color: '#0052CC', 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 duplicacion no se paga antes de ver el nodo en pantalla. Ademas
+           Atlassian tiene servidor MCP propio, ya registrado en
+           `MCP_OAUTH_PRESETS.atlassian`, que cubre la cola larga dentro del AI
+           Node. Los rieles son este nodo. */
+    },
     telegramAction: {
         type: 'telegramAction', prefix: 'tg', label: 'Telegram Action',
         group: 'Actions', detailPath: '/dashboard/telegram-actions', apiPath: '/telegram-actions',

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' | 'notionAction' | 'vectorStore' | 'rssAction' | 'socialMediaAction' | 'mailchimpAction' | 'shopifyAction' | 'githubAction' | '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' | 'shopifyAction' | 'githubAction' | 'jiraAction' | '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

@@ -78,6 +78,7 @@ exports.NODE_UI = {
     mailchimpAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'mailchimp' } },
     shopifyAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'shopify' } },
     githubAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'github' } },
+    jiraAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'jira' } },
     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 } },
@@ -104,6 +105,7 @@ exports.PREFIX_TO_TYPE = [
     { prefix: 'mc-', type: 'mailchimpAction', canvasType: 'mailchimpAction' },
     { prefix: 'shp-', type: 'shopifyAction', canvasType: 'shopifyAction' },
     { prefix: 'gh-', type: 'githubAction', canvasType: 'githubAction' },
+    { prefix: 'jr-', type: 'jiraAction', canvasType: 'jiraAction' },
     { prefix: 'gc-', type: 'googleContactsAction', canvasType: 'googleContactsAction' },
     { prefix: 'gaa-', type: 'googleAnalyticsAction', canvasType: 'googleAnalyticsAction' },
     { prefix: 'ntn-', type: 'notionAction', canvasType: 'notionAction' },

package/package.json

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