@nextsparkjs/core 0.1.0-beta.7 → 0.1.0-beta.70

package/dist/lib/api/helpers.d.ts

@@ -1,178 +0,0 @@
-import { NextRequest, NextResponse } from 'next/server';
-import { ApiKeyAuth } from './auth';
-interface SessionAuth {
-    userId: string;
-    scopes: string[];
-    flags: import('../entities/types').UserFlag[];
-    isSession: true;
-}
-type Auth = ApiKeyAuth | SessionAuth;
-/**
- * Validates authentication using session or API key
- * Prefers session auth if available, falls back to API key
- */
-export declare function validateAndAuthenticateRequest(request: NextRequest): Promise<{
-    auth: Auth;
-    rateLimitResponse?: NextResponse;
-}>;
-/**
- * Valida la API key y aplica rate limiting
- * Esta función debe ser llamada al inicio de cada endpoint API v1
- */
-export declare function validateAndAuthenticateApiRequest(request: NextRequest): Promise<{
-    auth: ApiKeyAuth;
-    rateLimitResponse?: NextResponse;
-}>;
-/**
- * Extrae la información de autenticación API de los headers de la request
- * @deprecated Use validateAndAuthenticateApiRequest instead
- */
-export declare function getApiAuth(request: NextRequest): ApiKeyAuth;
-/**
- * Verifica que la autenticación tenga el scope requerido
- * Retorna un NextResponse de error si no tiene permisos, null si está autorizado
- */
-export declare function checkScope(auth: Auth, requiredScope: string): NextResponse | null;
-/**
- * Crea una respuesta exitosa estandarizada para la API
- */
-export declare function createApiResponse<T>(data: T, responseMeta?: Record<string, unknown>, status?: number): NextResponse<{
-    success: boolean;
-    data: T;
-    info: {
-        timestamp: string;
-    };
-}>;
-/**
- * Crea una respuesta de error estandarizada para la API
- */
-export declare function createApiError(message: string, status?: number, details?: unknown, code?: string): NextResponse<{
-    success: boolean;
-    error: string;
-    code: string;
-    details: unknown;
-    info: {
-        timestamp: string;
-    };
-}>;
-/**
- * Parsea y valida parámetros de paginación
- */
-export declare function parsePaginationParams(request: NextRequest): {
-    page: number;
-    limit: number;
-    offset: number;
-};
-/**
- * Crea metadatos de paginación para respuestas
- */
-export declare function createPaginationMeta(page: number, limit: number, total: number): {
-    page: number;
-    limit: number;
-    total: number;
-    totalPages: number;
-    hasNextPage: boolean;
-    hasPrevPage: boolean;
-};
-/**
- * Registra el uso de la API para auditoría
- */
-export declare function logApiUsage(auth: ApiKeyAuth, request: NextRequest, statusCode: number, responseTime?: number, requestBody?: unknown): Promise<void>;
-/**
- * Wrapper para endpoints que agrega logging automático
- */
-export declare function withApiLogging<T extends unknown[]>(handler: (request: NextRequest, ...args: T) => Promise<NextResponse>): (request: NextRequest, ...args: T) => Promise<NextResponse>;
-/**
- * Valida que un UUID tenga formato válido
- */
-export declare function isValidUUID(uuid: string): boolean;
-/**
- * Sanitiza parámetros de búsqueda para prevenir inyección SQL
- */
-export declare function sanitizeSearchQuery(query: string): string;
-/**
- * Parsea filtros de query parameters
- *
- * Note: Replaces hardcoded allowedFilters array with registry-based configuration.
- * Previously violated anti-hardcoding policies with static filter list.
- */
-export declare function parseFilters(request: NextRequest): Record<string, string>;
-/**
- * Agrega headers de CORS para API externa
- */
-export declare function addCorsHeaders(response: NextResponse, request?: NextRequest): Promise<NextResponse>;
-/**
- * Maneja requests OPTIONS para CORS preflight
- */
-export declare function handleCorsPreflightRequest(request?: NextRequest): Promise<NextResponse>;
-/**
- * Parsea los parámetros de metadata de una request
- * Soporta: metas=all, metas=key1,key2,key3, o sin parámetro
- */
-export interface MetaParams {
-    includeMetadata: boolean;
-    specificKeys?: string[];
-    includeAll: boolean;
-}
-export declare function parseMetaParams(request: NextRequest): MetaParams;
-/**
- * Child entity parameters for request parsing
- */
-export interface ChildParams {
-    includeChildren: boolean;
-    includeAll: boolean;
-    specificChildren?: string[];
-}
-/**
- * Parse child entities parameters from request URL
- * Supports: child=all, child=audiences, child=audiences,products
- */
-export declare function parseChildParams(request: NextRequest): ChildParams;
-/**
- * Helper para incluir metadata en entidades según parámetros de request
- * Uso: await includeEntityMetadata('user', users, metaParams, userId)
- */
-export declare function includeEntityMetadata<T extends {
-    id: string;
-}>(entityType: string, entities: T[], metaParams: MetaParams, userId: string): Promise<(T & {
-    metas?: Record<string, unknown>;
-})[]>;
-/**
- * Helper para incluir child entities en entidades según parámetros de request
- * Uso: await includeEntityChildren('client', clients, childParams, userId, entityConfig)
- */
-export declare function includeEntityChildren<T extends {
-    id: string;
-}>(entityName: string, entities: T[], childParams: ChildParams, userId: string, entityConfig?: unknown): Promise<(T & {
-    child?: Record<string, unknown[]>;
-})[]>;
-/**
- * Helper para incluir metadata en una entidad individual según parámetros de request
- * Uso: await includeEntityMetadataForSingle('user', user, metaParams, userId)
- */
-export declare function includeEntityMetadataForSingle<T extends {
-    id: string;
-}>(entityType: string, entity: T, metaParams: MetaParams, userId: string): Promise<T & {
-    metas?: Record<string, unknown>;
-}>;
-/**
- * Helper para manejar metadata en CREATE/UPDATE: responder con metadata solo si se envió en el payload
- * Uso: await handleEntityMetadataInResponse('user', entity, metaWasProvided, userId)
- */
-export declare function handleEntityMetadataInResponse<T extends {
-    id: string;
-}>(entityType: string, entity: T, metaWasProvided: boolean, userId: string): Promise<T & {
-    metas?: Record<string, unknown>;
-}>;
-/**
- * Helper para procesar metadata en CREATE/UPDATE
- * Uso: await processEntityMetadata('user', entityId, meta, userId)
- *
- * NOTE: Metas tables do NOT have teamId - security is inherited from parent entity via RLS.
- */
-export declare function processEntityMetadata(entityType: string, entityId: string, meta: unknown, userId: string): Promise<{
-    success: boolean;
-    errors: string[];
-}>;
-export {};
-//# sourceMappingURL=helpers.d.ts.map

