@fiado/type-kit 3.57.0 → 3.57.1

package/src/benefitCenter/dtos/ConnectorCatalogItem.ts

@@ -1,37 +1,37 @@
-import { ProductItem } from "./ProductItem";
-import { InputSchema } from "./InputSchema";
-import { Provider } from "../../provider/enums/Provider";
-
-/**
- * Item de catálogo que cada conector devuelve en GET /catalog/standard.
- * El CatalogTreeBuilder del Centro consume un array de estos items y arma
- * el árbol de navegación agrupando por category → subcategory → (LEAF).
- *
- * El `moduleName` NO viene aquí — el Centro lo inyecta al armar el LEAF
- * (sabe qué conector llamó).
- */
-export class ConnectorCatalogItem {
-    // Identidad
-    serviceId: string;
-    serviceName: string;
-    benefitId: string;           // "ben-3", "ben-6"
-    enabled: boolean;
-    provider: Provider;          // MULTICOMM_SERVICE_PAYMENT | MULTICENTER_SERVICE_PAYMENT | STP_SERVICE_PAYMENT — read-only metadata del catálogo del conector
-
-    // Navegación (usado por el CatalogTreeBuilder para armar BRANCHes)
-    category: string;            // "RECARGA", "AGUA"
-    subcategory: string;         // "TELCEL", "CESPM"
-    serviceOrder: number;        // orden del LEAF dentro del subcategory
-    subcategoryOrder: number;    // orden del subcategory dentro del category
-
-    // Data operacional
-    currency: string;            // "USD", "MXN"
-    countryId: string;           // ISO numérico
-    logo?: string;
-
-    // Data del leaf
-    requiresReferenceVerification: boolean;
-    products: ProductItem[];
-    inputSchema: InputSchema;
-    updatedAt: number;
-}
+import { ProductItem } from "./ProductItem";
+import { InputSchema } from "./InputSchema";
+import { Provider } from "../../provider/enums/Provider";
+
+/**
+ * Item de catálogo que cada conector devuelve en GET /catalog/standard.
+ * El CatalogTreeBuilder del Centro consume un array de estos items y arma
+ * el árbol de navegación agrupando por category → subcategory → (LEAF).
+ *
+ * El `moduleName` NO viene aquí — el Centro lo inyecta al armar el LEAF
+ * (sabe qué conector llamó).
+ */
+export class ConnectorCatalogItem {
+    // Identidad
+    serviceId: string;
+    serviceName: string;
+    benefitId: string;           // "ben-3", "ben-6"
+    enabled: boolean;
+    provider: Provider;          // MULTICOMM_SERVICE_PAYMENT | MULTICENTER_SERVICE_PAYMENT | STP_SERVICE_PAYMENT — read-only metadata del catálogo del conector
+
+    // Navegación (usado por el CatalogTreeBuilder para armar BRANCHes)
+    category: string;            // "RECARGA", "AGUA"
+    subcategory: string;         // "TELCEL", "CESPM"
+    serviceOrder: number;        // orden del LEAF dentro del subcategory
+    subcategoryOrder: number;    // orden del subcategory dentro del category
+
+    // Data operacional
+    currency: string;            // "USD", "MXN"
+    countryId: string;           // ISO numérico
+    logo?: string;
+
+    // Data del leaf
+    requiresReferenceVerification: boolean;
+    products: ProductItem[];
+    inputSchema: InputSchema;
+    updatedAt: number;
+}

package/src/benefitCenter/dtos/ConnectorCatalogResponse.ts

@@ -1,5 +1,5 @@
-import { ConnectorCatalogItem } from "./ConnectorCatalogItem";
-
-export class ConnectorCatalogResponse {
-    items: ConnectorCatalogItem[];
-}
+import { ConnectorCatalogItem } from "./ConnectorCatalogItem";
+
+export class ConnectorCatalogResponse {
+    items: ConnectorCatalogItem[];
+}

package/src/benefitCenter/dtos/FavoriteDetailResponse.ts

