@fiado/type-kit 3.373.0 → 3.375.0

package/_test_/unit/loanOfferings/storePolicyRequests.test.ts

@@ -0,0 +1,117 @@
+import 'reflect-metadata';
+import { plainToInstance } from 'class-transformer';
+import { validate } from 'class-validator';
+import {
+  ChangeStorePolicyStatusRequest,
+  CreateStorePolicyRequest,
+  CreditPlanLevelEnum,
+  StorePolicyHardeningDto,
+  StorePolicyStatusEnum,
+  UpdateStorePolicyRequest,
+} from '../../../src/loanOfferings/index';
+
+/** El alta mínima válida: una política que endurece el piso de SCI. */
+const base = {
+  name: 'Freno de riesgo Norte',
+  hardening: { minSciScore: 70 },
+};
+
+type StorePolicyRequestClass =
+  | typeof CreateStorePolicyRequest
+  | typeof UpdateStorePolicyRequest
+  | typeof ChangeStorePolicyStatusRequest;
+
+const errorProperties = async (
+  raw: Record<string, unknown>,
+  dtoClass: StorePolicyRequestClass = CreateStorePolicyRequest,
+): Promise<string[]> => {
+  const instance = plainToInstance(dtoClass, raw, { excludeExtraneousValues: true });
+  return (await validate(instance as object)).map((error) => error.property);
+};
+
+describe('CreateStorePolicyRequest', () => {
+  it('valida con los obligatorios y tipa el grupo de endurecimiento', async () => {
+    const dto = plainToInstance(CreateStorePolicyRequest, base, { excludeExtraneousValues: true });
+    expect(await validate(dto as object)).toHaveLength(0);
+    expect(dto.hardening).toBeInstanceOf(StorePolicyHardeningDto);
+    expect(dto.hardening?.minSciScore).toBe(70);
+  });
+
+  it('conserva cada campo del alcance: sin @Expose() la exclusión los borraría', async () => {
+    const dto = plainToInstance(
+      CreateStorePolicyRequest,
+      {
+        ...base,
+        description: 'Sube el piso de score en las tiendas del norte',
+        easing: { tnaAnnual: 1.9 },
+        suspended: false,
+        allowedSkus: ['SKU-1'],
+        storeIds: ['ST-04'],
+        targetLevels: ['SILVER'],
+        targetSkus: ['SKU-1'],
+        validFrom: '2026-09-01',
+        validUntil: '2026-12-31',
+        reason: 'Cartera vencida por arriba del objetivo',
+      },
+      { excludeExtraneousValues: true },
+    );
+    expect(await validate(dto as object)).toHaveLength(0);
+    expect(dto.targetLevels).toEqual([CreditPlanLevelEnum.SILVER]);
+    expect(dto.easing?.tnaAnnual).toBe(1.9);
+    expect(dto.storeIds).toEqual(['ST-04']);
+    expect(dto.reason).toBe('Cartera vencida por arriba del objetivo');
+  });
+
+  it('exige el nombre', async () => {
+    expect(await errorProperties({ hardening: { minSciScore: 70 } })).toContain('name');
+  });
+
+  it('rechaza una palanca fuera de su cota', async () => {
+    expect(await errorProperties({ ...base, hardening: { minSciScore: 140 } })).toContain(
+      'hardening',
+    );
+    expect(await errorProperties({ ...base, easing: { minDownPaymentPct: 1.4 } })).toContain(
+      'easing',
+    );
+  });
+
+  it('rechaza una fecha que no es ISO 8601', async () => {
+    expect(await errorProperties({ ...base, validFrom: 'mañana' })).toContain('validFrom');
+  });
+
+  it('exige al menos un elemento en cada lista de alcance', async () => {
+    expect(await errorProperties({ ...base, storeIds: [] })).toContain('storeIds');
+    expect(await errorProperties({ ...base, targetLevels: [] })).toContain('targetLevels');
+  });
+});
+
+describe('UpdateStorePolicyRequest', () => {
+  it('el parche vacío es válido: no exige el nombre', async () => {
+    expect(await errorProperties({}, UpdateStorePolicyRequest)).toHaveLength(0);
+  });
+
+  it('sigue validando las palancas que sí vienen', async () => {
+    expect(
+      await errorProperties({ hardening: { tnaAnnualFloor: 9 } }, UpdateStorePolicyRequest),
+    ).toContain('hardening');
+  });
+});
+
+describe('ChangeStorePolicyStatusRequest', () => {
+  it('acepta un estado del enum con su motivo', async () => {
+    const dto = plainToInstance(
+      ChangeStorePolicyStatusRequest,
+      { status: 'PAUSED', reason: 'Revisión de riesgo' },
+      { excludeExtraneousValues: true },
+    );
+    expect(await validate(dto as object)).toHaveLength(0);
+    expect(dto.status).toBe(StorePolicyStatusEnum.PAUSED);
+    expect(dto.reason).toBe('Revisión de riesgo');
+  });
+
+  it('rechaza un estado que no existe', async () => {
+    expect(await errorProperties({ status: 'ARCHIVED' }, ChangeStorePolicyStatusRequest)).toContain(
+      'status',
+    );
+  });
+});

