@fiado/type-kit 3.46.2 → 3.48.0

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;
+}

package/src/benefitCenter/dtos/BannerCreateRequest.ts

@@ -1,67 +1,67 @@
-import {
-    ArrayNotEmpty,
-    IsArray,
-    IsEnum,
-    IsInt,
-    IsNotEmpty,
-    IsObject,
-    IsOptional,
-    IsString,
-    Min,
-    ValidateIf,
-    ValidateNested,
-} from "class-validator";
-import { Type } from "class-transformer";
-import { BannerStatusEnum } from "../enums/BannerStatusEnum";
-import { BannerScreenEnum } from "../enums/BannerScreenEnum";
-import { BannerContentRequest } from "./BannerContentRequest";
-import { BannerActionRequest } from "./BannerActionRequest";
-
-export class BannerCreateRequest {
-    @IsOptional()
-    @IsString()
-    id?: string;
-
-    @IsNotEmpty()
-    @IsString()
-    name!: string;
-
-    @IsEnum(BannerStatusEnum)
-    status!: BannerStatusEnum;
-
-    @IsInt()
-    @Min(0)
-    sortOrder!: number;
-
-    /**
-     * Pantallas donde el banner aparece. Requerido — al menos un valor.
-     * El admin decide caso por caso por restricciones regulatorias (algunos
-     * benefits no se pueden promocionar en HOME).
-     */
-    @IsArray()
-    @ArrayNotEmpty()
-    @IsEnum(BannerScreenEnum, { each: true })
-    screens!: BannerScreenEnum[];
-
-    @IsOptional() @IsInt() startDate?: number;
-    @IsOptional() @IsInt() endDate?: number;
-
-    @ValidateNested()
-    @Type(() => BannerContentRequest)
-    content!: BannerContentRequest;
-
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => BannerActionRequest)
-    action?: BannerActionRequest;
-
-    /**
-     * Reglas de visibilidad. `null` se acepta como "banner público"
-     * (visible a todos los usuarios); `undefined` también — el backend
-     * normaliza ambos a "sin regla". Si se envía un objeto, debe pasar
-     * la validación del VisibilityRulesValidator.
-     */
-    @ValidateIf((_, value) => value !== null && value !== undefined)
-    @IsObject()
-    rulesVisibility?: Record<string, unknown> | null;
-}
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsNotEmpty,
+    IsObject,
+    IsOptional,
+    IsString,
+    Min,
+    ValidateIf,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { BannerStatusEnum } from "../enums/BannerStatusEnum";
+import { BannerScreenEnum } from "../enums/BannerScreenEnum";
+import { BannerContentRequest } from "./BannerContentRequest";
+import { BannerActionRequest } from "./BannerActionRequest";
+
+export class BannerCreateRequest {
+    @IsOptional()
+    @IsString()
+    id?: string;
+
+    @IsNotEmpty()
+    @IsString()
+    name!: string;
+
+    @IsEnum(BannerStatusEnum)
+    status!: BannerStatusEnum;
+
+    @IsInt()
+    @Min(0)
+    sortOrder!: number;
+
+    /**
+     * Pantallas donde el banner aparece. Requerido — al menos un valor.
+     * El admin decide caso por caso por restricciones regulatorias (algunos
+     * benefits no se pueden promocionar en HOME).
+     */
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(BannerScreenEnum, { each: true })
+    screens!: BannerScreenEnum[];
+
+    @IsOptional() @IsInt() startDate?: number;
+    @IsOptional() @IsInt() endDate?: number;
+
+    @ValidateNested()
+    @Type(() => BannerContentRequest)
+    content!: BannerContentRequest;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerActionRequest)
+    action?: BannerActionRequest;
+
+    /**
+     * Reglas de visibilidad. `null` se acepta como "banner público"
+     * (visible a todos los usuarios); `undefined` también — el backend
+     * normaliza ambos a "sin regla". Si se envía un objeto, debe pasar
+     * la validación del VisibilityRulesValidator.
+     */
+    @ValidateIf((_, value) => value !== null && value !== undefined)
+    @IsObject()
+    rulesVisibility?: Record<string, unknown> | null;
+}

package/src/benefitCenter/dtos/BannerItem.ts

@@ -1,9 +1,9 @@
-import { BannerContent } from "./BannerContent";
-import { BannerAction } from "./BannerAction";
-
-export class BannerItem {
-    id: string;
-    content: BannerContent;
-    sortOrder: number;
-    action?: BannerAction;
-}
+import { BannerContent } from "./BannerContent";
+import { BannerAction } from "./BannerAction";
+
+export class BannerItem {
+    id: string;
+    content: BannerContent;
+    sortOrder: number;
+    action?: BannerAction;
+}

package/src/benefitCenter/dtos/BannerTemplateRequest.ts

