@pittaj/contracts 1.2.2

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

@@ -0,0 +1,103 @@
+/**
+ * @fileoverview Esquema Zod para validación de peticiones de creación de categorías
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones de entrada para el endpoint POST /categories.
+ *
+ * **Arquitectura Child Container DI + PWA:**
+ * - tenantId y createdBy vienen de headers HTTP (X-Tenant-ID, X-User-ID)
+ * - Servidor SIEMPRE genera código (eliminado campo `code`)
+ * - Background Sync envía `id` del cliente cuando sincroniza
+ */
+import { z } from 'zod';
+/**
+ * Scopes válidos para categorías.
+ *
+ * - PRODUCT: Productos físicos
+ * - SERVICE: Servicios
+ * - EXPENSE: Gastos
+ * - ASSET: Activos fijos
+ * - GL_ACCOUNT: Cuentas contables
+ * - ACCOUNTING: Contabilidad general
+ * - PROJECT: Proyectos
+ * - PROCUREMENT: Procurement
+ * - NAV_POS: Navegación POS
+ * - NAV_ECOM: Navegación E-commerce
+ */
+export declare const CategoryScopeEnum: 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"]>;
+/**
+ * Esquema de validación para crear una categoría.
+ *
+ * Valida que los datos de entrada cumplan con las reglas de negocio
+ * antes de pasar al Handler.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export declare const createCategorySchema: z.ZodObject<{
+    /**
+     * ID de la categoría (opcional, UUID v4).
+     *
+     * **Solo enviar cuando viene de Background Sync** (categoría creada offline).
+     * - Online: Cliente NO envía ID, servidor lo genera
+     * - Offline → Sync: Cliente envía ID generado localmente
+     */
+    id: z.ZodOptional<z.ZodString>;
+    /**
+     * Nombre de la categoría (2-100 caracteres).
+     */
+    name: z.ZodString;
+    /**
+     * Scope de la categoría.
+     */
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    /**
+     * ID de la categoría padre (opcional, UUID v4 o null para raíz).
+     */
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /**
+     * Orden de visualización (opcional, 0-999999).
+     */
+    displayOrder: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Estado inicial de la categoría (opcional, default: ACTIVE).
+     */
+    status: z.ZodOptional<z.ZodEnum<["ACTIVE", "INACTIVE", "BLOCKED", "ARCHIVED"]>>;
+    /**
+     * Atributos adicionales como metadatos JSON (opcional).
+     */
+    attributes: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /**
+     * ID del dispositivo/sucursal que creó la categoría (opcional).
+     *
+     * Usado para tracking multi-sucursal y resolución de conflictos.
+     * Formato sugerido: `sucursal-{id}-{device-type}-{index}`
+     *
+     * @example "sucursal-02-laptop-01", "sucursal-01-tablet-03"
+     */
+    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;
+}>;
+//# sourceMappingURL=createCategory.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createCategory.schema.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/createCategory.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,iBAAiB,oIAW5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB,0DAK7B,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB;IAC7B;;;;;;OAMG;;IAGH;;OAEG;;IAOH;;OAEG;;IAGH;;OAEG;;IAOH;;OAEG;;IAQH;;OAEG;;IAGH;;OAEG;;IAGH;;;;;;;OAOG;;;;;;;;;;;;;;;;;;;;EAKL,CAAC"}

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

