@fiado/type-kit 3.647.0 → 3.649.0

package/_test_/unit/collection/costCenter.test.ts

@@ -1,8 +1,8 @@
 import 'reflect-metadata';
 import { plainToInstance } from 'class-transformer';
 import { validate } from 'class-validator';
-import { CollectionProductConfigDto, UpsertProductConfigRequest } from '../../../src/collection/index';
-import { AuthorizeBonusRequest } from '../../../src/transactionProcessor/index';
+import { CollectRequest, CollectionProductConfigDto, RegisterCollectibleRequest, UpsertProductConfigRequest } from '../../../src/collection/index';
+import { AuthorizeBonusRequest, AuthorizeRewardTopupRequest } from '../../../src/transactionProcessor/index';
 
 async function invalidProperties<T extends object>(cls: new () => T, body: Record<string, unknown>): Promise<string[]> {
     return (await validate(plainToInstance(cls, body) as object)).map((e) => e.property);
@@ -24,6 +24,13 @@ const CONFIG = {
     updatedBy: 'system',
 };
 
+const REGISTER = { directoryId: 'dir-1', tenantId: 'surekeep', domain: 'loan-credit', productId: 'loan', chargeId: 'c-1' };
+const COLLECT = { ...REGISTER, amount: 150.25 };
+const TOPUP = {
+    idempotencyKey: 'RW-1', directoryId: 'dir-1', phone: '5512345678', moduleName: 'm', benefitId: 'b1', leafId: 'l1',
+    productId: 'p1', amount: 15, concept: 'Recarga',
+};
+
 const BONUS = {
     idempotencyKey: 'bonus-1',
     productCatalogId: 'cat-1',
@@ -33,9 +40,10 @@ const BONUS = {
 };
 
 describe.each([
-    ['CollectionProductConfigDto', CollectionProductConfigDto, CONFIG],
-    ['UpsertProductConfigRequest', UpsertProductConfigRequest, UPSERT],
+    ['RegisterCollectibleRequest', RegisterCollectibleRequest, REGISTER],
+    ['CollectRequest', CollectRequest, COLLECT],
     ['AuthorizeBonusRequest', AuthorizeBonusRequest, BONUS],
+    ['AuthorizeRewardTopupRequest', AuthorizeRewardTopupRequest, TOPUP],
 ] as const)('%s.costCenterId', (_name, cls, valid) => {
     const klass = cls as unknown as new () => object;
 
@@ -52,3 +60,14 @@ describe.each([
         expect(await invalidProperties(klass, { ...valid, costCenterId: 3 })).toEqual(['costCenterId']);
     });
 });
+
+describe.each([
+    ['CollectionProductConfigDto', CollectionProductConfigDto, CONFIG],
+    ['UpsertProductConfigRequest', UpsertProductConfigRequest, UPSERT],
+] as const)('%s sin centro de costo', (_name, cls, valid) => {
+    it('el centro de costo lo manda el originador en cada cobro, no la configuración del producto', async () => {
+        const dto = plainToInstance(cls as unknown as new () => object, { ...valid, costCenterId: 'SK-COBRANZA' });
+        const errors = await validate(dto as object, { whitelist: true, forbidNonWhitelisted: true });
+        expect(errors.map((e) => e.property)).toEqual(['costCenterId']);
+    });
+});

package/_test_/unit/costCenter/moduleCostCenterConfig.test.ts

@@ -0,0 +1,77 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import { CreateSalePromotionRequest, UpdateSalePromotionRequest } from '../../../src/retailPromotions/index';
+import { CreatePromotionRequest, UpdatePromotionRequest } from '../../../src/loanOfferings/index';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../src/transaction/index';
+import type { WelcomeBonusPromotionResponse, SalePromotion } from '../../../src/retailPromotions/index';
+import type { PromotionBonusResponse, PromotionResponse } from '../../../src/loanOfferings/index';
+import type { CommissionPayoutPolicy, UpdatePoliciesRequest } from '../../../src/retailCommission/index';
+
+type Dto = new () => object;
+
+const errorProperties = async (dtoClass: Dto, raw: Record<string, unknown>): Promise<string[]> => {
+  const instance = plainToInstance(dtoClass, raw, { excludeExtraneousValues: true });
+  return (await validate(instance as object)).map((error) => error.property);
+};
+
+const salePromotion = {
+  name: 'Bono de venta',
+  customerText: 'Bono a tu wallet',
+  levers: { walletBonus: { amountCents: 10000 } },
+};
+
+const creditPromotion = {
+  name: 'Bono PCF',
+  description: 'Bono al activar el crédito',
+  effect: { pcfBonusCents: 5000 },
+  segmentId: 'SEG_ALL',
+  targetLevels: ['SILVER'],
+};
+
+describe('centro de costo en la configuración de los módulos que pagan', () => {
+  const tooLong = 'X'.repeat(COST_CENTER_ID_MAX_LENGTH + 1);
+
+  it.each([
+    ['CreateSalePromotionRequest', CreateSalePromotionRequest, salePromotion],
+    ['UpdateSalePromotionRequest', UpdateSalePromotionRequest, {}],
+    ['CreatePromotionRequest', CreatePromotionRequest, creditPromotion],
+    ['UpdatePromotionRequest', UpdatePromotionRequest, {}],
+  ] as const)('%s acepta el centro, ausente o null, y lo conserva al transformar', async (_name, dto, base) => {
+    const parsed = plainToInstance(dto as Dto, { ...base, costCenterId: 'CC_PROMO' }, { excludeExtraneousValues: true }) as {
+      costCenterId?: string | null;
+    };
+    expect(parsed.costCenterId).toBe('CC_PROMO');
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: 'CC_PROMO' })).not.toContain('costCenterId');
+    expect(await errorProperties(dto as Dto, { ...base })).not.toContain('costCenterId');
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: null })).not.toContain('costCenterId');
+  });
+
+  it.each([
+    ['CreateSalePromotionRequest', CreateSalePromotionRequest, salePromotion],
+    ['UpdateSalePromotionRequest', UpdateSalePromotionRequest, {}],
+    ['CreatePromotionRequest', CreatePromotionRequest, creditPromotion],
+    ['UpdatePromotionRequest', UpdatePromotionRequest, {}],
+  ] as const)('%s rechaza el centro vacío, que no es texto o demasiado largo', async (_name, dto, base) => {
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: '' })).toContain('costCenterId');
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: 42 })).toContain('costCenterId');
+    expect(await errorProperties(dto as Dto, { ...base, costCenterId: tooLong })).toContain('costCenterId');
+  });
+
+  it('las respuestas y la política de pagos llevan el centro opcional', () => {
+    const welcome: WelcomeBonusPromotionResponse = { promotionId: 'p', active: true, amountCents: 2500, costCenterId: 'CC_WELCOME' };
+    const bonus: Pick<PromotionBonusResponse, 'costCenterId'> = { costCenterId: 'CC_CREDIT' };
+    const credit: Pick<PromotionResponse, 'costCenterId'> = {};
+    const sale: Pick<SalePromotion, 'costCenterId'> = { costCenterId: 'CC_SALE' };
+    const payouts: Pick<CommissionPayoutPolicy, 'costCenterId'> = { costCenterId: 'CC_COMMISSION' };
+    const update: NonNullable<UpdatePoliciesRequest['payouts']>['costCenterId'] = null;
+    expect([welcome.costCenterId, bonus.costCenterId, credit.costCenterId, sale.costCenterId, payouts.costCenterId, update]).toEqual([
+      'CC_WELCOME',
+      'CC_CREDIT',
+      undefined,
+      'CC_SALE',
+      'CC_COMMISSION',
+      null,
+    ]);
+  });
+});

