@constructive-io/graphql-codegen 4.9.0 → 4.13.0

package/esm/core/codegen/orm/model-generator.d.ts

@@ -5,5 +5,9 @@ export interface GeneratedModelFile {
     modelName: string;
     tableName: string;
 }
-export declare function generateModelFile(table: CleanTable, _useSharedTypes: boolean): GeneratedModelFile;
-export declare function generateAllModelFiles(tables: CleanTable[], useSharedTypes: boolean): GeneratedModelFile[];
+export declare function generateModelFile(table: CleanTable, _useSharedTypes: boolean, options?: {
+    condition?: boolean;
+}): GeneratedModelFile;
+export declare function generateAllModelFiles(tables: CleanTable[], useSharedTypes: boolean, options?: {
+    condition?: boolean;
+}): GeneratedModelFile[];

package/esm/core/codegen/orm/model-generator.js

@@ -65,7 +65,8 @@ function strictSelectGuard(selectTypeName) {
         t.tsTypeReference(t.identifier(selectTypeName)),
     ]));
 }
-export function generateModelFile(table, _useSharedTypes) {
+export function generateModelFile(table, _useSharedTypes, options) {
+    const conditionEnabled = options?.condition !== false;
     const { typeName, singularName, pluralName } = getTableNames(table);
     const modelName = `${typeName}Model`;
     const baseFileName = lcFirst(typeName);
@@ -74,6 +75,7 @@ export function generateModelFile(table, _useSharedTypes) {
     const selectTypeName = `${typeName}Select`;
     const relationTypeName = `${typeName}WithRelations`;
     const whereTypeName = getFilterTypeName(table);
+    const conditionTypeName = conditionEnabled ? `${typeName}Condition` : undefined;
     const orderByTypeName = getOrderByTypeName(table);
     const createInputTypeName = `Create${typeName}Input`;
     const updateInputTypeName = `Update${typeName}Input`;
@@ -108,16 +110,18 @@ export function generateModelFile(table, _useSharedTypes) {
         'InferSelectResult',
         'StrictSelect',
     ], true));
-    statements.push(createImportDeclaration('../input-types', [
+    const inputTypeImports = [
         typeName,
         relationTypeName,
         selectTypeName,
         whereTypeName,
+        ...(conditionTypeName ? [conditionTypeName] : []),
         orderByTypeName,
         createInputTypeName,
         updateInputTypeName,
         patchTypeName,
-    ], true));
+    ];
+    statements.push(createImportDeclaration('../input-types', inputTypeImports, true));
     statements.push(createImportDeclaration('../input-types', ['connectionFieldsMap']));
     const classBody = [];
     // Constructor
@@ -131,11 +135,15 @@ export function generateModelFile(table, _useSharedTypes) {
     const pkTsType = () => tsTypeFromPrimitive(pkField.tsType);
     // ── findMany ───────────────────────────────────────────────────────────
     {
-        const argsType = (sel) => t.tsTypeReference(t.identifier('FindManyArgs'), t.tsTypeParameterInstantiation([
-            sel,
-            t.tsTypeReference(t.identifier(whereTypeName)),
-            t.tsTypeReference(t.identifier(orderByTypeName)),
-        ]));
+        const findManyTypeArgs = [
+            (sel) => sel,
+            () => t.tsTypeReference(t.identifier(whereTypeName)),
+            ...(conditionTypeName
+                ? [() => t.tsTypeReference(t.identifier(conditionTypeName))]
+                : []),
+            () => t.tsTypeReference(t.identifier(orderByTypeName)),
+        ];
+        const argsType = (sel) => t.tsTypeReference(t.identifier('FindManyArgs'), t.tsTypeParameterInstantiation(findManyTypeArgs.map(fn => fn(sel))));
         const retType = (sel) => t.tsTypeAnnotation(t.tsTypeReference(t.identifier('QueryBuilder'), t.tsTypeParameterInstantiation([
             t.tsTypeLiteral([
                 t.tsPropertySignature(t.identifier(pluralQueryName), t.tsTypeAnnotation(t.tsTypeReference(t.identifier('ConnectionResult'), t.tsTypeParameterInstantiation([
@@ -153,34 +161,47 @@ export function generateModelFile(table, _useSharedTypes) {
             strictSelectGuard(selectTypeName),
         ]));
         const selectExpr = t.memberExpression(t.identifier('args'), t.identifier('select'));
+        const findManyObjProps = [
+            t.objectProperty(t.identifier('where'), t.optionalMemberExpression(t.identifier('args'), t.identifier('where'), false, true)),
+            ...(conditionTypeName
+                ? [
+                    t.objectProperty(t.identifier('condition'), t.optionalMemberExpression(t.identifier('args'), t.identifier('condition'), false, true)),
+                ]
+                : []),
+            t.objectProperty(t.identifier('orderBy'), t.tsAsExpression(t.optionalMemberExpression(t.identifier('args'), t.identifier('orderBy'), false, true), t.tsUnionType([
+                t.tsArrayType(t.tsStringKeyword()),
+                t.tsUndefinedKeyword(),
+            ]))),
+            t.objectProperty(t.identifier('first'), t.optionalMemberExpression(t.identifier('args'), t.identifier('first'), false, true)),
+            t.objectProperty(t.identifier('last'), t.optionalMemberExpression(t.identifier('args'), t.identifier('last'), false, true)),
+            t.objectProperty(t.identifier('after'), t.optionalMemberExpression(t.identifier('args'), t.identifier('after'), false, true)),
+            t.objectProperty(t.identifier('before'), t.optionalMemberExpression(t.identifier('args'), t.identifier('before'), false, true)),
+            t.objectProperty(t.identifier('offset'), t.optionalMemberExpression(t.identifier('args'), t.identifier('offset'), false, true)),
+        ];
         const bodyArgs = [
             t.stringLiteral(typeName),
             t.stringLiteral(pluralQueryName),
             selectExpr,
-            t.objectExpression([
-                t.objectProperty(t.identifier('where'), t.optionalMemberExpression(t.identifier('args'), t.identifier('where'), false, true)),
-                t.objectProperty(t.identifier('orderBy'), t.tsAsExpression(t.optionalMemberExpression(t.identifier('args'), t.identifier('orderBy'), false, true), t.tsUnionType([
-                    t.tsArrayType(t.tsStringKeyword()),
-                    t.tsUndefinedKeyword(),
-                ]))),
-                t.objectProperty(t.identifier('first'), t.optionalMemberExpression(t.identifier('args'), t.identifier('first'), false, true)),
-                t.objectProperty(t.identifier('last'), t.optionalMemberExpression(t.identifier('args'), t.identifier('last'), false, true)),
-                t.objectProperty(t.identifier('after'), t.optionalMemberExpression(t.identifier('args'), t.identifier('after'), false, true)),
-                t.objectProperty(t.identifier('before'), t.optionalMemberExpression(t.identifier('args'), t.identifier('before'), false, true)),
-                t.objectProperty(t.identifier('offset'), t.optionalMemberExpression(t.identifier('args'), t.identifier('offset'), false, true)),
-            ]),
+            t.objectExpression(findManyObjProps),
             t.stringLiteral(whereTypeName),
             t.stringLiteral(orderByTypeName),
             t.identifier('connectionFieldsMap'),
+            ...(conditionTypeName
+                ? [t.stringLiteral(conditionTypeName)]
+                : []),
         ];
         classBody.push(createClassMethod('findMany', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildFindManyDocument', bodyArgs, 'query', typeName, pluralQueryName)));
     }
     // ── findFirst ──────────────────────────────────────────────────────────
     {
-        const argsType = (sel) => t.tsTypeReference(t.identifier('FindFirstArgs'), t.tsTypeParameterInstantiation([
-            sel,
-            t.tsTypeReference(t.identifier(whereTypeName)),
-        ]));
+        const findFirstTypeArgs = [
+            (sel) => sel,
+            () => t.tsTypeReference(t.identifier(whereTypeName)),
+            ...(conditionTypeName
+                ? [() => t.tsTypeReference(t.identifier(conditionTypeName))]
+                : []),
+        ];
+        const argsType = (sel) => t.tsTypeReference(t.identifier('FindFirstArgs'), t.tsTypeParameterInstantiation(findFirstTypeArgs.map(fn => fn(sel))));
         const retType = (sel) => t.tsTypeAnnotation(t.tsTypeReference(t.identifier('QueryBuilder'), t.tsTypeParameterInstantiation([
             t.tsTypeLiteral([
                 t.tsPropertySignature(t.identifier(pluralQueryName), t.tsTypeAnnotation(t.tsTypeLiteral([
@@ -198,15 +219,24 @@ export function generateModelFile(table, _useSharedTypes) {
             strictSelectGuard(selectTypeName),
         ]));
         const selectExpr = t.memberExpression(t.identifier('args'), t.identifier('select'));
+        const findFirstObjProps = [
+            t.objectProperty(t.identifier('where'), t.optionalMemberExpression(t.identifier('args'), t.identifier('where'), false, true)),
+            ...(conditionTypeName
+                ? [
+                    t.objectProperty(t.identifier('condition'), t.optionalMemberExpression(t.identifier('args'), t.identifier('condition'), false, true)),
+                ]
+                : []),
+        ];
         const bodyArgs = [
             t.stringLiteral(typeName),
             t.stringLiteral(pluralQueryName),
             selectExpr,
-            t.objectExpression([
-                t.objectProperty(t.identifier('where'), t.optionalMemberExpression(t.identifier('args'), t.identifier('where'), false, true)),
-            ]),
+            t.objectExpression(findFirstObjProps),
             t.stringLiteral(whereTypeName),
             t.identifier('connectionFieldsMap'),
+            ...(conditionTypeName
+                ? [t.stringLiteral(conditionTypeName)]
+                : []),
         ];
         classBody.push(createClassMethod('findFirst', createTypeParam(selectTypeName), [implParam], retType(sRef()), buildMethodBody('buildFindFirstDocument', bodyArgs, 'query', typeName, pluralQueryName)));
     }
@@ -410,6 +440,6 @@ export function generateModelFile(table, _useSharedTypes) {
         tableName: table.name,
     };
 }
-export function generateAllModelFiles(tables, useSharedTypes) {
-    return tables.map((table) => generateModelFile(table, useSharedTypes));
+export function generateAllModelFiles(tables, useSharedTypes, options) {
+    return tables.map((table) => generateModelFile(table, useSharedTypes, options));
 }

package/esm/core/codegen/orm/select-types.d.ts

@@ -150,9 +150,10 @@ export interface PageInfo {
 /**
  * Arguments for findMany operations
  */
-export interface FindManyArgs<TSelect, TWhere, TOrderBy> {
+export interface FindManyArgs<TSelect, TWhere, TCondition, TOrderBy> {
     select?: TSelect;
     where?: TWhere;
+    condition?: TCondition;
     orderBy?: TOrderBy[];
     first?: number;
     last?: number;
@@ -163,9 +164,10 @@ export interface FindManyArgs<TSelect, TWhere, TOrderBy> {
 /**
  * Arguments for findFirst/findUnique operations
  */
-export interface FindFirstArgs<TSelect, TWhere> {
+export interface FindFirstArgs<TSelect, TWhere, TCondition> {
     select?: TSelect;
     where?: TWhere;
+    condition?: TCondition;
 }
 /**
  * Arguments for create operations

package/esm/core/codegen/scalars.js

@@ -33,6 +33,8 @@ export const SCALAR_TS_MAP = {
     MacAddr: 'string',
     TsVector: 'string',
     TsQuery: 'string',
+    // Vector types (pgvector) — serialized as [Float] in GraphQL
+    Vector: 'number[]',
     // File upload
     Upload: 'File',
 };
@@ -51,6 +53,12 @@ export const SCALAR_FILTER_MAP = {
     BigFloat: 'BigFloatFilter',
     BitString: 'BitStringFilter',
     InternetAddress: 'InternetAddressFilter',
+    // VectorFilter provides equality/distinct operators (isNull, equalTo, etc.) for vector
+    // columns on Filter types. While similarity search is done via condition types
+    // (e.g., embeddingNearby on ContactCondition), postgraphile-plugin-connection-filter
+    // may still auto-generate a filter type for vector columns. Without this mapping,
+    // those fields would be silently omitted from the generated SDK.
+    Vector: 'VectorFilter',
     FullText: 'FullTextFilter',
     Interval: 'StringFilter',
 };

package/esm/core/generate.js

@@ -274,18 +274,18 @@ export async function generate(options = {}, internalOptions) {
             ? config.cli.toolName
             : 'app';
         if (docsConfig.readme) {
-            const readme = generateCliReadme(tables, allCustomOps, toolName);
+            const readme = generateCliReadme(tables, allCustomOps, toolName, customOperations.typeRegistry);
             filesToWrite.push({ path: path.posix.join('cli', readme.fileName), content: readme.content });
         }
         if (docsConfig.agents) {
-            const agents = generateCliAgentsDocs(tables, allCustomOps, toolName);
+            const agents = generateCliAgentsDocs(tables, allCustomOps, toolName, customOperations.typeRegistry);
             filesToWrite.push({ path: path.posix.join('cli', agents.fileName), content: agents.content });
         }
         if (docsConfig.mcp) {
-            allMcpTools.push(...getCliMcpTools(tables, allCustomOps, toolName));
+            allMcpTools.push(...getCliMcpTools(tables, allCustomOps, toolName, customOperations.typeRegistry));
         }
         if (docsConfig.skills) {
-            for (const skill of generateCliSkills(tables, allCustomOps, toolName, targetName)) {
+            for (const skill of generateCliSkills(tables, allCustomOps, toolName, targetName, customOperations.typeRegistry)) {
                 skillsToWrite.push({ path: skill.fileName, content: skill.content });
             }
         }
@@ -574,9 +574,19 @@ export async function generateMulti(options) {
             const docsConfig = resolveDocsConfig(firstTargetDocsConfig);
             const { resolveBuiltinNames } = await import('./codegen/cli');
             const builtinNames = resolveBuiltinNames(cliTargets.map((t) => t.name), cliConfig.builtinNames);
+            // Merge all target type registries into a combined registry for docs generation
+            const combinedRegistry = new Map();
+            for (const t of cliTargets) {
+                if (t.typeRegistry) {
+                    for (const [key, value] of t.typeRegistry) {
+                        combinedRegistry.set(key, value);
+                    }
+                }
+            }
             const docsInput = {
                 toolName,
                 builtinNames,
+                registry: combinedRegistry.size > 0 ? combinedRegistry : undefined,
                 targets: cliTargets.map((t) => ({
                     name: t.name,
                     endpoint: t.endpoint,

package/esm/types/config.d.ts

@@ -153,6 +153,7 @@ export interface DocsConfig {
 export interface BuiltinNames {
     auth?: string;
     context?: string;
+    config?: string;
 }
 /**
  * CLI generation configuration
@@ -285,6 +286,14 @@ export interface GraphQLSDKConfigTarget {
          * @default true
          */
         comments?: boolean;
+        /**
+         * Generate condition types and condition arguments on findMany/findFirst.
+         * PostGraphile's native `condition` argument provides simple equality filtering.
+         * Set to `true` to include condition types and arguments in generated code.
+         * Set to `false` to omit them (e.g., when using connection-filter's `filter` argument exclusively).
+         * @default false
+         */
+        condition?: boolean;
     };
     /**
      * Whether to generate ORM client

package/esm/types/config.js

@@ -61,6 +61,7 @@ export const DEFAULT_CONFIG = {
     codegen: {
         skipQueryField: true,
         comments: true,
+        condition: false,
     },
     orm: false,
     reactQuery: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "4.9.0",
+  "version": "4.13.0",
   "description": "GraphQL SDK generator for Constructive databases with React Query hooks",
   "keywords": [
     "graphql",
@@ -56,25 +56,25 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@babel/generator": "^7.29.1",
     "@babel/types": "^7.29.0",
-    "@constructive-io/graphql-query": "^3.3.4",
-    "@constructive-io/graphql-types": "^3.1.2",
+    "@constructive-io/graphql-query": "^3.5.3",
+    "@constructive-io/graphql-types": "^3.3.2",
     "@inquirerer/utils": "^3.3.1",
-    "@pgpmjs/core": "^6.4.2",
+    "@pgpmjs/core": "^6.6.2",
     "ajv": "^8.18.0",
     "deepmerge": "^4.3.1",
     "find-and-require-package-json": "^0.9.1",
-    "gql-ast": "^3.1.1",
-    "graphile-schema": "^1.3.4",
+    "gql-ast": "^3.3.2",
+    "graphile-schema": "^1.5.3",
     "graphql": "^16.13.0",
     "inflekt": "^0.3.3",
     "inquirerer": "^4.5.2",
     "jiti": "^2.6.1",
     "komoji": "^0.8.1",
     "oxfmt": "^0.36.0",
-    "pg-cache": "^3.1.1",
-    "pg-env": "^1.5.0",
-    "pgsql-client": "^3.3.2",
-    "pgsql-seed": "^2.3.2",
+    "pg-cache": "^3.3.2",
+    "pg-env": "^1.7.2",
+    "pgsql-client": "^3.5.2",
+    "pgsql-seed": "^2.5.2",
     "undici": "^7.22.0"
   },
   "peerDependencies": {
@@ -101,5 +101,5 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "f1f05509f0168497f17c3dbbddb131d6aa5310e1"
+  "gitHead": "67218366027bc6370e07a1b96d8bf25adba18f42"
 }

package/types/config.d.ts

@@ -153,6 +153,7 @@ export interface DocsConfig {
 export interface BuiltinNames {
     auth?: string;
     context?: string;
+    config?: string;
 }
 /**
  * CLI generation configuration
@@ -285,6 +286,14 @@ export interface GraphQLSDKConfigTarget {
          * @default true
          */
         comments?: boolean;
+        /**
+         * Generate condition types and condition arguments on findMany/findFirst.
+         * PostGraphile's native `condition` argument provides simple equality filtering.
+         * Set to `true` to include condition types and arguments in generated code.
+         * Set to `false` to omit them (e.g., when using connection-filter's `filter` argument exclusively).
+         * @default false
+         */
+        condition?: boolean;
     };
     /**
      * Whether to generate ORM client

package/types/config.js

@@ -70,6 +70,7 @@ exports.DEFAULT_CONFIG = {
     codegen: {
         skipQueryField: true,
         comments: true,
+        condition: false,
     },
     orm: false,
     reactQuery: false,