@fiado/type-kit 3.183.0 → 3.185.0

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/bin/walletFunding/dtos/CancelFundingReferenceRequest.d.ts

@@ -0,0 +1,5 @@
+export declare class CancelFundingReferenceRequest {
+    fundingId: string;
+    directoryId: string;
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelFundingReferenceRequest.js

@@ -0,0 +1,31 @@
+"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.CancelFundingReferenceRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelFundingReferenceRequest {
+}
+exports.CancelFundingReferenceRequest = CancelFundingReferenceRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "fundingId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingReferenceRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelFundingReferenceResponse {
+    fundingId: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+}

package/bin/walletFunding/dtos/CancelFundingReferenceResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingReferenceResponse = void 0;
+class CancelFundingReferenceResponse {
+}
+exports.CancelFundingReferenceResponse = CancelFundingReferenceResponse;

package/bin/walletFunding/dtos/CancelFundingRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `fundingId` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
+ */
+export declare class CancelFundingRequest {
+    idempotencyKey: string;
+    providerModuleName: string;
+}

package/bin/walletFunding/dtos/CancelFundingRequest.js

@@ -0,0 +1,33 @@
+"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.CancelFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Request del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `fundingId` viaja en el path, `directoryId` se resuelve del JWT.
+ * `providerModuleName` permite al marketplace rutear al publisher correcto
+ * sin tener que persistir el mapping (el wallet-app sabe el moduleName
+ * porque vino en la respuesta del authorize).
+ */
+class CancelFundingRequest {
+}
+exports.CancelFundingRequest = CancelFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelFundingRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], CancelFundingRequest.prototype, "providerModuleName", void 0);

package/bin/walletFunding/dtos/CancelFundingResponse.d.ts

@@ -0,0 +1,14 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+export declare class CancelFundingResponse {
+    fundingId: string;
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    message?: string;
+}

package/bin/walletFunding/dtos/CancelFundingResponse.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelFundingResponse = void 0;
+/**
+ * Response del cancel via Centro de Beneficios (spec 13 v2.0).
+ * `status` reusa `BenefitPaymentStatusEnum` (APPROVED = cancel aceptado;
+ * REJECTED = no se pudo) para consistencia con `CancelFundingReferenceResponse`
+ * (marketplace ↔ connector). Idempotente: re-cancelar devuelve APPROVED.
+ */
+class CancelFundingResponse {
+}
+exports.CancelFundingResponse = CancelFundingResponse;

package/bin/walletFunding/dtos/CancelWalletFundingRequest.d.ts

@@ -0,0 +1,3 @@
+export declare class CancelWalletFundingRequest {
+    idempotencyKey: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingRequest.js

@@ -0,0 +1,21 @@
+"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.CancelWalletFundingRequest = void 0;
+const class_validator_1 = require("class-validator");
+class CancelWalletFundingRequest {
+}
+exports.CancelWalletFundingRequest = CancelWalletFundingRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], CancelWalletFundingRequest.prototype, "idempotencyKey", void 0);

package/bin/walletFunding/dtos/CancelWalletFundingResponse.d.ts

@@ -0,0 +1,7 @@
+import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
+import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
+export declare class CancelWalletFundingResponse {
+    status: BenefitPaymentStatusEnum;
+    errorCode?: WalletFundingErrorCodeEnum;
+    fundingId?: string;
+}

package/bin/walletFunding/dtos/CancelWalletFundingResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CancelWalletFundingResponse = void 0;
+class CancelWalletFundingResponse {
+}
+exports.CancelWalletFundingResponse = CancelWalletFundingResponse;

package/package.json

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

package/src/index.ts

@@ -103,5 +103,7 @@ export * as EmailVerification from './emailVerification';
 // RetailOrg: DTOs/enums del lambda retail-org-business (SureKeep Fase 1 — pista Retail).
 // Dominio de retailers → zonas → tiendas → usuarios retail.
 export * as RetailOrg from './retailOrg';
+// LoanConfig: DTOs/enums del lambda loan-config-business (comp 09 — parámetros operativos del SOFOM).
+export * as LoanConfig from './loanConfig';
 export * from './messaging';
 export * from './complaint';