package/bin/collection/dtos/RegisterCollectibleResponse.d.ts

@@ -0,0 +1,9 @@
+import { RegisterCollectibleStatus } from '../enums/RegisterCollectibleStatus';
+/**
+ * Resultado de dar de alta un cargo cobrable. El `intentId` es la referencia con la que el motor
+ * sigue ese cargo, y es la misma tanto si el alta es nueva como si el cargo ya estaba registrado.
+ */
+export declare class RegisterCollectibleResponse {
+    status: RegisterCollectibleStatus;
+    intentId: string;
+}

package/bin/collection/dtos/RegisterCollectibleResponse.js

@@ -0,0 +1,29 @@
+"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.RegisterCollectibleResponse = void 0;
+const class_validator_1 = require("class-validator");
+const RegisterCollectibleStatus_1 = require("../enums/RegisterCollectibleStatus");
+/**
+ * Resultado de dar de alta un cargo cobrable. El `intentId` es la referencia con la que el motor
+ * sigue ese cargo, y es la misma tanto si el alta es nueva como si el cargo ya estaba registrado.
+ */
+class RegisterCollectibleResponse {
+}
+exports.RegisterCollectibleResponse = RegisterCollectibleResponse;
+__decorate([
+    (0, class_validator_1.IsEnum)(RegisterCollectibleStatus_1.RegisterCollectibleStatus),
+    __metadata("design:type", String)
+], RegisterCollectibleResponse.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], RegisterCollectibleResponse.prototype, "intentId", void 0);

package/bin/collection/enums/RegisterCollectibleStatus.d.ts

@@ -0,0 +1,6 @@
+export declare enum RegisterCollectibleStatus {
+    /** El cargo se indexó por primera vez y ya entra en los reintentos del motor. */
+    REGISTERED = "REGISTERED",
+    /** Ese cargo ya estaba dado de alta. Volver a registrarlo es un no-op. */
+    ALREADY_REGISTERED = "ALREADY_REGISTERED"
+}

package/bin/collection/enums/RegisterCollectibleStatus.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RegisterCollectibleStatus = void 0;
+var RegisterCollectibleStatus;
+(function (RegisterCollectibleStatus) {
+    /** El cargo se indexó por primera vez y ya entra en los reintentos del motor. */
+    RegisterCollectibleStatus["REGISTERED"] = "REGISTERED";
+    /** Ese cargo ya estaba dado de alta. Volver a registrarlo es un no-op. */
+    RegisterCollectibleStatus["ALREADY_REGISTERED"] = "ALREADY_REGISTERED";
+})(RegisterCollectibleStatus || (exports.RegisterCollectibleStatus = RegisterCollectibleStatus = {}));

package/bin/collection/index.d.ts

@@ -3,6 +3,7 @@ export * from './enums/CollectionState';
 export * from './enums/SagaStep';
 export * from './enums/CollectionResultStatus';
 export * from './enums/DeregisterChargeStatus';
+export * from './enums/RegisterCollectibleStatus';
 export * from './dtos/PendingChargeDto';
 export * from './dtos/CollectRequest';
 export * from './dtos/CollectResponse';
@@ -16,6 +17,7 @@ export * from './dtos/CollectionProductConfigDto';
 export * from './dtos/UpsertProductConfigRequest';
 export * from './dtos/ApplyCollectionResultRequest';
 export * from './dtos/DeregisterChargeResponse';
+export * from './dtos/RegisterCollectibleResponse';
 export * from './dtos/ResolvePendingChargesRequest';
 export * from './dtos/MoneyInEvent';
 export * from './dtos/CollectionIntentSummaryDto';

package/bin/collection/index.js

@@ -20,6 +20,7 @@ __exportStar(require("./enums/CollectionState"), exports);
 __exportStar(require("./enums/SagaStep"), exports);
 __exportStar(require("./enums/CollectionResultStatus"), exports);
 __exportStar(require("./enums/DeregisterChargeStatus"), exports);
+__exportStar(require("./enums/RegisterCollectibleStatus"), exports);
 // DTOs
 __exportStar(require("./dtos/PendingChargeDto"), exports);
 __exportStar(require("./dtos/CollectRequest"), exports);
@@ -34,6 +35,7 @@ __exportStar(require("./dtos/CollectionProductConfigDto"), exports);
 __exportStar(require("./dtos/UpsertProductConfigRequest"), exports);
 __exportStar(require("./dtos/ApplyCollectionResultRequest"), exports);
 __exportStar(require("./dtos/DeregisterChargeResponse"), exports);
