@fiado/type-kit 3.610.0 → 3.611.0

package/_test_/unit/loanCredit/customerReadDtos.test.ts

@@ -3,6 +3,8 @@ import {
     ContractTypeEnum,
     CreditSaleContext,
     LoanContractDownloadUrl,
+    LoanCustomerCreditDocument,
+    LoanCustomerCreditDocumentUrl,
     LoanPaymentListItem,
     LoanPaymentListResponse,
 } from '../../../src/loanCredit/index';
@@ -68,4 +70,24 @@ describe('loanCredit — DTOs de lectura de cliente (I1)', () => {
         };
         expect(url.type).toBe(ContractTypeEnum.CREDIT);
     });
+
+    it('un documento del ciclo de vida sin PDF todavía no tiene fecha de generación', () => {
+        const pending: LoanCustomerCreditDocument = {
+            documentType: ContractTypeEnum.PAYMENT_RECEIPT,
+            documentKey: '01K8Z5Q2J6V3W4X5Y6Z7A8B9C0',
+            generatedAt: null,
+        };
+        expect(pending.generatedAt).toBeNull();
+    });
+
+    it('la URL de un documento del ciclo de vida trae su tipo, su llave y su vencimiento', () => {
+        const url: LoanCustomerCreditDocumentUrl = {
+            creditId: 'CR-1',
+            documentType: ContractTypeEnum.ACCOUNT_STATEMENT,
+            documentKey: '2026-09',
+            url: 'https://s3.example/statement.pdf',
+            expiresAt: '2026-10-21T15:00:00.000Z',
+        };
+        expect(url.documentKey).toBe('2026-09');
+    });
 });

package/_test_/unit/retailLoan/contract.test.ts