package/dist/lib/api/helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/api/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,UAAU,EAAkB,MAAM,QAAQ,CAAC;AAYpD,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,OAAO,mBAAmB,EAAE,QAAQ,EAAE,CAAC;IAC9C,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,KAAK,IAAI,GAAG,UAAU,GAAG,WAAW,CAAC;AAErC;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC;IAClF,IAAI,EAAE,IAAI,CAAC;IACX,iBAAiB,CAAC,EAAE,YAAY,CAAC;CAClC,CAAC,CAoCD;AAgFD;;;GAGG;AACH,wBAAsB,iCAAiC,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC;IACrF,IAAI,EAAE,UAAU,CAAC;IACjB,iBAAiB,CAAC,EAAE,YAAY,CAAC;CAClC,CAAC,CA4BD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAc3D;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAkBjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAE,MAAY;;;;;;GASzG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,MAAY,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,IAAI,CAAC,EAAE,MAAM;;;;;;;;GAWd;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAQA;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM;;;;;;;EAUd;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,WAAW,EACpB,UAAU,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,OAAO,EAAE,EAChD,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,IAEtD,SAAS,WAAW,EAAE,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,YAAY,CAAC,CA6CvE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUzD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAezE;AAUD;;GAEG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAiCzG;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAG7F;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CA0BhE;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,EAAE,OAAO,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,WAAW,CA0BlE;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAClE,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,EAAE,EACb,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,EAAE,CAAC,CA6BtD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAClE,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,EAAE,EACb,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,OAAO,GACrB,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;CAAE,CAAC,EAAE,CAAC,CAgExD;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC3E,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,EACT,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CA2BlD;AAED;;;GAGG;AACH,wBAAsB,8BAA8B,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAC3E,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,CAAC,EACT,eAAe,EAAE,OAAO,EACxB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,GAAG;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CAiBlD;AAoBD;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA+DjD"}

