@fiado/type-kit 3.153.0 → 3.154.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"
+}

package/bin/remittance/enums/FxEffectMode.js

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

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

@@ -0,0 +1,7 @@
+/** Cómo se activa la promo para el cliente. */
+export declare enum PromotionActivation {
+    /** Auto-aplica a toda la audiencia. */
+    AUTOMATIC = "AUTOMATIC",
+    /** El cliente teclea el código en la app (habilita SOLO esa promo). */
+    CODE = "CODE"
+}

package/bin/remittance/enums/PromotionActivation.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionActivation = void 0;
+/** Cómo se activa la promo para el cliente. */
+var PromotionActivation;
+(function (PromotionActivation) {
+    /** Auto-aplica a toda la audiencia. */
+    PromotionActivation["AUTOMATIC"] = "AUTOMATIC";
+    /** El cliente teclea el código en la app (habilita SOLO esa promo). */
+    PromotionActivation["CODE"] = "CODE";
+})(PromotionActivation || (exports.PromotionActivation = PromotionActivation = {}));

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

@@ -0,0 +1,9 @@
+/** Tipo de promoción (Variables Operativas › Promociones — mockup). */
+export declare enum PromotionKind {
+    /** Descuento promocional temporal (puede tener código). */
+    PROMO = "PROMO",
+    /** Cambio de BASE programado (overlay absoluto; NO muta RemittancePricing_GT). */
+    PRICE_CHANGE = "PRICE_CHANGE",
+    /** Override permanente por audiencia (VIP, Onboarding sin fee, …). */
+    PREFERENTIAL = "PREFERENTIAL"
+}

package/bin/remittance/enums/PromotionKind.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionKind = void 0;
+/** Tipo de promoción (Variables Operativas › Promociones — mockup). */
+var PromotionKind;
+(function (PromotionKind) {
+    /** Descuento promocional temporal (puede tener código). */
+    PromotionKind["PROMO"] = "PROMO";
+    /** Cambio de BASE programado (overlay absoluto; NO muta RemittancePricing_GT). */
+    PromotionKind["PRICE_CHANGE"] = "PRICE_CHANGE";
+    /** Override permanente por audiencia (VIP, Onboarding sin fee, …). */
+    PromotionKind["PREFERENTIAL"] = "PREFERENTIAL";
+})(PromotionKind || (exports.PromotionKind = PromotionKind = {}));

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

@@ -0,0 +1,7 @@
+/** Estado DERIVADO de effectiveFrom/To vs hoy (UTC). NO se persiste. */
+export declare enum PromotionStatus {
+    ACTIVE = "ACTIVE",// vigente con fecha de fin
+    SCHEDULED = "SCHEDULED",// programada (hoy < from)
+    PERMANENT = "PERMANENT",// vigente sin fin (effectiveTo null)
+    EXPIRED = "EXPIRED"
+}

package/bin/remittance/enums/PromotionStatus.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromotionStatus = void 0;
+/** Estado DERIVADO de effectiveFrom/To vs hoy (UTC). NO se persiste. */
+var PromotionStatus;
+(function (PromotionStatus) {
+    PromotionStatus["ACTIVE"] = "ACTIVE";
+    PromotionStatus["SCHEDULED"] = "SCHEDULED";
+    PromotionStatus["PERMANENT"] = "PERMANENT";
+    PromotionStatus["EXPIRED"] = "EXPIRED";
+})(PromotionStatus || (exports.PromotionStatus = PromotionStatus = {}));

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

@@ -12,3 +12,8 @@ export * from "./AuditAction";
 export * from "./AuditEntityType";
 export * from "./SegmentMemberType";
 export * from "./RemittanceCorridor";
+export * from "./PromotionKind";
+export * from "./PromotionActivation";
+export * from "./PromotionStatus";
+export * from "./FxEffectMode";
+export * from "./FeeEffectMode";

package/bin/remittance/enums/index.js

@@ -28,3 +28,8 @@ __exportStar(require("./AuditAction"), exports);
 __exportStar(require("./AuditEntityType"), exports);
 __exportStar(require("./SegmentMemberType"), exports);
 __exportStar(require("./RemittanceCorridor"), exports);
