@fiado/type-kit 3.6.4 → 3.7.1

package/bin/benefitCenter/index.js

@@ -22,6 +22,8 @@ __exportStar(require("./enums/BannerContentTypeEnum"), exports);
 __exportStar(require("./enums/BannerActionTypeEnum"), exports);
 __exportStar(require("./enums/BannerStatusEnum"), exports);
 __exportStar(require("./enums/BannerLocaleEnum"), exports);
+__exportStar(require("./enums/BannerScreenEnum"), exports);
+__exportStar(require("./enums/BannerTemplateVariantEnum"), exports);
 //DTOs
 __exportStar(require("./dtos/BenefitItem"), exports);
 __exportStar(require("./dtos/BenefitListResponse"), exports);
@@ -37,6 +39,7 @@ __exportStar(require("./dtos/ServiceLeaf"), exports);
 __exportStar(require("./dtos/BannerContent"), exports);
 __exportStar(require("./dtos/BannerAction"), exports);
 __exportStar(require("./dtos/BannerItem"), exports);
+__exportStar(require("./dtos/BannerTemplateTheme"), exports);
 __exportStar(require("./dtos/BenefitReferenceVerificationRequest"), exports);
 __exportStar(require("./dtos/ConnectorCatalogItem"), exports);
 __exportStar(require("./dtos/ConnectorCatalogResponse"), exports);
@@ -51,4 +54,6 @@ __exportStar(require("./dtos/BannerContentRequest"), exports);
 __exportStar(require("./dtos/BannerActionRequest"), exports);
 __exportStar(require("./dtos/BannerCreateRequest"), exports);
 __exportStar(require("./dtos/BannerUpdateRequest"), exports);
+__exportStar(require("./dtos/BannerTemplateThemeRequest"), exports);
+__exportStar(require("./dtos/BannerTemplateRequest"), exports);
 __exportStar(require("./dtos/PublicVerifyReferenceRequest"), exports);

package/bin/circuloCredito/dtos/AccountInfo.d.ts

@@ -0,0 +1,27 @@
+import { AccountStatus } from "../enums/AccountStatus";
+import { PaymentFrequency } from "../enums/PaymentFrequency";
+import { PaymentPeriodStatus } from "../enums/PaymentPeriodStatus";
+import { ReportType } from "../enums/ReportType";
+export declare class AccountInfo {
+    accountNumber: string;
+    reportType: ReportType;
+    status: AccountStatus;
+    openedAt: string;
+    cutoffDate: string;
+    closedAt?: string;
+    lastPaymentAt?: string;
+    numberOfPayments: number;
+    paymentFrequency: PaymentFrequency;
+    paymentAmount: number;
+    currency: 'MXN' | 'USD';
+    originalAmount: number;
+    maxCredit: number;
+    currentBalance: number;
+    outstandingBalance: number;
+    overdueBalance: number;
+    overduePaymentsCount: number;
+    overdueDays: number;
+    totalReportedPayments: number;
+    lastPaymentAmount?: number;
+    paymentHistory: Array<PaymentPeriodStatus>;
+}

package/bin/circuloCredito/dtos/AccountInfo.js

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

package/bin/circuloCredito/dtos/AddressInfo.d.ts

@@ -0,0 +1,11 @@
+export declare class AddressInfo {
+    street: string;
+    addressNumber: string;
+    internalNumber?: string;
+    neighborhood?: string;
+    municipality?: string;
+    city: string;
+    state: string;
+    country: string;
+    postalCode?: string;
+}

package/bin/circuloCredito/dtos/AddressInfo.js

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

package/bin/circuloCredito/dtos/ClientInfo.d.ts

@@ -0,0 +1,14 @@
+export declare class ClientInfo {
+    firstName: string;
+    middleName?: string;
+    lastNamePaterno: string;
+    lastNameMaterno: string;
+    rfc: string;
+    curp?: string;
+    dateOfBirth: string;
+    sex?: 'M' | 'F';
+    nationality?: string;
+    ineKey?: string;
+    email?: string;
+    phone?: string;
+}

package/bin/circuloCredito/dtos/ClientInfo.js

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

package/bin/circuloCredito/dtos/ReportarCuentaRequest.d.ts

