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

package/dist/lib/entities/entity-hooks.d.ts

@@ -1,94 +0,0 @@
-/**
- * Entity Hook System Integration
- *
- * Provides WordPress-like hooks for entity operations
- * Allows plugins to extend entity behavior without modifying core code
- */
-import type { EntityConfig } from './types';
-/**
- * Entity operation data for hooks
- */
-export interface EntityHookData<T = Record<string, unknown>> {
-    entityName: string;
-    entityConfig: EntityConfig;
-    data?: T;
-    userId?: string;
-    operation: 'create' | 'read' | 'update' | 'delete';
-    id?: string;
-    changes?: Partial<T>;
-}
-/**
- * Entity validation result
- */
-export interface EntityValidationResult {
-    valid: boolean;
-    errors: string[];
-    data?: unknown;
-}
-/**
- * Entity Hook Manager
- * Provides integration points for plugins to extend entity operations
- */
-export declare class EntityHookManager {
-    private hooks;
-    /**
-     * Hook: Before entity creation
-     * Allows plugins to validate, modify, or prevent entity creation
-     */
-    beforeEntityCreate<T>(entityName: string, data: T, userId?: string): Promise<T>;
-    /**
-     * Hook: After entity creation
-     * Allows plugins to react to entity creation events
-     */
-    afterEntityCreate<T>(entityName: string, data: T, userId?: string): Promise<void>;
-    /**
-     * Hook: Before entity update
-     */
-    beforeEntityUpdate<T>(entityName: string, id: string, changes: Partial<T>, userId?: string): Promise<Partial<T>>;
-    /**
-     * Hook: After entity update
-     */
-    afterEntityUpdate<T>(entityName: string, id: string, data: T, changes: Partial<T>, userId?: string): Promise<void>;
-    /**
-     * Hook: Before entity deletion
-     */
-    beforeEntityDelete(entityName: string, id: string, userId?: string): Promise<boolean>;
-    /**
-     * Hook: After entity deletion
-     */
-    afterEntityDelete(entityName: string, id: string, userId?: string): Promise<void>;
-    /**
-     * Hook: Entity validation
-     * Allows plugins to add custom validation rules
-     */
-    validateEntity<T>(entityName: string, data: T, operation: 'create' | 'update'): Promise<EntityValidationResult>;
-    /**
-     * Hook: Before entity query/read
-     */
-    beforeEntityRead(entityName: string, query: Record<string, unknown>, userId?: string): Promise<Record<string, unknown>>;
-    /**
-     * Hook: After entity query/read
-     */
-    afterEntityRead<T>(entityName: string, results: T[], query: Record<string, unknown>, userId?: string): Promise<T[]>;
-    /**
-     * Authentication hooks
-     */
-    onUserLogin(user: Record<string, unknown>): Promise<void>;
-    onUserLogout(user: Record<string, unknown>): Promise<void>;
-    onUserRegister(user: Record<string, unknown>): Promise<void>;
-    /**
-     * Get entity configuration (placeholder)
-     */
-    private getEntityConfig;
-}
-export declare const entityHookManager: EntityHookManager;
-export declare const beforeEntityCreate: <T>(entityName: string, data: T, userId?: string) => Promise<T>;
-export declare const afterEntityCreate: <T>(entityName: string, data: T, userId?: string) => Promise<void>;
-export declare const beforeEntityUpdate: <T>(entityName: string, id: string, changes: Partial<T>, userId?: string) => Promise<Partial<T>>;
-export declare const afterEntityUpdate: <T>(entityName: string, id: string, data: T, changes: Partial<T>, userId?: string) => Promise<void>;
-export declare const beforeEntityDelete: (entityName: string, id: string, userId?: string) => Promise<boolean>;
-export declare const afterEntityDelete: (entityName: string, id: string, userId?: string) => Promise<void>;
-export declare const validateEntity: <T>(entityName: string, data: T, operation: "create" | "update") => Promise<EntityValidationResult>;
-export declare const beforeEntityRead: (entityName: string, query: Record<string, unknown>, userId?: string) => Promise<Record<string, unknown>>;
-export declare const afterEntityRead: <T>(entityName: string, results: T[], query: Record<string, unknown>, userId?: string) => Promise<T[]>;
-//# sourceMappingURL=entity-hooks.d.ts.map

