@fiado/type-kit 3.627.0 → 3.629.0

package/bin/loanOfferings/dtos/requests/UpdateFinancierRequest.d.ts

@@ -2,11 +2,17 @@ import { ProductTierEnum } from '../../enums/ProductTierEnum';
 /**
  * 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 declare class UpdateFinancierRequest {
     name?: string;
     label?: string;
+    /** URL https a la que se redirige al cliente; `null` = sin redirección. */
     externalRedirectUrl?: string | null;
     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.
+     */
     config?: Record<string, unknown> | null;
 }

package/bin/loanOfferings/dtos/requests/UpdateFinancierRequest.js

@@ -12,30 +12,40 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateFinancierRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const offeringsInputLimits_1 = require("../../constants/offeringsInputLimits");
 const ProductTierEnum_1 = require("../../enums/ProductTierEnum");
+const IsOptionalNonNull_1 = require("../../validators/IsOptionalNonNull");
+const MaxJsonBytes_1 = require("../../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.
  */
 class UpdateFinancierRequest {
 }
 exports.UpdateFinancierRequest = UpdateFinancierRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(offeringsInputLimits_1.OFFERINGS_NAME_MAX_LENGTH),
     __metadata("design:type", String)
 ], UpdateFinancierRequest.prototype, "name", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(offeringsInputLimits_1.OFFERINGS_LABEL_MAX_LENGTH),
     __metadata("design:type", String)
 ], UpdateFinancierRequest.prototype, "label", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(offeringsInputLimits_1.FINANCIER_REDIRECT_URL_MAX_LENGTH),
+    (0, class_validator_1.IsUrl)({ protocols: ['https'], require_protocol: true }),
     __metadata("design:type", String)
 ], UpdateFinancierRequest.prototype, "externalRedirectUrl", void 0);
 __decorate([
@@ -49,5 +59,6 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsObject)(),
+    (0, MaxJsonBytes_1.MaxJsonBytes)(offeringsInputLimits_1.FINANCIER_CONFIG_MAX_BYTES),
     __metadata("design:type", Object)
 ], UpdateFinancierRequest.prototype, "config", void 0);

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.d.ts

@@ -6,6 +6,9 @@ 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 declare class UpdatePromotionRequest {
     name?: string;
@@ -13,6 +16,7 @@ export declare class UpdatePromotionRequest {
     effect?: PromotionEffectInput;
     segmentId?: string;
     targetLevels?: CreditPlanLevelEnum[];
+    /** SKUs alcanzados; `null` = todos los productos. Hasta 2 000. */
     productSkus?: string[] | null;
     /** Tipos de producto alcanzados; ausente o `null` = todos los tipos. */
     productCategories?: ProductCategoryEnum[] | null;
@@ -20,9 +24,11 @@ export declare class UpdatePromotionRequest {
     tiers?: ProductTierEnum[] | null;
     /** Cadenas alcanzadas; ausente, `null` o vacío = todas las cadenas. */
     retailerIds?: string[] | null;
-    /** Tiendas alcanzadas. `null` o ausente = todas. */
+    /** Tiendas alcanzadas. `null` o ausente = todas. Hasta 1 000. */
     storeIds?: string[] | null;
     validFrom?: string | null;
     validUntil?: string | null;
     budgetMaxCents?: number | null;
+    /** Motivo del cambio; queda en la bitácora de la promoción. */
+    reason?: string;
 }

package/bin/loanOfferings/dtos/requests/UpdatePromotionRequest.js

@@ -12,47 +12,56 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdatePromotionRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const offeringsInputLimits_1 = require("../../constants/offeringsInputLimits");
 const promotionRetailerScope_1 = require("../../constants/promotionRetailerScope");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
 const ProductCategoryEnum_1 = require("../../../retailCatalog/enums/ProductCategoryEnum");
 const ProductTierEnum_1 = require("../../../retailCatalog/enums/ProductTierEnum");
+const IsOptionalNonNull_1 = require("../../validators/IsOptionalNonNull");
 const PromotionEffectInput_1 = require("./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.
  */
 class UpdatePromotionRequest {
 }
 exports.UpdatePromotionRequest = UpdatePromotionRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(offeringsInputLimits_1.OFFERINGS_NAME_MAX_LENGTH),
     __metadata("design:type", String)
 ], UpdatePromotionRequest.prototype, "name", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(offeringsInputLimits_1.OFFERINGS_DESCRIPTION_MAX_LENGTH),
     __metadata("design:type", String)
 ], UpdatePromotionRequest.prototype, "description", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => PromotionEffectInput_1.PromotionEffectInput),
     __metadata("design:type", PromotionEffectInput_1.PromotionEffectInput)
 ], UpdatePromotionRequest.prototype, "effect", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], UpdatePromotionRequest.prototype, "segmentId", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayNotEmpty)(),
     (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum, { each: true }),
