@hostwebhook/node-types 1.69.0 → 1.71.0

package/dist/esm/types.d.ts

@@ -0,0 +1,149 @@
+/** All valid node type identifiers */
+export type NodeType = 'webhook' | 'scheduledWorkflow' | 'chatTrigger' | 'trigger' | 'voiceAgent' | 'filter' | 'transform' | 'schemaValidator' | 'conditional' | 'delay' | 'rateLimiter' | 'aggregator' | 'cache' | 'code' | 'ai' | 'merge' | 'approval' | 'split' | 'loop' | 'markdown' | 'fileTransform' | 'limit' | 'router' | 'emailAction' | 'gmailAction' | 'httpAction' | 'mongoAction' | 'postgresAction' | 'notificationAction' | 'sheetsAction' | 'calendarAction' | 'docsAction' | 'driveAction' | 'firecrawlAction' | 'telegramAction' | 'whatsappAction' | 'discordAction' | 'slackAction' | 'googleContactsAction' | 'googleAnalyticsAction' | 'notionAction' | 'vectorStore' | 'rssAction' | 'socialMediaAction' | 'mailchimpAction' | 'shopifyAction' | 'githubAction' | 'jiraAction' | 'bucketAction' | 'stickyNote';
+/** Node role in the pipeline */
+export type NodeRole = 'source' | 'processing' | 'flowControl' | 'routing' | 'action' | 'monitoring';
+/** Handle positions on the canvas node */
+export type HandlePosition = 'left' | 'right' | 'top' | 'bottom';
+/** Connection rules — which node types can connect to/from this node */
+export interface NodeConnectionConfig {
+    acceptsInputFrom: NodeType[];
+    canOutputTo: NodeType[];
+    special?: {
+        hasRejectionOutputNodes?: boolean;
+        hasBranches?: boolean;
+        isTerminal?: boolean;
+        hasLoopBack?: boolean;
+    };
+}
+/** UI-specific config for the dashboard canvas */
+export interface NodeUIConfig {
+    fromNodes: boolean;
+    toNodes: boolean;
+    isSource?: boolean;
+    inputHandles?: HandlePosition[];
+    outputHandles?: HandlePosition[];
+    dotHandles?: {
+        input?: string[];
+        output?: string[];
+    };
+    /**
+     * When true, the canvas derives output handles from the node entity
+     * at render time (e.g. one handle per `entity.tools[i].name`) rather
+     * than from a static `dotHandles.output` list. Used by Voice Agent —
+     * the count of tools is data, not config. NodeShell branches on this
+     * flag to render the dynamic handle set.
+     */
+    dynamicOutputs?: boolean;
+    special?: {
+        hasBranches?: boolean;
+        isTerminal?: boolean;
+        hasLoopBack?: boolean;
+        connectModal?: 'branch' | 'rule' | 'output-group';
+        routerTargetLabel?: string;
+        /**
+         * Generic named output groups — used by connectModal: 'output-group'.
+         * The modal reads entity[outputGroupsField] as an array of groups,
+         * each with a name (outputGroupNameField), a summary (outputGroupSummaryField),
+         * and its own outputNodes[].
+         * Works for Split (outputs[]), Conditional (branches[]), or any future branching node.
+         */
+        outputGroups?: {
+            /** Entity field containing the array of groups (e.g. 'outputs', 'branches') */
+            field?: string;
+            /** Field within each group for display name (e.g. 'name') */
+            nameField?: string;
+            /** Field within each group for summary/description (e.g. 'field', 'filterMode') */
+            summaryField?: string;
+            /** Label shown in the modal (e.g. 'output', 'branch') */
+            label: string;
+            /** Entity field for the fallback/else path (e.g. 'elseOutputNodes') */
+            elseField?: string;
+            /**
+             * Fixed output groups — for nodes with a static set of outputs (e.g. approval: approve/reject).
+             * Each entry maps to a top-level entity field that holds outputNodes[].
+             * When set, `field`/`nameField` are ignored — modal shows these fixed options.
+             */
+            fixedGroups?: Array<{
+                name: string;
+                field: string;
+            }>;
+            /**
+             * Optional content-aware gate — the output-group modal only opens
+             * when `entity[gate.field] === gate.value`. Lets a node opt into
+             * multi-branch routing only in some modes (e.g. AI Node in
+             * classifier mode) without trapping every connection in the
+             * picker the rest of the time. When the gate fails, the
+             * FlowCanvas falls through to the universal
+             * `entity.outputNodes` connect path.
+             */
+            gate?: {
+                field: string;
+                value: unknown;
+            };
+        };
+        /**
+         * Maps output fields to alternate payload fields on the source entity.
+         * When a downstream node is connected via a specific output field,
+         * InputSection reads the alternate payload instead of lastPayload.
+         * Example: { doneOutputNodes: 'lastDonePayload' } for loop nodes.
+         */
+        alternatePayloads?: Record<string, string>;
+        /** Whether this node can be connected as a loop-back target. Only nodes that go through the unified node-lifecycle support loop-back detection. */
+        loopBackAllowed?: boolean;
+    };
+}
+/**
+ * How the event pipeline routes a payload to this node when an
+ * upstream webhook connects to it directly. Required so adding a
+ * new node type at compile time is impossible without picking one.
+ *
+ * - 'generic': dispatchConnectedNodes loops findActiveByInputEndpoint
+ *   on the service and dispatches every active match. Use for
+ *   pipeline-style nodes that ingest webhook payloads (filter,
+ *   transform, ai, code, markdown, fileTransform, vectorStore).
+ *
+ * - 'custom': has a dedicated `case` in the dispatchOutputNodes
+ *   switch that calls the node's specific service method. Used
+ *   when the node needs scheduling, branching, gating, or queueing
+ *   (delay, cache, aggregator, rateLimiter, conditional, split,
+ *   loop, merge, approval, schemaValidator, router). The generic
+ *   loop must NOT process these — would dispatch twice.
+ *
+ * - 'excluded': not dispatched in the webhook flow at all. Action
+ *   nodes (email/http/mongo/notification/sheets/calendar/docs/
+ *   firecrawl) are fired post-delivery in onDeliveryResult with
+ *   their own loops; ingress nodes (webhook/scheduledWorkflow/
+ *   chatTrigger/trigger) start the flow themselves;
+ *   stickyNote is purely visual.
+ */
+export type PipelineDispatchKind = 'generic' | 'custom' | 'excluded';
+/** API dispatch config — how the event pipeline processes each node */
+export interface NodeDispatchConfig {
+    service: string;
+    collection: string;
+    hasFilters: boolean;
+    outputFields: string[];
+    /** @deprecated Use `pipelineDispatch` instead. Kept for backwards compat
+     *  during the migration; will be removed once every consumer reads
+     *  `pipelineDispatch`. */
+    customDispatch: boolean;
+    /** Required. See PipelineDispatchKind for the contract per value. */
+    pipelineDispatch: PipelineDispatchKind;
+}
+/** Standardized payload metadata — every node output MUST include _meta */
+export interface PayloadMeta {
+    iterable: boolean;
+    count: number;
+    iterateField?: string;
+}
+/** Helper to create _meta for single-object outputs */
+export declare function singleMeta(): PayloadMeta;
+/** Helper to create _meta for iterable array outputs */
+export declare function iterableMeta(field: string, count: number): PayloadMeta;
+/** Canvas prefix → node type mapping */
+export interface PrefixMapping {
+    prefix: string;
+    type: NodeType;
+    /** Canvas node type used in React Flow nodeTypes map (e.g. "cache-node", "email-action") */
+    canvasType: string;
+}

