@fiado/type-kit 3.644.0 → 3.646.0

package/src/collection/dtos/DisburseTopupDetail.ts

@@ -0,0 +1,15 @@
+import { IsNotEmpty, IsString, Matches, MaxLength } from 'class-validator';
+
+/** Datos de la recarga Bait de una dispersión `MEX_REWARD_TOPUP`. */
+export class DisburseTopupDetail {
+    /** 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;
+}

package/src/collection/dtos/UpsertProductConfigRequest.ts

@@ -1,4 +1,4 @@
-import { IsString, IsArray, IsBoolean, ValidateNested } from 'class-validator';
+import { IsString, IsArray, IsBoolean, IsNotEmpty, IsOptional, ValidateNested } from 'class-validator';
 import { Type } from 'class-transformer';
 import { CollectionSourceDto } from './CollectionSourceDto';
 import { RetryPolicyDto } from './RetryPolicyDto';
@@ -12,4 +12,6 @@ export class UpsertProductConfigRequest {
   @IsBoolean() allowPartial!: boolean;
   @ValidateNested() @Type(() => RetryPolicyDto) retryPolicy!: RetryPolicyDto;
   @IsArray() @IsString({ each: true }) reportTargets!: string[];
+  /** Centro de costo con el que el ledger registra los cobros de este producto. */
+  @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
 }

package/src/collection/enums/DisbursementType.ts

@@ -9,4 +9,6 @@ export enum DisbursementType {
     MEX_SELLER_COMMISSION = 'MEX_SELLER_COMMISSION',
     /** Abono de recompensas de `rewards-business`. */
     MEX_REWARD = 'MEX_REWARD',
+    /** Recarga Bait de recompensas de `rewards-business`. */
+    MEX_REWARD_TOPUP = 'MEX_REWARD_TOPUP',
 }

package/src/collection/index.ts

@@ -35,6 +35,7 @@ export * from './dtos/RegisterCollectibleResponse';
 export * from './dtos/CollectionPricingDto';
 export * from './dtos/ResolvePendingChargesRequest';
 export * from './dtos/MoneyInEvent';
+export * from './dtos/DisburseTopupDetail';
 export * from './dtos/DisburseRequest';
 export * from './dtos/DisburseResponse';
 

package/src/productCatalog/enums/ProductSubtypeEnum.ts