package/dist/lib/entities/entity-hooks.d.ts.map

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

package/dist/lib/entities/external-api-generator.d.ts

@@ -1,89 +0,0 @@
-/**
- * External API Generator
- *
- * Generates external REST APIs for entities with automatic auth, rate limiting,
- * pagination, filtering, and CORS handling.
- */
-import { NextRequest, NextResponse } from 'next/server';
-import { APIGeneratorOptions } from './api-generator';
-import type { EntityConfig } from './types';
-export interface ExternalAPIOptions extends APIGeneratorOptions {
-    enableAPIKeyAuth?: boolean;
-    enableRateLimit?: boolean;
-    enableCORS?: boolean;
-    rateLimitConfig?: {
-        windowMs: number;
-        maxRequests: number;
-    };
-    corsOptions?: {
-        origins: string[];
-        methods: string[];
-        headers: string[];
-    };
-}
-export interface ExternalAPIContext {
-    entityName: string;
-    entityConfig: EntityConfig;
-    apiKey?: string;
-    clientId?: string;
-    userAgent?: string;
-    ip?: string;
-}
-/**
- * Generate external REST API for an entity with v1 prefix
- */
-export declare function generateExternalAPI(entityName: string, options?: ExternalAPIOptions): {
-    GET: (request: NextRequest, context?: {
-        params?: {
-            id?: string;
-        };
-    }) => Promise<NextResponse<unknown>>;
-    POST: (request: NextRequest, context?: {
-        params?: {
-            id?: string;
-        };
-    }) => Promise<NextResponse<unknown>>;
-    PATCH: (request: NextRequest, context?: {
-        params?: {
-            id?: string;
-        };
-    }) => Promise<NextResponse<unknown>>;
-    DELETE: (request: NextRequest, context?: {
-        params?: {
-            id?: string;
-        };
-    }) => Promise<NextResponse<unknown>>;
-    OPTIONS: (request: NextRequest) => Promise<NextResponse<unknown>>;
-};
-/**
- * Generate OpenAPI/Swagger documentation for entity
- */
-export declare function generateOpenAPISpec(entityName: string): {
-    openapi: string;
-    info: {
-        title: string;
-        version: string;
-        description: string;
-    };
-    paths: Record<string, Record<string, unknown>>;
-    components: {
-        schemas: {
-            [x: string]: {
-                type: string;
-                properties: Record<string, Record<string, unknown>>;
-                required: string[];
-            };
-        };
-        securitySchemes: {
-            ApiKeyAuth: {
-                type: string;
-                in: string;
-                name: string;
-            };
-        };
-    };
-    security: {
-        ApiKeyAuth: any[];
-    }[];
-};
-//# sourceMappingURL=external-api-generator.d.ts.map

package/dist/lib/entities/external-api-generator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"external-api-generator.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/external-api-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACvD,OAAO,EAAqB,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAK3C,MAAM,WAAW,kBAAmB,SAAQ,mBAAmB;IAC7D,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,eAAe,CAAC,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAA;QAChB,WAAW,EAAE,MAAM,CAAA;KACpB,CAAA;IACD,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,MAAM,EAAE,CAAA;QACjB,OAAO,EAAE,MAAM,EAAE,CAAA;QACjB,OAAO,EAAE,MAAM,EAAE,CAAA;KAClB,CAAA;CACF;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,YAAY,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,EAAE,CAAC,EAAE,MAAM,CAAA;CACZ;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,kBAAuB;mBAqFT,WAAW,YAAY;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;oBAAnD,WAAW,YAAY;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;qBAAnD,WAAW,YAAY;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;sBAAnD,WAAW,YAAY;QAAE,MAAM,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;uBAkGnD,WAAW;EAnHnC;AAyKD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;EAoMrD"}

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