package/dist/esm/types.js

@@ -0,0 +1,8 @@
+/** Helper to create _meta for single-object outputs */
+export function singleMeta() {
+    return { iterable: false, count: 1 };
+}
+/** Helper to create _meta for iterable array outputs */
+export function iterableMeta(field, count) {
+    return { iterable: true, iterateField: field, count };
+}

package/dist/esm/ui.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Dashboard UI config — handle positions, dot visibility, canvas prefixes.
+ * Only imported by the Dashboard. Broker and API don't need this.
+ */
+import type { NodeType, NodeUIConfig, PrefixMapping } from './types.js';
+export declare const NODE_UI: Record<NodeType, NodeUIConfig>;
+/** Canvas prefix → node type mapping (used by FlowCanvas to identify node type from XYFlow node ID) */
+export declare const PREFIX_TO_TYPE: PrefixMapping[];
+/** Resolve canvas node ID to { type, entityId } */
+export declare function resolveNodeId(canvasId: string): {
+    type: NodeType;
+    entityId: string;
+} | null;

package/dist/esm/ui.js

@@ -0,0 +1,152 @@
+/**
+ * Dashboard UI config — handle positions, dot visibility, canvas prefixes.
+ * Only imported by the Dashboard. Broker and API don't need this.
+ */
+export const NODE_UI = {
+    // ── Source nodes ──
+    // Una fuente arranca el flujo: `fromNodes: false` significa que nada puede
+    // conectarse HACIA ella, y por eso su DTO en la API tampoco declara
+    // `inputNodes`. Expone un único punto de salida, `right-out`. El de abajo se
+    // retiró porque no aportaba una segunda semántica — sólo una segunda diana
+    // donde soltar aristas.
+    //
+    // Ya no queda ningún punto de abajo en todo el registro. Aquí ponía que el
+    // `router` conservaba el suyo «porque ahí abajo significa por regla», y era
+    // mentira: el modal de reglas lo abre `special.connectModal`, que mira el
+    // TIPO del nodo origen y no el handle por el que sueltas, así que desde la
+    // derecha salía el mismo modal. El destino de una regla vive en
+    // `port: rule:<id>`; el handle es sólo por dónde entra y sale la línea.
+    webhook: { fromNodes: true, toNodes: true, isSource: true },
+    scheduledWorkflow: { fromNodes: false, toNodes: true, isSource: true, outputHandles: ['right'], dotHandles: { output: ['right-out'] } },
+    chatTrigger: { fromNodes: false, toNodes: true, isSource: true, outputHandles: ['right'], dotHandles: { output: ['right-out'] } },
+    trigger: { fromNodes: false, toNodes: true, isSource: true, outputHandles: ['right'], dotHandles: { output: ['right-out'] } },
+    // Voice Agent: dynamicOutputs=true tells NodeShell to derive ONE
+    // output handle per non-disabled `entity.tools[i].name`. The
+    // `right-out` fallback handle is rendered when the agent has zero
+    // tools so the user has somewhere to drop the first wired connection
+    // before any tools are defined (rare but possible during onboarding).
+    voiceAgent: { fromNodes: false, toNodes: true, isSource: true, outputHandles: ['right'], dotHandles: { output: ['right-out'] }, dynamicOutputs: true },
+    // ── Pipeline processing nodes ──
+    filter: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },
+    transform: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },
+    // One output only: a payload that fails validation stops at the node.
+    schemaValidator: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { loopBackAllowed: true } },
+    conditional: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { loopBackAllowed: true, connectModal: 'output-group', outputGroups: { field: 'branches', nameField: 'name', summaryField: 'filterMode', label: 'branch', elseField: 'elseOutputNodes' } } },
+    delay: { fromNodes: true, toNodes: true },
+    rateLimiter: { fromNodes: true, toNodes: true },
+    aggregator: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },
+    cache: { fromNodes: true, toNodes: true },
+    code: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },
+    // AI Node: in classifier mode (entity.outputMode === 'classifier') the
+    // node fans out to N output handles — one per category in
+    // `entity.categories[]`, with the wiring in `categories[].outputNodes`.
+    // An item the classifier cannot place lands on the synthetic "other"
+    // value (see `entity.includeOtherBranch`) and stops there — "other" has
+    // no handle and no route. In any other outputMode the node falls back to
+    // the single right-out handle NodeShell renders when no dynamic outputs
+    // materialize.
+    ai: { fromNodes: true, toNodes: true, outputHandles: ['right'], special: { loopBackAllowed: true, connectModal: 'output-group', outputGroups: { field: 'categories', nameField: 'name', summaryField: 'description', label: 'category', gate: { field: 'outputMode', value: 'classifier' } } } },
+    markdown: { fromNodes: true, toNodes: true, special: { loopBackAllowed: true } },
+    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' } } },
+    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' } },
+    // ── 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' } },
+    httpAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    mongoAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    postgresAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    notificationAction: { fromNodes: true, toNodes: false, inputHandles: ['left', 'top'], dotHandles: { input: ['left-in', 'top-in'] }, special: { isTerminal: true, routerTargetLabel: 'notification' } },
+    sheetsAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    calendarAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    docsAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    driveAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    firecrawlAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    telegramAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'telegram' } },
+    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' } },
+    jiraAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'jira' } },
+    bucketAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'bucket' } },
+    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 } },
+    notionAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true, routerTargetLabel: 'notion' } },
+    vectorStore: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    rssAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    socialMediaAction: { fromNodes: true, toNodes: true, inputHandles: ['left'], dotHandles: { input: ['left-in'], output: ['right-out'] }, special: { loopBackAllowed: true } },
+    // ── Annotations ──
+    stickyNote: { fromNodes: false, toNodes: false },
+};
+/** Canvas prefix → node type mapping (used by FlowCanvas to identify node type from XYFlow node ID) */
+export const PREFIX_TO_TYPE = [
+    { prefix: 'wh-', type: 'webhook', canvasType: 'webhook' },
+    { prefix: 'swf-', type: 'scheduledWorkflow', canvasType: 'scheduledWorkflow' },
+    { prefix: 'chat-', type: 'chatTrigger', canvasType: 'chatTrigger' },
+    { prefix: 'trg-', type: 'trigger', canvasType: 'trigger' },
+    { prefix: 'va-', type: 'voiceAgent', canvasType: 'voiceAgent' },
+    { prefix: 'ea-', type: 'emailAction', canvasType: 'emailAction' },
+    { prefix: 'gm-', type: 'gmailAction', canvasType: 'gmailAction' },
+    { prefix: 'tg-', type: 'telegramAction', canvasType: 'telegramAction' },
+    { prefix: 'wa-', type: 'whatsappAction', canvasType: 'whatsappAction' },
+    { 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: 'jr-', type: 'jiraAction', canvasType: 'jiraAction' },
+    { prefix: 'bkt-', type: 'bucketAction', canvasType: 'bucketAction' },
+    { prefix: 'gc-', type: 'googleContactsAction', canvasType: 'googleContactsAction' },
+    { prefix: 'gaa-', type: 'googleAnalyticsAction', canvasType: 'googleAnalyticsAction' },
+    { prefix: 'ntn-', type: 'notionAction', canvasType: 'notionAction' },
+    { prefix: 'ha-', type: 'httpAction', canvasType: 'httpAction' },
+    { prefix: 'ma-', type: 'mongoAction', canvasType: 'mongoAction' },
+    { prefix: 'pg-', type: 'postgresAction', canvasType: 'postgresAction' },
+    { prefix: 'na-', type: 'notificationAction', canvasType: 'notificationAction' },
+    { prefix: 'ro-', type: 'router', canvasType: 'router' },
+    { prefix: 'fi-', type: 'filter', canvasType: 'filter' },
+    { prefix: 'tr-', type: 'transform', canvasType: 'transform' },
+    { prefix: 'sv-', type: 'schemaValidator', canvasType: 'schemaValidator' },
+    { prefix: 'delay-', type: 'delay', canvasType: 'delay' },
+    { prefix: 'sheet-', type: 'sheetsAction', canvasType: 'sheetsAction' },
+    { prefix: 'cal-', type: 'calendarAction', canvasType: 'calendarAction' },
+    { prefix: 'appr-', type: 'approval', canvasType: 'approval' },
+    { prefix: 'merge-', type: 'merge', canvasType: 'merge' },
+    { prefix: 'cond-', type: 'conditional', canvasType: 'conditional' },
+    { prefix: 'rl-', type: 'rateLimiter', canvasType: 'rateLimiter' },
+    { prefix: 'agg-', type: 'aggregator', canvasType: 'aggregator' },
+    { prefix: 'cache-', type: 'cache', canvasType: 'cache' },
+    { prefix: 'code-', type: 'code', canvasType: 'code' },
+    { prefix: 'ai-', type: 'ai', canvasType: 'ai' },
+    { prefix: 'split-', type: 'split', canvasType: 'split' },
+    { prefix: 'loop-', type: 'loop', canvasType: 'loop' },
+    { prefix: 'md-', type: 'markdown', canvasType: 'markdown' },
+    { prefix: 'ft-', type: 'fileTransform', canvasType: 'fileTransform' },
+    { prefix: 'lim-', type: 'limit', canvasType: 'limit' },
+    { prefix: 'doc-', type: 'docsAction', canvasType: 'docsAction' },
+    { prefix: 'drv-', type: 'driveAction', canvasType: 'driveAction' },
+    { prefix: 'fc-', type: 'firecrawlAction', canvasType: 'firecrawlAction' },
+    { prefix: 'vs-', type: 'vectorStore', canvasType: 'vectorStore' },
+    { prefix: 'rssa-', type: 'rssAction', canvasType: 'rssAction' },
+    { prefix: 'sm-', type: 'socialMediaAction', canvasType: 'socialMediaAction' },
+    { prefix: 'note-', type: 'stickyNote', canvasType: 'stickyNote' },
+];
+/** Resolve canvas node ID to { type, entityId } */
+export function resolveNodeId(canvasId) {
+    // Sort by prefix length descending so longer prefixes match first
+    const sorted = [...PREFIX_TO_TYPE].sort((a, b) => b.prefix.length - a.prefix.length);
+    for (const { prefix, type } of sorted) {
+        if (canvasId.startsWith(prefix)) {
+            return { type, entityId: canvasId.slice(prefix.length) };
+        }
+    }
+    return null;
+}

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

