@fiado/type-kit 3.69.0 → 3.70.0

package/bin/index.d.ts

@@ -74,6 +74,7 @@ export * as CirculoCredito from './circuloCredito';
 export * as MilestoneBusiness from './milestone-business';
 export * as Mdm from './mdm';
 export * as MessagesConnector from './messagesConnector';
+export * as TwilioConnector from './twilioConnector';
 export * as CognitoBackofficeConnector from './cognitoBackofficeConnector';
 export * as PlatformRbac from './platformRbac';
 export * as Remittance from './remittance';

package/bin/index.js

@@ -37,7 +37,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = 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.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.App = exports.Address = exports.Beneficiary = exports.Activity = exports.Account = exports.Crypto = void 0;
-exports.TotpSecurity = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = 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.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = void 0;
+exports.TotpSecurity = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = 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.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.Activity = __importStar(require("./activity"));
@@ -114,6 +114,7 @@ exports.CirculoCredito = __importStar(require("./circuloCredito"));
 exports.MilestoneBusiness = __importStar(require("./milestone-business"));
 exports.Mdm = __importStar(require("./mdm"));
 exports.MessagesConnector = __importStar(require("./messagesConnector"));
+exports.TwilioConnector = __importStar(require("./twilioConnector"));
 exports.CognitoBackofficeConnector = __importStar(require("./cognitoBackofficeConnector"));
 // PlatformRbac: módulo del lambda platform-rbac-business (Fase 0 SureKeep).
 // Contiene Permission enum + AuthContext + RoleAssignmentInfo + PermissionScope +

package/bin/milestone-business/dtos/Milestone.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Forma completa de un Milestone tal como lo persiste y devuelve el lambda
+ * `milestone-business`. Es la representación canónica del item de la tabla DDB
+ * `Milestones` expuesta a consumers server-to-server (api-invoker).
+ *
+ * `value` es metadata libre asociada al evento (objeto de forma variable).
+ * `createdAt` / `updatedAt` son epoch ms (Dynamoose `timestamps: true`).
+ */
+export interface Milestone {
+    /** Identificador único del milestone. Determinístico: `${directoryId}#${eventKey}`. */
+    id: string;
+    /** directoryId del usuario al que pertenece el evento. */
+    directoryId: string;
+    /** Fecha en la que ocurrió el evento (epoch en milisegundos). */
+    eventDate: number;
+    /** Llave que identifica el tipo de evento/milestone. */
+    eventKey: string;
+    /** Metadata libre asociada al milestone (objeto con forma variable). */
+    value?: Record<string, unknown>;
+    /** Epoch ms de creación (Dynamoose timestamps). */
+    createdAt?: number;
+    /** Epoch ms de última actualización (Dynamoose timestamps). */
+    updatedAt?: number;
+}

package/bin/milestone-business/dtos/Milestone.js

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

package/bin/milestone-business/dtos/MilestonesByDirectoryIdsRequest.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cota máxima de directoryIds aceptados por request en el endpoint batch
+ * `privateListMilestonesByDirectoryIds`. Protege contra fan-out excesivo
+ * (cada directoryId dispara un query GSI con drenado de paginación).
+ */
+export declare const MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH = 100;
+/**
+ * Body de `POST /private/milestones/by-directory-ids`.
+ *
+ * Recibe una lista de directoryIds y devuelve, por cada uno, el array COMPLETO
+ * de milestones (paginación drenada del lado del lambda). Se usa POST en lugar
+ * de GET porque la lista puede ser larga y no cabe cómoda en query string.
+ *
+ * La cota de tamaño (`MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH`) se valida también
+ * en el manager para responder 400 explícito si se excede.
+ */
+export declare class MilestonesByDirectoryIdsRequest {
+    directoryIds: string[];
+}

package/bin/milestone-business/dtos/MilestonesByDirectoryIdsRequest.js