@@ -0,0 +1,117 @@
+/**
+ * @fileoverview Esquema Zod para validación de peticiones de creación de categorías
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones de entrada para el endpoint POST /categories.
+ *
+ * **Arquitectura Child Container DI + PWA:**
+ * - tenantId y createdBy vienen de headers HTTP (X-Tenant-ID, X-User-ID)
+ * - Servidor SIEMPRE genera código (eliminado campo `code`)
+ * - Background Sync envía `id` del cliente cuando sincroniza
+ */
+import { z } from 'zod';
+/**
+ * Scopes válidos para categorías.
+ *
+ * - PRODUCT: Productos físicos
+ * - SERVICE: Servicios
+ * - EXPENSE: Gastos
+ * - ASSET: Activos fijos
+ * - GL_ACCOUNT: Cuentas contables
+ * - ACCOUNTING: Contabilidad general
+ * - PROJECT: Proyectos
+ * - PROCUREMENT: Procurement
+ * - NAV_POS: Navegación POS
+ * - NAV_ECOM: Navegación E-commerce
+ */
+export const CategoryScopeEnum = 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',
+]);
+/**
+ * Esquema de validación para crear una categoría.
+ *
+ * Valida que los datos de entrada cumplan con las reglas de negocio
+ * antes de pasar al Handler.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export const createCategorySchema = z.object({
+    /**
+     * ID de la categoría (opcional, UUID v4).
+     *
+     * **Solo enviar cuando viene de Background Sync** (categoría creada offline).
+     * - Online: Cliente NO envía ID, servidor lo genera
+     * - Offline → Sync: Cliente envía ID generado localmente
+     */
+    id: z.string().uuid('El id debe ser un UUID válido').optional(),
+    /**
+     * Nombre de la categoría (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(),
+    /**
+     * Scope de la categoría.
+     */
+    scope: CategoryScopeEnum,
+    /**
+     * ID de la categoría padre (opcional, UUID v4 o null para raíz).
+     */
+    parentId: z
+        .string()
+        .uuid('El parentId debe ser un UUID válido')
+        .nullable()
+        .optional(),
+    /**
+     * 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(),
+    /**
+     * Estado inicial de la categoría (opcional, default: ACTIVE).
+     */
+    status: CategoryStatusEnum.optional(),
+    /**
+     * Atributos adicionales como metadatos JSON (opcional).
+     */
+    attributes: z.record(z.unknown()).optional(),
+    /**
+     * ID del dispositivo/sucursal que creó la categoría (opcional).
+     *
+     * Usado para tracking multi-sucursal y resolución de conflictos.
+     * Formato sugerido: `sucursal-{id}-{device-type}-{index}`
+     *
+     * @example "sucursal-02-laptop-01", "sucursal-01-tablet-03"
+     */
+    deviceId: z
+        .string()
+        .max(255, 'El deviceId no debe exceder 255 caracteres')
+        .optional(),
+});
+//# sourceMappingURL=createCategory.schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createCategory.schema.js","sourceRoot":"","sources":["../../../src/category/schemas/createCategory.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,SAAS;IACT,SAAS;IACT,SAAS;IACT,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,SAAS;IACT,aAAa;IACb,SAAS;IACT,UAAU;CACb,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,IAAI,CAAC;IACrC,QAAQ;IACR,UAAU;IACV,SAAS;IACT,UAAU;CACb,CAAC,CAAC;AAEH;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC;;;;;;OAMG;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,QAAQ,EAAE;IAE/D;;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;IAEX;;OAEG;IACH,KAAK,EAAE,iBAAiB;IAExB;;OAEG;IACH,QAAQ,EAAE,CAAC;SACN,MAAM,EAAE;SACR,IAAI,CAAC,qCAAqC,CAAC;SAC3C,QAAQ,EAAE;SACV,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;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAErC;;OAEG;IACH,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE5C;;;;;;;OAOG;IACH,QAAQ,EAAE,CAAC;SACN,MAAM,EAAE;SACR,GAAG,CAAC,GAAG,EAAE,4CAA4C,CAAC;SACtD,QAAQ,EAAE;CAClB,CAAC,CAAC"}

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

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Esquema Zod para validación de peticiones de eliminación de categorías
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones de entrada para el endpoint DELETE /categories/:id.
+ * El endpoint usa soft delete (marca como ARCHIVED en vez de eliminar físicamente).
+ * Arquitectura Child Container DI: tenantId y deletedBy vienen de headers HTTP.
+ */
+import { z } from 'zod';
+/**
+ * Esquema de validación para eliminar una categoría (query params).
+ *
+ * Valida parámetros de seguridad multi-tenant antes de ejecutar soft delete.
+ * El ID de la categoría viene en el path parameter (:id), no en el body.
+ *
+ * NOTA: Este endpoint implementa soft delete. La categoría NO se elimina físicamente
+ * de la base de datos, sino que se marca con estado ARCHIVED.
+ *
+ * NOTA: tenantId viene del header X-Tenant-ID, NO del query.
+ * NOTA: deletedBy viene del header X-User-ID, NO del query.
+ *
+ * @constant
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // Eliminar categoría (requiere version para optimistic locking)
+ * DELETE /categories/550e8400-e29b-41d4-a716-446655440000?scope=PRODUCT&version=2
+ * Headers: { "X-Tenant-ID": "59afae4e...", "X-User-ID": "user-123" }
+ *
+ * Response 200:
+ * {
+ *   "success": true,
+ *   "message": "Category deleted successfully",
+ *   "data": null
+ * }
+ * ```
+ */
+export declare const deleteCategorySchema: 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.
+     * Requerido para optimistic concurrency control (previene race conditions).
+     */
+    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";
+}>;
+//# sourceMappingURL=deleteCategory.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deleteCategory.schema.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/deleteCategory.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,oBAAoB;IAC7B;;OAEG;;IAGH;;;OAGG;;;;;;;;EAIL,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * @fileoverview Esquema Zod para validación de peticiones de eliminación de categorías
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones de entrada para el endpoint DELETE /categories/:id.
+ * El endpoint usa soft delete (marca como ARCHIVED en vez de eliminar físicamente).
+ * Arquitectura Child Container DI: tenantId y deletedBy vienen de headers HTTP.
+ */
+import { z } from 'zod';
+import { CategoryScopeEnum } from './createCategory.schema';
+/**
+ * Esquema de validación para eliminar una categoría (query params).
+ *
+ * Valida parámetros de seguridad multi-tenant antes de ejecutar soft delete.
+ * El ID de la categoría viene en el path parameter (:id), no en el body.
+ *
+ * NOTA: Este endpoint implementa soft delete. La categoría NO se elimina físicamente
+ * de la base de datos, sino que se marca con estado ARCHIVED.
+ *
+ * NOTA: tenantId viene del header X-Tenant-ID, NO del query.
+ * NOTA: deletedBy viene del header X-User-ID, NO del query.
+ *
+ * @constant
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // Eliminar categoría (requiere version para optimistic locking)
+ * DELETE /categories/550e8400-e29b-41d4-a716-446655440000?scope=PRODUCT&version=2
+ * Headers: { "X-Tenant-ID": "59afae4e...", "X-User-ID": "user-123" }
+ *
+ * Response 200:
+ * {
+ *   "success": true,
+ *   "message": "Category deleted successfully",
+ *   "data": null
+ * }
+ * ```
+ */
+export const deleteCategorySchema = z.object({
+    /**
+     * Scope de la categoría (requerido para validación de seguridad y permisos).
+     */
+    scope: CategoryScopeEnum,
+    /**
+     * Versión actual de la categoría.
+     * Requerido para optimistic concurrency control (previene race conditions).
+     */
+    version: z.coerce.number().int().positive({
+        message: 'La versión debe ser un número entero positivo',
+    }),
+});
+//# sourceMappingURL=deleteCategory.schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deleteCategory.schema.js","sourceRoot":"","sources":["../../../src/category/schemas/deleteCategory.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC;;OAEG;IACH,KAAK,EAAE,iBAAiB;IAExB;;;OAGG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC;QACtC,OAAO,EAAE,+CAA+C;KAC3D,CAAC;CACL,CAAC,CAAC"}

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

