@constructive-io/graphql-codegen 2.21.0 → 2.22.0

package/esm/cli/introspect/transform-schema.d.ts

@@ -30,13 +30,29 @@ export declare function transformSchemaToOperations(response: IntrospectionQuery
  * Uses glob-like patterns (supports * wildcard)
  */
 export declare function filterOperations(operations: CleanOperation[], include?: string[], exclude?: string[]): CleanOperation[];
+/**
+ * Result type for table operation names lookup
+ */
+export interface TableOperationNames {
+    queries: Set<string>;
+    mutations: Set<string>;
+}
 /**
  * Get the set of table-related operation names from tables
  * Used to identify which operations are already covered by table generators
  *
- * This includes:
- * - Basic CRUD: all, one, create, update, delete
- * - PostGraphile alternate mutations: updateXByY, deleteXByY (for unique constraints)
+ * IMPORTANT: This uses EXACT matches only from _meta.query fields.
+ * Any operation not explicitly listed in _meta will flow through as a
+ * custom operation, ensuring 100% coverage of the schema.
+ *
+ * Table operations (generated by table generators):
+ * - Queries: all (list), one (single by PK)
+ * - Mutations: create, update (by PK), delete (by PK)
+ *
+ * Custom operations (generated by custom operation generators):
+ * - Unique constraint lookups: *ByUsername, *ByEmail, etc.
+ * - Unique constraint mutations: update*By*, delete*By*
+ * - True custom operations: login, register, bootstrapUser, etc.
  */
 export declare function getTableOperationNames(tables: Array<{
     name: string;
@@ -47,28 +63,24 @@ export declare function getTableOperationNames(tables: Array<{
         update: string | null;
         delete: string | null;
     };
-    inflection?: {
-        tableType: string;
-    };
-}>): {
-    queries: Set<string>;
-    mutations: Set<string>;
-    tableTypePatterns: RegExp[];
-};
+}>): TableOperationNames;
 /**
  * Check if an operation is a table operation (already handled by table generators)
+ *
+ * Uses EXACT match only - no pattern matching. This ensures:
+ * 1. Only operations explicitly in _meta.query are treated as table operations
+ * 2. All other operations (including update*By*, delete*By*) become custom operations
+ * 3. 100% schema coverage is guaranteed
  */
-export declare function isTableOperation(operation: CleanOperation, tableOperationNames: {
-    queries: Set<string>;
-    mutations: Set<string>;
-    tableTypePatterns: RegExp[];
-}): boolean;
+export declare function isTableOperation(operation: CleanOperation, tableOperationNames: TableOperationNames): boolean;
 /**
  * Get only custom operations (not covered by table generators)
+ *
+ * This returns ALL operations that are not exact matches for table CRUD operations.
+ * Includes:
+ * - Unique constraint queries (*ByUsername, *ByEmail, etc.)
+ * - Unique constraint mutations (update*By*, delete*By*)
+ * - True custom operations (login, register, bootstrapUser, etc.)
  */
-export declare function getCustomOperations(operations: CleanOperation[], tableOperationNames: {
-    queries: Set<string>;
-    mutations: Set<string>;
-    tableTypePatterns: RegExp[];
-}): CleanOperation[];
+export declare function getCustomOperations(operations: CleanOperation[], tableOperationNames: TableOperationNames): CleanOperation[];
 export { unwrapType, getBaseTypeName, isNonNull };

package/esm/cli/introspect/transform-schema.js

@@ -26,6 +26,10 @@ export function buildTypeRegistry(types) {
         if (type.kind === 'ENUM' && type.enumValues) {
             resolvedType.enumValues = type.enumValues.map((ev) => ev.name);
         }
+        // Resolve possible types for UNION types (no circular refs for names)
+        if (type.kind === 'UNION' && type.possibleTypes) {
+            resolvedType.possibleTypes = type.possibleTypes.map((pt) => pt.name);
+        }
         registry.set(type.name, resolvedType);
     }
     // Second pass: Resolve fields (now that all types exist in registry)
@@ -200,57 +204,63 @@ function matchesPatterns(name, patterns) {
         return name === pattern;
     });
 }
