@fiado/type-kit 3.627.0 → 3.628.0

package/bin/collection/validators/IsCentPrecision.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsCentPrecision = exports.hasCentPrecision = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Ruido de punto flotante tolerado, en centavos. Restar montos en `double` deja colas como
+ * `648.2299999999999`; un tercer decimal real (0.001 pesos = 0.1 centavos) queda muy por encima.
+ */
+const FLOAT_NOISE_CENTS = 1e-3;
+/** `true` si el número no tiene fracción de centavo, salvo ruido de punto flotante. */
+const hasCentPrecision = (value) => {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return false;
+    const cents = value * 100;
+    return Math.abs(cents - Math.round(cents)) < FLOAT_NOISE_CENTS;
+};
+exports.hasCentPrecision = hasCentPrecision;
+/**
+ * Monto con a lo más dos decimales (centavos).
+ *
+ * No se usa `@IsNumber({ maxDecimalPlaces: 2 })` porque cuenta los dígitos del `toString()`: rechaza
+ * `648.2299999999999`, que es `648.23` con ruido de una resta. El motor de cobro deja ese ruido al
+ * restar lo cobrado de lo pendiente, y rechazar un resultado con dinero ya cobrado lo manda a la DLQ.
+ */
+const IsCentPrecision = (validationOptions) => (0, class_validator_1.ValidateBy)({
+    name: 'isCentPrecision',
+    validator: {
+        validate: (value) => (0, exports.hasCentPrecision)(value),
+        defaultMessage: () => '$property debe ser un monto con a lo más dos decimales',
+    },
+}, validationOptions);
+exports.IsCentPrecision = IsCentPrecision;

package/bin/loanCollectorAssignment/constants/CollectorAssignmentLimits.d.ts

@@ -0,0 +1,12 @@
+/** Largo máximo de un motivo de reasignación o redistribución. */
+export declare const COLLECTOR_REASON_MAX_LENGTH = 500;
+/** Al menos un carácter que no sea espacio: un motivo en blanco no explica nada. */
+export declare const COLLECTOR_REASON_NON_BLANK_PATTERN: RegExp;
+/** Ids de cadena, tienda, crédito y usuario: hoy ULID de 26; se acepta hasta 64 con guion y guion bajo. */
+export declare const COLLECTOR_ID_PATTERN: RegExp;
+export declare const COLLECTOR_ID_MAX_LENGTH = 64;
+export declare const COLLECTOR_ID_MESSAGE = "El id admite letras, n\u00FAmeros, guion y guion bajo (m\u00E1ximo 64)";
+/** Asignaciones por página del listado. */
+export declare const COLLECTOR_ASSIGNMENTS_LIST_MAX_LIMIT = 100;
+/** Largo máximo del cursor opaco del listado. */
+export declare const COLLECTOR_ASSIGNMENTS_NEXT_TOKEN_MAX_LENGTH = 1024;

package/bin/loanCollectorAssignment/constants/CollectorAssignmentLimits.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COLLECTOR_ASSIGNMENTS_NEXT_TOKEN_MAX_LENGTH = exports.COLLECTOR_ASSIGNMENTS_LIST_MAX_LIMIT = exports.COLLECTOR_ID_MESSAGE = exports.COLLECTOR_ID_MAX_LENGTH = exports.COLLECTOR_ID_PATTERN = exports.COLLECTOR_REASON_NON_BLANK_PATTERN = exports.COLLECTOR_REASON_MAX_LENGTH = void 0;
+/** Largo máximo de un motivo de reasignación o redistribución. */
+exports.COLLECTOR_REASON_MAX_LENGTH = 500;
+/** Al menos un carácter que no sea espacio: un motivo en blanco no explica nada. */
+exports.COLLECTOR_REASON_NON_BLANK_PATTERN = /\S/;
+/** Ids de cadena, tienda, crédito y usuario: hoy ULID de 26; se acepta hasta 64 con guion y guion bajo. */
+exports.COLLECTOR_ID_PATTERN = /^[A-Za-z0-9_-]+$/;
+exports.COLLECTOR_ID_MAX_LENGTH = 64;
+exports.COLLECTOR_ID_MESSAGE = 'El id admite letras, números, guion y guion bajo (máximo 64)';
+/** Asignaciones por página del listado. */
+exports.COLLECTOR_ASSIGNMENTS_LIST_MAX_LIMIT = 100;
+/** Largo máximo del cursor opaco del listado. */
+exports.COLLECTOR_ASSIGNMENTS_NEXT_TOKEN_MAX_LENGTH = 1024;