@@ -1,43 +1,43 @@
-import { BenefitSummary } from "./BenefitSummary";
-import { CatalogNode } from "./CatalogNode";
-
-/**
- * Selección previa del usuario que el frontend usa para pre-llenar el form
- * de pago. La `reference` viaja en claro (es data del propio usuario,
- * autenticado).
- */
-export class FavoriteSelection {
-    leafId: string;
-    productId: string;
-    amount: number | null;
-    reference: string;
-}
-
-/**
- * Metadata del favorito en sí (para menús contextuales, ordenamiento, etc.).
- */
-export class FavoriteDetailMeta {
-    id: string;
-    alias: string | null;
-    photo: string | null;
-    position: number;
-    disabled: boolean;
-    usageCount: number;
-    lastUsedAt: number;
-    createdAt: number;
-    updatedAt: number;
-}
-
-/**
- * Response de `GET /favorites/{id}`. Devuelve el shape del árbol del catálogo
- * (BRANCH padre con los LEAFs hermanos del favorito; el LEAF del favorito
- * trae `leaf` populado inline) más la selección previa y la metadata editable.
- *
- * El frontend reusa `renderCatalog(catalog)` sin caso especial.
- */
-export class FavoriteDetailResponse {
-    benefit: BenefitSummary;
-    catalog: CatalogNode;
-    selection: FavoriteSelection;
-    favorite: FavoriteDetailMeta;
-}
+import { BenefitSummary } from "./BenefitSummary";
+import { CatalogNode } from "./CatalogNode";
+
+/**
+ * Selección previa del usuario que el frontend usa para pre-llenar el form
+ * de pago. La `reference` viaja en claro (es data del propio usuario,
+ * autenticado).
+ */
+export class FavoriteSelection {
+    leafId: string;
+    productId: string;
+    amount: number | null;
+    reference: string;
+}
+
+/**
+ * Metadata del favorito en sí (para menús contextuales, ordenamiento, etc.).
+ */
+export class FavoriteDetailMeta {
+    id: string;
+    alias: string | null;
+    photo: string | null;
+    position: number;
+    disabled: boolean;
+    usageCount: number;
+    lastUsedAt: number;
+    createdAt: number;
+    updatedAt: number;
+}
+
+/**
+ * Response de `GET /favorites/{id}`. Devuelve el shape del árbol del catálogo
+ * (BRANCH padre con los LEAFs hermanos del favorito; el LEAF del favorito
+ * trae `leaf` populado inline) más la selección previa y la metadata editable.
+ *
+ * El frontend reusa `renderCatalog(catalog)` sin caso especial.
+ */
+export class FavoriteDetailResponse {
+    benefit: BenefitSummary;
+    catalog: CatalogNode;
+    selection: FavoriteSelection;
+    favorite: FavoriteDetailMeta;
+}

package/src/benefitCenter/dtos/FavoriteItem.ts

@@ -1,25 +1,25 @@
-import { FavoriteDisabledReasonEnum } from "../enums/FavoriteDisabledReasonEnum";
-
-/**
- * Ítem que viaja en `GET /favorites`. Representa un favorito ACTIVO
- * (la lista filtra `disabled=true` por default).
- */
-export class FavoriteItem {
-    id: string;
-    benefitId: string;
-
-    leafId: string;
-    productId: string;
-    referenceMasked: string;          // "555****567" — el campo crudo no se expone en lista
-
-    alias: string | null;
-    photo: string | null;
-    position: number;                 // orden definido por el usuario (drag-and-drop)
-    disabled: boolean;                // siempre false en GET (filtra disabled=true por default)
-    disabledReason: FavoriteDisabledReasonEnum | null;
-
-    lastProductId: string | null;
-    lastAmount: number | null;
-    usageCount: number;
-    lastUsedAt: number;
-}
+import { FavoriteDisabledReasonEnum } from "../enums/FavoriteDisabledReasonEnum";
+
+/**
+ * Ítem que viaja en `GET /favorites`. Representa un favorito ACTIVO
+ * (la lista filtra `disabled=true` por default).
+ */
+export class FavoriteItem {
+    id: string;
+    benefitId: string;
+
+    leafId: string;
+    productId: string;
+    referenceMasked: string;          // "555****567" — el campo crudo no se expone en lista
+
+    alias: string | null;
+    photo: string | null;
+    position: number;                 // orden definido por el usuario (drag-and-drop)
+    disabled: boolean;                // siempre false en GET (filtra disabled=true por default)
+    disabledReason: FavoriteDisabledReasonEnum | null;
+
+    lastProductId: string | null;
+    lastAmount: number | null;
+    usageCount: number;
+    lastUsedAt: number;
+}

