@fiado/type-kit 3.303.0 → 3.305.0

package/bin/index.d.ts

@@ -111,3 +111,4 @@ export * as PhoneSales from './phoneSales';
 export * as Shipping from './shipping';
 export * as Collection from './collection';
 export * as UserConfirmations from './userConfirmations';
+export * as PeopleBusiness from './peopleBusiness';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.LoanConfig = exports.DatalakeQuery = exports.RetailWizard = exports.RetailCustomer = exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = void 0;
-exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = void 0;
+exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -207,3 +207,5 @@ exports.Collection = __importStar(require("./collection"));
 // UserConfirmations: contrato del motor de confirmaciones pendientes (people-business ↔ app) —
 // la app consulta qué confirmaciones mostrar al usuario (verificar email, …) y reporta descartes.
 exports.UserConfirmations = __importStar(require("./userConfirmations"));
+// PeopleBusiness: contrato de lectura por lote de People_GT + AccountRequirementControl_GT.
+exports.PeopleBusiness = __importStar(require("./peopleBusiness"));

package/bin/peopleBusiness/dtos/AccountRequirementControlRecord.d.ts

@@ -0,0 +1,6 @@
+import { PeopleResponse } from '../../identity/dtos/PeopleResponse';
+/**
+ * Fila de AccountRequirementControl_GT, con el mismo shape que identity ya publica anidado
+ * dentro de PeopleResponse.
+ */
+export type AccountRequirementControlRecord = PeopleResponse['accountRequirementControl'];

package/bin/peopleBusiness/dtos/AccountRequirementControlRecord.js

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

package/bin/peopleBusiness/dtos/PeopleBatchItem.d.ts

@@ -0,0 +1,11 @@
+import { AccountRequirementControlRecord } from './AccountRequirementControlRecord';
+import { PeopleRecord } from './PeopleRecord';
+/**
+ * Un peopleId del lote con lo que se encontró de él. Cada tabla viene en null si no se pidió
+ * en el include o si esa tabla no tiene fila para ese id.
+ */
+export declare class PeopleBatchItem {
+    id: string;
+    people: PeopleRecord | null;
+    accountRequirementControl: AccountRequirementControlRecord | null;
+}

package/bin/peopleBusiness/dtos/PeopleBatchItem.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeopleBatchItem = void 0;
+/**
+ * Un peopleId del lote con lo que se encontró de él. Cada tabla viene en null si no se pidió
+ * en el include o si esa tabla no tiene fila para ese id.
+ */
+class PeopleBatchItem {
+}
+exports.PeopleBatchItem = PeopleBatchItem;

package/bin/peopleBusiness/dtos/PeopleBatchResponse.d.ts

@@ -0,0 +1,9 @@
+import { PeopleBatchItem } from './PeopleBatchItem';
+/**
+ * Respuesta del lote. `items` sale en el orden en que llegaron los ids; `notFound` lista los
+ * que ninguna de las tablas pedidas devolvió, porque DynamoDB no avisa cuáles faltaron.
+ */
+export declare class PeopleBatchResponse {
+    items: PeopleBatchItem[];
+    notFound: string[];
+}

package/bin/peopleBusiness/dtos/PeopleBatchResponse.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeopleBatchResponse = void 0;
+/**
+ * Respuesta del lote. `items` sale en el orden en que llegaron los ids; `notFound` lista los
+ * que ninguna de las tablas pedidas devolvió, porque DynamoDB no avisa cuáles faltaron.
+ */
+class PeopleBatchResponse {
+}
+exports.PeopleBatchResponse = PeopleBatchResponse;

package/bin/peopleBusiness/dtos/PeopleRecord.d.ts

@@ -0,0 +1,5 @@
+import { PeopleResponse } from '../../identity/dtos/PeopleResponse';
+/**
+ * Fila de People_GT sin el join de accountRequirementControl, que en el lote viaja aparte.
+ */
+export type PeopleRecord = Omit<PeopleResponse, 'accountRequirementControl'>;

