@hostwebhook/node-types 1.62.0 → 1.64.0

package/dist/connections.js

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

@@ -96,6 +96,51 @@ exports.CREDENTIAL_TYPES = [
     // Renombrarlo ahora rompería las credenciales que hayan llegado a existir:
     // el `type` es la clave por la que los nodos las referencian.
     { type: 'mailchimp_oauth2' },
+    // El OAuth de HostWebhook contra Shopify.
+    //
+    // Se anota aquí ANTES de escribir el servicio, precisamente por lo que
+    // cuenta el bloque de Mailchimp de arriba: la api puede tener el flujo
+    // entero y bien, y aun así el `create` de la credencial muere con un enum
+    // de Mongoose que TypeScript no ve. Es el mismo agujero, y ya sabemos que
+    // no avisa al compilar.
+    //
+    // Lleva `_oauth2` por coherencia con `mailchimp_oauth2`, y porque el
+    // `scopeFilter` del dashboard filtra por esta cadena exacta.
+    //
+    // Una nota sobre lo que este tipo GUARDA, que aquí no se ve: el dominio de
+    // la tienda (`{shop}.myshopify.com`) viaja DENTRO del blob cifrado, igual
+    // que el `dc` de Mailchimp. Es parte del host de toda llamada y de la URL
+    // de autorización, así que una credencial de Shopify sin su dominio es
+    // inservible — no un detalle de presentación.
+    { type: 'shopify_oauth2' },
+    // La instalación de la GitHub App de HostWebhook. El camino PRINCIPAL: el
+    // usuario pulsa "Connect GitHub", elige en qué repos entra, y vuelve.
+    //
+    // Lo que guarda es un `installationId` y NINGÚN secreto — la private key es
+    // de la app y vive en el entorno (`GITHUB_APP_PRIVATE_KEY_BASE64`). El token
+    // de instalación es corto y se re-emite firmando con esa llave, así que aquí
+    // no hay nada que caduque en la base de datos.
+    //
+    // Va aparte de `github_pat` por lo mismo que `discord_oauth` va aparte de
+    // `discord_bot`: lo que guardan es distinto.
+    //
+    // ⚠️ No confundir con `GITHUB_OAUTH_CLIENT_ID`/`_SECRET`, que ya existían y
+    // son de una OAuth App DISTINTA — la que usa `MCP_OAUTH_PRESETS.github` para
+    // llegar al servidor MCP de GitHub. Dos registros, dos pares de credenciales,
+    // y conviven a propósito: el MCP es la cola larga dentro del AI Node, esto
+    // son los rieles del nodo.
+    { type: 'github_app' },
+    // Un fine-grained personal access token pegado por el usuario. La salida de
+    // emergencia, detrás de "Use a personal access token instead".
+    //
+    // Aquí SÍ hay un secreto del usuario, y además caduca: GitHub obliga a
+    // ponerles fecha. Un aviso antes de que muera es trabajo pendiente, no de
+    // esta versión.
+    //
+    // Ejecuta exactamente las mismas 14 operaciones que `github_app`. Lo único
+    // que cambia es de dónde sale la lista de repositorios del formulario: los
+    // del usuario, en vez de los que abarca una instalación.
+    { type: 'github_pat' },
 ];
 /**
  * Plain string array — what the Mongoose `enum` field and the

package/dist/dispatch.js

@@ -53,6 +53,8 @@ exports.NODE_DISPATCH = {
     whatsappAction: { service: 'whatsappActionsService', collection: 'whatsappactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     discordAction: { service: 'discordActionsService', collection: 'discordactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     mailchimpAction: { service: 'mailchimpActionsService', collection: 'mailchimpactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    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' },
     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/github-operations.d.ts

@@ -0,0 +1,147 @@
+/**
+ * GitHub operation enum — única fuente de verdad para la api, el dashboard y
+ * el Message Broker. Lo usan:
+ *   - la entidad y el DTO de `githubAction` (api): campo `operation` + validación
+ *   - la página de detalle del dashboard, que pinta el formulario desde los specs
+ *   - specs de toolkit MCP, si algún día el nodo gana modo herramienta
+ *
+ * Mismo patrón que `notion-operations.ts` y `shopify-operations.ts`.
+ *
+ * ── Qué credencial hay debajo ──
+ *
+ * Dos tipos, y la diferencia se nota en UNA cosa que no es una operación:
+ * de dónde sale la lista de repositorios.
+ *
+ *   - `github_app`  — la instalación de la GitHub App. El camino principal.
+ *     Los repos son los que abarca esa instalación.
+ *   - `github_pat`  — un fine-grained token pegado por el usuario. La salida
+ *     de emergencia, detrás de "Use a personal access token instead".
+ *     Los repos son los del usuario.
+ *
+ * Las 14 operaciones de abajo se ejecutan IGUAL con las dos. Lo que cambia es
+ * el listado que rellena el formulario, y eso vive en el controlador, no aquí.
+ *
+ * ── Por qué 14 y no la API entera ──
+ *
+ * Paridad con lo que la gente encadena en un flujo, no con los docs de GitHub.
+ * Abrir un issue, comentarlo, mover un PR, leer o escribir un archivo, disparar
+ * un workflow. Lo demás —releases, gists, administración de la organización,
+ * búsqueda de código— lo cubre el MCP oficial de GitHub dentro del AI Node, que
+ * ya existe y no hay que construir.
+ *
+ * Y la regla que dejó escrita Notion se respeta al pie: **ninguna operación
+ * declarada sin implementar**. El enum ES el contrato de la pantalla — una op
+ * declarada se pinta en el desplegable y luego revienta al ejecutarse. Entran
+ * cuando entre su código.
+ *
+ * ── Lo que NO es un parámetro, a propósito ──
+ *
+ * El `sha`. Actualizar un archivo y crear una rama lo necesitan, y GitHub no
+ * perdona uno equivocado. Pedírselo al usuario es pedirle que se equivoque: lo
+ * resuelve el nodo, desde la ruta del archivo o el nombre de la rama base. Es
+ * el mismo criterio por el que un id de Notion se elige de una lista en vez de
+ * teclearse.
+ *
+ * Tampoco son operaciones listar repos, ramas, etiquetas, asignables o
+ * workflows. Una operación existe para producir payload en una corrida; eso
+ * otro es para rellenar el formulario, y son endpoints del controlador — como
+ * Drive alimenta su `DriveFilePicker`.
+ *
+ * ── Límites de GitHub que condicionan el diseño ──
+ *
+ *   - 5.000 peticiones/hora autenticadas. Suficiente salvo en bucles largos.
+ *   - `searchIssues` NO comparte ese cubo: la API de búsqueda va por su cuenta,
+ *     del orden de 30 por minuto. Por eso está marcada aparte más abajo.
+ *   - Las escrituras tienen además un límite secundario por ráfaga, y GitHub
+ *     responde con `Retry-After`. Se respeta con `common/rate-limiter.ts` y
+ *     `common/retry-transient.ts`, que ya existen. No escribir otro backoff.
+ */
+export declare const GITHUB_OPERATIONS: readonly ["createIssue", "updateIssue", "getIssue", "commentIssue", "listIssues", "createPullRequest", "getPullRequest", "mergePullRequest", "listPullRequests", "getFile", "createOrUpdateFile", "createBranch", "dispatchWorkflow", "searchIssues"];
+export type GithubOperation = (typeof GITHUB_OPERATIONS)[number];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+export declare function isGithubOperation(value: unknown): value is GithubOperation;
+/**
+ * Las operaciones que devuelven un ARRAY y por tanto obligan a marcar
+ * `_meta.iterable` en `getOutputPayload`.
+ *
+ * Está aquí y no sólo en la api porque el error de 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. Que la lista viva en el paquete permite que
+ * el test de la api la recorra en vez de repetirla a mano.
+ */
+export declare const GITHUB_ITERABLE_OPERATIONS: readonly GithubOperation[];
+export type GithubParamType = 
+/** Selector vivo de repositorios que alcanza la credencial. Guarda
+ *  `owner/repo`, que es como lo consumen todas las rutas. */
+'githubRepo'
+/** Selector vivo de ramas del repo elegido. Admite escribir una que aún no
+ *  existe: `createBranch` la crea, y una plantilla puede resolverla. */
+ | 'githubBranch'
+/** Etiquetas del repo elegido, selección múltiple. */
+ | 'githubLabels'
+/** Usuarios asignables en el repo elegido, selección múltiple. */
+ | 'githubAssignees'
+/** Workflows del repo que declaran `workflow_dispatch`. Los demás no se
+ *  pueden disparar, así que no se ofrecen. */
+ | 'githubWorkflow'
+/** 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. */
+ | 'json';
+export interface GithubParamSpec {
+    /** La clave de `operationConfig`. Es lo que lee la api, no un nombre de UI. */
+    name: string;
+    label: string;
+    type: GithubParamType;
+    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 GithubOperationSpec {
+    /** 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: GithubParamSpec[];
+}
+export declare const GITHUB_OPERATION_SPECS: Record<GithubOperation, GithubOperationSpec>;
+/**
+ * Lo que se ofrece en el desplegable de operación.
+ *
+ * Hoy son todas. Existe como constante aparte —y no como alias de
+ * `GITHUB_OPERATIONS`— porque es exactamente el punto donde otros nodos han
+ * necesitado esconder una op sin sacarla del enum: retirarla del enum rompe
+ * las que ya estaban guardadas en la base de datos.
+ */
+export declare const GITHUB_DROPDOWN_OPERATIONS: readonly GithubOperation[];

package/dist/github-operations.js

@@ -0,0 +1,555 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATION_SPECS = exports.GITHUB_ITERABLE_OPERATIONS = exports.GITHUB_OPERATIONS = void 0;
+exports.isGithubOperation = isGithubOperation;
+/**
+ * GitHub operation enum — única fuente de verdad para la api, el dashboard y
+ * el Message Broker. Lo usan:
+ *   - la entidad y el DTO de `githubAction` (api): campo `operation` + validación
+ *   - la página de detalle del dashboard, que pinta el formulario desde los specs
+ *   - specs de toolkit MCP, si algún día el nodo gana modo herramienta
+ *
+ * Mismo patrón que `notion-operations.ts` y `shopify-operations.ts`.
+ *
+ * ── Qué credencial hay debajo ──
+ *
+ * Dos tipos, y la diferencia se nota en UNA cosa que no es una operación:
+ * de dónde sale la lista de repositorios.
+ *
+ *   - `github_app`  — la instalación de la GitHub App. El camino principal.
+ *     Los repos son los que abarca esa instalación.
+ *   - `github_pat`  — un fine-grained token pegado por el usuario. La salida
+ *     de emergencia, detrás de "Use a personal access token instead".
+ *     Los repos son los del usuario.
+ *
+ * Las 14 operaciones de abajo se ejecutan IGUAL con las dos. Lo que cambia es
+ * el listado que rellena el formulario, y eso vive en el controlador, no aquí.
+ *
+ * ── Por qué 14 y no la API entera ──
+ *
+ * Paridad con lo que la gente encadena en un flujo, no con los docs de GitHub.
+ * Abrir un issue, comentarlo, mover un PR, leer o escribir un archivo, disparar
+ * un workflow. Lo demás —releases, gists, administración de la organización,
+ * búsqueda de código— lo cubre el MCP oficial de GitHub dentro del AI Node, que
+ * ya existe y no hay que construir.
+ *
+ * Y la regla que dejó escrita Notion se respeta al pie: **ninguna operación
+ * declarada sin implementar**. El enum ES el contrato de la pantalla — una op
+ * declarada se pinta en el desplegable y luego revienta al ejecutarse. Entran
+ * cuando entre su código.
+ *
+ * ── Lo que NO es un parámetro, a propósito ──
+ *
+ * El `sha`. Actualizar un archivo y crear una rama lo necesitan, y GitHub no
+ * perdona uno equivocado. Pedírselo al usuario es pedirle que se equivoque: lo
+ * resuelve el nodo, desde la ruta del archivo o el nombre de la rama base. Es
+ * el mismo criterio por el que un id de Notion se elige de una lista en vez de
+ * teclearse.
+ *
+ * Tampoco son operaciones listar repos, ramas, etiquetas, asignables o
+ * workflows. Una operación existe para producir payload en una corrida; eso
+ * otro es para rellenar el formulario, y son endpoints del controlador — como
+ * Drive alimenta su `DriveFilePicker`.
+ *
+ * ── Límites de GitHub que condicionan el diseño ──
+ *
+ *   - 5.000 peticiones/hora autenticadas. Suficiente salvo en bucles largos.
+ *   - `searchIssues` NO comparte ese cubo: la API de búsqueda va por su cuenta,
+ *     del orden de 30 por minuto. Por eso está marcada aparte más abajo.
+ *   - Las escrituras tienen además un límite secundario por ráfaga, y GitHub
+ *     responde con `Retry-After`. Se respeta con `common/rate-limiter.ts` y
+ *     `common/retry-transient.ts`, que ya existen. No escribir otro backoff.
+ */
+exports.GITHUB_OPERATIONS = [
+    // Issues
+    'createIssue', // POST   /repos/{o}/{r}/issues
+    'updateIssue', // PATCH  /repos/{o}/{r}/issues/{n}   (cubre cerrar y reabrir)
+    'getIssue', // GET    /repos/{o}/{r}/issues/{n}
+    'commentIssue', // POST   /repos/{o}/{r}/issues/{n}/comments
+    'listIssues', // GET    /repos/{o}/{r}/issues       → iterable
+    // Pull requests
+    'createPullRequest', // POST   /repos/{o}/{r}/pulls
+    'getPullRequest', // GET    /repos/{o}/{r}/pulls/{n}
+    'mergePullRequest', // PUT    /repos/{o}/{r}/pulls/{n}/merge
+    'listPullRequests', // GET    /repos/{o}/{r}/pulls        → iterable
+    // Contenido del repositorio
+    'getFile', // GET    /repos/{o}/{r}/contents/{path}
+    'createOrUpdateFile', // PUT    /repos/{o}/{r}/contents/{path}
+    'createBranch', // POST   /repos/{o}/{r}/git/refs
+    // Automatización
+    'dispatchWorkflow', // POST   /repos/{o}/{r}/actions/workflows/{id}/dispatches
+    // Transversal
+    'searchIssues', // GET    /search/issues              → iterable, cubo propio
+];
+/** Type guard — para validar entrada no fiable (DTOs, tool calls). */
+function isGithubOperation(value) {
+    return (typeof value === 'string' &&
+        exports.GITHUB_OPERATIONS.includes(value));
+}
+/**
+ * Las operaciones que devuelven un ARRAY y por tanto obligan a marcar
+ * `_meta.iterable` en `getOutputPayload`.
+ *
+ * Está aquí y no sólo en la api porque el error de 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. Que la lista viva en el paquete permite que
+ * el test de la api la recorra en vez de repetirla a mano.
+ */
+exports.GITHUB_ITERABLE_OPERATIONS = [
+    'listIssues',
+    'listPullRequests',
+    'searchIssues',
+];
+/* Ayudantes — casi toda operación empieza eligiendo repositorio, y repetir el
+   mismo objeto catorce veces es cómo se desincronizan las descripciones. */
+const repo = () => ({
+    name: 'repo',
+    label: 'Repository',
+    type: 'githubRepo',
+    required: true,
+    description: 'De la lista de repos que alcanza esta credencial. Se guarda como owner/repo.',
+});
+const issueNumber = (label = 'Issue number') => ({
+    name: 'issueNumber',
+    label,
+    type: 'template',
+    required: true,
+    placeholder: '{{payload.issue.number}}',
+    description: 'El número que se ve en la URL del issue, no su id interno.',
+});
+const pullNumber = () => ({
+    name: 'pullNumber',
+    label: 'Pull request number',
+    type: 'template',
+    required: true,
+    placeholder: '{{payload.pull_request.number}}',
+    description: 'El número que se ve en la URL del PR, no su id interno.',
+});
+const perPage = () => ({
+    name: 'perPage',
+    label: 'How many at most',
+    type: 'number',
+    default: 30,
+    min: 1,
+    max: 100,
+    advanced: true,
+    description: 'GitHub no devuelve más de 100 por página.',
+});
+exports.GITHUB_OPERATION_SPECS = {
+    /* ── Issues ────────────────────────────────────────────────────────────── */
+    createIssue: {
+        label: 'Create issue',
+        description: 'Abre un issue nuevo en el repositorio.',
+        apiRoute: 'POST /repos/{owner}/{repo}/issues',
+        params: [
+            repo(),
+            {
+                name: 'title',
+                label: 'Title',
+                type: 'template',
+                required: true,
+                placeholder: 'Error en el pago: {{payload.order.id}}',
+            },
+            {
+                name: 'body',
+                label: 'Body',
+                type: 'textarea',
+                placeholder: 'Lo que llegó:\n\n{{payload.message}}',
+                description: 'Admite Markdown, que es como GitHub lo va a pintar.',
+            },
+            {
+                name: 'labels',
+                label: 'Labels',
+                type: 'githubLabels',
+                description: 'De las que ya existen en el repo.',
+            },
+            {
+                name: 'assignees',
+                label: 'Assignees',
+                type: 'githubAssignees',
+                description: 'Sólo se puede asignar a quien tiene acceso al repo.',
+            },
+        ],
+    },
+    updateIssue: {
+        label: 'Update issue',
+        description: 'Cambia título, cuerpo, estado, etiquetas o asignados.',
+        apiRoute: 'PATCH /repos/{owner}/{repo}/issues/{issue_number}',
+        params: [
+            repo(),
+            issueNumber(),
+            {
+                name: 'title',
+                label: 'New title',
+                type: 'template',
+                description: 'Se deja vacío para no tocarlo.',
+            },
+            {
+                name: 'body',
+                label: 'New body',
+                type: 'textarea',
+                description: 'Se deja vacío para no tocarlo. Reemplaza el cuerpo entero.',
+            },
+            {
+                name: 'state',
+                label: 'State',
+                type: 'select',
+                options: [
+                    { value: '', label: '— sin tocar —' },
+                    { value: 'open', label: 'Open (reabrir)' },
+                    { value: 'closed', label: 'Closed (cerrar)' },
+                ],
+                description: 'Cerrar y reabrir se hacen aquí; no hay operación aparte.',
+            },
+            {
+                name: 'stateReason',
+                label: 'Why closed',
+                type: 'select',
+                showWhen: { field: 'state', in: ['closed'] },
+                options: [
+                    { value: 'completed', label: 'Completed — se resolvió' },
+                    { value: 'not_planned', label: 'Not planned — no se va a hacer' },
+                ],
+                description: 'Es lo que decide qué icono pinta GitHub al cerrarlo.',
+            },
+            {
+                name: 'labels',
+                label: 'Labels',
+                type: 'githubLabels',
+                description: 'Ojo: REEMPLAZA las etiquetas del issue, no las añade. Vacío las deja como están.',
+            },
+            {
+                name: 'assignees',
+                label: 'Assignees',
+                type: 'githubAssignees',
+                description: 'Igual que las etiquetas: reemplaza, no añade.',
+            },
+        ],
+    },
+    getIssue: {
+        label: 'Get issue',
+        description: 'Lee un issue por su número.',
+        apiRoute: 'GET /repos/{owner}/{repo}/issues/{issue_number}',
+        params: [repo(), issueNumber()],
+    },
+    commentIssue: {
+        label: 'Comment on issue',
+        description: 'Añade un comentario a un issue o a un pull request.',
+        apiRoute: 'POST /repos/{owner}/{repo}/issues/{issue_number}/comments',
+        params: [
+            repo(),
+            issueNumber('Issue or PR number'),
+            {
+                name: 'body',
+                label: 'Comment',
+                type: 'textarea',
+                required: true,
+                placeholder: 'Desplegado en producción: {{payload.deployment.url}}',
+                description: 'Vale igual para un PR: en la API de GitHub un pull request ES un issue.',
+            },
+        ],
+    },
+    listIssues: {
+        label: 'List issues',
+        description: 'Los issues del repositorio, filtrables. Devuelve una lista.',
+        apiRoute: 'GET /repos/{owner}/{repo}/issues',
+        params: [
+            repo(),
+            {
+                name: 'state',
+                label: 'State',
+                type: 'select',
+                default: 'open',
+                options: [
+                    { value: 'open', label: 'Open' },
+                    { value: 'closed', label: 'Closed' },
+                    { value: 'all', label: 'Todos' },
+                ],
+            },
+            {
+                name: 'labels',
+                label: 'With these labels',
+                type: 'githubLabels',
+                description: 'Un issue tiene que llevarlas TODAS para salir.',
+            },
+            {
+                name: 'assignee',
+                label: 'Assigned to',
+                type: 'githubAssignees',
+                description: 'Una sola persona. Vacío no filtra.',
+            },
+            perPage(),
+        ],
+    },
+    /* ── Pull requests ─────────────────────────────────────────────────────── */
+    createPullRequest: {
+        label: 'Create pull request',
+        description: 'Abre un PR de una rama contra otra.',
+        apiRoute: 'POST /repos/{owner}/{repo}/pulls',
+        params: [
+            repo(),
+            {
+                name: 'title',
+                label: 'Title',
+                type: 'template',
+                required: true,
+                placeholder: 'Actualiza dependencias — {{payload.date}}',
+            },
+            {
+                name: 'head',
+                label: 'From branch',
+                type: 'githubBranch',
+                required: true,
+                description: 'La rama con los cambios. La que se quiere fusionar.',
+            },
+            {
+                name: 'base',
+                label: 'Into branch',
+                type: 'githubBranch',
+                required: true,
+                description: 'La rama de destino. Normalmente main.',
+            },
+            { name: 'body', label: 'Description', type: 'textarea' },
+            {
+                name: 'draft',
+                label: 'Open as draft',
+                type: 'booleanSelect',
+                options: [
+                    { value: '', label: '— sin tocar —' },
+                    { value: 'true', label: 'Sí, en borrador' },
+                    { value: 'false', label: 'No, listo para revisar' },
+                ],
+                advanced: true,
+            },
+        ],
+    },
+    getPullRequest: {
+        label: 'Get pull request',
+        description: 'Lee un PR por su número, con su estado de fusión.',
+        apiRoute: 'GET /repos/{owner}/{repo}/pulls/{pull_number}',
+        params: [repo(), pullNumber()],
+    },
+    mergePullRequest: {
+        label: 'Merge pull request',
+        description: 'Fusiona un PR abierto.',
+        apiRoute: 'PUT /repos/{owner}/{repo}/pulls/{pull_number}/merge',
+        params: [
+            repo(),
+            pullNumber(),
+            {
+                name: 'mergeMethod',
+                label: 'How',
+                type: 'select',
+                default: 'merge',
+                options: [
+                    { value: 'merge', label: 'Merge commit' },
+                    { value: 'squash', label: 'Squash and merge' },
+                    { value: 'rebase', label: 'Rebase and merge' },
+                ],
+                description: 'El repo puede tener métodos deshabilitados en sus ajustes; si el elegido no está permitido, GitHub responde 405.',
+            },
+            {
+                name: 'commitTitle',
+                label: 'Commit title',
+                type: 'template',
+                advanced: true,
+                description: 'Vacío deja el que GitHub genera solo.',
+            },
+            {
+                name: 'commitMessage',
+                label: 'Commit message',
+                type: 'textarea',
+                advanced: true,
+            },
+        ],
+    },
+    listPullRequests: {
+        label: 'List pull requests',
+        description: 'Los PRs del repositorio, filtrables. Devuelve una lista.',
+        apiRoute: 'GET /repos/{owner}/{repo}/pulls',
+        params: [
+            repo(),
+            {
+                name: 'state',
+                label: 'State',
+                type: 'select',
+                default: 'open',
+                options: [
+                    { value: 'open', label: 'Open' },
+                    { value: 'closed', label: 'Closed' },
+                    { value: 'all', label: 'Todos' },
+                ],
+            },
+            {
+                name: 'base',
+                label: 'Into branch',
+                type: 'githubBranch',
+                description: 'Sólo los que apuntan a esta rama. Vacío no filtra.',
+            },
+            perPage(),
+        ],
+    },
+    /* ── Contenido del repositorio ─────────────────────────────────────────── */
+    getFile: {
+        label: 'Get file',
+        description: 'Lee un archivo del repositorio, ya decodificado.',
+        apiRoute: 'GET /repos/{owner}/{repo}/contents/{path}',
+        params: [
+            repo(),
+            {
+                name: 'path',
+                label: 'Path',
+                type: 'template',
+                required: true,
+                placeholder: 'package.json',
+                description: 'Ruta desde la raíz del repo, sin barra inicial.',
+            },
+            {
+                name: 'ref',
+                label: 'Branch',
+                type: 'githubBranch',
+                description: 'Vacío usa la rama por defecto del repo.',
+            },
+        ],
+    },
+    createOrUpdateFile: {
+        label: 'Create or update file',
+        description: 'Escribe un archivo y commitea el cambio.',
+        apiRoute: 'PUT /repos/{owner}/{repo}/contents/{path}',
+        params: [
+            repo(),
+            {
+                name: 'path',
+                label: 'Path',
+                type: 'template',
+                required: true,
+                placeholder: 'data/report.md',
+                description: 'Si el archivo ya existe se actualiza; si no, se crea. El sha lo resuelve el nodo — no hace falta dárselo.',
+            },
+            {
+                name: 'content',
+                label: 'Content',
+                type: 'textarea',
+                required: true,
+                description: 'Texto plano. El nodo lo codifica antes de mandarlo.',
+            },
+            {
+                name: 'commitMessage',
+                label: 'Commit message',
+                type: 'template',
+                required: true,
+                placeholder: 'Actualiza el informe de {{payload.date}}',
+            },
+            {
+                name: 'branch',
+                label: 'Branch',
+                type: 'githubBranch',
+                description: 'Vacío commitea en la rama por defecto del repo.',
+            },
+        ],
+    },
+    createBranch: {
+        label: 'Create branch',
+        description: 'Crea una rama a partir de otra.',
+        apiRoute: 'POST /repos/{owner}/{repo}/git/refs',
+        params: [
+            repo(),
+            {
+                name: 'newBranch',
+                label: 'New branch name',
+                type: 'template',
+                required: true,
+                placeholder: 'fix/{{payload.issue.number}}',
+                description: 'Sin el prefijo refs/heads/ — lo pone el nodo.',
+            },
+            {
+                name: 'fromBranch',
+                label: 'From branch',
+                type: 'githubBranch',
+                required: true,
+                description: 'De dónde parte. El sha de su punta lo resuelve el nodo desde este nombre.',
+            },
+        ],
+    },
+    /* ── Automatización ────────────────────────────────────────────────────── */
+    dispatchWorkflow: {
+        label: 'Run workflow',
+        description: 'Dispara un workflow de GitHub Actions.',
+        apiRoute: 'POST /repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches',
+        params: [
+            repo(),
+            {
+                name: 'workflow',
+                label: 'Workflow',
+                type: 'githubWorkflow',
+                required: true,
+                description: 'Sólo salen los que declaran workflow_dispatch: el resto no se puede disparar desde fuera.',
+            },
+            {
+                name: 'ref',
+                label: 'Branch or tag',
+                type: 'githubBranch',
+                required: true,
+                description: 'Desde dónde se corre el workflow.',
+            },
+            {
+                name: 'inputs',
+                label: 'Inputs',
+                type: 'json',
+                advanced: true,
+                placeholder: '{ "environment": "production" }',
+                description: 'Los inputs que declara el workflow. Objeto plano: GitHub sólo acepta cadenas como valores.',
+            },
+        ],
+    },
+    /* ── Transversal ───────────────────────────────────────────────────────── */
+    searchIssues: {
+        label: 'Search issues and PRs',
+        description: 'Busca en todo GitHub con su sintaxis de búsqueda. Devuelve una lista.',
+        apiRoute: 'GET /search/issues',
+        params: [
+            {
+                name: 'query',
+                label: 'Query',
+                type: 'template',
+                required: true,
+                placeholder: 'repo:hostwebhook/dashboard is:open label:bug',
+                description: 'La misma sintaxis de la barra de búsqueda de GitHub. Sin repo: busca en todo lo que alcance la credencial.',
+            },
+            {
+                name: 'sort',
+                label: 'Sort by',
+                type: 'select',
+                options: [
+                    { value: '', label: 'Relevancia' },
+                    { value: 'created', label: 'Fecha de creación' },
+                    { value: 'updated', label: 'Última actualización' },
+                    { value: 'comments', label: 'Número de comentarios' },
+                ],
+                advanced: true,
+            },
+            {
+                name: 'order',
+                label: 'Order',
+                type: 'select',
+                default: 'desc',
+                options: [
+                    { value: 'desc', label: 'Descendente' },
+                    { value: 'asc', label: 'Ascendente' },
+                ],
+                advanced: true,
+            },
+            perPage(),
+        ],
+    },
+};
+/**
+ * Lo que se ofrece en el desplegable de operación.
+ *
+ * Hoy son todas. Existe como constante aparte —y no como alias de
+ * `GITHUB_OPERATIONS`— porque es exactamente el punto donde otros nodos han
+ * necesitado esconder una op sin sacarla del enum: retirarla del enum rompe
+ * las que ya estaban guardadas en la base de datos.
+ */
+exports.GITHUB_DROPDOWN_OPERATIONS = exports.GITHUB_OPERATIONS;

package/dist/index.d.ts

@@ -26,6 +26,10 @@ export { DISCORD_OPERATIONS, DISCORD_OPERATION_SPECS, isDiscordOperation, } from
 export type { DiscordOperation, DiscordParamSpec, DiscordOperationSpec, } from './discord-operations';
 export { MAILCHIMP_OPERATIONS, MAILCHIMP_OPERATION_SPECS, MAILCHIMP_CONTACT_STATUSES, isMailchimpOperation, } from './mailchimp-operations';
 export type { MailchimpOperation, MailchimpContactStatus, MailchimpParamSpec, MailchimpOperationSpec, } from './mailchimp-operations';
+export { SHOPIFY_OPERATIONS, SHOPIFY_OPERATION_SPECS, SHOPIFY_TAGGABLE_RESOURCES, SHOPIFY_SEARCHABLE_RESOURCES, isShopifyOperation, } from './shopify-operations';
+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 { 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.DOCS_OPERATION_SPECS = exports.DOCS_OPERATIONS = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isNotionOperation = exports.NOTION_DROPDOWN_OPERATIONS = exports.NOTION_OPERATION_SPECS = exports.NOTION_OPERATIONS = exports.isGoogleAnalyticsOperation = exports.GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS = exports.GOOGLE_ANALYTICS_OPERATION_SPECS = exports.GOOGLE_ANALYTICS_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isMailchimpOperation = exports.MAILCHIMP_CONTACT_STATUSES = exports.MAILCHIMP_OPERATION_SPECS = exports.MAILCHIMP_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = void 0;
-exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.getModelLabel = exports.getDefaultModel = exports.getModelsFor = exports.MODEL_CONTEXT_WINDOWS = exports.LLM_MODELS = exports.LLM_PROVIDERS = exports.DOCS_TOOLKIT_DEFAULTABLE = exports.DOCS_TOOLKIT_BY_TOOL_NAME = exports.DOCS_TOOLKIT_SPECS = exports.isDocsOperation = void 0;
+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;
 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; } });
