@trii/types 2.10.730 → 2.10.732

package/dist/Events/DomainEventTypes.d.ts

@@ -9,39 +9,39 @@
  */
 export declare const DOMAIN_EVENT_TYPES: {
     readonly AUTOMATIONS: {
-        readonly MANUAL: 'automations.manual';
-        readonly SCHEDULE_TICK: 'automations.schedule.tick';
+        readonly MANUAL: "automations.manual";
+        readonly SCHEDULE_TICK: "automations.schedule.tick";
     };
     readonly CONTACTS: {
-        readonly CONTACT_CREATED: 'contacts.contact.created';
-        readonly BUSINESS_CREATED: 'contacts.business.created';
-        readonly PROPERTY_CHANGED: 'contacts.property.changed';
-        readonly TAG_ADDED: 'contacts.tag.added';
-        readonly TAG_REMOVED: 'contacts.tag.removed';
-        readonly PROPERTY_DATE_REACHED: 'contacts.property.date_reached';
+        readonly CONTACT_CREATED: "contacts.contact.created";
+        readonly BUSINESS_CREATED: "contacts.business.created";
+        readonly PROPERTY_CHANGED: "contacts.property.changed";
+        readonly TAG_ADDED: "contacts.tag.added";
+        readonly TAG_REMOVED: "contacts.tag.removed";
+        readonly PROPERTY_DATE_REACHED: "contacts.property.date_reached";
     };
     readonly CONVERSATIONS: {
-        readonly CONVERSATION_CREATED: 'conversations.conversation.created';
-        readonly CONVERSATION_CLOSED: 'conversations.conversation.closed';
-        readonly MESSAGE_RECEIVED: 'conversations.message.received';
-        readonly AGENT_INTERVENED: 'conversations.agent.intervened';
+        readonly CONVERSATION_CREATED: "conversations.conversation.created";
+        readonly CONVERSATION_CLOSED: "conversations.conversation.closed";
+        readonly MESSAGE_RECEIVED: "conversations.message.received";
+        readonly AGENT_INTERVENED: "conversations.agent.intervened";
     };
     readonly TICKETS: {
-        readonly CREATED: 'tickets.created';
-        readonly STATUS_CHANGED: 'tickets.status_changed';
-        readonly PRIORITY_CHANGED: 'tickets.priority_changed';
-        readonly ASSIGNED: 'tickets.assigned';
-        readonly CUSTOMER_REPLIED: 'tickets.customer_replied';
-        readonly SLA_WARNING: 'tickets.sla_warning';
-        readonly SLA_BREACHED: 'tickets.sla_breached';
-        readonly CLOSED: 'tickets.closed';
-        readonly REOPENED: 'tickets.reopened';
+        readonly CREATED: "tickets.created";
+        readonly STATUS_CHANGED: "tickets.status_changed";
+        readonly PRIORITY_CHANGED: "tickets.priority_changed";
+        readonly ASSIGNED: "tickets.assigned";
+        readonly CUSTOMER_REPLIED: "tickets.customer_replied";
+        readonly SLA_WARNING: "tickets.sla_warning";
+        readonly SLA_BREACHED: "tickets.sla_breached";
+        readonly CLOSED: "tickets.closed";
+        readonly REOPENED: "tickets.reopened";
     };
     readonly FORMS: {
-        readonly SUBMITTED: 'forms.submitted';
+        readonly SUBMITTED: "forms.submitted";
     };
     readonly INTEGRATIONS: {
-        readonly WEBHOOK_RECEIVED: 'integrations.webhook.received';
+        readonly WEBHOOK_RECEIVED: "integrations.webhook.received";
     };
 };
 type Values<T> = T extends unknown ? T[keyof T] : never;

package/dist/index.js

@@ -15,23 +15,13 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Automations = exports.Forms = exports.APIResponses = exports.Shop = exports.AI = exports.APIKeys = exports.Events = exports.EventsQueue = exports.ApiResponses = exports.Presence = exports.Users = exports.Collections = exports.Sales = exports.Tickets = exports.Spaces = exports.Reports = exports.Security = exports.Calls = exports.Conversations = exports.Calendar = exports.Contacts = exports.Common = exports.AuditLogs = exports.Accounts = void 0;
 exports.Accounts = __importStar(require("./Accounts/index"));

