@fiado/type-kit 3.160.0 → 3.162.0

package/bin/places/dtos/EstablishmentDto.d.ts

@@ -1,5 +1,4 @@
 import { CountryId } from '../../country/enums/CountryId';
-import { CashInFeeDto } from './CashInFeeDto';
 import { CashInNetworkEnum } from '../enums/CashInNetworkEnum';
 import { CashInProviderEnum } from '../enums/CashInProviderEnum';
 import { EstablishmentBrandEnum } from '../enums/EstablishmentBrandEnum';
@@ -15,7 +14,6 @@ export declare class EstablishmentDto {
     longitude: number;
     address: string;
     categories: string[];
-    isOpen: boolean | null;
     /** epoch ms del último refresco desde HERE (UI "verificado hace X días") */
     lastRefreshed: number;
     /** true si la celda alcanzó el umbral de reportes de "no existe" */
@@ -25,8 +23,6 @@ export declare class EstablishmentDto {
     provider?: CashInProviderEnum;
     /** País del punto (USA | MEX). Redundante con `provider`; explícito para la UI. */
     country?: CountryId;
-    /** Red Passport (OXXO/SUPERMERCADO/TIENDITA). En US no aplica (el fee es por brand). */
+    /** Red Passport (OXXO/SUPERMERCADO/TIENDITA). En US no aplica. */
     network?: CashInNetworkEnum;
-    /** Comisión a mostrar (no se cobra acá). */
-    fee?: CashInFeeDto;
 }

package/bin/places/index.d.ts

@@ -1,4 +1,3 @@
-export * from './dtos/CashInFeeDto';
 export * from './dtos/EstablishmentDto';
 export * from './dtos/GetNearbyPlacesRequest';
 export * from './dtos/GetNearbyPlacesResponse';

package/bin/places/index.js

@@ -15,7 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 //dtos
-__exportStar(require("./dtos/CashInFeeDto"), exports);
 __exportStar(require("./dtos/EstablishmentDto"), exports);
 __exportStar(require("./dtos/GetNearbyPlacesRequest"), exports);
 __exportStar(require("./dtos/GetNearbyPlacesResponse"), exports);

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

@@ -14,4 +14,6 @@ export declare class RemittanceQuoteRequest {
     amount: number;
     /** "USD" si amount está en origen; ISO destino si está en moneda destino. */
     amountCurrency: string;
+    /** Fase B: código de promo tecleado en la app (habilita SOLO esa promo). Inerte hasta que la app lo mande. */
+    promoCode?: string;
 }

package/bin/remittance/dtos/RemittanceQuoteRequest.js

@@ -49,3 +49,9 @@ __decorate([
     (0, class_validator_1.IsIn)(["USD", "GTQ", "HNL", "MXN", "NIO"]),
     __metadata("design:type", String)
 ], RemittanceQuoteRequest.prototype, "amountCurrency", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 30),
+    __metadata("design:type", String)
+], RemittanceQuoteRequest.prototype, "promoCode", void 0);

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

@@ -27,12 +27,16 @@ export declare class CreateSegmentRequest {
     name: string;
     members: SegmentMember[];
     individuals: SegmentIndividual[];
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    priority?: number;
 }
 /** Body de EP-24 PUT /backoffice/config/segments/{id} (reemplazo completo). */
 export declare class UpdateSegmentRequest {
     name: string;
     members: SegmentMember[];
     individuals: SegmentIndividual[];
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    priority?: number;
 }
 /** Segmento completo (response). Métricas null = nunca calculadas. */
 export declare class Segment {
@@ -51,6 +55,8 @@ export declare class Segment {
     updatedAt: string;
     createdBy: string;
     updatedBy: string;
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    priority?: number;
 }
 /** Response de EP-22 GET /backoffice/config/segments. */
 export declare class SegmentListResponse {

package/bin/remittance/dtos/RemittanceSegment.js

@@ -75,6 +75,12 @@ __decorate([
     (0, class_transformer_1.Type)(() => SegmentIndividual),
     __metadata("design:type", Array)
 ], CreateSegmentRequest.prototype, "individuals", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], CreateSegmentRequest.prototype, "priority", void 0);
 /** Body de EP-24 PUT /backoffice/config/segments/{id} (reemplazo completo). */
 class UpdateSegmentRequest {
 }
@@ -96,6 +102,12 @@ __decorate([
     (0, class_transformer_1.Type)(() => SegmentIndividual),
     __metadata("design:type", Array)
 ], UpdateSegmentRequest.prototype, "individuals", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], UpdateSegmentRequest.prototype, "priority", void 0);
 /** Segmento completo (response). Métricas null = nunca calculadas. */
 class Segment {
 }

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

