@fiado/type-kit 3.230.0 → 3.232.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/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/retailOrg/dtos/validation/RetailUserValidationDto.d.ts

@@ -8,6 +8,12 @@ export interface RetailUserValidationDto {
     retailUserId: string;
     cognitoSub: string;
     retailerId: string;
+    /**
+     * Nombre de display del usuario retail (DEC-SKF1-021: etiqueta de conveniencia, la identidad real
+     * vive en RBAC). `null` si no se capturó. Lo consume el snapshot de venta del wizard para congelar
+     * quién vendió, sin tener que resolver el usuario en cada lectura del BO.
+     */
+    displayName: string | null;
     homeStoreId: string;
     employmentType: EmploymentTypeEnum;
     commissionTier: string;

package/bin/retailOrg/dtos/validation/StoreValidationDto.d.ts

@@ -7,6 +7,12 @@ export interface StoreValidationDto {
     storeId: string;
     retailerId: string;
     zoneId: string | null;
+    /**
+     * Nombre de la zona, resuelto por retail-org contra su propia tabla. `null` si la tienda no está
+     * acotada a una zona o si la zona ya no existe. Lo consume el snapshot de venta del wizard, que
+     * congela el contexto comercial y no puede resolver un `zoneId` de otro dominio.
+     */
+    zoneName: string | null;
     code: string;
     name: string;
     status: StoreStatusEnum;

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

@@ -13,6 +13,18 @@ import type { WizardWelcome } from './WizardWelcome';
 export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
 /** Estado de la apertura de cuenta async (D35) — espejo de `RetailCustomer.accountStatus`. */
 export type AccountStatus = 'OPENING' | 'OPEN' | 'FAILED' | 'LINKED';
+/**
+ * Ruta del comprador tras la bifurcación del KYC (D-A2 / DEC-BIF-001).
+ *
+ * - **FACEMATCH** — ya tiene una cuenta PagoConFiado activa en México: verificación biométrica
+ *   ligera contra su foto registrada, sin repetir el KYC completo.
+ * - **FULL_KYC** — no tiene cuenta: KYC completo con INE y prueba de vida. Es también el destino
+ *   FAIL-CLOSED cuando la señal de cuenta no responde o la vía biométrica no se puede armar.
+ *
+ * Viaja al front porque las dos rutas piden cosas distintas al cliente —una selfie contra INE por
+ * ambos lados— y la pantalla tiene que decirle al vendedor cuál de las dos toca.
+ */
+export type CustomerRoute = 'FACEMATCH' | 'FULL_KYC';
 /**
  * Estado de la SAGA del wizard (modelo-datos §1). ES la tabla de estado: cada paso persiste su
  * avance; reanudable. pk `SESSION#<sessionId>` · sk `META` · GSIs `phone-state-index`,
@@ -35,6 +47,11 @@ export interface WizardSession {
     /** Espejo del estado KYC (fuente = customer). */
     kycStatus: string | null;
     kycModality: KycModality | null;
+    /**
+     * Ruta resuelta en el paso 01d, al registrar los consentimientos. `null` mientras no se haya
+     * resuelto: el consumidor no puede asumir `FULL_KYC` en ese caso, porque todavía no se sabe.
+     */
+    customerRoute: CustomerRoute | null;
     metamapIdentityId: string | null;
     occupation: OccupationEnum | null;
     occupationOther: string | null;

package/package.json

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

package/src/retailOrg/dtos/validation/RetailUserValidationDto.ts

@@ -9,6 +9,12 @@ export interface RetailUserValidationDto {
     retailUserId: string;
     cognitoSub: string;
     retailerId: string;
+    /**
+     * Nombre de display del usuario retail (DEC-SKF1-021: etiqueta de conveniencia, la identidad real
+     * vive en RBAC). `null` si no se capturó. Lo consume el snapshot de venta del wizard para congelar
+     * quién vendió, sin tener que resolver el usuario en cada lectura del BO.
+     */
+    displayName: string | null;
     homeStoreId: string;
     employmentType: EmploymentTypeEnum;
     commissionTier: string;

package/src/retailOrg/dtos/validation/StoreValidationDto.ts

@@ -8,6 +8,12 @@ export interface StoreValidationDto {
     storeId: string;
     retailerId: string;
     zoneId: string | null;
+    /**
+     * Nombre de la zona, resuelto por retail-org contra su propia tabla. `null` si la tienda no está
+     * acotada a una zona o si la zona ya no existe. Lo consume el snapshot de venta del wizard, que
+     * congela el contexto comercial y no puede resolver un `zoneId` de otro dominio.
+     */
+    zoneName: string | null;
     code: string;
     name: string;
     status: StoreStatusEnum;

package/src/retailWizard/dtos/WizardSession.ts

@@ -16,6 +16,19 @@ export type KycModality = 'CUSTOMER_LINK' | 'STORE_DEVICE' | 'MANUAL';
 /** Estado de la apertura de cuenta async (D35) — espejo de `RetailCustomer.accountStatus`. */
 export type AccountStatus = 'OPENING' | 'OPEN' | 'FAILED' | 'LINKED';
 
+/**
+ * Ruta del comprador tras la bifurcación del KYC (D-A2 / DEC-BIF-001).
+ *
+ * - **FACEMATCH** — ya tiene una cuenta PagoConFiado activa en México: verificación biométrica
+ *   ligera contra su foto registrada, sin repetir el KYC completo.
+ * - **FULL_KYC** — no tiene cuenta: KYC completo con INE y prueba de vida. Es también el destino
+ *   FAIL-CLOSED cuando la señal de cuenta no responde o la vía biométrica no se puede armar.
+ *
+ * Viaja al front porque las dos rutas piden cosas distintas al cliente —una selfie contra INE por
+ * ambos lados— y la pantalla tiene que decirle al vendedor cuál de las dos toca.
+ */
+export type CustomerRoute = 'FACEMATCH' | 'FULL_KYC';
+
 /**
  * Estado de la SAGA del wizard (modelo-datos §1). ES la tabla de estado: cada paso persiste su
  * avance; reanudable. pk `SESSION#<sessionId>` · sk `META` · GSIs `phone-state-index`,
@@ -38,6 +51,11 @@ export interface WizardSession {
   /** Espejo del estado KYC (fuente = customer). */
   kycStatus: string | null;
   kycModality: KycModality | null;
+  /**
+   * Ruta resuelta en el paso 01d, al registrar los consentimientos. `null` mientras no se haya
+   * resuelto: el consumidor no puede asumir `FULL_KYC` en ese caso, porque todavía no se sabe.
+   */
+  customerRoute: CustomerRoute | null;
   metamapIdentityId: string | null;
   occupation: OccupationEnum | null;
   occupationOther: string | null;

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 = {}));