@pittaj/contracts 1.2.2

package/dist/category/responses/UpdateCategoryResponse.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Response DTO para UpdateCategory command
+ * @module commands/update-category
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta después de actualizar una categoría.
+ * Co-ubicado con el command y handler para cohesión.
+ */
+/**
+ * Response DTO para categoría actualizada.
+ *
+ * Retorna la categoría completa después de actualizar.
+ * Incluye campos de auditoría para tracking de cambios.
+ *
+ * @interface UpdateCategoryResponse
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const response: UpdateCategoryResponse = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   name: 'Electrónica Actualizada',
+ *   version: 2,
+ *   updatedAt: new Date(),
+ *   updatedBy: 'user-789'
+ * };
+ * ```
+ */
+export interface UpdateCategoryResponse {
+    readonly id: string;
+    readonly name: string;
+    readonly code: string | null;
+    readonly displayCode: string;
+    readonly scope: string;
+    readonly status: string;
+    readonly tenantId: string;
+    readonly parentId: string | null;
+    readonly displayOrder: number;
+    readonly attributes: Record<string, any> | null;
+    readonly path: string;
+    readonly level: number;
+    readonly createdAt: Date;
+    readonly createdBy: string | null;
+    readonly updatedAt: Date | null;
+    readonly updatedBy: string | null;
+    readonly version: number;
+}
+//# sourceMappingURL=UpdateCategoryResponse.d.ts.map

package/dist/category/responses/UpdateCategoryResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateCategoryResponse.d.ts","sourceRoot":"","sources":["../../../src/category/responses/UpdateCategoryResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAChD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,IAAI,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B"}

package/dist/category/responses/UpdateCategoryResponse.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Response DTO para UpdateCategory command
+ * @module commands/update-category
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta después de actualizar una categoría.
+ * Co-ubicado con el command y handler para cohesión.
+ */
+export {};
+//# sourceMappingURL=UpdateCategoryResponse.js.map

package/dist/category/responses/UpdateCategoryResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateCategoryResponse.js","sourceRoot":"","sources":["../../../src/category/responses/UpdateCategoryResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/category/responses/index.d.ts

@@ -0,0 +1,9 @@
+export * from './CategoryListResponse';
+export * from './CategoryMetadataResponse';
+export * from './CategoryResponse';
+export * from './CategoryTreeResponse';
+export * from './CreateCategoryResponse';
+export * from './SyncPullResponse';
+export * from './SyncPushResponse';
+export * from './UpdateCategoryResponse';
+//# sourceMappingURL=index.d.ts.map

package/dist/category/responses/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/category/responses/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/category/responses/index.js

@@ -0,0 +1,9 @@
+export * from './CategoryListResponse';
+export * from './CategoryMetadataResponse';
+export * from './CategoryResponse';
+export * from './CategoryTreeResponse';
+export * from './CreateCategoryResponse';
+export * from './SyncPullResponse';
+export * from './SyncPushResponse';
+export * from './UpdateCategoryResponse';
+//# sourceMappingURL=index.js.map

package/dist/category/responses/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/category/responses/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC"}

package/dist/category/schemas/categorySchemas.d.ts

