@fiado/type-kit 3.296.0 → 3.298.0

package/_test_/unit/auth/SignUpProspectRequest.test.ts

@@ -12,6 +12,14 @@ describe('SignUpProspectRequest', () => {
     expect(await validate(dto as object)).toHaveLength(0);
   });
 
+  it('acepta un alta sin nombre — la persona queda sin preferredName', async () => {
+    const dto = plainToInstance(SignUpProspectRequest,
+      { phoneNumber: '5512345678', tenantId: 'surekeep' },
+      { excludeExtraneousValues: true });
+
+    expect(await validate(dto as object)).toHaveLength(0);
+  });
+
   it('rechaza si falta el tenantId (el hardcode FIADO_BETA es justo lo que se elimina)', async () => {
     const dto = plainToInstance(SignUpProspectRequest,
       { name: 'Paulina Garcia', phoneNumber: '5512345678' },

package/bin/auth/dtos/SignUpProspectRequest.d.ts

@@ -5,10 +5,11 @@
  * `tenantId` es OBLIGATORIO y explícito: la variante de agente lo tiene hardcodeado a
  * `FIADO_BETA`, y eliminar ese hardcode es parte del contrato de este endpoint privado.
  *
- * ⚠️ PII: nombre y teléfono — nunca loguear el request completo.
+ * ⚠️ PII: teléfono — nunca loguear el request completo.
  */
 export declare class SignUpProspectRequest {
-    name: string;
+    /** Opcional: sin nombre la persona se crea sin `preferredName`; el real lo escribe el KYC después. */
+    name?: string;
     phoneNumber: string;
     /** Decidido: sin `@Matches(/^[a-z0-9-]+$/)` — `FIADO_BETA` es un tenant real y ese regex lo rechazaría. */
     tenantId: string;

package/bin/auth/dtos/SignUpProspectRequest.js

@@ -19,13 +19,14 @@ const class_validator_1 = require("class-validator");
  * `tenantId` es OBLIGATORIO y explícito: la variante de agente lo tiene hardcodeado a
  * `FIADO_BETA`, y eliminar ese hardcode es parte del contrato de este endpoint privado.
  *
- * ⚠️ PII: nombre y teléfono — nunca loguear el request completo.
+ * ⚠️ PII: teléfono — nunca loguear el request completo.
  */
 class SignUpProspectRequest {
 }
 exports.SignUpProspectRequest = SignUpProspectRequest;
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     (0, class_validator_1.IsNotEmpty)(),
     __metadata("design:type", String)

package/bin/index.d.ts

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

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.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = 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.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -204,3 +204,6 @@ exports.Shipping = __importStar(require("./shipping"));
 // CollectResponse el contrato dominio↔motor; AuthorizeCollectionMovementRequest/Response el
 // contrato motor↔processor. Ver spec 2026-07-29-motor-cobro-central-design.
 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"));

package/bin/retailWizard/dtos/requests/ConsentsRequest.d.ts

@@ -2,10 +2,8 @@ import { WizardConsents } from '../WizardConsents';
 /**
  * POST /wizard/sessions/:id/consents — registra los consentimientos VL + contrato PCF. Dispara la
  * tríada Fiado idempotente (D26): lookup directory por phone → reusa o crea onboarding+people+directory.
- * Puede incluir el nombre del cliente (para el signUpProspect si no existe todavía). SureKeep Fase 2 — pista Retail.
+ * SureKeep Fase 2 — pista Retail.
  */
 export declare class ConsentsRequest {
     consents: WizardConsents;
-    /** Nombre del cliente (para la creación de identidad Fiado si aún no existe). */
-    customerName?: string;
 }

package/bin/retailWizard/dtos/requests/ConsentsRequest.js

@@ -16,7 +16,7 @@ const WizardConsents_1 = require("../WizardConsents");
 /**
  * POST /wizard/sessions/:id/consents — registra los consentimientos VL + contrato PCF. Dispara la
  * tríada Fiado idempotente (D26): lookup directory por phone → reusa o crea onboarding+people+directory.
- * Puede incluir el nombre del cliente (para el signUpProspect si no existe todavía). SureKeep Fase 2 — pista Retail.
+ * SureKeep Fase 2 — pista Retail.
  */
 class ConsentsRequest {
 }
@@ -27,9 +27,3 @@ __decorate([
     (0, class_validator_1.ValidateNested)(),
     __metadata("design:type", WizardConsents_1.WizardConsents)
 ], ConsentsRequest.prototype, "consents", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsString)(),
-    __metadata("design:type", String)
-], ConsentsRequest.prototype, "customerName", void 0);

package/bin/userConfirmations/dtos/ConfirmationDismissRequest.d.ts

@@ -0,0 +1,7 @@
+import { ConfirmationTypeEnum } from '../enums/ConfirmationTypeEnum';
+/**
+ * Solicitud del usuario para descartar una confirmación pendiente.
+ */
+export declare class ConfirmationDismissRequest {
+    confirmationType: ConfirmationTypeEnum;
+}

package/bin/userConfirmations/dtos/ConfirmationDismissRequest.js

@@ -0,0 +1,26 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmationDismissRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const ConfirmationTypeEnum_1 = require("../enums/ConfirmationTypeEnum");
+/**
+ * Solicitud del usuario para descartar una confirmación pendiente.
+ */
+class ConfirmationDismissRequest {
+}
+exports.ConfirmationDismissRequest = ConfirmationDismissRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEnum)(ConfirmationTypeEnum_1.ConfirmationTypeEnum),
+    __metadata("design:type", String)
+], ConfirmationDismissRequest.prototype, "confirmationType", void 0);

