@pittaj/contracts 1.2.2

package/dist/cash-closure/schemas/cashClosureSchemas.js

@@ -0,0 +1,121 @@
+/**
+ * @fileoverview Schemas Zod para validación HTTP del módulo CashClosure
+ * @module infrastructure/api/schemas
+ * @version 1.0.0
+ */
+import { z } from 'zod';
+import { CASH_CLOSURE_CONSTANTS } from '../constants';
+const { LIMITS, STATUSES, SHIFTS, CURRENCIES } = CASH_CLOSURE_CONSTANTS;
+// ============================================================
+// SUB-SCHEMAS
+// ============================================================
+/** Resumen de pago por método */
+const paymentSummarySchema = z.object({
+    paymentMethodId: z.string().uuid(),
+    paymentMethodName: z.string().min(1),
+    isCashCount: z.boolean().default(false),
+    expectedAmount: z.object({
+        amount: z.number().min(0),
+        currency: z.enum(CURRENCIES),
+    }),
+    actualAmount: z.object({
+        amount: z.number().min(0),
+        currency: z.enum(CURRENCIES),
+    }),
+    transactionCount: z.number().int().min(0),
+});
+/** Schema para cambios de sincronización */
+const syncChangeSchema = z.object({
+    id: z.string().uuid(),
+    entityType: z.string().min(1),
+    operation: z.enum(['create', 'update', 'delete', 'upsert']),
+    data: z.record(z.unknown()).optional(),
+    version: z.number().int(),
+    localTimestamp: z.coerce.date(),
+    deviceId: z.string().optional(),
+    tenantId: z.string().uuid(),
+});
+// ============================================================
+// ENUMS
+// ============================================================
+const cashClosureStatusEnum = z.enum(STATUSES);
+const cashClosureShiftEnum = z.enum(SHIFTS);
+const currencyEnum = z.enum(CURRENCIES);
+// ============================================================
+// PARAMS
+// ============================================================
+/** Validación de parámetro :id en la URL */
+export const cashClosureIdParamSchema = z.object({
+    id: z.string().uuid('El ID debe ser un UUID válido'),
+});
+// ============================================================
+// COMMANDS
+// ============================================================
+/** POST /api/cash-closures — Crear cierre de caja */
+export const createCashClosureSchema = z.object({
+    id: z.string().uuid(),
+    shift: cashClosureShiftEnum,
+    openedAt: z.coerce.date(),
+    closedAt: z.coerce.date(),
+    posSessionId: z.string().uuid(),
+    locationId: z.string().uuid(),
+    openingFundAmount: z.number().min(LIMITS.MIN_OPENING_FUND).max(LIMITS.MAX_OPENING_FUND),
+    currency: currencyEnum.optional(),
+});
+/** PUT /api/cash-closures/:id — Actualizar cierre de caja */
+export const updateCashClosureSchema = z.object({
+    version: z.number().int().min(1),
+    openingFundAmount: z.number().min(LIMITS.MIN_OPENING_FUND).max(LIMITS.MAX_OPENING_FUND).optional(),
+    currency: currencyEnum.optional(),
+    paymentSummaries: z.array(paymentSummarySchema).max(LIMITS.MAX_PAYMENT_SUMMARIES).optional(),
+    notes: z.string().max(LIMITS.MAX_NOTES_LENGTH).nullable().optional(),
+});
+/** POST /api/cash-closures/:id/submit — Version en body */
+export const versionBodySchema = z.object({
+    version: z.number().int().min(1),
+});
+/** POST /api/cash-closures/:id/reject — Rechazar con razón */
+export const rejectCashClosureSchema = z.object({
+    version: z.number().int().min(1),
+    reason: z.string().min(1).max(LIMITS.MAX_REJECTION_REASON_LENGTH),
+});
+// ============================================================
+// QUERIES
+// ============================================================
+/** GET /api/cash-closures — Listar con filtros */
+export const getCashClosuresSchema = z.object({
+    status: cashClosureStatusEnum.optional(),
+    locationId: z.string().uuid().optional(),
+    userId: z.string().uuid().optional(),
+    dateFrom: z.coerce.date().optional(),
+    dateTo: z.coerce.date().optional(),
+    page: z.coerce.number().int().min(1).optional(),
+    limit: z.coerce.number().int().min(1).max(LIMITS.MAX_PAGE_SIZE).optional(),
+});
+/** GET /api/cash-closures/daily-summary — Resumen diario */
+export const getDailySummarySchema = z.object({
+    dateFrom: z.coerce.date(),
+    dateTo: z.coerce.date(),
+});
+/** GET /api/cash-closures/payment-method-summary — Resumen por método de pago */
+export const getPaymentMethodSummarySchema = z.object({
+    dateFrom: z.coerce.date(),
+    dateTo: z.coerce.date(),
+});
+// ============================================================
+// SYNC
+// ============================================================
+/** POST /api/cash-closures/sync/push */
+export const syncPushCashClosureSchema = z.object({
+    tenantId: z.string().uuid(),
+    deviceId: z.string().min(1),
+    changes: z.array(syncChangeSchema).min(1),
+});
+/** POST /api/cash-closures/sync/pull */
+export const syncPullCashClosureSchema = z.object({
+    tenantId: z.string().uuid(),
+    lastSyncedAt: z.string().datetime().optional(),
+    limit: z.number().int().min(1).max(1000).optional(),
+    offset: z.number().int().min(0).optional(),
+});
+//# sourceMappingURL=cashClosureSchemas.js.map

