@fiado/type-kit 3.369.0 → 3.370.0

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

@@ -0,0 +1,13 @@
+import { PromotionEffectKindEnum } from '../../loanOfferings/enums/PromotionEffectKindEnum';
+/**
+ * Promoción con la que se cotizó este crédito, congelada al originar y al re-cotizar. Los términos
+ * del crédito YA la incluyen: es el porqué de la cuota, no un extra a sumar.
+ */
+export interface AppliedPromotionSnapshot {
+    promotionId: string;
+    name: string;
+    /** Edición de la promoción al cotizar. Con `promotionId` + `version` la bitácora la reconstruye. */
+    version: number;
+    /** Palancas del plan que la promoción pisó. */
+    appliedEffects: PromotionEffectKindEnum[];
+}

package/bin/loanCredit/dtos/AppliedPromotionSnapshot.js

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

package/bin/loanCredit/dtos/responses/LoanCreditResponse.d.ts

@@ -1,5 +1,6 @@
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+import { AppliedPromotionSnapshot } from '../AppliedPromotionSnapshot';
 /**
  * Response de los endpoints de LoanCredit (loan-credit-business). Montos en cents; TNA decimal.
  */
@@ -28,6 +29,8 @@ export interface LoanCreditResponse {
     sciEvaluationId?: string;
     sciAtOrigination?: number;
     clientLevelAtOrigination?: ClientLevelEnum;
+    /** Promoción con la que se cotizó, o `null` si ninguna alcanzaba a esta venta. */
+    appliedPromotion?: AppliedPromotionSnapshot | null;
     activatedAt?: string;
     voluntaryCancelDeadline?: string;
     firstDueDate?: string;

package/bin/loanCredit/index.d.ts

@@ -8,6 +8,7 @@ export * from './dtos/LoanCredit';
 export * from './dtos/LoanInstallment';
 export * from './dtos/LoanContract';
 export * from './dtos/ActivationChecklist';
+export * from './dtos/AppliedPromotionSnapshot';
 export * from './dtos/requests/UpsertLoanBorrowerRequest';
 export * from './dtos/requests/OriginateLoanCreditRequest';
 export * from './dtos/requests/QuoteLoanCreditRequest';

package/bin/loanCredit/index.js

@@ -29,6 +29,7 @@ __exportStar(require("./dtos/LoanCredit"), exports);
 __exportStar(require("./dtos/LoanInstallment"), exports);
 __exportStar(require("./dtos/LoanContract"), exports);
 __exportStar(require("./dtos/ActivationChecklist"), exports);
+__exportStar(require("./dtos/AppliedPromotionSnapshot"), exports);
 // Request DTOs
 __exportStar(require("./dtos/requests/UpsertLoanBorrowerRequest"), exports);
 __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);

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

@@ -0,0 +1,7 @@
+/**
+ * Body de POST /private/promotions/:promotionId/consume — el crédito que acaba de activarse bajo
+ * esta promoción. `creditId` es la llave de idempotencia: reenviarlo NO vuelve a contar.
+ */
+export declare class ConsumePromotionRequest {
+    creditId: string;
+}

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

@@ -0,0 +1,26 @@
+"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.ConsumePromotionRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body de POST /private/promotions/:promotionId/consume — el crédito que acaba de activarse bajo
+ * esta promoción. `creditId` es la llave de idempotencia: reenviarlo NO vuelve a contar.
+ */
+class ConsumePromotionRequest {
+}
+exports.ConsumePromotionRequest = ConsumePromotionRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], ConsumePromotionRequest.prototype, "creditId", void 0);

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

@@ -0,0 +1,12 @@
+/**
+ * Resultado de registrar el consumo de una promoción. `alreadyCounted` en `true` es un reenvío del
+ * mismo crédito: no es error, y los contadores no se movieron.
+ */
+export interface ConsumePromotionResponse {
+    promotionId: string;
+    alreadyCounted: boolean;
+    creditsGenerated: number;
+    budgetConsumedCents: number;
+    /** `true` si este consumo alcanzó el tope y la promoción quedó en PAUSED. */
+    pausedByBudget: boolean;
+}

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

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

package/bin/loanOfferings/index.d.ts

@@ -24,9 +24,11 @@ export * from './dtos/requests/PromotionEffectInput';
 export * from './dtos/requests/CreatePromotionRequest';
 export * from './dtos/requests/UpdatePromotionRequest';
 export * from './dtos/requests/ChangePromotionStatusRequest';
+export * from './dtos/requests/ConsumePromotionRequest';
 export * from './dtos/responses/CreditPlanResponse';
 export * from './dtos/responses/FinancierResponse';
 export * from './dtos/responses/RetailerCreditPlanResponse';
 export * from './dtos/responses/SimulationResultResponse';
 export * from './dtos/responses/PromotionResponse';
 export * from './dtos/responses/PromotionLogEntryResponse';