+__exportStar(require("./dtos/RegisterCollectibleResponse"), exports);
 __exportStar(require("./dtos/ResolvePendingChargesRequest"), exports);
 __exportStar(require("./dtos/MoneyInEvent"), exports);
 // DTOs — backoffice de monitoreo

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

@@ -0,0 +1,10 @@
+import { StorePolicyStatusEnum } from '../../enums/StorePolicyStatusEnum';
+/**
+ * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar o vencer.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * `reason` acompaña el cambio y queda en la bitácora.
+ */
+export declare class ChangeStorePolicyStatusRequest {
+    status: StorePolicyStatusEnum;
+    reason?: string;
+}

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

@@ -0,0 +1,35 @@
+"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.ChangeStorePolicyStatusRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const StorePolicyStatusEnum_1 = require("../../enums/StorePolicyStatusEnum");
+/**
+ * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar o vencer.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * `reason` acompaña el cambio y queda en la bitácora.
+ */
+class ChangeStorePolicyStatusRequest {
+}
+exports.ChangeStorePolicyStatusRequest = ChangeStorePolicyStatusRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(StorePolicyStatusEnum_1.StorePolicyStatusEnum),
+    __metadata("design:type", String)
+], ChangeStorePolicyStatusRequest.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)(280),
+    __metadata("design:type", String)
+], ChangeStorePolicyStatusRequest.prototype, "reason", void 0);

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

@@ -0,0 +1,40 @@
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+/** Grupo de palancas que ENDURECEN las condiciones del plan. */
+export declare class StorePolicyHardeningDto {
+    /** Piso de SCI; es compuerta de elegibilidad, no término del crédito. */
+    minSciScore?: number;
+    minDownPaymentPct?: number;
+    /** Piso de TNA en decimal: la tasa no puede bajar de ahí. */
+    tnaAnnualFloor?: number;
+    maxFinancedAmountCents?: number;
+}
+/** Grupo de palancas que AFLOJAN las condiciones del plan. */
+export declare class StorePolicyEasingDto {
+    minDownPaymentPct?: number;
+    tnaAnnual?: number;
+    maxFinancedAmountCents?: number;
+}
+/**
+ * Body de POST /store-policies — alta de una política especial de tienda.
+ * Nace en `DRAFT`: el estado, `policyId`, `version` y la auditoría los asigna el lambda y NO viajan
+ * en el request. Que haya al menos una palanca o compuerta lo valida el lambda.
+ */
+export declare class CreateStorePolicyRequest {
+    name: string;
+    description?: string;
+    hardening?: StorePolicyHardeningDto;
+    easing?: StorePolicyEasingDto;
+    /** Compuerta que niega la venta en las tiendas alcanzadas. */
+    suspended?: boolean;
+    /** Compuerta: SKUs habilitados. Ausente = sin restricción. */
+    allowedSkus?: string[];
+    /** Alcance: tiendas alcanzadas. Ausente = toda la red. */
+    storeIds?: string[];
+    /** Alcance: niveles alcanzados. Ausente = todos los niveles. */
+    targetLevels?: CreditPlanLevelEnum[];
+    /** Alcance: SKUs alcanzados. Ausente = todos los productos. */
+    targetSkus?: string[];
+    validFrom?: string;
+    validUntil?: string;
+    reason?: string;
+}

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

@@ -0,0 +1,169 @@
+"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.CreateStorePolicyRequest = exports.StorePolicyEasingDto = exports.StorePolicyHardeningDto = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+/** Grupo de palancas que ENDURECEN las condiciones del plan. */
+class StorePolicyHardeningDto {
+}
+exports.StorePolicyHardeningDto = StorePolicyHardeningDto;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(100),
+    __metadata("design:type", Number)
+], StorePolicyHardeningDto.prototype, "minSciScore", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(1),
+    __metadata("design:type", Number)
+], StorePolicyHardeningDto.prototype, "minDownPaymentPct", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(5),
+    __metadata("design:type", Number)
+], StorePolicyHardeningDto.prototype, "tnaAnnualFloor", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StorePolicyHardeningDto.prototype, "maxFinancedAmountCents", void 0);
+/** Grupo de palancas que AFLOJAN las condiciones del plan. */
+class StorePolicyEasingDto {
+}
+exports.StorePolicyEasingDto = StorePolicyEasingDto;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(1),
+    __metadata("design:type", Number)
+], StorePolicyEasingDto.prototype, "minDownPaymentPct", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.Min)(0),
+    (0, class_validator_1.Max)(5),
+    __metadata("design:type", Number)
+], StorePolicyEasingDto.prototype, "tnaAnnual", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], StorePolicyEasingDto.prototype, "maxFinancedAmountCents", void 0);
+/**
+ * Body de POST /store-policies — alta de una política especial de tienda.
+ * Nace en `DRAFT`: el estado, `policyId`, `version` y la auditoría los asigna el lambda y NO viajan
+ * en el request. Que haya al menos una palanca o compuerta lo valida el lambda.
+ */
+class CreateStorePolicyRequest {
+}
+exports.CreateStorePolicyRequest = CreateStorePolicyRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], CreateStorePolicyRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], CreateStorePolicyRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => StorePolicyHardeningDto),
+    __metadata("design:type", StorePolicyHardeningDto)
+], CreateStorePolicyRequest.prototype, "hardening", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => StorePolicyEasingDto),
+    __metadata("design:type", StorePolicyEasingDto)
+], CreateStorePolicyRequest.prototype, "easing", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], CreateStorePolicyRequest.prototype, "suspended", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateStorePolicyRequest.prototype, "allowedSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateStorePolicyRequest.prototype, "storeIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum, { each: true }),
+    __metadata("design:type", Array)
+], CreateStorePolicyRequest.prototype, "targetLevels", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], CreateStorePolicyRequest.prototype, "targetSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], CreateStorePolicyRequest.prototype, "validFrom", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], CreateStorePolicyRequest.prototype, "validUntil", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(280),
+    __metadata("design:type", String)
+], CreateStorePolicyRequest.prototype, "reason", void 0);

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

