@fiado/type-kit 3.295.0 → 3.297.0

package/bin/country/enums/CountryId.d.ts

@@ -1,17 +1,48 @@
+/**
+ * Código ISO 3166-1 numérico del país. Es el valor que viaja en `countryId` por toda la plataforma y
+ * el que `fiado-address-lambda` usa para filtrar su dedup de domicilios.
+ *
+ * Cubre los 35 países soberanos de América más España. Las llaves son el alfa-3 (ISO 3166-1 alpha-3),
+ * así que convertir de alfa-3 a numérico es un acceso por llave.
+ *
+ * Estar acá NO significa que el país esté habilitado para operar: qué países acepta cada flujo lo
+ * decide cada consumidor (por ejemplo `PAISES_ACEPTADOS` en `kyc-metamap-webhook`).
+ */
 export declare enum CountryId {
+    ATG = "028",
     ARG = "032",
+    BHS = "044",
+    BRB = "052",
     BOL = "068",
+    BRA = "076",
+    BLZ = "084",
+    CAN = "124",
+    CHL = "152",
     COL = "170",
     CRI = "188",
     CUB = "192",
+    DMA = "212",
     DOM = "214",
     ECU = "218",
     SLV = "222",
+    GRD = "308",
     GTM = "320",
+    GUY = "328",
     HTI = "332",
     HND = "340",
     JAM = "388",
     MEX = "484",
     NIC = "558",
-    USA = "840"
+    PAN = "591",
+    PRY = "600",
+    PER = "604",
+    KNA = "659",
+    LCA = "662",
+    VCT = "670",
+    ESP = "724",
+    SUR = "740",
+    TTO = "780",
+    USA = "840",
+    URY = "858",
+    VEN = "862"
 }

package/bin/country/enums/CountryId.js

@@ -2,21 +2,52 @@
 //*
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CountryId = void 0;
+/**
+ * Código ISO 3166-1 numérico del país. Es el valor que viaja en `countryId` por toda la plataforma y
+ * el que `fiado-address-lambda` usa para filtrar su dedup de domicilios.
+ *
+ * Cubre los 35 países soberanos de América más España. Las llaves son el alfa-3 (ISO 3166-1 alpha-3),
+ * así que convertir de alfa-3 a numérico es un acceso por llave.
+ *
+ * Estar acá NO significa que el país esté habilitado para operar: qué países acepta cada flujo lo
+ * decide cada consumidor (por ejemplo `PAISES_ACEPTADOS` en `kyc-metamap-webhook`).
+ */
 var CountryId;
 (function (CountryId) {
+    CountryId["ATG"] = "028";
     CountryId["ARG"] = "032";
+    CountryId["BHS"] = "044";
+    CountryId["BRB"] = "052";
     CountryId["BOL"] = "068";
+    CountryId["BRA"] = "076";
+    CountryId["BLZ"] = "084";
+    CountryId["CAN"] = "124";
+    CountryId["CHL"] = "152";
     CountryId["COL"] = "170";
     CountryId["CRI"] = "188";
     CountryId["CUB"] = "192";
+    CountryId["DMA"] = "212";
     CountryId["DOM"] = "214";
     CountryId["ECU"] = "218";
     CountryId["SLV"] = "222";
+    CountryId["GRD"] = "308";
     CountryId["GTM"] = "320";
+    CountryId["GUY"] = "328";
     CountryId["HTI"] = "332";
     CountryId["HND"] = "340";
     CountryId["JAM"] = "388";
     CountryId["MEX"] = "484";
     CountryId["NIC"] = "558";
+    CountryId["PAN"] = "591";
+    CountryId["PRY"] = "600";
+    CountryId["PER"] = "604";
+    CountryId["KNA"] = "659";
+    CountryId["LCA"] = "662";
+    CountryId["VCT"] = "670";
+    CountryId["ESP"] = "724";
+    CountryId["SUR"] = "740";
+    CountryId["TTO"] = "780";
     CountryId["USA"] = "840";
+    CountryId["URY"] = "858";
+    CountryId["VEN"] = "862";
 })(CountryId || (exports.CountryId = CountryId = {}));

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/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.295.0",
+  "version": "3.297.0",
   "description": "",
   "main": "bin/index.js",
   "types": "bin/index.d.ts",

package/src/country/enums/CountryId.ts

@@ -1,20 +1,51 @@
 
 //*
 
+/**
+ * Código ISO 3166-1 numérico del país. Es el valor que viaja en `countryId` por toda la plataforma y
+ * el que `fiado-address-lambda` usa para filtrar su dedup de domicilios.
+ *
+ * Cubre los 35 países soberanos de América más España. Las llaves son el alfa-3 (ISO 3166-1 alpha-3),
+ * así que convertir de alfa-3 a numérico es un acceso por llave.
+ *
+ * Estar acá NO significa que el país esté habilitado para operar: qué países acepta cada flujo lo
+ * decide cada consumidor (por ejemplo `PAISES_ACEPTADOS` en `kyc-metamap-webhook`).
+ */
 export enum CountryId {
+    ATG = "028",
     ARG = "032",
+    BHS = "044",
+    BRB = "052",
     BOL = "068",
+    BRA = "076",
+    BLZ = "084",
+    CAN = "124",
+    CHL = "152",
     COL = "170",
     CRI = "188",
     CUB = "192",
+    DMA = "212",
     DOM = "214",
     ECU = "218",
     SLV = "222",
+    GRD = "308",
     GTM = "320",
+    GUY = "328",
     HTI = "332",
     HND = "340",
     JAM = "388",
     MEX = "484",
     NIC = "558",
+    PAN = "591",
+    PRY = "600",
+    PER = "604",
+    KNA = "659",
+    LCA = "662",
+    VCT = "670",
+    ESP = "724",
+    SUR = "740",
+    TTO = "780",
     USA = "840",
-}
+    URY = "858",
+    VEN = "862",
+}

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/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';