@fiado/type-kit 3.429.0 → 3.431.0

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

@@ -0,0 +1,30 @@
+import { Expose } from 'class-transformer';
+import { IsInt, IsNumber, Max, Min } from 'class-validator';
+
+/** Body de `POST /private/amortization/schedule` (loan-offerings-business). Tabla francesa semanal sin fechas. */
+export class ComputeAmortizationScheduleRequest {
+    /** Saldo a amortizar en centavos. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    financedAmountCents!: number;
+
+    /** TNA en decimal (`2.30` = 230%). */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    tnaAnnual!: number;
+
+    /** Número de cuotas semanales. */
+    @Expose()
+    @IsInt()
+    @Min(1)
+    termWeeks!: number;
+
+    /** IVA sobre interés en decimal (`0.16`). */
+    @Expose()
+    @IsNumber()
+    @Min(0)
+    @Max(1)
+    ivaOnInterest!: number;
+}

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

@@ -0,0 +1,13 @@
+import { AmortizationScheduleRow } from './AmortizationScheduleRow';
+
+/** Response de `POST /private/amortization/schedule` (loan-offerings-business). */
+export interface AmortizationScheduleResponse {
+    /** Cuota sin IVA (capital + interés). */
+    weeklyPaymentExcludingIvaCents: number;
+    totalCapitalCents: number;
+    totalInterestCents: number;
+    totalIvaCents: number;
+    totalToPayCents: number;
+    /** La última cuota absorbe el redondeo y cierra en 0. */
+    schedule: AmortizationScheduleRow[];
+}

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

@@ -0,0 +1,10 @@
+/** Un renglón de la tabla recalculada. Montos en centavos. */
+export interface AmortizationScheduleRow {
+    /** Número de cuota, empieza en 1. */
+    week: number;
+    capitalCents: number;
+    interestCents: number;
+    ivaCents: number;
+    totalPaymentCents: number;
+    remainingBalanceCents: number;
+}

package/src/loanOfferings/index.ts

@@ -46,6 +46,7 @@ export * from './dtos/requests/CreateSegmentRequest';
 export * from './dtos/requests/UpdateSegmentRequest';
 export * from './dtos/requests/ChangeSegmentStatusRequest';
 export * from './dtos/requests/ResolveCustomerSegmentsRequest';
+export * from './dtos/requests/ComputeAmortizationScheduleRequest';
 
 // Response DTOs
 export * from './dtos/responses/CreditPlanResponse';
@@ -64,3 +65,5 @@ export * from './dtos/responses/StorePolicyResponse';
 export * from './dtos/responses/SegmentResponse';
 export * from './dtos/responses/SegmentFilterResponse';
 export * from './dtos/responses/ResolveCustomerSegmentsResponse';
+export * from './dtos/responses/AmortizationScheduleRow';
+export * from './dtos/responses/AmortizationScheduleResponse';

package/src/messagesConnector/dtos/SendMessageRequest.ts

@@ -1,6 +1,7 @@
 import { Expose } from 'class-transformer';
 import { IsEnum, IsNotEmpty, IsObject, IsOptional, IsString, IsUUID } from 'class-validator';
 import { DeliveryChannelEnum } from '../../messaging';
+import { OtpMessagePurposeEnum } from '../enums/OtpMessagePurposeEnum';
 
 export class SendMessageRequest {
     @Expose() @IsEnum(DeliveryChannelEnum) channelType!: DeliveryChannelEnum;
@@ -27,4 +28,5 @@ export class SendMessageRequest {
     @Expose() @IsOptional() @IsObject() options?: Record<string, unknown>;
     @Expose() @IsOptional() @IsUUID() referenceMessageId?: string;
     @Expose() @IsOptional() @IsString() transactionNumber?: string;
+    @Expose() @IsOptional() @IsEnum(OtpMessagePurposeEnum) purpose?: OtpMessagePurposeEnum;
 }

package/src/messagesConnector/dtos/VerifyOtpRequest.ts

@@ -1,5 +1,6 @@
 import { Expose } from 'class-transformer';
-import { IsNotEmpty, IsString } from 'class-validator';
+import { IsEnum, IsNotEmpty, IsOptional, IsString } from 'class-validator';
+import { OtpMessagePurposeEnum } from '../enums/OtpMessagePurposeEnum';
 
 export class VerifyOtpRequest {
     // directoryId NO se valida como @IsUUID: los cognitoSub de los pools backoffice son UUID v7
@@ -9,4 +10,5 @@ export class VerifyOtpRequest {
     @Expose() @IsString() @IsNotEmpty() directoryId!: string;
     @Expose() @IsString() @IsNotEmpty() typeOfDirectoryId!: string;
     @Expose() @IsString() @IsNotEmpty() message!: string;
+    @Expose() @IsOptional() @IsEnum(OtpMessagePurposeEnum) purpose?: OtpMessagePurposeEnum;
 }

package/src/messagesConnector/enums/OtpMessagePurposeEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Propósito del OTP en messages: sólo verifica y aparece como validado para ese mismo propósito; sin él aplica SIGNATURE.
+ * @enum {string}
+ */
+export enum OtpMessagePurposeEnum {
+    SIGNATURE = 'SIGNATURE',
+    RESTRUCTURE = 'RESTRUCTURE',
+    ADVANCE = 'ADVANCE',
+}

package/src/messagesConnector/index.ts

@@ -1,6 +1,7 @@
 export * from './enums/DeliveryChannelExtendedEnum';
 export * from './enums/NotificationOriginEnum';
 export * from './enums/MessagingSlotEnum';
+export * from './enums/OtpMessagePurposeEnum';
 export * from './validators/IsStringValueRecord';
 export * from './dtos/NotificationQueueMessageRequestV2';
 export * from './dtos/SendMessageRequest';

package/src/transactionProcessor/enums/CreditContractStatusEnum.ts

@@ -3,5 +3,12 @@ export enum CreditContractStatusEnum {
     COMPRADO = "COMPRADO",
     COBRADO = "COBRADO",
     SALDADO = "SALDADO",
-    ERROR = "ERROR"
+    ERROR = "ERROR",
+    /**
+     * Credito declarado incobrable (write-off backoffice).
+     * Aplica cuando el cobro no se logro y no hay posibilidad razonable de
+     * recuperar. Convencion: collectorAmountUSD = 0 y profit = -cvAmountUSD.
+     * El detalle vive en el campo writeOffInfo del CC.
+     */
+    INCOBRABLE = "INCOBRABLE"
 }