@fiado/type-kit 3.152.0 → 3.154.0

package/bin/cognitoBackofficeConnector/dtos/MfaPoolConfig.d.ts

@@ -0,0 +1,7 @@
+declare const ALLOWED_MFA_TYPES: readonly ["SOFTWARE_TOKEN_MFA"];
+export type AllowedMfaType = (typeof ALLOWED_MFA_TYPES)[number];
+export declare class MfaPoolConfig {
+    requireMfa: boolean;
+    mfaTypes: AllowedMfaType[];
+}
+export {};

package/bin/cognitoBackofficeConnector/dtos/MfaPoolConfig.js

@@ -0,0 +1,36 @@
+"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.MfaPoolConfig = 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 {
+}
+exports.MfaPoolConfig = MfaPoolConfig;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], MfaPoolConfig.prototype, "requireMfa", 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);

package/bin/cognitoBackofficeConnector/dtos/PoolConfigResponse.d.ts

@@ -0,0 +1,20 @@
+import { PoolKind } from '../../rbac/enums/PoolKind';
+/**
+ * Shape del `PoolConfigRow` expuesto al caller (BFF M18 / otros lambdas Fiado).
+ * Refleja la configuración de un Cognito User Pool registrado en la tabla
+ * `PoolConfigs_GT` del lambda `cognito-backoffice-connector`.
+ */
+export declare class PoolConfigResponse {
+    userPoolId: string;
+    userPoolArn: string;
+    region: string;
+    poolKind: PoolKind;
+    displayName: string;
+    appClients: Record<string, {
+        clientId: string;
+        clientName: string;
+    }>;
+    status: 'active' | 'deprecated';
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/cognitoBackofficeConnector/dtos/PoolConfigResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolConfigResponse = void 0;
+/**
+ * Shape del `PoolConfigRow` expuesto al caller (BFF M18 / otros lambdas Fiado).
+ * Refleja la configuración de un Cognito User Pool registrado en la tabla
+ * `PoolConfigs_GT` del lambda `cognito-backoffice-connector`.
+ */
+class PoolConfigResponse {
+}
+exports.PoolConfigResponse = PoolConfigResponse;

package/bin/cognitoBackofficeConnector/dtos/PoolsListResponse.d.ts

@@ -0,0 +1,4 @@
+import { PoolConfigResponse } from './PoolConfigResponse';
+export declare class PoolsListResponse {
+    pools: PoolConfigResponse[];
+}

package/bin/cognitoBackofficeConnector/dtos/PoolsListResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolsListResponse = void 0;
+class PoolsListResponse {
+}
+exports.PoolsListResponse = PoolsListResponse;

package/bin/cognitoBackofficeConnector/validators/MfaTypesRequiresOne.d.ts

@@ -0,0 +1,17 @@
+import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+/**
+ * Cross-field validator: si `requireMfa: true`, entonces `mfaTypes` debe tener
+ * al menos 1 elemento. Si `requireMfa: false`, `mfaTypes` puede ser vacío.
+ *
+ * Razón: cuando el pool nace con MFA habilitado, el connector llama
+ * `SetUserPoolMfaConfigCommand` con la lista de tipos del DTO. Si el array
+ * llega vacío con `requireMfa: true`, el SDK rechaza con InvalidParameterException
+ * y el pool queda en estado inconsistente (MfaConfiguration:'ON' sin tipos).
+ * Mejor rechazar en validación del DTO antes de tocar AWS.
+ *
+ * Ver pivote v1.4.1 TD-017 cerrado + spec doc §1 R3.
+ */
+export declare class MfaTypesRequiresOne implements ValidatorConstraintInterface {
+    validate(mfaTypes: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/cognitoBackofficeConnector/validators/MfaTypesRequiresOne.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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MfaTypesRequiresOne = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Cross-field validator: si `requireMfa: true`, entonces `mfaTypes` debe tener
+ * al menos 1 elemento. Si `requireMfa: false`, `mfaTypes` puede ser vacío.
+ *
+ * Razón: cuando el pool nace con MFA habilitado, el connector llama
+ * `SetUserPoolMfaConfigCommand` con la lista de tipos del DTO. Si el array
+ * llega vacío con `requireMfa: true`, el SDK rechaza con InvalidParameterException
+ * y el pool queda en estado inconsistente (MfaConfiguration:'ON' sin tipos).
+ * Mejor rechazar en validación del DTO antes de tocar AWS.
+ *
+ * Ver pivote v1.4.1 TD-017 cerrado + spec doc §1 R3.
+ */
+let MfaTypesRequiresOne = class MfaTypesRequiresOne {
+    validate(mfaTypes, args) {
+        const obj = args.object;
+        if (obj.requireMfa === true) {
+            return Array.isArray(mfaTypes) && mfaTypes.length >= 1;
+        }
+        // requireMfa: false → cualquier mfaTypes pasa.
+        return true;
+    }
+    defaultMessage() {
+        return 'mfaTypes requiere al menos un tipo cuando requireMfa=true';
+    }
+};
+exports.MfaTypesRequiresOne = MfaTypesRequiresOne;
+exports.MfaTypesRequiresOne = MfaTypesRequiresOne = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'MfaTypesRequiresOneWhenMfaRequired', async: false })
+], MfaTypesRequiresOne);

