@fiado/type-kit 3.645.0 → 3.647.0

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

@@ -31,3 +31,18 @@ describe('AuthorizeCollectionMovementRequest.tenantId', () => {
         expect(await invalidProperties({ ...VALID, tenantId: 42 })).toEqual(['tenantId']);
     });
 });
+
+describe('AuthorizeCollectionMovementRequest.costCenterId', () => {
+    it('es opcional', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+    });
+
+    it('acepta el centro de costo del producto', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: 'SK-COBRANZA' })).toEqual([]);
+    });
+
+    it('rechaza costCenterId vacío o no string', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties({ ...VALID, costCenterId: 42 })).toEqual(['costCenterId']);
+    });
+});

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

@@ -0,0 +1,54 @@
+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';
+
+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);
+}
+
+const UPSERT = {
+    sources: [{ order: 1, wallet: 'MXN', currency: 'MXN', mechanism: 'MXN_DIRECT', provider: 'wallet' }],
+    allowPartial: false,
+    retryPolicy: { maxAttempts: 3, backoffSeconds: 60 },
+    reportTargets: [],
+};
+
+const CONFIG = {
+    ...UPSERT,
+    tenantId: 'surekeep',
+    productId: 'loan',
+    version: 1,
+    createdBy: 'system',
+    updatedBy: 'system',
+};
+
+const BONUS = {
+    idempotencyKey: 'bonus-1',
+    productCatalogId: 'cat-1',
+    amount: 50,
+    directoryId: 'dir-1',
+    concept: 'Bono SureKeep',
+};
+
+describe.each([
+    ['CollectionProductConfigDto', CollectionProductConfigDto, CONFIG],
+    ['UpsertProductConfigRequest', UpsertProductConfigRequest, UPSERT],
+    ['AuthorizeBonusRequest', AuthorizeBonusRequest, BONUS],
+] as const)('%s.costCenterId', (_name, cls, valid) => {
+    const klass = cls as unknown as new () => object;
+
+    it('es opcional', async () => {
+        expect(await invalidProperties(klass, valid)).toEqual([]);
+    });
+
+    it('acepta un centro de costo', async () => {
+        expect(await invalidProperties(klass, { ...valid, costCenterId: 'SK-COBRANZA' })).toEqual([]);
+    });
+
+    it('rechaza vacío o no string', async () => {
+        expect(await invalidProperties(klass, { ...valid, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties(klass, { ...valid, costCenterId: 3 })).toEqual(['costCenterId']);
+    });
+});

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

@@ -130,3 +130,18 @@ describe('DisburseResponse', () => {
         expect(await validate(plainToInstance(DisburseResponse, { transactionId: null }) as object)).toHaveLength(0);
     });
 });
+
+describe('DisburseRequest.costCenterId', () => {
+    it('es opcional', async () => {
+        expect(await invalidProperties(VALID)).toEqual([]);
+    });
+
+    it('acepta el centro de costo de quien dispersa', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: 'SK-BONOS' })).toEqual([]);
+    });
+
+    it('rechaza vacío o no string', async () => {
+        expect(await invalidProperties({ ...VALID, costCenterId: '' })).toEqual(['costCenterId']);
+        expect(await invalidProperties({ ...VALID, costCenterId: 9 })).toEqual(['costCenterId']);
+    });
+});

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

@@ -0,0 +1,15 @@
+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/_test_/unit/reconciliation/reconciliationRequests.test.ts

@@ -206,6 +206,21 @@ describe('feed genérico de los dueños', () => {
         );
     });
 
+    it('costCenterIds es opcional y llega como csv del query', () => {
+        const base = { tenantId: 'surekeep', from: '2026-10-19T06:00:00.000Z', to: '2026-10-26T05:59:59.999Z' };
+        expect(errorsOf(PrivateListReconciliationFeedQuery, base)).toEqual([]);
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA, SK-BONOS' })).toEqual([]);
+        const dto = plainToInstance(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA, SK-BONOS' }, { excludeExtraneousValues: true });
+        expect(dto.costCenterIds).toEqual(['SK-COBRANZA', 'SK-BONOS']);
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: ['SK-COBRANZA'] })).toEqual([]);
+    });
+
+    it('costCenterIds rechaza elementos vacíos', () => {
+        const base = { tenantId: 'surekeep', from: '2026-10-19T06:00:00.000Z', to: '2026-10-26T05:59:59.999Z' };
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: 'SK-COBRANZA,' })).toContain('costCenterIds');
+        expect(errorsOf(PrivateListReconciliationFeedQuery, { ...base, costCenterIds: '' })).toContain('costCenterIds');
+    });
+
     it('el registro por recordId pide tenant y el servicio que llama; el actor es opcional', () => {
         expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { tenantId: 'surekeep', author: 'reconciliation-engine-business' })).toEqual(
             [],
@@ -220,6 +235,17 @@ describe('feed genérico de los dueños', () => {
         expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { tenantId: 'surekeep' })).toContain('author');
     });
 