@@ -0,0 +1,39 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MilestonesByDirectoryIdsRequest = exports.MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Cota máxima de directoryIds aceptados por request en el endpoint batch
+ * `privateListMilestonesByDirectoryIds`. Protege contra fan-out excesivo
+ * (cada directoryId dispara un query GSI con drenado de paginación).
+ */
+exports.MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH = 100;
+/**
+ * Body de `POST /private/milestones/by-directory-ids`.
+ *
+ * Recibe una lista de directoryIds y devuelve, por cada uno, el array COMPLETO
+ * de milestones (paginación drenada del lado del lambda). Se usa POST en lugar
+ * de GET porque la lista puede ser larga y no cabe cómoda en query string.
+ *
+ * La cota de tamaño (`MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH`) se valida también
+ * en el manager para responder 400 explícito si se excede.
+ */
+class MilestonesByDirectoryIdsRequest {
+}
+exports.MilestonesByDirectoryIdsRequest = MilestonesByDirectoryIdsRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayMaxSize)(exports.MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], MilestonesByDirectoryIdsRequest.prototype, "directoryIds", void 0);

package/bin/milestone-business/dtos/MilestonesByDirectoryIdsResponse.d.ts

@@ -0,0 +1,10 @@
+import { Milestone } from "./Milestone";
+/**
+ * Respuesta de `POST /private/milestones/by-directory-ids`.
+ *
+ * Mapa directoryId -> array COMPLETO de milestones de ese directorio.
+ * Cada directoryId solicitado aparece como clave; si un directorio no tiene
+ * milestones, su valor es un array vacío `[]` (la clave NO se omite, para que
+ * el consumer pueda distinguir "consultado, sin milestones" de "no consultado").
+ */
+export type MilestonesByDirectoryIdsResponse = Record<string, Milestone[]>;

package/bin/milestone-business/dtos/MilestonesByDirectoryIdsResponse.js

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

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

@@ -1 +1,4 @@
 export { MilestonesByEventKeyDateRangeParams } from "./dtos/MilestonesByEventKeyDateRangeParams";
+export { Milestone } from "./dtos/Milestone";
+export { MilestonesByDirectoryIdsRequest, MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH, } from "./dtos/MilestonesByDirectoryIdsRequest";
+export { MilestonesByDirectoryIdsResponse } from "./dtos/MilestonesByDirectoryIdsResponse";

package/bin/milestone-business/index.js

@@ -1,2 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH = exports.MilestonesByDirectoryIdsRequest = void 0;
+var MilestonesByDirectoryIdsRequest_1 = require("./dtos/MilestonesByDirectoryIdsRequest");
+Object.defineProperty(exports, "MilestonesByDirectoryIdsRequest", { enumerable: true, get: function () { return MilestonesByDirectoryIdsRequest_1.MilestonesByDirectoryIdsRequest; } });
+Object.defineProperty(exports, "MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH", { enumerable: true, get: function () { return MilestonesByDirectoryIdsRequest_1.MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH; } });

package/bin/twilioConnector/dtos/ConnectorSendMessageRequest.d.ts

@@ -0,0 +1,27 @@
+import { SelectedProvider } from './SelectedProvider';
+/**
+ * Contrato de entrada `messages-business → twilio-connector`.
+ *
+ * messages-business resuelve el proveedor (plantilla, remitente, `secretRef`)
+ * desde el `senderConfig` del `(tenant, channel)` y lo manda ya resuelto en
+ * `selectedProvider`. El connector NO resuelve plantillas ni elige proveedor:
+ * solo transmite a Twilio y resuelve el secret indicado por `secretRef`.
+ *
+ * NOTA: `channelType` es `string` (no el enum) a proposito: el connector es un
+ * transporte tonto y maneja canales como WHATSAPP que aun no estan en
+ * `DeliveryChannelEnum`. El alta de WHATSAPP en el enum aplica al lado *inbound*
+ * (productor → messages-business), no a este contrato. Ver docs/cross-team en
+ * messages-business.
+ */
+export declare class ConnectorSendMessageRequest {
+    /** Canal de entrega. Ej: "WHATSAPP", "SMS". */
+    channelType: string;
+    /** Numero destino en formato E.164. Ej: "+50212345678". */
+    destination: string;
+    /** Tipo de mensaje de dominio. Ej: "OTP_CODE". Solo para logging/trazabilidad. */
+    messageType?: string;
+    /** Idioma de la plantilla. Ej: "ES". Solo para logging/trazabilidad. */
+    language?: string;
+    /** Proveedor ya seleccionado y resuelto por messages-business. */
+    selectedProvider: SelectedProvider;
+}

