@fiado/type-kit 3.153.0 → 3.155.0

package/_test_/unit/platformRbac/auth/PrepareChallengeRequest.test.ts

@@ -5,7 +5,7 @@ import { PrepareChallengeRequest } from '../../../../src/platformRbac/auth/Prepa
 import { ChallengeNameEnum } from '../../../../src/platformRbac/enums/ChallengeNameEnum';
 
 /**
- * DEC-RBAC-093: `email` es opcional y robusto a string vacío. Un usuario phone-primario
+ * DEC-RBAC-094: `email` es opcional y robusto a string vacío. Un usuario phone-primario
  * (sin email) hace login MFA (SMS_OTP / TOTP) sin email — el trigger CreateAuthChallenge
  * ya no manda `''`. `@ValidateIf` saltea undefined/null/'' (`@IsOptional` NO saltea `''`).
  * La rama EMAIL_OTP del preparer sigue necesitando email en runtime — eso NO lo valida el DTO.

package/bin/messagesConnector/dtos/AgentSendNotificationRequest.d.ts

@@ -0,0 +1,26 @@
+import { DeliveryChannelEnum } from '../../messaging';
+/**
+ * DTO del endpoint agent `POST /v2/agents/notifications` (messages-business).
+ * Espejo de SendMessageRequest, pero `directoryId` es opcional/string (NO @IsUUID):
+ * el flujo agent (shortlink SMS pre-onboarding) manda el literal "NONE" cuando aún
+ * no hay una persona con UUID.
+ */
+export declare class AgentSendNotificationRequest {
+    channelType: DeliveryChannelEnum;
+    messageType: string;
+    directoryId?: string;
+    typeOfDirectory: string;
+    language: string;
+    country: string;
+    destination?: string;
+    var1?: string;
+    var2?: string;
+    var3?: string;
+    var4?: string;
+    var5?: string;
+    beneficiaryDirectoryId?: string;
+    beneficiaryTypeOfDirectoryId?: string;
+    options?: Record<string, unknown>;
+    referenceMessageId?: string;
+    transactionNumber?: string;
+}

package/bin/messagesConnector/dtos/AgentSendNotificationRequest.js

@@ -0,0 +1,125 @@
+"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.AgentSendNotificationRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const messaging_1 = require("../../messaging");
+/**
+ * DTO del endpoint agent `POST /v2/agents/notifications` (messages-business).
+ * Espejo de SendMessageRequest, pero `directoryId` es opcional/string (NO @IsUUID):
+ * el flujo agent (shortlink SMS pre-onboarding) manda el literal "NONE" cuando aún
+ * no hay una persona con UUID.
+ */
+class AgentSendNotificationRequest {
+}
+exports.AgentSendNotificationRequest = AgentSendNotificationRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(messaging_1.DeliveryChannelEnum),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "channelType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "messageType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "typeOfDirectory", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "language", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "country", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "destination", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "var1", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "var2", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "var3", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "var4", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "var5", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "beneficiaryDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "beneficiaryTypeOfDirectoryId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], AgentSendNotificationRequest.prototype, "options", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "referenceMessageId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], AgentSendNotificationRequest.prototype, "transactionNumber", void 0);

package/bin/messagesConnector/index.d.ts

@@ -2,6 +2,7 @@ export * from './enums/DeliveryChannelExtendedEnum';
 export * from './validators/IsStringValueRecord';
 export * from './dtos/NotificationQueueMessageRequestV2';
 export * from './dtos/SendMessageRequest';
+export * from './dtos/AgentSendNotificationRequest';
 export * from './dtos/SendMessageResponse';
 export * from './dtos/VerifyOtpRequest';
 export * from './dtos/VerifyOtpResponse';

package/bin/messagesConnector/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./enums/DeliveryChannelExtendedEnum"), exports);
 __exportStar(require("./validators/IsStringValueRecord"), exports);
 __exportStar(require("./dtos/NotificationQueueMessageRequestV2"), exports);
 __exportStar(require("./dtos/SendMessageRequest"), exports);
