@fiado/type-kit 3.604.0 → 3.606.0

package/bin/meetings/index.js

@@ -0,0 +1,46 @@
+"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 });
+//Enums
+__exportStar(require("./enums/MeetingTypeEnum"), exports);
+__exportStar(require("./enums/MeetingModalityEnum"), exports);
+__exportStar(require("./enums/MeetingPlatformEnum"), exports);
+__exportStar(require("./enums/MeetingStatusEnum"), exports);
+__exportStar(require("./enums/MeetingSourceEnum"), exports);
+__exportStar(require("./enums/MeetingAttendanceStatusEnum"), exports);
+__exportStar(require("./enums/MeetingAttendanceRoleEnum"), exports);
+__exportStar(require("./enums/MeetingAttendanceSourceEnum"), exports);
+__exportStar(require("./enums/MeetingLeadSourceEnum"), exports);
+__exportStar(require("./enums/MeetingLeadTagEnum"), exports);
+__exportStar(require("./enums/MeetingQuestionTypeEnum"), exports);
+__exportStar(require("./enums/MeetingQuestionSurfaceEnum"), exports);
+__exportStar(require("./enums/MeetingQuestionDataTypeEnum"), exports);
+__exportStar(require("./enums/MeetingRuleStatusEnum"), exports);
+__exportStar(require("./enums/MeetingRuleActionTypeEnum"), exports);
+__exportStar(require("./enums/MeetingEventTypeEnum"), exports);
+//Constants
+__exportStar(require("./constants/MeetingLimits"), exports);
+//DTOs
+__exportStar(require("./dtos/MeetingSessionRef"), exports);
+__exportStar(require("./dtos/MeetingQuestionRef"), exports);
+__exportStar(require("./dtos/MeetingPollRef"), exports);
+__exportStar(require("./dtos/MeetingResponse"), exports);
+__exportStar(require("./dtos/MeetingAttendanceResponse"), exports);
+__exportStar(require("./dtos/MeetingLeadResponse"), exports);
+__exportStar(require("./dtos/MeetingQuestionResponse"), exports);
+__exportStar(require("./dtos/MeetingFormResponse"), exports);
+__exportStar(require("./dtos/MeetingRuleResponse"), exports);
+__exportStar(require("./dtos/MeetingQueueEvents"), exports);

package/bin/retailIntegration/dtos/ProductEventPayload.d.ts

@@ -16,9 +16,11 @@ export declare class ProductEventPayload implements RetailSystemProduct {
     description: string | null;
     category: RetailProductCategory;
     trackingMode: RetailTrackingMode;
+    /** Opcional en el evento: ausente se vuelve `null`. */
     tier: RetailProductTier | null;
     currencyId: RetailCurrency;
     price: ProductEventPricePayload;
+    /** Opcional en el evento: ausente o `null` se vuelve la lista de todas las financieras. */
     eligibleFinanciers: RetailFinancier[];
     mdmProvider: RetailMdmProvider | null;
     status: RetailProductStatus;

package/bin/retailIntegration/dtos/ProductEventPayload.js

@@ -89,7 +89,9 @@ __decorate([
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "trackingMode", void 0);
 __decorate([
-    (0, class_validator_1.ValidateIf)(payloadValidators_1.isNullOrValidated),
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ?? null),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsIn)(Object.values(enums_1.RetailProductTierEnum)),
     __metadata("design:type", String)
 ], ProductEventPayload.prototype, "tier", void 0);
@@ -105,7 +107,12 @@ __decorate([
     __metadata("design:type", ProductEventPricePayload)
 ], ProductEventPayload.prototype, "price", void 0);
 __decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_transformer_1.Transform)(({ value }) => value ?? Object.values(enums_1.RetailFinancierEnum)),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayUnique)(),
     (0, class_validator_1.ArrayMaxSize)(retailIntegrationLimits_1.RETAIL_ELIGIBLE_FINANCIERS_MAX),
     (0, class_validator_1.IsIn)(Object.values(enums_1.RetailFinancierEnum), { each: true }),
     __metadata("design:type", Array)

package/bin/retailIntegration/enums/RetailProductTierEnum.d.ts

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