package/bin/twilioConnector/dtos/ConnectorSendMessageRequest.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorSendMessageRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const SelectedProvider_1 = require("./SelectedProvider");
+/**
+ * Contrato de entrada `messages-business → twilio-connector`.
+ *
+ * messages-business resuelve el proveedor (plantilla, remitente, `secretRef`)
+ * desde el `senderConfig` del `(tenant, channel)` y lo manda ya resuelto en
+ * `selectedProvider`. El connector NO resuelve plantillas ni elige proveedor:
+ * solo transmite a Twilio y resuelve el secret indicado por `secretRef`.
+ *
+ * NOTA: `channelType` es `string` (no el enum) a proposito: el connector es un
+ * transporte tonto y maneja canales como WHATSAPP que aun no estan en
+ * `DeliveryChannelEnum`. El alta de WHATSAPP en el enum aplica al lado *inbound*
+ * (productor → messages-business), no a este contrato. Ver docs/cross-team en
+ * messages-business.
+ */
+class ConnectorSendMessageRequest {
+}
+exports.ConnectorSendMessageRequest = ConnectorSendMessageRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "channelType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "destination", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "messageType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageRequest.prototype, "language", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => SelectedProvider_1.SelectedProvider),
+    __metadata("design:type", SelectedProvider_1.SelectedProvider)
+], ConnectorSendMessageRequest.prototype, "selectedProvider", void 0);

package/bin/twilioConnector/dtos/ConnectorSendMessageResponse.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Respuesta del twilio-connector tras delegar el envio a Twilio.
+ */
+export declare class ConnectorSendMessageResponse {
+    /** SID del mensaje generado por Twilio. */
+    providerMessageId: string;
+    /** Estado reportado por Twilio al momento del envio (queued, sent, ...). */
+    status: string;
+}

package/bin/twilioConnector/dtos/ConnectorSendMessageResponse.js

@@ -0,0 +1,30 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConnectorSendMessageResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Respuesta del twilio-connector tras delegar el envio a Twilio.
+ */
+class ConnectorSendMessageResponse {
+}
+exports.ConnectorSendMessageResponse = ConnectorSendMessageResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageResponse.prototype, "providerMessageId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConnectorSendMessageResponse.prototype, "status", void 0);

package/bin/twilioConnector/dtos/SelectedProvider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Proveedor ya resuelto por messages-business desde el `senderConfig` del
+ * `(tenant, channel)`. El twilio-connector es transporte tonto: solo transmite
+ * estos valores a Twilio. Los nombres son genericos para no acoplar el contrato
+ * al vocabulario del proveedor.
+ */
+export declare class SelectedProvider {
+    /** Plantilla del proveedor ya resuelta. Para Twilio se traduce a `contentSid` (HX...). */
+    templateId: string;
+    /** Remitente ya resuelto. Para Twilio = Messaging Service SID (MG...) o numero `from`. */
+    senderId: string;
+    /** Variables de la plantilla ya resueltas, keyeadas por slot posicional. Ej: { "1": "1234" }. */
+    contentVariables?: Record<string, string>;
+    /**
+     * Referencia (nombre/ARN) al secret de Secrets Manager con las credenciales
+     * de la cuenta de Twilio de este `(tenant, channel)`. Ej: "twilio/FIADO/credentials".
+     * El connector resuelve el secret real con esta referencia justo antes de enviar.
+     * Opcional: si se omite, el connector usa su secret por defecto (TWILIO_SECRET_NAME).
+     */
+    secretRef?: string;
+}

package/bin/twilioConnector/dtos/SelectedProvider.js

@@ -0,0 +1,47 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SelectedProvider = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Proveedor ya resuelto por messages-business desde el `senderConfig` del
+ * `(tenant, channel)`. El twilio-connector es transporte tonto: solo transmite
+ * estos valores a Twilio. Los nombres son genericos para no acoplar el contrato
+ * al vocabulario del proveedor.
+ */
+class SelectedProvider {
+}
+exports.SelectedProvider = SelectedProvider;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SelectedProvider.prototype, "templateId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], SelectedProvider.prototype, "senderId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], SelectedProvider.prototype, "contentVariables", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], SelectedProvider.prototype, "secretRef", void 0);

package/bin/twilioConnector/index.d.ts

@@ -0,0 +1,3 @@
+export * from './dtos/SelectedProvider';
+export * from './dtos/ConnectorSendMessageRequest';
+export * from './dtos/ConnectorSendMessageResponse';

package/bin/twilioConnector/index.js

@@ -0,0 +1,19 @@
+"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("./dtos/SelectedProvider"), exports);
+__exportStar(require("./dtos/ConnectorSendMessageRequest"), exports);
+__exportStar(require("./dtos/ConnectorSendMessageResponse"), exports);

