@fiado/type-kit 3.46.2 → 3.48.0

package/src/benefitCenter/dtos/BannerUpdateRequest.ts

@@ -1,57 +1,57 @@
-import {
-    ArrayNotEmpty,
-    IsArray,
-    IsEnum,
-    IsInt,
-    IsObject,
-    IsOptional,
-    IsString,
-    Min,
-    ValidateIf,
-    ValidateNested,
-} from "class-validator";
-import { Type } from "class-transformer";
-import { BannerStatusEnum } from "../enums/BannerStatusEnum";
-import { BannerScreenEnum } from "../enums/BannerScreenEnum";
-import { BannerContentRequest } from "./BannerContentRequest";
-import { BannerActionRequest } from "./BannerActionRequest";
-
-/**
- * Patch parcial. Todos los campos son opcionales — el manager mergea con
- * el documento existente y revalida (regla bilingüe + screens no vacío
- * + action por type) sobre el resultado merged.
- */
-export class BannerUpdateRequest {
-    @IsOptional() @IsString() name?: string;
-    @IsOptional() @IsEnum(BannerStatusEnum) status?: BannerStatusEnum;
-    @IsOptional() @IsInt() @Min(0) sortOrder?: number;
-
-    @IsOptional()
-    @IsArray()
-    @ArrayNotEmpty()
-    @IsEnum(BannerScreenEnum, { each: true })
-    screens?: BannerScreenEnum[];
-
-    @IsOptional() @IsInt() startDate?: number;
-    @IsOptional() @IsInt() endDate?: number;
-
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => BannerContentRequest)
-    content?: BannerContentRequest;
-
-    @IsOptional()
-    @ValidateNested()
-    @Type(() => BannerActionRequest)
-    action?: BannerActionRequest;
-
-    /**
-     * Reglas de visibilidad — patch parcial:
-     *   - `undefined` → no toca el campo existente.
-     *   - `null` → limpia la regla (banner se vuelve público).
-     *   - objeto → reemplaza la regla; debe pasar VisibilityRulesValidator.
-     */
-    @ValidateIf((_, value) => value !== null && value !== undefined)
-    @IsObject()
-    rulesVisibility?: Record<string, unknown> | null;
-}
+import {
+    ArrayNotEmpty,
+    IsArray,
+    IsEnum,
+    IsInt,
+    IsObject,
+    IsOptional,
+    IsString,
+    Min,
+    ValidateIf,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { BannerStatusEnum } from "../enums/BannerStatusEnum";
+import { BannerScreenEnum } from "../enums/BannerScreenEnum";
+import { BannerContentRequest } from "./BannerContentRequest";
+import { BannerActionRequest } from "./BannerActionRequest";
+
+/**
+ * Patch parcial. Todos los campos son opcionales — el manager mergea con
+ * el documento existente y revalida (regla bilingüe + screens no vacío
+ * + action por type) sobre el resultado merged.
+ */
+export class BannerUpdateRequest {
+    @IsOptional() @IsString() name?: string;
+    @IsOptional() @IsEnum(BannerStatusEnum) status?: BannerStatusEnum;
+    @IsOptional() @IsInt() @Min(0) sortOrder?: number;
+
+    @IsOptional()
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(BannerScreenEnum, { each: true })
+    screens?: BannerScreenEnum[];
+
+    @IsOptional() @IsInt() startDate?: number;
+    @IsOptional() @IsInt() endDate?: number;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerContentRequest)
+    content?: BannerContentRequest;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerActionRequest)
+    action?: BannerActionRequest;
+
+    /**
+     * Reglas de visibilidad — patch parcial:
+     *   - `undefined` → no toca el campo existente.
+     *   - `null` → limpia la regla (banner 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/BannerUploadUrlRequest.ts

@@ -1,23 +1,23 @@
-import { IsEnum, IsNotEmpty, IsString } from "class-validator";
-import { BannerAssetKindEnum } from "../enums/BannerAssetKindEnum";
-
-/**
- * Solicitud del backoffice para subir directamente un asset de banner
- * (imagen, video o poster). El backend responde con una presigned URL
- * de S3 a la que el cliente sube el binario por PUT, y devuelve también
- * la URL pública final (CloudFront) que se guarda en el banner.
- */
-export class BannerUploadUrlRequest {
-    @IsEnum(BannerAssetKindEnum)
-    kind!: BannerAssetKindEnum;
-
-    /** MIME type del archivo. Debe estar en el whitelist correspondiente al `kind`. */
-    @IsString()
-    @IsNotEmpty()
-    contentType!: string;
-
-    /** Extensión sin punto (ej. "png", "mp4"). Se usa para componer la key en S3. */
-    @IsString()
-    @IsNotEmpty()
-    fileExtension!: string;
-}
+import { IsEnum, IsNotEmpty, IsString } from "class-validator";
+import { BannerAssetKindEnum } from "../enums/BannerAssetKindEnum";
+
+/**
+ * Solicitud del backoffice para subir directamente un asset de banner
+ * (imagen, video o poster). El backend responde con una presigned URL
+ * de S3 a la que el cliente sube el binario por PUT, y devuelve también
+ * la URL pública final (CloudFront) que se guarda en el banner.
+ */
+export class BannerUploadUrlRequest {
+    @IsEnum(BannerAssetKindEnum)
+    kind!: BannerAssetKindEnum;
+
+    /** MIME type del archivo. Debe estar en el whitelist correspondiente al `kind`. */
+    @IsString()
+    @IsNotEmpty()
+    contentType!: string;
+
+    /** Extensión sin punto (ej. "png", "mp4"). Se usa para componer la key en S3. */
+    @IsString()
+    @IsNotEmpty()
+    fileExtension!: string;
+}

package/src/benefitCenter/dtos/BannerUploadUrlResponse.ts

@@ -1,15 +1,15 @@
-/**
- * Respuesta con la presigned URL para subir el asset directamente a S3.
- * El backoffice debe hacer `PUT uploadUrl` con header `Content-Type` exacto
- * al que se solicitó, y body binario del archivo (≤ maxSizeBytes).
- *
- * `publicUrl` es la URL final servida vía CloudFront — esa es la que se
- * guarda en `imageUrl` / `videoUrl` / `posterUrl` del banner.
- */
-export class BannerUploadUrlResponse {
-    uploadUrl: string;
-    publicUrl: string;
-    key: string;
-    expiresAt: string;
-    maxSizeBytes: number;
-}
+/**
+ * Respuesta con la presigned URL para subir el asset directamente a S3.
+ * El backoffice debe hacer `PUT uploadUrl` con header `Content-Type` exacto
+ * al que se solicitó, y body binario del archivo (≤ maxSizeBytes).
+ *
+ * `publicUrl` es la URL final servida vía CloudFront — esa es la que se
+ * guarda en `imageUrl` / `videoUrl` / `posterUrl` del banner.
+ */
+export class BannerUploadUrlResponse {
+    uploadUrl: string;
+    publicUrl: string;
+    key: string;
+    expiresAt: string;
+    maxSizeBytes: number;
+}

package/src/benefitCenter/dtos/BenefitCatalogResponse.ts

@@ -1,7 +1,7 @@
-import { BenefitSummary } from "./BenefitSummary";
-import { CatalogNode } from "./CatalogNode";
-
-export class BenefitCatalogResponse {
-    benefit: BenefitSummary;
-    catalog: CatalogNode;
-}
+import { BenefitSummary } from "./BenefitSummary";
+import { CatalogNode } from "./CatalogNode";
+
+export class BenefitCatalogResponse {
+    benefit: BenefitSummary;
+    catalog: CatalogNode;
+}

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