@fiado/type-kit 3.183.0 → 3.185.0

package/bin/loanConfig/dtos/requests/BulkGetParametersRequest.js

@@ -0,0 +1,40 @@
+"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.BulkGetParametersRequest = exports.ParameterKeyRef = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ParameterTypeEnum_1 = require("../../enums/ParameterTypeEnum");
+class ParameterKeyRef {
+}
+exports.ParameterKeyRef = ParameterKeyRef;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ParameterTypeEnum_1.ParameterTypeEnum),
+    __metadata("design:type", String)
+], ParameterKeyRef.prototype, "paramType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ParameterKeyRef.prototype, "key", void 0);
+/** Body de POST /private/parameters/bulk-get — hot path para consumers (cachean 5 min). */
+class BulkGetParametersRequest {
+}
+exports.BulkGetParametersRequest = BulkGetParametersRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => ParameterKeyRef),
+    __metadata("design:type", Array)
+], BulkGetParametersRequest.prototype, "items", void 0);

package/bin/loanConfig/dtos/requests/BulkUpdateParametersRequest.d.ts

@@ -0,0 +1,11 @@
+import { ParameterTypeEnum } from '../../enums/ParameterTypeEnum';
+export declare class BulkUpdateParameterItem {
+    paramType: ParameterTypeEnum;
+    key: string;
+    value: string | null;
+    reason?: string;
+}
+/** Body de POST /parameters/bulk-update — carga inicial / ajuste masivo. */
+export declare class BulkUpdateParametersRequest {
+    parameters: BulkUpdateParameterItem[];
+}

package/bin/loanConfig/dtos/requests/BulkUpdateParametersRequest.js

@@ -0,0 +1,52 @@
+"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.BulkUpdateParametersRequest = exports.BulkUpdateParameterItem = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ParameterTypeEnum_1 = require("../../enums/ParameterTypeEnum");
+class BulkUpdateParameterItem {
+}
+exports.BulkUpdateParameterItem = BulkUpdateParameterItem;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ParameterTypeEnum_1.ParameterTypeEnum),
+    __metadata("design:type", String)
+], BulkUpdateParameterItem.prototype, "paramType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BulkUpdateParameterItem.prototype, "key", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BulkUpdateParameterItem.prototype, "value", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], BulkUpdateParameterItem.prototype, "reason", void 0);
+/** Body de POST /parameters/bulk-update — carga inicial / ajuste masivo. */
+class BulkUpdateParametersRequest {
+}
+exports.BulkUpdateParametersRequest = BulkUpdateParametersRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => BulkUpdateParameterItem),
+    __metadata("design:type", Array)
+], BulkUpdateParametersRequest.prototype, "parameters", void 0);

package/bin/loanConfig/dtos/requests/UpdateParameterRequest.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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 declare class UpdateParameterRequest {
+    value: string | null;
+    reason?: string;
+}

package/bin/loanConfig/dtos/requests/UpdateParameterRequest.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.UpdateParameterRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("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).
+ */
+class UpdateParameterRequest {
+}
+exports.UpdateParameterRequest = UpdateParameterRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateParameterRequest.prototype, "value", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], UpdateParameterRequest.prototype, "reason", void 0);

package/bin/loanConfig/dtos/responses/ParameterResponse.d.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/bin/loanConfig/dtos/responses/ParameterResponse.js

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

package/bin/loanConfig/enums/ModifiableByRoleEnum.d.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 declare enum ModifiableByRoleEnum {
+    SUPER_ADMIN = "super_admin",
+    SOFOM_ADMIN = "sofom_admin",
+    RETAILER_ADMIN = "retailer_admin"
+}

package/bin/loanConfig/enums/ModifiableByRoleEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModifiableByRoleEnum = void 0;
+/**
+ * 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}
+ */
+var ModifiableByRoleEnum;
+(function (ModifiableByRoleEnum) {
+    ModifiableByRoleEnum["SUPER_ADMIN"] = "super_admin";
+    ModifiableByRoleEnum["SOFOM_ADMIN"] = "sofom_admin";
+    ModifiableByRoleEnum["RETAILER_ADMIN"] = "retailer_admin";
+})(ModifiableByRoleEnum || (exports.ModifiableByRoleEnum = ModifiableByRoleEnum = {}));

