@fiado/type-kit 3.19.0 → 3.20.0

package/src/benefitCenter/dtos/ConnectorCatalogItem.ts

@@ -1,35 +1,35 @@
-import { ProductItem } from "./ProductItem";
-import { InputSchema } from "./InputSchema";
-
-/**
- * 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;
-
-    // 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";
+
+/**
+ * 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;
+
+    // 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/ProductItem.ts

@@ -1,11 +1,11 @@
-import { AmountTypeEnum } from "../../servicePayment";
-
-export class ProductItem {
-    productId: string;
-    productName: string;
-    price: number;
-    fee: number;
-    amountType: AmountTypeEnum;
-    logo: string;
-    helpText: string;
-}
+import { AmountTypeEnum } from "../../servicePayment";
+
+export class ProductItem {
+    productId: string;
+    productName: string;
+    price: number;
+    fee: number;
+    amountType: AmountTypeEnum;
+    logo: string;
+    helpText: string;
+}

package/src/benefitCenter/dtos/PublicVerifyReferenceRequest.ts

@@ -1,33 +1,33 @@
-import { IsNotEmpty, IsString, Length } from "class-validator";
-
-/**
- * Request del endpoint público POST /benefits/{benefitId}/verificateReference del
- * `benefits-marketplace-business`. Combina:
- *  - Los campos de `BenefitReferenceVerificationRequest` (serviceId/productId/reference)
- *  - Un `leafId` adicional para que el lambda del Centro sepa a qué módulo rutear
- *    la verificación sin tener que buscar por anchor.
- *
- * Se expone separado de `BenefitReferenceVerificationRequest` porque éste último
- * es el contrato DIRECTO al conector (no conoce de leafIds).
- */
-export class PublicVerifyReferenceRequest {
-    @IsNotEmpty()
-    @IsString()
-    @Length(1, 100)
-    leafId!: string;
-
-    @IsNotEmpty()
-    @IsString()
-    @Length(1, 50)
-    serviceId!: string;
-
-    @IsNotEmpty()
-    @IsString()
-    @Length(1, 50)
-    productId!: string;
-
-    @IsNotEmpty()
-    @IsString()
-    @Length(1, 100)
-    reference!: string;
-}
+import { IsNotEmpty, IsString, Length } from "class-validator";
+
+/**
+ * Request del endpoint público POST /benefits/{benefitId}/verificateReference del
+ * `benefits-marketplace-business`. Combina:
+ *  - Los campos de `BenefitReferenceVerificationRequest` (serviceId/productId/reference)
+ *  - Un `leafId` adicional para que el lambda del Centro sepa a qué módulo rutear
+ *    la verificación sin tener que buscar por anchor.
+ *
+ * Se expone separado de `BenefitReferenceVerificationRequest` porque éste último
+ * es el contrato DIRECTO al conector (no conoce de leafIds).
+ */
+export class PublicVerifyReferenceRequest {
+    @IsNotEmpty()
+    @IsString()
+    @Length(1, 100)
+    leafId!: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @Length(1, 50)
+    serviceId!: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @Length(1, 50)
+    productId!: string;
+
+    @IsNotEmpty()
+    @IsString()
+    @Length(1, 100)
+    reference!: string;
+}

package/src/benefitCenter/dtos/SelectOption.ts

@@ -1,4 +1,4 @@
-export class SelectOption {
-    value: string;
-    label: string;
-}
+export class SelectOption {
+    value: string;
+    label: string;
+}