package/bin/loanCollectorAssignment/dtos/requests/AutoAssignRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * Body de POST /private/collector-assignments/auto-assign (hot path). Lo invoca loan-credit-business
  * al crearse un crédito (F3+); en F1 se prueba con `creditId` dummy. Elige cobrador y persiste ACTIVE.
+ * Los ids son llave en DynamoDB: largo y forma acotados (L-171).
  */
 export declare class AutoAssignRequest {
     retailerId: string;

package/bin/loanCollectorAssignment/dtos/requests/AutoAssignRequest.js

@@ -12,9 +12,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AutoAssignRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const CollectorAssignmentLimits_1 = require("../../constants/CollectorAssignmentLimits");
 /**
  * Body de POST /private/collector-assignments/auto-assign (hot path). Lo invoca loan-credit-business
  * al crearse un crédito (F3+); en F1 se prueba con `creditId` dummy. Elige cobrador y persiste ACTIVE.
+ * Los ids son llave en DynamoDB: largo y forma acotados (L-171).
  */
 class AutoAssignRequest {
 }
@@ -23,17 +25,23 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(CollectorAssignmentLimits_1.COLLECTOR_ID_MAX_LENGTH),
+    (0, class_validator_1.Matches)(CollectorAssignmentLimits_1.COLLECTOR_ID_PATTERN, { message: CollectorAssignmentLimits_1.COLLECTOR_ID_MESSAGE }),
     __metadata("design:type", String)
 ], AutoAssignRequest.prototype, "retailerId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(CollectorAssignmentLimits_1.COLLECTOR_ID_MAX_LENGTH),
+    (0, class_validator_1.Matches)(CollectorAssignmentLimits_1.COLLECTOR_ID_PATTERN, { message: CollectorAssignmentLimits_1.COLLECTOR_ID_MESSAGE }),
     __metadata("design:type", String)
 ], AutoAssignRequest.prototype, "creditId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(CollectorAssignmentLimits_1.COLLECTOR_ID_MAX_LENGTH),
+    (0, class_validator_1.Matches)(CollectorAssignmentLimits_1.COLLECTOR_ID_PATTERN, { message: CollectorAssignmentLimits_1.COLLECTOR_ID_MESSAGE }),
     __metadata("design:type", String)
 ], AutoAssignRequest.prototype, "storeId", void 0);

package/bin/loanCollectorAssignment/dtos/requests/ListCollectorAssignmentsRequest.d.ts

@@ -0,0 +1,14 @@
+import { AssignmentStatusEnum } from '../../enums/AssignmentStatusEnum';
+/**
+ * Query de `GET /retailers/:retailerId/collector-assignments`. Todos opcionales: sin filtros lista
+ * la cadena completa, página por página (L-161, L-170). Los filtros llegan validados, no crudos.
+ */
+export declare class ListCollectorAssignmentsRequest {
+    status?: AssignmentStatusEnum;
+    storeId?: string;
+    collectorUserId?: string;
+    /** Asignaciones por página, de 1 a 100. Sin él, el lambda pone su default. */
+    limit?: number;
+    /** Cursor opaco que devolvió la página anterior. */
+    nextToken?: string;
+}

package/bin/loanCollectorAssignment/dtos/requests/ListCollectorAssignmentsRequest.js

