@fiado/api-invoker 5.154.0 → 5.156.0

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

@@ -1,16 +1,17 @@
-import { KycVerificationChangedV1, KycStepCompletedV1, KycProofOfAddressCompletedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+import { KycVerificationChangedV1, KycStepCompletedV1, KycProofOfAddressCompletedV1, KycVerificationProgressV1 } from "@fiado/type-kit/bin/kyc/index.js";
 /**
  * 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.
  * - `KycProofOfAddressCompletedV1` — el resultado del COMPROBANTE DE DOMICILIO, un flow aparte del
  *   documento de identidad.
+ * - `KycVerificationProgressV1` — el avance de la verificación (iniciada, datos cargados, vencida).
  *
  * 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 | KycProofOfAddressCompletedV1;
+export type RetailKycInboundMessage = KycVerificationChangedV1 | KycStepCompletedV1 | KycProofOfAddressCompletedV1 | KycVerificationProgressV1;
 /**
  * Publisher del KYC hacia `RetailKycInboundQueue`, que consume `retail-wizard-business` (SureKeep F2).
  *

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

@@ -1,6 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, ActivationCheckResponse, CancelLoanCreditRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, PreviewLoanContractRequest, LoanContractPreview, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, ContractTypeEnum, LoanCustomerCreditDocument, LoanCustomerCreditDocumentUrl, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, ActivationCheckResponse, CancelLoanCreditRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, SignLoanCreditResponse, PreviewLoanContractRequest, LoanContractPreview, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, ContractTypeEnum, LoanCustomerCreditDocument, LoanCustomerCreditDocumentUrl, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult, SegmentFactsBatchRequest, SegmentFactsBatchResponse, SegmentFactsPageRequest, SegmentFactsPageResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { CreditSummariesBatchRequest, CreditSummariesBatchResponse } from "./dtos/CreditSummariesBatch.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "./dtos/LoanCreditAnalyticsBatch.js";
 import type { GetCreditOptions } from "./dtos/GetCreditOptions.js";
@@ -37,6 +37,8 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
     getCustomerCreditHistory(retailCustomerId: string, tenantId: string): Promise<StandardResponse<CustomerCreditHistoryResponse>>;
     batchGetCreditAnalytics(input: LoanCreditAnalyticsBatchRequest, tenantId: string): Promise<StandardResponse<LoanCreditAnalyticsBatchResponse>>;
     batchGetCreditSummaries(input: CreditSummariesBatchRequest, tenantId: string): Promise<StandardResponse<CreditSummariesBatchResponse>>;
+    getSegmentFacts(input: SegmentFactsBatchRequest, tenantId: string): Promise<StandardResponse<SegmentFactsBatchResponse>>;
+    pageSegmentFacts(input: SegmentFactsPageRequest, tenantId: string): Promise<StandardResponse<SegmentFactsPageResponse>>;
     upsertBorrower(input: UpsertLoanBorrowerRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
     updateBorrowerSci(borrowerId: string, input: UpdateLoanBorrowerSciRequest, tenantId: string): Promise<StandardResponse<LoanBorrowerResponse>>;
     notifyLifecycleFact(creditId: string, input: CreditLifecycleFactRequest, tenantId: string): Promise<StandardResponse<CreditLifecycleFactResponse>>;

package/bin/loanCredit/api/LoanCreditBusinessApi.js

@@ -92,6 +92,14 @@ let LoanCreditBusinessApi = class LoanCreditBusinessApi {
         const url = `${this.baseUrl}/private/borrowers/credit-summaries?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);
     }
+    async getSegmentFacts(input, tenantId) {
+        const url = `${this.baseUrl}/private/borrowers/segment-facts?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+    async pageSegmentFacts(input, tenantId) {
+        const url = `${this.baseUrl}/private/borrowers/segment-facts/page?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
     async upsertBorrower(input, tenantId) {
         const url = `${this.baseUrl}/private/borrowers?tenantId=${encodeURIComponent(tenantId)}`;
         return await this.httpRequest.post(url, input);

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

@@ -1,5 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, CancelLoanCreditRequest, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, PreviewLoanContractRequest, LoanContractPreview, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, ContractTypeEnum, LoanCustomerCreditDocument, LoanCustomerCreditDocumentUrl, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult } from "@fiado/type-kit/bin/loanCredit/index.js";
+import { ActivationCheckRequest, CreditPaymentAppliedRequest, CreditPaymentAppliedResponse, CreditSettledRequest, CreditSettledResponse, ActivationCheckResponse, CancelLoanCreditRequest, LoanBorrowerResponse, ListMessagingCandidatesRequest, ListMessagingCandidatesResponse, LoanCreditResponse, OriginateLoanCreditRequest, OriginateLoanCreditResponse, QuoteLoanCreditRequest, QuoteLoanCreditResponse, SignLoanCreditRequest, PreviewLoanContractRequest, LoanContractPreview, SignLoanCreditResponse, UpdateLoanBorrowerSciRequest, UpsertLoanBorrowerRequest, LoanBorrowerCreditItem, LoanContractDownloadUrl, LoanContractResponse, ContractTypeEnum, LoanCustomerCreditDocument, LoanCustomerCreditDocumentUrl, LoanCreditDetail, LoanInstallmentResponse, LoanPaymentListResponse, CreateCustomerPaymentRequest, LoanCustomerPaymentOptions, LoanCustomerPaymentResult, SegmentFactsBatchRequest, SegmentFactsBatchResponse, SegmentFactsPageRequest, SegmentFactsPageResponse } from "@fiado/type-kit/bin/loanCredit/index.js";
 import { CreditSummariesBatchRequest, CreditSummariesBatchResponse } from "../dtos/CreditSummariesBatch.js";
 import { LoanCreditAnalyticsBatchRequest, LoanCreditAnalyticsBatchResponse } from "../dtos/LoanCreditAnalyticsBatch.js";
 import type { GetCreditOptions } from "../dtos/GetCreditOptions.js";
@@ -110,6 +110,18 @@ export interface ILoanCreditBusinessApi {
      * `400 VALIDATION_ERROR` si el lote viene vacío, repite ids o pasa de 100.
      */
     batchGetCreditSummaries(input: CreditSummariesBatchRequest, tenantId: string): Promise<StandardResponse<CreditSummariesBatchResponse>>;
+    /**
+     * Datos para evaluar cohorts de segmentos de hasta 100 clientes retail en lote, ya normalizados:
+     * un cliente sin acreditado sale con conteos en `0` y `borrowerId: null`. Un ítem por id pedido,
+     * en el mismo orden.
+     * `400` si el lote viene vacío o pasa de 100.
+     */
+    getSegmentFacts(input: SegmentFactsBatchRequest, tenantId: string): Promise<StandardResponse<SegmentFactsBatchResponse>>;
+    /**
+     * Recorre la cartera de acreditados por páginas (hasta 100) con sus datos para evaluar cohorts.
+     * Es para el recálculo de conteos. `nextCursor` en `null` significa que ya no quedan acreditados.
+     */
+    pageSegmentFacts(input: SegmentFactsPageRequest, tenantId: string): Promise<StandardResponse<SegmentFactsPageResponse>>;
     /**
      * Upsert idempotente del acreditado por `retailCustomerId` (mismo contrato que el consumidor
      * del evento `CustomerKycVerifiedV1` — fallback operativo mientras la cola no exista).

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.d.ts

@@ -1,7 +1,6 @@
 import type { IHttpRequest } from "@fiado/http-client";
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { AmortizationScheduleResponse, ComputeAmortizationScheduleRequest, ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanLevelEnum, CreditPlanResponse, FinancierResponse, ListPromotedSkusRequest, ListSkuPromotionsRequest, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, ScopeWidePromotionsResponse, SegmentCatalogResponse, SegmentStatusEnum, SkuPromotionsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
-import { SegmentMembersResponse } from "./dtos/SegmentMembers.js";
+import { AmortizationScheduleResponse, ComputeAmortizationScheduleRequest, ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanLevelEnum, CreditPlanResponse, FinancierResponse, ListPromotedSkusRequest, ListSkuPromotionsRequest, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, ResolveSegmentMembersRequest, ScopeWidePromotionsResponse, SegmentCatalogResponse, SegmentMembersResponse, SegmentStatusEnum, SkuPromotionsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
 import { ILoanOfferingsBusinessApi } from "./interfaces/ILoanOfferingsBusinessApi.js";
 /**
  * Publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1) para sus
@@ -33,6 +32,8 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
     listSkuPromotions(storeId: string, tenantId: string, level?: CreditPlanLevelEnum, segmentId?: string): Promise<StandardResponse<SkuPromotionsResponse>>;
     listSkuPromotionsBatch(input: ListSkuPromotionsRequest, tenantId: string): Promise<StandardResponse<SkuPromotionsResponse>>;
     listScopeWidePromotions(storeId: string, tenantId: string, level?: CreditPlanLevelEnum, segmentId?: string): Promise<StandardResponse<ScopeWidePromotionsResponse>>;
+    /** @deprecated Usar `resolveSegmentMembers`: este GET solo mira la lista manual. */
     getSegmentMembers(retailCustomerIds: string[], tenantId: string): Promise<StandardResponse<SegmentMembersResponse>>;
+    resolveSegmentMembers(input: ResolveSegmentMembersRequest, tenantId: string): Promise<StandardResponse<SegmentMembersResponse>>;
     listSegments(tenantId: string, status?: SegmentStatusEnum): Promise<StandardResponse<SegmentCatalogResponse>>;
 }

