@nextsparkjs/core 0.1.0-beta.75 → 0.1.0-beta.77

package/dist/lib/api/auth/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/auth/permissions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAGjD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAOhE;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,cAAc,EAC1B,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAYT"}

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

@@ -0,0 +1,58 @@
+import { NextRequest } from 'next/server';
+/**
+ * Información de autenticación de API Key
+ */
+export interface ApiKeyAuth {
+    userId: string;
+    keyId: string;
+    scopes: string[];
+}
+/**
+ * Check if auth object has a specific scope
+ */
+export declare function hasScope(auth: {
+    scopes: string[];
+}, requiredScope: string): boolean;
+/**
+ * Resultado de validación de API Key
+ */
+export interface ApiKeyValidationResult {
+    success: boolean;
+    auth?: ApiKeyAuth;
+    error?: string;
+}
+/**
+ * Valida una API Key desde el header Authorization o x-api-key
+ */
+export declare function validateApiKey(request: NextRequest): Promise<ApiKeyAuth | null>;
+/**
+ * Verifica si una autenticación tiene alguno de los scopes requeridos
+ */
+export declare function hasAnyScope(auth: ApiKeyAuth, requiredScopes: string[]): boolean;
+/**
+ * Verifica si una autenticación tiene todos los scopes requeridos
+ */
+export declare function hasAllScopes(auth: ApiKeyAuth, requiredScopes: string[]): boolean;
+/**
+ * Obtiene información del usuario asociado a una API key
+ */
+export declare function getApiKeyUser(auth: ApiKeyAuth): Promise<{
+    id: string;
+    email: string;
+    firstName: string | null;
+    lastName: string | null;
+    role: string;
+}>;
+/**
+ * Verifica si un usuario puede crear API keys
+ */
+export declare function canCreateApiKeys(userId: string): Promise<boolean>;
+/**
+ * Valida que los scopes solicitados sean permitidos para el usuario
+ */
+export declare function validateScopesForUser(userId: string, requestedScopes: string[]): Promise<{
+    valid: boolean;
+    allowedScopes: string[];
+    deniedScopes: string[];
+}>;
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/lib/api/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAEnF;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoHrF;AAiDD;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAM/E;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAMhF;AAiBD;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU;QAG1C,MAAM;WACH,MAAM;eACF,MAAM,GAAG,IAAI;cACd,MAAM,GAAG,IAAI;UACjB,MAAM;GAWjB;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBvE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAC9F,KAAK,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB,CAAC,CAuDD"}

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

@@ -0,0 +1,48 @@
+/**
+ * Sistema de cache optimizado para rate limiting y datos frecuentes
+ * Implementación in-memory con TTL y LRU eviction
+ */
+declare class MemoryCache<T> {
+    private cache;
+    private maxSize;
+    private defaultTTL;
+    private cleanupInterval;
+    constructor(maxSize?: number, defaultTTL?: number);
+    set(key: string, value: T, ttl?: number): void;
+    get(key: string): T | null;
+    delete(key: string): boolean;
+    has(key: string): boolean;
+    clear(): void;
+    size(): number;
+    destroy(): void;
+    private evictLRU;
+    private cleanup;
+    getStats(): {
+        total: number;
+        active: number;
+        expired: number;
+        maxSize: number;
+    };
+}
+export declare const rateLimitCache: MemoryCache<{
+    count: number;
+    resetTime: number;
+}>;
+export declare const apiKeyCache: MemoryCache<{
+    id: string;
+    userId: string;
+    scopes: string[];
+    status: "active" | "inactive" | "expired";
+    expiresAt: string | null;
+    failedAttempts: number | null;
+    lockedUntil: string | null;
+}>;
+export declare const userCache: MemoryCache<{
+    id: string;
+    role: string;
+    email: string;
+}>;
+export declare function getCacheKey(prefix: string, ...parts: string[]): string;
+export declare function invalidatePattern(cache: MemoryCache<unknown>, pattern: string): void;
+export {};
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/lib/api/cache.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,cAAM,WAAW,CAAC,CAAC;IACjB,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,eAAe,CAA+B;gBAE1C,OAAO,GAAE,MAAc,EAAE,UAAU,GAAE,MAAe;IAUhE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAgB9C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAqB1B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAI5B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAgBzB,KAAK,IAAI,IAAI;IAIb,IAAI,IAAI,MAAM;IAId,OAAO,IAAI,IAAI;IAQf,OAAO,CAAC,QAAQ;IAgBhB,OAAO,CAAC,OAAO;IAcf,QAAQ;;;;;;CAoBT;AAGD,eAAO,MAAM,cAAc;WAClB,MAAM;eACF,MAAM;EACJ,CAAC;AAEhB,eAAO,MAAM,WAAW;QAClB,MAAM;YACF,MAAM;YACN,MAAM,EAAE;YACR,QAAQ,GAAG,UAAU,GAAG,SAAS;eAC9B,MAAM,GAAG,IAAI;oBACR,MAAM,GAAG,IAAI;iBAChB,MAAM,GAAG,IAAI;EACZ,CAAC;AAEjB,eAAO,MAAM,SAAS;QAChB,MAAM;UACJ,MAAM;WACL,MAAM;EACC,CAAC;AAGjB,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAEtE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CASpF"}

