@fiado/type-kit 3.13.9 → 3.15.0

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

@@ -0,0 +1,32 @@
+import { ConnectorCatalogItem } from "./ConnectorCatalogItem";
+import { LeafOverrideStatusEnum } from "../enums/LeafOverrideStatusEnum";
+/**
+ * Override que vive en BenefitLeafOverride_GT (forma plana del item de DynamoDB).
+ * Los slots están definidos del lado lambda en BenefitLeafOverrideDocument;
+ * acá lo tipamos como Record opaco para no duplicar la definición.
+ *
+ * Los consumers del type-kit no necesitan el detalle interno — usan `effective`
+ * para ver el resultado final y `override` solo para saber qué campos están
+ * seteados.
+ */
+export type BenefitLeafOverridePayload = Record<string, unknown>;
+/**
+ * Response del detalle del backoffice. Trae 3 visiones del leaf:
+ *   - base: lo que devuelve el conector (sin merge).
+ *   - override: lo que hay en BenefitLeafOverride_GT (null si nunca se editó).
+ *   - effective: el merge (lo que ve la app).
+ * Si status === ORPHANED, base y effective son null.
+ */
+export declare class BackofficeLeafDetailResponse {
+    leafId: string;
+    benefitId: string;
+    moduleName: string;
+    serviceId: string;
+    base: ConnectorCatalogItem | null;
+    override: BenefitLeafOverridePayload | null;
+    effective: ConnectorCatalogItem | null;
+    status: LeafOverrideStatusEnum;
+    updatedBy: string | null;
+    createdAt: number | null;
+    updatedAt: number | null;
+}

package/bin/benefitCenter/dtos/BackofficeLeafDetailResponse.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackofficeLeafDetailResponse = void 0;
+/**
+ * Response del detalle del backoffice. Trae 3 visiones del leaf:
+ *   - base: lo que devuelve el conector (sin merge).
+ *   - override: lo que hay en BenefitLeafOverride_GT (null si nunca se editó).
+ *   - effective: el merge (lo que ve la app).
+ * Si status === ORPHANED, base y effective son null.
+ */
+class BackofficeLeafDetailResponse {
+}
+exports.BackofficeLeafDetailResponse = BackofficeLeafDetailResponse;

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

@@ -0,0 +1,21 @@
+import { LeafOverrideStatusEnum } from "../enums/LeafOverrideStatusEnum";
+/**
+ * Item del listado del backoffice de leaves. Combina el estado efectivo
+ * (post-merge) que verá la app con metadata del override (si existe).
+ */
+export declare class BackofficeLeafListItem {
+    leafId: string;
+    benefitId: string;
+    moduleName: string;
+    serviceId: string;
+    serviceName: string;
+    category: string;
+    subcategory: string;
+    enabled: boolean;
+    logo?: string;
+    hasOverride: boolean;
+    overriddenFields: string[];
+    status: LeafOverrideStatusEnum;
+    updatedBy?: string;
+    updatedAt?: number;
+}

package/bin/benefitCenter/dtos/BackofficeLeafListItem.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BackofficeLeafListItem = void 0;
+/**
+ * Item del listado del backoffice de leaves. Combina el estado efectivo
+ * (post-merge) que verá la app con metadata del override (si existe).
+ */
+class BackofficeLeafListItem {
+}
+exports.BackofficeLeafListItem = BackofficeLeafListItem;

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

@@ -0,0 +1,6 @@
+import { BackofficeLeafListItem } from "./BackofficeLeafListItem";
+export declare class BackofficeLeafListResponse {
+    items: BackofficeLeafListItem[];
+    /** Cursor opaco para la próxima página. Ausente → no hay más páginas. */
+    index?: string;
+}

package/bin/benefitCenter/dtos/BackofficeLeafListResponse.js

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

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

