@hostwebhook/node-types 1.73.0 → 1.75.0

package/dist/esm/types.d.ts

@@ -38,7 +38,20 @@ export interface NodeUIConfig {
         hasBranches?: boolean;
         isTerminal?: boolean;
         hasLoopBack?: boolean;
-        connectModal?: 'branch' | 'rule' | 'output-group';
+        /**
+         * Aquí había también un `'rule'`, sólo para el router, y con él vivía en
+         * el lienzo un camino de conexión a medida: su propio modal, su propio
+         * `handleRuleSelect` y su propia puerta en `onConnect`. Dos mecanismos
+         * para lo mismo, y así es como uno se arregla y el otro no: el modal del
+         * router salía al ARRASTRAR y nunca al pulsar el `+`, porque ese segundo
+         * camino pasa por `outputGroups` — que el router no declaraba.
+         *
+         * El router ramifica igual que el conditional, el split y el clasificador,
+         * y su destino vive en el mismo sitio que el de ellos (`port: rule:<id>`),
+         * así que usa la misma maquinaria. Se quita del tipo para que no pueda
+         * volver a declararse sin que el compilador lo diga.
+         */
+        connectModal?: 'branch' | 'output-group';
         routerTargetLabel?: string;
         /**
          * Generic named output groups — used by connectModal: 'output-group'.
@@ -54,6 +67,20 @@ export interface NodeUIConfig {
             nameField?: string;
             /** Field within each group for summary/description (e.g. 'field', 'filterMode') */
             summaryField?: string;
+            /**
+             * Varios campos del grupo, unidos por espacios, cuando el resumen que
+             * de verdad identifica al grupo no cabe en uno solo.
+             *
+             * Existe por las reglas del router: su condición son TRES campos
+             * (`field`, `operator`, `value`) y el modal a medida que se retiró las
+             * pintaba juntas — «status eq active». Con un único `summaryField` una
+             * regla sin `label` quedaba en «rule 1» y «status», que no dice a qué
+             * se está conectando uno.
+             *
+             * Los campos vacíos se saltan, para que una regla con operador
+             * `exists` no salga con un espacio colgando al final.
+             */
+            summaryFields?: string[];
             /** Label shown in the modal (e.g. 'output', 'branch') */
             label: string;
             /** Entity field for the fallback/else path (e.g. 'elseOutputNodes') */
@@ -80,6 +107,29 @@ export interface NodeUIConfig {
                 field: string;
                 value: unknown;
             };
+            /**
+             * Qué es el puerto `main` de este nodo MIENTRAS su contenedor está
+             * vacío. Sin esto, conectar a un nodo que ramifica y todavía no tiene
+             * ninguna salida escribía una arista en `main` **en silencio**, y el
+             * usuario no tenía forma de saber qué había pasado con ella.
+             *
+             * No hay una respuesta única, y por eso es un dato y no una regla.
+             * Medido en `api/src/common/pipeline-run.service.ts`:
+             *
+             *   'passthrough'       — router sin reglas: `rules.length === 0
+             *                         ? refsForPort(entity, MAIN_PORT) : []`. La
+             *                         arista SÍ dispara... hasta que se cree la
+             *                         primera regla, y entonces deja de hacerlo
+             *                         sin avisar.
+             *   'never-dispatched'  — split: no tiene salida `main`, y el propio
+             *                         despachador registra un warning por cada
+             *                         arista que se quedó en ese puerto.
+             *
+             * Se declara sólo donde se ha medido. Sin declarar, el lienzo se
+             * comporta como siempre: conecta por el camino universal y no dice
+             * nada, que es lo que hacía antes de existir este campo.
+             */
+            emptyContainerMain?: 'passthrough' | 'never-dispatched';
         };
         /**
          * Maps output fields to alternate payload fields on the source entity.

package/dist/esm/ui.js

@@ -50,12 +50,30 @@ export const NODE_UI = {
     fileTransform: { fromNodes: true, toNodes: true },
     limit: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },
     // ── Flow control nodes ──
-    split: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { connectModal: 'output-group', outputGroups: { field: 'outputs', nameField: 'name', summaryField: 'field', label: 'output' } } },
+    // `emptyContainerMain: 'never-dispatched'` dice lo que el despachador ya
+    // registra como warning: un split NO tiene salida `main`, así que una arista
+    // que se quede ahí —la que se guardaba al conectar un split sin salidas— no
+    // se despacha nunca. Ver `pipeline-run.service.ts`, el bloque `nodeType ===
+    // 'split'`. El lienzo lo usa para avisar en vez de callarse.
+    split: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { connectModal: 'output-group', outputGroups: { field: 'outputs', nameField: 'name', summaryField: 'field', label: 'output', emptyContainerMain: 'never-dispatched' } } },
     merge: { fromNodes: true, toNodes: true, inputHandles: ['left', 'top'] },
     approval: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { connectModal: 'output-group', outputGroups: { fixedGroups: [{ name: 'Approve', field: 'outputNodes' }, { name: 'Reject', field: 'rejectionOutputNodes' }], label: 'action' } } },
     loop: { fromNodes: true, toNodes: true, inputHandles: ['left'], outputHandles: ['right'], dotHandles: { input: ['left-in'], output: ['right-out-loop', 'right-in-loopback', 'right-out-done'] }, special: { hasLoopBack: true, alternatePayloads: { doneOutputNodes: 'lastDonePayload' } } },
     // ── Routing nodes ──
-    router: { fromNodes: true, toNodes: true, outputHandles: ['right'], dotHandles: { output: ['right-out'] }, special: { connectModal: 'rule' } },
+    // El router ramifica igual que el conditional, el split y el clasificador:
+    // sus salidas son un contenedor (`rules[]`) y el destino de cada una vive en
+    // la arista, en `port: rule:<id>`. Lo único que le faltaba era DECIRLO aquí.
+    //
+    // Mientras no lo decía, tenía en el lienzo un camino propio —`connectModal:
+    // 'rule'`, con su modal, su `handleRuleSelect` y su puerta en `onConnect`— y
+    // eso dejaba el `+` fuera: ese camino no pasa por `onConnect`, pregunta por
+    // `outputGroups`, y el router no tenía. Arrastrando salía el modal; pulsando
+    // el `+` la arista se guardaba en `main` sin preguntar nada.
+    //
+    // `nameField: 'label'` porque el `label` de una regla es opcional; cuando
+    // falta, el modal numera («rule 1») y el `summaryFields` de al lado pone la
+    // condición, que es lo que de verdad la identifica.
+    router: { fromNodes: true, toNodes: true, outputHandles: ['right'], dotHandles: { output: ['right-out'] }, special: { connectModal: 'output-group', outputGroups: { field: 'rules', nameField: 'label', summaryFields: ['field', 'operator', 'value'], label: 'rule', emptyContainerMain: 'passthrough' } } },
     // ── Action nodes ──
     emailAction: { fromNodes: true, toNodes: true, inputHandles: ['left', 'top'], outputHandles: ['right'], dotHandles: { input: ['left-in', 'top-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'email' } },
     gmailAction: { fromNodes: true, toNodes: true, inputHandles: ['left', 'top'], outputHandles: ['right'], dotHandles: { input: ['left-in', 'top-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'gmail' } },

package/dist/index.d.ts

@@ -30,8 +30,8 @@ export { DISCORD_TOOLKIT_SPECS, DISCORD_TOOLKIT_BY_TOOL_NAME, herramientasDeDisc
 export type { DiscordToolkitSpec, DiscordToolkitParameter, } from './discord-toolkit.js';
 export { MAILCHIMP_OPERATIONS, MAILCHIMP_OPERATION_SPECS, MAILCHIMP_CONTACT_STATUSES, isMailchimpOperation, } from './mailchimp-operations.js';
 export type { MailchimpOperation, MailchimpContactStatus, MailchimpParamSpec, MailchimpOperationSpec, } from './mailchimp-operations.js';
-export { SHOPIFY_OPERATIONS, SHOPIFY_OPERATION_SPECS, SHOPIFY_TAGGABLE_RESOURCES, SHOPIFY_SEARCHABLE_RESOURCES, isShopifyOperation, } from './shopify-operations.js';
-export type { ShopifyOperation, ShopifyTaggableResource, ShopifySearchableResource, ShopifyParamSpec, ShopifyOperationSpec, } from './shopify-operations.js';
+export { SHOPIFY_OPERATIONS, SHOPIFY_OPERATION_SPECS, SHOPIFY_OPERATION_SCOPES, SHOPIFY_TAGGABLE_RESOURCES, SHOPIFY_SEARCHABLE_RESOURCES, SHOPIFY_CANCEL_REASONS, SHOPIFY_PRODUCT_STATUSES, isShopifyOperation, scopesQueFaltanEnShopify, } from './shopify-operations.js';
+export type { ShopifyOperation, ShopifyTaggableResource, ShopifySearchableResource, ShopifyCancelReason, ShopifyProductStatus, ShopifyParamSpec, ShopifyOperationSpec, } from './shopify-operations.js';
 export { GITHUB_OPERATIONS, GITHUB_OPERATION_SPECS, GITHUB_DROPDOWN_OPERATIONS, GITHUB_ITERABLE_OPERATIONS, isGithubOperation, } from './github-operations.js';
 export type { GithubOperation, GithubParamType, GithubParamSpec, GithubOperationSpec, } from './github-operations.js';
 export { JIRA_OPERATIONS, JIRA_OPERATION_SPECS, JIRA_DROPDOWN_OPERATIONS, JIRA_ITERABLE_OPERATIONS, isJiraOperation, } from './jira-operations.js';

package/dist/index.js

@@ -1,9 +1,9 @@
 "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.operacionesDeSlackPara = exports.SLACK_CAPACIDADES_POR_CREDENCIAL = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isBucketOperation = exports.BUCKET_ITERABLE_OPERATIONS = exports.BUCKET_OPERATION_SPECS = exports.BUCKET_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.herramientasDeDiscordPara = exports.DISCORD_TOOLKIT_BY_TOOL_NAME = exports.DISCORD_TOOLKIT_SPECS = exports.isDiscordOperation = exports.camposDeDiscordNoDisponibles = exports.discordPuedeEjecutar = exports.operacionesDeDiscordPara = exports.DISCORD_CAPACIDADES_POR_CREDENCIAL = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.camposNoDisponiblesPara = exports.puedeEjecutar = exports.operacionesPara = 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.CREDENTIAL_TYPES = exports.ventanaDeContextoDeOpenRouter = exports.opcionesDeModelosDeOpenRouter = exports.URL_DE_MODELOS_DE_OPENROUTER = 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 = 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.herramientasDeSlackPara = exports.SLACK_TOOLKIT_BY_TOOL_NAME = exports.SLACK_TOOLKIT_SPECS = exports.isSlackOperation = exports.camposDeSlackNoDisponibles = exports.slackPuedeEjecutar = void 0;
-exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = void 0;
+exports.isBucketOperation = exports.BUCKET_ITERABLE_OPERATIONS = exports.BUCKET_OPERATION_SPECS = exports.BUCKET_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.scopesQueFaltanEnShopify = exports.isShopifyOperation = exports.SHOPIFY_PRODUCT_STATUSES = exports.SHOPIFY_CANCEL_REASONS = exports.SHOPIFY_SEARCHABLE_RESOURCES = exports.SHOPIFY_TAGGABLE_RESOURCES = exports.SHOPIFY_OPERATION_SCOPES = exports.SHOPIFY_OPERATION_SPECS = exports.SHOPIFY_OPERATIONS = exports.isMailchimpOperation = exports.MAILCHIMP_CONTACT_STATUSES = exports.MAILCHIMP_OPERATION_SPECS = exports.MAILCHIMP_OPERATIONS = exports.herramientasDeDiscordPara = exports.DISCORD_TOOLKIT_BY_TOOL_NAME = exports.DISCORD_TOOLKIT_SPECS = exports.isDiscordOperation = exports.camposDeDiscordNoDisponibles = exports.discordPuedeEjecutar = exports.operacionesDeDiscordPara = exports.DISCORD_CAPACIDADES_POR_CREDENCIAL = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.camposNoDisponiblesPara = exports.puedeEjecutar = exports.operacionesPara = 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.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 = 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.herramientasDeSlackPara = exports.SLACK_TOOLKIT_BY_TOOL_NAME = exports.SLACK_TOOLKIT_SPECS = exports.isSlackOperation = exports.camposDeSlackNoDisponibles = exports.slackPuedeEjecutar = exports.operacionesDeSlackPara = exports.SLACK_CAPACIDADES_POR_CREDENCIAL = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = void 0;
+exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.ventanaDeContextoDeOpenRouter = exports.opcionesDeModelosDeOpenRouter = exports.URL_DE_MODELOS_DE_OPENROUTER = void 0;
 var types_js_1 = require("./types.js");
 Object.defineProperty(exports, "singleMeta", { enumerable: true, get: function () { return types_js_1.singleMeta; } });
 Object.defineProperty(exports, "iterableMeta", { enumerable: true, get: function () { return types_js_1.iterableMeta; } });
@@ -115,9 +115,13 @@ Object.defineProperty(exports, "isMailchimpOperation", { enumerable: true, get:
 var shopify_operations_js_1 = require("./shopify-operations.js");
 Object.defineProperty(exports, "SHOPIFY_OPERATIONS", { enumerable: true, get: function () { return shopify_operations_js_1.SHOPIFY_OPERATIONS; } });
 Object.defineProperty(exports, "SHOPIFY_OPERATION_SPECS", { enumerable: true, get: function () { return shopify_operations_js_1.SHOPIFY_OPERATION_SPECS; } });
+Object.defineProperty(exports, "SHOPIFY_OPERATION_SCOPES", { enumerable: true, get: function () { return shopify_operations_js_1.SHOPIFY_OPERATION_SCOPES; } });
 Object.defineProperty(exports, "SHOPIFY_TAGGABLE_RESOURCES", { enumerable: true, get: function () { return shopify_operations_js_1.SHOPIFY_TAGGABLE_RESOURCES; } });
 Object.defineProperty(exports, "SHOPIFY_SEARCHABLE_RESOURCES", { enumerable: true, get: function () { return shopify_operations_js_1.SHOPIFY_SEARCHABLE_RESOURCES; } });
+Object.defineProperty(exports, "SHOPIFY_CANCEL_REASONS", { enumerable: true, get: function () { return shopify_operations_js_1.SHOPIFY_CANCEL_REASONS; } });
+Object.defineProperty(exports, "SHOPIFY_PRODUCT_STATUSES", { enumerable: true, get: function () { return shopify_operations_js_1.SHOPIFY_PRODUCT_STATUSES; } });
 Object.defineProperty(exports, "isShopifyOperation", { enumerable: true, get: function () { return shopify_operations_js_1.isShopifyOperation; } });
+Object.defineProperty(exports, "scopesQueFaltanEnShopify", { enumerable: true, get: function () { return shopify_operations_js_1.scopesQueFaltanEnShopify; } });
 var github_operations_js_1 = require("./github-operations.js");
 Object.defineProperty(exports, "GITHUB_OPERATIONS", { enumerable: true, get: function () { return github_operations_js_1.GITHUB_OPERATIONS; } });
 Object.defineProperty(exports, "GITHUB_OPERATION_SPECS", { enumerable: true, get: function () { return github_operations_js_1.GITHUB_OPERATION_SPECS; } });

package/dist/shopify-operations.d.ts

@@ -2,18 +2,24 @@
  * Shopify Admin API operations — single source of truth across the api, the
  * dashboard and downstream consumers (MCP server).
  *
- * ## Four, out of several hundred
+ * ## Ten, out of several hundred
  *
- * The Admin API has hundreds of mutations. This node exposes four, and the
+ * The Admin API has hundreds of mutations. This node exposes ten, 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.
+ * how a node becomes unusable.
  *
- * 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.
+ * The first four cover what people automate on day one — put a customer in the
+ * store, tag something, sync stock, and read back what the store already
+ * knows. The six added on 2026-09-08 cover what they ask for on day two: the
+ * order lifecycle (draft → complete → fulfil → cancel), custom data
+ * (metafields) and putting a product in the catalogue.
+ *
+ * ⚠️ **Every entry below carries the OAuth scope it needs**, in
+ * `SHOPIFY_OPERATION_SCOPES`. That is not documentation: a scope missing from
+ * the credential answers HTTP 403 on a call that looks perfectly formed, and
+ * on Shopify a scope is granted at INSTALL time — adding one to the app means
+ * every existing credential has to be reconnected before it can use the new
+ * operation.
  *
  * ## GraphQL only, and the version is not ours to drift on
  *
@@ -54,8 +60,35 @@
  * `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.
+ *
+ * ## What was verified for the six added on 2026-09-08
+ *
+ * Read off the Admin GraphQL reference for the current version, not recalled.
+ * The pages, and the one fact from each that a from-memory version gets wrong:
+ *
+ * - `draftOrderCreate(input: DraftOrderInput!)` — `lineItems` is the only
+ *   required field of the input, and each item is `{ variantId, quantity }`
+ *   OR `{ title, originalUnitPrice, quantity }` for a custom line.
+ * - `draftOrderComplete(id: ID!, …)` — the id is a **sibling argument**, not
+ *   inside an input. `paymentPending` is deprecated and is not offered here.
+ * - `fulfillmentCreate(fulfillment: FulfillmentInput!)` — takes
+ *   `lineItemsByFulfillmentOrder`, NOT an order id. There is no mutation that
+ *   fulfils "an order": fulfilment hangs off FulfillmentOrder, so the
+ *   executor has to look them up first. That indirection is the whole reason
+ *   ADR-0007 left this out of v1.
+ * - `orderCancel(orderId:, reason:, restock:, …)` — `reason` and `restock` are
+ *   **required arguments**, and the payload's errors arrive in
+ *   `orderCancelUserErrors`; plain `userErrors` is deprecated there.
+ * - `metafieldsSet(metafields: [MetafieldsSetInput!]!)` — takes a LIST, and
+ *   each entry needs all of `ownerId`, `namespace`, `key`, `type`, `value`.
+ *   `type` is not guessable from the value: `single_line_text_field` and
+ *   `number_integer` are different metafields.
+ * - `productCreate(product: ProductCreateInput!)` — the argument is `product`,
+ *   not `input`; `input: ProductInput` is the deprecated spelling. It creates
+ *   ONE default variant; more variants are `productVariantsBulkCreate`, which
+ *   is a surface of its own and is not offered here.
  */
