@fiado/type-kit 3.18.0 → 3.20.0

package/src/benefitCenter/dtos/AuthorizeBenefitsMarketplaceTransactionRequest.ts

@@ -1,138 +1,138 @@
-import {
-    IsLatitude,
-    IsLongitude,
-    IsNotEmpty,
-    IsNumber,
-    IsObject,
-    IsOptional,
-    IsPositive,
-    IsString,
-    Matches,
-    Max,
-    MaxLength,
-} from "class-validator";
-
-/**
- * Request del endpoint nuevo `POST /authorizeBenefitsMarketplaceTransaction`
- * en `transaction-processor-business` (PublicController). Lo invoca la app
- * para todos los flujos del Centro de Beneficios.
- *
- * NO se reusa `AuthorizePaymentTransactionRequest` ni similares: este DTO
- * es dedicado, sin sub-objetos opcionales, con los campos del Centro como
- * ciudadanos de primera clase.
- *
- * Los endpoints `authorize*Transaction` actuales del procesador no se tocan
- * y siguen recibiendo su tráfico legacy. Ver doc Fase 2 §5.1.
- */
-export class AuthorizeBenefitsMarketplaceTransactionRequest {
-    /**
-     * Reusa entradas existentes en `ProductCatalog_GT` del procesador
-     * (`MEX_TOPUP`, `MEX_SERVICE_PAYMENT`, …). No se agregan entradas nuevas
-     * en Fase 2 (ver doc §10).
-     *
-     * El factory dinámico `TransactionProcessorFactory.getMarketplaceInstance`
-     * deriva el token del binding desde aquí (`MEX_<X>` →
-     * `BenefitsMarketplace<X>TransactionService`). La regex impone el contrato
-     * y permite que el factory falle con 400 en lugar de 500 si llega algo
-     * fuera de la convención.
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    @Matches(/^MEX_[A-Z][A-Z_]*$/, {
-        message: "productCatalogId debe seguir el formato MEX_<UPPER_SNAKE>",
-    })
-    productCatalogId!: string;
-
-    /**
-     * Idempotency key generada por la **app** (UUID por intento).
-     * Lo consume el decorador `@IdempotencyController` del procesador para
-     * deduplicar reintentos del cliente.
-     *
-     * Distinto de `BenefitPaymentRequest.transactionNumber` que el procesador
-     * genera internamente al crear la transacción y envía al marketplace y
-     * al conector como idempotency key del lado del proveedor. La app NO
-     * debe generar `transactionNumber` — por eso este DTO no lo expone.
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    idempotencyKey!: string;
-
-    /**
-     * Monto en unidad mayor de la moneda (no centavos). Como mucho 2 decimales.
-     * El `Max` cap es defensivo — atrapa errores obvios (montos absurdos por
-     * bugs de UI) sin restringir casos legítimos. Ajustar si la operatoria
-     * requiere techos mayores.
-     */
-    @IsNumber({maxDecimalPlaces: 2})
-    @IsPositive()
-    @Max(1_000_000)
-    amount!: number;
-
-    /** ISO numeric (3 chars). Ej: "484" (MXN), "840" (USD). */
-    @IsString()
-    @Matches(/^\d{3}$/, {
-        message: "currencyId debe ser ISO numérico de 3 dígitos",
-    })
-    currencyId!: string;
-
-    // Campos del Centro de Beneficios — first-class, no opcionales
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    benefitId!: string;
-
-    /**
-     * `leafId = base64url("<moduleName>::<idServicio>")`. Convención
-     * cross-componente del Centro (ver
-     * `docs/favorites/05b-favoritos-ligados-a-producto.md`). La regex
-     * enforce el charset base64url sin tener que decodificar acá.
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(256)
-    @Matches(/^[A-Za-z0-9_-]+$/, {
-        message: "leafId debe estar codificado en base64url (charset A-Za-z0-9_-)",
-    })
-    leafId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    productId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(128)
-    reference!: string;
-
-    /**
-     * Decide a qué conector apuntar dentro del marketplace. Va concatenado
-     * a la URL `POST /pay/{moduleName}` del marketplace privado. La regex
-     * restringe a charset seguro (kebab-case minúsculas), previene
-     * inyecciones de path y matchea la convención de naming de los
-     * lambdas Fiado.
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(128)
-    @Matches(/^[a-z][a-z0-9-]*$/, {
-        message: "moduleName debe ser kebab-case minúsculas",
-    })
-    moduleName!: string;
-
-    /** Inputs dinámicos del leaf — opcionales según el servicio. */
-    @IsOptional()
-    @IsObject()
-    inputs?: Record<string, string | number | boolean>;
-
-    @IsOptional()
-    @IsLatitude()
-    latitude?: number;
-
-    @IsOptional()
-    @IsLongitude()
-    longitude?: number;
-}
+import {
+    IsLatitude,
+    IsLongitude,
+    IsNotEmpty,
+    IsNumber,
+    IsObject,
+    IsOptional,
+    IsPositive,
+    IsString,
+    Matches,
+    Max,
+    MaxLength,
+} from "class-validator";
+
+/**
+ * Request del endpoint nuevo `POST /authorizeBenefitsMarketplaceTransaction`
+ * en `transaction-processor-business` (PublicController). Lo invoca la app
+ * para todos los flujos del Centro de Beneficios.
+ *
+ * NO se reusa `AuthorizePaymentTransactionRequest` ni similares: este DTO
+ * es dedicado, sin sub-objetos opcionales, con los campos del Centro como
+ * ciudadanos de primera clase.
+ *
+ * Los endpoints `authorize*Transaction` actuales del procesador no se tocan
+ * y siguen recibiendo su tráfico legacy. Ver doc Fase 2 §5.1.
+ */
+export class AuthorizeBenefitsMarketplaceTransactionRequest {
+    /**
+     * Reusa entradas existentes en `ProductCatalog_GT` del procesador
+     * (`MEX_TOPUP`, `MEX_SERVICE_PAYMENT`, …). No se agregan entradas nuevas
+     * en Fase 2 (ver doc §10).
+     *
+     * El factory dinámico `TransactionProcessorFactory.getMarketplaceInstance`
+     * deriva el token del binding desde aquí (`MEX_<X>` →
+     * `BenefitsMarketplace<X>TransactionService`). La regex impone el contrato
+     * y permite que el factory falle con 400 en lugar de 500 si llega algo
+     * fuera de la convención.
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    @Matches(/^MEX_[A-Z][A-Z_]*$/, {
+        message: "productCatalogId debe seguir el formato MEX_<UPPER_SNAKE>",
+    })
+    productCatalogId!: string;
+
+    /**
+     * Idempotency key generada por la **app** (UUID por intento).
+     * Lo consume el decorador `@IdempotencyController` del procesador para
+     * deduplicar reintentos del cliente.
+     *
+     * Distinto de `BenefitPaymentRequest.transactionNumber` que el procesador
+     * genera internamente al crear la transacción y envía al marketplace y
+     * al conector como idempotency key del lado del proveedor. La app NO
+     * debe generar `transactionNumber` — por eso este DTO no lo expone.
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    idempotencyKey!: string;
+
+    /**
+     * Monto en unidad mayor de la moneda (no centavos). Como mucho 2 decimales.
+     * El `Max` cap es defensivo — atrapa errores obvios (montos absurdos por
+     * bugs de UI) sin restringir casos legítimos. Ajustar si la operatoria
+     * requiere techos mayores.
+     */
+    @IsNumber({maxDecimalPlaces: 2})
+    @IsPositive()
+    @Max(1_000_000)
+    amount!: number;
+
+    /** ISO numeric (3 chars). Ej: "484" (MXN), "840" (USD). */
+    @IsString()
+    @Matches(/^\d{3}$/, {
+        message: "currencyId debe ser ISO numérico de 3 dígitos",
+    })
+    currencyId!: string;
+
+    // Campos del Centro de Beneficios — first-class, no opcionales
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    benefitId!: string;
+
+    /**
+     * `leafId = base64url("<moduleName>::<idServicio>")`. Convención
+     * cross-componente del Centro (ver
+     * `docs/favorites/05b-favoritos-ligados-a-producto.md`). La regex
+     * enforce el charset base64url sin tener que decodificar acá.
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(256)
+    @Matches(/^[A-Za-z0-9_-]+$/, {
+        message: "leafId debe estar codificado en base64url (charset A-Za-z0-9_-)",
+    })
+    leafId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    productId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    reference!: string;
+
+    /**
+     * Decide a qué conector apuntar dentro del marketplace. Va concatenado
+     * a la URL `POST /pay/{moduleName}` del marketplace privado. La regex
+     * restringe a charset seguro (kebab-case minúsculas), previene
+     * inyecciones de path y matchea la convención de naming de los
+     * lambdas Fiado.
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    @Matches(/^[a-z][a-z0-9-]*$/, {
+        message: "moduleName debe ser kebab-case minúsculas",
+    })
+    moduleName!: string;
+
+    /** Inputs dinámicos del leaf — opcionales según el servicio. */
+    @IsOptional()
+    @IsObject()
+    inputs?: Record<string, string | number | boolean>;
+
+    @IsOptional()
+    @IsLatitude()
+    latitude?: number;
+
+    @IsOptional()
+    @IsLongitude()
+    longitude?: number;
+}

