@constructive-io/graphql-codegen 2.17.37 → 2.17.39

package/README.md

@@ -86,26 +86,16 @@ Endpoint introspection:
 
 ## Selection Options
 
-Configure result field selections, mutation input style, and connection pagination shape.
+Configure mutation input style and connection pagination shape.
 
 ```ts
 selection: {
-  defaultMutationModelFields?: string[]
-  modelFields?: Record<string, string[]>
   mutationInputMode?: 'expanded' | 'model' | 'raw' | 'patchCollapsed'
   connectionStyle?: 'nodes' | 'edges'
   forceModelOutput?: boolean
 }
 ```
 
-- `defaultMutationModelFields`
-  - Sets default fields selected from the object payload returned by mutations when the mutation exposes an OBJECT output.
-  - Example: `['id']` will select only the `id` from the returned model unless overridden per model.
-
-- `modelFields`
-  - Per‑model overrides for returned object payload fields.
-  - Example: `{ domain: ['id','domain','subdomain'] }` selects those fields from the `domain` object output.
-
 - `mutationInputMode`
   - Controls how mutation variables and `input` are generated.
   - `expanded`: one variable per input property; `input` is a flat object of those variables.
@@ -119,8 +109,7 @@ selection: {
   - `edges`: emits `totalCount`, `pageInfo { ... }`, and `edges { cursor node { ... } }`.
 
 - `forceModelOutput`
-  - When `true`, ensures the object payload is selected even if `defaultMutationModelFields` is empty, defaulting to `['id']`.
-  - Useful to avoid generating mutations that only return `clientMutationId`.
+  - When `true`, ensures the object payload selection is emitted to avoid a payload with only `clientMutationId`.
 
 ### Examples
 
@@ -208,9 +197,14 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 
 ## Related Constructive Tooling
 
+### 📦 Package Management
+
+* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
+
 ### 🧪 Testing
 
 * [pgsql-test](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-test): **📊 Isolated testing environments** with per-test transaction rollbacks—ideal for integration tests, complex migrations, and RLS simulation.
+* [pgsql-seed](https://github.com/constructive-io/constructive/tree/main/postgres/pgsql-seed): **🌱 PostgreSQL seeding utilities** for CSV, JSON, SQL data loading, and pgpm deployment.
 * [supabase-test](https://github.com/constructive-io/constructive/tree/main/postgres/supabase-test): **🧪 Supabase-native test harness** preconfigured for the local Supabase stack—per-test rollbacks, JWT/role context helpers, and CI/GitHub Actions ready.
 * [graphile-test](https://github.com/constructive-io/constructive/tree/main/graphile/graphile-test): **🔐 Authentication mocking** for Graphile-focused test helpers and emulating row-level security contexts.
 * [pg-query-context](https://github.com/constructive-io/constructive/tree/main/postgres/pg-query-context): **🔒 Session context injection** to add session-local context (e.g., `SET LOCAL`) into queries—ideal for setting `role`, `jwt.claims`, and other session settings.
@@ -224,28 +218,6 @@ Common issues and solutions for pgpm, PostgreSQL, and testing.
 * [@pgsql/types](https://www.npmjs.com/package/@pgsql/types): **📝 Type definitions** for PostgreSQL AST nodes in TypeScript.
 * [@pgsql/utils](https://www.npmjs.com/package/@pgsql/utils): **🛠️ AST utilities** for constructing and transforming PostgreSQL syntax trees.
 
-### 🚀 API & Dev Tools
-
-* [@constructive-io/graphql-server](https://github.com/constructive-io/constructive/tree/main/graphql/server): **⚡ Express-based API server** powered by PostGraphile to expose a secure, scalable GraphQL API over your Postgres database.
-* [@constructive-io/graphql-explorer](https://github.com/constructive-io/constructive/tree/main/graphql/explorer): **🔎 Visual API explorer** with GraphiQL for browsing across all databases and schemas—useful for debugging, documentation, and API prototyping.
-
-### 🔁 Streaming & Uploads
-
-* [etag-hash](https://github.com/constructive-io/constructive/tree/main/streaming/etag-hash): **🏷️ S3-compatible ETags** created by streaming and hashing file uploads in chunks.
-* [etag-stream](https://github.com/constructive-io/constructive/tree/main/streaming/etag-stream): **🔄 ETag computation** via Node stream transformer during upload or transfer.
-* [uuid-hash](https://github.com/constructive-io/constructive/tree/main/streaming/uuid-hash): **🆔 Deterministic UUIDs** generated from hashed content, great for deduplication and asset referencing.
-* [uuid-stream](https://github.com/constructive-io/constructive/tree/main/streaming/uuid-stream): **🌊 Streaming UUID generation** based on piped file content—ideal for upload pipelines.
-* [@constructive-io/s3-streamer](https://github.com/constructive-io/constructive/tree/main/streaming/s3-streamer): **📤 Direct S3 streaming** for large files with support for metadata injection and content validation.
-* [@constructive-io/upload-names](https://github.com/constructive-io/constructive/tree/main/streaming/upload-names): **📂 Collision-resistant filenames** utility for structured and unique file names for uploads.
-
-### 🧰 CLI & Codegen
-
-* [pgpm](https://github.com/constructive-io/constructive/tree/main/pgpm/pgpm): **🖥️ PostgreSQL Package Manager** for modular Postgres development. Works with database workspaces, scaffolding, migrations, seeding, and installing database packages.
-* [@constructive-io/cli](https://github.com/constructive-io/constructive/tree/main/packages/cli): **🖥️ Command-line toolkit** for managing Constructive projects—supports database scaffolding, migrations, seeding, code generation, and automation.
-* [@constructive-io/graphql-codegen](https://github.com/constructive-io/constructive/tree/main/graphql/codegen): **✨ GraphQL code generation** (types, operations, SDK) from schema/endpoint introspection.
-* [@constructive-io/query-builder](https://github.com/constructive-io/constructive/tree/main/packages/query-builder): **🏗️ SQL constructor** providing a robust TypeScript-based query builder for dynamic generation of `SELECT`, `INSERT`, `UPDATE`, `DELETE`, and stored procedure calls—supports advanced SQL features like `JOIN`, `GROUP BY`, and schema-qualified queries.
-* [@constructive-io/graphql-query](https://github.com/constructive-io/constructive/tree/main/graphql/query): **🧩 Fluent GraphQL builder** for PostGraphile schemas. ⚡ Schema-aware via introspection, 🧩 composable and ergonomic for building deeply nested queries.
-
 ## Credits
 
 **🛠 Built by the [Constructive](https://constructive.io) team — creators of modular Postgres tooling for secure, composable backends. If you like our work, contribute on [GitHub](https://github.com/constructive-io).**

package/esm/gql.js

@@ -480,12 +480,27 @@ export const createOne = ({ operationName, mutation, selection, }, typeNameOverr
                 }),
             }),
         ];
-    const selections = allAttrs.map((field) => t.field({ name: 'id' }));
-    const modelFields = selection?.modelFields?.[modelName] || selection?.defaultMutationModelFields || ['id'];
-    const nested = (modelFields.length > 0)
+    let idExists = true;
+    let availableFieldNames = [];
+    if (typeIndex) {
+        const typ = typeIndex.byName?.[mutation.model];
+        const fields = (typ && Array.isArray(typ.fields)) ? typ.fields : [];
+        idExists = fields.some((f) => f && f.name === 'id');
+        availableFieldNames = fields
+            .filter((f) => {
+            let r = f.type;
+            while (r && (r.kind === 'NON_NULL' || r.kind === 'LIST'))
+                r = r.ofType;
+            const kind = r?.kind;
+            return kind === 'SCALAR' || kind === 'ENUM';
+        })
+            .map((f) => f.name);
+    }
+    const finalFields = Array.from(new Set([...(idExists ? ['id'] : []), ...availableFieldNames]));
+    const nested = (finalFields.length > 0)
         ? [t.field({
                 name: modelName,
-                selectionSet: t.selectionSet({ selections: modelFields.map((f) => t.field({ name: f })) }),
+                selectionSet: t.selectionSet({ selections: finalFields.map((f) => t.field({ name: f })) }),
             })]
         : [];
     const ast = createGqlMutation({
@@ -577,7 +592,7 @@ export const patchOne = ({ operationName, mutation, selection, }, typeNameOverri
             unresolved++;
         return t.variableDefinition({ variable: t.variable({ name }), type: gqlType });
     });
-    const mustUseRaw = useCollapsedOpt || unresolved > 0;
+    const mustUseRaw = unresolved > 0;
     const selectArgs = mustUseRaw
         ? [t.argument({ name: 'input', value: t.variable({ name: 'input' }) })]
         : [
@@ -598,11 +613,18 @@ export const patchOne = ({ operationName, mutation, selection, }, typeNameOverri
                 }),
             }),
         ];
-    const modelFields = selection?.modelFields?.[modelName] || selection?.defaultMutationModelFields || ['id'];
-    const nestedPatch = (modelFields.length > 0)
+    let idExistsPatch = true;
+    if (typeIndex) {
+        const typ = typeIndex.byName?.[mutation.model];
+        const fields = (typ && Array.isArray(typ.fields)) ? typ.fields : [];
+        idExistsPatch = fields.some((f) => f && f.name === 'id');
+    }
+    const shouldDropIdPatch = /Extension$/i.test(modelName) || !idExistsPatch;
+    const idSelection = shouldDropIdPatch ? [] : ['id'];
+    const nestedPatch = (idSelection.length > 0)
         ? [t.field({
                 name: modelName,
-                selectionSet: t.selectionSet({ selections: modelFields.map((f) => t.field({ name: f })) }),
+                selectionSet: t.selectionSet({ selections: idSelection.map((f) => t.field({ name: f })) }),
             })]
         : [];
     const ast = createGqlMutation({
@@ -729,20 +751,41 @@ export const createMutation = ({ operationName, mutation, selection, }, typeName
     const scalarOutputs = (mutation.outputs || [])
         .filter((field) => field.type.kind === 'SCALAR')
         .map((f) => f.name);
-    const objectOutput = (mutation.outputs || []).find((field) => field.type.kind === 'OBJECT');
-    const selections = [];
-    if (objectOutput?.name) {
-        const modelFieldsRaw = selection?.modelFields?.[objectOutput.name] || selection?.defaultMutationModelFields || [];
-        const shouldDropId = /Extension$/i.test(objectOutput.name);
-        const fallbackFields = shouldDropId ? [] : ['id'];
-        const modelFields = (selection?.forceModelOutput && modelFieldsRaw.length === 0) ? fallbackFields : (modelFieldsRaw.length > 0 ? modelFieldsRaw : []);
-        if (modelFields.length > 0) {
-            selections.push(t.field({
-                name: objectOutput.name,
-                selectionSet: t.selectionSet({ selections: modelFields.map((f) => t.field({ name: f })) }),
-            }));
+    let objectOutputName = (mutation.outputs || [])
+        .find((field) => field.type.kind === 'OBJECT')?.name;
+    if (!objectOutputName) {
+        const payloadTypeName = mutation?.output?.name;
+        if (typeIndex && payloadTypeName) {
+            const payloadType = typeIndex.byName?.[payloadTypeName];
+            const fields = (payloadType && Array.isArray(payloadType.fields)) ? payloadType.fields : [];
+            const match = fields
+                .filter((f) => f && f.name !== 'clientMutationId')
+                .filter((f) => (refToNamedTypeName(f.type) || f.type?.name) !== 'Query')
+                .find((f) => (refToNamedTypeName(f.type) || f.type?.name) === mutation?.model);
+            if (match)
+                objectOutputName = match.name;
         }
     }
+    const selections = [];
+    if (objectOutputName) {
+        const modelTypeName = mutation?.model;
+        const modelType = typeIndex && modelTypeName ? typeIndex.byName?.[modelTypeName] : null;
+        const fieldNames = (modelType && Array.isArray(modelType.fields))
+            ? modelType.fields
+                .filter((f) => {
+                let r = f.type;
+                while (r && (r.kind === 'NON_NULL' || r.kind === 'LIST'))
+                    r = r.ofType;
+                const kind = r?.kind;
+                return kind === 'SCALAR' || kind === 'ENUM';
+            })
+                .map((f) => f.name)
+            : [];
+        selections.push(t.field({
+            name: objectOutputName,
+            selectionSet: t.selectionSet({ selections: fieldNames.map((n) => t.field({ name: n })) }),
+        }));
+    }
     if (scalarOutputs.length > 0) {
         selections.push(...scalarOutputs.map((o) => t.field({ name: o })));
     }

package/esm/options.js

@@ -10,7 +10,7 @@ export const defaultGraphQLCodegenOptions = {
     documents: { format: 'gql', convention: 'dashed', allowQueries: [], excludeQueries: [], excludePatterns: [] },
     features: { emitTypes: true, emitOperations: true, emitSdk: true, emitReactQuery: true },
     reactQuery: { fetcher: 'graphql-request', legacyMode: false, exposeDocument: false, addInfiniteQuery: false, reactQueryVersion: 5 },
-    selection: { defaultMutationModelFields: ['id'], modelFields: {}, mutationInputMode: 'patchCollapsed', connectionStyle: 'edges', forceModelOutput: true },
+    selection: { mutationInputMode: 'patchCollapsed', connectionStyle: 'edges', forceModelOutput: true },
     scalars: {},
     typeNameOverrides: {}
 };

package/gql.d.ts

@@ -84,8 +84,6 @@ export interface CreateOneArgs {
     operationName: string;
     mutation: MutationSpec;
     selection?: {
-        defaultMutationModelFields?: string[];
-        modelFields?: Record<string, string[]>;
         mutationInputMode?: 'expanded' | 'model' | 'raw' | 'patchCollapsed';
         connectionStyle?: 'nodes' | 'edges';
         forceModelOutput?: boolean;
@@ -115,8 +113,6 @@ export interface PatchOneArgs {
     operationName: string;
     mutation: MutationSpec;
     selection?: {
-        defaultMutationModelFields?: string[];
-        modelFields?: Record<string, string[]>;
         mutationInputMode?: 'expanded' | 'model' | 'raw' | 'patchCollapsed';
         connectionStyle?: 'nodes' | 'edges';
         forceModelOutput?: boolean;
@@ -140,8 +136,6 @@ export interface CreateMutationArgs {
     operationName: string;
     mutation: MutationSpec;
     selection?: {
-        defaultMutationModelFields?: string[];
-        modelFields?: Record<string, string[]>;
         mutationInputMode?: 'expanded' | 'model' | 'raw' | 'patchCollapsed';
         connectionStyle?: 'nodes' | 'edges';
         forceModelOutput?: boolean;

package/gql.js

@@ -527,12 +527,27 @@ const createOne = ({ operationName, mutation, selection, }, typeNameOverrides, t
                 }),
             }),
         ];
-    const selections = allAttrs.map((field) => t.field({ name: 'id' }));
-    const modelFields = selection?.modelFields?.[modelName] || selection?.defaultMutationModelFields || ['id'];
-    const nested = (modelFields.length > 0)
+    let idExists = true;
+    let availableFieldNames = [];
+    if (typeIndex) {
+        const typ = typeIndex.byName?.[mutation.model];
+        const fields = (typ && Array.isArray(typ.fields)) ? typ.fields : [];
+        idExists = fields.some((f) => f && f.name === 'id');
+        availableFieldNames = fields
+            .filter((f) => {
+            let r = f.type;
+            while (r && (r.kind === 'NON_NULL' || r.kind === 'LIST'))
+                r = r.ofType;
+            const kind = r?.kind;
+            return kind === 'SCALAR' || kind === 'ENUM';
+        })
+            .map((f) => f.name);
+    }
+    const finalFields = Array.from(new Set([...(idExists ? ['id'] : []), ...availableFieldNames]));
+    const nested = (finalFields.length > 0)
         ? [t.field({
                 name: modelName,
-                selectionSet: t.selectionSet({ selections: modelFields.map((f) => t.field({ name: f })) }),
+                selectionSet: t.selectionSet({ selections: finalFields.map((f) => t.field({ name: f })) }),
             })]
         : [];
     const ast = (0, exports.createGqlMutation)({
@@ -625,7 +640,7 @@ const patchOne = ({ operationName, mutation, selection, }, typeNameOverrides, ty
             unresolved++;
         return t.variableDefinition({ variable: t.variable({ name }), type: gqlType });
     });
-    const mustUseRaw = useCollapsedOpt || unresolved > 0;
+    const mustUseRaw = unresolved > 0;
     const selectArgs = mustUseRaw
         ? [t.argument({ name: 'input', value: t.variable({ name: 'input' }) })]
         : [
@@ -646,11 +661,18 @@ const patchOne = ({ operationName, mutation, selection, }, typeNameOverrides, ty
                 }),
             }),
         ];
-    const modelFields = selection?.modelFields?.[modelName] || selection?.defaultMutationModelFields || ['id'];
-    const nestedPatch = (modelFields.length > 0)
+    let idExistsPatch = true;
+    if (typeIndex) {
+        const typ = typeIndex.byName?.[mutation.model];
+        const fields = (typ && Array.isArray(typ.fields)) ? typ.fields : [];
+        idExistsPatch = fields.some((f) => f && f.name === 'id');
+    }
+    const shouldDropIdPatch = /Extension$/i.test(modelName) || !idExistsPatch;
+    const idSelection = shouldDropIdPatch ? [] : ['id'];
+    const nestedPatch = (idSelection.length > 0)
         ? [t.field({
                 name: modelName,
-                selectionSet: t.selectionSet({ selections: modelFields.map((f) => t.field({ name: f })) }),
+                selectionSet: t.selectionSet({ selections: idSelection.map((f) => t.field({ name: f })) }),
             })]
         : [];
     const ast = (0, exports.createGqlMutation)({
@@ -779,20 +801,41 @@ const createMutation = ({ operationName, mutation, selection, }, typeNameOverrid
     const scalarOutputs = (mutation.outputs || [])
         .filter((field) => field.type.kind === 'SCALAR')
         .map((f) => f.name);
-    const objectOutput = (mutation.outputs || []).find((field) => field.type.kind === 'OBJECT');
-    const selections = [];
-    if (objectOutput?.name) {
-        const modelFieldsRaw = selection?.modelFields?.[objectOutput.name] || selection?.defaultMutationModelFields || [];
-        const shouldDropId = /Extension$/i.test(objectOutput.name);
-        const fallbackFields = shouldDropId ? [] : ['id'];
-        const modelFields = (selection?.forceModelOutput && modelFieldsRaw.length === 0) ? fallbackFields : (modelFieldsRaw.length > 0 ? modelFieldsRaw : []);
-        if (modelFields.length > 0) {
-            selections.push(t.field({
-                name: objectOutput.name,
-                selectionSet: t.selectionSet({ selections: modelFields.map((f) => t.field({ name: f })) }),
-            }));
+    let objectOutputName = (mutation.outputs || [])
+        .find((field) => field.type.kind === 'OBJECT')?.name;
+    if (!objectOutputName) {
+        const payloadTypeName = mutation?.output?.name;
+        if (typeIndex && payloadTypeName) {
+            const payloadType = typeIndex.byName?.[payloadTypeName];
+            const fields = (payloadType && Array.isArray(payloadType.fields)) ? payloadType.fields : [];
+            const match = fields
+                .filter((f) => f && f.name !== 'clientMutationId')
+                .filter((f) => (refToNamedTypeName(f.type) || f.type?.name) !== 'Query')
+                .find((f) => (refToNamedTypeName(f.type) || f.type?.name) === mutation?.model);
+            if (match)
+                objectOutputName = match.name;
         }
     }
+    const selections = [];
+    if (objectOutputName) {
+        const modelTypeName = mutation?.model;
+        const modelType = typeIndex && modelTypeName ? typeIndex.byName?.[modelTypeName] : null;
+        const fieldNames = (modelType && Array.isArray(modelType.fields))
+            ? modelType.fields
+                .filter((f) => {
+                let r = f.type;
+                while (r && (r.kind === 'NON_NULL' || r.kind === 'LIST'))
+                    r = r.ofType;
+                const kind = r?.kind;
+                return kind === 'SCALAR' || kind === 'ENUM';
+            })
+                .map((f) => f.name)
+            : [];
+        selections.push(t.field({
+            name: objectOutputName,
+            selectionSet: t.selectionSet({ selections: fieldNames.map((n) => t.field({ name: n })) }),
+        }));
+    }
     if (scalarOutputs.length > 0) {
         selections.push(...scalarOutputs.map((o) => t.field({ name: o })));
     }

package/options.d.ts

@@ -34,8 +34,6 @@ export interface GraphQLCodegenOptions {
         reactQueryVersion?: number;
     };
     selection?: {
-        defaultMutationModelFields?: string[];
-        modelFields?: Record<string, string[]>;
         mutationInputMode?: 'expanded' | 'model' | 'raw' | 'patchCollapsed';
         connectionStyle?: 'nodes' | 'edges';
         forceModelOutput?: boolean;

package/options.js

@@ -14,7 +14,7 @@ exports.defaultGraphQLCodegenOptions = {
     documents: { format: 'gql', convention: 'dashed', allowQueries: [], excludeQueries: [], excludePatterns: [] },
     features: { emitTypes: true, emitOperations: true, emitSdk: true, emitReactQuery: true },
     reactQuery: { fetcher: 'graphql-request', legacyMode: false, exposeDocument: false, addInfiniteQuery: false, reactQueryVersion: 5 },
-    selection: { defaultMutationModelFields: ['id'], modelFields: {}, mutationInputMode: 'patchCollapsed', connectionStyle: 'edges', forceModelOutput: true },
+    selection: { mutationInputMode: 'patchCollapsed', connectionStyle: 'edges', forceModelOutput: true },
     scalars: {},
     typeNameOverrides: {}
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "2.17.37",
+  "version": "2.17.39",
   "description": "Generate queries and mutations for use with Graphile",
   "author": "Constructive <developers@constructive.io>",
   "main": "index.js",
@@ -29,7 +29,7 @@
     "test:watch": "jest --watch"
   },
   "devDependencies": {
-    "@constructive-io/graphql-test": "^2.11.30",
+    "@constructive-io/graphql-test": "^2.11.32",
     "@types/babel__generator": "^7.27.0",
     "@types/pluralize": "0.0.33",
     "makage": "^0.1.9"
@@ -48,7 +48,7 @@
     "graphql-request": "6.1.0",
     "graphql-tag": "2.12.6",
     "inflection": "^1.12.0",
-    "introspectron": "^2.14.35",
+    "introspectron": "^2.14.37",
     "pluralize": "^8.0.0"
   },
   "keywords": [
@@ -58,5 +58,5 @@
     "graphile",
     "constructive"
   ],
-  "gitHead": "bda56442f70c77c98276bc7bab0450308c975df8"
+  "gitHead": "6883e3b93da28078483bc6aa25862613ef4405b2"
 }