@constructive-io/graphql-codegen 2.32.0 → 3.0.1

package/esm/types/config.d.ts

@@ -1,6 +1,7 @@
 /**
  * SDK Configuration types
  */
+import type { PgConfig } from 'pg-env';
 /**
  * Entity relationship definition for cascade invalidation
  */
@@ -56,21 +57,84 @@ export interface QueryKeyConfig {
      */
     generateMutationKeys?: boolean;
 }
+/**
+ * PGPM module configuration for ephemeral database creation
+ */
+export interface PgpmConfig {
+    /**
+     * Path to a PGPM module directory
+     * Creates an ephemeral database, deploys the module, and introspects
+     */
+    modulePath?: string;
+    /**
+     * Path to a PGPM workspace directory
+     * Must be used together with `moduleName`
+     */
+    workspacePath?: string;
+    /**
+     * Name of the module within the PGPM workspace
+     * Must be used together with `workspacePath`
+     */
+    moduleName?: string;
+}
+/**
+ * Database configuration for direct database introspection
+ */
+export interface DbConfig {
+    /**
+     * PostgreSQL connection configuration
+     * Falls back to environment variables (PGHOST, PGPORT, PGUSER, PGPASSWORD, PGDATABASE)
+     * via @pgpmjs/env when not specified
+     */
+    config?: Partial<PgConfig>;
+    /**
+     * PGPM module configuration for ephemeral database creation
+     * When specified, creates an ephemeral database from the module
+     */
+    pgpm?: PgpmConfig;
+    /**
+     * PostgreSQL schemas to introspect
+     * Mutually exclusive with `apiNames`
+     * @example ['public', 'app_public']
+     */
+    schemas?: string[];
+    /**
+     * API names to resolve schemas from
+     * Queries services_public.api_schemas to automatically determine schemas
+     * Mutually exclusive with `schemas`
+     * @example ['my_api']
+     */
+    apiNames?: string[];
+    /**
+     * Keep the ephemeral database after introspection (for debugging)
+     * Only applies when using pgpm
+     * @default false
+     */
+    keepDb?: boolean;
+}
 /**
  * Target configuration for graphql-codegen
  * Represents a single schema source and output destination.
+ *
+ * Source options (choose one):
+ * - endpoint: GraphQL endpoint URL for live introspection
+ * - schemaFile: Path to GraphQL schema file (.graphql)
+ * - db: Database configuration for direct introspection or PGPM module
  */
 export interface GraphQLSDKConfigTarget {
     /**
      * GraphQL endpoint URL for live introspection
-     * Either endpoint or schema must be provided
      */
     endpoint?: string;
     /**
      * Path to GraphQL schema file (.graphql) for file-based generation
-     * Either endpoint or schema must be provided
      */
-    schema?: string;
+    schemaFile?: string;
+    /**
+     * Database configuration for direct database introspection or PGPM module
+     * Use db.schemas or db.apiNames to specify which schemas to introspect
+     */
+    db?: DbConfig;
     /**
      * Headers to include in introspection requests
      */
@@ -147,39 +211,18 @@ export interface GraphQLSDKConfigTarget {
         skipQueryField?: boolean;
     };
     /**
-     * ORM client generation options
-     * When set, generates a Prisma-like ORM client in addition to or instead of React Query hooks
-     */
-    orm?: {
-        /**
-         * Whether to generate ORM client
-         * @default false
-         */
-        enabled?: boolean;
-        /**
-         * Output directory for generated ORM client
-         * @default './generated/orm'
-         */
-        output?: string;
-        /**
-         * Whether to import shared types from hooks output or generate standalone
-         * When true, ORM types.ts will re-export from ../graphql/types
-         * @default true
-         */
-        useSharedTypes?: boolean;
-    };
+     * Whether to generate ORM client
+     * When enabled, generates a Prisma-like ORM client to {output}/orm
+     * @default false
+     */
+    orm?: boolean;
     /**
-     * React Query integration options
-     * Controls whether React Query hooks are generated
+     * Whether to generate React Query hooks
+     * When enabled, generates React Query hooks to {output}/hooks
+     * When false, only standalone fetch functions are generated (no React dependency)
+     * @default false
      */
-    reactQuery?: {
-        /**
-         * Whether to generate React Query hooks (useQuery, useMutation)
-         * When false, only standalone fetch functions are generated (no React dependency)
-         * @default false
-         */
-        enabled?: boolean;
-    };
+    reactQuery?: boolean;
     /**
      * Query key generation configuration
      * Controls how query keys are structured for cache management
@@ -190,24 +233,31 @@ export interface GraphQLSDKConfigTarget {
      * When enabled via CLI --watch flag, the CLI will poll the endpoint for schema changes
      */
     watch?: WatchConfig;
-}
-/**
- * Multi-target configuration for graphql-codegen
- */
-export interface GraphQLSDKMultiConfig {
     /**
-     * Shared defaults applied to every target
+     * Authorization header value (convenience option, also available in headers)
      */
-    defaults?: GraphQLSDKConfigTarget;
+    authorization?: string;
     /**
-     * Named target configurations
+     * Enable verbose output
+     * @default false
      */
-    targets: Record<string, GraphQLSDKConfigTarget>;
+    verbose?: boolean;
+    /**
+     * Dry run - don't write files, just show what would be generated
+     * @default false
+     */
+    dryRun?: boolean;
+    /**
+     * Skip custom operations (only generate table CRUD)
+     * @default false
+     */
+    skipCustomOperations?: boolean;
 }
 /**
  * Main configuration type for graphql-codegen
+ * This is the same as GraphQLSDKConfigTarget - we keep the alias for clarity.
  */
