@pittaj/contracts 1.2.2

package/dist/category/schemas/getCategoryTree.schema.js

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Esquema Zod para validación de petición GET /categories/tree
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones para obtener árbol jerárquico de categorías.
+ * Arquitectura Child Container DI: tenantId viene del header X-Tenant-ID (no query param).
+ */
+import { z } from 'zod';
+import { CategoryScopeEnum } from './createCategory.schema';
+/**
+ * Esquema de validación para obtener árbol de categorías.
+ *
+ * Permite especificar scope, raíz y profundidad máxima.
+ *
+ * NOTA: tenantId viene del header X-Tenant-ID, NO se valida aquí.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export const getCategoryTreeSchema = z.object({
+    /**
+     * Scope del árbol de categorías (requerido).
+     */
+    scope: CategoryScopeEnum,
+    /**
+     * ID de la categoría raíz para construir subárbol (opcional).
+     * Si no se proporciona, se obtienen todas las raíces del scope.
+     */
+    rootId: z.string().uuid('El rootId debe ser un UUID válido').optional(),
+    /**
+     * Profundidad máxima del árbol (opcional, default: sin límite).
+     * 1 = solo raíces, 2 = raíces + hijos directos, etc.
+     */
+    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(),
+});
+//# sourceMappingURL=getCategoryTree.schema.js.map

package/dist/category/schemas/getCategoryTree.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCategoryTree.schema.js","sourceRoot":"","sources":["../../../src/category/schemas/getCategoryTree.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C;;OAEG;IACH,KAAK,EAAE,iBAAiB;IAExB;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC,QAAQ,EAAE;IAEvE;;;OAGG;IACH,QAAQ,EAAE,CAAC;SACN,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,iDAAiD,CAAC;SACjE,SAAS,CAAC,MAAM,CAAC;SACjB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,2CAA2C,CAAC;SACtE,QAAQ,EAAE;CAClB,CAAC,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from './categorySchemas';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/category/schemas/index.js

@@ -0,0 +1,2 @@
+export * from './categorySchemas';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/category/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/category/schemas/sync.schema.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @fileoverview Esquemas Zod para sincronización offline de categorías
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones para endpoints de sincronización bidireccional:
+ * - syncPush: Enviar cambios locales al servidor
+ * - syncPull: Obtener cambios del servidor
+ */
+import { z } from 'zod';
+/**
+ * Operaciones de sincronización válidas.
+ */
+export declare const SyncOperationEnum: z.ZodEnum<["create", "update", "delete"]>;
+/**
+ * Esquema para un cambio individual en sync push.
+ */
+export declare const syncChangeSchema: z.ZodObject<{
+    /**
+     * ID de la categoría afectada (UUID v4).
+     */
+    id: z.ZodString;
+    /**
+     * Tipo de operación realizada offline.
+     */
+    operation: z.ZodEnum<["create", "update", "delete"]>;
+    /**
+     * Datos de la categoría (para create/update).
+     */
+    data: z.ZodUnknown;
+    /**
+     * Versión del registro (para optimistic locking en update/delete).
+     */
+    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;
+}>;
+/**
+ * Esquema de validación para push de sincronización.
+ *
+ * Envía cambios realizados offline al servidor.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export declare const syncPushSchema: z.ZodObject<{
+    /**
+     * ID del tenant (UUID v4).
+     */
+    tenantId: z.ZodString;
+    /**
+     * ID del dispositivo que envía los cambios.
+     */
+    deviceId: z.ZodString;
+    /**
+     * Lista de cambios a sincronizar.
+     */
+    changes: z.ZodArray<z.ZodObject<{
+        /**
+         * ID de la categoría afectada (UUID v4).
+         */
+        id: z.ZodString;
+        /**
+         * Tipo de operación realizada offline.
+         */
+        operation: z.ZodEnum<["create", "update", "delete"]>;
+        /**
+         * Datos de la categoría (para create/update).
+         */
+        data: z.ZodUnknown;
+        /**
+         * Versión del registro (para optimistic locking en update/delete).
+         */
+        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;
+    }[];
+}>;
+/**
+ * Esquema de validación para pull de sincronización.
+ *
+ * Obtiene cambios del servidor desde la última sincronización.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export declare const syncPullSchema: z.ZodObject<{
+    /**
+     * ID del tenant (UUID v4).
+     */
+    tenantId: z.ZodString;
+    /**
+     * Timestamp de la última sincronización (ISO 8601).
+     * Si no se proporciona, obtiene todos los registros.
+     */
+    lastSyncedAt: z.ZodOptional<z.ZodString>;
+    /**
+     * Límite de registros a obtener.
+     */
+    limit: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Offset para paginación.
+     */
+    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=sync.schema.d.ts.map