package/bin/rbac/enums/PoolKind.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tipo de User Pool de Cognito desde la perspectiva del modelo RBAC Fiado.
+ *
+ * Origen: spec del proyecto `cognito-backoffice-connector` (Fase 0, componente 01
+ * documento `docs/superpowers/specs/2026-05-26-cognito-connector-decisiones-pendientes-design.md`).
+ *
+ * Decisión (TD-003): el proyecto converge en estos 2 valores. El documento componente 03
+ * lista 3 valores (incluyendo una variante adicional) pero queda como outlier — la
+ * decisión vigente en los 6 docs restantes y en el plan de implementación es 2 valores:
+ *  - BACKOFFICE_PLATFORM — pool del backoffice de plataforma (cross-tenant)
+ *  - BACKOFFICE_TENANT — pool por tenant (multi-tenant isolation)
+ */
+export declare enum PoolKind {
+    BACKOFFICE_PLATFORM = "BACKOFFICE_PLATFORM",
+    BACKOFFICE_TENANT = "BACKOFFICE_TENANT"
+}

package/bin/rbac/enums/PoolKind.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolKind = void 0;
+/**
+ * Tipo de User Pool de Cognito desde la perspectiva del modelo RBAC Fiado.
+ *
+ * Origen: spec del proyecto `cognito-backoffice-connector` (Fase 0, componente 01
+ * documento `docs/superpowers/specs/2026-05-26-cognito-connector-decisiones-pendientes-design.md`).
+ *
+ * Decisión (TD-003): el proyecto converge en estos 2 valores. El documento componente 03
+ * lista 3 valores (incluyendo una variante adicional) pero queda como outlier — la
+ * decisión vigente en los 6 docs restantes y en el plan de implementación es 2 valores:
+ *  - BACKOFFICE_PLATFORM — pool del backoffice de plataforma (cross-tenant)
+ *  - BACKOFFICE_TENANT — pool por tenant (multi-tenant isolation)
+ */
+var PoolKind;
+(function (PoolKind) {
+    PoolKind["BACKOFFICE_PLATFORM"] = "BACKOFFICE_PLATFORM";
+    PoolKind["BACKOFFICE_TENANT"] = "BACKOFFICE_TENANT";
+})(PoolKind || (exports.PoolKind = PoolKind = {}));

package/bin/rbac/index.d.ts

@@ -0,0 +1 @@
+export * from './enums/PoolKind';

package/bin/rbac/index.js

@@ -0,0 +1,17 @@
+"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("./enums/PoolKind"), exports);

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