+    it('el registro por recordId acepta costCenterIds opcionales en csv o arreglo', () => {
+        const base = { tenantId: 'surekeep', author: 'reconciliation-engine-business' };
+        expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { ...base, costCenterIds: 'SK-COBRANZA, SK-BONOS' })).toEqual([]);
+        const dto = plainToInstance(PrivateGetReconciliationFeedRecordQuery, { ...base, costCenterIds: 'SK-COBRANZA, SK-BONOS' }, { excludeExtraneousValues: true });
+        expect(dto.costCenterIds).toEqual(['SK-COBRANZA', 'SK-BONOS']);
+        expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { ...base, costCenterIds: ['SK-COBRANZA'] })).toEqual([]);
+        expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { ...base, costCenterIds: 'SK-COBRANZA,' })).toContain('costCenterIds');
+        expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { ...base, costCenterIds: '' })).toContain('costCenterIds');
+        expect(errorsOf(PrivateGetReconciliationFeedRecordQuery, { ...base, costCenterIds: [7] })).toContain('costCenterIds');
+    });
+
     it('el concepto del path es del catálogo de feeds', () => {
         expect(errorsOf(ReconciliationFeedPathParams, { concept: ReconciliationFeedConceptEnum.SIGNED_CREDIT })).toEqual([]);
         expect(errorsOf(ReconciliationFeedPathParams, { concept: 'ADJUSTMENT' })).toContain('concept');

package/_test_/unit/transaction/transactionCreateRequestM8.test.ts

@@ -1,27 +1,42 @@
 import 'reflect-metadata';
 import { plainToInstance } from 'class-transformer';
 import { validateSync } from 'class-validator';
-import { TransactionCreateRequest } from '../../../src/transaction';
+import { TransactionCreateRequest, UNASSIGNED_COST_CENTER_ID } from '../../../src/transaction';
 
 function errorPropsOf(payload: Record<string, unknown>): string[] {
     return validateSync(plainToInstance(TransactionCreateRequest, payload)).map((e) => e.property);
 }
 
-describe('TransactionCreateRequest · executionId y tenant SOFOM', () => {
+describe('TransactionCreateRequest · executionId y centro de costo', () => {
     it('ambos son opcionales', () => {
         const props = errorPropsOf({});
         expect(props).not.toContain('executionId');
-        expect(props).not.toContain('sofomTenantId');
+        expect(props).not.toContain('costCenterId');
     });
 
     it('acepta strings no vacíos', () => {
-        const props = errorPropsOf({ executionId: 'exec-1', sofomTenantId: 'surekeep' });
+        const props = errorPropsOf({ executionId: 'exec-1', costCenterId: 'SK-COBRANZA' });
         expect(props).not.toContain('executionId');
-        expect(props).not.toContain('sofomTenantId');
+        expect(props).not.toContain('costCenterId');
+    });
+
+    it('acepta el centro de costo sin asignar', () => {
+        expect(errorPropsOf({ costCenterId: UNASSIGNED_COST_CENTER_ID })).not.toContain('costCenterId');
     });
 
     it('rechaza tipos que no son string o vacíos', () => {
         expect(errorPropsOf({ executionId: 12 })).toContain('executionId');
-        expect(errorPropsOf({ sofomTenantId: '' })).toContain('sofomTenantId');
+        expect(errorPropsOf({ costCenterId: '' })).toContain('costCenterId');
+        expect(errorPropsOf({ costCenterId: 7 })).toContain('costCenterId');
+    });
+
+    it('ya no declara el tenant SOFOM', () => {
+        expect(errorPropsOf({ sofomTenantId: '' })).not.toContain('sofomTenantId');
+    });
+});
+
+describe('UNASSIGNED_COST_CENTER_ID', () => {
+    it('es UNASSIGNED', () => {
+        expect(UNASSIGNED_COST_CENTER_ID).toBe('UNASSIGNED');
     });
 });

package/_test_/unit/transactionProcessor/reconciliationAdjustment.test.ts

@@ -37,6 +37,14 @@ describe('PrivateAuthorizeReconciliationAdjustmentRequest', () => {
         expect(errorsOf(rest)).toEqual([]);
     });
 
+    it('costCenterId es opcional y, si llega, es texto no vacío', () => {
+        expect(errorsOf({ ...valid, costCenterId: 'SK-COBRANZA' })).toEqual([]);
+        expect(errorsOf({ ...valid, costCenterId: '' })).toContain('costCenterId');
+        expect(errorsOf({ ...valid, costCenterId: 7 })).toContain('costCenterId');
+        const dto = plainToInstance(PrivateAuthorizeReconciliationAdjustmentRequest, { ...valid, costCenterId: 'SK-COBRANZA' }, { excludeExtraneousValues: true });
+        expect(dto.costCenterId).toBe('SK-COBRANZA');
+    });
+
     it('la llave debe empezar con el tenantId', () => {
         expect(errorsOf({ ...valid, adjustmentKey: 'otro#INSTALLMENT_COLLECTION_L1#exec-1#1' })).toEqual(['adjustmentKey']);
         expect(errorsOf({ ...valid, adjustmentKey: 'INSTALLMENT_COLLECTION_L1#exec-1#1' })).toEqual(['adjustmentKey']);

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

@@ -11,7 +11,16 @@ export declare class AuthorizeCollectionMovementRequest {
     intentId?: string;
     chargeId?: string;
     holdTxId?: string;
+    /**
+     * Tenant SOFOM del intento de cobro. Se conserva por compatibilidad con transaction-processor; el
+     * ledger ya no lo usa: la pertenencia contable del movimiento viaja en `costCenterId`.
+     */
     tenantId?: string;
+    /**
+     * Centro de costo del producto cobrado, tomado de su configuración en el motor. El processor lo
+     * escribe en la transacción del ledger; ausente, queda como `UNASSIGNED`.
+     */
+    costCenterId?: string;
     /**
      * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
      * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el

package/bin/collection/dtos/AuthorizeCollectionMovementRequest.js

@@ -63,6 +63,12 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], AuthorizeCollectionMovementRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AuthorizeCollectionMovementRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),

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

@@ -17,6 +17,8 @@ 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,6 +58,12 @@ __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/DisburseRequest.d.ts

@@ -18,6 +18,11 @@ export declare class DisburseRequest {
     concept: string;
     /** Id del llamador para rastreo: asiento, crédito. */
     reference?: string;
+    /**
+     * Centro de costo de la dispersión, tomado de la configuración de quien dispersa. El motor lo
+     * reenvía al processor en `AuthorizeBonusRequest.costCenterId`; ausente, el ledger escribe `UNASSIGNED`.
+     */
+    costCenterId?: string;
     /** Datos de la recarga. Obligatorio si `disbursementType` es `MEX_REWARD_TOPUP`; en otros tipos se ignora. */
     topup?: DisburseTopupDetail;
 }

package/bin/collection/dtos/DisburseRequest.js

@@ -64,6 +64,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], DisburseRequest.prototype, "reference", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], DisburseRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_validator_1.ValidateIf)((o) => o.disbursementType === DisbursementType_1.DisbursementType.MEX_REWARD_TOPUP),
     (0, class_validator_1.IsDefined)(),

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

@@ -9,4 +9,6 @@ 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,3 +41,9 @@ __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,6 +13,7 @@ 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,6 +31,8 @@ __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/collection/interfaces/TenantCostCenters.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 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

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

package/bin/reconciliation/dtos/ReconciliationDefinition.d.ts

@@ -11,6 +11,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. */
 export interface ReconciliationDefinitionBankAccountView {

package/bin/reconciliation/dtos/requests/ReconciliationFeedRequests.d.ts

@@ -13,6 +13,11 @@ export declare class PrivateListReconciliationFeedQuery {
     from: string;
     to: string;
     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.
+     */
+    costCenterIds?: string[];
 }
 /** Query de privateGetReconciliationFeedRecord; `author` y `actor` van al registro de acceso del dueño. */
 export declare class PrivateGetReconciliationFeedRecordQuery {
@@ -20,4 +25,9 @@ export declare class PrivateGetReconciliationFeedRecordQuery {
     author: string;
     /** Email del operador cuando la lectura sale del detalle de una partida. */
     actor?: string;
+    /**
+     * Centros de costo de la fuente, en csv (`a,b`) o repetidos. El dueño del feed del ledger solo
+     * devuelve el registro si pertenece a uno de ellos.
+     */
+    costCenterIds?: string[];
 }

package/bin/reconciliation/dtos/requests/ReconciliationFeedRequests.js

@@ -53,6 +53,15 @@ __decorate([
     (0, reconciliationRequestDecorators_1.PageToken)(),
     __metadata("design:type", String)
 ], PrivateListReconciliationFeedQuery.prototype, "cursor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.split(',').map((id) => id.trim()) : value)),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], PrivateListReconciliationFeedQuery.prototype, "costCenterIds", void 0);
 /** Query de privateGetReconciliationFeedRecord; `author` y `actor` van al registro de acceso del dueño. */
 class PrivateGetReconciliationFeedRecordQuery {
 }
@@ -69,3 +78,12 @@ __decorate([
     (0, reconciliationRequestDecorators_1.OptionalEmail)(),
     __metadata("design:type", String)
 ], PrivateGetReconciliationFeedRecordQuery.prototype, "actor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (typeof value === 'string' ? value.split(',').map((id) => id.trim()) : value)),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
+    __metadata("design:type", Array)
+], PrivateGetReconciliationFeedRecordQuery.prototype, "costCenterIds", void 0);

package/bin/transaction/constants/costCenter.d.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 declare const UNASSIGNED_COST_CENTER_ID = "UNASSIGNED";

package/bin/transaction/constants/costCenter.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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';

package/bin/transaction/dtos/TransactionCreateRequest.d.ts

@@ -56,6 +56,9 @@ export declare class TransactionCreateRequest {
     domFolio?: string;
     /** Intento del motor de cobro que originó el cargo; en cobranza es igual al `attemptId`. */
     executionId?: string;
-    /** Tenant SOFOM dueño del cobro; `tenantId` del ledger sigue siendo `FIADO`. */
-    sofomTenantId?: string;
+    /**
+     * 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`.
+     */
+    costCenterId?: string;
 }

package/bin/transaction/dtos/TransactionCreateRequest.js

@@ -211,4 +211,4 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     (0, class_validator_1.IsOptional)(),
     __metadata("design:type", String)
-], TransactionCreateRequest.prototype, "sofomTenantId", void 0);
+], TransactionCreateRequest.prototype, "costCenterId", void 0);

package/bin/transaction/index.d.ts

@@ -36,6 +36,7 @@ export * from './dtos/internal/ProviderTransactionReversalRequest';
 export * from './dtos/internal/ProviderTransactionReversalResponse';
 export * from './dtos/internal/ProviderTransactionCompletionRequest';
 export * from './dtos/internal/ProviderTransactionCompletionResponse';
+export * from './constants/costCenter';
 export * from './enums/OperationEnum';
 export * from './enums/TransactionSourceEnum';
 export * from './enums/TransactionStatusEnum';

package/bin/transaction/index.js

@@ -53,6 +53,8 @@ __exportStar(require("./dtos/internal/ProviderTransactionReversalRequest"), expo
 __exportStar(require("./dtos/internal/ProviderTransactionReversalResponse"), exports);
 __exportStar(require("./dtos/internal/ProviderTransactionCompletionRequest"), exports);
 __exportStar(require("./dtos/internal/ProviderTransactionCompletionResponse"), exports);
+//constants
+__exportStar(require("./constants/costCenter"), exports);
 //enums
 __exportStar(require("./enums/OperationEnum"), exports);
 __exportStar(require("./enums/TransactionSourceEnum"), exports);

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

@@ -15,5 +15,7 @@ export declare class AuthorizeBonusRequest {
     directoryId: string;
     /** Lo que el cliente ve como descripción de su movimiento. */
     concept: string;
+    /** Centro de costo del bono en el ledger; ausente, el processor escribe `UNASSIGNED`. */
+    costCenterId?: string;
 }
 export default AuthorizeBonusRequest;

package/bin/transactionProcessor/dtos/AuthorizeBonusRequest.js

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

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

@@ -21,6 +21,8 @@ export declare class PrivateAuthorizeReconciliationAdjustmentRequest {
     originalTransactionId: string;
     /** Intento del cobro original, si lo hubo. */
     executionId?: string;
+    /** Centro de costo de la fuente ejecutada de la partida; el processor lo asienta en el ledger. */
+    costCenterId?: string;
     reference: ReconciliationAdjustmentReference;
     reason: string;
     /** Email del operador que resolvió la partida. */

package/bin/transactionProcessor/dtos/PrivateAuthorizeReconciliationAdjustmentRequest.js

@@ -81,6 +81,13 @@ __decorate([
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)
 ], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "executionId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], PrivateAuthorizeReconciliationAdjustmentRequest.prototype, "costCenterId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.ValidateNested)(),

package/package.json

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

package/src/collection/dtos/AuthorizeCollectionMovementRequest.ts

@@ -14,9 +14,18 @@ export class AuthorizeCollectionMovementRequest {
   @IsOptional() @IsString() intentId?: string;
   @IsOptional() @IsString() chargeId?: string;
   @IsOptional() @IsString() holdTxId?: string;
-  // Tenant SOFOM del intento de cobro; transaction-processor lo asienta como `sofomTenantId`.
+  /**
+   * Tenant SOFOM del intento de cobro. Se conserva por compatibilidad con transaction-processor; el
+   * ledger ya no lo usa: la pertenencia contable del movimiento viaja en `costCenterId`.
+   */
   @IsOptional() @IsString() @IsNotEmpty() tenantId?: string;
 
+  /**
+   * Centro de costo del producto cobrado, tomado de su configuración en el motor. El processor lo
+   * escribe en la transacción del ledger; ausente, queda como `UNASSIGNED`.
+   */
+  @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
+
   /**
    * Tarifa con la que se registra el cobro. Presente, el movimiento deja además una transacción
    * Fiado: asiento contable, historial visible para el cliente y comisión declarada. Ausente, el

package/src/collection/dtos/CollectionProductConfigDto.ts

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

@@ -30,6 +30,12 @@ export class DisburseRequest {
     /** Id del llamador para rastreo: asiento, crédito. */
     @IsOptional() @IsString() reference?: string;
 
+    /**
+     * Centro de costo de la dispersión, tomado de la configuración de quien dispersa. El motor lo
+     * reenvía al processor en `AuthorizeBonusRequest.costCenterId`; ausente, el ledger escribe `UNASSIGNED`.
+     */
+    @IsOptional() @IsString() @IsNotEmpty() costCenterId?: string;
+
     /** Datos de la recarga. Obligatorio si `disbursementType` es `MEX_REWARD_TOPUP`; en otros tipos se ignora. */
     @ValidateIf((o: DisburseRequest) => o.disbursementType === DisbursementType.MEX_REWARD_TOPUP)
     @IsDefined()

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/index.ts

@@ -17,6 +17,9 @@ 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/collection/interfaces/TenantCostCenters.ts

@@ -0,0 +1,14 @@
+/**
+ * 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/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. */
@@ -44,4 +56,16 @@ export class PrivateGetReconciliationFeedRecordQuery {
     /** Email del operador cuando la lectura sale del detalle de una partida. */
     @OptionalEmail()
     actor?: string;
+
+    /**
+     * Centros de costo de la fuente, en csv (`a,b`) o repetidos. El dueño del feed del ledger solo
+     * devuelve el registro si pertenece a uno de ellos.
+     */
+    @Expose()
+    @IsOptional()
+    @Transform(({ value }) => (typeof value === 'string' ? value.split(',').map((id) => id.trim()) : value))
+    @IsArray()
+    @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    costCenterIds?: string[];
 }

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/PrivateAuthorizeReconciliationAdjustmentRequest.ts

@@ -77,6 +77,13 @@ export class PrivateAuthorizeReconciliationAdjustmentRequest {
     @IsNotEmpty()
     executionId?: string;
 
+    /** Centro de costo de la fuente ejecutada de la partida; el processor lo asienta en el ledger. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @IsNotEmpty()
+    costCenterId?: string;
+
     @Expose()
     @ValidateNested()
     @Type(() => ReconciliationAdjustmentReference)