@hostwebhook/node-types 1.52.14 → 1.52.15

package/dist/index.d.ts

@@ -33,5 +33,7 @@ export { GOOGLE_CONTACTS_OPERATIONS, GOOGLE_CONTACTS_OPERATIONS_V1, GOOGLE_CONTA
 export type { GoogleContactsOperation, GoogleContactsParamSpec, GoogleContactsOperationSpec, GoogleContactsOperationGroup, } from './google-contacts-operations';
 export { POSTGRES_OPERATIONS, POSTGRES_MODES, POSTGRES_OPERATION_SPECS, isPostgresOperation, } from './postgres-operations';
 export type { PostgresOperation, PostgresMode, PostgresOperationSpec, } from './postgres-operations';
+export { MONGO_OPERATIONS, MONGO_OPERATION_SPECS, isMongoOperation, } from './mongo-operations';
+export type { MongoOperation, MongoParamType, MongoParamSpec, MongoOperationSpec, } from './mongo-operations';
 export type { CredentialTypeRegistration, CredentialType } from './credentials';
 export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials';

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isSheetsOperation = exports.SHEETS_OPERATION_SPECS = exports.SHEETS_OPERATIONS = exports.isSlackOperation = exports.SLACK_OPERATION_SPECS = exports.SLACK_OPERATIONS = exports.isDiscordOperation = exports.DISCORD_OPERATION_SPECS = exports.DISCORD_OPERATIONS = exports.isWhatsAppOperation = exports.WHATSAPP_OPERATIONS = exports.TELEGRAM_TOOLKIT_BY_TOOL_NAME = exports.TELEGRAM_TOOLKIT_SPECS = exports.isTelegramOperation = exports.TELEGRAM_OPERATION_SPECS = exports.TELEGRAM_OPERATIONS = exports.DRIVE_TOOLKIT_BY_TOOL_NAME = exports.DRIVE_TOOLKIT_SPECS = exports.isDriveOperation = 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.GMAIL_OPERATIONS = exports.NODE_TYPE_TO_PREFIX = exports.PREFIX_TO_NODE_TYPE = exports.NODE_STATE_KEYS = exports.NODE_COLORS = exports.NODE_DETAIL_PATHS = exports.getNodeRegistryEntry = exports.NODE_REGISTRY = exports.getNodeDispatchConfig = exports.getAllNodeCollections = exports.NODE_DISPATCH = exports.resolveNodeId = exports.PREFIX_TO_TYPE = exports.NODE_UI = exports.ALL_NODE_TYPES = exports.isNodeType = exports.isTerminal = exports.canSendToNodes = exports.canReceiveFromNodes = exports.canReceiveFrom = exports.NODE_CONNECTIONS = exports.iterableMeta = exports.singleMeta = void 0;
-exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = void 0;
+exports.isCredentialType = exports.getCredentialType = exports.credentialTypeValues = exports.CREDENTIAL_TYPE_VALUES = exports.CREDENTIAL_TYPES = exports.isMongoOperation = exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = exports.isPostgresOperation = exports.POSTGRES_OPERATION_SPECS = exports.POSTGRES_MODES = exports.POSTGRES_OPERATIONS = exports.isGoogleContactsOperation = exports.GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS = exports.GOOGLE_CONTACTS_OPERATION_GROUPS = exports.GOOGLE_CONTACTS_OPERATION_SPECS = exports.GOOGLE_CONTACTS_OPERATIONS_V2 = exports.GOOGLE_CONTACTS_OPERATIONS_V1 = exports.GOOGLE_CONTACTS_OPERATIONS = exports.SHEETS_TOOLKIT_DEFAULTABLE = exports.SHEETS_TOOLKIT_BY_TOOL_NAME = exports.SHEETS_TOOLKIT_SPECS = 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; } });
@@ -89,6 +89,10 @@ Object.defineProperty(exports, "POSTGRES_OPERATIONS", { enumerable: true, get: f
 Object.defineProperty(exports, "POSTGRES_MODES", { enumerable: true, get: function () { return postgres_operations_1.POSTGRES_MODES; } });
 Object.defineProperty(exports, "POSTGRES_OPERATION_SPECS", { enumerable: true, get: function () { return postgres_operations_1.POSTGRES_OPERATION_SPECS; } });
 Object.defineProperty(exports, "isPostgresOperation", { enumerable: true, get: function () { return postgres_operations_1.isPostgresOperation; } });
+var mongo_operations_1 = require("./mongo-operations");
+Object.defineProperty(exports, "MONGO_OPERATIONS", { enumerable: true, get: function () { return mongo_operations_1.MONGO_OPERATIONS; } });
+Object.defineProperty(exports, "MONGO_OPERATION_SPECS", { enumerable: true, get: function () { return mongo_operations_1.MONGO_OPERATION_SPECS; } });
+Object.defineProperty(exports, "isMongoOperation", { enumerable: true, get: function () { return mongo_operations_1.isMongoOperation; } });
 var credentials_1 = require("./credentials");
 Object.defineProperty(exports, "CREDENTIAL_TYPES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPES; } });
 Object.defineProperty(exports, "CREDENTIAL_TYPE_VALUES", { enumerable: true, get: function () { return credentials_1.CREDENTIAL_TYPE_VALUES; } });

package/dist/mongo-operations.d.ts

@@ -0,0 +1,61 @@
+/**
+ * MongoDB operation enum + esquema del formulario — una sola copia para la api,
+ * el Dashboard y el broker.
+ *
+ * ── Lo que quita ──
+ * La lista estaba escrita a mano **cinco veces sólo en la api** (tres en el DTO,
+ * dos en la entidad) y otras tantas en el dashboard. Y de los siete valores,
+ * el lienzo sólo conocía **cinco**: `findAll` y `findOneAndUpdate` no estaban en
+ * sus mapas de etiqueta y color, así que se pintaban grises y con el nombre
+ * crudo en camelCase mientras el panel sí les daba azul y ámbar.
+ *
+ * ── Lo fácil de Mongo ──
+ * Al contrario que Drive o Calendar, aquí **no hay capa de renombrado**: el
+ * `name` de cada param es la prop de la entidad tal cual, y el `apiUpdate` de la
+ * página es un passthrough de una línea. Es la forma de guardado más simple de
+ * la tanda.
+ */
+export declare const MONGO_OPERATIONS: readonly ["insertOne", "findOne", "findAll", "updateOne", "findOneAndUpdate", "deleteOne", "aggregate"];
+export type MongoOperation = (typeof MONGO_OPERATIONS)[number];
+/** Type guard — útil al validar entrada que no controlas (DTOs, tool calls). */
+export declare function isMongoOperation(value: unknown): value is MongoOperation;
+export type MongoParamType = 
+/** El `TemplateEditor` de JSON, con autocompletado de `{{payload.*}}`. */
+'jsonTemplate'
+/** El componente `UpdateBuilder` (arma `$set`, `$inc`… sin escribir JSON). */
+ | 'updateBuilder'
+/**
+ * Un `Switch` que se guarda **al instante** (`updateFieldInstant`) y se lee de
+ * la entidad, no de los locales. Se conserva así porque es como estaba.
+ */
+ | 'booleanInstant';
+export interface MongoParamSpec {
+    /** La prop de la entidad. Sin renombrado: es también la clave del cable. */
+    name: string;
+    label: string;
+    type: MongoParamType;
+    /** Texto de ayuda. Llano: el paquete no lleva React. */
+    description?: string;
+    placeholder?: string;
+    /** Sólo para `jsonTemplate`: la altura del editor. */
+    minHeight?: number;
+    maxHeight?: number;
+}
+export interface MongoOperationSpec {
+    /** La del desplegable de la página de detalle: «Insert One». */
+    label: string;
+    /**
+     * La de la píldora estrecha del lienzo y del panel: «INSERT».
+     *
+     * **Son dos etiquetas a propósito**, como en Calendar: dos anchos distintos y
+     * las dos se ven. Antes había una TERCERA convención, porque el panel pintaba
+     * `operation.toUpperCase()` y decía «FINDONEANDUPDATE» donde el lienzo decía
+     * «UPDATE». Ahora los dos leen esta.
+     */
+    labelShort: string;
+    /** Sub-línea del desplegable. */
+    description: string;
+    /** Orden de pantalla. */
+    params: MongoParamSpec[];
+}
+export declare const MONGO_OPERATION_SPECS: Record<MongoOperation, MongoOperationSpec>;

package/dist/mongo-operations.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * MongoDB operation enum + esquema del formulario — una sola copia para la api,
+ * el Dashboard y el broker.
+ *
+ * ── Lo que quita ──
+ * La lista estaba escrita a mano **cinco veces sólo en la api** (tres en el DTO,
+ * dos en la entidad) y otras tantas en el dashboard. Y de los siete valores,
+ * el lienzo sólo conocía **cinco**: `findAll` y `findOneAndUpdate` no estaban en
+ * sus mapas de etiqueta y color, así que se pintaban grises y con el nombre
+ * crudo en camelCase mientras el panel sí les daba azul y ámbar.
+ *
+ * ── Lo fácil de Mongo ──
+ * Al contrario que Drive o Calendar, aquí **no hay capa de renombrado**: el
+ * `name` de cada param es la prop de la entidad tal cual, y el `apiUpdate` de la
+ * página es un passthrough de una línea. Es la forma de guardado más simple de
+ * la tanda.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MONGO_OPERATION_SPECS = exports.MONGO_OPERATIONS = void 0;
+exports.isMongoOperation = isMongoOperation;
+exports.MONGO_OPERATIONS = [
+    'insertOne', // inserta un documento
+    'findOne', // devuelve el primero que casa
+    'findAll', // devuelve todos los que casan (tope 1000)
+    'updateOne', // actualiza el primero que casa
+    'findOneAndUpdate', // actualiza y devuelve el documento
+    'deleteOne', // borra el primero que casa
+    'aggregate', // pipeline de agregación
+];
+/** Type guard — útil al validar entrada que no controlas (DTOs, tool calls). */
+function isMongoOperation(value) {
+    return typeof value === 'string' && exports.MONGO_OPERATIONS.includes(value);
+}
+/* Los campos que comparten varias operaciones. */
+const queryTemplate = () => ({
+    name: 'queryTemplate',
+    label: 'Query Template',
+    type: 'jsonTemplate',
+    placeholder: '{"email": "{{payload.email}}"}',
+    minHeight: 100,
+    maxHeight: 200,
+});
+const updateTemplate = () => ({
+    name: 'updateTemplate',
+    label: 'Update Operations',
+    type: 'updateBuilder',
+});
+exports.MONGO_OPERATION_SPECS = {
+    insertOne: {
+        label: 'Insert One',
+        labelShort: 'INSERT',
+        description: 'Insert a single document',
+        params: [
+            {
+                name: 'documentTemplate',
+                label: 'Document Template',
+                type: 'jsonTemplate',
+                placeholder: '{"name": "{{payload.name}}", "email": "{{payload.email}}"}',
+                minHeight: 100,
+                maxHeight: 200,
+            },
+        ],
+    },
+    findOne: {
+        label: 'Find One',
+        labelShort: 'FIND',
+        description: 'Find a single matching document',
+        params: [queryTemplate()],
+    },
+    findAll: {
+        label: 'Find All',
+        /* Antes no estaba en el mapa del lienzo y salía el crudo `findAll`. */
+        labelShort: 'FIND ALL',
+        description: 'Find all matching documents (limit 1000)',
+        params: [
+            /* El interruptor va ANTES del query, que es el orden en que se pintaba. */
+            {
+                name: 'includeCount',
+                label: 'Include Count',
+                type: 'booleanInstant',
+                description: 'Return total count of matching documents alongside results',
+            },
+            queryTemplate(),
+        ],
+    },
+    updateOne: {
+        label: 'Update One',
+        labelShort: 'UPDATE',
+        description: 'Update a single matching document',
+        params: [queryTemplate(), updateTemplate()],
+    },
+    findOneAndUpdate: {
+        label: 'Find & Update',
+        /* Tampoco estaba: salía el crudo `findOneAndUpdate` en el lienzo y
+           `FINDONEANDUPDATE` en el panel. */
+        labelShort: 'FIND & UPDATE',
+        description: 'Find, update, and return the document',
+        params: [queryTemplate(), updateTemplate()],
+    },
+    deleteOne: {
+        label: 'Delete One',
+        labelShort: 'DELETE',
+        description: 'Delete a single matching document',
+        params: [queryTemplate()],
+    },
+    aggregate: {
+        label: 'Aggregate',
+        labelShort: 'AGGREGATE',
+        description: 'Run aggregation pipeline ($match, $group, $sort...)',
+        params: [
+            {
+                /* Mismo campo que en las demás, con otro título y otro ejemplo: por eso
+                   los params se declaran por operación y no en un registro global. */
+                name: 'queryTemplate',
+                label: 'Pipeline Template',
+                type: 'jsonTemplate',
+                placeholder: '[{"$match": {"status": "active"}}, {"$group": {"_id": "$category"}}]',
+                minHeight: 100,
+                maxHeight: 200,
+            },
+        ],
+    },
+};

package/package.json

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