package/dist/lib/api/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * API Library - Public API functionality
- *
- * This module exports all the core functionality for the public API system,
- * including authentication, rate limiting, caching, and utilities.
- */
-export * from './auth';
-export * from './keys';
-export * from './helpers';
-export * from './rate-limit';
-export * from './cache';
-export type { ApiKeyAuth, ApiKeyValidationResult } from './auth';
-export type { ApiScope } from './keys';
-//# sourceMappingURL=index.d.ts.map

package/dist/lib/api/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/api/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AAGxB,YAAY,EAAE,UAAU,EAAE,sBAAsB,EAAE,MAAM,QAAQ,CAAC;AACjE,YAAY,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC"}

package/dist/lib/api/keys.d.ts

@@ -1,129 +0,0 @@
-/**
- * Gestión de API Keys para acceso externo
- */
-export declare class ApiKeyManager {
-    /**
-     * Genera una nueva API key con formato seguro
-     * Formato: sk_live_1234567890abcdef... (56 caracteres total)
-     */
-    static generateApiKey(): Promise<{
-        key: string;
-        hash: string;
-        prefix: string;
-    }>;
-    /**
-     * Valida el formato de una API key
-     */
-    static validateKeyFormat(key: string): boolean;
-    /**
-     * Extrae el prefix de una API key para identificación
-     */
-    static extractPrefix(key: string): string;
-    /**
-     * Genera hash SHA-256 de una API key
-     */
-    static hashKey(key: string): Promise<string>;
-    /**
-     * Valida que los scopes sean válidos
-     */
-    static validateScopes(scopes: string[]): {
-        valid: boolean;
-        invalidScopes: string[];
-    };
-    /**
-     * Genera un nombre sugerido para la API key basado en scopes
-     */
-    static suggestKeyName(scopes: string[]): string;
-}
-/**
- * Definición de scopes disponibles para API keys
- */
-export declare const API_SCOPES: {
-    readonly 'users:read': "Leer información de usuarios";
-    readonly 'users:write': "Crear y actualizar usuarios";
-    readonly 'users:delete': "Eliminar usuarios";
-    readonly 'tasks:read': "Leer tasks";
-    readonly 'tasks:write': "Crear y actualizar tasks";
-    readonly 'tasks:delete': "Eliminar tasks";
-    readonly 'media:read': "Leer información de archivos y media";
-    readonly 'media:write': "Subir y actualizar archivos";
-    readonly 'media:delete': "Eliminar archivos";
-    readonly 'admin:api-keys': "Gestionar API keys";
-    readonly 'admin:users': "Administración completa de usuarios";
-    readonly '*': "Acceso completo (solo superadmin)";
-};
-export type ApiScope = keyof typeof API_SCOPES;
-/**
- * Categorías de scopes para organización en UI
- */
-export declare const SCOPE_CATEGORIES: {
-    readonly users: {
-        readonly name: "Usuarios";
-        readonly description: "Gestión de usuarios del sistema";
-        readonly scopes: ApiScope[];
-    };
-    readonly tasks: {
-        readonly name: "Tasks";
-        readonly description: "Gestión de tareas y TODOs";
-        readonly scopes: ApiScope[];
-    };
-    readonly admin: {
-        readonly name: "Administración";
-        readonly description: "Funciones administrativas";
-        readonly scopes: ApiScope[];
-    };
-    readonly system: {
-        readonly name: "Sistema";
-        readonly description: "Acceso completo al sistema";
-        readonly scopes: ApiScope[];
-    };
-};
-/**
- * Configuración de límites de API keys
- */
-export declare const API_KEY_LIMITS: {
-    readonly maxKeysPerUser: number;
-    readonly maxKeyNameLength: 100;
-    readonly keyExpirationDays: 365;
-};
-/**
- * Configuración de rate limiting por scope
- */
-export declare const RATE_LIMITS: {
-    readonly default: {
-        readonly requests: 1000;
-        readonly windowMs: 60000;
-    };
-    readonly 'users:write': {
-        readonly requests: 100;
-        readonly windowMs: 60000;
-    };
-    readonly 'users:delete': {
-        readonly requests: 10;
-        readonly windowMs: 60000;
-    };
-    readonly 'tasks:write': {
-        readonly requests: 500;
-        readonly windowMs: 60000;
-    };
-    readonly 'teams:invite': {
-        readonly requests: 20;
-        readonly windowMs: 60000;
-    };
-    readonly 'teams:invite:respond': {
-        readonly requests: 50;
-        readonly windowMs: 60000;
-    };
-    readonly '*': {
-        readonly requests: 5000;
-        readonly windowMs: 60000;
-    };
-};
-/**
- * Obtiene el rate limit aplicable para un conjunto de scopes
- */
-export declare function getRateLimitForScopes(scopes: string[]): {
-    requests: number;
-    windowMs: number;
-};
-//# sourceMappingURL=keys.d.ts.map