package/package.json

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

package/src/index.ts

@@ -74,6 +74,7 @@ export * as CirculoCredito from './circuloCredito';
 export * as MilestoneBusiness from './milestone-business';
 export * as Mdm from './mdm';
 export * as MessagesConnector from './messagesConnector';
+export * as TwilioConnector from './twilioConnector';
 export * as CognitoBackofficeConnector from './cognitoBackofficeConnector';
 // PlatformRbac: módulo del lambda platform-rbac-business (Fase 0 SureKeep).
 // Contiene Permission enum + AuthContext + RoleAssignmentInfo + PermissionScope +

package/src/milestone-business/dtos/Milestone.ts

@@ -0,0 +1,24 @@
+/**
+ * Forma completa de un Milestone tal como lo persiste y devuelve el lambda
+ * `milestone-business`. Es la representación canónica del item de la tabla DDB
+ * `Milestones` expuesta a consumers server-to-server (api-invoker).
+ *
+ * `value` es metadata libre asociada al evento (objeto de forma variable).
+ * `createdAt` / `updatedAt` son epoch ms (Dynamoose `timestamps: true`).
+ */
+export interface Milestone {
+    /** Identificador único del milestone. Determinístico: `${directoryId}#${eventKey}`. */
+    id: string;
+    /** directoryId del usuario al que pertenece el evento. */
+    directoryId: string;
+    /** Fecha en la que ocurrió el evento (epoch en milisegundos). */
+    eventDate: number;
+    /** Llave que identifica el tipo de evento/milestone. */
+    eventKey: string;
+    /** Metadata libre asociada al milestone (objeto con forma variable). */
+    value?: Record<string, unknown>;
+    /** Epoch ms de creación (Dynamoose timestamps). */
+    createdAt?: number;
+    /** Epoch ms de última actualización (Dynamoose timestamps). */
+    updatedAt?: number;
+}

package/src/milestone-business/dtos/MilestonesByDirectoryIdsRequest.ts

@@ -0,0 +1,26 @@
+import { ArrayMaxSize, ArrayNotEmpty, IsArray, IsString } from "class-validator";
+
+/**
+ * Cota máxima de directoryIds aceptados por request en el endpoint batch
+ * `privateListMilestonesByDirectoryIds`. Protege contra fan-out excesivo
+ * (cada directoryId dispara un query GSI con drenado de paginación).
+ */
+export const MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH = 100;
+
+/**
+ * Body de `POST /private/milestones/by-directory-ids`.
+ *
+ * Recibe una lista de directoryIds y devuelve, por cada uno, el array COMPLETO
+ * de milestones (paginación drenada del lado del lambda). Se usa POST en lugar
+ * de GET porque la lista puede ser larga y no cabe cómoda en query string.
+ *
+ * La cota de tamaño (`MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH`) se valida también
+ * en el manager para responder 400 explícito si se excede.
+ */
+export class MilestonesByDirectoryIdsRequest {
+    @IsArray()
+    @ArrayNotEmpty()
+    @ArrayMaxSize(MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH)
+    @IsString({ each: true })
+    directoryIds!: string[];
+}

package/src/milestone-business/dtos/MilestonesByDirectoryIdsResponse.ts

@@ -0,0 +1,11 @@
+import { Milestone } from "./Milestone";
+
+/**
+ * Respuesta de `POST /private/milestones/by-directory-ids`.
+ *
+ * Mapa directoryId -> array COMPLETO de milestones de ese directorio.
+ * Cada directoryId solicitado aparece como clave; si un directorio no tiene
+ * milestones, su valor es un array vacío `[]` (la clave NO se omite, para que
+ * el consumer pueda distinguir "consultado, sin milestones" de "no consultado").
+ */
+export type MilestonesByDirectoryIdsResponse = Record<string, Milestone[]>;

package/src/milestone-business/index.ts

@@ -1,2 +1,8 @@
 // dtos
 export { MilestonesByEventKeyDateRangeParams } from "./dtos/MilestonesByEventKeyDateRangeParams";
+export { Milestone } from "./dtos/Milestone";
+export {
+    MilestonesByDirectoryIdsRequest,
+    MILESTONES_BY_DIRECTORY_IDS_MAX_BATCH,
+} from "./dtos/MilestonesByDirectoryIdsRequest";
+export { MilestonesByDirectoryIdsResponse } from "./dtos/MilestonesByDirectoryIdsResponse";