+__exportStar(require("./dtos/AgentSendNotificationRequest"), exports);
 __exportStar(require("./dtos/SendMessageResponse"), exports);
 __exportStar(require("./dtos/VerifyOtpRequest"), exports);
 __exportStar(require("./dtos/VerifyOtpResponse"), exports);

package/bin/platformRbac/dtos/ResendOtpRequest.d.ts

@@ -0,0 +1,22 @@
+import { MfaMethodEnum } from '../enums/MfaMethodEnum';
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+export declare class ResendOtpRequest {
+    email: string;
+    tenantId: string;
+}
+/**
+ * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
+ * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
+ * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
+ * el server responde 200 genérico sin session ni método.
+ */
+export interface ResendOtpResponse {
+    session?: string;
+    mfaMethod?: MfaMethodEnum;
+}

package/bin/{walletFunding/dtos/CancelFundingRequest.js → platformRbac/dtos/ResendOtpRequest.js}

@@ -9,25 +9,28 @@ 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.CancelFundingRequest = void 0;
+exports.ResendOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
- * Request del cancel via Centro de Beneficios (spec 13 v2.0).
- * `fundingId` viaja en el path, `directoryId` se resuelve del JWT.
- * `providerModuleName` permite al marketplace rutear al publisher correcto
- * sin tener que persistir el mapping (el wallet-app sabe el moduleName
- * porque vino en la respuesta del authorize).
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
  */
-class CancelFundingRequest {
+class ResendOtpRequest {
 }
-exports.CancelFundingRequest = CancelFundingRequest;
+exports.ResendOtpRequest = ResendOtpRequest;
 __decorate([
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(64),
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], CancelFundingRequest.prototype, "idempotencyKey", void 0);
+], ResendOtpRequest.prototype, "email", void 0);
 __decorate([
+    (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(128),
+    (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
-], CancelFundingRequest.prototype, "providerModuleName", void 0);
+], ResendOtpRequest.prototype, "tenantId", void 0);

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+export declare class ResendSelfRegisterOtpRequest {
+    tenantId: string;
+    email: string;
+}

package/bin/{cognitoBackofficeConnector/dtos/MfaPoolConfig.js → platformRbac/dtos/ResendSelfRegisterOtpRequest.js}

@@ -9,28 +9,28 @@ 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.MfaPoolConfig = void 0;
+exports.ResendSelfRegisterOtpRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
-const MfaTypesRequiresOne_1 = require("../validators/MfaTypesRequiresOne");
-// EMAIL_OTP removido (3.41.0): el cognito-backoffice-connector no provisiona
-// EmailMfaConfiguration a nivel pool (requiere infra SES que no está montada
-// y la integración con messages-lambda aún no tiene diseño). Ver TD-020 +
-// DEC-001 en cognito-backoffice-connector/docs/. Si se reintroduce, agregar
-// 'EMAIL_OTP' a este array.
-const ALLOWED_MFA_TYPES = ['SOFTWARE_TOKEN_MFA'];
-class MfaPoolConfig {
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+class ResendSelfRegisterOtpRequest {
 }
-exports.MfaPoolConfig = MfaPoolConfig;
+exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsBoolean)(),
-    __metadata("design:type", Boolean)
-], MfaPoolConfig.prototype, "requireMfa", void 0);
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "tenantId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsArray)(),
-    (0, class_validator_1.IsIn)(ALLOWED_MFA_TYPES, { each: true }),
-    (0, class_validator_1.Validate)(MfaTypesRequiresOne_1.MfaTypesRequiresOne),
-    __metadata("design:type", Array)
-], MfaPoolConfig.prototype, "mfaTypes", void 0);
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "email", void 0);

package/bin/remittance/dtos/RemittancePromotion.d.ts

