@fiado/type-kit 3.198.0 → 3.199.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (68) hide show
  1. package/bin/loanCredit/dtos/LoanBorrower.d.ts +1 -1
  2. package/bin/loanCredit/dtos/LoanBorrower.js +1 -1
  3. package/bin/loanCredit/dtos/LoanContract.d.ts +27 -0
  4. package/bin/loanCredit/dtos/LoanContract.js +91 -0
  5. package/bin/loanCredit/dtos/LoanCredit.d.ts +5 -1
  6. package/bin/loanCredit/dtos/LoanCredit.js +14 -1
  7. package/bin/loanCredit/dtos/requests/ActivationCheckRequest.d.ts +21 -0
  8. package/bin/loanCredit/dtos/requests/ActivationCheckRequest.js +52 -0
  9. package/bin/loanCredit/dtos/requests/OriginateLoanCreditRequest.d.ts +12 -9
  10. package/bin/loanCredit/dtos/requests/OriginateLoanCreditRequest.js +14 -13
  11. package/bin/loanCredit/dtos/requests/QuoteLoanCreditRequest.d.ts +11 -0
  12. package/bin/loanCredit/dtos/requests/QuoteLoanCreditRequest.js +39 -0
  13. package/bin/loanCredit/dtos/requests/SignLoanCreditRequest.d.ts +17 -0
  14. package/bin/loanCredit/dtos/requests/SignLoanCreditRequest.js +37 -0
  15. package/bin/loanCredit/dtos/requests/UpsertLoanBorrowerRequest.d.ts +1 -1
  16. package/bin/loanCredit/dtos/requests/UpsertLoanBorrowerRequest.js +1 -1
  17. package/bin/loanCredit/dtos/responses/ActivationCheckResponse.d.ts +10 -0
  18. package/bin/loanCredit/dtos/responses/ActivationCheckResponse.js +2 -0
  19. package/bin/loanCredit/dtos/responses/LoanBorrowerResponse.d.ts +1 -1
  20. package/bin/loanCredit/dtos/responses/LoanContractResponse.d.ts +16 -0
  21. package/bin/loanCredit/dtos/responses/LoanContractResponse.js +2 -0
  22. package/bin/loanCredit/dtos/responses/LoanCreditResponse.d.ts +1 -1
  23. package/bin/loanCredit/dtos/responses/OriginateLoanCreditResponse.d.ts +5 -2
  24. package/bin/loanCredit/dtos/responses/QuoteLoanCreditResponse.d.ts +10 -0
  25. package/bin/loanCredit/dtos/responses/QuoteLoanCreditResponse.js +2 -0
  26. package/bin/loanCredit/dtos/responses/SignLoanCreditResponse.d.ts +20 -0
  27. package/bin/loanCredit/dtos/responses/SignLoanCreditResponse.js +2 -0
  28. package/bin/loanCredit/enums/ContractTypeEnum.d.ts +12 -0
  29. package/bin/loanCredit/enums/ContractTypeEnum.js +16 -0
  30. package/bin/loanCredit/enums/LoanInstallmentStatusEnum.d.ts +5 -2
  31. package/bin/loanCredit/enums/LoanInstallmentStatusEnum.js +5 -2
  32. package/bin/loanCredit/index.d.ts +10 -2
  33. package/bin/loanCredit/index.js +13 -2
  34. package/package.json +1 -1
  35. package/src/loanCredit/dtos/LoanBorrower.ts +1 -1
  36. package/src/loanCredit/dtos/LoanContract.ts +70 -0
  37. package/src/loanCredit/dtos/LoanCredit.ts +14 -1
  38. package/src/loanCredit/dtos/requests/ActivationCheckRequest.ts +39 -0
  39. package/src/loanCredit/dtos/requests/OriginateLoanCreditRequest.ts +16 -15
  40. package/src/loanCredit/dtos/requests/QuoteLoanCreditRequest.ts +24 -0
  41. package/src/loanCredit/dtos/requests/SignLoanCreditRequest.ts +24 -0
  42. package/src/loanCredit/dtos/requests/UpsertLoanBorrowerRequest.ts +1 -1
  43. package/src/loanCredit/dtos/responses/ActivationCheckResponse.ts +11 -0
  44. package/src/loanCredit/dtos/responses/LoanBorrowerResponse.ts +1 -1
  45. package/src/loanCredit/dtos/responses/LoanContractResponse.ts +17 -0
  46. package/src/loanCredit/dtos/responses/LoanCreditResponse.ts +1 -1
  47. package/src/loanCredit/dtos/responses/OriginateLoanCreditResponse.ts +5 -2
  48. package/src/loanCredit/dtos/responses/QuoteLoanCreditResponse.ts +11 -0
  49. package/src/loanCredit/dtos/responses/SignLoanCreditResponse.ts +21 -0
  50. package/src/loanCredit/enums/ContractTypeEnum.ts +12 -0
  51. package/src/loanCredit/enums/LoanInstallmentStatusEnum.ts +5 -2
  52. package/src/loanCredit/index.ts +11 -2
  53. package/bin/benefitCenter/enums/BenefitFlowEnum.d.ts +0 -11
  54. package/bin/benefitCenter/enums/BenefitFlowEnum.js +0 -15
  55. package/bin/walletFunding/dtos/CancelFundingReferenceRequest.d.ts +0 -6
  56. package/bin/walletFunding/dtos/CancelFundingReferenceRequest.js +0 -31
  57. package/bin/walletFunding/dtos/CancelFundingReferenceResponse.d.ts +0 -7
  58. package/bin/walletFunding/dtos/CancelFundingReferenceResponse.js +0 -6
  59. package/bin/walletFunding/dtos/CancelFundingRequest.d.ts +0 -11
  60. package/bin/walletFunding/dtos/CancelFundingRequest.js +0 -33
  61. package/bin/walletFunding/dtos/CancelFundingResponse.d.ts +0 -14
  62. package/bin/walletFunding/dtos/CancelFundingResponse.js +0 -12
  63. package/bin/walletFunding/dtos/CancelWalletFundingRequest.d.ts +0 -3
  64. package/bin/walletFunding/dtos/CancelWalletFundingRequest.js +0 -21
  65. package/bin/walletFunding/dtos/CancelWalletFundingResponse.d.ts +0 -7
  66. package/bin/walletFunding/dtos/CancelWalletFundingResponse.js +0 -6
  67. package/src/loanCredit/dtos/requests/UpdateActivationChecklistRequest.ts +0 -29
  68. package/src/loanCredit/enums/ClientLevelEnum.ts +0 -11
