@constructive-io/graphql-codegen 2.19.0 → 2.20.1

package/cli/codegen/mutations.js

@@ -0,0 +1,410 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateCreateMutationHook = generateCreateMutationHook;
+exports.generateUpdateMutationHook = generateUpdateMutationHook;
+exports.generateDeleteMutationHook = generateDeleteMutationHook;
+exports.generateAllMutationHooks = generateAllMutationHooks;
+const ts_ast_1 = require("./ts-ast");
+const gql_ast_1 = require("./gql-ast");
+const utils_1 = require("./utils");
+// ============================================================================
+// Create mutation hook generator
+// ============================================================================
+/**
+ * Generate create mutation hook file content using AST
+ */
+function generateCreateMutationHook(table) {
+    const project = (0, ts_ast_1.createProject)();
+    const { typeName, singularName } = (0, utils_1.getTableNames)(table);
+    const hookName = (0, utils_1.getCreateMutationHookName)(table);
+    const mutationName = (0, utils_1.getCreateMutationName)(table);
+    const scalarFields = (0, utils_1.getScalarFields)(table);
+    // Generate GraphQL document via AST
+    const mutationAST = (0, gql_ast_1.buildCreateMutationAST)({ table });
+    const mutationDocument = (0, gql_ast_1.printGraphQL)(mutationAST);
+    const sourceFile = (0, ts_ast_1.createSourceFile)(project, (0, utils_1.getCreateMutationFileName)(table));
+    // Add file header
+    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(`Create mutation hook for ${typeName}`) + '\n\n');
+    // Add imports
+    sourceFile.addImportDeclarations([
+        (0, ts_ast_1.createImport)({
+            moduleSpecifier: '@tanstack/react-query',
+            namedImports: ['useMutation', 'useQueryClient'],
+            typeOnlyNamedImports: ['UseMutationOptions'],
+        }),
+        (0, ts_ast_1.createImport)({
+            moduleSpecifier: '../client',
+            namedImports: ['execute'],
+        }),
+        (0, ts_ast_1.createImport)({
+            moduleSpecifier: '../types',
+            typeOnlyNamedImports: [typeName],
+        }),
+    ]);
+    // Re-export entity type
+    sourceFile.addStatements(`\n// Re-export entity type for convenience\nexport type { ${typeName} };\n`);
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// GraphQL Document');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Add mutation document constant
+    sourceFile.addVariableStatement((0, ts_ast_1.createConst)(`${mutationName}MutationDocument`, '`\n' + mutationDocument + '`'));
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// Types');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Generate CreateInput type - exclude auto-generated fields
+    const inputFields = scalarFields
+        .filter((f) => {
+        const name = f.name.toLowerCase();
+        return !['id', 'createdat', 'updatedat', 'created_at', 'updated_at'].includes(name);
+    })
+        .map((f) => ({
+        name: f.name,
+        type: `${(0, utils_1.fieldTypeToTs)(f.type)} | null`,
+        optional: true,
+    }));
+    sourceFile.addInterface((0, ts_ast_1.createInterface)(`${typeName}CreateInput`, inputFields, {
+        docs: [`Input type for creating a ${typeName}`],
+    }));
+    // Variables interface
+    sourceFile.addInterface((0, ts_ast_1.createInterface)(`${(0, utils_1.ucFirst)(mutationName)}MutationVariables`, [
+        {
+            name: 'input',
+            type: `{
+    ${(0, utils_1.lcFirst)(typeName)}: ${typeName}CreateInput;
+  }`,
+        },
+    ]));
+    // Result interface
+    sourceFile.addInterface((0, ts_ast_1.createInterface)(`${(0, utils_1.ucFirst)(mutationName)}MutationResult`, [
+        {
+            name: mutationName,
+            type: `{
+    ${singularName}: ${typeName};
+  }`,
+        },
+    ]));
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// Hook');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Hook function
+    sourceFile.addFunction({
+        name: hookName,
+        isExported: true,
+        parameters: [
+            {
+                name: 'options',
+                type: `Omit<UseMutationOptions<${(0, utils_1.ucFirst)(mutationName)}MutationResult, Error, ${(0, utils_1.ucFirst)(mutationName)}MutationVariables>, 'mutationFn'>`,
+                hasQuestionToken: true,
+            },
+        ],
+        statements: `const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: (variables: ${(0, utils_1.ucFirst)(mutationName)}MutationVariables) =>
+      execute<${(0, utils_1.ucFirst)(mutationName)}MutationResult, ${(0, utils_1.ucFirst)(mutationName)}MutationVariables>(
+        ${mutationName}MutationDocument,
+        variables
+      ),
+    onSuccess: () => {
+      // Invalidate list queries to refetch
+      queryClient.invalidateQueries({ queryKey: ['${typeName.toLowerCase()}', 'list'] });
+    },
+    ...options,
+  });`,
+        docs: [
+            {
+                description: `Mutation hook for creating a ${typeName}
+
+@example
+\`\`\`tsx
+const { mutate, isPending } = ${hookName}();
+
+mutate({
+  input: {
+    ${(0, utils_1.lcFirst)(typeName)}: {
+      // ... fields
+    },
+  },
+});
+\`\`\``,
+            },
+        ],
+    });
+    return {
+        fileName: (0, utils_1.getCreateMutationFileName)(table),
+        content: (0, ts_ast_1.getFormattedOutput)(sourceFile),
+    };
+}
+// ============================================================================
+// Update mutation hook generator
+// ============================================================================
+/**
+ * Generate update mutation hook file content using AST
+ */
+function generateUpdateMutationHook(table) {
+    // Check if update mutation exists
+    if (table.query?.update === null) {
+        return null;
+    }
+    const project = (0, ts_ast_1.createProject)();
+    const { typeName, singularName } = (0, utils_1.getTableNames)(table);
+    const hookName = (0, utils_1.getUpdateMutationHookName)(table);
+    const mutationName = (0, utils_1.getUpdateMutationName)(table);
+    const scalarFields = (0, utils_1.getScalarFields)(table);
+    // Generate GraphQL document via AST
+    const mutationAST = (0, gql_ast_1.buildUpdateMutationAST)({ table });
+    const mutationDocument = (0, gql_ast_1.printGraphQL)(mutationAST);
+    const sourceFile = (0, ts_ast_1.createSourceFile)(project, (0, utils_1.getUpdateMutationFileName)(table));
+    // Add file header
+    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(`Update mutation hook for ${typeName}`) + '\n\n');
+    // Add imports
+    sourceFile.addImportDeclarations([
+        (0, ts_ast_1.createImport)({
+            moduleSpecifier: '@tanstack/react-query',
+            namedImports: ['useMutation', 'useQueryClient'],
+            typeOnlyNamedImports: ['UseMutationOptions'],
+        }),
+        (0, ts_ast_1.createImport)({
+            moduleSpecifier: '../client',
+            namedImports: ['execute'],
+        }),
+        (0, ts_ast_1.createImport)({
+            moduleSpecifier: '../types',
+            typeOnlyNamedImports: [typeName],
+        }),
+    ]);
+    // Re-export entity type
+    sourceFile.addStatements(`\n// Re-export entity type for convenience\nexport type { ${typeName} };\n`);
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// GraphQL Document');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Add mutation document constant
+    sourceFile.addVariableStatement((0, ts_ast_1.createConst)(`${mutationName}MutationDocument`, '`\n' + mutationDocument + '`'));
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// Types');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Generate Patch type - all fields optional
+    const patchFields = scalarFields
+        .filter((f) => f.name.toLowerCase() !== 'id')
+        .map((f) => ({
+        name: f.name,
+        type: `${(0, utils_1.fieldTypeToTs)(f.type)} | null`,
+        optional: true,
+    }));
+    sourceFile.addInterface((0, ts_ast_1.createInterface)(`${typeName}Patch`, patchFields, {
+        docs: [`Patch type for updating a ${typeName} - all fields optional`],
+    }));
+    // Variables interface
+    sourceFile.addInterface((0, ts_ast_1.createInterface)(`${(0, utils_1.ucFirst)(mutationName)}MutationVariables`, [
+        {
+            name: 'input',
+            type: `{
+    id: string;
+    patch: ${typeName}Patch;
+  }`,
+        },
+    ]));
+    // Result interface
+    sourceFile.addInterface((0, ts_ast_1.createInterface)(`${(0, utils_1.ucFirst)(mutationName)}MutationResult`, [
+        {
+            name: mutationName,
+            type: `{
+    ${singularName}: ${typeName};
+  }`,
+        },
+    ]));
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// Hook');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Hook function
+    sourceFile.addFunction({
+        name: hookName,
+        isExported: true,
+        parameters: [
+            {
+                name: 'options',
+                type: `Omit<UseMutationOptions<${(0, utils_1.ucFirst)(mutationName)}MutationResult, Error, ${(0, utils_1.ucFirst)(mutationName)}MutationVariables>, 'mutationFn'>`,
+                hasQuestionToken: true,
+            },
+        ],
+        statements: `const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: (variables: ${(0, utils_1.ucFirst)(mutationName)}MutationVariables) =>
+      execute<${(0, utils_1.ucFirst)(mutationName)}MutationResult, ${(0, utils_1.ucFirst)(mutationName)}MutationVariables>(
+        ${mutationName}MutationDocument,
+        variables
+      ),
+    onSuccess: (_, variables) => {
+      // Invalidate specific item and list queries
+      queryClient.invalidateQueries({ queryKey: ['${typeName.toLowerCase()}', 'detail', variables.input.id] });
+      queryClient.invalidateQueries({ queryKey: ['${typeName.toLowerCase()}', 'list'] });
+    },
+    ...options,
+  });`,
+        docs: [
+            {
+                description: `Mutation hook for updating a ${typeName}
+
+@example
+\`\`\`tsx
+const { mutate, isPending } = ${hookName}();
+
+mutate({
+  input: {
+    id: 'uuid-here',
+    patch: {
+      // ... fields to update
+    },
+  },
+});
+\`\`\``,
+            },
+        ],
+    });
+    return {
+        fileName: (0, utils_1.getUpdateMutationFileName)(table),
+        content: (0, ts_ast_1.getFormattedOutput)(sourceFile),
+    };
+}
+// ============================================================================
+// Delete mutation hook generator
+// ============================================================================
+/**
+ * Generate delete mutation hook file content using AST
+ */
+function generateDeleteMutationHook(table) {
+    // Check if delete mutation exists
+    if (table.query?.delete === null) {
+        return null;
+    }
+    const project = (0, ts_ast_1.createProject)();
+    const { typeName } = (0, utils_1.getTableNames)(table);
+    const hookName = (0, utils_1.getDeleteMutationHookName)(table);
+    const mutationName = (0, utils_1.getDeleteMutationName)(table);
+    // Generate GraphQL document via AST
+    const mutationAST = (0, gql_ast_1.buildDeleteMutationAST)({ table });
+    const mutationDocument = (0, gql_ast_1.printGraphQL)(mutationAST);
+    const sourceFile = (0, ts_ast_1.createSourceFile)(project, (0, utils_1.getDeleteMutationFileName)(table));
+    // Add file header
+    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)(`Delete mutation hook for ${typeName}`) + '\n\n');
+    // Add imports
+    sourceFile.addImportDeclarations([
+        (0, ts_ast_1.createImport)({
+            moduleSpecifier: '@tanstack/react-query',
+            namedImports: ['useMutation', 'useQueryClient'],
+            typeOnlyNamedImports: ['UseMutationOptions'],
+        }),
+        (0, ts_ast_1.createImport)({
+            moduleSpecifier: '../client',
+            namedImports: ['execute'],
+        }),
+    ]);
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// GraphQL Document');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Add mutation document constant
+    sourceFile.addVariableStatement((0, ts_ast_1.createConst)(`${mutationName}MutationDocument`, '`\n' + mutationDocument + '`'));
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// Types');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Variables interface
+    sourceFile.addInterface((0, ts_ast_1.createInterface)(`${(0, utils_1.ucFirst)(mutationName)}MutationVariables`, [
+        {
+            name: 'input',
+            type: `{
+    id: string;
+  }`,
+        },
+    ]));
+    // Result interface
+    sourceFile.addInterface((0, ts_ast_1.createInterface)(`${(0, utils_1.ucFirst)(mutationName)}MutationResult`, [
+        {
+            name: mutationName,
+            type: `{
+    clientMutationId: string | null;
+    deletedId: string | null;
+  }`,
+        },
+    ]));
+    // Add section comment
+    sourceFile.addStatements('\n// ============================================================================');
+    sourceFile.addStatements('// Hook');
+    sourceFile.addStatements('// ============================================================================\n');
+    // Hook function
+    sourceFile.addFunction({
+        name: hookName,
+        isExported: true,
+        parameters: [
+            {
+                name: 'options',
+                type: `Omit<UseMutationOptions<${(0, utils_1.ucFirst)(mutationName)}MutationResult, Error, ${(0, utils_1.ucFirst)(mutationName)}MutationVariables>, 'mutationFn'>`,
+                hasQuestionToken: true,
+            },
+        ],
+        statements: `const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: (variables: ${(0, utils_1.ucFirst)(mutationName)}MutationVariables) =>
+      execute<${(0, utils_1.ucFirst)(mutationName)}MutationResult, ${(0, utils_1.ucFirst)(mutationName)}MutationVariables>(
+        ${mutationName}MutationDocument,
+        variables
+      ),
+    onSuccess: (_, variables) => {
+      // Remove from cache and invalidate list
+      queryClient.removeQueries({ queryKey: ['${typeName.toLowerCase()}', 'detail', variables.input.id] });
+      queryClient.invalidateQueries({ queryKey: ['${typeName.toLowerCase()}', 'list'] });
+    },
+    ...options,
+  });`,
+        docs: [
+            {
+                description: `Mutation hook for deleting a ${typeName}
+
+@example
+\`\`\`tsx
+const { mutate, isPending } = ${hookName}();
+
+mutate({
+  input: {
+    id: 'uuid-to-delete',
+  },
+});
+\`\`\``,
+            },
+        ],
+    });
+    return {
+        fileName: (0, utils_1.getDeleteMutationFileName)(table),
+        content: (0, ts_ast_1.getFormattedOutput)(sourceFile),
+    };
+}
+// ============================================================================
+// Batch generator
+// ============================================================================
+/**
+ * Generate all mutation hook files for all tables
+ */
+function generateAllMutationHooks(tables) {
+    const files = [];
+    for (const table of tables) {
+        files.push(generateCreateMutationHook(table));
+        const updateHook = generateUpdateMutationHook(table);
+        if (updateHook) {
+            files.push(updateHook);
+        }
+        const deleteHook = generateDeleteMutationHook(table);
+        if (deleteHook) {
+            files.push(deleteHook);
+        }
+    }
+    return files;
+}