package/src/benefitCenter/dtos/FavoriteListResponse.ts

@@ -1,5 +1,5 @@
-import { FavoriteItem } from "./FavoriteItem";
-
-export class FavoriteListResponse {
-    items: FavoriteItem[];
-}
+import { FavoriteItem } from "./FavoriteItem";
+
+export class FavoriteListResponse {
+    items: FavoriteItem[];
+}

package/src/benefitCenter/dtos/FavoriteReorderRequest.ts

@@ -1,32 +1,32 @@
-import {
-    IsArray,
-    IsInt,
-    IsNotEmpty,
-    IsString,
-    Min,
-    ValidateNested,
-} from "class-validator";
-import { Type } from "class-transformer";
-
-export class FavoriteReorderItem {
-    @IsString()
-    @IsNotEmpty()
-    id!: string;
-
-    @IsInt()
-    @Min(0)
-    position!: number;
-}
-
-/**
- * Body de `PATCH /favorites/reorder`. El frontend manda la lista completa con
- * las posiciones finales (1, 2, 3, …); el backend confía y persiste.
- *
- * `items: []` es válido: equivale a no-op (drag sin cambios netos) y devuelve 204.
- */
-export class FavoriteReorderRequest {
-    @IsArray()
-    @ValidateNested({ each: true })
-    @Type(() => FavoriteReorderItem)
-    items!: FavoriteReorderItem[];
-}
+import {
+    IsArray,
+    IsInt,
+    IsNotEmpty,
+    IsString,
+    Min,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+
+export class FavoriteReorderItem {
+    @IsString()
+    @IsNotEmpty()
+    id!: string;
+
+    @IsInt()
+    @Min(0)
+    position!: number;
+}
+
+/**
+ * Body de `PATCH /favorites/reorder`. El frontend manda la lista completa con
+ * las posiciones finales (1, 2, 3, …); el backend confía y persiste.
+ *
+ * `items: []` es válido: equivale a no-op (drag sin cambios netos) y devuelve 204.
+ */
+export class FavoriteReorderRequest {
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => FavoriteReorderItem)
+    items!: FavoriteReorderItem[];
+}

package/src/benefitCenter/dtos/FavoriteUpdateRequest.ts