@@ -1,118 +0,0 @@
-/**
- * Entity Helpers - Phase 2 Teams Integration
- *
- * This file contains helper functions for entity-level operations,
- * particularly for the two-layer security model:
- * - RLS (Database): Team isolation only (identical for ALL entities)
- * - App (Endpoints): User isolation based on access.shared config
- */
-/**
- * Determines if an entity should filter by userId at the app level
- *
- * The two-layer security model:
- * - RLS at DB level handles team isolation (IDENTICAL for all entities)
- * - App level handles user isolation based on access.shared config
- *
- * @param entityName - The name of the entity (e.g., 'tasks', 'customers')
- * @returns True if the entity requires user isolation (access.shared === false)
- *
- * @example
- * ```ts
- * // Tasks with access.shared: false -> Only owner sees their records
- * if (shouldFilterByUserId('tasks')) {
- *   query += ' AND "userId" = $userId'
- * }
- *
- * // Customers with access.shared: true -> All team members see all records
- * if (shouldFilterByUserId('customers')) { // false
- *   // No additional userId filter needed
- * }
- * ```
- */
-export declare function shouldFilterByUserId(entityName: string): boolean;
-/**
- * Gets the isolation mode for an entity
- *
- * @param entityName - The name of the entity
- * @returns 'private' (user isolation) or 'shared' (team-wide access)
- */
-export declare function getEntityIsolationMode(entityName: string): 'private' | 'shared';
-/**
- * Applies user isolation to a query based on entity config
- *
- * This is the recommended way to build queries that respect the two-layer model.
- *
- * @param entityName - The name of the entity
- * @param baseConditions - Base WHERE conditions (should already include teamId)
- * @param userId - The current user's ID
- * @returns Modified conditions with optional userId filter
- *
- * @example
- * ```ts
- * // In an API endpoint:
- * const conditions = applyUserIsolation('tasks', { teamId }, userId)
- * // If tasks has access.shared: false
- * // -> conditions = { teamId, userId }
- * // If access.shared: true
- * // -> conditions = { teamId }
- * ```
- */
-export declare function applyUserIsolation(entityName: string, baseConditions: {
-    teamId: string;
-    [key: string]: unknown;
-}, userId: string): {
-    teamId: string;
-    userId?: string;
-    [key: string]: unknown;
-};
-/**
- * Builds SQL WHERE clause for entity queries
- *
- * Generates the appropriate WHERE clause based on entity config:
- * - Always includes teamId (RLS layer)
- * - Optionally includes userId (App layer based on access.shared)
- *
- * @param entityName - The name of the entity
- * @param teamIdParam - The parameter number for teamId (e.g., 1 -> $1)
- * @param userIdParam - The parameter number for userId (e.g., 2 -> $2)
- * @returns SQL WHERE conditions string and array of used parameters
- *
- * @example
- * ```ts
- * const { clause, params } = buildEntityWhereClause('tasks', 1, 2)
- * // If tasks has access.shared: false
- * // -> clause = '"teamId" = $1 AND "userId" = $2'
- * // -> params = ['teamId', 'userId']
- *
- * // If customers has access.shared: true
- * // -> clause = '"teamId" = $1'
- * // -> params = ['teamId']
- * ```
- */
-export declare function buildEntityWhereClause(entityName: string, teamIdParam?: number, userIdParam?: number): {
-    clause: string;
-    params: string[];
-};
-/**
- * Validates that a team context exists for entity operations
- *
- * @param teamId - The team ID from request headers
- * @throws Error if teamId is missing
- */
-export declare function validateTeamContext(teamId: string | null): asserts teamId is string;
-/**
- * Gets required entity fields for creation
- *
- * Returns the fields that must be set when creating an entity:
- * - userId: Always required (creator)
- * - teamId: Always required (team context)
- *
- * @param userId - The current user's ID
- * @param teamId - The active team's ID
- * @returns Object with userId and teamId
- */
-export declare function getEntityCreationFields(userId: string, teamId: string): {
-    userId: string;
-    teamId: string;
-};
-//# sourceMappingURL=helpers.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAOhE;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,CAE/E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,cAAc,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAC1D,MAAM,EAAE,MAAM,GACb;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAK7D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,EAAE,MAAM,EAClB,WAAW,GAAE,MAAU,EACvB,WAAW,GAAE,MAAU,GACtB;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CActC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAInF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAEpC"}

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