package/dist/lib/api/distributed-cache.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Distributed Cache System (Two-Tier: L1 Memory + L2 Redis)
+ *
+ * Provides distributed caching for multi-instance deployments using:
+ * - L1: In-memory cache for fastest access (per-instance)
+ * - L2: Redis (Upstash) for shared cache across instances
+ *
+ * Falls back gracefully when Redis is not configured.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage
+ * await cacheSet('user:123', userData, 300)
+ * const user = await cacheGet<UserData>('user:123')
+ *
+ * // With tags for invalidation
+ * await cacheSet('user:123', userData, 300, ['users', 'user:123'])
+ * await cacheInvalidateByTag('users') // Invalidates all user caches
+ * ```
+ */
+declare class L1MemoryCache {
+    private cache;
+    private tagIndex;
+    private maxSize;
+    private cleanupInterval;
+    constructor(maxSize?: number);
+    set<T>(key: string, value: T, ttlMs: number, tags?: string[]): void;
+    get<T>(key: string): T | null;
+    delete(key: string): boolean;
+    invalidateByTag(tag: string): number;
+    clear(): void;
+    /**
+     * Evicts the oldest entry (FIFO - First In, First Out).
+     * JavaScript Maps maintain insertion order, so the first key is the oldest.
+     */
+    private evictOldest;
+    private cleanup;
+    destroy(): void;
+    getStats(): {
+        size: number;
+        maxSize: number;
+        tagCount: number;
+    };
+}
+declare let l1Cache: L1MemoryCache;
+/**
+ * Get a value from the distributed cache
+ *
+ * Checks L1 (memory) first, then L2 (Redis) if not found.
+ * When found in L2, populates L1 for subsequent accesses.
+ *
+ * @param key - Cache key
+ * @returns Cached value or null if not found/expired
+ */
+export declare function cacheGet<T>(key: string): Promise<T | null>;
+/**
+ * Set a value in the distributed cache
+ *
+ * Stores in both L1 (memory) and L2 (Redis).
+ * Uses tags for efficient bulk invalidation.
+ *
+ * @param key - Cache key
+ * @param value - Value to cache
+ * @param ttlSeconds - Time to live in seconds (default: 300 = 5 minutes)
+ * @param tags - Optional tags for bulk invalidation
+ */
+export declare function cacheSet<T>(key: string, value: T, ttlSeconds?: number, tags?: string[]): Promise<void>;
+/**
+ * Delete a specific key from the cache
+ *
+ * Removes from both L1 and L2.
+ *
+ * @param key - Cache key to delete
+ */
+export declare function cacheDelete(key: string): Promise<boolean>;
+/**
+ * Invalidate all cache entries with a specific tag
+ *
+ * Useful for invalidating related caches, e.g., all user-related caches
+ * when user data changes.
+ *
+ * @param tag - Tag to invalidate
+ * @returns Number of entries invalidated (from L1)
+ */
+export declare function cacheInvalidateByTag(tag: string): Promise<number>;
+/**
+ * Clear all cache entries
+ *
+ * Use with caution - clears entire cache.
+ * Uses SCAN for Redis to avoid blocking (safe for production).
+ */
+export declare function cacheClear(): Promise<void>;
+/**
+ * Check if Redis is available for distributed caching
+ */
+export declare function isDistributedCacheAvailable(): Promise<boolean>;
+/**
+ * Get cache statistics
+ */
+export declare function getCacheStats(): Promise<{
+    l1: {
+        size: number;
+        maxSize: number;
+        tagCount: number;
+    };
+    l2Available: boolean;
+}>;
+/**
+ * Helper to create cache keys with consistent naming
+ */
+export declare function createCacheKey(namespace: string, ...parts: string[]): string;
+export { l1Cache as _l1Cache };
+/**
+ * Reset function for testing (fix #7: properly destroy and recreate)
+ */
+export declare function _resetForTesting(): void;
+/**
+ * Cleanup function for graceful shutdown (fix #1: lifecycle management)
+ * Call this when your application is shutting down.
+ */
+export declare function destroyCache(): void;
+//# sourceMappingURL=distributed-cache.d.ts.map

package/dist/lib/api/distributed-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distributed-cache.d.ts","sourceRoot":"","sources":["../../../src/lib/api/distributed-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAWH,cAAM,aAAa;IACjB,OAAO,CAAC,KAAK,CAA2C;IACxD,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,eAAe,CAA8B;gBAEzC,OAAO,GAAE,MAAc;IAanC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,EAAO,GAAG,IAAI;IA8BvE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,IAAI;IAe7B,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAW5B,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IA6BpC,KAAK,IAAI,IAAI;IAKb;;;OAGG;IACH,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,OAAO;IAef,OAAO,IAAI,IAAI;IAQf,QAAQ;;;;;CAOT;AAGD,QAAA,IAAI,OAAO,eAAsB,CAAA;AAkFjC;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAqChE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,UAAU,GAAE,MAAY,EACxB,IAAI,GAAE,MAAM,EAAO,GAClB,OAAO,CAAC,IAAI,CAAC,CAyBf;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAgB/D;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BvE;AAuBD;;;;;GAKG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAiBhD;AAED;;GAEG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,OAAO,CAAC,CAGpE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAC7C,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAA;IACvD,WAAW,EAAE,OAAO,CAAA;CACrB,CAAC,CAMD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE5E;AAGD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,CAAA;AAE9B;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAWvC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

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

@@ -0,0 +1,151 @@
+/**
+ * Entity API Client
+ *
+ * Centralized API client for entity CRUD operations
+ */
+export interface EntityData {
+    id?: string;
+    [key: string]: unknown;
+}
+export interface EntityListParams {
+    page?: number;
+    limit?: number;
+    userId?: string;
+    filters?: Record<string, string>;
+    includeMeta?: boolean;
+}
+export interface EntityListResponse {
+    success: true;
+    data: EntityData[];
+    info: {
+        timestamp: string;
+        page: number;
+        limit: number;
+        total: number;
+        totalPages: number;
+        hasNextPage: boolean;
+        hasPrevPage: boolean;
+    };
+}
+export interface EntityStats {
+    total: number;
+    recentCount: number;
+    growth: number;
+    status?: {
+        [key: string]: number;
+    };
+}
+export interface BulkOperation {
+    id: string;
+    name: string;
+    description: string;
+    icon?: string;
+    requiresConfirmation?: boolean;
+}
+export interface DashboardEntityResponse {
+    success: true;
+    data: EntityData[];
+    stats: EntityStats;
+    availableOperations: BulkOperation[];
+    info: {
+        timestamp: string;
+        entityType: string;
+        hasOverride: boolean;
+    };
+}
+/**
+ * Generic entity API client
+ */
+export declare class EntityApiClient {
+    private baseUrl;
+    constructor(baseUrl?: string);
+    /**
+     * Get endpoint path from entity configuration using slug
+     * This ensures consistent URLs across routes, endpoints, and navigation
+     */
+    private getEndpointPath;
+    /**
+     * Get list of entities
+     */
+    list(entityType: string, params?: EntityListParams): Promise<EntityListResponse>;
+    /**
+     * Get single entity by ID
+     */
+    get(entityType: string, id: string, includeMeta?: boolean): Promise<EntityData>;
+    /**
+     * Create new entity
+     */
+    create(entityType: string, data: EntityData): Promise<EntityData>;
+    /**
+     * Update entity
+     */
+    update(entityType: string, id: string, data: Partial<EntityData>): Promise<EntityData>;
+    /**
+     * Delete entity
+     */
+    delete(entityType: string, id: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
+    /**
+     * Get dashboard data with stats and bulk operations
+     * Optimized for dashboard views with additional metadata
+     */
+    getDashboardData(entityType: string, params?: EntityListParams): Promise<DashboardEntityResponse>;
+    /**
+     * Get entity statistics for dashboard metrics
+     */
+    getEntityStats(entityType: string): Promise<EntityStats>;
+    /**
+     * Calculate basic stats from entity list (fallback)
+     */
+    private calculateBasicStats;
+    /**
+     * Get available bulk operations for entity
+     */
+    getBulkOperations(entityType: string): Promise<BulkOperation[]>;
+    /**
+     * Execute bulk operation on multiple entities
+     */
+    executeBulkOperation(entityType: string, operationId: string, entityIds: string[], params?: Record<string, unknown>): Promise<{
+        success: boolean;
+        processed: number;
+        errors: string[];
+    }>;
+    /**
+     * Get entity activity/audit log for dashboard
+     */
+    getEntityActivity(entityType: string, limit?: number): Promise<Record<string, unknown>[]>;
+    /**
+     * Detect if entity has custom override (client-side detection)
+     */
+    private detectEntityOverride;
+}
+export declare const entityApi: EntityApiClient;
+export declare const createEntityData: (entityType: string, data: EntityData) => Promise<EntityData>;
+export declare const updateEntityData: (entityType: string, id: string, data: Partial<EntityData>) => Promise<EntityData>;
+export declare const deleteEntityData: (entityType: string, id: string) => Promise<{
+    deleted: boolean;
+    id: string;
+}>;
+export declare const getEntityData: (entityType: string, id: string, includeMeta?: boolean) => Promise<EntityData>;
+export declare const listEntityData: (entityType: string, params?: EntityListParams) => Promise<EntityListResponse>;
+/**
+ * Get child entities for a parent entity
+ * Example: Get order items for an order
+ */
+export declare const getEntityChildren: (parentEntityType: string, parentId: string, childEntityName: string, params?: EntityListParams) => Promise<EntityData[]>;
+/**
+ * Fetch wrapper that automatically includes team context headers
+ * Used by theme components to make API calls with team isolation
+ *
+ * @param url - The URL to fetch (can be relative like '/api/v1/activities')
+ * @param options - Standard fetch options
+ * @returns Promise<Response> - The fetch response
+ *
+ * @example
+ * const response = await fetchWithTeam('/api/v1/activities')
+ * const data = await response.json()
+ */
+export declare function fetchWithTeam(url: string, options?: RequestInit): Promise<Response>;
+//# sourceMappingURL=entities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../../src/lib/api/entities.ts"],"names":[],"mappings":"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"}

package/dist/lib/api/entity/generic-handler.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Generic Entity Handler
+ *
+ * Unified CRUD handler for all entities with dual authentication support.
+ * Used by catch-all routes /api/v1/[entity]/ and /api/v1/[entity]/[id]/
+ *
+ * Phase 2 - Two-Layer Security Model:
+ * - RLS (Database): Team isolation only - IDENTICAL for all entities
+ * - App (Endpoints): User isolation based on access.shared config
+ *
+ * Team context is required for all entity operations via x-team-id header.
+ */
+import { NextRequest, NextResponse } from 'next/server';
+/**
+ * Generic LIST handler (GET /api/v1/[entity])
+ */
+export declare function handleGenericList(request: NextRequest): Promise<NextResponse>;
+/**
+ * Generic CREATE handler (POST /api/v1/[entity])
+ */
+export declare function handleGenericCreate(request: NextRequest): Promise<NextResponse>;
+/**
+ * Generic READ handler (GET /api/v1/[entity]/[id])
+ */
+export declare function handleGenericRead(request: NextRequest, { params }: {
+    params: Promise<{
+        entity: string;
+        id: string;
+    }>;
+}): Promise<NextResponse>;
+/**
+ * Generic UPDATE handler (PATCH /api/v1/[entity]/[id])
+ */
+export declare function handleGenericUpdate(request: NextRequest, { params }: {
+    params: Promise<{
+        entity: string;
+        id: string;
+    }>;
+}): Promise<NextResponse>;
+/**
+ * Generic DELETE handler (DELETE /api/v1/[entity]/[id])
+ */
+export declare function handleGenericDelete(request: NextRequest, { params }: {
+    params: Promise<{
+        entity: string;
+        id: string;
+    }>;
+}): Promise<NextResponse>;
+/**
+ * Handle CORS preflight for all generic endpoints
+ */
+export declare function handleGenericOptions(request: NextRequest): Promise<NextResponse>;
+//# sourceMappingURL=generic-handler.d.ts.map

package/dist/lib/api/entity/generic-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic-handler.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/entity/generic-handler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AA2VvD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAobnF;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA0SrF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAkKpJ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAyStJ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,YAAY,CAAC,CAqGtJ;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAEtF"}

package/dist/lib/api/entity/public-resolver.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Public Entity Resolver
+ *
+ * Similar to entity resolver but specifically for public-facing pages.
+ * Determines which entities are publicly accessible and handles custom overrides.
+ */
+import type { EntityConfig } from '../../entities/types';
+export interface PublicEntityResolution {
+    entityName: string;
+    entityConfig: EntityConfig | null;
+    hasCustomOverride: boolean;
+    isValidPublicEntity: boolean;
+    hasArchivePage: boolean;
+    hasSinglePage: boolean;
+}
+/**
+ * Resolve entity from public URL path
+ */
+export declare function resolvePublicEntityFromUrl(pathname: string): Promise<PublicEntityResolution>;
+/**
+ * Get all public entities that can be handled
+ */
+export declare function getPublicEntities(): Promise<EntityConfig[]>;
+/**
+ * Validate public entity supports the requested page type
+ */
+export declare function validatePublicEntityPage(entityConfig: EntityConfig, pageType: 'archive' | 'single'): boolean;
+//# sourceMappingURL=public-resolver.d.ts.map

package/dist/lib/api/entity/public-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-resolver.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/entity/public-resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAIxD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAA;IACjC,iBAAiB,EAAE,OAAO,CAAA;IAC1B,mBAAmB,EAAE,OAAO,CAAA;IAC5B,cAAc,EAAE,OAAO,CAAA;IACvB,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,CAAC,CA4DlG;AAwBD;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CASjE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,YAAY,EAC1B,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAC7B,OAAO,CAaT"}

package/dist/lib/api/entity/resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Entity Resolver
+ *
+ * Resolves entity configurations from URLs and determines if custom
+ * overrides exist in (contents) folders.
+ */
+import type { EntityConfig } from '../../entities/types';
+export interface EntityResolution {
+    entityName: string;
+    entityConfig: EntityConfig | null;
+    hasCustomOverride: boolean;
+    isValidEntity: boolean;
+}
+/**
+ * Resolve entity from API URL path
+ */
+export declare function resolveEntityFromUrl(pathname: string): Promise<EntityResolution>;
+/**
+ * Get all registered entities that can be handled generically
+ */
+export declare function getGenericEntities(): Promise<string[]>;
+/**
+ * Validate entity supports the requested operation
+ */
+export declare function validateEntityOperation(entityConfig: EntityConfig, operation: 'list' | 'create' | 'read' | 'update' | 'delete'): boolean;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/lib/api/entity/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../../src/lib/api/entity/resolver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAIxD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,YAAY,GAAG,IAAI,CAAA;IACjC,iBAAiB,EAAE,OAAO,CAAA;IAC1B,aAAa,EAAE,OAAO,CAAA;CACvB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkDtF;AA2CD;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAQ5D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAC1D,OAAO,CAkBT"}