@@ -0,0 +1,62 @@
+"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.ListCollectorAssignmentsRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CollectorAssignmentLimits_1 = require("../../constants/CollectorAssignmentLimits");
+const AssignmentStatusEnum_1 = require("../../enums/AssignmentStatusEnum");
+/**
+ * Query de `GET /retailers/:retailerId/collector-assignments`. Todos opcionales: sin filtros lista
+ * la cadena completa, página por página (L-161, L-170). Los filtros llegan validados, no crudos.
+ */
+class ListCollectorAssignmentsRequest {
+}
+exports.ListCollectorAssignmentsRequest = ListCollectorAssignmentsRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(AssignmentStatusEnum_1.AssignmentStatusEnum),
+    __metadata("design:type", String)
+], ListCollectorAssignmentsRequest.prototype, "status", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(CollectorAssignmentLimits_1.COLLECTOR_ID_MAX_LENGTH),
+    (0, class_validator_1.Matches)(CollectorAssignmentLimits_1.COLLECTOR_ID_PATTERN, { message: CollectorAssignmentLimits_1.COLLECTOR_ID_MESSAGE }),
+    __metadata("design:type", String)
+], ListCollectorAssignmentsRequest.prototype, "storeId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(CollectorAssignmentLimits_1.COLLECTOR_ID_MAX_LENGTH),
+    (0, class_validator_1.Matches)(CollectorAssignmentLimits_1.COLLECTOR_ID_PATTERN, { message: CollectorAssignmentLimits_1.COLLECTOR_ID_MESSAGE }),
+    __metadata("design:type", String)
+], ListCollectorAssignmentsRequest.prototype, "collectorUserId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(CollectorAssignmentLimits_1.COLLECTOR_ASSIGNMENTS_LIST_MAX_LIMIT),
+    __metadata("design:type", Number)
+], ListCollectorAssignmentsRequest.prototype, "limit", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(CollectorAssignmentLimits_1.COLLECTOR_ASSIGNMENTS_NEXT_TOKEN_MAX_LENGTH),
+    __metadata("design:type", String)
+], ListCollectorAssignmentsRequest.prototype, "nextToken", void 0);

package/bin/loanCollectorAssignment/dtos/requests/ReassignRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * Body de POST /retailers/:retailerId/collector-assignments/:assignmentId/reassign (reasignación manual).
  * `reason` obligatorio (auditoría de acción crítica — modelo-datos §10).
+ * Motivo no en blanco y de hasta 500 caracteres (L-171).
  */
 export declare class ReassignRequest {
     reason: string;

package/bin/loanCollectorAssignment/dtos/requests/ReassignRequest.js

@@ -12,9 +12,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ReassignRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const CollectorAssignmentLimits_1 = require("../../constants/CollectorAssignmentLimits");
 /**
  * Body de POST /retailers/:retailerId/collector-assignments/:assignmentId/reassign (reasignación manual).
  * `reason` obligatorio (auditoría de acción crítica — modelo-datos §10).
+ * Motivo no en blanco y de hasta 500 caracteres (L-171).
  */
 class ReassignRequest {
 }
@@ -23,5 +25,7 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(CollectorAssignmentLimits_1.COLLECTOR_REASON_NON_BLANK_PATTERN, { message: 'reason no puede ir en blanco' }),
+    (0, class_validator_1.MaxLength)(CollectorAssignmentLimits_1.COLLECTOR_REASON_MAX_LENGTH),
     __metadata("design:type", String)
 ], ReassignRequest.prototype, "reason", void 0);

package/bin/loanCollectorAssignment/dtos/requests/RedistributeRequest.d.ts

@@ -1,6 +1,7 @@
 /**
  * Body de POST /retailers/:retailerId/collectors/:userId/redistribute. Redistribuye la cartera activa de
  * un cobrador (ej. al desactivarlo). `reason` obligatorio (ej. `USER_INACTIVATED`) — auditoría §10.
+ * Motivo no en blanco y de hasta 500 caracteres (L-171).
  */
 export declare class RedistributeRequest {
     reason: string;

package/bin/loanCollectorAssignment/dtos/requests/RedistributeRequest.js

@@ -12,9 +12,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RedistributeRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const CollectorAssignmentLimits_1 = require("../../constants/CollectorAssignmentLimits");
 /**
  * Body de POST /retailers/:retailerId/collectors/:userId/redistribute. Redistribuye la cartera activa de
  * un cobrador (ej. al desactivarlo). `reason` obligatorio (ej. `USER_INACTIVATED`) — auditoría §10.
+ * Motivo no en blanco y de hasta 500 caracteres (L-171).
  */
 class RedistributeRequest {
 }
@@ -23,5 +25,7 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.Matches)(CollectorAssignmentLimits_1.COLLECTOR_REASON_NON_BLANK_PATTERN, { message: 'reason no puede ir en blanco' }),
+    (0, class_validator_1.MaxLength)(CollectorAssignmentLimits_1.COLLECTOR_REASON_MAX_LENGTH),
     __metadata("design:type", String)
 ], RedistributeRequest.prototype, "reason", void 0);