@@ -1,130 +0,0 @@
-/**
- * Entity Hook System
- *
- * Provides lifecycle hooks for entities with support for plan limits,
- * flag system, child entities, and comprehensive hook management.
- */
-import type { HookFunction, HookContext, HookResult, CRUDOperation, EntityConfig } from './types';
-/**
- * Hook execution priority levels
- */
-export declare enum HookPriority {
-    HIGHEST = 0,
-    HIGH = 10,
-    NORMAL = 50,
-    LOW = 90,
-    LOWEST = 100
-}
-/**
- * Hook registration with priority
- */
-interface HookRegistration {
-    hook: HookFunction;
-    priority: HookPriority;
-    name?: string;
-}
-/**
- * Hook execution statistics
- */
-interface HookStats {
-    entityName: string;
-    hookType: string;
-    executionCount: number;
-    averageExecutionTime: number;
-    lastExecuted: Date;
-}
-/**
- * EntityHookManager - Manages lifecycle hooks for entities
- */
-export declare class EntityHookManager {
-    private hooks;
-    private stats;
-    private enabled;
-    /**
-     * Register a hook for a specific entity and hook type
-     */
-    registerHook(entityName: string, hookType: string, hook: HookFunction, priority?: HookPriority, name?: string): void;
-    /**
-     * Register hooks from entity configuration
-     */
-    registerEntityHooks(config: EntityConfig): void;
-    /**
-     * Execute hooks for a specific entity and hook type
-     */
-    executeHooks(entityName: string, hookType: string, context: HookContext): Promise<HookResult>;
-    /**
-     * Execute before hooks (can modify data and stop execution)
-     */
-    executeBeforeHooks(entityName: string, operation: CRUDOperation, context: HookContext): Promise<HookResult>;
-    /**
-     * Execute after hooks (notifications, cleanup, etc.)
-     */
-    executeAfterHooks(entityName: string, operation: CRUDOperation, context: HookContext): Promise<void>;
-    /**
-     * Execute plan limit hooks
-     */
-    executePlanLimitHooks(entityName: string, limitType: 'reached' | 'upgrade', context: HookContext): Promise<HookResult>;
-    /**
-     * Execute flag system hooks
-     */
-    executeFlagHooks(entityName: string, flagEvent: 'conflict' | 'granted' | 'denied', context: HookContext): Promise<HookResult>;
-    /**
-     * Execute child entity hooks
-     */
-    executeChildHooks(parentEntityName: string, childName: string, hookType: string, context: HookContext): Promise<HookResult>;
-    /**
-     * Remove hooks for an entity
-     */
-    removeEntityHooks(entityName: string): void;
-    /**
-     * Remove specific hook
-     */
-    removeHook(entityName: string, hookType: string, hookName?: string): void;
-    /**
-     * Get registered hooks for entity
-     */
-    getEntityHooks(entityName: string): Record<string, HookRegistration[]>;
-    /**
-     * Update hook execution statistics
-     */
-    private updateStats;
-    /**
-     * Get hook execution statistics
-     */
-    getStats(): HookStats[];
-    /**
-     * Enable/disable hook execution
-     */
-    setEnabled(enabled: boolean): void;
-    /**
-     * Clear all hooks and stats
-     */
-    clear(): void;
-    /**
-     * Get total number of registered hooks
-     */
-    getHookCount(): number;
-}
-export declare const entityHookManager: EntityHookManager;
-export declare function registerHook(entityName: string, hookType: string, hook: HookFunction, priority?: HookPriority, name?: string): void;
-export declare function executeEntityHooks(entityName: string, hookType: string, context: HookContext): Promise<HookResult>;
-export declare function executeBeforeHooks(entityName: string, operation: CRUDOperation, context: HookContext): Promise<HookResult>;
-export declare function executeAfterHooks(entityName: string, operation: CRUDOperation, context: HookContext): Promise<void>;
-/**
- * Built-in hook: Log entity operations
- */
-export declare const logOperationHook: HookFunction;
-/**
- * Built-in hook: Validate required fields
- */
-export declare const validateRequiredFieldsHook: HookFunction;
-/**
- * Built-in hook: Check plan limits before creation
- */
-export declare const checkPlanLimitsHook: HookFunction;
-/**
- * Built-in hook: Audit trail for sensitive operations
- */
-export declare const auditTrailHook: HookFunction;
-export {};
-//# sourceMappingURL=hooks.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,aAAa,EACb,YAAY,EACb,MAAM,SAAS,CAAA;AAEhB;;GAEG;AACH,oBAAY,YAAY;IACtB,OAAO,IAAI;IACX,IAAI,KAAK;IACT,MAAM,KAAK;IACX,GAAG,KAAK;IACR,MAAM,MAAM;CACb;AAED;;GAEG;AACH,UAAU,gBAAgB;IACxB,IAAI,EAAE,YAAY,CAAA;IAClB,QAAQ,EAAE,YAAY,CAAA;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,UAAU,SAAS;IACjB,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,cAAc,EAAE,MAAM,CAAA;IACtB,oBAAoB,EAAE,MAAM,CAAA;IAC5B,YAAY,EAAE,IAAI,CAAA;CACnB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAAO;IAEtB;;OAEG;IACH,YAAY,CACV,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,EAClB,QAAQ,GAAE,YAAkC,EAC5C,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI;IAUP;;OAEG;IACH,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAoB/C;;OAEG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IA0DtB;;OAEG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAKtB;;OAEG;IACG,iBAAiB,CACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC;IAKhB;;OAEG;IACG,qBAAqB,CACzB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAKtB;;OAEG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,EAC5C,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAUtB;;OAEG;IACG,iBAAiB,CACrB,gBAAgB,EAAE,MAAM,EACxB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC;IAatB;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAQ3C;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;IAYzE;;OAEG;IACH,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,EAAE,CAAC;IAatE;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;IACH,QAAQ,IAAI,SAAS,EAAE;IAIvB;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIlC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,YAAY,IAAI,MAAM;CAGvB;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAA;AAGxD,wBAAgB,YAAY,CAC1B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,YAAY,EAClB,QAAQ,CAAC,EAAE,YAAY,EACvB,IAAI,CAAC,EAAE,MAAM,GACZ,IAAI,CAEN;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAErB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,UAAU,CAAC,CAErB;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,aAAa,EACxB,OAAO,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAEf;AAID;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAG9B,CAAA;AAED;;GAEG;AAEH,eAAO,MAAM,0BAA0B,EAAE,YAIxC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAQjC,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,YAM5B,CAAA"}