package/bin/userConfirmations/dtos/ConfirmationDismissResponse.d.ts

@@ -0,0 +1,8 @@
+import { ConfirmationTypeEnum } from '../enums/ConfirmationTypeEnum';
+/**
+ * Confirmación descartada y el momento del descarte (epoch ms).
+ */
+export declare class ConfirmationDismissResponse {
+    confirmationType: ConfirmationTypeEnum;
+    dismissedAt: number;
+}

package/bin/userConfirmations/dtos/ConfirmationDismissResponse.js

@@ -0,0 +1,28 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmationDismissResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+const ConfirmationTypeEnum_1 = require("../enums/ConfirmationTypeEnum");
+/**
+ * Confirmación descartada y el momento del descarte (epoch ms).
+ */
+class ConfirmationDismissResponse {
+}
+exports.ConfirmationDismissResponse = ConfirmationDismissResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], ConfirmationDismissResponse.prototype, "confirmationType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], ConfirmationDismissResponse.prototype, "dismissedAt", void 0);

package/bin/userConfirmations/dtos/EmailConfirmationPayload.d.ts

@@ -0,0 +1,8 @@
+import { EmailVerificationStatusEnum } from '../../emailVerification/enums/EmailVerificationStatusEnum';
+/**
+ * Payload de la confirmación EMAIL_VERIFICATION: el email pendiente y su estado actual.
+ */
+export declare class EmailConfirmationPayload {
+    email: string;
+    status: EmailVerificationStatusEnum;
+}

package/bin/userConfirmations/dtos/EmailConfirmationPayload.js

@@ -0,0 +1,28 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailConfirmationPayload = void 0;
+const class_transformer_1 = require("class-transformer");
+const EmailVerificationStatusEnum_1 = require("../../emailVerification/enums/EmailVerificationStatusEnum");
+/**
+ * Payload de la confirmación EMAIL_VERIFICATION: el email pendiente y su estado actual.
+ */
+class EmailConfirmationPayload {
+}
+exports.EmailConfirmationPayload = EmailConfirmationPayload;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], EmailConfirmationPayload.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], EmailConfirmationPayload.prototype, "status", void 0);

package/bin/userConfirmations/dtos/PendingConfirmationItem.d.ts

@@ -0,0 +1,13 @@
+import { ConfirmationTypeEnum } from '../enums/ConfirmationTypeEnum';
+import { ConfirmationDisplayModeEnum } from '../enums/ConfirmationDisplayModeEnum';
+import { EmailConfirmationPayload } from './EmailConfirmationPayload';
+/**
+ * Una confirmación pendiente que la app debe mostrarle al usuario.
+ */
+export declare class PendingConfirmationItem {
+    confirmationType: ConfirmationTypeEnum;
+    priority: number;
+    displayMode: ConfirmationDisplayModeEnum;
+    /** Presente solo cuando confirmationType === EMAIL_VERIFICATION. */
+    payload?: EmailConfirmationPayload;
+}