package/cli/codegen/orm/barrel.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Barrel file generators for ORM client
+ *
+ * Generates index.ts files that re-export all models and operations.
+ */
+import type { CleanTable } from '../../../types/schema';
+export interface GeneratedBarrelFile {
+    fileName: string;
+    content: string;
+}
+/**
+ * Generate the models/index.ts barrel file
+ */
+export declare function generateModelsBarrel(tables: CleanTable[]): GeneratedBarrelFile;
+/**
+ * Generate the types.ts file that re-exports all types
+ */
+export declare function generateTypesBarrel(_useSharedTypes: boolean): GeneratedBarrelFile;

package/cli/codegen/orm/barrel.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateModelsBarrel = generateModelsBarrel;
+exports.generateTypesBarrel = generateTypesBarrel;
+const ts_ast_1 = require("../ts-ast");
+const utils_1 = require("../utils");
+/**
+ * Generate the models/index.ts barrel file
+ */
+function generateModelsBarrel(tables) {
+    const project = (0, ts_ast_1.createProject)();
+    const sourceFile = (0, ts_ast_1.createSourceFile)(project, 'index.ts');
+    // Add file header
+    sourceFile.insertText(0, (0, ts_ast_1.createFileHeader)('Models barrel export') + '\n\n');
+    // Export all model classes (Select types are now in input-types.ts)
+    for (const table of tables) {
+        const { typeName } = (0, utils_1.getTableNames)(table);
+        const modelName = `${typeName}Model`;
+        const fileName = (0, utils_1.lcFirst)(typeName);
+        sourceFile.addExportDeclaration({
+            moduleSpecifier: `./${fileName}`,
+            namedExports: [modelName],
+        });
+    }
+    return {
+        fileName: 'models/index.ts',
+        content: (0, ts_ast_1.getFormattedOutput)(sourceFile),
+    };
+}
+/**
+ * Generate the types.ts file that re-exports all types
+ */
+function generateTypesBarrel(_useSharedTypes) {
+    // Always re-export from input-types since that's where all types are generated
+    const content = `/**
+ * Types re-export
+ * @generated by @constructive-io/graphql-codegen
+ * DO NOT EDIT - changes will be overwritten
+ */
+
+// Re-export all types from input-types
+export * from './input-types';
+`;
+    return {
+        fileName: 'types.ts',
+        content,
+    };
+}