@@ -1,35 +1,35 @@
-import {
-    IsOptional,
-    IsString,
-    IsUrl,
-    Length,
-    Matches,
-    MaxLength,
-    ValidateIf,
-} from "class-validator";
-
-/**
- * Body de `PATCH /favorites/{id}`. Solo `alias` y `photo` son editables por
- * el usuario.
- *
- * - `undefined` (campo ausente) → no se toca.
- * - `null` → borra el valor actual.
- * - `string` → setea el nuevo valor (validado).
- *
- * Si AMBOS llegan `undefined`, el manager devuelve `INVALID_PATCH_PAYLOAD`
- * (PATCH vacío no aporta).
- */
-export class FavoriteUpdateRequest {
-    @IsOptional()
-    @ValidateIf((_, value) => value !== null)
-    @IsString()
-    @Length(1, 60)
-    @Matches(/^[^\u0000-\u001f<>]+$/, { message: "alias contiene caracteres no permitidos" })
-    alias?: string | null;
-
-    @IsOptional()
-    @ValidateIf((_, value) => value !== null)
-    @IsUrl({ protocols: ["https"], require_protocol: true })
-    @MaxLength(500)
-    photo?: string | null;
-}
+import {
+    IsOptional,
+    IsString,
+    IsUrl,
+    Length,
+    Matches,
+    MaxLength,
+    ValidateIf,
+} from "class-validator";
+
+/**
+ * Body de `PATCH /favorites/{id}`. Solo `alias` y `photo` son editables por
+ * el usuario.
+ *
+ * - `undefined` (campo ausente) → no se toca.
+ * - `null` → borra el valor actual.
+ * - `string` → setea el nuevo valor (validado).
+ *
+ * Si AMBOS llegan `undefined`, el manager devuelve `INVALID_PATCH_PAYLOAD`
+ * (PATCH vacío no aporta).
+ */
+export class FavoriteUpdateRequest {
+    @IsOptional()
+    @ValidateIf((_, value) => value !== null)
+    @IsString()
+    @Length(1, 60)
+    @Matches(/^[^\u0000-\u001f<>]+$/, { message: "alias contiene caracteres no permitidos" })
+    alias?: string | null;
+
+    @IsOptional()
+    @ValidateIf((_, value) => value !== null)
+    @IsUrl({ protocols: ["https"], require_protocol: true })
+    @MaxLength(500)
+    photo?: string | null;
+}

package/src/benefitCenter/dtos/FavoriteUpsertContext.ts

@@ -1,26 +1,26 @@
-/**
- * Contexto que el `PaymentManager` del marketplace pasa a
- * `FavoriteManager.upsertFromPayment(...)` para crear/actualizar el favorito
- * tras un pago APPROVED.
- *
- * NO ES UN DTO DE REQUEST HTTP: vive solo dentro del proceso del lambda
- * `benefits-marketplace-business`. Por eso no lleva decoradores de
- * `class-validator` — nunca se deserializa desde un body HTTP.
- *
- * El procesador NO conoce este tipo (no participa en la lógica de favoritos).
- * Ver doc Fase 2 §4.3 y §8.4.
- */
-export class FavoriteUpsertContext {
-    directoryId: string;
-    benefitId: string;
-    leafId: string;
-    productId: string;
-    reference: string;
-    amount: number;
-
-    /** Idempotency key del pago — alimenta el GSI `transactionNumber-index`. */
-    transactionNumber: string;
-
-    /** Epoch ms — cuándo cerró la transacción exitosa en el conector. */
-    occurredAt: number;
-}
+/**
+ * Contexto que el `PaymentManager` del marketplace pasa a
+ * `FavoriteManager.upsertFromPayment(...)` para crear/actualizar el favorito
+ * tras un pago APPROVED.
+ *
+ * NO ES UN DTO DE REQUEST HTTP: vive solo dentro del proceso del lambda
+ * `benefits-marketplace-business`. Por eso no lleva decoradores de
+ * `class-validator` — nunca se deserializa desde un body HTTP.
+ *
+ * El procesador NO conoce este tipo (no participa en la lógica de favoritos).
+ * Ver doc Fase 2 §4.3 y §8.4.
+ */
+export class FavoriteUpsertContext {
+    directoryId: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    reference: string;
+    amount: number;
+
+    /** Idempotency key del pago — alimenta el GSI `transactionNumber-index`. */
+    transactionNumber: string;
+
+    /** Epoch ms — cuándo cerró la transacción exitosa en el conector. */
+    occurredAt: number;
+}

package/src/benefitCenter/dtos/FavoriteValidationResult.ts

