@fiado/type-kit 3.8.0 → 3.9.0

package/bin/benefitCenter/enums/BenefitPaymentErrorCodeEnum.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BenefitPaymentErrorCodeEnum = void 0;
+/**
+ * Códigos canónicos de error del pago. Cada conector mapea sus errores internos
+ * a esta lista antes de devolverle al marketplace. Solo se popula cuando
+ * `status === REJECTED` (o `PENDING` si el conector quiere comunicar la causa
+ * de la espera).
+ *
+ * Lista canónica documentada en doc Fase 2 §6.5.
+ */
+var BenefitPaymentErrorCodeEnum;
+(function (BenefitPaymentErrorCodeEnum) {
+    BenefitPaymentErrorCodeEnum["LEAF_NOT_FOUND"] = "LEAF_NOT_FOUND";
+    BenefitPaymentErrorCodeEnum["LEAF_DISABLED"] = "LEAF_DISABLED";
+    BenefitPaymentErrorCodeEnum["LEAF_NOT_VISIBLE"] = "LEAF_NOT_VISIBLE";
+    BenefitPaymentErrorCodeEnum["PRODUCT_NOT_FOUND"] = "PRODUCT_NOT_FOUND";
+    BenefitPaymentErrorCodeEnum["PROVIDER_REJECTED"] = "PROVIDER_REJECTED";
+    BenefitPaymentErrorCodeEnum["PROVIDER_TIMEOUT"] = "PROVIDER_TIMEOUT";
+    BenefitPaymentErrorCodeEnum["INSUFFICIENT_FUNDS"] = "INSUFFICIENT_FUNDS";
+})(BenefitPaymentErrorCodeEnum || (exports.BenefitPaymentErrorCodeEnum = BenefitPaymentErrorCodeEnum = {}));

package/bin/benefitCenter/enums/BenefitPaymentStatusEnum.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Estado del pago devuelto por el marketplace al procesador.
+ *
+ * Lo decide el conector (STP, Multicomm, donaciones, etc.) en su `/pay/standard`;
+ * el marketplace lo reenvía sin transformar. APPROVED dispara el upsert in-process
+ * del favorito (ver doc Fase 2 §4.3); REJECTED y PENDING no.
+ */
+export declare enum BenefitPaymentStatusEnum {
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED",
+    PENDING = "PENDING"
+}

package/bin/benefitCenter/enums/BenefitPaymentStatusEnum.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BenefitPaymentStatusEnum = void 0;
+/**
+ * Estado del pago devuelto por el marketplace al procesador.
+ *
+ * Lo decide el conector (STP, Multicomm, donaciones, etc.) en su `/pay/standard`;
+ * el marketplace lo reenvía sin transformar. APPROVED dispara el upsert in-process
+ * del favorito (ver doc Fase 2 §4.3); REJECTED y PENDING no.
+ */
+var BenefitPaymentStatusEnum;
+(function (BenefitPaymentStatusEnum) {
+    BenefitPaymentStatusEnum["APPROVED"] = "APPROVED";
+    BenefitPaymentStatusEnum["REJECTED"] = "REJECTED";
+    BenefitPaymentStatusEnum["PENDING"] = "PENDING";
+})(BenefitPaymentStatusEnum || (exports.BenefitPaymentStatusEnum = BenefitPaymentStatusEnum = {}));

package/bin/benefitCenter/enums/FavoriteDisabledReasonEnum.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Razón por la que un favorito quedó deshabilitado (`disabled === true`).
+ *
+ * - `USER` solo aparece como motivo de deshabilitación (soft delete del usuario);
+ *   nunca aparece como `reason` en el response del endpoint de validación.
+ * - Las otras 4 razones describen por qué el favorito no es usable contra el
+ *   catálogo actual y SÍ pueden aparecer en el `ValidationResult.reason`.
+ */
+export declare enum FavoriteDisabledReasonEnum {
+    USER = "USER",
+    LEAF_NOT_FOUND = "LEAF_NOT_FOUND",
+    LEAF_DISABLED = "LEAF_DISABLED",
+    LEAF_NOT_VISIBLE = "LEAF_NOT_VISIBLE",
+    PRODUCT_NOT_FOUND = "PRODUCT_NOT_FOUND"
+}