package/bin/userConfirmations/dtos/PendingConfirmationItem.js

@@ -0,0 +1,38 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingConfirmationItem = void 0;
+const class_transformer_1 = require("class-transformer");
+const ConfirmationTypeEnum_1 = require("../enums/ConfirmationTypeEnum");
+const ConfirmationDisplayModeEnum_1 = require("../enums/ConfirmationDisplayModeEnum");
+const EmailConfirmationPayload_1 = require("./EmailConfirmationPayload");
+/**
+ * Una confirmación pendiente que la app debe mostrarle al usuario.
+ */
+class PendingConfirmationItem {
+}
+exports.PendingConfirmationItem = PendingConfirmationItem;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], PendingConfirmationItem.prototype, "confirmationType", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Number)
+], PendingConfirmationItem.prototype, "priority", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", String)
+], PendingConfirmationItem.prototype, "displayMode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", EmailConfirmationPayload_1.EmailConfirmationPayload)
+], PendingConfirmationItem.prototype, "payload", void 0);

package/bin/userConfirmations/dtos/PendingConfirmationsResponse.d.ts

@@ -0,0 +1,7 @@
+import { PendingConfirmationItem } from './PendingConfirmationItem';
+/**
+ * Confirmaciones pendientes del usuario, ordenadas por prioridad.
+ */
+export declare class PendingConfirmationsResponse {
+    items: PendingConfirmationItem[];
+}

package/bin/userConfirmations/dtos/PendingConfirmationsResponse.js

@@ -0,0 +1,23 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PendingConfirmationsResponse = void 0;
+const class_transformer_1 = require("class-transformer");
+/**
+ * Confirmaciones pendientes del usuario, ordenadas por prioridad.
+ */
+class PendingConfirmationsResponse {
+}
+exports.PendingConfirmationsResponse = PendingConfirmationsResponse;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    __metadata("design:type", Array)
+], PendingConfirmationsResponse.prototype, "items", void 0);

package/bin/userConfirmations/enums/ConfirmationDisplayModeEnum.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cómo debe presentar la app una confirmación pendiente.
+ * SINGLE: modal exclusivo, no se combina con otras confirmaciones.
+ * STACKABLE: puede apilarse junto a otras confirmaciones en la misma vista.
+ */
+export declare enum ConfirmationDisplayModeEnum {
+    SINGLE = "SINGLE",
+    STACKABLE = "STACKABLE"
+}

package/bin/userConfirmations/enums/ConfirmationDisplayModeEnum.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmationDisplayModeEnum = void 0;
+/**
+ * Cómo debe presentar la app una confirmación pendiente.
+ * SINGLE: modal exclusivo, no se combina con otras confirmaciones.
+ * STACKABLE: puede apilarse junto a otras confirmaciones en la misma vista.
+ */
+var ConfirmationDisplayModeEnum;
+(function (ConfirmationDisplayModeEnum) {
+    ConfirmationDisplayModeEnum["SINGLE"] = "SINGLE";
+    ConfirmationDisplayModeEnum["STACKABLE"] = "STACKABLE";
+})(ConfirmationDisplayModeEnum || (exports.ConfirmationDisplayModeEnum = ConfirmationDisplayModeEnum = {}));

package/bin/userConfirmations/enums/ConfirmationTypeEnum.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Tipo de confirmación pendiente que el motor de confirmaciones puede pedirle al usuario.
+ */
+export declare enum ConfirmationTypeEnum {
+    EMAIL_VERIFICATION = "EMAIL_VERIFICATION"
+}

package/bin/userConfirmations/enums/ConfirmationTypeEnum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfirmationTypeEnum = void 0;
+/**
+ * Tipo de confirmación pendiente que el motor de confirmaciones puede pedirle al usuario.
+ */
+var ConfirmationTypeEnum;
+(function (ConfirmationTypeEnum) {
+    ConfirmationTypeEnum["EMAIL_VERIFICATION"] = "EMAIL_VERIFICATION";
+})(ConfirmationTypeEnum || (exports.ConfirmationTypeEnum = ConfirmationTypeEnum = {}));