@@ -1,37 +1,37 @@
-import { AmountTypeEnum } from "../../servicePayment/enums/AmountTypeEnum";
-import { FavoriteDisabledReasonEnum } from "../enums/FavoriteDisabledReasonEnum";
-
-/**
- * Información del leaf incluida en el response del validate cuando se pudo
- * resolver. Si el leaf no existe (`reason === LEAF_NOT_FOUND`), no viaja.
- */
-export class FavoriteValidationLeaf {
-    name: string;
-    logo: string;
-    enabled: boolean;
-}
-
-/**
- * Información del producto. `price` es `null` cuando `amountType === VARIABLE`
- * (productos de monto abierto donde el usuario decide cuánto pagar).
- */
-export class FavoriteValidationProduct {
-    productId: string;
-    productName: string;
-    amountType: AmountTypeEnum;
-    price: number | null;
-    currency: string;
-}
-
-/**
- * Resultado del endpoint `POST /favorites/{id}/validate`. Si `valid === false`,
- * el backend ya marcó `disabled: true` con `disabledReason: <reason>` en la
- * misma operación (excepto `USER`, que solo se setea por soft-delete del usuario).
- */
-export class FavoriteValidationResult {
-    id: string;
-    valid: boolean;
-    reason?: FavoriteDisabledReasonEnum;   // Nunca `USER` — eso es soft delete, no validación.
-    leaf?: FavoriteValidationLeaf;
-    product?: FavoriteValidationProduct;
-}
+import { AmountTypeEnum } from "../../servicePayment/enums/AmountTypeEnum";
+import { FavoriteDisabledReasonEnum } from "../enums/FavoriteDisabledReasonEnum";
+
+/**
+ * Información del leaf incluida en el response del validate cuando se pudo
+ * resolver. Si el leaf no existe (`reason === LEAF_NOT_FOUND`), no viaja.
+ */
+export class FavoriteValidationLeaf {
+    name: string;
+    logo: string;
+    enabled: boolean;
+}
+
+/**
+ * Información del producto. `price` es `null` cuando `amountType === VARIABLE`
+ * (productos de monto abierto donde el usuario decide cuánto pagar).
+ */
+export class FavoriteValidationProduct {
+    productId: string;
+    productName: string;
+    amountType: AmountTypeEnum;
+    price: number | null;
+    currency: string;
+}
+
+/**
+ * Resultado del endpoint `POST /favorites/{id}/validate`. Si `valid === false`,
+ * el backend ya marcó `disabled: true` con `disabledReason: <reason>` en la
+ * misma operación (excepto `USER`, que solo se setea por soft-delete del usuario).
+ */
+export class FavoriteValidationResult {
+    id: string;
+    valid: boolean;
+    reason?: FavoriteDisabledReasonEnum;   // Nunca `USER` — eso es soft delete, no validación.
+    leaf?: FavoriteValidationLeaf;
+    product?: FavoriteValidationProduct;
+}

package/src/benefitCenter/dtos/InputField.ts

@@ -1,14 +1,14 @@
-import { InputFieldTypeEnum } from "../enums/InputFieldTypeEnum";
-import { SelectOption } from "./SelectOption";
-
-export class InputField {
-    key: string;
-    type: InputFieldTypeEnum;
-    label: string;
-    required: boolean;
-    placeholder?: string;
-    helpImage?: string;
-    showHelp?: boolean;
-    options?: SelectOption[];
-    dependsOn?: string;
-}
+import { InputFieldTypeEnum } from "../enums/InputFieldTypeEnum";
+import { SelectOption } from "./SelectOption";
+
+export class InputField {
+    key: string;
+    type: InputFieldTypeEnum;
+    label: string;
+    required: boolean;
+    placeholder?: string;
+    helpImage?: string;
+    showHelp?: boolean;
+    options?: SelectOption[];
+    dependsOn?: string;
+}

package/src/benefitCenter/dtos/InputSchema.ts

@@ -1,7 +1,7 @@
-import { InputField } from "./InputField";
-import { InputValidation } from "./InputValidation";
-
-export class InputSchema {
-    fields: InputField[];
-    validations?: Record<string, InputValidation>;
-}
+import { InputField } from "./InputField";
+import { InputValidation } from "./InputValidation";
+
+export class InputSchema {
+    fields: InputField[];
+    validations?: Record<string, InputValidation>;
+}

