@fiado/type-kit 3.562.0 → 3.564.0

package/_test_/unit/retailCustomer/welcomeBonusRequests.test.ts

@@ -219,6 +219,6 @@ describe('enums del bono de bienvenida', () => {
     });
 
     it('el origen del monto distingue el parámetro del fallback local', () => {
-        expect(Object.values(WelcomeBonusAmountSourceEnum)).toEqual(['PARAM', 'DEFAULT']);
+        expect(Object.values(WelcomeBonusAmountSourceEnum)).toEqual(['PARAM', 'DEFAULT', 'SALE_PROMOTION']);
     });
 });

package/_test_/unit/retailPromotions/constants.test.ts

@@ -43,7 +43,7 @@ describe('catálogo de errores', () => {
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.CODE_NOT_FOUND).toBe(404);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.DISCOUNT_AFTER_QUOTE).toBe(409);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.CODE_NOT_OWNED).toBe(422);
-    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(32);
+    expect(Object.keys(RetailPromotionsErrorCodeEnum)).toHaveLength(34);
     expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS.SPLIT_FINANCING_DISABLED).toBe(409);
   });
 

package/_test_/unit/retailPromotions/welcomeBonusPromotion.test.ts

@@ -0,0 +1,34 @@
+import 'reflect-metadata';
+import {
+  RETAIL_PROMOTIONS_ERROR_HTTP_STATUS,
+  RetailPromotionsErrorCodeEnum,
+  SalePromotion,
+  SalePromotionSystemKeyEnum,
+  WelcomeBonusPromotionResponse,
+} from '../../../src/retailPromotions/index';
+import { WelcomeBonusAmountSourceEnum } from '../../../src/retailCustomer/index';
+
+describe('promo de sistema del bono de bienvenida', () => {
+  it('la llave de sistema solo tiene WELCOME_BONUS', () => {
+    expect(Object.values(SalePromotionSystemKeyEnum)).toEqual(['WELCOME_BONUS']);
+  });
+
+  it('la promo de venta expone systemKey opcional', () => {
+    const systemKey: SalePromotion['systemKey'] = SalePromotionSystemKeyEnum.WELCOME_BONUS;
+    expect(systemKey).toBe('WELCOME_BONUS');
+  });
+
+  it('la respuesta privada trae id, estado y monto', () => {
+    const response: WelcomeBonusPromotionResponse = { promotionId: 'p', active: true, amountCents: 2500 };
+    expect(Object.keys(response)).toEqual(['promotionId', 'active', 'amountCents']);
+  });
+
+  it('los candados de la promo de sistema son 422', () => {
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS[RetailPromotionsErrorCodeEnum.SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED]).toBe(422);
+    expect(RETAIL_PROMOTIONS_ERROR_HTTP_STATUS[RetailPromotionsErrorCodeEnum.SYSTEM_PROMOTION_FIELD_LOCKED]).toBe(422);
+  });
+
+  it('el monto del bono puede salir de la promo de venta', () => {
+    expect(WelcomeBonusAmountSourceEnum.SALE_PROMOTION).toBe('SALE_PROMOTION');
+  });
+});

package/bin/index.d.ts

@@ -130,3 +130,4 @@ export * as DatalakeReports from './datalakeReports';
 export * as PdfRender from './pdfRender';
 export * as Rules from './rules';
 export * as LoanRetailAudit from './loanRetailAudit';
+export * as TaskManager from './task-manager-business';

package/bin/index.js

@@ -38,7 +38,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 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.FiadoIncFavorite = exports.BankAccount = exports.P2pContact = exports.CreditContract = exports.Contract = exports.ProductCatalog = exports.ContactInfo = exports.TransactionAnalytics = exports.Transaction = exports.TransactionProcessor = exports.GenericMessage = exports.EventBridgeMessage = exports.SessionActivity = exports.MessageMoments = exports.NotificationMessages = exports.ServicePayment = exports.Header = exports.Identity = exports.UserTags = exports.Group = exports.File = exports.ExchangeRate = exports.Directory = exports.Currency = exports.Country = exports.Card = exports.Authentication = exports.AppContent = exports.App = exports.Offices = exports.Places = exports.Address = exports.Beneficiary = exports.Activity = exports.Biometrics = exports.MetamapConnector = exports.Account = exports.Crypto = void 0;
 exports.RetailCards = exports.RetailCatalog = exports.RetailCommission = exports.RetailOrg = exports.EmailVerification = exports.NetworkConnector = exports.Modelias = exports.TotpSecurity = exports.Passport = exports.WalletFunding = exports.Remittance = exports.PlatformRbac = exports.CognitoBackofficeConnector = exports.WhatsappConnector = exports.TwilioConnector = exports.MessagesConnector = exports.Mdm = 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.UsMarketGrowthBusiness = exports.ReferralBusiness = exports.ZendeskMessaging = exports.NotificationWS = exports.Event = exports.PayrollBusiness = exports.Cnbv = exports.DirectorySetting = exports.InvoiceCollector = exports.Collector = exports.Pricelist = exports.Company = exports.Services = exports.AccountIssuanceBusiness = exports.AppSelectionData = exports.Device = exports.Observations = exports.IssuanceBusiness = exports.Blacklist = void 0;
