@fiado/type-kit 3.58.0 → 3.59.0

package/src/benefitCenter/dtos/BackofficeProductHelpImageUpdateRequest.ts

@@ -1,13 +1,13 @@
-import { IsNotEmpty, IsString } from "class-validator";
-
-/**
- * Body de PUT /backoffice/leaves/{leafId}/products/{productId}/help-image.
- *
- * Asigna la imagen de ayuda (`refSrc`) a UN producto específico del servicio.
- */
-export class BackofficeProductHelpImageUpdateRequest {
-    /** URL pública de la imagen de ayuda (CloudFront) ya subida. */
-    @IsString()
-    @IsNotEmpty()
-    helpImage!: string;
-}
+import { IsNotEmpty, IsString } from "class-validator";
+
+/**
+ * Body de PUT /backoffice/leaves/{leafId}/products/{productId}/help-image.
+ *
+ * Asigna la imagen de ayuda (`refSrc`) a UN producto específico del servicio.
+ */
+export class BackofficeProductHelpImageUpdateRequest {
+    /** URL pública de la imagen de ayuda (CloudFront) ya subida. */
+    @IsString()
+    @IsNotEmpty()
+    helpImage!: string;
+}

package/src/benefitCenter/dtos/BackofficeProductUpdateRequest.ts

@@ -1,75 +1,75 @@
-import {
-    IsBoolean,
-    IsEnum,
-    IsNumber,
-    IsOptional,
-    IsString,
-    Min,
-    MaxLength,
-} from "class-validator";
-import { AmountTypeEnum } from "../../servicePayment/enums/AmountTypeEnum";
-import { ReferenceTypeEnum } from "../enums/ReferenceTypeEnum";
-
-/**
- * Patch parcial in-place de un producto existente (F2/F3). Se traduce a forma
- * nativa en el conector (que re-deriva tipoFront de amountType).
- */
-export class BackofficeProductUpdateRequest {
-    @IsOptional()
-    @IsString()
-    @MaxLength(200)
-    productName?: string;
-
-    /** Precio del producto (0 para monto VARIABLE). */
-    @IsOptional()
-    @IsNumber()
-    @Min(0)
-    price?: number;
-
-    /** Comisión. */
-    @IsOptional()
-    @IsNumber()
-    @Min(0)
-    fee?: number;
-
-    @IsOptional()
-    @IsEnum(AmountTypeEnum)
-    amountType?: AmountTypeEnum;
-
-    /** Tipo de referencia (→ tipoReferencia nativo; define el input de la app). */
-    @IsOptional()
-    @IsEnum(ReferenceTypeEnum)
-    referenceType?: ReferenceTypeEnum;
-
-    /** Si la referencia lleva dígito verificador (→ hasDigitoVerificador). */
-    @IsOptional()
-    @IsBoolean()
-    hasCheckDigit?: boolean;
-
-    /** Si la referencia se verifica antes de pagar (→ verificateReference). */
-    @IsOptional()
-    @IsBoolean()
-    verifyReference?: boolean;
-
-    /** Texto de ayuda (→ legend). */
-    @IsOptional()
-    @IsString()
-    helpText?: string;
-
-    /** Imagen de ayuda / dónde escanear (→ refSrc). */
-    @IsOptional()
-    @IsString()
-    @MaxLength(500)
-    helpImage?: string;
-
-    /** Logo del producto (→ logoSrc). */
-    @IsOptional()
-    @IsString()
-    @MaxLength(500)
-    logo?: string;
-
-    /** Habilitado. */
-    @IsOptional()
-    @IsBoolean()
-    enabled?: boolean;
-}
+import {
+    IsBoolean,
+    IsEnum,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Min,
+    MaxLength,
+} from "class-validator";
+import { AmountTypeEnum } from "../../servicePayment/enums/AmountTypeEnum";
+import { ReferenceTypeEnum } from "../enums/ReferenceTypeEnum";
+
+/**
+ * Patch parcial in-place de un producto existente (F2/F3). Se traduce a forma
+ * nativa en el conector (que re-deriva tipoFront de amountType).
+ */
+export class BackofficeProductUpdateRequest {
+    @IsOptional()
+    @IsString()
+    @MaxLength(200)
+    productName?: string;
+
+    /** Precio del producto (0 para monto VARIABLE). */
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    price?: number;
+
+    /** Comisión. */
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    fee?: number;
+
+    @IsOptional()
+    @IsEnum(AmountTypeEnum)
+    amountType?: AmountTypeEnum;
+
+    /** Tipo de referencia (→ tipoReferencia nativo; define el input de la app). */
+    @IsOptional()
+    @IsEnum(ReferenceTypeEnum)
+    referenceType?: ReferenceTypeEnum;
+
+    /** Si la referencia lleva dígito verificador (→ hasDigitoVerificador). */
+    @IsOptional()
+    @IsBoolean()
+    hasCheckDigit?: boolean;
+
+    /** Si la referencia se verifica antes de pagar (→ verificateReference). */
+    @IsOptional()
+    @IsBoolean()
+    verifyReference?: boolean;
+
+    /** Texto de ayuda (→ legend). */
+    @IsOptional()
+    @IsString()
+    helpText?: string;
+
+    /** Imagen de ayuda / dónde escanear (→ refSrc). */
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    helpImage?: string;
+
+    /** Logo del producto (→ logoSrc). */
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    logo?: string;
+
+    /** Habilitado. */
+    @IsOptional()
+    @IsBoolean()
+    enabled?: boolean;
+}