package/src/benefitCenter/dtos/BackofficeLeafDetailResponse.ts

@@ -1,14 +1,14 @@
-import { ConnectorCatalogItem } from "./ConnectorCatalogItem";
-
-/**
- * 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
- * (la edición editorial vive in-place en la tabla del conector).
- */
-export interface BackofficeLeafDetailResponse {
-    leafId: string;
-    benefitId: string;
-    moduleName: string;
-    serviceId: string;
-    item: ConnectorCatalogItem;
-}
+import { ConnectorCatalogItem } from "./ConnectorCatalogItem";
+
+/**
+ * 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
+ * (la edición editorial vive in-place en la tabla del conector).
+ */
+export interface BackofficeLeafDetailResponse {
+    leafId: string;
+    benefitId: string;
+    moduleName: string;
+    serviceId: string;
+    item: ConnectorCatalogItem;
+}

package/src/benefitCenter/dtos/BackofficeLeafListItem.ts

@@ -1,18 +1,18 @@
-/**
- * Item del listado paginado de leaves en el backoffice (v2 in-place).
- * Cada item representa un servicio del catálogo del conector, ya con
- * los valores editoriales aplicados (no hay "base/override/effective" —
- * la edición es in-place sobre la tabla del conector).
- */
-export interface BackofficeLeafListItem {
-    leafId: string;
-    benefitId: string;
-    moduleName: string;
-    serviceId: string;
-    category: string;
-    subcategory: string;
-    serviceName: string;
-    logo: string;
-    enabled: boolean;
-    updatedAt: number; // ms epoch — del item del conector
-}
+/**
+ * Item del listado paginado de leaves en el backoffice (v2 in-place).
+ * Cada item representa un servicio del catálogo del conector, ya con
+ * los valores editoriales aplicados (no hay "base/override/effective" —
+ * la edición es in-place sobre la tabla del conector).
+ */
+export interface BackofficeLeafListItem {
+    leafId: string;
+    benefitId: string;
+    moduleName: string;
+    serviceId: string;
+    category: string;
+    subcategory: string;
+    serviceName: string;
+    logo: string;
+    enabled: boolean;
+    updatedAt: number; // ms epoch — del item del conector
+}

