@fiado/type-kit 3.604.0 → 3.606.0

package/src/meetings/dtos/MeetingRuleResponse.ts

@@ -0,0 +1,47 @@
+import { JsonValue } from '../../common';
+import { MeetingRuleActionTypeEnum } from '../enums/MeetingRuleActionTypeEnum';
+import { MeetingRuleStatusEnum } from '../enums/MeetingRuleStatusEnum';
+
+/** Qué se hace con quien cumple: TAG lleva la etiqueta; PROMOTE no necesita más datos. */
+export class MeetingRuleAction {
+    type: MeetingRuleActionTypeEnum;
+    /** De MeetingLeadTagEnum; obligatoria con TAG. */
+    tag?: string;
+}
+
+/** Una regla de clasificación nuestra: rules-business no guarda nada y la recibe en cada llamada. */
+export class MeetingRuleResponse {
+    id: string;
+    version: number;
+    name: string;
+    description?: string;
+    /** La definición tal cual viaja al motor: tabla ancla, condiciones y grupos. */
+    definition: JsonValue;
+    /** El SQL de la última validación; el motor responde SchemaDriftError si el esquema del lago cambió. */
+    expectedSql?: string;
+    usedColumns?: string[];
+    definitionHash?: string;
+    humanSummary?: string;
+    actions: MeetingRuleAction[];
+    status: MeetingRuleStatusEnum;
+    lastTestAt?: string;
+    lastTestCount?: number;
+    tenantId?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+    updatedBy?: string;
+}
+
+export class MeetingRuleUpsertRequest {
+    name: string;
+    description?: string;
+    definition: JsonValue;
+    actions: MeetingRuleAction[];
+    status?: MeetingRuleStatusEnum;
+}
+
+export class MeetingRuleListResponse {
+    items: MeetingRuleResponse[];
+    index: string | null;
+}

package/src/meetings/dtos/MeetingSessionRef.ts

@@ -0,0 +1,8 @@
+/** Una sesión de la reunión en la plataforma: un reinicio el mismo día agrega otra. */
+export class MeetingSessionRef {
+    /** Id de la sesión en la plataforma (en Zoom, el uuid). */
+    id: string;
+    /** ISO 8601 UTC. */
+    startedAt: string;
+    endedAt?: string;
+}

package/src/meetings/enums/MeetingAttendanceRoleEnum.ts

@@ -0,0 +1,5 @@
+/** Todo anfitrión lleva su renglón de asistencia, incluido el responsable (hostEmail). Nunca pasa a NO_SHOW. */
+export enum MeetingAttendanceRoleEnum {
+    HOST = 'HOST',
+    PARTICIPANT = 'PARTICIPANT',
+}

package/src/meetings/enums/MeetingAttendanceSourceEnum.ts

@@ -0,0 +1,5 @@
+/** ZOOM = lo marcó un aviso de la plataforma; MANUAL = lo marcó el anfitrión (markedBy). */
+export enum MeetingAttendanceSourceEnum {
+    ZOOM = 'ZOOM',
+    MANUAL = 'MANUAL',
+}

package/src/meetings/enums/MeetingAttendanceStatusEnum.ts

@@ -0,0 +1,7 @@
+/** INVITED es el precargado al crear la reunión (invitado o anfitrión); REGISTERED, quien llenó el registro. */
+export enum MeetingAttendanceStatusEnum {
+    INVITED = 'INVITED',
+    REGISTERED = 'REGISTERED',
+    ATTENDED = 'ATTENDED',
+    NO_SHOW = 'NO_SHOW',
+}

package/src/meetings/enums/MeetingEventTypeEnum.ts