package/bin/loanCollectorAssignment/dtos/responses/ListCollectorAssignmentsResponse.d.ts

@@ -0,0 +1,9 @@
+import { CollectorAssignmentResponse } from './CollectorAssignmentResponse';
+/**
+ * Respuesta de `GET /retailers/:retailerId/collector-assignments`. Conserva la clave `assignments`
+ * que ya lee la webapp; `nextToken` viene solo si hay otra página (ausente en la última).
+ */
+export interface ListCollectorAssignmentsResponse {
+    assignments: CollectorAssignmentResponse[];
+    nextToken?: string;
+}

package/bin/loanCollectorAssignment/dtos/responses/ListCollectorAssignmentsResponse.js

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

package/bin/loanCollectorAssignment/index.d.ts

@@ -1,12 +1,15 @@
 export * from './enums/AssignmentStrategyEnum';
 export * from './enums/AssignmentStatusEnum';
+export * from './constants/CollectorAssignmentLimits';
 export * from './dtos/PriorityWeights';
 export * from './dtos/requests/CreateAssignmentRuleRequest';
 export * from './dtos/requests/UpdateAssignmentRuleRequest';
 export * from './dtos/requests/AutoAssignRequest';
 export * from './dtos/requests/ReassignRequest';
 export * from './dtos/requests/RedistributeRequest';
+export * from './dtos/requests/ListCollectorAssignmentsRequest';
 export * from './dtos/responses/AssignmentRuleResponse';
 export * from './dtos/responses/CollectorAssignmentResponse';
 export * from './dtos/responses/CollectorLoadResponse';
 export * from './dtos/responses/RedistributeSummaryResponse';
+export * from './dtos/responses/ListCollectorAssignmentsResponse';

package/bin/loanCollectorAssignment/index.js

@@ -17,6 +17,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // Enums
 __exportStar(require("./enums/AssignmentStrategyEnum"), exports);
 __exportStar(require("./enums/AssignmentStatusEnum"), exports);
+// Constantes
+__exportStar(require("./constants/CollectorAssignmentLimits"), exports);
 // Shared DTOs
 __exportStar(require("./dtos/PriorityWeights"), exports);
 // Request DTOs
@@ -25,8 +27,10 @@ __exportStar(require("./dtos/requests/UpdateAssignmentRuleRequest"), exports);
 __exportStar(require("./dtos/requests/AutoAssignRequest"), exports);
 __exportStar(require("./dtos/requests/ReassignRequest"), exports);
 __exportStar(require("./dtos/requests/RedistributeRequest"), exports);
+__exportStar(require("./dtos/requests/ListCollectorAssignmentsRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/AssignmentRuleResponse"), exports);
 __exportStar(require("./dtos/responses/CollectorAssignmentResponse"), exports);
 __exportStar(require("./dtos/responses/CollectorLoadResponse"), exports);
 __exportStar(require("./dtos/responses/RedistributeSummaryResponse"), exports);
+__exportStar(require("./dtos/responses/ListCollectorAssignmentsResponse"), exports);

package/bin/loanConfig/constants/ParameterRequestLimits.d.ts

@@ -0,0 +1,8 @@
+/** Claves por llamada a bulk-get: el límite de BatchGetItem. Los consumidores mandan 20 o menos. */
+export declare const BULK_GET_PARAMETERS_MAX_ITEMS = 100;
+/** Parámetros por llamada a bulk-update; la webapp manda solo los editados (hoy 22 como máximo). */
+export declare const BULK_UPDATE_PARAMETERS_MAX_ITEMS = 50;
+/** Largo máximo del motivo de un cambio de parámetro. */
+export declare const PARAMETER_REASON_MAX_LENGTH = 500;
+/** Al menos un carácter que no sea espacio: un motivo en blanco no explica nada. */
+export declare const PARAMETER_REASON_NON_BLANK_PATTERN: RegExp;