@@ -0,0 +1,21 @@
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+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.
+ */
+export declare class UpdateStorePolicyRequest {
+    name?: string;
+    description?: string;
+    hardening?: StorePolicyHardeningDto;
+    easing?: StorePolicyEasingDto;
+    suspended?: boolean;
+    allowedSkus?: string[];
+    storeIds?: string[];
+    targetLevels?: CreditPlanLevelEnum[];
+    targetSkus?: string[];
+    validFrom?: string;
+    validUntil?: string;
+    reason?: string;
+}

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

@@ -0,0 +1,109 @@
+"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.UpdateStorePolicyRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const CreditPlanLevelEnum_1 = require("../../enums/CreditPlanLevelEnum");
+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.
+ */
+class UpdateStorePolicyRequest {
+}
+exports.UpdateStorePolicyRequest = UpdateStorePolicyRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], UpdateStorePolicyRequest.prototype, "name", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], UpdateStorePolicyRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (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, 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, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], UpdateStorePolicyRequest.prototype, "suspended", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdateStorePolicyRequest.prototype, "allowedSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdateStorePolicyRequest.prototype, "storeIds", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsEnum)(CreditPlanLevelEnum_1.CreditPlanLevelEnum, { each: true }),
+    __metadata("design:type", Array)
+], UpdateStorePolicyRequest.prototype, "targetLevels", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ArrayNotEmpty)(),
+    (0, class_validator_1.IsString)({ each: true }),
+    __metadata("design:type", Array)
+], UpdateStorePolicyRequest.prototype, "targetSkus", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], UpdateStorePolicyRequest.prototype, "validFrom", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsISO8601)(),
+    __metadata("design:type", String)
+], UpdateStorePolicyRequest.prototype, "validUntil", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(280),
+    __metadata("design:type", String)
+], UpdateStorePolicyRequest.prototype, "reason", void 0);

package/bin/loanOfferings/dtos/responses/SimulationResultResponse.d.ts

@@ -1,4 +1,5 @@
 import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
+import { PlanTermProvenance } from './StorePolicyResponse';
 /**
  * Un renglón de la tabla de amortización (M2 §3.3). Todos los montos en cents.
  */
@@ -59,4 +60,9 @@ export interface SimulationResultResponse {
      * incluyen: es el porqué de la cuota, no un extra a sumar.
      */
     appliedPromotion: AppliedPromotionResponse | null;
+    /**
+     * Qué capas tocaron cada término y en qué orden. Va vacío (`{}`) si ninguna política especial
+     * alcanzó la venta, y ausente si el lambda todavía no lo emite.
+     */
+    provenance?: PlanTermProvenance;
 }

package/bin/loanOfferings/dtos/responses/StorePolicyResponse.d.ts

