@trii/types 2.10.691 → 2.10.692

package/dist/Automations/Common.d.ts

@@ -5,11 +5,33 @@
  * traducirse ni depender del nombre visible de la aplicación.
  */
 export declare enum AutomationSourceApplication {
+    /** Automations y sus capacidades Core. */
+    AUTOMATIONS = "automations",
+    /** Gestión de conversaciones y mensajería conversacional. */
     CONVERSATIONS = "conversations",
+    /** Gestión de contactos y organizaciones. */
+    CONTACTS = "contacts",
+    /** Gestión de tickets y soporte. */
     TICKETS = "tickets",
+    /** Campañas y operaciones de marketing. */
     MARKETING = "marketing",
+    /** Procesos y oportunidades comerciales. */
     SALES = "sales",
+    /** Telefonía y llamadas. */
     CALLS = "calls",
+    /** Comunicaciones salientes como email y SMS. */
+    COMMUNICATIONS = "communications",
+    /** Formularios y captura estructurada de datos. */
+    FORMS = "forms",
+    /** Conectores e integraciones externas. */
+    INTEGRATIONS = "integrations",
+    /** Acceso y transformación de datos. */
+    DATA = "data",
+    /** Agentes, modelos y herramientas de inteligencia artificial. */
+    AI = "ai",
+    /** Bases de conocimiento, documentos y búsqueda semántica. */
+    KNOWLEDGE = "knowledge",
+    /** Propietario externo o no clasificado; no debe usarse como fallback. */
     GENERIC = "generic"
 }
 export type AutomationJsonValue = string | number | boolean | null | AutomationJsonObject | AutomationJsonValue[];
@@ -50,6 +72,17 @@ export interface AutomationCustomerReference {
     id: string;
     displayNameSnapshot?: string | null;
 }
+/** Referencia transversal a una entidad perteneciente a una aplicación. */
+export interface AutomationResourceReference {
+    /** Aplicación propietaria de la entidad. */
+    sourceApplication: AutomationSourceApplication;
+    /** Tipo estable dentro de la aplicación, por ejemplo ticket o campaign. */
+    resourceType: string;
+    /** Identificador en la aplicación propietaria. */
+    id: string;
+    /** Nombre informativo capturado al crear la referencia. */
+    displayNameSnapshot?: string | null;
+}
 /**
  * Contexto CRM opcional asociado a un evento o ejecución.
  * Permite representar escenarios B2C, B2B o un contacto perteneciente a una

package/dist/Automations/Common.js

@@ -9,10 +9,32 @@ exports.AutomationSourceApplication = void 0;
  */
 var AutomationSourceApplication;
 (function (AutomationSourceApplication) {
+    /** Automations y sus capacidades Core. */
+    AutomationSourceApplication["AUTOMATIONS"] = "automations";
+    /** Gestión de conversaciones y mensajería conversacional. */
     AutomationSourceApplication["CONVERSATIONS"] = "conversations";
+    /** Gestión de contactos y organizaciones. */
+    AutomationSourceApplication["CONTACTS"] = "contacts";
+    /** Gestión de tickets y soporte. */
     AutomationSourceApplication["TICKETS"] = "tickets";
+    /** Campañas y operaciones de marketing. */
     AutomationSourceApplication["MARKETING"] = "marketing";
+    /** Procesos y oportunidades comerciales. */
     AutomationSourceApplication["SALES"] = "sales";
+    /** Telefonía y llamadas. */
     AutomationSourceApplication["CALLS"] = "calls";
+    /** Comunicaciones salientes como email y SMS. */
+    AutomationSourceApplication["COMMUNICATIONS"] = "communications";
+    /** Formularios y captura estructurada de datos. */
+    AutomationSourceApplication["FORMS"] = "forms";
+    /** Conectores e integraciones externas. */
+    AutomationSourceApplication["INTEGRATIONS"] = "integrations";
+    /** Acceso y transformación de datos. */
+    AutomationSourceApplication["DATA"] = "data";
+    /** Agentes, modelos y herramientas de inteligencia artificial. */
+    AutomationSourceApplication["AI"] = "ai";
+    /** Bases de conocimiento, documentos y búsqueda semántica. */
+    AutomationSourceApplication["KNOWLEDGE"] = "knowledge";
+    /** Propietario externo o no clasificado; no debe usarse como fallback. */
     AutomationSourceApplication["GENERIC"] = "generic";
 })(AutomationSourceApplication || (exports.AutomationSourceApplication = AutomationSourceApplication = {}));