package/src/benefitCenter/dtos/InputValidation.ts

@@ -1,8 +1,8 @@
-export class InputValidation {
-    pattern?: string;
-    maxLength?: number;
-    minLength?: number;
-    min?: number;
-    max?: number;
-    hasCheckDigit?: boolean;
-}
+export class InputValidation {
+    pattern?: string;
+    maxLength?: number;
+    minLength?: number;
+    min?: number;
+    max?: number;
+    hasCheckDigit?: boolean;
+}

package/src/benefitCenter/dtos/LeafAssetUploadUrlRequest.ts

@@ -1,23 +1,23 @@
-import { IsEnum, IsNotEmpty, IsString } from "class-validator";
-import { LeafAssetKindEnum } from "../enums/LeafAssetKindEnum";
-
-/**
- * Solicitud del backoffice para subir un asset de un leaf (logo o imagen de
- * ayuda) directamente a S3. El backend responde con una presigned PUT URL y la
- * URL pública final (CloudFront) que luego se asigna al leaf/producto.
- */
-export class LeafAssetUploadUrlRequest {
-    /** Determina la subcarpeta S3 y el whitelist de MIME/tamaño. */
-    @IsEnum(LeafAssetKindEnum)
-    kind!: LeafAssetKindEnum;
-
-    /** MIME type del archivo (ej. "image/png"). Debe estar en el whitelist. */
-    @IsString()
-    @IsNotEmpty()
-    contentType!: string;
-
-    /** Extensión sin punto (ej. "png"). Se usa para componer la key en S3. */
-    @IsString()
-    @IsNotEmpty()
-    fileExtension!: string;
-}
+import { IsEnum, IsNotEmpty, IsString } from "class-validator";
+import { LeafAssetKindEnum } from "../enums/LeafAssetKindEnum";
+
+/**
+ * Solicitud del backoffice para subir un asset de un leaf (logo o imagen de
+ * ayuda) directamente a S3. El backend responde con una presigned PUT URL y la
+ * URL pública final (CloudFront) que luego se asigna al leaf/producto.
+ */
+export class LeafAssetUploadUrlRequest {
+    /** Determina la subcarpeta S3 y el whitelist de MIME/tamaño. */
+    @IsEnum(LeafAssetKindEnum)
+    kind!: LeafAssetKindEnum;
+
+    /** MIME type del archivo (ej. "image/png"). Debe estar en el whitelist. */
+    @IsString()
+    @IsNotEmpty()
+    contentType!: string;
+
+    /** Extensión sin punto (ej. "png"). Se usa para componer la key en S3. */
+    @IsString()
+    @IsNotEmpty()
+    fileExtension!: string;
+}

package/src/benefitCenter/dtos/LeafAssetUploadUrlResponse.ts

@@ -1,13 +1,13 @@
-/**
- * Respuesta con la presigned URL para subir el asset del leaf directamente a S3.
- * El backoffice hace `PUT uploadUrl` con el `Content-Type` exacto solicitado y
- * body binario (≤ maxSizeBytes). `publicUrl` (CloudFront) es la que se asigna
- * luego al leaf (logo) o producto (helpImage).
- */
-export class LeafAssetUploadUrlResponse {
-    uploadUrl: string;
-    publicUrl: string;
-    key: string;
-    expiresAt: string;
-    maxSizeBytes: number;
-}
+/**
+ * Respuesta con la presigned URL para subir el asset del leaf directamente a S3.
+ * El backoffice hace `PUT uploadUrl` con el `Content-Type` exacto solicitado y
+ * body binario (≤ maxSizeBytes). `publicUrl` (CloudFront) es la que se asigna
+ * luego al leaf (logo) o producto (helpImage).
+ */
+export class LeafAssetUploadUrlResponse {
+    uploadUrl: string;
+    publicUrl: string;
+    key: string;
+    expiresAt: string;
+    maxSizeBytes: number;
+}