@@ -1,17 +1,17 @@
-import { IsEnum, IsOptional, ValidateNested } from "class-validator";
-import { Type } from "class-transformer";
-import { BannerTemplateVariantEnum } from "../enums/BannerTemplateVariantEnum";
-import { BannerTemplateThemeRequest } from "./BannerTemplateThemeRequest";
-
-/**
- * Wrapper de variant + theme para banners content.type === TEMPLATE.
- */
-export class BannerTemplateRequest {
-    @IsEnum(BannerTemplateVariantEnum)
-    variant!: BannerTemplateVariantEnum;
-
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => BannerTemplateThemeRequest)
-    theme?: BannerTemplateThemeRequest;
-}
+import { IsEnum, IsOptional, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { BannerTemplateVariantEnum } from "../enums/BannerTemplateVariantEnum";
+import { BannerTemplateThemeRequest } from "./BannerTemplateThemeRequest";
+
+/**
+ * Wrapper de variant + theme para banners content.type === TEMPLATE.
+ */
+export class BannerTemplateRequest {
+    @IsEnum(BannerTemplateVariantEnum)
+    variant!: BannerTemplateVariantEnum;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerTemplateThemeRequest)
+    theme?: BannerTemplateThemeRequest;
+}

package/src/benefitCenter/dtos/BannerTemplateTheme.ts

@@ -1,18 +1,18 @@
-/**
- * Theme de un banner TEMPLATE. Todos los campos son opcionales — si vienen
- * ausentes, el frontend aplica defaults de marca:
- *
- *   backgroundColor:       #915DE4
- *   textColor:             #FFFFFF
- *   buttonBackgroundColor: #FFFF00
- *   buttonTextColor:       #915DE4
- *
- * Los campos del botón (`buttonBackgroundColor`, `buttonTextColor`) sólo
- * tienen efecto cuando la variante incluye un botón.
- */
-export interface BannerTemplateTheme {
-    backgroundColor?: string;
-    textColor?: string;
-    buttonBackgroundColor?: string;
-    buttonTextColor?: string;
-}
+/**
+ * Theme de un banner TEMPLATE. Todos los campos son opcionales — si vienen
+ * ausentes, el frontend aplica defaults de marca:
+ *
+ *   backgroundColor:       #915DE4
+ *   textColor:             #FFFFFF
+ *   buttonBackgroundColor: #FFFF00
+ *   buttonTextColor:       #915DE4
+ *
+ * Los campos del botón (`buttonBackgroundColor`, `buttonTextColor`) sólo
+ * tienen efecto cuando la variante incluye un botón.
+ */
+export interface BannerTemplateTheme {
+    backgroundColor?: string;
+    textColor?: string;
+    buttonBackgroundColor?: string;
+    buttonTextColor?: string;
+}

package/src/benefitCenter/dtos/BannerTemplateThemeRequest.ts

@@ -1,23 +1,23 @@
-import { IsOptional, IsString } from "class-validator";
-
-/**
- * DTO de entrada para el theme del banner TEMPLATE. Todos los campos
- * opcionales — el frontend aplica defaults de marca cuando no vienen.
- */
-export class BannerTemplateThemeRequest {
-    @IsOptional()
-    @IsString()
-    backgroundColor?: string;
-
-    @IsOptional()
-    @IsString()
-    textColor?: string;
-
-    @IsOptional()
-    @IsString()
-    buttonBackgroundColor?: string;
-
-    @IsOptional()
-    @IsString()
-    buttonTextColor?: string;
-}
+import { IsOptional, IsString } from "class-validator";
+
+/**
+ * DTO de entrada para el theme del banner TEMPLATE. Todos los campos
+ * opcionales — el frontend aplica defaults de marca cuando no vienen.
+ */
+export class BannerTemplateThemeRequest {
+    @IsOptional()
+    @IsString()
+    backgroundColor?: string;
+
+    @IsOptional()
+    @IsString()
+    textColor?: string;
+
+    @IsOptional()
+    @IsString()
+    buttonBackgroundColor?: string;
+
+    @IsOptional()
+    @IsString()
+    buttonTextColor?: string;
+}

package/src/benefitCenter/dtos/BannerTranslation.ts