@@ -0,0 +1,76 @@
+/**
+ * @fileoverview Esquema Zod para validación de petición GET /categories
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones para listar categorías con filtros y paginación.
+ *
+ * **Child Container DI:**
+ * - tenantId viene del header X-Tenant-ID (no query param)
+ */
+import { z } from 'zod';
+/**
+ * Esquema de validación para listar categorías.
+ *
+ * Soporta filtros (scope, status, parentId), paginación y ordenamiento.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export declare const getCategoriesSchema: z.ZodObject<{
+    /**
+     * Scope de categorías a filtrar (requerido por seguridad).
+     * Cada usuario solo debe poder consultar los scopes a los que tiene acceso.
+     */
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    /**
+     * Estado de categorías a filtrar (opcional).
+     */
+    status: z.ZodOptional<z.ZodEnum<["ACTIVE", "INACTIVE", "BLOCKED", "ARCHIVED"]>>;
+    /**
+     * Texto de búsqueda (opcional).
+     * Busca en nombre y código de categoría.
+     */
+    q: z.ZodOptional<z.ZodString>;
+    /**
+     * ID del padre para filtrar categorías hijas (opcional).
+     * null = obtener solo raíces.
+     * undefined = sin filtro de padre.
+     */
+    parentId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /**
+     * Número de página (opcional, default: 1).
+     */
+    page: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, number, string>, number, string>>>;
+    /**
+     * Tamaño de página (opcional, default: 50, max: 100).
+     */
+    pageSize: z.ZodDefault<z.ZodOptional<z.ZodEffects<z.ZodEffects<z.ZodString, number, string>, number, string>>>;
+    /**
+     * Campo por el cual ordenar (opcional, default: displayOrder).
+     */
+    sortBy: z.ZodDefault<z.ZodOptional<z.ZodEnum<["name", "code", "displayOrder", "createdAt"]>>>;
+    /**
+     * Dirección del ordenamiento (opcional, default: asc).
+     */
+    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;
+}>;
+//# sourceMappingURL=getCategories.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCategories.schema.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/getCategories.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB;IAC5B;;;OAGG;;IAGH;;OAEG;;IAGH;;;OAGG;;IAOH;;;;OAIG;;IAOH;;OAEG;;IASH;;OAEG;;IAYH;;OAEG;;IAMH;;OAEG;;;;;;;;;;;;;;;;;;;;EAEL,CAAC"}

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