+__exportStar(require("./PromotionKind"), exports);
+__exportStar(require("./PromotionActivation"), exports);
+__exportStar(require("./PromotionStatus"), exports);
+__exportStar(require("./FxEffectMode"), exports);
+__exportStar(require("./FeeEffectMode"), exports);

package/bin/remittance/index.d.ts

@@ -5,3 +5,4 @@ export * from "./dtos/internal/RemittanceCreditBackResponse";
 export * from "./dtos/internal/RemittanceCohortCount";
 export * from "./dtos/internal/RemittanceSegmentMetrics";
 export * from "./dtos/internal/RemittancePricingBridge";
+export * from "./dtos/internal/RemittancePromotionReach";

package/bin/remittance/index.js

@@ -23,3 +23,4 @@ __exportStar(require("./dtos/internal/RemittanceCreditBackResponse"), exports);
 __exportStar(require("./dtos/internal/RemittanceCohortCount"), exports);
 __exportStar(require("./dtos/internal/RemittanceSegmentMetrics"), exports);
 __exportStar(require("./dtos/internal/RemittancePricingBridge"), exports);
+__exportStar(require("./dtos/internal/RemittancePromotionReach"), exports);

package/package.json

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

package/src/remittance/dtos/RemittancePromotion.ts

@@ -0,0 +1,162 @@
+import { Type } from "class-transformer";
+import {
+    IsEnum,
+    IsInt,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Length,
+    Matches,
+    Max,
+    MaxLength,
+    Min,
+    ValidateNested,
+} from "class-validator";
+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";
+
+/**
+ * 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". */
+export class PromotionAudience {
+    @IsOptional()
+    @IsEnum(RemittanceCorridor)
+    corridor?: RemittanceCorridor | null;
+
+    @IsOptional()
+    @IsString()
+    @Length(1, 100)
+    segmentId?: string | null;
+
+    @IsOptional()
+    @IsString()
+    @Length(1, 100)
+    cohortId?: string | null;
+}
+
+/** Efecto FX (spread): DELTA suma bps CON SIGNO al markup base; ABSOLUTE lo reemplaza. */
+export class FxEffect {
+    @IsEnum(FxEffectMode)
+    mode!: FxEffectMode;
+
+    /** bps con signo. Ignorado si mode=NONE (mandar 0). */
+    @IsInt()
+    @Min(-500)
+    @Max(500)
+    valueBps!: number;
+}
+
+/** Efecto fee: ABSOLUTE = $; DELTA = ±$; PERCENTAGE = −% del fee (0-100). */
+export class FeeEffect {
+    @IsEnum(FeeEffectMode)
+    mode!: FeeEffectMode;
+
+    @IsNumber()
+    @Min(-100)
+    @Max(100)
+    value!: number;
+}
+
+export class CreatePromotionRequest {
+    @IsString()
+    @Length(3, 100)
+    name!: string;
+
+    @IsEnum(PromotionKind)
+    kind!: PromotionKind;
+
+    @IsEnum(PromotionActivation)
+    activation!: PromotionActivation;
+
+    /** Requerido si activation=CODE (regla en manager); único case-insensitive. */
+    @IsOptional()
+    @IsString()
+    @Length(3, 30)
+    @Matches(/^[A-Z0-9_-]+$/i)
+    code?: string | null;
+
+    @ValidateNested()
+    @Type(() => PromotionAudience)
+    audience!: PromotionAudience;
+
+    /** ISO date (YYYY-MM-DD). */
+    @IsString()
+    @Matches(ISO_DATE)
+    effectiveFrom!: string;
+
+    /** ISO date; null/ausente = permanente (∞). */
+    @IsOptional()
+    @IsString()
+    @Matches(ISO_DATE)
+    effectiveTo?: string | null;
+
+    @ValidateNested()
+    @Type(() => FxEffect)
+    fxEffect!: FxEffect;
+
+    @ValidateNested()
+    @Type(() => FeeEffect)
+    feeEffect!: FeeEffect;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    notes?: string | null;
+}
+
+/** PUT — reemplazo completo (mismos campos que create). */
+export class UpdatePromotionRequest extends CreatePromotionRequest {
+}
+
+/** Promoción completa (response de list/create/update). */
+export 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 class PromotionListResponse {
+    items!: Promotion[];
+}
+
+/** Response de GET /backoffice/pricing/promotions/reach. */
+export class PromotionReachResponse {
+    /** Clientes en la intersección corridor × segmento × cohort. */
+    reach!: number;
+    /** Universo (todos los RemittanceUsers) — para el % del picker. */
+    total!: number;
+}