package/src/benefitCenter/dtos/BackofficeLeafListResponse.ts

@@ -1,8 +1,8 @@
-import { BackofficeLeafListItem } from "./BackofficeLeafListItem";
-
-export class BackofficeLeafListResponse {
-    items: BackofficeLeafListItem[];
-
-    /** Cursor opaco para la próxima página. Ausente → no hay más páginas. */
-    index?: string;
-}
+import { BackofficeLeafListItem } from "./BackofficeLeafListItem";
+
+export class BackofficeLeafListResponse {
+    items: BackofficeLeafListItem[];
+
+    /** Cursor opaco para la próxima página. Ausente → no hay más páginas. */
+    index?: string;
+}

package/src/benefitCenter/dtos/BackofficeLeafUpdateRequest.ts

@@ -1,30 +1,30 @@
-import { IsBoolean, IsNumber, IsOptional, IsString, Matches, MaxLength } from "class-validator";
-
-/**
- * Patch parcial para editar un leaf in-place (v2). Todos los campos son
- * 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 —
- * vienen derivados del producto en el mapper del conector.
- */
-export class BackofficeLeafUpdateRequest {
-    @IsOptional() @IsString() @MaxLength(200) serviceName?: string;
-
-    @IsOptional() @IsString() @MaxLength(100)
-    @Matches(/^[A-Z][A-Z0-9_ ]*$/, { message: "category must match /^[A-Z][A-Z0-9_ ]*$/" })
-    category?: string;
-
-    @IsOptional() @IsString() @MaxLength(100)
-    @Matches(/^[A-Z][A-Z0-9_ ]*$/, { message: "subcategory must match /^[A-Z][A-Z0-9_ ]*$/" })
-    subcategory?: string;
-
-    @IsOptional() @IsBoolean() enabled?: boolean;
-
-    @IsOptional() @IsString() @MaxLength(500) logo?: string;
-
-    @IsOptional() @IsNumber() serviceOrder?: number;
-
-    @IsOptional() @IsNumber() subcategoryOrder?: number;
-}
+import { IsBoolean, IsNumber, IsOptional, IsString, Matches, MaxLength } from "class-validator";
+
+/**
+ * Patch parcial para editar un leaf in-place (v2). Todos los campos son
+ * 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 —
+ * vienen derivados del producto en el mapper del conector.
+ */
+export class BackofficeLeafUpdateRequest {
+    @IsOptional() @IsString() @MaxLength(200) serviceName?: string;
+
+    @IsOptional() @IsString() @MaxLength(100)
+    @Matches(/^[A-Z][A-Z0-9_ ]*$/, { message: "category must match /^[A-Z][A-Z0-9_ ]*$/" })
+    category?: string;
+
+    @IsOptional() @IsString() @MaxLength(100)
+    @Matches(/^[A-Z][A-Z0-9_ ]*$/, { message: "subcategory must match /^[A-Z][A-Z0-9_ ]*$/" })
+    subcategory?: string;
+
+    @IsOptional() @IsBoolean() enabled?: boolean;
+
+    @IsOptional() @IsString() @MaxLength(500) logo?: string;
+
+    @IsOptional() @IsNumber() serviceOrder?: number;
+
+    @IsOptional() @IsNumber() subcategoryOrder?: number;
+}