@@ -0,0 +1,58 @@
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { StorePolicyPhaseEnum } from '../../enums/StorePolicyPhaseEnum';
+import { StorePolicyStatusEnum } from '../../enums/StorePolicyStatusEnum';
+/** Capas que pueden tocar un término del plan, en el orden en que se pliegan. */
+export type PlanTermLayer = 'PLAN' | 'EASING' | 'PROMOTION' | 'HARDENING';
+/**
+ * Cadena de capas que tocaron cada término, no una capa única: una palanca puede registrarse como
+ * aplicada y quedar pisada después. Va vacío (`{}`) si ninguna política alcanzó la venta.
+ */
+export type PlanTermProvenance = Record<string, PlanTermLayer[]>;
+/** Palancas que ENDURECEN. Se pliegan con `max` sobre pisos y `min` sobre techos. */
+export interface StorePolicyHardening {
+    /** Piso de SCI. Es COMPUERTA de elegibilidad, no término del crédito. */
+    minSciScore?: number;
+    minDownPaymentPct?: number;
+    /** Piso de TNA: la tasa no puede bajar de ahí. */
+    tnaAnnualFloor?: number;
+    maxFinancedAmountCents?: number;
+}
+/** Palancas que AFLOJAN. Solo aplican si mejoran contra el PLAN CRUDO. */
+export interface StorePolicyEasing {
+    minDownPaymentPct?: number;
+    tnaAnnual?: number;
+    maxFinancedAmountCents?: number;
+}
+/**
+ * Shape de salida de una política especial (GET / POST / PUT de /store-policies).
+ * Montos en cents; porcentajes y TNA en decimal. `phase` es DERIVADO y no vive en la tabla.
+ */
+export interface StorePolicyResponse {
+    policyId: string;
+    name: string;
+    description: string | null;
+    status: StorePolicyStatusEnum;
+    /** Derivada de las fechas contra hoy; `null` cuando el estado no es `PUBLISHED`. */
+    phase: StorePolicyPhaseEnum | null;
+    hardening: StorePolicyHardening;
+    easing: StorePolicyEasing;
+    /** COMPUERTA: niega la venta. */
+    suspended: boolean;
+    /** COMPUERTA: `null` = sin restricción. Distinto de `targetSkus`, que es ALCANCE. */
+    allowedSkus: string[] | null;
+    /** ALCANCE. `null` = toda la red. */
+    storeIds: string[] | null;
+    /** ALCANCE. `null` = todos los niveles. */
+    targetLevels: CreditPlanLevelEnum[] | null;
+    /** ALCANCE. `null` = todos los SKUs. */
+    targetSkus: string[] | null;
+    validFrom: string | null;
+    validUntil: string | null;
+    reason: string | null;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+    publishedAt: string | null;
+}

package/bin/loanOfferings/dtos/responses/StorePolicyResponse.js

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

package/bin/loanOfferings/enums/StorePolicyPhaseEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Fase de vigencia de una política especial PUBLICADA, derivada de `validFrom`/`validUntil` contra
+ * hoy. No se persiste — así no hace falta un cron que mueva estados a medianoche. `null` cuando el
+ * estado persistido no es `PUBLISHED`.
+ * @enum {string}
+ */
+export declare enum StorePolicyPhaseEnum {
+    SCHEDULED = "SCHEDULED",
+    ACTIVE = "ACTIVE",
+    EXPIRED = "EXPIRED"
+}

package/bin/loanOfferings/enums/StorePolicyPhaseEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorePolicyPhaseEnum = void 0;
+/**
+ * Fase de vigencia de una política especial PUBLICADA, derivada de `validFrom`/`validUntil` contra
+ * hoy. No se persiste — así no hace falta un cron que mueva estados a medianoche. `null` cuando el
+ * estado persistido no es `PUBLISHED`.
+ * @enum {string}
+ */
+var StorePolicyPhaseEnum;
+(function (StorePolicyPhaseEnum) {
+    StorePolicyPhaseEnum["SCHEDULED"] = "SCHEDULED";
+    StorePolicyPhaseEnum["ACTIVE"] = "ACTIVE";
+    StorePolicyPhaseEnum["EXPIRED"] = "EXPIRED";
+})(StorePolicyPhaseEnum || (exports.StorePolicyPhaseEnum = StorePolicyPhaseEnum = {}));

package/bin/loanOfferings/enums/StorePolicyStatusEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` es terminal. La fase que ve el
+ * operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
+ * @enum {string}
+ */
+export declare enum StorePolicyStatusEnum {
+    DRAFT = "DRAFT",
+    PUBLISHED = "PUBLISHED",
+    PAUSED = "PAUSED",
+    EXPIRED = "EXPIRED"
+}

package/bin/loanOfferings/enums/StorePolicyStatusEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorePolicyStatusEnum = void 0;
+/**
+ * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` es terminal. La fase que ve el
+ * operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
+ * @enum {string}
+ */
+var StorePolicyStatusEnum;
+(function (StorePolicyStatusEnum) {
+    StorePolicyStatusEnum["DRAFT"] = "DRAFT";
+    StorePolicyStatusEnum["PUBLISHED"] = "PUBLISHED";
+    StorePolicyStatusEnum["PAUSED"] = "PAUSED";
+    StorePolicyStatusEnum["EXPIRED"] = "EXPIRED";
+})(StorePolicyStatusEnum || (exports.StorePolicyStatusEnum = StorePolicyStatusEnum = {}));

package/bin/loanOfferings/index.d.ts

@@ -8,6 +8,8 @@ export * from './enums/PromotionStatusEnum';
 export * from './enums/PromotionEffectKindEnum';
 export * from './enums/PromotionPhaseEnum';
 export * from './enums/PromotionLogEventEnum';
+export * from './enums/StorePolicyStatusEnum';
+export * from './enums/StorePolicyPhaseEnum';
 export * from './dtos/CreditPlan';
 export * from './dtos/Financier';
 export * from './dtos/RetailerCreditPlan';
