@fiado/type-kit 3.8.0 → 3.9.0

package/bin/benefitCenter/dtos/AuthorizeBenefitsMarketplaceTransactionRequest.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 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 declare 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).
+     */
+    productCatalogId: string;
+    /** Idempotency key — viaja end-to-end (procesador → marketplace → conector). */
+    transactionNumber: string;
+    amount: number;
+    /** ISO numeric (3 chars). Ej: "484" (MXN), "840" (USD). */
+    currencyId: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    reference: string;
+    /** Decide a qué conector apuntar dentro del marketplace. */
+    moduleName: string;
+    /** Inputs dinámicos del leaf — opcionales según el servicio. */
+    inputs?: Record<string, string | number | boolean>;
+    latitude?: number;
+    longitude?: number;
+}

package/bin/benefitCenter/dtos/AuthorizeBenefitsMarketplaceTransactionRequest.js

@@ -0,0 +1,95 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthorizeBenefitsMarketplaceTransactionRequest = void 0;
+const class_validator_1 = require("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.
+ */
+class AuthorizeBenefitsMarketplaceTransactionRequest {
+}
+exports.AuthorizeBenefitsMarketplaceTransactionRequest = AuthorizeBenefitsMarketplaceTransactionRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "productCatalogId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "transactionNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(3, 3),
+    __metadata("design:type", String)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "currencyId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "benefitId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(256),
+    __metadata("design:type", String)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "leafId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "productId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "reference", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "moduleName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "inputs", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsLatitude)(),
+    __metadata("design:type", Number)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "latitude", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsLongitude)(),
+    __metadata("design:type", Number)
+], AuthorizeBenefitsMarketplaceTransactionRequest.prototype, "longitude", void 0);

package/bin/benefitCenter/dtos/BenefitPaymentRequest.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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 declare class BenefitPaymentRequest {
+    directoryId: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    reference: string;
+    amount: number;
+    /**
+     * Idempotency key del pago (la genera el procesador y la usa el conector
+     * para no re-cobrar si el request se repite).
+     */
+    transactionNumber: string;
+    /**
+     * Inputs dinámicos del leaf (definidos por su `inputSchema`). Opcionales
+     * según el servicio.
+     */
+    inputs?: Record<string, string | number | boolean>;
+    latitude?: number;
+    longitude?: number;
+}

package/bin/benefitCenter/dtos/BenefitPaymentRequest.js

@@ -0,0 +1,83 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BenefitPaymentRequest = void 0;
+const class_validator_1 = require("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.
+ */
+class BenefitPaymentRequest {
+}
+exports.BenefitPaymentRequest = BenefitPaymentRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], BenefitPaymentRequest.prototype, "directoryId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], BenefitPaymentRequest.prototype, "benefitId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(256),
+    __metadata("design:type", String)
+], BenefitPaymentRequest.prototype, "leafId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], BenefitPaymentRequest.prototype, "productId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(128),
+    __metadata("design:type", String)
+], BenefitPaymentRequest.prototype, "reference", void 0);
+__decorate([
+    (0, class_validator_1.IsNumber)(),
+    (0, class_validator_1.IsPositive)(),
+    __metadata("design:type", Number)
+], BenefitPaymentRequest.prototype, "amount", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.MaxLength)(64),
+    __metadata("design:type", String)
+], BenefitPaymentRequest.prototype, "transactionNumber", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], BenefitPaymentRequest.prototype, "inputs", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsLatitude)(),
+    __metadata("design:type", Number)
+], BenefitPaymentRequest.prototype, "latitude", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsLongitude)(),
+    __metadata("design:type", Number)
+], BenefitPaymentRequest.prototype, "longitude", void 0);

package/bin/benefitCenter/dtos/BenefitPaymentResponse.d.ts

@@ -0,0 +1,23 @@
+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 declare 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/bin/benefitCenter/dtos/BenefitPaymentResponse.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BenefitPaymentResponse = void 0;
+/**
+ * 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.
+ */
+class BenefitPaymentResponse {
+}
+exports.BenefitPaymentResponse = BenefitPaymentResponse;

package/bin/benefitCenter/dtos/FavoriteDetailResponse.d.ts

@@ -0,0 +1,40 @@
+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 declare class FavoriteSelection {
+    leafId: string;
+    productId: string;
+    amount: number | null;
+    reference: string;
+}
+/**
+ * Metadata del favorito en sí (para menús contextuales, ordenamiento, etc.).
+ */
+export declare 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 declare class FavoriteDetailResponse {
+    benefit: BenefitSummary;
+    catalog: CatalogNode;
+    selection: FavoriteSelection;
+    favorite: FavoriteDetailMeta;
+}

package/bin/benefitCenter/dtos/FavoriteDetailResponse.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FavoriteDetailResponse = exports.FavoriteDetailMeta = exports.FavoriteSelection = void 0;
+/**
+ * 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).
+ */
+class FavoriteSelection {
+}
+exports.FavoriteSelection = FavoriteSelection;
+/**
+ * Metadata del favorito en sí (para menús contextuales, ordenamiento, etc.).
+ */
+class FavoriteDetailMeta {
+}
+exports.FavoriteDetailMeta = FavoriteDetailMeta;
+/**
+ * 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.
+ */
+class FavoriteDetailResponse {
+}
+exports.FavoriteDetailResponse = FavoriteDetailResponse;