package/dist/Automations/Events/Event.d.ts

@@ -1,4 +1,4 @@
-import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationSourceApplication } from '../Common';
+import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationResourceReference, AutomationSourceApplication } from '../Common';
 export interface AutomationEventDefinition {
     eventType: string;
     version: number;
@@ -6,6 +6,7 @@ export interface AutomationEventDefinition {
     name: string;
     description?: string | null;
     payloadSchema: AutomationJsonSchema;
+    /** Schema de la vista del envelope cuyos paths pueden utilizarse en filtros. */
     filterSchema?: AutomationJsonSchema | null;
     requiredPermissions: string[];
     enabled: boolean;
@@ -19,23 +20,49 @@ export interface AutomationEventEnvelope {
     occurredAt: string;
     receivedAt: string;
     customer?: AutomationCustomer | null;
-    subjectId?: string | null;
+    /** Entidad principal sobre la que ocurrió el evento. */
+    subject?: AutomationResourceReference | null;
     correlationId?: string | null;
     causationId?: string | null;
     idempotencyKey?: string | null;
     payload: AutomationJsonObject;
     metadata?: AutomationJsonObject | null;
 }
+export declare enum AutomationEntryPointExclusionCode {
+    ENTRY_POINT_DISABLED = "entryPointDisabled",
+    SOURCE_APPLICATION_MISMATCH = "sourceApplicationMismatch",
+    EVENT_TYPE_MISMATCH = "eventTypeMismatch",
+    FILTERS_NOT_MATCHED = "filtersNotMatched",
+    FLOW_NOT_ACTIVE = "flowNotActive",
+    VERSION_NOT_PUBLISHED = "versionNotPublished",
+    LOWER_PRIORITY = "lowerPriority",
+    EXECUTION_MODE_RESTRICTED = "executionModeRestricted"
+}
+/** Motivo estructurado por el que un Entry Point no fue seleccionado. */
+export interface AutomationEntryPointExclusion {
+    /** Código estable para lógica, métricas y observabilidad. */
+    code: AutomationEntryPointExclusionCode;
+    /** Explicación humana opcional; no debe utilizarse para lógica. */
+    message?: string | null;
+    /** Datos diagnósticos específicos del código. */
+    details?: AutomationJsonObject | null;
+}
 export interface ResolveFlowEntryPointsRequest {
     event: AutomationEventEnvelope;
 }
 export interface ResolvedFlowEntryPoint {
+    /** Definición estable del Flow. */
     flowId: string;
+    /** Versión publicada candidata a recibir el evento. */
     flowVersionId: string;
+    /** Entry Point evaluado. */
     entryPointId: string;
+    /** Prioridad utilizada para resolver candidatos. */
     priority: number;
+    /** Indica si el candidato debe iniciar una ejecución. */
     selected: boolean;
-    exclusionReason?: string | null;
+    /** Motivo de exclusión; ausente cuando selected es true. */
+    exclusion?: AutomationEntryPointExclusion | null;
 }
 export interface ResolveFlowEntryPointsResult {
     matches: ResolvedFlowEntryPoint[];

package/dist/Automations/Events/Event.js

@@ -1,2 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationEntryPointExclusionCode = void 0;
+var AutomationEntryPointExclusionCode;
+(function (AutomationEntryPointExclusionCode) {
+    AutomationEntryPointExclusionCode["ENTRY_POINT_DISABLED"] = "entryPointDisabled";
+    AutomationEntryPointExclusionCode["SOURCE_APPLICATION_MISMATCH"] = "sourceApplicationMismatch";
+    AutomationEntryPointExclusionCode["EVENT_TYPE_MISMATCH"] = "eventTypeMismatch";
+    AutomationEntryPointExclusionCode["FILTERS_NOT_MATCHED"] = "filtersNotMatched";
+    AutomationEntryPointExclusionCode["FLOW_NOT_ACTIVE"] = "flowNotActive";
+    AutomationEntryPointExclusionCode["VERSION_NOT_PUBLISHED"] = "versionNotPublished";
+    AutomationEntryPointExclusionCode["LOWER_PRIORITY"] = "lowerPriority";
+    AutomationEntryPointExclusionCode["EXECUTION_MODE_RESTRICTED"] = "executionModeRestricted";
+})(AutomationEntryPointExclusionCode || (exports.AutomationEntryPointExclusionCode = AutomationEntryPointExclusionCode = {}));

package/dist/Automations/Executions/Execution.d.ts

@@ -1,4 +1,4 @@
-import { AutomationCustomer, AutomationError, AutomationJsonObject, AutomationPageRequest, AutomationSourceApplication } from '../Common';
+import { AutomationCustomer, AutomationError, AutomationJsonObject, AutomationPageRequest, AutomationResourceReference, AutomationSourceApplication } from '../Common';
 export declare enum AutomationExecutionStatus {
     QUEUED = "queued",
     RUNNING = "running",
@@ -21,11 +21,17 @@ export declare enum AutomationExecutionStepStatus {
  * Referencia genérica al evento que inició una ejecución.
  */
 export interface AutomationExecutionTrigger {
+    /** Entry Point que aceptó el evento. */
     entryPointId: string;
+    /** Aplicación propietaria del evento. */
     sourceApplication: AutomationSourceApplication;
+    /** Código estable del tipo de evento. */
     eventType: string;
-    referenceId?: string | null;
+    /** Entidad principal relacionada con el evento. */
+    reference?: AutomationResourceReference | null;
+    /** Instante informado por el productor. */
     occurredAt?: string | null;
+    /** Snapshot opcional del payload disparador. */
     payload?: AutomationJsonObject | null;
 }
 /** Identidad completa que debe persistir una ejecución transversal. */
@@ -35,6 +41,27 @@ export interface AutomationFlowExecutionReference {
     entryPointId: string;
     executionId: string;
 }
+/** Contexto que un caller puede aportar al iniciar una ejecución. */
+export interface AutomationExecutionContextInput {
+    /** Valores iniciales de variables declaradas por la versión del Flow. */
+    variables: AutomationJsonObject;
+    /** Extensiones agrupadas por módulo propietario. */
+    extensions: AutomationJsonObject;
+}
+/** Datos confiables establecidos exclusivamente por Automations. */
+export interface AutomationExecutionSystemContext {
+    /** Locale BCP 47, por ejemplo es-AR. */
+    locale?: string | null;
+    /** Zona horaria IANA utilizada por fechas y agendas. */
+    timeZone?: string | null;
+    /** Usuario, servicio o recurso que originó la ejecución. */
+    actor?: AutomationResourceReference | null;
+}
+/** Contexto persistido y utilizado durante una ejecución. */
+export interface AutomationExecutionContext extends AutomationExecutionContextInput {
+    /** Datos confiables agregados por el runtime. */
+    system: AutomationExecutionSystemContext;
+}
 export interface AutomationExecution {
     id: string;
     spaceId: string;
@@ -46,7 +73,8 @@ export interface AutomationExecution {
     customer?: AutomationCustomer | null;
     trigger: AutomationExecutionTrigger;
     input: AutomationJsonObject;
-    context: AutomationJsonObject;
+    /** Scope tipado y extensible utilizado durante la ejecución. */
+    context: AutomationExecutionContext;
     output?: AutomationJsonObject | null;
     error?: AutomationError | null;
     createdAt: string;
@@ -101,7 +129,8 @@ export interface StartAutomationExecutionRequest {
     customer?: AutomationCustomer | null;
     trigger: AutomationExecutionTrigger;
     input: AutomationJsonObject;
-    context: AutomationJsonObject;
+    /** Variables iniciales y extensiones aportadas por el caller. */
+    context: AutomationExecutionContextInput;
     idempotencyKey?: string | null;
     correlationId?: string | null;
     parentExecutionId?: string | null;

package/dist/Automations/Flows/Canvas.d.ts

@@ -1,4 +1,5 @@
-import { AutomationJsonObject, AutomationJsonValue } from '../Common';
+import { AutomationJsonObject, AutomationJsonSchema, AutomationJsonValue } from '../Common';
+import type { AutomationNodeVisibilityRule } from '../Nodes';
 export declare enum AutomationFlowVariableType {
     STRING = "string",
     NUMBER = "number",
@@ -32,7 +33,8 @@ export interface AutomationFlowVariable {
     type: AutomationFlowVariableType;
     isInput: boolean;
     isOutput: boolean;
-    schema?: AutomationJsonObject | null;
+    /** JSON Schema que restringe el valor permitido para la variable. */
+    schema?: AutomationJsonSchema | null;
     defaultValue?: AutomationJsonValue;
 }
 export interface AutomationFlowViewport {
@@ -96,6 +98,6 @@ export interface AutomationNodeHandle {
     multiple: boolean;
     showName: boolean;
     tags: string[];
-    showWhen?: AutomationJsonObject | null;
-    hideWhen?: AutomationJsonObject | null;
+    showWhen?: AutomationNodeVisibilityRule | null;
+    hideWhen?: AutomationNodeVisibilityRule | null;
 }

package/dist/Automations/Flows/Flow.d.ts

@@ -1,5 +1,5 @@
 import { AutomationCapabilityReference } from '../Capabilities';
-import { AutomationJsonObject, AutomationSourceApplication } from '../Common';
+import { AutomationJsonObject, AutomationJsonValue, AutomationSourceApplication } from '../Common';
 import { AutomationFlowEdge, AutomationCanvasAnnotation, AutomationFlowNode, AutomationFlowVariable, AutomationFlowViewport } from './Canvas';
 export declare enum AutomationFlowKind {
     CONVERSATIONAL = "conversational",
@@ -28,6 +28,48 @@ export declare enum FlowEntryPointExecutionMode {
     /** El solapamiento fue habilitado explícitamente. */
     MULTIPLE = "multiple"
 }
+export declare enum AutomationFilterLogicalOperator {
+    /** Todas las condiciones y grupos hijos deben cumplirse. */
+    ALL = "all",
+    /** Al menos una condición o grupo hijo debe cumplirse. */
+    ANY = "any"
+}
+export declare enum AutomationFilterOperator {
+    EQUALS = "equals",
+    NOT_EQUALS = "notEquals",
+    CONTAINS = "contains",
+    NOT_CONTAINS = "notContains",
+    STARTS_WITH = "startsWith",
+    ENDS_WITH = "endsWith",
+    GREATER_THAN = "greaterThan",
+    GREATER_THAN_OR_EQUAL = "greaterThanOrEqual",
+    LESS_THAN = "lessThan",
+    LESS_THAN_OR_EQUAL = "lessThanOrEqual",
+    IN = "in",
+    NOT_IN = "notIn",
+    EXISTS = "exists",
+    NOT_EXISTS = "notExists"
+}
+/** Comparación tipada aplicada a un campo de un evento. */
+export interface AutomationFilterCondition {
+    /** JSON Pointer RFC 6901 absoluto dentro del envelope. */
+    path: string;
+    /** Operación utilizada para comparar el campo. */
+    operator: AutomationFilterOperator;
+    /** Valor esperado; no aplica a exists/notExists. */
+    value?: AutomationJsonValue;
+    /** Sensibilidad de comparaciones de strings; por defecto es true. */
+    caseSensitive?: boolean | null;
+}
+/** Grupo recursivo de filtros combinados mediante all o any. */
+export interface AutomationFilterGroup {
+    /** Forma en que se combinan condiciones y grupos hijos. */
+    logicalOperator: AutomationFilterLogicalOperator;
+    /** Comparaciones directas pertenecientes al grupo. */
+    conditions: AutomationFilterCondition[];
+    /** Grupos anidados. */
+    groups: AutomationFilterGroup[];
+}
 /**
  * Identidad estable del Flow. El contenido ejecutable vive en FlowVersion.
  */
@@ -95,7 +137,8 @@ export interface FlowEntryPoint {
     sourceApplication: AutomationSourceApplication;
     eventType: string;
     triggerCapability?: AutomationCapabilityReference | null;
-    filters: AutomationJsonObject;
+    /** Grupo vacío acepta cualquier evento del tipo configurado. */
+    filters: AutomationFilterGroup;
     enabled: boolean;
     triggerNodeId: string;
     priority: number;

package/dist/Automations/Flows/Flow.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FlowEntryPointExecutionMode = exports.AutomationFlowVersionStatus = exports.AutomationFlowStatus = exports.AutomationFlowKind = void 0;
+exports.AutomationFilterOperator = exports.AutomationFilterLogicalOperator = exports.FlowEntryPointExecutionMode = exports.AutomationFlowVersionStatus = exports.AutomationFlowStatus = exports.AutomationFlowKind = void 0;
 var AutomationFlowKind;
 (function (AutomationFlowKind) {
     AutomationFlowKind["CONVERSATIONAL"] = "conversational";
@@ -32,3 +32,27 @@ var FlowEntryPointExecutionMode;
     /** El solapamiento fue habilitado explícitamente. */
     FlowEntryPointExecutionMode["MULTIPLE"] = "multiple";
 })(FlowEntryPointExecutionMode || (exports.FlowEntryPointExecutionMode = FlowEntryPointExecutionMode = {}));
+var AutomationFilterLogicalOperator;
+(function (AutomationFilterLogicalOperator) {
+    /** Todas las condiciones y grupos hijos deben cumplirse. */
+    AutomationFilterLogicalOperator["ALL"] = "all";
+    /** Al menos una condición o grupo hijo debe cumplirse. */
+    AutomationFilterLogicalOperator["ANY"] = "any";
+})(AutomationFilterLogicalOperator || (exports.AutomationFilterLogicalOperator = AutomationFilterLogicalOperator = {}));
+var AutomationFilterOperator;
+(function (AutomationFilterOperator) {
+    AutomationFilterOperator["EQUALS"] = "equals";
+    AutomationFilterOperator["NOT_EQUALS"] = "notEquals";
+    AutomationFilterOperator["CONTAINS"] = "contains";
+    AutomationFilterOperator["NOT_CONTAINS"] = "notContains";
+    AutomationFilterOperator["STARTS_WITH"] = "startsWith";
+    AutomationFilterOperator["ENDS_WITH"] = "endsWith";
+    AutomationFilterOperator["GREATER_THAN"] = "greaterThan";
+    AutomationFilterOperator["GREATER_THAN_OR_EQUAL"] = "greaterThanOrEqual";
+    AutomationFilterOperator["LESS_THAN"] = "lessThan";
+    AutomationFilterOperator["LESS_THAN_OR_EQUAL"] = "lessThanOrEqual";
+    AutomationFilterOperator["IN"] = "in";
+    AutomationFilterOperator["NOT_IN"] = "notIn";
+    AutomationFilterOperator["EXISTS"] = "exists";
+    AutomationFilterOperator["NOT_EXISTS"] = "notExists";
+})(AutomationFilterOperator || (exports.AutomationFilterOperator = AutomationFilterOperator = {}));

package/dist/Automations/Nodes/Node.d.ts

@@ -15,6 +15,37 @@ export declare enum AutomationNodePropertyEditor {
     ASYNC_OPTIONS = "asyncOptions",
     ASYNC_MULTI_OPTIONS = "asyncMultiOptions"
 }
+export declare enum AutomationNodeVisibilityLogicalOperator {
+    ALL = "all",
+    ANY = "any"
+}
+export declare enum AutomationNodeConditionOperator {
+    EQUALS = "equals"
+}
+export interface AutomationNodeCondition {
+    propertyId: string;
+    operator: AutomationNodeConditionOperator;
+    value?: AutomationJsonValue;
+}
+export interface AutomationNodeVisibilityRule {
+    logicalOperator: AutomationNodeVisibilityLogicalOperator;
+    conditions: AutomationNodeCondition[];
+}
+export interface AutomationNodePropertyUi {
+    tabId: string;
+    tabLabel: string;
+    order: number;
+    labelKey?: string | null;
+    placeholder?: string | null;
+    rows?: number | null;
+    numberMin?: number | null;
+    numberMax?: number | null;
+    step?: number | null;
+    acceptVariable?: boolean | null;
+    acceptEmojis?: boolean | null;
+    allowMaximizeInput?: boolean | null;
+    itemProperties: AutomationNodePropertyDefinition[];
+}
 export interface AutomationNodeDefinition {
     code: string;
     version: number;
@@ -44,9 +75,9 @@ export interface AutomationNodePropertyDefinition {
     schema?: AutomationJsonSchema | null;
     options: AutomationNodeOption[];
     optionsCapabilityCode?: string | null;
-    ui?: AutomationJsonObject | null;
-    showWhen?: AutomationJsonObject | null;
-    hideWhen?: AutomationJsonObject | null;
+    ui: AutomationNodePropertyUi;
+    showWhen?: AutomationNodeVisibilityRule | null;
+    hideWhen?: AutomationNodeVisibilityRule | null;
 }
 export interface AutomationNodeOption {
     id: string;

package/dist/Automations/Nodes/Node.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutomationNodePropertyEditor = void 0;
+exports.AutomationNodeConditionOperator = exports.AutomationNodeVisibilityLogicalOperator = exports.AutomationNodePropertyEditor = void 0;
 var AutomationNodePropertyEditor;
 (function (AutomationNodePropertyEditor) {
     AutomationNodePropertyEditor["STRING"] = "string";
@@ -16,3 +16,12 @@ var AutomationNodePropertyEditor;
     AutomationNodePropertyEditor["ASYNC_OPTIONS"] = "asyncOptions";
     AutomationNodePropertyEditor["ASYNC_MULTI_OPTIONS"] = "asyncMultiOptions";
 })(AutomationNodePropertyEditor || (exports.AutomationNodePropertyEditor = AutomationNodePropertyEditor = {}));
+var AutomationNodeVisibilityLogicalOperator;
+(function (AutomationNodeVisibilityLogicalOperator) {
+    AutomationNodeVisibilityLogicalOperator["ALL"] = "all";
+    AutomationNodeVisibilityLogicalOperator["ANY"] = "any";
+})(AutomationNodeVisibilityLogicalOperator || (exports.AutomationNodeVisibilityLogicalOperator = AutomationNodeVisibilityLogicalOperator = {}));
+var AutomationNodeConditionOperator;
+(function (AutomationNodeConditionOperator) {
+    AutomationNodeConditionOperator["EQUALS"] = "equals";
+})(AutomationNodeConditionOperator || (exports.AutomationNodeConditionOperator = AutomationNodeConditionOperator = {}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trii/types",
-  "version": "2.10.691",
+  "version": "2.10.692",
   "description": "Types definitions for Trii projects - ",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",