@@ -0,0 +1,82 @@
+/**
+ * @fileoverview Esquema Zod para validación de petición GET /categories
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones para listar categorías con filtros y paginación.
+ *
+ * **Child Container DI:**
+ * - tenantId viene del header X-Tenant-ID (no query param)
+ */
+import { z } from 'zod';
+import { CategoryScopeEnum, CategoryStatusEnum } from './createCategory.schema';
+/**
+ * Esquema de validación para listar categorías.
+ *
+ * Soporta filtros (scope, status, parentId), paginación y ordenamiento.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export const getCategoriesSchema = z.object({
+    /**
+     * Scope de categorías a filtrar (requerido por seguridad).
+     * Cada usuario solo debe poder consultar los scopes a los que tiene acceso.
+     */
+    scope: CategoryScopeEnum,
+    /**
+     * Estado de categorías a filtrar (opcional).
+     */
+    status: CategoryStatusEnum.optional(),
+    /**
+     * Texto de búsqueda (opcional).
+     * Busca en nombre y código de categoría.
+     */
+    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(),
+    /**
+     * ID del padre para filtrar categorías hijas (opcional).
+     * null = obtener solo raíces.
+     * undefined = sin filtro de padre.
+     */
+    parentId: z
+        .string()
+        .uuid('El parentId debe ser un UUID válido')
+        .nullable()
+        .optional(),
+    /**
+     * Número de página (opcional, default: 1).
+     */
+    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'),
+    /**
+     * Tamaño de página (opcional, default: 50, max: 100).
+     */
+    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'),
+    /**
+     * Campo por el cual ordenar (opcional, default: displayOrder).
+     */
+    sortBy: z
+        .enum(['name', 'code', 'displayOrder', 'createdAt'])
+        .optional()
+        .default('displayOrder'),
+    /**
+     * Dirección del ordenamiento (opcional, default: asc).
+     */
+    sortOrder: z.enum(['asc', 'desc']).optional().default('asc'),
+});
+//# sourceMappingURL=getCategories.schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCategories.schema.js","sourceRoot":"","sources":["../../../src/category/schemas/getCategories.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC;;;OAGG;IACH,KAAK,EAAE,iBAAiB;IAExB;;OAEG;IACH,MAAM,EAAE,kBAAkB,CAAC,QAAQ,EAAE;IAErC;;;OAGG;IACH,CAAC,EAAE,CAAC;SACC,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,uDAAuD,CAAC;SAC/D,GAAG,CAAC,GAAG,EAAE,wDAAwD,CAAC;SAClE,QAAQ,EAAE;IAEf;;;;OAIG;IACH,QAAQ,EAAE,CAAC;SACN,MAAM,EAAE;SACR,IAAI,CAAC,qCAAqC,CAAC;SAC3C,QAAQ,EAAE;SACV,QAAQ,EAAE;IAEf;;OAEG;IACH,IAAI,EAAE,CAAC;SACF,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,qCAAqC,CAAC;SACrD,SAAS,CAAC,MAAM,CAAC;SACjB,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,+BAA+B,CAAC;SAC1D,QAAQ,EAAE;SACV,OAAO,CAAC,GAAG,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,CAAC;SACN,MAAM,EAAE;SACR,KAAK,CAAC,OAAO,EAAE,+CAA+C,CAAC;SAC/D,SAAS,CAAC,MAAM,CAAC;SACjB,MAAM,CACH,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAC/B,8CAA8C,CACjD;SACA,QAAQ,EAAE;SACV,OAAO,CAAC,IAAI,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,WAAW,CAAC,CAAC;SACnD,QAAQ,EAAE;SACV,OAAO,CAAC,cAAc,CAAC;IAE5B;;OAEG;IACH,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC/D,CAAC,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Esquema Zod para validación de petición GET /categories/:id
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones para obtener una categoría por ID.
+ * Arquitectura Child Container DI: tenantId viene del header X-Tenant-ID (no query param).
+ */
+import { z } from 'zod';
+/**
+ * Esquema de validación para obtener categoría por ID.
+ *
+ * Valida parámetros de ruta y query params.
+ *
+ * NOTA: tenantId viene del header X-Tenant-ID, NO se valida aquí.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export declare const getCategoryByIdSchema: z.ZodObject<{
+    /**
+     * ID de la categoría a obtener (UUID v4).
+     */
+    id: z.ZodString;
+    /**
+     * Scope de la categoría (requerido por seguridad).
+     * Valida que el usuario tenga acceso al scope de la categoría solicitada.
+     */
+    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";
+}>;
+//# sourceMappingURL=getCategoryById.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCategoryById.schema.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/getCategoryById.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB;IAC9B;;OAEG;;IAGH;;;OAGG;;;;;;;;EAEL,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Esquema Zod para validación de petición GET /categories/:id
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Define validaciones para obtener una categoría por ID.
+ * 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 categoría por ID.
+ *
+ * Valida parámetros de ruta y query params.
+ *
+ * NOTA: tenantId viene del header X-Tenant-ID, NO se valida aquí.
+ *
+ * @constant
+ * @since 1.0.0
+ */
+export const getCategoryByIdSchema = z.object({
+    /**
+     * ID de la categoría a obtener (UUID v4).
+     */
+    id: z.string().uuid('El id debe ser un UUID válido'),
+    /**
+     * Scope de la categoría (requerido por seguridad).
+     * Valida que el usuario tenga acceso al scope de la categoría solicitada.
+     */
+    scope: CategoryScopeEnum,
+});
+//# sourceMappingURL=getCategoryById.schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCategoryById.schema.js","sourceRoot":"","sources":["../../../src/category/schemas/getCategoryById.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,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,+BAA+B,CAAC;IAEpD;;;OAGG;IACH,KAAK,EAAE,iBAAiB;CAC3B,CAAC,CAAC"}

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

@@ -0,0 +1,44 @@
+/**
+ * @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';
+/**
+ * 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 declare const getCategoryTreeSchema: z.ZodObject<{
+    /**
+     * Scope del árbol de categorías (requerido).
+     */
+    scope: z.ZodEnum<["PRODUCT", "SERVICE", "EXPENSE", "ASSET", "GL_ACCOUNT", "ACCOUNTING", "PROJECT", "PROCUREMENT", "NAV_POS", "NAV_ECOM"]>;
+    /**
+     * 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.ZodOptional<z.ZodString>;
+    /**
+     * Profundidad máxima del árbol (opcional, default: sin límite).
+     * 1 = solo raíces, 2 = raíces + hijos directos, etc.
+     */
+    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;
+}>;
+//# sourceMappingURL=getCategoryTree.schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getCategoryTree.schema.d.ts","sourceRoot":"","sources":["../../../src/category/schemas/getCategoryTree.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB;IAC9B;;OAEG;;IAGH;;;OAGG;;IAGH;;;OAGG;;;;;;;;;;EAOL,CAAC"}