package/bin/loanConfig/constants/ParameterRequestLimits.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PARAMETER_REASON_NON_BLANK_PATTERN = exports.PARAMETER_REASON_MAX_LENGTH = exports.BULK_UPDATE_PARAMETERS_MAX_ITEMS = exports.BULK_GET_PARAMETERS_MAX_ITEMS = void 0;
+/** Claves por llamada a bulk-get: el límite de BatchGetItem. Los consumidores mandan 20 o menos. */
+exports.BULK_GET_PARAMETERS_MAX_ITEMS = 100;
+/** Parámetros por llamada a bulk-update; la webapp manda solo los editados (hoy 22 como máximo). */
+exports.BULK_UPDATE_PARAMETERS_MAX_ITEMS = 50;
+/** Largo máximo del motivo de un cambio de parámetro. */
+exports.PARAMETER_REASON_MAX_LENGTH = 500;
+/** Al menos un carácter que no sea espacio: un motivo en blanco no explica nada. */
+exports.PARAMETER_REASON_NON_BLANK_PATTERN = /\S/;

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

@@ -3,7 +3,7 @@ export declare class ParameterKeyRef {
     paramType: ParameterTypeEnum;
     key: string;
 }
-/** Body de POST /private/parameters/bulk-get — hot path para consumers (cachean 5 min). */
+/** Body de POST /private/parameters/bulk-get — hot path para consumers (cachean 5 min). Hasta 100 claves. */
 export declare class BulkGetParametersRequest {
     items: ParameterKeyRef[];
 }

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

@@ -12,6 +12,7 @@ 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 ParameterRequestLimits_1 = require("../../constants/ParameterRequestLimits");
 const ParameterTypeEnum_1 = require("../../enums/ParameterTypeEnum");
 class ParameterKeyRef {
 }
@@ -26,7 +27,7 @@ __decorate([
     (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). */
+/** Body de POST /private/parameters/bulk-get — hot path para consumers (cachean 5 min). Hasta 100 claves. */
 class BulkGetParametersRequest {
 }
 exports.BulkGetParametersRequest = BulkGetParametersRequest;
@@ -34,6 +35,7 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayMaxSize)(ParameterRequestLimits_1.BULK_GET_PARAMETERS_MAX_ITEMS),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => ParameterKeyRef),
     __metadata("design:type", Array)

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

@@ -1,11 +1,14 @@
 import { ParameterTypeEnum } from '../../enums/ParameterTypeEnum';
+/** Un parámetro del lote. Mismas reglas que `UpdateParameterRequest` para `value` y `reason`. */
 export declare class BulkUpdateParameterItem {
     paramType: ParameterTypeEnum;
     key: string;
+    /** Obligatorio; `null` deja el parámetro pendiente. */
     value: string | null;
-    reason?: string;
+    /** Obligatorio, no en blanco y de hasta 500 caracteres. */
+    reason: string;
 }
-/** Body de POST /parameters/bulk-update — carga inicial / ajuste masivo. */
+/** Body de POST /parameters/bulk-update — carga inicial / ajuste masivo. Hasta 50 parámetros. */
 export declare class BulkUpdateParametersRequest {
     parameters: BulkUpdateParameterItem[];
 }

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

@@ -12,7 +12,9 @@ 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 ParameterRequestLimits_1 = require("../../constants/ParameterRequestLimits");
 const ParameterTypeEnum_1 = require("../../enums/ParameterTypeEnum");
+/** Un parámetro del lote. Mismas reglas que `UpdateParameterRequest` para `value` y `reason`. */
 class BulkUpdateParameterItem {
 }
 exports.BulkUpdateParameterItem = BulkUpdateParameterItem;
@@ -28,17 +30,18 @@ __decorate([
 ], BulkUpdateParameterItem.prototype, "key", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.ValidateIf)((item) => item.value !== null),
+    (0, class_validator_1.IsString)({ message: 'value es obligatorio: un string, o null para dejar el parámetro pendiente' }),
     __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)(),
