@fiado/type-kit 3.214.0 → 3.216.0

package/bin/benefitCenter/enums/BenefitFlowEnum.d.ts

@@ -0,0 +1,11 @@
+export declare enum BenefitFlowEnum {
+    TOPUPS = "TOPUPS",
+    BILL_PAYMENT = "BILL_PAYMENT",
+    CREDIT = "CREDIT",
+    INSURANCE = "INSURANCE",
+    DONATION = "DONATION",
+    PHARMACY = "PHARMACY",
+    REMITTANCE = "REMITTANCE",
+    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
+    WALLET_FUNDING = "WALLET_FUNDING"
+}

package/bin/benefitCenter/enums/BenefitFlowEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BenefitFlowEnum = void 0;
+var BenefitFlowEnum;
+(function (BenefitFlowEnum) {
+    BenefitFlowEnum["TOPUPS"] = "TOPUPS";
+    BenefitFlowEnum["BILL_PAYMENT"] = "BILL_PAYMENT";
+    BenefitFlowEnum["CREDIT"] = "CREDIT";
+    BenefitFlowEnum["INSURANCE"] = "INSURANCE";
+    BenefitFlowEnum["DONATION"] = "DONATION";
+    BenefitFlowEnum["PHARMACY"] = "PHARMACY";
+    BenefitFlowEnum["REMITTANCE"] = "REMITTANCE";
+    /** Fondeo de wallet PCF con efectivo via provider externo (Equality/Passport, OpenPay, …) — spec 13. */
+    BenefitFlowEnum["WALLET_FUNDING"] = "WALLET_FUNDING";
+})(BenefitFlowEnum || (exports.BenefitFlowEnum = BenefitFlowEnum = {}));

package/bin/kyc/dtos/KycAddress.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Domicilio del INE ya normalizado por `places-business` (AWS Location), listo para que el consumidor
+ * arme su `AddressBase` local. Mapea el `AddressCandidate` de places a un shape con `@Expose`, porque
+ * el consumer parsea el evento con `excludeExtraneousValues` y descartaría todo campo sin exponer.
+ *
+ * Todos los campos son opcionales: el domicilio es best-effort (la OCR del INE + el geocoding pueden
+ * no resolver todo). ⚠️ PII: nunca loguear esta estructura.
+ */
+export declare class KycAddress {
+    /** Etiqueta completa legible (equivalente a Place.Label). */
+    label?: string;
+    street?: string;
+    /** Número exterior (Place.AddressNumber). */
+    addressNumber?: string;
+    neighborhood?: string;
+    municipality?: string;
+    /** Estado/provincia (Place.Region). */
+    region?: string;
+    postalCode?: string;
+    /** ISO3 del país (Place.Country). */
+    country?: string;
+    latitude?: number;
+    longitude?: number;
+}

package/bin/kyc/dtos/KycAddress.js

@@ -0,0 +1,85 @@
+"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.KycAddress = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Domicilio del INE ya normalizado por `places-business` (AWS Location), listo para que el consumidor
+ * arme su `AddressBase` local. Mapea el `AddressCandidate` de places a un shape con `@Expose`, porque
+ * el consumer parsea el evento con `excludeExtraneousValues` y descartaría todo campo sin exponer.
+ *
+ * Todos los campos son opcionales: el domicilio es best-effort (la OCR del INE + el geocoding pueden
+ * no resolver todo). ⚠️ PII: nunca loguear esta estructura.
+ */
+class KycAddress {
+}
+exports.KycAddress = KycAddress;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "label", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "street", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "addressNumber", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "neighborhood", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "municipality", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "region", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "postalCode", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    __metadata("design:type", String)
+], KycAddress.prototype, "country", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], KycAddress.prototype, "latitude", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsNumber)(),
+    __metadata("design:type", Number)
+], KycAddress.prototype, "longitude", void 0);

package/bin/kyc/events/KycVerificationChangedV1.d.ts