-exports.LoanRetailAudit = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
+exports.TaskManager = exports.LoanRetailAudit = exports.Rules = exports.PdfRender = exports.DatalakeReports = exports.RewardsEligibility = exports.Rewards = exports.DynamicForm = exports.FileStorage = exports.MoneyTransfer = exports.RetailLoan = exports.Membership = exports.WebhookBusiness = exports.PeopleBusiness = exports.UserConfirmations = exports.Collection = exports.Shipping = exports.PhoneSales = exports.Onboarding = exports.Kyc = exports.LoanScoring = exports.LoanCredit = exports.LoanCollectorAssignment = exports.LoanOfferings = exports.Shortlink = exports.LoanConfig = exports.DatalakeQuery = exports.RetailIntegration = exports.RetailPromotions = exports.RetailWizard = exports.RetailCustomer = void 0;
 exports.Crypto = __importStar(require("./crypto"));
 exports.Account = __importStar(require("./account"));
 exports.MetamapConnector = __importStar(require("./metamapConnector"));
@@ -255,3 +255,5 @@ exports.Rules = __importStar(require("./rules"));
 // LoanRetailAudit: contrato del lambda central loan-retail-audit-business (bitácora y accesos a PII
 // de Loan y Retail): mensaje de su cola, POST /private/pii-access-logs y GET /private/audit-trail.
 exports.LoanRetailAudit = __importStar(require("./loanRetailAudit"));
+// TaskManager: DTOs del lambda task-manager-business (gestor genérico de tareas; primer tipo MARKETING_MATERIAL).
+exports.TaskManager = __importStar(require("./task-manager-business"));

package/bin/retailCustomer/enums/WelcomeBonusAmountSourceEnum.d.ts

@@ -8,5 +8,7 @@ export declare enum WelcomeBonusAmountSourceEnum {
     /** Parámetro de negocio de `loan-config` (`WELCOME_BONUS/amount_cents`). */
     PARAM = "PARAM",
     /** Default local del wizard, usado porque `loan-config` no respondió. */
-    DEFAULT = "DEFAULT"
+    DEFAULT = "DEFAULT",
+    /** Monto de la promo de venta de sistema `WELCOME_BONUS` del retailer. */
+    SALE_PROMOTION = "SALE_PROMOTION"
 }

package/bin/retailCustomer/enums/WelcomeBonusAmountSourceEnum.js

@@ -13,4 +13,6 @@ var WelcomeBonusAmountSourceEnum;
     WelcomeBonusAmountSourceEnum["PARAM"] = "PARAM";
     /** Default local del wizard, usado porque `loan-config` no respondió. */
     WelcomeBonusAmountSourceEnum["DEFAULT"] = "DEFAULT";
+    /** Monto de la promo de venta de sistema `WELCOME_BONUS` del retailer. */
+    WelcomeBonusAmountSourceEnum["SALE_PROMOTION"] = "SALE_PROMOTION";
 })(WelcomeBonusAmountSourceEnum || (exports.WelcomeBonusAmountSourceEnum = WelcomeBonusAmountSourceEnum = {}));

package/bin/retailPromotions/constants/retailPromotionsErrorHttpStatus.js

@@ -36,4 +36,6 @@ exports.RETAIL_PROMOTIONS_ERROR_HTTP_STATUS = {
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SPLIT_FINANCING_DISABLED]: 409,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_NOT_STACKABLE]: 422,
     [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.PROMOTION_PAYMENT_NOT_ELIGIBLE]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED]: 422,
+    [RetailPromotionsErrorCodeEnum_1.RetailPromotionsErrorCodeEnum.SYSTEM_PROMOTION_FIELD_LOCKED]: 422,
 };

package/bin/retailPromotions/dtos/SalePromotion.d.ts

@@ -2,11 +2,14 @@ import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../enums/PromotionPaymentOptionEnum';
 import { SalePromotionPhaseEnum } from '../enums/SalePromotionPhaseEnum';
 import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
+import { SalePromotionSystemKeyEnum } from '../enums/SalePromotionSystemKeyEnum';
 import { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from './SalePromotionLevers';
 /** Promo de venta tal como la devuelve el CRUD. Dinero en centavos, fechas ISO. */
 export interface SalePromotion {
     promotionId: string;
     retailerId: string;
+    /** Presente solo en promos sembradas por el sistema; ausente en las del admin. */
+    systemKey?: SalePromotionSystemKeyEnum;
     name: string;
     /** Texto que ve el cliente en el wizard. */
     customerText: string;

package/bin/retailPromotions/dtos/responses/WelcomeBonusPromotionResponse.d.ts

@@ -0,0 +1,6 @@
+/** Respuesta de `GET /private/retailers/{retailerId}/welcome-bonus`; `active` = promo en `ACTIVE`. */
+export interface WelcomeBonusPromotionResponse {
+    promotionId: string;
+    active: boolean;
+    amountCents: number;
+}

package/bin/retailPromotions/dtos/responses/WelcomeBonusPromotionResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.d.ts

@@ -48,5 +48,9 @@ export declare enum RetailPromotionsErrorCodeEnum {
     /** La promo no acumulable choca con otra en la misma línea. */
     PROMOTION_NOT_STACKABLE = "PROMOTION_NOT_STACKABLE",
     /** La promo no acepta la forma de pago o el medio de cobro de la venta. */
-    PROMOTION_PAYMENT_NOT_ELIGIBLE = "PROMOTION_PAYMENT_NOT_ELIGIBLE"
+    PROMOTION_PAYMENT_NOT_ELIGIBLE = "PROMOTION_PAYMENT_NOT_ELIGIBLE",
+    /** La promo de sistema solo admite pausar y reanudar. */
+    SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED = "SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED",
+    /** De la promo de sistema solo se edita el monto del bono. */
+    SYSTEM_PROMOTION_FIELD_LOCKED = "SYSTEM_PROMOTION_FIELD_LOCKED"
 }

package/bin/retailPromotions/enums/RetailPromotionsErrorCodeEnum.js

@@ -53,4 +53,8 @@ var RetailPromotionsErrorCodeEnum;
     RetailPromotionsErrorCodeEnum["PROMOTION_NOT_STACKABLE"] = "PROMOTION_NOT_STACKABLE";
     /** La promo no acepta la forma de pago o el medio de cobro de la venta. */
     RetailPromotionsErrorCodeEnum["PROMOTION_PAYMENT_NOT_ELIGIBLE"] = "PROMOTION_PAYMENT_NOT_ELIGIBLE";
+    /** La promo de sistema solo admite pausar y reanudar. */
+    RetailPromotionsErrorCodeEnum["SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED"] = "SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED";
+    /** De la promo de sistema solo se edita el monto del bono. */
+    RetailPromotionsErrorCodeEnum["SYSTEM_PROMOTION_FIELD_LOCKED"] = "SYSTEM_PROMOTION_FIELD_LOCKED";
 })(RetailPromotionsErrorCodeEnum || (exports.RetailPromotionsErrorCodeEnum = RetailPromotionsErrorCodeEnum = {}));