@@ -25,6 +27,9 @@ export * from './dtos/requests/CreatePromotionRequest';
 export * from './dtos/requests/UpdatePromotionRequest';
 export * from './dtos/requests/ChangePromotionStatusRequest';
 export * from './dtos/requests/ConsumePromotionRequest';
+export * from './dtos/requests/CreateStorePolicyRequest';
+export * from './dtos/requests/UpdateStorePolicyRequest';
+export * from './dtos/requests/ChangeStorePolicyStatusRequest';
 export * from './dtos/responses/CreditPlanResponse';
 export * from './dtos/responses/FinancierResponse';
 export * from './dtos/responses/RetailerCreditPlanResponse';
@@ -32,3 +37,4 @@ export * from './dtos/responses/SimulationResultResponse';
 export * from './dtos/responses/PromotionResponse';
 export * from './dtos/responses/PromotionLogEntryResponse';
 export * from './dtos/responses/ConsumePromotionResponse';
+export * from './dtos/responses/StorePolicyResponse';

package/bin/loanOfferings/index.js

@@ -25,6 +25,8 @@ __exportStar(require("./enums/PromotionStatusEnum"), exports);
 __exportStar(require("./enums/PromotionEffectKindEnum"), exports);
 __exportStar(require("./enums/PromotionPhaseEnum"), exports);
 __exportStar(require("./enums/PromotionLogEventEnum"), exports);
+__exportStar(require("./enums/StorePolicyStatusEnum"), exports);
+__exportStar(require("./enums/StorePolicyPhaseEnum"), exports);
 // Entity DTOs
 __exportStar(require("./dtos/CreditPlan"), exports);
 __exportStar(require("./dtos/Financier"), exports);
@@ -44,6 +46,9 @@ __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/CreateStorePolicyRequest"), exports);
+__exportStar(require("./dtos/requests/UpdateStorePolicyRequest"), exports);
+__exportStar(require("./dtos/requests/ChangeStorePolicyStatusRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/CreditPlanResponse"), exports);
 __exportStar(require("./dtos/responses/FinancierResponse"), exports);
@@ -52,3 +57,4 @@ __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/StorePolicyResponse"), exports);

package/package.json

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

package/src/collection/dtos/RegisterCollectibleResponse.ts

@@ -0,0 +1,12 @@
+import { IsEnum, IsString } from 'class-validator';
+import { RegisterCollectibleStatus } from '../enums/RegisterCollectibleStatus';
+
+/**
+ * Resultado de dar de alta un cargo cobrable. El `intentId` es la referencia con la que el motor
+ * sigue ese cargo, y es la misma tanto si el alta es nueva como si el cargo ya estaba registrado.
+ */
+export class RegisterCollectibleResponse {
+  @IsEnum(RegisterCollectibleStatus) status!: RegisterCollectibleStatus;
+
+  @IsString() intentId!: string;
+}

package/src/collection/enums/RegisterCollectibleStatus.ts

@@ -0,0 +1,6 @@
+export enum RegisterCollectibleStatus {
+  /** El cargo se indexó por primera vez y ya entra en los reintentos del motor. */
+  REGISTERED = 'REGISTERED',
+  /** Ese cargo ya estaba dado de alta. Volver a registrarlo es un no-op. */
+  ALREADY_REGISTERED = 'ALREADY_REGISTERED',
+}

package/src/collection/index.ts

@@ -4,6 +4,7 @@ export * from './enums/CollectionState';
 export * from './enums/SagaStep';
 export * from './enums/CollectionResultStatus';
 export * from './enums/DeregisterChargeStatus';
+export * from './enums/RegisterCollectibleStatus';
 
 // DTOs
 export * from './dtos/PendingChargeDto';
@@ -19,6 +20,7 @@ export * from './dtos/CollectionProductConfigDto';
 export * from './dtos/UpsertProductConfigRequest';
 export * from './dtos/ApplyCollectionResultRequest';
 export * from './dtos/DeregisterChargeResponse';
+export * from './dtos/RegisterCollectibleResponse';
 export * from './dtos/ResolvePendingChargesRequest';
 export * from './dtos/MoneyInEvent';
 

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