@@ -18,6 +18,11 @@ describe('retailLoan — contrato app ↔ retail-loan-business (I1)', () => {
     it('los ids de grupo de documentos son los que espera el módulo de la app', () => {
         expect(MyDocumentGroupIdEnum.CONTRACT).toBe('contract');
         expect(MyDocumentGroupIdEnum.MONTHLY).toBe('monthly');
+        expect(MyDocumentGroupIdEnum.PAYMENT_RECEIPTS).toBe('receipts');
+    });
+
+    it('un comprobante de pago es su propio tipo de documento', () => {
+        expect(MyDocumentKindEnum.PAYMENT_RECEIPT).toBe('PAYMENT_RECEIPT');
     });
 
     it('el detalle del crédito va en pesos y con frecuencia semanal', () => {

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

@@ -0,0 +1,9 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+/** Documento del ciclo de vida de un crédito, visto por su acreditado. */
+export interface LoanCustomerCreditDocument {
+    documentType: ContractTypeEnum;
+    /** Llave del documento: el paymentId en un comprobante, el periodo `YYYY-MM` en un estado de cuenta. */
+    documentKey: string;
+    /** ISO-8601; `null` mientras el PDF no se haya generado. */
+    generatedAt: string | null;
+}

package/bin/loanCredit/dtos/responses/LoanCustomerCreditDocument.js

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

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

@@ -0,0 +1,9 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+/** Enlace prefirmado y temporal del PDF de un documento del ciclo de vida. `expiresAt` en ISO-8601. */
+export interface LoanCustomerCreditDocumentUrl {
+    creditId: string;
+    documentType: ContractTypeEnum;
+    documentKey: string;
+    url: string;
+    expiresAt: string;
+}

package/bin/loanCredit/dtos/responses/LoanCustomerCreditDocumentUrl.js

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

package/bin/loanCredit/index.d.ts

@@ -42,6 +42,8 @@ export * from './dtos/responses/LoanPaymentListItem';
 export * from './dtos/responses/LoanContractDownloadUrl';
 export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
+export * from './dtos/responses/LoanCustomerCreditDocument';
+export * from './dtos/responses/LoanCustomerCreditDocumentUrl';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';
 export * from './dtos/responses/SignLoanCreditResponse';

package/bin/loanCredit/index.js

@@ -66,6 +66,8 @@ __exportStar(require("./dtos/responses/LoanPaymentListItem"), exports);
 __exportStar(require("./dtos/responses/LoanContractDownloadUrl"), exports);
 __exportStar(require("./dtos/responses/LoanContractPreview"), exports);
 __exportStar(require("./dtos/responses/LoanContractResponse"), exports);
+__exportStar(require("./dtos/responses/LoanCustomerCreditDocument"), exports);
+__exportStar(require("./dtos/responses/LoanCustomerCreditDocumentUrl"), exports);
 __exportStar(require("./dtos/responses/OriginateLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/QuoteLoanCreditResponse"), exports);
 __exportStar(require("./dtos/responses/SignLoanCreditResponse"), exports);

package/bin/retailLoan/dtos/MyDocument.d.ts

@@ -4,7 +4,8 @@ import { MyDocumentKindEnum } from '../enums/MyDocumentKindEnum';
 import { MyDocumentStatusEnum } from '../enums/MyDocumentStatusEnum';
 /**
  * Un documento del crédito. `documentRef` sigue la convención del módulo de la app:
- * `doc-contract-<contractId>` para contratos y `doc-stmt-YYYY-MM` para estados de cuenta.
+ * `doc-contract-<contractId>` para contratos, `doc-stmt-YYYY-MM` para estados de cuenta y
+ * `doc-receipt-<paymentId>` para comprobantes de pago.
  */
 export interface MyDocument {
     documentRef: string;

package/bin/retailLoan/enums/MyDocumentGroupIdEnum.d.ts

@@ -1,5 +1,6 @@
 /** Ids de grupo que exige el módulo de la app (`DocumentGroupList`): minúsculas a propósito. */
 export declare enum MyDocumentGroupIdEnum {
     CONTRACT = "contract",
-    MONTHLY = "monthly"
+    MONTHLY = "monthly",
+    PAYMENT_RECEIPTS = "receipts"
 }

package/bin/retailLoan/enums/MyDocumentGroupIdEnum.js

@@ -6,4 +6,5 @@ var MyDocumentGroupIdEnum;
 (function (MyDocumentGroupIdEnum) {
     MyDocumentGroupIdEnum["CONTRACT"] = "contract";
     MyDocumentGroupIdEnum["MONTHLY"] = "monthly";
+    MyDocumentGroupIdEnum["PAYMENT_RECEIPTS"] = "receipts";
 })(MyDocumentGroupIdEnum || (exports.MyDocumentGroupIdEnum = MyDocumentGroupIdEnum = {}));

package/bin/retailLoan/enums/MyDocumentKindEnum.d.ts

@@ -1,4 +1,5 @@
 export declare enum MyDocumentKindEnum {
     CONTRACT = "CONTRACT",
-    MONTHLY_STATEMENT = "MONTHLY_STATEMENT"
+    MONTHLY_STATEMENT = "MONTHLY_STATEMENT",
+    PAYMENT_RECEIPT = "PAYMENT_RECEIPT"
 }

package/bin/retailLoan/enums/MyDocumentKindEnum.js

@@ -5,4 +5,5 @@ var MyDocumentKindEnum;
 (function (MyDocumentKindEnum) {
     MyDocumentKindEnum["CONTRACT"] = "CONTRACT";
     MyDocumentKindEnum["MONTHLY_STATEMENT"] = "MONTHLY_STATEMENT";
+    MyDocumentKindEnum["PAYMENT_RECEIPT"] = "PAYMENT_RECEIPT";
 })(MyDocumentKindEnum || (exports.MyDocumentKindEnum = MyDocumentKindEnum = {}));

package/package.json

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

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

@@ -0,0 +1,10 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+
+/** Documento del ciclo de vida de un crédito, visto por su acreditado. */
+export interface LoanCustomerCreditDocument {
+    documentType: ContractTypeEnum;
+    /** Llave del documento: el paymentId en un comprobante, el periodo `YYYY-MM` en un estado de cuenta. */
+    documentKey: string;
+    /** ISO-8601; `null` mientras el PDF no se haya generado. */
+    generatedAt: string | null;
+}

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

@@ -0,0 +1,10 @@
+import { ContractTypeEnum } from '../../enums/ContractTypeEnum';
+
+/** Enlace prefirmado y temporal del PDF de un documento del ciclo de vida. `expiresAt` en ISO-8601. */
+export interface LoanCustomerCreditDocumentUrl {
+    creditId: string;
+    documentType: ContractTypeEnum;
+    documentKey: string;
+    url: string;
+    expiresAt: string;
+}

package/src/loanCredit/index.ts

@@ -51,6 +51,8 @@ export * from './dtos/responses/LoanPaymentListItem';
 export * from './dtos/responses/LoanContractDownloadUrl';
 export * from './dtos/responses/LoanContractPreview';
 export * from './dtos/responses/LoanContractResponse';
+export * from './dtos/responses/LoanCustomerCreditDocument';
+export * from './dtos/responses/LoanCustomerCreditDocumentUrl';
 export * from './dtos/responses/OriginateLoanCreditResponse';
 export * from './dtos/responses/QuoteLoanCreditResponse';
 export * from './dtos/responses/SignLoanCreditResponse';

package/src/retailLoan/dtos/MyDocument.ts

@@ -5,7 +5,8 @@ import { MyDocumentStatusEnum } from '../enums/MyDocumentStatusEnum';
 
 /**
  * Un documento del crédito. `documentRef` sigue la convención del módulo de la app:
- * `doc-contract-<contractId>` para contratos y `doc-stmt-YYYY-MM` para estados de cuenta.
+ * `doc-contract-<contractId>` para contratos, `doc-stmt-YYYY-MM` para estados de cuenta y
+ * `doc-receipt-<paymentId>` para comprobantes de pago.
  */
 export interface MyDocument {
     documentRef: string;

package/src/retailLoan/enums/MyDocumentGroupIdEnum.ts

@@ -2,4 +2,5 @@
 export enum MyDocumentGroupIdEnum {
     CONTRACT = 'contract',
     MONTHLY = 'monthly',
+    PAYMENT_RECEIPTS = 'receipts',
 }

package/src/retailLoan/enums/MyDocumentKindEnum.ts

@@ -1,4 +1,5 @@
 export enum MyDocumentKindEnum {
     CONTRACT = 'CONTRACT',
     MONTHLY_STATEMENT = 'MONTHLY_STATEMENT',
+    PAYMENT_RECEIPT = 'PAYMENT_RECEIPT',
 }