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

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

@@ -0,0 +1,31 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,121 @@
+/**
+ * Entity System Performance Monitor
+ *
+ * Tracks and benchmarks performance of the new entity system
+ * vs legacy implementations. Provides metrics for optimization.
+ */
+interface PerformanceMetric {
+    operation: string;
+    entityName: string;
+    duration: number;
+    timestamp: Date;
+    metadata?: Record<string, unknown>;
+}
+interface BenchmarkResult {
+    operation: string;
+    entityName: string;
+    averageDuration: number;
+    minDuration: number;
+    maxDuration: number;
+    totalOperations: number;
+    successRate: number;
+    lastExecuted: Date;
+}
+interface SystemBenchmark {
+    entitySystem: {
+        initialization: number;
+        configurationLoad: number;
+        registryLookup: number;
+        permissionCheck: number;
+    };
+    apiGeneration: {
+        schemaGeneration: number;
+        queryGeneration: number;
+        routeRegistration: number;
+    };
+    uiGeneration: {
+        pageTemplateRender: number;
+        componentGeneration: number;
+        formValidation: number;
+    };
+    comparison: {
+        legacyVsNew: {
+            [operation: string]: {
+                legacy: number;
+                new: number;
+                improvement: number;
+            };
+        };
+    };
+}
+declare class EntityPerformanceMonitor {
+    private metrics;
+    private benchmarks;
+    private enabled;
+    /**
+     * Start performance tracking for an operation
+     */
+    startTracking(operation: string, entityName: string, metadata?: Record<string, unknown>): () => void;
+    /**
+     * Record a performance metric
+     */
+    recordMetric(metric: PerformanceMetric): void;
+    /**
+     * Update benchmark statistics
+     */
+    private updateBenchmark;
+    /**
+     * Get benchmark results for entity
+     */
+    getEntityBenchmarks(entityName: string): BenchmarkResult[];
+    /**
+     * Get all benchmark results
+     */
+    getAllBenchmarks(): BenchmarkResult[];
+    /**
+     * Get system-wide performance metrics
+     */
+    getSystemMetrics(): SystemBenchmark;
+    /**
+     * Get metrics by operation name
+     */
+    private getMetricsByOperation;
+    /**
+     * Calculate average duration from metrics
+     */
+    private getAverageDuration;
+    /**
+     * Compare legacy vs new system performance
+     */
+    private getLegacyComparison;
+    /**
+     * Generate performance report
+     */
+    generateReport(): string;
+    /**
+     * Clear all metrics and benchmarks
+     */
+    clear(): void;
+    /**
+     * Enable/disable performance monitoring
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Get current monitoring status
+     */
+    isEnabled(): boolean;
+}
+export declare const entityPerformanceMonitor: EntityPerformanceMonitor;
+/**
+ * Performance tracking decorator
+ */
+export declare function trackPerformance(operation: string, entityName?: string): <T extends (...args: unknown[]) => unknown>(target: unknown, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<T>;
+/**
+ * Simple performance tracking function
+ */
+export declare function withPerformanceTracking<T>(operation: string, entityName: string, fn: () => T): T;
+/**
+ * Export for use in performance testing
+ */
+export { type PerformanceMetric, type BenchmarkResult, type SystemBenchmark };
+//# sourceMappingURL=performance.d.ts.map

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

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

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

@@ -0,0 +1,152 @@
+/**
+ * Entity Queries
+ *
+ * Query functions for the Entity Registry.
+ * These operate on the auto-generated ENTITY_REGISTRY data.
+ *
+ * Uses dynamic require to load the registry at runtime (not compile time)
+ * because the registry is generated in the user's project, not in the core package.
+ *
+ * @module core/lib/entities/queries
+ */
+import type { EntityConfig, ChildEntityDefinition } from './types';
+/**
+ * Generic EntityRegistryEntry type (matches generated registry structure)
+ * The actual EntityName type is project-specific and should be imported
+ * directly from @nextsparkjs/registries/entity-registry when needed.
+ */
+export interface EntityRegistryEntry {
+    name: string;
+    config: EntityConfig | ChildEntityDefinition;
+    parent: string | null;
+    children: string[];
+    depth: number;
+    tableName: string;
+    routePrefix?: string;
+    pluginContext?: {
+        pluginName: string;
+        pluginDir?: string;
+    } | null;
+    themeContext?: {
+        themeName: string;
+        themeDir?: string;
+    } | null;
+    schema?: any;
+    relations?: any;
+    relativePath?: string;
+    hasComponents?: boolean;
+    hasHooks?: boolean;
+    hasMigrations?: boolean;
+    hasMessages?: boolean;
+    hasAssets?: boolean;
+    messagesPath?: string;
+    isCore?: boolean;
+    source?: 'core' | 'theme' | 'plugin';
+}
+export interface EntityRegistryMetadata {
+    totalEntities: number;
+    rootEntities?: number;
+    maxDepth: number;
+    generatedAt: string;
+    entityNames?: string[];
+    entities?: string[];
+    pluginEntities?: number;
+    themeEntities?: number;
+    entitiesWithComponents?: number;
+    entitiesWithHooks?: number;
+    entitiesWithMigrations?: number;
+    entitiesWithMessages?: number;
+    entitiesWithAssets?: number;
+}
+export interface EntityOwner {
+    type: 'plugin' | 'theme';
+    name: string;
+}
+/**
+ * Register the entity registry from the project
+ * This should be called by the dashboard layout which imports the registry directly
+ * (webpack resolves the @nextsparkjs/registries alias at compile time)
+ */
+export declare function setEntityRegistry(registry: Record<string, EntityRegistryEntry>, metadata?: EntityRegistryMetadata): void;
+/**
+ * Add a single entity to the registry
+ * Used by EntityRegistry.register() for programmatic registration
+ */
+export declare function addEntityToRegistry(entry: EntityRegistryEntry): void;
+/**
+ * Remove an entity from the registry
+ */
+export declare function removeEntityFromRegistry(name: string): boolean;
+/**
+ * Clear the registry (for testing)
+ */
+export declare function clearEntityRegistry(): void;
+/**
+ * Check if registry is initialized
+ */
+export declare function isRegistryInitialized(): boolean;
+/**
+ * Get all registered entity configs
+ */
+export declare function getRegisteredEntities(): (EntityConfig | ChildEntityDefinition)[];
+/**
+ * Get entity config by name
+ */
+export declare function getEntity(name: string): EntityConfig | ChildEntityDefinition | undefined;
+/**
+ * Get entity with full metadata
+ */
+export declare function getEntityMetadata(name: string): EntityRegistryEntry | undefined;
+/**
+ * Get root entities (no parent)
+ */
+export declare function getRootEntities(): EntityRegistryEntry[];
+/**
+ * Get child entities of a parent
+ */
+export declare function getChildEntities(parentName: string): EntityRegistryEntry[];
+export interface EntityTreeNode extends Omit<EntityRegistryEntry, 'children'> {
+    childNodes: EntityTreeNode[];
+}
+/**
+ * Get entity tree (hierarchical)
+ */
+export declare function getEntityTree(): EntityTreeNode[];
+/**
+ * Get entities by depth level
+ */
+export declare function getEntitiesByDepth(depth: number): EntityRegistryEntry[];
+/**
+ * Get table name for entity
+ */
+export declare function getEntityTableName(name: string): string | undefined;
+/**
+ * Get entity by table name (reverse lookup)
+ */
+export declare function getEntityByTableName(tableName: string): EntityRegistryEntry | undefined;
+/**
+ * Get entities from a specific plugin
+ */
+export declare function getPluginEntities(pluginName: string): EntityRegistryEntry[];
+/**
+ * Get entities from a specific theme
+ */
+export declare function getThemeEntities(themeName: string): EntityRegistryEntry[];
+/**
+ * Get entity owner (plugin or theme)
+ */
+export declare function getEntityOwner(entityName: string): EntityOwner | null;
+/**
+ * Get entity by slug
+ */
+export declare function getEntityBySlug(slug: string): EntityConfig | undefined;
+/**
+ * Get entity metadata (totals, counts, etc.)
+ */
+export declare function getEntityRegistryMetadata(): EntityRegistryMetadata | null;
+/**
+ * Get the raw registry object
+ * Use this when you need direct access to the registry
+ */
+export declare function getEntityRegistry(): Record<string, EntityRegistryEntry>;
+//# sourceMappingURL=queries.d.ts.map

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

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

package/dist/lib/entities/query-generator.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Database Query Generation System
+ *
+ * Automatically generates optimized database queries for entity CRUD operations
+ * including child entities, filtering, sorting, and RLS integration.
+ */
+import type { EntityConfig, ChildEntityDefinition } from './types';
+export interface QueryOptions {
+    select?: string[];
+    where?: WhereClause[];
+    orderBy?: OrderByClause[];
+    limit?: number;
+    offset?: number;
+    includeChildren?: string[] | 'all';
+    includeDeleted?: boolean;
+}
+export interface WhereClause {
+    field: string;
+    operator: 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'notin' | 'is' | 'isnot';
+    value: unknown;
+    connector?: 'AND' | 'OR';
+}
+export interface OrderByClause {
+    field: string;
+    direction: 'ASC' | 'DESC';
+    nulls?: 'FIRST' | 'LAST';
+}
+export interface QueryResult {
+    sql: string;
+    params: unknown[];
+    estimatedRows?: number;
+}
+export interface BulkQueryResult {
+    mainQuery: QueryResult;
+    childQueries: Record<string, QueryResult>;
+}
+/**
+ * Generate SELECT query for entity
+ */
+export declare function generateSelectQuery(entityConfig: EntityConfig, options?: QueryOptions): QueryResult;
+/**
+ * Generate INSERT query for entity
+ */
+export declare function generateInsertQuery(entityConfig: EntityConfig, data: Record<string, unknown>, userId?: string): QueryResult;
+/**
+ * Generate UPDATE query for entity
+ */
+export declare function generateUpdateQuery(entityConfig: EntityConfig, id: string, data: Record<string, unknown>, userId?: string): QueryResult;
+/**
+ * Generate DELETE query for entity
+ */
+export declare function generateDeleteQuery(entityConfig: EntityConfig, id: string, userId?: string): QueryResult;
+/**
+ * Generate child entity queries for parent item
+ */
+export declare function generateChildEntityQueries(parentEntityConfig: EntityConfig, parentId: string, childNames?: string[] | 'all'): Record<string, QueryResult>;
+/**
+ * Generate INSERT query for child entity
+ */
+export declare function generateChildInsertQuery(parentEntityName: string, childConfig: ChildEntityDefinition, parentId: string, data: Record<string, unknown>, userId?: string): QueryResult;
+/**
+ * Generate UPDATE query for child entity
+ */
+export declare function generateChildUpdateQuery(parentEntityName: string, childConfig: ChildEntityDefinition, childId: string, data: Record<string, unknown>, userId?: string): QueryResult;
+/**
+ * Generate DELETE query for child entity
+ */
+export declare function generateChildDeleteQuery(childConfig: ChildEntityDefinition, childId: string, userId?: string): QueryResult;
+/**
+ * Generate bulk queries for multiple operations
+ */
+export declare function generateBulkQueries(entityConfig: EntityConfig, operations: Array<{
+    type: 'insert' | 'update' | 'delete';
+    data?: Record<string, unknown>;
+    id?: string;
+}>, userId?: string): QueryResult[];
+/**
+ * Generate count query for pagination
+ */
+export declare function generateCountQuery(entityConfig: EntityConfig, where?: WhereClause[]): QueryResult;
+//# sourceMappingURL=query-generator.d.ts.map

package/dist/lib/entities/query-generator.d.ts.map

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

package/dist/lib/entities/query-generator.js

@@ -9,7 +9,7 @@ function generateSelectQuery(entityConfig, options = {}) {
   } = options;
   const selectFields = select || generateSelectFields(entityConfig);
   const selectClause = selectFields.join(", ");
-  const tableName = entityConfig.slug;
+  const tableName = entityConfig.tableName || entityConfig.slug;
   const fromClause = `FROM ${tableName}`;
   const whereConditions = [];
   const params = [];
@@ -63,7 +63,7 @@ function generateSelectQuery(entityConfig, options = {}) {
   };
 }
 function generateInsertQuery(entityConfig, data, userId) {
-  const tableName = entityConfig.slug;
+  const tableName = entityConfig.tableName || entityConfig.slug;
   const insertableFields = getInsertableFields(entityConfig);
   const fields = [];
   const placeholders = [];
@@ -98,7 +98,7 @@ function generateInsertQuery(entityConfig, data, userId) {
   return { sql, params };
 }
 function generateUpdateQuery(entityConfig, id, data, userId) {
-  const tableName = entityConfig.slug;
+  const tableName = entityConfig.tableName || entityConfig.slug;
   const updatableFields = getUpdatableFields(entityConfig);
   const setConditions = [];
   const params = [];
@@ -133,7 +133,7 @@ function generateUpdateQuery(entityConfig, id, data, userId) {
   return { sql, params };
 }
 function generateDeleteQuery(entityConfig, id, userId) {
-  const tableName = entityConfig.slug;
+  const tableName = entityConfig.tableName || entityConfig.slug;
   const params = [id];
   let paramIndex = 2;
   if (true) {
@@ -310,7 +310,7 @@ function generateBulkQueries(entityConfig, operations, userId) {
   });
 }
 function generateCountQuery(entityConfig, where = []) {
-  const tableName = entityConfig.slug;
+  const tableName = entityConfig.tableName || entityConfig.slug;
   const whereConditions = [];
   const params = [];
   let paramIndex = 1;
@@ -333,7 +333,7 @@ function generateCountQuery(entityConfig, where = []) {
   return { sql, params };
 }
 function generateSelectFields(entityConfig) {
-  const tableName = entityConfig.slug;
+  const tableName = entityConfig.tableName || entityConfig.slug;
   const fields = ["id"];
   entityConfig.fields.filter((field) => true).forEach((field) => {
     if (!fields.includes(field.name)) {

package/dist/lib/entities/registry.client.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Client-Only Entity Registry
+ *
+ * Provides minimal entity functionality for client components
+ * without any server-side imports or contents integration
+ */
+import type { EntityConfig } from './types';
+/**
+ * Client-only entity registry with minimal functionality
+ */
+declare class ClientEntityRegistry {
+    private entities;
+    /**
+     * Register a new entity configuration
+     */
+    register(config: EntityConfig): void;
+    /**
+     * Get entity configuration by name
+     */
+    get(name: string): EntityConfig | undefined;
+    /**
+     * Get all registered entities
+     */
+    getAll(): EntityConfig[];
+    /**
+     * Get only enabled entities
+     */
+    getEnabled(): EntityConfig[];
+    /**
+     * Clear all registered entities
+     */
+    clear(): void;
+}
+export declare const clientEntityRegistry: ClientEntityRegistry;
+/**
+ * Set entities from server-side data
+ * Called by EntityProvider when receiving server data
+ */
+export declare function setServerEntities(entities: EntityConfig[]): void;
+/**
+ * Client-safe function to get all entity configurations
+ * Returns entities from the client registry (populated by DashboardShell)
+ */
+export declare function getAllEntityConfigs(): EntityConfig[];
+/**
+ * Client-safe function to get enabled entities
+ * Data must be provided via EntityProvider/Context from server component
+ */
+export declare function getEnabledEntities(): EntityConfig[];
+/**
+ * Client-safe function to register entity
+ */
+export declare function registerEntity(config: EntityConfig): void;
+/**
+ * Client-safe function to get entity config
+ */
+export declare function getEntityConfig(name: string): EntityConfig | undefined;
+export {};
+//# sourceMappingURL=registry.client.d.ts.map

package/dist/lib/entities/registry.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.client.d.ts","sourceRoot":"","sources":["../../../src/lib/entities/registry.client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C;;GAEG;AACH,cAAM,oBAAoB;IACxB,OAAO,CAAC,QAAQ,CAAuC;IAEvD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI;IAIpC;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI3C;;OAEG;IACH,MAAM,IAAI,YAAY,EAAE;IAIxB;;OAEG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAGD,eAAO,MAAM,oBAAoB,sBAA6B,CAAA;AAE9D;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAKhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,EAAE,CAUpD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,EAAE,CAEnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAEzD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEtE"}