@@ -0,0 +1,93 @@
+import { RemittanceCorridor } from "../enums/RemittanceCorridor";
+/**
+ * DTOs de Precio Base (Dashboard Ops · Variables Operativas §1).
+ *
+ * Una combinación (corridor × segmento) define el markup FX (bps CON SIGNO:
+ * + Fiado gana spread; − Fiado subsidia, retail > wholesale) y los service fees
+ * escalonados por tramo de monto. Dueño de la tabla: remittance-business
+ * (RemittancePricing_GT). Cambios inmediatos al guardar; lo temporal vive en
+ * Promociones. retail = wholesale × (1 − markupBps/10000), SIN clampear
+ * (el tope ≤ base de UNIR es transitorio).
+ */
+/** Tramo de service fee. Matching = MAYOR amountMin ≤ monto (amountMax es SOLO display). */
+export declare class PricingTier {
+    amountMin: number;
+    /** Display ("$1–$49"); null/ausente = sin tope (último tramo). El matching NO lo usa. */
+    amountMax?: number | null;
+    serviceFee: number;
+    /** ISO date (YYYY-MM-DD) "FEE DESDE" — informativo. */
+    effectiveFrom: string;
+}
+/** Body de POST /backoffice/pricing/base. */
+export declare class CreatePricingRequest {
+    corridor: RemittanceCorridor;
+    segmentId: string;
+    /** CON SIGNO: + Fiado gana spread; − Fiado subsidia (retail > wholesale). */
+    markupBps: number;
+    tramos: PricingTier[];
+    name?: string;
+    notes?: string;
+}
+/** Body de PUT /backoffice/pricing/base/{id} (reemplazo completo; corridor/segmentId inmutables). */
+export declare class UpdatePricingRequest {
+    markupBps: number;
+    tramos: PricingTier[];
+    name?: string;
+    notes?: string;
+}
+/** Combinación completa (response de list/create/update). */
+export declare class PricingCombination {
+    id: string;
+    corridor: RemittanceCorridor;
+    segmentId: string;
+    /** Display resuelto contra RemittanceSegments_GT ("Premium"); segmentId si no resoluble. */
+    segmentName: string;
+    markupBps: number;
+    tramos: PricingTier[];
+    /** # promos activas que aplican a la combinación. 0 hasta que exista Promociones. */
+    promosCount: number;
+    name: string | null;
+    notes: string | null;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+}
+/** Response de GET /backoffice/pricing/base. */
+export declare class PricingListResponse {
+    items: PricingCombination[];
+}
+/** Response de GET /backoffice/pricing/base/{id}/metrics. */
+export declare class PricingCombinationMetrics {
+    /** Miembros del segmento con ≥1 tx no-cancelada al corredor (histórica). */
+    clientCount: number;
+    /** Σ amountUSD del mes calendario (UTC) de esas tx al corredor, sin CANCELLED/REFUND. */
+    volMonthUSD: number;
+}
+/** Body de POST /backoffice/pricing/simulate (valores del panel — pueden NO estar guardados). */
+export declare class SimulatePricingRequest {
+    corridor: RemittanceCorridor;
+    amountUSD: number;
+    markupBps: number;
+    tramos: PricingTier[];
+}
+export declare class SimulatePricingResponse {
+    /** ExternalQuickQuotes (vivo). */
+    wholesale: number;
+    /** round4(wholesale × (1 − markupBps/10000)) — SIN clampear (markup negativo ⇒ retail > wholesale). */
+    retail: number;
+    /** Del tramo matcheado (mayor amountMin ≤ amountUSD). */
+    serviceFee: number;
+    /** round2(amountUSD × retail), en moneda destino. */
+    receives: number;
+    /** amountUSD + serviceFee (el stateFee lo calcula UNIR; prod US = 0). */
+    totalToPay: number;
+    /** ISO del quote. */
+    asOf: string;
+}
+/** Response de GET /backoffice/pricing/wholesale?corridor= (rb passthrough del connector). */
+export declare class WholesaleRateResponse {
+    corridor: RemittanceCorridor;
+    wholesale: number;
+    asOf: string;
+}

package/bin/remittance/dtos/RemittancePricing.js

