@fiado/type-kit 3.603.0 → 3.605.0

package/_test_/unit/retailIntegration/retailMovementsContracts.test.ts

@@ -4,9 +4,11 @@ import { validateSync } from 'class-validator';
 import {
     GetRetailInventoryRequest,
     type GetRetailInventoryResponse,
+    type InvalidRetailInventoryMovement,
     ListRetailInventoryMovementsRequest,
     type ListRetailInventoryMovementsResponse,
     ReconciliationEntityEnum,
+    RetailEventRejectCodeEnum,
     ReconciliationPageMessage,
     ReconciliationTriggerEnum,
 } from '../../../src/retailIntegration';
@@ -61,6 +63,17 @@ describe('ListRetailInventoryMovementsRequest', () => {
             meta: { count: 1, nextToken: null },
         };
         expect(response.meta.nextToken).toBeNull();
+        expect(response.invalidItems).toBeUndefined();
+    });
+
+    it('la respuesta lista los movimientos inválidos con índice, eventId opcional y rutas', () => {
+        const invalid: InvalidRetailInventoryMovement[] = [
+            { index: 3, eventId: 'evt-4', code: RetailEventRejectCodeEnum.INVALID_PAYLOAD, invalidPaths: ['payload.storeId'] },
+            { index: 7, code: RetailEventRejectCodeEnum.INVALID_PAYLOAD, invalidPaths: ['eventId', 'occurredAt'] },
+        ];
+        const response: ListRetailInventoryMovementsResponse = { items: [], meta: { count: 0, nextToken: null }, invalidItems: invalid };
+        expect(response.invalidItems?.map((i) => i.index)).toEqual([3, 7]);
+        expect(response.invalidItems?.[1].eventId).toBeUndefined();
     });
 });
 

package/_test_/unit/retailIntegration/retailSaleContracts.test.ts

@@ -26,7 +26,7 @@ async function errorsOf(cls: new () => object, plain: object): Promise<string[]>
 const cashPayment = { method: 'CASH', amount: '400.00', cardLast4: null, authCode: null, speiTrackingKey: null, senderClabe: null } as const;
 const cardPayment = { method: 'CARD', amount: '200.00', cardLast4: '4242', authCode: 'A1B2C3', speiTrackingKey: null, senderClabe: null } as const;
 const wirePayment = {
-    method: 'WIRE', amount: '200.00', cardLast4: null, authCode: null, speiTrackingKey: '123456789012345678', senderClabe: '012180001234567897',
+    method: 'WIRE', amount: '200.00', cardLast4: null, authCode: null, speiTrackingKey: 'MBAN01002610160000123ABCD', senderClabe: '012180001234567897',
 } as const;
 
 // Literal tipado: prueba en compilación que la clase sigue aceptando objetos planos.
@@ -145,6 +145,11 @@ describe('RetailSystemSale.payments', () => {
         expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, senderClabe: null }] })).toEqual([]);
     });
 
+    it('acepta speiTrackingKey de 1 a 30 alfanuméricos', async () => {
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, speiTrackingKey: '7' }] })).toEqual([]);
+        expect(await errorsOf(RetailSystemSale, { ...sale, payments: [cashPayment, { ...wirePayment, speiTrackingKey: 'A'.repeat(30) }] })).toEqual([]);
+    });
+
     it('acepta FIADO sin detalle', async () => {
         expect(await errorsOf(RetailSystemSale, { ...sale, payments: [{ ...cashPayment, method: 'FIADO', amount: '600.00' }] })).toEqual([]);
     });