package/src/benefitCenter/dtos/BannerAction.ts

@@ -1,25 +1,25 @@
-import { BannerActionTypeEnum } from "../enums/BannerActionTypeEnum";
-
-/**
- * Acción pública del banner. La estructura cambia según `type`:
- *   - URL          → `target` (URL externa absoluta)
- *   - NAVIGATION   → `flow` y opcionalmente `props` (data dinámica para profundizar la navegación)
- *
- * Cuando un banner es informativo se omite el campo `action` por completo
- * en el response — no existe un type "NONE".
- */
-export class BannerAction {
-    type: BannerActionTypeEnum;
-
-    /** URL externa absoluta — solo si type === URL. */
-    target?: string;
-
-    /** Flow interno de la app — solo si type === NAVIGATION. */
-    flow?: string;
-
-    /** Data libre para profundizar la navegación — solo si type === NAVIGATION. */
-    props?: Record<string, unknown>;
-
-    /** Tracking arbitrario (campaign, source, etc.). */
-    metadata?: Record<string, unknown>;
-}
+import { BannerActionTypeEnum } from "../enums/BannerActionTypeEnum";
+
+/**
+ * Acción pública del banner. La estructura cambia según `type`:
+ *   - URL          → `target` (URL externa absoluta)
+ *   - NAVIGATION   → `flow` y opcionalmente `props` (data dinámica para profundizar la navegación)
+ *
+ * Cuando un banner es informativo se omite el campo `action` por completo
+ * en el response — no existe un type "NONE".
+ */
+export class BannerAction {
+    type: BannerActionTypeEnum;
+
+    /** URL externa absoluta — solo si type === URL. */
+    target?: string;
+
+    /** Flow interno de la app — solo si type === NAVIGATION. */
+    flow?: string;
+
+    /** Data libre para profundizar la navegación — solo si type === NAVIGATION. */
+    props?: Record<string, unknown>;
+
+    /** Tracking arbitrario (campaign, source, etc.). */
+    metadata?: Record<string, unknown>;
+}