+    (0, class_validator_1.Matches)(ParameterRequestLimits_1.PARAMETER_REASON_NON_BLANK_PATTERN, { message: 'reason no puede ir vacío ni en blanco' }),
+    (0, class_validator_1.MaxLength)(ParameterRequestLimits_1.PARAMETER_REASON_MAX_LENGTH),
     __metadata("design:type", String)
 ], BulkUpdateParameterItem.prototype, "reason", void 0);
-/** Body de POST /parameters/bulk-update — carga inicial / ajuste masivo. */
+/** Body de POST /parameters/bulk-update — carga inicial / ajuste masivo. Hasta 50 parámetros. */
 class BulkUpdateParametersRequest {
 }
 exports.BulkUpdateParametersRequest = BulkUpdateParametersRequest;
@@ -46,6 +49,7 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayMaxSize)(ParameterRequestLimits_1.BULK_UPDATE_PARAMETERS_MAX_ITEMS),
     (0, class_validator_1.ValidateNested)({ each: true }),
     (0, class_transformer_1.Type)(() => BulkUpdateParameterItem),
     __metadata("design:type", Array)

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

@@ -1,8 +1,11 @@
 /**
- * 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).
+ * Body de PUT /parameters/:paramType/:key.
+ *
+ * - `value` es obligatorio pero puede ser `null` (parámetro pendiente). Omitirlo da 400: antes borraba
+ *   el valor y respondía 200 (L-140).
+ * - `reason` es obligatorio, no en blanco y de hasta 500 caracteres (decisión D-7, L-139).
  */
 export declare class UpdateParameterRequest {
     value: string | null;
-    reason?: string;
+    reason: string;
 }

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

@@ -12,22 +12,27 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateParameterRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const ParameterRequestLimits_1 = require("../../constants/ParameterRequestLimits");
 /**
- * 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).
+ * Body de PUT /parameters/:paramType/:key.
+ *
+ * - `value` es obligatorio pero puede ser `null` (parámetro pendiente). Omitirlo da 400: antes borraba
+ *   el valor y respondía 200 (L-140).
+ * - `reason` es obligatorio, no en blanco y de hasta 500 caracteres (decisión D-7, L-139).
  */
 class UpdateParameterRequest {
 }
 exports.UpdateParameterRequest = UpdateParameterRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.ValidateIf)((request) => request.value !== null),
+    (0, class_validator_1.IsString)({ message: 'value es obligatorio: un string, o null para dejar el parámetro pendiente' }),
     __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)(),
+    (0, class_validator_1.Matches)(ParameterRequestLimits_1.PARAMETER_REASON_NON_BLANK_PATTERN, { message: 'reason no puede ir vacío ni en blanco' }),
+    (0, class_validator_1.MaxLength)(ParameterRequestLimits_1.PARAMETER_REASON_MAX_LENGTH),
     __metadata("design:type", String)
 ], UpdateParameterRequest.prototype, "reason", void 0);

package/bin/loanConfig/index.d.ts

@@ -1,6 +1,7 @@
 export * from './enums/ParameterTypeEnum';
 export * from './enums/ParameterValueTypeEnum';
 export * from './constants/RecentParameterChangesLimits';
+export * from './constants/ParameterRequestLimits';
 export * from './dtos/Parameter';
 export * from './dtos/requests/UpdateParameterRequest';
 export * from './dtos/requests/BulkUpdateParametersRequest';

package/bin/loanConfig/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./enums/ParameterTypeEnum"), exports);
 __exportStar(require("./enums/ParameterValueTypeEnum"), exports);
 // Constants
 __exportStar(require("./constants/RecentParameterChangesLimits"), exports);
