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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@
+{"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/meta-adapter.js

@@ -9,8 +9,8 @@ class MetaSystemAdapter {
     const config = getEntityConfig(entityName);
     if (config && ((_a = config.access) == null ? void 0 : _a.metadata)) {
       return {
-        tableName: config.slug,
-        metaTableName: `${config.slug}_metas`,
+        tableName: config.tableName || config.slug,
+        metaTableName: `${config.tableName || config.slug}_metas`,
         idColumn: "entityId",
         apiPath: `/api/v1/${config.slug}`
       };
@@ -62,8 +62,8 @@ class MetaSystemAdapter {
     }
     return {
       entityType: entityConfig.slug,
-      tableName: entityConfig.slug,
-      metaTableName: `${entityConfig.slug}_metas`,
+      tableName: entityConfig.tableName || entityConfig.slug,
+      metaTableName: `${entityConfig.tableName || entityConfig.slug}_metas`,
       idColumn: "entityId",
       apiPath: `/api/v1/${entityConfig.slug}`
     };

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

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

@@ -0,0 +1 @@
+{"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/migration-helper.js

@@ -38,7 +38,7 @@ function generateEntityMigration(entityConfig, options = {}) {
   };
 }
 function generateTableDefinition(entityConfig, options) {
-  const tableName = entityConfig.slug;
+  const tableName = entityConfig.tableName || entityConfig.slug;
   const primaryKey = "id";
   const columns = [];
   columns.push({