@@ -0,0 +1,23 @@
+/**
+ * WhatsApp Business Cloud API operation enum — single source of truth
+ * across the API, Dashboard, and any future consumers (Message Broker,
+ * MCP server). Used by:
+ *   - whatsappAction entity / DTO (api): operation field + validation
+ *   - dashboard WhatsAppAction operation picker
+ *   - MCP toolkit-specs expansion (one aiEnabled whatsappAction → N tools)
+ *
+ * Targets Meta Cloud API v21+ (the only supported variant after the
+ * On-Premises sunset on 2025-10-23). Each op maps to a single POST to
+ * `https://graph.facebook.com/v21.0/<phone_number_id>/messages` with
+ * a different `type` discriminator in the body.
+ *
+ * Phase 1 covers the ten ops that handle ~95% of business messaging.
+ * Phase 2 candidates (sendInteractiveButtons, sendInteractiveList,
+ * sendSticker, sendContacts) extend this list — bump the package and
+ * re-install in consumers, same pattern as Gmail / Calendar / Drive
+ * / Telegram.
+ */
+export declare const WHATSAPP_OPERATIONS: readonly ["sendText", "sendImage", "sendAudio", "sendVideo", "sendDocument", "sendLocation", "sendTemplate", "replyToMessage", "markAsRead", "sendReaction"];
+export type WhatsAppOperation = (typeof WHATSAPP_OPERATIONS)[number];
+/** Type guard — useful when validating untrusted input (DTOs, tool calls). */
+export declare function isWhatsAppOperation(value: unknown): value is WhatsAppOperation;

