@fiado/type-kit 3.41.0 → 3.42.0

package/src/benefitCenter/dtos/BackofficeLeafCreateRequest.ts

@@ -0,0 +1,90 @@
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsInt,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    Min,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { Provider } from "../../provider/enums/Provider";
+import { BackofficeProductCreateItem } from "./BackofficeProductCreateItem";
+
+/**
+ * Body de POST /backoffice/leaves — alta manual de un servicio nuevo en el
+ * catálogo, en forma estándar. bmb rutea por `provider` al conector destino,
+ * que traduce a su forma nativa y persiste.
+ *
+ * `serviceId` (idServicio) y los `productId` vienen del Excel del proveedor
+ * (ids reales). Si el `serviceId` ya existe → 409 (no sobrescribe).
+ */
+export class BackofficeLeafCreateRequest {
+    /** Determina el conector destino (STP vs multicomm). */
+    @IsEnum(Provider)
+    provider!: Provider;
+
+    /** "ben-3" (recargas) | "ben-6" (pagos). */
+    @IsString()
+    @IsNotEmpty()
+    benefitId!: string;
+
+    /** idServicio real del proveedor (del Excel). */
+    @IsString()
+    @IsNotEmpty()
+    serviceId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    serviceName!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    category!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    subcategory!: string;
+
+    /** Código de moneda ISO (ej. "MXN", "USD"). */
+    @IsString()
+    @IsNotEmpty()
+    currency!: string;
+
+    /** Código ISO numérico del país destino (ej. "484"). */
+    @IsString()
+    @IsNotEmpty()
+    countryId!: string;
+
+    /** Logo del servicio (→ logoSrc). */
+    @IsOptional()
+    @IsString()
+    logo?: string;
+
+    /** Orden del servicio dentro de su subcategoría. Default 1. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    serviceOrder?: number;
+
+    /** Orden de la subcategoría. Default 1. */
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    subcategoryOrder?: number;
+
+    /** Habilitado en el catálogo público. Default true. */
+    @IsOptional()
+    @IsBoolean()
+    enabled?: boolean;
+
+    /** Productos del servicio (≥1). */
+    @IsArray()
+    @ArrayNotEmpty()
+    @ValidateNested({ each: true })
+    @Type(() => BackofficeProductCreateItem)
+    products!: BackofficeProductCreateItem[];
+}

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/BackofficeLeafFacetsResponse.ts

@@ -1,26 +1,26 @@
-/**
- * Respuesta del endpoint GET /backoffice/leaves/facets.
- *
- * Devuelve los valores distintos observados en el catálogo de ben-3 y ben-6
- * (ambos módulos: multicomm + stp). El front lo consume al cargar la pantalla
- * para armar dropdowns dinámicos de category/subcategory.
- *
- * NO incluye providers — esa lista es estática (el enum `Provider` del type-kit).
- */
-export interface BackofficeLeafFacetsResponse {
-    /** Categorías distintas en uso, ordenadas alfabéticamente. */
-    categories: string[];
-
-    /**
-     * Subcategorías por categoría, ordenadas alfabéticamente.
-     * Key = nombre de categoría, value = array de subcategorías que aparecen bajo esa categoría.
-     */
-    subcategoriesByCategory: { [category: string]: string[] };
-
-    /**
-     * Países destino distintos observados en el catálogo (códigos ISO numéricos,
-     * ordenados). El front arma el dropdown de filtro por país; el mapeo
-     * code→nombre/bandera es responsabilidad del front.
-     */
-    countries: string[];
-}
+/**
+ * Respuesta del endpoint GET /backoffice/leaves/facets.
+ *
+ * Devuelve los valores distintos observados en el catálogo de ben-3 y ben-6
+ * (ambos módulos: multicomm + stp). El front lo consume al cargar la pantalla
+ * para armar dropdowns dinámicos de category/subcategory.
+ *
+ * NO incluye providers — esa lista es estática (el enum `Provider` del type-kit).
+ */
+export interface BackofficeLeafFacetsResponse {
+    /** Categorías distintas en uso, ordenadas alfabéticamente. */
+    categories: string[];
+
+    /**
+     * Subcategorías por categoría, ordenadas alfabéticamente.
+     * Key = nombre de categoría, value = array de subcategorías que aparecen bajo esa categoría.
+     */
+    subcategoriesByCategory: { [category: string]: string[] };
+
+    /**
+     * Países destino distintos observados en el catálogo (códigos ISO numéricos,
+     * ordenados). El front arma el dropdown de filtro por país; el mapeo
+     * code→nombre/bandera es responsabilidad del front.
+     */
+    countries: string[];
+}

package/src/benefitCenter/dtos/BackofficeLeafHelpImageUpdateRequest.ts