@@ -2,7 +2,7 @@ import { IdentificationDocumentStatus } from '../../identity/enums/Identificatio
 import { KycVerificationStatusEnum } from '../enums/KycVerificationStatusEnum';
 import { KycSubChecks } from '../dtos/KycSubChecks';
 import { KycPersonData } from '../dtos/responses/KycPersonData';
-import { AddressBase } from '../../address/dtos/AddressBase';
+import { KycAddress } from '../dtos/KycAddress';
 /**
  * Cambio terminal de una verificación KYC, tal como lo publica `kyc-metamap-webhook` directo en
  * `RetailKycInboundQueue` (el webhook manda un `SendMessage` cuando la verificación pasa a COMPLETED).
@@ -53,9 +53,11 @@ export declare class KycVerificationChangedV1 {
      */
     person?: KycPersonData;
     /**
-     * Domicilio del INE ya ESTRUCTURADO por `places-business` (paso 02e), listo para copiarse a
-     * `RetailCustomer.address` en el upsert. OPCIONAL y aditivo: el webhook lo puebla cuando la OCR trae
-     * domicilio y `places` resuelve; si no, el upsert corre sin dirección y se completa después. ⚠️ PII.
+     * Domicilio del INE ya normalizado por `places-business` (paso 02e). El webhook manda el resultado
+     * del geocoding (`KycAddress`); el CONSUMIDOR (wizard) arma con esto su `AddressBase` local, porque
+     * ese objeto lleva contexto de SureKeep (tenant, tipo) que el webhook no tiene. OPCIONAL y aditivo:
+     * si la OCR no trae domicilio o `places` no resuelve, viaja ausente y el upsert corre sin dirección.
+     * ⚠️ PII: nunca loguear.
      */
-    address?: AddressBase;
+    address?: KycAddress;
 }

package/bin/kyc/events/KycVerificationChangedV1.js