-export type GraphQLSDKConfig = GraphQLSDKConfigTarget | GraphQLSDKMultiConfig;
+export type GraphQLSDKConfig = GraphQLSDKConfigTarget;
 /**
  * Watch mode configuration options
  *
@@ -237,117 +287,30 @@ export interface WatchConfig {
      */
     clearScreen?: boolean;
 }
-/**
- * Resolved watch configuration with defaults applied
- */
-export interface ResolvedWatchConfig {
-    pollInterval: number;
-    debounce: number;
-    touchFile: string | null;
-    clearScreen: boolean;
-}
-/**
- * Resolved query key configuration with defaults applied
- */
-export interface ResolvedQueryKeyConfig {
-    style: 'flat' | 'hierarchical';
-    relationships: Record<string, EntityRelationship>;
-    generateScopedKeys: boolean;
-    generateCascadeHelpers: boolean;
-    generateMutationKeys: boolean;
-}
-/**
- * Resolved configuration with defaults applied
- */
-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[];
-        systemExclude: string[];
-    };
-    queries: {
-        include: string[];
-        exclude: string[];
-        systemExclude: string[];
-    };
-    mutations: {
-        include: string[];
-        exclude: string[];
-        systemExclude: string[];
-    };
-    excludeFields: string[];
-    hooks: {
-        queries: boolean;
-        mutations: boolean;
-        queryKeyPrefix: string;
-    };
-    postgraphile: {
-        schema: string;
-    };
-    codegen: {
-        maxFieldDepth: number;
-        skipQueryField: boolean;
-    };
-    orm: {
-        enabled: boolean;
-        output: string;
-        useSharedTypes: boolean;
-    };
-    reactQuery: {
-        enabled: boolean;
-    };
-    queryKeys: ResolvedQueryKeyConfig;
-    watch: ResolvedWatchConfig;
-}
 /**
  * Default watch configuration values
  */
-export declare const DEFAULT_WATCH_CONFIG: ResolvedWatchConfig;
+export declare const DEFAULT_WATCH_CONFIG: WatchConfig;
 /**
  * Default query key configuration values
  */
-export declare const DEFAULT_QUERY_KEY_CONFIG: ResolvedQueryKeyConfig;
+export declare const DEFAULT_QUERY_KEY_CONFIG: QueryKeyConfig;
 /**
  * Default configuration values
  */