@@ -1,13 +1,13 @@
-import { IsNotEmpty, IsString } from "class-validator";
-
-/**
- * Body de PUT /backoffice/leaves/{leafId}/help-image.
- *
- * Asigna la imagen de ayuda (`refSrc`) a TODOS los productos del servicio.
- */
-export class BackofficeLeafHelpImageUpdateRequest {
-    /** 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}/help-image.
+ *
+ * Asigna la imagen de ayuda (`refSrc`) a TODOS los productos del servicio.
+ */
+export class BackofficeLeafHelpImageUpdateRequest {
+    /** URL pública de la imagen de ayuda (CloudFront) ya subida. */
+    @IsString()
+    @IsNotEmpty()
+    helpImage!: string;
+}

package/src/benefitCenter/dtos/BackofficeLeafListItem.ts

@@ -1,27 +1,27 @@
-import { Provider } from "../../provider/enums/Provider";
-
-/**
- * Item del listado paginado de leaves en el backoffice (v3 — provider + currency + orders).
- * 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
-
-    // v3 additions
-    provider: Provider;      // MULTICOMM | MULTICENTER | STP — read-only, separa el lambda del proveedor real
-    currency: string;        // USD, MXN — moneda con la que se paga
-    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
-}
+import { Provider } from "../../provider/enums/Provider";
+
+/**
+ * Item del listado paginado de leaves en el backoffice (v3 — provider + currency + orders).
+ * 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
+
+    // v3 additions
+    provider: Provider;      // MULTICOMM | MULTICENTER | STP — read-only, separa el lambda del proveedor real
+    currency: string;        // USD, MXN — moneda con la que se paga
+    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
+}

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/BackofficeProductCreateItem.ts

@@ -0,0 +1,77 @@
+import {
+    IsBoolean,
+    IsEnum,
+    IsNotEmpty,
+    IsNumber,
+    IsOptional,
+    IsString,
+    Min,
+} from "class-validator";
+import { AmountTypeEnum } from "../../servicePayment/enums/AmountTypeEnum";
+import { ReferenceTypeEnum } from "../enums/ReferenceTypeEnum";
+
+/**
+ * Un producto que la jefa captura al crear un servicio manualmente. Forma
+ * estándar: el conector lo traduce a su `productoDTOList` nativo.
+ *
+ * `productId` es el id real del proveedor (viene en el Excel), igual que el
+ * `serviceId` del servicio.
+ */
+export class BackofficeProductCreateItem {
+    /** idProducto real del proveedor (del Excel). */
+    @IsString()
+    @IsNotEmpty()
+    productId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    productName!: string;
+
+    /** Precio del producto (0 para monto VARIABLE). */
+    @IsNumber()
+    @Min(0)
+    price!: number;
+
+    /** Comisión. Default 0 si se omite. */
+    @IsOptional()
+    @IsNumber()
+    @Min(0)
+    fee?: number;
+
+    @IsEnum(AmountTypeEnum)
+    amountType!: AmountTypeEnum;
+
+    /** Tipo de referencia (→ tipoReferencia nativo; define el input de la app). */
+    @IsEnum(ReferenceTypeEnum)
+    referenceType!: ReferenceTypeEnum;
+
+    /** Si la referencia lleva dígito verificador (→ hasDigitoVerificador). Default false. */
+    @IsOptional()
+    @IsBoolean()
+    hasCheckDigit?: boolean;
+
+    /** Si la referencia se verifica antes de pagar (→ verificateReference). Default false. */
+    @IsOptional()
+    @IsBoolean()
+    verifyReference?: boolean;
+
+    /** Texto de ayuda (→ legend). */
+    @IsOptional()
+    @IsString()
+    helpText?: string;
+
+    /** Imagen de ayuda / dónde escanear (→ refSrc). */
+    @IsOptional()
+    @IsString()
+    helpImage?: string;
+
+    /** Logo del producto (→ logoSrc). */
+    @IsOptional()
+    @IsString()
+    logo?: string;
+
+    /** Habilitado. Default true (ausencia = habilitado). */
+    @IsOptional()
+    @IsBoolean()
+    enabled?: boolean;
+}

package/src/benefitCenter/dtos/BackofficeProductEnabledUpdateRequest.ts

@@ -1,12 +1,12 @@
-import { IsBoolean } from "class-validator";
-
-/**
- * Body de PUT /backoffice/leaves/{leafId}/products/{productId}/enabled.
- *
- * Habilita/deshabilita UN producto. Un producto con `enabled=false` se oculta
- * del catálogo público (la ausencia del campo = habilitado).
- */
-export class BackofficeProductEnabledUpdateRequest {
-    @IsBoolean()
-    enabled!: boolean;
-}
+import { IsBoolean } from "class-validator";
+
+/**
+ * Body de PUT /backoffice/leaves/{leafId}/products/{productId}/enabled.
+ *
+ * Habilita/deshabilita UN producto. Un producto con `enabled=false` se oculta
+ * del catálogo público (la ausencia del campo = habilitado).
+ */
+export class BackofficeProductEnabledUpdateRequest {
+    @IsBoolean()
+    enabled!: boolean;
+}

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/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[];
+}