package/src/benefitCenter/dtos/BackofficeSubcategoryLogoUpdateRequest.ts

@@ -1,14 +1,14 @@
-import { IsNotEmpty, IsString } from "class-validator";
-
-/**
- * Body de PUT /backoffice/leaves/categories/{category}/subcategories/{subcategory}/logo.
- *
- * Asigna el mismo `logo` (URL pública ya subida a S3) a TODOS los leaves de la
- * `(category, subcategory)` — el logo es de la marca, no de cada país.
- */
-export class BackofficeSubcategoryLogoUpdateRequest {
-    /** URL pública del logo (CloudFront) ya subido vía asset-upload-url. */
-    @IsString()
-    @IsNotEmpty()
-    logo!: string;
-}
+import { IsNotEmpty, IsString } from "class-validator";
+
+/**
+ * Body de PUT /backoffice/leaves/categories/{category}/subcategories/{subcategory}/logo.
+ *
+ * Asigna el mismo `logo` (URL pública ya subida a S3) a TODOS los leaves de la
+ * `(category, subcategory)` — el logo es de la marca, no de cada país.
+ */
+export class BackofficeSubcategoryLogoUpdateRequest {
+    /** URL pública del logo (CloudFront) ya subido vía asset-upload-url. */
+    @IsString()
+    @IsNotEmpty()
+    logo!: string;
+}

package/src/benefitCenter/dtos/BackofficeSubcategoryOrderUpdateRequest.ts

@@ -1,20 +1,20 @@
-import { IsInt, IsString, IsNotEmpty, Min } from "class-validator";
-
-/**
- * Body de PUT /backoffice/leaves/categories/{category}/subcategories/{subcategory}/subcategoryOrder.
- *
- * Aplica `order` como `subcategoryOrder` a los leaves de esa
- * (category, subcategory) EN el país indicado (`countryId`). Normaliza el valor
- * en el grupo de ese país de una sola llamada. El orden de una subcategoría es
- * per-país (TELCEL puede ir distinto en MX vs CO).
- */
-export class BackofficeSubcategoryOrderUpdateRequest {
-    @IsInt()
-    @Min(0)
-    order: number;
-
-    /** Código ISO numérico del país destino cuyo orden se ajusta (ej. "484"). */
-    @IsString()
-    @IsNotEmpty()
-    countryId: string;
-}
+import { IsInt, IsString, IsNotEmpty, Min } from "class-validator";
+
+/**
+ * Body de PUT /backoffice/leaves/categories/{category}/subcategories/{subcategory}/subcategoryOrder.
+ *
+ * Aplica `order` como `subcategoryOrder` a los leaves de esa
+ * (category, subcategory) EN el país indicado (`countryId`). Normaliza el valor
+ * en el grupo de ese país de una sola llamada. El orden de una subcategoría es
+ * per-país (TELCEL puede ir distinto en MX vs CO).
+ */
+export class BackofficeSubcategoryOrderUpdateRequest {
+    @IsInt()
+    @Min(0)
+    order: number;
+
+    /** Código ISO numérico del país destino cuyo orden se ajusta (ej. "484"). */
+    @IsString()
+    @IsNotEmpty()
+    countryId: string;
+}

package/src/benefitCenter/dtos/BackofficeSubcategoryOrdersResponse.ts