package/bin/retailPromotions/enums/SalePromotionSystemKeyEnum.d.ts

@@ -0,0 +1,5 @@
+/** Promos de venta que siembra el sistema; solo se pausan, reanudan o editan su monto. */
+export declare enum SalePromotionSystemKeyEnum {
+    /** Bono de bienvenida por apertura de cuenta, una por retailer. */
+    WELCOME_BONUS = "WELCOME_BONUS"
+}

package/bin/retailPromotions/enums/SalePromotionSystemKeyEnum.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SalePromotionSystemKeyEnum = void 0;
+/** Promos de venta que siembra el sistema; solo se pausan, reanudan o editan su monto. */
+var SalePromotionSystemKeyEnum;
+(function (SalePromotionSystemKeyEnum) {
+    /** Bono de bienvenida por apertura de cuenta, una por retailer. */
+    SalePromotionSystemKeyEnum["WELCOME_BONUS"] = "WELCOME_BONUS";
+})(SalePromotionSystemKeyEnum || (exports.SalePromotionSystemKeyEnum = SalePromotionSystemKeyEnum = {}));

package/bin/retailPromotions/index.d.ts

@@ -19,6 +19,7 @@ export * from './enums/SaleCouponAvailabilityEnum';
 export * from './enums/RetailPromotionsErrorCodeEnum';
 export * from './enums/SalePromotionKindEnum';
 export * from './enums/SkuSalePromotionLookupStatusEnum';
+export * from './enums/SalePromotionSystemKeyEnum';
 export * from './constants/retailPromotionsErrorHttpStatus';
 export * from './constants/salePromotionTransitions';
 export * from './constants/bonusPreMoney';
@@ -60,3 +61,4 @@ export * from './dtos/responses/WizardSalePromotionResponses';
 export * from './dtos/responses/SkuSalePromotionsResponse';
 export * from './dtos/responses/SalePromotionSegmentsResponse';
 export * from './dtos/responses/ActiveSalePromotionsBySkusResponse';
+export * from './dtos/responses/WelcomeBonusPromotionResponse';

package/bin/retailPromotions/index.js

@@ -36,6 +36,7 @@ __exportStar(require("./enums/SaleCouponAvailabilityEnum"), exports);
 __exportStar(require("./enums/RetailPromotionsErrorCodeEnum"), exports);
 __exportStar(require("./enums/SalePromotionKindEnum"), exports);
 __exportStar(require("./enums/SkuSalePromotionLookupStatusEnum"), exports);
+__exportStar(require("./enums/SalePromotionSystemKeyEnum"), exports);
 // Constantes y helpers puros
 __exportStar(require("./constants/retailPromotionsErrorHttpStatus"), exports);
 __exportStar(require("./constants/salePromotionTransitions"), exports);
@@ -82,3 +83,4 @@ __exportStar(require("./dtos/responses/WizardSalePromotionResponses"), exports);
 __exportStar(require("./dtos/responses/SkuSalePromotionsResponse"), exports);
 __exportStar(require("./dtos/responses/SalePromotionSegmentsResponse"), exports);
 __exportStar(require("./dtos/responses/ActiveSalePromotionsBySkusResponse"), exports);
+__exportStar(require("./dtos/responses/WelcomeBonusPromotionResponse"), exports);

package/bin/task-manager-business/dtos/CreateTaskRequest.d.ts

@@ -0,0 +1,13 @@
+import { OwnerType } from '../enums/OwnerType';
+import { TaskType } from '../enums/TaskType';
+export declare class TaskOwnerInput {
+    type: OwnerType;
+    id: string;
+}
+/** Body de POST /v2/backoffice/tasks. `details` se valida después con el DTO del tipo de tarea. */
+export declare class CreateTaskRequest {
+    taskType: TaskType;
+    dueDate: string;
+    owner: TaskOwnerInput;
+    details: Record<string, unknown>;
+}

package/bin/task-manager-business/dtos/CreateTaskRequest.js

@@ -0,0 +1,50 @@
+"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.CreateTaskRequest = exports.TaskOwnerInput = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const OwnerType_1 = require("../enums/OwnerType");
+const TaskType_1 = require("../enums/TaskType");
+class TaskOwnerInput {
+}
+exports.TaskOwnerInput = TaskOwnerInput;
+__decorate([
+    (0, class_validator_1.IsEnum)(OwnerType_1.OwnerType),
+    __metadata("design:type", String)
+], TaskOwnerInput.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 64),
+    __metadata("design:type", String)
+], TaskOwnerInput.prototype, "id", void 0);
+/** Body de POST /v2/backoffice/tasks. `details` se valida después con el DTO del tipo de tarea. */
+class CreateTaskRequest {
+}
+exports.CreateTaskRequest = CreateTaskRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(TaskType_1.TaskType),
+    __metadata("design:type", String)
+], CreateTaskRequest.prototype, "taskType", void 0);
+__decorate([
+    (0, class_validator_1.Matches)(/^\d{4}-\d{2}-\d{2}$/, { message: 'dueDate debe tener formato YYYY-MM-DD' }),
+    (0, class_validator_1.IsDateString)({ strict: true }, { message: 'dueDate debe ser una fecha válida' }),
+    __metadata("design:type", String)
+], CreateTaskRequest.prototype, "dueDate", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => TaskOwnerInput),
+    __metadata("design:type", TaskOwnerInput)
+], CreateTaskRequest.prototype, "owner", void 0);
+__decorate([
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], CreateTaskRequest.prototype, "details", void 0);

