@fiado/type-kit 3.51.1 → 3.52.0

package/bin/benefitCenter/dtos/BackofficeLeafDetailResponse.d.ts

@@ -1,4 +1,5 @@
 import { ConnectorCatalogItem } from "./ConnectorCatalogItem";
+import { VerifyEquivalentInfo } from "./VerifyEquivalentInfo";
 /**
  * Respuesta del detalle de un leaf en el backoffice (v2 in-place).
  * Devuelve el item del catálogo del conector tal cual — sin paso de merge
@@ -10,4 +11,6 @@ export interface BackofficeLeafDetailResponse {
     moduleName: string;
     serviceId: string;
     item: ConnectorCatalogItem;
+    verifyEquivalent: VerifyEquivalentInfo;
+    warnings?: string[];
 }

package/bin/benefitCenter/dtos/BackofficeLeafListItem.d.ts

@@ -21,4 +21,5 @@ export interface BackofficeLeafListItem {
     countryId: string;
     serviceOrder: number;
     subcategoryOrder: number;
+    requiresReferenceVerification: boolean;
 }

package/bin/benefitCenter/dtos/BackofficeLeafUpdateRequest.d.ts

@@ -3,9 +3,12 @@
  * opcionales pero al menos uno debe venir; si el body está vacío el backend
  * responde 400 INVALID_PATCH_PAYLOAD.
  *
- * Los campos eliminados respecto de v1 (`description`, `helpText`,
- * `inputSchema`, `requiresReferenceVerification`) ya no son editables —
+ * Los campos `description`, `helpText` e `inputSchema` NO son editables —
  * vienen derivados del producto en el mapper del conector.
+ *
+ * `requiresReferenceVerification` SÍ es editable: es un toggle a nivel
+ * servicio que el backend traduce a `verificateReference` en TODOS los
+ * productos del servicio (el derivado se recalcula solo en el siguiente read).
  */
 export declare class BackofficeLeafUpdateRequest {
     serviceName?: string;
@@ -15,4 +18,5 @@ export declare class BackofficeLeafUpdateRequest {
     logo?: string;
     serviceOrder?: number;
     subcategoryOrder?: number;
+    requiresReferenceVerification?: boolean;
 }

package/bin/benefitCenter/dtos/BackofficeLeafUpdateRequest.js

@@ -16,9 +16,12 @@ const class_validator_1 = require("class-validator");
  * opcionales pero al menos uno debe venir; si el body está vacío el backend
  * responde 400 INVALID_PATCH_PAYLOAD.
  *
- * Los campos eliminados respecto de v1 (`description`, `helpText`,
- * `inputSchema`, `requiresReferenceVerification`) ya no son editables —
+ * Los campos `description`, `helpText` e `inputSchema` NO son editables —
  * vienen derivados del producto en el mapper del conector.
+ *
+ * `requiresReferenceVerification` SÍ es editable: es un toggle a nivel
+ * servicio que el backend traduce a `verificateReference` en TODOS los
+ * productos del servicio (el derivado se recalcula solo en el siguiente read).
  */
 class BackofficeLeafUpdateRequest {
 }
@@ -64,3 +67,8 @@ __decorate([
     (0, class_validator_1.IsNumber)(),
     __metadata("design:type", Number)
 ], BackofficeLeafUpdateRequest.prototype, "subcategoryOrder", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], BackofficeLeafUpdateRequest.prototype, "requiresReferenceVerification", void 0);

package/bin/benefitCenter/dtos/ProductItem.d.ts

@@ -19,4 +19,12 @@ export declare class ProductItem {
      * el producto del catálogo público.
      */
     enabled?: boolean;
+    /**
+     * Si este producto verifica la referencia (consulta de saldo) antes de
+     * pagar. Mapea del campo nativo del producto `verificateReference`. Es lo
+     * que deriva `requiresReferenceVerification` a nivel servicio
+     * (`products.some(p => p.verificateReference === true)`). Opcional/aditivo:
+     * ausente o `false` ⇒ no verifica.
+     */
+    verificateReference?: boolean;
 }

package/bin/benefitCenter/dtos/VerifyEquivalentInfo.d.ts

