@fiado/type-kit 3.587.0 → 3.589.0

package/_test_/unit/retailIntegration/reconciliationContracts.test.ts

@@ -118,6 +118,22 @@ describe('respuestas de la revisión', () => {
     expect(org.counts.seen).toBe(10);
     expect(catalog.storesPending).toBe(0);
   });
+
+  it('GetCatalogReconciliationResponse admite MOVEMENTS con su ventana', () => {
+    const movements: GetCatalogReconciliationResponse = {
+      runId: 'run-m',
+      retailerId: 'r-1',
+      entity: ReconciliationEntityEnum.MOVEMENTS,
+      status: ReconciliationRunStatusEnum.RUNNING,
+      trigger: ReconciliationTriggerEnum.DAILY,
+      startedAt: '2026-10-25T10:00:00.000Z',
+      pagesProcessed: 1,
+      movementsFrom: '2026-10-24T00:00:00.000Z',
+      movementsTo: '2026-10-25T00:00:00.000Z',
+      counts: { seen: 0, created: 0, updated: 0, deactivated: 0, reactivated: 0, skipped: 0 },
+    };
+    expect(movements.movementsTo).toBe('2026-10-25T00:00:00.000Z');
+  });
 });
 
 describe('revisión con excludeExtraneousValues', () => {

package/bin/retailIntegration/dtos/GetReconciliationResponses.d.ts

@@ -20,7 +20,7 @@ export interface GetOrgReconciliationResponse {
 export interface GetCatalogReconciliationResponse {
     runId: string;
     retailerId: string;
-    entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY;
+    entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY | ReconciliationEntityEnum.MOVEMENTS;
     status: ReconciliationRunStatusEnum;
     trigger: ReconciliationTriggerEnum;
     triggeredBy?: string;
@@ -31,5 +31,9 @@ export interface GetCatalogReconciliationResponse {
     storeId?: string;
     /** Tiendas de inventario que faltan por cerrar. */
     storesPending?: number;
+    /** Inicio ISO de la ventana revisada en movimientos. */
+    movementsFrom?: string;
+    /** Fin ISO de la ventana revisada en movimientos. */
+    movementsTo?: string;
     counts: ReconciliationRunCounts;
 }

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

@@ -1,4 +1,3 @@
-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. */
@@ -7,7 +6,8 @@ export declare class ListTasksQuery {
     status?: string;
     ownerType?: OwnerType;
     ownerId?: string;
-    materialType?: MaterialType;
+    /** Clave del catálogo AppSelection (`TaskManagerMaterialType`). */
+    materialType?: string;
     overdue?: boolean;
     closedWithinDays?: number;
 }

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

@@ -12,7 +12,7 @@ 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 MarketingMaterialDetails_1 = require("./MarketingMaterialDetails");
 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. */
@@ -41,7 +41,7 @@ __decorate([
 ], ListTasksQuery.prototype, "ownerId", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
-    (0, class_validator_1.IsEnum)(MaterialType_1.MaterialType),
+    (0, class_validator_1.Matches)(MarketingMaterialDetails_1.MATERIAL_TYPE_PATTERN),
     __metadata("design:type", String)
 ], ListTasksQuery.prototype, "materialType", void 0);
 __decorate([

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

@@ -1,6 +1,12 @@
-import { MaterialType } from '../enums/MaterialType';
-/** `details` de una tarea MARKETING_MATERIAL. */
+/** Clave de un tipo de material: el `value` del catálogo AppSelection (`TaskManagerMaterialType`), p. ej. `PLASTIC_CARD`. */
+export declare const MATERIAL_TYPE_PATTERN: RegExp;
+/**
+ * `details` de una tarea MARKETING_MATERIAL. El tipo sale del catálogo AppSelection (`TaskManagerMaterialType`), así que
+ * se pueden agregar tipos sin tocar código; `MaterialType` queda sólo con los cuatro de origen.
+ */
 export declare class MarketingMaterialDetails {
-    materialType: MaterialType;
+    materialType: string;
+    /** Nombre del tipo tal cual se ve en el catálogo (displayName). Es el que se manda a Asana. */
+    materialTypeLabel?: string;
     description?: string;
 }

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

@@ -9,17 +9,28 @@ 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;
+exports.MarketingMaterialDetails = exports.MATERIAL_TYPE_PATTERN = void 0;
 const class_validator_1 = require("class-validator");
-const MaterialType_1 = require("../enums/MaterialType");
-/** `details` de una tarea MARKETING_MATERIAL. */
+/** Clave de un tipo de material: el `value` del catálogo AppSelection (`TaskManagerMaterialType`), p. ej. `PLASTIC_CARD`. */
+exports.MATERIAL_TYPE_PATTERN = /^[A-Z0-9_]{1,40}$/;
+/**
+ * `details` de una tarea MARKETING_MATERIAL. El tipo sale del catálogo AppSelection (`TaskManagerMaterialType`), así que
+ * se pueden agregar tipos sin tocar código; `MaterialType` queda sólo con los cuatro de origen.
+ */
 class MarketingMaterialDetails {
 }
 exports.MarketingMaterialDetails = MarketingMaterialDetails;
 __decorate([
-    (0, class_validator_1.IsEnum)(MaterialType_1.MaterialType),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.Matches)(exports.MATERIAL_TYPE_PATTERN, { message: 'materialType: clave del catálogo en mayúsculas (A-Z, 0-9, _)' }),
     __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)(80),
+    __metadata("design:type", String)
+], MarketingMaterialDetails.prototype, "materialTypeLabel", void 0);
 __decorate([
     (0, class_validator_1.IsOptional)(),
     (0, class_validator_1.IsString)(),

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

@@ -0,0 +1,12 @@
+import { TaskType } from '../enums/TaskType';
+import { TaskOwnerInput } from './CreateTaskRequest';
+/**
+ * Body de PUT /v2/backoffice/tasks/{taskId}: cambia los datos de una tarea ya creada. Lo que no viene se queda igual.
+ * El estado no se cambia aquí (va por transitions). `details`, si viene, es completo y se valida con el DTO del tipo.
+ */
+export declare class UpdateTaskRequest {
+    taskType: TaskType;
+    dueDate?: string;
+    owner?: TaskOwnerInput;
+    details?: Record<string, unknown>;
+}

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

@@ -0,0 +1,44 @@
+"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.UpdateTaskRequest = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const TaskType_1 = require("../enums/TaskType");
+const CreateTaskRequest_1 = require("./CreateTaskRequest");
+/**
+ * Body de PUT /v2/backoffice/tasks/{taskId}: cambia los datos de una tarea ya creada. Lo que no viene se queda igual.
+ * El estado no se cambia aquí (va por transitions). `details`, si viene, es completo y se valida con el DTO del tipo.
+ */
+class UpdateTaskRequest {
+}
+exports.UpdateTaskRequest = UpdateTaskRequest;
+__decorate([
+    (0, class_validator_1.IsEnum)(TaskType_1.TaskType),
+    __metadata("design:type", String)
+], UpdateTaskRequest.prototype, "taskType", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (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)
+], UpdateTaskRequest.prototype, "dueDate", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => CreateTaskRequest_1.TaskOwnerInput),
+    __metadata("design:type", CreateTaskRequest_1.TaskOwnerInput)
+], UpdateTaskRequest.prototype, "owner", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsObject)(),
+    __metadata("design:type", Object)
+], UpdateTaskRequest.prototype, "details", void 0);

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

