@constructive-io/graphql-codegen 2.20.1 → 2.22.0

package/cli/codegen/orm/model-generator.js

@@ -11,13 +11,15 @@ function generateModelFile(table, _useSharedTypes) {
     const project = (0, ts_ast_1.createProject)();
     const { typeName, singularName, pluralName } = (0, utils_1.getTableNames)(table);
     const modelName = `${typeName}Model`;
-    const fileName = `${(0, utils_1.lcFirst)(typeName)}.ts`;
+    // Avoid "index.ts" which clashes with barrel file
+    const baseFileName = (0, utils_1.lcFirst)(typeName);
+    const fileName = baseFileName === 'index' ? `${baseFileName}Model.ts` : `${baseFileName}.ts`;
     const entityLower = singularName;
-    // Type names for this entity
+    // Type names for this entity - use inflection from table metadata
     const selectTypeName = `${typeName}Select`;
     const relationTypeName = `${typeName}WithRelations`;
-    const whereTypeName = `${typeName}Filter`;
-    const orderByTypeName = `${typeName}sOrderBy`; // PostGraphile uses plural
+    const whereTypeName = (0, utils_1.getFilterTypeName)(table);
+    const orderByTypeName = (0, utils_1.getOrderByTypeName)(table);
     const createInputTypeName = `Create${typeName}Input`;
     const updateInputTypeName = `Update${typeName}Input`;
     const deleteInputTypeName = `Delete${typeName}Input`;

package/cli/codegen/queries.d.ts

@@ -11,15 +11,19 @@ export interface GeneratedQueryFile {
     fileName: string;
     content: string;
 }
+export interface QueryGeneratorOptions {
+    /** Whether to generate React Query hooks (default: true for backwards compatibility) */
+    reactQueryEnabled?: boolean;
+}
 /**
  * Generate list query hook file content using AST
  */
-export declare function generateListQueryHook(table: CleanTable): GeneratedQueryFile;
+export declare function generateListQueryHook(table: CleanTable, options?: QueryGeneratorOptions): GeneratedQueryFile;
 /**
  * Generate single item query hook file content using AST
  */
-export declare function generateSingleQueryHook(table: CleanTable): GeneratedQueryFile;
+export declare function generateSingleQueryHook(table: CleanTable, options?: QueryGeneratorOptions): GeneratedQueryFile;
 /**
  * Generate all query hook files for all tables
  */
-export declare function generateAllQueryHooks(tables: CleanTable[]): GeneratedQueryFile[];
+export declare function generateAllQueryHooks(tables: CleanTable[], options?: QueryGeneratorOptions): GeneratedQueryFile[];

package/cli/codegen/queries.js

@@ -12,7 +12,8 @@ const utils_1 = require("./utils");
 /**
  * Generate list query hook file content using AST
  */
-function generateListQueryHook(table) {
+function generateListQueryHook(table, options = {}) {
+    const { reactQueryEnabled = true } = options;
     const project = (0, ts_ast_1.createProject)();
     const { typeName, pluralName } = (0, utils_1.getTableNames)(table);
     const hookName = (0, utils_1.getListQueryHookName)(table);
@@ -25,32 +26,36 @@ function generateListQueryHook(table) {
     const queryDocument = (0, gql_ast_1.printGraphQL)(queryAST);
     const sourceFile = (0, ts_ast_1.createSourceFile)(project, (0, utils_1.getListQueryFileName)(table));
     // Add file header as leading comment
-    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(`List query hook for ${typeName}`) + '\n\n');
+    const headerText = reactQueryEnabled
+        ? `List query hook for ${typeName}`
+        : `List query functions for ${typeName}`;
+    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(headerText) + '\n\n');
     // Collect all filter types used by this table's fields
     const filterTypesUsed = new Set();
     for (const field of scalarFields) {
-        const filterType = (0, utils_1.getScalarFilterType)(field.type.gqlType);
+        const filterType = (0, utils_1.getScalarFilterType)(field.type.gqlType, field.type.isArray);
         if (filterType) {
             filterTypesUsed.add(filterType);
         }
     }
-    // Add imports
-    sourceFile.addImportDeclarations([
-        (0, ts_ast_1.createImport)({
+    // Add imports - conditionally include React Query imports
+    const imports = [];
+    if (reactQueryEnabled) {
+        imports.push((0, ts_ast_1.createImport)({
             moduleSpecifier: '@tanstack/react-query',
             namedImports: ['useQuery'],
             typeOnlyNamedImports: ['UseQueryOptions', 'QueryClient'],
-        }),
-        (0, ts_ast_1.createImport)({
-            moduleSpecifier: '../client',
-            namedImports: ['execute'],
-            typeOnlyNamedImports: ['ExecuteOptions'],
-        }),
-        (0, ts_ast_1.createImport)({
-            moduleSpecifier: '../types',
-            typeOnlyNamedImports: [typeName, ...Array.from(filterTypesUsed)],
-        }),
-    ]);
+        }));
+    }
+    imports.push((0, ts_ast_1.createImport)({
+        moduleSpecifier: '../client',
+        namedImports: ['execute'],
+        typeOnlyNamedImports: ['ExecuteOptions'],
+    }), (0, ts_ast_1.createImport)({
+        moduleSpecifier: '../types',
+        typeOnlyNamedImports: [typeName, ...Array.from(filterTypesUsed)],
+    }));
+    sourceFile.addImportDeclarations(imports);
     // Re-export entity type
     sourceFile.addStatements(`\n// Re-export entity type for convenience\nexport type { ${typeName} };\n`);
     // Add section comment
@@ -66,12 +71,14 @@ function generateListQueryHook(table) {
     // Generate filter interface
     const fieldFilters = scalarFields
         .map((field) => {
-        const filterType = (0, utils_1.getScalarFilterType)(field.type.gqlType);
+        const filterType = (0, utils_1.getScalarFilterType)(field.type.gqlType, field.type.isArray);
         return filterType ? { fieldName: field.name, filterType } : null;
     })
         .filter((f) => f !== null);
-    sourceFile.addInterface((0, ts_ast_1.createFilterInterface)(filterTypeName, fieldFilters));
+    // Note: Not exported to avoid conflicts with schema-types
+    sourceFile.addInterface((0, ts_ast_1.createFilterInterface)(filterTypeName, fieldFilters, { isExported: false }));
     // Generate OrderBy type
+    // Note: Not exported to avoid conflicts with schema-types
     const orderByValues = [
         ...scalarFields.flatMap((f) => [
             `${(0, utils_1.toScreamingSnake)(f.name)}_ASC`,
@@ -81,7 +88,7 @@ function generateListQueryHook(table) {
         'PRIMARY_KEY_ASC',
         'PRIMARY_KEY_DESC',
     ];
-    sourceFile.addTypeAlias((0, ts_ast_1.createTypeAlias)(orderByTypeName, (0, ts_ast_1.createUnionType)(orderByValues)));
+    sourceFile.addTypeAlias((0, ts_ast_1.createTypeAlias)(orderByTypeName, (0, ts_ast_1.createUnionType)(orderByValues), { isExported: false }));
     // Variables interface
     const variablesProps = [
         { name: 'first', type: 'number', optional: true },
@@ -114,27 +121,28 @@ function generateListQueryHook(table) {
     // Query key factory
     sourceFile.addVariableStatement((0, ts_ast_1.createConst)(`${queryName}QueryKey`, `(variables?: ${(0, utils_1.ucFirst)(pluralName)}QueryVariables) =>
   ['${typeName.toLowerCase()}', 'list', variables] as const`));
-    // Add section comment
-    sourceFile.addStatements('\n// ============================================================================');
-    sourceFile.addStatements('// Hook');
-    sourceFile.addStatements('// ============================================================================\n');
-    // Hook function
-    sourceFile.addFunction({
-        name: hookName,
-        isExported: true,
-        parameters: [
-            {
-                name: 'variables',
-                type: `${(0, utils_1.ucFirst)(pluralName)}QueryVariables`,
-                hasQuestionToken: true,
-            },
-            {
-                name: 'options',
-                type: `Omit<UseQueryOptions<${(0, utils_1.ucFirst)(pluralName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`,
-                hasQuestionToken: true,
-            },
-        ],
-        statements: `return useQuery({
+    // Add React Query hook section (only if enabled)
+    if (reactQueryEnabled) {
+        sourceFile.addStatements('\n// ============================================================================');
+        sourceFile.addStatements('// Hook');
+        sourceFile.addStatements('// ============================================================================\n');
+        // Hook function
+        sourceFile.addFunction({
+            name: hookName,
+            isExported: true,
+            parameters: [
+                {
+                    name: 'variables',
+                    type: `${(0, utils_1.ucFirst)(pluralName)}QueryVariables`,
+                    hasQuestionToken: true,
+                },
+                {
+                    name: 'options',
+                    type: `Omit<UseQueryOptions<${(0, utils_1.ucFirst)(pluralName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`,
+                    hasQuestionToken: true,
+                },
+            ],
+            statements: `return useQuery({
     queryKey: ${queryName}QueryKey(variables),
     queryFn: () => execute<${(0, utils_1.ucFirst)(pluralName)}QueryResult, ${(0, utils_1.ucFirst)(pluralName)}QueryVariables>(
       ${queryName}QueryDocument,
@@ -142,9 +150,9 @@ function generateListQueryHook(table) {
     ),
     ...options,
   });`,
-        docs: [
-            {
-                description: `Query hook for fetching ${typeName} list
+            docs: [
+                {
+                    description: `Query hook for fetching ${typeName} list
 
 @example
 \`\`\`tsx
@@ -154,9 +162,10 @@ const { data, isLoading } = ${hookName}({
   orderBy: ['CREATED_AT_DESC'],
 });
 \`\`\``,
-            },
-        ],
-    });
+                },
+            ],
+        });
+    }
     // Add section comment for standalone functions
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Standalone Functions (non-React)');
@@ -202,29 +211,30 @@ const data = await queryClient.fetchQuery({
             },
         ],
     });
-    // Prefetch function (for SSR/QueryClient)
-    sourceFile.addFunction({
-        name: `prefetch${(0, utils_1.ucFirst)(pluralName)}Query`,
-        isExported: true,
-        isAsync: true,
-        parameters: [
-            {
-                name: 'queryClient',
-                type: 'QueryClient',
-            },
-            {
-                name: 'variables',
-                type: `${(0, utils_1.ucFirst)(pluralName)}QueryVariables`,
-                hasQuestionToken: true,
-            },
-            {
-                name: 'options',
-                type: 'ExecuteOptions',
-                hasQuestionToken: true,
-            },
-        ],
-        returnType: 'Promise<void>',
-        statements: `await queryClient.prefetchQuery({
+    // Prefetch function (for SSR/QueryClient) - only if React Query is enabled
+    if (reactQueryEnabled) {
+        sourceFile.addFunction({
+            name: `prefetch${(0, utils_1.ucFirst)(pluralName)}Query`,
+            isExported: true,
+            isAsync: true,
+            parameters: [
+                {
+                    name: 'queryClient',
+                    type: 'QueryClient',
+                },
+                {
+                    name: 'variables',
+                    type: `${(0, utils_1.ucFirst)(pluralName)}QueryVariables`,
+                    hasQuestionToken: true,
+                },
+                {
+                    name: 'options',
+                    type: 'ExecuteOptions',
+                    hasQuestionToken: true,
+                },
+            ],
+            returnType: 'Promise<void>',
+            statements: `await queryClient.prefetchQuery({
     queryKey: ${queryName}QueryKey(variables),
     queryFn: () => execute<${(0, utils_1.ucFirst)(pluralName)}QueryResult, ${(0, utils_1.ucFirst)(pluralName)}QueryVariables>(
       ${queryName}QueryDocument,
@@ -232,17 +242,18 @@ const data = await queryClient.fetchQuery({
       options
     ),
   });`,
-        docs: [
-            {
-                description: `Prefetch ${typeName} list for SSR or cache warming
+            docs: [
+                {
+                    description: `Prefetch ${typeName} list for SSR or cache warming
 
 @example
 \`\`\`ts
 await prefetch${(0, utils_1.ucFirst)(pluralName)}Query(queryClient, { first: 10 });
 \`\`\``,
-            },
-        ],
-    });
+                },
+            ],
+        });
+    }
     return {
         fileName: (0, utils_1.getListQueryFileName)(table),
         content: (0, ts_ast_1.getFormattedOutput)(sourceFile),
@@ -254,34 +265,46 @@ await prefetch${(0, utils_1.ucFirst)(pluralName)}Query(queryClient, { first: 10
 /**
  * Generate single item query hook file content using AST
  */
-function generateSingleQueryHook(table) {
+function generateSingleQueryHook(table, options = {}) {
+    const { reactQueryEnabled = true } = options;
     const project = (0, ts_ast_1.createProject)();
     const { typeName, singularName } = (0, utils_1.getTableNames)(table);
     const hookName = (0, utils_1.getSingleQueryHookName)(table);
     const queryName = (0, utils_1.getSingleRowQueryName)(table);
+    // Get primary key info dynamically from table constraints
+    const pkFields = (0, utils_1.getPrimaryKeyInfo)(table);
+    // For simplicity, use first PK field (most common case)
+    // Composite PKs would need more complex handling
+    const pkField = pkFields[0];
+    const pkName = pkField.name;
+    const pkTsType = pkField.tsType;
     // Generate GraphQL document via AST
     const queryAST = (0, gql_ast_1.buildSingleQueryAST)({ table });
     const queryDocument = (0, gql_ast_1.printGraphQL)(queryAST);
     const sourceFile = (0, ts_ast_1.createSourceFile)(project, (0, utils_1.getSingleQueryFileName)(table));
     // Add file header
-    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(`Single item query hook for ${typeName}`) + '\n\n');
-    // Add imports
-    sourceFile.addImportDeclarations([
-        (0, ts_ast_1.createImport)({
+    const headerText = reactQueryEnabled
+        ? `Single item query hook for ${typeName}`
+        : `Single item query functions for ${typeName}`;
+    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(headerText) + '\n\n');
+    // Add imports - conditionally include React Query imports
+    const imports = [];
+    if (reactQueryEnabled) {
+        imports.push((0, ts_ast_1.createImport)({
             moduleSpecifier: '@tanstack/react-query',
             namedImports: ['useQuery'],
             typeOnlyNamedImports: ['UseQueryOptions', 'QueryClient'],
-        }),
-        (0, ts_ast_1.createImport)({
-            moduleSpecifier: '../client',
-            namedImports: ['execute'],
-            typeOnlyNamedImports: ['ExecuteOptions'],
-        }),
-        (0, ts_ast_1.createImport)({
-            moduleSpecifier: '../types',
-            typeOnlyNamedImports: [typeName],
-        }),
-    ]);
+        }));
+    }
+    imports.push((0, ts_ast_1.createImport)({
+        moduleSpecifier: '../client',
+        namedImports: ['execute'],
+        typeOnlyNamedImports: ['ExecuteOptions'],
+    }), (0, ts_ast_1.createImport)({
+        moduleSpecifier: '../types',
+        typeOnlyNamedImports: [typeName],
+    }));
+    sourceFile.addImportDeclarations(imports);
     // Re-export entity type
     sourceFile.addStatements(`\n// Re-export entity type for convenience\nexport type { ${typeName} };\n`);
     // Add section comment
@@ -294,9 +317,9 @@ function generateSingleQueryHook(table) {
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Types');
     sourceFile.addStatements('// ============================================================================\n');
-    // Variables interface
+    // Variables interface - use dynamic PK field name and type
     sourceFile.addInterface((0, ts_ast_1.createInterface)(`${(0, utils_1.ucFirst)(singularName)}QueryVariables`, [
-        { name: 'id', type: 'string' },
+        { name: pkName, type: pkTsType },
     ]));
     // Result interface
     sourceFile.addInterface((0, ts_ast_1.createInterface)(`${(0, utils_1.ucFirst)(singularName)}QueryResult`, [
@@ -306,60 +329,62 @@ function generateSingleQueryHook(table) {
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Query Key');
     sourceFile.addStatements('// ============================================================================\n');
-    // Query key factory
-    sourceFile.addVariableStatement((0, ts_ast_1.createConst)(`${queryName}QueryKey`, `(id: string) =>
-  ['${typeName.toLowerCase()}', 'detail', id] as const`));
-    // Add section comment
-    sourceFile.addStatements('\n// ============================================================================');
-    sourceFile.addStatements('// Hook');
-    sourceFile.addStatements('// ============================================================================\n');
-    // Hook function
-    sourceFile.addFunction({
-        name: hookName,
-        isExported: true,
-        parameters: [
-            { name: 'id', type: 'string' },
-            {
-                name: 'options',
-                type: `Omit<UseQueryOptions<${(0, utils_1.ucFirst)(singularName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`,
-                hasQuestionToken: true,
-            },
-        ],
-        statements: `return useQuery({
-    queryKey: ${queryName}QueryKey(id),
+    // Query key factory - use dynamic PK field name and type
+    sourceFile.addVariableStatement((0, ts_ast_1.createConst)(`${queryName}QueryKey`, `(${pkName}: ${pkTsType}) =>
+  ['${typeName.toLowerCase()}', 'detail', ${pkName}] as const`));
+    // Add React Query hook section (only if enabled)
+    if (reactQueryEnabled) {
+        sourceFile.addStatements('\n// ============================================================================');
+        sourceFile.addStatements('// Hook');
+        sourceFile.addStatements('// ============================================================================\n');
+        // Hook function - use dynamic PK field name and type
+        sourceFile.addFunction({
+            name: hookName,
+            isExported: true,
+            parameters: [
+                { name: pkName, type: pkTsType },
+                {
+                    name: 'options',
+                    type: `Omit<UseQueryOptions<${(0, utils_1.ucFirst)(singularName)}QueryResult, Error>, 'queryKey' | 'queryFn'>`,
+                    hasQuestionToken: true,
+                },
+            ],
+            statements: `return useQuery({
+    queryKey: ${queryName}QueryKey(${pkName}),
     queryFn: () => execute<${(0, utils_1.ucFirst)(singularName)}QueryResult, ${(0, utils_1.ucFirst)(singularName)}QueryVariables>(
       ${queryName}QueryDocument,
-      { id }
+      { ${pkName} }
     ),
-    enabled: !!id && (options?.enabled !== false),
+    enabled: !!${pkName} && (options?.enabled !== false),
     ...options,
   });`,
-        docs: [
-            {
-                description: `Query hook for fetching a single ${typeName} by ID
+            docs: [
+                {
+                    description: `Query hook for fetching a single ${typeName} by primary key
 
 @example
 \`\`\`tsx
-const { data, isLoading } = ${hookName}('uuid-here');
+const { data, isLoading } = ${hookName}(${pkTsType === 'string' ? "'value-here'" : '123'});
 
 if (data?.${queryName}) {
-  console.log(data.${queryName}.id);
+  console.log(data.${queryName}.${pkName});
 }
 \`\`\``,
-            },
-        ],
-    });
+                },
+            ],
+        });
+    }
     // Add section comment for standalone functions
     sourceFile.addStatements('\n// ============================================================================');
     sourceFile.addStatements('// Standalone Functions (non-React)');
     sourceFile.addStatements('// ============================================================================\n');
-    // Fetch function (standalone, no React)
+    // Fetch function (standalone, no React) - use dynamic PK
     sourceFile.addFunction({
         name: `fetch${(0, utils_1.ucFirst)(singularName)}Query`,
         isExported: true,
         isAsync: true,
         parameters: [
-            { name: 'id', type: 'string' },
+            { name: pkName, type: pkTsType },
             {
                 name: 'options',
                 type: 'ExecuteOptions',
@@ -369,54 +394,56 @@ if (data?.${queryName}) {
         returnType: `Promise<${(0, utils_1.ucFirst)(singularName)}QueryResult>`,
         statements: `return execute<${(0, utils_1.ucFirst)(singularName)}QueryResult, ${(0, utils_1.ucFirst)(singularName)}QueryVariables>(
     ${queryName}QueryDocument,
-    { id },
+    { ${pkName} },
     options
   );`,
         docs: [
             {
-                description: `Fetch a single ${typeName} by ID without React hooks
+                description: `Fetch a single ${typeName} by primary key without React hooks
 
 @example
 \`\`\`ts
-const data = await fetch${(0, utils_1.ucFirst)(singularName)}Query('uuid-here');
+const data = await fetch${(0, utils_1.ucFirst)(singularName)}Query(${pkTsType === 'string' ? "'value-here'" : '123'});
 \`\`\``,
             },
         ],
     });
-    // Prefetch function (for SSR/QueryClient)
-    sourceFile.addFunction({
-        name: `prefetch${(0, utils_1.ucFirst)(singularName)}Query`,
-        isExported: true,
-        isAsync: true,
-        parameters: [
-            { name: 'queryClient', type: 'QueryClient' },
-            { name: 'id', type: 'string' },
-            {
-                name: 'options',
-                type: 'ExecuteOptions',
-                hasQuestionToken: true,
-            },
-        ],
-        returnType: 'Promise<void>',
-        statements: `await queryClient.prefetchQuery({
-    queryKey: ${queryName}QueryKey(id),
+    // Prefetch function (for SSR/QueryClient) - only if React Query is enabled, use dynamic PK
+    if (reactQueryEnabled) {
+        sourceFile.addFunction({
+            name: `prefetch${(0, utils_1.ucFirst)(singularName)}Query`,
+            isExported: true,
+            isAsync: true,
+            parameters: [
+                { name: 'queryClient', type: 'QueryClient' },
+                { name: pkName, type: pkTsType },
+                {
+                    name: 'options',
+                    type: 'ExecuteOptions',
+                    hasQuestionToken: true,
+                },
+            ],
+            returnType: 'Promise<void>',
+            statements: `await queryClient.prefetchQuery({
+    queryKey: ${queryName}QueryKey(${pkName}),
     queryFn: () => execute<${(0, utils_1.ucFirst)(singularName)}QueryResult, ${(0, utils_1.ucFirst)(singularName)}QueryVariables>(
       ${queryName}QueryDocument,
-      { id },
+      { ${pkName} },
       options
     ),
   });`,
-        docs: [
-            {
-                description: `Prefetch a single ${typeName} for SSR or cache warming
+            docs: [
+                {
+                    description: `Prefetch a single ${typeName} for SSR or cache warming
 
 @example
 \`\`\`ts
-await prefetch${(0, utils_1.ucFirst)(singularName)}Query(queryClient, 'uuid-here');
+await prefetch${(0, utils_1.ucFirst)(singularName)}Query(queryClient, ${pkTsType === 'string' ? "'value-here'" : '123'});
 \`\`\``,
-            },
-        ],
-    });
+                },
+            ],
+        });
+    }
     return {
         fileName: (0, utils_1.getSingleQueryFileName)(table),
         content: (0, ts_ast_1.getFormattedOutput)(sourceFile),
@@ -428,11 +455,11 @@ await prefetch${(0, utils_1.ucFirst)(singularName)}Query(queryClient, 'uuid-here
 /**
  * Generate all query hook files for all tables
  */
-function generateAllQueryHooks(tables) {
+function generateAllQueryHooks(tables, options = {}) {
     const files = [];
     for (const table of tables) {
-        files.push(generateListQueryHook(table));
-        files.push(generateSingleQueryHook(table));
+        files.push(generateListQueryHook(table, options));
+        files.push(generateSingleQueryHook(table, options));
     }
     return files;
 }

package/cli/codegen/scalars.d.ts

@@ -4,9 +4,11 @@
 export declare const SCALAR_TS_MAP: Record<string, string>;
 export declare const SCALAR_FILTER_MAP: Record<string, string>;
 export declare const SCALAR_NAMES: Set<string>;
-export interface ScalarToTsOptions {
+/** All base filter type names - skip these in schema-types.ts to avoid duplicates */
+export declare const BASE_FILTER_TYPE_NAMES: Set<string>;
+export declare function scalarToTsType(scalarName: string, options?: {
     unknownScalar?: 'unknown' | 'name';
     overrides?: Record<string, string>;
-}
-export declare function scalarToTsType(scalarName: string, options?: ScalarToTsOptions): string;
-export declare function scalarToFilterType(scalarName: string): string | null;
+}): string;
+/** Get the filter type for a scalar (handles both scalar and array types) */
+export declare function scalarToFilterType(scalarName: string, isArray?: boolean): string | null;

package/cli/codegen/scalars.js

@@ -3,7 +3,7 @@
  * Shared scalar mappings for code generation
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SCALAR_NAMES = exports.SCALAR_FILTER_MAP = exports.SCALAR_TS_MAP = void 0;
+exports.BASE_FILTER_TYPE_NAMES = exports.SCALAR_NAMES = exports.SCALAR_FILTER_MAP = exports.SCALAR_TS_MAP = void 0;
 exports.scalarToTsType = scalarToTsType;
 exports.scalarToFilterType = scalarToFilterType;
 exports.SCALAR_TS_MAP = {
@@ -37,6 +37,8 @@ exports.SCALAR_TS_MAP = {
     MacAddr: 'string',
     TsVector: 'string',
     TsQuery: 'string',
+    // File upload
+    Upload: 'File',
 };
 exports.SCALAR_FILTER_MAP = {
     String: 'StringFilter',
@@ -57,15 +59,21 @@ exports.SCALAR_FILTER_MAP = {
     Interval: 'StringFilter',
 };
 exports.SCALAR_NAMES = new Set(Object.keys(exports.SCALAR_TS_MAP));
+/** Scalars that have list filter variants (e.g., StringListFilter) */
+const LIST_FILTER_SCALARS = new Set(['String', 'Int', 'UUID']);
+/** All base filter type names - skip these in schema-types.ts to avoid duplicates */
+exports.BASE_FILTER_TYPE_NAMES = new Set([
+    ...new Set(Object.values(exports.SCALAR_FILTER_MAP)),
+    ...Array.from(LIST_FILTER_SCALARS).map((s) => `${s}ListFilter`),
+]);
 function scalarToTsType(scalarName, options = {}) {
-    const override = options.overrides?.[scalarName];
-    if (override)
-        return override;
-    const mapped = exports.SCALAR_TS_MAP[scalarName];
-    if (mapped)
-        return mapped;
-    return options.unknownScalar === 'unknown' ? 'unknown' : scalarName;
+    return options.overrides?.[scalarName] ?? exports.SCALAR_TS_MAP[scalarName] ?? (options.unknownScalar === 'unknown' ? 'unknown' : scalarName);
 }
-function scalarToFilterType(scalarName) {
+/** Get the filter type for a scalar (handles both scalar and array types) */
+function scalarToFilterType(scalarName, isArray = false) {
+    const baseName = scalarName === 'ID' ? 'UUID' : scalarName;
+    if (isArray) {
+        return LIST_FILTER_SCALARS.has(baseName) ? `${baseName}ListFilter` : null;
+    }
     return exports.SCALAR_FILTER_MAP[scalarName] ?? null;
 }

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

@@ -0,0 +1,26 @@
+import type { TypeRegistry } from '../../types/schema';
+export interface GeneratedSchemaTypesFile {
+    fileName: string;
+    content: string;
+    /** List of enum type names that were generated */
+    generatedEnums: string[];
+    /** List of table entity types that are referenced */
+    referencedTableTypes: string[];
+}
+export interface GenerateSchemaTypesOptions {
+    /** The TypeRegistry containing all GraphQL types */
+    typeRegistry: TypeRegistry;
+    /** Type names that already exist in types.ts (table entity types) */
+    tableTypeNames: Set<string>;
+}
+export interface PayloadTypesResult {
+    generatedTypes: Set<string>;
+    referencedTableTypes: Set<string>;
+}
+/**
+ * Generate comprehensive schema-types.ts file using ts-morph AST
+ *
+ * This generates all Input/Payload/Enum types from the TypeRegistry
+ * that are needed by custom mutation/query hooks.
+ */
+export declare function generateSchemaTypesFile(options: GenerateSchemaTypesOptions): GeneratedSchemaTypesFile;