package/dist/lib/api/keys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/lib/api/keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAa;IACxB;;;OAGG;WACU,cAAc,IAAI,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAyBrF;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAM9C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKzC;;OAEG;WACU,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQlD;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,aAAa,EAAE,MAAM,EAAE,CAAA;KAAE;IAUpF;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM;CAchD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;CAsBb,CAAC;AAEX,MAAM,MAAM,QAAQ,GAAG,MAAM,OAAO,UAAU,CAAC;AAE/C;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;yBAIgC,QAAQ,EAAE;;;;;yBAKV,QAAQ,EAAE;;;;;yBAKtB,QAAQ,EAAE;;;;;yBAKtC,QAAQ,EAAE;;CAErB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,cAAc;;;;CAIjB,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CASd,CAAC;AAEX;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAmB9F"}

package/dist/lib/api/meta.middleware.d.ts

@@ -1,16 +0,0 @@
-import { NextRequest, NextResponse } from 'next/server';
-import { EntityType } from '../../types/meta.types';
-interface RouteContext {
-    params: Promise<{
-        id: string;
-        [key: string]: string;
-    }>;
-}
-/**
- * Middleware que procesa meta datos en endpoints existentes
- */
-export declare function withUnifiedMeta(entityType: EntityType): <T extends {
-    id: string;
-}>(handler: (req: NextRequest, context: RouteContext) => Promise<NextResponse | T | T[]>) => (req: NextRequest, context: RouteContext) => Promise<any>;
-export {};
-//# sourceMappingURL=meta.middleware.d.ts.map

package/dist/lib/api/meta.middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"meta.middleware.d.ts","sourceRoot":"","sources":["../../../src/lib/api/meta.middleware.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGxD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGpD,UAAU,YAAY;IACpB,MAAM,EAAE,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,IACnC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACvC,SAAS,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,YAAY,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,MAE9D,KAAK,WAAW,EAAE,SAAS,YAAY,kBAYjE"}

package/dist/lib/api/permission-middleware.d.ts

