@constructive-io/graphql-codegen 2.22.1 → 2.23.0

package/cli/index.js

@@ -56,7 +56,7 @@ async function loadWatchConfig(options) {
     if (configPath) {
         const loadResult = await (0, init_1.loadConfigFile)(configPath);
         if (!loadResult.success) {
-            console.error('✗', loadResult.error);
+            console.error('x', loadResult.error);
             return null;
         }
         baseConfig = loadResult.config;
@@ -77,21 +77,23 @@ async function loadWatchConfig(options) {
         watch: {
             ...baseConfig.watch,
             // CLI options override config
-            ...(options.pollInterval !== undefined && { pollInterval: options.pollInterval }),
+            ...(options.pollInterval !== undefined && {
+                pollInterval: options.pollInterval,
+            }),
             ...(options.debounce !== undefined && { debounce: options.debounce }),
             ...(options.touch !== undefined && { touchFile: options.touch }),
             ...(options.clear !== undefined && { clearScreen: options.clear }),
         },
     };
     if (!mergedConfig.endpoint) {
-        console.error('✗ No endpoint specified. Use --endpoint or create a config file with "graphql-codegen init".');
+        console.error('x No endpoint specified. Use --endpoint or create a config file with "graphql-codegen init".');
         return null;
     }
     return (0, config_1.resolveConfig)(mergedConfig);
 }
 program
     .name('graphql-codegen')
-    .description('CLI for generating GraphQL SDK from PostGraphile endpoints')
+    .description('CLI for generating GraphQL SDK from PostGraphile endpoints or schema files')
     .version('2.17.48');
 // Init command
 program
@@ -109,19 +111,20 @@ program
         output: options.output,
     });
     if (result.success) {
-        console.log('✓', result.message);
+        console.log('[ok]', result.message);
     }
     else {
-        console.error('✗', result.message);
+        console.error('x', result.message);
         process.exit(1);
     }
 });
 // Generate command
 program
     .command('generate')
-    .description('Generate SDK from GraphQL endpoint')
+    .description('Generate SDK from GraphQL endpoint or schema file')
     .option('-c, --config <path>', 'Path to config file')
     .option('-e, --endpoint <url>', 'GraphQL endpoint URL (overrides config)')
+    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
     .option('-o, --output <dir>', 'Output directory (overrides config)')
     .option('-a, --authorization <header>', 'Authorization header value')
     .option('-v, --verbose', 'Verbose output', false)
