@constructive-io/graphql-codegen 2.22.1 → 2.23.0

package/cli/commands/generate-orm.js

@@ -1,19 +1,17 @@
 "use strict";
 /**
- * Generate ORM command - generates Prisma-like ORM client
+ * Generate ORM command - generates Prisma-like ORM client from GraphQL schema
  *
  * This command:
- * 1. Fetches _meta query for table-based CRUD operations
- * 2. Fetches __schema introspection for custom operations
+ * 1. Fetches schema from endpoint or loads from file
+ * 2. Infers table metadata from introspection (replaces _meta)
  * 3. Generates a Prisma-like ORM client with fluent API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateOrmCommand = generateOrmCommand;
 const config_1 = require("../../types/config");
-const fetch_meta_1 = require("../introspect/fetch-meta");
-const fetch_schema_1 = require("../introspect/fetch-schema");
-const transform_1 = require("../introspect/transform");
-const transform_schema_1 = require("../introspect/transform-schema");
+const source_1 = require("../introspect/source");
+const shared_1 = require("./shared");
 const init_1 = require("./init");
 const generate_1 = require("./generate");
 const orm_1 = require("../codegen/orm");
@@ -34,109 +32,90 @@ async function generateOrmCommand(options = {}) {
     const config = configResult.config;
     // Use ORM output directory if specified, otherwise default
     const outputDir = options.output || config.orm?.output || './generated/orm';
-    log(`  Endpoint: ${config.endpoint}`);
+    // Log source
+    if (config.schema) {
+        log(`  Schema: ${config.schema}`);
+    }
+    else {
+        log(`  Endpoint: ${config.endpoint}`);
+    }
     log(`  Output: ${outputDir}`);
-    // 2. Validate endpoint
-    const endpointValidation = (0, fetch_meta_1.validateEndpoint)(config.endpoint);
-    if (!endpointValidation.valid) {
+    // 2. Create schema source
+    const sourceValidation = (0, source_1.validateSourceOptions)({
+        endpoint: config.endpoint || undefined,
+        schema: config.schema || undefined,
+    });
+    if (!sourceValidation.valid) {
         return {
             success: false,
-            message: `Invalid endpoint: ${endpointValidation.error}`,
+            message: sourceValidation.error,
         };
     }
-    // Build authorization header if provided
-    const authHeader = options.authorization || config.headers['Authorization'];
-    // 3. Fetch _meta for table-based operations
-    log('Fetching schema metadata (_meta)...');
-    const metaResult = await (0, fetch_meta_1.fetchMeta)({
-        endpoint: config.endpoint,
-        authorization: authHeader,
+    const source = (0, source_1.createSchemaSource)({
+        endpoint: config.endpoint || undefined,
+        schema: config.schema || undefined,
+        authorization: options.authorization || config.headers['Authorization'],
         headers: config.headers,
-        timeout: 30000,
     });
-    if (!metaResult.success) {
+    // 3. Run the codegen pipeline
+    let pipelineResult;
+    try {
+        pipelineResult = await (0, shared_1.runCodegenPipeline)({
+            source,
+            config,
+            verbose: options.verbose,
+            skipCustomOperations: options.skipCustomOperations,
+        });
+    }
+    catch (err) {
         return {
             success: false,
-            message: `Failed to fetch _meta: ${metaResult.error}`,
+            message: `Failed to fetch schema: ${err instanceof Error ? err.message : 'Unknown error'}`,
         };
     }
-    // 4. Transform to CleanTable[]
-    log('Transforming table schema...');
-    let tables = (0, transform_1.transformMetaToCleanTables)(metaResult.data);
-    log(`  Found ${tables.length} tables`);
-    // 5. Filter tables
-    tables = (0, transform_1.filterTables)(tables, config.tables.include, config.tables.exclude);
-    log(`  After filtering: ${tables.length} tables`);
-    if (tables.length === 0) {
+    const { tables, customOperations, stats } = pipelineResult;
+    // 4. Validate tables found
+    const tablesValidation = (0, shared_1.validateTablesFound)(tables);
+    if (!tablesValidation.valid) {
         return {
             success: false,
-            message: 'No tables found after filtering. Check your include/exclude patterns.',
+            message: tablesValidation.error,
         };
     }
-    // Get table operation names for filtering custom operations
-    const tableOperationNames = (0, transform_schema_1.getTableOperationNames)(tables);
-    // 6. Fetch __schema for custom operations (unless skipped)
-    let customQueries = [];
-    let customMutations = [];
-    let customOperationsData;
-    if (!options.skipCustomOperations) {
-        log('Fetching schema introspection (__schema)...');
-        const schemaResult = await (0, fetch_schema_1.fetchSchema)({
-            endpoint: config.endpoint,
-            authorization: authHeader,
-            headers: config.headers,
-            timeout: 30000,
-        });
-        if (schemaResult.success && schemaResult.data) {
-            log('Transforming custom operations...');
-            // Transform to CleanOperation[]
-            const { queries: allQueries, mutations: allMutations, typeRegistry } = (0, transform_schema_1.transformSchemaToOperations)(schemaResult.data);
-            log(`  Found ${allQueries.length} queries and ${allMutations.length} mutations total`);
-            // Filter by config include/exclude
-            const filteredQueries = (0, transform_schema_1.filterOperations)(allQueries, config.queries.include, config.queries.exclude);
-            const filteredMutations = (0, transform_schema_1.filterOperations)(allMutations, config.mutations.include, config.mutations.exclude);
-            log(`  After config filtering: ${filteredQueries.length} queries, ${filteredMutations.length} mutations`);
-            // Remove table operations (already handled by table generators)
-            const customQueriesOps = (0, transform_schema_1.getCustomOperations)(filteredQueries, tableOperationNames);
-            const customMutationsOps = (0, transform_schema_1.getCustomOperations)(filteredMutations, tableOperationNames);
-            log(`  Custom operations: ${customQueriesOps.length} queries, ${customMutationsOps.length} mutations`);
-            customQueries = customQueriesOps.map((q) => q.name);
-            customMutations = customMutationsOps.map((m) => m.name);
-            customOperationsData = {
-                queries: customQueriesOps,
-                mutations: customMutationsOps,
-                typeRegistry,
-            };
-        }
-        else {
-            log(`  Warning: Could not fetch __schema: ${schemaResult.error}`);
-            log('  Continuing with table-only generation...');
-        }
-    }
-    // 7. Generate ORM code
+    // 5. Generate ORM code
     console.log('Generating code...');
-    const { files: generatedFiles, stats } = (0, orm_1.generateOrm)({
+    const { files: generatedFiles, stats: genStats } = (0, orm_1.generateOrm)({
         tables,
-        customOperations: customOperationsData,
+        customOperations: {
+            queries: customOperations.queries,
+            mutations: customOperations.mutations,
+            typeRegistry: customOperations.typeRegistry,
+        },
         config,
     });
-    console.log(`Generated ${stats.totalFiles} files`);
-    log(`  ${stats.tables} table models`);
-    log(`  ${stats.customQueries} custom query operations`);
-    log(`  ${stats.customMutations} custom mutation operations`);
+    console.log(`Generated ${genStats.totalFiles} files`);
+    log(`  ${genStats.tables} table models`);
+    log(`  ${genStats.customQueries} custom query operations`);
+    log(`  ${genStats.customMutations} custom mutation operations`);
+    const customQueries = customOperations.queries.map((q) => q.name);
+    const customMutations = customOperations.mutations.map((m) => m.name);
     if (options.dryRun) {
         return {
             success: true,
-            message: `Dry run complete. Would generate ${generatedFiles.length} files for ${tables.length} tables and ${customQueries.length + customMutations.length} custom operations.`,
+            message: `Dry run complete. Would generate ${generatedFiles.length} files for ${tables.length} tables and ${stats.customQueries + stats.customMutations} custom operations.`,
             tables: tables.map((t) => t.name),
             customQueries,
             customMutations,
             filesWritten: generatedFiles.map((f) => f.path),
         };
     }
-    // 8. Write files
+    // 6. Write files
     log('Writing files...');
-    const writeResult = await (0, generate_1.writeGeneratedFiles)(generatedFiles, outputDir, ['models', 'query', 'mutation']);
+    const writeResult = await (0, generate_1.writeGeneratedFiles)(generatedFiles, outputDir, [
+        'models',
+        'query',
+        'mutation',
+    ]);
     if (!writeResult.success) {
         return {
             success: false,
@@ -171,7 +150,8 @@ async function loadConfig(options) {
     }
     // Override with CLI options
     const mergedConfig = {
-        endpoint: options.endpoint || baseConfig.endpoint || '',
+        endpoint: options.endpoint || baseConfig.endpoint,
+        schema: options.schema || baseConfig.schema,
         output: options.output || baseConfig.output,
         headers: baseConfig.headers,
         tables: baseConfig.tables,
@@ -183,10 +163,11 @@ async function loadConfig(options) {
         codegen: baseConfig.codegen,
         orm: baseConfig.orm,
     };
-    if (!mergedConfig.endpoint) {
+    // Validate at least one source is provided
+    if (!mergedConfig.endpoint && !mergedConfig.schema) {
         return {
             success: false,
-            error: 'No endpoint specified. Use --endpoint or create a config file with "graphql-codegen init".',
+            error: 'No source specified. Use --endpoint or --schema, or create a config file with "graphql-codegen init".',
         };
     }
     // Resolve with defaults

package/cli/commands/generate.d.ts

@@ -3,6 +3,8 @@ export interface GenerateOptions {
     config?: string;
     /** GraphQL endpoint URL (overrides config) */
     endpoint?: string;
