@constructive-io/graphql-codegen 2.22.1 → 2.23.0

package/esm/cli/watch/poller.d.ts

@@ -5,7 +5,6 @@
  * No file I/O during normal polling - only touchFile is optional file write.
  */
 import { EventEmitter } from 'node:events';
-import type { MetaQueryResponse } from '../introspect/meta-query';
 import type { IntrospectionQueryResponse } from '../../types/introspection';
 import { SchemaCache } from './cache';
 import type { PollResult, WatchOptions } from './types';
@@ -62,4 +61,4 @@ export declare class SchemaPoller extends EventEmitter {
 /**
  * Utility to compute schema hash without full poll
  */
-export declare function computeSchemaHash(meta: MetaQueryResponse, schema: IntrospectionQueryResponse): Promise<string>;
+export declare function computeSchemaHash(schema: IntrospectionQueryResponse): Promise<string>;

package/esm/cli/watch/poller.js

@@ -5,10 +5,9 @@
  * No file I/O during normal polling - only touchFile is optional file write.
  */
 import { EventEmitter } from 'node:events';
-import { fetchMeta } from '../introspect/fetch-meta';
 import { fetchSchema } from '../introspect/fetch-schema';
 import { SchemaCache, touchFile } from './cache';
-import { hashObject, combineHashes } from './hash';
+import { hashObject } from './hash';
 /**
  * Schema poller that periodically introspects a GraphQL endpoint
  * and emits events when the schema changes.
@@ -56,39 +55,31 @@ export class SchemaPoller extends EventEmitter {
     async poll() {
         // Prevent concurrent polls
         if (this.isPolling) {
-            return { success: false, changed: false, error: 'Poll already in progress' };
+            return {
+                success: false,
+                changed: false,
+                error: 'Poll already in progress',
+            };
         }
         this.isPolling = true;
         const startTime = Date.now();
         this.emit('poll-start', this.createEvent('poll-start'));
         try {
-            // Fetch both _meta and __schema
-            const [metaResult, schemaResult] = await Promise.all([
-                fetchMeta({
-                    endpoint: this.options.endpoint,
-                    authorization: this.options.authorization,
-                    headers: this.options.headers,
-                    timeout: 30000,
-                }),
-                fetchSchema({
-                    endpoint: this.options.endpoint,
-                    authorization: this.options.authorization,
-                    headers: this.options.headers,
-                    timeout: 30000,
-                }),
-            ]);
+            // Fetch __schema via standard introspection
+            const schemaResult = await fetchSchema({
+                endpoint: this.options.endpoint,
+                authorization: this.options.authorization,
+                headers: this.options.headers,
+                timeout: 30000,
+            });
             const duration = Date.now() - startTime;
             // Check for errors
-            if (!metaResult.success) {
-                return this.handleError(`_meta fetch failed: ${metaResult.error}`, duration);
-            }
             if (!schemaResult.success) {
                 return this.handleError(`__schema fetch failed: ${schemaResult.error}`, duration);
             }
-            const meta = metaResult.data;
             const schema = schemaResult.data;
             // Check if schema changed
-            const { changed, newHash } = await this.cache.hasChanged(meta, schema);
+            const { changed, newHash } = await this.cache.hasChanged(schema);
             // Reset error counter on success
             this.consecutiveErrors = 0;
             if (changed) {
@@ -99,11 +90,11 @@ export class SchemaPoller extends EventEmitter {
                     touchFile(this.options.touchFile);
                 }
                 this.emit('schema-changed', this.createEvent('schema-changed', { hash: newHash, duration }));
-                return { success: true, changed: true, hash: newHash, meta, schema };
+                return { success: true, changed: true, hash: newHash, schema };
             }
             this.emit('schema-unchanged', this.createEvent('schema-unchanged', { duration }));
             this.emit('poll-success', this.createEvent('poll-success', { duration }));
-            return { success: true, changed: false, hash: newHash, meta, schema };
+            return { success: true, changed: false, hash: newHash, schema };
         }
         catch (err) {
             const duration = Date.now() - startTime;
@@ -126,22 +117,14 @@ export class SchemaPoller extends EventEmitter {
      */
     async seedCache() {
         try {
-            const [metaResult, schemaResult] = await Promise.all([
-                fetchMeta({
-                    endpoint: this.options.endpoint,
-                    authorization: this.options.authorization,
-                    headers: this.options.headers,
-                    timeout: 30000,
-                }),
-                fetchSchema({
-                    endpoint: this.options.endpoint,
-                    authorization: this.options.authorization,
-                    headers: this.options.headers,
-                    timeout: 30000,
-                }),
-            ]);
-            if (metaResult.success && schemaResult.success) {
-                const { newHash } = await this.cache.hasChanged(metaResult.data, schemaResult.data);
+            const schemaResult = await fetchSchema({
+                endpoint: this.options.endpoint,
+                authorization: this.options.authorization,
+                headers: this.options.headers,
+                timeout: 30000,
+            });
+            if (schemaResult.success) {
+                const { newHash } = await this.cache.hasChanged(schemaResult.data);
                 this.cache.updateHash(newHash);
             }
         }
@@ -171,7 +154,8 @@ export class SchemaPoller extends EventEmitter {
         this.consecutiveErrors++;
         this.emit('poll-error', this.createEvent('poll-error', { error, duration }));
         // Slow down polling after multiple consecutive errors
-        if (this.consecutiveErrors >= this.MAX_CONSECUTIVE_ERRORS && this.pollTimer) {
+        if (this.consecutiveErrors >= this.MAX_CONSECUTIVE_ERRORS &&
+            this.pollTimer) {
             this.stop();
             const newInterval = this.options.pollInterval * 2;
             this.pollTimer = setInterval(() => {
@@ -191,8 +175,6 @@ export class SchemaPoller extends EventEmitter {
 /**
  * Utility to compute schema hash without full poll
  */
-export async function computeSchemaHash(meta, schema) {
-    const metaHash = await hashObject(meta);
-    const schemaHash = await hashObject(schema);
-    return combineHashes(metaHash, schemaHash);
+export async function computeSchemaHash(schema) {
+    return hashObject(schema);
 }

package/esm/cli/watch/types.d.ts

@@ -1,7 +1,6 @@
 /**
  * Watch mode types
  */
-import type { MetaQueryResponse } from '../introspect/meta-query';
 import type { IntrospectionQueryResponse } from '../../types/introspection';
 /**
  * Result of a schema poll operation
@@ -14,8 +13,6 @@ export interface PollResult {
     error?: string;
     /** The new hash if successful */
     hash?: string;
-    /** Meta response if successful */
-    meta?: MetaQueryResponse;
     /** Schema response if successful */
     schema?: IntrospectionQueryResponse;
 }

package/esm/types/config.d.ts

@@ -6,9 +6,15 @@
  */
 export interface GraphQLSDKConfig {
     /**
-     * GraphQL endpoint URL (must expose _meta query)
+     * GraphQL endpoint URL for live introspection
+     * Either endpoint or schema must be provided
      */
-    endpoint: string;
+    endpoint?: string;
+    /**
+     * Path to GraphQL schema file (.graphql) for file-based generation
+     * Either endpoint or schema must be provided
+     */
+    schema?: string;
     /**
      * Headers to include in introspection requests
      */
@@ -19,7 +25,7 @@ export interface GraphQLSDKConfig {
      */
     output?: string;
     /**
-     * Table filtering options (for table-based CRUD operations from _meta)
+     * Table filtering options (for table-based CRUD operations)
      */
     tables?: {
         /** Tables to include (glob patterns supported) */
@@ -154,8 +160,17 @@ export interface ResolvedWatchConfig {
 /**
  * Resolved configuration with defaults applied
  */
-export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers' | 'tables' | 'queries' | 'mutations' | 'hooks' | 'postgraphile' | 'codegen' | 'orm' | 'reactQuery' | 'watch'>> {
+export interface ResolvedConfig {
+    /**
+     * GraphQL endpoint URL (empty string if using schema file)
+     */
+    endpoint: string;
+    /**
+     * Path to GraphQL schema file (null if using endpoint)
+     */
+    schema: string | null;
     headers: Record<string, string>;
+    output: string;
     tables: {
         include: string[];
         exclude: string[];
@@ -168,6 +183,7 @@ export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers
         include: string[];
         exclude: string[];
     };
+    excludeFields: string[];
     hooks: {
         queries: boolean;
         mutations: boolean;
@@ -196,7 +212,7 @@ export declare const DEFAULT_WATCH_CONFIG: ResolvedWatchConfig;
 /**
  * Default configuration values
  */
-export declare const DEFAULT_CONFIG: Omit<ResolvedConfig, 'endpoint'>;
+export declare const DEFAULT_CONFIG: Omit<ResolvedConfig, 'endpoint' | 'schema'>;
 /**
  * Default ORM configuration values
  */

package/esm/types/config.js

@@ -65,7 +65,8 @@ export function defineConfig(config) {
  */
 export function resolveConfig(config) {
     return {
-        endpoint: config.endpoint,
+        endpoint: config.endpoint ?? '',
+        schema: config.schema ?? null,
         headers: config.headers ?? DEFAULT_CONFIG.headers,
         output: config.output ?? DEFAULT_CONFIG.output,
         tables: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "2.22.1",
+  "version": "2.23.0",
   "description": "CLI-based GraphQL SDK generator for PostGraphile endpoints with React Query hooks",
   "keywords": [
     "graphql",
@@ -43,6 +43,8 @@
     "test:watch": "jest --watch",
     "example:codegen:sdk": "node dist/cli/index.js generate --endpoint http://api.localhost:3000/graphql --output examples/output/generated-sdk",
     "example:codegen:orm": "node dist/cli/index.js generate-orm --endpoint http://api.localhost:3000/graphql --output examples/output/generated-orm",
+    "example:codegen:sdk:schema": "node dist/cli/index.js generate --schema examples/example.schema.graphql --output examples/output/generated-sdk-schema",
+    "example:codegen:orm:schema": "node dist/cli/index.js generate-orm --schema examples/example.schema.graphql --output examples/output/generated-orm-schema",
     "example:sdk": "tsx examples/react-query-sdk.ts",
     "example:orm": "tsx examples/orm-sdk.ts"
   },
@@ -79,5 +81,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "cb086f098f3d82ee9e4eced65383fc3f45253064"
+  "gitHead": "ba5bbacf7ccc1980cba10bf3f45ebb0ca639fb79"
 }

package/types/config.d.ts

@@ -6,9 +6,15 @@
  */
 export interface GraphQLSDKConfig {
     /**
-     * GraphQL endpoint URL (must expose _meta query)
+     * GraphQL endpoint URL for live introspection
+     * Either endpoint or schema must be provided
      */
-    endpoint: string;
+    endpoint?: string;
+    /**
+     * Path to GraphQL schema file (.graphql) for file-based generation
+     * Either endpoint or schema must be provided
+     */
+    schema?: string;
     /**
      * Headers to include in introspection requests
      */
@@ -19,7 +25,7 @@ export interface GraphQLSDKConfig {
      */
     output?: string;
     /**
-     * Table filtering options (for table-based CRUD operations from _meta)
+     * Table filtering options (for table-based CRUD operations)
      */
     tables?: {
         /** Tables to include (glob patterns supported) */
@@ -154,8 +160,17 @@ export interface ResolvedWatchConfig {
 /**
  * Resolved configuration with defaults applied
  */
-export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers' | 'tables' | 'queries' | 'mutations' | 'hooks' | 'postgraphile' | 'codegen' | 'orm' | 'reactQuery' | 'watch'>> {
+export interface ResolvedConfig {
+    /**
+     * GraphQL endpoint URL (empty string if using schema file)
+     */
+    endpoint: string;
+    /**
+     * Path to GraphQL schema file (null if using endpoint)
+     */
+    schema: string | null;
     headers: Record<string, string>;
+    output: string;
     tables: {
         include: string[];
         exclude: string[];
@@ -168,6 +183,7 @@ export interface ResolvedConfig extends Required<Omit<GraphQLSDKConfig, 'headers
         include: string[];
         exclude: string[];
     };
+    excludeFields: string[];
     hooks: {
         queries: boolean;
         mutations: boolean;
@@ -196,7 +212,7 @@ export declare const DEFAULT_WATCH_CONFIG: ResolvedWatchConfig;
 /**
  * Default configuration values
  */
-export declare const DEFAULT_CONFIG: Omit<ResolvedConfig, 'endpoint'>;
+export declare const DEFAULT_CONFIG: Omit<ResolvedConfig, 'endpoint' | 'schema'>;
 /**
  * Default ORM configuration values
  */

package/types/config.js

@@ -70,7 +70,8 @@ function defineConfig(config) {
  */
 function resolveConfig(config) {
     return {
-        endpoint: config.endpoint,
+        endpoint: config.endpoint ?? '',
+        schema: config.schema ?? null,
         headers: config.headers ?? exports.DEFAULT_CONFIG.headers,
         output: config.output ?? exports.DEFAULT_CONFIG.output,
         tables: {

package/cli/introspect/fetch-meta.d.ts

@@ -1,31 +0,0 @@
-/**
- * Fetch _meta query from a PostGraphile endpoint
- */
-import { type MetaQueryResponse } from './meta-query';
-export interface FetchMetaOptions {
-    /** GraphQL endpoint URL */
-    endpoint: string;
-    /** Optional authorization header value (e.g., "Bearer token") */
-    authorization?: string;
-    /** Optional additional headers */
-    headers?: Record<string, string>;
-    /** Request timeout in milliseconds (default: 30000) */
-    timeout?: number;
-}
-export interface FetchMetaResult {
-    success: boolean;
-    data?: MetaQueryResponse;
-    error?: string;
-    statusCode?: number;
-}
-/**
- * Fetch the _meta query from a PostGraphile endpoint
- */
-export declare function fetchMeta(options: FetchMetaOptions): Promise<FetchMetaResult>;
-/**
- * Validate that an endpoint URL is valid
- */
-export declare function validateEndpoint(endpoint: string): {
-    valid: boolean;
-    error?: string;
-};

package/cli/introspect/fetch-meta.js

@@ -1,108 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchMeta = fetchMeta;
-exports.validateEndpoint = validateEndpoint;
-/**
- * Fetch _meta query from a PostGraphile endpoint
- */
-const meta_query_1 = require("./meta-query");
-/**
- * Fetch the _meta query from a PostGraphile endpoint
- */
-async function fetchMeta(options) {
-    const { endpoint, authorization, headers = {}, timeout = 30000 } = options;
-    // Build headers
-    const requestHeaders = {
-        'Content-Type': 'application/json',
-        Accept: 'application/json',
-        ...headers,
-    };
-    if (authorization) {
-        requestHeaders['Authorization'] = authorization;
-    }
-    // Create abort controller for timeout
-    const controller = new AbortController();
-    const timeoutId = setTimeout(() => controller.abort(), timeout);
-    try {
-        const response = await fetch(endpoint, {
-            method: 'POST',
-            headers: requestHeaders,
-            body: JSON.stringify({
-                query: meta_query_1.META_QUERY,
-                variables: {},
-            }),
-            signal: controller.signal,
-        });
-        clearTimeout(timeoutId);
-        if (!response.ok) {
-            return {
-                success: false,
-                error: `HTTP ${response.status}: ${response.statusText}`,
-                statusCode: response.status,
-            };
-        }
-        const json = (await response.json());
-        // Check for GraphQL errors
-        if (json.errors && json.errors.length > 0) {
-            const errorMessages = json.errors.map((e) => e.message).join('; ');
-            return {
-                success: false,
-                error: `GraphQL errors: ${errorMessages}`,
-                statusCode: response.status,
-            };
-        }
-        // Check if _meta is present
-        if (!json.data?._meta) {
-            return {
-                success: false,
-                error: 'No _meta field in response. Make sure the endpoint has the PostGraphile meta plugin installed.',
-                statusCode: response.status,
-            };
-        }
-        return {
-            success: true,
-            data: json.data,
-            statusCode: response.status,
-        };
-    }
-    catch (err) {
-        clearTimeout(timeoutId);
-        if (err instanceof Error) {
-            if (err.name === 'AbortError') {
-                return {
-                    success: false,
-                    error: `Request timeout after ${timeout}ms`,
-                };
-            }
-            return {
-                success: false,
-                error: err.message,
-            };
-        }
-        return {
-            success: false,
-            error: 'Unknown error occurred',
-        };
-    }
-}
-/**
- * Validate that an endpoint URL is valid
- */
-function validateEndpoint(endpoint) {
-    try {
-        const url = new URL(endpoint);
-        if (!['http:', 'https:'].includes(url.protocol)) {
-            return {
-                valid: false,
-                error: 'Endpoint must use http or https protocol',
-            };
-        }
-        return { valid: true };
-    }
-    catch {
-        return {
-            valid: false,
-            error: 'Invalid URL format',
-        };
-    }
-}

package/cli/introspect/meta-query.d.ts

@@ -1,111 +0,0 @@
-/**
- * The _meta GraphQL query for introspecting PostGraphile schema
- * This query fetches all table metadata including fields, constraints, and relations
- */
-export declare const META_QUERY = "\nquery Meta {\n  _meta {\n    tables {\n      name\n      query {\n        all\n        create\n        delete\n        one\n        update\n      }\n      fields {\n        name\n        type {\n          gqlType\n          isArray\n          modifier\n          pgAlias\n          pgType\n          subtype\n          typmod\n        }\n      }\n      inflection {\n        allRows\n        allRowsSimple\n        conditionType\n        connection\n        createField\n        createInputType\n        createPayloadType\n        deleteByPrimaryKey\n        deletePayloadType\n        edge\n        edgeField\n        enumType\n        filterType\n        inputType\n        orderByType\n        patchField\n        patchType\n        tableFieldName\n        tableType\n        typeName\n        updateByPrimaryKey\n        updatePayloadType\n      }\n      primaryKeyConstraints {\n        name\n        fields {\n          name\n          type {\n            gqlType\n            isArray\n            modifier\n            pgAlias\n            pgType\n            subtype\n            typmod\n          }\n        }\n      }\n      uniqueConstraints {\n        name\n        fields {\n          name\n          type {\n            gqlType\n            isArray\n            modifier\n            pgAlias\n            pgType\n            subtype\n            typmod\n          }\n        }\n      }\n      foreignKeyConstraints {\n        name\n        fields {\n          name\n          type {\n            gqlType\n            isArray\n            modifier\n            pgAlias\n            pgType\n            subtype\n            typmod\n          }\n        }\n        refFields {\n          name\n          type {\n            gqlType\n            isArray\n            modifier\n            pgAlias\n            pgType\n            subtype\n            typmod\n          }\n        }\n        refTable {\n          name\n        }\n      }\n      relations {\n        belongsTo {\n          fieldName\n          isUnique\n          keys {\n            name\n            type {\n              gqlType\n              isArray\n              modifier\n              pgAlias\n              pgType\n              subtype\n              typmod\n            }\n          }\n          references {\n            name\n          }\n          type\n        }\n        hasOne {\n          fieldName\n          isUnique\n          keys {\n            name\n            type {\n              gqlType\n              isArray\n              modifier\n              pgAlias\n              pgType\n              subtype\n              typmod\n            }\n          }\n          referencedBy {\n            name\n          }\n          type\n        }\n        hasMany {\n          fieldName\n          isUnique\n          keys {\n            name\n            type {\n              gqlType\n              isArray\n              modifier\n              pgAlias\n              pgType\n              subtype\n              typmod\n            }\n          }\n          referencedBy {\n            name\n          }\n          type\n        }\n        manyToMany {\n          fieldName\n          junctionTable {\n            name\n          }\n          rightTable {\n            name\n          }\n          type\n        }\n      }\n    }\n  }\n}\n";
-/**
- * Types for the _meta query response
- */
-export interface MetaFieldType {
-    gqlType: string;
-    isArray: boolean;
-    modifier: string | number | null;
-    pgAlias: string | null;
-    pgType: string | null;
-    subtype: string | null;
-    typmod: number | null;
-}
-export interface MetaField {
-    name: string;
-    type: MetaFieldType;
-}
-export interface MetaConstraint {
-    name: string;
-    fields: MetaField[];
-}
-export interface MetaForeignKeyConstraint extends MetaConstraint {
-    refFields: MetaField[];
-    refTable: {
-        name: string;
-    };
-}
-export interface MetaTableQuery {
-    all: string;
-    create: string;
-    delete: string | null;
-    one: string;
-    update: string | null;
-}
-export interface MetaTableInflection {
-    allRows: string;
-    allRowsSimple: string;
-    conditionType: string;
-    connection: string;
-    createField: string;
-    createInputType: string;
-    createPayloadType: string;
-    deleteByPrimaryKey: string | null;
-    deletePayloadType: string;
-    edge: string;
-    edgeField: string;
-    enumType: string;
-    filterType: string | null;
-    inputType: string;
-    orderByType: string;
-    patchField: string;
-    patchType: string | null;
-    tableFieldName: string;
-    tableType: string;
-    typeName: string;
-    updateByPrimaryKey: string | null;
-    updatePayloadType: string | null;
-}
-export interface MetaBelongsToRelation {
-    fieldName: string | null;
-    isUnique: boolean;
-    keys: MetaField[];
-    references: {
-        name: string;
-    };
-    type: string | null;
-}
-export interface MetaHasRelation {
-    fieldName: string | null;
-    isUnique: boolean;
-    keys: MetaField[];
-    referencedBy: {
-        name: string;
-    };
-    type: string | null;
-}
-export interface MetaManyToManyRelation {
-    fieldName: string | null;
-    junctionTable: {
-        name: string;
-    };
-    rightTable: {
-        name: string;
-    };
-    type: string | null;
-}
-export interface MetaTableRelations {
-    belongsTo: MetaBelongsToRelation[];
-    hasOne: MetaHasRelation[];
-    hasMany: MetaHasRelation[];
-    manyToMany: MetaManyToManyRelation[];
-}
-export interface MetaTable {
-    name: string;
-    query: MetaTableQuery;
-    fields: MetaField[];
-    inflection: MetaTableInflection;
-    primaryKeyConstraints: MetaConstraint[];
-    uniqueConstraints: MetaConstraint[];
-    foreignKeyConstraints: MetaForeignKeyConstraint[];
-    relations: MetaTableRelations;
-}
-export interface MetaQueryResponse {
-    _meta: {
-        tables: MetaTable[];
-    };
-}