@@ -0,0 +1,10 @@
+import { ClientInfo } from "./ClientInfo";
+import { AddressInfo } from "./AddressInfo";
+import { AccountInfo } from "./AccountInfo";
+export declare class ReportarCuentaRequest {
+    partnerId: string;
+    idempotencyKey: string;
+    client: ClientInfo;
+    address: AddressInfo;
+    account: AccountInfo;
+}

package/bin/circuloCredito/dtos/ReportarCuentaRequest.js

@@ -0,0 +1,48 @@
+"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.ReportarCuentaRequest = void 0;
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const ClientInfo_1 = require("./ClientInfo");
+const AddressInfo_1 = require("./AddressInfo");
+const AccountInfo_1 = require("./AccountInfo");
+class ReportarCuentaRequest {
+}
+exports.ReportarCuentaRequest = ReportarCuentaRequest;
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ReportarCuentaRequest.prototype, "partnerId", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], ReportarCuentaRequest.prototype, "idempotencyKey", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => ClientInfo_1.ClientInfo),
+    __metadata("design:type", ClientInfo_1.ClientInfo)
+], ReportarCuentaRequest.prototype, "client", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => AddressInfo_1.AddressInfo),
+    __metadata("design:type", AddressInfo_1.AddressInfo)
+], ReportarCuentaRequest.prototype, "address", void 0);
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => AccountInfo_1.AccountInfo),
+    __metadata("design:type", AccountInfo_1.AccountInfo)
+], ReportarCuentaRequest.prototype, "account", void 0);

package/bin/circuloCredito/dtos/ReportarCuentaResponse.d.ts

@@ -0,0 +1,19 @@
+import { ReportarCuentaResultStatus } from "../enums/ReportarCuentaResultStatus";
+import { CdcConnectorErrorCode } from "../enums/CdcConnectorErrorCode";
+export declare class FieldError {
+    field: string;
+    reason: string;
+}
+export declare class ReportarCuentaError {
+    code: CdcConnectorErrorCode;
+    message: string;
+    fieldErrors?: FieldError[];
+}
+export declare class ReportarCuentaResponse {
+    status: ReportarCuentaResultStatus;
+    externalId: string | null;
+    sentAt: string;
+    payloadHash: string;
+    error?: ReportarCuentaError;
+    providerResponseRaw?: Record<string, unknown>;
+}

package/bin/circuloCredito/dtos/ReportarCuentaResponse.js

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

package/bin/circuloCredito/enums/AccountStatus.d.ts

@@ -0,0 +1,5 @@
+export declare enum AccountStatus {
+    ACTIVE = "ACTIVE",
+    DELINQUENT = "DELINQUENT",
+    PAID_OFF = "PAID_OFF"
+}

package/bin/circuloCredito/enums/AccountStatus.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountStatus = void 0;
+var AccountStatus;
+(function (AccountStatus) {
+    AccountStatus["ACTIVE"] = "ACTIVE";
+    AccountStatus["DELINQUENT"] = "DELINQUENT";
+    AccountStatus["PAID_OFF"] = "PAID_OFF";
+})(AccountStatus || (exports.AccountStatus = AccountStatus = {}));

package/bin/circuloCredito/enums/CdcConnectorErrorCode.d.ts

@@ -0,0 +1,8 @@
+export declare enum CdcConnectorErrorCode {
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    AUTH_ERROR = "AUTH_ERROR",
+    RATE_LIMIT = "RATE_LIMIT",
+    PROVIDER_ERROR = "PROVIDER_ERROR",
+    TIMEOUT = "TIMEOUT",
+    PARTNER_NOT_CONFIGURED = "PARTNER_NOT_CONFIGURED"
+}

package/bin/circuloCredito/enums/CdcConnectorErrorCode.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CdcConnectorErrorCode = void 0;
+var CdcConnectorErrorCode;
+(function (CdcConnectorErrorCode) {
+    CdcConnectorErrorCode["VALIDATION_ERROR"] = "VALIDATION_ERROR";
+    CdcConnectorErrorCode["AUTH_ERROR"] = "AUTH_ERROR";
+    CdcConnectorErrorCode["RATE_LIMIT"] = "RATE_LIMIT";
+    CdcConnectorErrorCode["PROVIDER_ERROR"] = "PROVIDER_ERROR";
+    CdcConnectorErrorCode["TIMEOUT"] = "TIMEOUT";
+    CdcConnectorErrorCode["PARTNER_NOT_CONFIGURED"] = "PARTNER_NOT_CONFIGURED";
+})(CdcConnectorErrorCode || (exports.CdcConnectorErrorCode = CdcConnectorErrorCode = {}));