@@ -2,14 +2,17 @@
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.LoanInstallmentStatusEnum = void 0;
4
4
  /**
5
- * Estado de una cuota semanal del crédito (M2 §6.1 / 05_MOTOR §5).
6
- * `RESTRUCTURED` (reestructurado) = la cuota dejó de aplicar por reestructura o cancelación.
5
+ * Estado de una cuota semanal del crédito (M2 §6.1: pendiente · pagado · pagado_adelantado ·
6
+ * vencido · reestructurado). `PAID_IN_ADVANCE` = pago adelantado (cubre cuota futura tal cual,
7
+ * sin recalcular tabla — M2 §3.7). `RESTRUCTURED` = la cuota dejó de aplicar por
8
+ * reestructura o cancelación.
7
9
  * @enum {string}
8
10
  */
9
11
  var LoanInstallmentStatusEnum;
10
12
  (function (LoanInstallmentStatusEnum) {
11
13
  LoanInstallmentStatusEnum["PENDING"] = "PENDING";
12
14
  LoanInstallmentStatusEnum["PAID"] = "PAID";
15
+ LoanInstallmentStatusEnum["PAID_IN_ADVANCE"] = "PAID_IN_ADVANCE";
13
16
  LoanInstallmentStatusEnum["OVERDUE"] = "OVERDUE";
14
17
  LoanInstallmentStatusEnum["RESTRUCTURED"] = "RESTRUCTURED";
15
18
  })(LoanInstallmentStatusEnum || (exports.LoanInstallmentStatusEnum = LoanInstallmentStatusEnum = {}));
@@ -1,16 +1,24 @@
1
1
  export * from './enums/LoanCreditStatusEnum';
2
2
  export * from './enums/LoanInstallmentStatusEnum';
3
- export * from './enums/ClientLevelEnum';
3
+ export * from './enums/ContractTypeEnum';
4
+ export { ClientLevelEnum } from '../loanScoring/enums/ClientLevelEnum';
4
5
  export * from './dtos/LoanBorrower';
5
6
  export * from './dtos/LoanBeneficiary';
6
7
  export * from './dtos/LoanCredit';
7
8
  export * from './dtos/LoanInstallment';
9
+ export * from './dtos/LoanContract';
8
10
  export * from './dtos/ActivationChecklist';
9
11
  export * from './dtos/requests/UpsertLoanBorrowerRequest';
10
12
  export * from './dtos/requests/OriginateLoanCreditRequest';
11
- export * from './dtos/requests/UpdateActivationChecklistRequest';
13
+ export * from './dtos/requests/QuoteLoanCreditRequest';
14
+ export * from './dtos/requests/SignLoanCreditRequest';
15
+ export * from './dtos/requests/ActivationCheckRequest';
12
16
  export * from './dtos/requests/ChangeLoanCreditStatusRequest';
13
17
  export * from './dtos/responses/LoanBorrowerResponse';
14
18
  export * from './dtos/responses/LoanCreditResponse';
15
19
  export * from './dtos/responses/LoanInstallmentResponse';