@@ -92,6 +92,18 @@ Object.defineProperty(exports, "MAILCHIMP_OPERATIONS", { enumerable: true, get:
 Object.defineProperty(exports, "MAILCHIMP_OPERATION_SPECS", { enumerable: true, get: function () { return mailchimp_operations_1.MAILCHIMP_OPERATION_SPECS; } });
 Object.defineProperty(exports, "MAILCHIMP_CONTACT_STATUSES", { enumerable: true, get: function () { return mailchimp_operations_1.MAILCHIMP_CONTACT_STATUSES; } });
 Object.defineProperty(exports, "isMailchimpOperation", { enumerable: true, get: function () { return mailchimp_operations_1.isMailchimpOperation; } });
+var shopify_operations_1 = require("./shopify-operations");
+Object.defineProperty(exports, "SHOPIFY_OPERATIONS", { enumerable: true, get: function () { return shopify_operations_1.SHOPIFY_OPERATIONS; } });
+Object.defineProperty(exports, "SHOPIFY_OPERATION_SPECS", { enumerable: true, get: function () { return shopify_operations_1.SHOPIFY_OPERATION_SPECS; } });
+Object.defineProperty(exports, "SHOPIFY_TAGGABLE_RESOURCES", { enumerable: true, get: function () { return shopify_operations_1.SHOPIFY_TAGGABLE_RESOURCES; } });
+Object.defineProperty(exports, "SHOPIFY_SEARCHABLE_RESOURCES", { enumerable: true, get: function () { return shopify_operations_1.SHOPIFY_SEARCHABLE_RESOURCES; } });
+Object.defineProperty(exports, "isShopifyOperation", { enumerable: true, get: function () { return shopify_operations_1.isShopifyOperation; } });
+var github_operations_1 = require("./github-operations");
+Object.defineProperty(exports, "GITHUB_OPERATIONS", { enumerable: true, get: function () { return github_operations_1.GITHUB_OPERATIONS; } });
+Object.defineProperty(exports, "GITHUB_OPERATION_SPECS", { enumerable: true, get: function () { return github_operations_1.GITHUB_OPERATION_SPECS; } });
+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 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/registry.js

@@ -273,6 +273,34 @@ exports.NODE_REGISTRY = {
         // light canvas. The brand value (#ffe01b) reads as a highlighter there.
         color: '#c9a227', testable: true,
     },
+    shopifyAction: {
+        type: 'shopifyAction', prefix: 'shp', label: 'Shopify',
+        group: 'Actions', detailPath: '/dashboard/shopify-actions', apiPath: '/shopify-actions',
+        stateKey: 'shopifyActions', allStateKey: 'allShopifyActions',
+        // Shopify's green, abierto un punto. El de marca (#008060) es más oscuro
+        // que cualquier otro color de este registro y se hunde contra el lienzo
+        // en modo oscuro; éste sigue leyéndose como Shopify y aguanta en los dos
+        // temas. Mismo criterio que el amarillo de Mailchimp, al revés.
+        color: '#0a9e70', testable: true,
+    },
+    githubAction: {
+        type: 'githubAction', prefix: 'gh', label: 'GitHub',
+        group: 'Actions', detailPath: '/dashboard/github-actions', apiPath: '/github-actions',
+        stateKey: 'githubActions', allStateKey: 'allGithubActions',
+        // El morado de "merged" de GitHub. Su marca real es acromática, y ahí no
+        // hay elección posible: en el minimapa lo único que distingue a un nodo es
+        // el color, el gris cálido ya lo ocupa Notion y el frío lo llevan tres.
+        //
+        // ⚠️ Es la banda MÁS disputada de este registro — ocho nodos en morado,
+        // con #7c3aed y #a855f7 como vecinos inmediatos. Se eligió por ser el
+        // color que de verdad dice GitHub, pero **la decisión se cierra mirando el
+        // minimapa**, no leyendo este comentario. Si choca, el plan B es un
+        // grafito claro, sabiendo que compite con Notion.
+        color: '#8957e5', testable: true,
+        /* Sin isToolOnly: la v1 no trae modo toolkit de IA, y aquí pesa más que en
+           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. */
+    },
     telegramAction: {
         type: 'telegramAction', prefix: 'tg', label: 'Telegram Action',
         group: 'Actions', detailPath: '/dashboard/telegram-actions', apiPath: '/telegram-actions',

package/dist/shopify-operations.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Shopify Admin API operations — single source of truth across the api, the
+ * dashboard and downstream consumers (MCP server).
+ *
+ * ## Four, out of several hundred
+ *
+ * The Admin API has hundreds of mutations. This node exposes four, and the
+ * choice is argued in `api/docs/ADR-0007-shopify.md`: a menu of everything is
+ * how a node becomes unusable, and these four cover what people actually
+ * automate — put a customer in the store, tag something, sync stock, and read
+ * back what the store already knows.
+ *
+ * Product creation and order fulfilment were considered and left out of v1.
+ * A product means variants, media and prices; a fulfilment means a location, a
+ * fulfilment service and a state machine. Each is a configuration surface of
+ * its own, not a field.
+ *
+ * ## GraphQL only, and the version is not ours to drift on
+ *
+ * REST went legacy in October 2024 and public apps have been GraphQL-only
+ * since April 2025, so there is no REST path here to fall back to. Every
+ * `apiRoute` below is a GraphQL mutation or query name, checkable against
+ * `shopify.dev/docs/api/admin-graphql`. The API version lives in ONE constant
+ * on the api side (`SHOPIFY_API_VERSION`) — never interpolated per call site.
+ *
+ * ## What was verified, and what was not (2026-08-25)
+ *
+ * Checked against the Admin GraphQL reference, not from memory:
+ *
+ * - `tagsAdd(id: ID!, tags: [String!]!)` and `tagsRemove` with the same
+ *   shape. Both accept Order, DraftOrder, Customer, Product, Article and
+ *   DiscountNode.
+ * - `customerCreate(input: CustomerInput!)` and `customerUpdate(input:
+ *   CustomerInput!)` — for the update, **the id goes inside the input**, not
+ *   as a sibling argument.
+ * - `inventoryAdjustQuantities(input: InventoryAdjustQuantitiesInput!)`, whose
+ *   input requires `reason`, `name` and a `changes[]` of
+ *   `{ delta, inventoryItemId, locationId }`.
+ *
+ * ⚠️ **NOT verified, and deliberately left loose below** — do not turn either
+ * into a hard-coded dropdown until someone reads the enumeration:
+ *
+ * - The full vocabulary of `reason`. Only `"correction"` is documented by
+ *   example.
+ * - The full vocabulary of `name`. Only `"available"` is documented by
+ *   example; the docs mention `on_hand` moving as a consequence, which is not
+ *   the same as it being a valid input.
+ * - The exact search syntax for finding a customer by email
+ *   (`customers(query: "email:…")`). It is the obvious shape and almost
+ *   certainly right, which is exactly why it is worth confirming rather than
+ *   assuming.
+ *
+ * ⚠️ **`@idempotent` is mandatory.** As of API version 2026-04,
+ * `inventoryAdjustQuantities` must be sent with the `@idempotent` directive
+ * and an idempotency key. A stock adjustment is the one operation here where a
+ * silent retry is a real inventory error, so this is not boilerplate.
+ */
+export declare const SHOPIFY_OPERATIONS: readonly ["upsertCustomer", "setTags", "adjustInventory", "findRecords"];
+export type ShopifyOperation = (typeof SHOPIFY_OPERATIONS)[number];
+/** Type guard — for DTOs and AI tool calls, where the input is untrusted. */
+export declare function isShopifyOperation(value: unknown): value is ShopifyOperation;
+/**
+ * The resources `tagsAdd` / `tagsRemove` accept. Taken from the mutation
+ * reference — this list is the API's, not a subset we chose.
+ *
+ * `article` and `discountNode` are left out of the node's own picker on
+ * purpose: neither is something a HostWebhook flow tags in practice, and every
+ * extra option is a field the user has to read past.
+ */
+export declare const SHOPIFY_TAGGABLE_RESOURCES: readonly ["order", "customer", "product", "draftOrder"];
+export type ShopifyTaggableResource = (typeof SHOPIFY_TAGGABLE_RESOURCES)[number];
+/** What `findRecords` can read back. */
+export declare const SHOPIFY_SEARCHABLE_RESOURCES: readonly ["orders", "customers", "products"];
+export type ShopifySearchableResource = (typeof SHOPIFY_SEARCHABLE_RESOURCES)[number];
+export interface ShopifyParamSpec {
+    /** Field key — also the property name on operationConfig. */
+    name: string;
+    label: string;
+    /** Param type, so the dashboard renders the right control. `location` is a
+     *  picker backed by a live lookup of the store's locations; `gid` is a
+     *  Shopify global id, which is almost always templated from the payload
+     *  rather than typed. */
+    type: 'gid' | 'location' | 'email' | 'string' | 'number' | 'tags' | 'taggableResource' | 'searchableResource' | 'json' | 'boolean';
+    required?: boolean;
+    description: string;
+    placeholder?: string;
+}
+export interface ShopifyOperationSpec {
+    label: string;
+    description: string;
+    /** The GraphQL operation this maps to, so the mapping is checkable. */
+    apiRoute: string;
+    params: ShopifyParamSpec[];
+}
+export declare const SHOPIFY_OPERATION_SPECS: Record<ShopifyOperation, ShopifyOperationSpec>;

package/dist/shopify-operations.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * Shopify Admin API operations — single source of truth across the api, the
+ * dashboard and downstream consumers (MCP server).
+ *
+ * ## Four, out of several hundred
+ *
+ * The Admin API has hundreds of mutations. This node exposes four, and the
+ * choice is argued in `api/docs/ADR-0007-shopify.md`: a menu of everything is
+ * how a node becomes unusable, and these four cover what people actually
+ * automate — put a customer in the store, tag something, sync stock, and read
+ * back what the store already knows.
+ *
+ * Product creation and order fulfilment were considered and left out of v1.
+ * A product means variants, media and prices; a fulfilment means a location, a
+ * fulfilment service and a state machine. Each is a configuration surface of
+ * its own, not a field.
+ *
+ * ## GraphQL only, and the version is not ours to drift on
+ *
+ * REST went legacy in October 2024 and public apps have been GraphQL-only
+ * since April 2025, so there is no REST path here to fall back to. Every
+ * `apiRoute` below is a GraphQL mutation or query name, checkable against
+ * `shopify.dev/docs/api/admin-graphql`. The API version lives in ONE constant
+ * on the api side (`SHOPIFY_API_VERSION`) — never interpolated per call site.
+ *
+ * ## What was verified, and what was not (2026-08-25)
+ *
+ * Checked against the Admin GraphQL reference, not from memory:
+ *
+ * - `tagsAdd(id: ID!, tags: [String!]!)` and `tagsRemove` with the same
+ *   shape. Both accept Order, DraftOrder, Customer, Product, Article and
+ *   DiscountNode.
+ * - `customerCreate(input: CustomerInput!)` and `customerUpdate(input:
+ *   CustomerInput!)` — for the update, **the id goes inside the input**, not
+ *   as a sibling argument.
+ * - `inventoryAdjustQuantities(input: InventoryAdjustQuantitiesInput!)`, whose
+ *   input requires `reason`, `name` and a `changes[]` of
+ *   `{ delta, inventoryItemId, locationId }`.
+ *
+ * ⚠️ **NOT verified, and deliberately left loose below** — do not turn either
+ * into a hard-coded dropdown until someone reads the enumeration:
+ *
+ * - The full vocabulary of `reason`. Only `"correction"` is documented by
+ *   example.
+ * - The full vocabulary of `name`. Only `"available"` is documented by
+ *   example; the docs mention `on_hand` moving as a consequence, which is not
+ *   the same as it being a valid input.
+ * - The exact search syntax for finding a customer by email
+ *   (`customers(query: "email:…")`). It is the obvious shape and almost
+ *   certainly right, which is exactly why it is worth confirming rather than
+ *   assuming.
+ *
+ * ⚠️ **`@idempotent` is mandatory.** As of API version 2026-04,
+ * `inventoryAdjustQuantities` must be sent with the `@idempotent` directive
+ * and an idempotency key. A stock adjustment is the one operation here where a
+ * silent retry is a real inventory error, so this is not boilerplate.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SHOPIFY_OPERATION_SPECS = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATIONS = void 0;
+exports.isShopifyOperation = isShopifyOperation;
+exports.SHOPIFY_OPERATIONS = [
+    'upsertCustomer',
+    'setTags',
+    'adjustInventory',
+    'findRecords',
+];
+/** Type guard — for DTOs and AI tool calls, where the input is untrusted. */
+function isShopifyOperation(value) {
+    return (typeof value === 'string' &&
+        exports.SHOPIFY_OPERATIONS.includes(value));
+}
+/**
+ * The resources `tagsAdd` / `tagsRemove` accept. Taken from the mutation
+ * reference — this list is the API's, not a subset we chose.
+ *
+ * `article` and `discountNode` are left out of the node's own picker on
+ * purpose: neither is something a HostWebhook flow tags in practice, and every
+ * extra option is a field the user has to read past.
+ */
+exports.SHOPIFY_TAGGABLE_RESOURCES = [
+    'order',
+    'customer',
+    'product',
+    'draftOrder',
+];
+/** What `findRecords` can read back. */
+exports.SHOPIFY_SEARCHABLE_RESOURCES = [
+    'orders',
+    'customers',
+    'products',
+];
+exports.SHOPIFY_OPERATION_SPECS = {
+    upsertCustomer: {
+        label: 'Add or update customer',
+        description: 'Look the customer up by email, then create them or update the fields you set.',
+        apiRoute: 'mutation customerCreate / customerUpdate (lookup by email first)',
+        params: [
+            {
+                name: 'email',
+                label: 'Email address',
+                type: 'email',
+                required: true,
+                description: 'Identifies the customer. This is what decides between creating and updating — there is no separate "id" to keep.',
+                placeholder: '{{payload.email}}',
+            },
+            {
+                name: 'firstName',
+                label: 'First name',
+                type: 'string',
+                description: 'Left untouched on an existing customer if you leave it empty.',
+                placeholder: '{{payload.firstName}}',
+            },
+            {
+                name: 'lastName',
+                label: 'Last name',
+                type: 'string',
+                description: 'Left untouched on an existing customer if you leave it empty.',
+                placeholder: '{{payload.lastName}}',
+            },
+            {
+                name: 'phone',
+                label: 'Phone',
+                type: 'string',
+                description: 'Shopify wants it in E.164 (+52…). A malformed number fails the whole mutation, not just the field.',
+            },
+            {
+                name: 'tags',
+                label: 'Tags',
+                type: 'tags',
+                description: 'Tags to set on the customer. Note these REPLACE the customer tags — to add without losing the existing ones, use the tag operation instead.',
+            },
+            {
+                name: 'note',
+                label: 'Note',
+                type: 'string',
+                description: 'Internal note, visible to staff in the Shopify admin.',
+            },
+            {
+                name: 'emailMarketingConsent',
+                label: 'Email marketing consent',
+                type: 'json',
+                description: 'Leave this EMPTY unless the customer actually consented. Omitting it leaves their consent exactly as it was; writing a subscribed state for someone who never opted in is a legal problem, not a technical one. Shape: {"marketingState":"SUBSCRIBED","marketingOptInLevel":"SINGLE_OPT_IN"}.',
+            },
+        ],
+    },
+    setTags: {
+        label: 'Add or remove tags',
+        description: 'Tag an order, a customer or a product. Adding and removing are separate calls, so one node does one of the two.',
+        apiRoute: 'mutation tagsAdd / tagsRemove',
+        params: [
+            {
+                name: 'resource',
+                label: 'What to tag',
+                type: 'taggableResource',
+                required: true,
+                description: 'Shopify tags many resource types through the same mutation; this only picks which id you are passing.',
+            },
+            {
+                name: 'resourceId',
+                label: 'Resource id',
+                type: 'gid',
+                required: true,
+                description: 'The Shopify global id, e.g. gid://shopify/Order/1234. A Shopify trigger gives you this directly in the payload.',
+                placeholder: '{{payload.admin_graphql_api_id}}',
+            },
+            {
+                name: 'tags',
+                label: 'Tags',
+                type: 'tags',
+                required: true,
+                description: 'One or more tags.',
+            },
+            {
+                name: 'remove',
+                label: 'Remove instead of add',
+                type: 'boolean',
+                description: 'Off adds the tags (tagsAdd); on removes them (tagsRemove). Unlike Mailchimp, Shopify cannot do both in one call.',
+            },
+        ],
+    },
+    adjustInventory: {
+        label: 'Adjust inventory',
+        description: 'Move stock by a delta at one location. For the case where the real stock lives in another system.',
+        apiRoute: 'mutation inventoryAdjustQuantities',
+        params: [
+            {
+                name: 'inventoryItemId',
+                label: 'Inventory item id',
+                type: 'gid',
+                required: true,
+                description: 'gid://shopify/InventoryItem/1234. This is the inventory item, NOT the product or the variant — a variant points at one.',
+                placeholder: '{{payload.inventory_item_id}}',
+            },
+            {
+                name: 'locationId',
+                label: 'Location',
+                type: 'location',
+                required: true,
+                description: 'Which location the stock moves at. A store with one location still has to name it.',
+            },
+            {
+                name: 'delta',
+                label: 'Change by',
+                type: 'number',
+                required: true,
+                description: 'A DELTA, not a total. 5 adds five units and -5 removes five. Sending the absolute stock level here is the mistake that silently multiplies inventory.',
+                placeholder: '{{payload.delta}}',
+            },
+            {
+                name: 'name',
+                label: 'Quantity type',
+                type: 'string',
+                required: true,
+                description: 'Which quantity is being changed. "available" is the documented value; check the reference before using another.',
+                placeholder: 'available',
+            },
+            {
+                name: 'reason',
+                label: 'Reason',
+                type: 'string',
+                required: true,
+                description: 'Why the stock moved — it lands in the store\'s inventory history. "correction" is the documented value; check the reference before using another.',
+                placeholder: 'correction',
+            },
+            {
+                name: 'referenceDocumentUri',
+                label: 'Reference',
+                type: 'string',
+                description: 'Optional audit-trail link back to whatever caused the change, so someone reading Shopify\'s inventory history can find it.',
+            },
+        ],
+    },
+    findRecords: {
+        label: 'Find orders, customers or products',
+        description: 'Read back what the store knows, to enrich a payload that came from somewhere else.',
+        apiRoute: 'query orders / customers / products (with search syntax)',
+        params: [
+            {
+                name: 'resource',
+                label: 'What to look for',
+                type: 'searchableResource',
+                required: true,
+                description: 'Which collection to search.',
+            },
+            {
+                name: 'query',
+                label: 'Search',
+                type: 'string',
+                required: true,
+                description: 'Shopify search syntax, e.g. email:someone@example.com or financial_status:paid. Empty would return the newest records, which is rarely what anyone means.',
+                placeholder: 'email:{{payload.email}}',
+            },
+            {
+                name: 'first',
+                label: 'How many',
+                type: 'number',
+                description: 'Defaults to 1, which is the enrichment case. Asking for many costs more against the query-cost budget, not more calls.',
+                placeholder: '1',
+            },
+        ],
+    },
+};

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

@@ -76,6 +76,8 @@ exports.NODE_UI = {
     whatsappAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'whatsapp' } },
     discordAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'discord' } },
     mailchimpAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'mailchimp' } },
+    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' } },
     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 } },
@@ -100,6 +102,8 @@ exports.PREFIX_TO_TYPE = [
     { prefix: 'dc-', type: 'discordAction', canvasType: 'discordAction' },
     { prefix: 'sl-', type: 'slackAction', canvasType: 'slackAction' },
     { prefix: 'mc-', type: 'mailchimpAction', canvasType: 'mailchimpAction' },
+    { prefix: 'shp-', type: 'shopifyAction', canvasType: 'shopifyAction' },
+    { prefix: 'gh-', type: 'githubAction', canvasType: 'githubAction' },
     { 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.62.0",
+  "version": "1.64.0",
   "description": "Shared node type definitions, connection rules, and dispatch config for HostWebhook",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",