@@ -6,4 +6,6 @@ export declare class RemittanceSendPreviewRequest {
     beneficiaryId: string;
     amount: number;
     amountCurrency: string;
+    /** Fase B: código de promo tecleado en la app (habilita SOLO esa promo). Inerte hasta que la app lo mande. */
+    promoCode?: string;
 }

package/bin/remittance/dtos/RemittanceSendPreviewRequest.js

@@ -32,3 +32,9 @@ __decorate([
     (0, class_validator_1.IsIn)(["USD", "GTQ", "HNL", "MXN", "NIO"]),
     __metadata("design:type", String)
 ], RemittanceSendPreviewRequest.prototype, "amountCurrency", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 30),
+    __metadata("design:type", String)
+], RemittanceSendPreviewRequest.prototype, "promoCode", void 0);

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

@@ -0,0 +1,9 @@
+import { CohortCondition } from "../RemittanceCohort";
+/** Evalúa las condiciones (AND) de un cohort para UN usuario (send-time, Fase B). */
+export declare class CohortUserMatchRequest {
+    directoryId: string;
+    conditions: CohortCondition[];
+}
+export declare class CohortUserMatchResponse {
+    matches: boolean;
+}

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

@@ -0,0 +1,33 @@
+"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.CohortUserMatchResponse = exports.CohortUserMatchRequest = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const RemittanceCohort_1 = require("../RemittanceCohort");
+/** Evalúa las condiciones (AND) de un cohort para UN usuario (send-time, Fase B). */
+class CohortUserMatchRequest {
+}
+exports.CohortUserMatchRequest = CohortUserMatchRequest;
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], CohortUserMatchRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => RemittanceCohort_1.CohortCondition),
+    __metadata("design:type", Array)
+], CohortUserMatchRequest.prototype, "conditions", void 0);
+class CohortUserMatchResponse {
+}
+exports.CohortUserMatchResponse = CohortUserMatchResponse;

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

@@ -0,0 +1,33 @@
+import { RemittanceCorridor } from "../../enums/RemittanceCorridor";
+/**
+ * Request del resolver de send-time (Fase B). El connector lo llama por cada
+ * quote/preview/pay. `code` = promo tecleada por el cliente en la app (opcional).
+ */
+export declare class PricingResolveRequest {
+    directoryId: string;
+    corridor: RemittanceCorridor;
+    amountUSD: number;
+    code?: string;
+}
+/** Regla BLOCK que rechazó la tx (VALIDATION o TX_AMOUNT con acción BLOCK). */
+export declare class PricingResolveBlocked {
+    ruleId: string;
+    ruleName: string;
+    message: string;
+}
+/**
+ * Respuesta del resolver. `markupBps`/`serviceFee` = valores FINALES tras todas las
+ * capas (markupBps puede ser negativo = subsidio). Si `blocked` viene, el connector
+ * rechaza la tx y NO llama a UNIR.
+ */
+export declare class PricingResolveResponse {
+    segmentId: string;
+    segmentName: string;
+    markupBps: number;
+    serviceFee: number;
+    appliedPromoIds: string[];
+    appliedRuleIds: string[];
+    /** true si no había combinación (se usó Estándar del corridor o markup 0 + fee 0). */
+    fallback: boolean;
+    blocked?: PricingResolveBlocked;
+}

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