@@ -16,7 +16,7 @@ const IdentificationDocumentStatus_1 = require("../../identity/enums/Identificat
 const KycVerificationStatusEnum_1 = require("../enums/KycVerificationStatusEnum");
 const KycSubChecks_1 = require("../dtos/KycSubChecks");
 const KycPersonData_1 = require("../dtos/responses/KycPersonData");
-const AddressBase_1 = require("../../address/dtos/AddressBase");
+const KycAddress_1 = require("../dtos/KycAddress");
 /**
  * Cambio terminal de una verificación KYC, tal como lo publica `kyc-metamap-webhook` directo en
  * `RetailKycInboundQueue` (el webhook manda un `SendMessage` cuando la verificación pasa a COMPLETED).
@@ -95,6 +95,6 @@ __decorate([
     (0, class_transformer_1.Expose)(),
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.ValidateNested)(),
-    (0, class_transformer_1.Type)(() => AddressBase_1.AddressBase),
-    __metadata("design:type", AddressBase_1.AddressBase)
+    (0, class_transformer_1.Type)(() => KycAddress_1.KycAddress),
+    __metadata("design:type", KycAddress_1.KycAddress)
 ], KycVerificationChangedV1.prototype, "address", void 0);

package/bin/kyc/index.d.ts

@@ -2,6 +2,7 @@ export * from './enums/KycVerificationStatusEnum';
 export * from './enums/KycSubCheckStatusEnum';
 export * from './enums/KycWatchlistStatusEnum';
 export * from './dtos/KycSubChecks';
+export * from './dtos/KycAddress';
 export * from './dtos/responses/KycPersonData';
 export * from './dtos/responses/KycByDirectoryResponse';
 export * from './events/KycVerificationChangedV1';

package/bin/kyc/index.js

@@ -21,6 +21,8 @@ __exportStar(require("./enums/KycSubCheckStatusEnum"), exports);
 __exportStar(require("./enums/KycWatchlistStatusEnum"), exports);
 // Sub-pasos descompuestos (SureKeep F2)
 __exportStar(require("./dtos/KycSubChecks"), exports);
+// Domicilio del INE normalizado por places (SureKeep F2)
+__exportStar(require("./dtos/KycAddress"), exports);
 // Response DTOs
 __exportStar(require("./dtos/responses/KycPersonData"), exports);
 __exportStar(require("./dtos/responses/KycByDirectoryResponse"), exports);

package/bin/loanConfig/enums/ModifiableByRoleEnum.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
+ * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
+ * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
+ * @enum {string}
+ */
+export declare enum ModifiableByRoleEnum {
+    SUPER_ADMIN = "super_admin",
+    SOFOM_ADMIN = "sofom_admin",
+    RETAILER_ADMIN = "retailer_admin"
+}

package/bin/loanConfig/enums/ModifiableByRoleEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModifiableByRoleEnum = void 0;
+/**
+ * Rol RBAC mínimo que puede modificar un parámetro (RBAC a nivel de parámetro, modelo-datos §8).
+ * `retailer_admin` = "Admin VentasLuga" de M6 §8. Valores = identificadores de rol de RBAC F0.
+ * TD-004: confirmar mapeo super_admin ↔ platform_super_admin con el naming real de F0.
+ * @enum {string}
+ */
+var ModifiableByRoleEnum;
+(function (ModifiableByRoleEnum) {
+    ModifiableByRoleEnum["SUPER_ADMIN"] = "super_admin";
+    ModifiableByRoleEnum["SOFOM_ADMIN"] = "sofom_admin";
+    ModifiableByRoleEnum["RETAILER_ADMIN"] = "retailer_admin";
+})(ModifiableByRoleEnum || (exports.ModifiableByRoleEnum = ModifiableByRoleEnum = {}));

package/bin/places/dtos/CashInFeeDto.d.ts

@@ -0,0 +1,17 @@
+import { CurrencyId } from '../../currency/enums/CurrencyId';
+/**
+ * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
+ * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
+ * - Passport (MX): por red → `fixed` + `percentage`.
+ * Response DTO — sin decoradores de validación.
+ */
+export declare class CashInFeeDto {
+    /** Comisión fija, en la moneda del país. */
+    fixed?: number;
+    /** Porcentaje del monto depositado (0–100). */
+    percentage?: number;
+    /** Tope máximo de comisión (GreenDot: el asociado cobra hasta este cap). */
+    cap?: number;
+    /** Moneda del fee: USD (GreenDot) | MXN (Passport). */
+    currency: CurrencyId;
+}

package/bin/places/dtos/CashInFeeDto.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CashInFeeDto = void 0;
+/**
+ * Comisión que cobra un punto de cash-in (lo que el lambda MUESTRA, no cobra).
+ * - GreenDot (US): representativo por cadena → `fixed` + `cap` (cada tienda cobra hasta el tope).
+ * - Passport (MX): por red → `fixed` + `percentage`.
+ * Response DTO — sin decoradores de validación.
+ */
+class CashInFeeDto {
+}
+exports.CashInFeeDto = CashInFeeDto;

package/bin/platformRbac/dtos/ResendOtpRequest.d.ts

@@ -0,0 +1,22 @@
+import { MfaMethodEnum } from '../enums/MfaMethodEnum';
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+export declare class ResendOtpRequest {
+    email: string;
+    tenantId: string;
+}
+/**
+ * Respuesta del resend-otp. `session`/`mfaMethod` frescos del nuevo challenge CUSTOM_AUTH.
+ * Plain sin validators (no validamos lo que mandamos al cliente — fiado-validation-and-dtos § 7).
+ * Ambos opcionales: en los caminos de rechazo silencioso (anti-enumeración) o ramas sin CUSTOM_AUTH
+ * el server responde 200 genérico sin session ni método.
+ */
+export interface ResendOtpResponse {
+    session?: string;
+    mfaMethod?: MfaMethodEnum;
+}

package/bin/platformRbac/dtos/ResendOtpRequest.js

@@ -0,0 +1,36 @@
+"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.ResendOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body del POST /auth/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Reenvía el OTP del login re-disparando el challenge real CUSTOM_AUTH (EMAIL_OTP) para la
+ * identidad SIN password. `tenantId` obligatorio (DEC-064 — el picker ya lo resolvió, NO "solo email").
+ * El email se normaliza lowercase server-side. Postura anti-enumeración: respuesta 200 genérica
+ * siempre, sin filtrar existencia (ver AuthLoginManager.resendChallengeOtp).
+ */
+class ResendOtpRequest {
+}
+exports.ResendOtpRequest = ResendOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendOtpRequest.prototype, "email", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendOtpRequest.prototype, "tenantId", void 0);

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+export declare class ResendSelfRegisterOtpRequest {
+    tenantId: string;
+    email: string;
+}