package/bin/peopleBusiness/dtos/PeopleRecord.js

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

package/bin/peopleBusiness/enums/PeopleBatchIncludeEnum.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Tabla que el lector quiere en el lote. Ausente = las dos.
+ */
+export declare enum PeopleBatchIncludeEnum {
+    PEOPLE = "people",
+    ACCOUNT = "account"
+}

package/bin/peopleBusiness/enums/PeopleBatchIncludeEnum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PeopleBatchIncludeEnum = void 0;
+/**
+ * Tabla que el lector quiere en el lote. Ausente = las dos.
+ */
+var PeopleBatchIncludeEnum;
+(function (PeopleBatchIncludeEnum) {
+    PeopleBatchIncludeEnum["PEOPLE"] = "people";
+    PeopleBatchIncludeEnum["ACCOUNT"] = "account";
+})(PeopleBatchIncludeEnum || (exports.PeopleBatchIncludeEnum = PeopleBatchIncludeEnum = {}));

package/bin/peopleBusiness/index.d.ts

@@ -0,0 +1,5 @@
+export * from './enums/PeopleBatchIncludeEnum';
+export * from './dtos/PeopleRecord';
+export * from './dtos/AccountRequirementControlRecord';
+export * from './dtos/PeopleBatchItem';
+export * from './dtos/PeopleBatchResponse';

package/bin/peopleBusiness/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./enums/PeopleBatchIncludeEnum"), exports);
+__exportStar(require("./dtos/PeopleRecord"), exports);
+__exportStar(require("./dtos/AccountRequirementControlRecord"), exports);
+__exportStar(require("./dtos/PeopleBatchItem"), exports);
+__exportStar(require("./dtos/PeopleBatchResponse"), exports);

package/bin/retailWizard/dtos/WizardResumeTarget.d.ts

@@ -0,0 +1,11 @@
+import type { ResumeReasonEnum } from '../enums/ResumeReasonEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+/**
+ * A qué paso aterriza el comprador al reanudar una venta a medias, y por qué. Lo calcula el silo:
+ * es regla de negocio y el front solo navega a lo que le digan.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardResumeTarget {
+    step: WizardStepEnum;
+    reason: ResumeReasonEnum;
+}

package/bin/retailWizard/dtos/WizardResumeTarget.js

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

package/bin/retailWizard/dtos/WizardSession.d.ts