package/bin/benefitCenter/dtos/FavoriteItem.d.ts

@@ -0,0 +1,21 @@
+import { FavoriteDisabledReasonEnum } from "../enums/FavoriteDisabledReasonEnum";
+/**
+ * Ítem que viaja en `GET /favorites`. Representa un favorito ACTIVO
+ * (la lista filtra `disabled=true` por default).
+ */
+export declare class FavoriteItem {
+    id: string;
+    benefitId: string;
+    leafId: string;
+    productId: string;
+    referenceMasked: string;
+    alias: string | null;
+    photo: string | null;
+    position: number;
+    disabled: boolean;
+    disabledReason: FavoriteDisabledReasonEnum | null;
+    lastProductId: string | null;
+    lastAmount: number | null;
+    usageCount: number;
+    lastUsedAt: number;
+}

package/bin/benefitCenter/dtos/FavoriteItem.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FavoriteItem = void 0;
+/**
+ * Ítem que viaja en `GET /favorites`. Representa un favorito ACTIVO
+ * (la lista filtra `disabled=true` por default).
+ */
+class FavoriteItem {
+}
+exports.FavoriteItem = FavoriteItem;

package/bin/benefitCenter/dtos/FavoriteListResponse.d.ts

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

package/bin/benefitCenter/dtos/FavoriteListResponse.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FavoriteListResponse = void 0;
+class FavoriteListResponse {
+}
+exports.FavoriteListResponse = FavoriteListResponse;

package/bin/benefitCenter/dtos/FavoriteReorderRequest.d.ts

@@ -0,0 +1,13 @@
+export declare class FavoriteReorderItem {
+    id: string;
+    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 declare class FavoriteReorderRequest {
+    items: FavoriteReorderItem[];
+}

package/bin/benefitCenter/dtos/FavoriteReorderRequest.js

@@ -0,0 +1,42 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FavoriteReorderRequest = exports.FavoriteReorderItem = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+class FavoriteReorderItem {
+}
+exports.FavoriteReorderItem = FavoriteReorderItem;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], FavoriteReorderItem.prototype, "id", void 0);
+__decorate([
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], FavoriteReorderItem.prototype, "position", void 0);
+/**
+ * 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.
+ */
+class FavoriteReorderRequest {
+}
+exports.FavoriteReorderRequest = FavoriteReorderRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => FavoriteReorderItem),
+    __metadata("design:type", Array)
+], FavoriteReorderRequest.prototype, "items", void 0);

package/bin/benefitCenter/dtos/FavoriteUpdateRequest.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 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 declare class FavoriteUpdateRequest {
+    alias?: string | null;
+    photo?: string | null;
+}

package/bin/benefitCenter/dtos/FavoriteUpdateRequest.js

@@ -0,0 +1,42 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FavoriteUpdateRequest = void 0;
+const class_validator_1 = require("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).
+ */
+class FavoriteUpdateRequest {
+}
+exports.FavoriteUpdateRequest = FavoriteUpdateRequest;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateIf)((_, value) => value !== null),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 60),
+    (0, class_validator_1.Matches)(/^[^\u0000-\u001f<>]+$/, { message: "alias contiene caracteres no permitidos" }),
+    __metadata("design:type", String)
+], FavoriteUpdateRequest.prototype, "alias", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateIf)((_, value) => value !== null),
+    (0, class_validator_1.IsUrl)({ protocols: ["https"], require_protocol: true }),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], FavoriteUpdateRequest.prototype, "photo", void 0);

package/bin/benefitCenter/dtos/FavoriteUpsertContext.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 declare 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/bin/benefitCenter/dtos/FavoriteUpsertContext.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FavoriteUpsertContext = void 0;
+/**
+ * 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.
+ */
+class FavoriteUpsertContext {
+}
+exports.FavoriteUpsertContext = FavoriteUpsertContext;

package/bin/benefitCenter/dtos/FavoriteValidationResult.d.ts

@@ -0,0 +1,34 @@
+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 declare 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 declare 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 declare class FavoriteValidationResult {
+    id: string;
+    valid: boolean;
+    reason?: FavoriteDisabledReasonEnum;
+    leaf?: FavoriteValidationLeaf;
+    product?: FavoriteValidationProduct;
+}

package/bin/benefitCenter/dtos/FavoriteValidationResult.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FavoriteValidationResult = exports.FavoriteValidationProduct = exports.FavoriteValidationLeaf = void 0;
+/**
+ * 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.
+ */
+class FavoriteValidationLeaf {
+}
+exports.FavoriteValidationLeaf = FavoriteValidationLeaf;
+/**
+ * Información del producto. `price` es `null` cuando `amountType === VARIABLE`
+ * (productos de monto abierto donde el usuario decide cuánto pagar).
+ */
+class FavoriteValidationProduct {
+}
+exports.FavoriteValidationProduct = FavoriteValidationProduct;
+/**
+ * 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).
+ */
+class FavoriteValidationResult {
+}
+exports.FavoriteValidationResult = FavoriteValidationResult;

package/bin/benefitCenter/enums/BenefitPaymentErrorCodeEnum.d.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 declare 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"
+}