package/bin/userConfirmations/index.d.ts

@@ -0,0 +1,7 @@
+export * from './enums/ConfirmationTypeEnum';
+export * from './enums/ConfirmationDisplayModeEnum';
+export * from './dtos/EmailConfirmationPayload';
+export * from './dtos/PendingConfirmationItem';
+export * from './dtos/PendingConfirmationsResponse';
+export * from './dtos/ConfirmationDismissRequest';
+export * from './dtos/ConfirmationDismissResponse';

package/bin/userConfirmations/index.js

@@ -0,0 +1,23 @@
+"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/ConfirmationTypeEnum"), exports);
+__exportStar(require("./enums/ConfirmationDisplayModeEnum"), exports);
+__exportStar(require("./dtos/EmailConfirmationPayload"), exports);
+__exportStar(require("./dtos/PendingConfirmationItem"), exports);
+__exportStar(require("./dtos/PendingConfirmationsResponse"), exports);
+__exportStar(require("./dtos/ConfirmationDismissRequest"), exports);
+__exportStar(require("./dtos/ConfirmationDismissResponse"), exports);

package/package.json

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

package/src/auth/dtos/SignUpProspectRequest.ts

@@ -1,5 +1,5 @@
 import { Expose } from 'class-transformer';
-import { IsNotEmpty, IsString } from 'class-validator';
+import { IsNotEmpty, IsOptional, IsString } from 'class-validator';
 
 /**
  * Alta de prospecto M2M en `auth-business` (crea onboarding + People + DirectoryUser).
@@ -8,11 +8,12 @@ import { IsNotEmpty, IsString } from 'class-validator';
  * `tenantId` es OBLIGATORIO y explícito: la variante de agente lo tiene hardcodeado a
  * `FIADO_BETA`, y eliminar ese hardcode es parte del contrato de este endpoint privado.
  *
- * ⚠️ PII: nombre y teléfono — nunca loguear el request completo.
+ * ⚠️ PII: teléfono — nunca loguear el request completo.
  */
 export class SignUpProspectRequest {
-    @Expose() @IsString() @IsNotEmpty()
-    name!: string;
+    /** Opcional: sin nombre la persona se crea sin `preferredName`; el real lo escribe el KYC después. */
+    @Expose() @IsOptional() @IsString() @IsNotEmpty()
+    name?: string;
 
     @Expose() @IsString() @IsNotEmpty()
     phoneNumber!: string;

package/src/index.ts

@@ -163,3 +163,6 @@ export * as Shipping from './shipping';
 // CollectResponse el contrato dominio↔motor; AuthorizeCollectionMovementRequest/Response el
 // contrato motor↔processor. Ver spec 2026-07-29-motor-cobro-central-design.
 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';

package/src/retailWizard/dtos/requests/ConsentsRequest.ts

@@ -1,21 +1,15 @@
 import { Expose, Type } from 'class-transformer';
-import { IsOptional, IsString, ValidateNested } from 'class-validator';
+import { ValidateNested } from 'class-validator';
 import { WizardConsents } from '../WizardConsents';
 
 /**
  * POST /wizard/sessions/:id/consents — registra los consentimientos VL + contrato PCF. Dispara la
  * tríada Fiado idempotente (D26): lookup directory por phone → reusa o crea onboarding+people+directory.
- * Puede incluir el nombre del cliente (para el signUpProspect si no existe todavía). SureKeep Fase 2 — pista Retail.
+ * SureKeep Fase 2 — pista Retail.
  */
 export class ConsentsRequest {
   @Expose()
   @Type(() => WizardConsents)
   @ValidateNested()
   consents!: WizardConsents;
-
-  /** Nombre del cliente (para la creación de identidad Fiado si aún no existe). */
-  @Expose()
-  @IsOptional()
-  @IsString()
-  customerName?: string;
 }

package/src/userConfirmations/dtos/ConfirmationDismissRequest.ts

@@ -0,0 +1,12 @@
+import { Expose } from 'class-transformer';
+import { IsEnum } from 'class-validator';
+import { ConfirmationTypeEnum } from '../enums/ConfirmationTypeEnum';
+
+/**
+ * Solicitud del usuario para descartar una confirmación pendiente.
+ */
+export class ConfirmationDismissRequest {
+    @Expose()
+    @IsEnum(ConfirmationTypeEnum)
+    confirmationType!: ConfirmationTypeEnum;
+}

package/src/userConfirmations/dtos/ConfirmationDismissResponse.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { ConfirmationTypeEnum } from '../enums/ConfirmationTypeEnum';
+
+/**
+ * Confirmación descartada y el momento del descarte (epoch ms).
+ */
+export class ConfirmationDismissResponse {
+    @Expose()
+    confirmationType!: ConfirmationTypeEnum;
+
+    @Expose()
+    dismissedAt!: number;
+}

package/src/userConfirmations/dtos/EmailConfirmationPayload.ts

@@ -0,0 +1,13 @@
+import { Expose } from 'class-transformer';
+import { EmailVerificationStatusEnum } from '../../emailVerification/enums/EmailVerificationStatusEnum';
+
+/**
+ * Payload de la confirmación EMAIL_VERIFICATION: el email pendiente y su estado actual.
+ */
+export class EmailConfirmationPayload {
+    @Expose()
+    email!: string;
+
+    @Expose()
+    status!: EmailVerificationStatusEnum;
+}

package/src/userConfirmations/dtos/PendingConfirmationItem.ts

@@ -0,0 +1,22 @@
+import { Expose } from 'class-transformer';
+import { ConfirmationTypeEnum } from '../enums/ConfirmationTypeEnum';
+import { ConfirmationDisplayModeEnum } from '../enums/ConfirmationDisplayModeEnum';
+import { EmailConfirmationPayload } from './EmailConfirmationPayload';
+
+/**
+ * Una confirmación pendiente que la app debe mostrarle al usuario.
+ */
+export class PendingConfirmationItem {
+    @Expose()
+    confirmationType!: ConfirmationTypeEnum;
+
+    @Expose()
+    priority!: number;
+
+    @Expose()
+    displayMode!: ConfirmationDisplayModeEnum;
+
+    /** Presente solo cuando confirmationType === EMAIL_VERIFICATION. */
+    @Expose()
+    payload?: EmailConfirmationPayload;
+}

package/src/userConfirmations/dtos/PendingConfirmationsResponse.ts

@@ -0,0 +1,10 @@
+import { Expose } from 'class-transformer';
+import { PendingConfirmationItem } from './PendingConfirmationItem';
+
+/**
+ * Confirmaciones pendientes del usuario, ordenadas por prioridad.
+ */
+export class PendingConfirmationsResponse {
+    @Expose()
+    items!: PendingConfirmationItem[];
+}

package/src/userConfirmations/enums/ConfirmationDisplayModeEnum.ts

@@ -0,0 +1,9 @@
+/**
+ * Cómo debe presentar la app una confirmación pendiente.
+ * SINGLE: modal exclusivo, no se combina con otras confirmaciones.
+ * STACKABLE: puede apilarse junto a otras confirmaciones en la misma vista.
+ */
+export enum ConfirmationDisplayModeEnum {
+    SINGLE = 'SINGLE',
+    STACKABLE = 'STACKABLE',
+}

package/src/userConfirmations/enums/ConfirmationTypeEnum.ts

@@ -0,0 +1,6 @@
+/**
+ * Tipo de confirmación pendiente que el motor de confirmaciones puede pedirle al usuario.
+ */
+export enum ConfirmationTypeEnum {
+    EMAIL_VERIFICATION = 'EMAIL_VERIFICATION',
+}

package/src/userConfirmations/index.ts

@@ -0,0 +1,7 @@
+export * from './enums/ConfirmationTypeEnum';
+export * from './enums/ConfirmationDisplayModeEnum';
+export * from './dtos/EmailConfirmationPayload';
+export * from './dtos/PendingConfirmationItem';
+export * from './dtos/PendingConfirmationsResponse';
+export * from './dtos/ConfirmationDismissRequest';
+export * from './dtos/ConfirmationDismissResponse';