@fiado/type-kit 3.643.0 → 3.645.0

package/src/transactionProcessor/dtos/AuthorizeRewardTopupRequest.ts

@@ -0,0 +1,44 @@
+import { IsNotEmpty, IsNumber, IsPositive, IsString, Matches, MaxLength } from 'class-validator';
+
+/**
+ * Pago de una recarga Bait de recompensa (`MEX_REWARD_TOPUP`). No toca ninguna wallet.
+ *
+ * `idempotencyKey` ≤ 60: el folio del proveedor admite 64 y se reservan 4 caracteres para el
+ * sufijo `-{k}` del folio por intento.
+ */
+export class AuthorizeRewardTopupRequest {
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(60)
+    @Matches(/^[^#]+$/)
+    idempotencyKey: string;
+
+    /** Titular beneficiario de la recompensa. */
+    @IsString()
+    @IsNotEmpty()
+    directoryId: string;
+
+    /** Celular MX normalizado a 10 dígitos. */
+    @IsString()
+    @Matches(/^[0-9]{10}$/)
+    phone: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) moduleName: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) benefitId: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(256) leafId: string;
+
+    @IsString() @IsNotEmpty() @MaxLength(64) productId: string;
+
+    /** En PESOS, no centavos. */
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @IsPositive()
+    amount: number;
+
+    @IsString()
+    @MaxLength(120)
+    concept: string;
+}
+
+export default AuthorizeRewardTopupRequest;

package/src/transactionProcessor/enums/TransactionProcessorCodesEnum.ts

@@ -20,4 +20,12 @@ export enum TransactionProcessorCodesEnum {
     PROVIDER_NOT_FOUND = "PROVIDER_NOT_FOUND",
     /** El request no cumple el contrato del DTO. Nada tocó saldo. */
     INVALID_REQUEST = "INVALID_REQUEST",
+    /** Recarga de recompensa: el proveedor la rechazó de forma permanente (o se agotaron los intentos de folio). */
+    REWARD_TOPUP_PROVIDER_REJECTED = "REWARD_TOPUP_PROVIDER_REJECTED",
+    /** Recarga de recompensa: rechazo transitorio del proveedor; reintentable con la misma llave. */
+    REWARD_TOPUP_UNAVAILABLE = "REWARD_TOPUP_UNAVAILABLE",
+    /** Recarga de recompensa: resultado desconocido (timeout/PENDING); no se repaga. */
+    REWARD_TOPUP_OUTCOME_UNKNOWN = "REWARD_TOPUP_OUTCOME_UNKNOWN",
+    /** Recarga de recompensa: la llave de idempotencia sigue en vuelo. */
+    REWARD_TOPUP_IN_FLIGHT = "REWARD_TOPUP_IN_FLIGHT",
 }

package/src/transactionProcessor/index.ts

@@ -11,6 +11,7 @@ export * from './dtos/AuthorizeSpeiBankTransferNcRequest';
 export * from './dtos/AuthorizeCollectorTransactionRequest';
 export * from './dtos/AuthorizeDisputeTransactionRequest';
 export * from './dtos/AuthorizeBonusRequest';
+export * from './dtos/AuthorizeRewardTopupRequest';
 export * from './dtos/CardInfo';
 export * from './dtos/InstallmentsInfo';
 export * from './dtos/MerchantInfo';