package/bin/loanOfferings/api/LoanOfferingsBusinessApi.js

@@ -98,6 +98,7 @@ let LoanOfferingsBusinessApi = class LoanOfferingsBusinessApi {
             url += `&segmentId=${encodeURIComponent(segmentId)}`;
         return await this.httpRequest.get(url);
     }
+    /** @deprecated Usar `resolveSegmentMembers`: este GET solo mira la lista manual. */
     async getSegmentMembers(retailCustomerIds, tenantId) {
         const params = new URLSearchParams({
             retailCustomerIds: retailCustomerIds.join(","),
@@ -106,6 +107,10 @@ let LoanOfferingsBusinessApi = class LoanOfferingsBusinessApi {
         const url = `${this.baseUrl}/private/segments/members?${params.toString()}`;
         return await this.httpRequest.get(url);
     }
+    async resolveSegmentMembers(input, tenantId) {
+        const url = `${this.baseUrl}/private/segments/members?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
     async listSegments(tenantId, status) {
         const params = new URLSearchParams({ tenantId });
         if (status)

package/bin/loanOfferings/api/dtos/SegmentMembers.d.ts

@@ -1,23 +1,7 @@
-/**
- * Tipos de la pertenencia a segmentos EN LOTE. Viven en esta lib (y no en `@fiado/type-kit`) porque
- * el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO local.
- */
-/** Un segmento al que pertenece el cliente, con lo mínimo para pintarlo. */
-export interface CustomerSegmentMembership {
-    segmentId: string;
-    name: string;
-    /**
-     * Segmento por omisión del catálogo. Su semántica cambia por motor (alcanza a todos en
-     * promociones y a nadie en políticas), así que el consumidor decide si lo pinta.
-     */
-    isDefault: boolean;
-}
-/** Un cliente y los segmentos que le tocan. `segments: []` afirma que no está en ninguno. */
-export interface SegmentMembersItem {
-    retailCustomerId: string;
-    segments: CustomerSegmentMembership[];
-}
-/** Una fila por cada id PEDIDO, no por cada id con segmentos. */
-export interface SegmentMembersResponse {
-    items: SegmentMembersItem[];
-}
+import type { CustomerSegmentRef, CustomerSegmentsItem, SegmentMembersResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+/** Pertenencia a segmentos en lote. La forma vive en `@fiado/type-kit`. */
+export type { SegmentMembersResponse };
+/** @deprecated Usar `CustomerSegmentRef` de `@fiado/type-kit/bin/loanOfferings`. */
+export type CustomerSegmentMembership = CustomerSegmentRef;
+/** @deprecated Usar `CustomerSegmentsItem` de `@fiado/type-kit/bin/loanOfferings`. */
+export type SegmentMembersItem = CustomerSegmentsItem;

package/bin/loanOfferings/api/dtos/SegmentMembers.js

@@ -1,5 +1 @@
-/**
- * Tipos de la pertenencia a segmentos EN LOTE. Viven en esta lib (y no en `@fiado/type-kit`) porque
- * el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO local.
- */
 export {};

package/bin/loanOfferings/api/interfaces/ILoanOfferingsBusinessApi.d.ts

@@ -1,6 +1,5 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { SegmentMembersResponse } from "../dtos/SegmentMembers.js";
-import { ListPromotedSkusRequest, ListSkuPromotionsRequest, AmortizationScheduleResponse, ComputeAmortizationScheduleRequest, ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanLevelEnum, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, ScopeWidePromotionsResponse, SegmentCatalogResponse, SegmentStatusEnum, SkuPromotionsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
+import { ListPromotedSkusRequest, ListSkuPromotionsRequest, AmortizationScheduleResponse, ComputeAmortizationScheduleRequest, ConsumePromotionRequest, PromotedSkusResponse, ConsumePromotionResponse, CreditPlanLevelEnum, CreditPlanResponse, FinancierResponse, ReservePromotionBonusRequest, ReservePromotionBonusResponse, ResolveCustomerSegmentsRequest, ResolveCustomerSegmentsResponse, ResolveSegmentMembersRequest, ScopeWidePromotionsResponse, SegmentCatalogResponse, SegmentMembersResponse, SegmentStatusEnum, SkuPromotionsResponse, SettlePromotionBonusRequest, PromotionBonusResponse, SimulateCreditPlanRequest, SimulationResultResponse } from "@fiado/type-kit/bin/loanOfferings/index.js";
 /**
  * Contrato del publisher HTTP del lambda `loan-offerings-business` (componente 07 SureKeep Fase 1)
  * para sus endpoints privados service-to-service (VPC-only): LECTURAS del catálogo SOFOM y
@@ -99,11 +98,10 @@ export interface ILoanOfferingsBusinessApi {
     listPromotedSkusBatch(input: ListPromotedSkusRequest, tenantId: string): Promise<StandardResponse<PromotedSkusResponse>>;
     /**
      * POST /private/segments/resolve — los segmentos a los que pertenece el cliente HOY, evaluados
-     * en línea contra los hechos que manda el caller. No hay segmento persistido en el cliente.
+     * en línea con sus cohorts. No hay segmento persistido en el cliente.
      *
-     * Los hechos los junta quien ya tiene al cliente delante; este lambda no sale a buscarlos a
-     * otro silo. Un hecho AUSENTE hace que su filtro NO se cumpla: sin el dato no se puede afirmar
-     * que el cliente califica, y de las dos salidas la segura es dejarlo fuera.
+     * Los datos del cliente son opcionales: si el caller no los manda, loan-offerings los pide a
+     * loan-credit. Un dato ausente hace que su condición no se cumpla.
      *
      * `segmentIds` puede venir VACÍO y eso no es un error: significa que el cliente está en
      * Estándar, el catch-all, que nunca se devuelve aquí.
@@ -160,8 +158,21 @@ export interface ILoanOfferingsBusinessApi {
      *
      * @throws `400 SEGMENT_MEMBERS_BATCH_TOO_LARGE` si el lote pasa de 100 ids.
      * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
+     * @deprecated Solo cruza la lista manual del segmento, no evalúa cohorts. Usar
+     *             {@link resolveSegmentMembers}.
      */
     getSegmentMembers(retailCustomerIds: string[], tenantId: string): Promise<StandardResponse<SegmentMembersResponse>>;
+    /**
+     * `POST /private/segments/members` — pertenencia a segmentos EN LOTE, evaluando cohorts y lista
+     * manual igual que el resolve. Hasta 100 clientes; cada uno viaja con sus datos si el caller
+     * los tiene.
+     *
+     * Devuelve una fila por cada cliente pedido, en el mismo orden.
+     *
+     * @throws `400` si el lote viene vacío, pasa de 100 o un dato tiene el tipo equivocado.
+     * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
+     */
+    resolveSegmentMembers(input: ResolveSegmentMembersRequest, tenantId: string): Promise<StandardResponse<SegmentMembersResponse>>;
     /**
      * `GET /private/segments` — catálogo de segmentos del silo, sin miembros; el catch-all viaja con `isDefault: true`.
      * Sin `status` devuelve todos los estados.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fiado/api-invoker",
-  "version": "5.154.0",
+  "version": "5.156.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.14.0",
     "@fiado/http-client": "^2.0.1",
     "@fiado/logger": "^1.1.3",
-    "@fiado/type-kit": "^3.612.0",
+    "@fiado/type-kit": "^3.614.0",
     "dotenv": "^16.4.7"
   },
   "peerDependencies": {

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

@@ -1,4 +1,4 @@
-import { KycVerificationChangedV1, KycStepCompletedV1, KycProofOfAddressCompletedV1 } from "@fiado/type-kit/bin/kyc/index.js";
+import { KycVerificationChangedV1, KycStepCompletedV1, KycProofOfAddressCompletedV1, KycVerificationProgressV1 } from "@fiado/type-kit/bin/kyc/index.js";
 
 /**
  * Todo lo que `RetailKycInboundQueue` transporta:
@@ -6,12 +6,17 @@ import { KycVerificationChangedV1, KycStepCompletedV1, KycProofOfAddressComplete
  * - `KycStepCompletedV1` — el resultado de UNA estación, en cuanto Metamap la cierra.
  * - `KycProofOfAddressCompletedV1` — el resultado del COMPROBANTE DE DOMICILIO, un flow aparte del
  *   documento de identidad.
+ * - `KycVerificationProgressV1` — el avance de la verificación (iniciada, datos cargados, vencida).
  *
  * 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 | KycProofOfAddressCompletedV1;
+export type RetailKycInboundMessage =
+    | KycVerificationChangedV1
+    | KycStepCompletedV1
+    | KycProofOfAddressCompletedV1
+    | KycVerificationProgressV1;
 
 /**
  * Publisher del KYC hacia `RetailKycInboundQueue`, que consume `retail-wizard-business` (SureKeep F2).

package/src/loanCredit/api/LoanCreditBusinessApi.ts

@@ -35,6 +35,10 @@ import {
     CreateCustomerPaymentRequest,
     LoanCustomerPaymentOptions,
     LoanCustomerPaymentResult,
+    SegmentFactsBatchRequest,
+    SegmentFactsBatchResponse,
+    SegmentFactsPageRequest,
+    SegmentFactsPageResponse,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 import {
     CreditSummariesBatchRequest,
@@ -198,6 +202,22 @@ export default class LoanCreditBusinessApi implements ILoanCreditBusinessApi {
         return await this.httpRequest.post(url, input);
     }
 
+    async getSegmentFacts(
+        input: SegmentFactsBatchRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SegmentFactsBatchResponse>> {
+        const url = `${this.baseUrl}/private/borrowers/segment-facts?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
+    async pageSegmentFacts(
+        input: SegmentFactsPageRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SegmentFactsPageResponse>> {
+        const url = `${this.baseUrl}/private/borrowers/segment-facts/page?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
     async upsertBorrower(
         input: UpsertLoanBorrowerRequest,
         tenantId: string,

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

@@ -33,6 +33,10 @@ import {
     CreateCustomerPaymentRequest,
     LoanCustomerPaymentOptions,
     LoanCustomerPaymentResult,
+    SegmentFactsBatchRequest,
+    SegmentFactsBatchResponse,
+    SegmentFactsPageRequest,
+    SegmentFactsPageResponse,
 } from "@fiado/type-kit/bin/loanCredit/index.js";
 import {
     CreditSummariesBatchRequest,
@@ -218,6 +222,26 @@ export interface ILoanCreditBusinessApi {
         tenantId: string,
     ): Promise<StandardResponse<CreditSummariesBatchResponse>>;
 
+    /**
+     * Datos para evaluar cohorts de segmentos de hasta 100 clientes retail en lote, ya normalizados:
+     * un cliente sin acreditado sale con conteos en `0` y `borrowerId: null`. Un ítem por id pedido,
+     * en el mismo orden.
+     * `400` si el lote viene vacío o pasa de 100.
+     */
+    getSegmentFacts(
+        input: SegmentFactsBatchRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SegmentFactsBatchResponse>>;
+
+    /**
+     * Recorre la cartera de acreditados por páginas (hasta 100) con sus datos para evaluar cohorts.
+     * Es para el recálculo de conteos. `nextCursor` en `null` significa que ya no quedan acreditados.
+     */
+    pageSegmentFacts(
+        input: SegmentFactsPageRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SegmentFactsPageResponse>>;
+
     /**
      * Upsert idempotente del acreditado por `retailCustomerId` (mismo contrato que el consumidor
      * del evento `CustomerKycVerifiedV1` — fallback operativo mientras la cola no exista).

package/src/loanOfferings/api/LoanOfferingsBusinessApi.ts

@@ -16,8 +16,10 @@ import {
     ReservePromotionBonusResponse,
     ResolveCustomerSegmentsRequest,
     ResolveCustomerSegmentsResponse,
+    ResolveSegmentMembersRequest,
     ScopeWidePromotionsResponse,
     SegmentCatalogResponse,
+    SegmentMembersResponse,
     SegmentStatusEnum,
     SkuPromotionsResponse,
     SettlePromotionBonusRequest,
@@ -25,7 +27,6 @@ import {
     SimulateCreditPlanRequest,
     SimulationResultResponse,
 } from "@fiado/type-kit/bin/loanOfferings/index.js";
-import { SegmentMembersResponse } from "./dtos/SegmentMembers.js";
 import { ILoanOfferingsBusinessApi } from "./interfaces/ILoanOfferingsBusinessApi.js";
 
 /**
@@ -174,6 +175,7 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
         return await this.httpRequest.get(url);
     }
 
+    /** @deprecated Usar `resolveSegmentMembers`: este GET solo mira la lista manual. */
     async getSegmentMembers(
         retailCustomerIds: string[],
         tenantId: string,
@@ -186,6 +188,14 @@ export default class LoanOfferingsBusinessApi implements ILoanOfferingsBusinessA
         return await this.httpRequest.get(url);
     }
 
+    async resolveSegmentMembers(
+        input: ResolveSegmentMembersRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SegmentMembersResponse>> {
+        const url = `${this.baseUrl}/private/segments/members?tenantId=${encodeURIComponent(tenantId)}`;
+        return await this.httpRequest.post(url, input);
+    }
+
     async listSegments(
         tenantId: string,
         status?: SegmentStatusEnum,

package/src/loanOfferings/api/dtos/SegmentMembers.ts

@@ -1,26 +1,14 @@
-/**
- * Tipos de la pertenencia a segmentos EN LOTE. Viven en esta lib (y no en `@fiado/type-kit`) porque
- * el type-kit todavía no modela esta vista reducida — el lambda destino la tiene como DTO local.
- */
+import type {
+    CustomerSegmentRef,
+    CustomerSegmentsItem,
+    SegmentMembersResponse,
+} from "@fiado/type-kit/bin/loanOfferings/index.js";
 
-/** Un segmento al que pertenece el cliente, con lo mínimo para pintarlo. */
-export interface CustomerSegmentMembership {
-    segmentId: string;
-    name: string;
-    /**
-     * Segmento por omisión del catálogo. Su semántica cambia por motor (alcanza a todos en
-     * promociones y a nadie en políticas), así que el consumidor decide si lo pinta.
-     */
-    isDefault: boolean;
-}
+/** Pertenencia a segmentos en lote. La forma vive en `@fiado/type-kit`. */
+export type { SegmentMembersResponse };
 
-/** Un cliente y los segmentos que le tocan. `segments: []` afirma que no está en ninguno. */
-export interface SegmentMembersItem {
-    retailCustomerId: string;
-    segments: CustomerSegmentMembership[];
-}
+/** @deprecated Usar `CustomerSegmentRef` de `@fiado/type-kit/bin/loanOfferings`. */
+export type CustomerSegmentMembership = CustomerSegmentRef;
 
-/** Una fila por cada id PEDIDO, no por cada id con segmentos. */
-export interface SegmentMembersResponse {
-    items: SegmentMembersItem[];
-}
+/** @deprecated Usar `CustomerSegmentsItem` de `@fiado/type-kit/bin/loanOfferings`. */
+export type SegmentMembersItem = CustomerSegmentsItem;

package/src/loanOfferings/api/interfaces/ILoanOfferingsBusinessApi.ts

@@ -1,5 +1,4 @@
 import { StandardResponse } from "@fiado/gateway-adapter";
-import { SegmentMembersResponse } from "../dtos/SegmentMembers.js";
 import {
     ListPromotedSkusRequest,
     ListSkuPromotionsRequest,
@@ -15,8 +14,10 @@ import {
     ReservePromotionBonusResponse,
     ResolveCustomerSegmentsRequest,
     ResolveCustomerSegmentsResponse,
+    ResolveSegmentMembersRequest,
     ScopeWidePromotionsResponse,
     SegmentCatalogResponse,
+    SegmentMembersResponse,
     SegmentStatusEnum,
     SkuPromotionsResponse,
     SettlePromotionBonusRequest,
@@ -158,11 +159,10 @@ export interface ILoanOfferingsBusinessApi {
 
     /**
      * POST /private/segments/resolve — los segmentos a los que pertenece el cliente HOY, evaluados
-     * en línea contra los hechos que manda el caller. No hay segmento persistido en el cliente.
+     * en línea con sus cohorts. No hay segmento persistido en el cliente.
      *
-     * Los hechos los junta quien ya tiene al cliente delante; este lambda no sale a buscarlos a
-     * otro silo. Un hecho AUSENTE hace que su filtro NO se cumpla: sin el dato no se puede afirmar
-     * que el cliente califica, y de las dos salidas la segura es dejarlo fuera.
+     * Los datos del cliente son opcionales: si el caller no los manda, loan-offerings los pide a
+     * loan-credit. Un dato ausente hace que su condición no se cumpla.
      *
      * `segmentIds` puede venir VACÍO y eso no es un error: significa que el cliente está en
      * Estándar, el catch-all, que nunca se devuelve aquí.
@@ -249,12 +249,29 @@ export interface ILoanOfferingsBusinessApi {
      *
      * @throws `400 SEGMENT_MEMBERS_BATCH_TOO_LARGE` si el lote pasa de 100 ids.
      * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
+     * @deprecated Solo cruza la lista manual del segmento, no evalúa cohorts. Usar
+     *             {@link resolveSegmentMembers}.
      */
     getSegmentMembers(
         retailCustomerIds: string[],
         tenantId: string,
     ): Promise<StandardResponse<SegmentMembersResponse>>;
 
+    /**
+     * `POST /private/segments/members` — pertenencia a segmentos EN LOTE, evaluando cohorts y lista
+     * manual igual que el resolve. Hasta 100 clientes; cada uno viaja con sus datos si el caller
+     * los tiene.
+     *
+     * Devuelve una fila por cada cliente pedido, en el mismo orden.
+     *
+     * @throws `400` si el lote viene vacío, pasa de 100 o un dato tiene el tipo equivocado.
+     * @throws `400 UNKNOWN_TENANT` si el `tenantId` viene ausente o desconocido.
+     */
+    resolveSegmentMembers(
+        input: ResolveSegmentMembersRequest,
+        tenantId: string,
+    ): Promise<StandardResponse<SegmentMembersResponse>>;
+
     /**
      * `GET /private/segments` — catálogo de segmentos del silo, sin miembros; el catch-all viaja con `isDefault: true`.
      * Sin `status` devuelve todos los estados.