@@ -0,0 +1,20 @@
+import { Expose } from 'class-transformer';
+import { IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { StorePolicyStatusEnum } from '../../enums/StorePolicyStatusEnum';
+
+/**
+ * Body de PUT /store-policies/:policyId/status — publicar, pausar, reanudar o vencer.
+ * Transiciones válidas: `DRAFT→PUBLISHED`, `PUBLISHED⇄PAUSED`, `PUBLISHED|PAUSED→EXPIRED`.
+ * `reason` acompaña el cambio y queda en la bitácora.
+ */
+export class ChangeStorePolicyStatusRequest {
+    @Expose()
+    @IsEnum(StorePolicyStatusEnum)
+    status!: StorePolicyStatusEnum;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(280)
+    reason?: string;
+}

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

@@ -0,0 +1,156 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsInt,
+    IsISO8601,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Max,
+    MaxLength,
+    Min,
+    ValidateNested,
+} from 'class-validator';
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+
+/** Grupo de palancas que ENDURECEN las condiciones del plan. */
+export class StorePolicyHardeningDto {
+    /** Piso de SCI; es compuerta de elegibilidad, no término del crédito. */
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    @Max(100)
+    minSciScore?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    minDownPaymentPct?: number;
+
+    /** Piso de TNA en decimal: la tasa no puede bajar de ahí. */
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    @Max(5)
+    tnaAnnualFloor?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    maxFinancedAmountCents?: number;
+}
+
+/** Grupo de palancas que AFLOJAN las condiciones del plan. */
+export class StorePolicyEasingDto {
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    minDownPaymentPct?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    @Max(5)
+    tnaAnnual?: number;
+
+    @Expose()
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    maxFinancedAmountCents?: number;
+}
+
+/**
+ * Body de POST /store-policies — alta de una política especial de tienda.
+ * Nace en `DRAFT`: el estado, `policyId`, `version` y la auditoría los asigna el lambda y NO viajan
+ * en el request. Que haya al menos una palanca o compuerta lo valida el lambda.
+ */
+export class CreateStorePolicyRequest {
+    @Expose()
+    @IsString()
+    @MaxLength(120)
+    name!: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => StorePolicyHardeningDto)
+    hardening?: StorePolicyHardeningDto;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => StorePolicyEasingDto)
+    easing?: StorePolicyEasingDto;
+
+    /** Compuerta que niega la venta en las tiendas alcanzadas. */
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    suspended?: boolean;
+
+    /** Compuerta: SKUs habilitados. Ausente = sin restricción. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    allowedSkus?: string[];
+
+    /** Alcance: tiendas alcanzadas. Ausente = toda la red. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    storeIds?: string[];
+
+    /** Alcance: niveles alcanzados. Ausente = todos los niveles. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(CreditPlanLevelEnum, { each: true })
+    targetLevels?: CreditPlanLevelEnum[];
+
+    /** Alcance: SKUs alcanzados. Ausente = todos los productos. */
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    targetSkus?: string[];
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validFrom?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validUntil?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(280)
+    reason?: string;
+}

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

@@ -0,0 +1,94 @@
+import { Expose, Type } from 'class-transformer';
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsISO8601,
+    IsOptional,
+    IsString,
+    MaxLength,
+    ValidateNested,
+} from 'class-validator';
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+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.
+ */
+export class UpdateStorePolicyRequest {
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(120)
+    name?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    description?: string;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => StorePolicyHardeningDto)
+    hardening?: StorePolicyHardeningDto;
+
+    @Expose()
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => StorePolicyEasingDto)
+    easing?: StorePolicyEasingDto;
+
+    @Expose()
+    @IsOptional()
+    @IsBoolean()
+    suspended?: boolean;
+
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    allowedSkus?: string[];
+
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    storeIds?: string[];
+
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(CreditPlanLevelEnum, { each: true })
+    targetLevels?: CreditPlanLevelEnum[];
+
+    @Expose()
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    targetSkus?: string[];
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validFrom?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsISO8601()
+    validUntil?: string;
+
+    @Expose()
+    @IsOptional()
+    @IsString()
+    @MaxLength(280)
+    reason?: string;
+}

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

@@ -1,4 +1,5 @@
 import { PromotionEffectKindEnum } from '../../enums/PromotionEffectKindEnum';
+import { PlanTermProvenance } from './StorePolicyResponse';
 
 /**
  * Un renglón de la tabla de amortización (M2 §3.3). Todos los montos en cents.
@@ -62,4 +63,9 @@ export interface SimulationResultResponse {
      * incluyen: es el porqué de la cuota, no un extra a sumar.
      */
     appliedPromotion: AppliedPromotionResponse | null;
+    /**
+     * Qué capas tocaron cada término y en qué orden. Va vacío (`{}`) si ninguna política especial
+     * alcanzó la venta, y ausente si el lambda todavía no lo emite.
+     */
+    provenance?: PlanTermProvenance;
 }

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