@@ -0,0 +1,20 @@
+/** Por qué no hay equivalente verificable (cuando `feasible === false`). */
+export declare enum VerifyEquivalentReasonEnum {
+    NO_SUBCATEGORY = "NO_SUBCATEGORY",
+    NO_EQUIVALENT = "NO_EQUIVALENT",
+    NO_VERIFIABLE_PRODUCT = "NO_VERIFIABLE_PRODUCT"
+}
+/**
+ * Dónde ocurriría realmente la verificación de referencia de un leaf y si es
+ * factible. Para módulos sin verify nativo (multicomm/multicenter) describe el
+ * equivalente resuelto por subcategoría (STP). Para módulos con verify nativo
+ * (STP) describe su propio servicio/producto.
+ */
+export interface VerifyEquivalentInfo {
+    feasible: boolean;
+    module: string;
+    serviceId?: string;
+    serviceName?: string;
+    productId?: string;
+    reason?: VerifyEquivalentReasonEnum;
+}

package/bin/benefitCenter/dtos/VerifyEquivalentInfo.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VerifyEquivalentReasonEnum = void 0;
+/** Por qué no hay equivalente verificable (cuando `feasible === false`). */
+var VerifyEquivalentReasonEnum;
+(function (VerifyEquivalentReasonEnum) {
+    VerifyEquivalentReasonEnum["NO_SUBCATEGORY"] = "NO_SUBCATEGORY";
+    VerifyEquivalentReasonEnum["NO_EQUIVALENT"] = "NO_EQUIVALENT";
+    VerifyEquivalentReasonEnum["NO_VERIFIABLE_PRODUCT"] = "NO_VERIFIABLE_PRODUCT";
+})(VerifyEquivalentReasonEnum || (exports.VerifyEquivalentReasonEnum = VerifyEquivalentReasonEnum = {}));

package/bin/benefitCenter/index.d.ts

@@ -74,3 +74,4 @@ export * from "./dtos/BackofficeProductCreateItem";
 export * from "./dtos/BackofficeLeafCreateRequest";
 export * from "./dtos/BannerUploadUrlRequest";
 export * from "./dtos/BannerUploadUrlResponse";
+export * from "./dtos/VerifyEquivalentInfo";

package/bin/benefitCenter/index.js

@@ -101,3 +101,5 @@ __exportStar(require("./dtos/BackofficeLeafCreateRequest"), exports);
 //Banner assets upload (presigned PUT)
 __exportStar(require("./dtos/BannerUploadUrlRequest"), exports);
 __exportStar(require("./dtos/BannerUploadUrlResponse"), exports);
+//Backoffice verify toggle + equivalente STP (Fase 1)
+__exportStar(require("./dtos/VerifyEquivalentInfo"), exports);

package/bin/card/validations/CardUpdateKeyConstraint.js

@@ -6,7 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IsValueValid = exports.CardUpdateKeyConstraint = exports.IsReasonRequiredForCancelledStatusConstraint = void 0;
+exports.CardUpdateKeyConstraint = exports.IsReasonRequiredForCancelledStatusConstraint = void 0;
+exports.IsValueValid = IsValueValid;
 const class_validator_1 = require("class-validator");
 const Status_1 = require("../enums/Status");
 const UpdateKey_1 = require("../enums/UpdateKey");
@@ -70,4 +71,3 @@ function IsValueValid(validationOptions) {
         });
     };
 }
-exports.IsValueValid = IsValueValid;

package/bin/card/validations/IsPhoneNumberConstraint.js

@@ -6,7 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IsPhoneNumberFiado = exports.IsPhoneNumberConstraint = void 0;
+exports.IsPhoneNumberConstraint = void 0;
+exports.IsPhoneNumberFiado = IsPhoneNumberFiado;
 const class_validator_1 = require("class-validator");
 const regex_1 = require("../../helpers/constans/regex");
 let IsPhoneNumberConstraint = class IsPhoneNumberConstraint {
@@ -36,4 +37,3 @@ function IsPhoneNumberFiado(validationOptions) {
         });
     };
 }
-exports.IsPhoneNumberFiado = IsPhoneNumberFiado;

package/bin/cognitoBackofficeConnector/dtos/MfaPoolConfig.d.ts

@@ -0,0 +1,7 @@
+declare const ALLOWED_MFA_TYPES: readonly ["SOFTWARE_TOKEN_MFA"];
+export type AllowedMfaType = (typeof ALLOWED_MFA_TYPES)[number];
+export declare class MfaPoolConfig {
+    requireMfa: boolean;
+    mfaTypes: AllowedMfaType[];
+}
+export {};