@@ -8,6 +8,7 @@ import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardProduct } from './WizardProduct';
+import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 /** Modalidad de captura del KYC (M1 §213-329). */
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
@@ -43,6 +44,20 @@ export interface WizardSession {
     state: WizardStateEnum;
     otpVerified: boolean;
     otpSkipped: boolean;
+    /**
+     * Hay una reanudación esperando su OTP. Retomar una venta a medias pide la prueba del teléfono de
+     * nuevo, aunque `otpVerified` ya esté en `true` de la vez anterior — por eso son campos distintos.
+     *
+     * Opcional: es aditivo sobre un contrato ya publicado. Ausente = no hay reanudación en curso.
+     */
+    resumeOtpRequired?: boolean;
+    /**
+     * Primer hueco del onboarding: a qué paso aterriza el comprador al reanudar, y por qué. Lo calcula
+     * el silo — es regla de negocio, no navegación.
+     *
+     * Opcional por lo mismo que `resumeOtpRequired`: un consumidor que no lo conoce sigue igual.
+     */
+    resumeTarget?: WizardResumeTarget | null;
     consents: WizardConsents | null;
     /** Espejo del estado KYC (fuente = customer). */
     kycStatus: string | null;

package/bin/retailWizard/enums/ResumeReasonEnum.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Por qué el wizard manda al comprador a ese paso al reanudar una venta a medias. El silo busca el
+ * PRIMER hueco del onboarding de arriba hacia abajo: cuenta → KYC → domicilio → preguntas.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export declare enum ResumeReasonEnum {
+    /** La cuenta PagoConFiado ya está lista: no falta nada del onboarding, se vuelve al paso donde quedó. */
+    ACCOUNT_READY = "ACCOUNT_READY",
+    /** El KYC no cerró verificado: se rehace desde el principio. */
+    KYC_PENDING = "KYC_PENDING",
+    /** El expediente quedó sin domicilio: toca el comprobante. */
+    ADDRESS_PENDING = "ADDRESS_PENDING",
+    /** Falta la ocupación o el ingreso mensual. */
+    PROFILE_PENDING = "PROFILE_PENDING",
+    /** El expediente está completo y la cuenta todavía no abre. */
+    ACCOUNT_PENDING = "ACCOUNT_PENDING"
+}

package/bin/retailWizard/enums/ResumeReasonEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResumeReasonEnum = void 0;
+/**
+ * Por qué el wizard manda al comprador a ese paso al reanudar una venta a medias. El silo busca el
+ * PRIMER hueco del onboarding de arriba hacia abajo: cuenta → KYC → domicilio → preguntas.
+ * SureKeep Fase 2 — pista Retail.
+ */
+var ResumeReasonEnum;
+(function (ResumeReasonEnum) {
+    /** La cuenta PagoConFiado ya está lista: no falta nada del onboarding, se vuelve al paso donde quedó. */
+    ResumeReasonEnum["ACCOUNT_READY"] = "ACCOUNT_READY";
+    /** El KYC no cerró verificado: se rehace desde el principio. */
+    ResumeReasonEnum["KYC_PENDING"] = "KYC_PENDING";
+    /** El expediente quedó sin domicilio: toca el comprobante. */
+    ResumeReasonEnum["ADDRESS_PENDING"] = "ADDRESS_PENDING";
+    /** Falta la ocupación o el ingreso mensual. */
+    ResumeReasonEnum["PROFILE_PENDING"] = "PROFILE_PENDING";
+    /** El expediente está completo y la cuenta todavía no abre. */
+    ResumeReasonEnum["ACCOUNT_PENDING"] = "ACCOUNT_PENDING";
+})(ResumeReasonEnum || (exports.ResumeReasonEnum = ResumeReasonEnum = {}));

package/bin/retailWizard/index.d.ts

@@ -16,6 +16,7 @@ export * from './enums/BeneficiaryRelationEnum';
 export * from './enums/AccountVerdictEnum';
 export * from './enums/AccountOutcomeEnum';
 export * from './enums/AccountStepStatusEnum';
+export * from './enums/ResumeReasonEnum';
 export * from './dtos/WizardConsents';
 export * from './dtos/WizardPayment';
 export * from './dtos/WizardProduct';
@@ -26,6 +27,7 @@ export * from './dtos/WizardBeneficiary';
 export * from './dtos/WizardLoan';
 export * from './dtos/WizardCreditSummary';
 export * from './dtos/AccountStep';
+export * from './dtos/WizardResumeTarget';
 export * from './dtos/WizardSession';
 export * from './dtos/OtpVerification';
 export * from './dtos/Sale';

package/bin/retailWizard/index.js

@@ -34,6 +34,7 @@ __exportStar(require("./enums/BeneficiaryRelationEnum"), exports);
 __exportStar(require("./enums/AccountVerdictEnum"), exports);
 __exportStar(require("./enums/AccountOutcomeEnum"), exports);
 __exportStar(require("./enums/AccountStepStatusEnum"), exports);
+__exportStar(require("./enums/ResumeReasonEnum"), exports);
 // DTOs anidados
 __exportStar(require("./dtos/WizardConsents"), exports);
 __exportStar(require("./dtos/WizardPayment"), exports);
@@ -45,6 +46,7 @@ __exportStar(require("./dtos/WizardBeneficiary"), exports);
 __exportStar(require("./dtos/WizardLoan"), exports);
 __exportStar(require("./dtos/WizardCreditSummary"), exports);
 __exportStar(require("./dtos/AccountStep"), exports);
+__exportStar(require("./dtos/WizardResumeTarget"), exports);
 // Entidades principales (shapes de estado/persistencia — planas)
 __exportStar(require("./dtos/WizardSession"), exports);
 __exportStar(require("./dtos/OtpVerification"), exports);

package/package.json

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

package/src/index.ts

@@ -166,3 +166,5 @@ export * as Collection from './collection';
 // UserConfirmations: contrato del motor de confirmaciones pendientes (people-business ↔ app) —
 // la app consulta qué confirmaciones mostrar al usuario (verificar email, …) y reporta descartes.
 export * as UserConfirmations from './userConfirmations';
+// PeopleBusiness: contrato de lectura por lote de People_GT + AccountRequirementControl_GT.
+export * as PeopleBusiness from './peopleBusiness';

package/src/peopleBusiness/dtos/AccountRequirementControlRecord.ts

@@ -0,0 +1,7 @@
+import { PeopleResponse } from '../../identity/dtos/PeopleResponse';
+
+/**
+ * Fila de AccountRequirementControl_GT, con el mismo shape que identity ya publica anidado
+ * dentro de PeopleResponse.
+ */
+export type AccountRequirementControlRecord = PeopleResponse['accountRequirementControl'];

package/src/peopleBusiness/dtos/PeopleBatchItem.ts

@@ -0,0 +1,12 @@
+import { AccountRequirementControlRecord } from './AccountRequirementControlRecord';
+import { PeopleRecord } from './PeopleRecord';
+
+/**
+ * Un peopleId del lote con lo que se encontró de él. Cada tabla viene en null si no se pidió
+ * en el include o si esa tabla no tiene fila para ese id.
+ */
+export class PeopleBatchItem {
+    id!: string;
+    people!: PeopleRecord | null;
+    accountRequirementControl!: AccountRequirementControlRecord | null;
+}

package/src/peopleBusiness/dtos/PeopleBatchResponse.ts

@@ -0,0 +1,10 @@
+import { PeopleBatchItem } from './PeopleBatchItem';
+
+/**
+ * Respuesta del lote. `items` sale en el orden en que llegaron los ids; `notFound` lista los
+ * que ninguna de las tablas pedidas devolvió, porque DynamoDB no avisa cuáles faltaron.
+ */
+export class PeopleBatchResponse {
+    items!: PeopleBatchItem[];
+    notFound!: string[];
+}

package/src/peopleBusiness/dtos/PeopleRecord.ts

@@ -0,0 +1,6 @@
+import { PeopleResponse } from '../../identity/dtos/PeopleResponse';
+
+/**
+ * Fila de People_GT sin el join de accountRequirementControl, que en el lote viaja aparte.
+ */
+export type PeopleRecord = Omit<PeopleResponse, 'accountRequirementControl'>;

package/src/peopleBusiness/enums/PeopleBatchIncludeEnum.ts

@@ -0,0 +1,7 @@
+/**
+ * Tabla que el lector quiere en el lote. Ausente = las dos.
+ */
+export enum PeopleBatchIncludeEnum {
+    PEOPLE = 'people',
+    ACCOUNT = 'account',
+}

package/src/peopleBusiness/index.ts

@@ -0,0 +1,5 @@
+export * from './enums/PeopleBatchIncludeEnum';
+export * from './dtos/PeopleRecord';
+export * from './dtos/AccountRequirementControlRecord';
+export * from './dtos/PeopleBatchItem';
+export * from './dtos/PeopleBatchResponse';

package/src/retailWizard/dtos/WizardResumeTarget.ts

@@ -0,0 +1,12 @@
+import type { ResumeReasonEnum } from '../enums/ResumeReasonEnum';
+import type { WizardStepEnum } from '../enums/WizardStepEnum';
+
+/**
+ * A qué paso aterriza el comprador al reanudar una venta a medias, y por qué. Lo calcula el silo:
+ * es regla de negocio y el front solo navega a lo que le digan.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export interface WizardResumeTarget {
+    step: WizardStepEnum;
+    reason: ResumeReasonEnum;
+}

package/src/retailWizard/dtos/WizardSession.ts

@@ -8,6 +8,7 @@ import type { WizardConsents } from './WizardConsents';
 import type { WizardLoan } from './WizardLoan';
 import type { WizardPayment } from './WizardPayment';
 import type { WizardProduct } from './WizardProduct';
+import type { WizardResumeTarget } from './WizardResumeTarget';
 import type { WizardWelcome } from './WizardWelcome';
 
 /** Modalidad de captura del KYC (M1 §213-329). */
@@ -47,6 +48,20 @@ export interface WizardSession {
   state: WizardStateEnum;
   otpVerified: boolean;
   otpSkipped: boolean;
+  /**
+   * Hay una reanudación esperando su OTP. Retomar una venta a medias pide la prueba del teléfono de
+   * nuevo, aunque `otpVerified` ya esté en `true` de la vez anterior — por eso son campos distintos.
+   *
+   * Opcional: es aditivo sobre un contrato ya publicado. Ausente = no hay reanudación en curso.
+   */
+  resumeOtpRequired?: boolean;
+  /**
+   * Primer hueco del onboarding: a qué paso aterriza el comprador al reanudar, y por qué. Lo calcula
+   * el silo — es regla de negocio, no navegación.
+   *
+   * Opcional por lo mismo que `resumeOtpRequired`: un consumidor que no lo conoce sigue igual.
+   */
+  resumeTarget?: WizardResumeTarget | null;
   consents: WizardConsents | null;
   /** Espejo del estado KYC (fuente = customer). */
   kycStatus: string | null;

package/src/retailWizard/enums/ResumeReasonEnum.ts

@@ -0,0 +1,17 @@
+/**
+ * Por qué el wizard manda al comprador a ese paso al reanudar una venta a medias. El silo busca el
+ * PRIMER hueco del onboarding de arriba hacia abajo: cuenta → KYC → domicilio → preguntas.
+ * SureKeep Fase 2 — pista Retail.
+ */
+export enum ResumeReasonEnum {
+    /** La cuenta PagoConFiado ya está lista: no falta nada del onboarding, se vuelve al paso donde quedó. */
+    ACCOUNT_READY = 'ACCOUNT_READY',
+    /** El KYC no cerró verificado: se rehace desde el principio. */
+    KYC_PENDING = 'KYC_PENDING',
+    /** El expediente quedó sin domicilio: toca el comprobante. */
+    ADDRESS_PENDING = 'ADDRESS_PENDING',
+    /** Falta la ocupación o el ingreso mensual. */
+    PROFILE_PENDING = 'PROFILE_PENDING',
+    /** El expediente está completo y la cuenta todavía no abre. */
+    ACCOUNT_PENDING = 'ACCOUNT_PENDING',
+}

package/src/retailWizard/index.ts

@@ -19,6 +19,7 @@ export * from './enums/BeneficiaryRelationEnum';
 export * from './enums/AccountVerdictEnum';
 export * from './enums/AccountOutcomeEnum';
 export * from './enums/AccountStepStatusEnum';
+export * from './enums/ResumeReasonEnum';
 
 // DTOs anidados
 export * from './dtos/WizardConsents';
@@ -31,6 +32,7 @@ export * from './dtos/WizardBeneficiary';
 export * from './dtos/WizardLoan';
 export * from './dtos/WizardCreditSummary';
 export * from './dtos/AccountStep';
+export * from './dtos/WizardResumeTarget';
 
 // Entidades principales (shapes de estado/persistencia — planas)
 export * from './dtos/WizardSession';