package/bin/collection/dtos/CollectRequest.d.ts

@@ -20,4 +20,10 @@ export declare class CollectRequest {
      * lo normal; se manda sólo cuando este cobro tiene condiciones propias.
      */
     pricing?: CollectionPricingDto;
+    /**
+     * Centro de costo con que el ledger asienta el cobro; lo decide la plataforma originadora por tipo de
+     * transacción. El motor lo guarda en la intención y lo reenvía al processor en cada intento. Ausente,
+     * el ledger lo asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string;
 }

package/bin/collection/dtos/CollectRequest.js

@@ -55,3 +55,9 @@ __decorate([
     (0, class_transformer_1.Type)(() => CollectionPricingDto_1.CollectionPricingDto),
     __metadata("design:type", CollectionPricingDto_1.CollectionPricingDto)
 ], CollectRequest.prototype, "pricing", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], CollectRequest.prototype, "costCenterId", void 0);

package/bin/collection/dtos/CollectionProductConfigDto.d.ts

@@ -17,8 +17,6 @@ export declare class CollectionProductConfigDto {
     allowPartial: boolean;
     retryPolicy: RetryPolicyDto;
     reportTargets: string[];
-    /** Centro de costo con el que el ledger registra los cobros de este producto. */
-    costCenterId?: string;
     createdBy: string;
     updatedBy: string;
 }