@@ -0,0 +1,22 @@
+import { InputSchemaOverrideRequest } from "./InputSchemaOverrideRequest";
+/**
+ * Body de PUT /backoffice/leaves/{leafId}. Upsert parcial:
+ *   - undefined → no se toca
+ *   - string/number/boolean seteado → pisa el valor previo del override
+ *   - null NO se acepta (para borrar un campo, usar DELETE /fields/{fieldName})
+ *
+ * Si todos los campos llegan undefined → 400 INVALID_PATCH_PAYLOAD.
+ */
+export declare class BackofficeLeafOverrideUpsertRequest {
+    serviceName?: string;
+    logo?: string;
+    description?: string;
+    helpText?: string;
+    serviceOrder?: number;
+    subcategoryOrder?: number;
+    enabled?: boolean;
+    category?: string;
+    subcategory?: string;
+    requiresReferenceVerification?: boolean;
+    inputSchema?: InputSchemaOverrideRequest;
+}

package/bin/benefitCenter/dtos/BackofficeLeafOverrideUpsertRequest.js

@@ -0,0 +1,91 @@
+"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.BackofficeLeafOverrideUpsertRequest = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const InputSchemaOverrideRequest_1 = require("./InputSchemaOverrideRequest");
+/**
+ * Body de PUT /backoffice/leaves/{leafId}. Upsert parcial:
+ *   - undefined → no se toca
+ *   - string/number/boolean seteado → pisa el valor previo del override
+ *   - null NO se acepta (para borrar un campo, usar DELETE /fields/{fieldName})
+ *
+ * Si todos los campos llegan undefined → 400 INVALID_PATCH_PAYLOAD.
+ */
+class BackofficeLeafOverrideUpsertRequest {
+}
+exports.BackofficeLeafOverrideUpsertRequest = BackofficeLeafOverrideUpsertRequest;
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], BackofficeLeafOverrideUpsertRequest.prototype, "serviceName", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUrl)({ protocols: ["https"], require_protocol: true }),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], BackofficeLeafOverrideUpsertRequest.prototype, "logo", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2000),
+    __metadata("design:type", String)
+], BackofficeLeafOverrideUpsertRequest.prototype, "description", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(1000),
+    __metadata("design:type", String)
+], BackofficeLeafOverrideUpsertRequest.prototype, "helpText", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], BackofficeLeafOverrideUpsertRequest.prototype, "serviceOrder", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(0),
+    __metadata("design:type", Number)
+], BackofficeLeafOverrideUpsertRequest.prototype, "subcategoryOrder", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], BackofficeLeafOverrideUpsertRequest.prototype, "enabled", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(60),
+    (0, class_validator_1.Matches)(/^[A-Z][A-Z0-9_ ]*$/, { message: "category must be uppercase with underscores or spaces" }),
+    __metadata("design:type", String)
+], BackofficeLeafOverrideUpsertRequest.prototype, "category", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(60),
+    __metadata("design:type", String)
+], BackofficeLeafOverrideUpsertRequest.prototype, "subcategory", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], BackofficeLeafOverrideUpsertRequest.prototype, "requiresReferenceVerification", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => InputSchemaOverrideRequest_1.InputSchemaOverrideRequest),
+    __metadata("design:type", InputSchemaOverrideRequest_1.InputSchemaOverrideRequest)
+], BackofficeLeafOverrideUpsertRequest.prototype, "inputSchema", void 0);

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

@@ -0,0 +1,14 @@
+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 declare class BannerUploadUrlRequest {
+    kind: BannerAssetKindEnum;
+    /** MIME type del archivo. Debe estar en el whitelist correspondiente al `kind`. */
+    contentType: string;
+    /** Extensión sin punto (ej. "png", "mp4"). Se usa para componer la key en S3. */
+    fileExtension: string;
+}

package/bin/benefitCenter/dtos/BannerUploadUrlRequest.js

@@ -0,0 +1,37 @@
+"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.BannerUploadUrlRequest = void 0;
+const class_validator_1 = require("class-validator");
+const BannerAssetKindEnum_1 = require("../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.
+ */
+class BannerUploadUrlRequest {
+}
+exports.BannerUploadUrlRequest = BannerUploadUrlRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(BannerAssetKindEnum_1.BannerAssetKindEnum),
+    __metadata("design:type", String)
+], BannerUploadUrlRequest.prototype, "kind", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], BannerUploadUrlRequest.prototype, "contentType", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], BannerUploadUrlRequest.prototype, "fileExtension", void 0);

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

