@hostwebhook/node-types 1.69.0 → 1.71.0

package/dist/bucket-operations.d.ts

@@ -0,0 +1,88 @@
+/**
+ * El nodo de bucket: guardar, firmar y borrar objetos en un almacenamiento
+ * compatible con S3.
+ *
+ * ## Por qué se llama `bucket` y no `r2`
+ *
+ * Porque el proveedor es un ENDPOINT, no un tipo de nodo. La credencial
+ * `aws_s3` ya guarda `endpoint`, `bucket` y `region`, así que el mismo nodo
+ * habla con Cloudflare R2, con AWS S3, con MinIO o con Backblaze sin cambiar
+ * una línea. Llamarlo `r2Action` habría obligado, el día que llegue AWS, a
+ * tener dos nodos casi idénticos o a renombrar un tipo — y el prefijo del tipo
+ * vive DENTRO de los ids de nodo ya guardados en la base de cada cliente, así
+ * que renombrar es migrar datos.
+ *
+ * ## La operación que motiva el nodo
+ *
+ * `presignDownload`. La plataforma sabe firmar peticiones S3 desde el nodo
+ * HTTP —`common/s3-signer.ts`— pero **por cabecera**, y una cabecera no cabe en
+ * un enlace que se manda por correo. Sin esto no había forma de entregarle a un
+ * comprador una descarga temporal desde un flujo.
+ *
+ * ## Por qué sólo cuatro operaciones
+ *
+ * Listar y subida multiparte son las dos que piden el SDK de AWS de verdad
+ * —paginación y reanudación— y el ejecutor hoy no tiene ni un `@aws-sdk/*`.
+ * Entrar sin esa dependencia y traerla cuando aparezca la operación que la
+ * justifique es más barato que al revés. Y un nodo con veinte operaciones es un
+ * nodo que nadie entiende.
+ */
+export declare const BUCKET_OPERATIONS: readonly ["presignDownload", "putObject", "headObject", "deleteObject"];
+export type BucketOperation = (typeof BUCKET_OPERATIONS)[number];
+export declare function isBucketOperation(value: unknown): value is BucketOperation;
+/**
+ * Ninguna es iterable.
+ *
+ * Una operación iterable es la que devuelve una COLECCIÓN sobre la que el nodo
+ * de abajo repite. Las cuatro de aquí actúan sobre UN objeto, así que el que
+ * viene detrás recibe un resultado, no una lista. El día que entre `listObjects`
+ * ésa sí entra en esta lista.
+ */
+export declare const BUCKET_ITERABLE_OPERATIONS: readonly BucketOperation[];
+export type BucketParamType = 
+/** La clave del objeto dentro del bucket. Con autocompletado de
+ *  `{{payload.*}}`, porque el 90% de los casos la construye del evento:
+ *  `cuadernillos/{{payload.orderId}}.pdf`. */
+"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";
+export interface BucketParamSpec {
+    /** La clave de `operationConfig`. Es lo que lee la api, no un nombre de UI. */
+    name: string;
+    label: string;
+    type: BucketParamType;
+    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`. */
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+    min?: number;
+    max?: number;
+    /** Se pinta en la pestaña "Advanced" en vez de en "Config". */
+    advanced?: boolean;
+}
+export interface BucketOperationSpec {
+    /** Etiqueta de la fila en el desplegable de operación. */
+    label: string;
+    /** Sub-línea bajo la etiqueta. */
+    description: string;
+    /** La llamada S3 a la que mapea, para poder cotejarla con los docs. */
+    apiRoute: string;
+    /** Esquema de parámetros. El orden ES el orden en pantalla. */
+    params: BucketParamSpec[];
+}
+export declare const BUCKET_OPERATION_SPECS: Record<BucketOperation, BucketOperationSpec>;

package/dist/bucket-operations.js

@@ -0,0 +1,140 @@
+"use strict";
+/**
+ * El nodo de bucket: guardar, firmar y borrar objetos en un almacenamiento
+ * compatible con S3.
+ *
+ * ## Por qué se llama `bucket` y no `r2`
+ *
+ * Porque el proveedor es un ENDPOINT, no un tipo de nodo. La credencial
+ * `aws_s3` ya guarda `endpoint`, `bucket` y `region`, así que el mismo nodo
+ * habla con Cloudflare R2, con AWS S3, con MinIO o con Backblaze sin cambiar
+ * una línea. Llamarlo `r2Action` habría obligado, el día que llegue AWS, a
+ * tener dos nodos casi idénticos o a renombrar un tipo — y el prefijo del tipo
+ * vive DENTRO de los ids de nodo ya guardados en la base de cada cliente, así
+ * que renombrar es migrar datos.
+ *
+ * ## La operación que motiva el nodo
+ *
+ * `presignDownload`. La plataforma sabe firmar peticiones S3 desde el nodo
+ * HTTP —`common/s3-signer.ts`— pero **por cabecera**, y una cabecera no cabe en
+ * un enlace que se manda por correo. Sin esto no había forma de entregarle a un
+ * comprador una descarga temporal desde un flujo.
+ *
+ * ## Por qué sólo cuatro operaciones
+ *
+ * Listar y subida multiparte son las dos que piden el SDK de AWS de verdad
+ * —paginación y reanudación— y el ejecutor hoy no tiene ni un `@aws-sdk/*`.
+ * Entrar sin esa dependencia y traerla cuando aparezca la operación que la
+ * justifique es más barato que al revés. Y un nodo con veinte operaciones es un
+ * nodo que nadie entiende.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BUCKET_OPERATION_SPECS = exports.BUCKET_ITERABLE_OPERATIONS = exports.BUCKET_OPERATIONS = void 0;
+exports.isBucketOperation = isBucketOperation;
+exports.BUCKET_OPERATIONS = [
+    "presignDownload",
+    "putObject",
+    "headObject",
+    "deleteObject",
+];
+function isBucketOperation(value) {
+    return (typeof value === "string" &&
+        exports.BUCKET_OPERATIONS.includes(value));
+}
+/**
+ * Ninguna es iterable.
+ *
+ * Una operación iterable es la que devuelve una COLECCIÓN sobre la que el nodo
+ * de abajo repite. Las cuatro de aquí actúan sobre UN objeto, así que el que
+ * viene detrás recibe un resultado, no una lista. El día que entre `listObjects`
+ * ésa sí entra en esta lista.
+ */
+exports.BUCKET_ITERABLE_OPERATIONS = [];
+/* Ayudantes — repetir el mismo objeto cuatro veces es cómo se desincronizan las
+   descripciones. */
+const objectKey = (placeholder) => ({
+    name: "key",
+    label: "Object key",
+    type: "template",
+    required: true,
+    placeholder,
+    description: "La ruta dentro del bucket. Sin barra inicial. Admite {{payload.x}}.",
+});
+exports.BUCKET_OPERATION_SPECS = {
+    presignDownload: {
+        label: "Sign download link",
+        description: "Devuelve una URL temporal para descargar un objeto privado. No mueve el fichero.",
+        apiRoute: "GET (presigned)",
+        params: [
+            objectKey("cuadernillos/{{payload.orderId}}.pdf"),
+            {
+                name: "expiresIn",
+                label: "Link valid for (seconds)",
+                type: "number",
+                required: true,
+                default: 3600,
+                min: 60,
+                /* El tope de SigV4 es de siete días y no se puede pasar: firmar por
+                   más tiempo produce una URL que el proveedor rechaza, y el error
+                   llega tarde y sin explicación. */
+                max: 604800,
+                description: "Desde 60 s hasta 7 días, que es el máximo que admite la firma. Pasado ese plazo el enlace deja de servir.",
+            },
+            {
+                name: "downloadAs",
+                label: "Download as (filename)",
+                type: "template",
+                placeholder: "Cuadernillo 1.pdf",
+                description: "Si se rellena, el navegador DESCARGA el fichero con ese nombre en vez de abrirlo. Déjalo vacío para que lo abra.",
+            },
+        ],
+    },
+    putObject: {
+        label: "Upload object",
+        description: "Guarda un objeto en el bucket. Sobreescribe si la clave ya existe.",
+        apiRoute: "PUT /{bucket}/{key}",
+        params: [
+            objectKey("recibos/{{payload.orderId}}.json"),
+            {
+                name: "body",
+                label: "Contents",
+                type: "textarea",
+                required: true,
+                placeholder: "{{payload}}",
+                description: "Lo que se guarda. Admite {{payload.x}}; un objeto se guarda como JSON.",
+            },
+            {
+                name: "contentType",
+                label: "Content type",
+                type: "template",
+                default: "application/json",
+                placeholder: "application/pdf",
+                description: "Lo que el navegador usará para decidir qué hacer con el fichero.",
+            },
+        ],
+    },
+    headObject: {
+        label: "Check object exists",
+        description: "Comprueba si un objeto existe, y su tamaño, sin descargarlo.",
+        apiRoute: "HEAD /{bucket}/{key}",
+        params: [
+            objectKey("cuadernillos/{{payload.orderId}}.pdf"),
+            {
+                name: "failIfMissing",
+                label: "Fail when the object is missing",
+                type: "booleanSelect",
+                options: [
+                    { value: "true", label: "Sí — cortar el flujo" },
+                    { value: "false", label: "No — seguir con exists: false" },
+                ],
+                description: 'Con "No", el paso sale bien y el de abajo decide. Con "Sí", un objeto que falta corta el flujo.',
+            },
+        ],
+    },
+    deleteObject: {
+        label: "Delete object",
+        description: "Borra un objeto del bucket. No se puede deshacer.",
+        apiRoute: "DELETE /{bucket}/{key}",
+        params: [objectKey("temporales/{{payload.id}}.tmp")],
+    },
+};

package/dist/calendar-toolkit.d.ts

@@ -28,7 +28,7 @@
  * El array se generó desde la copia de la api para que las descripciones largas
  * salieran idénticas, no tecleadas.
  */
-import type { GoogleCalendarOperation } from './calendar-operations';
+import type { GoogleCalendarOperation } from './calendar-operations.js';
 export interface GoogleCalendarToolkitParameter {
     name: string;
     type: 'string' | 'number' | 'boolean';

package/dist/connections.d.ts

@@ -6,7 +6,7 @@
  *
  * Adding a new node type = add 1 entry here. All repos import from this package.
  */
-import type { NodeType, NodeConnectionConfig } from './types';
+import type { NodeType, NodeConnectionConfig } from './types.js';
 export declare const NODE_CONNECTIONS: Record<NodeType, NodeConnectionConfig>;
 export declare function canReceiveFrom(targetType: NodeType, sourceType: NodeType): boolean;
 export declare function canReceiveFromNodes(nodeType: NodeType): boolean;

package/dist/connections.js

@@ -81,6 +81,7 @@ exports.NODE_CONNECTIONS = {
     shopifyAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     githubAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
     jiraAction: { acceptsInputFrom: ACTION_INPUTS, canOutputTo: PROCESSING_OUTPUTS },
+    bucketAction: { 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/discord-operations.d.ts

@@ -17,7 +17,7 @@
  * forum-post create) extend this list — bump the package and re-install
  * in consumers, same pattern as Gmail / Calendar / Drive / Telegram.
  */
-import { type CapacidadesPorCredencial } from './capacidad-de-credencial';
+import { type CapacidadesPorCredencial } from './capacidad-de-credencial.js';
 export declare const DISCORD_OPERATIONS: readonly ["sendMessage", "editMessage", "deleteMessage", "getMessage", "addReaction", "removeReaction", "pinMessage", "createChannel", "editChannel", "deleteChannel", "getChannel", "listChannels", "createThread", "sendDM", "addRole", "removeRole", "getMember"];
 export type DiscordOperation = (typeof DISCORD_OPERATIONS)[number];
 /** Type guard — useful when validating untrusted input (DTOs, tool calls). */

package/dist/discord-operations.js

@@ -24,7 +24,7 @@ exports.camposDeDiscordNoDisponibles = camposDeDiscordNoDisponibles;
  * forum-post create) extend this list — bump the package and re-install
  * in consumers, same pattern as Gmail / Calendar / Drive / Telegram.
  */
-const capacidad_de_credencial_1 = require("./capacidad-de-credencial");
+const capacidad_de_credencial_js_1 = require("./capacidad-de-credencial.js");
 exports.DISCORD_OPERATIONS = [
     // Messages
     'sendMessage',
@@ -402,13 +402,13 @@ exports.DISCORD_CAPACIDADES_POR_CREDENCIAL = {
 };
 /** Las operaciones que ofrecer para una credencial de Discord. */
 function operacionesDeDiscordPara(tipoDeCredencial) {
-    return (0, capacidad_de_credencial_1.operacionesPara)(exports.DISCORD_OPERATIONS, exports.DISCORD_CAPACIDADES_POR_CREDENCIAL, tipoDeCredencial);
+    return (0, capacidad_de_credencial_js_1.operacionesPara)(exports.DISCORD_OPERATIONS, exports.DISCORD_CAPACIDADES_POR_CREDENCIAL, tipoDeCredencial);
 }
 /** Si esa credencial puede ejecutar esa operación de Discord. */
 function discordPuedeEjecutar(tipoDeCredencial, operacion) {
-    return (0, capacidad_de_credencial_1.puedeEjecutar)(exports.DISCORD_OPERATIONS, exports.DISCORD_CAPACIDADES_POR_CREDENCIAL, tipoDeCredencial, operacion);
+    return (0, capacidad_de_credencial_js_1.puedeEjecutar)(exports.DISCORD_OPERATIONS, exports.DISCORD_CAPACIDADES_POR_CREDENCIAL, tipoDeCredencial, operacion);
 }
 /** Los campos que esa credencial de Discord no deja elegir. */
 function camposDeDiscordNoDisponibles(tipoDeCredencial) {
-    return (0, capacidad_de_credencial_1.camposNoDisponiblesPara)(exports.DISCORD_CAPACIDADES_POR_CREDENCIAL, tipoDeCredencial);
+    return (0, capacidad_de_credencial_js_1.camposNoDisponiblesPara)(exports.DISCORD_CAPACIDADES_POR_CREDENCIAL, tipoDeCredencial);
 }

package/dist/discord-toolkit.d.ts

@@ -22,7 +22,7 @@
  * pueda usarse sin adaptador. Los textos van en inglés porque los lee el modelo
  * y quien mire la lista de herramientas del servidor MCP.
  */
-import type { DiscordOperation } from './discord-operations';
+import type { DiscordOperation } from './discord-operations.js';
 export interface DiscordToolkitParameter {
     name: string;
     type: 'string' | 'number' | 'boolean';

package/dist/discord-toolkit.js

@@ -26,7 +26,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DISCORD_TOOLKIT_BY_TOOL_NAME = exports.DISCORD_TOOLKIT_SPECS = void 0;
 exports.herramientasDeDiscordPara = herramientasDeDiscordPara;
-const discord_operations_1 = require("./discord-operations");
+const discord_operations_js_1 = require("./discord-operations.js");
 const p = (name, description, required = true, type = 'string') => ({ name, type, description, required });
 exports.DISCORD_TOOLKIT_SPECS = [
     // ── Messages ───────────────────────────────────────────────────
@@ -252,8 +252,8 @@ exports.DISCORD_TOOLKIT_BY_TOOL_NAME = Object.fromEntries(exports.DISCORD_TOOLKI
  *      fallar, porque parece que funcionó.
  */
 function herramientasDeDiscordPara(tipoDeCredencial) {
-    const permitidas = new Set((0, discord_operations_1.operacionesDeDiscordPara)(tipoDeCredencial));
-    const fuera = (0, discord_operations_1.camposDeDiscordNoDisponibles)(tipoDeCredencial);
+    const permitidas = new Set((0, discord_operations_js_1.operacionesDeDiscordPara)(tipoDeCredencial));
+    const fuera = (0, discord_operations_js_1.camposDeDiscordNoDisponibles)(tipoDeCredencial);
     return exports.DISCORD_TOOLKIT_SPECS.filter((s) => permitidas.has(s.operation)).map((s) => 
     /* Se devuelve una copia sólo cuando hay algo que quitar: así el camino
        normal —el bot, que puede con todo— sigue entregando las MISMAS

package/dist/dispatch.d.ts

@@ -8,7 +8,7 @@
  * orphan the node (the symptom Vector Store / AI / Markdown / Code /
  * File Transform all hit before this refactor).
  */
-import type { NodeType, NodeDispatchConfig } from './types';
+import type { NodeType, NodeDispatchConfig } from './types.js';
 export declare const NODE_DISPATCH: Record<NodeType, NodeDispatchConfig>;
 /** Get all MongoDB collection names for cascade cleanup */
 export declare function getAllNodeCollections(): string[];

package/dist/dispatch.js

@@ -56,6 +56,7 @@ exports.NODE_DISPATCH = {
     shopifyAction: { service: 'shopifyActionsService', collection: 'shopifyactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     githubAction: { service: 'githubActionsService', collection: 'githubactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
     jiraAction: { service: 'jiraActionsService', collection: 'jiraactions', hasFilters: true, outputFields: ['outputNodes'], customDispatch: true, pipelineDispatch: 'excluded' },
+    bucketAction: { service: 'bucketActionsService', collection: 'bucketactions', 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/docs-toolkit.d.ts

@@ -13,7 +13,7 @@
  * usarse sin adaptador. Los textos van en inglés porque los lee el modelo y
  * quien mire la lista de herramientas del servidor MCP.
  */
-import type { DocsOperation } from './docs-operations';
+import type { DocsOperation } from './docs-operations.js';
 export interface DocsToolkitParameter {
     name: string;
     /** El esquema MCP sólo admite estos tres. */

package/dist/drive-toolkit.d.ts

@@ -19,7 +19,7 @@
  * herramientas del mismo grupo tienen que ir seguidas. Los tres grupos son los
  * que ya inventaba el JSX que sustituye.
  */
-import type { DriveOperation } from './drive-operations';
+import type { DriveOperation } from './drive-operations.js';
 export interface DriveToolkitParameter {
     name: string;
     type: 'string' | 'number' | 'boolean';

package/dist/esm/bucket-operations.d.ts

@@ -0,0 +1,88 @@
+/**
+ * El nodo de bucket: guardar, firmar y borrar objetos en un almacenamiento
+ * compatible con S3.
+ *
+ * ## Por qué se llama `bucket` y no `r2`
+ *
+ * Porque el proveedor es un ENDPOINT, no un tipo de nodo. La credencial
+ * `aws_s3` ya guarda `endpoint`, `bucket` y `region`, así que el mismo nodo
+ * habla con Cloudflare R2, con AWS S3, con MinIO o con Backblaze sin cambiar
+ * una línea. Llamarlo `r2Action` habría obligado, el día que llegue AWS, a
+ * tener dos nodos casi idénticos o a renombrar un tipo — y el prefijo del tipo
+ * vive DENTRO de los ids de nodo ya guardados en la base de cada cliente, así
+ * que renombrar es migrar datos.
+ *
+ * ## La operación que motiva el nodo
+ *
+ * `presignDownload`. La plataforma sabe firmar peticiones S3 desde el nodo
+ * HTTP —`common/s3-signer.ts`— pero **por cabecera**, y una cabecera no cabe en
+ * un enlace que se manda por correo. Sin esto no había forma de entregarle a un
+ * comprador una descarga temporal desde un flujo.
+ *
+ * ## Por qué sólo cuatro operaciones
+ *
+ * Listar y subida multiparte son las dos que piden el SDK de AWS de verdad
+ * —paginación y reanudación— y el ejecutor hoy no tiene ni un `@aws-sdk/*`.
+ * Entrar sin esa dependencia y traerla cuando aparezca la operación que la
+ * justifique es más barato que al revés. Y un nodo con veinte operaciones es un
+ * nodo que nadie entiende.
+ */
+export declare const BUCKET_OPERATIONS: readonly ["presignDownload", "putObject", "headObject", "deleteObject"];
+export type BucketOperation = (typeof BUCKET_OPERATIONS)[number];
+export declare function isBucketOperation(value: unknown): value is BucketOperation;
+/**
+ * Ninguna es iterable.
+ *
+ * Una operación iterable es la que devuelve una COLECCIÓN sobre la que el nodo
+ * de abajo repite. Las cuatro de aquí actúan sobre UN objeto, así que el que
+ * viene detrás recibe un resultado, no una lista. El día que entre `listObjects`
+ * ésa sí entra en esta lista.
+ */
+export declare const BUCKET_ITERABLE_OPERATIONS: readonly BucketOperation[];
+export type BucketParamType = 
+/** La clave del objeto dentro del bucket. Con autocompletado de
+ *  `{{payload.*}}`, porque el 90% de los casos la construye del evento:
+ *  `cuadernillos/{{payload.orderId}}.pdf`. */
+"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";
+export interface BucketParamSpec {
+    /** La clave de `operationConfig`. Es lo que lee la api, no un nombre de UI. */
+    name: string;
+    label: string;
+    type: BucketParamType;
+    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`. */
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+    min?: number;
+    max?: number;
+    /** Se pinta en la pestaña "Advanced" en vez de en "Config". */
+    advanced?: boolean;
+}
+export interface BucketOperationSpec {
+    /** Etiqueta de la fila en el desplegable de operación. */
+    label: string;
+    /** Sub-línea bajo la etiqueta. */
+    description: string;
+    /** La llamada S3 a la que mapea, para poder cotejarla con los docs. */
+    apiRoute: string;
+    /** Esquema de parámetros. El orden ES el orden en pantalla. */
+    params: BucketParamSpec[];
+}
+export declare const BUCKET_OPERATION_SPECS: Record<BucketOperation, BucketOperationSpec>;

package/dist/esm/bucket-operations.js

@@ -0,0 +1,136 @@
+/**
+ * El nodo de bucket: guardar, firmar y borrar objetos en un almacenamiento
+ * compatible con S3.
+ *
+ * ## Por qué se llama `bucket` y no `r2`
+ *
+ * Porque el proveedor es un ENDPOINT, no un tipo de nodo. La credencial
+ * `aws_s3` ya guarda `endpoint`, `bucket` y `region`, así que el mismo nodo
+ * habla con Cloudflare R2, con AWS S3, con MinIO o con Backblaze sin cambiar
+ * una línea. Llamarlo `r2Action` habría obligado, el día que llegue AWS, a
+ * tener dos nodos casi idénticos o a renombrar un tipo — y el prefijo del tipo
+ * vive DENTRO de los ids de nodo ya guardados en la base de cada cliente, así
+ * que renombrar es migrar datos.
+ *
+ * ## La operación que motiva el nodo
+ *
+ * `presignDownload`. La plataforma sabe firmar peticiones S3 desde el nodo
+ * HTTP —`common/s3-signer.ts`— pero **por cabecera**, y una cabecera no cabe en
+ * un enlace que se manda por correo. Sin esto no había forma de entregarle a un
+ * comprador una descarga temporal desde un flujo.
+ *
+ * ## Por qué sólo cuatro operaciones
+ *
+ * Listar y subida multiparte son las dos que piden el SDK de AWS de verdad
+ * —paginación y reanudación— y el ejecutor hoy no tiene ni un `@aws-sdk/*`.
+ * Entrar sin esa dependencia y traerla cuando aparezca la operación que la
+ * justifique es más barato que al revés. Y un nodo con veinte operaciones es un
+ * nodo que nadie entiende.
+ */
+export const BUCKET_OPERATIONS = [
+    "presignDownload",
+    "putObject",
+    "headObject",
+    "deleteObject",
+];
+export function isBucketOperation(value) {
+    return (typeof value === "string" &&
+        BUCKET_OPERATIONS.includes(value));
+}
+/**
+ * Ninguna es iterable.
+ *
+ * Una operación iterable es la que devuelve una COLECCIÓN sobre la que el nodo
+ * de abajo repite. Las cuatro de aquí actúan sobre UN objeto, así que el que
+ * viene detrás recibe un resultado, no una lista. El día que entre `listObjects`
+ * ésa sí entra en esta lista.
+ */
+export const BUCKET_ITERABLE_OPERATIONS = [];
+/* Ayudantes — repetir el mismo objeto cuatro veces es cómo se desincronizan las
+   descripciones. */
+const objectKey = (placeholder) => ({
+    name: "key",
+    label: "Object key",
+    type: "template",
+    required: true,
+    placeholder,
+    description: "La ruta dentro del bucket. Sin barra inicial. Admite {{payload.x}}.",
+});
+export const BUCKET_OPERATION_SPECS = {
+    presignDownload: {
+        label: "Sign download link",
+        description: "Devuelve una URL temporal para descargar un objeto privado. No mueve el fichero.",
+        apiRoute: "GET (presigned)",
+        params: [
+            objectKey("cuadernillos/{{payload.orderId}}.pdf"),
+            {
+                name: "expiresIn",
+                label: "Link valid for (seconds)",
+                type: "number",
+                required: true,
+                default: 3600,
+                min: 60,
+                /* El tope de SigV4 es de siete días y no se puede pasar: firmar por
+                   más tiempo produce una URL que el proveedor rechaza, y el error
+                   llega tarde y sin explicación. */
+                max: 604800,
+                description: "Desde 60 s hasta 7 días, que es el máximo que admite la firma. Pasado ese plazo el enlace deja de servir.",
+            },
+            {
+                name: "downloadAs",
+                label: "Download as (filename)",
+                type: "template",
+                placeholder: "Cuadernillo 1.pdf",
+                description: "Si se rellena, el navegador DESCARGA el fichero con ese nombre en vez de abrirlo. Déjalo vacío para que lo abra.",
+            },
+        ],
+    },
+    putObject: {
+        label: "Upload object",
+        description: "Guarda un objeto en el bucket. Sobreescribe si la clave ya existe.",
+        apiRoute: "PUT /{bucket}/{key}",
+        params: [
+            objectKey("recibos/{{payload.orderId}}.json"),
+            {
+                name: "body",
+                label: "Contents",
+                type: "textarea",
+                required: true,
+                placeholder: "{{payload}}",
+                description: "Lo que se guarda. Admite {{payload.x}}; un objeto se guarda como JSON.",
+            },
+            {
+                name: "contentType",
+                label: "Content type",
+                type: "template",
+                default: "application/json",
+                placeholder: "application/pdf",
+                description: "Lo que el navegador usará para decidir qué hacer con el fichero.",
+            },
+        ],
+    },
+    headObject: {
+        label: "Check object exists",
+        description: "Comprueba si un objeto existe, y su tamaño, sin descargarlo.",
+        apiRoute: "HEAD /{bucket}/{key}",
+        params: [
+            objectKey("cuadernillos/{{payload.orderId}}.pdf"),
+            {
+                name: "failIfMissing",
+                label: "Fail when the object is missing",
+                type: "booleanSelect",
+                options: [
+                    { value: "true", label: "Sí — cortar el flujo" },
+                    { value: "false", label: "No — seguir con exists: false" },
+                ],
+                description: 'Con "No", el paso sale bien y el de abajo decide. Con "Sí", un objeto que falta corta el flujo.',
+            },
+        ],
+    },
+    deleteObject: {
+        label: "Delete object",
+        description: "Borra un objeto del bucket. No se puede deshacer.",
+        apiRoute: "DELETE /{bucket}/{key}",
+        params: [objectKey("temporales/{{payload.id}}.tmp")],
+    },
+};

package/dist/esm/calendar-operations.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Google Calendar operation enum — single source of truth across the API,
+ * Dashboard, and Message Broker. Used by:
+ *   - calendarAction entity / DTO (api): operation field + validation
+ *   - dashboard CalendarActionGoogleOperation type
+ *   - broker hostwebhook types + tool schemas
+ *   - any future calendar-related node
+ *
+ * Adding a new Calendar operation = add it here, bump this package's
+ * version, publish to npm, and re-install in the consuming repos.
+ * Each consumer still owns its operation-specific config schema (the
+ * dashboard owns the UI form schema, the api owns the dispatch logic),
+ * but the canonical list of valid operation strings lives here.
+ */
+export declare const GOOGLE_CALENDAR_OPERATIONS: readonly ["createEvent", "updateEvent", "deleteEvent", "listEvents", "getEvent", "listCalendars", "findFreeSlots", "proposeEvent", "confirmEvent"];
+export type GoogleCalendarOperation = (typeof GOOGLE_CALENDAR_OPERATIONS)[number];
+/** Type guard — useful when validating untrusted input (DTOs, tool calls). */
+export declare function isGoogleCalendarOperation(value: unknown): value is GoogleCalendarOperation;
+export type GoogleCalendarParamTarget = 'eventConfig' | 'listConfig' | 'root';
+export type GoogleCalendarParamType = 
+/** Campo de texto con autocompletado de `{{payload.*}}`. */
+'template' | 'number' | 'select'
+/** El `TimezonePicker` que ya existe en el dashboard. */
+ | 'timezone';
+export interface GoogleCalendarParamSpec {
+    /** La clave DENTRO de `target`. Es la del cable, no un nombre de UI. */
+    name: string;
+    /** Dónde vive en la entidad. */
+    target: GoogleCalendarParamTarget;
+    label: string;
+    type: GoogleCalendarParamType;
+    required?: boolean;
+    /** Texto de ayuda. Llano: el paquete no lleva React. */
+    description?: string;
+    placeholder?: string;
+    default?: string | number;
+    options?: ReadonlyArray<{
+        value: string;
+        label: string;
+    }>;
+    min?: number;
+    max?: number;
+    /**
+     * Cómo se llama esta misma cosa en el `config` que espera el ejecutor
+     * compartido (`google-calendar-operations.service.ts`). El ejecutor está
+     * escrito para la ruta del toolkit, donde el LLM manda los nombres **sin**
+     * sufijo, así que `summaryTemplate` viaja como `summary`. Sólo lo llevan los
+     * params de las operaciones que van por ese despachador.
+     */
+    execKey?: string;
+}
+export interface GoogleCalendarOperationSpec {
+    /** Etiqueta del desplegable, y la misma que pinta el lienzo y el panel. */
+    label: string;
+    /** Sub-línea del desplegable. */
+    description: string;
+    /** Método de la API de Google al que corresponde. */
+    apiMethod: string;
+    /**
+     * Si se ejecuta por el despachador genérico (`calendarOps.run`) en vez de por
+     * un `case` escrito a mano. Son las cuatro que se abrieron el 2026-08-11.
+     */
+    viaExecutor?: boolean;
+    /** Orden de pantalla. */
+    params: GoogleCalendarParamSpec[];
+}
+export declare const GOOGLE_CALENDAR_OPERATION_SPECS: Record<GoogleCalendarOperation, GoogleCalendarOperationSpec>;