package/bin/circuloCredito/enums/PaymentFrequency.d.ts

@@ -0,0 +1,10 @@
+export declare enum PaymentFrequency {
+    WEEKLY = "WEEKLY",
+    BIWEEKLY = "BIWEEKLY",
+    FORTNIGHTLY = "FORTNIGHTLY",
+    MONTHLY = "MONTHLY",
+    QUARTERLY = "QUARTERLY",
+    SEMESTRAL = "SEMESTRAL",
+    ANNUAL = "ANNUAL",
+    ONE_TIME = "ONE_TIME"
+}

package/bin/circuloCredito/enums/PaymentFrequency.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentFrequency = void 0;
+var PaymentFrequency;
+(function (PaymentFrequency) {
+    PaymentFrequency["WEEKLY"] = "WEEKLY";
+    PaymentFrequency["BIWEEKLY"] = "BIWEEKLY";
+    PaymentFrequency["FORTNIGHTLY"] = "FORTNIGHTLY";
+    PaymentFrequency["MONTHLY"] = "MONTHLY";
+    PaymentFrequency["QUARTERLY"] = "QUARTERLY";
+    PaymentFrequency["SEMESTRAL"] = "SEMESTRAL";
+    PaymentFrequency["ANNUAL"] = "ANNUAL";
+    PaymentFrequency["ONE_TIME"] = "ONE_TIME";
+})(PaymentFrequency || (exports.PaymentFrequency = PaymentFrequency = {}));

package/bin/circuloCredito/enums/PaymentPeriodStatus.d.ts

@@ -0,0 +1,12 @@
+export declare enum PaymentPeriodStatus {
+    ON_TIME = "ON_TIME",
+    OVERDUE_1 = "OVERDUE_1",
+    OVERDUE_2 = "OVERDUE_2",
+    OVERDUE_3 = "OVERDUE_3",
+    OVERDUE_4 = "OVERDUE_4",
+    OVERDUE_5 = "OVERDUE_5",
+    OVERDUE_6 = "OVERDUE_6",
+    OVERDUE_7_PLUS = "OVERDUE_7_PLUS",
+    WRITTEN_OFF = "WRITTEN_OFF",
+    NO_DATA = "NO_DATA"
+}

package/bin/circuloCredito/enums/PaymentPeriodStatus.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PaymentPeriodStatus = void 0;
+var PaymentPeriodStatus;
+(function (PaymentPeriodStatus) {
+    PaymentPeriodStatus["ON_TIME"] = "ON_TIME";
+    PaymentPeriodStatus["OVERDUE_1"] = "OVERDUE_1";
+    PaymentPeriodStatus["OVERDUE_2"] = "OVERDUE_2";
+    PaymentPeriodStatus["OVERDUE_3"] = "OVERDUE_3";
+    PaymentPeriodStatus["OVERDUE_4"] = "OVERDUE_4";
+    PaymentPeriodStatus["OVERDUE_5"] = "OVERDUE_5";
+    PaymentPeriodStatus["OVERDUE_6"] = "OVERDUE_6";
+    PaymentPeriodStatus["OVERDUE_7_PLUS"] = "OVERDUE_7_PLUS";
+    PaymentPeriodStatus["WRITTEN_OFF"] = "WRITTEN_OFF";
+    PaymentPeriodStatus["NO_DATA"] = "NO_DATA";
+})(PaymentPeriodStatus || (exports.PaymentPeriodStatus = PaymentPeriodStatus = {}));

package/bin/circuloCredito/enums/ReportType.d.ts

@@ -0,0 +1,5 @@
+export declare enum ReportType {
+    NEW = "NEW",
+    UPDATE = "UPDATE",
+    CLOSURE = "CLOSURE"
+}