@@ -1,29 +1,29 @@
-/**
- * Una subcategoría con su orden canónico y cuántos leaves agrupa.
- * `order` = min(subcategoryOrder) entre los leaves del grupo (hasta que un
- * bulk PUT los normalice a un único valor).
- */
-export interface SubcategoryOrderItem {
-    subcategory: string;
-    order: number;
-    leafCount: number;
-}
-
-/**
- * Respuesta de GET /backoffice/leaves/subcategory-orders.
- *
- * Alimenta la pantalla de "Ordenamiento de subcategorías" del backoffice.
- * Estructura POR PAÍS: el orden de una subcategoría depende del país destino
- * (ej. TELCEL puede ir 1º en MX y último en CO). Cada subcategoría aparece una
- * vez por cada país donde opera.
- *
- * Forma: `byCountry[countryId][category]` = subcategorías de esa categoría EN ese
- * país, ordenadas por `order` ASC (alfabético como desempate). `order` =
- * min(subcategoryOrder) entre los leaves de `(country, category, subcategory)`.
- *
- * `countryId` es el código ISO numérico (el front mapea a nombre/bandera).
- * `leafCount` incluye leaves deshabilitados (se ordena el árbol completo).
- */
-export interface BackofficeSubcategoryOrdersResponse {
-    byCountry: { [countryId: string]: { [category: string]: SubcategoryOrderItem[] } };
-}
+/**
+ * Una subcategoría con su orden canónico y cuántos leaves agrupa.
+ * `order` = min(subcategoryOrder) entre los leaves del grupo (hasta que un
+ * bulk PUT los normalice a un único valor).
+ */
+export interface SubcategoryOrderItem {
+    subcategory: string;
+    order: number;
+    leafCount: number;
+}
+
+/**
+ * Respuesta de GET /backoffice/leaves/subcategory-orders.
+ *
+ * Alimenta la pantalla de "Ordenamiento de subcategorías" del backoffice.
+ * Estructura POR PAÍS: el orden de una subcategoría depende del país destino
+ * (ej. TELCEL puede ir 1º en MX y último en CO). Cada subcategoría aparece una
+ * vez por cada país donde opera.
+ *
+ * Forma: `byCountry[countryId][category]` = subcategorías de esa categoría EN ese
+ * país, ordenadas por `order` ASC (alfabético como desempate). `order` =
+ * min(subcategoryOrder) entre los leaves de `(country, category, subcategory)`.
+ *
+ * `countryId` es el código ISO numérico (el front mapea a nombre/bandera).
+ * `leafCount` incluye leaves deshabilitados (se ordena el árbol completo).
+ */
+export interface BackofficeSubcategoryOrdersResponse {
+    byCountry: { [countryId: string]: { [category: string]: SubcategoryOrderItem[] } };
+}

package/src/benefitCenter/dtos/BackofficeSubcategoryReorderRequest.ts

@@ -1,17 +1,17 @@
-import { ArrayNotEmpty, IsArray, IsString } from "class-validator";
-
-/**
- * Body de PUT /backoffice/leaves/categories/{category}/countries/{countryId}/subcategory-orders.
- *
- * Reordenamiento bulk para drag-and-drop: el front manda la lista COMPLETA de
- * subcategorías de la categoría (para ese país) en el orden deseado. El backend
- * asigna `subcategoryOrder = índice+1` a los leaves de cada subcategoría EN ese
- * país, en una sola llamada.
- */
-export class BackofficeSubcategoryReorderRequest {
-    /** Subcategorías en el orden final deseado (posición 1..N por índice). */
-    @IsArray()
-    @ArrayNotEmpty()
-    @IsString({ each: true })
-    orders: string[];
-}
+import { ArrayNotEmpty, IsArray, IsString } from "class-validator";
+
+/**
+ * Body de PUT /backoffice/leaves/categories/{category}/countries/{countryId}/subcategory-orders.
+ *
+ * Reordenamiento bulk para drag-and-drop: el front manda la lista COMPLETA de
+ * subcategorías de la categoría (para ese país) en el orden deseado. El backend
+ * asigna `subcategoryOrder = índice+1` a los leaves de cada subcategoría EN ese
+ * país, en una sola llamada.
+ */
+export class BackofficeSubcategoryReorderRequest {
+    /** Subcategorías en el orden final deseado (posición 1..N por índice). */
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsString({ each: true })
+    orders: string[];
+}

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