package/dist/lib/entities/meta-adapter.d.ts

@@ -1,76 +0,0 @@
-/**
- * Meta System Adapter
- *
- * Provides meta configuration for entities using the modern Entity Registry.
- * Simplified from the legacy dual-registry system to use only entity-registry.
- */
-import type { EntityConfig } from './types';
-/**
- * Meta configuration interface
- * Derived from EntityConfig for backward compatibility
- */
-export interface MetaEntityConfig {
-    entityType: string;
-    tableName: string;
-    metaTableName: string;
-    idColumn: string;
-    apiPath: string;
-}
-/**
- * Meta System Adapter
- * Provides meta configuration derived from the modern entity registry
- */
-export declare class MetaSystemAdapter {
-    /**
-     * Get meta configuration for an entity
-     * Derives meta table info from the entity's slug
-     */
-    getMetaConfig(entityName: string): {
-        tableName: string;
-        metaTableName: string;
-        idColumn: string;
-        apiPath: string;
-    } | null;
-    /**
-     * Check if entity supports metadata
-     */
-    supportsMetadata(entityName: string): boolean;
-    /**
-     * Get entity API path
-     */
-    getApiPath(entityName: string): string | null;
-    /**
-     * Get all supported entity types that have metadata
-     */
-    getSupportedEntityTypes(): string[];
-    /**
-     * Convert entity config to meta config format
-     */
-    toMetaConfig(entityConfig: EntityConfig): MetaEntityConfig | null;
-    /**
-     * Validate entity configuration compatibility
-     */
-    validateCompatibility(entityName: string): {
-        compatible: boolean;
-        issues: string[];
-        recommendations: string[];
-    };
-    /**
-     * Generate migration report for all entities
-     */
-    generateMigrationReport(): {
-        fullyMigrated: string[];
-        needsMigration: string[];
-        newEntitiesOnly: string[];
-        compatibilityIssues: Array<{
-            entityName: string;
-            issues: string[];
-        }>;
-    };
-}
-export declare const metaSystemAdapter: MetaSystemAdapter;
-export declare function getMetaConfigForEntity(entityName: string): ReturnType<MetaSystemAdapter['getMetaConfig']>;
-export declare function checkEntitySupportsMetadata(entityName: string): boolean;
-export declare function getEntityApiPath(entityName: string): string | null;
-export declare function validateEntityCompatibility(entityName: string): ReturnType<MetaSystemAdapter['validateCompatibility']>;
-//# sourceMappingURL=meta-adapter.d.ts.map

