@fiado/type-kit 3.646.0 → 3.647.0

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

@@ -235,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/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/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/requests/ReconciliationFeedRequests.d.ts

@@ -25,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

@@ -78,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/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.646.0",
+  "version": "3.647.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

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/requests/ReconciliationFeedRequests.ts

@@ -56,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/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)