20
+ export * from './dtos/responses/LoanContractResponse';
16
21
  export * from './dtos/responses/OriginateLoanCreditResponse';
22
+ export * from './dtos/responses/QuoteLoanCreditResponse';
23
+ export * from './dtos/responses/SignLoanCreditResponse';
24
+ export * from './dtos/responses/ActivationCheckResponse';
@@ -14,23 +14,34 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
14
14
  for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
15
15
  };
16
16
  Object.defineProperty(exports, "__esModule", { value: true });
17
+ exports.ClientLevelEnum = void 0;
17
18
  // Enums
18
19
  __exportStar(require("./enums/LoanCreditStatusEnum"), exports);
19
20
  __exportStar(require("./enums/LoanInstallmentStatusEnum"), exports);
20
- __exportStar(require("./enums/ClientLevelEnum"), exports);
21
+ __exportStar(require("./enums/ContractTypeEnum"), exports);
22
+ // Re-export del enum canónico de nivel (owner: loanScoring — un solo origen de verdad).
23
+ var ClientLevelEnum_1 = require("../loanScoring/enums/ClientLevelEnum");
24
+ Object.defineProperty(exports, "ClientLevelEnum", { enumerable: true, get: function () { return ClientLevelEnum_1.ClientLevelEnum; } });
21
25
  // Entity DTOs
22
26
  __exportStar(require("./dtos/LoanBorrower"), exports);
23
27
  __exportStar(require("./dtos/LoanBeneficiary"), exports);
24
28
  __exportStar(require("./dtos/LoanCredit"), exports);
25
29
  __exportStar(require("./dtos/LoanInstallment"), exports);
30
+ __exportStar(require("./dtos/LoanContract"), exports);
26
31
  __exportStar(require("./dtos/ActivationChecklist"), exports);
27
32
  // Request DTOs
28
33
  __exportStar(require("./dtos/requests/UpsertLoanBorrowerRequest"), exports);
29
34
  __exportStar(require("./dtos/requests/OriginateLoanCreditRequest"), exports);
30
- __exportStar(require("./dtos/requests/UpdateActivationChecklistRequest"), exports);
35
+ __exportStar(require("./dtos/requests/QuoteLoanCreditRequest"), exports);
36
+ __exportStar(require("./dtos/requests/SignLoanCreditRequest"), exports);
37
+ __exportStar(require("./dtos/requests/ActivationCheckRequest"), exports);
31
38
  __exportStar(require("./dtos/requests/ChangeLoanCreditStatusRequest"), exports);
32
39
  // Response DTOs
33
40
  __exportStar(require("./dtos/responses/LoanBorrowerResponse"), exports);
34
41
  __exportStar(require("./dtos/responses/LoanCreditResponse"), exports);
35
42
  __exportStar(require("./dtos/responses/LoanInstallmentResponse"), exports);
43
+ __exportStar(require("./dtos/responses/LoanContractResponse"), exports);
36
44
  __exportStar(require("./dtos/responses/OriginateLoanCreditResponse"), exports);
45
+ __exportStar(require("./dtos/responses/QuoteLoanCreditResponse"), exports);
46
+ __exportStar(require("./dtos/responses/SignLoanCreditResponse"), exports);
47
+ __exportStar(require("./dtos/responses/ActivationCheckResponse"), exports);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@fiado/type-kit",
3
- "version": "3.198.0",
3
+ "version": "3.199.0",
4
4
  "description": "",
5
5
  "main": "bin/index.js",
6
6
  "types": "bin/index.d.ts",
@@ -10,7 +10,7 @@ import {
10
10
  ValidateNested,
11
11
  } from 'class-validator';
12
12
  import { regexIso8601 } from '../../helpers/constans/regex';
13
- import { ClientLevelEnum } from '../enums/ClientLevelEnum';
13
+ import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
14
14
  import { LoanBeneficiary } from './LoanBeneficiary';
15
15
 