package/bin/cognitoBackofficeConnector/dtos/MfaPoolConfig.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.MfaPoolConfig = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const MfaTypesRequiresOne_1 = require("../validators/MfaTypesRequiresOne");
+// EMAIL_OTP removido (3.41.0): el cognito-backoffice-connector no provisiona
+// EmailMfaConfiguration a nivel pool (requiere infra SES que no está montada
+// y la integración con messages-lambda aún no tiene diseño). Ver TD-020 +
+// DEC-001 en cognito-backoffice-connector/docs/. Si se reintroduce, agregar
+// 'EMAIL_OTP' a este array.
+const ALLOWED_MFA_TYPES = ['SOFTWARE_TOKEN_MFA'];
+class MfaPoolConfig {
+}
+exports.MfaPoolConfig = MfaPoolConfig;
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], MfaPoolConfig.prototype, "requireMfa", void 0);
+__decorate([
+    (0, class_transformer_1.Expose)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.IsIn)(ALLOWED_MFA_TYPES, { each: true }),
+    (0, class_validator_1.Validate)(MfaTypesRequiresOne_1.MfaTypesRequiresOne),
+    __metadata("design:type", Array)
+], MfaPoolConfig.prototype, "mfaTypes", void 0);

package/bin/cognitoBackofficeConnector/dtos/PoolConfigResponse.d.ts

@@ -0,0 +1,20 @@
+import { PoolKind } from '../../rbac/enums/PoolKind';
+/**
+ * Shape del `PoolConfigRow` expuesto al caller (BFF M18 / otros lambdas Fiado).
+ * Refleja la configuración de un Cognito User Pool registrado en la tabla
+ * `PoolConfigs_GT` del lambda `cognito-backoffice-connector`.
+ */
+export declare class PoolConfigResponse {
+    userPoolId: string;
+    userPoolArn: string;
+    region: string;
+    poolKind: PoolKind;
+    displayName: string;
+    appClients: Record<string, {
+        clientId: string;
+        clientName: string;
+    }>;
+    status: 'active' | 'deprecated';
+    createdAt: number;
+    updatedAt: number;
+}

package/bin/cognitoBackofficeConnector/dtos/PoolConfigResponse.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolConfigResponse = void 0;
+/**
+ * Shape del `PoolConfigRow` expuesto al caller (BFF M18 / otros lambdas Fiado).
+ * Refleja la configuración de un Cognito User Pool registrado en la tabla
+ * `PoolConfigs_GT` del lambda `cognito-backoffice-connector`.
+ */
+class PoolConfigResponse {
+}
+exports.PoolConfigResponse = PoolConfigResponse;

package/bin/cognitoBackofficeConnector/dtos/PoolsListResponse.d.ts

@@ -0,0 +1,4 @@
+import { PoolConfigResponse } from './PoolConfigResponse';
+export declare class PoolsListResponse {
+    pools: PoolConfigResponse[];
+}

package/bin/cognitoBackofficeConnector/dtos/PoolsListResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolsListResponse = void 0;
+class PoolsListResponse {
+}
+exports.PoolsListResponse = PoolsListResponse;

package/bin/cognitoBackofficeConnector/validators/MfaTypesRequiresOne.d.ts

@@ -0,0 +1,17 @@
+import { ValidatorConstraintInterface, ValidationArguments } from 'class-validator';
+/**
+ * Cross-field validator: si `requireMfa: true`, entonces `mfaTypes` debe tener
+ * al menos 1 elemento. Si `requireMfa: false`, `mfaTypes` puede ser vacío.
+ *
+ * Razón: cuando el pool nace con MFA habilitado, el connector llama
+ * `SetUserPoolMfaConfigCommand` con la lista de tipos del DTO. Si el array
+ * llega vacío con `requireMfa: true`, el SDK rechaza con InvalidParameterException
+ * y el pool queda en estado inconsistente (MfaConfiguration:'ON' sin tipos).
+ * Mejor rechazar en validación del DTO antes de tocar AWS.
+ *
+ * Ver pivote v1.4.1 TD-017 cerrado + spec doc §1 R3.
+ */
+export declare class MfaTypesRequiresOne implements ValidatorConstraintInterface {
+    validate(mfaTypes: unknown, args: ValidationArguments): boolean;
+    defaultMessage(): string;
+}

package/bin/cognitoBackofficeConnector/validators/MfaTypesRequiresOne.js