package/dist/src/Automations/Capabilities/Capability.d.ts

@@ -0,0 +1,81 @@
+import { AutomationError, AutomationJsonObject, AutomationJsonSchema, AutomationSourceApplication } from '../Common';
+export declare enum AutomationCapabilityKind {
+    TRIGGER = "trigger",
+    ACTION = "action",
+    CONDITION = "condition"
+}
+export declare enum AutomationCapabilityEffectClass {
+    NONE = "none",
+    READ = "read",
+    WRITE = "write",
+    COMMUNICATION = "communication",
+    BULK = "bulk"
+}
+export declare enum AutomationCapabilityIdempotency {
+    NONE = "none",
+    SUPPORTED = "supported",
+    REQUIRED = "required"
+}
+/** Capacidades operativas que el runtime puede aplicar de forma confiable. */
+export interface AutomationCapabilityExecutionSupport {
+    effectClass: AutomationCapabilityEffectClass;
+    supportsSimulation: boolean;
+    supportsTestTargets: boolean;
+    supportsUntilNode: boolean;
+    supportsFromNode: boolean;
+    supportsNodeOnly: boolean;
+    supportsCancellation: boolean;
+    idempotency: AutomationCapabilityIdempotency;
+    defaultTimeoutMs?: number | null;
+    maxAttempts?: number | null;
+    maxTestItems?: number | null;
+    inputSchema?: AutomationJsonSchema | null;
+    outputSchema?: AutomationJsonSchema | null;
+    simulationOutputSchema?: AutomationJsonSchema | null;
+    sensitivePaths?: string[] | null;
+    requiredPermissions?: string[] | null;
+}
+/**
+ * Capacidad publicada por una aplicación de negocio para que Automation pueda
+ * descubrirla y representarla sin incorporar reglas de ese dominio.
+ */
+export interface AutomationCapability {
+    code: string;
+    sourceApplication: AutomationSourceApplication;
+    kind: AutomationCapabilityKind;
+    name: string;
+    description?: string | null;
+    inputSchema?: AutomationJsonSchema | null;
+    outputSchema?: AutomationJsonSchema | null;
+    requiredPermissions: string[];
+    enabled: boolean;
+    version: number;
+    /** Metadata opcional para definitions anteriores a la política de ejecución. */
+    executionSupport?: AutomationCapabilityExecutionSupport | null;
+}
+export interface AutomationCapabilityQuery {
+    sourceApplications?: AutomationSourceApplication[];
+    kinds?: AutomationCapabilityKind[];
+    enabledOnly?: boolean;
+    version?: number;
+}
+export interface AutomationCapabilityReference {
+    code: string;
+    version: number;
+    sourceApplication: AutomationSourceApplication;
+}
+export interface AutomationCapabilityInvocation {
+    invocationId: string;
+    executionId: string;
+    nodeId: string;
+    capability: AutomationCapabilityReference;
+    input: AutomationJsonObject;
+    context: AutomationJsonObject;
+}
+export interface AutomationCapabilityResult {
+    invocationId: string;
+    success: boolean;
+    output?: AutomationJsonObject | null;
+    error?: AutomationError | null;
+    completedAt: string;
+}