@@ -0,0 +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 declare class BannerUploadUrlResponse {
+    uploadUrl: string;
+    publicUrl: string;
+    key: string;
+    expiresAt: string;
+    maxSizeBytes: number;
+}

package/bin/benefitCenter/dtos/BannerUploadUrlResponse.js

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

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

@@ -24,4 +24,8 @@ export declare class ConnectorCatalogItem {
     products: ProductItem[];
     inputSchema: InputSchema;
     updatedAt: number;
+    /** Campo editorial solo-marketplace. Vive en BenefitLeafOverride_GT y el merger lo agrega al item devuelto. */
+    description?: string;
+    /** Campo editorial solo-marketplace. Texto corto inline en el form de pago. */
+    helpText?: string;
 }

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

@@ -0,0 +1,19 @@
+import { InputFieldTypeEnum } from "../enums/InputFieldTypeEnum";
+import { InputValidation } from "./InputValidation";
+import { SelectOption } from "./SelectOption";
+/**
+ * Override parcial de un field individual del `inputSchema` por `key`.
+ * El admin no puede agregar ni quitar fields — solo editar los existentes.
+ */
+export declare class FieldOverrideRequest {
+    key: string;
+    type?: InputFieldTypeEnum;
+    label?: string;
+    placeholder?: string;
+    required?: boolean;
+    helpImage?: string;
+    showHelp?: boolean;
+    options?: SelectOption[];
+    dependsOn?: string;
+    validation?: InputValidation;
+}

package/bin/benefitCenter/dtos/FieldOverrideRequest.js

@@ -0,0 +1,80 @@
+"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.FieldOverrideRequest = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const InputFieldTypeEnum_1 = require("../enums/InputFieldTypeEnum");
+const InputValidation_1 = require("./InputValidation");
+const SelectOption_1 = require("./SelectOption");
+/**
+ * Override parcial de un field individual del `inputSchema` por `key`.
+ * El admin no puede agregar ni quitar fields — solo editar los existentes.
+ */
+class FieldOverrideRequest {
+}
+exports.FieldOverrideRequest = FieldOverrideRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], FieldOverrideRequest.prototype, "key", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(InputFieldTypeEnum_1.InputFieldTypeEnum),
+    __metadata("design:type", String)
+], FieldOverrideRequest.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], FieldOverrideRequest.prototype, "label", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(120),
+    __metadata("design:type", String)
+], FieldOverrideRequest.prototype, "placeholder", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FieldOverrideRequest.prototype, "required", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUrl)({ protocols: ["https"], require_protocol: true }),
+    __metadata("design:type", String)
+], FieldOverrideRequest.prototype, "helpImage", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], FieldOverrideRequest.prototype, "showHelp", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => SelectOption_1.SelectOption),
+    __metadata("design:type", Array)
+], FieldOverrideRequest.prototype, "options", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(60),
+    __metadata("design:type", String)
+], FieldOverrideRequest.prototype, "dependsOn", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => InputValidation_1.InputValidation),
+    __metadata("design:type", InputValidation_1.InputValidation)
+], FieldOverrideRequest.prototype, "validation", void 0);

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

@@ -0,0 +1,9 @@
+import { FieldOverrideRequest } from "./FieldOverrideRequest";
+/**
+ * Override del inputSchema completo. El array `fieldOverrides[]` lista overrides
+ * parciales por `key`. La validación cruzada de que cada `key` exista en el
+ * inputSchema del conector la hace el manager (no se puede expresar con class-validator).
+ */
+export declare class InputSchemaOverrideRequest {
+    fieldOverrides: FieldOverrideRequest[];
+}

package/bin/benefitCenter/dtos/InputSchemaOverrideRequest.js