@@ -0,0 +1,16 @@
+/**
+ * Eventos de MeetingsBusinessQueue. Productores: meeting-connector (los ocho de la plataforma,
+ * traducidos a eventos de Fiado sin nombrar al proveedor) y usmarketgrowth-business (PROMOTER_CREATED).
+ * Consumidor: meetings-business, de forma idempotente (los avisos llegan duplicados o fuera de orden).
+ */
+export enum MeetingEventTypeEnum {
+    MEETING_CREATED = 'MEETING_CREATED',
+    MEETING_UPDATED = 'MEETING_UPDATED',
+    MEETING_DELETED = 'MEETING_DELETED',
+    SESSION_STARTED = 'SESSION_STARTED',
+    PERSON_REGISTERED = 'PERSON_REGISTERED',
+    PARTICIPANT_JOINED = 'PARTICIPANT_JOINED',
+    PARTICIPANT_LEFT = 'PARTICIPANT_LEFT',
+    MEETING_ENDED = 'MEETING_ENDED',
+    PROMOTER_CREATED = 'PROMOTER_CREATED',
+}

package/src/meetings/enums/MeetingLeadSourceEnum.ts

@@ -0,0 +1,8 @@
+/** WEB existe desde el principio aunque la captación web sea fase 1B, para no migrar después. */
+export enum MeetingLeadSourceEnum {
+    ZOOM = 'ZOOM',
+    MANUAL = 'MANUAL',
+    WEB = 'WEB',
+    /** F9: los promotores de UsGrowthPromoter_GT migrados al padrón una sola vez. */
+    MIGRATION = 'MIGRATION',
+}

package/src/meetings/enums/MeetingLeadTagEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Las etiquetas de lead de la fase 1: la lista blanca que comparten encuestas, reglas y back office.
+ * Sumar una requiere publicar type-kit y desplegar; a cambio, los reportes no se rompen con variantes.
+ * Cumplen el formato del lambda de tags (hasta 64 caracteres, sin espacios ni acentos).
+ */
+export enum MeetingLeadTagEnum {
+    PROMOTER_PROSPECT = 'PROMOTER_PROSPECT',
+    BUSINESS = 'BUSINESS',
+    AGENT = 'AGENT',
+}

package/src/meetings/enums/MeetingModalityEnum.ts

@@ -0,0 +1,6 @@
+/** Cómo se encuentra la gente. En la fase 1, lo creado desde el back office para Zoom es VIRTUAL. */
+export enum MeetingModalityEnum {
+    VIRTUAL = 'VIRTUAL',
+    IN_PERSON = 'IN_PERSON',
+    PHONE = 'PHONE',
+}

package/src/meetings/enums/MeetingPlatformEnum.ts

@@ -0,0 +1,7 @@
+/** Proveedor de la reunión virtual. El agnosticismo vive acá: ningún campo se llama como el proveedor. */
+export enum MeetingPlatformEnum {
+    ZOOM = 'ZOOM',
+    TEAMS = 'TEAMS',
+    MEET = 'MEET',
+    OTHER = 'OTHER',
+}

package/src/meetings/enums/MeetingQuestionDataTypeEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Tipo de dato de una pregunta abierta, propio y no de la plataforma (decidido el 22-10 con Yhon):
+ * cada connector manda lo que su proveedor soporta, y meetings-business valida al recibir. Lo que no
+ * cumple se guarda tal como llegó, marcado inválido, y un teléfono inválido no crea lead.
+ */
+export enum MeetingQuestionDataTypeEnum {
+    PHONE = 'PHONE',
+    EMAIL = 'EMAIL',
+    NUMBER = 'NUMBER',
+    ALPHANUMERIC = 'ALPHANUMERIC',
+    DATE = 'DATE',
+}

package/src/meetings/enums/MeetingQuestionSurfaceEnum.ts

@@ -0,0 +1,5 @@
+/** Dónde se puede usar la pregunta: el formulario de registro o la encuesta en vivo. */
+export enum MeetingQuestionSurfaceEnum {
+    REGISTRATION = 'REGISTRATION',
+    POLL = 'POLL',
+}

package/src/meetings/enums/MeetingQuestionTypeEnum.ts

@@ -0,0 +1,6 @@
+/** Cerradas (SINGLE, MULTIPLE) o abierta (TEXT). Sólo las cerradas pueden clasificar. */
+export enum MeetingQuestionTypeEnum {
+    SINGLE = 'SINGLE',
+    MULTIPLE = 'MULTIPLE',
+    TEXT = 'TEXT',
+}