package/dist/lib/entities/meta-adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"meta-adapter.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/meta-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B;;;OAGG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG;QACjC,SAAS,EAAE,MAAM,CAAA;QACjB,aAAa,EAAE,MAAM,CAAA;QACrB,QAAQ,EAAE,MAAM,CAAA;QAChB,OAAO,EAAE,MAAM,CAAA;KAChB,GAAG,IAAI;IAyBR;;OAEG;IACH,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAS7C;;OAEG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAK7C;;OAEG;IACH,uBAAuB,IAAI,MAAM,EAAE;IAMnC;;OAEG;IACH,YAAY,CAAC,YAAY,EAAE,YAAY,GAAG,gBAAgB,GAAG,IAAI;IAcjE;;OAEG;IACH,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG;QACzC,UAAU,EAAE,OAAO,CAAA;QACnB,MAAM,EAAE,MAAM,EAAE,CAAA;QAChB,eAAe,EAAE,MAAM,EAAE,CAAA;KAC1B;IAkBD;;OAEG;IACH,uBAAuB,IAAI;QACzB,aAAa,EAAE,MAAM,EAAE,CAAA;QACvB,cAAc,EAAE,MAAM,EAAE,CAAA;QACxB,eAAe,EAAE,MAAM,EAAE,CAAA;QACzB,mBAAmB,EAAE,KAAK,CAAC;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KACrE;CAUF;AAGD,eAAO,MAAM,iBAAiB,mBAA0B,CAAA;AAGxD,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC,CAEzG;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAElE;AAED,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,CAAC,CAEtH"}

package/dist/lib/entities/migration-helper.d.ts