@@ -0,0 +1,52 @@
+"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.PricingResolveResponse = exports.PricingResolveBlocked = exports.PricingResolveRequest = void 0;
+const class_validator_1 = require("class-validator");
+const RemittanceCorridor_1 = require("../../enums/RemittanceCorridor");
+/**
+ * Request del resolver de send-time (Fase B). El connector lo llama por cada
+ * quote/preview/pay. `code` = promo tecleada por el cliente en la app (opcional).
+ */
+class PricingResolveRequest {
+}
+exports.PricingResolveRequest = PricingResolveRequest;
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], PricingResolveRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsEnum)(RemittanceCorridor_1.RemittanceCorridor),
+    __metadata("design:type", String)
+], PricingResolveRequest.prototype, "corridor", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)({ maxDecimalPlaces: 2 }),
+    (0, class_validator_1.Min)(1),
+    __metadata("design:type", Number)
+], PricingResolveRequest.prototype, "amountUSD", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 30),
+    __metadata("design:type", String)
+], PricingResolveRequest.prototype, "code", void 0);
+/** Regla BLOCK que rechazó la tx (VALIDATION o TX_AMOUNT con acción BLOCK). */
+class PricingResolveBlocked {
+}
+exports.PricingResolveBlocked = PricingResolveBlocked;
+/**
+ * Respuesta del resolver. `markupBps`/`serviceFee` = valores FINALES tras todas las
+ * capas (markupBps puede ser negativo = subsidio). Si `blocked` viene, el connector
+ * rechaza la tx y NO llama a UNIR.
+ */
+class PricingResolveResponse {
+}
+exports.PricingResolveResponse = PricingResolveResponse;

package/bin/remittance/index.d.ts

@@ -6,3 +6,5 @@ export * from "./dtos/internal/RemittanceCohortCount";
 export * from "./dtos/internal/RemittanceSegmentMetrics";
 export * from "./dtos/internal/RemittancePricingBridge";
 export * from "./dtos/internal/RemittancePromotionReach";
+export * from "./dtos/internal/RemittancePricingResolve";
+export * from "./dtos/internal/RemittanceCohortUserMatch";

package/bin/remittance/index.js

@@ -24,3 +24,5 @@ __exportStar(require("./dtos/internal/RemittanceCohortCount"), exports);
 __exportStar(require("./dtos/internal/RemittanceSegmentMetrics"), exports);
 __exportStar(require("./dtos/internal/RemittancePricingBridge"), exports);
 __exportStar(require("./dtos/internal/RemittancePromotionReach"), exports);
+__exportStar(require("./dtos/internal/RemittancePricingResolve"), exports);
+__exportStar(require("./dtos/internal/RemittanceCohortUserMatch"), exports);

package/package.json

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

package/src/places/dtos/EstablishmentDto.ts

@@ -1,5 +1,4 @@
 import { CountryId } from '../../country/enums/CountryId';
-import { CashInFeeDto } from './CashInFeeDto';
 import { CashInNetworkEnum } from '../enums/CashInNetworkEnum';
 import { CashInProviderEnum } from '../enums/CashInProviderEnum';
 import { EstablishmentBrandEnum } from '../enums/EstablishmentBrandEnum';