16
16
  /**
@@ -0,0 +1,70 @@
1
+ import { Expose } from 'class-transformer';
2
+ import { IsBoolean, IsEnum, IsOptional, IsString, Matches } from 'class-validator';
3
+ import { regexIso8601 } from '../../helpers/constans/regex';
4
+ import { ContractTypeEnum } from '../enums/ContractTypeEnum';
5
+
6
+ /**
7
+ * LoanContract — documento del contrato de crédito con firma FES (modelo-datos §5b ·
8
+ * `<T>LoanContract_GT` · M2 §4.3-§4.4). Un registro por documento (3 por crédito — C4).
9
+ *
10
+ * Nace DRAFT en la originación (sin PDF); la firma FES genera el PDF, calcula su `sha256`,
11
+ * verifica el OTP y sella con NOM-151. Conservación documental: 10 años (NOM-151).
12
+ * `signedAt` ausente = draft sin firmar.
13
+ */
14
+ export class LoanContract {
15
+ @Expose()
16
+ @IsString()
17
+ contractId!: string;
18
+
19
+ @Expose()
20
+ @IsString()
21
+ creditId!: string;
22
+
23
+ @Expose()
24
+ @IsEnum(ContractTypeEnum)
25
+ type!: ContractTypeEnum;
26
+
27
+ /** Key del PDF en el bucket del tenant (`loan-{tenant}-{env}`). Ausente hasta generar (AS-09). */
28
+ @Expose()
29
+ @IsOptional()
30
+ @IsString()
31
+ pdfS3Key?: string;
32
+
33
+ /** Hash SHA-256 del PDF firmado (trazabilidad FES — M2 §4.4). Ausente hasta generar. */
34
+ @Expose()
35
+ @IsOptional()
36
+ @IsString()
37
+ sha256?: string;
38
+
39
+ /** El OTP de firma fue verificado (voluntad de firma — FES). */
40
+ @Expose()
41
+ @IsBoolean()
42
+ otpVerified!: boolean;
43
+
44
+ /** Sello de tiempo NOM-151 (TSA). Ausente hasta firmar (AS del TSA connector). */
45
+ @Expose()
46
+ @IsOptional()
47
+ @IsString()
48
+ nom151Timestamp?: string;
49
+
50
+ @Expose()
51
+ @IsOptional()
52
+ @Matches(regexIso8601)
53
+ signedAt?: string;
54
+
55
+ @Expose()
56
+ @IsString()
57
+ createdBy!: string;
58
+
59
+ @Expose()
60
+ @IsString()
61
+ updatedBy!: string;
62
+
63
+ @Expose()
64
+ @Matches(regexIso8601)
65
+ createdAt!: string;
66
+
67
+ @Expose()
68
+ @Matches(regexIso8601)
69
+ updatedAt!: string;
70
+ }
@@ -11,7 +11,7 @@ import {
11
11
  ValidateNested,
12
12
  } from 'class-validator';
13
13
  import { regexIso8601 } from '../../helpers/constans/regex';
14
- import { ClientLevelEnum } from '../enums/ClientLevelEnum';
14
+ import { ClientLevelEnum } from '../../loanScoring/enums/ClientLevelEnum';
15
15
  import { LoanCreditStatusEnum } from '../enums/LoanCreditStatusEnum';
16
16
  import { ActivationChecklist } from './ActivationChecklist';
17
17
 