package/dist/cash-closure/schemas/cashClosureSchemas.js.map

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

package/dist/cash-closure/schemas/index.d.ts

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

package/dist/cash-closure/schemas/index.d.ts.map

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

package/dist/cash-closure/schemas/index.js

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

package/dist/cash-closure/schemas/index.js.map

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

package/dist/category/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileoverview Barrel export para contratos de Category
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Solo schemas Zod para validación compartida.
+ * Los tipos se infieren con z.infer<typeof schema> donde se necesiten.
+ *
+ * @example
+ * ```typescript
+ * import { createCategorySchema } from '@pittaj/lib-contracts/category';
+ * import { z } from 'zod';
+ *
+ * type CreateCategoryPayload = z.infer<typeof createCategorySchema>;
+ * ```
+ */
+export * from './schemas';
+export * from './responses';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/category/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,aAAa,CAAC"}

package/dist/category/index.js

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Barrel export para contratos de Category
+ * @module Contracts/Category
+ * @version 1.0.0
+ *
+ * Solo schemas Zod para validación compartida.
+ * Los tipos se infieren con z.infer<typeof schema> donde se necesiten.
+ *
+ * @example
+ * ```typescript
+ * import { createCategorySchema } from '@pittaj/lib-contracts/category';
+ * import { z } from 'zod';
+ *
+ * type CreateCategoryPayload = z.infer<typeof createCategorySchema>;
+ * ```
+ */
+// Schemas Zod
+export * from './schemas';
+// Migrado desde módulos
+export * from './responses';
+//# sourceMappingURL=index.js.map