@@ -0,0 +1,257 @@
+/**
+ * @fileoverview Schemas Zod para validación HTTP del módulo Category
+ * @module infrastructure/api/schemas
+ * @version 1.0.0
+ *
+ * Los schemas viven dentro del módulo para máxima cohesión.
+ * Migrados desde @pittaj/lib-contracts/category para eliminar dependencia cruzada.
+ *
+ * @since 1.0.0
+ */
+import { z } from 'zod';
+/**
+ * Scopes válidos para categorías.
+ */
+export declare const CategoryScopeZodEnum: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+/**
+ * Estados válidos para categorías.
+ */
+export declare const CategoryStatusEnum: z.ZodEnum<["ACTIVE", "INACTIVE", "BLOCKED", "ARCHIVED"]>;
+/**
+ * Operaciones de sincronización válidas.
+ */
+export declare const SyncOperationEnum: z.ZodEnum<["create", "update", "delete"]>;
+/**
+ * Validación de parámetro :id en la URL.
+ * Mejora de seguridad: valida formato UUID en path params.
+ */
+export declare const categoryIdParamSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+/**
+ * POST /api/categories
+ * Crear una nueva categoría.
+ */
+export declare const createCategorySchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    name: z.ZodString;
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+    status: z.ZodOptional<z.ZodEnum<["ACTIVE", "INACTIVE", "BLOCKED", "ARCHIVED"]>>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    deviceId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+    deviceId?: string | undefined;
+    status?: "ACTIVE" | "INACTIVE" | "BLOCKED" | "ARCHIVED" | undefined;
+    id?: string | undefined;
+    parentId?: string | null | undefined;
+    displayOrder?: number | undefined;
+    attributes?: Record<string, unknown> | undefined;
+}, {
+    name: string;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+    deviceId?: string | undefined;
+    status?: "ACTIVE" | "INACTIVE" | "BLOCKED" | "ARCHIVED" | undefined;
+    id?: string | undefined;
+    parentId?: string | null | undefined;
+    displayOrder?: number | undefined;
+    attributes?: Record<string, unknown> | undefined;
+}>;
+/**
+ * PUT /api/categories/:id
+ * Actualizar una categoría existente.
+ */
+export declare const updateCategorySchema: z.ZodObject<{
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    version: z.ZodNumber;
+    name: z.ZodOptional<z.ZodString>;
+    code: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodEnum<["ACTIVE", "INACTIVE", "BLOCKED", "ARCHIVED"]>>;
+    parentId: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNull]>, string | null, unknown>>;
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    version: number;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+    code?: string | undefined;
+    status?: "ACTIVE" | "INACTIVE" | "BLOCKED" | "ARCHIVED" | undefined;
+    name?: string | undefined;
+    parentId?: string | null | undefined;
+    displayOrder?: number | undefined;
+    attributes?: Record<string, unknown> | undefined;
+}, {
+    version: number;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+    code?: string | undefined;
+    status?: "ACTIVE" | "INACTIVE" | "BLOCKED" | "ARCHIVED" | undefined;
+    name?: string | undefined;
+    parentId?: unknown;
+    displayOrder?: number | undefined;
+    attributes?: Record<string, unknown> | undefined;
+}>;
+/**
+ * DELETE /api/categories/:id (query params)
+ * Eliminar una categoría (soft delete).
+ */
+export declare const deleteCategorySchema: z.ZodObject<{
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    version: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    version: number;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+}, {
+    version: number;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+}>;
+/**
+ * GET /api/categories/:id (query params)
+ * Obtener una categoría por ID.
+ */
+export declare const getCategoryByIdSchema: z.ZodObject<{
+    id: z.ZodString;
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+}, {
+    id: string;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+}>;
+/**
+ * GET /api/categories (query params)
+ * Listar categorías con filtros y paginación.
+ */
+export declare const getCategoriesSchema: z.ZodObject<{
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    status: z.ZodOptional<z.ZodEnum<["ACTIVE", "INACTIVE", "BLOCKED", "ARCHIVED"]>>;
+    q: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    page: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, number, string>, number, string>>>;
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, number, string>, number, string>>>;
+    sortBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["name", "code", "displayOrder", "createdAt"]>>>;
+    sortOrder: z.ZodDefault<z.ZodOptional<z.ZodEnum<["asc", "desc"]>>>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+    pageSize: number;
+    sortBy: "code" | "name" | "displayOrder" | "createdAt";
+    sortOrder: "asc" | "desc";
+    status?: "ACTIVE" | "INACTIVE" | "BLOCKED" | "ARCHIVED" | undefined;
+    parentId?: string | null | undefined;
+    q?: string | undefined;
+}, {
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+    status?: "ACTIVE" | "INACTIVE" | "BLOCKED" | "ARCHIVED" | undefined;
+    page?: string | undefined;
+    parentId?: string | null | undefined;
+    q?: string | undefined;
+    pageSize?: string | undefined;
+    sortBy?: "code" | "name" | "displayOrder" | "createdAt" | undefined;
+    sortOrder?: "asc" | "desc" | undefined;
+}>;
+/**
+ * GET /api/categories/tree (query params)
+ * Obtener árbol jerárquico de categorías.
+ */
+export declare const getCategoryTreeSchema: z.ZodObject<{
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    rootId: z.ZodOptional<z.ZodString>;
+    maxDepth: z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, number, string>, number, string>>;
+}, "strip", z.ZodTypeAny, {
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+    rootId?: string | undefined;
+    maxDepth?: number | undefined;
+}, {
+    scope: "EXPENSE" | "PRODUCT" | "SERVICE" | "ASSET" | "GL_ACCOUNT" | "ACCOUNTING" | "PROJECT" | "PROCUREMENT" | "NAV_POS" | "NAV_ECOM";
+    rootId?: string | undefined;
+    maxDepth?: string | undefined;
+}>;
+/**
+ * Schema para un cambio individual en sync push.
+ */
+export declare const syncChangeSchema: z.ZodObject<{
+    id: z.ZodString;
+    operation: z.ZodEnum<["create", "update", "delete"]>;
+    data: z.ZodUnknown;
+    version: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    operation: "create" | "update" | "delete";
+    data?: unknown;
+    version?: number | undefined;
+}, {
+    id: string;
+    operation: "create" | "update" | "delete";
+    data?: unknown;
+    version?: number | undefined;
+}>;
+/**
+ * POST /api/categories/sync/push
+ * Sincronizar cambios locales al servidor.
+ */
+export declare const syncPushSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    deviceId: z.ZodString;
+    changes: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        operation: z.ZodEnum<["create", "update", "delete"]>;
+        data: z.ZodUnknown;
+        version: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        operation: "create" | "update" | "delete";
+        data?: unknown;
+        version?: number | undefined;
+    }, {
+        id: string;
+        operation: "create" | "update" | "delete";
+        data?: unknown;
+        version?: number | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    deviceId: string;
+    tenantId: string;
+    changes: {
+        id: string;
+        operation: "create" | "update" | "delete";
+        data?: unknown;
+        version?: number | undefined;
+    }[];
+}, {
+    deviceId: string;
+    tenantId: string;
+    changes: {
+        id: string;
+        operation: "create" | "update" | "delete";
+        data?: unknown;
+        version?: number | undefined;
+    }[];
+}>;
+/**
+ * POST /api/categories/sync/pull
+ * Obtener cambios del servidor.
+ */
+export declare const syncPullSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    lastSyncedAt: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    tenantId: string;
+    limit?: number | undefined;
+    lastSyncedAt?: string | undefined;
+    offset?: number | undefined;
+}, {
+    tenantId: string;
+    limit?: number | undefined;
+    lastSyncedAt?: string | undefined;
+    offset?: number | undefined;
+}>;
+//# sourceMappingURL=categorySchemas.d.ts.map

