@fiado/type-kit 3.183.0 → 3.184.0

package/_test_/unit/retailOrg/dtos/RetailUser.test.ts

@@ -4,6 +4,7 @@ import { validate } from 'class-validator';
 import { RetailUser } from '../../../../src/retailOrg/dtos/RetailUser';
 import { EmploymentTypeEnum } from '../../../../src/retailOrg/enums/EmploymentTypeEnum';
 import { RetailUserStatusEnum } from '../../../../src/retailOrg/enums/RetailUserStatusEnum';
+import { CollectorSeniorityEnum } from '../../../../src/retailOrg/enums/CollectorSeniorityEnum';
 
 const valid = {
     retailUserId: 'ru_001',
@@ -33,6 +34,35 @@ describe('RetailUser', () => {
         expect(errors).toEqual([]);
     });
 
+    it('valida sin los campos de cobrador (phone/collectorSeniority/coverageStoreIds ausentes)', async () => {
+        const dto = plainToInstance(RetailUser, valid);
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('valida con los campos de cobrador presentes', async () => {
+        const dto = plainToInstance(RetailUser, {
+            ...valid,
+            phone: '+528112345678',
+            collectorSeniority: CollectorSeniorityEnum.SENIOR,
+            coverageStoreIds: ['store_001', 'store_002'],
+        });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si collectorSeniority está fuera del enum', async () => {
+        const dto = plainToInstance(RetailUser, { ...valid, collectorSeniority: 'MASTER' });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'collectorSeniority')).toBe(true);
+    });
+
+    it('falla si coverageStoreIds no es un array de strings', async () => {
+        const dto = plainToInstance(RetailUser, { ...valid, coverageStoreIds: [1, 2] });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'coverageStoreIds')).toBe(true);
+    });
+
     it('falla si employmentType está fuera del enum', async () => {
         const dto = plainToInstance(RetailUser, { ...valid, employmentType: 'INTERN' });
         const errors = await validate(dto);

package/_test_/unit/retailOrg/dtos/Retailer.test.ts

@@ -8,7 +8,7 @@ import { RetailerStatusEnum } from '../../../../src/retailOrg/enums/RetailerStat
 const valid = {
     retailerId: 'ret_001',
     parentId: 'ROOT',
-    type: RetailerTypeEnum.CADENA,
+    type: RetailerTypeEnum.CHAIN,
     name: 'Tiendas del Centro',
     legalName: 'Tiendas del Centro SA de CV',
     rfc: 'VEN123456ABC',

package/_test_/unit/retailOrg/dtos/Store.test.ts

@@ -15,7 +15,7 @@ const valid = {
     phone: '+528112345678',
     managerRetailUserId: 'ru_010',
     schedule: 'L-V 9:00-18:00',
-    dailyAvgSalesCents: 1500000,
+    dailyAvgCollectionsCount: 12,
     status: StoreStatusEnum.ACTIVE,
     createdAt: '2026-07-14T10:00:00.000Z',
     updatedAt: '2026-07-14T10:00:00.000Z',
@@ -36,7 +36,7 @@ describe('Store', () => {
             zoneId: null,
             managerRetailUserId: null,
             schedule: null,
-            dailyAvgSalesCents: null,
+            dailyAvgCollectionsCount: null,
         });
         const errors = await validate(dto);
         expect(errors).toEqual([]);

package/_test_/unit/retailOrg/dtos/requests/retailUserRequests.test.ts

@@ -7,6 +7,7 @@ import { ChangeRetailUserStatusRequest } from '../../../../../src/retailOrg/dtos
 import { TransferRetailUserRequest } from '../../../../../src/retailOrg/dtos/requests/TransferRetailUserRequest';
 import { EmploymentTypeEnum } from '../../../../../src/retailOrg/enums/EmploymentTypeEnum';
 import { RetailUserStatusEnum } from '../../../../../src/retailOrg/enums/RetailUserStatusEnum';
+import { CollectorSeniorityEnum } from '../../../../../src/retailOrg/enums/CollectorSeniorityEnum';
 
 const validCreate = {
     cognitoSub: '5f7c8a90-1234-4abc-9def-0123456789ab',
@@ -29,6 +30,23 @@ describe('CreateRetailUserRequest', () => {
         expect(errors).toEqual([]);
     });
 
+    it('valida con los campos de cobrador presentes', async () => {
+        const dto = plainToInstance(CreateRetailUserRequest, {
+            ...validCreate,
+            phone: '+528112345678',
+            collectorSeniority: CollectorSeniorityEnum.JUNIOR,
+            coverageStoreIds: ['store_001', 'store_002'],
+        });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si collectorSeniority está fuera del enum', async () => {
+        const dto = plainToInstance(CreateRetailUserRequest, { ...validCreate, collectorSeniority: 'MASTER' });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'collectorSeniority')).toBe(true);
+    });
+
     it('falla si employmentType está fuera del enum', async () => {
         const dto = plainToInstance(CreateRetailUserRequest, { ...validCreate, employmentType: 'INTERN' });
         const errors = await validate(dto);
@@ -55,6 +73,22 @@ describe('UpdateRetailUserRequest', () => {
         const errors = await validate(dto);
         expect(errors.some(e => e.property === 'employmentType')).toBe(true);
     });
+
+    it('valida con los campos de cobrador presentes', async () => {
+        const dto = plainToInstance(UpdateRetailUserRequest, {
+            phone: '+528112345678',
+            collectorSeniority: CollectorSeniorityEnum.SENIOR,
+            coverageStoreIds: ['store_003'],
+        });
+        const errors = await validate(dto);
+        expect(errors).toEqual([]);
+    });
+
+    it('falla si collectorSeniority enviado está fuera del enum', async () => {
+        const dto = plainToInstance(UpdateRetailUserRequest, { collectorSeniority: 'MASTER' });
+        const errors = await validate(dto);
+        expect(errors.some(e => e.property === 'collectorSeniority')).toBe(true);
+    });
 });
 
 describe('ChangeRetailUserStatusRequest', () => {

package/_test_/unit/retailOrg/dtos/requests/retailerRequests.test.ts

@@ -18,7 +18,7 @@ const address = {
 };
 
 const validCreate = {
-    type: RetailerTypeEnum.CADENA,
+    type: RetailerTypeEnum.CHAIN,
     name: 'Tiendas del Centro',
     legalName: 'Tiendas del Centro SA de CV',
     rfc: 'VEN123456ABC',
@@ -91,7 +91,7 @@ describe('UpdateRetailerRequest', () => {
     it('NO permite editar rfc/type/status (no están en el shape)', () => {
         const dto = plainToInstance(
             UpdateRetailerRequest,
-            { rfc: 'X', type: 'CADENA', status: 'ACTIVE' } as object,
+            { rfc: 'X', type: 'CHAIN', status: 'ACTIVE' } as object,
             { excludeExtraneousValues: true },
         );
         expect((dto as unknown as Record<string, unknown>).rfc).toBeUndefined();
@@ -115,28 +115,28 @@ describe('ChangeRetailerStatusRequest', () => {
 });
 
 describe('CreateSubdistributorRequest', () => {
-    it('valida SUBDISTRIBUIDOR', async () => {
+    it('valida SUBDISTRIBUTOR', async () => {
         const dto = plainToInstance(CreateSubdistributorRequest, {
             ...validCreate,
-            type: RetailerTypeEnum.SUBDISTRIBUIDOR,
+            type: RetailerTypeEnum.SUBDISTRIBUTOR,
         });
         const errors = await validate(dto);
         expect(errors).toEqual([]);
     });
 
-    it('valida FRANQUICIA', async () => {
+    it('valida FRANCHISE', async () => {
         const dto = plainToInstance(CreateSubdistributorRequest, {
             ...validCreate,
-            type: RetailerTypeEnum.FRANQUICIA,
+            type: RetailerTypeEnum.FRANCHISE,
         });
         const errors = await validate(dto);
         expect(errors).toEqual([]);
     });
 
-    it('falla si type es CADENA (un subdistribuidor no puede ser cadena raíz)', async () => {
+    it('falla si type es CHAIN (un subdistribuidor no puede ser cadena raíz)', async () => {
         const dto = plainToInstance(CreateSubdistributorRequest, {
             ...validCreate,
-            type: RetailerTypeEnum.CADENA,
+            type: RetailerTypeEnum.CHAIN,
         });
         const errors = await validate(dto);
         expect(errors.some(e => e.property === 'type')).toBe(true);
@@ -145,7 +145,7 @@ describe('CreateSubdistributorRequest', () => {
     it('NO expone parentId (viene del path param)', () => {
         const dto = plainToInstance(
             CreateSubdistributorRequest,
-            { ...validCreate, type: RetailerTypeEnum.SUBDISTRIBUIDOR, parentId: 'ret_root' } as object,
+            { ...validCreate, type: RetailerTypeEnum.SUBDISTRIBUTOR, parentId: 'ret_root' } as object,
             { excludeExtraneousValues: true },
         );
         expect((dto as unknown as Record<string, unknown>).parentId).toBeUndefined();

package/_test_/unit/retailOrg/dtos/requests/storeRequests.test.ts

@@ -24,7 +24,7 @@ const validCreate = {
     phone: '+528112345678',
     managerRetailUserId: 'ru_010',
     schedule: 'L-V 9:00-18:00',
-    dailyAvgSalesCents: 1500000,
+    dailyAvgCollectionsCount: 12,
 };
 
 describe('CreateStoreRequest', () => {
@@ -40,7 +40,7 @@ describe('CreateStoreRequest', () => {
             zoneId: null,
             managerRetailUserId: null,
             schedule: null,
-            dailyAvgSalesCents: null,
+            dailyAvgCollectionsCount: null,
         });
         const errors = await validate(dto);
         expect(errors).toEqual([]);

package/_test_/unit/retailOrg/dtos/responses/RetailerHierarchyResponse.test.ts

@@ -7,7 +7,7 @@ function retailer(id: string): Retailer {
     return {
         retailerId: id,
         parentId: 'ROOT',
-        type: RetailerTypeEnum.CADENA,
+        type: RetailerTypeEnum.CHAIN,
         name: `Retailer ${id}`,
         legalName: `Retailer ${id} SA de CV`,
         rfc: 'VEN123456ABC',

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

@@ -12,12 +12,12 @@ describe('ValidationDtos (shapes mínimos de endpoints privados)', () => {
         const dto: RetailerValidationDto = {
             retailerId: 'ret_001',
             name: 'Tiendas del Centro',
-            type: RetailerTypeEnum.CADENA,
+            type: RetailerTypeEnum.CHAIN,
             status: RetailerStatusEnum.ACTIVE,
             parentId: 'ROOT',
         };
         expect(dto.retailerId).toBe('ret_001');
-        expect(dto.type).toBe(RetailerTypeEnum.CADENA);
+        expect(dto.type).toBe(RetailerTypeEnum.CHAIN);
     });
 
     it('StoreValidationDto acepta el shape mínimo (zoneId nullable)', () => {

package/_test_/unit/retailOrg/enums/CollectorSeniorityEnum.test.ts

@@ -0,0 +1,12 @@
+import { CollectorSeniorityEnum } from '../../../../src/retailOrg/enums/CollectorSeniorityEnum';
+
+describe('CollectorSeniorityEnum', () => {
+    it('contiene exactamente los niveles del contrato con value === key', () => {
+        expect(CollectorSeniorityEnum.JUNIOR).toBe('JUNIOR');
+        expect(CollectorSeniorityEnum.SENIOR).toBe('SENIOR');
+    });
+
+    it('no tiene valores de más', () => {
+        expect(Object.values(CollectorSeniorityEnum).sort()).toEqual(['JUNIOR', 'SENIOR']);
+    });
+});

package/_test_/unit/retailOrg/enums/RetailerTypeEnum.test.ts

@@ -1,15 +1,15 @@
 import { RetailerTypeEnum } from '../../../../src/retailOrg/enums/RetailerTypeEnum';
 
 describe('RetailerTypeEnum', () => {
-    it('contiene exactamente los tipos del contrato con value === key', () => {
-        expect(RetailerTypeEnum.CADENA).toBe('CADENA');
-        expect(RetailerTypeEnum.SUBDISTRIBUIDOR).toBe('SUBDISTRIBUIDOR');
-        expect(RetailerTypeEnum.FRANQUICIA).toBe('FRANQUICIA');
+    it('contiene exactamente los tipos del contrato con value === key (en inglés)', () => {
+        expect(RetailerTypeEnum.CHAIN).toBe('CHAIN');
+        expect(RetailerTypeEnum.SUBDISTRIBUTOR).toBe('SUBDISTRIBUTOR');
+        expect(RetailerTypeEnum.FRANCHISE).toBe('FRANCHISE');
     });
 
     it('no tiene valores de más', () => {
         expect(Object.values(RetailerTypeEnum).sort()).toEqual(
-            ['CADENA', 'FRANQUICIA', 'SUBDISTRIBUIDOR'],
+            ['CHAIN', 'FRANCHISE', 'SUBDISTRIBUTOR'],
         );
     });
 });

package/bin/benefitCenter/enums/BenefitFlowEnum.d.ts

@@ -0,0 +1,11 @@
+export declare enum BenefitFlowEnum {
+    TOPUPS = "TOPUPS",
+    BILL_PAYMENT = "BILL_PAYMENT",
+    CREDIT = "CREDIT",
+    INSURANCE = "INSURANCE",
+    DONATION = "DONATION",
+    PHARMACY = "PHARMACY",
+    REMITTANCE = "REMITTANCE",
+    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
+    WALLET_FUNDING = "WALLET_FUNDING"
+}

package/bin/benefitCenter/enums/BenefitFlowEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BenefitFlowEnum = void 0;
+var BenefitFlowEnum;
+(function (BenefitFlowEnum) {
+    BenefitFlowEnum["TOPUPS"] = "TOPUPS";
+    BenefitFlowEnum["BILL_PAYMENT"] = "BILL_PAYMENT";
+    BenefitFlowEnum["CREDIT"] = "CREDIT";
+    BenefitFlowEnum["INSURANCE"] = "INSURANCE";
+    BenefitFlowEnum["DONATION"] = "DONATION";
+    BenefitFlowEnum["PHARMACY"] = "PHARMACY";
+    BenefitFlowEnum["REMITTANCE"] = "REMITTANCE";
+    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
+    BenefitFlowEnum["WALLET_FUNDING"] = "WALLET_FUNDING";
+})(BenefitFlowEnum || (exports.BenefitFlowEnum = BenefitFlowEnum = {}));

package/bin/places/dtos/CashInFeeDto.d.ts

@@ -0,0 +1,17 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+/**
+ * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
+ * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
+ * - Passport (MX): por red → `fixed` + `percentage`.
+ * Response DTO — sin decoradores de validación.
+ */
+export declare class CashInFeeDto {
+    /** Comisión fija, en la moneda del país. */
+    fixed?: number;
+    /** Porcentaje del monto depositado (0–100). */
+    percentage?: number;
+    /** Tope máximo de comisión (GreenDot: el asociado cobra hasta este cap). */
+    cap?: number;
+    /** Moneda del fee: USD (GreenDot) | MXN (Passport). */
+    currency: CurrencyId;
+}

package/bin/places/dtos/CashInFeeDto.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CashInFeeDto = void 0;
+/**
+ * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
+ * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
+ * - Passport (MX): por red → `fixed` + `percentage`.
+ * Response DTO — sin decoradores de validación.
+ */
+class CashInFeeDto {
+}
+exports.CashInFeeDto = CashInFeeDto;

package/bin/platformRbac/dtos/ResendOtpRequest.d.ts

@@ -0,0 +1,22 @@
+import { MfaMethodEnum } from '../enums/MfaMethodEnum';
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+export declare class ResendOtpRequest {
+    email: string;
+    tenantId: string;
+}
+/**
+ * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
+ * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
+ * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
+ * el server responde 200 genérico sin session ni método.
+ */
+export interface ResendOtpResponse {
+    session?: string;
+    mfaMethod?: MfaMethodEnum;
+}

package/bin/platformRbac/dtos/ResendOtpRequest.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResendOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+class ResendOtpRequest {
+}
+exports.ResendOtpRequest = ResendOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendOtpRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendOtpRequest.prototype, "tenantId", void 0);

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+export declare class ResendSelfRegisterOtpRequest {
+    tenantId: string;
+    email: string;
+}

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.js

@@ -0,0 +1,36 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResendSelfRegisterOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+class ResendSelfRegisterOtpRequest {
+}
+exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "email", void 0);

package/bin/retailOrg/dtos/RetailUser.d.ts

@@ -1,3 +1,4 @@
+import { CollectorSeniorityEnum } from '../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../enums/EmploymentTypeEnum';
 import { RetailUserStatusEnum } from '../enums/RetailUserStatusEnum';
 /**
@@ -13,6 +14,12 @@ export declare class RetailUser {
     zoneId: string | null;
     employmentType: EmploymentTypeEnum;
     commissionTier: string;
+    /** Teléfono de contacto del usuario retail; opcional. */
+    phone?: string;
+    /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */
+    collectorSeniority?: CollectorSeniorityEnum;
+    /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
+    coverageStoreIds?: string[];
     status: RetailUserStatusEnum;
     createdAt: string;
     updatedAt: string;

package/bin/retailOrg/dtos/RetailUser.js

@@ -13,6 +13,7 @@ exports.RetailUser = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const regex_1 = require("../../helpers/constans/regex");
+const CollectorSeniorityEnum_1 = require("../enums/CollectorSeniorityEnum");
 const EmploymentTypeEnum_1 = require("../enums/EmploymentTypeEnum");
 const RetailUserStatusEnum_1 = require("../enums/RetailUserStatusEnum");
 /**
@@ -58,6 +59,25 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], RetailUser.prototype, "commissionTier", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RetailUser.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CollectorSeniorityEnum_1.CollectorSeniorityEnum),
+    __metadata("design:type", String)
+], RetailUser.prototype, "collectorSeniority", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], RetailUser.prototype, "coverageStoreIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsEnum)(RetailUserStatusEnum_1.RetailUserStatusEnum),

package/bin/retailOrg/dtos/Store.d.ts

@@ -22,8 +22,12 @@ export declare class Store {
     managerRetailUserId: string | null;
     /** Horario operativo (texto libre); `null` si no está definido. */
     schedule: string | null;
-    /** Venta diaria promedio en centavos; `null` si no está registrada. */
-    dailyAvgSalesCents: number | null;
+    /**
+     * Conteo promedio de transacciones de cobro por día (NO es un monto de dinero).
+     * `null` si no está registrado. El factor 2× que amplifica este conteo es global
+     * y vive en loan-config, no acá.
+     */
+    dailyAvgCollectionsCount: number | null;
     status: StoreStatusEnum;
     createdAt: string;
     updatedAt: string;

package/bin/retailOrg/dtos/Store.js

@@ -87,7 +87,7 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
-], Store.prototype, "dailyAvgSalesCents", void 0);
+], Store.prototype, "dailyAvgCollectionsCount", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsEnum)(StoreStatusEnum_1.StoreStatusEnum),

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

@@ -1,3 +1,4 @@
+import { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
 /**
  * Body de POST /retailers/:retailerId/users — alta de usuario retail (el `retailerId` sale del path;
@@ -10,4 +11,10 @@ export declare class CreateRetailUserRequest {
     commissionTier: string;
     /** Zona de operación del usuario; `null` si no está acotado a una zona. */
     zoneId: string | null;
+    /** Teléfono de contacto del usuario retail; opcional. */
+    phone?: string;
+    /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */
+    collectorSeniority?: CollectorSeniorityEnum;
+    /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
+    coverageStoreIds?: string[];
 }

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.CreateRetailUserRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const CollectorSeniorityEnum_1 = require("../../enums/CollectorSeniorityEnum");
 const EmploymentTypeEnum_1 = require("../../enums/EmploymentTypeEnum");
 /**
  * Body de POST /retailers/:retailerId/users — alta de usuario retail (el `retailerId` sale del path;
@@ -46,3 +47,22 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], CreateRetailUserRequest.prototype, "zoneId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], CreateRetailUserRequest.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CollectorSeniorityEnum_1.CollectorSeniorityEnum),
+    __metadata("design:type", String)
+], CreateRetailUserRequest.prototype, "collectorSeniority", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateRetailUserRequest.prototype, "coverageStoreIds", void 0);

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

@@ -17,6 +17,10 @@ export declare class CreateStoreRequest {
     managerRetailUserId: string | null;
     /** Horario operativo (texto libre); `null` si no está definido. */
     schedule: string | null;
-    /** Venta diaria promedio en centavos; `null` si no está registrada. */
-    dailyAvgSalesCents: number | null;
+    /**
+     * Conteo promedio de transacciones de cobro por día (NO es un monto de dinero).
+     * `null` si no está registrado. El factor 2× que amplifica este conteo es global
+     * y vive en loan-config, no acá.
+     */
+    dailyAvgCollectionsCount: number | null;
 }

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

@@ -74,4 +74,4 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
-], CreateStoreRequest.prototype, "dailyAvgSalesCents", void 0);
+], CreateStoreRequest.prototype, "dailyAvgCollectionsCount", void 0);

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

@@ -4,11 +4,11 @@ import { RetailAddressInput } from './RetailAddressInput';
  * Body de POST /retailers/:retailerId/subdistributors — alta de un retailer hijo colgando de
  * `:retailerId` (el `parentId` sale del path param, NO del body).
  *
- * `type` se restringe a SUBDISTRIBUIDOR | FRANQUICIA con `@IsIn`: un nodo hijo no puede ser una
- * CADENA raíz (esa se crea con `CreateRetailerRequest`).
+ * `type` se restringe a SUBDISTRIBUTOR | FRANCHISE con `@IsIn`: un nodo hijo no puede ser una
+ * CHAIN raíz (esa se crea con `CreateRetailerRequest`).
  */
 export declare class CreateSubdistributorRequest {
-    type: RetailerTypeEnum.SUBDISTRIBUIDOR | RetailerTypeEnum.FRANQUICIA;
+    type: RetailerTypeEnum.SUBDISTRIBUTOR | RetailerTypeEnum.FRANCHISE;
     name: string;
     legalName: string;
     /** RFC mexicano — 12 (persona moral / empresa) o 13 (persona física). */

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

@@ -18,15 +18,15 @@ const RetailAddressInput_1 = require("./RetailAddressInput");
  * Body de POST /retailers/:retailerId/subdistributors — alta de un retailer hijo colgando de
  * `:retailerId` (el `parentId` sale del path param, NO del body).
  *
- * `type` se restringe a SUBDISTRIBUIDOR | FRANQUICIA con `@IsIn`: un nodo hijo no puede ser una
- * CADENA raíz (esa se crea con `CreateRetailerRequest`).
+ * `type` se restringe a SUBDISTRIBUTOR | FRANCHISE con `@IsIn`: un nodo hijo no puede ser una
+ * CHAIN raíz (esa se crea con `CreateRetailerRequest`).
  */
 class CreateSubdistributorRequest {
 }
 exports.CreateSubdistributorRequest = CreateSubdistributorRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsIn)([RetailerTypeEnum_1.RetailerTypeEnum.SUBDISTRIBUIDOR, RetailerTypeEnum_1.RetailerTypeEnum.FRANQUICIA]),
+    (0, class_validator_1.IsIn)([RetailerTypeEnum_1.RetailerTypeEnum.SUBDISTRIBUTOR, RetailerTypeEnum_1.RetailerTypeEnum.FRANCHISE]),
     __metadata("design:type", String)
 ], CreateSubdistributorRequest.prototype, "type", void 0);
 __decorate([

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

@@ -1,3 +1,4 @@
+import { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
 /**
  * Body de PUT /users/:retailUserId — edición de usuario retail (campos editables opcionales).
@@ -8,4 +9,10 @@ export declare class UpdateRetailUserRequest {
     employmentType?: EmploymentTypeEnum;
     commissionTier?: string;
     zoneId?: string | null;
+    /** Teléfono de contacto del usuario retail; opcional. */
+    phone?: string;
+    /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */
+    collectorSeniority?: CollectorSeniorityEnum;
+    /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
+    coverageStoreIds?: string[];
 }

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

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateRetailUserRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const CollectorSeniorityEnum_1 = require("../../enums/CollectorSeniorityEnum");
 const EmploymentTypeEnum_1 = require("../../enums/EmploymentTypeEnum");
 /**
  * Body de PUT /users/:retailUserId — edición de usuario retail (campos editables opcionales).
@@ -39,3 +40,22 @@ __decorate([
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], UpdateRetailUserRequest.prototype, "zoneId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateRetailUserRequest.prototype, "phone", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(CollectorSeniorityEnum_1.CollectorSeniorityEnum),
+    __metadata("design:type", String)
+], UpdateRetailUserRequest.prototype, "collectorSeniority", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdateRetailUserRequest.prototype, "coverageStoreIds", void 0);

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

@@ -14,5 +14,6 @@ export declare class UpdateStoreRequest {
     phone?: string;
     managerRetailUserId?: string | null;
     schedule?: string | null;
-    dailyAvgSalesCents?: number | null;
+    /** Conteo promedio de transacciones de cobro por día (NO es un monto de dinero). */
+    dailyAvgCollectionsCount?: number | null;
 }

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

@@ -78,4 +78,4 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
-], UpdateStoreRequest.prototype, "dailyAvgSalesCents", void 0);
+], UpdateStoreRequest.prototype, "dailyAvgCollectionsCount", void 0);

package/bin/retailOrg/enums/CollectorSeniorityEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Antigüedad / seniority de un cobrador retail en SureKeep.
+ * Solo aplica a usuarios retail que cumplen rol de cobrador.
+ * @enum {string}
+ *
+ * @property {string} JUNIOR - Cobrador de menor antigüedad / experiencia.
+ * @property {string} SENIOR - Cobrador de mayor antigüedad / experiencia.
+ */
+export declare enum CollectorSeniorityEnum {
+    JUNIOR = "JUNIOR",
+    SENIOR = "SENIOR"
+}

package/bin/retailOrg/enums/CollectorSeniorityEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CollectorSeniorityEnum = void 0;
+/**
+ * Antigüedad / seniority de un cobrador retail en SureKeep.
+ * Solo aplica a usuarios retail que cumplen rol de cobrador.
+ * @enum {string}
+ *
+ * @property {string} JUNIOR - Cobrador de menor antigüedad / experiencia.
+ * @property {string} SENIOR - Cobrador de mayor antigüedad / experiencia.
+ */
+var CollectorSeniorityEnum;
+(function (CollectorSeniorityEnum) {
+    CollectorSeniorityEnum["JUNIOR"] = "JUNIOR";
+    CollectorSeniorityEnum["SENIOR"] = "SENIOR";
+})(CollectorSeniorityEnum || (exports.CollectorSeniorityEnum = CollectorSeniorityEnum = {}));

package/bin/retailOrg/enums/RetailerTypeEnum.d.ts

@@ -2,12 +2,12 @@
  * Tipo de retailer en la organización comercial de SureKeep.
  * @enum {string}
  *
- * @property {string} CADENA - Cadena comercial con múltiples tiendas propias.
- * @property {string} SUBDISTRIBUIDOR - Subdistribuidor que opera bajo un distribuidor mayor.
- * @property {string} FRANQUICIA - Franquicia operada por un tercero bajo la marca.
+ * @property {string} CHAIN - Cadena comercial con múltiples tiendas propias.
+ * @property {string} SUBDISTRIBUTOR - Subdistribuidor que opera bajo un distribuidor mayor.
+ * @property {string} FRANCHISE - Franquicia operada por un tercero bajo la marca.
  */
 export declare enum RetailerTypeEnum {
-    CADENA = "CADENA",
-    SUBDISTRIBUIDOR = "SUBDISTRIBUIDOR",
-    FRANQUICIA = "FRANQUICIA"
+    CHAIN = "CHAIN",
+    SUBDISTRIBUTOR = "SUBDISTRIBUTOR",
+    FRANCHISE = "FRANCHISE"
 }

package/bin/retailOrg/enums/RetailerTypeEnum.js

@@ -5,13 +5,13 @@ exports.RetailerTypeEnum = void 0;
  * Tipo de retailer en la organización comercial de SureKeep.
  * @enum {string}
  *
- * @property {string} CADENA - Cadena comercial con múltiples tiendas propias.
- * @property {string} SUBDISTRIBUIDOR - Subdistribuidor que opera bajo un distribuidor mayor.
- * @property {string} FRANQUICIA - Franquicia operada por un tercero bajo la marca.
+ * @property {string} CHAIN - Cadena comercial con múltiples tiendas propias.
+ * @property {string} SUBDISTRIBUTOR - Subdistribuidor que opera bajo un distribuidor mayor.
+ * @property {string} FRANCHISE - Franquicia operada por un tercero bajo la marca.
  */
 var RetailerTypeEnum;
 (function (RetailerTypeEnum) {
-    RetailerTypeEnum["CADENA"] = "CADENA";
-    RetailerTypeEnum["SUBDISTRIBUIDOR"] = "SUBDISTRIBUIDOR";
-    RetailerTypeEnum["FRANQUICIA"] = "FRANQUICIA";
+    RetailerTypeEnum["CHAIN"] = "CHAIN";
+    RetailerTypeEnum["SUBDISTRIBUTOR"] = "SUBDISTRIBUTOR";
+    RetailerTypeEnum["FRANCHISE"] = "FRANCHISE";
 })(RetailerTypeEnum || (exports.RetailerTypeEnum = RetailerTypeEnum = {}));

package/bin/retailOrg/index.d.ts

@@ -4,6 +4,7 @@ export * from './enums/ZoneStatusEnum';
 export * from './enums/StoreStatusEnum';
 export * from './enums/RetailUserStatusEnum';
 export * from './enums/EmploymentTypeEnum';
+export * from './enums/CollectorSeniorityEnum';
 export * from './dtos/GeoLocation';
 export * from './dtos/Retailer';
 export * from './dtos/Zone';

package/bin/retailOrg/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./enums/ZoneStatusEnum"), exports);
 __exportStar(require("./enums/StoreStatusEnum"), exports);
 __exportStar(require("./enums/RetailUserStatusEnum"), exports);
 __exportStar(require("./enums/EmploymentTypeEnum"), exports);
+__exportStar(require("./enums/CollectorSeniorityEnum"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/GeoLocation"), exports);
 __exportStar(require("./dtos/Retailer"), exports);

package/package.json

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

package/src/retailOrg/dtos/RetailUser.ts

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsOptional, IsString, Matches } from 'class-validator';
+import { IsArray, IsEnum, IsOptional, IsString, Matches } from 'class-validator';
 import { regexIso8601 } from '../../helpers/constans/regex';
+import { CollectorSeniorityEnum } from '../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../enums/EmploymentTypeEnum';
 import { RetailUserStatusEnum } from '../enums/RetailUserStatusEnum';
 
@@ -39,6 +40,25 @@ export class RetailUser {
     @IsString()
     commissionTier!: string;
 
+    /** Teléfono de contacto del usuario retail; opcional. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    phone?: string;
+
+    /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CollectorSeniorityEnum)
+    collectorSeniority?: CollectorSeniorityEnum;
+
+    /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    coverageStoreIds?: string[];
+
     @Expose()
     @IsEnum(RetailUserStatusEnum)
     status!: RetailUserStatusEnum;

package/src/retailOrg/dtos/Store.ts

@@ -75,11 +75,15 @@ export class Store {
     @IsString()
     schedule!: string | null;
 
-    /** Venta diaria promedio en centavos; `null` si no está registrada. */
+    /**
+     * Conteo promedio de transacciones de cobro por día (NO es un monto de dinero).
+     * `null` si no está registrado. El factor 2× que amplifica este conteo es global
+     * y vive en loan-config, no acá.
+     */
     @Expose()
     @IsOptional()
     @IsNumber()
-    dailyAvgSalesCents!: number | null;
+    dailyAvgCollectionsCount!: number | null;
 
     @Expose()
     @IsEnum(StoreStatusEnum)

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

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsOptional, IsString } from 'class-validator';
+import { IsArray, IsEnum, IsOptional, IsString } from 'class-validator';
+import { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
 
 /**
@@ -28,4 +29,23 @@ export class CreateRetailUserRequest {
     @IsOptional()
     @IsString()
     zoneId!: string | null;
+
+    /** Teléfono de contacto del usuario retail; opcional. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    phone?: string;
+
+    /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CollectorSeniorityEnum)
+    collectorSeniority?: CollectorSeniorityEnum;
+
+    /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    coverageStoreIds?: string[];
 }

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

@@ -59,9 +59,13 @@ export class CreateStoreRequest {
     @IsString()
     schedule!: string | null;
 
-    /** Venta diaria promedio en centavos; `null` si no está registrada. */
+    /**
+     * Conteo promedio de transacciones de cobro por día (NO es un monto de dinero).
+     * `null` si no está registrado. El factor 2× que amplifica este conteo es global
+     * y vive en loan-config, no acá.
+     */
     @Expose()
     @IsOptional()
     @IsNumber()
-    dailyAvgSalesCents!: number | null;
+    dailyAvgCollectionsCount!: number | null;
 }

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

@@ -7,13 +7,13 @@ import { RetailAddressInput } from './RetailAddressInput';
  * Body de POST /retailers/:retailerId/subdistributors — alta de un retailer hijo colgando de
  * `:retailerId` (el `parentId` sale del path param, NO del body).
  *
- * `type` se restringe a SUBDISTRIBUIDOR | FRANQUICIA con `@IsIn`: un nodo hijo no puede ser una
- * CADENA raíz (esa se crea con `CreateRetailerRequest`).
+ * `type` se restringe a SUBDISTRIBUTOR | FRANCHISE con `@IsIn`: un nodo hijo no puede ser una
+ * CHAIN raíz (esa se crea con `CreateRetailerRequest`).
  */
 export class CreateSubdistributorRequest {
     @Expose()
-    @IsIn([RetailerTypeEnum.SUBDISTRIBUIDOR, RetailerTypeEnum.FRANQUICIA])
-    type!: RetailerTypeEnum.SUBDISTRIBUIDOR | RetailerTypeEnum.FRANQUICIA;
+    @IsIn([RetailerTypeEnum.SUBDISTRIBUTOR, RetailerTypeEnum.FRANCHISE])
+    type!: RetailerTypeEnum.SUBDISTRIBUTOR | RetailerTypeEnum.FRANCHISE;
 
     @Expose()
     @IsString()

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

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
-import { IsEnum, IsOptional, IsString } from 'class-validator';
+import { IsArray, IsEnum, IsOptional, IsString } from 'class-validator';
+import { CollectorSeniorityEnum } from '../../enums/CollectorSeniorityEnum';
 import { EmploymentTypeEnum } from '../../enums/EmploymentTypeEnum';
 
 /**
@@ -22,4 +23,23 @@ export class UpdateRetailUserRequest {
     @IsOptional()
     @IsString()
     zoneId?: string | null;
+
+    /** Teléfono de contacto del usuario retail; opcional. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    phone?: string;
+
+    /** Seniority del cobrador; solo aplica a usuarios retail con rol de cobrador. */
+    @Expose()
+    @IsOptional()
+    @IsEnum(CollectorSeniorityEnum)
+    collectorSeniority?: CollectorSeniorityEnum;
+
+    /** Tiendas que cubre el cobrador (zona de cobranza); opcional. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @IsString({ each: true })
+    coverageStoreIds?: string[];
 }

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

@@ -52,8 +52,9 @@ export class UpdateStoreRequest {
     @IsString()
     schedule?: string | null;
 
+    /** Conteo promedio de transacciones de cobro por día (NO es un monto de dinero). */
     @Expose()
     @IsOptional()
     @IsNumber()
-    dailyAvgSalesCents?: number | null;
+    dailyAvgCollectionsCount?: number | null;
 }

package/src/retailOrg/enums/CollectorSeniorityEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Antigüedad / seniority de un cobrador retail en SureKeep.
+ * Solo aplica a usuarios retail que cumplen rol de cobrador.
+ * @enum {string}
+ *
+ * @property {string} JUNIOR - Cobrador de menor antigüedad / experiencia.
+ * @property {string} SENIOR - Cobrador de mayor antigüedad / experiencia.
+ */
+export enum CollectorSeniorityEnum {
+    JUNIOR = 'JUNIOR',
+    SENIOR = 'SENIOR',
+}

package/src/retailOrg/enums/RetailerTypeEnum.ts

@@ -2,12 +2,12 @@
  * Tipo de retailer en la organización comercial de SureKeep.
  * @enum {string}
  *
- * @property {string} CADENA - Cadena comercial con múltiples tiendas propias.
- * @property {string} SUBDISTRIBUIDOR - Subdistribuidor que opera bajo un distribuidor mayor.
- * @property {string} FRANQUICIA - Franquicia operada por un tercero bajo la marca.
+ * @property {string} CHAIN - Cadena comercial con múltiples tiendas propias.
+ * @property {string} SUBDISTRIBUTOR - Subdistribuidor que opera bajo un distribuidor mayor.
+ * @property {string} FRANCHISE - Franquicia operada por un tercero bajo la marca.
  */
 export enum RetailerTypeEnum {
-    CADENA = 'CADENA',
-    SUBDISTRIBUIDOR = 'SUBDISTRIBUIDOR',
-    FRANQUICIA = 'FRANQUICIA',
+    CHAIN = 'CHAIN',
+    SUBDISTRIBUTOR = 'SUBDISTRIBUTOR',
+    FRANCHISE = 'FRANCHISE',
 }

package/src/retailOrg/index.ts

@@ -4,6 +4,7 @@ export * from './enums/ZoneStatusEnum';
 export * from './enums/StoreStatusEnum';
 export * from './enums/RetailUserStatusEnum';
 export * from './enums/EmploymentTypeEnum';
+export * from './enums/CollectorSeniorityEnum';
 
 // Entity DTOs
 export * from './dtos/GeoLocation';