@@ -0,0 +1,63 @@
+import { CreditPlanLevelEnum } from '../../enums/CreditPlanLevelEnum';
+import { StorePolicyPhaseEnum } from '../../enums/StorePolicyPhaseEnum';
+import { StorePolicyStatusEnum } from '../../enums/StorePolicyStatusEnum';
+
+/** Capas que pueden tocar un término del plan, en el orden en que se pliegan. */
+export type PlanTermLayer = 'PLAN' | 'EASING' | 'PROMOTION' | 'HARDENING';
+
+/**
+ * Cadena de capas que tocaron cada término, no una capa única: una palanca puede registrarse como
+ * aplicada y quedar pisada después. Va vacío (`{}`) si ninguna política alcanzó la venta.
+ */
+export type PlanTermProvenance = Record<string, PlanTermLayer[]>;
+
+/** Palancas que ENDURECEN. Se pliegan con `max` sobre pisos y `min` sobre techos. */
+export interface StorePolicyHardening {
+    /** Piso de SCI. Es COMPUERTA de elegibilidad, no término del crédito. */
+    minSciScore?: number;
+    minDownPaymentPct?: number;
+    /** Piso de TNA: la tasa no puede bajar de ahí. */
+    tnaAnnualFloor?: number;
+    maxFinancedAmountCents?: number;
+}
+
+/** Palancas que AFLOJAN. Solo aplican si mejoran contra el PLAN CRUDO. */
+export interface StorePolicyEasing {
+    minDownPaymentPct?: number;
+    tnaAnnual?: number;
+    maxFinancedAmountCents?: number;
+}
+
+/**
+ * Shape de salida de una política especial (GET / POST / PUT de /store-policies).
+ * Montos en cents; porcentajes y TNA en decimal. `phase` es DERIVADO y no vive en la tabla.
+ */
+export interface StorePolicyResponse {
+    policyId: string;
+    name: string;
+    description: string | null;
+    status: StorePolicyStatusEnum;
+    /** Derivada de las fechas contra hoy; `null` cuando el estado no es `PUBLISHED`. */
+    phase: StorePolicyPhaseEnum | null;
+    hardening: StorePolicyHardening;
+    easing: StorePolicyEasing;
+    /** COMPUERTA: niega la venta. */
+    suspended: boolean;
+    /** COMPUERTA: `null` = sin restricción. Distinto de `targetSkus`, que es ALCANCE. */
+    allowedSkus: string[] | null;
+    /** ALCANCE. `null` = toda la red. */
+    storeIds: string[] | null;
+    /** ALCANCE. `null` = todos los niveles. */
+    targetLevels: CreditPlanLevelEnum[] | null;
+    /** ALCANCE. `null` = todos los SKUs. */
+    targetSkus: string[] | null;
+    validFrom: string | null;
+    validUntil: string | null;
+    reason: string | null;
+    version: number;
+    createdAt: string;
+    updatedAt: string;
+    createdBy: string;
+    updatedBy: string;
+    publishedAt: string | null;
+}

package/src/loanOfferings/enums/StorePolicyPhaseEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Fase de vigencia de una política especial PUBLICADA, derivada de `validFrom`/`validUntil` contra
+ * hoy. No se persiste — así no hace falta un cron que mueva estados a medianoche. `null` cuando el
+ * estado persistido no es `PUBLISHED`.
+ * @enum {string}
+ */
+export enum StorePolicyPhaseEnum {
+    SCHEDULED = 'SCHEDULED',
+    ACTIVE = 'ACTIVE',
+    EXPIRED = 'EXPIRED',
+}

package/src/loanOfferings/enums/StorePolicyStatusEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Estado PERSISTIDO de una política especial de tienda. `EXPIRED` es terminal. La fase que ve el
+ * operador NO se guarda: se deriva de las fechas — ver `StorePolicyPhaseEnum`.
+ * @enum {string}
+ */
+export enum StorePolicyStatusEnum {
+    DRAFT = 'DRAFT',
+    PUBLISHED = 'PUBLISHED',
+    PAUSED = 'PAUSED',
+    EXPIRED = 'EXPIRED',
+}

package/src/loanOfferings/index.ts

@@ -9,6 +9,8 @@ export * from './enums/PromotionStatusEnum';
 export * from './enums/PromotionEffectKindEnum';
 export * from './enums/PromotionPhaseEnum';
 export * from './enums/PromotionLogEventEnum';
+export * from './enums/StorePolicyStatusEnum';
+export * from './enums/StorePolicyPhaseEnum';
 
 // Entity DTOs
 export * from './dtos/CreditPlan';
@@ -30,6 +32,9 @@ export * from './dtos/requests/CreatePromotionRequest';
 export * from './dtos/requests/UpdatePromotionRequest';
 export * from './dtos/requests/ChangePromotionStatusRequest';
 export * from './dtos/requests/ConsumePromotionRequest';
+export * from './dtos/requests/CreateStorePolicyRequest';
+export * from './dtos/requests/UpdateStorePolicyRequest';
+export * from './dtos/requests/ChangeStorePolicyStatusRequest';
 
 // Response DTOs
 export * from './dtos/responses/CreditPlanResponse';
@@ -39,3 +44,4 @@ export * from './dtos/responses/SimulationResultResponse';
 export * from './dtos/responses/PromotionResponse';
 export * from './dtos/responses/PromotionLogEntryResponse';
 export * from './dtos/responses/ConsumePromotionResponse';
+export * from './dtos/responses/StorePolicyResponse';