@@ -0,0 +1,39 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MfaTypesRequiresOne = void 0;
+const class_validator_1 = require("class-validator");
+/**
+ * Cross-field validator: si `requireMfa: true`, entonces `mfaTypes` debe tener
+ * al menos 1 elemento. Si `requireMfa: false`, `mfaTypes` puede ser vacío.
+ *
+ * Razón: cuando el pool nace con MFA habilitado, el connector llama
+ * `SetUserPoolMfaConfigCommand` con la lista de tipos del DTO. Si el array
+ * llega vacío con `requireMfa: true`, el SDK rechaza con InvalidParameterException
+ * y el pool queda en estado inconsistente (MfaConfiguration:'ON' sin tipos).
+ * Mejor rechazar en validación del DTO antes de tocar AWS.
+ *
+ * Ver pivote v1.4.1 TD-017 cerrado + spec doc §1 R3.
+ */
+let MfaTypesRequiresOne = class MfaTypesRequiresOne {
+    validate(mfaTypes, args) {
+        const obj = args.object;
+        if (obj.requireMfa === true) {
+            return Array.isArray(mfaTypes) && mfaTypes.length >= 1;
+        }
+        // requireMfa: false → cualquier mfaTypes pasa.
+        return true;
+    }
+    defaultMessage() {
+        return 'mfaTypes requiere al menos un tipo cuando requireMfa=true';
+    }
+};
+exports.MfaTypesRequiresOne = MfaTypesRequiresOne;
+exports.MfaTypesRequiresOne = MfaTypesRequiresOne = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ name: 'MfaTypesRequiresOneWhenMfaRequired', async: false })
+], MfaTypesRequiresOne);

package/bin/index.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 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);
 };

package/bin/rbac/enums/PoolKind.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tipo de User Pool de Cognito desde la perspectiva del modelo RBAC Fiado.
+ *
+ * Origen: spec del proyecto `cognito-backoffice-connector` (Fase 0, componente 01
+ * documento `docs/superpowers/specs/2026-05-26-cognito-connector-decisiones-pendientes-design.md`).
+ *
+ * Decisión (TD-003): el proyecto converge en estos 2 valores. El documento componente 03
+ * lista 3 valores (incluyendo una variante adicional) pero queda como outlier — la
+ * decisión vigente en los 6 docs restantes y en el plan de implementación es 2 valores:
+ *  - BACKOFFICE_PLATFORM — pool del backoffice de plataforma (cross-tenant)
+ *  - BACKOFFICE_TENANT — pool por tenant (multi-tenant isolation)
+ */
+export declare enum PoolKind {
+    BACKOFFICE_PLATFORM = "BACKOFFICE_PLATFORM",
+    BACKOFFICE_TENANT = "BACKOFFICE_TENANT"
+}

package/bin/rbac/enums/PoolKind.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PoolKind = void 0;
+/**
+ * Tipo de User Pool de Cognito desde la perspectiva del modelo RBAC Fiado.
+ *
+ * Origen: spec del proyecto `cognito-backoffice-connector` (Fase 0, componente 01
+ * documento `docs/superpowers/specs/2026-05-26-cognito-connector-decisiones-pendientes-design.md`).
+ *
+ * Decisión (TD-003): el proyecto converge en estos 2 valores. El documento componente 03
+ * lista 3 valores (incluyendo una variante adicional) pero queda como outlier — la
+ * decisión vigente en los 6 docs restantes y en el plan de implementación es 2 valores:
+ *  - BACKOFFICE_PLATFORM — pool del backoffice de plataforma (cross-tenant)
+ *  - BACKOFFICE_TENANT — pool por tenant (multi-tenant isolation)
+ */
+var PoolKind;
+(function (PoolKind) {
+    PoolKind["BACKOFFICE_PLATFORM"] = "BACKOFFICE_PLATFORM";
+    PoolKind["BACKOFFICE_TENANT"] = "BACKOFFICE_TENANT";
+})(PoolKind || (exports.PoolKind = PoolKind = {}));

package/bin/rbac/index.d.ts

@@ -0,0 +1 @@
+export * from './enums/PoolKind';

package/bin/rbac/index.js

@@ -0,0 +1,17 @@
+"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/PoolKind"), exports);

package/package.json

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

package/src/benefitCenter/dtos/BackofficeLeafDetailResponse.ts

@@ -1,4 +1,5 @@
 import { ConnectorCatalogItem } from "./ConnectorCatalogItem";