@@ -91,6 +91,19 @@ export class LoanCredit {
91
91
  @IsInt()
92
92
  totalToPayCents!: number;
93
93
 
94
+ /** CAT decimal (`3.85` = 385%) — lo calcula el simulador de loan-offerings (C3/AS-01). */
95
+ @Expose()
96
+ @IsOptional()
97
+ @IsNumber()
98
+ @Min(0)
99
+ catAnnual?: number;
100
+
101
+ /** Sesión del wizard que originó — clave de idempotencia del originate (AS-07). */
102
+ @Expose()
103
+ @IsOptional()
104
+ @IsString()
105
+ wizardSessionId?: string;
106
+
94
107
  /** IMEI del equipo financiado (se fija en el enrolamiento MDM). */
95
108
  @Expose()
96
109
  @IsOptional()
@@ -0,0 +1,39 @@
1
+ import { Expose } from 'class-transformer';
2
+ import { IsBoolean, IsOptional, IsString } from 'class-validator';
3
+
4
+ /**
5
+ * Body de `POST /private/credits/:creditId/activate-check` (loan-credit-business — M2 §5).
6
+ * Marca condiciones del checklist de activación cumplidas (solo las que cambian, solo a `true`):
7
+ * `downPayment` la reporta el wizard al confirmar el enganche (paso 07); `imeiEnrolled` +
8
+ * `lockVerified` las dispara el paso 09 variante crédito (enrolamiento MDM vía la abstracción de
9
+ * proveedor). `contractSigned` NO se marca por acá — solo la firma FES (endpoint sign).
10
+ *
11
+ * Cuando las 4 condiciones quedan `true` en el mismo request → el crédito pasa a `ACTIVE`:
12
+ * vencimientos `activatedAt + n×7d` (domingo→lunes), `voluntaryCancelDeadline = +7d`, flag de
13
+ * cobro PCF configurado (C7 — solo flag, el débito real requiere adendum).
14
+ */
15
+ export class ActivationCheckRequest {
16
+ /** Enganche confirmado (efectivo/débito inmediato; SPEI espera confirmación — M2 §5). */
17
+ @Expose()
18
+ @IsOptional()
19
+ @IsBoolean()
20
+ downPayment?: boolean;
21
+
22
+ /** IMEI enrolado en MDM. Dispara el enroll vía `MdmConnectorRouter` si aún no se hizo. */
23
+ @Expose()
24
+ @IsOptional()
25
+ @IsBoolean()
26
+ imeiEnrolled?: boolean;
27
+
28
+ /** Software de bloqueo verificado (el MDM reporta "activo"). */
29
+ @Expose()
30
+ @IsOptional()
31
+ @IsBoolean()
32
+ lockVerified?: boolean;
33
+
34
+ /** IMEI del equipo (paso 09) si no se fijó en el originate. Luhn-validado por el motor. */
35
+ @Expose()
36
+ @IsOptional()
37
+ @IsString()
38
+ imei?: string;
39
+ }
@@ -3,23 +3,30 @@ import {
3
3
  IsEnum,
4
4
  IsInt,
5
5
  IsNotEmpty,
6
- IsNumber,
7
6
  IsOptional,
8
7
  IsString,
9
8
  Max,
10
9
  Min,
11
10
  } from 'class-validator';
12
- import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
11
+ import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
13
12
 
14
13
  /**
15
- * Body de POST /credits (loan-credit-business). Origina el crédito en `PENDING_ACTIVATION` y genera
16
- * su plan de cuotas (amortización francesa + IVA 16% M2 §3 / 05_MOTOR §4).
14
+ * Body de `POST /private/credits/originate` (loan-credit-business wizard, vía api-invoker).
15
+ * Origina el crédito en `PENDING_ACTIVATION`: valida (M2 §4.2: sin otro crédito vivo, plan activo,
16
+ * IMEI libre), invoca el simulador de loan-offerings con `planId+termWeeks+precio+enganche` (la
17
+ * TNA y el CAT los resuelve el PLAN — el caller NO los manda) y persiste crédito + cuotas +
18
+ * contratos draft.
17
19
  *
18
- * Los términos financieros (`planId`, `termWeeks`, `tnaAnnual`) vienen de la cotización hecha con
19
- * loan-offerings; el motor recalcula la tabla internamente (la cotización es informativa, el plan
20
- * de cuotas del crédito lo genera y persiste este lambda).
20
+ * **Idempotente por `wizardSessionId`** (el wizard reintenta): mismo wizardSessionId devuelve el
21
+ * crédito ya originado, no crea otro. El tenant viaja por query `?tenantId=` (convención privados).
21
22
  */
22
23
  export class OriginateLoanCreditRequest {
24
+ /** Sesión del wizard que origina — clave de idempotencia (AS-07). */
25
+ @Expose()
26
+ @IsString()
27
+ @IsNotEmpty()
28
+ wizardSessionId!: string;
29
+
23
30
  @Expose()
24
31
  @IsString()
25
32
  @IsNotEmpty()
@@ -46,14 +53,7 @@ export class OriginateLoanCreditRequest {
46
53
  @Min(0)
47
54
  downPaymentCents!: number;
48
55
 
49
- /** TNA decimal (`2.30` = 230%). */
50
- @Expose()
51
- @IsNumber()
52
- @Min(0)
53
- @Max(10)
54
- tnaAnnual!: number;
55
-
56
- /** SCI del cliente al originar (snapshot). */
56
+ /** SCI del cliente al originar (snapshot de la evaluación del paso 05). */
57
57
  @Expose()
58
58
  @IsOptional()
59
59
  @IsInt()
@@ -66,6 +66,7 @@ export class OriginateLoanCreditRequest {
66
66
  @IsEnum(ClientLevelEnum)
67
67
  clientLevelAtOrigination?: ClientLevelEnum;
68
68
 
69
+ /** IMEI del equipo si ya se conoce (también puede fijarse en el paso 09 vía activate-check). */
69
70
  @Expose()
70
71
  @IsOptional()
71
72
  @IsString()
@@ -0,0 +1,24 @@
1
+ import { Expose } from 'class-transformer';
2
+ import { IsInt, IsOptional, Max, Min } from 'class-validator';
3
+
4
+ /**
5
+ * Body de `POST /private/credits/:creditId/quote` (loan-credit-business — wizard paso 06).
6
+ * Re-cotiza el crédito en `PENDING_ACTIVATION` con términos nuevos (el cliente itera
7
+ * plazo/enganche en el cotizador) e invoca el simulador de loan-offerings; regenera las cuotas.
8
+ * Campos ausentes = conservar el valor actual del crédito. Rechaza si el crédito no está PENDING
9
+ * o si el contrato ya se firmó (los términos quedan congelados con la firma).
10
+ */
11
+ export class QuoteLoanCreditRequest {
12
+ @Expose()
13
+ @IsOptional()
14
+ @IsInt()
15
+ @Min(1)
16
+ @Max(104)
17
+ termWeeks?: number;
18
+
19
+ @Expose()
20
+ @IsOptional()
21
+ @IsInt()
22
+ @Min(0)
23
+ downPaymentCents?: number;
24
+ }
@@ -0,0 +1,24 @@
1
+ import { Expose } from 'class-transformer';
2
+ import { IsOptional, IsString, Length } from 'class-validator';
3
+
4
+ /**
5
+ * Body de `POST /private/credits/:creditId/sign` (loan-credit-business — wizard paso 08, firma FES
6
+ * M2 §4.4). Endpoint de DOS tiempos sobre el mismo contrato:
7
+ *
8
+ * 1. **SIN `otpCode`** → INICIA la firma: congela términos, genera los 3 PDFs (C4), calcula sus
9
+ * sha256 y dispara el OTP dedicado de firma (4 dígitos, 5 min, vía messages-business — D5;
10
+ * distinto al OTP del paso 01). Responde `otpSent: true`.
11
+ * 2. **CON `otpCode`** → VERIFICA el OTP y firma: marca los contratos `otpVerified` + `signedAt` +
12
+ * NOM-151, y pone `activationChecklist.contractSigned = true`.
13
+ *
14
+ * Errores: `OTP_INVALID` · `OTP_EXPIRED` · `OTP_MAX_ATTEMPTS` · `CREDIT_NOT_PENDING`.
15
+ * (Semántica a ratificar con el contrato del wizard — AS-07.)
16
+ */
17
+ export class SignLoanCreditRequest {
18
+ /** Código OTP de firma. Ausente = iniciar la firma (generar PDFs + enviar OTP). */
19
+ @Expose()
20
+ @IsOptional()
21
+ @IsString()
22
+ @Length(4, 4)
23
+ otpCode?: string;
24
+ }
@@ -9,7 +9,7 @@ import {
9
9
  Min,
10
10
  ValidateNested,
11
11
  } from 'class-validator';
12
- import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
12
+ import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
13
13
  import { LoanBeneficiary } from '../LoanBeneficiary';
14
14
 
15
15
  /**
@@ -0,0 +1,11 @@
1
+ import { LoanCreditResponse } from './LoanCreditResponse';
2
+
3
+ /**
4
+ * Response de `POST /private/credits/:creditId/activate-check` (loan-credit-business — M2 §5):
5
+ * el crédito con el checklist actualizado. `missingItems` lista las condiciones que faltan
6
+ * (vacío cuando el crédito quedó `ACTIVE`).
7
+ */
8
+ export interface ActivationCheckResponse {
9
+ credit: LoanCreditResponse;
10
+ missingItems: string[];
11
+ }
@@ -1,4 +1,4 @@
1
- import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
1
+ import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
2
2
 
3
3
  /**
4
4
  * Response de los endpoints de LoanBorrower (loan-credit-business). Interface plain (las salidas
@@ -0,0 +1,17 @@
1
+ import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
2
+
3
+ /**
4
+ * Response de un documento del contrato (loan-credit-business). `signedAt` ausente = draft.
5
+ */
6
+ export interface LoanContractResponse {
7
+ contractId: string;
8
+ creditId: string;
9
+ type: ContractTypeEnum;
10
+ pdfS3Key?: string;
11
+ sha256?: string;
12
+ otpVerified: boolean;
13
+ nom151Timestamp?: string;
14
+ signedAt?: string;
15
+ createdAt: string;
16
+ updatedAt: string;
17
+ }
@@ -1,4 +1,4 @@
1
- import { ClientLevelEnum } from '../../enums/ClientLevelEnum';
1
+ import { ClientLevelEnum } from '../../../loanScoring/enums/ClientLevelEnum';
2
2
  import { LoanCreditStatusEnum } from '../../enums/LoanCreditStatusEnum';
3
3
 
4
4
  /**
@@ -1,11 +1,14 @@
1
+ import { LoanContractResponse } from './LoanContractResponse';
1
2
  import { LoanCreditResponse } from './LoanCreditResponse';
2
3
  import { LoanInstallmentResponse } from './LoanInstallmentResponse';
3
4
 
4
5
  /**
5
- * Response de POST /credits (loan-credit-business): el crédito recién originado en
6
- * `PENDING_ACTIVATION` + su plan de cuotas completo (las fechas se fijan al activar).
6
+ * Response de `POST /private/credits/originate` (loan-credit-business): el crédito recién
7
+ * originado en `PENDING_ACTIVATION` + su plan de cuotas (fechas ausentes hasta activar) + los 3
8
+ * contratos draft (C4 — se firman en el paso 08).
7
9
  */
8
10
  export interface OriginateLoanCreditResponse {
9
11
  credit: LoanCreditResponse;
10
12
  installments: LoanInstallmentResponse[];
13
+ contracts: LoanContractResponse[];
11
14
  }
@@ -0,0 +1,11 @@
1
+ import { LoanCreditResponse } from './LoanCreditResponse';
2
+ import { LoanInstallmentResponse } from './LoanInstallmentResponse';
3
+
4
+ /**
5
+ * Response de `POST /private/credits/:creditId/quote` (loan-credit-business): el crédito con los
6
+ * términos re-cotizados + el plan de cuotas regenerado (fechas ausentes hasta activar).
7
+ */
8
+ export interface QuoteLoanCreditResponse {
9
+ credit: LoanCreditResponse;
10
+ installments: LoanInstallmentResponse[];
11
+ }
@@ -0,0 +1,21 @@
1
+ import { LoanContractResponse } from './LoanContractResponse';
2
+
3
+ /**
4
+ * Response de `POST /private/credits/:creditId/sign` (loan-credit-business — firma FES en 2
5
+ * tiempos): al INICIAR (`otpSent: true`, contratos con PDF+hash sin firmar); al VERIFICAR
6
+ * (`signed: true`, contratos firmados + checklist con `contractSigned = true`).
7
+ */
8
+ export interface SignLoanCreditResponse {
9
+ creditId: string;
10
+ /** true cuando el request inició la firma y el OTP fue despachado. */
11
+ otpSent: boolean;
12
+ /** true cuando el OTP fue verificado y los contratos quedaron firmados. */
13
+ signed: boolean;
14
+ contracts: LoanContractResponse[];
15
+ activationChecklist: {
16
+ downPayment: boolean;
17
+ contractSigned: boolean;
18
+ imeiEnrolled: boolean;
19
+ lockVerified: boolean;
20
+ };
21
+ }
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Tipo de documento del contrato de crédito (M2 §4.3 / C4 — 3 documentos):
3
+ * `CREDIT` = contrato de crédito celular (RECA 16145-439-038506/04-01076-0525) ·
4
+ * `PROMISSORY_NOTE` = pagaré (garantiza el crédito; mismo monto/tasa/plazo) ·
5
+ * `SIC_AUTHORIZATION` = autorización de consulta/reporte a Círculo de Crédito (Art. 28 LRSIC).
6
+ * @enum {string}
7
+ */
8
+ export enum ContractTypeEnum {
9
+ CREDIT = 'CREDIT',
10
+ PROMISSORY_NOTE = 'PROMISSORY_NOTE',
11
+ SIC_AUTHORIZATION = 'SIC_AUTHORIZATION',
12
+ }
@@ -1,11 +1,14 @@
1
1
  /**
2
- * Estado de una cuota semanal del crédito (M2 §6.1 / 05_MOTOR §5).
3
- * `RESTRUCTURED` (reestructurado) = la cuota dejó de aplicar por reestructura o cancelación.
2
+ * Estado de una cuota semanal del crédito (M2 §6.1: pendiente · pagado · pagado_adelantado ·
3
+ * vencido · reestructurado). `PAID_IN_ADVANCE` = pago adelantado (cubre cuota futura tal cual,
4
+ * sin recalcular tabla — M2 §3.7). `RESTRUCTURED` = la cuota dejó de aplicar por
5
+ * reestructura o cancelación.
4
6
  * @enum {string}
5
7
  */
6
8
  export enum LoanInstallmentStatusEnum {
7
9
  PENDING = 'PENDING',
8
10
  PAID = 'PAID',
11
+ PAID_IN_ADVANCE = 'PAID_IN_ADVANCE',
9
12
  OVERDUE = 'OVERDUE',
10
13
  RESTRUCTURED = 'RESTRUCTURED',
11
14
  }
@@ -1,23 +1,32 @@
1
1
  // Enums
2
2
  export * from './enums/LoanCreditStatusEnum';
3
3
  export * from './enums/LoanInstallmentStatusEnum';
4
- export * from './enums/ClientLevelEnum';
4
+ export * from './enums/ContractTypeEnum';
5
+ // Re-export del enum canónico de nivel (owner: loanScoring — un solo origen de verdad).
6
+ export { ClientLevelEnum } from '../loanScoring/enums/ClientLevelEnum';
5
7
 
6
8
  // Entity DTOs
7
9
  export * from './dtos/LoanBorrower';
8
10
  export * from './dtos/LoanBeneficiary';
9
11
  export * from './dtos/LoanCredit';
10
12
  export * from './dtos/LoanInstallment';
13
+ export * from './dtos/LoanContract';
11
14
  export * from './dtos/ActivationChecklist';
12
15
 
13
16
  // Request DTOs
14
17
  export * from './dtos/requests/UpsertLoanBorrowerRequest';
15
18
  export * from './dtos/requests/OriginateLoanCreditRequest';
16
- export * from './dtos/requests/UpdateActivationChecklistRequest';
19
+ export * from './dtos/requests/QuoteLoanCreditRequest';
20
+ export * from './dtos/requests/SignLoanCreditRequest';
21
+ export * from './dtos/requests/ActivationCheckRequest';
17
22
  export * from './dtos/requests/ChangeLoanCreditStatusRequest';
18
23
 
19
24
  // Response DTOs
20
25
  export * from './dtos/responses/LoanBorrowerResponse';
21
26
  export * from './dtos/responses/LoanCreditResponse';
22
27
  export * from './dtos/responses/LoanInstallmentResponse';
28
+ export * from './dtos/responses/LoanContractResponse';
23
29
  export * from './dtos/responses/OriginateLoanCreditResponse';
30
+ export * from './dtos/responses/QuoteLoanCreditResponse';
31
+ export * from './dtos/responses/SignLoanCreditResponse';
32
+ export * from './dtos/responses/ActivationCheckResponse';
@@ -1,11 +0,0 @@
1
- export declare enum BenefitFlowEnum {
2
- TOPUPS = "TOPUPS",
3
- BILL_PAYMENT = "BILL_PAYMENT",
4
- CREDIT = "CREDIT",
5
- INSURANCE = "INSURANCE",
6
- DONATION = "DONATION",
7
- PHARMACY = "PHARMACY",
8
- REMITTANCE = "REMITTANCE",
9
- /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
10
- WALLET_FUNDING = "WALLET_FUNDING"
11
- }
@@ -1,15 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.BenefitFlowEnum = void 0;
4
- var BenefitFlowEnum;
5
- (function (BenefitFlowEnum) {
6
- BenefitFlowEnum["TOPUPS"] = "TOPUPS";
7
- BenefitFlowEnum["BILL_PAYMENT"] = "BILL_PAYMENT";
8
- BenefitFlowEnum["CREDIT"] = "CREDIT";
9
- BenefitFlowEnum["INSURANCE"] = "INSURANCE";
10
- BenefitFlowEnum["DONATION"] = "DONATION";
11
- BenefitFlowEnum["PHARMACY"] = "PHARMACY";
12
- BenefitFlowEnum["REMITTANCE"] = "REMITTANCE";
13
- /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
14
- BenefitFlowEnum["WALLET_FUNDING"] = "WALLET_FUNDING";
15
- })(BenefitFlowEnum || (exports.BenefitFlowEnum = BenefitFlowEnum = {}));
@@ -1,6 +0,0 @@
1
- export declare class CancelFundingReferenceRequest {
2
- /** Referencia Passport (PK de EqualityFundingReference_GT). */
3
- reference: string;
4
- directoryId: string;
5
- idempotencyKey: string;
6
- }
@@ -1,31 +0,0 @@
1
- "use strict";
2
- var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
3
- var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
4
- if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
5
- 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;
6
- return c > 3 && r && Object.defineProperty(target, key, r), r;
7
- };
8
- var __metadata = (this && this.__metadata) || function (k, v) {
9
- if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
10
- };
11
- Object.defineProperty(exports, "__esModule", { value: true });
12
- exports.CancelFundingReferenceRequest = void 0;
13
- const class_validator_1 = require("class-validator");
14
- class CancelFundingReferenceRequest {
15
- }
16
- exports.CancelFundingReferenceRequest = CancelFundingReferenceRequest;
17
- __decorate([
18
- (0, class_validator_1.IsString)(),
19
- (0, class_validator_1.MaxLength)(64),
20
- __metadata("design:type", String)
21
- ], CancelFundingReferenceRequest.prototype, "reference", void 0);
22
- __decorate([
23
- (0, class_validator_1.IsString)(),
24
- (0, class_validator_1.MaxLength)(64),
25
- __metadata("design:type", String)
26
- ], CancelFundingReferenceRequest.prototype, "directoryId", void 0);
27
- __decorate([
28
- (0, class_validator_1.IsString)(),
29
- (0, class_validator_1.MaxLength)(64),
30
- __metadata("design:type", String)
31
- ], CancelFundingReferenceRequest.prototype, "idempotencyKey", void 0);
@@ -1,7 +0,0 @@
1
- import { BenefitPaymentStatusEnum } from "../../benefitCenter/enums/BenefitPaymentStatusEnum";
2
- import { WalletFundingErrorCodeEnum } from "../enums/WalletFundingErrorCodeEnum";
3
- export declare class CancelFundingReferenceResponse {
4
- reference: string;
5
- status: BenefitPaymentStatusEnum;
6
- errorCode?: WalletFundingErrorCodeEnum;
7
- }
@@ -1,6 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.CancelFundingReferenceResponse = void 0;
4
- class CancelFundingReferenceResponse {
5
- }
6
- exports.CancelFundingReferenceResponse = CancelFundingReferenceResponse;
@@ -1,11 +0,0 @@
1
- /**
2
- * Request del cancel via Centro de Beneficios (spec 13 v2.0).
3
- * `reference` viaja en el path, `directoryId` se resuelve del JWT.
4
- * `providerModuleName` permite al marketplace rutear al publisher correcto
5
- * sin tener que persistir el mapping (el wallet-app sabe el moduleName
6
- * porque vino en la respuesta del authorize).
7
- */
8
- export declare class CancelFundingRequest {
9
- idempotencyKey: string;
10
- providerModuleName: string;
11
- }