@@ -1,22 +1,22 @@
-/**
- * Slots de un banner por idioma. Cada `BannerContent.type` (y cada
- * variante de TEMPLATE) usa solo un subset de los campos:
- *
- *   - IMAGE                          → imageUrl
- *   - HTML                           → html
- *   - VIDEO                          → videoUrl, posterUrl?
- *   - TEMPLATE TITLE_DESCRIPTION_IMAGE        → title, description, imageUrl
- *   - TEMPLATE TITLE_DESCRIPTION_IMAGE_BUTTON → title, description, imageUrl, buttonText
- *
- * El backend devuelve las dos traducciones (es y en); la app elige cuál
- * mostrar según preferencia del usuario.
- */
-export interface BannerTranslation {
-    imageUrl?: string;
-    html?: string;
-    videoUrl?: string;
-    posterUrl?: string;
-    title?: string;
-    description?: string;
-    buttonText?: string;
-}
+/**
+ * Slots de un banner por idioma. Cada `BannerContent.type` (y cada
+ * variante de TEMPLATE) usa solo un subset de los campos:
+ *
+ *   - IMAGE                          → imageUrl
+ *   - HTML                           → html
+ *   - VIDEO                          → videoUrl, posterUrl?
+ *   - TEMPLATE TITLE_DESCRIPTION_IMAGE        → title, description, imageUrl
+ *   - TEMPLATE TITLE_DESCRIPTION_IMAGE_BUTTON → title, description, imageUrl, buttonText
+ *
+ * El backend devuelve las dos traducciones (es y en); la app elige cuál
+ * mostrar según preferencia del usuario.
+ */
+export interface BannerTranslation {
+    imageUrl?: string;
+    html?: string;
+    videoUrl?: string;
+    posterUrl?: string;
+    title?: string;
+    description?: string;
+    buttonText?: string;
+}

package/src/benefitCenter/dtos/BannerTranslationRequest.ts

@@ -1,31 +1,31 @@
-import { IsOptional, IsString } from "class-validator";
-
-/**
- * Slots por idioma. Cada `content.type` (y cada variante de TEMPLATE) usa
- * solo un subset; el resto se ignora. La validación cruzada por
- * (`content.type`, `template.variant`) la aplica el backend cuando el
- * banner queda ACTIVE — verifica que ambos locales tengan los slots
- * requeridos según el tipo y la variante.
- */
-export class BannerTranslationRequest {
-    /** IMAGE (banner completo) y TEMPLATE (ilustración / mascota lateral). */
-    @IsOptional() @IsString() imageUrl?: string;
-
-    /** HTML — fragmento de markup. */
-    @IsOptional() @IsString() html?: string;
-
-    /** VIDEO — URL del video. */
-    @IsOptional() @IsString() videoUrl?: string;
-
-    /** VIDEO — frame inicial / fallback cuando el video no se puede reproducir. */
-    @IsOptional() @IsString() posterUrl?: string;
-
-    /** TEMPLATE — título visible. */
-    @IsOptional() @IsString() title?: string;
-
-    /** TEMPLATE — descripción debajo del título. */
-    @IsOptional() @IsString() description?: string;
-
-    /** TEMPLATE _BUTTON — texto del botón CTA. */
-    @IsOptional() @IsString() buttonText?: string;
-}
+import { IsOptional, IsString } from "class-validator";
+
+/**
+ * Slots por idioma. Cada `content.type` (y cada variante de TEMPLATE) usa
+ * solo un subset; el resto se ignora. La validación cruzada por
+ * (`content.type`, `template.variant`) la aplica el backend cuando el
+ * banner queda ACTIVE — verifica que ambos locales tengan los slots
+ * requeridos según el tipo y la variante.
+ */
+export class BannerTranslationRequest {
+    /** IMAGE (banner completo) y TEMPLATE (ilustración / mascota lateral). */
+    @IsOptional() @IsString() imageUrl?: string;
+
+    /** HTML — fragmento de markup. */
+    @IsOptional() @IsString() html?: string;
+
+    /** VIDEO — URL del video. */
+    @IsOptional() @IsString() videoUrl?: string;
+
+    /** VIDEO — frame inicial / fallback cuando el video no se puede reproducir. */
+    @IsOptional() @IsString() posterUrl?: string;
+
+    /** TEMPLATE — título visible. */
+    @IsOptional() @IsString() title?: string;
+
+    /** TEMPLATE — descripción debajo del título. */
+    @IsOptional() @IsString() description?: string;
+
+    /** TEMPLATE _BUTTON — texto del botón CTA. */
+    @IsOptional() @IsString() buttonText?: string;
+}

package/src/benefitCenter/dtos/BannerTranslationsRequest.ts

@@ -1,15 +1,15 @@
-import { IsOptional, ValidateNested } from "class-validator";
-import { Type } from "class-transformer";
-import { BannerTranslationRequest } from "./BannerTranslationRequest";
-
-export class BannerTranslationsRequest {
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => BannerTranslationRequest)
-    es?: BannerTranslationRequest;
-
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => BannerTranslationRequest)
-    en?: BannerTranslationRequest;
-}
+import { IsOptional, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { BannerTranslationRequest } from "./BannerTranslationRequest";
+
+export class BannerTranslationsRequest {
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerTranslationRequest)
+    es?: BannerTranslationRequest;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerTranslationRequest)
+    en?: BannerTranslationRequest;
+}