@trii/types 2.10.681 → 2.10.683

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

@@ -0,0 +1,28 @@
+import { AutomationJsonSchema, AutomationSourceApplication } from '../Common';
+export declare enum AutomationCapabilityKind {
+    TRIGGER = "trigger",
+    ACTION = "action",
+    CONDITION = "condition"
+}
+/**
+ * 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;
+}
+export interface AutomationCapabilityQuery {
+    sourceApplications?: AutomationSourceApplication[];
+    kinds?: AutomationCapabilityKind[];
+    enabledOnly?: boolean;
+    version?: number;
+}

package/dist/Automations/Capabilities/Capability.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationCapabilityKind = void 0;
+var AutomationCapabilityKind;
+(function (AutomationCapabilityKind) {
+    AutomationCapabilityKind["TRIGGER"] = "trigger";
+    AutomationCapabilityKind["ACTION"] = "action";
+    AutomationCapabilityKind["CONDITION"] = "condition";
+})(AutomationCapabilityKind || (exports.AutomationCapabilityKind = AutomationCapabilityKind = {}));

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

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

package/dist/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/Automations/Common.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 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 {
+    CONVERSATIONS = "conversations",
+    TICKETS = "tickets",
+    MARKETING = "marketing",
+    SALES = "sales",
+    CALLS = "calls",
+    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;
+    };
+}

package/dist/Automations/Common.js

@@ -0,0 +1,18 @@
+"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) {
+    AutomationSourceApplication["CONVERSATIONS"] = "conversations";
+    AutomationSourceApplication["TICKETS"] = "tickets";
+    AutomationSourceApplication["MARKETING"] = "marketing";
+    AutomationSourceApplication["SALES"] = "sales";
+    AutomationSourceApplication["CALLS"] = "calls";
+    AutomationSourceApplication["GENERIC"] = "generic";
+})(AutomationSourceApplication || (exports.AutomationSourceApplication = AutomationSourceApplication = {}));

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

@@ -0,0 +1,22 @@
+import { AutomationJsonObject, AutomationSourceApplication } from '../Common';
+/**
+ * Referencia genérica al evento que inició una ejecución.
+ *
+ * Este contrato convive inicialmente con
+ * Conversations.Flows.Workflows.FlowExecutionTrigger.
+ */
+export interface AutomationExecutionTrigger {
+    entryPointId: string;
+    sourceApplication: AutomationSourceApplication;
+    eventType: string;
+    referenceId?: string | null;
+    occurredAt?: string | null;
+    payload?: AutomationJsonObject | null;
+}
+/** Identidad completa que debe persistir una ejecución transversal. */
+export interface AutomationFlowExecutionReference {
+    flowId: string;
+    flowVersionId: string;
+    entryPointId: string;
+    executionId: string;
+}

package/dist/Automations/Executions/Execution.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

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

package/dist/Automations/Executions/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("./Execution"), exports);

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

@@ -0,0 +1,100 @@
+import { IFlowVariable, IReactFlowEdge, IReactFlowNode } from '../../Conversations/Flows/Flow';
+import { AutomationJsonObject, AutomationSourceApplication } from '../Common';
+export declare enum AutomationFlowKind {
+    CONVERSATIONAL = "conversational",
+    VOICE = "voice",
+    CAMPAIGN = "campaign",
+    SALES = "sales",
+    GENERIC = "generic"
+}
+export declare enum AutomationFlowStatus {
+    DRAFT = "draft",
+    ACTIVE = "active",
+    DISABLED = "disabled",
+    ARCHIVED = "archived"
+}
+export declare enum AutomationFlowVersionStatus {
+    DRAFT = "draft",
+    TESTING = "testing",
+    PUBLISHED = "published",
+    DEPRECATED = "deprecated"
+}
+export declare enum FlowEntryPointExecutionMode {
+    /** Un evento inicia como máximo una ejecución de esta versión del Flow. */
+    SINGLE = "single",
+    /** El solapamiento fue habilitado explícitamente. */
+    MULTIPLE = "multiple"
+}
+/**
+ * Identidad estable del Flow. El contenido ejecutable vive en FlowVersion.
+ */
+export interface AutomationFlowDefinition {
+    id: string;
+    spaceId: string;
+    name: string;
+    description?: string | null;
+    kind: AutomationFlowKind;
+    status: AutomationFlowStatus;
+    ownerId?: string | null;
+    tags: string[];
+    draftVersionId?: string | null;
+    activeVersionId?: string | null;
+    createdAt: string;
+    createdBy: string;
+    updatedAt?: string | null;
+    updatedBy?: string | null;
+    deletedAt?: string | null;
+}
+/**
+ * Snapshot del canvas.
+ *
+ * IFlowVariable/IReactFlowNode/IReactFlowEdge se reutilizan desde el contrato
+ * legado durante la transición. No deben incorporarse nuevas dependencias de
+ * Conversations en los contratos de dominio de Automation.
+ */
+export interface AutomationFlowCanvas {
+    variables: IFlowVariable[];
+    nodes: IReactFlowNode[];
+    edges: IReactFlowEdge[];
+    viewport: {
+        x: number;
+        y: number;
+        zoom: number;
+    };
+}
+/**
+ * Snapshot versionado e inmutable una vez publicado.
+ */
+export interface AutomationFlowVersion {
+    id: string;
+    flowId: string;
+    version: number;
+    schemaVersion: number;
+    status: AutomationFlowVersionStatus;
+    canvas: AutomationFlowCanvas;
+    entryPoints: FlowEntryPoint[];
+    createdAt: string;
+    createdBy: string;
+    publishedAt?: string | null;
+    publishedBy?: string | null;
+}
+/**
+ * Evento de entrada que puede iniciar una versión concreta de un Flow.
+ *
+ * La configuración autoritativa vive en esta entidad. El nodo trigger es su
+ * representación en el canvas y se vincula mediante triggerNodeId.
+ */
+export interface FlowEntryPoint {
+    id: string;
+    flowId: string;
+    flowVersionId: string;
+    name: string;
+    sourceApplication: AutomationSourceApplication;
+    eventType: string;
+    filters: AutomationJsonObject;
+    enabled: boolean;
+    triggerNodeId: string;
+    priority: number;
+    executionMode: FlowEntryPointExecutionMode;
+    metadata?: AutomationJsonObject | null;
+}