package/src/loanConfig/dtos/Parameter.ts

@@ -0,0 +1,68 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, Matches } from 'class-validator';
+import { regexIso8601 } from '../../helpers/constans/regex';
+import { ModifiableByRoleEnum } from '../enums/ModifiableByRoleEnum';
+import { ParameterTypeEnum } from '../enums/ParameterTypeEnum';
+import { ParameterValueTypeEnum } from '../enums/ParameterValueTypeEnum';
+
+/**
+ * Parameter — parámetro operativo clave/valor del SOFOM (M6 §8 + §5).
+ * Identidad lógica `parameterId = ${paramType}#${key}` (D1). `value` null → aplica `defaultValue`.
+ */
+export class Parameter {
+    @Expose()
+    @IsString()
+    parameterId!: string;
+
+    @Expose()
+    @IsEnum(ParameterTypeEnum)
+    paramType!: ParameterTypeEnum;
+
+    @Expose()
+    @IsString()
+    key!: string;
+
+    /** Siempre string; `null` cuando el valor está pendiente de definición por negocio. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    value!: string | null;
+
+    @Expose()
+    @IsEnum(ParameterValueTypeEnum)
+    valueType!: ParameterValueTypeEnum;
+
+    @Expose()
+    @IsString()
+    defaultValue!: string;
+
+    @Expose()
+    @IsString()
+    description!: string;
+
+    @Expose()
+    @IsEnum(ModifiableByRoleEnum)
+    modifiableBy!: ModifiableByRoleEnum;
+
+    @Expose()
+    @IsString()
+    lastModifiedByUserId!: string;
+
+    @Expose()
+    @IsString()
+    createdBy!: string;
+
+    @Expose()
+    @IsString()
+    updatedBy!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'createdAt debe ser una fecha ISO 8601' })
+    createdAt!: string;
+
+    @Expose()
+    @IsString()
+    @Matches(regexIso8601, { message: 'updatedAt debe ser una fecha ISO 8601' })
+    updatedAt!: string;
+}

package/src/loanConfig/dtos/requests/BulkGetParametersRequest.ts

@@ -0,0 +1,23 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayNotEmpty, IsArray, IsEnum, IsString, ValidateNested } from 'class-validator';
+import { ParameterTypeEnum } from '../../enums/ParameterTypeEnum';
+
+export class ParameterKeyRef {
+    @Expose()
+    @IsEnum(ParameterTypeEnum)
+    paramType!: ParameterTypeEnum;
+
+    @Expose()
+    @IsString()
+    key!: string;
+}
+
+/** Body de POST /private/parameters/bulk-get — hot path para consumers (cachean 5 min). */
+export class BulkGetParametersRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ValidateNested({ each: true })
+    @Type(() => ParameterKeyRef)
+    items!: ParameterKeyRef[];
+}

package/src/loanConfig/dtos/requests/BulkUpdateParametersRequest.ts

@@ -0,0 +1,33 @@
+import { Expose, Type } from 'class-transformer';
+import { ArrayNotEmpty, IsArray, IsEnum, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { ParameterTypeEnum } from '../../enums/ParameterTypeEnum';
+
+export class BulkUpdateParameterItem {
+    @Expose()
+    @IsEnum(ParameterTypeEnum)
+    paramType!: ParameterTypeEnum;
+
+    @Expose()
+    @IsString()
+    key!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    value!: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    reason?: string;
+}
+
+/** Body de POST /parameters/bulk-update — carga inicial / ajuste masivo. */
+export class BulkUpdateParametersRequest {
+    @Expose()
+    @IsArray()
+    @ArrayNotEmpty()
+    @ValidateNested({ each: true })
+    @Type(() => BulkUpdateParameterItem)
+    parameters!: BulkUpdateParameterItem[];
+}

package/src/loanConfig/dtos/requests/UpdateParameterRequest.ts

@@ -0,0 +1,18 @@
+import { Expose } from 'class-transformer';
+import { IsOptional, IsString } from 'class-validator';
+
+/**
+ * Body de PUT /parameters/:paramType/:key. `value` puede ser null (parámetro pendiente).
+ * `reason` opcional en F1; el manager lo exigirá para cambios críticos (modelo-datos §10).
+ */
+export class UpdateParameterRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    value!: string | null;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    reason?: string;
+}