package/dist/category/schemas/categorySchemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorySchemas.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/categorySchemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,oBAAoB,oIAW/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,0DAK7B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB,2CAAyC,CAAC;AAMxE;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;EAEhC,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyB/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiC/B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;EAK/B,CAAC;AAMH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;EAGhC,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmC9B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;EAShC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;EAK3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIzB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;EAKzB,CAAC"}

package/dist/category/schemas/categorySchemas.js

@@ -0,0 +1,227 @@
+/**
+ * @fileoverview Schemas Zod para validación HTTP del módulo Category
+ * @module infrastructure/api/schemas
+ * @version 1.0.0
+ *
+ * Los schemas viven dentro del módulo para máxima cohesión.
+ * Migrados desde @pittaj/lib-contracts/category para eliminar dependencia cruzada.
+ *
+ * @since 1.0.0
+ */
+import { z } from 'zod';
+// ============================================================
+// ENUMS compartidos
+// ============================================================
+/**
+ * Scopes válidos para categorías.
+ */
+export const CategoryScopeZodEnum = z.enum([
+    'PRODUCT',
+    'SERVICE',
+    'EXPENSE',
+    'ASSET',
+    'GL_ACCOUNT',
+    'ACCOUNTING',
+    'PROJECT',
+    'PROCUREMENT',
+    'NAV_POS',
+    'NAV_ECOM',
+]);
+/**
+ * Estados válidos para categorías.
+ */
+export const CategoryStatusEnum = z.enum([
+    'ACTIVE',
+    'INACTIVE',
+    'BLOCKED',
+    'ARCHIVED',
+]);
+/**
+ * Operaciones de sincronización válidas.
+ */
+export const SyncOperationEnum = z.enum(['create', 'update', 'delete']);
+// ============================================================
+// PARAMS
+// ============================================================
+/**
+ * Validación de parámetro :id en la URL.
+ * Mejora de seguridad: valida formato UUID en path params.
+ */
+export const categoryIdParamSchema = z.object({
+    id: z.string().uuid('El ID debe ser un UUID válido'),
+});
+// ============================================================
+// COMMANDS - Schemas de escritura
+// ============================================================
+/**
+ * POST /api/categories
+ * Crear una nueva categoría.
+ */
+export const createCategorySchema = z.object({
+    id: z.string().uuid('El id debe ser un UUID válido').optional(),
+    name: z
+        .string()
+        .min(2, 'El nombre debe tener al menos 2 caracteres')
+        .max(100, 'El nombre no debe exceder 100 caracteres')
+        .trim(),
+    scope: CategoryScopeZodEnum,
+    parentId: z
+        .string()
+        .uuid('El parentId debe ser un UUID válido')
+        .nullable()
+        .optional(),
+    displayOrder: z
+        .number()
+        .int('El orden debe ser un número entero')
+        .min(0, 'El orden no puede ser negativo')
+        .max(999999, 'El orden no debe exceder 999999')
+        .optional(),
+    status: CategoryStatusEnum.optional(),
+    attributes: z.record(z.unknown()).optional(),
+    deviceId: z
+        .string()
+        .max(255, 'El deviceId no debe exceder 255 caracteres')
+        .optional(),
+});
+/**
+ * PUT /api/categories/:id
+ * Actualizar una categoría existente.
+ */
+export const updateCategorySchema = z.object({
+    scope: CategoryScopeZodEnum,
+    version: z
+        .number()
+        .int('La versión debe ser un número entero')
+        .min(0, 'La versión no puede ser negativa'),
+    name: z
+        .string()
+        .min(2, 'El nombre debe tener al menos 2 caracteres')
+        .max(100, 'El nombre no debe exceder 100 caracteres')
+        .trim()
+        .optional(),
+    code: z
+        .string()
+        .min(1, 'El código debe tener al menos 1 carácter')
+        .max(50, 'El código no debe exceder 50 caracteres')
+        .trim()
+        .optional(),
+    status: CategoryStatusEnum.optional(),
+    parentId: z
+        .preprocess((val) => {
+        if (val === '' || val === undefined || val === 'undefined')
+            return null;
+        return val;
+    }, z.union([z.string().uuid('El parentId debe ser un UUID válido'), z.null()]))
+        .optional(),
+    displayOrder: z
+        .number()
+        .int('El orden debe ser un número entero')
+        .min(0, 'El orden no puede ser negativo')
+        .max(999999, 'El orden no debe exceder 999999')
+        .optional(),
+    attributes: z.record(z.unknown()).optional(),
+});
+/**
+ * DELETE /api/categories/:id (query params)
+ * Eliminar una categoría (soft delete).
+ */
+export const deleteCategorySchema = z.object({
+    scope: CategoryScopeZodEnum,
+    version: z.coerce.number().int().positive({
+        message: 'La versión debe ser un número entero positivo',
+    }),
+});
+// ============================================================
+// QUERIES - Schemas de lectura
+// ============================================================
+/**
+ * GET /api/categories/:id (query params)
+ * Obtener una categoría por ID.
+ */
+export const getCategoryByIdSchema = z.object({
+    id: z.string().uuid('El id debe ser un UUID válido'),
+    scope: CategoryScopeZodEnum,
+});
+/**
+ * GET /api/categories (query params)
+ * Listar categorías con filtros y paginación.
+ */
+export const getCategoriesSchema = z.object({
+    scope: CategoryScopeZodEnum,
+    status: CategoryStatusEnum.optional(),
+    q: z
+        .string()
+        .min(1, 'El término de búsqueda debe tener al menos 1 carácter')
+        .max(100, 'El término de búsqueda no puede exceder 100 caracteres')
+        .optional(),
+    parentId: z
+        .string()
+        .uuid('El parentId debe ser un UUID válido')
+        .nullable()
+        .optional(),
+    page: z
+        .string()
+        .regex(/^\d+$/, 'La página debe ser un número entero')
+        .transform(Number)
+        .refine((val) => val >= 1, 'La página debe ser al menos 1')
+        .optional()
+        .default('1'),
+    pageSize: z
+        .string()
+        .regex(/^\d+$/, 'El tamaño de página debe ser un número entero')
+        .transform(Number)
+        .refine((val) => val >= 1 && val <= 100, 'El tamaño de página debe estar entre 1 y 100')
+        .optional()
+        .default('50'),
+    sortBy: z
+        .enum(['name', 'code', 'displayOrder', 'createdAt'])
+        .optional()
+        .default('displayOrder'),
+    sortOrder: z.enum(['asc', 'desc']).optional().default('asc'),
+});
+/**
+ * GET /api/categories/tree (query params)
+ * Obtener árbol jerárquico de categorías.
+ */
+export const getCategoryTreeSchema = z.object({
+    scope: CategoryScopeZodEnum,
+    rootId: z.string().uuid('El rootId debe ser un UUID válido').optional(),
+    maxDepth: z
+        .string()
+        .regex(/^\d+$/, 'La profundidad máxima debe ser un número entero')
+        .transform(Number)
+        .refine((val) => val >= 1, 'La profundidad máxima debe ser al menos 1')
+        .optional(),
+});
+// ============================================================
+// SYNC - Schemas de sincronización
+// ============================================================
+/**
+ * Schema para un cambio individual en sync push.
+ */
+export const syncChangeSchema = z.object({
+    id: z.string().uuid(),
+    operation: SyncOperationEnum,
+    data: z.unknown(),
+    version: z.number().optional(),
+});
+/**
+ * POST /api/categories/sync/push
+ * Sincronizar cambios locales al servidor.
+ */
+export const syncPushSchema = z.object({
+    tenantId: z.string().uuid(),
+    deviceId: z.string().min(1),
+    changes: z.array(syncChangeSchema),
+});
+/**
+ * POST /api/categories/sync/pull
+ * Obtener cambios del servidor.
+ */
+export const syncPullSchema = z.object({
+    tenantId: z.string().uuid(),
+    lastSyncedAt: z.string().datetime().optional(),
+    limit: z.number().optional(),
+    offset: z.number().optional(),
+});
+//# sourceMappingURL=categorySchemas.js.map

package/dist/category/schemas/categorySchemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"categorySchemas.js","sourceRoot":"","sources":["../../../src/category/schemas/categorySchemas.ts"],"names":[],"mappings":"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"}