-export declare const DEFAULT_CONFIG: ResolvedConfig;
+export declare const DEFAULT_CONFIG: GraphQLSDKConfigTarget;
 /**
  * Helper function to define configuration with type checking
  */
 export declare function defineConfig(config: GraphQLSDKConfig): GraphQLSDKConfig;
 /**
- * Resolved target configuration helper
- */
-export interface ResolvedTargetConfig {
-    name: string;
-    config: ResolvedConfig;
-}
-/**
- * Type guard for multi-target configs
- */
-export declare function isMultiConfig(config: GraphQLSDKConfig): config is GraphQLSDKMultiConfig;
-/**
- * Merge two target configs (defaults + overrides).
+ * Merge two configs (base + overrides).
  * Uses deepmerge with array replacement strategy - when a user specifies
  * an array like include: ['users'], it replaces the default ['*'] entirely.
  */
 export declare function mergeConfig(base: GraphQLSDKConfigTarget, overrides: GraphQLSDKConfigTarget): GraphQLSDKConfigTarget;
 /**
- * Resolve configuration by applying defaults.
- * Uses deepmerge with array replacement strategy.
- */
-export declare function resolveConfig(config: GraphQLSDKConfig): ResolvedConfig;
-/**
- * Resolve all targets in a multi-target config
+ * Get configuration options by merging defaults with user config.
+ * Similar to getEnvOptions pattern from @pgpmjs/env.
  */
-export declare function resolveConfigTargets(config: GraphQLSDKMultiConfig): ResolvedTargetConfig[];
+export declare function getConfigOptions(overrides?: GraphQLSDKConfigTarget): GraphQLSDKConfigTarget;

package/esm/types/config.js