@@ -182,7 +187,11 @@ describe('RetailSystemSale.payments', () => {
 
     it.each([
         ['speiTrackingKey', { speiTrackingKey: null }],
-        ['speiTrackingKey', { speiTrackingKey: '12345' }],
+        ['speiTrackingKey', { speiTrackingKey: '' }],
+        ['speiTrackingKey', { speiTrackingKey: 'A'.repeat(31) }],
+        ['speiTrackingKey', { speiTrackingKey: 'MBAN-0100-2610' }],
+        ['speiTrackingKey', { speiTrackingKey: 'MBAN 01002610' }],
+        ['senderClabe', { senderClabe: '01218000123456789A' }],
         ['senderClabe', { senderClabe: '0121' }],
         ['cardLast4', { cardLast4: '4242' }],
     ])('rechaza %s fuera de regla en WIRE', async (field, patch) => {

package/bin/index.d.ts

@@ -129,6 +129,7 @@ export * as RewardsEligibility from './rewardsEligibility';
 export * as DatalakeReports from './datalakeReports';
 export * as PdfRender from './pdfRender';
 export * as Rules from './rules';
+export * as Meetings from './meetings';
 export * as LoanRetailAudit from './loanRetailAudit';
 export * as TaskManager from './task-manager-business';
 export * as CustomerMessages from './customerMessages';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.FiadoIncFavorite = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.MessageMoments = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.UsMarketGrowthBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = void 0;
-exports.CustomerMessages = exports.TaskManager = exports.LoanRetailAudit = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
+exports.CustomerMessages = exports.TaskManager = exports.LoanRetailAudit = exports.Meetings = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -252,6 +252,9 @@ exports.DatalakeReports = __importStar(require("./datalakeReports"));
 exports.PdfRender = __importStar(require("./pdfRender"));
 // Rules: DTOs del lambda central rules-business (catálogo, validación, generación con IA y evaluación de reglas).
 exports.Rules = __importStar(require("./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.
+exports.Meetings = __importStar(require("./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.
 exports.LoanRetailAudit = __importStar(require("./loanRetailAudit"));

package/bin/meetings/constants/MeetingLimits.d.ts

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

package/bin/meetings/constants/MeetingLimits.js

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

package/bin/meetings/dtos/MeetingAttendanceResponse.d.ts

@@ -0,0 +1,61 @@
+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 declare 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 declare 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 declare 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 declare class MeetingAttendanceMarkRequest {
+    items: MeetingAttendanceMarkItem[];
+}
+export declare class MeetingAttendanceListResponse {
+    items: MeetingAttendanceResponse[];
+    index: string | null;
+}

package/bin/meetings/dtos/MeetingAttendanceResponse.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetingAttendanceListResponse = exports.MeetingAttendanceMarkRequest = exports.MeetingAttendanceMarkItem = exports.MeetingAttendanceResponse = exports.MeetingAnswer = void 0;
+/** Una respuesta guardada en el renglón de asistencia (del registro o de la encuesta en vivo). */
+class MeetingAnswer {
+}
+exports.MeetingAnswer = MeetingAnswer;
+/** Una persona en una reunión, desde que se la invita o se registra. Los anfitriones también. */
+class MeetingAttendanceResponse {
+}
+exports.MeetingAttendanceResponse = MeetingAttendanceResponse;
+/** Marcar asistencia fuera de la plataforma: lo marcado queda ATTENDED y los invitados sin marcar, NO_SHOW. */
+class MeetingAttendanceMarkItem {
+}
+exports.MeetingAttendanceMarkItem = MeetingAttendanceMarkItem;
+class MeetingAttendanceMarkRequest {
+}
+exports.MeetingAttendanceMarkRequest = MeetingAttendanceMarkRequest;
+class MeetingAttendanceListResponse {
+}
+exports.MeetingAttendanceListResponse = MeetingAttendanceListResponse;

package/bin/meetings/dtos/MeetingFormResponse.d.ts

@@ -0,0 +1,28 @@
+/** Un formulario que se manda a los asistentes (el formId de la reunión). Los carga Silvia; no se borran. */
+export declare 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 declare class MeetingFormUpsertRequest {
+    name: string;
+    url: string;
+    templateId: string;
+    skipPromoters?: boolean;
+    active?: boolean;
+}
+export declare class MeetingFormListResponse {
+    items: MeetingFormResponse[];
+    index: string | null;
+}

package/bin/meetings/dtos/MeetingFormResponse.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetingFormListResponse = exports.MeetingFormUpsertRequest = exports.MeetingFormResponse = void 0;
+/** Un formulario que se manda a los asistentes (el formId de la reunión). Los carga Silvia; no se borran. */
+class MeetingFormResponse {
+}
+exports.MeetingFormResponse = MeetingFormResponse;
+class MeetingFormUpsertRequest {
+}
+exports.MeetingFormUpsertRequest = MeetingFormUpsertRequest;
+class MeetingFormListResponse {
+}
+exports.MeetingFormListResponse = MeetingFormListResponse;

package/bin/meetings/dtos/MeetingLeadResponse.d.ts

@@ -0,0 +1,43 @@
+import { MeetingLeadSourceEnum } from '../enums/MeetingLeadSourceEnum';
+/** Una persona del padrón, una sola vez. Promotor, directorio o cuenta son estados colgados de la fila. */
+export declare 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 declare class MeetingLeadListResponse {
+    items: MeetingLeadResponse[];
+    index: string | null;
+}
+export declare 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 declare class MeetingLeadTagsRequest {
+    add?: string[];
+    remove?: string[];
+    /** En qué reunión se ganó, si aplica. */
+    meetingId?: string;
+}

package/bin/meetings/dtos/MeetingLeadResponse.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetingLeadTagsRequest = exports.MeetingLeadCreateRequest = exports.MeetingLeadListResponse = exports.MeetingLeadResponse = void 0;
+/** Una persona del padrón, una sola vez. Promotor, directorio o cuenta son estados colgados de la fila. */
+class MeetingLeadResponse {
+}
+exports.MeetingLeadResponse = MeetingLeadResponse;
+class MeetingLeadListResponse {
+}
+exports.MeetingLeadListResponse = MeetingLeadListResponse;
+class MeetingLeadCreateRequest {
+}
+exports.MeetingLeadCreateRequest = MeetingLeadCreateRequest;
+/** PUT /leads/{id}/tags: etiquetas a mano, contra la lista blanca de MeetingLeadTagEnum. */
+class MeetingLeadTagsRequest {
+}
+exports.MeetingLeadTagsRequest = MeetingLeadTagsRequest;

package/bin/meetings/dtos/MeetingPollRef.d.ts

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

package/bin/meetings/dtos/MeetingPollRef.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetingPollRef = void 0;
+const MeetingQuestionRef_1 = require("./MeetingQuestionRef");
+/** Una encuesta precargada en la plataforma; externalPollId llega al crearla allá. */
+class MeetingPollRef extends MeetingQuestionRef_1.MeetingQuestionRef {
+}
+exports.MeetingPollRef = MeetingPollRef;

package/bin/meetings/dtos/MeetingQuestionRef.d.ts

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

package/bin/meetings/dtos/MeetingQuestionRef.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetingQuestionRef = void 0;
+/** Una pregunta del catálogo elegida para una reunión, con la versión congelada al elegirla. */
+class MeetingQuestionRef {
+}
+exports.MeetingQuestionRef = MeetingQuestionRef;

package/bin/meetings/dtos/MeetingQuestionResponse.d.ts

@@ -0,0 +1,48 @@
+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 declare class MeetingQuestionOption {
+    ref: string;
+    value: string;
+    /** Etiqueta que gana quien la elige, si la pregunta es clasificatoria. */
+    tag?: string;
+}
+export declare 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 declare 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 declare class MeetingQuestionUpsertRequest {
+    title: string;
+    questions: MeetingQuestionItem[];
+    active?: boolean;
+}
+export declare class MeetingQuestionListResponse {
+    items: MeetingQuestionCatalogResponse[];
+    index: string | null;
+}

package/bin/meetings/dtos/MeetingQuestionResponse.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeetingQuestionListResponse = exports.MeetingQuestionUpsertRequest = exports.MeetingQuestionCatalogResponse = exports.MeetingQuestionItem = exports.MeetingQuestionOption = void 0;
+/** Una opción de una pregunta cerrada. La referencia es estable; el texto puede cambiar. */
+class MeetingQuestionOption {
+}
+exports.MeetingQuestionOption = MeetingQuestionOption;
+class MeetingQuestionItem {
+}
+exports.MeetingQuestionItem = MeetingQuestionItem;
+/** Una encuesta del catálogo, versionada: cada edición crea una versión nueva y conserva la vieja. */
+class MeetingQuestionCatalogResponse {
+}
+exports.MeetingQuestionCatalogResponse = MeetingQuestionCatalogResponse;
+class MeetingQuestionUpsertRequest {
+}
+exports.MeetingQuestionUpsertRequest = MeetingQuestionUpsertRequest;
+class MeetingQuestionListResponse {
+}
+exports.MeetingQuestionListResponse = MeetingQuestionListResponse;

package/bin/meetings/dtos/MeetingQueueEvents.d.ts

@@ -0,0 +1,85 @@
+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 declare 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/bin/meetings/dtos/MeetingQueueEvents.js

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

package/bin/meetings/dtos/MeetingResponse.d.ts

@@ -0,0 +1,131 @@
+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 declare 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 declare 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 declare 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 declare 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 declare class MeetingListResponse {
+    items: MeetingResponse[];
+    index: string | null;
+}