@@ -1,94 +0,0 @@
-/**
- * Permission Middleware for API Endpoints
- *
- * Helper functions to integrate permission checks into API routes.
- * Maps HTTP methods to entity actions and validates permissions.
- */
-import type { Permission } from '../permissions/types';
-import { NextResponse } from 'next/server';
-/**
- * Special mapping for list operations (GET on collection)
- */
-export declare const LIST_ACTION = "list";
-/**
- * Get the permission string for an entity action
- *
- * @param entitySlug - Entity slug (e.g., 'customers', 'tasks')
- * @param action - Action being performed (e.g., 'create', 'read', 'list')
- * @returns Permission string (e.g., 'customers.create')
- *
- * @example
- * ```typescript
- * const permission = getEntityPermission('customers', 'create')
- * // => 'customers.create'
- * ```
- */
-export declare function getEntityPermission(entitySlug: string, action: string): Permission;
-/**
- * Get entity action from HTTP method and context
- *
- * @param method - HTTP method (GET, POST, PATCH, DELETE)
- * @param isCollection - Whether this is a collection endpoint (true) or single entity (false)
- * @returns Action string (e.g., 'list', 'read', 'create', 'update', 'delete')
- *
- * @example
- * ```typescript
- * // GET /api/v1/customers (list)
- * const action = getActionFromMethod('GET', true)
- * // => 'list'
- *
- * // GET /api/v1/customers/123 (read single)
- * const action = getActionFromMethod('GET', false)
- * // => 'read'
- * ```
- */
-export declare function getActionFromMethod(method: string, isCollection: boolean): string;
-/**
- * Check if user has permission for entity action
- *
- * This is the main permission check function for API endpoints.
- * Returns either success indicator or error Response.
- *
- * @param userId - User ID
- * @param teamId - Team ID
- * @param entitySlug - Entity slug (e.g., 'customers')
- * @param action - Action being performed (e.g., 'create', 'read', 'list')
- * @returns Success indicator or error Response
- *
- * @example
- * ```typescript
- * // In API route handler
- * const permCheck = await checkEntityPermission(userId, teamId, 'customers', 'create')
- * if (!permCheck.allowed) {
- *   return permCheck.error
- * }
- * // Continue with operation...
- * ```
- */
-export declare function checkEntityPermission(userId: string, teamId: string, entitySlug: string, action: string): Promise<{
-    allowed: true;
-} | {
-    allowed: false;
-    error: NextResponse;
-}>;
-/**
- * Helper for common API pattern: check permission and return early if denied
- *
- * @param userId - User ID
- * @param teamId - Team ID
- * @param entitySlug - Entity slug
- * @param method - HTTP method
- * @param isCollection - Whether this is a collection endpoint
- * @returns null if allowed, error Response if denied
- *
- * @example
- * ```typescript
- * // Simplified usage in API routes
- * const error = await checkEntityPermissionOrFail(userId, teamId, 'customers', 'POST', true)
- * if (error) return error
- *
- * // Continue with operation...
- * ```
- */
-export declare function checkEntityPermissionOrFail(userId: string, teamId: string, entitySlug: string, method: string, isCollection: boolean): Promise<NextResponse | null>;
-//# sourceMappingURL=permission-middleware.d.ts.map

package/dist/lib/api/permission-middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"permission-middleware.d.ts","sourceRoot":"","sources":["../../../src/lib/api/permission-middleware.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAa1C;;GAEG;AACH,eAAO,MAAM,WAAW,SAAS,CAAA;AAEjC;;;;;;;;;;;;GAYG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAElF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAOjF;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC,CAkCtE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAK9B"}

package/dist/lib/api/rate-limit.d.ts

@@ -1,53 +0,0 @@
-import { NextRequest, NextResponse } from 'next/server';
-export interface RateLimitResult {
-    allowed: boolean;
-    remaining: number;
-    resetTime: number;
-    limit: number;
-}
-/**
- * Verifica el rate limit para un identificador específico
- */
-export declare function checkRateLimit(identifier: string, limit?: number, windowMs?: number): RateLimitResult;
-/**
- * Aplica rate limiting a una request API
- */
-export declare function applyRateLimit(request: NextRequest, keyId: string, scopes: string[]): NextResponse | null;
-/**
- * Agrega headers de rate limiting a una respuesta
- */
-export declare function addRateLimitHeaders(response: NextResponse, keyId: string, scopes: string[]): NextResponse;
-/**
- * Middleware helper para aplicar rate limiting automáticamente
- */
-export declare function withRateLimit<T extends unknown[]>(handler: (request: NextRequest, ...args: T) => Promise<NextResponse>): (request: NextRequest, ...args: T) => Promise<NextResponse>;
-/**
- * Obtiene estadísticas de rate limiting para un keyId
- */
-export declare function getRateLimitStats(keyId: string): {
-    currentUsage: number;
-    resetTime: number;
-    isNearLimit: boolean;
-} | null;
-/**
- * Limpia manualmente el rate limit para un keyId (útil para testing)
- */
-export declare function clearRateLimit(keyId: string): void;
-/**
- * Obtiene todas las estadísticas de rate limiting (útil para monitoring)
- */
-export declare function getAllRateLimitStats(): Array<{
-    keyId: string;
-    count: number;
-    resetTime: number;
-}>;
-/**
- * Obtiene estadísticas del cache de rate limiting
- */
-export declare function getRateLimitCacheStats(): {
-    total: number;
-    active: number;
-    expired: number;
-    maxSize: number;
-};
-//# sourceMappingURL=rate-limit.d.ts.map