package/bin/circuloCredito/enums/ReportType.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportType = void 0;
+var ReportType;
+(function (ReportType) {
+    ReportType["NEW"] = "NEW";
+    ReportType["UPDATE"] = "UPDATE";
+    ReportType["CLOSURE"] = "CLOSURE";
+})(ReportType || (exports.ReportType = ReportType = {}));

package/bin/circuloCredito/enums/ReportarCuentaResultStatus.d.ts

@@ -0,0 +1,5 @@
+export declare enum ReportarCuentaResultStatus {
+    CONFIRMED = "CONFIRMED",
+    REJECTED = "REJECTED",
+    ERROR = "ERROR"
+}

package/bin/circuloCredito/enums/ReportarCuentaResultStatus.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportarCuentaResultStatus = void 0;
+var ReportarCuentaResultStatus;
+(function (ReportarCuentaResultStatus) {
+    ReportarCuentaResultStatus["CONFIRMED"] = "CONFIRMED";
+    ReportarCuentaResultStatus["REJECTED"] = "REJECTED";
+    ReportarCuentaResultStatus["ERROR"] = "ERROR";
+})(ReportarCuentaResultStatus || (exports.ReportarCuentaResultStatus = ReportarCuentaResultStatus = {}));

package/bin/circuloCredito/index.d.ts

@@ -0,0 +1,11 @@
+export * from './dtos/ClientInfo';
+export * from './dtos/AddressInfo';
+export * from './dtos/AccountInfo';
+export * from './dtos/ReportarCuentaRequest';
+export * from './dtos/ReportarCuentaResponse';
+export * from './enums/PaymentPeriodStatus';
+export * from './enums/PaymentFrequency';
+export * from './enums/ReportType';
+export * from './enums/AccountStatus';
+export * from './enums/ReportarCuentaResultStatus';
+export * from './enums/CdcConnectorErrorCode';

package/bin/circuloCredito/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dtos/ClientInfo"), exports);
+__exportStar(require("./dtos/AddressInfo"), exports);
+__exportStar(require("./dtos/AccountInfo"), exports);
+__exportStar(require("./dtos/ReportarCuentaRequest"), exports);
+__exportStar(require("./dtos/ReportarCuentaResponse"), exports);
+__exportStar(require("./enums/PaymentPeriodStatus"), exports);
+__exportStar(require("./enums/PaymentFrequency"), exports);
+__exportStar(require("./enums/ReportType"), exports);
+__exportStar(require("./enums/AccountStatus"), exports);
+__exportStar(require("./enums/ReportarCuentaResultStatus"), exports);
+__exportStar(require("./enums/CdcConnectorErrorCode"), exports);

package/bin/index.d.ts

@@ -69,3 +69,4 @@ export * as Funnel from './funnel';
 export * as AiEngine from './aiEngine';
 export * as Sentry from './sentry';
 export * as CreditStatements from './credit-statements';
+export * as CirculoCredito from './circuloCredito';

package/bin/index.js

@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 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.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;
+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;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.Activity = __importStar(require("./activity"));
@@ -106,3 +106,4 @@ exports.Funnel = __importStar(require("./funnel"));
 exports.AiEngine = __importStar(require("./aiEngine"));
 exports.Sentry = __importStar(require("./sentry"));
 exports.CreditStatements = __importStar(require("./credit-statements"));
+exports.CirculoCredito = __importStar(require("./circuloCredito"));

package/package.json

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

package/src/benefitCenter/dtos/BannerAction.ts

@@ -1,8 +1,25 @@
 import { BannerActionTypeEnum } from "../enums/BannerActionTypeEnum";
 
+/**
+ * Acción pública del banner. La estructura cambia según `type`:
+ *   - URL          → `target` (URL externa absoluta)
+ *   - NAVIGATION   → `flow` y opcionalmente `props` (data dinámica para profundizar la navegación)
+ *
+ * Cuando un banner es informativo se omite el campo `action` por completo
+ * en el response — no existe un type "NONE".
+ */
 export class BannerAction {
     type: BannerActionTypeEnum;
+
+    /** URL externa absoluta — solo si type === URL. */
     target?: string;
-    benefitId?: string;
+
+    /** Flow interno de la app — solo si type === NAVIGATION. */
+    flow?: string;
+
+    /** Data libre para profundizar la navegación — solo si type === NAVIGATION. */
+    props?: Record<string, unknown>;
+
+    /** Tracking arbitrario (campaign, source, etc.). */
     metadata?: Record<string, unknown>;
 }