package/bin/task-manager-business/dtos/ListTasksQuery.d.ts

@@ -0,0 +1,13 @@
+import { MaterialType } from '../enums/MaterialType';
+import { OwnerType } from '../enums/OwnerType';
+import { TaskType } from '../enums/TaskType';
+/** Query de GET /v2/backoffice/tasks. Los valores llegan como string desde API Gateway. */
+export declare class ListTasksQuery {
+    taskType: TaskType;
+    status?: string;
+    ownerType?: OwnerType;
+    ownerId?: string;
+    materialType?: MaterialType;
+    overdue?: boolean;
+    closedWithinDays?: number;
+}

package/bin/task-manager-business/dtos/ListTasksQuery.js

@@ -0,0 +1,60 @@
+"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.ListTasksQuery = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const MaterialType_1 = require("../enums/MaterialType");
+const OwnerType_1 = require("../enums/OwnerType");
+const TaskType_1 = require("../enums/TaskType");
+/** Query de GET /v2/backoffice/tasks. Los valores llegan como string desde API Gateway. */
+class ListTasksQuery {
+}
+exports.ListTasksQuery = ListTasksQuery;
+__decorate([
+    (0, class_validator_1.IsEnum)(TaskType_1.TaskType),
+    __metadata("design:type", String)
+], ListTasksQuery.prototype, "taskType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.Matches)(/^[A-Z_]{1,32}$/),
+    __metadata("design:type", String)
+], ListTasksQuery.prototype, "status", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(OwnerType_1.OwnerType),
+    __metadata("design:type", String)
+], ListTasksQuery.prototype, "ownerType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Length)(1, 64),
+    __metadata("design:type", String)
+], ListTasksQuery.prototype, "ownerId", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsEnum)(MaterialType_1.MaterialType),
+    __metadata("design:type", String)
+], ListTasksQuery.prototype, "materialType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Transform)(({ value }) => (value === 'true' ? true : value === 'false' ? false : value)),
+    (0, class_validator_1.IsBoolean)(),
+    __metadata("design:type", Boolean)
+], ListTasksQuery.prototype, "overdue", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_transformer_1.Type)(() => Number),
+    (0, class_validator_1.IsInt)(),
+    (0, class_validator_1.Min)(1),
+    (0, class_validator_1.Max)(365),
+    __metadata("design:type", Number)
+], ListTasksQuery.prototype, "closedWithinDays", void 0);

package/bin/task-manager-business/dtos/MarketingMaterialDetails.d.ts

@@ -0,0 +1,6 @@
+import { MaterialType } from '../enums/MaterialType';
+/** `details` de una tarea MARKETING_MATERIAL. */
+export declare class MarketingMaterialDetails {
+    materialType: MaterialType;
+    description?: string;
+}

package/bin/task-manager-business/dtos/MarketingMaterialDetails.js

@@ -0,0 +1,28 @@
+"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.MarketingMaterialDetails = void 0;
+const class_validator_1 = require("class-validator");
+const MaterialType_1 = require("../enums/MaterialType");
+/** `details` de una tarea MARKETING_MATERIAL. */
+class MarketingMaterialDetails {
+}
+exports.MarketingMaterialDetails = MarketingMaterialDetails;
+__decorate([
+    (0, class_validator_1.IsEnum)(MaterialType_1.MaterialType),
+    __metadata("design:type", String)
+], MarketingMaterialDetails.prototype, "materialType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(2000),
+    __metadata("design:type", String)
+], MarketingMaterialDetails.prototype, "description", void 0);

package/bin/task-manager-business/dtos/TaskResponse.d.ts

@@ -0,0 +1,27 @@
+import { OwnerType } from '../enums/OwnerType';
+import { TaskType } from '../enums/TaskType';
+export interface TaskOwnerResponse {
+    type: OwnerType;
+    /** directoryId */
+    id: string;
+    displayName: string;
+}
+/** Tarea tal como la devuelve task-manager-business. `overdue` se calcula al leer. */
+export interface TaskResponse {
+    taskId: string;
+    taskType: TaskType;
+    title: string;
+    status: string;
+    /** YYYY-MM-DD */
+    dueDate: string;
+    owner: TaskOwnerResponse;
+    details: Record<string, unknown>;
+    createdBy: string;
+    /** ISO 8601 */
+    createdAt: string;
+    /** ISO 8601 */
+    updatedAt: string;
+    /** ISO 8601. Solo presente en estados finales. */
+    closedAt?: string;
+    overdue: boolean;
+}

package/bin/task-manager-business/dtos/TaskResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/task-manager-business/dtos/TaskTransitionResponse.d.ts

@@ -0,0 +1,11 @@
+/** Un cambio de estado del historial. `from` es null en la creación. */
+export interface TaskTransitionResponse {
+    from: string | null;
+    to: string;
+    /** ISO 8601 */
+    at: string;
+    by: string;
+    reason?: string;
+    /** false si la transición se registró pero la tarea no llegó a moverse (intento incompleto). */
+    complete: boolean;
+}