+import { VerifyEquivalentInfo } from "./VerifyEquivalentInfo";
 
 /**
  * Respuesta del detalle de un leaf en el backoffice (v2 in-place).
@@ -11,4 +12,6 @@ export interface BackofficeLeafDetailResponse {
     moduleName: string;
     serviceId: string;
     item: ConnectorCatalogItem;
+    verifyEquivalent: VerifyEquivalentInfo;
+    warnings?: string[];
 }

package/src/benefitCenter/dtos/BackofficeLeafListItem.ts

@@ -24,4 +24,6 @@ export interface BackofficeLeafListItem {
     countryId: string;       // ISO numérico del país destino de la recarga (840 USA, 484 MX, 192 CU, …)
     serviceOrder: number;    // orden del leaf en su subcategory
     subcategoryOrder: number;// orden de la subcategory en su category
+
+    requiresReferenceVerification: boolean; // Derivado: ¿algún producto requiere verificación?
 }

package/src/benefitCenter/dtos/BackofficeLeafUpdateRequest.ts

@@ -5,9 +5,12 @@ import { IsBoolean, IsNumber, IsOptional, IsString, Matches, MaxLength } from "c
  * opcionales pero al menos uno debe venir; si el body está vacío el backend
  * responde 400 INVALID_PATCH_PAYLOAD.
  *
- * Los campos eliminados respecto de v1 (`description`, `helpText`,
- * `inputSchema`, `requiresReferenceVerification`) ya no son editables —
+ * Los campos `description`, `helpText` e `inputSchema` NO son editables —
  * vienen derivados del producto en el mapper del conector.
+ *
+ * `requiresReferenceVerification` SÍ es editable: es un toggle a nivel
+ * servicio que el backend traduce a `verificateReference` en TODOS los
+ * productos del servicio (el derivado se recalcula solo en el siguiente read).
  */
 export class BackofficeLeafUpdateRequest {
     @IsOptional() @IsString() @MaxLength(200) serviceName?: string;
@@ -27,4 +30,6 @@ export class BackofficeLeafUpdateRequest {
     @IsOptional() @IsNumber() serviceOrder?: number;
 
     @IsOptional() @IsNumber() subcategoryOrder?: number;
+
+    @IsOptional() @IsBoolean() requiresReferenceVerification?: boolean;
 }

package/src/benefitCenter/dtos/ProductItem.ts

@@ -22,4 +22,13 @@ export class ProductItem {
      * el producto del catálogo público.
      */
     enabled?: boolean;
+
+    /**
+     * Si este producto verifica la referencia (consulta de saldo) antes de
+     * pagar. Mapea del campo nativo del producto `verificateReference`. Es lo
+     * que deriva `requiresReferenceVerification` a nivel servicio
+     * (`products.some(p => p.verificateReference === true)`). Opcional/aditivo:
+     * ausente o `false` ⇒ no verifica.
+     */
+    verificateReference?: boolean;
 }

package/src/benefitCenter/dtos/VerifyEquivalentInfo.ts

@@ -0,0 +1,21 @@
+/** Por qué no hay equivalente verificable (cuando `feasible === false`). */
+export enum VerifyEquivalentReasonEnum {
+    NO_SUBCATEGORY = "NO_SUBCATEGORY",
+    NO_EQUIVALENT = "NO_EQUIVALENT",
+    NO_VERIFIABLE_PRODUCT = "NO_VERIFIABLE_PRODUCT",
+}
+
+/**
+ * Dónde ocurriría realmente la verificación de referencia de un leaf y si es
+ * factible. Para módulos sin verify nativo (multicomm/multicenter) describe el
+ * equivalente resuelto por subcategoría (STP). Para módulos con verify nativo
+ * (STP) describe su propio servicio/producto.
+ */
+export interface VerifyEquivalentInfo {
+    feasible: boolean;
+    module: string;
+    serviceId?: string;
+    serviceName?: string;
+    productId?: string;
+    reason?: VerifyEquivalentReasonEnum;
+}

package/src/benefitCenter/index.ts

@@ -86,3 +86,5 @@ export * from "./dtos/BackofficeLeafCreateRequest";
 //Banner assets upload (presigned PUT)
 export * from "./dtos/BannerUploadUrlRequest";
 export * from "./dtos/BannerUploadUrlResponse";
+//Backoffice verify toggle + equivalente STP (Fase 1)
+export * from "./dtos/VerifyEquivalentInfo";