package/dist/src/Automations/Capabilities/Capability.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationCapabilityIdempotency = exports.AutomationCapabilityEffectClass = exports.AutomationCapabilityKind = void 0;
+var AutomationCapabilityKind;
+(function (AutomationCapabilityKind) {
+    AutomationCapabilityKind["TRIGGER"] = "trigger";
+    AutomationCapabilityKind["ACTION"] = "action";
+    AutomationCapabilityKind["CONDITION"] = "condition";
+})(AutomationCapabilityKind || (exports.AutomationCapabilityKind = AutomationCapabilityKind = {}));
+var AutomationCapabilityEffectClass;
+(function (AutomationCapabilityEffectClass) {
+    AutomationCapabilityEffectClass["NONE"] = "none";
+    AutomationCapabilityEffectClass["READ"] = "read";
+    AutomationCapabilityEffectClass["WRITE"] = "write";
+    AutomationCapabilityEffectClass["COMMUNICATION"] = "communication";
+    AutomationCapabilityEffectClass["BULK"] = "bulk";
+})(AutomationCapabilityEffectClass || (exports.AutomationCapabilityEffectClass = AutomationCapabilityEffectClass = {}));
+var AutomationCapabilityIdempotency;
+(function (AutomationCapabilityIdempotency) {
+    AutomationCapabilityIdempotency["NONE"] = "none";
+    AutomationCapabilityIdempotency["SUPPORTED"] = "supported";
+    AutomationCapabilityIdempotency["REQUIRED"] = "required";
+})(AutomationCapabilityIdempotency || (exports.AutomationCapabilityIdempotency = AutomationCapabilityIdempotency = {}));

package/dist/src/Automations/Capabilities/index.d.ts

@@ -0,0 +1 @@
+export * from './Capability';

package/dist/src/Automations/Capabilities/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Capability"), exports);

package/dist/src/Automations/Common.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Aplicación propietaria del evento o capacidad consumida por Automation.
+ *
+ * Los valores forman parte del contrato HTTP/event-driven y no deben
+ * 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[];
+/** Objeto JSON transportable entre aplicaciones y Automation. */
+export interface AutomationJsonObject {
+    [key: string]: AutomationJsonValue;
+}
+/**
+ * Schema JSON deliberadamente abierto. Cada aplicación es propietaria de la
+ * validación del schema que publica en su catálogo de capacidades.
+ */
+export interface AutomationJsonSchema extends AutomationJsonObject {
+    type?: string;
+    title?: string;
+    description?: string;
+    required?: string[];
+    properties?: {
+        [key: string]: AutomationJsonSchema;
+    };
+}
+export interface AutomationPageRequest {
+    skip: number;
+    limit: number;
+}
+export interface AutomationPagedResult<T> {
+    items: T[];
+    total: number;
+    skip: number;
+    limit: number;
+}
+export interface AutomationError {
+    code: string;
+    message: string;
+    details?: AutomationJsonObject | null;
+}
+/** Referencia estable con la identidad visible al iniciar una ejecución. */
+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
+ * empresa sin depender de los contratos internos del módulo Contacts.
+ */
+export interface AutomationCustomer {
+    contact?: AutomationCustomerReference | null;
+    business?: AutomationCustomerReference | null;
+}

package/dist/src/Automations/Common.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationSourceApplication = void 0;
+/**
+ * Aplicación propietaria del evento o capacidad consumida por Automation.
+ *
+ * Los valores forman parte del contrato HTTP/event-driven y no deben
+ * traducirse ni depender del nombre visible de la aplicación.
+ */
+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/src/Automations/Events/Event.d.ts

@@ -0,0 +1,69 @@
+import { AutomationCustomer, AutomationJsonObject, AutomationJsonSchema, AutomationResourceReference, AutomationSourceApplication } from '../Common';
+export interface AutomationEventDefinition {
+    eventType: string;
+    version: number;
+    sourceApplication: AutomationSourceApplication;
+    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;
+}
+export interface AutomationEventEnvelope {
+    id: string;
+    spaceId: string;
+    sourceApplication: AutomationSourceApplication;
+    eventType: string;
+    eventVersion: number;
+    occurredAt: string;
+    receivedAt: string;
+    customer?: AutomationCustomer | 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;
+    /** Motivo de exclusión; ausente cuando selected es true. */
+    exclusion?: AutomationEntryPointExclusion | null;
+}
+export interface ResolveFlowEntryPointsResult {
+    matches: ResolvedFlowEntryPoint[];
+}

package/dist/src/Automations/Events/Event.js

@@ -0,0 +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/src/Automations/Events/index.d.ts

@@ -0,0 +1 @@
+export * from './Event';

package/dist/src/Automations/Events/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./Event"), exports);