@@ -0,0 +1,29 @@
+"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.InputSchemaOverrideRequest = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const FieldOverrideRequest_1 = require("./FieldOverrideRequest");
+/**
+ * Override del inputSchema completo. El array `fieldOverrides[]` lista overrides
+ * parciales por `key`. La validación cruzada de que cada `key` exista en el
+ * inputSchema del conector la hace el manager (no se puede expresar con class-validator).
+ */
+class InputSchemaOverrideRequest {
+}
+exports.InputSchemaOverrideRequest = InputSchemaOverrideRequest;
+__decorate([
+    (0, class_validator_1.IsArray)(),
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_transformer_1.Type)(() => FieldOverrideRequest_1.FieldOverrideRequest),
+    __metadata("design:type", Array)
+], InputSchemaOverrideRequest.prototype, "fieldOverrides", void 0);

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

@@ -10,4 +10,8 @@ export declare class ServiceLeaf {
     products: ProductItem[];
     inputSchema: InputSchema;
     updatedAt: number;
+    /** Campo editorial solo-marketplace. Vive en BenefitLeafOverride_GT y el merger lo agrega al item devuelto. */
+    description?: string;
+    /** Campo editorial solo-marketplace. Texto corto inline en el form de pago. */
+    helpText?: string;
 }

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

@@ -0,0 +1,11 @@
+/**
+ * Tipo de asset que el backoffice quiere subir para un banner.
+ *
+ * Determina el whitelist de MIME types y el tamaño máximo permitido por la
+ * presigned URL que devuelve el backend.
+ */
+export declare enum BannerAssetKindEnum {
+    IMAGE = "IMAGE",
+    VIDEO = "VIDEO",
+    POSTER = "POSTER"
+}

package/bin/benefitCenter/enums/BannerAssetKindEnum.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BannerAssetKindEnum = void 0;
+/**
+ * Tipo de asset que el backoffice quiere subir para un banner.
+ *
+ * Determina el whitelist de MIME types y el tamaño máximo permitido por la
+ * presigned URL que devuelve el backend.
+ */
+var BannerAssetKindEnum;
+(function (BannerAssetKindEnum) {
+    BannerAssetKindEnum["IMAGE"] = "IMAGE";
+    BannerAssetKindEnum["VIDEO"] = "VIDEO";
+    BannerAssetKindEnum["POSTER"] = "POSTER";
+})(BannerAssetKindEnum || (exports.BannerAssetKindEnum = BannerAssetKindEnum = {}));

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

@@ -0,0 +1,10 @@
+/**
+ * Estado de un leaf en el listado del backoffice de overrides.
+ *
+ * - ACTIVE: el override (si existe) tiene un base correspondiente en el catálogo del conector.
+ * - ORPHANED: existe override pero el conector ya no devuelve este leafId — el provider lo retiró.
+ */
+export declare enum LeafOverrideStatusEnum {
+    ACTIVE = "ACTIVE",
+    ORPHANED = "ORPHANED"
+}

package/bin/benefitCenter/enums/LeafOverrideStatusEnum.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LeafOverrideStatusEnum = void 0;
+/**
+ * Estado de un leaf en el listado del backoffice de overrides.
+ *
+ * - ACTIVE: el override (si existe) tiene un base correspondiente en el catálogo del conector.
+ * - ORPHANED: existe override pero el conector ya no devuelve este leafId — el provider lo retiró.
+ */
+var LeafOverrideStatusEnum;
+(function (LeafOverrideStatusEnum) {
+    LeafOverrideStatusEnum["ACTIVE"] = "ACTIVE";
+    LeafOverrideStatusEnum["ORPHANED"] = "ORPHANED";
+})(LeafOverrideStatusEnum || (exports.LeafOverrideStatusEnum = LeafOverrideStatusEnum = {}));

package/bin/benefitCenter/index.d.ts

@@ -10,6 +10,8 @@ export * from "./enums/BannerTemplateVariantEnum";
 export * from "./enums/FavoriteDisabledReasonEnum";
 export * from "./enums/BenefitPaymentStatusEnum";
 export * from "./enums/BenefitPaymentErrorCodeEnum";