package/src/benefitCenter/dtos/BannerActionRequest.ts

@@ -1,28 +1,28 @@
-import { IsEnum, IsObject, IsOptional, IsString } from "class-validator";
-import { BannerActionTypeEnum } from "../enums/BannerActionTypeEnum";
-
-/**
- * Acción del banner. Validación cruzada por tipo (la aplica el backend):
- *   - URL          → `target` debe estar presente (URL absoluta)
- *   - NAVIGATION   → `flow` debe estar presente; `props` opcional
- */
-export class BannerActionRequest {
-    @IsEnum(BannerActionTypeEnum)
-    type!: BannerActionTypeEnum;
-
-    /** URL externa absoluta — requerido cuando type === URL. */
-    @IsOptional() @IsString() target?: string;
-
-    /** Flow interno de la app — requerido cuando type === NAVIGATION. */
-    @IsOptional() @IsString() flow?: string;
-
-    /** Data libre para profundizar la navegación — opcional cuando type === NAVIGATION. */
-    @IsOptional()
-    @IsObject()
-    props?: Record<string, unknown>;
-
-    /** Tracking arbitrario (campaña, source, etc.). */
-    @IsOptional()
-    @IsObject()
-    metadata?: Record<string, unknown>;
-}
+import { IsEnum, IsObject, IsOptional, IsString } from "class-validator";
+import { BannerActionTypeEnum } from "../enums/BannerActionTypeEnum";
+
+/**
+ * Acción del banner. Validación cruzada por tipo (la aplica el backend):
+ *   - URL          → `target` debe estar presente (URL absoluta)
+ *   - NAVIGATION   → `flow` debe estar presente; `props` opcional
+ */
+export class BannerActionRequest {
+    @IsEnum(BannerActionTypeEnum)
+    type!: BannerActionTypeEnum;
+
+    /** URL externa absoluta — requerido cuando type === URL. */
+    @IsOptional() @IsString() target?: string;
+
+    /** Flow interno de la app — requerido cuando type === NAVIGATION. */
+    @IsOptional() @IsString() flow?: string;
+
+    /** Data libre para profundizar la navegación — opcional cuando type === NAVIGATION. */
+    @IsOptional()
+    @IsObject()
+    props?: Record<string, unknown>;
+
+    /** Tracking arbitrario (campaña, source, etc.). */
+    @IsOptional()
+    @IsObject()
+    metadata?: Record<string, unknown>;
+}

package/src/benefitCenter/dtos/BannerContent.ts