package/bin/platformRbac/dtos/ResendSelfRegisterOtpRequest.js

@@ -0,0 +1,36 @@
+"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.ResendSelfRegisterOtpRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * Body del POST /self-register/resend-otp (público, anónimo). DEC-RBAC-054.
+ * Re-envía el OTP del autoregistro (mecanismo messages-business, NO Cognito) tras validar un
+ * `pending` existente. Misma postura anti-enumeración del start. El email se normaliza lowercase
+ * server-side. DTO propio por endpoint (NO reusa SelfRegisterStartRequest, que exige roleId/scope/
+ * scopeRef, ni SelfRegisterVerifyOtpRequest, que exige otp).
+ */
+class ResendSelfRegisterOtpRequest {
+}
+exports.ResendSelfRegisterOtpRequest = ResendSelfRegisterOtpRequest;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "tenantId", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsEmail)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ResendSelfRegisterOtpRequest.prototype, "email", void 0);

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

@@ -1,10 +1,15 @@
 /**
  * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
- * RetailInventory F1 (condición atómica H2). El `cashPriceCents` de la reserva ancla el cobro
- * (regla dura: `amountCents == cashPrice`). SureKeep Fase 2 — pista Retail.
+ * RetailInventory F1 (condición atómica H2).
+ *
+ * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
+ * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
+ * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
+ * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
+ * SureKeep Fase 2 — pista Retail.
  */
 export declare class AddProductRequest {
     sku: string;
-    imei: string;
-    cashPriceCents: number;
+    imei?: string;
+    cashPriceCents?: number;
 }

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

@@ -14,8 +14,13 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 /**
  * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
- * RetailInventory F1 (condición atómica H2). El `cashPriceCents` de la reserva ancla el cobro
- * (regla dura: `amountCents == cashPrice`). SureKeep Fase 2 — pista Retail.
+ * RetailInventory F1 (condición atómica H2).
+ *
+ * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
+ * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
+ * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
+ * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
+ * SureKeep Fase 2 — pista Retail.
  */
 class AddProductRequest {
 }