@@ -14,7 +14,7 @@ const replaceArrays = (_target, source) => source;
 export const DEFAULT_WATCH_CONFIG = {
     pollInterval: 3000,
     debounce: 800,
-    touchFile: null,
+    touchFile: undefined,
     clearScreen: true,
 };
 /**
@@ -32,7 +32,6 @@ export const DEFAULT_QUERY_KEY_CONFIG = {
  */
 export const DEFAULT_CONFIG = {
     endpoint: '',
-    schema: null,
     headers: {},
     output: './generated/graphql',
     tables: {
@@ -63,14 +62,8 @@ export const DEFAULT_CONFIG = {
         maxFieldDepth: 2,
         skipQueryField: true,
     },
-    orm: {
-        enabled: false,
-        output: './generated/orm',
-        useSharedTypes: true,
-    },
-    reactQuery: {
-        enabled: false,
-    },
+    orm: false,
+    reactQuery: false,
     queryKeys: DEFAULT_QUERY_KEY_CONFIG,
     watch: DEFAULT_WATCH_CONFIG,
 };
@@ -81,14 +74,7 @@ export function defineConfig(config) {
     return config;
 }
 /**
- * Type guard for multi-target configs
- */
-export function isMultiConfig(config) {
-    const targets = config.targets;
-    return typeof targets === 'object' && targets !== null;
-}
-/**
- * Merge two target configs (defaults + overrides).
+ * Merge two configs (base + overrides).
  * Uses deepmerge with array replacement strategy - when a user specifies
  * an array like include: ['users'], it replaces the default ['*'] entirely.
  */
@@ -96,22 +82,9 @@ export function mergeConfig(base, overrides) {
     return deepmerge(base, overrides, { arrayMerge: replaceArrays });
 }
 /**
- * Resolve configuration by applying defaults.
- * Uses deepmerge with array replacement strategy.
- */
-export function resolveConfig(config) {
-    if (isMultiConfig(config)) {
-        throw new Error('Multi-target config cannot be resolved with resolveConfig(). Use resolveConfigTargets().');
-    }
-    return deepmerge(DEFAULT_CONFIG, config, { arrayMerge: replaceArrays });
-}
-/**
- * Resolve all targets in a multi-target config
+ * Get configuration options by merging defaults with user config.
+ * Similar to getEnvOptions pattern from @pgpmjs/env.
  */
-export function resolveConfigTargets(config) {
-    const defaults = config.defaults ?? {};
-    return Object.entries(config.targets).map(([name, target]) => ({
-        name,
-        config: resolveConfig(mergeConfig(defaults, target)),
-    }));
+export function getConfigOptions(overrides = {}) {
+    return deepmerge(DEFAULT_CONFIG, overrides, { arrayMerge: replaceArrays });
 }

package/esm/types/index.d.ts

@@ -5,5 +5,5 @@ export type { CleanTable, CleanField, CleanFieldType, CleanRelations, CleanBelon
 export type { PageInfo, ConnectionResult, QueryOptions, OrderByItem, FilterOperator, FieldFilter, RelationalFilter, Filter, } from './query';
 export type { MutationOptions, CreateInput, UpdateInput, DeleteInput, MutationResult, } from './mutation';
 export type { SimpleFieldSelection, FieldSelectionPreset, FieldSelection, SelectionOptions, } from './selection';
-export type { GraphQLSDKConfig, GraphQLSDKConfigTarget, GraphQLSDKMultiConfig, ResolvedConfig, ResolvedTargetConfig, } from './config';
-export { defineConfig, resolveConfig, resolveConfigTargets, DEFAULT_CONFIG, } from './config';
+export type { GraphQLSDKConfig, GraphQLSDKConfigTarget, } from './config';
+export { defineConfig, getConfigOptions, mergeConfig, DEFAULT_CONFIG, } from './config';

package/esm/types/index.js

@@ -1,4 +1,4 @@
 /**
  * Type exports for @constructive-io/graphql-codegen
  */
-export { defineConfig, resolveConfig, resolveConfigTargets, DEFAULT_CONFIG, } from './config';
+export { defineConfig, getConfigOptions, mergeConfig, DEFAULT_CONFIG, } from './config';

package/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @constructive-io/graphql-codegen
  *
- * CLI-based GraphQL SDK generator for PostGraphile endpoints.
+ * GraphQL SDK generator for Constructive databases.
  * Introspects via _meta query and generates typed queries, mutations,
  * and React Query v5 hooks.
  */
@@ -10,5 +10,10 @@ export * from './core';
 export * from './generators';
 export * from './client';
 export { defineConfig } from './types/config';
-export { generateReactQuery, generateOrm, findConfigFile, loadConfigFile, } from './cli/commands';
-export type { GenerateOptions, GenerateResult, GenerateTargetResult, GenerateOrmOptions, GenerateOrmResult, GenerateOrmTargetResult, InitOptions, InitResult, } from './cli/commands';
+export { generate } from './core/generate';
+export type { GenerateOptions, GenerateResult } from './core/generate';
+export { findConfigFile, loadConfigFile } from './core/config';
+export { codegenQuestions, splitCommas, printResult } from './cli/shared';
+export type { CodegenAnswers } from './cli/shared';
+export { buildSchemaFromDatabase, buildSchemaSDLFromDatabase, } from './core/database';
+export type { BuildSchemaFromDatabaseOptions, BuildSchemaFromDatabaseResult, } from './core/database';

package/index.js

@@ -2,7 +2,7 @@
 /**
  * @constructive-io/graphql-codegen
  *
- * CLI-based GraphQL SDK generator for PostGraphile endpoints.
+ * GraphQL SDK generator for Constructive databases.
  * Introspects via _meta query and generates typed queries, mutations,
  * and React Query v5 hooks.
  */
@@ -21,7 +21,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.loadConfigFile = exports.findConfigFile = exports.generateOrm = exports.generateReactQuery = exports.defineConfig = void 0;
+exports.buildSchemaSDLFromDatabase = exports.buildSchemaFromDatabase = exports.printResult = exports.splitCommas = exports.codegenQuestions = exports.loadConfigFile = exports.findConfigFile = exports.generate = exports.defineConfig = void 0;
 // Core types
 __exportStar(require("./types"), exports);
 // Core query building
@@ -33,9 +33,19 @@ __exportStar(require("./client"), exports);
 // Config definition helper
 var config_1 = require("./types/config");
 Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return config_1.defineConfig; } });