@@ -16,7 +15,6 @@ export class EstablishmentDto {
     longitude: number;
     address: string;
     categories: string[];
-    isOpen: boolean | null;
     /** epoch ms del último refresco desde HERE (UI "verificado hace X días") */
     lastRefreshed: number;
     /** true si la celda alcanzó el umbral de reportes de "no existe" */
@@ -27,8 +25,6 @@ export class EstablishmentDto {
     provider?: CashInProviderEnum;
     /** País del punto (USA | MEX). Redundante con `provider`; explícito para la UI. */
     country?: CountryId;
-    /** Red Passport (OXXO/SUPERMERCADO/TIENDITA). En US no aplica (el fee es por brand). */
+    /** Red Passport (OXXO/SUPERMERCADO/TIENDITA). En US no aplica. */
     network?: CashInNetworkEnum;
-    /** Comisión a mostrar (no se cobra acá). */
-    fee?: CashInFeeDto;
 }

package/src/places/index.ts

@@ -1,5 +1,4 @@
 //dtos
-export * from './dtos/CashInFeeDto';
 export * from './dtos/EstablishmentDto';
 export * from './dtos/GetNearbyPlacesRequest';
 export * from './dtos/GetNearbyPlacesResponse';

package/src/remittance/dtos/RemittanceQuoteRequest.ts

@@ -1,4 +1,4 @@
-import { IsEnum, IsIn, IsNotEmpty, IsNumber, IsString, Min } from "class-validator";
+import { IsEnum, IsIn, IsNotEmpty, IsNumber, IsOptional, IsString, Length, Min } from "class-validator";
 import { ReceptionMethod } from "../enums/ReceptionMethod";
 import { RemittanceCountryISO } from "../enums/RemittanceCountryISO";
 
@@ -30,4 +30,10 @@ export class RemittanceQuoteRequest {
     /** "USD" si amount está en origen; ISO destino si está en moneda destino. */
     @IsIn(["USD", "GTQ", "HNL", "MXN", "NIO"])
     amountCurrency!: string;
+
+    /** Fase B: código de promo tecleado en la app (habilita SOLO esa promo). Inerte hasta que la app lo mande. */
+    @IsOptional()
+    @IsString()
+    @Length(3, 30)
+    promoCode?: string;
 }

package/src/remittance/dtos/RemittanceSegment.ts

@@ -2,10 +2,12 @@ import { Type } from "class-transformer";
 import {
     IsArray,
     IsEnum,
+    IsInt,
     IsOptional,
     IsString,
     IsUUID,
     Length,
+    Min,
     ValidateNested,
 } from "class-validator";
 import { SegmentMemberType } from "../enums/SegmentMemberType";
@@ -62,6 +64,12 @@ export class CreateSegmentRequest {
     @ValidateNested({ each: true })
     @Type(() => SegmentIndividual)
     individuals!: SegmentIndividual[];
+
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    priority?: number;
 }
 
 /** Body de EP-24 PUT /backoffice/config/segments/{id} (reemplazo completo). */
@@ -79,6 +87,12 @@ export class UpdateSegmentRequest {
     @ValidateNested({ each: true })
     @Type(() => SegmentIndividual)
     individuals!: SegmentIndividual[];
+
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    priority?: number;
 }
 
 /** Segmento completo (response). Métricas null = nunca calculadas. */
@@ -98,6 +112,8 @@ export class Segment {
     updatedAt!: string;
     createdBy!: string;
     updatedBy!: string;
+    /** Precedencia en send-time (D-PB-1): mayor gana; empate → nombre; ESTANDAR siempre piso. Ausente = 0. */
+    priority?: number;
 }
 
 /** Response de EP-22 GET /backoffice/config/segments. */

package/src/remittance/dtos/RemittanceSendPreviewRequest.ts

@@ -1,4 +1,4 @@
-import { IsIn, IsNotEmpty, IsNumber, IsString, Min } from "class-validator";
+import { IsIn, IsNotEmpty, IsNumber, IsOptional, IsString, Length, Min } from "class-validator";
 
 /**
  * Preview formal antes del confirm. Bajo API Lite no incluye fundingMethod —
@@ -15,4 +15,10 @@ export class RemittanceSendPreviewRequest {
 
     @IsIn(["USD", "GTQ", "HNL", "MXN", "NIO"])
     amountCurrency!: string;
+
+    /** Fase B: código de promo tecleado en la app (habilita SOLO esa promo). Inerte hasta que la app lo mande. */
+    @IsOptional()
+    @IsString()
+    @Length(3, 30)
+    promoCode?: string;
 }

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