package/bin/task-manager-business/dtos/TaskTransitionResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/task-manager-business/dtos/TaskTypeDefinitionResponse.d.ts

@@ -0,0 +1,12 @@
+import { OwnerType } from '../enums/OwnerType';
+import { TaskType } from '../enums/TaskType';
+/** Definición de un tipo de tarea, para que el backoffice pinte estados y botones. */
+export interface TaskTypeDefinitionResponse {
+    taskType: TaskType;
+    ownerType: OwnerType;
+    statuses: string[];
+    initialStatus: string;
+    finalStatuses: string[];
+    transitions: Record<string, string[]>;
+    reasonRequiredFor: string[];
+}

package/bin/task-manager-business/dtos/TaskTypeDefinitionResponse.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/bin/task-manager-business/dtos/TaskTypeQuery.d.ts

@@ -0,0 +1,5 @@
+import { TaskType } from '../enums/TaskType';
+/** Query `?taskType=` de las rutas por id (detalle e historial). */
+export declare class TaskTypeQuery {
+    taskType: TaskType;
+}

package/bin/task-manager-business/dtos/TaskTypeQuery.js

@@ -0,0 +1,22 @@
+"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.TaskTypeQuery = void 0;
+const class_validator_1 = require("class-validator");
+const TaskType_1 = require("../enums/TaskType");
+/** Query `?taskType=` de las rutas por id (detalle e historial). */
+class TaskTypeQuery {
+}
+exports.TaskTypeQuery = TaskTypeQuery;
+__decorate([
+    (0, class_validator_1.IsEnum)(TaskType_1.TaskType),
+    __metadata("design:type", String)
+], TaskTypeQuery.prototype, "taskType", void 0);

package/bin/task-manager-business/dtos/TransitionTaskRequest.d.ts

@@ -0,0 +1,8 @@
+import { TaskType } from '../enums/TaskType';
+/** Body de POST /v2/backoffice/tasks/{taskId}/transitions. `from` = estado que el usuario estaba viendo. */
+export declare class TransitionTaskRequest {
+    taskType: TaskType;
+    from: string;
+    to: string;
+    reason?: string;
+}

package/bin/task-manager-business/dtos/TransitionTaskRequest.js

@@ -0,0 +1,36 @@
+"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.TransitionTaskRequest = void 0;
+const class_validator_1 = require("class-validator");
+const TaskType_1 = require("../enums/TaskType");
+/** Body de POST /v2/backoffice/tasks/{taskId}/transitions. `from` = estado que el usuario estaba viendo. */
+class TransitionTaskRequest {
+}
+exports.TransitionTaskRequest = TransitionTaskRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(TaskType_1.TaskType),
+    __metadata("design:type", String)
+], TransitionTaskRequest.prototype, "taskType", void 0);
+__decorate([
+    (0, class_validator_1.Matches)(/^[A-Z_]{1,32}$/),
+    __metadata("design:type", String)
+], TransitionTaskRequest.prototype, "from", void 0);
+__decorate([
+    (0, class_validator_1.Matches)(/^[A-Z_]{1,32}$/),
+    __metadata("design:type", String)
+], TransitionTaskRequest.prototype, "to", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(500),
+    __metadata("design:type", String)
+], TransitionTaskRequest.prototype, "reason", void 0);

package/bin/task-manager-business/enums/MarketingMaterialStatus.d.ts

@@ -0,0 +1,9 @@
+/** Estados del flujo MARKETING_MATERIAL. ARRIVED y CANCELLED son finales. */
+export declare enum MarketingMaterialStatus {
+    PROMISED = "PROMISED",
+    DESIGN = "DESIGN",
+    IN_PRODUCTION = "IN_PRODUCTION",
+    SHIPPED = "SHIPPED",
+    ARRIVED = "ARRIVED",
+    CANCELLED = "CANCELLED"
+}

package/bin/task-manager-business/enums/MarketingMaterialStatus.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MarketingMaterialStatus = void 0;
+/** Estados del flujo MARKETING_MATERIAL. ARRIVED y CANCELLED son finales. */
+var MarketingMaterialStatus;
+(function (MarketingMaterialStatus) {
+    MarketingMaterialStatus["PROMISED"] = "PROMISED";
+    MarketingMaterialStatus["DESIGN"] = "DESIGN";
+    MarketingMaterialStatus["IN_PRODUCTION"] = "IN_PRODUCTION";
+    MarketingMaterialStatus["SHIPPED"] = "SHIPPED";
+    MarketingMaterialStatus["ARRIVED"] = "ARRIVED";
+    MarketingMaterialStatus["CANCELLED"] = "CANCELLED";
+})(MarketingMaterialStatus || (exports.MarketingMaterialStatus = MarketingMaterialStatus = {}));

package/bin/task-manager-business/enums/MaterialType.d.ts

@@ -0,0 +1,7 @@
+/** Materiales de marketing que se prometen a un promotor. OTHER + descripción cubre lo no listado. */
+export declare enum MaterialType {
+    PLASTIC_CARD = "PLASTIC_CARD",
+    REEL = "REEL",
+    DIGITAL_AD = "DIGITAL_AD",
+    OTHER = "OTHER"
+}

package/bin/task-manager-business/enums/MaterialType.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaterialType = void 0;
+/** Materiales de marketing que se prometen a un promotor. OTHER + descripción cubre lo no listado. */
+var MaterialType;
+(function (MaterialType) {
+    MaterialType["PLASTIC_CARD"] = "PLASTIC_CARD";
+    MaterialType["REEL"] = "REEL";
+    MaterialType["DIGITAL_AD"] = "DIGITAL_AD";
+    MaterialType["OTHER"] = "OTHER";
+})(MaterialType || (exports.MaterialType = MaterialType = {}));