+export * from "./enums/LeafOverrideStatusEnum";
+export * from "./enums/BannerAssetKindEnum";
 export * from "./dtos/BenefitItem";
 export * from "./dtos/BenefitListResponse";
 export * from "./dtos/BenefitSummary";
@@ -52,3 +54,11 @@ export * from "./dtos/BenefitPaymentRequest";
 export * from "./dtos/BenefitPaymentResponse";
 export * from "./dtos/AuthorizeBenefitsMarketplaceTransactionRequest";
 export * from "./dtos/FavoriteUpsertContext";
+export * from "./dtos/FieldOverrideRequest";
+export * from "./dtos/InputSchemaOverrideRequest";
+export * from "./dtos/BackofficeLeafOverrideUpsertRequest";
+export * from "./dtos/BackofficeLeafListItem";
+export * from "./dtos/BackofficeLeafListResponse";
+export * from "./dtos/BackofficeLeafDetailResponse";
+export * from "./dtos/BannerUploadUrlRequest";
+export * from "./dtos/BannerUploadUrlResponse";

package/bin/benefitCenter/index.js

@@ -27,6 +27,8 @@ __exportStar(require("./enums/BannerTemplateVariantEnum"), exports);
 __exportStar(require("./enums/FavoriteDisabledReasonEnum"), exports);
 __exportStar(require("./enums/BenefitPaymentStatusEnum"), exports);
 __exportStar(require("./enums/BenefitPaymentErrorCodeEnum"), exports);
+__exportStar(require("./enums/LeafOverrideStatusEnum"), exports);
+__exportStar(require("./enums/BannerAssetKindEnum"), exports);
 //DTOs
 __exportStar(require("./dtos/BenefitItem"), exports);
 __exportStar(require("./dtos/BenefitListResponse"), exports);
@@ -73,3 +75,13 @@ __exportStar(require("./dtos/BenefitPaymentRequest"), exports);
 __exportStar(require("./dtos/BenefitPaymentResponse"), exports);
 __exportStar(require("./dtos/AuthorizeBenefitsMarketplaceTransactionRequest"), exports);
 __exportStar(require("./dtos/FavoriteUpsertContext"), exports);
+//Leaf overrides (admin backoffice) (v3.14.0)
+__exportStar(require("./dtos/FieldOverrideRequest"), exports);
+__exportStar(require("./dtos/InputSchemaOverrideRequest"), exports);
+__exportStar(require("./dtos/BackofficeLeafOverrideUpsertRequest"), exports);
+__exportStar(require("./dtos/BackofficeLeafListItem"), exports);
+__exportStar(require("./dtos/BackofficeLeafListResponse"), exports);
+__exportStar(require("./dtos/BackofficeLeafDetailResponse"), exports);
+//Banner assets upload (presigned PUT)
+__exportStar(require("./dtos/BannerUploadUrlRequest"), exports);
+__exportStar(require("./dtos/BannerUploadUrlResponse"), exports);

package/bin/card/validations/CardUpdateKeyConstraint.js

@@ -6,7 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IsValueValid = exports.CardUpdateKeyConstraint = exports.IsReasonRequiredForCancelledStatusConstraint = void 0;
+exports.CardUpdateKeyConstraint = exports.IsReasonRequiredForCancelledStatusConstraint = void 0;
+exports.IsValueValid = IsValueValid;
 const class_validator_1 = require("class-validator");
 const Status_1 = require("../enums/Status");
 const UpdateKey_1 = require("../enums/UpdateKey");
@@ -70,4 +71,3 @@ function IsValueValid(validationOptions) {
         });
     };
 }
-exports.IsValueValid = IsValueValid;

package/bin/card/validations/IsPhoneNumberConstraint.js