package/bin/benefitCenter/enums/FavoriteDisabledReasonEnum.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FavoriteDisabledReasonEnum = void 0;
+/**
+ * Razón por la que un favorito quedó deshabilitado (`disabled === true`).
+ *
+ * - `USER` solo aparece como motivo de deshabilitación (soft delete del usuario);
+ *   nunca aparece como `reason` en el response del endpoint de validación.
+ * - Las otras 4 razones describen por qué el favorito no es usable contra el
+ *   catálogo actual y SÍ pueden aparecer en el `ValidationResult.reason`.
+ */
+var FavoriteDisabledReasonEnum;
+(function (FavoriteDisabledReasonEnum) {
+    FavoriteDisabledReasonEnum["USER"] = "USER";
+    FavoriteDisabledReasonEnum["LEAF_NOT_FOUND"] = "LEAF_NOT_FOUND";
+    FavoriteDisabledReasonEnum["LEAF_DISABLED"] = "LEAF_DISABLED";
+    FavoriteDisabledReasonEnum["LEAF_NOT_VISIBLE"] = "LEAF_NOT_VISIBLE";
+    FavoriteDisabledReasonEnum["PRODUCT_NOT_FOUND"] = "PRODUCT_NOT_FOUND";
+})(FavoriteDisabledReasonEnum || (exports.FavoriteDisabledReasonEnum = FavoriteDisabledReasonEnum = {}));

package/bin/benefitCenter/index.d.ts

@@ -7,6 +7,9 @@ export * from "./enums/BannerStatusEnum";
 export * from "./enums/BannerLocaleEnum";
 export * from "./enums/BannerScreenEnum";
 export * from "./enums/BannerTemplateVariantEnum";
+export * from "./enums/FavoriteDisabledReasonEnum";
+export * from "./enums/BenefitPaymentStatusEnum";
+export * from "./enums/BenefitPaymentErrorCodeEnum";
 export * from "./dtos/BenefitItem";
 export * from "./dtos/BenefitListResponse";
 export * from "./dtos/BenefitSummary";
@@ -39,3 +42,13 @@ export * from "./dtos/BannerUpdateRequest";
 export * from "./dtos/BannerTemplateThemeRequest";
 export * from "./dtos/BannerTemplateRequest";
 export * from "./dtos/PublicVerifyReferenceRequest";
+export * from "./dtos/FavoriteItem";
+export * from "./dtos/FavoriteListResponse";
+export * from "./dtos/FavoriteValidationResult";
+export * from "./dtos/FavoriteDetailResponse";
+export * from "./dtos/FavoriteUpdateRequest";
+export * from "./dtos/FavoriteReorderRequest";
+export * from "./dtos/BenefitPaymentRequest";
+export * from "./dtos/BenefitPaymentResponse";
+export * from "./dtos/AuthorizeBenefitsMarketplaceTransactionRequest";
+export * from "./dtos/FavoriteUpsertContext";

package/bin/benefitCenter/index.js

@@ -24,6 +24,9 @@ __exportStar(require("./enums/BannerStatusEnum"), exports);
 __exportStar(require("./enums/BannerLocaleEnum"), exports);
 __exportStar(require("./enums/BannerScreenEnum"), exports);
 __exportStar(require("./enums/BannerTemplateVariantEnum"), exports);
+__exportStar(require("./enums/FavoriteDisabledReasonEnum"), exports);
+__exportStar(require("./enums/BenefitPaymentStatusEnum"), exports);
+__exportStar(require("./enums/BenefitPaymentErrorCodeEnum"), exports);
 //DTOs
 __exportStar(require("./dtos/BenefitItem"), exports);
 __exportStar(require("./dtos/BenefitListResponse"), exports);
@@ -58,3 +61,15 @@ __exportStar(require("./dtos/BannerUpdateRequest"), exports);
 __exportStar(require("./dtos/BannerTemplateThemeRequest"), exports);
 __exportStar(require("./dtos/BannerTemplateRequest"), exports);
 __exportStar(require("./dtos/PublicVerifyReferenceRequest"), exports);