@@ -0,0 +1,90 @@
+import { FeeEffectMode } from "../enums/FeeEffectMode";
+import { FxEffectMode } from "../enums/FxEffectMode";
+import { PromotionActivation } from "../enums/PromotionActivation";
+import { PromotionKind } from "../enums/PromotionKind";
+import { PromotionStatus } from "../enums/PromotionStatus";
+import { RemittanceCorridor } from "../enums/RemittanceCorridor";
+/** Audiencia: null en una dimensión = "Cualquiera". */
+export declare class PromotionAudience {
+    corridor?: RemittanceCorridor | null;
+    segmentId?: string | null;
+    cohortId?: string | null;
+}
+/** Efecto FX (spread): DELTA suma bps CON SIGNO al markup base; ABSOLUTE lo reemplaza. */
+export declare class FxEffect {
+    mode: FxEffectMode;
+    /** bps con signo. Ignorado si mode=NONE (mandar 0). */
+    valueBps: number;
+}
+/** Efecto fee: ABSOLUTE = $; DELTA = ±$; PERCENTAGE = −% del fee (0-100). */
+export declare class FeeEffect {
+    mode: FeeEffectMode;
+    value: number;
+}
+export declare class CreatePromotionRequest {
+    name: string;
+    kind: PromotionKind;
+    activation: PromotionActivation;
+    /** Requerido si activation=CODE (regla en manager); único case-insensitive. */
+    code?: string | null;
+    audience: PromotionAudience;
+    /** ISO date (YYYY-MM-DD). */
+    effectiveFrom: string;
+    /** ISO date; null/ausente = permanente (∞). */
+    effectiveTo?: string | null;
+    fxEffect: FxEffect;
+    feeEffect: FeeEffect;
+    notes?: string | null;
+}
+/** PUT — reemplazo completo (mismos campos que create). */
+export declare class UpdatePromotionRequest extends CreatePromotionRequest {
+}
+/** Promoción completa (response de list/create/update). */
+export declare class Promotion {
+    id: string;
+    name: string;
+    kind: PromotionKind;
+    activation: PromotionActivation;
+    code: string | null;
+    audience: {
+        corridor: RemittanceCorridor | null;
+        segmentId: string | null;
+        cohortId: string | null;
+    };
+    /** Display: nombres resueltos de segmento/cohort (null = "Cualquiera" o no resoluble). */
+    audienceDisplay: {
+        corridor: string | null;
+        segmentName: string | null;
+        cohortName: string | null;
+    };
+    effectiveFrom: string;
+    effectiveTo: string | null;
+    fxEffect: {
+        mode: FxEffectMode;
+        valueBps: number;
+    };
+    feeEffect: {
+        mode: FeeEffectMode;
+        value: number;
+    };
+    /** Derivado de la vigencia vs hoy (UTC). */
+    status: PromotionStatus;
+    /** Legible para la columna EFECTO: "MU −30 bps + Fee = $0". */
+    effectSummary: string;
+    notes: string | null;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}
+/** Response de GET /backoffice/pricing/promotions. */
+export declare class PromotionListResponse {
+    items: Promotion[];
+}
+/** Response de GET /backoffice/pricing/promotions/reach. */
+export declare class PromotionReachResponse {
+    /** Clientes en la intersección corridor × segmento × cohort. */
+    reach: number;
+    /** Universo (todos los RemittanceUsers) — para el % del picker. */
+    total: number;
+}

package/bin/remittance/dtos/RemittancePromotion.js