package/dist/category/schemas/sync.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.schema.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/sync.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,iBAAiB,2CAAyC,CAAC;AAExE;;GAEG;AACH,eAAO,MAAM,gBAAgB;IACzB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;EAEL,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;IACvB;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;QA1CH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;QAGH;;WAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BL,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc;IACvB;;OAEG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;EAEL,CAAC"}

package/dist/category/schemas/sync.schema.js

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Esquemas Zod para sincronización offline de categorías
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones para endpoints de sincronización bidireccional:
+ * - syncPush: Enviar cambios locales al servidor
+ * - syncPull: Obtener cambios del servidor
+ */
+import { z } from 'zod';
+/**
+ * Operaciones de sincronización válidas.
+ */
+export const SyncOperationEnum = z.enum(['create', 'update', 'delete']);
+/**
+ * Esquema para un cambio individual en sync push.
+ */
+export const syncChangeSchema = z.object({
+    /**
+     * ID de la categoría afectada (UUID v4).
+     */
+    id: z.string().uuid(),
+    /**
+     * Tipo de operación realizada offline.
+     */
+    operation: SyncOperationEnum,
+    /**
+     * Datos de la categoría (para create/update).
+     */
+    data: z.unknown(),
+    /**
+     * Versión del registro (para optimistic locking en update/delete).
+     */
+    version: z.number().optional(),
+});
+/**
+ * Esquema de validación para push de sincronización.
+ *
+ * Envía cambios realizados offline al servidor.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export const syncPushSchema = z.object({
+    /**
+     * ID del tenant (UUID v4).
+     */
+    tenantId: z.string().uuid(),
+    /**
+     * ID del dispositivo que envía los cambios.
+     */
+    deviceId: z.string().min(1),
+    /**
+     * Lista de cambios a sincronizar.
+     */
+    changes: z.array(syncChangeSchema),
+});
+/**
+ * Esquema de validación para pull de sincronización.
+ *
+ * Obtiene cambios del servidor desde la última sincronización.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export const syncPullSchema = z.object({
+    /**
+     * ID del tenant (UUID v4).
+     */
+    tenantId: z.string().uuid(),
+    /**
+     * Timestamp de la última sincronización (ISO 8601).
+     * Si no se proporciona, obtiene todos los registros.
+     */
+    lastSyncedAt: z.string().datetime().optional(),
+    /**
+     * Límite de registros a obtener.
+     */
+    limit: z.number().optional(),
+    /**
+     * Offset para paginación.
+     */
+    offset: z.number().optional(),
+});
+//# sourceMappingURL=sync.schema.js.map

package/dist/category/schemas/sync.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.schema.js","sourceRoot":"","sources":["../../../src/category/schemas/sync.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC;;OAEG;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAErB;;OAEG;IACH,SAAS,EAAE,iBAAiB;IAE5B;;OAEG;IACH,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE;IAEjB;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAE3B;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE3B;;OAEG;IACH,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC;CACrC,CAAC,CAAC;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC;;OAEG;IACH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAE3B;;;OAGG;IACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE9C;;OAEG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAE5B;;OAEG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC"}