package/src/meetings/enums/MeetingRuleActionTypeEnum.ts

@@ -0,0 +1,5 @@
+/** Qué se hace con quien cumple una regla: etiquetar (contra el lambda de tags) o promover a promotor. */
+export enum MeetingRuleActionTypeEnum {
+    TAG = 'TAG',
+    PROMOTE = 'PROMOTE',
+}

package/src/meetings/enums/MeetingRuleStatusEnum.ts

@@ -0,0 +1,5 @@
+export enum MeetingRuleStatusEnum {
+    DRAFT = 'DRAFT',
+    ACTIVE = 'ACTIVE',
+    RETIRED = 'RETIRED',
+}

package/src/meetings/enums/MeetingSourceEnum.ts

@@ -0,0 +1,5 @@
+/** De dónde nació la fila: del back office, o capturada de una reunión creada directo en la plataforma. */
+export enum MeetingSourceEnum {
+    BACKOFFICE = 'BACKOFFICE',
+    ZOOM_DIRECT = 'ZOOM_DIRECT',
+}

package/src/meetings/enums/MeetingStatusEnum.ts

@@ -0,0 +1,5 @@
+export enum MeetingStatusEnum {
+    SCHEDULED = 'SCHEDULED',
+    HELD = 'HELD',
+    CANCELLED = 'CANCELLED',
+}

package/src/meetings/enums/MeetingTypeEnum.ts

@@ -0,0 +1,5 @@
+/** Cita (invitados conocidos de antemano) o evento masivo. Lo demás es idéntico entre los dos. */
+export enum MeetingTypeEnum {
+    APPOINTMENT = 'APPOINTMENT',
+    EVENT = 'EVENT',
+}

package/src/meetings/index.ts

@@ -0,0 +1,32 @@
+//Enums
+export * from './enums/MeetingTypeEnum';
+export * from './enums/MeetingModalityEnum';
+export * from './enums/MeetingPlatformEnum';
+export * from './enums/MeetingStatusEnum';
+export * from './enums/MeetingSourceEnum';
+export * from './enums/MeetingAttendanceStatusEnum';
+export * from './enums/MeetingAttendanceRoleEnum';
+export * from './enums/MeetingAttendanceSourceEnum';
+export * from './enums/MeetingLeadSourceEnum';
+export * from './enums/MeetingLeadTagEnum';
+export * from './enums/MeetingQuestionTypeEnum';
+export * from './enums/MeetingQuestionSurfaceEnum';
+export * from './enums/MeetingQuestionDataTypeEnum';
+export * from './enums/MeetingRuleStatusEnum';
+export * from './enums/MeetingRuleActionTypeEnum';
+export * from './enums/MeetingEventTypeEnum';
+
+//Constants
+export * from './constants/MeetingLimits';
+
+//DTOs
+export * from './dtos/MeetingSessionRef';
+export * from './dtos/MeetingQuestionRef';
+export * from './dtos/MeetingPollRef';
+export * from './dtos/MeetingResponse';
+export * from './dtos/MeetingAttendanceResponse';
+export * from './dtos/MeetingLeadResponse';
+export * from './dtos/MeetingQuestionResponse';
+export * from './dtos/MeetingFormResponse';
+export * from './dtos/MeetingRuleResponse';
+export * from './dtos/MeetingQueueEvents';

package/src/retailIntegration/dtos/ProductEventPayload.ts