@@ -6,7 +6,8 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IsPhoneNumberFiado = exports.IsPhoneNumberConstraint = void 0;
+exports.IsPhoneNumberConstraint = void 0;
+exports.IsPhoneNumberFiado = IsPhoneNumberFiado;
 const class_validator_1 = require("class-validator");
 const regex_1 = require("../../helpers/constans/regex");
 let IsPhoneNumberConstraint = class IsPhoneNumberConstraint {
@@ -36,4 +37,3 @@ function IsPhoneNumberFiado(validationOptions) {
         });
     };
 }
-exports.IsPhoneNumberFiado = IsPhoneNumberFiado;

package/bin/index.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = exports.CentralPayments = exports.Helpdesk = exports.FiadoApiResponse = exports.Auth = exports.LegalDocumentsBusiness = exports.Role = exports.STPAccount = exports.RiskProfile = exports.FraudPreventionEngine = exports.BBVARst = exports.Stp = exports.BenefitCenter = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.App = exports.Address = exports.Beneficiary = exports.Activity = exports.Account = exports.Crypto = void 0;
 exports.MilestoneBusiness = exports.CirculoCredito = exports.CreditStatements = exports.Sentry = exports.AiEngine = exports.Funnel = exports.TeamsConnector = exports.PlatformErrorEvents = exports.CustomerFile = exports.CreditBackoffice = exports.CreditDashboard = exports.CreditEngine = exports.Credit = exports.ComissionBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = void 0;

package/package.json

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

package/src/benefitCenter/dtos/BackofficeLeafDetailResponse.ts

@@ -0,0 +1,37 @@
+import { ConnectorCatalogItem } from "./ConnectorCatalogItem";
+import { LeafOverrideStatusEnum } from "../enums/LeafOverrideStatusEnum";
+
+/**
+ * Override que vive en BenefitLeafOverride_GT (forma plana del item de DynamoDB).
+ * Los slots están definidos del lado lambda en BenefitLeafOverrideDocument;
+ * acá lo tipamos como Record opaco para no duplicar la definición.
+ *
+ * Los consumers del type-kit no necesitan el detalle interno — usan `effective`
+ * para ver el resultado final y `override` solo para saber qué campos están
+ * seteados.
+ */
+export type BenefitLeafOverridePayload = Record<string, unknown>;
+
+/**
+ * Response del detalle del backoffice. Trae 3 visiones del leaf:
+ *   - base: lo que devuelve el conector (sin merge).
+ *   - override: lo que hay en BenefitLeafOverride_GT (null si nunca se editó).
+ *   - effective: el merge (lo que ve la app).
+ * Si status === ORPHANED, base y effective son null.
+ */
+export class BackofficeLeafDetailResponse {
+    leafId: string;
+    benefitId: string;
+    moduleName: string;
+    serviceId: string;
+
+    base: ConnectorCatalogItem | null;
+    override: BenefitLeafOverridePayload | null;
+    effective: ConnectorCatalogItem | null;
+
+    status: LeafOverrideStatusEnum;
+
+    updatedBy: string | null;
+    createdAt: number | null;
+    updatedAt: number | null;
+}

package/src/benefitCenter/dtos/BackofficeLeafListItem.ts

@@ -0,0 +1,28 @@
+import { LeafOverrideStatusEnum } from "../enums/LeafOverrideStatusEnum";
+
+/**
+ * Item del listado del backoffice de leaves. Combina el estado efectivo
+ * (post-merge) que verá la app con metadata del override (si existe).
+ */
+export class BackofficeLeafListItem {
+    leafId: string;
+    benefitId: string;
+    moduleName: string;
+    serviceId: string;
+
+    // Effective (post-merge) — lo que vería el cliente
+    serviceName: string;
+    category: string;
+    subcategory: string;
+    enabled: boolean;
+    logo?: string;
+
+    // Metadata de override
+    hasOverride: boolean;
+    overriddenFields: string[];
+    status: LeafOverrideStatusEnum;
+
+    // Audit ligera
+    updatedBy?: string;
+    updatedAt?: number;
+}

package/src/benefitCenter/dtos/BackofficeLeafListResponse.ts