@@ -132,8 +135,17 @@ program
     .option('--touch <file>', 'File to touch on schema change')
     .option('--no-clear', 'Do not clear terminal on regeneration')
     .action(async (options) => {
-    // Watch mode
+    // Validate source options
+    if (options.endpoint && options.schema) {
+        console.error('x Cannot use both --endpoint and --schema. Choose one source.');
+        process.exit(1);
+    }
+    // Watch mode (only for endpoint)
     if (options.watch) {
+        if (options.schema) {
+            console.error('x Watch mode is only supported with --endpoint, not --schema.');
+            process.exit(1);
+        }
         const config = await loadWatchConfig(options);
         if (!config) {
             process.exit(1);
@@ -151,13 +163,14 @@ program
     const result = await (0, generate_1.generateCommand)({
         config: options.config,
         endpoint: options.endpoint,
+        schema: options.schema,
         output: options.output,
         authorization: options.authorization,
         verbose: options.verbose,
         dryRun: options.dryRun,
     });
     if (result.success) {
-        console.log('✓', result.message);
+        console.log('[ok]', result.message);
         if (result.tables && result.tables.length > 0) {
             console.log('\nTables:');
             result.tables.forEach((t) => console.log(`  - ${t}`));
@@ -168,7 +181,7 @@ program
         }
     }
     else {
-        console.error('✗', result.message);
+        console.error('x', result.message);
         if (result.errors) {
             result.errors.forEach((e) => console.error('  -', e));
         }
@@ -178,9 +191,10 @@ program
 // Generate ORM command
 program
     .command('generate-orm')
-    .description('Generate Prisma-like ORM client from GraphQL endpoint')
+    .description('Generate Prisma-like ORM client from GraphQL endpoint or schema file')
     .option('-c, --config <path>', 'Path to config file')
     .option('-e, --endpoint <url>', 'GraphQL endpoint URL (overrides config)')
+    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
     .option('-o, --output <dir>', 'Output directory (overrides config)', './generated/orm')
     .option('-a, --authorization <header>', 'Authorization header value')
     .option('-v, --verbose', 'Verbose output', false)
@@ -192,8 +206,17 @@ program
     .option('--touch <file>', 'File to touch on schema change')
     .option('--no-clear', 'Do not clear terminal on regeneration')
     .action(async (options) => {
-    // Watch mode
+    // Validate source options
+    if (options.endpoint && options.schema) {
+        console.error('x Cannot use both --endpoint and --schema. Choose one source.');
+        process.exit(1);
+    }
+    // Watch mode (only for endpoint)
     if (options.watch) {
+        if (options.schema) {
+            console.error('x Watch mode is only supported with --endpoint, not --schema.');
+            process.exit(1);
+        }
         const config = await loadWatchConfig(options);
         if (!config) {
             process.exit(1);
@@ -212,6 +235,7 @@ program
     const result = await (0, generate_orm_1.generateOrmCommand)({
         config: options.config,
         endpoint: options.endpoint,
+        schema: options.schema,
         output: options.output,
         authorization: options.authorization,
         verbose: options.verbose,
@@ -219,7 +243,7 @@ program
         skipCustomOperations: options.skipCustomOperations,
     });
     if (result.success) {
-        console.log('✓', result.message);
+        console.log('[ok]', result.message);
         if (result.tables && result.tables.length > 0) {
             console.log('\nTables:');
             result.tables.forEach((t) => console.log(`  - ${t}`));
@@ -238,54 +262,60 @@ program
         }
     }
     else {
-        console.error('✗', result.message);
+        console.error('x', result.message);
         if (result.errors) {
             result.errors.forEach((e) => console.error('  -', e));
         }
         process.exit(1);
     }
 });
-// Introspect command (for debugging)
+// Introspect command (for debugging) - uses the new inference system
 program
     .command('introspect')
-    .description('Introspect a GraphQL endpoint and print table info')
-    .requiredOption('-e, --endpoint <url>', 'GraphQL endpoint URL')
+    .description('Introspect a GraphQL endpoint or schema file and print table info')
+    .option('-e, --endpoint <url>', 'GraphQL endpoint URL')
+    .option('-s, --schema <path>', 'Path to GraphQL schema file (.graphql)')
     .option('-a, --authorization <header>', 'Authorization header value')
     .option('--json', 'Output as JSON', false)
     .action(async (options) => {
-    const { fetchMeta, validateEndpoint } = await Promise.resolve().then(() => __importStar(require('./introspect/fetch-meta')));
-    const { transformMetaToCleanTables, getTableNames } = await Promise.resolve().then(() => __importStar(require('./introspect/transform')));
-    // Validate endpoint
-    const validation = validateEndpoint(options.endpoint);
-    if (!validation.valid) {
-        console.error('✗ Invalid endpoint:', validation.error);
+    // Validate source options
+    if (!options.endpoint && !options.schema) {
+        console.error('x Either --endpoint or --schema must be provided.');
         process.exit(1);
     }
-    console.log('Fetching schema from', options.endpoint, '...');
-    const result = await fetchMeta({
-        endpoint: options.endpoint,
-        authorization: options.authorization,
-    });
-    if (!result.success) {
-        console.error('✗ Failed to fetch schema:', result.error);
+    if (options.endpoint && options.schema) {
+        console.error('x Cannot use both --endpoint and --schema. Choose one source.');
         process.exit(1);
     }
-    const tables = transformMetaToCleanTables(result.data);
-    const tableNames = getTableNames(tables);
-    if (options.json) {
-        console.log(JSON.stringify(tables, null, 2));
-    }
-    else {
-        console.log(`\n✓ Found ${tables.length} tables:\n`);
-        tableNames.forEach((name) => {
-            const table = tables.find((t) => t.name === name);
-            const fieldCount = table.fields.length;
-            const relationCount = table.relations.belongsTo.length +
-                table.relations.hasOne.length +
-                table.relations.hasMany.length +
-                table.relations.manyToMany.length;
-            console.log(`  ${name} (${fieldCount} fields, ${relationCount} relations)`);
+    const { createSchemaSource } = await Promise.resolve().then(() => __importStar(require('./introspect/source')));
+    const { inferTablesFromIntrospection } = await Promise.resolve().then(() => __importStar(require('./introspect/infer-tables')));
+    try {
+        const source = createSchemaSource({
+            endpoint: options.endpoint,
+            schema: options.schema,
+            authorization: options.authorization,
         });
+        console.log('Fetching schema from', source.describe(), '...');
+        const { introspection } = await source.fetch();
+        const tables = inferTablesFromIntrospection(introspection);
+        if (options.json) {
+            console.log(JSON.stringify(tables, null, 2));
+        }
+        else {
+            console.log(`\n[ok] Found ${tables.length} tables:\n`);
+            tables.forEach((table) => {
+                const fieldCount = table.fields.length;
+                const relationCount = table.relations.belongsTo.length +
+                    table.relations.hasOne.length +
+                    table.relations.hasMany.length +
+                    table.relations.manyToMany.length;
+                console.log(`  ${table.name} (${fieldCount} fields, ${relationCount} relations)`);
+            });
+        }
+    }
+    catch (err) {
+        console.error('x Failed to introspect schema:', err instanceof Error ? err.message : err);
+        process.exit(1);
     }
 });
 program.parse();

package/cli/introspect/index.d.ts

@@ -1,8 +1,11 @@
 /**
  * Introspection module exports
  */
-export { META_QUERY } from './meta-query';
-export type { MetaQueryResponse, MetaTable, MetaField, MetaFieldType, MetaConstraint, MetaForeignKeyConstraint, MetaTableQuery, MetaTableInflection, MetaBelongsToRelation, MetaHasRelation, MetaManyToManyRelation, MetaTableRelations, } from './meta-query';
-export { fetchMeta, validateEndpoint } from './fetch-meta';
-export type { FetchMetaOptions, FetchMetaResult } from './fetch-meta';
-export { transformMetaToCleanTables, getTableNames, findTable, filterTables, } from './transform';
+export { inferTablesFromIntrospection } from './infer-tables';
+export type { InferTablesOptions } from './infer-tables';
+export { singularize, pluralize } from './pluralize';
+export { createSchemaSource, validateSourceOptions, EndpointSchemaSource, FileSchemaSource, SchemaSourceError, } from './source';
+export type { SchemaSource, SchemaSourceResult, CreateSchemaSourceOptions, } from './source';
+export { fetchSchema } from './fetch-schema';
+export type { FetchSchemaOptions, FetchSchemaResult } from './fetch-schema';
+export { getTableNames, findTable, filterTables } from './transform';

package/cli/introspect/index.js

@@ -3,14 +3,26 @@
  * Introspection module exports
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterTables = exports.findTable = exports.getTableNames = exports.transformMetaToCleanTables = exports.validateEndpoint = exports.fetchMeta = exports.META_QUERY = void 0;
-var meta_query_1 = require("./meta-query");
-Object.defineProperty(exports, "META_QUERY", { enumerable: true, get: function () { return meta_query_1.META_QUERY; } });
-var fetch_meta_1 = require("./fetch-meta");
-Object.defineProperty(exports, "fetchMeta", { enumerable: true, get: function () { return fetch_meta_1.fetchMeta; } });
-Object.defineProperty(exports, "validateEndpoint", { enumerable: true, get: function () { return fetch_meta_1.validateEndpoint; } });
+exports.filterTables = exports.findTable = exports.getTableNames = exports.fetchSchema = exports.SchemaSourceError = exports.FileSchemaSource = exports.EndpointSchemaSource = exports.validateSourceOptions = exports.createSchemaSource = exports.pluralize = exports.singularize = exports.inferTablesFromIntrospection = void 0;
+// Table inference from introspection
+var infer_tables_1 = require("./infer-tables");
+Object.defineProperty(exports, "inferTablesFromIntrospection", { enumerable: true, get: function () { return infer_tables_1.inferTablesFromIntrospection; } });
+// Pluralization utilities
+var pluralize_1 = require("./pluralize");
+Object.defineProperty(exports, "singularize", { enumerable: true, get: function () { return pluralize_1.singularize; } });
+Object.defineProperty(exports, "pluralize", { enumerable: true, get: function () { return pluralize_1.pluralize; } });
+// Schema sources
+var source_1 = require("./source");
+Object.defineProperty(exports, "createSchemaSource", { enumerable: true, get: function () { return source_1.createSchemaSource; } });
+Object.defineProperty(exports, "validateSourceOptions", { enumerable: true, get: function () { return source_1.validateSourceOptions; } });
+Object.defineProperty(exports, "EndpointSchemaSource", { enumerable: true, get: function () { return source_1.EndpointSchemaSource; } });
+Object.defineProperty(exports, "FileSchemaSource", { enumerable: true, get: function () { return source_1.FileSchemaSource; } });
+Object.defineProperty(exports, "SchemaSourceError", { enumerable: true, get: function () { return source_1.SchemaSourceError; } });
+// Schema fetching (still used by watch mode)
+var fetch_schema_1 = require("./fetch-schema");
+Object.defineProperty(exports, "fetchSchema", { enumerable: true, get: function () { return fetch_schema_1.fetchSchema; } });
+// Transform utilities (only filterTables, getTableNames, findTable are still useful)
 var transform_1 = require("./transform");
-Object.defineProperty(exports, "transformMetaToCleanTables", { enumerable: true, get: function () { return transform_1.transformMetaToCleanTables; } });
 Object.defineProperty(exports, "getTableNames", { enumerable: true, get: function () { return transform_1.getTableNames; } });
 Object.defineProperty(exports, "findTable", { enumerable: true, get: function () { return transform_1.findTable; } });
 Object.defineProperty(exports, "filterTables", { enumerable: true, get: function () { return transform_1.filterTables; } });

package/cli/introspect/infer-tables.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Infer PostGraphile table metadata from standard GraphQL introspection
+ *
+ * This module replaces the need for the _meta query by recognizing PostGraphile's
+ * naming conventions and type patterns from standard GraphQL introspection.
+ *
+ * Key patterns recognized:
+ * - Connection types: {PluralName}Connection → entity name
+ * - Filter types: {Name}Filter
+ * - Input types: Create{Name}Input, Update{Name}Input, Delete{Name}Input
+ * - Payload types: Create{Name}Payload, Update{Name}Payload, Delete{Name}Payload
+ * - Query operations: {pluralName} (list), {singularName} (single)
+ * - Mutation operations: create{Name}, update{Name}, delete{Name}
+ */
+import type { IntrospectionQueryResponse } from '../../types/introspection';
+import type { CleanTable } from '../../types/schema';
+/**
+ * PostGraphile naming patterns for type detection
+ */
+declare const PATTERNS: {
+    connection: RegExp;
+    edge: RegExp;
+    filter: RegExp;
+    condition: RegExp;
+    orderBy: RegExp;
+    patch: RegExp;
+    createInput: RegExp;
+    updateInput: RegExp;
+    deleteInput: RegExp;
+    createPayload: RegExp;
+    updatePayload: RegExp;
+    deletePayload: RegExp;
+    createMutation: RegExp;
+    updateMutation: RegExp;
+    deleteMutation: RegExp;
+};
+export interface InferTablesOptions {
+    /**
+     * Custom pattern overrides (for non-standard PostGraphile configurations)
+     */
+    patterns?: Partial<typeof PATTERNS>;
+}
+/**
+ * Infer CleanTable[] from GraphQL introspection by recognizing PostGraphile patterns
+ *
+ * @param introspection - Standard GraphQL introspection response
+ * @param options - Optional configuration
+ * @returns Array of CleanTable objects compatible with existing generators
+ */
+export declare function inferTablesFromIntrospection(introspection: IntrospectionQueryResponse, options?: InferTablesOptions): CleanTable[];
+export {};