package/bin/task-manager-business/enums/OwnerType.d.ts

@@ -0,0 +1,4 @@
+/** Para quién es la tarea. El id del dueño es su directoryId. */
+export declare enum OwnerType {
+    PROMOTER = "PROMOTER"
+}

package/bin/task-manager-business/enums/OwnerType.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OwnerType = void 0;
+/** Para quién es la tarea. El id del dueño es su directoryId. */
+var OwnerType;
+(function (OwnerType) {
+    OwnerType["PROMOTER"] = "PROMOTER";
+})(OwnerType || (exports.OwnerType = OwnerType = {}));

package/bin/task-manager-business/enums/TaskType.d.ts

@@ -0,0 +1,4 @@
+/** Tipos de tarea de task-manager-business. Cada uno tiene su TaskTypeDefinition en el lambda. */
+export declare enum TaskType {
+    MARKETING_MATERIAL = "MARKETING_MATERIAL"
+}

package/bin/task-manager-business/enums/TaskType.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskType = void 0;
+/** Tipos de tarea de task-manager-business. Cada uno tiene su TaskTypeDefinition en el lambda. */
+var TaskType;
+(function (TaskType) {
+    TaskType["MARKETING_MATERIAL"] = "MARKETING_MATERIAL";
+})(TaskType || (exports.TaskType = TaskType = {}));

package/bin/task-manager-business/index.d.ts

@@ -0,0 +1,12 @@
+export * from './enums/TaskType';
+export * from './enums/OwnerType';
+export * from './enums/MaterialType';
+export * from './enums/MarketingMaterialStatus';
+export * from './dtos/CreateTaskRequest';
+export * from './dtos/TransitionTaskRequest';
+export * from './dtos/ListTasksQuery';
+export * from './dtos/TaskTypeQuery';
+export * from './dtos/MarketingMaterialDetails';
+export * from './dtos/TaskResponse';
+export * from './dtos/TaskTransitionResponse';
+export * from './dtos/TaskTypeDefinitionResponse';

package/bin/task-manager-business/index.js

@@ -0,0 +1,30 @@
+"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 });
+//enums
+__exportStar(require("./enums/TaskType"), exports);
+__exportStar(require("./enums/OwnerType"), exports);
+__exportStar(require("./enums/MaterialType"), exports);
+__exportStar(require("./enums/MarketingMaterialStatus"), exports);
+//dtos
+__exportStar(require("./dtos/CreateTaskRequest"), exports);
+__exportStar(require("./dtos/TransitionTaskRequest"), exports);
+__exportStar(require("./dtos/ListTasksQuery"), exports);
+__exportStar(require("./dtos/TaskTypeQuery"), exports);
+__exportStar(require("./dtos/MarketingMaterialDetails"), exports);
+__exportStar(require("./dtos/TaskResponse"), exports);
+__exportStar(require("./dtos/TaskTransitionResponse"), exports);
+__exportStar(require("./dtos/TaskTypeDefinitionResponse"), exports);

package/package.json

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

package/src/index.ts

@@ -221,3 +221,6 @@ export * as Rules from './rules';
 // LoanRetailAudit: contrato del lambda central loan-retail-audit-business (bitácora y accesos a PII
 // de Loan y Retail): mensaje de su cola, POST /private/pii-access-logs y GET /private/audit-trail.
 export * as LoanRetailAudit from './loanRetailAudit';
+
+// TaskManager: DTOs del lambda task-manager-business (gestor genérico de tareas; primer tipo MARKETING_MATERIAL).
+export * as TaskManager from './task-manager-business';

package/src/retailCustomer/enums/WelcomeBonusAmountSourceEnum.ts

@@ -9,4 +9,6 @@ export enum WelcomeBonusAmountSourceEnum {
     PARAM = 'PARAM',
     /** Default local del wizard, usado porque `loan-config` no respondió. */
     DEFAULT = 'DEFAULT',
+    /** Monto de la promo de venta de sistema `WELCOME_BONUS` del retailer. */
+    SALE_PROMOTION = 'SALE_PROMOTION',
 }

package/src/retailPromotions/constants/retailPromotionsErrorHttpStatus.ts

@@ -34,4 +34,6 @@ export const RETAIL_PROMOTIONS_ERROR_HTTP_STATUS: Readonly<Record<C, 400 | 403 |
     [C.SPLIT_FINANCING_DISABLED]: 409,
     [C.PROMOTION_NOT_STACKABLE]: 422,
     [C.PROMOTION_PAYMENT_NOT_ELIGIBLE]: 422,
+    [C.SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED]: 422,
+    [C.SYSTEM_PROMOTION_FIELD_LOCKED]: 422,
 };

package/src/retailPromotions/dtos/SalePromotion.ts

@@ -2,12 +2,15 @@ import { PromotionAppliesToEnum } from '../enums/PromotionAppliesToEnum';
 import { PromotionPaymentOptionEnum } from '../enums/PromotionPaymentOptionEnum';
 import { SalePromotionPhaseEnum } from '../enums/SalePromotionPhaseEnum';
 import { SalePromotionStatusEnum } from '../enums/SalePromotionStatusEnum';