@@ -0,0 +1,8 @@
+import { BackofficeLeafListItem } from "./BackofficeLeafListItem";
+
+export class BackofficeLeafListResponse {
+    items: BackofficeLeafListItem[];
+
+    /** Cursor opaco para la próxima página. Ausente → no hay más páginas. */
+    index?: string;
+}

package/src/benefitCenter/dtos/BackofficeLeafOverrideUpsertRequest.ts

@@ -0,0 +1,77 @@
+import {
+    IsBoolean,
+    IsInt,
+    IsOptional,
+    IsString,
+    IsUrl,
+    Matches,
+    MaxLength,
+    Min,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { InputSchemaOverrideRequest } from "./InputSchemaOverrideRequest";
+
+/**
+ * Body de PUT /backoffice/leaves/{leafId}. Upsert parcial:
+ *   - undefined → no se toca
+ *   - string/number/boolean seteado → pisa el valor previo del override
+ *   - null NO se acepta (para borrar un campo, usar DELETE /fields/{fieldName})
+ *
+ * Si todos los campos llegan undefined → 400 INVALID_PATCH_PAYLOAD.
+ */
+export class BackofficeLeafOverrideUpsertRequest {
+    @IsOptional()
+    @IsString()
+    @MaxLength(120)
+    serviceName?: string;
+
+    @IsOptional()
+    @IsUrl({ protocols: ["https"], require_protocol: true })
+    @MaxLength(500)
+    logo?: string;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(2000)
+    description?: string;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(1000)
+    helpText?: string;
+
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    serviceOrder?: number;
+
+    @IsOptional()
+    @IsInt()
+    @Min(0)
+    subcategoryOrder?: number;
+
+    @IsOptional()
+    @IsBoolean()
+    enabled?: boolean;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(60)
+    @Matches(/^[A-Z][A-Z0-9_ ]*$/, { message: "category must be uppercase with underscores or spaces" })
+    category?: string;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(60)
+    subcategory?: string;
+
+    @IsOptional()
+    @IsBoolean()
+    requiresReferenceVerification?: boolean;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => InputSchemaOverrideRequest)
+    inputSchema?: InputSchemaOverrideRequest;
+}

package/src/benefitCenter/dtos/BannerUploadUrlRequest.ts

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

package/src/benefitCenter/dtos/BannerUploadUrlResponse.ts

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

package/src/benefitCenter/dtos/ConnectorCatalogItem.ts

@@ -32,4 +32,10 @@ export class ConnectorCatalogItem {
     products: ProductItem[];
     inputSchema: InputSchema;
     updatedAt: number;
+
+    /** Campo editorial solo-marketplace. Vive en BenefitLeafOverride_GT y el merger lo agrega al item devuelto. */
+    description?: string;
+
+    /** Campo editorial solo-marketplace. Texto corto inline en el form de pago. */
+    helpText?: string;
 }

package/src/benefitCenter/dtos/FieldOverrideRequest.ts

@@ -0,0 +1,67 @@
+import {
+    IsArray,
+    IsBoolean,
+    IsEnum,
+    IsNotEmpty,
+    IsOptional,
+    IsString,
+    IsUrl,
+    MaxLength,
+    ValidateNested,
+} from "class-validator";
+import { Type } from "class-transformer";
+import { InputFieldTypeEnum } from "../enums/InputFieldTypeEnum";
+import { InputValidation } from "./InputValidation";
+import { SelectOption } from "./SelectOption";
+
+/**
+ * Override parcial de un field individual del `inputSchema` por `key`.
+ * El admin no puede agregar ni quitar fields — solo editar los existentes.
+ */
+export class FieldOverrideRequest {
+    @IsString()
+    @IsNotEmpty()
+    key!: string;
+
+    @IsOptional()
+    @IsEnum(InputFieldTypeEnum)
+    type?: InputFieldTypeEnum;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(120)
+    label?: string;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(120)
+    placeholder?: string;
+
+    @IsOptional()
+    @IsBoolean()
+    required?: boolean;
+
+    @IsOptional()
+    @IsUrl({ protocols: ["https"], require_protocol: true })
+    helpImage?: string;
+
+    @IsOptional()
+    @IsBoolean()
+    showHelp?: boolean;
+
+    @IsOptional()
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => SelectOption)
+    options?: SelectOption[];
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(60)
+    dependsOn?: string;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => InputValidation)
+    validation?: InputValidation;
+}

