@constructive-io/graphql-codegen 2.22.1 → 2.23.1

package/esm/core/ast.js

@@ -1,5 +1,5 @@
 import * as t from 'gql-ast';
-import * as inflection from 'inflection';
+import { camelize, singularize } from 'inflekt';
 import { getCustomAst } from './custom-ast';
 const NON_MUTABLE_PROPS = ['createdAt', 'createdBy', 'updatedAt', 'updatedBy'];
 const objectToArray = (obj) => Object.keys(obj).map((k) => ({
@@ -279,7 +279,7 @@ export const createOne = ({ mutationName, operationName, mutation, selection, })
     if (!mutation.properties?.input?.properties) {
         throw new Error(`No input field for mutation: ${mutationName}`);
     }
-    const modelName = inflection.camelize([inflection.singularize(mutation.model)].join('_'), true);
+    const modelName = camelize([singularize(mutation.model)].join('_'), true);
     const inputProperties = mutation.properties.input
         .properties;
     const modelProperties = inputProperties[modelName];
@@ -324,7 +324,7 @@ export const patchOne = ({ mutationName, operationName, mutation, selection, })
     if (!mutation.properties?.input?.properties) {
         throw new Error(`No input field for mutation: ${mutationName}`);
     }
-    const modelName = inflection.camelize([inflection.singularize(mutation.model)].join('_'), true);
+    const modelName = camelize([singularize(mutation.model)].join('_'), true);
     const inputProperties = mutation.properties.input
         .properties;
     const patchProperties = inputProperties['patch'];
@@ -376,7 +376,7 @@ export const deleteOne = ({ mutationName, operationName, mutation, }) => {
     if (!mutation.properties?.input?.properties) {
         throw new Error(`No input field for mutation: ${mutationName}`);
     }
-    const modelName = inflection.camelize([inflection.singularize(mutation.model)].join('_'), true);
+    const modelName = camelize([singularize(mutation.model)].join('_'), true);
     const inputProperties = mutation.properties.input
         .properties;
     const deleteAttrs = objectToArray(inputProperties);

package/esm/core/query-builder.js

@@ -1,5 +1,5 @@
 import { print as gqlPrint } from 'graphql';
-import * as inflection from 'inflection';
+import { camelize, underscore, pluralize } from 'inflekt';
 import { createOne, deleteOne, getAll, getCount, getMany, getOne, patchOne, } from './ast';
 import { validateMetaObject } from './meta-object';
 export * as MetaObject from './meta-object';
@@ -88,13 +88,13 @@ export class QueryBuilder {
         const getInputName = (mutationType) => {
             switch (mutationType) {
                 case 'delete': {
-                    return `Delete${inflection.camelize(this._model)}Input`;
+                    return `Delete${camelize(this._model)}Input`;
                 }
                 case 'create': {
-                    return `Create${inflection.camelize(this._model)}Input`;
+                    return `Create${camelize(this._model)}Input`;
                 }
                 case 'patch': {
-                    return `Update${inflection.camelize(this._model)}Input`;
+                    return `Update${camelize(this._model)}Input`;
                 }
                 default:
                     throw new Error('Unhandled mutation type' + mutationType);
@@ -123,7 +123,7 @@ export class QueryBuilder {
     getMany({ select } = {}) {
         this._op = 'getMany';
         this._key = this._findQuery();
-        this.queryName(inflection.camelize(['get', inflection.underscore(this._key), 'query'].join('_'), true));
+        this.queryName(camelize(['get', underscore(this._key), 'query'].join('_'), true));
         const defn = this._introspection[this._key];
         this.select(select);
         this._ast = getMany({
@@ -138,7 +138,7 @@ export class QueryBuilder {
     all({ select } = {}) {
         this._op = 'getMany';
         this._key = this._findQuery();
-        this.queryName(inflection.camelize(['get', inflection.underscore(this._key), 'query', 'all'].join('_'), true));
+        this.queryName(camelize(['get', underscore(this._key), 'query', 'all'].join('_'), true));
         const defn = this._introspection[this._key];
         this.select(select);
         this._ast = getAll({
@@ -152,7 +152,7 @@ export class QueryBuilder {
     count() {
         this._op = 'getMany';
         this._key = this._findQuery();
-        this.queryName(inflection.camelize(['get', inflection.underscore(this._key), 'count', 'query'].join('_'), true));
+        this.queryName(camelize(['get', underscore(this._key), 'count', 'query'].join('_'), true));
         const defn = this._introspection[this._key];
         this._ast = getCount({
             queryName: this._queryName,
@@ -164,7 +164,7 @@ export class QueryBuilder {
     getOne({ select } = {}) {
         this._op = 'getOne';
         this._key = this._findQuery();
-        this.queryName(inflection.camelize(['get', inflection.underscore(this._key), 'query'].join('_'), true));
+        this.queryName(camelize(['get', underscore(this._key), 'query'].join('_'), true));
         const defn = this._introspection[this._key];
         this.select(select);
         this._ast = getOne({
@@ -180,7 +180,7 @@ export class QueryBuilder {
         this._op = 'mutation';
         this._mutation = 'create';
         this._key = this._findMutation();
-        this.queryName(inflection.camelize([inflection.underscore(this._key), 'mutation'].join('_'), true));
+        this.queryName(camelize([underscore(this._key), 'mutation'].join('_'), true));
         const defn = this._introspection[this._key];
         this.select(select);
         this._ast = createOne({
@@ -195,7 +195,7 @@ export class QueryBuilder {
         this._op = 'mutation';
         this._mutation = 'delete';
         this._key = this._findMutation();
-        this.queryName(inflection.camelize([inflection.underscore(this._key), 'mutation'].join('_'), true));
+        this.queryName(camelize([underscore(this._key), 'mutation'].join('_'), true));
         const defn = this._introspection[this._key];
         this.select(select);
         this._ast = deleteOne({
@@ -209,7 +209,7 @@ export class QueryBuilder {
         this._op = 'mutation';
         this._mutation = 'patch';
         this._key = this._findMutation();
-        this.queryName(inflection.camelize([inflection.underscore(this._key), 'mutation'].join('_'), true));
+        this.queryName(camelize([underscore(this._key), 'mutation'].join('_'), true));
         const defn = this._introspection[this._key];
         this.select(select);
         this._ast = patchOne({
@@ -371,5 +371,5 @@ function isRelationalField(fieldName, modelMeta) {
 // Get getMany op name from model
 // ie. UserSetting => userSettings
 function modelNameToGetMany(model) {
-    return inflection.camelize(inflection.pluralize(inflection.underscore(model)), true);
+    return camelize(pluralize(underscore(model)), true);
 }

package/esm/generators/mutations.js

@@ -4,7 +4,7 @@
  */
 import * as t from 'gql-ast';
 import { print } from 'graphql';
-import * as inflection from 'inflection';
+import { camelize } from 'inflekt';
 import { TypedDocumentString } from '../client/typed-document';
 import { getCustomAstForCleanField, requiresSubfieldSelection, } from '../core/custom-ast';
 import { isRelationalField } from './field-selector';
@@ -32,7 +32,7 @@ function generateFieldSelections(table) {
  */
 export function buildPostGraphileCreate(table, _allTables, _options = {}) {
     const mutationName = `create${table.name}`;
-    const singularName = inflection.camelize(table.name, true);
+    const singularName = camelize(table.name, true);
     // Create the variable definition for $input
     const variableDefinitions = [
         t.variableDefinition({
@@ -91,7 +91,7 @@ export function buildPostGraphileCreate(table, _allTables, _options = {}) {
  */
 export function buildPostGraphileUpdate(table, _allTables, _options = {}) {
     const mutationName = `update${table.name}`;
-    const singularName = inflection.camelize(table.name, true);
+    const singularName = camelize(table.name, true);
     // Create the variable definition for $input
     const variableDefinitions = [
         t.variableDefinition({

package/esm/generators/select.js

@@ -4,7 +4,7 @@
  */
 import * as t from 'gql-ast';
 import { print } from 'graphql';
-import * as inflection from 'inflection';
+import { camelize, pluralize } from 'inflekt';
 import { TypedDocumentString } from '../client/typed-document';
 import { getCustomAstForCleanField, requiresSubfieldSelection, } from '../core/custom-ast';
 import { QueryBuilder } from '../core/query-builder';
@@ -16,9 +16,9 @@ import { convertToSelectionOptions, isRelationalField } from './field-selector';
  */
 export function toCamelCasePlural(tableName) {
     // First convert to camelCase (lowercase first letter)
-    const camelCase = inflection.camelize(tableName, true);
+    const camelCase = camelize(tableName, true);
     // Then pluralize properly
-    return inflection.pluralize(camelCase);
+    return pluralize(camelCase);
 }
 /**
  * Generate the PostGraphile OrderBy enum type name for a table
@@ -101,7 +101,7 @@ export function generateIntrospectionSchema(tables) {
             properties: convertFieldsToProperties(table.fields),
         };
         // Add getOne query (by ID)
-        const singularName = inflection.camelize(modelName, true);
+        const singularName = camelize(modelName, true);
         schema[singularName] = {
             qtype: 'getOne',
             model: modelName,
@@ -122,8 +122,8 @@ export function generateIntrospectionSchema(tables) {
                     isArray: false,
                     isArrayNotNull: false,
                     properties: {
-                        [inflection.camelize(modelName, true)]: {
-                            name: inflection.camelize(modelName, true),
+                        [camelize(modelName, true)]: {
+                            name: camelize(modelName, true),
                             type: `${modelName}Input`,
                             isNotNull: true,
                             isArray: false,
@@ -549,7 +549,7 @@ function findRelatedTable(relationField, table, allTables) {
  * Generate FindOne query AST directly from CleanTable
  */
 function generateFindOneQueryAST(table) {
-    const singularName = inflection.camelize(table.name, true);
+    const singularName = camelize(table.name, true);
     // Generate field selections (include all non-relational fields, including complex types)
     const fieldSelections = table.fields
         .filter((field) => !isRelationalField(field.name, table))

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/generators/mutations.js

@@ -42,7 +42,7 @@ exports.buildPostGraphileDelete = buildPostGraphileDelete;
  */
 const t = __importStar(require("gql-ast"));
 const graphql_1 = require("graphql");
-const inflection = __importStar(require("inflection"));
+const inflekt_1 = require("inflekt");
 const typed_document_1 = require("../client/typed-document");
 const custom_ast_1 = require("../core/custom-ast");
 const field_selector_1 = require("./field-selector");
@@ -70,7 +70,7 @@ function generateFieldSelections(table) {
  */
 function buildPostGraphileCreate(table, _allTables, _options = {}) {
     const mutationName = `create${table.name}`;
-    const singularName = inflection.camelize(table.name, true);
+    const singularName = (0, inflekt_1.camelize)(table.name, true);
     // Create the variable definition for $input
     const variableDefinitions = [
         t.variableDefinition({
@@ -129,7 +129,7 @@ function buildPostGraphileCreate(table, _allTables, _options = {}) {
  */
 function buildPostGraphileUpdate(table, _allTables, _options = {}) {
     const mutationName = `update${table.name}`;
-    const singularName = inflection.camelize(table.name, true);
+    const singularName = (0, inflekt_1.camelize)(table.name, true);
     // Create the variable definition for $input
     const variableDefinitions = [
         t.variableDefinition({

package/generators/select.js

@@ -47,7 +47,7 @@ exports.buildCount = buildCount;
  */
 const t = __importStar(require("gql-ast"));
 const graphql_1 = require("graphql");
-const inflection = __importStar(require("inflection"));
+const inflekt_1 = require("inflekt");
 const typed_document_1 = require("../client/typed-document");
 const custom_ast_1 = require("../core/custom-ast");
 const query_builder_1 = require("../core/query-builder");
@@ -59,9 +59,9 @@ const field_selector_1 = require("./field-selector");
  */
 function toCamelCasePlural(tableName) {
     // First convert to camelCase (lowercase first letter)
-    const camelCase = inflection.camelize(tableName, true);
+    const camelCase = (0, inflekt_1.camelize)(tableName, true);
     // Then pluralize properly
-    return inflection.pluralize(camelCase);
+    return (0, inflekt_1.pluralize)(camelCase);
 }
 /**
  * Generate the PostGraphile OrderBy enum type name for a table
@@ -144,7 +144,7 @@ function generateIntrospectionSchema(tables) {
             properties: convertFieldsToProperties(table.fields),
         };
         // Add getOne query (by ID)
-        const singularName = inflection.camelize(modelName, true);
+        const singularName = (0, inflekt_1.camelize)(modelName, true);
         schema[singularName] = {
             qtype: 'getOne',
             model: modelName,
@@ -165,8 +165,8 @@ function generateIntrospectionSchema(tables) {
                     isArray: false,
                     isArrayNotNull: false,
                     properties: {
-                        [inflection.camelize(modelName, true)]: {
-                            name: inflection.camelize(modelName, true),
+                        [(0, inflekt_1.camelize)(modelName, true)]: {
+                            name: (0, inflekt_1.camelize)(modelName, true),
                             type: `${modelName}Input`,
                             isNotNull: true,
                             isArray: false,
@@ -592,7 +592,7 @@ function findRelatedTable(relationField, table, allTables) {
  * Generate FindOne query AST directly from CleanTable
  */
 function generateFindOneQueryAST(table) {
-    const singularName = inflection.camelize(table.name, true);
+    const singularName = (0, inflekt_1.camelize)(table.name, true);
     // Generate field selections (include all non-relational fields, including complex types)
     const fieldSelections = table.fields
         .filter((field) => !(0, field_selector_1.isRelationalField)(field.name, table))

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "2.22.1",
+  "version": "2.23.1",
   "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"
   },
@@ -51,7 +53,7 @@
     "commander": "^12.1.0",
     "gql-ast": "^2.4.6",
     "graphql": "15.10.1",
-    "inflection": "^3.0.2",
+    "inflekt": "^0.1.2",
     "jiti": "^2.6.1",
     "prettier": "^3.7.4",
     "ts-morph": "^27.0.2"
@@ -79,5 +81,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "cb086f098f3d82ee9e4eced65383fc3f45253064"
+  "gitHead": "22c89cfc6f67879e77ca47f652c31c80828665f5"
 }

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',
-        };
-    }
-}