package/bin/collection/dtos/CollectionProductConfigDto.js

@@ -58,12 +58,6 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], CollectionProductConfigDto.prototype, "reportTargets", void 0);
-__decorate([
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], CollectionProductConfigDto.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)

package/bin/collection/dtos/RegisterCollectibleRequest.d.ts

@@ -23,4 +23,10 @@ export declare class RegisterCollectibleRequest {
      * cobro. Si un cargo se puede cobrar más de una vez, el ciclo va codificado aquí dentro.
      */
     chargeId: string;
+    /**
+     * Centro de costo con que el ledger asienta el cobro; lo decide la plataforma originadora por tipo de
+     * transacción. El motor lo guarda en la intención y lo reenvía al processor en cada intento. Ausente,
+     * el ledger lo asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string;
 }

package/bin/collection/dtos/RegisterCollectibleRequest.js

@@ -41,3 +41,9 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], RegisterCollectibleRequest.prototype, "chargeId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], RegisterCollectibleRequest.prototype, "costCenterId", void 0);

package/bin/collection/dtos/UpsertProductConfigRequest.d.ts

@@ -9,6 +9,4 @@ export declare class UpsertProductConfigRequest {
     allowPartial: boolean;
     retryPolicy: RetryPolicyDto;
     reportTargets: string[];
-    /** Centro de costo con el que el ledger registra los cobros de este producto. */
-    costCenterId?: string;
 }

package/bin/collection/dtos/UpsertProductConfigRequest.js

@@ -41,9 +41,3 @@ __decorate([
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], UpsertProductConfigRequest.prototype, "reportTargets", void 0);
-__decorate([
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
-    (0, class_validator_1.IsNotEmpty)(),
-    __metadata("design:type", String)
-], UpsertProductConfigRequest.prototype, "costCenterId", void 0);

package/bin/collection/index.d.ts

@@ -13,7 +13,6 @@ export * from './enums/RedriveOutboxStatus';
 export * from './enums/DisbursementType';
 export * from './constants/CollectionResultLimits';
 export * from './validators/IsCentPrecision';
-export * from './interfaces/TenantCostCenters';
 export * from './dtos/PendingChargeDto';
 export * from './dtos/CollectRequest';
 export * from './dtos/CollectResponse';

package/bin/collection/index.js

@@ -31,8 +31,6 @@ __exportStar(require("./enums/DisbursementType"), exports);
 // Constantes y validadores
 __exportStar(require("./constants/CollectionResultLimits"), exports);
 __exportStar(require("./validators/IsCentPrecision"), exports);
-// Interfaces
-__exportStar(require("./interfaces/TenantCostCenters"), exports);
 // DTOs
 __exportStar(require("./dtos/PendingChargeDto"), exports);
 __exportStar(require("./dtos/CollectRequest"), exports);

package/bin/loanOfferings/dtos/requests/CreatePromotionRequest.d.ts

@@ -31,4 +31,9 @@ export declare class CreatePromotionRequest {
      * presupuesto negativo es un request bien formado que el negocio rechaza.
      */
     budgetMaxCents?: number | null;
+    /**
+     * Centro de costo con que el ledger imputa el bono PCF de la promoción. Ausente o `null` = sin
+     * centro: el bono se asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string | null;
 }

package/bin/loanOfferings/dtos/requests/CreatePromotionRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const offeringsInputLimits_1 = require("../../constants/offeringsInputLimits");
 const promotionRetailerScope_1 = require("../../constants/promotionRetailerScope");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
 const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
@@ -117,3 +118,11 @@ __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)
 ], CreatePromotionRequest.prototype, "budgetMaxCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreatePromotionRequest.prototype, "costCenterId", void 0);

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.d.ts

@@ -29,6 +29,8 @@ export declare class UpdatePromotionRequest {
     validFrom?: string | null;
     validUntil?: string | null;
     budgetMaxCents?: number | null;
+    /** Centro de costo del bono PCF. Ausente = conserva el actual; `null` = lo quita. */
+    costCenterId?: string | null;
     /** Motivo del cambio; queda en la bitácora de la promoción. */
     reason?: string;
 }

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const offeringsInputLimits_1 = require("../../constants/offeringsInputLimits");
 const promotionRetailerScope_1 = require("../../constants/promotionRetailerScope");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
 const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
@@ -126,6 +127,14 @@ __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)
 ], UpdatePromotionRequest.prototype, "budgetMaxCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], UpdatePromotionRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