@@ -1,33 +1,33 @@
-import { BannerContentTypeEnum } from "../enums/BannerContentTypeEnum";
-import { BannerTemplateVariantEnum } from "../enums/BannerTemplateVariantEnum";
-import { BannerTemplateTheme } from "./BannerTemplateTheme";
-import { BannerTranslation } from "./BannerTranslation";
-
-/**
- * Wrapper de variant + theme para banners type === TEMPLATE.
- */
-export interface BannerTemplate {
-    variant: BannerTemplateVariantEnum;
-    theme?: BannerTemplateTheme;
-}
-
-/**
- * Contenido del banner con sus traducciones en ambos idiomas (es y en).
- *
- * La app elige qué locale renderizar según la preferencia del usuario —
- * el backend NO localiza del lado servidor, devuelve los dos idiomas
- * para que la app maneje la lógica de cambio de idioma sin re-pegarle
- * al endpoint cada vez que el usuario cambia el setting.
- */
-export class BannerContent {
-    type: BannerContentTypeEnum;
-
-    /** Solo presente cuando type === TEMPLATE. */
-    template?: BannerTemplate;
-
-    /** Traducciones por locale. El admin garantiza que ambas estén completas para banners ACTIVE. */
-    translations: {
-        es?: BannerTranslation;
-        en?: BannerTranslation;
-    };
-}
+import { BannerContentTypeEnum } from "../enums/BannerContentTypeEnum";
+import { BannerTemplateVariantEnum } from "../enums/BannerTemplateVariantEnum";
+import { BannerTemplateTheme } from "./BannerTemplateTheme";
+import { BannerTranslation } from "./BannerTranslation";
+
+/**
+ * Wrapper de variant + theme para banners type === TEMPLATE.
+ */
+export interface BannerTemplate {
+    variant: BannerTemplateVariantEnum;
+    theme?: BannerTemplateTheme;
+}
+
+/**
+ * Contenido del banner con sus traducciones en ambos idiomas (es y en).
+ *
+ * La app elige qué locale renderizar según la preferencia del usuario —
+ * el backend NO localiza del lado servidor, devuelve los dos idiomas
+ * para que la app maneje la lógica de cambio de idioma sin re-pegarle
+ * al endpoint cada vez que el usuario cambia el setting.
+ */
+export class BannerContent {
+    type: BannerContentTypeEnum;
+
+    /** Solo presente cuando type === TEMPLATE. */
+    template?: BannerTemplate;
+
+    /** Traducciones por locale. El admin garantiza que ambas estén completas para banners ACTIVE. */
+    translations: {
+        es?: BannerTranslation;
+        en?: BannerTranslation;
+    };
+}

package/src/benefitCenter/dtos/BannerContentRequest.ts

@@ -1,24 +1,24 @@
-import { IsEnum, IsOptional, ValidateNested } from "class-validator";
-import { Type } from "class-transformer";
-import { BannerContentTypeEnum } from "../enums/BannerContentTypeEnum";
-import { BannerTemplateRequest } from "./BannerTemplateRequest";
-import { BannerTranslationsRequest } from "./BannerTranslationsRequest";
-
-export class BannerContentRequest {
-    @IsEnum(BannerContentTypeEnum)
-    type!: BannerContentTypeEnum;
-
-    /**
-     * Solo presente cuando `type === TEMPLATE`. La validación cruzada
-     * "TEMPLATE requiere template, los demás tipos lo ignoran" la aplica
-     * el backend al persistir.
-     */
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => BannerTemplateRequest)
-    template?: BannerTemplateRequest;
-
-    @ValidateNested()
-    @Type(() => BannerTranslationsRequest)
-    translations!: BannerTranslationsRequest;
-}
+import { IsEnum, IsOptional, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { BannerContentTypeEnum } from "../enums/BannerContentTypeEnum";
+import { BannerTemplateRequest } from "./BannerTemplateRequest";
+import { BannerTranslationsRequest } from "./BannerTranslationsRequest";
+
+export class BannerContentRequest {
+    @IsEnum(BannerContentTypeEnum)
+    type!: BannerContentTypeEnum;
+
+    /**
+     * Solo presente cuando `type === TEMPLATE`. La validación cruzada
+     * "TEMPLATE requiere template, los demás tipos lo ignoran" la aplica
+     * el backend al persistir.
+     */
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerTemplateRequest)
+    template?: BannerTemplateRequest;
+
+    @ValidateNested()
+    @Type(() => BannerTranslationsRequest)
+    translations!: BannerTranslationsRequest;
+}