@@ -0,0 +1,19 @@
+import { ArrayNotEmpty, IsArray, IsUUID, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { CohortCondition } from "../RemittanceCohort";
+
+/** Evalúa las condiciones (AND) de un cohort para UN usuario (send-time, Fase B). */
+export class CohortUserMatchRequest {
+    @IsUUID()
+    directoryId!: string;
+
+    @IsArray()
+    @ArrayNotEmpty()
+    @ValidateNested({ each: true })
+    @Type(() => CohortCondition)
+    conditions!: CohortCondition[];
+}
+
+export class CohortUserMatchResponse {
+    matches!: boolean;
+}

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

@@ -0,0 +1,47 @@
+import { IsEnum, IsNumber, IsOptional, IsString, IsUUID, Length, Min } from "class-validator";
+import { RemittanceCorridor } from "../../enums/RemittanceCorridor";
+
+/**
+ * Request del resolver de send-time (Fase B). El connector lo llama por cada
+ * quote/preview/pay. `code` = promo tecleada por el cliente en la app (opcional).
+ */
+export class PricingResolveRequest {
+    @IsUUID()
+    directoryId!: string;
+
+    @IsEnum(RemittanceCorridor)
+    corridor!: RemittanceCorridor;
+
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @Min(1)
+    amountUSD!: number;
+
+    @IsOptional()
+    @IsString()
+    @Length(3, 30)
+    code?: string;
+}
+
+/** Regla BLOCK que rechazó la tx (VALIDATION o TX_AMOUNT con acción BLOCK). */
+export class PricingResolveBlocked {
+    ruleId!: string;
+    ruleName!: string;
+    message!: string;
+}
+
+/**
+ * Respuesta del resolver. `markupBps`/`serviceFee` = valores FINALES tras todas las
+ * capas (markupBps puede ser negativo = subsidio). Si `blocked` viene, el connector
+ * rechaza la tx y NO llama a UNIR.
+ */
+export class PricingResolveResponse {
+    segmentId!: string;
+    segmentName!: string;
+    markupBps!: number;
+    serviceFee!: number;
+    appliedPromoIds!: string[];
+    appliedRuleIds!: string[];
+    /** true si no había combinación (se usó Estándar del corridor o markup 0 + fee 0). */
+    fallback!: boolean;
+    blocked?: PricingResolveBlocked;
+}

package/src/remittance/index.ts

@@ -8,3 +8,5 @@ export * from "./dtos/internal/RemittanceCohortCount";
 export * from "./dtos/internal/RemittanceSegmentMetrics";
 export * from "./dtos/internal/RemittancePricingBridge";
 export * from "./dtos/internal/RemittancePromotionReach";
+export * from "./dtos/internal/RemittancePricingResolve";
+export * from "./dtos/internal/RemittanceCohortUserMatch";

package/src/places/dtos/CashInFeeDto.ts

@@ -1,18 +0,0 @@
-import { CurrencyId } from '../../currency/enums/CurrencyId';
-
-/**
- * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
- * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
- * - Passport (MX): por red → `fixed` + `percentage`.
- * Response DTO — sin decoradores de validación.
- */
-export class CashInFeeDto {
-    /** Comisión fija, en la moneda del país. */
-    fixed?: number;
-    /** Porcentaje del monto depositado (0–100). */
-    percentage?: number;
-    /** Tope máximo de comisión (GreenDot: el asociado cobra hasta este cap). */
-    cap?: number;
-    /** Moneda del fee: USD (GreenDot) | MXN (Passport). */
-    currency: CurrencyId;
-}