@@ -0,0 +1,150 @@
+"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.PromotionReachResponse = exports.PromotionListResponse = exports.Promotion = exports.UpdatePromotionRequest = exports.CreatePromotionRequest = exports.FeeEffect = exports.FxEffect = exports.PromotionAudience = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const FeeEffectMode_1 = require("../enums/FeeEffectMode");
+const FxEffectMode_1 = require("../enums/FxEffectMode");
+const PromotionActivation_1 = require("../enums/PromotionActivation");
+const PromotionKind_1 = require("../enums/PromotionKind");
+const RemittanceCorridor_1 = require("../enums/RemittanceCorridor");
+/**
+ * DTOs de Promociones (Dashboard Ops · Variables Operativas §2).
+ *
+ * UniTeller NO participa (no hay motor de promos en API Lite): toda la lógica
+ * vive en Fiado. Una promo es un OVERRIDE de Precio Base (markup y/o fee) para
+ * una audiencia (corridor × segmento × cohort, null = Cualquiera) y vigencia.
+ * Dueño de la tabla: remittance-business (RemittancePromotions_GT). La
+ * resolución en send-time (capas: base → PRICE_CHANGE → mejor-para-el-cliente)
+ * es Fase B — estos DTOs cubren la config.
+ */
+const ISO_DATE = /^\d{4}-\d{2}-\d{2}$/;
+/** Audiencia: null en una dimensión = "Cualquiera". */
+class PromotionAudience {
+}
+exports.PromotionAudience = PromotionAudience;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RemittanceCorridor_1.RemittanceCorridor),
+    __metadata("design:type", String)
+], PromotionAudience.prototype, "corridor", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 100),
+    __metadata("design:type", String)
+], PromotionAudience.prototype, "segmentId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 100),
+    __metadata("design:type", String)
+], PromotionAudience.prototype, "cohortId", void 0);
+/** Efecto FX (spread): DELTA suma bps CON SIGNO al markup base; ABSOLUTE lo reemplaza. */
+class FxEffect {
+}
+exports.FxEffect = FxEffect;
+__decorate([
+    (0, class_validator_1.IsEnum)(FxEffectMode_1.FxEffectMode),
+    __metadata("design:type", String)
+], FxEffect.prototype, "mode", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(-500),
+    (0, class_validator_1.Max)(500),
+    __metadata("design:type", Number)
+], FxEffect.prototype, "valueBps", void 0);
+/** Efecto fee: ABSOLUTE = $; DELTA = ±$; PERCENTAGE = −% del fee (0-100). */
+class FeeEffect {
+}
+exports.FeeEffect = FeeEffect;
+__decorate([
+    (0, class_validator_1.IsEnum)(FeeEffectMode_1.FeeEffectMode),
+    __metadata("design:type", String)
+], FeeEffect.prototype, "mode", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(-100),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], FeeEffect.prototype, "value", void 0);
+class CreatePromotionRequest {
+}
+exports.CreatePromotionRequest = CreatePromotionRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 100),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(PromotionKind_1.PromotionKind),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "kind", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(PromotionActivation_1.PromotionActivation),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "activation", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 30),
+    (0, class_validator_1.Matches)(/^[A-Z0-9_-]+$/i),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "code", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => PromotionAudience),
+    __metadata("design:type", PromotionAudience)
+], CreatePromotionRequest.prototype, "audience", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(ISO_DATE),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "effectiveFrom", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(ISO_DATE),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "effectiveTo", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => FxEffect),
+    __metadata("design:type", FxEffect)
+], CreatePromotionRequest.prototype, "fxEffect", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => FeeEffect),
+    __metadata("design:type", FeeEffect)
+], CreatePromotionRequest.prototype, "feeEffect", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "notes", void 0);
+/** PUT — reemplazo completo (mismos campos que create). */
+class UpdatePromotionRequest extends CreatePromotionRequest {
+}
+exports.UpdatePromotionRequest = UpdatePromotionRequest;
+/** Promoción completa (response de list/create/update). */
+class Promotion {
+}
+exports.Promotion = Promotion;
+/** Response de GET /backoffice/pricing/promotions. */
+class PromotionListResponse {
+}
+exports.PromotionListResponse = PromotionListResponse;
+/** Response de GET /backoffice/pricing/promotions/reach. */
+class PromotionReachResponse {
+}
+exports.PromotionReachResponse = PromotionReachResponse;

package/bin/remittance/dtos/index.d.ts

@@ -41,3 +41,4 @@ export * from "./RemittanceAuditLog";
 export * from "./RemittanceSegment";
 export * from "./RemittanceCommittee";
 export * from "./RemittancePricing";
+export * from "./RemittancePromotion";

package/bin/remittance/dtos/index.js

@@ -57,3 +57,4 @@ __exportStar(require("./RemittanceAuditLog"), exports);
 __exportStar(require("./RemittanceSegment"), exports);
 __exportStar(require("./RemittanceCommittee"), exports);
 __exportStar(require("./RemittancePricing"), exports);
