@fiado/type-kit 3.19.0 → 3.20.0

package/src/benefitCenter/dtos/BenefitCreateRequest.ts

@@ -1,67 +1,67 @@
-import {
-    IsEnum,
-    IsInt,
-    IsNotEmpty,
-    IsObject,
-    IsOptional,
-    IsString,
-    Min,
-    ValidateIf,
-    ValidateNested,
-} from "class-validator";
-import { Type } from "class-transformer";
-import { BenefitFlowEnum } from "../enums/BenefitFlowEnum";
-import { BenefitModuleConfigRequest } from "./BenefitModuleConfigRequest";
-
-/** Mirror enum-like de BenefitCatalogStatus en el type-kit (para validación). */
-export enum BenefitCatalogStatusEnum {
-    ACTIVE = "ACTIVE",
-    INACTIVE = "INACTIVE",
-    COMING_SOON = "COMING_SOON",
-}
-
-export class BenefitCreateRequest {
-    @IsOptional()
-    @IsString()
-    id?: string;
-
-    @IsNotEmpty()
-    @IsString()
-    name!: string;
-
-    @IsOptional()
-    @IsString()
-    description?: string;
-
-    @IsEnum(BenefitCatalogStatusEnum)
-    status!: BenefitCatalogStatusEnum;
-
-    @IsInt()
-    @Min(0)
-    sortOrder!: number;
-
-    @IsOptional()
-    @IsString()
-    icon?: string;
-
-    @IsEnum(BenefitFlowEnum)
-    flow!: BenefitFlowEnum;
-
-    @IsOptional()
-    @IsString()
-    translationKey?: string;
-
-    @ValidateNested()
-    @Type(() => BenefitModuleConfigRequest)
-    moduleConfig!: BenefitModuleConfigRequest;
-
-    /**
-     * Reglas de visibilidad. `null` se acepta como "beneficio 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 {
+    IsEnum,
+    IsInt,
+    IsNotEmpty,
+    IsObject,
+    IsOptional,
+    IsString,
+    Min,
+    ValidateIf,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { BenefitFlowEnum } from "../enums/BenefitFlowEnum";
+import { BenefitModuleConfigRequest } from "./BenefitModuleConfigRequest";
+
+/** Mirror enum-like de BenefitCatalogStatus en el type-kit (para validación). */
+export enum BenefitCatalogStatusEnum {
+    ACTIVE = "ACTIVE",
+    INACTIVE = "INACTIVE",
+    COMING_SOON = "COMING_SOON",
+}
+
+export class BenefitCreateRequest {
+    @IsOptional()
+    @IsString()
+    id?: string;
+
+    @IsNotEmpty()
+    @IsString()
+    name!: string;
+
+    @IsOptional()
+    @IsString()
+    description?: string;
+
+    @IsEnum(BenefitCatalogStatusEnum)
+    status!: BenefitCatalogStatusEnum;
+
+    @IsInt()
+    @Min(0)
+    sortOrder!: number;
+
+    @IsOptional()
+    @IsString()
+    icon?: string;
+
+    @IsEnum(BenefitFlowEnum)
+    flow!: BenefitFlowEnum;
+
+    @IsOptional()
+    @IsString()
+    translationKey?: string;
+
+    @ValidateNested()
+    @Type(() => BenefitModuleConfigRequest)
+    moduleConfig!: BenefitModuleConfigRequest;
+
+    /**
+     * Reglas de visibilidad. `null` se acepta como "beneficio 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/BenefitItem.ts

@@ -1,11 +1,11 @@
-import { BenefitFlowEnum } from "../enums/BenefitFlowEnum";
-
-export class BenefitItem {
-    id: string;
-    name: string;
-    description: string;
-    icon: string;
-    flow: BenefitFlowEnum;
-    translationKey: string;
-    sortOrder: number;
-}
+import { BenefitFlowEnum } from "../enums/BenefitFlowEnum";
+
+export class BenefitItem {
+    id: string;
+    name: string;
+    description: string;
+    icon: string;
+    flow: BenefitFlowEnum;
+    translationKey: string;
+    sortOrder: number;
+}

package/src/benefitCenter/dtos/BenefitListResponse.ts

@@ -1,7 +1,7 @@
-import { BenefitItem } from "./BenefitItem";
-import { BannerItem } from "./BannerItem";
-
-export class BenefitListResponse {
-    benefits: BenefitItem[];
-    banners?: BannerItem[];
-}
+import { BenefitItem } from "./BenefitItem";
+import { BannerItem } from "./BannerItem";
+
+export class BenefitListResponse {
+    benefits: BenefitItem[];
+    banners?: BannerItem[];
+}

package/src/benefitCenter/dtos/BenefitModuleConfigRequest.ts

@@ -1,11 +1,11 @@
-import { ArrayMinSize, IsArray, ValidateNested } from "class-validator";
-import { Type } from "class-transformer";
-import { BenefitModuleEntryRequest } from "./BenefitModuleEntryRequest";
-
-export class BenefitModuleConfigRequest {
-    @IsArray()
-    @ArrayMinSize(1)
-    @ValidateNested({ each: true })
-    @Type(() => BenefitModuleEntryRequest)
-    modules!: BenefitModuleEntryRequest[];
-}
+import { ArrayMinSize, IsArray, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { BenefitModuleEntryRequest } from "./BenefitModuleEntryRequest";
+
+export class BenefitModuleConfigRequest {
+    @IsArray()
+    @ArrayMinSize(1)
+    @ValidateNested({ each: true })
+    @Type(() => BenefitModuleEntryRequest)
+    modules!: BenefitModuleEntryRequest[];
+}

package/src/benefitCenter/dtos/BenefitModuleEntryRequest.ts

@@ -1,11 +1,11 @@
-import { IsNotEmpty, IsString } from "class-validator";
-
-export class BenefitModuleEntryRequest {
-    @IsNotEmpty()
-    @IsString()
-    moduleEnvVar!: string;
-
-    @IsNotEmpty()
-    @IsString()
-    moduleName!: string;
-}
+import { IsNotEmpty, IsString } from "class-validator";
+
+export class BenefitModuleEntryRequest {
+    @IsNotEmpty()
+    @IsString()
+    moduleEnvVar!: string;
+
+    @IsNotEmpty()
+    @IsString()
+    moduleName!: string;
+}

package/src/benefitCenter/dtos/BenefitPaymentRequest.ts

@@ -1,78 +1,78 @@
-import {
-    IsLatitude,
-    IsLongitude,
-    IsNotEmpty,
-    IsNumber,
-    IsObject,
-    IsOptional,
-    IsPositive,
-    IsString,
-    MaxLength,
-} from "class-validator";
-
-/**
- * Request del endpoint privado `POST /pay/{moduleName}` del marketplace
- * (`benefits-marketplace-business`). Lo invoca el procesador desde
- * `IBenefitsMarketplaceApi.pay(...)` cuando entra una transacción por el
- * endpoint `authorizeBenefitsMarketplaceTransaction`.
- *
- * Es el MISMO contrato que reciben los conectores en su `POST /pay/standard`
- * — el marketplace lo reenvía sin transformar (sin mappers legacy).
- *
- * Ver doc Fase 2 §4.1 y §8.1.
- */
-export class BenefitPaymentRequest {
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    directoryId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    benefitId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(256)
-    leafId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    productId!: string;
-
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(128)
-    reference!: string;
-
-    @IsNumber()
-    @IsPositive()
-    amount!: number;
-
-    /**
-     * Idempotency key del pago (la genera el procesador y la usa el conector
-     * para no re-cobrar si el request se repite).
-     */
-    @IsString()
-    @IsNotEmpty()
-    @MaxLength(64)
-    transactionNumber!: string;
-
-    /**
-     * Inputs dinámicos del leaf (definidos por su `inputSchema`). Opcionales
-     * según el servicio.
-     */
-    @IsOptional()
-    @IsObject()
-    inputs?: Record<string, string | number | boolean>;
-
-    @IsOptional()
-    @IsLatitude()
-    latitude?: number;
-
-    @IsOptional()
-    @IsLongitude()
-    longitude?: number;
-}
+import {
+    IsLatitude,
+    IsLongitude,
+    IsNotEmpty,
+    IsNumber,
+    IsObject,
+    IsOptional,
+    IsPositive,
+    IsString,
+    MaxLength,
+} from "class-validator";
+
+/**
+ * Request del endpoint privado `POST /pay/{moduleName}` del marketplace
+ * (`benefits-marketplace-business`). Lo invoca el procesador desde
+ * `IBenefitsMarketplaceApi.pay(...)` cuando entra una transacción por el
+ * endpoint `authorizeBenefitsMarketplaceTransaction`.
+ *
+ * Es el MISMO contrato que reciben los conectores en su `POST /pay/standard`
+ * — el marketplace lo reenvía sin transformar (sin mappers legacy).
+ *
+ * Ver doc Fase 2 §4.1 y §8.1.
+ */
+export class BenefitPaymentRequest {
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    directoryId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    benefitId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(256)
+    leafId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    productId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    reference!: string;
+
+    @IsNumber()
+    @IsPositive()
+    amount!: number;
+
+    /**
+     * Idempotency key del pago (la genera el procesador y la usa el conector
+     * para no re-cobrar si el request se repite).
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    transactionNumber!: string;
+
+    /**
+     * Inputs dinámicos del leaf (definidos por su `inputSchema`). Opcionales
+     * según el servicio.
+     */
+    @IsOptional()
+    @IsObject()
+    inputs?: Record<string, string | number | boolean>;
+
+    @IsOptional()
+    @IsLatitude()
+    latitude?: number;
+
+    @IsOptional()
+    @IsLongitude()
+    longitude?: number;
+}

package/src/benefitCenter/dtos/BenefitPaymentResponse.ts

@@ -1,28 +1,28 @@
-import { BenefitPaymentErrorCodeEnum } from "../enums/BenefitPaymentErrorCodeEnum";
-import { BenefitPaymentStatusEnum } from "../enums/BenefitPaymentStatusEnum";
-
-/**
- * Respuesta uniforme del marketplace al procesador, devuelta por el endpoint
- * `POST /pay/{moduleName}`. La emite el marketplace tras invocar al conector
- * — su shape NO depende del conector (el mapping interno → estándar lo hace
- * el propio conector en `/pay/standard`).
- *
- * Sin decoradores `class-validator`: el procesador la consume tal cual viene
- * por la red, no la valida. Ver doc Fase 2 §8.2.
- */
-export class BenefitPaymentResponse {
-    /** Estado final del pago. APPROVED dispara el upsert del favorito in-process. */
-    status: BenefitPaymentStatusEnum;
-
-    /** Tracking del proveedor externo (ej. STP authNum). Útil para auditoría. */
-    providerReference?: string;
-
-    /** Código en bruto del proveedor — sirve solo para debug. */
-    rawCode?: string;
-
-    /** Código canónico mapeado (cuando `status !== APPROVED`). */
-    errorCode?: BenefitPaymentErrorCodeEnum;
-
-    /** Mensaje legible asociado al error o al status. */
-    message?: string;
-}
+import { BenefitPaymentErrorCodeEnum } from "../enums/BenefitPaymentErrorCodeEnum";
+import { BenefitPaymentStatusEnum } from "../enums/BenefitPaymentStatusEnum";
+
+/**
+ * Respuesta uniforme del marketplace al procesador, devuelta por el endpoint
+ * `POST /pay/{moduleName}`. La emite el marketplace tras invocar al conector
+ * — su shape NO depende del conector (el mapping interno → estándar lo hace
+ * el propio conector en `/pay/standard`).
+ *
+ * Sin decoradores `class-validator`: el procesador la consume tal cual viene
+ * por la red, no la valida. Ver doc Fase 2 §8.2.
+ */
+export class BenefitPaymentResponse {
+    /** Estado final del pago. APPROVED dispara el upsert del favorito in-process. */
+    status: BenefitPaymentStatusEnum;
+
+    /** Tracking del proveedor externo (ej. STP authNum). Útil para auditoría. */
+    providerReference?: string;
+
+    /** Código en bruto del proveedor — sirve solo para debug. */
+    rawCode?: string;
+
+    /** Código canónico mapeado (cuando `status !== APPROVED`). */
+    errorCode?: BenefitPaymentErrorCodeEnum;
+
+    /** Mensaje legible asociado al error o al status. */
+    message?: string;
+}

package/src/benefitCenter/dtos/BenefitReferenceVerificationRequest.ts

@@ -1,25 +1,25 @@
-import { IsNotEmpty, Length } from "class-validator";
-
-/**
- * DTO propio del Centro de Beneficios para verificar una referencia antes de pagar.
- *
- * Reemplaza al legacy `ReferenceVerificationRequest` del dominio `servicePayment`
- * (que usa `idProducto`/`idServicio` como `number` en español). El lambda del
- * Centro mapea internamente a ese DTO legacy al invocar a los conectores.
- *
- * La respuesta sí se reusa: `ReferenceVerificationResponse` de `servicePayment`
- * ya tiene los campos correctos (`validReference`, `amount`).
- */
-export class BenefitReferenceVerificationRequest {
-    @IsNotEmpty()
-    @Length(1, 50)
-    serviceId: string;
-
-    @IsNotEmpty()
-    @Length(1, 50)
-    productId: string;
-
-    @IsNotEmpty()
-    @Length(1, 100)
-    reference: string;
-}
+import { IsNotEmpty, Length } from "class-validator";
+
+/**
+ * DTO propio del Centro de Beneficios para verificar una referencia antes de pagar.
+ *
+ * Reemplaza al legacy `ReferenceVerificationRequest` del dominio `servicePayment`
+ * (que usa `idProducto`/`idServicio` como `number` en español). El lambda del
+ * Centro mapea internamente a ese DTO legacy al invocar a los conectores.
+ *
+ * La respuesta sí se reusa: `ReferenceVerificationResponse` de `servicePayment`
+ * ya tiene los campos correctos (`validReference`, `amount`).
+ */
+export class BenefitReferenceVerificationRequest {
+    @IsNotEmpty()
+    @Length(1, 50)
+    serviceId: string;
+
+    @IsNotEmpty()
+    @Length(1, 50)
+    productId: string;
+
+    @IsNotEmpty()
+    @Length(1, 100)
+    reference: string;
+}

package/src/benefitCenter/dtos/BenefitSummary.ts

@@ -1,8 +1,8 @@
-import { BenefitFlowEnum } from "../enums/BenefitFlowEnum";
-
-export class BenefitSummary {
-    id: string;
-    name: string;
-    flow: BenefitFlowEnum;
-    version: string;
-}
+import { BenefitFlowEnum } from "../enums/BenefitFlowEnum";
+
+export class BenefitSummary {
+    id: string;
+    name: string;
+    flow: BenefitFlowEnum;
+    version: string;
+}

package/src/benefitCenter/dtos/BenefitUpdateRequest.ts

@@ -1,41 +1,41 @@
-import {
-    IsEnum,
-    IsInt,
-    IsObject,
-    IsOptional,
-    IsString,
-    Min,
-    ValidateIf,
-    ValidateNested,
-} from "class-validator";
-import { Type } from "class-transformer";
-import { BenefitFlowEnum } from "../enums/BenefitFlowEnum";
-import {
-    BenefitCatalogStatusEnum,
-} from "./BenefitCreateRequest";
-import { BenefitModuleConfigRequest } from "./BenefitModuleConfigRequest";
-
-export class BenefitUpdateRequest {
-    @IsOptional() @IsString() name?: string;
-    @IsOptional() @IsString() description?: string;
-    @IsOptional() @IsEnum(BenefitCatalogStatusEnum) status?: BenefitCatalogStatusEnum;
-    @IsOptional() @IsInt() @Min(0) sortOrder?: number;
-    @IsOptional() @IsString() icon?: string;
-    @IsOptional() @IsEnum(BenefitFlowEnum) flow?: BenefitFlowEnum;
-    @IsOptional() @IsString() translationKey?: string;
-
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => BenefitModuleConfigRequest)
-    moduleConfig?: BenefitModuleConfigRequest;
-
-    /**
-     * Reglas de visibilidad — patch parcial:
-     *   - `undefined` → no toca el campo existente.
-     *   - `null` → limpia la regla (beneficio se vuelve público).
-     *   - objeto → reemplaza la regla; debe pasar VisibilityRulesValidator.
-     */
-    @ValidateIf((_, value) => value !== null && value !== undefined)
-    @IsObject()
-    rulesVisibility?: Record<string, unknown> | null;
-}
+import {
+    IsEnum,
+    IsInt,
+    IsObject,
+    IsOptional,
+    IsString,
+    Min,
+    ValidateIf,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { BenefitFlowEnum } from "../enums/BenefitFlowEnum";
+import {
+    BenefitCatalogStatusEnum,
+} from "./BenefitCreateRequest";
+import { BenefitModuleConfigRequest } from "./BenefitModuleConfigRequest";
+
+export class BenefitUpdateRequest {
+    @IsOptional() @IsString() name?: string;
+    @IsOptional() @IsString() description?: string;
+    @IsOptional() @IsEnum(BenefitCatalogStatusEnum) status?: BenefitCatalogStatusEnum;
+    @IsOptional() @IsInt() @Min(0) sortOrder?: number;
+    @IsOptional() @IsString() icon?: string;
+    @IsOptional() @IsEnum(BenefitFlowEnum) flow?: BenefitFlowEnum;
+    @IsOptional() @IsString() translationKey?: string;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BenefitModuleConfigRequest)
+    moduleConfig?: BenefitModuleConfigRequest;
+
+    /**
+     * Reglas de visibilidad — patch parcial:
+     *   - `undefined` → no toca el campo existente.
+     *   - `null` → limpia la regla (beneficio se vuelve público).
+     *   - objeto → reemplaza la regla; debe pasar VisibilityRulesValidator.
+     */
+    @ValidateIf((_, value) => value !== null && value !== undefined)
+    @IsObject()
+    rulesVisibility?: Record<string, unknown> | null;
+}

package/src/benefitCenter/dtos/CatalogNode.ts

@@ -1,13 +1,13 @@
-import { CatalogNodeTypeEnum } from "../enums/CatalogNodeTypeEnum";
-import { ServiceLeaf } from "./ServiceLeaf";
-
-export class CatalogNode {
-    id: string;
-    name: string;
-    sortOrder: number;
-    type: CatalogNodeTypeEnum;
-    logo?: string;
-    children?: CatalogNode[];   // Solo si type === BRANCH
-    leafId?: string;            // Solo si type === LEAF
-    leaf?: ServiceLeaf;         // Solo si type === LEAF y el árbol es trivial (doc 07)
-}
+import { CatalogNodeTypeEnum } from "../enums/CatalogNodeTypeEnum";
+import { ServiceLeaf } from "./ServiceLeaf";
+
+export class CatalogNode {
+    id: string;
+    name: string;
+    sortOrder: number;
+    type: CatalogNodeTypeEnum;
+    logo?: string;
+    children?: CatalogNode[];   // Solo si type === BRANCH
+    leafId?: string;            // Solo si type === LEAF
+    leaf?: ServiceLeaf;         // Solo si type === LEAF y el árbol es trivial (doc 07)
+}