package/bin/loanConfig/enums/ParameterTypeEnum.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 = 14).
+ * @enum {string}
+ */
+export declare 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/bin/loanConfig/enums/ParameterTypeEnum.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParameterTypeEnum = void 0;
+/**
+ * Sub-tipos de parámetro operativo del SOFOM (M6 §8 = 13 + SCORING de §5 = 14).
+ * @enum {string}
+ */
+var ParameterTypeEnum;
+(function (ParameterTypeEnum) {
+    ParameterTypeEnum["CREDIT"] = "CREDIT";
+    ParameterTypeEnum["WARRANTY"] = "WARRANTY";
+    ParameterTypeEnum["WELCOME_BONUS"] = "WELCOME_BONUS";
+    ParameterTypeEnum["MORA_BLOCK"] = "MORA_BLOCK";
+    ParameterTypeEnum["UNBLOCK"] = "UNBLOCK";
+    ParameterTypeEnum["PAY_INVESTIGATION"] = "PAY_INVESTIGATION";
+    ParameterTypeEnum["COLLECTIONS"] = "COLLECTIONS";
+    ParameterTypeEnum["ANTI_FRAUD"] = "ANTI_FRAUD";
+    ParameterTypeEnum["REMITTANCE"] = "REMITTANCE";
+    ParameterTypeEnum["NOTIFICATIONS"] = "NOTIFICATIONS";
+    ParameterTypeEnum["CROSS_BORDER"] = "CROSS_BORDER";
+    ParameterTypeEnum["WIZARD"] = "WIZARD";
+    ParameterTypeEnum["INTEGRATIONS"] = "INTEGRATIONS";
+    ParameterTypeEnum["SCORING"] = "SCORING";
+})(ParameterTypeEnum || (exports.ParameterTypeEnum = ParameterTypeEnum = {}));

package/bin/loanConfig/enums/ParameterValueTypeEnum.d.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 declare enum ParameterValueTypeEnum {
+    STRING = "string",
+    NUMBER = "number",
+    BOOLEAN = "boolean",
+    JSON = "json"
+}

package/bin/loanConfig/enums/ParameterValueTypeEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParameterValueTypeEnum = void 0;
+/**
+ * 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}
+ */
+var ParameterValueTypeEnum;
+(function (ParameterValueTypeEnum) {
+    ParameterValueTypeEnum["STRING"] = "string";
+    ParameterValueTypeEnum["NUMBER"] = "number";
+    ParameterValueTypeEnum["BOOLEAN"] = "boolean";
+    ParameterValueTypeEnum["JSON"] = "json";
+})(ParameterValueTypeEnum || (exports.ParameterValueTypeEnum = ParameterValueTypeEnum = {}));

package/bin/loanConfig/index.d.ts

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

package/bin/loanConfig/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums/ParameterTypeEnum"), exports);
+__exportStar(require("./enums/ParameterValueTypeEnum"), exports);
+__exportStar(require("./enums/ModifiableByRoleEnum"), exports);
+// Entity DTOs
+__exportStar(require("./dtos/Parameter"), exports);
+// Request DTOs
+__exportStar(require("./dtos/requests/UpdateParameterRequest"), exports);
+__exportStar(require("./dtos/requests/BulkUpdateParametersRequest"), exports);
+__exportStar(require("./dtos/requests/BulkGetParametersRequest"), exports);
+// Response DTOs
+__exportStar(require("./dtos/responses/ParameterResponse"), exports);

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/rbac/enums/PoolKind.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tipo de User Pool de Cognito desde la perspectiva del modelo RBAC Fiado.
+ *
+ * Origen: spec del proyecto `cognito-backoffice-connector` (Fase 0, componente 01
+ * documento `docs/superpowers/specs/2026-05-26-cognito-connector-decisiones-pendientes-design.md`).
+ *
+ * Decisión (TD-003): el proyecto converge en estos 2 valores. El documento componente 03
+ * lista 3 valores (incluyendo una variante adicional) pero queda como outlier — la
+ * decisión vigente en los 6 docs restantes y en el plan de implementación es 2 valores:
+ *  - BACKOFFICE_PLATFORM — pool del backoffice de plataforma (cross-tenant)
+ *  - BACKOFFICE_TENANT — pool por tenant (multi-tenant isolation)
+ */
+export declare enum PoolKind {
+    BACKOFFICE_PLATFORM = "BACKOFFICE_PLATFORM",
+    BACKOFFICE_TENANT = "BACKOFFICE_TENANT"
+}

package/bin/rbac/enums/PoolKind.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolKind = void 0;
+/**
+ * Tipo de User Pool de Cognito desde la perspectiva del modelo RBAC Fiado.
+ *
+ * Origen: spec del proyecto `cognito-backoffice-connector` (Fase 0, componente 01
+ * documento `docs/superpowers/specs/2026-05-26-cognito-connector-decisiones-pendientes-design.md`).
+ *
+ * Decisión (TD-003): el proyecto converge en estos 2 valores. El documento componente 03
+ * lista 3 valores (incluyendo una variante adicional) pero queda como outlier — la
+ * decisión vigente en los 6 docs restantes y en el plan de implementación es 2 valores:
+ *  - BACKOFFICE_PLATFORM — pool del backoffice de plataforma (cross-tenant)
+ *  - BACKOFFICE_TENANT — pool por tenant (multi-tenant isolation)
+ */
+var PoolKind;
+(function (PoolKind) {
+    PoolKind["BACKOFFICE_PLATFORM"] = "BACKOFFICE_PLATFORM";
+    PoolKind["BACKOFFICE_TENANT"] = "BACKOFFICE_TENANT";
+})(PoolKind || (exports.PoolKind = PoolKind = {}));

package/bin/rbac/index.d.ts

@@ -0,0 +1 @@
+export * from './enums/PoolKind';

package/bin/rbac/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums/PoolKind"), exports);

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[];
 }