-export declare const SHOPIFY_OPERATIONS: readonly ["upsertCustomer", "setTags", "adjustInventory", "findRecords"];
+export declare const SHOPIFY_OPERATIONS: readonly ["upsertCustomer", "setTags", "adjustInventory", "findRecords", "createDraftOrder", "completeDraftOrder", "fulfillOrder", "cancelOrder", "setMetafield", "createProduct"];
 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;
@@ -72,6 +105,22 @@ 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];
+/**
+ * `OrderCancelReason`, the whole enum, in Shopify's own spelling.
+ *
+ * A dropdown and not free text — and that is the opposite of the call made for
+ * `adjustInventory`'s `reason`, on purpose. The difference is not taste: the
+ * inventory vocabulary was NOT verifiable from the reference (see the note
+ * above), so a dropdown there would have been a list of invented values. This
+ * one IS the enumeration, read off `enums/OrderCancelReason`, and an argument
+ * of type `OrderCancelReason!` rejects anything outside it — so free text here
+ * would only mean the user finds out by failing.
+ */
+export declare const SHOPIFY_CANCEL_REASONS: readonly ["CUSTOMER", "DECLINED", "FRAUD", "INVENTORY", "OTHER", "STAFF"];
+export type ShopifyCancelReason = (typeof SHOPIFY_CANCEL_REASONS)[number];
+/** `ProductStatus`, the whole enum. Same reasoning as the cancel reasons. */
+export declare const SHOPIFY_PRODUCT_STATUSES: readonly ["ACTIVE", "DRAFT", "ARCHIVED"];
+export type ShopifyProductStatus = (typeof SHOPIFY_PRODUCT_STATUSES)[number];
 export interface ShopifyParamSpec {
     /** Field key — also the property name on operationConfig. */
     name: string;
@@ -80,7 +129,7 @@ export interface ShopifyParamSpec {
      *  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';
+    type: 'gid' | 'location' | 'email' | 'string' | 'number' | 'tags' | 'taggableResource' | 'searchableResource' | 'cancelReason' | 'productStatus' | 'json' | 'boolean';
     required?: boolean;
     description: string;
     placeholder?: string;
@@ -93,3 +142,55 @@ export interface ShopifyOperationSpec {
     params: ShopifyParamSpec[];
 }
 export declare const SHOPIFY_OPERATION_SPECS: Record<ShopifyOperation, ShopifyOperationSpec>;
+/**
+ * The OAuth scope each operation needs, so a missing one is named BEFORE the
+ * call instead of arriving as an HTTP 403 on a request that looks fine.
+ *
+ * ## The list is "any one of", not "all of"
+ *
+ * That is `fulfillOrder`'s doing and it is not a generalisation for its own
+ * sake: which fulfilment-order scope applies depends on where the order is
+ * fulfilled from — the merchant's own locations, a third-party service, or the
+ * app itself acting as one. Shopify accepts the mutation if the token carries
+ * ANY of the three. Requiring all three would refuse a store that is correctly
+ * set up.
+ *
+ * ## An empty list means "not checkable from the operation alone"
+ *
+ * `setTags` tags an order, a customer or a product through the same mutation,
+ * and `setMetafield` writes onto whichever resource the owner id points at —
+ * so the scope depends on a FIELD, not on the operation. Guessing would be
+ * worse than not checking: a wrong guess blocks a call Shopify would have
+ * accepted, and a pre-flight check that produces false refusals gets deleted.
+ * Those fall through to Shopify's own 403, which `describeShopifyError`
+ * already explains.
+ *
+ * ⚠️ Read against `shopify.dev/docs/api/usage/access-scopes` and each
+ * mutation's own "Access requirements". Two things follow from that page and
+ * are relied on by `scopesQueFaltanEnShopify`:
+ *
+ *   - **A write scope includes read.** `write_orders` grants `read_orders`, so
+ *     a required `read_x` is satisfied by a granted `write_x`.
+ *   - **Scopes are granted at install.** Adding one to the app does not give
+ *     it to credentials that already exist; those have to be reconnected.
+ */
+export declare const SHOPIFY_OPERATION_SCOPES: Record<ShopifyOperation, readonly string[]>;
+/**
+ * Which of an operation's scopes the credential does NOT have.
+ *
+ * Empty means "nothing to say" — and it says that in three different
+ * situations, all of which have to fail OPEN:
+ *
+ *   1. The operation declares no scope (the resource-dependent ones).
+ *   2. The credential has a scope string and it covers one of the alternatives.
+ *   3. **The credential has no scope string at all.** Shopify returns the
+ *      granted scopes on the token exchange, but a credential stored before
+ *      that was read, or one whose metadata was pruned, has an empty string —
+ *      and refusing to run a node because we cannot see its permissions would
+ *      break working flows to prevent a maybe. Shopify is the authority here;
+ *      this check only saves the round trip when it can prove the answer.
+ *
+ * @param concedidos what Shopify granted, as it sends it: a comma-separated
+ *   string, or the already-split list.
+ */
+export declare function scopesQueFaltanEnShopify(concedidos: string | readonly string[] | null | undefined, requeridos: readonly string[]): string[];