+__exportStar(require("./constants/ParameterRequestLimits"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/Parameter"), exports);
 // Request DTOs

package/bin/loanCredit/constants/LoanInputLimits.d.ts

@@ -0,0 +1,24 @@
+/** Plazo máximo de un crédito en semanas, en el alta y en la reestructura. */
+export declare const LOAN_MAX_TERM_WEEKS = 104;
+/**
+ * Techo técnico de un monto en centavos: 100 000 millones de centavos (1 000 millones de pesos).
+ *
+ * No es política de negocio: un equipo cuesta decenas de miles de pesos. Deja cuatro órdenes de
+ * margen bajo `Number.MAX_SAFE_INTEGER` para que intereses, IVA y sumas de cuotas no pierdan el centavo.
+ */
+export declare const LOAN_AMOUNT_MAX_CENTS = 100000000000;
+/** Largo máximo de un texto libre del backoffice (motivo, justificación); igual que la cancelación. */
+export declare const LOAN_FREE_TEXT_MAX_LENGTH = 500;
+/**
+ * Forma aceptada de un `retailCustomerId`. Laxa a propósito: el formato lo define retail-customer
+ * (hoy un ULID), así que solo se rechaza lo que no puede ser un id (espacios, comas, símbolos).
+ */
+export declare const RETAIL_CUSTOMER_ID_PATTERN: RegExp;
+export declare const RETAIL_CUSTOMER_ID_MESSAGE = "retailCustomerId admite letras, n\u00FAmeros, guion y guion bajo (m\u00E1ximo 64)";
+/** CLABE interbancaria: exactamente 18 dígitos. La aplica el dominio (D9); el DTO del contrato solo acota el largo. */
+export declare const CLABE_PATTERN: RegExp;
+export declare const CLABE_MESSAGE = "La CLABE debe tener 18 d\u00EDgitos";
+/** Teléfono en E.164: `+`, código de país y número; 16 caracteres como máximo. */
+export declare const E164_PHONE_PATTERN: RegExp;
+export declare const E164_PHONE_MAX_LENGTH = 16;
+export declare const E164_PHONE_MESSAGE = "El tel\u00E9fono debe ir en formato E.164 (por ejemplo +525512345678)";

package/bin/loanCredit/constants/LoanInputLimits.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.E164_PHONE_MESSAGE = exports.E164_PHONE_MAX_LENGTH = exports.E164_PHONE_PATTERN = exports.CLABE_MESSAGE = exports.CLABE_PATTERN = exports.RETAIL_CUSTOMER_ID_MESSAGE = exports.RETAIL_CUSTOMER_ID_PATTERN = exports.LOAN_FREE_TEXT_MAX_LENGTH = exports.LOAN_AMOUNT_MAX_CENTS = exports.LOAN_MAX_TERM_WEEKS = void 0;
+/** Plazo máximo de un crédito en semanas, en el alta y en la reestructura. */
+exports.LOAN_MAX_TERM_WEEKS = 104;
+/**
+ * Techo técnico de un monto en centavos: 100 000 millones de centavos (1 000 millones de pesos).
+ *
+ * No es política de negocio: un equipo cuesta decenas de miles de pesos. Deja cuatro órdenes de
+ * margen bajo `Number.MAX_SAFE_INTEGER` para que intereses, IVA y sumas de cuotas no pierdan el centavo.
+ */
+exports.LOAN_AMOUNT_MAX_CENTS = 100000000000;
+/** Largo máximo de un texto libre del backoffice (motivo, justificación); igual que la cancelación. */
+exports.LOAN_FREE_TEXT_MAX_LENGTH = 500;
+/**
+ * Forma aceptada de un `retailCustomerId`. Laxa a propósito: el formato lo define retail-customer
+ * (hoy un ULID), así que solo se rechaza lo que no puede ser un id (espacios, comas, símbolos).
+ */
+exports.RETAIL_CUSTOMER_ID_PATTERN = /^[0-9A-Za-z_-]{1,64}$/;
+exports.RETAIL_CUSTOMER_ID_MESSAGE = 'retailCustomerId admite letras, números, guion y guion bajo (máximo 64)';
+/** CLABE interbancaria: exactamente 18 dígitos. La aplica el dominio (D9); el DTO del contrato solo acota el largo. */
+exports.CLABE_PATTERN = /^\d{18}$/;
+exports.CLABE_MESSAGE = 'La CLABE debe tener 18 dígitos';
+/** Teléfono en E.164: `+`, código de país y número; 16 caracteres como máximo. */
+exports.E164_PHONE_PATTERN = /^\+[1-9]\d{7,14}$/;
+exports.E164_PHONE_MAX_LENGTH = 16;
+exports.E164_PHONE_MESSAGE = 'El teléfono debe ir en formato E.164 (por ejemplo +525512345678)';

package/bin/loanCredit/dtos/LoanBeneficiary.d.ts

@@ -1,5 +1,6 @@
 /**
  * Beneficiario declarado por el acreditado (modelo-datos §5b `LoanBorrower.beneficiary`).
+ * Textos con tope y teléfono MX de 10 dígitos, con `+52` opcional (L-031).
  */
 export declare class LoanBeneficiary {
     fullName: string;

package/bin/loanCredit/dtos/LoanBeneficiary.js

@@ -12,8 +12,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LoanBeneficiary = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const IsMxPhone_1 = require("../../common/validators/IsMxPhone");
+/** Largo máximo del nombre completo, igual que en el contrato. */
+const FULL_NAME_MAX_LENGTH = 300;
+/** Largo máximo del parentesco. */
+const RELATIONSHIP_MAX_LENGTH = 120;
 /**
  * Beneficiario declarado por el acreditado (modelo-datos §5b `LoanBorrower.beneficiary`).
+ * Textos con tope y teléfono MX de 10 dígitos, con `+52` opcional (L-031).
  */
 class LoanBeneficiary {
 }
@@ -22,17 +28,20 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(FULL_NAME_MAX_LENGTH),
     __metadata("design:type", String)
 ], LoanBeneficiary.prototype, "fullName", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(RELATIONSHIP_MAX_LENGTH),
     __metadata("design:type", String)
 ], LoanBeneficiary.prototype, "relationship", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, IsMxPhone_1.IsMxPhone)(),
     __metadata("design:type", String)
 ], LoanBeneficiary.prototype, "phone", void 0);