package/dist/Automations/Flows/Flow.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlowEntryPointExecutionMode = exports.AutomationFlowVersionStatus = exports.AutomationFlowStatus = exports.AutomationFlowKind = void 0;
+var AutomationFlowKind;
+(function (AutomationFlowKind) {
+    AutomationFlowKind["CONVERSATIONAL"] = "conversational";
+    AutomationFlowKind["VOICE"] = "voice";
+    AutomationFlowKind["CAMPAIGN"] = "campaign";
+    AutomationFlowKind["SALES"] = "sales";
+    AutomationFlowKind["GENERIC"] = "generic";
+})(AutomationFlowKind || (exports.AutomationFlowKind = AutomationFlowKind = {}));
+var AutomationFlowStatus;
+(function (AutomationFlowStatus) {
+    AutomationFlowStatus["DRAFT"] = "draft";
+    AutomationFlowStatus["ACTIVE"] = "active";
+    AutomationFlowStatus["DISABLED"] = "disabled";
+    AutomationFlowStatus["ARCHIVED"] = "archived";
+})(AutomationFlowStatus || (exports.AutomationFlowStatus = AutomationFlowStatus = {}));
+var AutomationFlowVersionStatus;
+(function (AutomationFlowVersionStatus) {
+    AutomationFlowVersionStatus["DRAFT"] = "draft";
+    AutomationFlowVersionStatus["TESTING"] = "testing";
+    AutomationFlowVersionStatus["PUBLISHED"] = "published";
+    AutomationFlowVersionStatus["DEPRECATED"] = "deprecated";
+})(AutomationFlowVersionStatus || (exports.AutomationFlowVersionStatus = AutomationFlowVersionStatus = {}));
+var FlowEntryPointExecutionMode;
+(function (FlowEntryPointExecutionMode) {
+    /** Un evento inicia como máximo una ejecución de esta versión del Flow. */
+    FlowEntryPointExecutionMode["SINGLE"] = "single";
+    /** El solapamiento fue habilitado explícitamente. */
+    FlowEntryPointExecutionMode["MULTIPLE"] = "multiple";
+})(FlowEntryPointExecutionMode || (exports.FlowEntryPointExecutionMode = FlowEntryPointExecutionMode = {}));

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

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

package/dist/Automations/Flows/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("./Flow"), exports);

package/dist/Automations/index.d.ts

@@ -0,0 +1,4 @@
+export * from './Common';
+export * from './Flows';
+export * from './Capabilities';
+export * from './Executions';

package/dist/Automations/index.js

@@ -0,0 +1,20 @@
+"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("./Common"), exports);
+__exportStar(require("./Flows"), exports);
+__exportStar(require("./Capabilities"), exports);
+__exportStar(require("./Executions"), exports);

package/dist/Conversations/Sla.d.ts

@@ -25,11 +25,57 @@ export interface ConversationSlaTarget {
     durationSeconds: number;
     warningThresholds: ConversationSlaWarningThreshold[];
 }