@@ -1,4 +1,8 @@
-/** Materiales de marketing que se prometen a un promotor. OTHER + descripción cubre lo no listado. */
+/**
+ * Los cuatro tipos de material de origen. Desde la versión con catálogo, los tipos viven en AppSelection
+ * (`TaskManagerMaterialType`) y `MarketingMaterialDetails.materialType` es la clave del catálogo; este enum queda para
+ * los valores iniciales y compatibilidad.
+ */
 export declare enum MaterialType {
     PLASTIC_CARD = "PLASTIC_CARD",
     REEL = "REEL",

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

@@ -1,7 +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. */
+/**
+ * Los cuatro tipos de material de origen. Desde la versión con catálogo, los tipos viven en AppSelection
+ * (`TaskManagerMaterialType`) y `MarketingMaterialDetails.materialType` es la clave del catálogo; este enum queda para
+ * los valores iniciales y compatibilidad.
+ */
 var MaterialType;
 (function (MaterialType) {
     MaterialType["PLASTIC_CARD"] = "PLASTIC_CARD";

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

@@ -3,6 +3,7 @@ export * from './enums/OwnerType';
 export * from './enums/MaterialType';
 export * from './enums/MarketingMaterialStatus';
 export * from './dtos/CreateTaskRequest';
+export * from './dtos/UpdateTaskRequest';
 export * from './dtos/TransitionTaskRequest';
 export * from './dtos/ListTasksQuery';
 export * from './dtos/TaskTypeQuery';

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

@@ -21,6 +21,7 @@ __exportStar(require("./enums/MaterialType"), exports);
 __exportStar(require("./enums/MarketingMaterialStatus"), exports);
 //dtos
 __exportStar(require("./dtos/CreateTaskRequest"), exports);
+__exportStar(require("./dtos/UpdateTaskRequest"), exports);
 __exportStar(require("./dtos/TransitionTaskRequest"), exports);
 __exportStar(require("./dtos/ListTasksQuery"), exports);
 __exportStar(require("./dtos/TaskTypeQuery"), exports);

package/package.json

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

package/src/retailIntegration/dtos/GetReconciliationResponses.ts

@@ -22,7 +22,7 @@ export interface GetOrgReconciliationResponse {
 export interface GetCatalogReconciliationResponse {
     runId: string;
     retailerId: string;
-    entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY;
+    entity: ReconciliationEntityEnum.CATALOG | ReconciliationEntityEnum.INVENTORY | ReconciliationEntityEnum.MOVEMENTS;
     status: ReconciliationRunStatusEnum;
     trigger: ReconciliationTriggerEnum;
     triggeredBy?: string;
@@ -33,5 +33,9 @@ export interface GetCatalogReconciliationResponse {
     storeId?: string;
     /** Tiendas de inventario que faltan por cerrar. */
     storesPending?: number;
+    /** Inicio ISO de la ventana revisada en movimientos. */
+    movementsFrom?: string;
+    /** Fin ISO de la ventana revisada en movimientos. */
+    movementsTo?: string;
     counts: ReconciliationRunCounts;
 }

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

@@ -1,6 +1,6 @@
 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 { MATERIAL_TYPE_PATTERN } from './MarketingMaterialDetails';
 import { OwnerType } from '../enums/OwnerType';
 import { TaskType } from '../enums/TaskType';
 
@@ -22,9 +22,10 @@ export class ListTasksQuery {
     @Length(1, 64)
     ownerId?: string;
 
+    /** Clave del catálogo AppSelection (`TaskManagerMaterialType`). */
     @IsOptional()
-    @IsEnum(MaterialType)
-    materialType?: MaterialType;
+    @Matches(MATERIAL_TYPE_PATTERN)
+    materialType?: string;
 
     @IsOptional()
     @Transform(({ value }) => (value === 'true' ? true : value === 'false' ? false : value))

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

@@ -1,10 +1,22 @@
-import { IsEnum, IsOptional, IsString, MaxLength } from 'class-validator';
-import { MaterialType } from '../enums/MaterialType';
+import { IsOptional, IsString, Matches, MaxLength } from 'class-validator';
 
-/** `details` de una tarea MARKETING_MATERIAL. */
+/** Clave de un tipo de material: el `value` del catálogo AppSelection (`TaskManagerMaterialType`), p. ej. `PLASTIC_CARD`. */
+export const MATERIAL_TYPE_PATTERN = /^[A-Z0-9_]{1,40}$/;
+
+/**
+ * `details` de una tarea MARKETING_MATERIAL. El tipo sale del catálogo AppSelection (`TaskManagerMaterialType`), así que
+ * se pueden agregar tipos sin tocar código; `MaterialType` queda sólo con los cuatro de origen.
+ */
 export class MarketingMaterialDetails {
-    @IsEnum(MaterialType)
-    materialType: MaterialType;
+    @IsString()
+    @Matches(MATERIAL_TYPE_PATTERN, { message: 'materialType: clave del catálogo en mayúsculas (A-Z, 0-9, _)' })
+    materialType: string;
+
+    /** Nombre del tipo tal cual se ve en el catálogo (displayName). Es el que se manda a Asana. */
+    @IsOptional()
+    @IsString()
+    @MaxLength(80)
+    materialTypeLabel?: string;
 
     @IsOptional()
     @IsString()

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

@@ -0,0 +1,27 @@
+import { Type } from 'class-transformer';
+import { IsDateString, IsEnum, IsObject, IsOptional, Matches, ValidateNested } from 'class-validator';
+import { TaskType } from '../enums/TaskType';
+import { TaskOwnerInput } from './CreateTaskRequest';
+
+/**
+ * Body de PUT /v2/backoffice/tasks/{taskId}: cambia los datos de una tarea ya creada. Lo que no viene se queda igual.
+ * El estado no se cambia aquí (va por transitions). `details`, si viene, es completo y se valida con el DTO del tipo.
+ */
+export class UpdateTaskRequest {
+    @IsEnum(TaskType)
+    taskType: TaskType;
+
+    @IsOptional()
+    @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;
+
+    @IsOptional()
+    @ValidateNested()
+    @Type(() => TaskOwnerInput)
+    owner?: TaskOwnerInput;
+
+    @IsOptional()
+    @IsObject()
+    details?: Record<string, unknown>;
+}

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

@@ -1,4 +1,8 @@
-/** Materiales de marketing que se prometen a un promotor. OTHER + descripción cubre lo no listado. */
+/**
+ * Los cuatro tipos de material de origen. Desde la versión con catálogo, los tipos viven en AppSelection
+ * (`TaskManagerMaterialType`) y `MarketingMaterialDetails.materialType` es la clave del catálogo; este enum queda para
+ * los valores iniciales y compatibilidad.
+ */
 export enum MaterialType {
     PLASTIC_CARD = 'PLASTIC_CARD',
     REEL = 'REEL',

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

@@ -5,6 +5,7 @@ export * from './enums/MaterialType';
 export * from './enums/MarketingMaterialStatus';
 //dtos
 export * from './dtos/CreateTaskRequest';
+export * from './dtos/UpdateTaskRequest';
 export * from './dtos/TransitionTaskRequest';
 export * from './dtos/ListTasksQuery';
 export * from './dtos/TaskTypeQuery';