package/dist/category/schemas/updateCategory.schema.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @fileoverview Esquema Zod para validación de peticiones de actualización de categorías
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones de entrada para el endpoint PUT /categories/:id.
+ * Incluye validación de optimistic locking con campo version.
+ * Arquitectura Child Container DI: tenantId y updatedBy vienen de headers HTTP.
+ */
+import { z } from 'zod';
+/**
+ * Esquema de validación para actualizar una categoría.
+ *
+ * Valida que los datos de entrada cumplan con las reglas de negocio
+ * antes de pasar al UpdateCategoryHandler.
+ *
+ * NOTA: Todos los campos son opcionales excepto scope y version.
+ * Solo se actualizan los campos proporcionados.
+ *
+ * NOTA: tenantId viene del header X-Tenant-ID, NO del body.
+ * NOTA: updatedBy viene del header X-User-ID, NO del body.
+ *
+ * @constant
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // Actualizar solo nombre y código
+ * PUT /categories/550e8400-e29b-41d4-a716-446655440000
+ * Headers: { "X-Tenant-ID": "59afae4e...", "X-User-ID": "user-123" }
+ * Body: {
+ *   "scope": "PRODUCT",
+ *   "name": "Electrónica Actualizada",
+ *   "code": "CAT-0001-NEW",
+ *   "version": 1
+ * }
+ * ```
+ */
+export declare const updateCategorySchema: z.ZodObject<{
+    /**
+     * Scope de la categoría (requerido para validación de seguridad y permisos).
+     */
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    /**
+     * Versión actual de la categoría (optimistic locking).
+     * Requerido para prevenir conflictos de concurrencia.
+     *
+     * El servidor valida que la versión enviada coincida con la versión actual en DB.
+     * Si no coincide, retorna error 409 Conflict.
+     */
+    version: z.ZodNumber;
+    /**
+     * Nuevo nombre de la categoría (opcional, 2-100 caracteres).
+     */
+    name: z.ZodOptional<z.ZodString>;
+    /**
+     * Nuevo código de la categoría (opcional, 1-50 caracteres).
+     */
+    code: z.ZodOptional<z.ZodString>;
+    /**
+     * Nuevo estado de la categoría (opcional).
+     */
+    status: z.ZodOptional<z.ZodEnum<["ACTIVE", "INACTIVE", "BLOCKED", "ARCHIVED"]>>;
+    /**
+     * Nuevo ID de la categoría padre (opcional, UUID v4 o null para convertir en raíz).
+     *
+     * VALIDACIONES:
+     * - Si se proporciona un UUID, el padre debe existir
+     * - Si se proporciona null, la categoría se convierte en raíz
+     * - No se permite crear referencias circulares (A → B → A)
+     * - No se permite asignar como padre a sí misma
+     * - No se permite asignar un descendiente como padre
+     */
+    parentId: z.ZodOptional<z.ZodEffects<z.ZodUnion<[z.ZodString, z.ZodNull]>, string | null, unknown>>;
+    /**
+     * Nuevo orden de visualización (opcional, 0-999999).
+     */
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Nuevos atributos adicionales como metadatos JSON (opcional).
+     *
+     * NOTA: Los atributos se actualizan completamente (no se mezclan con los existentes).
+     * Para agregar un atributo, se debe enviar el objeto completo con todos los atributos.
+     */
+    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;
+}>;
+//# sourceMappingURL=updateCategory.schema.d.ts.map

package/dist/category/schemas/updateCategory.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCategory.schema.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/updateCategory.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,eAAO,MAAM,oBAAoB;IAC7B;;OAEG;;IAGH;;;;;;OAMG;;IAMH;;OAEG;;IAQH;;OAEG;;IAQH;;OAEG;;IAGH;;;;;;;;;OASG;;IAWH;;OAEG;;IAQH;;;;;OAKG;;;;;;;;;;;;;;;;;;;;EAEL,CAAC"}

package/dist/category/schemas/updateCategory.schema.js