+    /** Path to GraphQL schema file (.graphql) */
+    schema?: string;
     /** Output directory (overrides config) */
     output?: string;
     /** Authorization header */

package/cli/commands/generate.js

@@ -36,22 +36,19 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateCommand = generateCommand;
 exports.writeGeneratedFiles = writeGeneratedFiles;
 /**
- * Generate command - introspects endpoint and generates SDK
+ * Generate command - generates SDK from GraphQL schema
  *
  * This command:
- * 1. Fetches _meta query for table-based CRUD operations
- * 2. Fetches __schema introspection for ALL operations
- * 3. Filters out table operations from custom operations to avoid duplicates
- * 4. Generates hooks for both table CRUD and custom operations
+ * 1. Fetches schema from endpoint or loads from file
+ * 2. Infers table metadata from introspection (replaces _meta)
+ * 3. Generates hooks for both table CRUD and custom operations
  */
 const fs = __importStar(require("node:fs"));
 const path = __importStar(require("node:path"));
 const prettier = __importStar(require("prettier"));
 const config_1 = require("../../types/config");
-const fetch_meta_1 = require("../introspect/fetch-meta");
-const fetch_schema_1 = require("../introspect/fetch-schema");
-const transform_1 = require("../introspect/transform");
-const transform_schema_1 = require("../introspect/transform-schema");
+const source_1 = require("../introspect/source");
+const shared_1 = require("./shared");
 const init_1 = require("./init");
 const codegen_1 = require("../codegen");
 /**
@@ -69,110 +66,90 @@ async function generateCommand(options = {}) {
         };
     }
     const config = configResult.config;
-    log(`  Endpoint: ${config.endpoint}`);
+    // Log source
+    if (config.schema) {
+        log(`  Schema: ${config.schema}`);
+    }
+    else {
+        log(`  Endpoint: ${config.endpoint}`);
+    }
     log(`  Output: ${config.output}`);
-    // 2. Validate endpoint
-    const endpointValidation = (0, fetch_meta_1.validateEndpoint)(config.endpoint);
-    if (!endpointValidation.valid) {
+    // 2. Create schema source
+    const sourceValidation = (0, source_1.validateSourceOptions)({
+        endpoint: config.endpoint || undefined,
+        schema: config.schema || undefined,
+    });
+    if (!sourceValidation.valid) {
         return {
             success: false,
-            message: `Invalid endpoint: ${endpointValidation.error}`,
+            message: sourceValidation.error,
         };
     }
-    // Build authorization header if provided
-    const authHeader = options.authorization || config.headers['Authorization'];
-    // 3. Fetch _meta for table-based operations
-    log('Fetching schema metadata (_meta)...');
-    const metaResult = await (0, fetch_meta_1.fetchMeta)({
-        endpoint: config.endpoint,
-        authorization: authHeader,
+    const source = (0, source_1.createSchemaSource)({
+        endpoint: config.endpoint || undefined,
+        schema: config.schema || undefined,
+        authorization: options.authorization || config.headers['Authorization'],
         headers: config.headers,
-        timeout: 30000,
     });
-    if (!metaResult.success) {
+    // 3. Run the codegen pipeline
+    let pipelineResult;
+    try {
+        pipelineResult = await (0, shared_1.runCodegenPipeline)({
+            source,
+            config,
+            verbose: options.verbose,
+            skipCustomOperations: options.skipCustomOperations,
+        });
+    }
+    catch (err) {
         return {
             success: false,
-            message: `Failed to fetch _meta: ${metaResult.error}`,
+            message: `Failed to fetch schema: ${err instanceof Error ? err.message : 'Unknown error'}`,
         };
     }
-    // 4. Transform to CleanTable[]
-    log('Transforming table schema...');
-    let tables = (0, transform_1.transformMetaToCleanTables)(metaResult.data);
-    log(`  Found ${tables.length} tables`);
-    // 5. Filter tables
-    tables = (0, transform_1.filterTables)(tables, config.tables.include, config.tables.exclude);
-    log(`  After filtering: ${tables.length} tables`);
-    if (tables.length === 0) {
+    const { tables, customOperations, stats } = pipelineResult;
+    // 4. Validate tables found
+    const tablesValidation = (0, shared_1.validateTablesFound)(tables);
+    if (!tablesValidation.valid) {
         return {
             success: false,
-            message: 'No tables found after filtering. Check your include/exclude patterns.',
+            message: tablesValidation.error,
         };
     }
-    // Get table operation names for filtering custom operations
-    const tableOperationNames = (0, transform_schema_1.getTableOperationNames)(tables);
-    // 6. Fetch __schema for custom operations (unless skipped)
-    let customQueries = [];
-    let customMutations = [];
-    let customOperationsData;
-    if (!options.skipCustomOperations) {
-        log('Fetching schema introspection (__schema)...');
-        const schemaResult = await (0, fetch_schema_1.fetchSchema)({
-            endpoint: config.endpoint,
-            authorization: authHeader,
-            headers: config.headers,
-            timeout: 30000,
-        });
-        if (schemaResult.success && schemaResult.data) {
-            log('Transforming custom operations...');
-            // Transform to CleanOperation[]
-            const { queries: allQueries, mutations: allMutations, typeRegistry } = (0, transform_schema_1.transformSchemaToOperations)(schemaResult.data);
-            log(`  Found ${allQueries.length} queries and ${allMutations.length} mutations total`);
-            // Filter by config include/exclude
-            const filteredQueries = (0, transform_schema_1.filterOperations)(allQueries, config.queries.include, config.queries.exclude);
-            const filteredMutations = (0, transform_schema_1.filterOperations)(allMutations, config.mutations.include, config.mutations.exclude);
-            log(`  After config filtering: ${filteredQueries.length} queries, ${filteredMutations.length} mutations`);
-            // Remove table operations (already handled by table generators)
-            const customQueriesOps = (0, transform_schema_1.getCustomOperations)(filteredQueries, tableOperationNames);
-            const customMutationsOps = (0, transform_schema_1.getCustomOperations)(filteredMutations, tableOperationNames);
-            log(`  Custom operations: ${customQueriesOps.length} queries, ${customMutationsOps.length} mutations`);
-            customQueries = customQueriesOps.map((q) => q.name);
-            customMutations = customMutationsOps.map((m) => m.name);
-            customOperationsData = {
-                queries: customQueriesOps,
-                mutations: customMutationsOps,
-                typeRegistry,
-            };
-        }
-        else {
-            log(`  Warning: Could not fetch __schema: ${schemaResult.error}`);
-            log('  Continuing with table-only generation...');
-        }
-    }
-    // 7. Generate code
+    // 5. Generate code
     console.log('Generating code...');
-    const { files: generatedFiles, stats } = (0, codegen_1.generate)({
+    const { files: generatedFiles, stats: genStats } = (0, codegen_1.generate)({
         tables,
-        customOperations: customOperationsData,
+        customOperations: {
+            queries: customOperations.queries,
+            mutations: customOperations.mutations,
+            typeRegistry: customOperations.typeRegistry,
+        },
         config,
     });
-    console.log(`Generated ${stats.totalFiles} files`);
-    log(`  ${stats.queryHooks} table query hooks`);
-    log(`  ${stats.mutationHooks} table mutation hooks`);
-    log(`  ${stats.customQueryHooks} custom query hooks`);
-    log(`  ${stats.customMutationHooks} custom mutation hooks`);
+    console.log(`Generated ${genStats.totalFiles} files`);
+    log(`  ${genStats.queryHooks} table query hooks`);
+    log(`  ${genStats.mutationHooks} table mutation hooks`);
+    log(`  ${genStats.customQueryHooks} custom query hooks`);
+    log(`  ${genStats.customMutationHooks} custom mutation hooks`);
+    const customQueries = customOperations.queries.map((q) => q.name);
+    const customMutations = customOperations.mutations.map((m) => m.name);
     if (options.dryRun) {
         return {
             success: true,
-            message: `Dry run complete. Would generate ${generatedFiles.length} files for ${tables.length} tables and ${customQueries.length + customMutations.length} custom operations.`,
+            message: `Dry run complete. Would generate ${generatedFiles.length} files for ${tables.length} tables and ${stats.customQueries + stats.customMutations} custom operations.`,
             tables: tables.map((t) => t.name),
             customQueries,
             customMutations,
             filesWritten: generatedFiles.map((f) => f.path),
         };
     }
-    // 8. Write files
+    // 6. Write files
     log('Writing files...');
-    const writeResult = await writeGeneratedFiles(generatedFiles, config.output, ['queries', 'mutations']);
+    const writeResult = await writeGeneratedFiles(generatedFiles, config.output, [
+        'queries',
+        'mutations',
+    ]);
     if (!writeResult.success) {
         return {
             success: false,
@@ -207,7 +184,8 @@ async function loadConfig(options) {
     }
     // Override with CLI options
     const mergedConfig = {
-        endpoint: options.endpoint || baseConfig.endpoint || '',
+        endpoint: options.endpoint || baseConfig.endpoint,
+        schema: options.schema || baseConfig.schema,
         output: options.output || baseConfig.output,
         headers: baseConfig.headers,
         tables: baseConfig.tables,
@@ -218,10 +196,11 @@ async function loadConfig(options) {
         postgraphile: baseConfig.postgraphile,
         codegen: baseConfig.codegen,
     };
-    if (!mergedConfig.endpoint) {
+    // Validate at least one source is provided
+    if (!mergedConfig.endpoint && !mergedConfig.schema) {
         return {
             success: false,
-            error: 'No endpoint specified. Use --endpoint or create a config file with "graphql-codegen init".',
+            error: 'No source specified. Use --endpoint or --schema, or create a config file with "graphql-codegen init".',
         };
     }
     // Resolve with defaults

package/cli/commands/shared.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Shared Codegen Pipeline
+ *
+ * Consolidates the common logic between generate and generate-orm commands.
+ * Handles:
+ * - Schema fetching from source (endpoint or file)
+ * - Table inference from introspection
+ * - Operation transformation
+ * - Filtering
+ */
+import type { ResolvedConfig } from '../../types/config';
+import type { CleanTable, CleanOperation, TypeRegistry } from '../../types/schema';
+import type { SchemaSource } from '../introspect/source';
+export interface CodegenPipelineOptions {
+    /**
+     * Schema source (endpoint or file)
+     */
+    source: SchemaSource;
+    /**
+     * Resolved configuration
+     */
+    config: ResolvedConfig;
+    /**
+     * Enable verbose logging
+     */
+    verbose?: boolean;
+    /**
+     * Skip custom operations (only generate table CRUD)
+     */
+    skipCustomOperations?: boolean;
+}
+export interface CodegenPipelineResult {
+    /**
+     * Inferred table metadata
+     */
+    tables: CleanTable[];
+    /**
+     * Custom operations (queries and mutations not covered by tables)
+     */
+    customOperations: {
+        queries: CleanOperation[];
+        mutations: CleanOperation[];
+        typeRegistry: TypeRegistry;
+    };
+    /**
+     * Statistics about what was found
+     */
+    stats: {
+        totalTables: number;
+        filteredTables: number;
+        totalQueries: number;
+        totalMutations: number;
+        customQueries: number;
+        customMutations: number;
+    };
+}
+/**
+ * Run the unified codegen pipeline
+ *
+ * This replaces the duplicated logic in generate.ts and generate-orm.ts:
+ * 1. Fetch introspection from source (endpoint or file)
+ * 2. Infer tables from introspection (replaces _meta query)
+ * 3. Transform to operations
+ * 4. Filter by config
+ * 5. Separate table operations from custom operations
+ */
+export declare function runCodegenPipeline(options: CodegenPipelineOptions): Promise<CodegenPipelineResult>;
+/**
+ * Validate that tables were found
+ */
+export declare function validateTablesFound(tables: CleanTable[]): {
+    valid: boolean;
+    error?: string;
+};