package/src/benefitCenter/dtos/BannerActionRequest.ts

@@ -1,13 +1,27 @@
 import { IsEnum, IsObject, IsOptional, IsString } from "class-validator";
 import { BannerActionTypeEnum } from "../enums/BannerActionTypeEnum";
 
+/**
+ * Acción del banner. Validación cruzada por tipo (la aplica el backend):
+ *   - URL          → `target` debe estar presente (URL absoluta)
+ *   - NAVIGATION   → `flow` debe estar presente; `props` opcional
+ */
 export class BannerActionRequest {
     @IsEnum(BannerActionTypeEnum)
     type!: BannerActionTypeEnum;
 
+    /** URL externa absoluta — requerido cuando type === URL. */
     @IsOptional() @IsString() target?: string;
-    @IsOptional() @IsString() benefitId?: string;
 
+    /** Flow interno de la app — requerido cuando type === NAVIGATION. */
+    @IsOptional() @IsString() flow?: string;
+
+    /** Data libre para profundizar la navegación — opcional cuando type === NAVIGATION. */
+    @IsOptional()
+    @IsObject()
+    props?: Record<string, unknown>;
+
+    /** Tracking arbitrario (campaña, source, etc.). */
     @IsOptional()
     @IsObject()
     metadata?: Record<string, unknown>;

package/src/benefitCenter/dtos/BannerContent.ts

@@ -1,15 +1,49 @@
 import { BannerContentTypeEnum } from "../enums/BannerContentTypeEnum";
+import { BannerTemplateVariantEnum } from "../enums/BannerTemplateVariantEnum";
+import { BannerTemplateTheme } from "./BannerTemplateTheme";
+
+/**
+ * Wrapper de variant + theme para banners type === TEMPLATE.
+ */
+export interface BannerTemplate {
+    variant: BannerTemplateVariantEnum;
+    theme?: BannerTemplateTheme;
+}
 
 /**
  * Contenido del banner ya resuelto al locale del usuario (plano, sin translations).
  * El backend resuelve `translations[locale]` antes de devolverlo a la app.
- * Ver doc 06 §"Manejo de Idioma".
+ *
+ * Cada `type` usa solo un subset de los campos:
+ *   - IMAGE     → imageUrl
+ *   - HTML      → html
+ *   - VIDEO     → videoUrl, posterUrl?
+ *   - TEMPLATE  → template (variant + theme), title, description, imageUrl, buttonText?
  */
 export class BannerContent {
     type: BannerContentTypeEnum;
-    imageUrl?: string;        // Si type === IMAGE
-    html?: string;            // Si type === HTML
-    title?: string;           // Si type === TEMPLATE
-    subtitle?: string;        // Si type === TEMPLATE
-    backgroundColor?: string; // Si type === TEMPLATE
+
+    /** Solo presente cuando type === TEMPLATE. */
+    template?: BannerTemplate;
+
+    /** IMAGE (banner completo) o TEMPLATE (ilustración / mascota lateral). */
+    imageUrl?: string;
+
+    /** HTML — fragmento de markup. */
+    html?: string;
+
+    /** VIDEO — URL del video. */
+    videoUrl?: string;
+
+    /** VIDEO — frame inicial / fallback cuando el video no se puede reproducir. */
+    posterUrl?: string;
+
+    /** TEMPLATE — título visible. */
+    title?: string;
+
+    /** TEMPLATE — descripción debajo del título. */
+    description?: string;
+
+    /** TEMPLATE _BUTTON — texto del botón CTA. */
+    buttonText?: string;
 }

package/src/benefitCenter/dtos/BannerContentRequest.ts

@@ -1,12 +1,23 @@
-import { IsEnum, ValidateNested } from "class-validator";
+import { IsEnum, IsOptional, ValidateNested } from "class-validator";
 import { Type } from "class-transformer";
 import { BannerContentTypeEnum } from "../enums/BannerContentTypeEnum";
+import { BannerTemplateRequest } from "./BannerTemplateRequest";
 import { BannerTranslationsRequest } from "./BannerTranslationsRequest";
 
 export class BannerContentRequest {
     @IsEnum(BannerContentTypeEnum)
     type!: BannerContentTypeEnum;
 
+    /**
+     * Solo presente cuando `type === TEMPLATE`. La validación cruzada
+     * "TEMPLATE requiere template, los demás tipos lo ignoran" la aplica
+     * el backend al persistir.
+     */
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerTemplateRequest)
+    template?: BannerTemplateRequest;
+
     @ValidateNested()
     @Type(() => BannerTranslationsRequest)
     translations!: BannerTranslationsRequest;

package/src/benefitCenter/dtos/BannerCreateRequest.ts

@@ -1,4 +1,6 @@
 import {
+    ArrayNotEmpty,
+    IsArray,
     IsEnum,
     IsInt,
     IsNotEmpty,
@@ -10,6 +12,7 @@ import {
 } from "class-validator";
 import { Type } from "class-transformer";
 import { BannerStatusEnum } from "../enums/BannerStatusEnum";
+import { BannerScreenEnum } from "../enums/BannerScreenEnum";
 import { BannerContentRequest } from "./BannerContentRequest";
 import { BannerActionRequest } from "./BannerActionRequest";
 
@@ -29,6 +32,16 @@ export class BannerCreateRequest {
     @Min(0)
     sortOrder!: number;
 
+    /**
+     * Pantallas donde el banner aparece. Requerido — al menos un valor.
+     * El admin decide caso por caso por restricciones regulatorias (algunos
+     * benefits no se pueden promocionar en HOME).
+     */
+    @IsArray()
+    @ArrayNotEmpty()
+    @IsEnum(BannerScreenEnum, { each: true })
+    screens!: BannerScreenEnum[];
+
     @IsOptional() @IsInt() startDate?: number;
     @IsOptional() @IsInt() endDate?: number;
 

package/src/benefitCenter/dtos/BannerTemplateRequest.ts

@@ -0,0 +1,17 @@
+import { IsEnum, IsOptional, ValidateNested } from "class-validator";
+import { Type } from "class-transformer";
+import { BannerTemplateVariantEnum } from "../enums/BannerTemplateVariantEnum";
+import { BannerTemplateThemeRequest } from "./BannerTemplateThemeRequest";
+
+/**
+ * Wrapper de variant + theme para banners content.type === TEMPLATE.
+ */
+export class BannerTemplateRequest {
+    @IsEnum(BannerTemplateVariantEnum)
+    variant!: BannerTemplateVariantEnum;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => BannerTemplateThemeRequest)
+    theme?: BannerTemplateThemeRequest;
+}

package/src/benefitCenter/dtos/BannerTemplateTheme.ts

@@ -0,0 +1,18 @@
+/**
+ * Theme de un banner TEMPLATE. Todos los campos son opcionales — si vienen
+ * ausentes, el frontend aplica defaults de marca:
+ *
+ *   backgroundColor:       #915DE4
+ *   textColor:             #FFFFFF
+ *   buttonBackgroundColor: #FFFF00
+ *   buttonTextColor:       #915DE4
+ *
+ * Los campos del botón (`buttonBackgroundColor`, `buttonTextColor`) sólo
+ * tienen efecto cuando la variante incluye un botón.
+ */
+export interface BannerTemplateTheme {
+    backgroundColor?: string;
+    textColor?: string;
+    buttonBackgroundColor?: string;
+    buttonTextColor?: string;
+}

package/src/benefitCenter/dtos/BannerTemplateThemeRequest.ts

@@ -0,0 +1,23 @@
+import { IsOptional, IsString } from "class-validator";
+
+/**
+ * DTO de entrada para el theme del banner TEMPLATE. Todos los campos
+ * opcionales — el frontend aplica defaults de marca cuando no vienen.
+ */
+export class BannerTemplateThemeRequest {
+    @IsOptional()
+    @IsString()
+    backgroundColor?: string;
+
+    @IsOptional()
+    @IsString()
+    textColor?: string;
+
+    @IsOptional()
+    @IsString()
+    buttonBackgroundColor?: string;
+
+    @IsOptional()
+    @IsString()
+    buttonTextColor?: string;
+}