@trii/types 2.10.738 → 2.10.742

package/dist/Common/Messages/Message.d.ts

@@ -1,3 +1,4 @@
+import { IEventType } from "../../Calendar/Event";
 import { IContactAddress } from "../../Contacts/contacts";
 import { UserInfo } from "../../Users/UserTrii";
 import { IChannelInfo } from "../Channels/Channel";
@@ -314,6 +315,41 @@ export interface MessagePollOption {
     name: string;
     localId: string;
 }
+/**
+ * Evento de calendario compartido como mensaje (B22). Es un **snapshot** del evento al momento de
+ * compartirlo, no una referencia viva: la tarjeta se pinta sin pegarle al calendar API y sigue
+ * siendo legible si después el evento se edita o se borra. `eventId` es lo único que se resuelve
+ * contra el calendario (deep link y, a futuro, refrescar el snapshot).
+ *
+ * Compatibilidad: el emisor sigue mandando además el resumen en `text.body`, así que un cliente
+ * que no conozca este campo muestra el mensaje de texto de siempre.
+ *
+ * Espejo C#: Trii.Common.Messages.MessageEvent.
+ */
+export interface MessageEvent {
+    /** `IEvent.id` en el calendario. */
+    eventId: string;
+    title: string;
+    /**ISO8601 timestamp */
+    startAt: Date;
+    /**ISO8601 timestamp */
+    endAt: Date;
+    allDay: boolean;
+    location?: string;
+    details?: string;
+    /** Color del evento (`IEvent.color`), para que la tarjeta use el mismo del calendario. */
+    color?: string;
+    /** Tipo de evento (`IEvent.eventType`): nombre, color e ícono. Snapshot, como el resto. */
+    eventType?: IEventType;
+    /**
+     * Sólo en eventos recurrentes: la ocurrencia que se compartió
+     * (`IEvent.originalOccurrenceDate`). `eventId` identifica la serie, así que sin esto el deep
+     * link abre la serie y no el día compartido.
+     */
+    originalOccurrenceDate?: Date;
+    /** Deep link al evento (`/a/calendar/Calendar?eventId=`). El front lo recalcula si falta. */
+    link?: string;
+}
 /** Un voto de un usuario a una opción de la encuesta (B13). Espejo C#: Trii.Common.Messages.MessagePollVote. */
 export interface MessagePollVote {
     /** `MessagePollOption.localId` de la opción votada. */
@@ -437,6 +473,11 @@ export interface IMessage {
     buttons?: MessageButton[];
     poll?: MessagePoll;
     note?: MessageNote;
+    /**
+     * Evento de calendario compartido en el chat (B22). Snapshot; el resumen legible sigue
+     * viajando en `text.body` para los clientes que no conocen el campo.
+     */
+    event?: MessageEvent;
     reactions?: MessageReaction[];
     messageReference?: MessageReference;
     comment?: CommentData;

package/dist/Conversations/SocialWalls.d.ts

@@ -19,6 +19,8 @@ export interface Post {
     participants: UserInfo[];
     archived: boolean;
     assignment: ConversationAssignmentSnapshot;
+    /** Concurrencia optimista + idempotencia de comandos, igual que Conversation.version. */
+    version: number;
     createdAt: Date;
     updatedAt: Date;
 }

package/dist/Tickets/Api.d.ts

@@ -32,6 +32,7 @@ export interface ITicketFilter {
     assigneeIds?: string[];
     assignedGroupIds?: string[];
     categoryIds?: string[];
+    requestTypeIds?: string[];
     tagIds?: string[];
     createdFrom?: Date;
     createdTo?: Date;

package/dist/Tickets/Notes.d.ts

@@ -1,13 +1,30 @@
 import type { ITicketAuditedEntity } from "./Common";
+import type { TicketMessageActorType } from "./Conversation";
+/**
+ * The four actor fields exist because ITicketAuditedEntity.createdBy is a
+ * single uuid-shaped string, which a contact cannot occupy. They follow the
+ * same pairing rule as ITicketActivity: AGENT is identified by createdBy /
+ * updatedBy, CONTACT, BOT and EXTERNAL_COLLABORATOR by the *ExternalId field,
+ * and SYSTEM by neither.
+ */
 export interface ITicketNote extends ITicketAuditedEntity {
     ticketId: string;
     text: string;
     version: number;
+    isPublic: boolean;
+    createdByType?: TicketMessageActorType;
+    createdByExternalId?: string;
+    updatedByType?: TicketMessageActorType;
+    updatedByExternalId?: string;
 }
 export interface CreateTicketNoteDto {
     text: string;
+    /** Defaults to false. */
+    isPublic?: boolean;
 }
+/** At least one of `text` / `isPublic` must be present. */
 export interface UpdateTicketNoteDto {
     expectedVersion: number;
-    text: string;
+    text?: string;
+    isPublic?: boolean;
 }

package/dist/Tickets/Notes.js

@@ -1,10 +1,13 @@
 "use strict";
 // ---------------------------------------------------------------------------
-// Ticket internal notes.
+// Ticket notes.
 //
-// Free-text internal annotations attached to a ticket, distinct from public
-// replies and from the conversation timeline. Optimistic concurrency via
-// version + expectedVersion on update, same pattern as the rest of the
-// module.
+// Free-text annotations attached to a ticket. A note is either internal or
+// public, and `isPublic` governs which: internal notes stay on the agent side,
+// public notes are the customer-visible reply channel while Conversations is
+// not wired to the public portal surface.
+//
+// Optimistic concurrency via version + expectedVersion on update, same pattern
+// as the rest of the module.
 // ---------------------------------------------------------------------------
 Object.defineProperty(exports, "__esModule", { value: true });

package/dist/Tickets/SelfService.d.ts

@@ -1,6 +1,7 @@
 import { ChannelType } from "../Common/Channels/ChannelType";
 import { ITicketAuditedEntity, ITicketProperty, TicketPriority } from "./Common";
 import { ITicketMessageReference } from "./Conversation";
+import type { ITicketCursorResponse } from "./Api";
 export declare enum TicketPortalAuthenticationMode {
     PUBLIC = "PUBLIC",
     OPTIONAL = "OPTIONAL",
@@ -63,6 +64,7 @@ export interface ITicketPortal extends ITicketAuditedEntity {
     allowComments: boolean;
     allowReopen: boolean;
     allowCancellation: boolean;
+    allowAttachments: boolean;
     termsDocumentId?: string;
     privacyDocumentId?: string;
     enabled: boolean;
@@ -83,6 +85,7 @@ export interface ICreateTicketPortalDto {
     allowComments?: boolean;
     allowReopen?: boolean;
     allowCancellation?: boolean;
+    allowAttachments?: boolean;
     termsDocumentId?: string;
     privacyDocumentId?: string;
     enabled?: boolean;
@@ -103,6 +106,7 @@ export interface IUpdateTicketPortalDto {
     allowComments?: boolean;
     allowReopen?: boolean;
     allowCancellation?: boolean;
+    allowAttachments?: boolean;
     termsDocumentId?: string | null;
     privacyDocumentId?: string | null;
     enabled?: boolean;
@@ -118,6 +122,11 @@ export interface ITicketRequestType extends ITicketAuditedEntity {
     defaultPriority?: TicketPriority;
     defaultAssignedGroupId?: string;
     slaPolicyId?: string;
+    /**
+     * @deprecated Never used. Public status resolution is space-level, not per
+     * request type - see the public portal surface. Always undefined; will be
+     * removed in a later release.
+     */
     publicStatusSchemeId?: string;
     fieldDefinitionIds?: string[];
     layoutIds?: string[];
@@ -135,7 +144,6 @@ export interface ICreateTicketRequestTypeDto {
     defaultPriority?: TicketPriority;
     defaultAssignedGroupId?: string;
     slaPolicyId?: string;
-    publicStatusSchemeId?: string;
     fieldDefinitionIds?: string[];
     layoutIds?: string[];
     audiencePolicyId?: string;
@@ -152,7 +160,6 @@ export interface IUpdateTicketRequestTypeDto {
     defaultPriority?: TicketPriority | null;
     defaultAssignedGroupId?: string | null;
     slaPolicyId?: string | null;
-    publicStatusSchemeId?: string | null;
     fieldDefinitionIds?: string[] | null;
     layoutIds?: string[] | null;
     audiencePolicyId?: string | null;
@@ -306,23 +313,87 @@ export interface ITicketPublicStatusScheme extends ITicketAuditedEntity {
     defaultPublicStatusId?: string;
     enabled: boolean;
 }
+export interface ICreateTicketPublicStatusDto {
+    name: string;
+    description?: string;
+    color?: string;
+    icon?: string;
+    order: number;
+}
+export interface IUpdateTicketPublicStatusDto extends Partial<ICreateTicketPublicStatusDto> {
+}
+export interface ICreateTicketPublicStatusSchemeDto {
+    name: string;
+    description?: string;
+    defaultPublicStatusId?: string;
+    enabled?: boolean;
+}
+export interface IUpdateTicketPublicStatusSchemeDto extends Partial<ICreateTicketPublicStatusSchemeDto> {
+}
+/**
+ * `schemeId` is absent on purpose: mappings are a sub-resource of a scheme
+ * (`/public-status-schemes/:schemeId/mappings`), so the parent id comes from the
+ * path.
+ */
+export interface ICreateTicketPublicStatusMappingDto {
+    publicStatusId: string;
+    internalStatusIds: string[];
+}
+export interface IUpdateTicketPublicStatusMappingDto extends Partial<ICreateTicketPublicStatusMappingDto> {
+}
+/** Customer-facing projection of ITicketPublicStatus: no audit or tenant fields. */
+export interface ICustomerPublicStatusView {
+    id: string;
+    name: string;
+    description?: string;
+    color?: string;
+    icon?: string;
+    order: number;
+}
 /** Safe customer projection; internal activity, notes, routing and SLA details are intentionally excluded. */
 export interface ICustomerTicketView {
     id: string;
     number: number;
     title: string;
     description?: string;
+    contactId: string;
     requestTypeId?: string;
     categoryId: string;
-    publicStatus: ITicketPublicStatus;
+    publicStatus: ICustomerPublicStatusView;
     priority?: TicketPriority;
     publicProperties?: ITicketProperty[];
+    version: number;
     createdAt: Date;
     updatedAt?: Date;
     resolvedAt?: Date;
     messages?: ITicketMessageReference[];
     availableActions: TicketCustomerAction[];
 }
+export interface ICustomerTicketFilter {
+    /** Mandatory. The surface never serves tickets across contacts. */
+    contactId: string;
+    search?: string;
+    publicStatusIds?: string[];
+    requestTypeIds?: string[];
+    categoryIds?: string[];
+    createdFrom?: Date;
+    createdTo?: Date;
+}
+export declare enum CustomerTicketSortField {
+    CREATED_AT = "CREATED_AT",
+    UPDATED_AT = "UPDATED_AT",
+    NUMBER = "NUMBER"
+}
+export interface ICustomerTicketQuery {
+    filter: ICustomerTicketFilter;
+    sort?: {
+        field: CustomerTicketSortField;
+        direction: 'ASC' | 'DESC';
+    }[];
+    cursor?: string;
+    limit?: number;
+}
+export type CustomerTicketPage = ITicketCursorResponse<ICustomerTicketView>;
 /** Reference only. Article content and lifecycle remain authoritative in Docs/Knowledge. */
 export interface ITicketKnowledgeReference extends ITicketAuditedEntity {
     referenceType: TicketKnowledgeReferenceType;
@@ -438,6 +509,7 @@ export interface ISubmitTicketRequestDto {
     idempotencyKey: string;
 }
 export interface ICustomerTicketActionDto {
+    expectedVersion: number;
     action: TicketCustomerAction;
     comment?: string;
     attachmentIds?: string[];

package/dist/Tickets/SelfService.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TicketKnowledgeReferenceType = exports.TicketDeflectionOutcome = exports.TicketNotificationEvent = exports.TicketAudienceRuleEffect = exports.TicketCustomerAction = exports.TicketRequestDraftStatus = exports.TicketPortalAuthenticationMode = void 0;
+exports.CustomerTicketSortField = exports.TicketKnowledgeReferenceType = exports.TicketDeflectionOutcome = exports.TicketNotificationEvent = exports.TicketAudienceRuleEffect = exports.TicketCustomerAction = exports.TicketRequestDraftStatus = exports.TicketPortalAuthenticationMode = void 0;
 var TicketPortalAuthenticationMode;
 (function (TicketPortalAuthenticationMode) {
     TicketPortalAuthenticationMode["PUBLIC"] = "PUBLIC";
@@ -54,3 +54,9 @@ var TicketKnowledgeReferenceType;
     TicketKnowledgeReferenceType["COLLECTION"] = "COLLECTION";
     TicketKnowledgeReferenceType["FOLDER"] = "FOLDER";
 })(TicketKnowledgeReferenceType || (exports.TicketKnowledgeReferenceType = TicketKnowledgeReferenceType = {}));
+var CustomerTicketSortField;
+(function (CustomerTicketSortField) {
+    CustomerTicketSortField["CREATED_AT"] = "CREATED_AT";
+    CustomerTicketSortField["UPDATED_AT"] = "UPDATED_AT";
+    CustomerTicketSortField["NUMBER"] = "NUMBER";
+})(CustomerTicketSortField || (exports.CustomerTicketSortField = CustomerTicketSortField = {}));

package/dist/Tickets/Workflow.d.ts

@@ -1,6 +1,7 @@
 import { TicketApprovalStatus } from './Approval';
 import { TicketTaskStatus } from './Task';
 import { ITicketAuditedEntity, TicketPropertyValue, TicketStage } from "./Common";
+import type { TicketMessageActorType } from "./Conversation";
 export interface ITicketStatus extends ITicketAuditedEntity {
     name: string;
     description?: string;
@@ -98,6 +99,21 @@ export interface ITicketFieldChange {
     previousValue?: TicketPropertyValue;
     newValue?: TicketPropertyValue;
 }
+/**
+ * Actor identity is split in two columns and exactly one of them is populated:
+ *
+ * | actorType               | Identity field      | Notes                                  |
+ * |-------------------------|---------------------|----------------------------------------|
+ * | AGENT                   | actorId (uuid)      | an internal user                       |
+ * | CONTACT                 | actorExternalId     | a Mongo ObjectId                       |
+ * | EXTERNAL_COLLABORATOR   | actorExternalId     | not produced yet                       |
+ * | BOT                     | actorExternalId     | not produced yet                       |
+ * | SYSTEM                  | neither             | schedulers, migrations, processor jobs |
+ *
+ * Both identity fields are absent for SYSTEM. Rows written before `actorType`
+ * existed have none, and must be read as AGENT when `actorId` is present and as
+ * SYSTEM when it is not.
+ */
 export interface ITicketActivity {
     id: string;
     spaceId: string;
@@ -105,6 +121,8 @@ export interface ITicketActivity {
     type: TicketActivityType;
     ticketEventType?: string;
     actorId?: string;
+    actorType?: TicketMessageActorType;
+    actorExternalId?: string;
     occurredAt: Date;
     comment?: string;
     attachmentIds?: string[];

package/package.json

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