@@ -62,7 +71,9 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(offeringsInputLimits_1.PROMOTION_PRODUCT_SKUS_MAX_ITEMS),
     (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
     __metadata("design:type", Array)
 ], UpdatePromotionRequest.prototype, "productSkus", void 0);
 __decorate([
@@ -92,7 +103,9 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(offeringsInputLimits_1.SCOPE_STORE_IDS_MAX_ITEMS),
     (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
     __metadata("design:type", Array)
 ], UpdatePromotionRequest.prototype, "storeIds", void 0);
 __decorate([
@@ -113,3 +126,10 @@ __decorate([
     (0, class_validator_1.IsInt)(),
     __metadata("design:type", Number)
 ], UpdatePromotionRequest.prototype, "budgetMaxCents", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(offeringsInputLimits_1.OFFERINGS_AUDIT_REASON_MAX_LENGTH),
+    __metadata("design:type", String)
+], UpdatePromotionRequest.prototype, "reason", void 0);

package/bin/loanOfferings/dtos/requests/UpdateSegmentRequest.d.ts

@@ -5,16 +5,19 @@ 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 declare class UpdateSegmentRequest {
     name?: string;
-    description?: string;
+    description?: string | null;
     colorSlot?: SegmentColorSlotEnum;
     /** Reemplaza la lista entera; `[]` deja el segmento sin cohorts. */
     cohortIds?: string[];
     /** @deprecated Usar `cohortIds`; se conserva para los consumidores que aún no migran. */
     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. */
     memberIds?: string[];
     reason?: string;
 }

package/bin/loanOfferings/dtos/requests/UpdateSegmentRequest.js

@@ -12,20 +12,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateSegmentRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const offeringsInputLimits_1 = require("../../constants/offeringsInputLimits");
 const SegmentColorSlotEnum_1 = require("../../enums/SegmentColorSlotEnum");
+const IsOptionalNonNull_1 = require("../../validators/IsOptionalNonNull");
 /**
  * Body de PUT /segments/:segmentId — edición parcial (todos los campos opcionales). Sube `version`.
  * El cambio de estado va por su endpoint dedicado.
  *
  * 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.
  */
 class UpdateSegmentRequest {
 }
 exports.UpdateSegmentRequest = UpdateSegmentRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.MaxLength)(120),
     __metadata("design:type", String)
@@ -39,13 +44,13 @@ __decorate([
 ], UpdateSegmentRequest.prototype, "description", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsEnum)(SegmentColorSlotEnum_1.SegmentColorSlotEnum),
     __metadata("design:type", String)
 ], UpdateSegmentRequest.prototype, "colorSlot", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.IsString)({ each: true }),
     (0, class_validator_1.IsNotEmpty)({ each: true }),