package/cli/commands/shared.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runCodegenPipeline = runCodegenPipeline;
+exports.validateTablesFound = validateTablesFound;
+const infer_tables_1 = require("../introspect/infer-tables");
+const transform_1 = require("../introspect/transform");
+const transform_schema_1 = require("../introspect/transform-schema");
+// ============================================================================
+// Main Pipeline
+// ============================================================================
+/**
+ * Run the unified codegen pipeline
+ *
+ * This replaces the duplicated logic in generate.ts and generate-orm.ts:
+ * 1. Fetch introspection from source (endpoint or file)
+ * 2. Infer tables from introspection (replaces _meta query)
+ * 3. Transform to operations
+ * 4. Filter by config
+ * 5. Separate table operations from custom operations
+ */
+async function runCodegenPipeline(options) {
+    const { source, config, verbose = false, skipCustomOperations = false, } = options;
+    const log = verbose ? console.log : () => { };
+    // 1. Fetch introspection from source
+    log(`Fetching schema from ${source.describe()}...`);
+    const { introspection } = await source.fetch();
+    // 2. Infer tables from introspection (replaces _meta)
+    log('Inferring table metadata from schema...');
+    let tables = (0, infer_tables_1.inferTablesFromIntrospection)(introspection);
+    const totalTables = tables.length;
+    log(`  Found ${totalTables} tables`);
+    // 3. Filter tables by config
+    tables = (0, transform_1.filterTables)(tables, config.tables.include, config.tables.exclude);
+    const filteredTables = tables.length;
+    log(`  After filtering: ${filteredTables} tables`);
+    // 4. Transform introspection to operations
+    log('Transforming operations...');
+    const { queries: allQueries, mutations: allMutations, typeRegistry, } = (0, transform_schema_1.transformSchemaToOperations)(introspection);
+    const totalQueries = allQueries.length;
+    const totalMutations = allMutations.length;
+    log(`  Found ${totalQueries} queries and ${totalMutations} mutations total`);
+    // 5. Get table operation names for filtering custom ops
+    const tableOperationNames = (0, transform_schema_1.getTableOperationNames)(tables);
+    // 6. Filter and separate custom operations
+    let customQueries = [];
+    let customMutations = [];
+    if (!skipCustomOperations) {
+        // Filter by config include/exclude
+        const filteredQueries = (0, transform_schema_1.filterOperations)(allQueries, config.queries.include, config.queries.exclude);
+        const filteredMutations = (0, transform_schema_1.filterOperations)(allMutations, config.mutations.include, config.mutations.exclude);
+        log(`  After config filtering: ${filteredQueries.length} queries, ${filteredMutations.length} mutations`);
+        // Remove table operations (already handled by table generators)
+        customQueries = (0, transform_schema_1.getCustomOperations)(filteredQueries, tableOperationNames);
+        customMutations = (0, transform_schema_1.getCustomOperations)(filteredMutations, tableOperationNames);
+        log(`  Custom operations: ${customQueries.length} queries, ${customMutations.length} mutations`);
+    }
+    return {
+        tables,
+        customOperations: {
+            queries: customQueries,
+            mutations: customMutations,
+            typeRegistry,
+        },
+        stats: {
+            totalTables,
+            filteredTables,
+            totalQueries,
+            totalMutations,
+            customQueries: customQueries.length,
+            customMutations: customMutations.length,
+        },
+    };
+}
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+/**
+ * Validate that tables were found
+ */
+function validateTablesFound(tables) {
+    if (tables.length === 0) {
+        return {
+            valid: false,
+            error: 'No tables found after filtering. Check your include/exclude patterns.',
+        };
+    }
+    return { valid: true };
+}