+import { SalePromotionSystemKeyEnum } from '../enums/SalePromotionSystemKeyEnum';
 import { SalePromotionLevers, SalePromotionScope, SalePromotionSegmentation } from './SalePromotionLevers';
 
 /** Promo de venta tal como la devuelve el CRUD. Dinero en centavos, fechas ISO. */
 export interface SalePromotion {
     promotionId: string;
     retailerId: string;
+    /** Presente solo en promos sembradas por el sistema; ausente en las del admin. */
+    systemKey?: SalePromotionSystemKeyEnum;
     name: string;
     /** Texto que ve el cliente en el wizard. */
     customerText: string;

package/src/retailPromotions/dtos/responses/WelcomeBonusPromotionResponse.ts

@@ -0,0 +1,6 @@
+/** Respuesta de `GET /private/retailers/{retailerId}/welcome-bonus`; `active` = promo en `ACTIVE`. */
+export interface WelcomeBonusPromotionResponse {
+    promotionId: string;
+    active: boolean;
+    amountCents: number;
+}

package/src/retailPromotions/enums/RetailPromotionsErrorCodeEnum.ts

@@ -49,4 +49,8 @@ export enum RetailPromotionsErrorCodeEnum {
     PROMOTION_NOT_STACKABLE = 'PROMOTION_NOT_STACKABLE',
     /** La promo no acepta la forma de pago o el medio de cobro de la venta. */
     PROMOTION_PAYMENT_NOT_ELIGIBLE = 'PROMOTION_PAYMENT_NOT_ELIGIBLE',
+    /** La promo de sistema solo admite pausar y reanudar. */
+    SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED = 'SYSTEM_PROMOTION_TRANSITION_NOT_ALLOWED',
+    /** De la promo de sistema solo se edita el monto del bono. */
+    SYSTEM_PROMOTION_FIELD_LOCKED = 'SYSTEM_PROMOTION_FIELD_LOCKED',
 }

package/src/retailPromotions/enums/SalePromotionSystemKeyEnum.ts

@@ -0,0 +1,5 @@
+/** Promos de venta que siembra el sistema; solo se pausan, reanudan o editan su monto. */
+export enum SalePromotionSystemKeyEnum {
+    /** Bono de bienvenida por apertura de cuenta, una por retailer. */
+    WELCOME_BONUS = 'WELCOME_BONUS',
+}

package/src/retailPromotions/index.ts

@@ -20,6 +20,7 @@ export * from './enums/SaleCouponAvailabilityEnum';
 export * from './enums/RetailPromotionsErrorCodeEnum';
 export * from './enums/SalePromotionKindEnum';
 export * from './enums/SkuSalePromotionLookupStatusEnum';
+export * from './enums/SalePromotionSystemKeyEnum';
 
 // Constantes y helpers puros
 export * from './constants/retailPromotionsErrorHttpStatus';
@@ -71,3 +72,4 @@ export * from './dtos/responses/WizardSalePromotionResponses';
 export * from './dtos/responses/SkuSalePromotionsResponse';
 export * from './dtos/responses/SalePromotionSegmentsResponse';
 export * from './dtos/responses/ActiveSalePromotionsBySkusResponse';
+export * from './dtos/responses/WelcomeBonusPromotionResponse';

package/src/task-manager-business/dtos/CreateTaskRequest.ts

@@ -0,0 +1,30 @@
+import { Type } from 'class-transformer';
+import { IsDateString, IsEnum, IsObject, IsString, Length, Matches, ValidateNested } from 'class-validator';
+import { OwnerType } from '../enums/OwnerType';
+import { TaskType } from '../enums/TaskType';
+
+export class TaskOwnerInput {
+    @IsEnum(OwnerType)
+    type: OwnerType;
+
+    @IsString()
+    @Length(1, 64)
+    id: string;
+}
+
+/** Body de POST /v2/backoffice/tasks. `details` se valida después con el DTO del tipo de tarea. */
+export class CreateTaskRequest {
+    @IsEnum(TaskType)
+    taskType: TaskType;
+
+    @Matches(/^\d{4}-\d{2}-\d{2}$/, { message: 'dueDate debe tener formato YYYY-MM-DD' })
+    @IsDateString({ strict: true }, { message: 'dueDate debe ser una fecha válida' })
+    dueDate: string;
+
+    @ValidateNested()
+    @Type(() => TaskOwnerInput)
+    owner: TaskOwnerInput;
+
+    @IsObject()
+    details: Record<string, unknown>;
+}

package/src/task-manager-business/dtos/ListTasksQuery.ts

@@ -0,0 +1,40 @@
+import { Transform, Type } from 'class-transformer';
+import { IsBoolean, IsEnum, IsInt, IsOptional, IsString, Length, Matches, Max, Min } from 'class-validator';
+import { MaterialType } from '../enums/MaterialType';
+import { OwnerType } from '../enums/OwnerType';
+import { TaskType } from '../enums/TaskType';
+
+/** Query de GET /v2/backoffice/tasks. Los valores llegan como string desde API Gateway. */
+export class ListTasksQuery {
+    @IsEnum(TaskType)
+    taskType: TaskType;
+
+    @IsOptional()
+    @Matches(/^[A-Z_]{1,32}$/)
+    status?: string;
+
+    @IsOptional()
+    @IsEnum(OwnerType)
+    ownerType?: OwnerType;
+
+    @IsOptional()
+    @IsString()
+    @Length(1, 64)
+    ownerId?: string;
+
+    @IsOptional()
+    @IsEnum(MaterialType)
+    materialType?: MaterialType;
+
+    @IsOptional()
+    @Transform(({ value }) => (value === 'true' ? true : value === 'false' ? false : value))
+    @IsBoolean()
+    overdue?: boolean;
+
+    @IsOptional()
+    @Type(() => Number)
+    @IsInt()
+    @Min(1)
+    @Max(365)
+    closedWithinDays?: number;
+}

package/src/task-manager-business/dtos/MarketingMaterialDetails.ts

@@ -0,0 +1,13 @@
+import { IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
+import { MaterialType } from '../enums/MaterialType';
+
+/** `details` de una tarea MARKETING_MATERIAL. */
+export class MarketingMaterialDetails {
+    @IsEnum(MaterialType)
+    materialType: MaterialType;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(2000)
+    description?: string;
+}

package/src/task-manager-business/dtos/TaskResponse.ts

@@ -0,0 +1,29 @@
+import { OwnerType } from '../enums/OwnerType';
+import { TaskType } from '../enums/TaskType';
+
+export interface TaskOwnerResponse {
+    type: OwnerType;
+    /** directoryId */
+    id: string;
+    displayName: string;
+}
+
+/** Tarea tal como la devuelve task-manager-business. `overdue` se calcula al leer. */
+export interface TaskResponse {
+    taskId: string;
+    taskType: TaskType;
+    title: string;
+    status: string;
+    /** YYYY-MM-DD */
+    dueDate: string;
+    owner: TaskOwnerResponse;
+    details: Record<string, unknown>;
+    createdBy: string;
+    /** ISO 8601 */
+    createdAt: string;
+    /** ISO 8601 */
+    updatedAt: string;
+    /** ISO 8601. Solo presente en estados finales. */
+    closedAt?: string;
+    overdue: boolean;
+}

package/src/task-manager-business/dtos/TaskTransitionResponse.ts

@@ -0,0 +1,11 @@
+/** Un cambio de estado del historial. `from` es null en la creación. */
+export interface TaskTransitionResponse {
+    from: string | null;
+    to: string;
+    /** ISO 8601 */
+    at: string;
+    by: string;
+    reason?: string;
+    /** false si la transición se registró pero la tarea no llegó a moverse (intento incompleto). */
+    complete: boolean;
+}

package/src/task-manager-business/dtos/TaskTypeDefinitionResponse.ts

@@ -0,0 +1,13 @@
+import { OwnerType } from '../enums/OwnerType';
+import { TaskType } from '../enums/TaskType';
+
+/** Definición de un tipo de tarea, para que el backoffice pinte estados y botones. */
+export interface TaskTypeDefinitionResponse {
+    taskType: TaskType;
+    ownerType: OwnerType;
+    statuses: string[];
+    initialStatus: string;
+    finalStatuses: string[];
+    transitions: Record<string, string[]>;
+    reasonRequiredFor: string[];
+}

package/src/task-manager-business/dtos/TaskTypeQuery.ts

@@ -0,0 +1,8 @@
+import { IsEnum } from 'class-validator';
+import { TaskType } from '../enums/TaskType';
+
+/** Query `?taskType=` de las rutas por id (detalle e historial). */
+export class TaskTypeQuery {
+    @IsEnum(TaskType)
+    taskType: TaskType;
+}

package/src/task-manager-business/dtos/TransitionTaskRequest.ts

@@ -0,0 +1,19 @@
+import { IsEnum, IsOptional, IsString, Matches, MaxLength } from 'class-validator';
+import { TaskType } from '../enums/TaskType';
+
+/** Body de POST /v2/backoffice/tasks/{taskId}/transitions. `from` = estado que el usuario estaba viendo. */
+export class TransitionTaskRequest {
+    @IsEnum(TaskType)
+    taskType: TaskType;
+
+    @Matches(/^[A-Z_]{1,32}$/)
+    from: string;
+
+    @Matches(/^[A-Z_]{1,32}$/)
+    to: string;
+
+    @IsOptional()
+    @IsString()
+    @MaxLength(500)
+    reason?: string;
+}

package/src/task-manager-business/enums/MarketingMaterialStatus.ts

@@ -0,0 +1,9 @@
+/** Estados del flujo MARKETING_MATERIAL. ARRIVED y CANCELLED son finales. */
+export enum MarketingMaterialStatus {
+    PROMISED = 'PROMISED',
+    DESIGN = 'DESIGN',
+    IN_PRODUCTION = 'IN_PRODUCTION',
+    SHIPPED = 'SHIPPED',
+    ARRIVED = 'ARRIVED',
+    CANCELLED = 'CANCELLED',
+}

package/src/task-manager-business/enums/MaterialType.ts

@@ -0,0 +1,7 @@
+/** Materiales de marketing que se prometen a un promotor. OTHER + descripción cubre lo no listado. */
+export enum MaterialType {
+    PLASTIC_CARD = 'PLASTIC_CARD',
+    REEL = 'REEL',
+    DIGITAL_AD = 'DIGITAL_AD',
+    OTHER = 'OTHER',
+}

package/src/task-manager-business/enums/OwnerType.ts

@@ -0,0 +1,4 @@
+/** Para quién es la tarea. El id del dueño es su directoryId. */
+export enum OwnerType {
+    PROMOTER = 'PROMOTER',
+}

package/src/task-manager-business/enums/TaskType.ts

@@ -0,0 +1,4 @@
+/** Tipos de tarea de task-manager-business. Cada uno tiene su TaskTypeDefinition en el lambda. */
+export enum TaskType {
+    MARKETING_MATERIAL = 'MARKETING_MATERIAL',
+}

package/src/task-manager-business/index.ts

@@ -0,0 +1,14 @@
+//enums
+export * from './enums/TaskType';
+export * from './enums/OwnerType';
+export * from './enums/MaterialType';
+export * from './enums/MarketingMaterialStatus';
+//dtos
+export * from './dtos/CreateTaskRequest';
+export * from './dtos/TransitionTaskRequest';
+export * from './dtos/ListTasksQuery';
+export * from './dtos/TaskTypeQuery';
+export * from './dtos/MarketingMaterialDetails';
+export * from './dtos/TaskResponse';
+export * from './dtos/TaskTransitionResponse';
+export * from './dtos/TaskTypeDefinitionResponse';