@@ -0,0 +1,114 @@
+/**
+ * @fileoverview Esquema Zod para validación de peticiones de actualización de categorías
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones de entrada para el endpoint PUT /categories/:id.
+ * Incluye validación de optimistic locking con campo version.
+ * Arquitectura Child Container DI: tenantId y updatedBy vienen de headers HTTP.
+ */
+import { z } from 'zod';
+import { CategoryScopeEnum, CategoryStatusEnum } from './createCategory.schema';
+/**
+ * Esquema de validación para actualizar una categoría.
+ *
+ * Valida que los datos de entrada cumplan con las reglas de negocio
+ * antes de pasar al UpdateCategoryHandler.
+ *
+ * NOTA: Todos los campos son opcionales excepto scope y version.
+ * Solo se actualizan los campos proporcionados.
+ *
+ * NOTA: tenantId viene del header X-Tenant-ID, NO del body.
+ * NOTA: updatedBy viene del header X-User-ID, NO del body.
+ *
+ * @constant
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // Actualizar solo nombre y código
+ * PUT /categories/550e8400-e29b-41d4-a716-446655440000
+ * Headers: { "X-Tenant-ID": "59afae4e...", "X-User-ID": "user-123" }
+ * Body: {
+ *   "scope": "PRODUCT",
+ *   "name": "Electrónica Actualizada",
+ *   "code": "CAT-0001-NEW",
+ *   "version": 1
+ * }
+ * ```
+ */
+export const updateCategorySchema = z.object({
+    /**
+     * Scope de la categoría (requerido para validación de seguridad y permisos).
+     */
+    scope: CategoryScopeEnum,
+    /**
+     * Versión actual de la categoría (optimistic locking).
+     * Requerido para prevenir conflictos de concurrencia.
+     *
+     * El servidor valida que la versión enviada coincida con la versión actual en DB.
+     * Si no coincide, retorna error 409 Conflict.
+     */
+    version: z
+        .number()
+        .int('La versión debe ser un número entero')
+        .min(0, 'La versión no puede ser negativa'),
+    /**
+     * Nuevo nombre de la categoría (opcional, 2-100 caracteres).
+     */
+    name: z
+        .string()
+        .min(2, 'El nombre debe tener al menos 2 caracteres')
+        .max(100, 'El nombre no debe exceder 100 caracteres')
+        .trim()
+        .optional(),
+    /**
+     * Nuevo código de la categoría (opcional, 1-50 caracteres).
+     */
+    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(),
+    /**
+     * Nuevo estado de la categoría (opcional).
+     */
+    status: CategoryStatusEnum.optional(),
+    /**
+     * Nuevo ID de la categoría padre (opcional, UUID v4 o null para convertir en raíz).
+     *
+     * VALIDACIONES:
+     * - Si se proporciona un UUID, el padre debe existir
+     * - Si se proporciona null, la categoría se convierte en raíz
+     * - No se permite crear referencias circulares (A → B → A)
+     * - No se permite asignar como padre a sí misma
+     * - No se permite asignar un descendiente como padre
+     */
+    parentId: z
+        .preprocess((val) => {
+        // Normalizar valores problemáticos enviados por algunos navegadores
+        if (val === '' || val === undefined || val === 'undefined')
+            return null;
+        // Pasar valores válidos sin cambios (UUID string o null)
+        return val;
+    }, z.union([z.string().uuid('El parentId debe ser un UUID válido'), z.null()]))
+        .optional(),
+    /**
+     * Nuevo orden de visualización (opcional, 0-999999).
+     */
+    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(),
+    /**
+     * Nuevos atributos adicionales como metadatos JSON (opcional).
+     *
+     * NOTA: Los atributos se actualizan completamente (no se mezclan con los existentes).
+     * Para agregar un atributo, se debe enviar el objeto completo con todos los atributos.
+     */
+    attributes: z.record(z.unknown()).optional(),
+});
+//# sourceMappingURL=updateCategory.schema.js.map