@@ -1,78 +0,0 @@
-/**
- * Migration Helper System
- *
- * Automatically generates database migrations, RLS policies, and optimized indexes
- * from entity configurations including child entities and relationships.
- */
-import type { EntityConfig } from './types';
-export interface MigrationOptions {
-    includeRLS?: boolean;
-    includeIndexes?: boolean;
-    includeChildEntities?: boolean;
-    includeConstraints?: boolean;
-    includeComments?: boolean;
-    softDelete?: boolean;
-    timestamps?: boolean;
-}
-export interface GeneratedMigration {
-    up: string;
-    down: string;
-    filename: string;
-    description: string;
-    dependencies?: string[];
-}
-export interface TableDefinition {
-    tableName: string;
-    columns: ColumnDefinition[];
-    indexes: IndexDefinition[];
-    constraints: ConstraintDefinition[];
-    rlsPolicies: RLSPolicyDefinition[];
-}
-export interface ColumnDefinition {
-    name: string;
-    type: string;
-    nullable: boolean;
-    defaultValue?: string;
-    primaryKey?: boolean;
-    unique?: boolean;
-    comment?: string;
-}
-export interface IndexDefinition {
-    name: string;
-    columns: string[];
-    unique?: boolean;
-    partial?: string;
-    method?: 'btree' | 'gin' | 'gist' | 'hash';
-    comment?: string;
-}
-export interface ConstraintDefinition {
-    name: string;
-    type: 'PRIMARY KEY' | 'FOREIGN KEY' | 'UNIQUE' | 'CHECK';
-    definition: string;
-    comment?: string;
-}
-export interface RLSPolicyDefinition {
-    name: string;
-    action: 'SELECT' | 'INSERT' | 'UPDATE' | 'DELETE' | 'ALL';
-    role?: string;
-    using?: string;
-    withCheck?: string;
-    comment?: string;
-}
-/**
- * Generate complete migration for an entity
- */
-export declare function generateEntityMigration(entityConfig: EntityConfig, options?: MigrationOptions): GeneratedMigration;
-/**
- * Generate migration boilerplate for a new entity
- */
-export declare function generateMigrationBoilerplate(entityName: string): string;
-/**
- * Validate entity configuration for migration generation
- */
-export declare function validateEntityForMigration(entityConfig: EntityConfig): {
-    valid: boolean;
-    errors: string[];
-    warnings: string[];
-};
-//# sourceMappingURL=migration-helper.d.ts.map

package/dist/lib/entities/migration-helper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"migration-helper.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/migration-helper.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAsC,MAAM,SAAS,CAAA;AAE/E,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,gBAAgB,EAAE,CAAA;IAC3B,OAAO,EAAE,eAAe,EAAE,CAAA;IAC1B,WAAW,EAAE,oBAAoB,EAAE,CAAA;IACnC,WAAW,EAAE,mBAAmB,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAA;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAA;IACxD,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,KAAK,CAAA;IACzD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,YAAY,EAC1B,OAAO,GAAE,gBAAqB,GAC7B,kBAAkB,CA2CpB;AAolBD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAsCvE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,YAAY,GAAG;IACtE,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;CACnB,CA+CA"}

package/dist/lib/entities/pattern-usage-hooks.d.ts

@@ -1,31 +0,0 @@
-/**
- * Pattern Usage Hooks
- *
- * Integrates pattern usage tracking with the entity hook system.
- * Automatically syncs pattern usages when entities with blocks are created/updated/deleted.
- * Also handles ISR cache invalidation when patterns are updated.
- *
- * @module PatternUsageHooks
- */
-/**
- * Initialize pattern usage hooks
- *
- * Call this function during app initialization to register the hooks.
- * The hooks will automatically track pattern usages for all builder-enabled entities.
- *
- * @example
- * ```typescript
- * // In your app initialization (e.g., layout.tsx or a server initialization file)
- * import { initPatternUsageHooks } from '@nextsparkjs/core/lib/entities/pattern-usage-hooks'
- *
- * initPatternUsageHooks()
- * ```
- */
-export declare function initPatternUsageHooks(): void;
-/**
- * Check if pattern usage hooks are initialized
- *
- * Useful for debugging or conditional initialization.
- */
-export declare function isPatternUsageHooksInitialized(): boolean;
-//# sourceMappingURL=pattern-usage-hooks.d.ts.map

package/dist/lib/entities/pattern-usage-hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pattern-usage-hooks.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/pattern-usage-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAqCH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,IAAI,IAAI,CAyG5C;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,IAAI,OAAO,CAGxD"}