package/cli/codegen/orm/client-generator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ORM Client generator
+ *
+ * Generates the createClient() factory function and main client file.
+ *
+ * Example output:
+ * ```typescript
+ * import { OrmClient, OrmClientConfig } from './client';
+ * import { UserModel } from './models/user';
+ * import { queryOperations } from './query';
+ * import { mutationOperations } from './mutation';
+ *
+ * export function createClient(config: OrmClientConfig) {
+ *   const client = new OrmClient(config);
+ *   return {
+ *     user: new UserModel(client),
+ *     post: new PostModel(client),
+ *     query: queryOperations(client),
+ *     mutation: mutationOperations(client),
+ *   };
+ * }
+ * ```
+ */
+import type { CleanTable } from '../../../types/schema';
+export interface GeneratedClientFile {
+    fileName: string;
+    content: string;
+}
+/**
+ * Generate the main client.ts file (OrmClient class)
+ * This is the runtime client that handles GraphQL execution
+ */
+export declare function generateOrmClientFile(): GeneratedClientFile;
+/**
+ * Generate the query-builder.ts file (runtime query builder)
+ */
+export declare function generateQueryBuilderFile(): GeneratedClientFile;
+/**
+ * Generate the select-types.ts file
+ */
+export declare function generateSelectTypesFile(): GeneratedClientFile;
+/**
+ * Generate the main index.ts with createClient factory
+ */
+export declare function generateCreateClientFile(tables: CleanTable[], hasCustomQueries: boolean, hasCustomMutations: boolean): GeneratedClientFile;