package/bin/loanCredit/dtos/LoanContractDetails.d.ts

@@ -1,10 +1,23 @@
 /** Datos del acreditado tal como se imprimen en el contrato (Sección II.1). */
 export declare class LoanContractBorrowerDetails {
     fullName: string;
+    /**
+     * Solo con tope de largo. retail-customer guarda el CURP de Metamap sin validar su formato, así que
+     * exigir `regexCurp` aquí tumbaría la firma. El formato lo revisa el dominio (loan-credit).
+     */
     curp: string;
     /** Domicilio completo en una línea. */
     address: string;
+    /**
+     * Solo con tope de largo. El RFC de `people` solo se limpia de espacios y puede llegar en minúsculas
+     * o con 10 caracteres; si se rechaza, el wizard descarta todo `contractDetails` y la firma no sale.
+     * El formato (`RFC_PATTERN`) lo revisa el dominio.
+     */
     rfc?: string;
+    /**
+     * Fecha de nacimiento ya formateada para imprimir (el wizard manda `DD/MM/AAAA`). Solo con tope de
+     * largo: el dominio puede revisar la fecha con `isContractBirthDate` y dejarla en blanco si no cumple.
+     */
     birthDate?: string;
     /** Identificación oficial con la que se validó al acreditado (p. ej. INE). */
     identification?: string;
@@ -31,7 +44,11 @@ export declare class LoanContractProviderDetails {
 }
 /** Cuenta Pago Confiado del acreditado, de la que se cobra el crédito (Secciones VI y VIII). */
 export declare class LoanContractPcfAccountDetails {
-    /** Tal como la tiene la cuenta; en dev puede no ser una CLABE de 18 dígitos. */
+    /**
+     * Tal como la tiene la cuenta, con tope de largo. La CLABE estricta de 18 dígitos (decisión D9) se
+     * aplica en el dominio: si no cumple `CLABE_PATTERN`, loan-credit deja la cuenta en blanco en el
+     * contrato. No se exige aquí para no rechazar la firma cuando la cuenta de dev no es una CLABE.
+     */
     clabe: string;
 }
 /**

package/bin/loanCredit/dtos/LoanContractDetails.js

@@ -75,7 +75,8 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
-    (0, class_validator_1.MaxLength)(LONG_TEXT),
+    (0, class_validator_1.MaxLength)(InputPatterns_1.EMAIL_MAX_LENGTH),
+    (0, class_validator_1.Matches)(InputPatterns_1.EMAIL_PATTERN, { message: InputPatterns_1.EMAIL_MESSAGE }),
     __metadata("design:type", String)
 ], LoanContractBorrowerDetails.prototype, "email", void 0);
 __decorate([