package/dist/esm/whatsapp-operations.js

@@ -0,0 +1,36 @@
+/**
+ * WhatsApp Business Cloud API operation enum — single source of truth
+ * across the API, Dashboard, and any future consumers (Message Broker,
+ * MCP server). Used by:
+ *   - whatsappAction entity / DTO (api): operation field + validation
+ *   - dashboard WhatsAppAction operation picker
+ *   - MCP toolkit-specs expansion (one aiEnabled whatsappAction → N tools)
+ *
+ * Targets Meta Cloud API v21+ (the only supported variant after the
+ * On-Premises sunset on 2025-10-23). Each op maps to a single POST to
+ * `https://graph.facebook.com/v21.0/<phone_number_id>/messages` with
+ * a different `type` discriminator in the body.
+ *
+ * Phase 1 covers the ten ops that handle ~95% of business messaging.
+ * Phase 2 candidates (sendInteractiveButtons, sendInteractiveList,
+ * sendSticker, sendContacts) extend this list — bump the package and
+ * re-install in consumers, same pattern as Gmail / Calendar / Drive
+ * / Telegram.
+ */
+export const WHATSAPP_OPERATIONS = [
+    'sendText',
+    'sendImage',
+    'sendAudio',
+    'sendVideo',
+    'sendDocument',
+    'sendLocation',
+    'sendTemplate',
+    'replyToMessage',
+    'markAsRead',
+    'sendReaction',
+];
+/** Type guard — useful when validating untrusted input (DTOs, tool calls). */
+export function isWhatsAppOperation(value) {
+    return (typeof value === 'string' &&
+        WHATSAPP_OPERATIONS.includes(value));
+}