package/dist/category/schemas/updateCategory.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateCategory.schema.js","sourceRoot":"","sources":["../../../src/category/schemas/updateCategory.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC;;OAEG;IACH,KAAK,EAAE,iBAAiB;IAExB;;;;;;OAMG;IACH,OAAO,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,CAAC,sCAAsC,CAAC;SAC3C,GAAG,CAAC,CAAC,EAAE,kCAAkC,CAAC;IAE/C;;OAEG;IACH,IAAI,EAAE,CAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,4CAA4C,CAAC;SACpD,GAAG,CAAC,GAAG,EAAE,0CAA0C,CAAC;SACpD,IAAI,EAAE;SACN,QAAQ,EAAE;IAEf;;OAEG;IACH,IAAI,EAAE,CAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,0CAA0C,CAAC;SAClD,GAAG,CAAC,EAAE,EAAE,yCAAyC,CAAC;SAClD,IAAI,EAAE;SACN,QAAQ,EAAE;IAEf;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAErC;;;;;;;;;OASG;IACH,QAAQ,EAAE,CAAC;SACN,UAAU,CAAC,CAAC,GAAG,EAAE,EAAE;QAChB,oEAAoE;QACpE,IAAI,GAAG,KAAK,EAAE,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,WAAW;YACtD,OAAO,IAAI,CAAC;QAChB,yDAAyD;QACzD,OAAO,GAAG,CAAC;IACf,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,qCAAqC,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;SAC9E,QAAQ,EAAE;IAEf;;OAEG;IACH,YAAY,EAAE,CAAC;SACV,MAAM,EAAE;SACR,GAAG,CAAC,oCAAoC,CAAC;SACzC,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,GAAG,CAAC,MAAM,EAAE,iCAAiC,CAAC;SAC9C,QAAQ,EAAE;IAEf;;;;;OAKG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC,CAAC"}

package/dist/company/dtos/CompanyDTO.d.ts

@@ -0,0 +1,79 @@
+/**
+ * @fileoverview DTO de respuesta para Company (GET endpoints).
+ *
+ * Define la estructura de datos que el backend envía al frontend
+ * cuando se consulta información de empresas.
+ *
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+/**
+ * DTO de respuesta para consultas de empresas.
+ *
+ * Usado en:
+ * - GET /companies (lista)
+ * - GET /companies/:id (detalle)
+ * - PUT /companies/:id (respuesta después de update)
+ *
+ * @example
+ * ```typescript
+ * const company: CompanyDTO = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   name: 'Tienda El Sol',
+ *   legalName: 'Comercializadora El Sol S.A.',
+ *   taxId: '1792146739001',
+ *   isDefault: true,
+ *   isActive: true,
+ *   createdAt: '2025-11-11T10:00:00Z',
+ *   version: 1,
+ * };
+ * ```
+ */
+export interface CompanyDTO {
+    /**
+     * ID único de la empresa (UUID v4).
+     */
+    readonly id: string;
+    /**
+     * Nombre comercial de la empresa.
+     */
+    readonly name: string;
+    /**
+     * Nombre legal completo (Razón Social).
+     */
+    readonly legalName: string;
+    /**
+     * Identificación fiscal (RUC, NIF, RFC, EIN).
+     */
+    readonly taxId: string;
+    /**
+     * Indica si es la empresa por defecto del tenant.
+     */
+    readonly isDefault: boolean;
+    /**
+     * Indica si la empresa está activa.
+     */
+    readonly isActive: boolean;
+    /**
+     * Fecha de creación (ISO 8601).
+     */
+    readonly createdAt: string;
+    /**
+     * ID del usuario que creó este registro (UUID).
+     */
+    readonly createdBy?: string;
+    /**
+     * Fecha de última actualización (ISO 8601).
+     */
+    readonly updatedAt?: string;
+    /**
+     * ID del usuario que actualizó este registro (UUID).
+     */
+    readonly updatedBy?: string;
+    /**
+     * Versión para optimistic locking.
+     */
+    readonly version: number;
+}
+//# sourceMappingURL=CompanyDTO.d.ts.map

package/dist/company/dtos/CompanyDTO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompanyDTO.d.ts","sourceRoot":"","sources":["../../../src/company/dtos/CompanyDTO.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/company/dtos/CompanyDTO.js

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview DTO de respuesta para Company (GET endpoints).
+ *
+ * Define la estructura de datos que el backend envía al frontend
+ * cuando se consulta información de empresas.
+ *
+ * @module Contracts/Company/DTOs
+ * @version 1.0.0
+ * @since 11-11-2025
+ */
+export {};
+//# sourceMappingURL=CompanyDTO.js.map

package/dist/company/dtos/CompanyDTO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompanyDTO.js","sourceRoot":"","sources":["../../../src/company/dtos/CompanyDTO.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}