@constructive-io/graphql-codegen 4.17.0 → 4.18.0

package/esm/core/codegen/utils.d.ts

@@ -1,4 +1,4 @@
-import type { CleanField, CleanFieldType, CleanTable, TypeRegistry } from '../../types/schema';
+import type { Field, FieldType, Table, TypeRegistry } from '../../types/schema';
 /** Lowercase first character */
 export declare function lcFirst(str: string): string;
 /** Uppercase first character */
@@ -22,118 +22,118 @@ export interface TableNames {
 /**
  * Derive all naming variants from a table
  */
-export declare function getTableNames(table: CleanTable): TableNames;
+export declare function getTableNames(table: Table): TableNames;
 /**
  * Generate hook function name for list query
  * e.g., "useCarsQuery"
  */
-export declare function getListQueryHookName(table: CleanTable): string;
+export declare function getListQueryHookName(table: Table): string;
 /**
  * Generate hook function name for single item query
  * e.g., "useCarQuery"
  */
-export declare function getSingleQueryHookName(table: CleanTable): string;
+export declare function getSingleQueryHookName(table: Table): string;
 /**
  * Generate hook function name for create mutation
  * e.g., "useCreateCarMutation"
  */
-export declare function getCreateMutationHookName(table: CleanTable): string;
+export declare function getCreateMutationHookName(table: Table): string;
 /**
  * Generate hook function name for update mutation
  * e.g., "useUpdateCarMutation"
  */
-export declare function getUpdateMutationHookName(table: CleanTable): string;
+export declare function getUpdateMutationHookName(table: Table): string;
 /**
  * Generate hook function name for delete mutation
  * e.g., "useDeleteCarMutation"
  */
-export declare function getDeleteMutationHookName(table: CleanTable): string;
+export declare function getDeleteMutationHookName(table: Table): string;
 /**
  * Generate file name for list query hook
  * e.g., "useCarsQuery.ts"
  */
-export declare function getListQueryFileName(table: CleanTable): string;
+export declare function getListQueryFileName(table: Table): string;
 /**
  * Generate file name for single query hook
  * e.g., "useCarQuery.ts"
  */
-export declare function getSingleQueryFileName(table: CleanTable): string;
+export declare function getSingleQueryFileName(table: Table): string;
 /**
  * Generate file name for create mutation hook
  */
-export declare function getCreateMutationFileName(table: CleanTable): string;
+export declare function getCreateMutationFileName(table: Table): string;
 /**
  * Generate file name for update mutation hook
  */
-export declare function getUpdateMutationFileName(table: CleanTable): string;
+export declare function getUpdateMutationFileName(table: Table): string;
 /**
  * Generate file name for delete mutation hook
  */
-export declare function getDeleteMutationFileName(table: CleanTable): string;
+export declare function getDeleteMutationFileName(table: Table): string;
 /**
  * Get the GraphQL query name for fetching all rows
  * Uses inflection from introspection, falls back to convention
  */
-export declare function getAllRowsQueryName(table: CleanTable): string;
+export declare function getAllRowsQueryName(table: Table): string;
 /**
  * Get the GraphQL query name for fetching single row
  */
-export declare function getSingleRowQueryName(table: CleanTable): string;
+export declare function getSingleRowQueryName(table: Table): string;
 /**
  * Get the GraphQL mutation name for creating
  */
-export declare function getCreateMutationName(table: CleanTable): string;
+export declare function getCreateMutationName(table: Table): string;
 /**
  * Get the GraphQL mutation name for updating
  */
-export declare function getUpdateMutationName(table: CleanTable): string;
+export declare function getUpdateMutationName(table: Table): string;
 /**
  * Get the GraphQL mutation name for deleting
  */
-export declare function getDeleteMutationName(table: CleanTable): string;
+export declare function getDeleteMutationName(table: Table): string;
 /**
  * Get PostGraphile filter type name
  * e.g., "CarFilter"
  */
-export declare function getFilterTypeName(table: CleanTable): string;
+export declare function getFilterTypeName(table: Table): string;
 /**
  * Get PostGraphile OrderBy enum type name
  * e.g., "CarsOrderBy", "AddressesOrderBy"
  */
-export declare function getOrderByTypeName(table: CleanTable): string;
+export declare function getOrderByTypeName(table: Table): string;
 /**
  * Get PostGraphile Condition type name (simple equality filter)
  * e.g., "CarCondition", "AddressCondition"
  */
-export declare function getConditionTypeName(table: CleanTable): string;
+export declare function getConditionTypeName(table: Table): string;
 /**
  * Get PostGraphile create input type name
  * e.g., "CreateCarInput"
  */
-export declare function getCreateInputTypeName(table: CleanTable): string;
+export declare function getCreateInputTypeName(table: Table): string;
 /**
  * Get PostGraphile patch type name for updates
  * e.g., "CarPatch"
  */
-export declare function getPatchTypeName(table: CleanTable): string;
+export declare function getPatchTypeName(table: Table): string;
 /**
  * Get PostGraphile update input type name
  * e.g., "UpdateCarInput"
  */
-export declare function getUpdateInputTypeName(table: CleanTable): string;
+export declare function getUpdateInputTypeName(table: Table): string;
 /**
  * Get PostGraphile delete input type name
  * e.g., "DeleteCarInput"
  */
-export declare function getDeleteInputTypeName(table: CleanTable): string;
+export declare function getDeleteInputTypeName(table: Table): string;
 /**
  * Convert GraphQL type to TypeScript type
  */
 export declare function gqlTypeToTs(gqlType: string, isArray?: boolean): string;
 /**
- * Convert CleanFieldType to TypeScript type string
+ * Convert FieldType to TypeScript type string
  */
-export declare function fieldTypeToTs(fieldType: CleanFieldType): string;
+export declare function fieldTypeToTs(fieldType: FieldType): string;
 /**
  * Get the PostGraphile filter type for a GraphQL scalar
  * @param gqlType - The GraphQL type string (e.g., "String", "UUID")
@@ -143,11 +143,11 @@ export declare function getScalarFilterType(gqlType: string, isArray?: boolean):
 /**
  * Check if a field is a relation field (not a scalar)
  */
-export declare function isRelationField(fieldName: string, table: CleanTable): boolean;
+export declare function isRelationField(fieldName: string, table: Table): boolean;
 /**
  * Get only scalar fields (non-relation fields)
  */
-export declare function getScalarFields(table: CleanTable): CleanField[];
+export declare function getScalarFields(table: Table): Field[];
 /**
  * Resolve the inner input type from a CreateXInput.
  * PostGraphile create inputs wrap the actual field definitions in an inner type
@@ -164,7 +164,7 @@ export declare function resolveInnerInputType(inputTypeName: string, typeRegistr
  * are plugin-added computed fields that don't correspond to real database columns.
  * Returns null when no typeRegistry is provided (caller should treat as "no filtering").
  */
-export declare function getWritableFieldNames(table: CleanTable, typeRegistry?: TypeRegistry): Set<string> | null;
+export declare function getWritableFieldNames(table: Table, typeRegistry?: TypeRegistry): Set<string> | null;
 /**
  * Get scalar fields that represent actual database columns (not computed/plugin-added).
  * When a TypeRegistry is provided, filters out fields that don't exist in the
@@ -172,7 +172,7 @@ export declare function getWritableFieldNames(table: CleanTable, typeRegistry?:
  * hash UUIDs) that aren't real columns and shouldn't appear in default selections.
  * Without a TypeRegistry, falls back to all scalar fields.
  */
-export declare function getSelectableScalarFields(table: CleanTable, typeRegistry?: TypeRegistry): CleanField[];
+export declare function getSelectableScalarFields(table: Table, typeRegistry?: TypeRegistry): Field[];
 /**
  * Primary key field information
  */
@@ -188,22 +188,22 @@ export interface PrimaryKeyField {
  * Get primary key field information from table constraints
  * Returns array to support composite primary keys
  */
-export declare function getPrimaryKeyInfo(table: CleanTable): PrimaryKeyField[];
+export declare function getPrimaryKeyInfo(table: Table): PrimaryKeyField[];
 /**
  * Get primary key field names (convenience wrapper)
  */
-export declare function getPrimaryKeyFields(table: CleanTable): string[];
+export declare function getPrimaryKeyFields(table: Table): string[];
 /**
  * Check if table has a valid single-field primary key
  * Used to determine if a single query hook can be generated
  * Tables with composite keys return false (handled as custom queries)
  */
-export declare function hasValidPrimaryKey(table: CleanTable): boolean;
+export declare function hasValidPrimaryKey(table: Table): boolean;
 /**
  * Generate query key prefix for a table
  * e.g., "cars" for list queries, "car" for detail queries
  */
-export declare function getQueryKeyPrefix(table: CleanTable): string;
+export declare function getQueryKeyPrefix(table: Table): string;
 /**
  * Strip PostGraphile smart comments and boilerplate from a description string.
  *

package/esm/core/codegen/utils.js

@@ -225,7 +225,7 @@ export function gqlTypeToTs(gqlType, isArray = false) {
     return isArray ? `${tsType}[]` : tsType;
 }
 /**
- * Convert CleanFieldType to TypeScript type string
+ * Convert FieldType to TypeScript type string
  */
 export function fieldTypeToTs(fieldType) {
     return gqlTypeToTs(fieldType.gqlType, fieldType.isArray);

package/esm/core/generate.d.ts

@@ -1,5 +1,5 @@
 import type { CliConfig, GraphQLSDKConfigTarget, SchemaConfig } from '../types/config';
-import type { CleanOperation, CleanTable, TypeRegistry } from '../types/schema';
+import type { Operation, Table, TypeRegistry } from '../types/schema';
 export interface GenerateOptions extends GraphQLSDKConfigTarget {
     authorization?: string;
     verbose?: boolean;
@@ -14,10 +14,10 @@ export interface GenerateResult {
     filesWritten?: string[];
     errors?: string[];
     pipelineData?: {
-        tables: CleanTable[];
+        tables: Table[];
         customOperations: {
-            queries: CleanOperation[];
-            mutations: CleanOperation[];
+            queries: Operation[];
+            mutations: Operation[];
             typeRegistry?: TypeRegistry;
         };
     };

package/esm/core/introspect/index.d.ts

@@ -4,7 +4,7 @@
 export type { InferTablesOptions } from './infer-tables';
 export { inferTablesFromIntrospection } from './infer-tables';
 export { pluralize, singularize } from 'inflekt';
-export type { CreateSchemaSourceOptions, SchemaSource, SchemaSourceResult, } from './source';
+export type { CreateSchemaSourceOptions, MetaTableInfo, SchemaSource, SchemaSourceResult, } from './source';
 export { createSchemaSource, EndpointSchemaSource, FileSchemaSource, SchemaSourceError, validateSourceOptions, } from './source';
 export type { FetchSchemaOptions, FetchSchemaResult } from './fetch-schema';
 export { fetchSchema } from './fetch-schema';

package/esm/core/introspect/source/database.js

@@ -3,9 +3,10 @@
  *
  * Loads GraphQL schema directly from a PostgreSQL database using PostGraphile
  * introspection and converts it to introspection format.
+ * Also returns _meta table metadata when available (via MetaSchemaPlugin cache).
  */
 import { buildSchema, introspectionFromSchema } from 'graphql';
-import { buildSchemaSDL } from 'graphile-schema';
+import { buildSchemaSDL, _cachedTablesMeta } from 'graphile-schema';
 import { createDatabasePool, resolveApiSchemas, validateServicesSchemas, } from './api-schemas';
 import { SchemaSourceError } from './types';
 /**
@@ -42,7 +43,7 @@ export class DatabaseSchemaSource {
         else {
             schemas = this.options.schemas ?? ['public'];
         }
-        // Build SDL from database
+        // Build SDL from database (MetaSchemaPlugin populates _cachedTablesMeta as a side-effect)
         let sdl;
         try {
             sdl = await buildSchemaSDL({
@@ -75,7 +76,10 @@ export class DatabaseSchemaSource {
         }
         // Convert graphql-js introspection result to our mutable type
         const introspection = JSON.parse(JSON.stringify(introspectionResult));
-        return { introspection };
+        return {
+            introspection,
+            tablesMeta: [..._cachedTablesMeta],
+        };
     }
     describe() {
         const { database, schemas, apiNames } = this.options;

package/esm/core/introspect/source/types.d.ts

@@ -5,6 +5,38 @@
  * to work with both live GraphQL endpoints and static schema files.
  */
 import type { IntrospectionQueryResponse } from '../../../types/introspection';
+/**
+ * Minimal table metadata from the _meta query, used to enrich M:N relations
+ * with junction key field information that isn't available from introspection alone.
+ */
+export interface MetaTableInfo {
+    name: string;
+    schemaName: string;
+    relations: {
+        manyToMany: Array<{
+            fieldName: string | null;
+            type: string | null;
+            junctionTable: {
+                name: string;
+            };
+            junctionLeftKeyAttributes: Array<{
+                name: string;
+            }>;
+            junctionRightKeyAttributes: Array<{
+                name: string;
+            }>;
+            leftKeyAttributes: Array<{
+                name: string;
+            }>;
+            rightKeyAttributes: Array<{
+                name: string;
+            }>;
+            rightTable: {
+                name: string;
+            };
+        }>;
+    };
+}
 /**
  * Result from fetching a schema source
  */
@@ -13,6 +45,11 @@ export interface SchemaSourceResult {
      * The GraphQL introspection data
      */
     introspection: IntrospectionQueryResponse;
+    /**
+     * Optional table metadata from _meta query (provides M:N junction key details).
+     * Present when the source supports _meta (database mode or endpoints with MetaSchemaPlugin).
+     */
+    tablesMeta?: MetaTableInfo[];
 }
 /**
  * Abstract interface for schema sources

package/esm/core/pipeline/index.d.ts

@@ -9,7 +9,7 @@
  * - Filtering
  */
 import type { GraphQLSDKConfigTarget } from '../../types/config';
-import type { CleanOperation, CleanTable, TypeRegistry } from '../../types/schema';
+import type { Operation, Table, TypeRegistry } from '../../types/schema';
 import type { SchemaSource } from '../introspect/source';
 export type { SchemaSource } from '../introspect/source';
 export { createSchemaSource, validateSourceOptions, } from '../introspect/source';
@@ -35,13 +35,13 @@ export interface CodegenPipelineResult {
     /**
      * Inferred table metadata
      */
-    tables: CleanTable[];
+    tables: Table[];
     /**
      * Custom operations (queries and mutations not covered by tables)
      */
     customOperations: {
-        queries: CleanOperation[];
-        mutations: CleanOperation[];
+        queries: Operation[];
+        mutations: Operation[];
         typeRegistry: TypeRegistry;
     };
     /**
@@ -70,7 +70,7 @@ export declare function runCodegenPipeline(options: CodegenPipelineOptions): Pro
 /**
  * Validate that tables were found
  */
-export declare function validateTablesFound(tables: CleanTable[]): {
+export declare function validateTablesFound(tables: Table[]): {
     valid: boolean;
     error?: string;
 };

package/esm/types/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Type exports for @constructive-io/graphql-codegen
  */
-export type { CleanBelongsToRelation, CleanField, CleanFieldType, CleanHasManyRelation, CleanHasOneRelation, CleanManyToManyRelation, CleanRelations, CleanTable, ConstraintInfo, ForeignKeyConstraint, TableConstraints, TableInflection, TableQueryNames, } from './schema';
+export type { BelongsToRelation, Field, FieldType, HasManyRelation, HasOneRelation, ManyToManyRelation, Relations, Table, ConstraintInfo, ForeignKeyConstraint, TableConstraints, TableInflection, TableQueryNames, } from './schema';
 export type { ConnectionResult, FieldFilter, Filter, FilterOperator, OrderByItem, PageInfo, QueryOptions, RelationalFilter, } from './query';
 export type { CreateInput, DeleteInput, MutationOptions, MutationResult, UpdateInput, } from './mutation';
 export type { FieldSelection, FieldSelectionPreset, SelectionOptions, SimpleFieldSelection, } from './selection';

package/esm/types/schema.d.ts

@@ -5,12 +5,12 @@
 /**
  * Represents a database table with its fields and relations
  */
-export interface CleanTable {
+export interface Table {
     name: string;
     /** Description from PostgreSQL COMMENT (smart comments stripped) */
     description?: string;
-    fields: CleanField[];
-    relations: CleanRelations;
+    fields: Field[];
+    relations: Relations;
     /** PostGraphile inflection rules for this table */
     inflection?: TableInflection;
     /** Query operation names from introspection */
@@ -94,20 +94,20 @@ export interface TableConstraints {
 }
 export interface ConstraintInfo {
     name: string;
-    fields: CleanField[];
+    fields: Field[];
 }
 export interface ForeignKeyConstraint extends ConstraintInfo {
     refTable: string;
-    refFields: CleanField[];
+    refFields: Field[];
 }
 /**
  * Represents a field/column in a table
  */
-export interface CleanField {
+export interface Field {
     name: string;
     /** Description from PostgreSQL COMMENT (smart comments stripped) */
     description?: string;
-    type: CleanFieldType;
+    type: FieldType;
     /** Whether the column has a NOT NULL constraint (inferred from NON_NULL wrapper on entity type field) */
     isNotNull?: boolean | null;
     /** Whether the column has a DEFAULT value (inferred by comparing entity vs CreateInput field nullability) */
@@ -116,7 +116,7 @@ export interface CleanField {
 /**
  * Field type information from PostGraphile introspection
  */
-export interface CleanFieldType {
+export interface FieldType {
     /** GraphQL type name (e.g., "String", "UUID", "Int") */
     gqlType: string;
     /** Whether this is an array type */
@@ -135,64 +135,72 @@ export interface CleanFieldType {
 /**
  * All relation types for a table
  */
-export interface CleanRelations {
-    belongsTo: CleanBelongsToRelation[];
-    hasOne: CleanHasOneRelation[];
-    hasMany: CleanHasManyRelation[];
-    manyToMany: CleanManyToManyRelation[];
+export interface Relations {
+    belongsTo: BelongsToRelation[];
+    hasOne: HasOneRelation[];
+    hasMany: HasManyRelation[];
+    manyToMany: ManyToManyRelation[];
 }
 /**
  * BelongsTo relation (foreign key on this table)
  */
-export interface CleanBelongsToRelation {
+export interface BelongsToRelation {
     fieldName: string | null;
     isUnique: boolean;
     referencesTable: string;
     type: string | null;
-    keys: CleanField[];
+    keys: Field[];
 }
 /**
  * HasOne relation (foreign key on other table, unique)
  */
-export interface CleanHasOneRelation {
+export interface HasOneRelation {
     fieldName: string | null;
     isUnique: boolean;
     referencedByTable: string;
     type: string | null;
-    keys: CleanField[];
+    keys: Field[];
 }
 /**
  * HasMany relation (foreign key on other table, not unique)
  */
-export interface CleanHasManyRelation {
+export interface HasManyRelation {
     fieldName: string | null;
     isUnique: boolean;
     referencedByTable: string;
     type: string | null;
-    keys: CleanField[];
+    keys: Field[];
 }
 /**
  * ManyToMany relation (through junction table)
  */
-export interface CleanManyToManyRelation {
+export interface ManyToManyRelation {
     fieldName: string | null;
     rightTable: string;
     junctionTable: string;
     type: string | null;
+    /** Junction FK field names pointing to the left table */
+    junctionLeftKeyFields?: string[];
+    /** Junction FK field names pointing to the right table */
+    junctionRightKeyFields?: string[];
+    /** Left table key fields (usually just 'id') */
+    leftKeyFields?: string[];
+    /** Right table key fields (usually just 'id') */
+    rightKeyFields?: string[];
 }
 /**
  * Clean representation of a GraphQL operation (query or mutation)
  * Derived from introspection data
  */
-export interface CleanOperation {
+export interface Operation {
     /** Operation name (e.g., "login", "currentUser", "cars") */
     name: string;
     /** Operation kind */
     kind: 'query' | 'mutation';
     /** Arguments/variables for the operation */
-    args: CleanArgument[];
+    args: Argument[];
     /** Return type */
-    returnType: CleanTypeRef;
+    returnType: TypeRef;
     /** Description from schema */
     description?: string;
     /** Whether this is deprecated */
@@ -203,11 +211,11 @@ export interface CleanOperation {
 /**
  * Clean representation of an operation argument
  */
-export interface CleanArgument {
+export interface Argument {
     /** Argument name */
     name: string;
     /** Argument type */
-    type: CleanTypeRef;
+    type: TypeRef;
     /** Default value (as string) */
     defaultValue?: string;
     /** Description from schema */
@@ -216,30 +224,30 @@ export interface CleanArgument {
 /**
  * Clean type reference - simplified from introspection TypeRef
  */
-export interface CleanTypeRef {
+export interface TypeRef {
     /** Type kind */
     kind: 'SCALAR' | 'OBJECT' | 'INPUT_OBJECT' | 'ENUM' | 'LIST' | 'NON_NULL';
     /** Type name (null for LIST and NON_NULL wrappers) */
     name: string | null;
     /** Inner type for LIST and NON_NULL wrappers */
-    ofType?: CleanTypeRef;
+    ofType?: TypeRef;
     /** Resolved TypeScript type string */
     tsType?: string;
     /** Fields for OBJECT types */
-    fields?: CleanObjectField[];
+    fields?: ObjectField[];
     /** Input fields for INPUT_OBJECT types */
-    inputFields?: CleanArgument[];
+    inputFields?: Argument[];
     /** Values for ENUM types */
     enumValues?: string[];
 }
 /**
  * Field on an object type
  */
-export interface CleanObjectField {
+export interface ObjectField {
     /** Field name */
     name: string;
     /** Field type */
-    type: CleanTypeRef;
+    type: TypeRef;
     /** Description */
     description?: string;
 }
@@ -255,9 +263,9 @@ export interface ResolvedType {
     name: string;
     description?: string;
     /** Fields for OBJECT types */
-    fields?: CleanObjectField[];
+    fields?: ObjectField[];
     /** Input fields for INPUT_OBJECT types */
-    inputFields?: CleanArgument[];
+    inputFields?: Argument[];
     /** Values for ENUM types */
     enumValues?: string[];
     /** Possible types for UNION types */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.17.0",
+  "version": "4.18.0",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -56,7 +56,7 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@babel/generator": "^7.29.1",
     "@babel/types": "^7.29.0",
-    "@constructive-io/graphql-query": "^3.7.0",
+    "@constructive-io/graphql-query": "^3.8.0",
     "@constructive-io/graphql-types": "^3.3.4",
     "@inquirerer/utils": "^3.3.4",
     "@pgpmjs/core": "^6.8.0",
@@ -64,7 +64,7 @@
     "deepmerge": "^4.3.1",
     "find-and-require-package-json": "^0.9.1",
     "gql-ast": "^3.3.3",
-    "graphile-schema": "^1.7.0",
+    "graphile-schema": "^1.8.0",
     "graphql": "16.13.0",
     "inflekt": "^0.3.3",
     "inquirerer": "^4.7.0",
@@ -101,5 +101,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "d7ad4d8a95a9ab73c9eee919e0cdfcc2334845af"
+  "gitHead": "b8d4ae2b36e37e7f3533f858f19ec000febaa04b"
 }

package/types/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * Type exports for @constructive-io/graphql-codegen
  */
-export type { CleanBelongsToRelation, CleanField, CleanFieldType, CleanHasManyRelation, CleanHasOneRelation, CleanManyToManyRelation, CleanRelations, CleanTable, ConstraintInfo, ForeignKeyConstraint, TableConstraints, TableInflection, TableQueryNames, } from './schema';
+export type { BelongsToRelation, Field, FieldType, HasManyRelation, HasOneRelation, ManyToManyRelation, Relations, Table, ConstraintInfo, ForeignKeyConstraint, TableConstraints, TableInflection, TableQueryNames, } from './schema';
 export type { ConnectionResult, FieldFilter, Filter, FilterOperator, OrderByItem, PageInfo, QueryOptions, RelationalFilter, } from './query';
 export type { CreateInput, DeleteInput, MutationOptions, MutationResult, UpdateInput, } from './mutation';
 export type { FieldSelection, FieldSelectionPreset, SelectionOptions, SimpleFieldSelection, } from './selection';