+/**
+ * Threshold received by the SLA policy write API.
+ *
+ * Existing thresholds keep their id. New thresholds may omit it so the
+ * backend can assign the canonical identifier returned in
+ * ConversationSlaPolicy.
+ */
+export interface ConversationSlaWarningThresholdInput {
+    id?: ID;
+    percentage: number;
+}
+/**
+ * Target received by the SLA policy write API.
+ * durationSeconds is stored as seconds regardless of the unit used by the UI.
+ */
+export interface ConversationSlaTargetInput {
+    metric: ConversationSlaMetric;
+    durationSeconds: number;
+    warningThresholds: ConversationSlaWarningThresholdInput[];
+}
 export type ConversationSlaResumeBehavior = 'continue' | 'restart' | 'recalculate';
 export type ConversationSlaReopenBehavior = 'preserve' | 'restart' | 'recalculate' | 'do_not_start';
 export interface ConversationSlaClockBehavior {
+    /**
+     * Conversation statuses that pause every running SLA cycle.
+     *
+     * Entering one of these statuses pauses the clock. Leaving all of them
+     * resumes it according to onResume. An empty array means that conversation
+     * status changes never pause the SLA clock.
+     */
     pauseOnStatuses: ConversationStatus[];
+    /**
+     * Behavior applied when the conversation leaves the last status included
+     * in pauseOnStatuses.
+     *
+     * continue: keeps the current cycle and its consumed/remaining time.
+     * restart: resets the current cycle from the resume timestamp.
+     * recalculate: keeps the applied policy snapshot and recalculates the
+     * schedule-derived warnings/deadline. It does not select another policy
+     * version.
+     */
     onResume: ConversationSlaResumeBehavior;
+    /**
+     * Behavior applied when a resolved/finalized conversation is reopened.
+     * Reopening is independent from resuming a status-paused clock.
+     *
+     * preserve: preserves the previous cycle state.
+     * restart: starts a new cycle from the reopen timestamp.
+     * recalculate: recalculates the cycle using the applied policy snapshot.
+     * do_not_start: does not start an SLA cycle because of the reopen action.
+     */
     onReopen: ConversationSlaReopenBehavior;
 }
 /**
@@ -51,6 +97,46 @@ export interface ConversationSlaPolicy {
     updatedAt: Date;
     updatedByUserId?: ID;
 }
+/**
+ * Editable definition sent by clients.
+ *
+ * It intentionally excludes policy id/version and audit fields controlled by
+ * the backend. targets is full-replacement: omitted metrics are disabled in
+ * the newly published policy version.
+ */
+export interface ConversationSlaPolicyDefinitionInput {
+    name: string;
+    description?: string;
+    enabled: boolean;
+    timeCalculation: ConversationSlaTimeCalculation;
+    targets: ConversationSlaTargetInput[];
+    clockBehavior: ConversationSlaClockBehavior;
+}
+/**
+ * Creates the first immutable version of an SLA policy.
+ *
+ * commandId provides idempotency for retries. The authenticated backend
+ * context supplies createdByUserId and the audit timestamps.
+ */
+export interface CreateConversationSlaPolicyRequest {
+    commandId: ID;
+    spaceId: ID;
+    definition: ConversationSlaPolicyDefinitionInput;
+}
+/**
+ * Publishes a new immutable version of an existing SLA policy.
+ *
+ * expectedVersion implements optimistic concurrency. The backend rejects the
+ * request when another version was published after the client loaded it.
+ * version, updatedAt and updatedByUserId are always assigned by the backend.
+ */
+export interface PublishConversationSlaPolicyVersionRequest {
+    commandId: ID;
+    spaceId: ID;
+    policyId: ID;
+    expectedVersion: number;
+    definition: ConversationSlaPolicyDefinitionInput;
+}
 export type ConversationSlaClockAction = 'start' | 'evaluate' | 'pause' | 'resume' | 'complete' | 'recalculate' | 'cancel';
 export type ConversationSlaClockReason = 'conversation_created' | 'conversation_enqueued' | 'customer_message' | 'agent_response' | 'assignment_changed' | 'status_changed' | 'queue_transfer' | 'conversation_reopened' | 'deadline_due' | 'policy_override';
 /**

package/dist/index.d.ts

@@ -20,3 +20,4 @@ export * as AI from './AI/index';
 export * as Shop from './Shop/index';
 export * as APIResponses from './ApiResponses/index';
 export * as Forms from './Forms/index';
+export * as Automations from './Automations/index';

package/dist/index.js

@@ -33,7 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Forms = exports.APIResponses = exports.Shop = exports.AI = exports.APIKeys = 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.Automations = exports.Forms = exports.APIResponses = exports.Shop = exports.AI = exports.APIKeys = 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"));
 exports.AuditLogs = __importStar(require("./AuditLogs/index"));
 exports.Common = __importStar(require("./Common/index"));
@@ -56,3 +56,4 @@ exports.AI = __importStar(require("./AI/index"));
 exports.Shop = __importStar(require("./Shop/index"));
 exports.APIResponses = __importStar(require("./ApiResponses/index"));
 exports.Forms = __importStar(require("./Forms/index"));
+exports.Automations = __importStar(require("./Automations/index"));

package/package.json

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