+__exportStar(require("./RemittancePromotion"), exports);

package/bin/remittance/dtos/internal/RemittancePromotionReach.d.ts

@@ -0,0 +1,17 @@
+import { CohortCondition } from "../RemittanceCohort";
+import { RemittanceCorridor } from "../../enums/RemittanceCorridor";
+/**
+ * Contrato interno del reach de Promociones (puente Opción A):
+ * POST /backoffice/config/promotions/reach (privado connector). rb resuelve las
+ * dimensiones a datos crudos — segmento → directoryIds; cohort → conditions;
+ * corredor → corridor — y el connector computa la intersección sobre el universo
+ * de RemittanceUsers. Toda dimensión AUSENTE = no filtra ("Cualquiera").
+ */
+export declare class PromotionReachRequest {
+    /** Miembros del segmento (resueltos por rb). Ausente = todos los usuarios. */
+    directoryIds?: string[];
+    /** Condiciones del cohort (AND, evaluadas como en cohortCount). Ausente = sin filtro. */
+    conditions?: CohortCondition[];
+    /** Filtro por corredor (countryISO de CORRIDOR_INFO, ≥1 tx no-cancelada histórica). Ausente = sin filtro. */
+    corridor?: RemittanceCorridor;
+}

package/bin/remittance/dtos/internal/RemittancePromotionReach.js

@@ -0,0 +1,44 @@
+"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.PromotionReachRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RemittanceCohort_1 = require("../RemittanceCohort");
+const RemittanceCorridor_1 = require("../../enums/RemittanceCorridor");
+/**
+ * Contrato interno del reach de Promociones (puente Opción A):
+ * POST /backoffice/config/promotions/reach (privado connector). rb resuelve las
+ * dimensiones a datos crudos — segmento → directoryIds; cohort → conditions;
+ * corredor → corridor — y el connector computa la intersección sobre el universo
+ * de RemittanceUsers. Toda dimensión AUSENTE = no filtra ("Cualquiera").
+ */
+class PromotionReachRequest {
+}
+exports.PromotionReachRequest = PromotionReachRequest;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsUUID)("4", { each: true }),
+    __metadata("design:type", Array)
+], PromotionReachRequest.prototype, "directoryIds", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RemittanceCohort_1.CohortCondition),
+    __metadata("design:type", Array)
+], PromotionReachRequest.prototype, "conditions", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(RemittanceCorridor_1.RemittanceCorridor),
+    __metadata("design:type", String)
+], PromotionReachRequest.prototype, "corridor", void 0);

package/bin/remittance/enums/FeeEffectMode.d.ts

@@ -0,0 +1,7 @@
+/** Efecto de la promo sobre el service fee (relativo a la base efectiva). */
+export declare enum FeeEffectMode {
+    NONE = "NONE",// sin cambio
+    ABSOLUTE = "ABSOLUTE",// fee = value (USD)
+    DELTA = "DELTA",// baseFee + value (CON SIGNO)
+    PERCENTAGE = "PERCENTAGE"
+}

package/bin/remittance/enums/FeeEffectMode.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FeeEffectMode = void 0;
+/** Efecto de la promo sobre el service fee (relativo a la base efectiva). */
+var FeeEffectMode;
+(function (FeeEffectMode) {
+    FeeEffectMode["NONE"] = "NONE";
+    FeeEffectMode["ABSOLUTE"] = "ABSOLUTE";
+    FeeEffectMode["DELTA"] = "DELTA";
+    FeeEffectMode["PERCENTAGE"] = "PERCENTAGE";
+})(FeeEffectMode || (exports.FeeEffectMode = FeeEffectMode = {}));

package/bin/remittance/enums/FxEffectMode.d.ts

@@ -0,0 +1,6 @@
+/** Efecto de la promo sobre el spread FX (relativo a la base efectiva). */
+export declare enum FxEffectMode {
+    NONE = "NONE",// sin cambio
+    DELTA = "DELTA",// baseMarkup + valueBps (CON SIGNO)
+    ABSOLUTE = "ABSOLUTE"
+}