@fiado/type-kit 3.190.0 → 3.192.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/RetailUser.d.ts

@@ -9,6 +9,13 @@ export declare class RetailUser {
     retailUserId: string;
     cognitoSub: string;
     retailerId: string;
+    /**
+     * Nombre de display del usuario — ETIQUETA DE CONVENIENCIA (DEC-SKF1-021). NO es la fuente de
+     * verdad de la identidad: la identidad real (nombre/email) vive en platform-rbac (DEC-SKF1-005 /
+     * DEC-011). Es solo un rótulo que el admin teclea para reconocer al usuario en la lista; puede
+     * quedar desincronizado si el nombre cambia en RBAC. Opcional (usuarios previos no lo tienen).
+     */
+    displayName?: string;
     homeStoreId: string;
     /** Zona de operación del usuario; `null` si no está acotado a una zona. */
     zoneId: string | null;

package/bin/retailOrg/dtos/RetailUser.js

@@ -38,6 +38,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], RetailUser.prototype, "retailerId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailUser.prototype, "displayName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/retailOrg/dtos/requests/CreateRetailUserRequest.d.ts

@@ -6,6 +6,11 @@ import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
  */
 export declare class CreateRetailUserRequest {
     cognitoSub: string;
+    /**
+     * Nombre de display — etiqueta de conveniencia (DEC-SKF1-021). La identidad real vive en RBAC
+     * (DEC-SKF1-005); esto es solo un rótulo para reconocer al usuario en el backoffice. Opcional.
+     */
+    displayName?: string;
     homeStoreId: string;
     employmentType: EmploymentTypeEnum;
     commissionTier: string;

package/bin/retailOrg/dtos/requests/CreateRetailUserRequest.js

@@ -26,6 +26,12 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CreateRetailUserRequest.prototype, "cognitoSub", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateRetailUserRequest.prototype, "displayName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),

package/bin/retailOrg/dtos/requests/UpdateRetailUserRequest.d.ts

@@ -6,6 +6,8 @@ import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
  * el status se cambia con `ChangeRetailUserStatusRequest`.
  */
 export declare class UpdateRetailUserRequest {
+    /** Nombre de display — etiqueta de conveniencia editable (DEC-SKF1-021, identidad real en RBAC). */
+    displayName?: string;
     employmentType?: EmploymentTypeEnum;
     commissionTier?: string;
     zoneId?: string | null;

package/bin/retailOrg/dtos/requests/UpdateRetailUserRequest.js

@@ -22,6 +22,12 @@ const EmploymentTypeEnum_1 = require("../../enums/EmploymentTypeEnum");
 class UpdateRetailUserRequest {
 }
 exports.UpdateRetailUserRequest = UpdateRetailUserRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateRetailUserRequest.prototype, "displayName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),

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.192.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/retailOrg/dtos/RetailUser.ts

@@ -22,6 +22,17 @@ export class RetailUser {
     @IsString()
     retailerId!: string;
 
+    /**
+     * Nombre de display del usuario — ETIQUETA DE CONVENIENCIA (DEC-SKF1-021). NO es la fuente de
+     * verdad de la identidad: la identidad real (nombre/email) vive en platform-rbac (DEC-SKF1-005 /
+     * DEC-011). Es solo un rótulo que el admin teclea para reconocer al usuario en la lista; puede
+     * quedar desincronizado si el nombre cambia en RBAC. Opcional (usuarios previos no lo tienen).
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    displayName?: string;
+
     @Expose()
     @IsString()
     homeStoreId!: string;

package/src/retailOrg/dtos/requests/CreateRetailUserRequest.ts

@@ -12,6 +12,15 @@ export class CreateRetailUserRequest {
     @IsString()
     cognitoSub!: string;
 
+    /**
+     * Nombre de display — etiqueta de conveniencia (DEC-SKF1-021). La identidad real vive en RBAC
+     * (DEC-SKF1-005); esto es solo un rótulo para reconocer al usuario en el backoffice. Opcional.
+     */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    displayName?: string;
+
     @Expose()
     @IsString()
     homeStoreId!: string;

package/src/retailOrg/dtos/requests/UpdateRetailUserRequest.ts

@@ -9,6 +9,12 @@ import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
  * el status se cambia con `ChangeRetailUserStatusRequest`.
  */
 export class UpdateRetailUserRequest {
+    /** Nombre de display — etiqueta de conveniencia editable (DEC-SKF1-021, identidad real en RBAC). */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    displayName?: string;
+
     @Expose()
     @IsOptional()
     @IsEnum(EmploymentTypeEnum)

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