+export * from './dtos/responses/ConsumePromotionResponse';

package/bin/loanOfferings/index.js

@@ -43,6 +43,7 @@ __exportStar(require("./dtos/requests/PromotionEffectInput"), exports);
 __exportStar(require("./dtos/requests/CreatePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/UpdatePromotionRequest"), exports);
 __exportStar(require("./dtos/requests/ChangePromotionStatusRequest"), exports);
+__exportStar(require("./dtos/requests/ConsumePromotionRequest"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/CreditPlanResponse"), exports);
 __exportStar(require("./dtos/responses/FinancierResponse"), exports);
@@ -50,3 +51,4 @@ __exportStar(require("./dtos/responses/RetailerCreditPlanResponse"), exports);
 __exportStar(require("./dtos/responses/SimulationResultResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionResponse"), exports);
 __exportStar(require("./dtos/responses/PromotionLogEntryResponse"), exports);
+__exportStar(require("./dtos/responses/ConsumePromotionResponse"), exports);

package/package.json

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

package/src/loanCredit/dtos/AppliedPromotionSnapshot.ts

@@ -0,0 +1,14 @@
+import { PromotionEffectKindEnum } from '../../loanOfferings/enums/PromotionEffectKindEnum';
+
+/**
+ * Promoción con la que se cotizó este crédito, congelada al originar y al re-cotizar. Los términos
+ * del crédito YA la incluyen: es el porqué de la cuota, no un extra a sumar.
+ */
+export interface AppliedPromotionSnapshot {
+    promotionId: string;
+    name: string;
+    /** Edición de la promoción al cotizar. Con `promotionId` + `version` la bitácora la reconstruye. */
+    version: number;
+    /** Palancas del plan que la promoción pisó. */
+    appliedEffects: PromotionEffectKindEnum[];
+}

package/src/loanCredit/dtos/responses/LoanCreditResponse.ts

@@ -1,5 +1,6 @@
 import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
 import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
+import { AppliedPromotionSnapshot } from '../AppliedPromotionSnapshot';
 
 /**
  * Response de los endpoints de LoanCredit (loan-credit-business). Montos en cents; TNA decimal.
@@ -29,6 +30,8 @@ export interface LoanCreditResponse {
     sciEvaluationId?: string;
     sciAtOrigination?: number;
     clientLevelAtOrigination?: ClientLevelEnum;
+    /** Promoción con la que se cotizó, o `null` si ninguna alcanzaba a esta venta. */
+    appliedPromotion?: AppliedPromotionSnapshot | null;
     activatedAt?: string;
     voluntaryCancelDeadline?: string;
     firstDueDate?: string;

package/src/loanCredit/index.ts

@@ -12,6 +12,7 @@ export * from './dtos/LoanCredit';
 export * from './dtos/LoanInstallment';
 export * from './dtos/LoanContract';
 export * from './dtos/ActivationChecklist';
+export * from './dtos/AppliedPromotionSnapshot';
 
 // Request DTOs
 export * from './dtos/requests/UpsertLoanBorrowerRequest';

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

@@ -0,0 +1,12 @@
+import { Expose } from 'class-transformer';
+import { IsString } from 'class-validator';
+
+/**
+ * Body de POST /private/promotions/:promotionId/consume — el crédito que acaba de activarse bajo
+ * esta promoción. `creditId` es la llave de idempotencia: reenviarlo NO vuelve a contar.
+ */
+export class ConsumePromotionRequest {
+    @Expose()
+    @IsString()
+    creditId!: string;
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Resultado de registrar el consumo de una promoción. `alreadyCounted` en `true` es un reenvío del
+ * mismo crédito: no es error, y los contadores no se movieron.
+ */
+export interface ConsumePromotionResponse {
+    promotionId: string;
+    alreadyCounted: boolean;
+    creditsGenerated: number;
+    budgetConsumedCents: number;
+    /** `true` si este consumo alcanzó el tope y la promoción quedó en PAUSED. */
+    pausedByBudget: boolean;
+}

package/src/loanOfferings/index.ts

@@ -29,6 +29,7 @@ export * from './dtos/requests/PromotionEffectInput';
 export * from './dtos/requests/CreatePromotionRequest';
 export * from './dtos/requests/UpdatePromotionRequest';
 export * from './dtos/requests/ChangePromotionStatusRequest';
+export * from './dtos/requests/ConsumePromotionRequest';
 
 // Response DTOs
 export * from './dtos/responses/CreditPlanResponse';
@@ -37,3 +38,4 @@ export * from './dtos/responses/RetailerCreditPlanResponse';
 export * from './dtos/responses/SimulationResultResponse';
 export * from './dtos/responses/PromotionResponse';
 export * from './dtos/responses/PromotionLogEntryResponse';
+export * from './dtos/responses/ConsumePromotionResponse';