@@ -0,0 +1,165 @@
+"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.WholesaleRateResponse = exports.SimulatePricingResponse = exports.SimulatePricingRequest = exports.PricingCombinationMetrics = exports.PricingListResponse = exports.PricingCombination = exports.UpdatePricingRequest = exports.CreatePricingRequest = exports.PricingTier = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const RemittanceCorridor_1 = require("../enums/RemittanceCorridor");
+/**
+ * DTOs de Precio Base (Dashboard Ops · Variables Operativas §1).
+ *
+ * Una combinación (corridor × segmento) define el markup FX (bps CON SIGNO:
+ * + Fiado gana spread; − Fiado subsidia, retail > wholesale) y los service fees
+ * escalonados por tramo de monto. Dueño de la tabla: remittance-business
+ * (RemittancePricing_GT). Cambios inmediatos al guardar; lo temporal vive en
+ * Promociones. retail = wholesale × (1 − markupBps/10000), SIN clampear
+ * (el tope ≤ base de UNIR es transitorio).
+ */
+/** Tramo de service fee. Matching = MAYOR amountMin ≤ monto (amountMax es SOLO display). */
+class PricingTier {
+}
+exports.PricingTier = PricingTier;
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], PricingTier.prototype, "amountMin", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], PricingTier.prototype, "amountMax", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], PricingTier.prototype, "serviceFee", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(10, 10),
+    __metadata("design:type", String)
+], PricingTier.prototype, "effectiveFrom", void 0);
+/** Body de POST /backoffice/pricing/base. */
+class CreatePricingRequest {
+}
+exports.CreatePricingRequest = CreatePricingRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(RemittanceCorridor_1.RemittanceCorridor),
+    __metadata("design:type", String)
+], CreatePricingRequest.prototype, "corridor", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 100),
+    __metadata("design:type", String)
+], CreatePricingRequest.prototype, "segmentId", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(-500),
+    (0, class_validator_1.Max)(500),
+    __metadata("design:type", Number)
+], CreatePricingRequest.prototype, "markupBps", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(20),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PricingTier),
+    __metadata("design:type", Array)
+], CreatePricingRequest.prototype, "tramos", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", String)
+], CreatePricingRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreatePricingRequest.prototype, "notes", void 0);
+/** Body de PUT /backoffice/pricing/base/{id} (reemplazo completo; corridor/segmentId inmutables). */
+class UpdatePricingRequest {
+}
+exports.UpdatePricingRequest = UpdatePricingRequest;
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(-500),
+    (0, class_validator_1.Max)(500),
+    __metadata("design:type", Number)
+], UpdatePricingRequest.prototype, "markupBps", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(20),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PricingTier),
+    __metadata("design:type", Array)
+], UpdatePricingRequest.prototype, "tramos", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(100),
+    __metadata("design:type", String)
+], UpdatePricingRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], UpdatePricingRequest.prototype, "notes", void 0);
+/** Combinación completa (response de list/create/update). */
+class PricingCombination {
+}
+exports.PricingCombination = PricingCombination;
+/** Response de GET /backoffice/pricing/base. */
+class PricingListResponse {
+}
+exports.PricingListResponse = PricingListResponse;
+/** Response de GET /backoffice/pricing/base/{id}/metrics. */
+class PricingCombinationMetrics {
+}
+exports.PricingCombinationMetrics = PricingCombinationMetrics;
+/** Body de POST /backoffice/pricing/simulate (valores del panel — pueden NO estar guardados). */
+class SimulatePricingRequest {
+}
+exports.SimulatePricingRequest = SimulatePricingRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(RemittanceCorridor_1.RemittanceCorridor),
+    __metadata("design:type", String)
+], SimulatePricingRequest.prototype, "corridor", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], SimulatePricingRequest.prototype, "amountUSD", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(-500),
+    (0, class_validator_1.Max)(500),
+    __metadata("design:type", Number)
+], SimulatePricingRequest.prototype, "markupBps", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMinSize)(1),
+    (0, class_validator_1.ArrayMaxSize)(20),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => PricingTier),
+    __metadata("design:type", Array)
+], SimulatePricingRequest.prototype, "tramos", void 0);
+class SimulatePricingResponse {
+}
+exports.SimulatePricingResponse = SimulatePricingResponse;
+/** Response de GET /backoffice/pricing/wholesale?corridor= (rb passthrough del connector). */
+class WholesaleRateResponse {
+}
+exports.WholesaleRateResponse = WholesaleRateResponse;

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;
+}