@@ -54,16 +59,18 @@ __decorate([
 ], UpdateSegmentRequest.prototype, "cohortIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.IsString)({ each: true }),
     __metadata("design:type", Array)
 ], UpdateSegmentRequest.prototype, "filterIds", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayMaxSize)(offeringsInputLimits_1.SEGMENT_MEMBER_IDS_MAX_ITEMS),
     (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
     __metadata("design:type", Array)
 ], UpdateSegmentRequest.prototype, "memberIds", void 0);
 __decorate([

package/bin/loanOfferings/dtos/requests/UpdateStorePolicyRequest.d.ts

@@ -4,20 +4,29 @@ import { StorePolicyEasingDto, StorePolicyHardeningDto } from './CreateStorePoli
  * 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 declare class UpdateStorePolicyRequest {
     name?: string;
-    description?: string;
+    description?: string | null;
     hardening?: StorePolicyHardeningDto;
     easing?: StorePolicyEasingDto;
     suspended?: boolean;
-    allowedSkus?: string[];
-    storeIds?: string[];
-    targetLevels?: CreditPlanLevelEnum[];
-    /** Alcance: segmentos alcanzados. */
-    segmentIds?: string[];
-    targetSkus?: string[];
-    validFrom?: string;
-    validUntil?: string;
+    /** Compuerta: SKUs habilitados; `null` = sin restricción. */
+    allowedSkus?: string[] | null;
+    /** Alcance: tiendas; `null` = toda la red. Hasta 1 000. */
+    storeIds?: string[] | null;
+    /** Alcance: niveles; `null` = todos. */
+    targetLevels?: CreditPlanLevelEnum[] | null;
+    /** Alcance: segmentos alcanzados; `null` = todos. */
+    segmentIds?: string[] | null;
+    /** Alcance: SKUs; `null` = todos los productos. */
+    targetSkus?: string[] | null;
+    validFrom?: string | null;
+    /** `null` = permanente. */
+    validUntil?: string | null;
     reason?: string;
 }

package/bin/loanOfferings/dtos/requests/UpdateStorePolicyRequest.js

@@ -12,19 +12,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateStorePolicyRequest = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const offeringsInputLimits_1 = require("../../constants/offeringsInputLimits");
 const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+const IsOptionalNonNull_1 = require("../../validators/IsOptionalNonNull");
 const CreateStorePolicyRequest_1 = require("./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.
  */
 class UpdateStorePolicyRequest {
 }
 exports.UpdateStorePolicyRequest = UpdateStorePolicyRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.MaxLength)(120),
     __metadata("design:type", String)
@@ -38,21 +44,21 @@ __decorate([
 ], UpdateStorePolicyRequest.prototype, "description", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => CreateStorePolicyRequest_1.StorePolicyHardeningDto),
     __metadata("design:type", CreateStorePolicyRequest_1.StorePolicyHardeningDto)
 ], UpdateStorePolicyRequest.prototype, "hardening", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.ValidateNested)(),
     (0, class_transformer_1.Type)(() => CreateStorePolicyRequest_1.StorePolicyEasingDto),
     __metadata("design:type", CreateStorePolicyRequest_1.StorePolicyEasingDto)
 ], UpdateStorePolicyRequest.prototype, "easing", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
+    (0, IsOptionalNonNull_1.IsOptionalNonNull)(),
     (0, class_validator_1.IsBoolean)(),
     __metadata("design:type", Boolean)
 ], UpdateStorePolicyRequest.prototype, "suspended", void 0);