-// ============================================================================
-// Utility Functions
-// ============================================================================
 /**
  * Get the set of table-related operation names from tables
  * Used to identify which operations are already covered by table generators
  *
- * This includes:
- * - Basic CRUD: all, one, create, update, delete
- * - PostGraphile alternate mutations: updateXByY, deleteXByY (for unique constraints)
+ * IMPORTANT: This uses EXACT matches only from _meta.query fields.
+ * Any operation not explicitly listed in _meta will flow through as a
+ * custom operation, ensuring 100% coverage of the schema.
+ *
+ * Table operations (generated by table generators):
+ * - Queries: all (list), one (single by PK)
+ * - Mutations: create, update (by PK), delete (by PK)
+ *
+ * Custom operations (generated by custom operation generators):
+ * - Unique constraint lookups: *ByUsername, *ByEmail, etc.
+ * - Unique constraint mutations: update*By*, delete*By*
+ * - True custom operations: login, register, bootstrapUser, etc.
  */
 export function getTableOperationNames(tables) {
     const queries = new Set();
     const mutations = new Set();
-    const tableTypePatterns = [];
     for (const table of tables) {
         if (table.query) {
+            // Add exact query names from _meta
             queries.add(table.query.all);
             queries.add(table.query.one);
+            // Add exact mutation names from _meta
             mutations.add(table.query.create);
             if (table.query.update)
                 mutations.add(table.query.update);
             if (table.query.delete)
                 mutations.add(table.query.delete);
         }
-        // Create patterns to match alternate CRUD mutations (updateXByY, deleteXByY)
-        if (table.inflection?.tableType) {
-            const typeName = table.inflection.tableType;
-            // Match: update{TypeName}By*, delete{TypeName}By*
-            tableTypePatterns.push(new RegExp(`^update${typeName}By`, 'i'));
-            tableTypePatterns.push(new RegExp(`^delete${typeName}By`, 'i'));
-        }
     }
-    return { queries, mutations, tableTypePatterns };
+    return { queries, mutations };
 }
 /**
  * Check if an operation is a table operation (already handled by table generators)
+ *
+ * Uses EXACT match only - no pattern matching. This ensures:
+ * 1. Only operations explicitly in _meta.query are treated as table operations
+ * 2. All other operations (including update*By*, delete*By*) become custom operations
+ * 3. 100% schema coverage is guaranteed
  */
 export function isTableOperation(operation, tableOperationNames) {
     if (operation.kind === 'query') {
         return tableOperationNames.queries.has(operation.name);
     }
-    // Check exact match first
-    if (tableOperationNames.mutations.has(operation.name)) {
-        return true;
-    }
-    // Check pattern match for alternate CRUD mutations (updateXByY, deleteXByY)
-    return tableOperationNames.tableTypePatterns.some((pattern) => pattern.test(operation.name));
+    return tableOperationNames.mutations.has(operation.name);
 }
 /**
  * Get only custom operations (not covered by table generators)
+ *
+ * This returns ALL operations that are not exact matches for table CRUD operations.
+ * Includes:
+ * - Unique constraint queries (*ByUsername, *ByEmail, etc.)
+ * - Unique constraint mutations (update*By*, delete*By*)
+ * - True custom operations (login, register, bootstrapUser, etc.)
  */
 export function getCustomOperations(operations, tableOperationNames) {
     return operations.filter((op) => !isTableOperation(op, tableOperationNames));

package/esm/types/schema.d.ts

@@ -250,4 +250,6 @@ export interface ResolvedType {
     inputFields?: CleanArgument[];
     /** Values for ENUM types */
     enumValues?: string[];
+    /** Possible types for UNION types */
+    possibleTypes?: string[];
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@constructive-io/graphql-codegen",
-  "version": "2.21.0",
+  "version": "2.22.0",
   "description": "CLI-based GraphQL SDK generator for PostGraphile endpoints with React Query hooks",
   "keywords": [
     "graphql",
@@ -41,15 +41,16 @@
     "lint": "eslint . --fix",
     "test": "jest --passWithNoTests",
     "test:watch": "jest --watch",
-    "example:orm": "tsx examples/test-orm.ts",
-    "example:rq": "tsx examples/test-rq.ts",
-    "example:schema": "tsx examples/download-schema.ts"
+    "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:sdk": "tsx examples/react-query-sdk.ts",
+    "example:orm": "tsx examples/orm-sdk.ts"
   },
   "dependencies": {
     "ajv": "^8.17.1",
     "commander": "^12.1.0",
     "gql-ast": "^2.4.6",
-    "graphql": "15.8.0",
+    "graphql": "15.10.1",
     "inflection": "^3.0.2",
     "jiti": "^2.6.1",
     "prettier": "^3.7.4",
@@ -76,7 +77,8 @@
     "jest": "^29.7.0",
     "react": "^19.2.3",
     "ts-jest": "^29.2.5",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
-  "gitHead": "a8a6f2cf22eb610f385bfba63d5e6e40e0a47e50"
+  "gitHead": "fe5e59d3a4497d7ac91a051b74e181851393f56c"
 }

package/types/schema.d.ts

@@ -250,4 +250,6 @@ export interface ResolvedType {
     inputFields?: CleanArgument[];
     /** Values for ENUM types */
     enumValues?: string[];
+    /** Possible types for UNION types */
+    possibleTypes?: string[];
 }

package/__tests__/codegen/input-types-generator.test.d.ts

@@ -1 +0,0 @@
-export {};