package/src/remittance/dtos/index.ts

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

package/src/remittance/dtos/internal/RemittancePromotionReach.ts

@@ -0,0 +1,31 @@
+import { Type } from "class-transformer";
+import { IsArray, IsEnum, IsOptional, IsUUID, ValidateNested } from "class-validator";
+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 class PromotionReachRequest {
+    /** Miembros del segmento (resueltos por rb). Ausente = todos los usuarios. */
+    @IsOptional()
+    @IsArray()
+    @IsUUID("4", { each: true })
+    directoryIds?: string[];
+
+    /** Condiciones del cohort (AND, evaluadas como en cohortCount). Ausente = sin filtro. */
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => CohortCondition)
+    conditions?: CohortCondition[];
+
+    /** Filtro por corredor (countryISO de CORRIDOR_INFO, ≥1 tx no-cancelada histórica). Ausente = sin filtro. */
+    @IsOptional()
+    @IsEnum(RemittanceCorridor)
+    corridor?: RemittanceCorridor;
+}

package/src/remittance/enums/FeeEffectMode.ts

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

package/src/remittance/enums/FxEffectMode.ts

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

package/src/remittance/enums/PromotionActivation.ts

@@ -0,0 +1,7 @@
+/** Cómo se activa la promo para el cliente. */
+export enum PromotionActivation {
+    /** Auto-aplica a toda la audiencia. */
+    AUTOMATIC = "AUTOMATIC",
+    /** El cliente teclea el código en la app (habilita SOLO esa promo). */
+    CODE = "CODE",
+}

package/src/remittance/enums/PromotionKind.ts

@@ -0,0 +1,9 @@
+/** Tipo de promoción (Variables Operativas › Promociones — mockup). */
+export enum PromotionKind {
+    /** Descuento promocional temporal (puede tener código). */
+    PROMO = "PROMO",
+    /** Cambio de BASE programado (overlay absoluto; NO muta RemittancePricing_GT). */
+    PRICE_CHANGE = "PRICE_CHANGE",
+    /** Override permanente por audiencia (VIP, Onboarding sin fee, …). */
+    PREFERENTIAL = "PREFERENTIAL",
+}

package/src/remittance/enums/PromotionStatus.ts

@@ -0,0 +1,7 @@
+/** Estado DERIVADO de effectiveFrom/To vs hoy (UTC). NO se persiste. */
+export enum PromotionStatus {
+    ACTIVE = "ACTIVE",         // vigente con fecha de fin
+    SCHEDULED = "SCHEDULED",   // programada (hoy < from)
+    PERMANENT = "PERMANENT",   // vigente sin fin (effectiveTo null)
+    EXPIRED = "EXPIRED",       // vencida (hoy > to)
+}

package/src/remittance/enums/index.ts

@@ -12,3 +12,8 @@ export * from "./AuditAction";
 export * from "./AuditEntityType";
 export * from "./SegmentMemberType";
 export * from "./RemittanceCorridor";
+export * from "./PromotionKind";
+export * from "./PromotionActivation";
+export * from "./PromotionStatus";
+export * from "./FxEffectMode";
+export * from "./FeeEffectMode";

package/src/remittance/index.ts

@@ -7,3 +7,4 @@ export * from "./dtos/internal/RemittanceCreditBackResponse";
 export * from "./dtos/internal/RemittanceCohortCount";
 export * from "./dtos/internal/RemittanceSegmentMetrics";
 export * from "./dtos/internal/RemittancePricingBridge";
+export * from "./dtos/internal/RemittancePromotionReach";