package/dist/lib/api/rate-limit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"rate-limit.d.ts","sourceRoot":"","sources":["../../../src/lib/api/rate-limit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIxD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAa,EACpB,QAAQ,GAAE,MAAc,GACvB,eAAe,CAyCjB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,GACf,YAAY,GAAG,IAAI,CAkCrB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,GACf,YAAY,CASd;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,OAAO,EAAE,EAC/C,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,YAAY,CAAC,IAEtD,SAAS,WAAW,EAAE,GAAG,MAAM,CAAC,KAAG,OAAO,CAAC,YAAY,CAAC,CA8BvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,OAAO,CAAC;CACtB,GAAG,IAAI,CAaP;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,KAAK,CAAC;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC,CASD;AAED;;GAEG;AACH,wBAAgB,sBAAsB;;;;;EAErC"}

package/dist/lib/auth/api-keys.d.ts

@@ -1,75 +0,0 @@
-/**
- * API Key Authentication System
- *
- * Handles API key validation, scopes, and permissions for external APIs.
- */
-export interface APIKeyValidation {
-    valid: boolean;
-    apiKeyId?: string;
-    clientId?: string;
-    userId?: string;
-    scopes?: string[];
-    reason?: string;
-    metadata?: Record<string, unknown>;
-}
-export interface APIKeyValidationOptions {
-    requiredScopes?: string[];
-    entityName?: string;
-    allowInactive?: boolean;
-}
-interface APIKeyData {
-    id: string;
-    clientId: string;
-    userId?: string;
-    scopes: string[];
-    active: boolean;
-    name: string;
-    lastUsed?: string;
-    expiresAt?: string;
-    metadata?: Record<string, unknown>;
-}
-/**
- * Validate API key and check permissions
- */
-export declare function validateAPIKey(apiKey: string, options?: APIKeyValidationOptions): Promise<APIKeyValidation>;
-/**
- * Generate scope name for entity and action
- */
-export declare function generateScope(entityName: string, action: 'read' | 'create' | 'update' | 'delete'): string;
-/**
- * Check if API key has specific scope
- */
-export declare function hasScope(scopes: string[], requiredScope: string): boolean;
-/**
- * Create API key (mock implementation)
- */
-export declare function createAPIKey(data: {
-    clientId: string;
-    userId?: string;
-    scopes: string[];
-    name: string;
-    expiresAt?: string;
-    metadata?: Record<string, unknown>;
-}): Promise<{
-    apiKey: string;
-    keyData: APIKeyData;
-}>;
-/**
- * Revoke API key
- */
-export declare function revokeAPIKey(apiKey: string): Promise<boolean>;
-/**
- * List API keys for a client
- */
-export declare function listAPIKeys(clientId: string): Promise<APIKeyData[]>;
-/**
- * Get API key analytics
- */
-export declare function getAPIKeyAnalytics(apiKey: string): Promise<{
-    requests: number;
-    lastUsed?: string;
-    scopes: string[];
-    active: boolean;
-} | null>;
-export {};
-//# sourceMappingURL=api-keys.d.ts.map

package/dist/lib/auth/api-keys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-keys.d.ts","sourceRoot":"","sources":["../../../src/lib/auth/api-keys.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,uBAAuB;IACtC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAA;IACzB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,UAAU,UAAU;IAClB,EAAE,EAAE,MAAM,CAAA;IACV,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AA0CD;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,gBAAgB,CAAC,CAwE3B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAEzG;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAIzE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,UAAU,CAAA;CAAE,CAAC,CAYnD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAQnE;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAChE,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,MAAM,EAAE,OAAO,CAAA;CAChB,GAAG,IAAI,CAAC,CAYR"}