@fiado/type-kit 3.562.0 → 3.563.0

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/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.563.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/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';