+//Favorites (v3.8.1)
+__exportStar(require("./dtos/FavoriteItem"), exports);
+__exportStar(require("./dtos/FavoriteListResponse"), exports);
+__exportStar(require("./dtos/FavoriteValidationResult"), exports);
+__exportStar(require("./dtos/FavoriteDetailResponse"), exports);
+__exportStar(require("./dtos/FavoriteUpdateRequest"), exports);
+__exportStar(require("./dtos/FavoriteReorderRequest"), exports);
+//Phase 2 — Payments + favorite upsert context (v3.9.0)
+__exportStar(require("./dtos/BenefitPaymentRequest"), exports);
+__exportStar(require("./dtos/BenefitPaymentResponse"), exports);
+__exportStar(require("./dtos/AuthorizeBenefitsMarketplaceTransactionRequest"), exports);
+__exportStar(require("./dtos/FavoriteUpsertContext"), exports);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@fiado/type-kit",
-	"version": "3.8.0",
+	"version": "3.9.0",
 	"description": "",
 	"main": "bin/index.js",
 	"types": "bin/index.d.ts",

package/src/benefitCenter/dtos/AuthorizeBenefitsMarketplaceTransactionRequest.ts

@@ -0,0 +1,92 @@
+import {
+    IsLatitude,
+    IsLongitude,
+    IsNotEmpty,
+    IsNumber,
+    IsObject,
+    IsOptional,
+    IsPositive,
+    IsString,
+    Length,
+    MaxLength,
+} from "class-validator";
+
+/**
+ * Request del endpoint nuevo `POST /authorizeBenefitsMarketplaceTransaction`
+ * en `transaction-processor-business` (PublicController). Lo invoca la app
+ * para todos los flujos del Centro de Beneficios.
+ *
+ * NO se reusa `AuthorizePaymentTransactionRequest` ni similares: este DTO
+ * es dedicado, sin sub-objetos opcionales, con los campos del Centro como
+ * ciudadanos de primera clase.
+ *
+ * Los endpoints `authorize*Transaction` actuales del procesador no se tocan
+ * y siguen recibiendo su tráfico legacy. Ver doc Fase 2 §5.1.
+ */
+export class AuthorizeBenefitsMarketplaceTransactionRequest {
+    /**
+     * Reusa entradas existentes en `ProductCatalog_GT` del procesador
+     * (`MEX_TOPUP`, `MEX_SERVICE_PAYMENT`, …). No se agregan entradas nuevas
+     * en Fase 2 (ver doc §10).
+     */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    productCatalogId!: string;
+
+    /** Idempotency key — viaja end-to-end (procesador → marketplace → conector). */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    transactionNumber!: string;
+
+    @IsNumber()
+    @IsPositive()
+    amount!: number;
+
+    /** ISO numeric (3 chars). Ej: "484" (MXN), "840" (USD). */
+    @IsString()
+    @Length(3, 3)
+    currencyId!: string;
+
+    // Campos del Centro de Beneficios — first-class, no opcionales
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    benefitId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(256)
+    leafId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(64)
+    productId!: string;
+
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    reference!: string;
+
+    /** Decide a qué conector apuntar dentro del marketplace. */
+    @IsString()
+    @IsNotEmpty()
+    @MaxLength(128)
+    moduleName!: string;
+
+    /** Inputs dinámicos del leaf — 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/BenefitPaymentRequest.ts

@@ -0,0 +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;
+}

package/src/benefitCenter/dtos/BenefitPaymentResponse.ts

@@ -0,0 +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;
+}

package/src/benefitCenter/dtos/FavoriteDetailResponse.ts

@@ -0,0 +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;
+}

package/src/benefitCenter/dtos/FavoriteItem.ts

@@ -0,0 +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;
+}

package/src/benefitCenter/dtos/FavoriteListResponse.ts

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

package/src/benefitCenter/dtos/FavoriteReorderRequest.ts

@@ -0,0 +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[];
+}

package/src/benefitCenter/dtos/FavoriteUpdateRequest.ts

@@ -0,0 +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;
+}

package/src/benefitCenter/dtos/FavoriteUpsertContext.ts

@@ -0,0 +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;
+}

package/src/benefitCenter/dtos/FavoriteValidationResult.ts

@@ -0,0 +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;
+}

package/src/benefitCenter/enums/BenefitPaymentErrorCodeEnum.ts

@@ -0,0 +1,17 @@
+/**
+ * Códigos canónicos de error del pago. Cada conector mapea sus errores internos
+ * a esta lista antes de devolverle al marketplace. Solo se popula cuando
+ * `status === REJECTED` (o `PENDING` si el conector quiere comunicar la causa
+ * de la espera).
+ *
+ * Lista canónica documentada en doc Fase 2 §6.5.
+ */
+export enum BenefitPaymentErrorCodeEnum {
+    LEAF_NOT_FOUND = "LEAF_NOT_FOUND",
+    LEAF_DISABLED = "LEAF_DISABLED",
+    LEAF_NOT_VISIBLE = "LEAF_NOT_VISIBLE",
+    PRODUCT_NOT_FOUND = "PRODUCT_NOT_FOUND",
+    PROVIDER_REJECTED = "PROVIDER_REJECTED",
+    PROVIDER_TIMEOUT = "PROVIDER_TIMEOUT",
+    INSUFFICIENT_FUNDS = "INSUFFICIENT_FUNDS",
+}

package/src/benefitCenter/enums/BenefitPaymentStatusEnum.ts

@@ -0,0 +1,12 @@
+/**
+ * Estado del pago devuelto por el marketplace al procesador.
+ *
+ * Lo decide el conector (STP, Multicomm, donaciones, etc.) en su `/pay/standard`;
+ * el marketplace lo reenvía sin transformar. APPROVED dispara el upsert in-process
+ * del favorito (ver doc Fase 2 §4.3); REJECTED y PENDING no.
+ */
+export enum BenefitPaymentStatusEnum {
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED",
+    PENDING = "PENDING",
+}

package/src/benefitCenter/enums/FavoriteDisabledReasonEnum.ts

@@ -0,0 +1,15 @@
+/**
+ * Razón por la que un favorito quedó deshabilitado (`disabled === true`).
+ *
+ * - `USER` solo aparece como motivo de deshabilitación (soft delete del usuario);
+ *   nunca aparece como `reason` en el response del endpoint de validación.
+ * - Las otras 4 razones describen por qué el favorito no es usable contra el
+ *   catálogo actual y SÍ pueden aparecer en el `ValidationResult.reason`.
+ */
+export enum FavoriteDisabledReasonEnum {
+    USER = "USER",
+    LEAF_NOT_FOUND = "LEAF_NOT_FOUND",
+    LEAF_DISABLED = "LEAF_DISABLED",
+    LEAF_NOT_VISIBLE = "LEAF_NOT_VISIBLE",
+    PRODUCT_NOT_FOUND = "PRODUCT_NOT_FOUND",
+}

package/src/benefitCenter/index.ts

@@ -8,6 +8,9 @@ export * from "./enums/BannerStatusEnum";
 export * from "./enums/BannerLocaleEnum";
 export * from "./enums/BannerScreenEnum";
 export * from "./enums/BannerTemplateVariantEnum";
+export * from "./enums/FavoriteDisabledReasonEnum";
+export * from "./enums/BenefitPaymentStatusEnum";
+export * from "./enums/BenefitPaymentErrorCodeEnum";
 
 //DTOs
 export * from "./dtos/BenefitItem";
@@ -43,3 +46,15 @@ export * from "./dtos/BannerUpdateRequest";
 export * from "./dtos/BannerTemplateThemeRequest";
 export * from "./dtos/BannerTemplateRequest";
 export * from "./dtos/PublicVerifyReferenceRequest";
+//Favorites (v3.8.1)
+export * from "./dtos/FavoriteItem";
+export * from "./dtos/FavoriteListResponse";
+export * from "./dtos/FavoriteValidationResult";
+export * from "./dtos/FavoriteDetailResponse";
+export * from "./dtos/FavoriteUpdateRequest";
+export * from "./dtos/FavoriteReorderRequest";
+//Phase 2 — Payments + favorite upsert context (v3.9.0)
+export * from "./dtos/BenefitPaymentRequest";
+export * from "./dtos/BenefitPaymentResponse";
+export * from "./dtos/AuthorizeBenefitsMarketplaceTransactionRequest";
+export * from "./dtos/FavoriteUpsertContext";