package/dist/index.d.ts

@@ -1,66 +1,68 @@
-export type { NodeType, NodeRole, HandlePosition, NodeConnectionConfig, NodeUIConfig, NodeDispatchConfig, PrefixMapping, PayloadMeta, } from './types';
-export { singleMeta, iterableMeta } from './types';
-export { NODE_CONNECTIONS, canReceiveFrom, canReceiveFromNodes, canSendToNodes, isTerminal, isNodeType, ALL_NODE_TYPES, } from './connections';
-export { NODE_UI, PREFIX_TO_TYPE, resolveNodeId, } from './ui';
-export { NODE_DISPATCH, getAllNodeCollections, getNodeDispatchConfig, } from './dispatch';
-export type { NodeRegistryEntry, NodeGroup, NodeVersionSpec, VersionCatalog, } from './registry';
-export { NODE_REGISTRY, getNodeRegistryEntry, NODE_DETAIL_PATHS, NODE_COLORS, NODE_STATE_KEYS, PREFIX_TO_NODE_TYPE, NODE_TYPE_TO_PREFIX, } from './registry';
-export { isVersioned, versionsOf, versionSpec, currentVersion, fieldsLostBetween, fieldsLost, versionCatalogErrors, } from './registry';
-export { GMAIL_OPERATIONS, GMAIL_OPERATION_SPECS, GMAIL_OPERATION_GROUPS, GMAIL_DROPDOWN_OPERATIONS, GMAIL_TOOLKIT_OPERATIONS, GMAIL_TOOLKIT_SPECS, GMAIL_ALL_TOOLKIT_SPECS, GMAIL_SEND_AND_WAIT_TOOL_SPEC, NATIVE_EMAIL_TOOLKIT_SPECS, GMAIL_TOOLKIT_BY_TOOL_NAME, NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME, GMAIL_SEND_LEGACY_FIELDS, resolveGmailSendFields, isGmailOperation, } from './gmail-operations';
-export type { GmailOperation, GmailOperationGroup, GmailParamType, GmailParamSpec, GmailOperationSpec, GmailToolkitParameter, GmailToolkitSpec, GmailSendFieldSource, GmailSendFields, } from './gmail-operations';
-export { GOOGLE_CALENDAR_OPERATIONS, GOOGLE_CALENDAR_OPERATION_SPECS, isGoogleCalendarOperation, } from './calendar-operations';
-export type { GoogleCalendarOperation, GoogleCalendarParamTarget, GoogleCalendarParamType, GoogleCalendarParamSpec, GoogleCalendarOperationSpec, } from './calendar-operations';
-export { GOOGLE_CALENDAR_TOOLKIT_SPECS, GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME, } from './calendar-toolkit';
-export type { GoogleCalendarToolkitSpec, GoogleCalendarToolkitParameter, } from './calendar-toolkit';
-export { DRIVE_OPERATIONS, DRIVE_OPERATION_SPECS, isDriveOperation, } from './drive-operations';
-export type { DriveOperation, DriveParamType, DriveParamSpec, DriveOperationSpec, } from './drive-operations';
-export { DRIVE_TOOLKIT_SPECS, DRIVE_TOOLKIT_BY_TOOL_NAME, } from './drive-toolkit';
-export type { DriveToolkitSpec, DriveToolkitParameter, } from './drive-toolkit';
-export { TELEGRAM_OPERATIONS, TELEGRAM_OPERATION_SPECS, isTelegramOperation, } from './telegram-operations';
-export type { TelegramOperation, TelegramParamSpec, TelegramOperationSpec, } from './telegram-operations';
-export { TELEGRAM_TOOLKIT_SPECS, TELEGRAM_TOOLKIT_BY_TOOL_NAME, } from './telegram-toolkit';
-export type { TelegramToolkitSpec, TelegramToolkitParameter, } from './telegram-toolkit';
-export { WHATSAPP_OPERATIONS, isWhatsAppOperation, } from './whatsapp-operations';
-export type { WhatsAppOperation } from './whatsapp-operations';
-export { operacionesPara, puedeEjecutar, camposNoDisponiblesPara, } from './capacidad-de-credencial';
-export type { CapacidadDeCredencial, CapacidadesPorCredencial, } from './capacidad-de-credencial';
-export { DISCORD_OPERATIONS, DISCORD_OPERATION_SPECS, DISCORD_CAPACIDADES_POR_CREDENCIAL, operacionesDeDiscordPara, discordPuedeEjecutar, camposDeDiscordNoDisponibles, isDiscordOperation, } from './discord-operations';
-export type { DiscordOperation, DiscordParamSpec, DiscordOperationSpec, } from './discord-operations';
-export { DISCORD_TOOLKIT_SPECS, DISCORD_TOOLKIT_BY_TOOL_NAME, herramientasDeDiscordPara, } from './discord-toolkit';
-export type { DiscordToolkitSpec, DiscordToolkitParameter, } from './discord-toolkit';
-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 { JIRA_OPERATIONS, JIRA_OPERATION_SPECS, JIRA_DROPDOWN_OPERATIONS, JIRA_ITERABLE_OPERATIONS, isJiraOperation, } from './jira-operations';
-export type { JiraOperation, JiraParamType, JiraParamSpec, JiraOperationSpec, } from './jira-operations';
-export { SLACK_OPERATIONS, SLACK_OPERATION_SPECS, SLACK_CAPACIDADES_POR_CREDENCIAL, operacionesDeSlackPara, slackPuedeEjecutar, camposDeSlackNoDisponibles, isSlackOperation, } from './slack-operations';
-export type { SlackOperation, SlackParamSpec, SlackOperationSpec, } from './slack-operations';
-export { SLACK_TOOLKIT_SPECS, SLACK_TOOLKIT_BY_TOOL_NAME, herramientasDeSlackPara, } from './slack-toolkit';
-export type { SlackToolkitSpec, SlackToolkitParameter, } from './slack-toolkit';
-export { SHEETS_OPERATIONS, SHEETS_OPERATION_SPECS, isSheetsOperation, } from './sheets-operations';
-export type { SheetsOperation, SheetsParamSpec, SheetsOperationSpec, } from './sheets-operations';
-export { SHEETS_TOOLKIT_SPECS, SHEETS_TOOLKIT_BY_TOOL_NAME, SHEETS_TOOLKIT_DEFAULTABLE, } from './sheets-toolkit';
-export type { SheetsToolkitSpec, SheetsToolkitParameter, } from './sheets-toolkit';
-export { GOOGLE_CONTACTS_OPERATIONS, GOOGLE_CONTACTS_OPERATIONS_V1, GOOGLE_CONTACTS_OPERATIONS_V2, GOOGLE_CONTACTS_OPERATION_SPECS, GOOGLE_CONTACTS_OPERATION_GROUPS, GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS, isGoogleContactsOperation, } from './google-contacts-operations';
-export type { GoogleContactsOperation, GoogleContactsParamSpec, GoogleContactsOperationSpec, GoogleContactsOperationGroup, } from './google-contacts-operations';
-export { GOOGLE_ANALYTICS_OPERATIONS, GOOGLE_ANALYTICS_OPERATION_SPECS, GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS, isGoogleAnalyticsOperation, } from './google-analytics-operations';
-export type { GoogleAnalyticsOperation, GoogleAnalyticsParamType, GoogleAnalyticsParamSpec, GoogleAnalyticsOperationSpec, } from './google-analytics-operations';
-export { NOTION_OPERATIONS, NOTION_OPERATION_SPECS, NOTION_DROPDOWN_OPERATIONS, isNotionOperation, } from './notion-operations';
-export type { NotionOperation, NotionParamType, NotionParamSpec, NotionOperationSpec, } from './notion-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 { DOCS_OPERATIONS, DOCS_OPERATION_SPECS, isDocsOperation, } from './docs-operations';
-export type { DocsOperation, DocsParamType, DocsParamSlot, DocsParamSpec, DocsOperationSpec, } from './docs-operations';
-export { DOCS_TOOLKIT_SPECS, DOCS_TOOLKIT_BY_TOOL_NAME, DOCS_TOOLKIT_DEFAULTABLE, } from './docs-toolkit';
-export type { DocsToolkitSpec, DocsToolkitParameter, } from './docs-toolkit';
-export type { LlmProvider, LlmProviderOption, LlmModelOption, } from './llm-models';
-export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models';
-export type { ModeloDeOpenRouter, PrecioDeOpenRouter, RespuestaDeModelosDeOpenRouter, } from './openrouter';
-export { URL_DE_MODELOS_DE_OPENROUTER, opcionesDeModelosDeOpenRouter, ventanaDeContextoDeOpenRouter, } from './openrouter';
-export type { CredentialTypeRegistration, CredentialType } from './credentials';
-export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials';
+export type { NodeType, NodeRole, HandlePosition, NodeConnectionConfig, NodeUIConfig, NodeDispatchConfig, PrefixMapping, PayloadMeta, } from './types.js';
+export { singleMeta, iterableMeta } from './types.js';
+export { NODE_CONNECTIONS, canReceiveFrom, canReceiveFromNodes, canSendToNodes, isTerminal, isNodeType, ALL_NODE_TYPES, } from './connections.js';
+export { NODE_UI, PREFIX_TO_TYPE, resolveNodeId, } from './ui.js';
+export { NODE_DISPATCH, getAllNodeCollections, getNodeDispatchConfig, } from './dispatch.js';
+export type { NodeRegistryEntry, NodeGroup, NodeVersionSpec, VersionCatalog, } from './registry.js';
+export { NODE_REGISTRY, getNodeRegistryEntry, NODE_DETAIL_PATHS, NODE_COLORS, NODE_STATE_KEYS, PREFIX_TO_NODE_TYPE, NODE_TYPE_TO_PREFIX, } from './registry.js';
+export { isVersioned, versionsOf, versionSpec, currentVersion, fieldsLostBetween, fieldsLost, versionCatalogErrors, } from './registry.js';
+export { GMAIL_OPERATIONS, GMAIL_OPERATION_SPECS, GMAIL_OPERATION_GROUPS, GMAIL_DROPDOWN_OPERATIONS, GMAIL_TOOLKIT_OPERATIONS, GMAIL_TOOLKIT_SPECS, GMAIL_ALL_TOOLKIT_SPECS, GMAIL_SEND_AND_WAIT_TOOL_SPEC, NATIVE_EMAIL_TOOLKIT_SPECS, GMAIL_TOOLKIT_BY_TOOL_NAME, NATIVE_EMAIL_TOOLKIT_BY_TOOL_NAME, GMAIL_SEND_LEGACY_FIELDS, resolveGmailSendFields, isGmailOperation, } from './gmail-operations.js';
+export type { GmailOperation, GmailOperationGroup, GmailParamType, GmailParamSpec, GmailOperationSpec, GmailToolkitParameter, GmailToolkitSpec, GmailSendFieldSource, GmailSendFields, } from './gmail-operations.js';
+export { GOOGLE_CALENDAR_OPERATIONS, GOOGLE_CALENDAR_OPERATION_SPECS, isGoogleCalendarOperation, } from './calendar-operations.js';
+export type { GoogleCalendarOperation, GoogleCalendarParamTarget, GoogleCalendarParamType, GoogleCalendarParamSpec, GoogleCalendarOperationSpec, } from './calendar-operations.js';
+export { GOOGLE_CALENDAR_TOOLKIT_SPECS, GOOGLE_CALENDAR_TOOLKIT_BY_TOOL_NAME, } from './calendar-toolkit.js';
+export type { GoogleCalendarToolkitSpec, GoogleCalendarToolkitParameter, } from './calendar-toolkit.js';
+export { DRIVE_OPERATIONS, DRIVE_OPERATION_SPECS, isDriveOperation, } from './drive-operations.js';
+export type { DriveOperation, DriveParamType, DriveParamSpec, DriveOperationSpec, } from './drive-operations.js';
+export { DRIVE_TOOLKIT_SPECS, DRIVE_TOOLKIT_BY_TOOL_NAME, } from './drive-toolkit.js';
+export type { DriveToolkitSpec, DriveToolkitParameter, } from './drive-toolkit.js';
+export { TELEGRAM_OPERATIONS, TELEGRAM_OPERATION_SPECS, isTelegramOperation, } from './telegram-operations.js';
+export type { TelegramOperation, TelegramParamSpec, TelegramOperationSpec, } from './telegram-operations.js';
+export { TELEGRAM_TOOLKIT_SPECS, TELEGRAM_TOOLKIT_BY_TOOL_NAME, } from './telegram-toolkit.js';
+export type { TelegramToolkitSpec, TelegramToolkitParameter, } from './telegram-toolkit.js';
+export { WHATSAPP_OPERATIONS, isWhatsAppOperation, } from './whatsapp-operations.js';
+export type { WhatsAppOperation } from './whatsapp-operations.js';
+export { operacionesPara, puedeEjecutar, camposNoDisponiblesPara, } from './capacidad-de-credencial.js';
+export type { CapacidadDeCredencial, CapacidadesPorCredencial, } from './capacidad-de-credencial.js';
+export { DISCORD_OPERATIONS, DISCORD_OPERATION_SPECS, DISCORD_CAPACIDADES_POR_CREDENCIAL, operacionesDeDiscordPara, discordPuedeEjecutar, camposDeDiscordNoDisponibles, isDiscordOperation, } from './discord-operations.js';
+export type { DiscordOperation, DiscordParamSpec, DiscordOperationSpec, } from './discord-operations.js';
+export { DISCORD_TOOLKIT_SPECS, DISCORD_TOOLKIT_BY_TOOL_NAME, herramientasDeDiscordPara, } from './discord-toolkit.js';
+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 { 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';
+export type { JiraOperation, JiraParamType, JiraParamSpec, JiraOperationSpec, } from './jira-operations.js';
+export { BUCKET_OPERATIONS, BUCKET_OPERATION_SPECS, BUCKET_ITERABLE_OPERATIONS, isBucketOperation, } from './bucket-operations.js';
+export type { BucketOperation, BucketParamType, BucketParamSpec, BucketOperationSpec, } from './bucket-operations.js';
+export { SLACK_OPERATIONS, SLACK_OPERATION_SPECS, SLACK_CAPACIDADES_POR_CREDENCIAL, operacionesDeSlackPara, slackPuedeEjecutar, camposDeSlackNoDisponibles, isSlackOperation, } from './slack-operations.js';
+export type { SlackOperation, SlackParamSpec, SlackOperationSpec, } from './slack-operations.js';
+export { SLACK_TOOLKIT_SPECS, SLACK_TOOLKIT_BY_TOOL_NAME, herramientasDeSlackPara, } from './slack-toolkit.js';
+export type { SlackToolkitSpec, SlackToolkitParameter, } from './slack-toolkit.js';
+export { SHEETS_OPERATIONS, SHEETS_OPERATION_SPECS, isSheetsOperation, } from './sheets-operations.js';
+export type { SheetsOperation, SheetsParamSpec, SheetsOperationSpec, } from './sheets-operations.js';
+export { SHEETS_TOOLKIT_SPECS, SHEETS_TOOLKIT_BY_TOOL_NAME, SHEETS_TOOLKIT_DEFAULTABLE, } from './sheets-toolkit.js';
+export type { SheetsToolkitSpec, SheetsToolkitParameter, } from './sheets-toolkit.js';
+export { GOOGLE_CONTACTS_OPERATIONS, GOOGLE_CONTACTS_OPERATIONS_V1, GOOGLE_CONTACTS_OPERATIONS_V2, GOOGLE_CONTACTS_OPERATION_SPECS, GOOGLE_CONTACTS_OPERATION_GROUPS, GOOGLE_CONTACTS_DEFAULT_PERSON_FIELDS, isGoogleContactsOperation, } from './google-contacts-operations.js';
+export type { GoogleContactsOperation, GoogleContactsParamSpec, GoogleContactsOperationSpec, GoogleContactsOperationGroup, } from './google-contacts-operations.js';
+export { GOOGLE_ANALYTICS_OPERATIONS, GOOGLE_ANALYTICS_OPERATION_SPECS, GOOGLE_ANALYTICS_DROPDOWN_OPERATIONS, isGoogleAnalyticsOperation, } from './google-analytics-operations.js';
+export type { GoogleAnalyticsOperation, GoogleAnalyticsParamType, GoogleAnalyticsParamSpec, GoogleAnalyticsOperationSpec, } from './google-analytics-operations.js';
+export { NOTION_OPERATIONS, NOTION_OPERATION_SPECS, NOTION_DROPDOWN_OPERATIONS, isNotionOperation, } from './notion-operations.js';
+export type { NotionOperation, NotionParamType, NotionParamSpec, NotionOperationSpec, } from './notion-operations.js';
+export { POSTGRES_OPERATIONS, POSTGRES_MODES, POSTGRES_OPERATION_SPECS, isPostgresOperation, } from './postgres-operations.js';
+export type { PostgresOperation, PostgresMode, PostgresOperationSpec, } from './postgres-operations.js';
+export { MONGO_OPERATIONS, MONGO_OPERATION_SPECS, isMongoOperation, } from './mongo-operations.js';
+export type { MongoOperation, MongoParamType, MongoParamSpec, MongoOperationSpec, } from './mongo-operations.js';
+export { DOCS_OPERATIONS, DOCS_OPERATION_SPECS, isDocsOperation, } from './docs-operations.js';
+export type { DocsOperation, DocsParamType, DocsParamSlot, DocsParamSpec, DocsOperationSpec, } from './docs-operations.js';
+export { DOCS_TOOLKIT_SPECS, DOCS_TOOLKIT_BY_TOOL_NAME, DOCS_TOOLKIT_DEFAULTABLE, } from './docs-toolkit.js';
+export type { DocsToolkitSpec, DocsToolkitParameter, } from './docs-toolkit.js';
+export type { LlmProvider, LlmProviderOption, LlmModelOption, } from './llm-models.js';
+export { LLM_PROVIDERS, LLM_MODELS, MODEL_CONTEXT_WINDOWS, getModelsFor, getDefaultModel, getModelLabel, } from './llm-models.js';
+export type { ModeloDeOpenRouter, PrecioDeOpenRouter, RespuestaDeModelosDeOpenRouter, } from './openrouter.js';
+export { URL_DE_MODELOS_DE_OPENROUTER, opcionesDeModelosDeOpenRouter, ventanaDeContextoDeOpenRouter, } from './openrouter.js';
+export type { CredentialTypeRegistration, CredentialType } from './credentials.js';
+export { CREDENTIAL_TYPES, CREDENTIAL_TYPE_VALUES, credentialTypeValues, getCredentialType, isCredentialType, } from './credentials.js';