package/bin/loanOfferings/dtos/responses/PromotionBonusResponse.d.ts

@@ -11,6 +11,11 @@ export interface PromotionBonusResponse {
     /** Versión de la promoción al reservar: el monto queda congelado aunque la promo se edite. */
     promotionVersion: number;
     amountCents: number;
+    /**
+     * Centro de costo de la promoción al reservar, congelado como el monto. Quien paga lo manda al motor
+     * de cobro; ausente = el ledger asienta el bono como `UNASSIGNED`.
+     */
+    costCenterId?: string;
     status: PromotionBonusStatusEnum;
     /** Folio del processor. `null` mientras no haya cerrado, o si cerró sin darlo. */
     transactionId: string | null;

package/bin/loanOfferings/dtos/responses/PromotionResponse.d.ts

@@ -38,6 +38,8 @@ export interface PromotionResponse {
     phase: PromotionPhaseEnum | null;
     /** Tope de presupuesto; `null` = sin tope. */
     budgetMaxCents: number | null;
+    /** Centro de costo con que el ledger imputa el bono PCF; ausente = sin configurar. */
+    costCenterId?: string;
     budgetConsumedCents: number;
     creditsGenerated: number;
     version: number;

package/bin/retailCommission/dtos/CommissionApi.d.ts

@@ -320,6 +320,8 @@ export interface UpdatePoliciesRequest {
     payouts?: {
         walletDeposits: boolean;
         chainBillingPeriod: CommissionBillingPeriodEnum;
+        /** Centro de costo de los depósitos de comisiones. Ausente = conserva el guardado; `null` = lo quita. */
+        costCenterId?: string | null;
     };
 }
 export interface UpdatePoliciesResponse {

package/bin/retailCommission/dtos/CommissionRule.d.ts

@@ -118,6 +118,11 @@ export interface CommissionPayoutPolicy {
     walletDeposits: boolean;
     /** Cada cuánto se le cobra a la cadena. */
     chainBillingPeriod: CommissionBillingPeriodEnum;
+    /**
+     * Centro de costo con que el ledger imputa los depósitos de comisiones a la wallet. Ausente = sin
+     * configurar: el depósito se asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string;
 }
 /** Políticas de la cadena. `clawback` y `commissions` son `null` mientras la cadena no las guarda. */
 export interface CommissionPolicies {

package/bin/retailPromotions/dtos/SalePromotion.d.ts

@@ -33,6 +33,8 @@ export interface SalePromotion {
     stackable: boolean;
     /** Solo en promos `REFERRAL`. */
     referral?: ReferralPromotionConfig | null;
+    /** Centro de costo con que el ledger imputa lo que la promo paga a la wallet; ausente = sin configurar. */
+    costCenterId?: string;
     status: SalePromotionStatusEnum;
     /** Derivada; `null` cuando el estado no es `ACTIVE`. */
     phase: SalePromotionPhaseEnum | null;

package/bin/retailPromotions/dtos/requests/CreateSalePromotionRequest.d.ts

@@ -24,4 +24,10 @@ export declare class CreateSalePromotionRequest {
     stackable?: boolean;
     /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
     referral?: ReferralPromotionInput | null;
+    /**
+     * Centro de costo con que el ledger imputa lo que esta promo paga a la wallet (bono de venta,
+     * premio de referido, bono de bienvenida). Ausente o `null` = sin centro: el pago se asienta como
+     * `UNASSIGNED`.
+     */
+    costCenterId?: string | null;
 }

package/bin/retailPromotions/dtos/requests/CreateSalePromotionRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateSalePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
 const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
 const ReferralPromotionInput_1 = require("./ReferralPromotionInput");
@@ -103,3 +104,11 @@ __decorate([
     (0, class_transformer_1.Type)(() => ReferralPromotionInput_1.ReferralPromotionInput),
     __metadata("design:type", ReferralPromotionInput_1.ReferralPromotionInput)
 ], CreateSalePromotionRequest.prototype, "referral", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], CreateSalePromotionRequest.prototype, "costCenterId", void 0);

package/bin/retailPromotions/dtos/requests/UpdateSalePromotionRequest.d.ts

@@ -24,4 +24,6 @@ export declare class UpdateSalePromotionRequest {
     stackable?: boolean;
     /** Evento, condiciones y premios de la promo de referido; ausente en las demás promos. */
     referral?: ReferralPromotionInput | null;
+    /** Centro de costo de lo que la promo paga a la wallet. Ausente = conserva el actual; `null` = lo quita. */
+    costCenterId?: string | null;
 }

package/bin/retailPromotions/dtos/requests/UpdateSalePromotionRequest.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateSalePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const costCenter_1 = require("../../../transaction/constants/costCenter");
 const PromotionAppliesToEnum_1 = require("../../enums/PromotionAppliesToEnum");
 const PromotionPaymentOptionEnum_1 = require("../../enums/PromotionPaymentOptionEnum");
 const ReferralPromotionInput_1 = require("./ReferralPromotionInput");
@@ -105,3 +106,11 @@ __decorate([
     (0, class_transformer_1.Type)(() => ReferralPromotionInput_1.ReferralPromotionInput),
     __metadata("design:type", ReferralPromotionInput_1.ReferralPromotionInput)
 ], UpdateSalePromotionRequest.prototype, "referral", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(costCenter_1.COST_CENTER_ID_MAX_LENGTH),
+    __metadata("design:type", String)
+], UpdateSalePromotionRequest.prototype, "costCenterId", void 0);

package/bin/retailPromotions/dtos/responses/WelcomeBonusPromotionResponse.d.ts

@@ -3,4 +3,6 @@ export interface WelcomeBonusPromotionResponse {
     promotionId: string;
     active: boolean;
     amountCents: number;
+    /** Centro de costo del bono, configurado en la promo; ausente = el ledger lo asienta como `UNASSIGNED`. */
+    costCenterId?: string;
 }

package/bin/transaction/constants/costCenter.d.ts

@@ -3,3 +3,5 @@
  * transacciones sin dueño contable quedan agrupadas aquí en lugar de perderse del índice.
  */
 export declare const UNASSIGNED_COST_CENTER_ID = "UNASSIGNED";
+/** Largo máximo de un centro de costo capturado en la configuración de un módulo que paga. */
+export declare const COST_CENTER_ID_MAX_LENGTH = 64;

package/bin/transaction/constants/costCenter.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.UNASSIGNED_COST_CENTER_ID = void 0;
+exports.COST_CENTER_ID_MAX_LENGTH = exports.UNASSIGNED_COST_CENTER_ID = void 0;
 /**
  * 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.
  */
 exports.UNASSIGNED_COST_CENTER_ID = 'UNASSIGNED';
+/** Largo máximo de un centro de costo capturado en la configuración de un módulo que paga. */
+exports.COST_CENTER_ID_MAX_LENGTH = 64;

package/bin/transactionProcessor/dtos/AuthorizeAdjustmentTransactionRequest.d.ts

@@ -11,4 +11,6 @@ export declare class AuthorizeAdjustmentTransactionRequest {
     relatedTransactionNumber: string;
     operation: OperationEnum;
     concept: string;
+    /** Centro de costo del asiento del ajuste en el ledger; ausente, el ledger escribe `UNASSIGNED`. */
+    costCenterId?: string;
 }

package/bin/transactionProcessor/dtos/AuthorizeRewardTopupRequest.d.ts

@@ -17,5 +17,7 @@ export declare class AuthorizeRewardTopupRequest {
     /** En PESOS, no centavos. */
     amount: number;
     concept: string;
+    /** Centro de costo del asiento de la recarga en el ledger; ausente, el processor escribe `UNASSIGNED`. */
+    costCenterId?: string;
 }
 export default AuthorizeRewardTopupRequest;

package/bin/transactionProcessor/dtos/AuthorizeRewardTopupRequest.js

@@ -71,4 +71,10 @@ __decorate([
     (0, class_validator_1.MaxLength)(120),
     __metadata("design:type", String)
 ], AuthorizeRewardTopupRequest.prototype, "concept", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeRewardTopupRequest.prototype, "costCenterId", void 0);
 exports.default = AuthorizeRewardTopupRequest;

package/package.json

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

package/src/collection/dtos/CollectRequest.ts

@@ -1,4 +1,4 @@
-import { IsString, IsNumber, IsOptional, ValidateNested } from 'class-validator';
+import { IsNotEmpty, IsString, IsNumber, IsOptional, ValidateNested } from 'class-validator';
 import { Type } from 'class-transformer';
 import { CollectionPricingDto } from './CollectionPricingDto';
 
@@ -24,4 +24,11 @@ export class CollectRequest {
    * lo normal; se manda sólo cuando este cobro tiene condiciones propias.
    */
   @IsOptional() @ValidateNested() @Type(() => CollectionPricingDto) pricing?: CollectionPricingDto;
+
+  /**
+   * Centro de costo con que el ledger asienta el cobro; lo decide la plataforma originadora por tipo de
+   * transacción. El motor lo guarda en la intención y lo reenvía al processor en cada intento. Ausente,
+   * el ledger lo asienta como `UNASSIGNED`.
+   */
+  @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
 }

package/src/collection/dtos/CollectionProductConfigDto.ts

@@ -1,4 +1,4 @@
-import { IsString, IsInt, IsArray, IsBoolean, IsNotEmpty, IsOptional, ValidateNested } from 'class-validator';
+import { IsString, IsInt, IsArray, IsBoolean, ValidateNested } from 'class-validator';
 import { Type } from 'class-transformer';
 import { CollectionSourceDto } from './CollectionSourceDto';
 import { RetryPolicyDto } from './RetryPolicyDto';
@@ -20,8 +20,6 @@ export class CollectionProductConfigDto {
   @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;
   @IsString() createdBy!: string;
   @IsString() updatedBy!: string;
 }

package/src/collection/dtos/RegisterCollectibleRequest.ts

@@ -1,4 +1,4 @@
-import { IsString } from 'class-validator';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
 
 /**
  * Alta de un cargo cobrable: el dominio avisa de que hay algo que cobrar y el motor se encarga de
@@ -29,4 +29,11 @@ export class RegisterCollectibleRequest {
    * cobro. Si un cargo se puede cobrar más de una vez, el ciclo va codificado aquí dentro.
    */
   @IsString() chargeId!: string;
+
+  /**
+   * Centro de costo con que el ledger asienta el cobro; lo decide la plataforma originadora por tipo de
+   * transacción. El motor lo guarda en la intención y lo reenvía al processor en cada intento. Ausente,
+   * el ledger lo asienta como `UNASSIGNED`.
+   */
+  @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
 }

package/src/collection/dtos/UpsertProductConfigRequest.ts

@@ -1,4 +1,4 @@
-import { IsString, IsArray, IsBoolean, IsNotEmpty, IsOptional, ValidateNested } from 'class-validator';
+import { IsString, IsArray, IsBoolean, ValidateNested } from 'class-validator';
 import { Type } from 'class-transformer';
 import { CollectionSourceDto } from './CollectionSourceDto';
 import { RetryPolicyDto } from './RetryPolicyDto';
@@ -12,6 +12,4 @@ 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/index.ts

@@ -17,9 +17,6 @@ export * from './enums/DisbursementType';
 export * from './constants/CollectionResultLimits';
 export * from './validators/IsCentPrecision';
 
-// Interfaces
-export * from './interfaces/TenantCostCenters';
-
 // DTOs
 export * from './dtos/PendingChargeDto';
 export * from './dtos/CollectRequest';

package/src/loanOfferings/dtos/requests/CreatePromotionRequest.ts

@@ -19,6 +19,7 @@ import {
     SCOPE_STORE_IDS_MAX_ITEMS,
 } from '../../constants/offeringsInputLimits';
 import { PROMOTION_RETAILER_IDS_MAX_ITEMS } from '../../constants/promotionRetailerScope';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
@@ -117,4 +118,15 @@ export class CreatePromotionRequest {
     @IsOptional()
     @IsInt()
     budgetMaxCents?: number | null;
+
+    /**
+     * Centro de costo con que el ledger imputa el bono PCF de la promoción. Ausente o `null` = sin
+     * centro: el bono se asienta como `UNASSIGNED`.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
 }

package/src/loanOfferings/dtos/requests/UpdatePromotionRequest.ts

@@ -20,6 +20,7 @@ import {
     SCOPE_STORE_IDS_MAX_ITEMS,
 } from '../../constants/offeringsInputLimits';
 import { PROMOTION_RETAILER_IDS_MAX_ITEMS } from '../../constants/promotionRetailerScope';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
@@ -123,6 +124,14 @@ export class UpdatePromotionRequest {
     @IsInt()
     budgetMaxCents?: number | null;
 
+    /** Centro de costo del bono PCF. Ausente = conserva el actual; `null` = lo quita. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
+
     /** Motivo del cambio; queda en la bitácora de la promoción. */
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/responses/PromotionBonusResponse.ts

@@ -12,6 +12,11 @@ export interface PromotionBonusResponse {
     /** Versión de la promoción al reservar: el monto queda congelado aunque la promo se edite. */
     promotionVersion: number;
     amountCents: number;
+    /**
+     * Centro de costo de la promoción al reservar, congelado como el monto. Quien paga lo manda al motor
+     * de cobro; ausente = el ledger asienta el bono como `UNASSIGNED`.
+     */
+    costCenterId?: string;
     status: PromotionBonusStatusEnum;
     /** Folio del processor. `null` mientras no haya cerrado, o si cerró sin darlo. */
     transactionId: string | null;

package/src/loanOfferings/dtos/responses/PromotionResponse.ts

@@ -39,6 +39,8 @@ export interface PromotionResponse {
     phase: PromotionPhaseEnum | null;
     /** Tope de presupuesto; `null` = sin tope. */
     budgetMaxCents: number | null;
+    /** Centro de costo con que el ledger imputa el bono PCF; ausente = sin configurar. */
+    costCenterId?: string;
     budgetConsumedCents: number;
     creditsGenerated: number;
     version: number;

package/src/retailCommission/dtos/CommissionApi.ts

@@ -343,7 +343,12 @@ export interface UpdatePoliciesRequest {
     clawback: { cancelacionDias: number; devolucionDias: number; npiM30Dias: number };
     commissions: { multiplicadorMaxBps: number; ventanaDefault: CommissionWindowEnum };
     /** Opcional para que un editor que todavía no la manda siga funcionando. */
-    payouts?: { walletDeposits: boolean; chainBillingPeriod: CommissionBillingPeriodEnum };
+    payouts?: {
+        walletDeposits: boolean;
+        chainBillingPeriod: CommissionBillingPeriodEnum;
+        /** Centro de costo de los depósitos de comisiones. Ausente = conserva el guardado; `null` = lo quita. */
+        costCenterId?: string | null;
+    };
 }
 
 export interface UpdatePoliciesResponse {

package/src/retailCommission/dtos/CommissionRule.ts

@@ -130,6 +130,11 @@ export interface CommissionPayoutPolicy {
     walletDeposits: boolean;
     /** Cada cuánto se le cobra a la cadena. */
     chainBillingPeriod: CommissionBillingPeriodEnum;
+    /**
+     * Centro de costo con que el ledger imputa los depósitos de comisiones a la wallet. Ausente = sin
+     * configurar: el depósito se asienta como `UNASSIGNED`.
+     */
+    costCenterId?: string;
 }
 
 /** Políticas de la cadena. `clawback` y `commissions` son `null` mientras la cadena no las guarda. */

package/src/retailPromotions/dtos/SalePromotion.ts

@@ -34,6 +34,8 @@ export interface SalePromotion {
     stackable: boolean;
     /** Solo en promos `REFERRAL`. */
     referral?: ReferralPromotionConfig | null;
+    /** Centro de costo con que el ledger imputa lo que la promo paga a la wallet; ausente = sin configurar. */
+    costCenterId?: string;
     status: SalePromotionStatusEnum;
     /** Derivada; `null` cuando el estado no es `ACTIVE`. */
     phase: SalePromotionPhaseEnum | null;

package/src/retailPromotions/dtos/requests/CreateSalePromotionRequest.ts

@@ -9,8 +9,10 @@ import {
     IsNotEmpty,
     IsOptional,
     IsString,
+    MaxLength,
     ValidateNested,
 } from 'class-validator';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { ReferralPromotionInput } from './ReferralPromotionInput';
@@ -93,4 +95,16 @@ export class CreateSalePromotionRequest {
     @ValidateNested()
     @Type(() => ReferralPromotionInput)
     referral?: ReferralPromotionInput | null;
+
+    /**
+     * Centro de costo con que el ledger imputa lo que esta promo paga a la wallet (bono de venta,
+     * premio de referido, bono de bienvenida). Ausente o `null` = sin centro: el pago se asienta como
+     * `UNASSIGNED`.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
 }

package/src/retailPromotions/dtos/requests/UpdateSalePromotionRequest.ts

@@ -8,8 +8,10 @@ import {
     IsNotEmpty,
     IsOptional,
     IsString,
+    MaxLength,
     ValidateNested,
 } from 'class-validator';
+import { COST_CENTER_ID_MAX_LENGTH } from '../../../transaction/constants/costCenter';
 import { PromotionAppliesToEnum } from '../../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../../enums/PromotionPaymentOptionEnum';
 import { ReferralPromotionInput } from './ReferralPromotionInput';
@@ -94,4 +96,12 @@ export class UpdateSalePromotionRequest {
     @ValidateNested()
     @Type(() => ReferralPromotionInput)
     referral?: ReferralPromotionInput | null;
+
+    /** Centro de costo de lo que la promo paga a la wallet. Ausente = conserva el actual; `null` = lo quita. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(COST_CENTER_ID_MAX_LENGTH)
+    costCenterId?: string | null;
 }

package/src/retailPromotions/dtos/responses/WelcomeBonusPromotionResponse.ts

@@ -3,4 +3,6 @@ export interface WelcomeBonusPromotionResponse {
     promotionId: string;
     active: boolean;
     amountCents: number;
+    /** Centro de costo del bono, configurado en la promo; ausente = el ledger lo asienta como `UNASSIGNED`. */
+    costCenterId?: string;
 }

package/src/transaction/constants/costCenter.ts

@@ -3,3 +3,6 @@
  * transacciones sin dueño contable quedan agrupadas aquí en lugar de perderse del índice.
  */
 export const UNASSIGNED_COST_CENTER_ID = 'UNASSIGNED';
+
+/** Largo máximo de un centro de costo capturado en la configuración de un módulo que paga. */
+export const COST_CENTER_ID_MAX_LENGTH = 64;

package/src/transactionProcessor/dtos/AuthorizeAdjustmentTransactionRequest.ts

@@ -12,4 +12,6 @@ export class AuthorizeAdjustmentTransactionRequest {
     relatedTransactionNumber: string;
     operation: OperationEnum;
     concept: string;
+    /** Centro de costo del asiento del ajuste en el ledger; ausente, el ledger escribe `UNASSIGNED`. */
+    costCenterId?: string;
 }

package/src/transactionProcessor/dtos/AuthorizeRewardTopupRequest.ts

@@ -1,4 +1,4 @@
-import { IsNotEmpty, IsNumber, IsPositive, IsString, Matches, MaxLength } from 'class-validator';
+import { IsNotEmpty, IsNumber, IsOptional, IsPositive, IsString, Matches, MaxLength } from 'class-validator';
 
 /**
  * Pago de una recarga Bait de recompensa (`MEX_REWARD_TOPUP`). No toca ninguna wallet.
@@ -39,6 +39,12 @@ export class AuthorizeRewardTopupRequest {
     @IsString()
     @MaxLength(120)
     concept: string;
+
+    /** Centro de costo del asiento de la recarga en el ledger; ausente, el processor escribe `UNASSIGNED`. */
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    costCenterId?: string;
 }
 
 export default AuthorizeRewardTopupRequest;

package/_test_/unit/collection/tenantCostCenters.test.ts

@@ -1,15 +0,0 @@
-import type { TenantCostCenters } from '../../../src/collection/index';
-
-describe('TenantCostCenters', () => {
-    it('cada movimiento del tenant tiene su centro de costo opcional', () => {
-        const all: TenantCostCenters = {
-            welcomeBonus: 'SK-BONO-BIENVENIDA',
-            creditPromotion: 'SK-PROMO-CREDITO',
-            salePromotion: 'SK-PROMO-VENTA',
-            commission: 'SK-COMISIONES',
-        };
-        const none: TenantCostCenters = {};
-        expect(Object.keys(all)).toEqual(['welcomeBonus', 'creditPromotion', 'salePromotion', 'commission']);
-        expect(none).toEqual({});
-    });
-});

package/bin/collection/interfaces/TenantCostCenters.d.ts

@@ -1,14 +0,0 @@
-/**
- * Centros de costo de un tenant para los movimientos que paga desde su bolsa. Cada servicio que
- * dispersa lee el suyo de la configuración del tenant; si falta, el ledger lo asienta como no asignado.
- */
-export interface TenantCostCenters {
-    /** Bono de bienvenida al alta del cliente. */
-    welcomeBonus?: string;
-    /** Promociones ligadas al crédito. */
-    creditPromotion?: string;
-    /** Promociones ligadas a la venta. */
-    salePromotion?: string;
-    /** Comisiones a vendedores. */
-    commission?: string;
-}

package/bin/collection/interfaces/TenantCostCenters.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/src/collection/interfaces/TenantCostCenters.ts

@@ -1,14 +0,0 @@
-/**
- * Centros de costo de un tenant para los movimientos que paga desde su bolsa. Cada servicio que
- * dispersa lee el suyo de la configuración del tenant; si falta, el ledger lo asienta como no asignado.
- */
-export interface TenantCostCenters {
-    /** Bono de bienvenida al alta del cliente. */
-    welcomeBonus?: string;
-    /** Promociones ligadas al crédito. */
-    creditPromotion?: string;
-    /** Promociones ligadas a la venta. */
-    salePromotion?: string;
-    /** Comisiones a vendedores. */
-    commission?: string;
-}