package/src/loanConfig/dtos/responses/ParameterResponse.ts

@@ -0,0 +1,28 @@
+import { ModifiableByRoleEnum } from '../../enums/ModifiableByRoleEnum';
+import { ParameterTypeEnum } from '../../enums/ParameterTypeEnum';
+import { ParameterValueTypeEnum } from '../../enums/ParameterValueTypeEnum';
+
+/** Shape de salida de un parámetro. `effectiveValue` = value ?? defaultValue. */
+export interface ParameterResponse {
+    parameterId: string;
+    paramType: ParameterTypeEnum;
+    key: string;
+    value: string | null;
+    effectiveValue: string;
+    valueType: ParameterValueTypeEnum;
+    defaultValue: string;
+    description: string;
+    modifiableBy: ModifiableByRoleEnum;
+    lastModifiedByUserId: string;
+    createdAt: string;
+    updatedAt: string;
+}
+
+/** Respuesta de GET /parameters — agrupado por paramType (flow 08.1). */
+export type ParametersByTypeResponse = Partial<Record<ParameterTypeEnum, ParameterResponse[]>>;
+
+/** Respuesta de POST /private/parameters/bulk-get. */
+export interface BulkGetParametersResponse {
+    parameters: ParameterResponse[];
+    notFound: { paramType: ParameterTypeEnum; key: string }[];
+}

package/src/loanConfig/enums/ModifiableByRoleEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
+ * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
+ * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
+ * @enum {string}
+ */
+export enum ModifiableByRoleEnum {
+    SUPER_ADMIN = 'super_admin',
+    SOFOM_ADMIN = 'sofom_admin',
+    RETAILER_ADMIN = 'retailer_admin',
+}

package/src/loanConfig/enums/ParameterTypeEnum.ts

@@ -0,0 +1,20 @@
+/**
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 = 14).
+ * @enum {string}
+ */
+export enum ParameterTypeEnum {
+    CREDIT = 'CREDIT',
+    WARRANTY = 'WARRANTY',
+    WELCOME_BONUS = 'WELCOME_BONUS',
+    MORA_BLOCK = 'MORA_BLOCK',
+    UNBLOCK = 'UNBLOCK',
+    PAY_INVESTIGATION = 'PAY_INVESTIGATION',
+    COLLECTIONS = 'COLLECTIONS',
+    ANTI_FRAUD = 'ANTI_FRAUD',
+    REMITTANCE = 'REMITTANCE',
+    NOTIFICATIONS = 'NOTIFICATIONS',
+    CROSS_BORDER = 'CROSS_BORDER',
+    WIZARD = 'WIZARD',
+    INTEGRATIONS = 'INTEGRATIONS',
+    SCORING = 'SCORING',
+}

package/src/loanConfig/enums/ParameterValueTypeEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Tipo lógico del `value` (siempre persistido como string; el consumer parsea según esto).
+ * Valores en minúscula por contrato del modelo (modelo-datos §8).
+ * @enum {string}
+ */
+export enum ParameterValueTypeEnum {
+    STRING = 'string',
+    NUMBER = 'number',
+    BOOLEAN = 'boolean',
+    JSON = 'json',
+}

package/src/loanConfig/index.ts

@@ -0,0 +1,14 @@
+export * from './enums/ParameterTypeEnum';
+export * from './enums/ParameterValueTypeEnum';
+export * from './enums/ModifiableByRoleEnum';
+
+// Entity DTOs
+export * from './dtos/Parameter';
+
+// Request DTOs
+export * from './dtos/requests/UpdateParameterRequest';
+export * from './dtos/requests/BulkUpdateParametersRequest';
+export * from './dtos/requests/BulkGetParametersRequest';
+
+// Response DTOs
+export * from './dtos/responses/ParameterResponse';

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)