package/src/twilioConnector/dtos/ConnectorSendMessageRequest.ts

@@ -0,0 +1,34 @@
+import { Expose, Type } from 'class-transformer';
+import { IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { SelectedProvider } from './SelectedProvider';
+
+/**
+ * Contrato de entrada `messages-business → twilio-connector`.
+ *
+ * messages-business resuelve el proveedor (plantilla, remitente, `secretRef`)
+ * desde el `senderConfig` del `(tenant, channel)` y lo manda ya resuelto en
+ * `selectedProvider`. El connector NO resuelve plantillas ni elige proveedor:
+ * solo transmite a Twilio y resuelve el secret indicado por `secretRef`.
+ *
+ * NOTA: `channelType` es `string` (no el enum) a proposito: el connector es un
+ * transporte tonto y maneja canales como WHATSAPP que aun no estan en
+ * `DeliveryChannelEnum`. El alta de WHATSAPP en el enum aplica al lado *inbound*
+ * (productor → messages-business), no a este contrato. Ver docs/cross-team en
+ * messages-business.
+ */
+export class ConnectorSendMessageRequest {
+    /** Canal de entrega. Ej: "WHATSAPP", "SMS". */
+    @Expose() @IsString() @IsNotEmpty() channelType!: string;
+
+    /** Numero destino en formato E.164. Ej: "+50212345678". */
+    @Expose() @IsString() @IsNotEmpty() destination!: string;
+
+    /** Tipo de mensaje de dominio. Ej: "OTP_CODE". Solo para logging/trazabilidad. */
+    @Expose() @IsOptional() @IsString() messageType?: string;
+
+    /** Idioma de la plantilla. Ej: "ES". Solo para logging/trazabilidad. */
+    @Expose() @IsOptional() @IsString() language?: string;
+
+    /** Proveedor ya seleccionado y resuelto por messages-business. */
+    @Expose() @ValidateNested() @Type(() => SelectedProvider) selectedProvider!: SelectedProvider;
+}

package/src/twilioConnector/dtos/ConnectorSendMessageResponse.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/**
+ * Respuesta del twilio-connector tras delegar el envio a Twilio.
+ */
+export class ConnectorSendMessageResponse {
+    /** SID del mensaje generado por Twilio. */
+    @Expose() @IsString() providerMessageId!: string;
+
+    /** Estado reportado por Twilio al momento del envio (queued, sent, ...). */
+    @Expose() @IsString() status!: string;
+}

package/src/twilioConnector/dtos/SelectedProvider.ts

@@ -0,0 +1,27 @@
+import { Expose } from 'class-transformer';
+import { IsNotEmpty, IsObject, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Proveedor ya resuelto por messages-business desde el `senderConfig` del
+ * `(tenant, channel)`. El twilio-connector es transporte tonto: solo transmite
+ * estos valores a Twilio. Los nombres son genericos para no acoplar el contrato
+ * al vocabulario del proveedor.
+ */
+export class SelectedProvider {
+    /** Plantilla del proveedor ya resuelta. Para Twilio se traduce a `contentSid` (HX...). */
+    @Expose() @IsString() @IsNotEmpty() templateId!: string;
+
+    /** Remitente ya resuelto. Para Twilio = Messaging Service SID (MG...) o numero `from`. */
+    @Expose() @IsString() @IsNotEmpty() senderId!: string;
+
+    /** Variables de la plantilla ya resueltas, keyeadas por slot posicional. Ej: { "1": "1234" }. */
+    @Expose() @IsOptional() @IsObject() contentVariables?: Record<string, string>;
+
+    /**
+     * Referencia (nombre/ARN) al secret de Secrets Manager con las credenciales
+     * de la cuenta de Twilio de este `(tenant, channel)`. Ej: "twilio/FIADO/credentials".
+     * El connector resuelve el secret real con esta referencia justo antes de enviar.
+     * Opcional: si se omite, el connector usa su secret por defecto (TWILIO_SECRET_NAME).
+     */
+    @Expose() @IsOptional() @IsString() secretRef?: string;
+}

package/src/twilioConnector/index.ts

@@ -0,0 +1,3 @@
+export * from './dtos/SelectedProvider';
+export * from './dtos/ConnectorSendMessageRequest';
+export * from './dtos/ConnectorSendMessageResponse';