@@ -69,7 +75,9 @@ __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsArray)(),
     (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.ArrayMaxSize)(offeringsInputLimits_1.SCOPE_STORE_IDS_MAX_ITEMS),
     (0, class_validator_1.IsString)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)({ each: true }),
     __metadata("design:type", Array)
 ], UpdateStorePolicyRequest.prototype, "storeIds", void 0);
 __decorate([

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

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

package/bin/loanOfferings/index.d.ts

@@ -28,6 +28,9 @@ export * from './enums/SegmentationRecountTriggerEnum';
 export * from './enums/SegmentationRecountStatusEnum';
 export * from './constants/promotionSkuBatch';
 export * from './constants/promotionRetailerScope';
+export * from './constants/offeringsInputLimits';
+export * from './validators/IsOptionalNonNull';
+export * from './validators/MaxJsonBytes';
 export * from './dtos/CreditPlan';
 export * from './dtos/PrepaymentMinimum';
 export * from './dtos/Financier';
@@ -46,6 +49,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';
@@ -76,6 +80,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/bin/loanOfferings/index.js

@@ -46,6 +46,10 @@ __exportStar(require("./enums/SegmentationRecountStatusEnum"), exports);
 // Constantes
 __exportStar(require("./constants/promotionSkuBatch"), exports);
 __exportStar(require("./constants/promotionRetailerScope"), exports);
+__exportStar(require("./constants/offeringsInputLimits"), exports);
+// Validadores
+__exportStar(require("./validators/IsOptionalNonNull"), exports);
+__exportStar(require("./validators/MaxJsonBytes"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
 __exportStar(require("./dtos/PrepaymentMinimum"), exports);
@@ -66,6 +70,7 @@ __exportStar(require("./dtos/requests/CreatePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/UpdatePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/ChangePromotionStatusRequest"), exports);
 __exportStar(require("./dtos/requests/ConsumePromotionRequest"), exports);
+__exportStar(require("./dtos/requests/ReleasePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/ReservePromotionBonusRequest"), exports);
 __exportStar(require("./dtos/requests/SettlePromotionBonusRequest"), exports);
 __exportStar(require("./dtos/requests/CreateStorePolicyRequest"), exports);
@@ -97,6 +102,7 @@ __exportStar(require("./dtos/responses/SimulationResultResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionLogEntryResponse"), exports);
 __exportStar(require("./dtos/responses/ConsumePromotionResponse"), exports);
+__exportStar(require("./dtos/responses/ReleasePromotionResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionBonusResponse"), exports);
 __exportStar(require("./dtos/responses/ReservePromotionBonusResponse"), exports);
 __exportStar(require("./dtos/responses/PromotedSkusResponse"), exports);

package/bin/loanOfferings/validators/IsOptionalNonNull.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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 declare const IsOptionalNonNull: () => PropertyDecorator;

package/bin/loanOfferings/validators/IsOptionalNonNull.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsOptionalNonNull = void 0;
+const class_validator_1 = require("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()`.
+ */
+const IsOptionalNonNull = () => (0, class_validator_1.ValidateIf)((_object, value) => value !== undefined);
+exports.IsOptionalNonNull = IsOptionalNonNull;

package/bin/loanOfferings/validators/MaxJsonBytes.d.ts

@@ -0,0 +1,5 @@
+import { ValidationOptions } from 'class-validator';
+/** Bytes UTF-8 del valor serializado en JSON; `undefined` si no se puede serializar. */
+export declare const jsonByteLength: (value: unknown) => number | undefined;
+/** El valor, serializado en JSON, ocupa a lo más `maxBytes` bytes UTF-8. */
+export declare const MaxJsonBytes: (maxBytes: number, validationOptions?: ValidationOptions) => PropertyDecorator;

package/bin/loanOfferings/validators/MaxJsonBytes.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaxJsonBytes = exports.jsonByteLength = void 0;
+const class_validator_1 = require("class-validator");
+/** Bytes UTF-8 del valor serializado en JSON; `undefined` si no se puede serializar. */
+const jsonByteLength = (value) => {
+    try {
+        const json = JSON.stringify(value);
+        return json === undefined ? undefined : new TextEncoder().encode(json).length;
+    }
+    catch {
+        return undefined;
+    }
+};
+exports.jsonByteLength = jsonByteLength;
+/** El valor, serializado en JSON, ocupa a lo más `maxBytes` bytes UTF-8. */
+const MaxJsonBytes = (maxBytes, validationOptions) => (0, class_validator_1.ValidateBy)({
+    name: 'maxJsonBytes',
+    constraints: [maxBytes],
+    validator: {
+        validate: (value) => {
+            const bytes = (0, exports.jsonByteLength)(value);
+            return bytes !== undefined && bytes <= maxBytes;
+        },
+        defaultMessage: () => `$property no puede pasar de ${maxBytes} bytes serializado`,
+    },
+}, validationOptions);
+exports.MaxJsonBytes = MaxJsonBytes;

package/bin/loanRetailAudit/constants/auditInputLimits.d.ts

@@ -0,0 +1,16 @@
+/**
+ * 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 declare const AUDIT_TRAIL_CHANGES_MAX_ITEMS = 100;
+export declare const AUDIT_TRAIL_CONTEXT_MAX_ITEMS = 50;
+/** Nombre de un campo o clave de contexto. */
+export declare const AUDIT_FIELD_NAME_MAX_LENGTH = 128;
+/** Valor serializado de un cambio o de un dato de contexto (4 KB). */
+export declare const AUDIT_VALUE_MAX_LENGTH = 4096;
+/** Campos PII por acceso. */
+export declare const PII_ACCESS_FIELDS_MAX_ITEMS = 50;
+/** Un id de recurso en `resourceIds` (hoy ULID de 26 o `acc-` + 32 hex). */
+export declare const PII_RESOURCE_ID_MAX_LENGTH = 128;

package/bin/loanRetailAudit/constants/auditInputLimits.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PII_RESOURCE_ID_MAX_LENGTH = exports.PII_ACCESS_FIELDS_MAX_ITEMS = exports.AUDIT_VALUE_MAX_LENGTH = exports.AUDIT_FIELD_NAME_MAX_LENGTH = exports.AUDIT_TRAIL_CONTEXT_MAX_ITEMS = exports.AUDIT_TRAIL_CHANGES_MAX_ITEMS = void 0;
+/**
+ * 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.
+ */
+exports.AUDIT_TRAIL_CHANGES_MAX_ITEMS = 100;
+exports.AUDIT_TRAIL_CONTEXT_MAX_ITEMS = 50;
+/** Nombre de un campo o clave de contexto. */
+exports.AUDIT_FIELD_NAME_MAX_LENGTH = 128;
+/** Valor serializado de un cambio o de un dato de contexto (4 KB). */
+exports.AUDIT_VALUE_MAX_LENGTH = 4096;
+/** Campos PII por acceso. */
+exports.PII_ACCESS_FIELDS_MAX_ITEMS = 50;
+/** Un id de recurso en `resourceIds` (hoy ULID de 26 o `acc-` + 32 hex). */
+exports.PII_RESOURCE_ID_MAX_LENGTH = 128;

package/bin/loanRetailAudit/dtos/AuditTrailChange.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuditTrailChange = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const auditInputLimits_1 = require("../constants/auditInputLimits");
 /** Un campo que cambió; los valores van serializados a string y nunca llevan PII. */
 class AuditTrailChange {
 }
@@ -20,17 +21,20 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(auditInputLimits_1.AUDIT_FIELD_NAME_MAX_LENGTH),
     __metadata("design:type", String)
 ], AuditTrailChange.prototype, "field", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(auditInputLimits_1.AUDIT_VALUE_MAX_LENGTH),
     __metadata("design:type", String)
 ], AuditTrailChange.prototype, "oldValue", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(auditInputLimits_1.AUDIT_VALUE_MAX_LENGTH),
     __metadata("design:type", String)
 ], AuditTrailChange.prototype, "newValue", void 0);

package/bin/loanRetailAudit/dtos/AuditTrailContextEntry.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AuditTrailContextEntry = void 0;
 const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
+const auditInputLimits_1 = require("../constants/auditInputLimits");
 /** Dato que la acción no cambió y se guarda para leer la entrada sin abrir otra pantalla. */
 class AuditTrailContextEntry {
 }
@@ -20,10 +21,12 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(auditInputLimits_1.AUDIT_FIELD_NAME_MAX_LENGTH),
     __metadata("design:type", String)
 ], AuditTrailContextEntry.prototype, "key", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(auditInputLimits_1.AUDIT_VALUE_MAX_LENGTH),
     __metadata("design:type", String)
 ], AuditTrailContextEntry.prototype, "value", void 0);

package/bin/loanRetailAudit/dtos/requests/CreatePiiAccessLogRequest.d.ts

@@ -4,6 +4,7 @@ import { PiiResourceTypeEnum } from '../../enums/PiiResourceTypeEnum';
 export declare class CreatePiiAccessLogRequest {
     /** ULID generado por quien llama; con `occurredAt` forma el sk, así un reintento no duplica. */
     accessId: string;
+    /** Fecha-hora ISO-8601 completa con zona, como `toISOString()`. */
     occurredAt: string;
     correlationId: string;
     actorId: string;
@@ -13,7 +14,12 @@ export declare class CreatePiiAccessLogRequest {
     resourceType: PiiResourceTypeEnum;
     /** Id del recurso, o `(list)` en un listado con los ids en `resourceIds`. */
     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. */
     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).
+     */
     resourceIds?: string[];
 }