@constructive-io/graphql-codegen 3.2.0 → 3.3.0

package/core/codegen/query-keys.d.ts

@@ -1,5 +1,5 @@
-import type { CleanTable, CleanOperation } from '../../types/schema';
 import type { QueryKeyConfig } from '../../types/config';
+import type { CleanOperation, CleanTable } from '../../types/schema';
 export interface QueryKeyGeneratorOptions {
     tables: CleanTable[];
     customQueries: CleanOperation[];

package/core/codegen/query-keys.js

@@ -45,8 +45,8 @@ exports.generateQueryKeysFile = generateQueryKeysFile;
  * @see https://tanstack.com/query/docs/framework/react/community/lukemorales-query-key-factory
  */
 const t = __importStar(require("@babel/types"));
-const utils_1 = require("./utils");
 const babel_ast_1 = require("./babel-ast");
+const utils_1 = require("./utils");
 /**
  * Get all ancestor entities for a given entity based on relationships
  */
@@ -112,11 +112,13 @@ function buildByParentProperty(entityKey, typeName, parent, fkField) {
     const arrowFn = t.arrowFunctionExpression([(0, babel_ast_1.typedParam)(fkField, t.tsStringKeyword())], (0, babel_ast_1.constArray)([
         t.stringLiteral(entityKey),
         t.objectExpression([
-            t.objectProperty(t.identifier(fkField), t.identifier(fkField), false, true)
-        ])
+            t.objectProperty(t.identifier(fkField), t.identifier(fkField), false, true),
+        ]),
     ]));
     const prop = t.objectProperty(t.identifier(`by${parentUpper}`), arrowFn);
