@pittaj/contracts 1.2.2

package/dist/payment-method/schemas/paymentMethodSchemas.js

@@ -0,0 +1,100 @@
+/**
+ * @fileoverview Schemas Zod para validación HTTP del módulo PaymentMethod
+ * @module infrastructure/api/schemas
+ * @version 1.0.0
+ */
+import { z } from 'zod';
+import { PAYMENT_METHOD_CONSTANTS } from '../constants';
+const { LIMITS, TYPES, STATUSES } = PAYMENT_METHOD_CONSTANTS;
+// ============================================================
+// SUB-SCHEMAS
+// ============================================================
+/** Configuración del método de pago (comisiones, referencias, etc.) */
+const paymentMethodConfigSchema = z.object({
+    isCashCount: z.boolean().default(false),
+    requiresCustomer: z.boolean().default(false),
+    requiresReference: z.boolean().default(false),
+    commission: z.number().min(0).max(LIMITS.MAX_COMMISSION_PERCENT).default(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 paymentMethodTypeEnum = z.enum(TYPES);
+const paymentMethodStatusEnum = z.enum(STATUSES);
+// ============================================================
+// PARAMS
+// ============================================================
+/** Validación de parámetro :id en la URL */
+export const paymentMethodIdParamSchema = z.object({
+    id: z.string().uuid('El ID debe ser un UUID válido'),
+});
+// ============================================================
+// COMMANDS
+// ============================================================
+/** POST /api/payment-methods — Crear método de pago */
+export const createPaymentMethodSchema = z.object({
+    id: z.string().uuid(),
+    name: z.string().min(LIMITS.MIN_NAME_LENGTH).max(LIMITS.MAX_NAME_LENGTH),
+    type: paymentMethodTypeEnum,
+    displayOrder: z.number().int().min(LIMITS.MIN_DISPLAY_ORDER).max(LIMITS.MAX_DISPLAY_ORDER).optional(),
+    config: paymentMethodConfigSchema.optional(),
+    deviceId: z.string().optional(),
+});
+/** POST /api/payment-methods/defaults — Crear métodos por defecto */
+export const createDefaultsSchema = z.object({
+    deviceId: z.string().optional(),
+});
+/** PUT /api/payment-methods/:id — Actualizar método de pago */
+export const updatePaymentMethodSchema = z.object({
+    version: z.number().int().min(1),
+    name: z.string().min(LIMITS.MIN_NAME_LENGTH).max(LIMITS.MAX_NAME_LENGTH).optional(),
+    displayOrder: z.number().int().min(LIMITS.MIN_DISPLAY_ORDER).max(LIMITS.MAX_DISPLAY_ORDER).optional(),
+    config: paymentMethodConfigSchema.optional(),
+});
+/** DELETE /api/payment-methods/:id (query params) */
+export const deletePaymentMethodSchema = z.object({
+    version: z.coerce.number().int().min(1),
+});
+/** POST /api/payment-methods/:id/activate | deactivate — Version en body */
+export const versionBodySchema = z.object({
+    version: z.number().int().min(1),
+});
+// ============================================================
+// QUERIES
+// ============================================================
+/** GET /api/payment-methods — Listar con filtros */
+export const getPaymentMethodsSchema = z.object({
+    q: z.string().max(100).optional(),
+    type: paymentMethodTypeEnum.optional(),
+    status: paymentMethodStatusEnum.optional(),
+    page: z.coerce.number().int().min(1).optional(),
+    limit: z.coerce.number().int().min(1).max(LIMITS.MAX_PAGE_SIZE).optional(),
+});
+// ============================================================
+// SYNC
+// ============================================================
+/** POST /api/payment-methods/sync/push */
+export const syncPushPaymentMethodSchema = z.object({
+    tenantId: z.string().uuid(),
+    deviceId: z.string().min(1),
+    changes: z.array(syncChangeSchema).min(1),
+});
+/** POST /api/payment-methods/sync/pull */
+export const syncPullPaymentMethodSchema = 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=paymentMethodSchemas.js.map

package/dist/payment-method/schemas/paymentMethodSchemas.js.map

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

package/dist/permission/PaginatedPermissionsDTO.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview DTO para respuesta paginada de permisos
+ * @module Permission/Application/DTOs
+ * @version 1.0.0
+ */
+import type { PermissionDTO } from './PermissionDTO';
+/**
+ * DTO para respuestas paginadas de permisos
+ *
+ * @interface PaginatedPermissionsDTO
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const response: PaginatedPermissionsDTO = {
+ *   items: [
+ *     { id: '...', code: 'users.create', ... },
+ *     { id: '...', code: 'users.read', ... },
+ *   ],
+ *   total: 78,
+ *   page: 1,
+ *   limit: 50,
+ *   totalPages: 2,
+ *   hasNextPage: true,
+ *   hasPreviousPage: false,
+ * };
+ * ```
+ */
+export interface PaginatedPermissionsDTO {
+    /**
+     * Array de permisos en la página actual
+     */
+    readonly items: PermissionDTO[];
+    /**
+     * Total de permisos que cumplen los filtros
+     */
+    readonly total: number;
+    /**
+     * Número de página actual (1-indexed)
+     */
+    readonly page: number;
+    /**
+     * Cantidad de items por página
+     */
+    readonly limit: number;
+    /**
+     * Total de páginas disponibles
+     */
+    readonly totalPages: number;
+    /**
+     * Indica si hay una página siguiente
+     */
+    readonly hasNextPage: boolean;
+    /**
+     * Indica si hay una página anterior
+     */
+    readonly hasPreviousPage: boolean;
+}
+//# sourceMappingURL=PaginatedPermissionsDTO.d.ts.map

package/dist/permission/PaginatedPermissionsDTO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaginatedPermissionsDTO.d.ts","sourceRoot":"","sources":["../../src/permission/PaginatedPermissionsDTO.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;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;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC"}

package/dist/permission/PaginatedPermissionsDTO.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview DTO para respuesta paginada de permisos
+ * @module Permission/Application/DTOs
+ * @version 1.0.0
+ */
+export {};
+//# sourceMappingURL=PaginatedPermissionsDTO.js.map

package/dist/permission/PaginatedPermissionsDTO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaginatedPermissionsDTO.js","sourceRoot":"","sources":["../../src/permission/PaginatedPermissionsDTO.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/permission/PermissionDTO.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Data Transfer Object para Permission
+ * @module Permission/Application/DTOs
+ * @version 1.0.0
+ */
+/**
+ * DTO para transferir datos de Permission entre capas
+ *
+ * NOTA: Los permisos son GLOBALES (sin tenantId).
+ * Son compartidos por todos los tenants del sistema.
+ *
+ * @interface PermissionDTO
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const dto: PermissionDTO = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   code: 'users.create',
+ *   name: 'Crear Usuario',
+ *   description: 'Permite crear nuevos usuarios en el sistema',
+ *   scope: 'ACTION',
+ *   module: 'users',
+ *   createdAt: '2025-01-01T00:00:00Z',
+ *   updatedAt: null,
+ * };
+ * ```
+ */
+export interface PermissionDTO {
+    /**
+     * ID único del permiso (UUID)
+     */
+    readonly id: string;
+    /**
+     * Código único en formato module.action
+     * Ejemplos: 'users.create', 'products.read'
+     */
+    readonly code: string;
+    /**
+     * Nombre descriptivo del permiso
+     * Ejemplo: 'Crear Usuario'
+     */
+    readonly name: string;
+    /**
+     * Descripción detallada de qué permite hacer
+     */
+    readonly description: string;
+    /**
+     * Ámbito del permiso: MODULE, FEATURE, ACTION
+     */
+    readonly scope: string;
+    /**
+     * Módulo al que pertenece el permiso
+     * Ejemplo: 'users', 'products'
+     */
+    readonly module: string;
+    /**
+     * Fecha de creación
+     */
+    readonly createdAt: string;
+    /**
+     * Fecha de última actualización (null si nunca se actualizó)
+     */
+    readonly updatedAt: string | null;
+}
+//# sourceMappingURL=PermissionDTO.d.ts.map

package/dist/permission/PermissionDTO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionDTO.d.ts","sourceRoot":"","sources":["../../src/permission/PermissionDTO.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC"}

package/dist/permission/PermissionDTO.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Data Transfer Object para Permission
+ * @module Permission/Application/DTOs
+ * @version 1.0.0
+ */
+export {};
+//# sourceMappingURL=PermissionDTO.js.map

package/dist/permission/PermissionDTO.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionDTO.js","sourceRoot":"","sources":["../../src/permission/PermissionDTO.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/permission/getPermissionByIdSchema.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @fileoverview Zod schema para validar obtención de permiso por ID
+ * @module Contracts/Permission
+ * @version 1.0.0
+ */
+import { z } from 'zod';
+/**
+ * Schema de validación para GetPermissionByIdQuery
+ *
+ * Valida el parámetro de ruta (path param) para obtener un permiso:
+ * - id: UUID del permiso (formato UUID válido)
+ *
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // En controller
+ * const { id } = getPermissionByIdSchema.parse({ id: c.req.param('id') });
+ * ```
+ */
+export declare const getPermissionByIdSchema: z.ZodObject<{
+    /**
+     * ID del permiso (UUID)
+     * Debe ser un UUID válido
+     */
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+/**
+ * Tipo TypeScript inferido del schema
+ */
+export type GetPermissionByIdSchemaType = z.infer<typeof getPermissionByIdSchema>;
+//# sourceMappingURL=getPermissionByIdSchema.d.ts.map

package/dist/permission/getPermissionByIdSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPermissionByIdSchema.d.ts","sourceRoot":"","sources":["../../src/permission/getPermissionByIdSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,uBAAuB;IAClC;;;OAGG;;;;;;EAIH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC"}

package/dist/permission/getPermissionByIdSchema.js

@@ -0,0 +1,30 @@
+/**
+ * @fileoverview Zod schema para validar obtención de permiso por ID
+ * @module Contracts/Permission
+ * @version 1.0.0
+ */
+import { z } from 'zod';
+/**
+ * Schema de validación para GetPermissionByIdQuery
+ *
+ * Valida el parámetro de ruta (path param) para obtener un permiso:
+ * - id: UUID del permiso (formato UUID válido)
+ *
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // En controller
+ * const { id } = getPermissionByIdSchema.parse({ id: c.req.param('id') });
+ * ```
+ */
+export const getPermissionByIdSchema = z.object({
+    /**
+     * ID del permiso (UUID)
+     * Debe ser un UUID válido
+     */
+    id: z.string().uuid({
+        message: 'El ID debe ser un UUID válido',
+    }),
+});
+//# sourceMappingURL=getPermissionByIdSchema.js.map

package/dist/permission/getPermissionByIdSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPermissionByIdSchema.js","sourceRoot":"","sources":["../../src/permission/getPermissionByIdSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C;;;OAGG;IACH,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC;QAClB,OAAO,EAAE,+BAA+B;KACzC,CAAC;CACH,CAAC,CAAC"}

package/dist/permission/getPermissionsSchema.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @fileoverview Zod schema para validar query de obtención de permisos
+ * @module Contracts/Permission
+ * @version 1.0.0
+ */
+import { z } from 'zod';
+/**
+ * Schema de validación para GetPermissionsQuery
+ *
+ * Valida parámetros de query string para filtrar y paginar permisos:
+ * - module: Filtro opcional por módulo
+ * - scope: Filtro opcional por ámbito (MODULE, FEATURE, ACTION)
+ * - search: Búsqueda opcional por texto
+ * - page: Página actual (default: 1, min: 1)
+ * - limit: Items por página (default: 50, min: 1, max: 100)
+ *
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // En controller
+ * const query = getPermissionsSchema.parse(c.req.query());
+ * ```
+ */
+export declare const getPermissionsSchema: z.ZodObject<{
+    /**
+     * Filtrar por módulo específico
+     * Ejemplo: 'users', 'products', 'categories'
+     */
+    module: z.ZodOptional<z.ZodString>;
+    /**
+     * Filtrar por ámbito del permiso
+     * Valores permitidos: 'MODULE', 'FEATURE', 'ACTION'
+     */
+    scope: z.ZodOptional<z.ZodEnum<["MODULE", "FEATURE", "ACTION"]>>;
+    /**
+     * Búsqueda por texto en código, nombre o descripción
+     * Mínimo 2 caracteres
+     */
+    search: z.ZodOptional<z.ZodString>;
+    /**
+     * Número de página (1-indexed)
+     * Default: 1
+     * Mínimo: 1
+     */
+    page: z.ZodDefault<z.ZodNumber>;
+    /**
+     * Cantidad de items por página
+     * Default: 50
+     * Mínimo: 1
+     * Máximo: 100
+     */
+    limit: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    page: number;
+    limit: number;
+    search?: string | undefined;
+    module?: string | undefined;
+    scope?: "MODULE" | "FEATURE" | "ACTION" | undefined;
+}, {
+    search?: string | undefined;
+    page?: number | undefined;
+    limit?: number | undefined;
+    module?: string | undefined;
+    scope?: "MODULE" | "FEATURE" | "ACTION" | undefined;
+}>;
+/**
+ * Tipo TypeScript inferido del schema
+ */
+export type GetPermissionsSchemaType = z.infer<typeof getPermissionsSchema>;
+//# sourceMappingURL=getPermissionsSchema.d.ts.map

package/dist/permission/getPermissionsSchema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPermissionsSchema.d.ts","sourceRoot":"","sources":["../../src/permission/getPermissionsSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;OAGG;;IAGH;;;OAGG;;IAGH;;;OAGG;;IAGH;;;;OAIG;;IAGH;;;;;OAKG;;;;;;;;;;;;;;EAEH,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/permission/getPermissionsSchema.js

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Zod schema para validar query de obtención de permisos
+ * @module Contracts/Permission
+ * @version 1.0.0
+ */
+import { z } from 'zod';
+/**
+ * Schema de validación para GetPermissionsQuery
+ *
+ * Valida parámetros de query string para filtrar y paginar permisos:
+ * - module: Filtro opcional por módulo
+ * - scope: Filtro opcional por ámbito (MODULE, FEATURE, ACTION)
+ * - search: Búsqueda opcional por texto
+ * - page: Página actual (default: 1, min: 1)
+ * - limit: Items por página (default: 50, min: 1, max: 100)
+ *
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * // En controller
+ * const query = getPermissionsSchema.parse(c.req.query());
+ * ```
+ */
+export const getPermissionsSchema = z.object({
+    /**
+     * Filtrar por módulo específico
+     * Ejemplo: 'users', 'products', 'categories'
+     */
+    module: z.string().min(1).max(50).optional(),
+    /**
+     * Filtrar por ámbito del permiso
+     * Valores permitidos: 'MODULE', 'FEATURE', 'ACTION'
+     */
+    scope: z.enum(['MODULE', 'FEATURE', 'ACTION']).optional(),
+    /**
+     * Búsqueda por texto en código, nombre o descripción
+     * Mínimo 2 caracteres
+     */
+    search: z.string().min(2).max(100).optional(),
+    /**
+     * Número de página (1-indexed)
+     * Default: 1
+     * Mínimo: 1
+     */
+    page: z.coerce.number().int().min(1).default(1),
+    /**
+     * Cantidad de items por página
+     * Default: 50
+     * Mínimo: 1
+     * Máximo: 100
+     */
+    limit: z.coerce.number().int().min(1).max(100).default(50),
+});
+//# sourceMappingURL=getPermissionsSchema.js.map

package/dist/permission/getPermissionsSchema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getPermissionsSchema.js","sourceRoot":"","sources":["../../src/permission/getPermissionsSchema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;IAE5C;;;OAGG;IACH,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,EAAE;IAEzD;;;OAGG;IACH,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IAE7C;;;;OAIG;IACH,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC3D,CAAC,CAAC"}

package/dist/permission/index.d.ts

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

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

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

package/dist/permission/index.js

@@ -0,0 +1,3 @@
+export * from './schemas';
+export * from './responses';
+//# sourceMappingURL=index.js.map

package/dist/permission/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/permission/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/permission/responses/PaginatedPermissionsResponse.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileoverview DTO para respuesta paginada de permisos
+ * @module Permission/Application/DTOs
+ * @version 1.0.0
+ */
+import type { PermissionResponse } from './PermissionResponse';
+/**
+ * DTO para respuestas paginadas de permisos
+ *
+ * @interface PaginatedPermissionsResponse
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const response: PaginatedPermissionsResponse = {
+ *   items: [
+ *     { id: '...', code: 'users.create', ... },
+ *     { id: '...', code: 'users.read', ... },
+ *   ],
+ *   total: 78,
+ *   page: 1,
+ *   limit: 50,
+ *   totalPages: 2,
+ *   hasNextPage: true,
+ *   hasPreviousPage: false,
+ * };
+ * ```
+ */
+export interface PaginatedPermissionsResponse {
+    /**
+     * Array de permisos en la página actual
+     */
+    readonly items: PermissionResponse[];
+    /**
+     * Total de permisos que cumplen los filtros
+     */
+    readonly total: number;
+    /**
+     * Número de página actual (1-indexed)
+     */
+    readonly page: number;
+    /**
+     * Cantidad de items por página
+     */
+    readonly limit: number;
+    /**
+     * Total de páginas disponibles
+     */
+    readonly totalPages: number;
+    /**
+     * Indica si hay una página siguiente
+     */
+    readonly hasNextPage: boolean;
+    /**
+     * Indica si hay una página anterior
+     */
+    readonly hasPreviousPage: boolean;
+}
+//# sourceMappingURL=PaginatedPermissionsResponse.d.ts.map

package/dist/permission/responses/PaginatedPermissionsResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaginatedPermissionsResponse.d.ts","sourceRoot":"","sources":["../../../src/permission/responses/PaginatedPermissionsResponse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;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;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC"}

package/dist/permission/responses/PaginatedPermissionsResponse.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview DTO para respuesta paginada de permisos
+ * @module Permission/Application/DTOs
+ * @version 1.0.0
+ */
+export {};
+//# sourceMappingURL=PaginatedPermissionsResponse.js.map

package/dist/permission/responses/PaginatedPermissionsResponse.js.map

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

package/dist/permission/responses/PermissionResponse.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Data Transfer Object para Permission
+ * @module Permission/Application/DTOs
+ * @version 1.0.0
+ */
+/**
+ * DTO para transferir datos de Permission entre capas
+ *
+ * NOTA: Los permisos son GLOBALES (sin tenantId).
+ * Son compartidos por todos los tenants del sistema.
+ *
+ * @interface PermissionResponse
+ * @since 1.0.0
+ *
+ * @example
+ * ```typescript
+ * const dto: PermissionResponse = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   code: 'users.create',
+ *   name: 'Crear Usuario',
+ *   description: 'Permite crear nuevos usuarios en el sistema',
+ *   scope: 'ACTION',
+ *   module: 'users',
+ *   createdAt: '2025-01-01T00:00:00Z',
+ *   updatedAt: null,
+ * };
+ * ```
+ */
+export interface PermissionResponse {
+    /**
+     * ID único del permiso (UUID)
+     */
+    readonly id: string;
+    /**
+     * Código único en formato module.action
+     * Ejemplos: 'users.create', 'products.read'
+     */
+    readonly code: string;
+    /**
+     * Nombre descriptivo del permiso
+     * Ejemplo: 'Crear Usuario'
+     */
+    readonly name: string;
+    /**
+     * Descripción detallada de qué permite hacer
+     */
+    readonly description: string;
+    /**
+     * Ámbito del permiso: MODULE, FEATURE, ACTION
+     */
+    readonly scope: string;
+    /**
+     * Módulo al que pertenece el permiso
+     * Ejemplo: 'users', 'products'
+     */
+    readonly module: string;
+    /**
+     * Fecha de creación
+     */
+    readonly createdAt: string;
+    /**
+     * Fecha de última actualización (null si nunca se actualizó)
+     */
+    readonly updatedAt: string | null;
+}
+//# sourceMappingURL=PermissionResponse.d.ts.map

package/dist/permission/responses/PermissionResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PermissionResponse.d.ts","sourceRoot":"","sources":["../../../src/permission/responses/PermissionResponse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC"}

package/dist/permission/responses/PermissionResponse.js

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Data Transfer Object para Permission
+ * @module Permission/Application/DTOs
+ * @version 1.0.0
+ */
+export {};
+//# sourceMappingURL=PermissionResponse.js.map

package/dist/permission/responses/PermissionResponse.js.map

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

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

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