@@ -1,5 +1,5 @@
-import { Type } from 'class-transformer';
-import { ArrayMaxSize, IsArray, IsDefined, IsIn, IsObject, IsString, Matches, MaxLength, Validate, ValidateIf, ValidateNested } from 'class-validator';
+import { Expose, Transform, Type } from 'class-transformer';
+import { ArrayMaxSize, ArrayNotEmpty, ArrayUnique, IsArray, IsDefined, IsIn, IsObject, IsOptional, IsString, Matches, MaxLength, Validate, ValidateIf, ValidateNested } from 'class-validator';
 import {
     RETAIL_ELIGIBLE_FINANCIERS_MAX,
     RETAIL_EVENT_DECIMAL_PATTERN,
@@ -49,10 +49,15 @@ export class ProductEventPayload implements RetailSystemProduct {
     @ValidateIf(isNullOrValidated) @IsString() @MaxLength(RETAIL_LONG_TEXT_MAX_LENGTH) description!: string | null;
     @IsIn(Object.values(RetailProductCategoryEnum)) category!: RetailProductCategory;
     @IsIn(Object.values(RetailTrackingModeEnum)) trackingMode!: RetailTrackingMode;
-    @ValidateIf(isNullOrValidated) @IsIn(Object.values(RetailProductTierEnum)) tier!: RetailProductTier | null;
+    /** Opcional en el evento: ausente se vuelve `null`. */
+    @Expose() @Transform(({ value }) => value ?? null)
+    @IsOptional() @IsIn(Object.values(RetailProductTierEnum)) tier!: RetailProductTier | null;
     @IsIn(Object.values(RetailCurrencyEnum)) currencyId!: RetailCurrency;
     @IsDefined() @IsObject() @ValidateNested() @Type(() => ProductEventPricePayload) price!: ProductEventPricePayload;
-    @IsArray() @ArrayMaxSize(RETAIL_ELIGIBLE_FINANCIERS_MAX) @IsIn(Object.values(RetailFinancierEnum), { each: true }) eligibleFinanciers!: RetailFinancier[];
+    /** Opcional en el evento: ausente o `null` se vuelve la lista de todas las financieras. */
+    @Expose() @Transform(({ value }) => value ?? Object.values(RetailFinancierEnum))
+    @IsOptional() @IsArray() @ArrayNotEmpty() @ArrayUnique() @ArrayMaxSize(RETAIL_ELIGIBLE_FINANCIERS_MAX) @IsIn(Object.values(RetailFinancierEnum), { each: true })
+    eligibleFinanciers!: RetailFinancier[];
     @ValidateIf(isNullOrValidated) @IsIn(Object.values(RetailMdmProviderEnum)) mdmProvider!: RetailMdmProvider | null;
     @IsIn(Object.values(RetailProductStatusEnum)) status!: RetailProductStatus;
 }

package/src/retailIntegration/enums/RetailProductTierEnum.ts

@@ -1,4 +1,4 @@
-/** Gama de un producto. */
+/** Gama de un producto; mismos valores que `ProductTierEnum` de retailCatalog. */
 export enum RetailProductTierEnum {
     LOW = 'LOW',
     MID = 'MID',

package/src/usmarketgrowth-business/dtos/PromoterFromLead.ts

@@ -0,0 +1,20 @@
+/**
+ * 4.5 del plan de reuniones: alta de un promotor a partir de un lead de meetings-business.
+ * `POST /private/promoters/from-lead` de `usmarketgrowth-business`, idempotente por teléfono o correo:
+ * dos llamadas con el mismo contacto devuelven el mismo `promoterId`.
+ */
+
+export interface CreatePromoterFromLeadRequest {
+    /** Nombre completo; obligatorio (DEC-024: nombre y un medio de contacto). */
+    name?: string;
+    phoneNumber?: string;
+    email?: string;
+}
+
+export interface PostPromoterFromLeadResponse {
+    /** CREATED si nació aquí; EXISTING si ya había promotor con ese contacto (no se toca nada). */
+    status: 'CREATED' | 'EXISTING';
+    promoterId: string;
+    /** Lo que faltó de la aplicación: el promotor queda «por revisar» hasta completarla. */
+    reviewReasons: string[];
+}

package/src/usmarketgrowth-business/index.ts

@@ -1,2 +1,3 @@
 //dtos
 export * from './dtos/PromoterByDirectoryIdResponse';
+export * from './dtos/PromoterFromLead';