@fiado/api-invoker 5.2.0 → 5.4.0

package/bin/kyc/queue/RetailKycInboundPublisher.d.ts

@@ -1,6 +1,5 @@
-import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
-import { IRetailKycInboundPublisher } from "./interfaces/IRetailKycInboundPublisher.js";
+import { IRetailKycInboundPublisher, RetailKycInboundMessage } from "./interfaces/IRetailKycInboundPublisher.js";
 export declare class RetailKycInboundPublisher implements IRetailKycInboundPublisher {
     private readonly RETAIL_KYC_INBOUND_QUEUE_URL;
-    publish(message: KycVerificationChangedV1): Promise<void>;
+    publish(message: RetailKycInboundMessage): Promise<void>;
 }

package/bin/kyc/queue/RetailKycInboundPublisher.js

@@ -11,8 +11,11 @@ let RetailKycInboundPublisher = class RetailKycInboundPublisher {
     async publish(message) {
         try {
             const client = new SQSClient();
-            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId. La deduplicación
-            // la hace el consumidor con la llave de negocio (directoryId + verificationId + status + result).
+            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId, y por lo tanto SIN
+            // orden garantizado. La deduplicación la hace el consumidor con la llave de negocio: el
+            // cierre por (directoryId + verificationId + status + result), la estación por
+            // (verificationId + step) — su escritura ya es idempotente. El reordenamiento lo resuelve
+            // el `occurredAt` de cada estación, no la cola.
             const sendMessageRequest = {
                 QueueUrl: this.RETAIL_KYC_INBOUND_QUEUE_URL,
                 MessageBody: JSON.stringify(message),

package/bin/kyc/queue/interfaces/IRetailKycInboundPublisher.d.ts

@@ -1,12 +1,22 @@
-import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+import { KycVerificationChangedV1, KycStepCompletedV1 } from "@fiado/type-kit/bin/kyc/index.js";
 /**
- * Publisher del resultado del KYC hacia `RetailKycInboundQueue`, que consume
- * `retail-wizard-business` (SureKeep F2).
+ * Todo lo que `RetailKycInboundQueue` transporta:
+ * - `KycVerificationChangedV1` — el CIERRE de la verificación, con el resultado consolidado.
+ * - `KycStepCompletedV1` — el resultado de UNA estación, en cuanto Metamap la cierra.
  *
- * Lo produce `kyc-metamap-webhook` cuando una verificación pasa a COMPLETED. Vive acá —y no como
- * SDK crudo en el webhook— porque la cola es COMPARTIDA cross-lambda: el estándar Fiado publica a una
- * cola compartida vía Publisher de `@fiado/api-invoker` (mismo patrón que `ITransactionPublisher`).
+ * Es una unión cerrada y no un `unknown` a propósito: el consumidor rutea por `eventType`, así que
+ * agregar un tipo acá obliga a tocar también el consumidor — que es exactamente la conversación que
+ * tiene que pasar antes de meter un mensaje nuevo en una cola compartida.
+ */
+export type RetailKycInboundMessage = KycVerificationChangedV1 | KycStepCompletedV1;
+/**
+ * Publisher del KYC hacia `RetailKycInboundQueue`, que consume `retail-wizard-business` (SureKeep F2).
+ *
+ * Lo produce `kyc-metamap-webhook`: el cierre cuando la verificación pasa a COMPLETED, y una estación
+ * por cada `step_completed`. Vive acá —y no como SDK crudo en el webhook— porque la cola es COMPARTIDA
+ * cross-lambda: el estándar Fiado publica a una cola compartida vía Publisher de `@fiado/api-invoker`
+ * (mismo patrón que `ITransactionPublisher`).
  */
 export interface IRetailKycInboundPublisher {
-    publish(message: KycVerificationChangedV1): Promise<void>;
+    publish(message: RetailKycInboundMessage): Promise<void>;
 }

package/bin/loanCredit/api/LoanCreditBusinessApi.d.ts

@@ -22,6 +22,7 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     quote(creditId: string, input: QuoteLoanCreditRequest, tenantId: string): Promise<StandardResponse<QuoteLoanCreditResponse>>;
     sign(creditId: string, input: SignLoanCreditRequest, tenantId: string): Promise<StandardResponse<SignLoanCreditResponse>>;
     activateCheck(creditId: string, input: ActivationCheckRequest, tenantId: string): Promise<StandardResponse<ActivationCheckResponse>>;
+    discard(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     getBorrowerByRetailCustomer(retailCustomerId: string, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
     upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -46,6 +46,10 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/activate-check?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+    async discard(creditId, tenantId) {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/discard?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, {});
+    }
     async getCredit(creditId, tenantId) {
         const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.get(url);

package/bin/loanCredit/api/interfaces/ILoanCreditBusinessApi.d.ts

@@ -42,6 +42,13 @@ export interface ILoanCreditBusinessApi {
      * el crédito pasa a `ACTIVE` (vencimientos +7d, ventana de cancelación 7d).
      */
     activateCheck(creditId: string, input: ActivationCheckRequest, tenantId: string): Promise<StandardResponse<ActivationCheckResponse>>;
+    /**
+     * Descarta un crédito PENDING_ACTIVATION → DISCARDED (compensación del wizard al cancelar la
+     * venta — sin esto el crédito huérfano bloquea al cliente vía un-crédito-vivo). Idempotente.
+     * `400 CREDIT_NOT_PENDING` si el crédito ya avanzó (ACTIVE/IN_ARREARS jamás se descartan) ·
+     * `404 CREDIT_NOT_FOUND`.
+     */
+    discard(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     /** Estado completo del crédito (checklist, status, términos). */
     getCredit(creditId: string, tenantId: string): Promise<StandardResponse<LoanCreditResponse>>;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.2.0",
+  "version": "5.4.0",
   "description": "Sirve como un puente entre diferentes funciones lambda, facilitando la comunicación entre ellas a través de invocaciones http",
   "type": "module",
   "main": "bin/index.js",
@@ -34,7 +34,7 @@
     "@fiado/gateway-adapter": "^3.9.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.212.0",
+    "@fiado/type-kit": "^3.221.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

package/src/kyc/queue/RetailKycInboundPublisher.ts

@@ -1,17 +1,19 @@
 import { SendMessageCommand, SendMessageRequest, SQSClient } from "@aws-sdk/client-sqs";
 import { injectable } from "inversify";
-import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
-import { IRetailKycInboundPublisher } from "./interfaces/IRetailKycInboundPublisher.js";
+import { IRetailKycInboundPublisher, RetailKycInboundMessage } from "./interfaces/IRetailKycInboundPublisher.js";
 
 @injectable()
 export class RetailKycInboundPublisher implements IRetailKycInboundPublisher {
     private readonly RETAIL_KYC_INBOUND_QUEUE_URL = process.env.RETAIL_KYC_INBOUND_QUEUE_URL;
 
-    async publish(message: KycVerificationChangedV1): Promise<void> {
+    async publish(message: RetailKycInboundMessage): Promise<void> {
         try {
             const client: SQSClient = new SQSClient();
-            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId. La deduplicación
-            // la hace el consumidor con la llave de negocio (directoryId + verificationId + status + result).
+            // Cola ESTÁNDAR (no FIFO): sin MessageGroupId/MessageDeduplicationId, y por lo tanto SIN
+            // orden garantizado. La deduplicación la hace el consumidor con la llave de negocio: el
+            // cierre por (directoryId + verificationId + status + result), la estación por
+            // (verificationId + step) — su escritura ya es idempotente. El reordenamiento lo resuelve
+            // el `occurredAt` de cada estación, no la cola.
             const sendMessageRequest: SendMessageRequest = {
                 QueueUrl: this.RETAIL_KYC_INBOUND_QUEUE_URL,
                 MessageBody: JSON.stringify(message),

package/src/kyc/queue/interfaces/IRetailKycInboundPublisher.ts

@@ -1,13 +1,24 @@
-import { KycVerificationChangedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+import { KycVerificationChangedV1, KycStepCompletedV1 } from "@fiado/type-kit/bin/kyc/index.js";
 
 /**
- * Publisher del resultado del KYC hacia `RetailKycInboundQueue`, que consume
- * `retail-wizard-business` (SureKeep F2).
+ * Todo lo que `RetailKycInboundQueue` transporta:
+ * - `KycVerificationChangedV1` — el CIERRE de la verificación, con el resultado consolidado.
+ * - `KycStepCompletedV1` — el resultado de UNA estación, en cuanto Metamap la cierra.
  *
- * Lo produce `kyc-metamap-webhook` cuando una verificación pasa a COMPLETED. Vive acá —y no como
- * SDK crudo en el webhook— porque la cola es COMPARTIDA cross-lambda: el estándar Fiado publica a una
- * cola compartida vía Publisher de `@fiado/api-invoker` (mismo patrón que `ITransactionPublisher`).
+ * Es una unión cerrada y no un `unknown` a propósito: el consumidor rutea por `eventType`, así que
+ * agregar un tipo acá obliga a tocar también el consumidor — que es exactamente la conversación que
+ * tiene que pasar antes de meter un mensaje nuevo en una cola compartida.
+ */
+export type RetailKycInboundMessage = KycVerificationChangedV1 | KycStepCompletedV1;
+
+/**
+ * Publisher del KYC hacia `RetailKycInboundQueue`, que consume `retail-wizard-business` (SureKeep F2).
+ *
+ * Lo produce `kyc-metamap-webhook`: el cierre cuando la verificación pasa a COMPLETED, y una estación
+ * por cada `step_completed`. Vive acá —y no como SDK crudo en el webhook— porque la cola es COMPARTIDA
+ * cross-lambda: el estándar Fiado publica a una cola compartida vía Publisher de `@fiado/api-invoker`
+ * (mismo patrón que `ITransactionPublisher`).
  */
 export interface IRetailKycInboundPublisher {
-    publish(message: KycVerificationChangedV1): Promise<void>;
+    publish(message: RetailKycInboundMessage): Promise<void>;
 }

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -70,6 +70,14 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         return await this.httpRequest.post(url, input);
     }
 
+    async discard(
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCreditResponse>> {
+        const url = `${this.baseUrl}/private/credits/${encodeURIComponent(creditId)}/discard?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, {});
+    }
+
     async getCredit(
         creditId: string,
         tenantId: string,

package/src/loanCredit/api/interfaces/ILoanCreditBusinessApi.ts

@@ -74,6 +74,17 @@ export interface ILoanCreditBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<ActivationCheckResponse>>;
 
+    /**
+     * Descarta un crédito PENDING_ACTIVATION → DISCARDED (compensación del wizard al cancelar la
+     * venta — sin esto el crédito huérfano bloquea al cliente vía un-crédito-vivo). Idempotente.
+     * `400 CREDIT_NOT_PENDING` si el crédito ya avanzó (ACTIVE/IN_ARREARS jamás se descartan) ·
+     * `404 CREDIT_NOT_FOUND`.
+     */
+    discard(
+        creditId: string,
+        tenantId: string,
+    ): Promise<StandardResponse<LoanCreditResponse>>;
+
     /** Estado completo del crédito (checklist, status, términos). */
     getCredit(
         creditId: string,