-// CLI command exports (for packages/cli consumption)
-var commands_1 = require("./cli/commands");
-Object.defineProperty(exports, "generateReactQuery", { enumerable: true, get: function () { return commands_1.generateReactQuery; } });
-Object.defineProperty(exports, "generateOrm", { enumerable: true, get: function () { return commands_1.generateOrm; } });
-Object.defineProperty(exports, "findConfigFile", { enumerable: true, get: function () { return commands_1.findConfigFile; } });
-Object.defineProperty(exports, "loadConfigFile", { enumerable: true, get: function () { return commands_1.loadConfigFile; } });
+// Main generate function (orchestrates the entire pipeline)
+var generate_1 = require("./core/generate");
+Object.defineProperty(exports, "generate", { enumerable: true, get: function () { return generate_1.generate; } });
+// Config utilities
+var config_2 = require("./core/config");
+Object.defineProperty(exports, "findConfigFile", { enumerable: true, get: function () { return config_2.findConfigFile; } });
+Object.defineProperty(exports, "loadConfigFile", { enumerable: true, get: function () { return config_2.loadConfigFile; } });
+// CLI shared utilities (for packages/cli to import)
+var shared_1 = require("./cli/shared");
+Object.defineProperty(exports, "codegenQuestions", { enumerable: true, get: function () { return shared_1.codegenQuestions; } });
+Object.defineProperty(exports, "splitCommas", { enumerable: true, get: function () { return shared_1.splitCommas; } });
+Object.defineProperty(exports, "printResult", { enumerable: true, get: function () { return shared_1.printResult; } });
+// Database schema utilities (re-exported from core for convenience)
+var database_1 = require("./core/database");
+Object.defineProperty(exports, "buildSchemaFromDatabase", { enumerable: true, get: function () { return database_1.buildSchemaFromDatabase; } });
+Object.defineProperty(exports, "buildSchemaSDLFromDatabase", { enumerable: true, get: function () { return database_1.buildSchemaSDLFromDatabase; } });

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "2.32.0",
-  "description": "CLI-based GraphQL SDK generator for PostGraphile endpoints with React Query hooks",
+  "version": "3.0.1",
+  "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
     "postgraphile",
@@ -35,19 +35,19 @@
   "scripts": {
     "clean": "makage clean",
     "prepack": "npm run build",
-    "copy:ts": "makage copy src/cli/codegen/orm/query-builder.ts dist/cli/codegen/orm --flat",
+    "copy:ts": "makage copy src/core/codegen/orm/query-builder.ts dist/core/codegen/orm --flat",
     "build": "makage build && npm run copy:ts",
     "build:dev": "makage build --dev && npm run copy:ts",
     "dev": "ts-node ./src/index.ts",
     "lint": "eslint . --fix",
-    "fmt": "prettier --write .",
-    "fmt:check": "prettier --check .",
+    "fmt": "oxfmt --write .",
+    "fmt:check": "oxfmt --check .",
     "test": "jest --passWithNoTests",
     "test:watch": "jest --watch",
-    "example:codegen:sdk": "tsx src/cli/index.ts generate --config examples/multi-target.config.ts",
-    "example:codegen:orm": "tsx src/cli/index.ts generate-orm --config examples/multi-target.config.ts",
-    "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:codegen:sdk": "tsx src/cli/index.ts --config examples/multi-target.config.ts --react-query",
+    "example:codegen:orm": "tsx src/cli/index.ts --config examples/multi-target.config.ts --orm",
+    "example:codegen:sdk:schema": "node dist/cli/index.js --schema-file examples/example.schema.graphql --output examples/output/generated-sdk-schema --react-query",
+    "example:codegen:orm:schema": "node dist/cli/index.js --schema-file examples/example.schema.graphql --output examples/output/generated-orm-schema --orm",
     "example:sdk": "tsx examples/react-hooks-sdk-test.tsx",
     "example:orm": "tsx examples/orm-sdk-test.ts",
     "example:sdk:typecheck": "tsc --noEmit --jsx react --esModuleInterop --skipLibCheck --moduleResolution node examples/react-hooks-sdk-test.tsx"
@@ -56,8 +56,10 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@babel/generator": "^7.28.6",
     "@babel/types": "^7.28.6",
+    "@constructive-io/graphql-server": "^3.0.1",
     "@constructive-io/graphql-types": "^2.14.0",
     "@inquirerer/utils": "^3.2.0",
+    "@pgpmjs/core": "^5.0.0",
     "ajv": "^8.17.1",
     "deepmerge": "^4.3.1",
     "find-and-require-package-json": "^0.9.0",
@@ -66,7 +68,12 @@
     "inflekt": "^0.3.0",
     "inquirerer": "^4.4.0",
     "jiti": "^2.6.1",
-    "prettier": "^3.7.4"
+    "oxfmt": "^0.26.0",
+    "pg-cache": "^2.0.0",
+    "pg-env": "^1.3.0",
+    "pgsql-client": "^2.0.0",
+    "pgsql-seed": "^1.0.0",
+    "undici": "^7.19.0"
   },
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
@@ -92,5 +99,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "39b5c59b01b8ce391dc14daf5a9430ca0ff67574"
+  "gitHead": "f6b4b738f0d069833af001a80b97d86fea6499ae"
 }