@fiado/type-kit 3.627.0 → 3.629.0

package/src/loanOfferings/dtos/requests/UpdateFinancierRequest.ts

@@ -2,30 +2,49 @@ import { Expose } from 'class-transformer';
 import {
     IsArray,
     IsEnum,
+    IsNotEmpty,
     IsObject,
     IsOptional,
     IsString,
+    IsUrl,
+    MaxLength,
 } from 'class-validator';
+import {
+    FINANCIER_CONFIG_MAX_BYTES,
+    FINANCIER_REDIRECT_URL_MAX_LENGTH,
+    OFFERINGS_LABEL_MAX_LENGTH,
+    OFFERINGS_NAME_MAX_LENGTH,
+} from '../../constants/offeringsInputLimits';
 import { ProductTierEnum } from '../../enums/ProductTierEnum';
+import { IsOptionalNonNull } from '../../validators/IsOptionalNonNull';
+import { MaxJsonBytes } from '../../validators/MaxJsonBytes';
 
 /**
  * Body de PUT /financiers/:financierId — edición parcial (todos opcionales).
  * `code`, `type` y `displayOrder` no se editan aquí (identidad / orden por endpoint dedicado).
+ * `null` se acepta en `externalRedirectUrl`, `eligibleTiers` y `config`; en `name` y `label` da 400.
  */
 export class UpdateFinancierRequest {
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsString()
+    @IsNotEmpty()
+    @MaxLength(OFFERINGS_NAME_MAX_LENGTH)
     name?: string;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsString()
+    @IsNotEmpty()
+    @MaxLength(OFFERINGS_LABEL_MAX_LENGTH)
     label?: string;
 
+    /** URL https a la que se redirige al cliente; `null` = sin redirección. */
     @Expose()
     @IsOptional()
     @IsString()
+    @MaxLength(FINANCIER_REDIRECT_URL_MAX_LENGTH)
+    @IsUrl({ protocols: ['https'], require_protocol: true })
     externalRedirectUrl?: string | null;
 
     @Expose()
@@ -34,8 +53,13 @@ export class UpdateFinancierRequest {
     @IsEnum(ProductTierEnum, { each: true })
     eligibleTiers?: ProductTierEnum[] | null;
 
+    /**
+     * @deprecated Ningún consumidor lo lee (TD-019 de loan-offerings) y se va a eliminar (decisión
+     * D-9). Mientras tanto, a lo más 4 KB serializado.
+     */
     @Expose()
     @IsOptional()
     @IsObject()
+    @MaxJsonBytes(FINANCIER_CONFIG_MAX_BYTES)
     config?: Record<string, unknown> | null;
 }

package/src/loanOfferings/dtos/requests/UpdatePromotionRequest.ts

@@ -9,52 +9,71 @@ import {
     IsNotEmpty,
     IsOptional,
     IsString,
+    MaxLength,
     ValidateNested,
 } from 'class-validator';
+import {
+    OFFERINGS_AUDIT_REASON_MAX_LENGTH,
+    OFFERINGS_DESCRIPTION_MAX_LENGTH,
+    OFFERINGS_NAME_MAX_LENGTH,
+    PROMOTION_PRODUCT_SKUS_MAX_ITEMS,
+    SCOPE_STORE_IDS_MAX_ITEMS,
+} from '../../constants/offeringsInputLimits';
 import { PROMOTION_RETAILER_IDS_MAX_ITEMS } from '../../constants/promotionRetailerScope';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
 import { ProductCategoryEnum } from '../../../retailCatalog/enums/ProductCategoryEnum';
 import { ProductTierEnum } from '../../../retailCatalog/enums/ProductTierEnum';
+import { IsOptionalNonNull } from '../../validators/IsOptionalNonNull';
 import { PromotionEffectInput } from './PromotionEffectInput';
 
 /**
  * Body de PUT /promotions/:promotionId — edición parcial (todos los campos opcionales).
  * Solo se admite sobre `DRAFT` y `PUBLISHED`, y sube `version`. El cambio de estado va por su
  * endpoint dedicado. `effect` se reemplaza entero cuando viene, no se mergea clave a clave.
+ *
+ * Ausente deja el campo como está. `null` solo se acepta en los alcances, las fechas y el
+ * presupuesto, que lo declaran; en `name`, `description`, `effect`, `segmentId` y `targetLevels` da 400.
  */
 export class UpdatePromotionRequest {
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsString()
+    @IsNotEmpty()
+    @MaxLength(OFFERINGS_NAME_MAX_LENGTH)
     name?: string;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsString()
+    @IsNotEmpty()
+    @MaxLength(OFFERINGS_DESCRIPTION_MAX_LENGTH)
     description?: string;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @ValidateNested()
     @Type(() => PromotionEffectInput)
     effect?: PromotionEffectInput;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsString()
     segmentId?: string;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsArray()
     @ArrayNotEmpty()
     @IsEnum(CreditPlanLevelEnum, { each: true })
     targetLevels?: CreditPlanLevelEnum[];
 
+    /** SKUs alcanzados; `null` = todos los productos. Hasta 2 000. */
     @Expose()
     @IsOptional()
     @IsArray()
+    @ArrayMaxSize(PROMOTION_PRODUCT_SKUS_MAX_ITEMS)
     @IsString({ each: true })
+    @IsNotEmpty({ each: true })
     productSkus?: string[] | null;
 
     /** Tipos de producto alcanzados; ausente o `null` = todos los tipos. */
@@ -80,11 +99,13 @@ export class UpdatePromotionRequest {
     @IsNotEmpty({ each: true })
     retailerIds?: string[] | null;
 
-    /** Tiendas alcanzadas. `null` o ausente = todas. */
+    /** Tiendas alcanzadas. `null` o ausente = todas. Hasta 1 000. */
     @Expose()
     @IsOptional()
     @IsArray()
+    @ArrayMaxSize(SCOPE_STORE_IDS_MAX_ITEMS)
     @IsString({ each: true })
+    @IsNotEmpty({ each: true })
     storeIds?: string[] | null;
 
     @Expose()
@@ -101,4 +122,11 @@ export class UpdatePromotionRequest {
     @IsOptional()
     @IsInt()
     budgetMaxCents?: number | null;
+
+    /** Motivo del cambio; queda en la bitácora de la promoción. */
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(OFFERINGS_AUDIT_REASON_MAX_LENGTH)
+    reason?: string;
 }

package/src/loanOfferings/dtos/requests/UpdateSegmentRequest.ts

@@ -1,6 +1,8 @@
 import { Expose } from 'class-transformer';
 import { ArrayMaxSize, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { SEGMENT_MEMBER_IDS_MAX_ITEMS } from '../../constants/offeringsInputLimits';
 import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
+import { IsOptionalNonNull } from '../../validators/IsOptionalNonNull';
 
 /**
  * Body de PUT /segments/:segmentId — edición parcial (todos los campos opcionales). Sube `version`.
@@ -8,10 +10,13 @@ import { SegmentColorSlotEnum } from '../../enums/SegmentColorSlotEnum';
  *
  * Un arreglo vacío VACÍA la lista; ausente la deja como está. El segmento por omisión
  * (`isDefault`) solo acepta el cambio de nombre.
+ *
+ * `null` solo se acepta en `description`, donde la borra (así la manda el backoffice al vaciarla).
+ * En el resto da 400: un `null` en las listas reventaba con 500.
  */
 export class UpdateSegmentRequest {
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsString()
     @MaxLength(120)
     name?: string;
@@ -20,16 +25,16 @@ export class UpdateSegmentRequest {
     @IsOptional()
     @IsString()
     @MaxLength(500)
-    description?: string;
+    description?: string | null;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsEnum(SegmentColorSlotEnum)
     colorSlot?: SegmentColorSlotEnum;
 
     /** Reemplaza la lista entera; `[]` deja el segmento sin cohorts. */
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsArray()
     @IsString({ each: true })
     @IsNotEmpty({ each: true })
@@ -38,16 +43,18 @@ export class UpdateSegmentRequest {
 
     /** @deprecated Usar `cohortIds`; se conserva para los consumidores que aún no migran. */
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsArray()
     @IsString({ each: true })
     filterIds?: string[];
 
-    /** Reemplaza la lista entera; `[]` saca a todos los agregados a mano. */
+    /** Reemplaza la lista entera; `[]` saca a todos los agregados a mano. Hasta 5 000, sin ids vacíos. */
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsArray()
+    @ArrayMaxSize(SEGMENT_MEMBER_IDS_MAX_ITEMS)
     @IsString({ each: true })
+    @IsNotEmpty({ each: true })
     memberIds?: string[];
 
     @Expose()

package/src/loanOfferings/dtos/requests/UpdateStorePolicyRequest.ts

@@ -1,26 +1,34 @@
 import { Expose, Type } from 'class-transformer';
 import {
+    ArrayMaxSize,
     ArrayNotEmpty,
     IsArray,
     IsBoolean,
     IsEnum,
     IsISO8601,
+    IsNotEmpty,
     IsOptional,
     IsString,
     MaxLength,
     ValidateNested,
 } from 'class-validator';
+import { SCOPE_STORE_IDS_MAX_ITEMS } from '../../constants/offeringsInputLimits';
 import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { IsOptionalNonNull } from '../../validators/IsOptionalNonNull';
 import { StorePolicyEasingDto, StorePolicyHardeningDto } from './CreateStorePolicyRequest';
 
 /**
  * Body de PUT /store-policies/:policyId — edición parcial (todos los campos opcionales).
  * Sube `version`. El cambio de estado va por su endpoint dedicado. Cada grupo de palancas se
  * reemplaza entero cuando viene, no se mergea clave a clave.
+ *
+ * Ausente deja el campo como está. `null` BORRA el valor en la descripción, los alcances y las
+ * fechas: el alcance vuelve a «toda la red» y la vigencia a «permanente» (así lo usa el backoffice).
+ * En `name`, `hardening`, `easing` y `suspended` un `null` da 400.
  */
 export class UpdateStorePolicyRequest {
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsString()
     @MaxLength(120)
     name?: string;
@@ -29,70 +37,77 @@ export class UpdateStorePolicyRequest {
     @IsOptional()
     @IsString()
     @MaxLength(500)
-    description?: string;
+    description?: string | null;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @ValidateNested()
     @Type(() => StorePolicyHardeningDto)
     hardening?: StorePolicyHardeningDto;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @ValidateNested()
     @Type(() => StorePolicyEasingDto)
     easing?: StorePolicyEasingDto;
 
     @Expose()
-    @IsOptional()
+    @IsOptionalNonNull()
     @IsBoolean()
     suspended?: boolean;
 
+    /** Compuerta: SKUs habilitados; `null` = sin restricción. */
     @Expose()
     @IsOptional()
     @IsArray()
     @ArrayNotEmpty()
     @IsString({ each: true })
-    allowedSkus?: string[];
+    allowedSkus?: string[] | null;
 
+    /** Alcance: tiendas; `null` = toda la red. Hasta 1 000. */
     @Expose()
     @IsOptional()
     @IsArray()
     @ArrayNotEmpty()
+    @ArrayMaxSize(SCOPE_STORE_IDS_MAX_ITEMS)
     @IsString({ each: true })
-    storeIds?: string[];
+    @IsNotEmpty({ each: true })
+    storeIds?: string[] | null;
 
+    /** Alcance: niveles; `null` = todos. */
     @Expose()
     @IsOptional()
     @IsArray()
     @ArrayNotEmpty()
     @IsEnum(CreditPlanLevelEnum, { each: true })
-    targetLevels?: CreditPlanLevelEnum[];
+    targetLevels?: CreditPlanLevelEnum[] | null;
 
-    /** Alcance: segmentos alcanzados. */
+    /** Alcance: segmentos alcanzados; `null` = todos. */
     @Expose()
     @IsOptional()
     @IsArray()
     @ArrayNotEmpty()
     @IsString({ each: true })
-    segmentIds?: string[];
+    segmentIds?: string[] | null;
 
+    /** Alcance: SKUs; `null` = todos los productos. */
     @Expose()
     @IsOptional()
     @IsArray()
     @ArrayNotEmpty()
     @IsString({ each: true })
-    targetSkus?: string[];
+    targetSkus?: string[] | null;
 
     @Expose()
     @IsOptional()
     @IsISO8601()
-    validFrom?: string;
+    validFrom?: string | null;
 
+    /** `null` = permanente. */
     @Expose()
     @IsOptional()
     @IsISO8601()
-    validUntil?: string;
+    validUntil?: string | null;
 
     @Expose()
     @IsOptional()

package/src/loanOfferings/dtos/responses/ReleasePromotionResponse.ts

@@ -0,0 +1,11 @@
+/**
+ * Resultado de liberar el lugar de un crédito en una promoción. `released` en `false` no es error:
+ * es un reenvío del mismo crédito o un crédito que nunca se contó, y el contador no se movió.
+ */
+export interface ReleasePromotionResponse {
+    promotionId: string;
+    /** `true` si esta llamada bajó `creditsGenerated`. */
+    released: boolean;
+    /** Créditos generados después de la llamada. */
+    creditsGenerated: number;
+}

package/src/loanOfferings/index.ts

@@ -31,6 +31,11 @@ export * from './enums/SegmentationRecountStatusEnum';
 // Constantes
 export * from './constants/promotionSkuBatch';
 export * from './constants/promotionRetailerScope';
+export * from './constants/offeringsInputLimits';
+
+// Validadores
+export * from './validators/IsOptionalNonNull';
+export * from './validators/MaxJsonBytes';
 
 // Entity DTOs
 export * from './dtos/CreditPlan';
@@ -53,6 +58,7 @@ export * from './dtos/requests/CreatePromotionRequest';
 export * from './dtos/requests/UpdatePromotionRequest';
 export * from './dtos/requests/ChangePromotionStatusRequest';
 export * from './dtos/requests/ConsumePromotionRequest';
+export * from './dtos/requests/ReleasePromotionRequest';
 export * from './dtos/requests/ReservePromotionBonusRequest';
 export * from './dtos/requests/SettlePromotionBonusRequest';
 export * from './dtos/requests/CreateStorePolicyRequest';
@@ -85,6 +91,7 @@ export * from './dtos/responses/SimulationResultResponse';
 export * from './dtos/responses/PromotionResponse';
 export * from './dtos/responses/PromotionLogEntryResponse';
 export * from './dtos/responses/ConsumePromotionResponse';
+export * from './dtos/responses/ReleasePromotionResponse';
 export * from './dtos/responses/PromotionBonusResponse';
 export * from './dtos/responses/ReservePromotionBonusResponse';
 export * from './dtos/responses/PromotedSkusResponse';

package/src/loanOfferings/validators/IsOptionalNonNull.ts

@@ -0,0 +1,12 @@
+import { ValidateIf } from 'class-validator';
+
+/**
+ * Campo opcional de un PUT parcial que NO admite `null`: ausente deja el valor como está, y `null`
+ * corre los validadores del campo y falla con 400.
+ *
+ * `@IsOptional()` deja pasar `null`; en los PUT de offerings ese `null` se convierte en `$REMOVE` y
+ * revienta con 500 en los atributos requeridos (L-100). Los campos que sí se borran con `null`
+ * (alcances, fechas, descripción) siguen con `@IsOptional()`.
+ */
+export const IsOptionalNonNull = (): PropertyDecorator =>
+    ValidateIf((_object: object, value: unknown) => value !== undefined);

package/src/loanOfferings/validators/MaxJsonBytes.ts

@@ -0,0 +1,28 @@
+import { ValidateBy, ValidationOptions } from 'class-validator';
+
+/** Bytes UTF-8 del valor serializado en JSON; `undefined` si no se puede serializar. */
+export const jsonByteLength = (value: unknown): number | undefined => {
+    try {
+        const json = JSON.stringify(value);
+        return json === undefined ? undefined : new TextEncoder().encode(json).length;
+    } catch {
+        return undefined;
+    }
+};
+
+/** El valor, serializado en JSON, ocupa a lo más `maxBytes` bytes UTF-8. */
+export const MaxJsonBytes = (maxBytes: number, validationOptions?: ValidationOptions): PropertyDecorator =>
+    ValidateBy(
+        {
+            name: 'maxJsonBytes',
+            constraints: [maxBytes],
+            validator: {
+                validate: (value: unknown): boolean => {
+                    const bytes = jsonByteLength(value);
+                    return bytes !== undefined && bytes <= maxBytes;
+                },
+                defaultMessage: (): string => `$property no puede pasar de ${maxBytes} bytes serializado`,
+            },
+        },
+        validationOptions,
+    );

package/src/loanRetailAudit/constants/auditInputLimits.ts

@@ -0,0 +1,20 @@
+/**
+ * Topes de forma de la auditoría y del registro de accesos a PII (L-183). Son de cordura, no de
+ * tamaño total: el ítem de DynamoDB (400 KB) lo cuida la guardia de tamaño de loan-retail-audit.
+ * Los productores de hoy mandan a lo más 7 `changes`, 4 `context`, 10 `fields` y valores de ~40
+ * caracteres.
+ */
+export const AUDIT_TRAIL_CHANGES_MAX_ITEMS = 100;
+export const AUDIT_TRAIL_CONTEXT_MAX_ITEMS = 50;
+
+/** Nombre de un campo o clave de contexto. */
+export const AUDIT_FIELD_NAME_MAX_LENGTH = 128;
+
+/** Valor serializado de un cambio o de un dato de contexto (4 KB). */
+export const AUDIT_VALUE_MAX_LENGTH = 4096;
+
+/** Campos PII por acceso. */
+export const PII_ACCESS_FIELDS_MAX_ITEMS = 50;
+
+/** Un id de recurso en `resourceIds` (hoy ULID de 26 o `acc-` + 32 hex). */
+export const PII_RESOURCE_ID_MAX_LENGTH = 128;

package/src/loanRetailAudit/dtos/AuditTrailChange.ts

@@ -1,22 +1,26 @@
 import { Expose } from 'class-transformer';
-import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import { AUDIT_FIELD_NAME_MAX_LENGTH, AUDIT_VALUE_MAX_LENGTH } from '../constants/auditInputLimits';
 
 /** Un campo que cambió; los valores van serializados a string y nunca llevan PII. */
 export class AuditTrailChange {
     @Expose()
     @IsString()
     @IsNotEmpty()
+    @MaxLength(AUDIT_FIELD_NAME_MAX_LENGTH)
     field!: string;
 
     /** Ausente en un alta. */
     @Expose()
     @IsOptional()
     @IsString()
+    @MaxLength(AUDIT_VALUE_MAX_LENGTH)
     oldValue?: string;
 
     /** Ausente en una baja. */
     @Expose()
     @IsOptional()
     @IsString()
+    @MaxLength(AUDIT_VALUE_MAX_LENGTH)
     newValue?: string;
 }

package/src/loanRetailAudit/dtos/AuditTrailContextEntry.ts

@@ -1,14 +1,17 @@
 import { Expose } from 'class-transformer';
-import { IsNotEmpty, IsString } from 'class-validator';
+import { IsNotEmpty, IsString, MaxLength } from 'class-validator';
+import { AUDIT_FIELD_NAME_MAX_LENGTH, AUDIT_VALUE_MAX_LENGTH } from '../constants/auditInputLimits';
 
 /** Dato que la acción no cambió y se guarda para leer la entrada sin abrir otra pantalla. */
 export class AuditTrailContextEntry {
     @Expose()
     @IsString()
     @IsNotEmpty()
+    @MaxLength(AUDIT_FIELD_NAME_MAX_LENGTH)
     key!: string;
 
     @Expose()
     @IsString()
+    @MaxLength(AUDIT_VALUE_MAX_LENGTH)
     value!: string;
 }

package/src/loanRetailAudit/dtos/requests/CreatePiiAccessLogRequest.ts

@@ -1,5 +1,11 @@
 import { Expose } from 'class-transformer';
-import { ArrayNotEmpty, IsArray, IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { ArrayMaxSize, ArrayNotEmpty, IsArray, IsEnum, IsNotEmpty, IsOptional, IsString, MaxLength } from 'class-validator';
+import {
+    AUDIT_FIELD_NAME_MAX_LENGTH,
+    PII_ACCESS_FIELDS_MAX_ITEMS,
+    PII_RESOURCE_ID_MAX_LENGTH,
+} from '../../constants/auditInputLimits';
+import { IsIsoDateTime } from '../../validators/IsIsoDateTime';
 import { PiiAccessActionEnum } from '../../enums/PiiAccessActionEnum';
 import { PiiResourceTypeEnum } from '../../enums/PiiResourceTypeEnum';
 
@@ -11,8 +17,9 @@ export class CreatePiiAccessLogRequest {
     @IsNotEmpty()
     accessId!: string;
 
+    /** Fecha-hora ISO-8601 completa con zona, como `toISOString()`. */
     @Expose()
-    @IsISO8601()
+    @IsIsoDateTime()
     occurredAt!: string;
 
     @Expose()
@@ -49,16 +56,26 @@ export class CreatePiiAccessLogRequest {
     @IsNotEmpty()
     resourceId!: string;
 
-    /** Nombres de los campos PII que viajaron; nunca sus valores. */
+    /** Nombres de los campos PII que viajaron; nunca sus valores. Sin nombres vacíos. */
     @Expose()
     @IsArray()
     @ArrayNotEmpty()
+    @ArrayMaxSize(PII_ACCESS_FIELDS_MAX_ITEMS)
     @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    @MaxLength(AUDIT_FIELD_NAME_MAX_LENGTH, { each: true })
     fields!: string[];
 
+    /**
+     * Ids del listado, sin vacíos y de hasta 128 caracteres cada uno. Sin tope de cantidad todavía:
+     * `/backoffice/customers` de retail-wizard manda todos los clientes de la ventana (miles), y un
+     * rechazo tumba el listado. El tope llega con el fan-out por id del central (L-184).
+     */
     @Expose()
     @IsOptional()
     @IsArray()
     @IsString({ each: true })
+    @IsNotEmpty({ each: true })
+    @MaxLength(PII_RESOURCE_ID_MAX_LENGTH, { each: true })
     resourceIds?: string[];
 }

package/src/loanRetailAudit/events/AuditTrailRecordedV1.ts

@@ -1,5 +1,7 @@
 import { Expose, Type } from 'class-transformer';
-import { IsArray, IsIn, IsEnum, IsISO8601, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { ArrayMaxSize, IsArray, IsIn, IsEnum, IsNotEmpty, IsOptional, IsString, ValidateNested } from 'class-validator';
+import { AUDIT_TRAIL_CHANGES_MAX_ITEMS, AUDIT_TRAIL_CONTEXT_MAX_ITEMS } from '../constants/auditInputLimits';
+import { IsIsoDateTime } from '../validators/IsIsoDateTime';
 import { AUDIT_TRAIL_ENTITY_TYPES, AuditTrailEntityType } from '../constants/auditTrailEntityTypes';
 import { AuditTrailChange } from '../dtos/AuditTrailChange';
 import { AuditTrailContextEntry } from '../dtos/AuditTrailContextEntry';
@@ -27,12 +29,14 @@ export class AuditTrailRecordedV1 {
 
     @Expose()
     @IsArray()
+    @ArrayMaxSize(AUDIT_TRAIL_CHANGES_MAX_ITEMS)
     @ValidateNested({ each: true })
     @Type(() => AuditTrailChange)
     changes!: AuditTrailChange[];
 
     @Expose()
     @IsArray()
+    @ArrayMaxSize(AUDIT_TRAIL_CONTEXT_MAX_ITEMS)
     @ValidateNested({ each: true })
     @Type(() => AuditTrailContextEntry)
     context!: AuditTrailContextEntry[];
@@ -48,8 +52,9 @@ export class AuditTrailRecordedV1 {
     @IsNotEmpty()
     sourceLambda!: string;
 
+    /** Fecha-hora ISO-8601 completa con zona, como `toISOString()`. */
     @Expose()
-    @IsISO8601()
+    @IsIsoDateTime()
     occurredAt!: string;
 
     @Expose()

package/src/loanRetailAudit/index.ts

@@ -7,6 +7,10 @@ export * from './enums/PiiAccessActionEnum';
 
 // Constantes
 export * from './constants/auditTrailEntityTypes';
+export * from './constants/auditInputLimits';
+
+// Validadores
+export * from './validators/IsIsoDateTime';
 
 // DTOs
 export * from './dtos/AuditTrailChange';

package/src/loanRetailAudit/validators/IsIsoDateTime.ts

@@ -0,0 +1,33 @@
+import { isISO8601, ValidateBy, ValidationOptions } from 'class-validator';
+
+/** Fecha-hora completa: fecha, hora con segundos y zona (`Z` u offset). Como `toISOString()`. */
+const ISO_DATE_TIME_PATTERN = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d{1,9})?(Z|[+-]\d{2}:\d{2})$/;
+
+/**
+ * `true` si el valor es una fecha-hora ISO-8601 completa, con zona, que existe en el calendario y
+ * que `Date.parse` entiende.
+ */
+export const isIsoDateTime = (value: unknown): boolean =>
+    typeof value === 'string' &&
+    ISO_DATE_TIME_PATTERN.test(value) &&
+    isISO8601(value, { strict: true, strictSeparator: true }) &&
+    Number.isFinite(Date.parse(value));
+
+/**
+ * Fecha-hora ISO-8601 completa con zona (L-188).
+ *
+ * `@IsISO8601()` acepta `2026-W44-1`, `2026-305` o `2026`, que `new Date()` no entiende, y la fecha
+ * sin zona, que cada runtime lee distinto. El central calcula el vencimiento del registro con ella.
+ */
+export const IsIsoDateTime = (validationOptions?: ValidationOptions): PropertyDecorator =>
+    ValidateBy(
+        {
+            name: 'isIsoDateTime',
+            validator: {
+                validate: (value: unknown): boolean => isIsoDateTime(value),
+                defaultMessage: (): string =>
+                    '$property debe ser una fecha-hora ISO-8601 completa con zona (p. ej. 2026-11-03T10:00:00.000Z)',
+            },
+        },
+        validationOptions,
+    );

package/src/loanScoring/dtos/ScoringOffer.ts

@@ -3,16 +3,18 @@
  * Modelias la devuelve completa; el camino Círculo+SCI no produce oferta, el plan lo resuelve
  * loan-offerings por nivel).
  *
- * ⚠️ Los valores numéricos se transportan TAL CUAL los entrega el proveedor (el contrato Modelias
- * no confirma unidades de `linea_credito`/`enganche` — ver TD del módulo modelias). NO asumir cents.
+ * Se guarda TAL CUAL la entrega el proveedor, sin convertir unidades (decisión D-4 de la auditoría,
+ * L-181). Unidades observadas contra Modelias DEV (A9 de loan-scoring, `docs/F2/ASSUMPTIONS.md`):
+ * `linea_credito` 10000/7500/4000 y `enganche` 0.1/0.2/0.35. Quien la use para originar convierte
+ * a centavos y a porcentaje; no la sumes a montos en centavos.
  */
 export interface ScoringOffer {
-    /** Línea de crédito aprobada (unidad según proveedor). */
+    /** Línea de crédito aprobada, en PESOS MXN enteros (no centavos): `10000` = $10,000. */
     creditLine: number | null;
-    /** Enganche requerido (unidad/base según proveedor). */
+    /** Enganche requerido como FRACCIÓN del precio (no monto ni porcentaje): `0.2` = 20%. */
     downPayment: number | null;
-    /** Plazos ofrecidos, en semanas. */
+    /** Plazos ofrecidos, en semanas (Modelias usa múltiplos de 13). */
     termsWeeks: number[];
-    /** Tasas por plazo (clave = plazo, valor = tasa decimal). */
+    /** Tasas por plazo: clave = plazo en semanas, valor = tasa en decimal. */
     rates: Record<string, number>;
 }