@@ -27,11 +32,13 @@ __decorate([
 ], AddProductRequest.prototype, "sku", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),
     __metadata("design:type", String)
 ], AddProductRequest.prototype, "imei", void 0);
 __decorate([
     (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsInt)(),
     (0, class_validator_1.Min)(0),
     __metadata("design:type", Number)

package/package.json

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

package/src/kyc/dtos/KycAddress.ts

@@ -0,0 +1,46 @@
+import { Expose } from 'class-transformer';
+import { IsNumber, IsOptional, IsString } from 'class-validator';
+
+/**
+ * Domicilio del INE ya normalizado por `places-business` (AWS Location), listo para que el consumidor
+ * arme su `AddressBase` local. Mapea el `AddressCandidate` de places a un shape con `@Expose`, porque
+ * el consumer parsea el evento con `excludeExtraneousValues` y descartaría todo campo sin exponer.
+ *
+ * Todos los campos son opcionales: el domicilio es best-effort (la OCR del INE + el geocoding pueden
+ * no resolver todo). ⚠️ PII: nunca loguear esta estructura.
+ */
+export class KycAddress {
+    /** Etiqueta completa legible (equivalente a Place.Label). */
+    @Expose() @IsOptional() @IsString()
+    label?: string;
+
+    @Expose() @IsOptional() @IsString()
+    street?: string;
+
+    /** Número exterior (Place.AddressNumber). */
+    @Expose() @IsOptional() @IsString()
+    addressNumber?: string;
+
+    @Expose() @IsOptional() @IsString()
+    neighborhood?: string;
+
+    @Expose() @IsOptional() @IsString()
+    municipality?: string;
+
+    /** Estado/provincia (Place.Region). */
+    @Expose() @IsOptional() @IsString()
+    region?: string;
+
+    @Expose() @IsOptional() @IsString()
+    postalCode?: string;
+
+    /** ISO3 del país (Place.Country). */
+    @Expose() @IsOptional() @IsString()
+    country?: string;
+
+    @Expose() @IsOptional() @IsNumber()
+    latitude?: number;
+
+    @Expose() @IsOptional() @IsNumber()
+    longitude?: number;
+}

package/src/kyc/events/KycVerificationChangedV1.ts

@@ -4,7 +4,7 @@ import { IdentificationDocumentStatus } from '../../identity/enums/Identificatio
 import { KycVerificationStatusEnum } from '../enums/KycVerificationStatusEnum';
 import { KycSubChecks } from '../dtos/KycSubChecks';
 import { KycPersonData } from '../dtos/responses/KycPersonData';
-import { AddressBase } from '../../address/dtos/AddressBase';
+import { KycAddress } from '../dtos/KycAddress';
 
 /**
  * Cambio terminal de una verificación KYC, tal como lo publica `kyc-metamap-webhook` directo en
@@ -74,10 +74,12 @@ export class KycVerificationChangedV1 {
     person?: KycPersonData;
 
     /**
-     * Domicilio del INE ya ESTRUCTURADO por `places-business` (paso 02e), listo para copiarse a
-     * `RetailCustomer.address` en el upsert. OPCIONAL y aditivo: el webhook lo puebla cuando la OCR trae
-     * domicilio y `places` resuelve; si no, el upsert corre sin dirección y se completa después. ⚠️ PII.
+     * Domicilio del INE ya normalizado por `places-business` (paso 02e). El webhook manda el resultado
+     * del geocoding (`KycAddress`); el CONSUMIDOR (wizard) arma con esto su `AddressBase` local, porque
+     * ese objeto lleva contexto de SureKeep (tenant, tipo) que el webhook no tiene. OPCIONAL y aditivo:
+     * si la OCR no trae domicilio o `places` no resuelve, viaja ausente y el upsert corre sin dirección.
+     * ⚠️ PII: nunca loguear.
      */
-    @Expose() @IsOptional() @ValidateNested() @Type(() => AddressBase)
-    address?: AddressBase;
+    @Expose() @IsOptional() @ValidateNested() @Type(() => KycAddress)
+    address?: KycAddress;
 }

package/src/kyc/index.ts

@@ -7,6 +7,9 @@ export * from './enums/KycWatchlistStatusEnum';
 // Sub-pasos descompuestos (SureKeep F2)
 export * from './dtos/KycSubChecks';
 
+// Domicilio del INE normalizado por places (SureKeep F2)
+export * from './dtos/KycAddress';
+
 // Response DTOs
 export * from './dtos/responses/KycPersonData';
 export * from './dtos/responses/KycByDirectoryResponse';

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

@@ -1,10 +1,15 @@
 import { Expose } from 'class-transformer';
-import { IsInt, IsString, Min } from 'class-validator';
+import { IsInt, IsOptional, IsString, Min } from 'class-validator';
 
 /**
  * POST /wizard/sessions/:id/product — reserva un equipo del catálogo (paso 03). Reserva 30 min en
- * RetailInventory F1 (condición atómica H2). El `cashPriceCents` de la reserva ancla el cobro
- * (regla dura: `amountCents == cashPrice`). SureKeep Fase 2 — pista Retail.
+ * RetailInventory F1 (condición atómica H2).
+ *
+ * `imei` y `cashPriceCents` son OPCIONALES a propósito: la unidad física y el precio son AUTORIDAD DEL
+ * SERVIDOR. Con solo el `sku`, el wizard elige una unidad disponible del catálogo y toma su precio (el
+ * cliente NUNCA dicta el monto a cobrar — `cashPriceCents` ancla el cobro con `amountCents == cashPrice`).
+ * Si el caller manda `imei`, el server puede honrar esa unidad, pero el precio SIEMPRE sale del catálogo.
+ * SureKeep Fase 2 — pista Retail.
  */
 export class AddProductRequest {
   @Expose()
@@ -12,11 +17,13 @@ export class AddProductRequest {
   sku!: string;
 
   @Expose()
+  @IsOptional()
   @IsString()
-  imei!: string;
+  imei?: string;
 
   @Expose()
+  @IsOptional()
   @IsInt()
   @Min(0)
-  cashPriceCents!: number;
+  cashPriceCents?: number;
 }

package/bin/loanCredit/dtos/requests/UpdateActivationChecklistRequest.d.ts

@@ -1,11 +0,0 @@
-/**
- * Body de PUT /credits/:creditId/checklist (loan-credit-business). Marca condiciones de activación
- * cumplidas. Solo se mandan las que cambian; en F3 las marcarán los flujos de firma de contrato
- * (`downPayment` + `contractSigned`) y de enrolamiento MDM (`imeiEnrolled` + `lockVerified`).
- */
-export declare class UpdateActivationChecklistRequest {
-    downPayment?: boolean;
-    contractSigned?: boolean;
-    imeiEnrolled?: boolean;
-    lockVerified?: boolean;
-}

package/bin/loanCredit/dtos/requests/UpdateActivationChecklistRequest.js

@@ -1,46 +0,0 @@
-"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.UpdateActivationChecklistRequest = void 0;
-const class_transformer_1 = require("class-transformer");
-const class_validator_1 = require("class-validator");
-/**
- * Body de PUT /credits/:creditId/checklist (loan-credit-business). Marca condiciones de activación
- * cumplidas. Solo se mandan las que cambian; en F3 las marcarán los flujos de firma de contrato
- * (`downPayment` + `contractSigned`) y de enrolamiento MDM (`imeiEnrolled` + `lockVerified`).
- */
-class UpdateActivationChecklistRequest {
-}
-exports.UpdateActivationChecklistRequest = UpdateActivationChecklistRequest;
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsBoolean)(),
-    __metadata("design:type", Boolean)
-], UpdateActivationChecklistRequest.prototype, "downPayment", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsBoolean)(),
-    __metadata("design:type", Boolean)
-], UpdateActivationChecklistRequest.prototype, "contractSigned", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsBoolean)(),
-    __metadata("design:type", Boolean)
-], UpdateActivationChecklistRequest.prototype, "imeiEnrolled", void 0);
-__decorate([
-    (0, class_transformer_1.Expose)(),
-    (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsBoolean)(),
-    __metadata("design:type", Boolean)
-], UpdateActivationChecklistRequest.prototype, "lockVerified", void 0);

package/bin/loanCredit/enums/ClientLevelEnum.d.ts

@@ -1,11 +0,0 @@
-/**
- * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
- * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
- * un CLIENTE nunca es `ALL`.
- * @enum {string}
- */
-export declare enum ClientLevelEnum {
-    BRONZE = "BRONZE",
-    SILVER = "SILVER",
-    GOLD = "GOLD"
-}

package/bin/loanCredit/enums/ClientLevelEnum.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClientLevelEnum = void 0;
-/**
- * Nivel del cliente según su SCI (M7/05_MOTOR §3.2): 21-60 Bronce · 61-80 Plata · 81-100 Oro.
- * Distinto de `CreditPlanLevelEnum` de loanOfferings (que además tiene `ALL` para planes):
- * un CLIENTE nunca es `ALL`.
- * @enum {string}
- */
-var ClientLevelEnum;
-(function (ClientLevelEnum) {
-    ClientLevelEnum["BRONZE"] = "BRONZE";
-    ClientLevelEnum["SILVER"] = "SILVER";
-    ClientLevelEnum["GOLD"] = "GOLD";
-})(ClientLevelEnum || (exports.ClientLevelEnum = ClientLevelEnum = {}));