package/src/benefitCenter/dtos/InputSchemaOverrideRequest.ts

@@ -0,0 +1,15 @@
+import { IsArray, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { FieldOverrideRequest } from "./FieldOverrideRequest";
+
+/**
+ * Override del inputSchema completo. El array `fieldOverrides[]` lista overrides
+ * parciales por `key`. La validación cruzada de que cada `key` exista en el
+ * inputSchema del conector la hace el manager (no se puede expresar con class-validator).
+ */
+export class InputSchemaOverrideRequest {
+    @IsArray()
+    @ValidateNested({ each: true })
+    @Type(() => FieldOverrideRequest)
+    fieldOverrides!: FieldOverrideRequest[];
+}

package/src/benefitCenter/dtos/ServiceLeaf.ts

@@ -11,4 +11,10 @@ export class ServiceLeaf {
     products: ProductItem[];
     inputSchema: InputSchema;
     updatedAt: number;
+
+    /** Campo editorial solo-marketplace. Vive en BenefitLeafOverride_GT y el merger lo agrega al item devuelto. */
+    description?: string;
+
+    /** Campo editorial solo-marketplace. Texto corto inline en el form de pago. */
+    helpText?: string;
 }

package/src/benefitCenter/enums/BannerAssetKindEnum.ts

@@ -0,0 +1,11 @@
+/**
+ * Tipo de asset que el backoffice quiere subir para un banner.
+ *
+ * Determina el whitelist de MIME types y el tamaño máximo permitido por la
+ * presigned URL que devuelve el backend.
+ */
+export enum BannerAssetKindEnum {
+    IMAGE = "IMAGE",
+    VIDEO = "VIDEO",
+    POSTER = "POSTER",
+}

package/src/benefitCenter/enums/LeafOverrideStatusEnum.ts

@@ -0,0 +1,10 @@
+/**
+ * Estado de un leaf en el listado del backoffice de overrides.
+ *
+ * - ACTIVE: el override (si existe) tiene un base correspondiente en el catálogo del conector.
+ * - ORPHANED: existe override pero el conector ya no devuelve este leafId — el provider lo retiró.
+ */
+export enum LeafOverrideStatusEnum {
+    ACTIVE = "ACTIVE",
+    ORPHANED = "ORPHANED",
+}

package/src/benefitCenter/index.ts

@@ -11,6 +11,8 @@ export * from "./enums/BannerTemplateVariantEnum";
 export * from "./enums/FavoriteDisabledReasonEnum";
 export * from "./enums/BenefitPaymentStatusEnum";
 export * from "./enums/BenefitPaymentErrorCodeEnum";
+export * from "./enums/LeafOverrideStatusEnum";
+export * from "./enums/BannerAssetKindEnum";
 
 //DTOs
 export * from "./dtos/BenefitItem";
@@ -58,3 +60,13 @@ export * from "./dtos/BenefitPaymentRequest";
 export * from "./dtos/BenefitPaymentResponse";
 export * from "./dtos/AuthorizeBenefitsMarketplaceTransactionRequest";
 export * from "./dtos/FavoriteUpsertContext";
+//Leaf overrides (admin backoffice) (v3.14.0)
+export * from "./dtos/FieldOverrideRequest";
+export * from "./dtos/InputSchemaOverrideRequest";
+export * from "./dtos/BackofficeLeafOverrideUpsertRequest";
+export * from "./dtos/BackofficeLeafListItem";
+export * from "./dtos/BackofficeLeafListResponse";
+export * from "./dtos/BackofficeLeafDetailResponse";
+//Banner assets upload (presigned PUT)
+export * from "./dtos/BannerUploadUrlRequest";
+export * from "./dtos/BannerUploadUrlResponse";