@fiado/type-kit 3.190.0 → 3.191.0

package/_test_/unit/retailOrg/dtos/validation/validationDtos.test.ts

@@ -1,11 +1,13 @@
 import { RetailerValidationDto } from '../../../../../src/retailOrg/dtos/validation/RetailerValidationDto';
 import { StoreValidationDto } from '../../../../../src/retailOrg/dtos/validation/StoreValidationDto';
 import { RetailUserValidationDto } from '../../../../../src/retailOrg/dtos/validation/RetailUserValidationDto';
+import { CollectorValidationDto } from '../../../../../src/retailOrg/dtos/validation/CollectorValidationDto';
 import { RetailerTypeEnum } from '../../../../../src/retailOrg/enums/RetailerTypeEnum';
 import { RetailerStatusEnum } from '../../../../../src/retailOrg/enums/RetailerStatusEnum';
 import { StoreStatusEnum } from '../../../../../src/retailOrg/enums/StoreStatusEnum';
 import { EmploymentTypeEnum } from '../../../../../src/retailOrg/enums/EmploymentTypeEnum';
 import { RetailUserStatusEnum } from '../../../../../src/retailOrg/enums/RetailUserStatusEnum';
+import { CollectorSeniorityEnum } from '../../../../../src/retailOrg/enums/CollectorSeniorityEnum';
 
 describe('ValidationDtos (shapes mínimos de endpoints privados)', () => {
     it('RetailerValidationDto acepta el shape mínimo', () => {
@@ -46,4 +48,29 @@ describe('ValidationDtos (shapes mínimos de endpoints privados)', () => {
         expect(dto.employmentType).toBe(EmploymentTypeEnum.EMPLOYEE);
         expect(dto.commissionTier).toBe('TIER_A');
     });
+
+    it('CollectorValidationDto acepta el shape con seniority (coverageStoreIds requerido)', () => {
+        const dto: CollectorValidationDto = {
+            retailUserId: 'ru_001',
+            coverageStoreIds: ['store_001', 'store_002'],
+            collectorSeniority: CollectorSeniorityEnum.SENIOR,
+            status: RetailUserStatusEnum.ACTIVE,
+            commissionTier: 'TIER_A',
+        };
+        expect(dto.coverageStoreIds).toHaveLength(2);
+        expect(dto.collectorSeniority).toBe(CollectorSeniorityEnum.SENIOR);
+        expect(dto.status).toBe(RetailUserStatusEnum.ACTIVE);
+    });
+
+    it('CollectorValidationDto acepta un cobrador SIN seniority (collectorSeniority opcional)', () => {
+        const dto: CollectorValidationDto = {
+            retailUserId: 'ru_002',
+            coverageStoreIds: [],
+            status: RetailUserStatusEnum.ACTIVE,
+            commissionTier: 'collector',
+        };
+        expect(dto.collectorSeniority).toBeUndefined();
+        expect(dto.coverageStoreIds).toHaveLength(0);
+        expect(dto.commissionTier).toBe('collector');
+    });
 });

package/bin/retailOrg/dtos/validation/CollectorValidationDto.d.ts

@@ -0,0 +1,21 @@
+import type { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
+import type { RetailUserStatusEnum } from '../../enums/RetailUserStatusEnum';
+/**
+ * Shape mínimo de un cobrador retail que devuelve el endpoint privado de validación de cobradores
+ * (consumido por loan-collector-assignment-business vía @fiado/api-invoker) para alimentar el
+ * algoritmo de asignación de cartera.
+ *
+ * `coverageStoreIds` va requerido (siempre presente; si el cobrador aún no cubre tiendas, `[]`).
+ *
+ * `collectorSeniority` es OPCIONAL: el modelo de datos no obliga a que un usuario con
+ * `commissionTier === 'collector'` tenga seniority poblado, así que un cobrador sin seniority es
+ * válido. Las estrategias de asignación BY_STORE / BY_LOAD / ROUND_ROBIN no lo necesitan; solo
+ * BY_SENIORITY lo usa para rankear (y ahí un cobrador sin seniority simplemente no rankea).
+ */
+export interface CollectorValidationDto {
+    retailUserId: string;
+    coverageStoreIds: string[];
+    collectorSeniority?: CollectorSeniorityEnum;
+    status: RetailUserStatusEnum;
+    commissionTier: string;
+}

package/bin/retailOrg/dtos/validation/CollectorValidationDto.js

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

package/bin/retailOrg/index.d.ts

@@ -13,6 +13,7 @@ export * from './dtos/RetailUser';
 export * from './dtos/validation/RetailerValidationDto';
 export * from './dtos/validation/StoreValidationDto';
 export * from './dtos/validation/RetailUserValidationDto';
+export * from './dtos/validation/CollectorValidationDto';
 export * from './dtos/PaginatedResult';
 export * from './dtos/requests/RetailAddressInput';
 export * from './dtos/requests/CreateRetailerRequest';

package/bin/retailOrg/index.js

@@ -31,6 +31,7 @@ __exportStar(require("./dtos/RetailUser"), exports);
 __exportStar(require("./dtos/validation/RetailerValidationDto"), exports);
 __exportStar(require("./dtos/validation/StoreValidationDto"), exports);
 __exportStar(require("./dtos/validation/RetailUserValidationDto"), exports);
+__exportStar(require("./dtos/validation/CollectorValidationDto"), exports);
 // Paginación genérica
 __exportStar(require("./dtos/PaginatedResult"), exports);
 // Request DTOs (input validado por endpoint)

package/package.json

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

package/src/retailOrg/dtos/validation/CollectorValidationDto.ts

@@ -0,0 +1,22 @@
+import type { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
+import type { RetailUserStatusEnum } from '../../enums/RetailUserStatusEnum';
+
+/**
+ * Shape mínimo de un cobrador retail que devuelve el endpoint privado de validación de cobradores
+ * (consumido por loan-collector-assignment-business vía @fiado/api-invoker) para alimentar el
+ * algoritmo de asignación de cartera.
+ *
+ * `coverageStoreIds` va requerido (siempre presente; si el cobrador aún no cubre tiendas, `[]`).
+ *
+ * `collectorSeniority` es OPCIONAL: el modelo de datos no obliga a que un usuario con
+ * `commissionTier === 'collector'` tenga seniority poblado, así que un cobrador sin seniority es
+ * válido. Las estrategias de asignación BY_STORE / BY_LOAD / ROUND_ROBIN no lo necesitan; solo
+ * BY_SENIORITY lo usa para rankear (y ahí un cobrador sin seniority simplemente no rankea).
+ */
+export interface CollectorValidationDto {
+    retailUserId: string;
+    coverageStoreIds: string[];
+    collectorSeniority?: CollectorSeniorityEnum;
+    status: RetailUserStatusEnum;
+    commissionTier: string;
+}

package/src/retailOrg/index.ts

@@ -17,6 +17,7 @@ export * from './dtos/RetailUser';
 export * from './dtos/validation/RetailerValidationDto';
 export * from './dtos/validation/StoreValidationDto';
 export * from './dtos/validation/RetailUserValidationDto';
+export * from './dtos/validation/CollectorValidationDto';
 
 // Paginación genérica
 export * from './dtos/PaginatedResult';