package/dist/category/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/category/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,cAAc;AACd,cAAc,WAAW,CAAC;AAE1B,wBAAwB;AACxB,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Response DTO para GetCategories query
+ * @module queries/get-categories
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta al listar categorías.
+ * Co-ubicado con la query y handler para cohesión.
+ */
+/**
+ * Response DTO para item de lista de categorías.
+ *
+ * Similar a CategoryResponse pero optimizado para listados.
+ * Puede excluir campos pesados si es necesario.
+ *
+ * @interface CategoryListResponse
+ * @since 1.0.0
+ */
+export interface CategoryListResponse {
+    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=CategoryListResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryListResponse.d.ts","sourceRoot":"","sources":["../../../src/category/responses/CategoryListResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAoB;IACjC,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/CategoryListResponse.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Response DTO para GetCategories query
+ * @module queries/get-categories
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta al listar categorías.
+ * Co-ubicado con la query y handler para cohesión.
+ */
+export {};
+//# sourceMappingURL=CategoryListResponse.js.map

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

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

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

@@ -0,0 +1,46 @@
+/**
+ * @fileoverview Response DTO para GetCategoryMetadata query
+ * @module queries/get-metadata
+ * @version 1.0.0
+ *
+ * Define la estructura de metadata para sincronización inteligente.
+ * Co-ubicado con la query y handler para cohesión.
+ */
+/**
+ * Response DTO para metadata de categorías.
+ *
+ * Usado por Smart Cache System para detectar cambios sin descargar datos completos.
+ * Permite sincronización eficiente comparando hash/version.
+ *
+ * @interface CategoryMetadataResponse
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const metadata: CategoryMetadataResponse = {
+ *   lastModified: '2025-11-26T10:30:00Z',
+ *   totalCount: 1247,
+ *   hash: 'a3f5c89d2b1e4567890abcdef1234567',
+ *   version: 15234
+ * };
+ * ```
+ */
+export interface CategoryMetadataResponse {
+    /**
+     * Timestamp de última modificación (ISO 8601).
+     */
+    readonly lastModified: string;
+    /**
+     * Total de categorías del tenant.
+     */
+    readonly totalCount: number;
+    /**
+     * Hash SHA256 de todos los datos (detecta cambios).
+     */
+    readonly hash: string;
+    /**
+     * Suma de versiones (incrementa con cada cambio).
+     */
+    readonly version: number;
+}
+//# sourceMappingURL=CategoryMetadataResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryMetadataResponse.d.ts","sourceRoot":"","sources":["../../../src/category/responses/CategoryMetadataResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,wBAAwB;IACrC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B"}

package/dist/category/responses/CategoryMetadataResponse.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Response DTO para GetCategoryMetadata query
+ * @module queries/get-metadata
+ * @version 1.0.0
+ *
+ * Define la estructura de metadata para sincronización inteligente.
+ * Co-ubicado con la query y handler para cohesión.
+ */
+export {};
+//# sourceMappingURL=CategoryMetadataResponse.js.map

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

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

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

@@ -0,0 +1,47 @@
+/**
+ * @fileoverview Response DTO para GetCategoryById query
+ * @module queries/get-by-id
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta al consultar una categoría por ID.
+ * Co-ubicado con la query y handler para cohesión.
+ */
+/**
+ * Response DTO para consulta de categoría individual.
+ *
+ * Retorna todos los datos de una categoría incluyendo auditoría.
+ *
+ * @interface CategoryResponse
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const response: CategoryResponse = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   name: 'Electrónica',
+ *   code: 'CAT-0042',
+ *   scope: 'PRODUCT',
+ *   status: 'ACTIVE'
+ * };
+ * ```
+ */
+export interface CategoryResponse {
+    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=CategoryResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryResponse.d.ts","sourceRoot":"","sources":["../../../src/category/responses/CategoryResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,gBAAgB;IAC7B,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/CategoryResponse.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Response DTO para GetCategoryById query
+ * @module queries/get-by-id
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta al consultar una categoría por ID.
+ * Co-ubicado con la query y handler para cohesión.
+ */
+export {};
+//# sourceMappingURL=CategoryResponse.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Response DTO para GetCategoryTree query
+ * @module queries/get-tree
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta jerárquica del árbol de categorías.
+ * Co-ubicado con la query y handler para cohesión.
+ */
+/**
+ * Response DTO para nodo del árbol de categorías.
+ *
+ * Estructura recursiva que representa el árbol completo.
+ * Cada nodo puede tener hijos anidados.
+ *
+ * @interface CategoryTreeResponse
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const tree: CategoryTreeResponse = {
+ *   id: 'cat-1',
+ *   name: 'Electrónica',
+ *   children: [
+ *     {
+ *       id: 'cat-2',
+ *       name: 'Smartphones',
+ *       children: []
+ *     }
+ *   ]
+ * };
+ * ```
+ */
+export interface CategoryTreeResponse {
+    readonly id: string;
+    readonly name: string;
+    readonly code: string | null;
+    readonly displayCode: string;
+    readonly scope: string;
+    readonly status: string;
+    readonly parentId: string | null;
+    readonly displayOrder: number;
+    readonly path: string;
+    readonly level: number;
+    readonly hasChildren: boolean;
+    readonly childrenCount: number;
+    readonly children: CategoryTreeResponse[];
+}
+//# sourceMappingURL=CategoryTreeResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CategoryTreeResponse.d.ts","sourceRoot":"","sources":["../../../src/category/responses/CategoryTreeResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,oBAAoB;IACjC,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,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAC7C"}

package/dist/category/responses/CategoryTreeResponse.js

@@ -0,0 +1,10 @@
+/**
+ * @fileoverview Response DTO para GetCategoryTree query
+ * @module queries/get-tree
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta jerárquica del árbol de categorías.
+ * Co-ubicado con la query y handler para cohesión.
+ */
+export {};
+//# sourceMappingURL=CategoryTreeResponse.js.map

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

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

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

@@ -0,0 +1,92 @@
+/**
+ * @fileoverview Response DTO para CreateCategory command
+ * @module commands/create-category
+ * @version 1.0.0
+ *
+ * Define la estructura de respuesta después de crear una categoría.
+ * Co-ubicado con el command y handler para cohesión.
+ */
+/**
+ * Response DTO para categoría creada.
+ *
+ * Retorna información esencial después de crear una categoría.
+ * Evita que el cliente tenga que hacer segunda query.
+ *
+ * @interface CreateCategoryResponse
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const response: CreateCategoryResponse = {
+ *   id: 'cat-123',
+ *   code: 'CAT-0042',
+ *   displayCode: 'CAT-0042',
+ *   name: 'Electrónica',
+ *   scope: 'PRODUCT',
+ *   status: 'ACTIVE',
+ *   parentId: null,
+ *   tenantId: 'tenant-123',
+ *   createdAt: new Date(),
+ *   createdBy: 'user-456'
+ * };
+ * ```
+ */
+export interface CreateCategoryResponse {
+    /**
+     * ID único de la categoría.
+     */
+    readonly id: string;
+    /**
+     * Código definitivo (null si es offline).
+     */
+    readonly code: string | null;
+    /**
+     * Código para mostrar en UI (temporal o definitivo).
+     */
+    readonly displayCode: string;
+    /**
+     * Nombre de la categoría.
+     */
+    readonly name: string;
+    /**
+     * Alcance de la categoría.
+     */
+    readonly scope: string;
+    /**
+     * Estado de la categoría.
+     */
+    readonly status: string;
+    /**
+     * ID de la categoría padre (null si es raíz).
+     */
+    readonly parentId: string | null;
+    /**
+     * ID del tenant propietario.
+     */
+    readonly tenantId: string;
+    /**
+     * Orden de visualización.
+     */
+    readonly displayOrder: number;
+    /**
+     * Path jerárquico.
+     */
+    readonly path: string;
+    /**
+     * Nivel en el árbol (0 = raíz).
+     */
+    readonly level: number;
+    /**
+     * Atributos adicionales.
+     */
+    readonly attributes: Record<string, any> | null;
+    /**
+     * Timestamp de creación.
+     */
+    readonly createdAt: Date;
+    /**
+     * Usuario que creó.
+     */
+    readonly createdBy: string;
+}
+//# sourceMappingURL=CreateCategoryResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CreateCategoryResponse.d.ts","sourceRoot":"","sources":["../../../src/category/responses/CreateCategoryResponse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,WAAW,sBAAsB;IACnC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC;IAEhD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B"}

package/dist/category/responses/CreateCategoryResponse.js

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

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

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

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

@@ -0,0 +1,7 @@
+import type { CategoryListResponse } from './CategoryListResponse';
+export interface SyncPullResponse {
+    changes: CategoryListResponse[];
+    lastSyncedAt: Date;
+    hasMore: boolean;
+}
+//# sourceMappingURL=SyncPullResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SyncPullResponse.d.ts","sourceRoot":"","sources":["../../../src/category/responses/SyncPullResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,oBAAoB,EAAE,CAAC;IAChC,YAAY,EAAE,IAAI,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACpB"}

package/dist/category/responses/SyncPullResponse.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SyncPullResponse.js.map

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

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

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

@@ -0,0 +1,7 @@
+import type { SyncBatchResult } from '../../shared';
+/**
+ * Re-exportar el tipo de dominio como Response del Application Layer.
+ * Esto mantiene la separación de capas mientras reutiliza el tipo.
+ */
+export type SyncPushResponse = SyncBatchResult;
+//# sourceMappingURL=SyncPushResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SyncPushResponse.d.ts","sourceRoot":"","sources":["../../../src/category/responses/SyncPushResponse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAEpD;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,eAAe,CAAC"}

package/dist/category/responses/SyncPushResponse.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=SyncPushResponse.js.map

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

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