-    (0, babel_ast_1.addJSDocComment)(prop, [`${typeName} queries scoped to a specific ${parentLower}`]);
+    (0, babel_ast_1.addJSDocComment)(prop, [
+        `${typeName} queries scoped to a specific ${parentLower}`,
+    ]);
     return prop;
 }
 /**
@@ -128,14 +130,18 @@ function buildScopedProperty(keysName, typeName, relationship, ancestors) {
     const statements = [];
     if (relationship.parent) {
         statements.push(t.ifStatement(t.optionalMemberExpression(t.identifier('scope'), t.identifier(relationship.foreignKey), false, true), t.blockStatement([
-            t.returnStatement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier(`by${(0, utils_1.ucFirst)(relationship.parent)}`)), [t.memberExpression(t.identifier('scope'), t.identifier(relationship.foreignKey))]))
+            t.returnStatement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier(`by${(0, utils_1.ucFirst)(relationship.parent)}`)), [
+                t.memberExpression(t.identifier('scope'), t.identifier(relationship.foreignKey)),
+            ])),
         ])));
     }
     for (const ancestor of ancestors) {
         const ancestorLower = (0, utils_1.lcFirst)(ancestor);
         const fkField = `${ancestorLower}Id`;
         statements.push(t.ifStatement(t.optionalMemberExpression(t.identifier('scope'), t.identifier(fkField), false, true), t.blockStatement([
-            t.returnStatement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier(`by${(0, utils_1.ucFirst)(ancestor)}`)), [t.memberExpression(t.identifier('scope'), t.identifier(fkField))]))
+            t.returnStatement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier(`by${(0, utils_1.ucFirst)(ancestor)}`)), [
+                t.memberExpression(t.identifier('scope'), t.identifier(fkField)),
+            ])),
         ])));
     }
     statements.push(t.returnStatement(t.memberExpression(t.identifier(keysName), t.identifier('all'))));
@@ -151,7 +157,7 @@ function buildScopedListsProperty(keysName, scopeTypeName) {
     const scopeParam = (0, babel_ast_1.typedParam)('scope', t.tsTypeReference(t.identifier(scopeTypeName)), true);
     const arrowFn = t.arrowFunctionExpression([scopeParam], (0, babel_ast_1.constArray)([
         t.spreadElement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('scoped')), [t.identifier('scope')])),
-        t.stringLiteral('list')
+        t.stringLiteral('list'),
     ]));
     const prop = t.objectProperty(t.identifier('lists'), arrowFn);
     (0, babel_ast_1.addJSDocComment)(prop, ['List query keys (optionally scoped)']);
@@ -165,7 +171,7 @@ function buildScopedListProperty(keysName, scopeTypeName) {
     const scopeParam = (0, babel_ast_1.typedParam)('scope', t.tsTypeReference(t.identifier(scopeTypeName)), true);
     const arrowFn = t.arrowFunctionExpression([variablesParam, scopeParam], (0, babel_ast_1.constArray)([
         t.spreadElement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('lists')), [t.identifier('scope')])),
-        t.identifier('variables')
+        t.identifier('variables'),
     ]));
     const prop = t.objectProperty(t.identifier('list'), arrowFn);
     (0, babel_ast_1.addJSDocComment)(prop, ['List query key with variables']);
@@ -178,7 +184,7 @@ function buildScopedDetailsProperty(keysName, scopeTypeName) {
     const scopeParam = (0, babel_ast_1.typedParam)('scope', t.tsTypeReference(t.identifier(scopeTypeName)), true);
     const arrowFn = t.arrowFunctionExpression([scopeParam], (0, babel_ast_1.constArray)([
         t.spreadElement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('scoped')), [t.identifier('scope')])),
-        t.stringLiteral('detail')
+        t.stringLiteral('detail'),
     ]));
     const prop = t.objectProperty(t.identifier('details'), arrowFn);
     (0, babel_ast_1.addJSDocComment)(prop, ['Detail query keys (optionally scoped)']);
@@ -192,7 +198,7 @@ function buildScopedDetailProperty(keysName, scopeTypeName) {
     const scopeParam = (0, babel_ast_1.typedParam)('scope', t.tsTypeReference(t.identifier(scopeTypeName)), true);
     const arrowFn = t.arrowFunctionExpression([idParam, scopeParam], (0, babel_ast_1.constArray)([
         t.spreadElement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('details')), [t.identifier('scope')])),
-        t.identifier('id')
+        t.identifier('id'),
     ]));
     const prop = t.objectProperty(t.identifier('detail'), arrowFn);
     (0, babel_ast_1.addJSDocComment)(prop, ['Detail query key for specific item']);
@@ -204,7 +210,7 @@ function buildScopedDetailProperty(keysName, scopeTypeName) {
 function buildSimpleListsProperty(keysName) {
     const arrowFn = t.arrowFunctionExpression([], (0, babel_ast_1.constArray)([
         t.spreadElement(t.memberExpression(t.identifier(keysName), t.identifier('all'))),
-        t.stringLiteral('list')
+        t.stringLiteral('list'),
     ]));
     const prop = t.objectProperty(t.identifier('lists'), arrowFn);
     (0, babel_ast_1.addJSDocComment)(prop, ['List query keys']);
@@ -217,7 +223,7 @@ function buildSimpleListProperty(keysName) {
     const variablesParam = (0, babel_ast_1.typedParam)('variables', t.tsTypeReference(t.identifier('object')), true);
     const arrowFn = t.arrowFunctionExpression([variablesParam], (0, babel_ast_1.constArray)([
         t.spreadElement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('lists')), [])),
-        t.identifier('variables')
+        t.identifier('variables'),
     ]));
     const prop = t.objectProperty(t.identifier('list'), arrowFn);
     (0, babel_ast_1.addJSDocComment)(prop, ['List query key with variables']);
@@ -229,7 +235,7 @@ function buildSimpleListProperty(keysName) {
 function buildSimpleDetailsProperty(keysName) {
     const arrowFn = t.arrowFunctionExpression([], (0, babel_ast_1.constArray)([
         t.spreadElement(t.memberExpression(t.identifier(keysName), t.identifier('all'))),
-        t.stringLiteral('detail')
+        t.stringLiteral('detail'),
     ]));
     const prop = t.objectProperty(t.identifier('details'), arrowFn);
     (0, babel_ast_1.addJSDocComment)(prop, ['Detail query keys']);
@@ -242,7 +248,7 @@ function buildSimpleDetailProperty(keysName) {
     const idParam = (0, babel_ast_1.typedParam)('id', t.tsUnionType([t.tsStringKeyword(), t.tsNumberKeyword()]));
     const arrowFn = t.arrowFunctionExpression([idParam], (0, babel_ast_1.constArray)([
         t.spreadElement(t.callExpression(t.memberExpression(t.identifier(keysName), t.identifier('details')), [])),
-        t.identifier('id')
+        t.identifier('id'),
     ]));
     const prop = t.objectProperty(t.identifier('detail'), arrowFn);
     (0, babel_ast_1.addJSDocComment)(prop, ['Detail query key for specific item']);
@@ -283,7 +289,7 @@ function generateEntityKeysDeclaration(table, relationships, generateScopedKeys)
         properties.push(buildSimpleDetailProperty(keysName));
     }
     return t.exportNamedDeclaration(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier(keysName), (0, babel_ast_1.asConst)(t.objectExpression(properties)))
+        t.variableDeclarator(t.identifier(keysName), (0, babel_ast_1.asConst)(t.objectExpression(properties))),
     ]));
 }
 /**
@@ -310,7 +316,7 @@ function generateCustomQueryKeysDeclaration(operations) {
         properties.push(prop);
     }
     return t.exportNamedDeclaration(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier('customQueryKeys'), (0, babel_ast_1.asConst)(t.objectExpression(properties)))
+        t.variableDeclarator(t.identifier('customQueryKeys'), (0, babel_ast_1.asConst)(t.objectExpression(properties))),
     ]));
 }
 /**
@@ -327,7 +333,7 @@ function generateUnifiedStoreDeclaration(tables, hasCustomQueries) {
         properties.push(t.objectProperty(t.identifier('custom'), t.identifier('customQueryKeys')));
     }
     const decl = t.exportNamedDeclaration(t.variableDeclaration('const', [
-        t.variableDeclarator(t.identifier('queryKeys'), (0, babel_ast_1.asConst)(t.objectExpression(properties)))
+        t.variableDeclarator(t.identifier('queryKeys'), (0, babel_ast_1.asConst)(t.objectExpression(properties))),
     ]));
     (0, babel_ast_1.addJSDocComment)(decl, [
         'Unified query key store',
@@ -384,7 +390,9 @@ function generateQueryKeysFile(options) {
     statements.push(generateUnifiedStoreDeclaration(tables, queryOperations.length > 0));
     // Generate QueryKeyScope type
     const scopeTypeDecl = t.exportNamedDeclaration(t.tsTypeAliasDeclaration(t.identifier('QueryKeyScope'), null, (0, babel_ast_1.keyofTypeof)('queryKeys')));
-    (0, babel_ast_1.addJSDocComment)(scopeTypeDecl, ['Type representing all available query key scopes']);
+    (0, babel_ast_1.addJSDocComment)(scopeTypeDecl, [
+        'Type representing all available query key scopes',
+    ]);
     statements.push(scopeTypeDecl);
     // Generate code from AST
     const code = (0, babel_ast_1.generateCode)(statements);
@@ -407,7 +415,7 @@ ${description}
 `;
     // Add scope types section if present
     if (generateScopedKeys && Object.keys(relationships).length > 0) {
-        const hasScopes = tables.some(table => {
+        const hasScopes = tables.some((table) => {
             const { typeName } = (0, utils_1.getTableNames)(table);
             return !!relationships[typeName.toLowerCase()];
         });
@@ -428,7 +436,9 @@ ${description}
     for (let i = 0; i < codeLines.length; i++) {
         const line = codeLines[i];
         // Detect transition from scope types to entity keys
-        if (inScopeTypes && line.startsWith('export const') && line.includes('Keys =')) {
+        if (inScopeTypes &&
+            line.startsWith('export const') &&
+            line.includes('Keys =')) {
             content += `// ============================================================================
 // Entity Query Keys
 // ============================================================================
@@ -438,7 +448,8 @@ ${description}
             addedEntitySection = true;
         }
         // Detect custom query keys section
-        if (!addedCustomSection && line.startsWith('export const customQueryKeys')) {
+        if (!addedCustomSection &&
+            line.startsWith('export const customQueryKeys')) {
             content += `
 // ============================================================================
 // Custom Query Keys
@@ -463,11 +474,14 @@ ${description}
     if (!addedEntitySection && !inScopeTypes) {
         const firstExportIndex = content.indexOf('\nexport const');
         if (firstExportIndex !== -1) {
-            content = content.slice(0, firstExportIndex) + `
+            content =
+                content.slice(0, firstExportIndex) +
+                    `
 // ============================================================================
 // Entity Query Keys
 // ============================================================================
-` + content.slice(firstExportIndex);
+` +
+                    content.slice(firstExportIndex);
         }
     }
     return {

package/core/codegen/scalars.js

@@ -68,7 +68,9 @@ exports.BASE_FILTER_TYPE_NAMES = new Set([
     ...Array.from(LIST_FILTER_SCALARS).map((s) => `${s}ListFilter`),
 ]);
 function scalarToTsType(scalarName, options = {}) {
-    return options.overrides?.[scalarName] ?? exports.SCALAR_TS_MAP[scalarName] ?? (options.unknownScalar === 'unknown' ? 'unknown' : scalarName);
+    return (options.overrides?.[scalarName] ??
+        exports.SCALAR_TS_MAP[scalarName] ??
+        (options.unknownScalar === 'unknown' ? 'unknown' : scalarName));
 }
 /** Get the filter type for a scalar (handles both scalar and array types) */
 function scalarToFilterType(scalarName, isArray = false) {

package/core/codegen/schema-types-generator.d.ts

@@ -11,8 +11,8 @@
  *
  * Uses Babel AST for robust code generation.
  */
-import type { TypeRegistry } from '../../types/schema';
 import * as t from '@babel/types';
+import type { TypeRegistry } from '../../types/schema';
 export interface GeneratedSchemaTypesFile {
     fileName: string;
     content: string;

package/core/codegen/schema-types-generator.js

@@ -34,10 +34,23 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateSchemaTypesFile = generateSchemaTypesFile;
+/**
+ * Schema types generator for React Query hooks (non-ORM mode)
+ *
+ * Generates TypeScript interfaces for:
+ * 1. INPUT_OBJECT types (e.g., BootstrapUserInput, LoginInput)
+ * 2. Payload OBJECT types (e.g., BootstrapUserPayload, LoginPayload)
+ * 3. ENUM types (e.g., FieldCategory, TableCategory)
+ *
+ * These types are referenced by custom mutation/query hooks but not generated
+ * elsewhere in non-ORM mode.
+ *
+ * Uses Babel AST for robust code generation.
+ */
 const t = __importStar(require("@babel/types"));
 const babel_ast_1 = require("./babel-ast");
-const type_resolver_1 = require("./type-resolver");
 const scalars_1 = require("./scalars");
+const type_resolver_1 = require("./type-resolver");
 const utils_1 = require("./utils");
 const SKIP_TYPES = new Set([
     ...scalars_1.SCALAR_NAMES,
@@ -267,7 +280,9 @@ function generateSchemaTypesFile(options) {
     allStatements.push(...inputResult.statements);
     allStatements.push(...payloadResult.statements);
     const code = (0, babel_ast_1.generateCode)(allStatements);
-    const content = (0, utils_1.getGeneratedFileHeader)('GraphQL schema types for custom operations') + '\n\n' + code;
+    const content = (0, utils_1.getGeneratedFileHeader)('GraphQL schema types for custom operations') +
+        '\n\n' +
+        code;
     return {
         fileName: 'schema-types.ts',
         content,

package/core/codegen/select-helpers.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Shared helpers for select type resolution in custom operations
+ *
+ * Used by custom-queries.ts, custom-mutations.ts, and orm/custom-ops-generator.ts
+ */
+import type { CleanArgument } from '../../types/schema';
+/**
+ * Types that don't need Select types (scalars + root query/mutation types)
+ */
+export declare const NON_SELECT_TYPES: Set<string>;
+/**
+ * Get the Select type name for a return type.
+ * Returns null for scalar types, Connection types, and root types.
+ */
+export declare function getSelectTypeName(returnType: CleanArgument['type']): string | null;
+/**
+ * Wrap a type reference in InferSelectResult, handling NON_NULL and LIST wrappers.
+ */
+export declare function wrapInferSelectResult(typeRef: CleanArgument['type'], payloadTypeName: string, selectType?: string): string;

package/core/codegen/select-helpers.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NON_SELECT_TYPES = void 0;
+exports.getSelectTypeName = getSelectTypeName;
+exports.wrapInferSelectResult = wrapInferSelectResult;
+const scalars_1 = require("./scalars");
+const type_resolver_1 = require("./type-resolver");
+/**
+ * Types that don't need Select types (scalars + root query/mutation types)
+ */
+exports.NON_SELECT_TYPES = new Set([
+    ...scalars_1.SCALAR_NAMES,
+    'Query',
+    'Mutation',
+]);
+/**
+ * Get the Select type name for a return type.
+ * Returns null for scalar types, Connection types, and root types.
+ */
+function getSelectTypeName(returnType) {
+    const baseName = (0, type_resolver_1.getTypeBaseName)(returnType);
+    if (baseName &&
+        !exports.NON_SELECT_TYPES.has(baseName) &&
+        !baseName.endsWith('Connection')) {
+        return `${baseName}Select`;
+    }
+    return null;
+}
+/**
+ * Wrap a type reference in InferSelectResult, handling NON_NULL and LIST wrappers.
+ */
+function wrapInferSelectResult(typeRef, payloadTypeName, selectType = 'S') {
+    if (typeRef.kind === 'NON_NULL' && typeRef.ofType) {
+        return wrapInferSelectResult(typeRef.ofType, payloadTypeName, selectType);
+    }
+    if (typeRef.kind === 'LIST' && typeRef.ofType) {
+        return `${wrapInferSelectResult(typeRef.ofType, payloadTypeName, selectType)}[]`;
+    }
+    return `InferSelectResult<${payloadTypeName}, ${selectType}>`;
+}

package/core/codegen/selection.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Generate selection.ts content - shared selection types + runtime mappers
+ */
+export declare function generateSelectionFile(): string;

package/core/codegen/selection.js

@@ -0,0 +1,65 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateSelectionFile = generateSelectionFile;
+/**
+ * Selection helper generator for React Query hooks
+ *
+ * Uses template-copy pattern: reads hooks-selection.ts from templates/
+ * and writes it to the output directory with a generated file header.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const utils_1 = require("./utils");
+function findTemplateFile(templateName) {
+    const templatePath = path.join(__dirname, 'templates', templateName);
+    if (fs.existsSync(templatePath)) {
+        return templatePath;
+    }
+    throw new Error(`Could not find template file: ${templateName}. Searched in: ${templatePath}`);
+}
+function readTemplateFile(templateName, description) {
+    const templatePath = findTemplateFile(templateName);
+    let content = fs.readFileSync(templatePath, 'utf-8');
+    const headerPattern = /\/\*\*[\s\S]*?\* NOTE: This file is read at codegen time and written to output\.[\s\S]*?\*\/\n*/;
+    content = content.replace(headerPattern, (0, utils_1.getGeneratedFileHeader)(description) + '\n');
+    return content;
+}
+/**
+ * Generate selection.ts content - shared selection types + runtime mappers
+ */
+function generateSelectionFile() {
+    return readTemplateFile('hooks-selection.ts', 'Selection helpers for React Query hooks');
+}

package/core/codegen/shared/index.d.ts

@@ -1,18 +1,5 @@
-/**
- * Shared types generator
- *
- * Generates shared TypeScript types that can be imported by both
- * React Query SDK and ORM client outputs.
- *
- * Output structure:
- * shared/
- *   index.ts          - Barrel export
- *   types.ts          - Entity interfaces
- *   schema-types.ts   - Enums, input types, payload types
- *   filters.ts        - Filter types (StringFilter, IntFilter, etc.)
- */
-import type { CleanTable, CleanOperation, TypeRegistry } from '../../../types/schema';
 import type { GraphQLSDKConfigTarget } from '../../../types/config';
+import type { CleanOperation, CleanTable, TypeRegistry } from '../../../types/schema';
 export interface GeneratedFile {
     path: string;
     content: string;
@@ -35,5 +22,5 @@ export interface GenerateSharedResult {
  * Generate shared types that can be imported by both React Query SDK and ORM client
  */
 export declare function generateSharedTypes(options: GenerateSharedOptions): GenerateSharedResult;
-export { generateTypesFile } from '../types';
 export { generateSchemaTypesFile } from '../schema-types-generator';
+export { generateTypesFile } from '../types';

package/core/codegen/shared/index.js

@@ -33,12 +33,25 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateSchemaTypesFile = exports.generateTypesFile = void 0;
+exports.generateTypesFile = exports.generateSchemaTypesFile = void 0;
 exports.generateSharedTypes = generateSharedTypes;
+/**
+ * Shared types generator
+ *
+ * Generates shared TypeScript types that can be imported by both
+ * React Query SDK and ORM client outputs.
+ *
+ * Output structure:
+ * shared/
+ *   index.ts          - Barrel export
+ *   types.ts          - Entity interfaces
+ *   schema-types.ts   - Enums, input types, payload types
+ *   filters.ts        - Filter types (StringFilter, IntFilter, etc.)
+ */
 const t = __importStar(require("@babel/types"));
 const babel_ast_1 = require("../babel-ast");
-const types_1 = require("../types");
 const schema_types_generator_1 = require("../schema-types-generator");
+const types_1 = require("../types");
 const utils_1 = require("../utils");
 /**
  * Helper to create export * from './module' statement
@@ -112,7 +125,7 @@ function generateSharedBarrel(hasSchemaTypes) {
     }
     return (0, babel_ast_1.generateCode)(statements);
 }
-var types_2 = require("../types");
-Object.defineProperty(exports, "generateTypesFile", { enumerable: true, get: function () { return types_2.generateTypesFile; } });
 var schema_types_generator_2 = require("../schema-types-generator");
 Object.defineProperty(exports, "generateSchemaTypesFile", { enumerable: true, get: function () { return schema_types_generator_2.generateSchemaTypesFile; } });
+var types_2 = require("../types");
+Object.defineProperty(exports, "generateTypesFile", { enumerable: true, get: function () { return types_2.generateTypesFile; } });

package/core/codegen/templates/hooks-client.ts

@@ -0,0 +1,49 @@
+/**
+ * ORM client wrapper for React Query hooks
+ *
+ * This is the RUNTIME code that gets copied to generated output.
+ * Provides configure/getClient singleton for React Query hooks to access the ORM.
+ *
+ * NOTE: This file is read at codegen time and written to output.
+ * Any changes here will affect all generated hook clients.
+ */
+
+import { createClient } from '../orm';
+import type { OrmClientConfig } from '../orm/client';
+
+export type { OrmClientConfig } from '../orm/client';
+export type { GraphQLAdapter, GraphQLError, QueryResult } from '../orm/client';
+export { GraphQLRequestError } from '../orm/client';
+
+type OrmClientInstance = ReturnType<typeof createClient>;
+let client: OrmClientInstance | null = null;
+
+/**
+ * Configure the ORM client for React Query hooks
+ *
+ * @example
+ * ```ts
+ * import { configure } from './generated/hooks';
+ *
+ * configure({
+ *   endpoint: 'https://api.example.com/graphql',
+ *   headers: { Authorization: 'Bearer <token>' },
+ * });
+ * ```
+ */
+export function configure(config: OrmClientConfig): void {
+  client = createClient(config);
+}
+
+/**
+ * Get the configured ORM client instance
+ * @throws Error if configure() has not been called
+ */
+export function getClient(): OrmClientInstance {
+  if (!client) {
+    throw new Error(
+      'ORM client not configured. Call configure() before using hooks.',
+    );
+  }
+  return client;
+}

package/core/codegen/templates/hooks-selection.ts

@@ -0,0 +1,58 @@
+/**
+ * Selection helpers for React Query hooks
+ *
+ * This is the RUNTIME code that gets copied to generated output.
+ * Provides selection types and runtime mappers between hook-facing
+ * `selection` params and ORM-facing args (`select`, `where`, `orderBy`, etc.).
+ *
+ * NOTE: This file is read at codegen time and written to output.
+ * Any changes here will affect all generated hook selection helpers.
+ */
+
+export interface SelectionConfig<TFields> {
+  fields: TFields;
+}
+
+export interface ListSelectionConfig<
+  TFields,
+  TWhere,
+  TOrderBy,
+> extends SelectionConfig<TFields> {
+  where?: TWhere;
+  orderBy?: TOrderBy[];
+  first?: number;
+  last?: number;
+  after?: string;
+  before?: string;
+  offset?: number;
+}
+
+export function buildSelectionArgs<TFields>(
+  selection: SelectionConfig<TFields>,
+): { select: TFields } {
+  return { select: selection.fields };
+}
+
+export function buildListSelectionArgs<TFields, TWhere, TOrderBy>(
+  selection: ListSelectionConfig<TFields, TWhere, TOrderBy>,
+): {
+  select: TFields;
+  where?: TWhere;
+  orderBy?: TOrderBy[];
+  first?: number;
+  last?: number;
+  after?: string;
+  before?: string;
+  offset?: number;
+} {
+  return {
+    select: selection.fields,
+    where: selection.where,
+    orderBy: selection.orderBy,
+    first: selection.first,
+    last: selection.last,
+    after: selection.after,
+    before: selection.before,
+    offset: selection.offset,
+  };
+}

package/core/codegen/templates/orm-client.ts

@@ -29,14 +29,14 @@ export class FetchAdapter implements GraphQLAdapter {
 
   constructor(
     private endpoint: string,
-    headers?: Record<string, string>
+    headers?: Record<string, string>,
   ) {
     this.headers = headers ?? {};
   }
 
   async execute<T>(
     document: string,
-    variables?: Record<string, unknown>
+    variables?: Record<string, unknown>,
   ): Promise<QueryResult<T>> {
     const response = await fetch(this.endpoint, {
       method: 'POST',
@@ -55,7 +55,9 @@ export class FetchAdapter implements GraphQLAdapter {
       return {
         ok: false,
         data: null,
-        errors: [{ message: `HTTP ${response.status}: ${response.statusText}` }],
+        errors: [
+          { message: `HTTP ${response.status}: ${response.statusText}` },
+        ],
       };
     }
 
@@ -108,7 +110,7 @@ export interface OrmClientConfig {
 export class GraphQLRequestError extends Error {
   constructor(
     public readonly errors: GraphQLError[],
-    public readonly data: unknown = null
+    public readonly data: unknown = null,
   ) {
     const messages = errors.map((e) => e.message).join('; ');
     super(`GraphQL Error: ${messages}`);
@@ -126,14 +128,14 @@ export class OrmClient {
       this.adapter = new FetchAdapter(config.endpoint, config.headers);
     } else {
       throw new Error(
-        'OrmClientConfig requires either an endpoint or a custom adapter'
+        'OrmClientConfig requires either an endpoint or a custom adapter',
       );
     }
   }
 
   async execute<T>(
     document: string,
-    variables?: Record<string, unknown>
+    variables?: Record<string, unknown>,
   ): Promise<QueryResult<T>> {
     return this.adapter.execute<T>(document, variables);
   }