package/bin/retailIntegration/enums/RetailProductTierEnum.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RetailProductTierEnum = void 0;
-/** Gama de un producto. */
+/** Gama de un producto; mismos valores que `ProductTierEnum` de retailCatalog. */
 var RetailProductTierEnum;
 (function (RetailProductTierEnum) {
     RetailProductTierEnum["LOW"] = "LOW";

package/bin/usmarketgrowth-business/dtos/PromoterFromLead.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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/bin/usmarketgrowth-business/dtos/PromoterFromLead.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * 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`.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/usmarketgrowth-business/index.d.ts

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

package/bin/usmarketgrowth-business/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 //dtos
 __exportStar(require("./dtos/PromoterByDirectoryIdResponse"), exports);
+__exportStar(require("./dtos/PromoterFromLead"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/type-kit",
-  "version": "3.604.0",
+  "version": "3.606.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/index.ts

@@ -218,6 +218,10 @@ export * as PdfRender from './pdfRender';
 // Rules: DTOs del lambda central rules-business (catálogo, validación, generación con IA y evaluación de reglas).
 export * as Rules from './rules';
 
+// Meetings: reuniones, eventos y leads (meetings-business y meeting-connector): el contrato de los
+// endpoints del back office y los eventos de MeetingsBusinessQueue, sin nombrar al proveedor.
+export * as Meetings from './meetings';
+
 // LoanRetailAudit: contrato del lambda central loan-retail-audit-business (bitácora y accesos a PII
 // de Loan y Retail): mensaje de su cola, POST /private/pii-access-logs y GET /private/audit-trail.
 export * as LoanRetailAudit from './loanRetailAudit';

package/src/meetings/constants/MeetingLimits.ts

@@ -0,0 +1,11 @@
+/** Título de una encuesta o pregunta: lo que ve el asistente en la plataforma. */
+export const MEETING_QUESTION_TITLE_MAX_LENGTH = 64;
+/** Una pregunta cerrada lleva entre 2 y 10 opciones; una abierta, ninguna. */
+export const MEETING_QUESTION_OPTIONS_MIN = 2;
+export const MEETING_QUESTION_OPTIONS_MAX = 10;
+/** Tope de reuniones que crea una repetición semanal (la plataforma limita las creaciones por día). */
+export const MEETING_REPEAT_MAX = 12;
+/** Un evento se dimensiona para miles de asistentes, no decenas de miles: por encima se procesa en lotes. */
+export const MEETING_EVENT_EXPECTED_MAX_ATTENDEES = 2000;
+/** Entrada "pregunta:opción" de Lead_GT.answers: referencias estables, nunca el texto. */
+export const MEETING_ANSWER_TOKEN_SEPARATOR = ':';

package/src/meetings/dtos/MeetingAttendanceResponse.ts

@@ -0,0 +1,66 @@
+import { MeetingAttendanceRoleEnum } from '../enums/MeetingAttendanceRoleEnum';
+import { MeetingAttendanceSourceEnum } from '../enums/MeetingAttendanceSourceEnum';
+import { MeetingAttendanceStatusEnum } from '../enums/MeetingAttendanceStatusEnum';
+import { MeetingQuestionSurfaceEnum } from '../enums/MeetingQuestionSurfaceEnum';
+
+/** Una respuesta guardada en el renglón de asistencia (del registro o de la encuesta en vivo). */
+export class MeetingAnswer {
+    questionId: string;
+    version: number;
+    surface: MeetingQuestionSurfaceEnum;
+    /** El texto que vio la persona, como contexto; las reglas usan las referencias. */
+    question?: string;
+    answer: string;
+    /** Referencias estables de las opciones elegidas (las entradas de Lead_GT.answers salen de acá). */
+    optionRefs?: string[];
+    /** true = no cumple el dataType declarado; se guarda tal como llegó y no crea lead. */
+    invalid?: boolean;
+    respondedAt?: string;
+}
+
+/** Una persona en una reunión, desde que se la invita o se registra. Los anfitriones también. */
+export class MeetingAttendanceResponse {
+    meetingId: string;
+    /** LEAD#<id>; EMAIL#<correo> si todavía no es lead; EXT#<id de participante> si no se pudo identificar. */
+    personKey: string;
+    role: MeetingAttendanceRoleEnum;
+    status: MeetingAttendanceStatusEnum;
+    leadId?: string;
+    promoterId?: string;
+    directoryId?: string;
+    meetingStartsAt?: string;
+    name?: string;
+    email?: string;
+    phoneNumber?: string;
+    externalRegistrantId?: string;
+    registeredAt?: string;
+    joinedAt?: string;
+    leftAt?: string;
+    /** Suma de tramos si se reconecta. */
+    durationMinutes?: number;
+    wasInvited?: boolean;
+    source: MeetingAttendanceSourceEnum;
+    markedBy?: string;
+    responses?: MeetingAnswer[];
+    createdAt?: number;
+    updatedAt?: number;
+}
+
+/** Marcar asistencia fuera de la plataforma: lo marcado queda ATTENDED y los invitados sin marcar, NO_SHOW. */
+export class MeetingAttendanceMarkItem {
+    /** De un renglón existente; si falta, se crea uno nuevo con los datos de abajo. */
+    personKey?: string;
+    name?: string;
+    email?: string;
+    phoneNumber?: string;
+    attended: boolean;
+}
+
+export class MeetingAttendanceMarkRequest {
+    items: MeetingAttendanceMarkItem[];
+}
+
+export class MeetingAttendanceListResponse {
+    items: MeetingAttendanceResponse[];
+    index: string | null;
+}

package/src/meetings/dtos/MeetingFormResponse.ts

@@ -0,0 +1,30 @@
+/** Un formulario que se manda a los asistentes (el formId de la reunión). Los carga Silvia; no se borran. */
+export class MeetingFormResponse {
+    id: string;
+    name: string;
+    /** El link del formulario; hoy, Microsoft Forms. */
+    url: string;
+    /** Plantilla de messages-business con que se manda el correo. */
+    templateId: string;
+    /** No se le manda a quien ya es promotor (marcada en el de promotor). */
+    skipPromoters: boolean;
+    active: boolean;
+    tenantId?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+    updatedBy?: string;
+}
+
+export class MeetingFormUpsertRequest {
+    name: string;
+    url: string;
+    templateId: string;
+    skipPromoters?: boolean;
+    active?: boolean;
+}
+
+export class MeetingFormListResponse {
+    items: MeetingFormResponse[];
+    index: string | null;
+}

package/src/meetings/dtos/MeetingLeadResponse.ts

@@ -0,0 +1,47 @@
+import { MeetingLeadSourceEnum } from '../enums/MeetingLeadSourceEnum';
+
+/** Una persona del padrón, una sola vez. Promotor, directorio o cuenta son estados colgados de la fila. */
+export class MeetingLeadResponse {
+    id: string;
+    name?: string;
+    email?: string;
+    /** Llave de identidad, normalizado (+1 o +52). */
+    phoneNumber?: string;
+    /** Derivados del reporte de identificación del lago; no se mantienen a mano. */
+    directoryId?: string;
+    peopleId?: string;
+    hasFiadoAccount?: boolean;
+    promoterId?: string;
+    source: MeetingLeadSourceEnum;
+    lastAttendedAt?: string;
+    /** «<ref de pregunta>:<ref de opción>» por opción elegida en una cerrada; lo lee el motor en el lago. */
+    answers?: string[];
+    /** Correo con el formulario de la reunión (formId). */
+    formSentAt?: string;
+    formReminderSentAt?: string;
+    /** Etiquetas de LeadTags_GT (las sirve el lambda de tags de onboarding-business). */
+    tags?: string[];
+    tenantId?: string;
+    createdAt?: number;
+    updatedAt?: number;
+}
+
+export class MeetingLeadListResponse {
+    items: MeetingLeadResponse[];
+    index: string | null;
+}
+
+export class MeetingLeadCreateRequest {
+    name?: string;
+    email?: string;
+    /** El lead nace cuando aparece el teléfono; a mano se exige. */
+    phoneNumber: string;
+}
+
+/** PUT /leads/{id}/tags: etiquetas a mano, contra la lista blanca de MeetingLeadTagEnum. */
+export class MeetingLeadTagsRequest {
+    add?: string[];
+    remove?: string[];
+    /** En qué reunión se ganó, si aplica. */
+    meetingId?: string;
+}

package/src/meetings/dtos/MeetingPollRef.ts

@@ -0,0 +1,6 @@
+import { MeetingQuestionRef } from './MeetingQuestionRef';
+
+/** Una encuesta precargada en la plataforma; externalPollId llega al crearla allá. */
+export class MeetingPollRef extends MeetingQuestionRef {
+    externalPollId?: string;
+}

package/src/meetings/dtos/MeetingQuestionRef.ts

@@ -0,0 +1,5 @@
+/** Una pregunta del catálogo elegida para una reunión, con la versión congelada al elegirla. */
+export class MeetingQuestionRef {
+    questionId: string;
+    version: number;
+}

package/src/meetings/dtos/MeetingQuestionResponse.ts

@@ -0,0 +1,53 @@
+import { MeetingQuestionDataTypeEnum } from '../enums/MeetingQuestionDataTypeEnum';
+import { MeetingQuestionSurfaceEnum } from '../enums/MeetingQuestionSurfaceEnum';
+import { MeetingQuestionTypeEnum } from '../enums/MeetingQuestionTypeEnum';
+
+/** Una opción de una pregunta cerrada. La referencia es estable; el texto puede cambiar. */
+export class MeetingQuestionOption {
+    ref: string;
+    value: string;
+    /** Etiqueta que gana quien la elige, si la pregunta es clasificatoria. */
+    tag?: string;
+}
+
+export class MeetingQuestionItem {
+    /** Referencia estable: las reglas se escriben contra ella, renombrar no rompe nada. */
+    ref: string;
+    text: string;
+    type: MeetingQuestionTypeEnum;
+    /** Sólo en abiertas (TEXT) y opcional: lo valida meetings-business al recibir. */
+    dataType?: MeetingQuestionDataTypeEnum;
+    surfaces: MeetingQuestionSurfaceEnum[];
+    /** Sólo aplica en el registro. */
+    required?: boolean;
+    /** Una abierta clasificatoria se rechaza al guardar: el motor compara valores, no lee texto. */
+    classifying?: boolean;
+    options?: MeetingQuestionOption[];
+}
+
+/** Una encuesta del catálogo, versionada: cada edición crea una versión nueva y conserva la vieja. */
+export class MeetingQuestionCatalogResponse {
+    id: string;
+    version: number;
+    /** Hasta MEETING_QUESTION_TITLE_MAX_LENGTH caracteres. */
+    title: string;
+    questions: MeetingQuestionItem[];
+    /** Las inactivas no aparecen al crear reuniones. */
+    active: boolean;
+    tenantId?: string;
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+    updatedBy?: string;
+}
+
+export class MeetingQuestionUpsertRequest {
+    title: string;
+    questions: MeetingQuestionItem[];
+    active?: boolean;
+}
+
+export class MeetingQuestionListResponse {
+    items: MeetingQuestionCatalogResponse[];
+    index: string | null;
+}

package/src/meetings/dtos/MeetingQueueEvents.ts

@@ -0,0 +1,102 @@
+import { JsonValue } from '../../common';
+import { MeetingEventTypeEnum } from '../enums/MeetingEventTypeEnum';
+
+/** meeting.created: fechas vacías = reunión sin horario fijo (se guarda cuando empiece cada sesión). */
+export interface MeetingCreatedPayload {
+    externalMeetingId: string;
+    hostEmail?: string;
+    /** Quién la creó en la plataforma, si no es el anfitrión. */
+    operator?: string;
+    title?: string;
+    /** ISO 8601 UTC, una por fecha fija. */
+    dates: string[];
+    timezone?: string;
+    durationMinutes?: number;
+    joinUrl?: string;
+}
+
+export interface MeetingUpdatedPayload {
+    externalMeetingId: string;
+    /** Lo que cambió, tal como lo reportó la plataforma. */
+    changes: Record<string, JsonValue>;
+}
+
+export interface MeetingDeletedPayload {
+    externalMeetingId: string;
+}
+
+export interface SessionStartedPayload {
+    externalMeetingId: string;
+    sessionId: string;
+    startedAt: string;
+}
+
+/** El teléfono va tal como lo escribió la persona: lo normaliza meetings-business. */
+export interface PersonRegisteredPayload {
+    externalMeetingId: string;
+    registrantId: string;
+    name?: string;
+    email?: string;
+    phoneNumber?: string;
+    answers?: Array<{ question: string; answer: string }>;
+}
+
+export interface ParticipantJoinedPayload {
+    externalMeetingId: string;
+    sessionId: string;
+    participantId: string;
+    registrantId?: string;
+    name?: string;
+    email?: string;
+    joinedAt: string;
+}
+
+export interface ParticipantLeftPayload {
+    externalMeetingId: string;
+    sessionId: string;
+    participantId: string;
+    registrantId?: string;
+    name?: string;
+    email?: string;
+    leftAt: string;
+}
+
+export interface MeetingEndedPayload {
+    externalMeetingId: string;
+    sessionId: string;
+    startedAt?: string;
+    endedAt: string;
+}
+
+/** Lo publica usmarketgrowth-business al crear un promotor; el lead guarda su promoterId. */
+export interface PromoterCreatedPayload {
+    promoterId: string;
+    phoneNumber?: string;
+    email?: string;
+    name?: string;
+}
+
+export type MeetingEventPayload =
+    | MeetingCreatedPayload
+    | MeetingUpdatedPayload
+    | MeetingDeletedPayload
+    | SessionStartedPayload
+    | PersonRegisteredPayload
+    | ParticipantJoinedPayload
+    | ParticipantLeftPayload
+    | MeetingEndedPayload
+    | PromoterCreatedPayload;
+
+/**
+ * Sobre de todo mensaje de MeetingsBusinessQueue. El connector traduce los avisos de la plataforma a
+ * esto: nada nombra al proveedor (la reunión allá es externalMeetingId; una sesión, sessionId).
+ * El consumidor es idempotente: un eventId repetido o fuera de orden no duplica nada.
+ */
+export class MeetingQueueEvent<T = MeetingEventPayload> {
+    type: MeetingEventTypeEnum;
+    /** Identidad del aviso en el origen, para idempotencia. */
+    eventId: string;
+    /** Cuándo pasó, ISO 8601 UTC. */
+    occurredAt: string;
+    payload: T;
+}

package/src/meetings/dtos/MeetingResponse.ts

@@ -0,0 +1,136 @@
+import { MeetingAttendanceRoleEnum } from '../enums/MeetingAttendanceRoleEnum';
+import { MeetingModalityEnum } from '../enums/MeetingModalityEnum';
+import { MeetingPlatformEnum } from '../enums/MeetingPlatformEnum';
+import { MeetingSourceEnum } from '../enums/MeetingSourceEnum';
+import { MeetingStatusEnum } from '../enums/MeetingStatusEnum';
+import { MeetingTypeEnum } from '../enums/MeetingTypeEnum';
+import { MeetingPollRef } from './MeetingPollRef';
+import { MeetingQuestionRef } from './MeetingQuestionRef';
+import { MeetingSessionRef } from './MeetingSessionRef';
+
+/** Una reunión (cita o evento) de una fecha. Una clase que se repite son varias filas. */
+export class MeetingResponse {
+    id: string;
+    type: MeetingTypeEnum;
+    title: string;
+    /** El mensaje de la reunión; va a la plataforma como agenda. */
+    description?: string;
+    /** Tipo de clase, sólo en eventos; texto con autocompletado, no un enum (decidido el 22-10). */
+    classType?: string;
+    /** Referencia opcional a una campaña de otro servicio. */
+    campaignId?: string;
+    /** ISO 8601 UTC. Puede faltar en reuniones capturadas sin fecha. */
+    startsAt?: string;
+    durationMinutes?: number;
+    /** Zona de la reunión, p. ej. America/Los_Angeles. */
+    timezone?: string;
+    /** AAAA-MM-DD en esa zona; con externalMeetingId identifica la fila de una sesión. */
+    localDate?: string;
+    /** AAAA-MM en UTC, para el índice de «Todas». */
+    month: string;
+    /** El responsable único. Los co-anfitriones son renglones de asistencia con role HOST. */
+    hostEmail: string;
+    hostName?: string;
+    modality: MeetingModalityEnum;
+    platform?: MeetingPlatformEnum;
+    /** En Zoom, el link de registro: lo que se publica por WhatsApp y lleva el QR. */
+    meetingUrl?: string;
+    address?: string;
+    phoneNumber?: string;
+    registrationRequired: boolean;
+    phoneRequired: boolean;
+    /** El formulario que se manda a los asistentes (MeetingForm_GT); vacío = no se manda nada. */
+    formId?: string;
+    status: MeetingStatusEnum;
+    /** Id de la reunión en la plataforma, como texto (en Zoom puede pasar de 10 dígitos). */
+    externalMeetingId?: string;
+    externalSessions?: MeetingSessionRef[];
+    polls?: MeetingPollRef[];
+    registrationQuestions?: MeetingQuestionRef[];
+    source: MeetingSourceEnum;
+    /** Sólo en citas capturadas de la plataforma: pendiente de clasificar en el back office. */
+    pendingClassification?: boolean;
+    /** Todos los participantes eran del equipo interno: no ensucia reportes, no se borra. */
+    internal?: boolean;
+    /** Cuántos renglones de asistencia PARTICIPANT tiene (registrados o que entraron). Lo mantiene
+     *  meetings-business en la fila al cambiar la asistencia; el back office lo muestra sin recalcular. */
+    registeredCount?: number;
+    /** Cuántos de esos PARTICIPANT quedaron ATTENDED. Mismo mantenimiento que registeredCount. */
+    attendedCount?: number;
+    tenantId?: string;
+    /** Epoch ms, como el resto de la flota. */
+    createdAt?: number;
+    updatedAt?: number;
+    createdBy?: string;
+    updatedBy?: string;
+}
+
+/** Un invitado o co-anfitrión al crear o editar: nace como renglón de asistencia INVITED. */
+export class MeetingInviteeRequest {
+    role: MeetingAttendanceRoleEnum;
+    name?: string;
+    /** Obligatorio si la reunión es virtual: es por donde se avisa. */
+    email?: string;
+    /** Obligatorio si la reunión es por teléfono. */
+    phoneNumber?: string;
+    leadId?: string;
+    promoterId?: string;
+    directoryId?: string;
+}
+
+export class MeetingCreateRequest {
+    type: MeetingTypeEnum;
+    title: string;
+    description?: string;
+    classType?: string;
+    campaignId?: string;
+    startsAt: string;
+    durationMinutes: number;
+    timezone: string;
+    hostEmail: string;
+    hostName?: string;
+    modality: MeetingModalityEnum;
+    platform?: MeetingPlatformEnum;
+    /** Link cargado a mano cuando no se crea en la plataforma. */
+    meetingUrl?: string;
+    address?: string;
+    phoneNumber?: string;
+    /** Marcadas por defecto en el back office. */
+    registrationRequired?: boolean;
+    phoneRequired?: boolean;
+    formId?: string;
+    invitees?: MeetingInviteeRequest[];
+    registrationQuestions?: MeetingQuestionRef[];
+    polls?: MeetingQuestionRef[];
+    /** true = pedirle al connector que la cree en la plataforma (botón «Crear en Zoom»). */
+    createInPlatform?: boolean;
+    /** Repetición semanal: cuántas reuniones independientes crear (tope MEETING_REPEAT_MAX). */
+    repeatWeeks?: number;
+}
+
+export class MeetingUpdateRequest {
+    title?: string;
+    description?: string;
+    classType?: string;
+    campaignId?: string;
+    startsAt?: string;
+    durationMinutes?: number;
+    timezone?: string;
+    hostEmail?: string;
+    hostName?: string;
+    modality?: MeetingModalityEnum;
+    platform?: MeetingPlatformEnum;
+    meetingUrl?: string;
+    address?: string;
+    phoneNumber?: string;
+    registrationRequired?: boolean;
+    phoneRequired?: boolean;
+    formId?: string;
+    status?: MeetingStatusEnum;
+    invitees?: MeetingInviteeRequest[];
+}
+
+export class MeetingListResponse {
+    items: MeetingResponse[];
+    index: string | null;
+}