@@ -89,6 +89,8 @@ export enum ProductSubtypeEnum {
     //REWARDS
     // Abono de recompensas de `rewards-business`.
     REWARD_MX = "REWARD_MX",
+    // Recarga Bait de recompensas de `rewards-business`.
+    REWARD_TOPUP_MX = "REWARD_TOPUP_MX",
 
     //STORE
     STORE_PHONE = "PHONE",

package/src/reconciliation/dtos/ReconciliationDefinition.ts

@@ -12,6 +12,8 @@ export interface ReconciliationDefinitionSource {
     domain: ReconciliationFeedOwnerEnum;
     concept: ReconciliationFeedConceptEnum;
     partName?: string;
+    /** Centros de costo del ledger que pertenecen al tenant; el feed solo devuelve esos. */
+    costCenterIds?: string[];
 }
 
 /** Cuenta de FSA cuyo EdC lee una definición BANK_STATEMENT. */

package/src/reconciliation/dtos/requests/ReconciliationFeedRequests.ts

@@ -1,5 +1,5 @@
-import { Expose } from 'class-transformer';
-import { IsEnum, IsISO8601 } from 'class-validator';
+import { Expose, Transform } from 'class-transformer';
+import { IsArray, IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString } from 'class-validator';
 import { ReconciliationFeedConceptEnum } from '../../enums/ReconciliationFeedConceptEnum';
 import { OptionalEmail, PageToken, RequiredId } from './reconciliationRequestDecorators';
 
@@ -31,6 +31,18 @@ export class PrivateListReconciliationFeedQuery {
 
     @PageToken()
     cursor?: string;
+
+    /**
+     * Centros de costo del tenant, en csv (`a,b`). El dueño del feed filtra por ellos; sin la
+     * lista responde vacío, nunca el ledger completo.
+     */
+    @Expose()
+    @IsOptional()
+    @Transform(({ value }) => (typeof value === 'string' ? value.split(',').map((id) => id.trim()) : value))
+    @IsArray()
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    costCenterIds?: string[];
 }
 
 /** Query de privateGetReconciliationFeedRecord; `author` y `actor` van al registro de acceso del dueño. */

package/src/rewards/dtos/backoffice/BackofficeGrantItemResponse.ts

@@ -5,6 +5,8 @@ import { BackofficeGrantAttemptResponse } from './BackofficeGrantAttemptResponse
 export class BackofficeGrantItemResponse extends GrantItemResponse {
     /** Nombre de la recompensa congelada en la entrega. */
     name: string;
+    /** Tipo de recompensa congelado en la entrega (ej. `'MOBILE_TOPUP'`). */
+    type?: string;
     attempts: BackofficeGrantAttemptResponse[];
     /** Motivo de la espera por tope; solo cuando el ítem está en `WAITING_LIMIT`. */
     waitReason?: LimitWaitReasonEnum;

package/src/rewards/dtos/backoffice/MobileTopupConfigRequest.ts

@@ -0,0 +1,41 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNotEmpty, IsNumber, IsOptional, IsPositive, IsString, MaxLength, Min } from 'class-validator';
+
+/** Guarda la configuración de la recarga Bait (producto en Multicenter y precio mensual). */
+export class MobileTopupConfigRequest {
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(100)
+    moduleName: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(100)
+    benefitId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(100)
+    leafId: string;
+
+    @Expose()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(100)
+    productId: string;
+
+    @Expose()
+    @IsNumber({ maxDecimalPlaces: 2 })
+    @IsPositive()
+    monthlyPrice: number;
+
+    /** Candado optimista: versión que el operador vio al editar. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(1)
+    expectedVersion?: number;
+}

package/src/rewards/dtos/backoffice/MobileTopupConfigResponse.ts

@@ -0,0 +1,15 @@
+export interface MobileTopupConfigResponse {
+    moduleName: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    monthlyPrice: number;
+    currency: 'MXN';
+    version: number;
+    updatedBy: string;
+    updatedAt: number;
+    /** Ítems del catálogo `MOBILE_TOPUP` recalculados al guardar. */
+    repricedItems?: number;
+    /** Ítems omitidos por conflicto de versión. */
+    skippedItems?: number;
+}

package/src/rewards/dtos/backoffice/MobileTopupContributionResponse.ts

@@ -0,0 +1,9 @@
+export interface MobileTopupContributionResponse {
+    grantId: string;
+    itemKey: string;
+    months: number;
+    sourceService: string;
+    sourceReference: string;
+    campaignId?: string;
+    addedAt: number;
+}

package/src/rewards/dtos/backoffice/MobileTopupPlanListResponse.ts

@@ -0,0 +1,6 @@
+import { MobileTopupPlanResponse } from './MobileTopupPlanResponse';
+
+export interface MobileTopupPlanListResponse {
+    items: MobileTopupPlanResponse[];
+    truncated: boolean;
+}

package/src/rewards/dtos/backoffice/MobileTopupPlanResponse.ts

@@ -0,0 +1,23 @@
+import { MobileTopupPlanStatusEnum } from '../../enums/MobileTopupPlanStatusEnum';
+import { MobileTopupContributionResponse } from './MobileTopupContributionResponse';
+import { MobileTopupRechargeResponse } from './MobileTopupRechargeResponse';
+
+/** Calendario de recargas Bait de un número. */
+export interface MobileTopupPlanResponse {
+    phone: string;
+    status: MobileTopupPlanStatusEnum;
+    promised: number;
+    done: number;
+    pending: number;
+    nextDueAt?: number;
+    lastRechargeAt?: number;
+    lastFolio?: string;
+    failedAttempts: number;
+    lastError?: string;
+    closedUndelivered?: number;
+    closedBy?: string;
+    closedAt?: number;
+    contributions: MobileTopupContributionResponse[];
+    recharges?: MobileTopupRechargeResponse[];
+    updatedAt: number;
+}

package/src/rewards/dtos/backoffice/MobileTopupRechargeResponse.ts

@@ -0,0 +1,9 @@
+import { MobileTopupRechargeStatusEnum } from '../../enums/MobileTopupRechargeStatusEnum';
+
+export interface MobileTopupRechargeResponse {
+    folio: string;
+    rechargeNumber: number;
+    status: MobileTopupRechargeStatusEnum;
+    at: number;
+    summary?: string;
+}

package/src/rewards/enums/MobileTopupPlanStatusEnum.ts

@@ -0,0 +1,6 @@
+/** Estado del calendario de recargas Bait de un número. */
+export enum MobileTopupPlanStatusEnum {
+    ACTIVE = 'ACTIVE',
+    NEEDS_ATTENTION = 'NEEDS_ATTENTION',
+    DONE = 'DONE',
+}

package/src/rewards/enums/MobileTopupRechargeStatusEnum.ts

@@ -0,0 +1,7 @@
+/** Resultado de una recarga mensual del calendario. */
+export enum MobileTopupRechargeStatusEnum {
+    PAID = 'PAID',
+    REJECTED = 'REJECTED',
+    UNCONFIRMED = 'UNCONFIRMED',
+    NOT_DELIVERED = 'NOT_DELIVERED',
+}

package/src/rewards/enums/RewardItemCodeEnum.ts

@@ -6,4 +6,8 @@ export enum RewardItemCodeEnum {
     LIMIT_WAIT_EXPIRED = 'LIMIT_WAIT_EXPIRED',
     /** Resultado desconocido agotado: no se puede asegurar si el abono ocurrió. */
     OUTCOME_UNKNOWN = 'OUTCOME_UNKNOWN',
+    /** Bait rechazó la recarga de forma permanente: queda en atención del operador. */
+    TOPUP_REJECTED = 'TOPUP_REJECTED',
+    /** Un operador dio el ítem por fallido. */
+    ITEM_DISMISSED = 'ITEM_DISMISSED',
 }

package/src/rewards/index.ts

@@ -13,6 +13,8 @@ export * from './enums/RewardsErrorCodeEnum';
 export * from './enums/DeliveryDimensionEnum';
 export * from './enums/DeliveryTopDimensionEnum';
 export * from './enums/DeliveryTopByEnum';
+export * from './enums/MobileTopupPlanStatusEnum';
+export * from './enums/MobileTopupRechargeStatusEnum';
 
 //Types
 export * from './types/RewardInputs';
@@ -73,3 +75,9 @@ export * from './dtos/backoffice/DeliveryMetricsQuery';
 export * from './dtos/backoffice/DeliveryTopQuery';
 export * from './dtos/backoffice/DeliveryMetricsPoint';
 export * from './dtos/backoffice/DeliveryTopEntry';
+export * from './dtos/backoffice/MobileTopupConfigRequest';
+export * from './dtos/backoffice/MobileTopupConfigResponse';
+export * from './dtos/backoffice/MobileTopupContributionResponse';
+export * from './dtos/backoffice/MobileTopupRechargeResponse';
+export * from './dtos/backoffice/MobileTopupPlanResponse';
+export * from './dtos/backoffice/MobileTopupPlanListResponse';

package/src/transaction/constants/costCenter.ts

@@ -0,0 +1,5 @@
+/**
+ * Centro de costo de una transacción que llegó sin uno. El ledger lo escribe siempre, así que las
+ * transacciones sin dueño contable quedan agrupadas aquí en lugar de perderse del índice.
+ */
+export const UNASSIGNED_COST_CENTER_ID = 'UNASSIGNED';

package/src/transaction/dtos/TransactionCreateRequest.ts

@@ -173,9 +173,12 @@ export class TransactionCreateRequest {
     @IsOptional()
     executionId?: string;
 
-    /** Tenant SOFOM dueño del cobro; `tenantId` del ledger sigue siendo `FIADO`. */
+    /**
+     * Centro de costo contable de la transacción; con él se reparte el ledger entre dueños y
+     * conciliaciones. Si no llega, el ledger escribe `UNASSIGNED_COST_CENTER_ID`.
+     */
     @IsString()
     @IsNotEmpty()
     @IsOptional()
-    sofomTenantId?: string;
+    costCenterId?: string;
 }

package/src/transaction/index.ts

@@ -40,6 +40,9 @@ export * from './dtos/internal/ProviderTransactionCompletionRequest';
 export * from './dtos/internal/ProviderTransactionCompletionResponse';
 
 
+//constants
+export * from './constants/costCenter';
+
 //enums
 export * from './enums/OperationEnum';
 export * from './enums/TransactionSourceEnum';

package/src/transactionProcessor/dtos/AuthorizeBonusRequest.ts

@@ -1,4 +1,4 @@
-import { IsNotEmpty, IsNumber, IsPositive, IsString, MaxLength } from "class-validator";
+import { IsNotEmpty, IsNumber, IsOptional, IsPositive, IsString, MaxLength } from "class-validator";
 
 /**
  * Acreditación de un bono a la wallet PagoConfiado de una persona.
@@ -31,6 +31,12 @@ export class AuthorizeBonusRequest {
     @IsString()
     @MaxLength(120)
     concept: string;
+
+    /** Centro de costo del bono en el ledger; ausente, el processor escribe `UNASSIGNED`. */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    costCenterId?: string;
 }
 
 export default AuthorizeBonusRequest;

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';