@constructive-io/graphql-codegen 2.23.3 → 2.24.0

package/cli/codegen/ts-ast.js

@@ -1,280 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createProject = createProject;
-exports.createSourceFile = createSourceFile;
-exports.getFormattedOutput = getFormattedOutput;
-exports.getMinimalFormattedOutput = getMinimalFormattedOutput;
-exports.createFileHeader = createFileHeader;
-exports.createJsDoc = createJsDoc;
-exports.createImport = createImport;
-exports.createInterface = createInterface;
-exports.createFilterInterface = createFilterInterface;
-exports.createTypeAlias = createTypeAlias;
-exports.createUnionType = createUnionType;
-exports.createConst = createConst;
-exports.createTemplateLiteral = createTemplateLiteral;
-exports.createFunction = createFunction;
-exports.createReExport = createReExport;
-exports.createBarrelExport = createBarrelExport;
-exports.createSectionComment = createSectionComment;
-exports.addSectionComment = addSectionComment;
-/**
- * TypeScript AST builders using ts-morph
- *
- * Provides utilities for generating TypeScript code via AST manipulation
- * instead of string concatenation.
- */
-const ts_morph_1 = require("ts-morph");
-// ============================================================================
-// Project management
-// ============================================================================
-/**
- * Create a new ts-morph project for code generation
- */
-function createProject() {
-    return new ts_morph_1.Project({
-        useInMemoryFileSystem: true,
-        compilerOptions: {
-            declaration: true,
-            strict: true,
-            target: ts_morph_1.ScriptTarget.ESNext,
-            module: ts_morph_1.ModuleKind.ESNext,
-        },
-    });
-}
-/**
- * Create a source file in the project
- */
-function createSourceFile(project, fileName) {
-    return project.createSourceFile(fileName, '', { overwrite: true });
-}
-/**
- * Get formatted output from source file
- */
-function getFormattedOutput(sourceFile) {
-    sourceFile.formatText({
-        indentSize: 2,
-        convertTabsToSpaces: true,
-    });
-    return sourceFile.getFullText();
-}
-/**
- * Get output with minimal formatting (preserves intentional blank lines)
- * Post-processes to fix indentation and section comment spacing
- *
- * ts-morph generates type alias bodies with extra indentation:
- * - Properties get 6 spaces (we want 2)
- * - Closing brace gets 4 spaces (we want 0)
- *
- * For interfaces it uses 4 spaces which we convert to 2.
- */
-function getMinimalFormattedOutput(sourceFile) {
-    let text = sourceFile.getFullText();
-    // Process each line to fix indentation
-    // ts-morph uses inconsistent indentation for type alias bodies
-    // We halve all indentation: 4->2, 6->3 (rounds to 2), 8->4, etc.
-    text = text.split('\n').map(line => {
-        // Match leading whitespace
-        const match = line.match(/^(\s*)/);
-        if (!match)
-            return line;
-        const spaces = match[1].length;
-        const content = line.slice(spaces);
-        // Skip empty lines
-        if (content === '')
-            return line;
-        // No indentation - keep as-is
-        if (spaces === 0)
-            return line;
-        // Halve the indentation (minimum 0)
-        const newSpaces = Math.floor(spaces / 2);
-        return ' '.repeat(newSpaces) + content;
-    }).join('\n');
-    // Ensure blank line after section comment blocks
-    text = text.replace(/(\/\/ =+\n\/\/ .+\n\/\/ =+)\n(export|\/\/)/g, '$1\n\n$2');
-    // Add blank line between consecutive export declarations (type aliases, interfaces)
-    // Pattern: "}\nexport" or ";\nexport" should become "}\n\nexport" or ";\n\nexport"
-    text = text.replace(/(\}|\;)\n(export )/g, '$1\n\n$2');
-    // Remove trailing extra blank lines at end of file
-    text = text.replace(/\n\n+$/, '\n');
-    return text;
-}
-// ============================================================================
-// Comment helpers
-// ============================================================================
-/**
- * Create a file header comment
- */
-function createFileHeader(description) {
-    return [
-        '/**',
-        ` * ${description}`,
-        ' * @generated by @constructive-io/graphql-codegen',
-        ' * DO NOT EDIT - changes will be overwritten',
-        ' */',
-    ].join('\n');
-}
-/**
- * Create JSDoc comment for a declaration
- */
-function createJsDoc(lines) {
-    if (lines.length === 1) {
-        return `/** ${lines[0]} */`;
-    }
-    return ['/**', ...lines.map((l) => ` * ${l}`), ' */'].join('\n');
-}
-/**
- * Create import declaration structure
- */
-function createImport(spec) {
-    const namedImports = [];
-    if (spec.namedImports) {
-        namedImports.push(...spec.namedImports.map((name) => ({ name })));
-    }
-    if (spec.typeOnlyNamedImports) {
-        namedImports.push(...spec.typeOnlyNamedImports.map((name) => ({ name, isTypeOnly: true })));
-    }
-    return {
-        kind: ts_morph_1.StructureKind.ImportDeclaration,
-        moduleSpecifier: spec.moduleSpecifier,
-        defaultImport: spec.defaultImport,
-        namedImports: namedImports.length > 0 ? namedImports : undefined,
-    };
-}
-/**
- * Create interface declaration structure
- */
-function createInterface(name, properties, options) {
-    return {
-        kind: ts_morph_1.StructureKind.Interface,
-        name,
-        isExported: options?.isExported ?? true,
-        extends: options?.extends,
-        docs: options?.docs ? [{ description: options.docs.join('\n') }] : undefined,
-        properties: properties.map((prop) => ({
-            kind: ts_morph_1.StructureKind.PropertySignature,
-            name: prop.name,
-            type: prop.type,
-            hasQuestionToken: prop.optional,
-            docs: prop.docs ? [{ description: prop.docs.join('\n') }] : undefined,
-        })),
-    };
-}
-/**
- * Create filter interface with standard PostGraphile operators
- */
-function createFilterInterface(name, fieldFilters, options) {
-    const properties = [
-        ...fieldFilters.map((f) => ({
-            name: f.fieldName,
-            type: f.filterType,
-            optional: true,
-        })),
-        { name: 'and', type: `${name}[]`, optional: true, docs: ['Logical AND'] },
-        { name: 'or', type: `${name}[]`, optional: true, docs: ['Logical OR'] },
-        { name: 'not', type: name, optional: true, docs: ['Logical NOT'] },
-    ];
-    return createInterface(name, properties, { isExported: options?.isExported ?? true });
-}
-// ============================================================================
-// Type alias builders
-// ============================================================================
-/**
- * Create type alias declaration structure
- */
-function createTypeAlias(name, type, options) {
-    return {
-        kind: ts_morph_1.StructureKind.TypeAlias,
-        name,
-        type,
-        isExported: options?.isExported ?? true,
-        docs: options?.docs ? [{ description: options.docs.join('\n') }] : undefined,
-    };
-}
-/**
- * Create union type from string literals
- */
-function createUnionType(values) {
-    return values.map((v) => `'${v}'`).join(' | ');
-}
-// ============================================================================
-// Variable/constant builders
-// ============================================================================
-/**
- * Create const variable statement structure
- */
-function createConst(name, initializer, options) {
-    return {
-        kind: ts_morph_1.StructureKind.VariableStatement,
-        declarationKind: ts_morph_1.VariableDeclarationKind.Const,
-        isExported: options?.isExported ?? true,
-        docs: options?.docs ? [{ description: options.docs.join('\n') }] : undefined,
-        declarations: [
-            {
-                name,
-                type: options?.type,
-                initializer,
-            },
-        ],
-    };
-}
-/**
- * Create a template literal string (for GraphQL documents)
- */
-function createTemplateLiteral(content) {
-    return '`\n' + content + '\n`';
-}
-/**
- * Create function declaration structure
- */
-function createFunction(name, parameters, returnType, body, options) {
-    return {
-        kind: ts_morph_1.StructureKind.Function,
-        name,
-        isExported: options?.isExported ?? true,
-        isAsync: options?.isAsync,
-        parameters: parameters.map((p) => ({
-            name: p.name,
-            type: p.type,
-            hasQuestionToken: p.optional,
-            initializer: p.initializer,
-        })),
-        returnType,
-        statements: body,
-    };
-}
-// ============================================================================
-// Export builders
-// ============================================================================
-/**
- * Create re-export statement
- */
-function createReExport(names, moduleSpecifier, isTypeOnly = false) {
-    const typePrefix = isTypeOnly ? 'type ' : '';
-    return `export ${typePrefix}{ ${names.join(', ')} } from '${moduleSpecifier}';`;
-}
-/**
- * Create barrel export statement
- */
-function createBarrelExport(moduleSpecifier) {
-    return `export * from '${moduleSpecifier}';`;
-}
-// ============================================================================
-// Section comment helpers
-// ============================================================================
-/**
- * Create a section divider comment for generated code
- */
-function createSectionComment(title) {
-    return [
-        '// ============================================================================',
-        `// ${title}`,
-        '// ============================================================================',
-    ].join('\n');
-}
-/**
- * Add a section comment to source file with proper spacing
- */
-function addSectionComment(sourceFile, title) {
-    sourceFile.addStatements(`\n${createSectionComment(title)}\n\n`);
-}

package/esm/cli/codegen/ts-ast.d.ts

@@ -1,124 +0,0 @@
-/**
- * TypeScript AST builders using ts-morph
- *
- * Provides utilities for generating TypeScript code via AST manipulation
- * instead of string concatenation.
- */
-import { Project, SourceFile, type InterfaceDeclarationStructure, type FunctionDeclarationStructure, type VariableStatementStructure, type ImportDeclarationStructure, type TypeAliasDeclarationStructure } from 'ts-morph';
-/**
- * Create a new ts-morph project for code generation
- */
-export declare function createProject(): Project;
-/**
- * Create a source file in the project
- */
-export declare function createSourceFile(project: Project, fileName: string): SourceFile;
-/**
- * Get formatted output from source file
- */
-export declare function getFormattedOutput(sourceFile: SourceFile): string;
-/**
- * Get output with minimal formatting (preserves intentional blank lines)
- * Post-processes to fix indentation and section comment spacing
- *
- * ts-morph generates type alias bodies with extra indentation:
- * - Properties get 6 spaces (we want 2)
- * - Closing brace gets 4 spaces (we want 0)
- *
- * For interfaces it uses 4 spaces which we convert to 2.
- */
-export declare function getMinimalFormattedOutput(sourceFile: SourceFile): string;
-/**
- * Create a file header comment
- */
-export declare function createFileHeader(description: string): string;
-/**
- * Create JSDoc comment for a declaration
- */
-export declare function createJsDoc(lines: string[]): string;
-export interface ImportSpec {
-    moduleSpecifier: string;
-    namedImports?: string[];
-    typeOnlyNamedImports?: string[];
-    defaultImport?: string;
-}
-/**
- * Create import declaration structure
- */
-export declare function createImport(spec: ImportSpec): ImportDeclarationStructure;
-export interface InterfaceProperty {
-    name: string;
-    type: string;
-    optional?: boolean;
-    docs?: string[];
-}
-/**
- * Create interface declaration structure
- */
-export declare function createInterface(name: string, properties: InterfaceProperty[], options?: {
-    docs?: string[];
-    isExported?: boolean;
-    extends?: string[];
-}): InterfaceDeclarationStructure;
-/**
- * Create filter interface with standard PostGraphile operators
- */
-export declare function createFilterInterface(name: string, fieldFilters: Array<{
-    fieldName: string;
-    filterType: string;
-}>, options?: {
-    isExported?: boolean;
-}): InterfaceDeclarationStructure;
-/**
- * Create type alias declaration structure
- */
-export declare function createTypeAlias(name: string, type: string, options?: {
-    docs?: string[];
-    isExported?: boolean;
-}): TypeAliasDeclarationStructure;
-/**
- * Create union type from string literals
- */
-export declare function createUnionType(values: string[]): string;
-/**
- * Create const variable statement structure
- */
-export declare function createConst(name: string, initializer: string, options?: {
-    docs?: string[];
-    isExported?: boolean;
-    type?: string;
-}): VariableStatementStructure;
-/**
- * Create a template literal string (for GraphQL documents)
- */
-export declare function createTemplateLiteral(content: string): string;
-export interface FunctionParameter {
-    name: string;
-    type: string;
-    optional?: boolean;
-    initializer?: string;
-}
-/**
- * Create function declaration structure
- */
-export declare function createFunction(name: string, parameters: FunctionParameter[], returnType: string, body: string, options?: {
-    docs?: string[];
-    isExported?: boolean;
-    isAsync?: boolean;
-}): FunctionDeclarationStructure;
-/**
- * Create re-export statement
- */
-export declare function createReExport(names: string[], moduleSpecifier: string, isTypeOnly?: boolean): string;
-/**
- * Create barrel export statement
- */
-export declare function createBarrelExport(moduleSpecifier: string): string;
-/**
- * Create a section divider comment for generated code
- */
-export declare function createSectionComment(title: string): string;
-/**
- * Add a section comment to source file with proper spacing
- */
-export declare function addSectionComment(sourceFile: SourceFile, title: string): void;

package/esm/cli/codegen/ts-ast.js

@@ -1,260 +0,0 @@
-/**
- * TypeScript AST builders using ts-morph
- *
- * Provides utilities for generating TypeScript code via AST manipulation
- * instead of string concatenation.
- */
-import { Project, StructureKind, VariableDeclarationKind, ScriptTarget, ModuleKind, } from 'ts-morph';
-// ============================================================================
-// Project management
-// ============================================================================
-/**
- * Create a new ts-morph project for code generation
- */
-export function createProject() {
-    return new Project({
-        useInMemoryFileSystem: true,
-        compilerOptions: {
-            declaration: true,
-            strict: true,
-            target: ScriptTarget.ESNext,
-            module: ModuleKind.ESNext,
-        },
-    });
-}
-/**
- * Create a source file in the project
- */
-export function createSourceFile(project, fileName) {
-    return project.createSourceFile(fileName, '', { overwrite: true });
-}
-/**
- * Get formatted output from source file
- */
-export function getFormattedOutput(sourceFile) {
-    sourceFile.formatText({
-        indentSize: 2,
-        convertTabsToSpaces: true,
-    });
-    return sourceFile.getFullText();
-}
-/**
- * Get output with minimal formatting (preserves intentional blank lines)
- * Post-processes to fix indentation and section comment spacing
- *
- * ts-morph generates type alias bodies with extra indentation:
- * - Properties get 6 spaces (we want 2)
- * - Closing brace gets 4 spaces (we want 0)
- *
- * For interfaces it uses 4 spaces which we convert to 2.
- */
-export function getMinimalFormattedOutput(sourceFile) {
-    let text = sourceFile.getFullText();
-    // Process each line to fix indentation
-    // ts-morph uses inconsistent indentation for type alias bodies
-    // We halve all indentation: 4->2, 6->3 (rounds to 2), 8->4, etc.
-    text = text.split('\n').map(line => {
-        // Match leading whitespace
-        const match = line.match(/^(\s*)/);
-        if (!match)
-            return line;
-        const spaces = match[1].length;
-        const content = line.slice(spaces);
-        // Skip empty lines
-        if (content === '')
-            return line;
-        // No indentation - keep as-is
-        if (spaces === 0)
-            return line;
-        // Halve the indentation (minimum 0)
-        const newSpaces = Math.floor(spaces / 2);
-        return ' '.repeat(newSpaces) + content;
-    }).join('\n');
-    // Ensure blank line after section comment blocks
-    text = text.replace(/(\/\/ =+\n\/\/ .+\n\/\/ =+)\n(export|\/\/)/g, '$1\n\n$2');
-    // Add blank line between consecutive export declarations (type aliases, interfaces)
-    // Pattern: "}\nexport" or ";\nexport" should become "}\n\nexport" or ";\n\nexport"
-    text = text.replace(/(\}|\;)\n(export )/g, '$1\n\n$2');
-    // Remove trailing extra blank lines at end of file
-    text = text.replace(/\n\n+$/, '\n');
-    return text;
-}
-// ============================================================================
-// Comment helpers
-// ============================================================================
-/**
- * Create a file header comment
- */
-export function createFileHeader(description) {
-    return [
-        '/**',
-        ` * ${description}`,
-        ' * @generated by @constructive-io/graphql-codegen',
-        ' * DO NOT EDIT - changes will be overwritten',
-        ' */',
-    ].join('\n');
-}
-/**
- * Create JSDoc comment for a declaration
- */
-export function createJsDoc(lines) {
-    if (lines.length === 1) {
-        return `/** ${lines[0]} */`;
-    }
-    return ['/**', ...lines.map((l) => ` * ${l}`), ' */'].join('\n');
-}
-/**
- * Create import declaration structure
- */
-export function createImport(spec) {
-    const namedImports = [];
-    if (spec.namedImports) {
-        namedImports.push(...spec.namedImports.map((name) => ({ name })));
-    }
-    if (spec.typeOnlyNamedImports) {
-        namedImports.push(...spec.typeOnlyNamedImports.map((name) => ({ name, isTypeOnly: true })));
-    }
-    return {
-        kind: StructureKind.ImportDeclaration,
-        moduleSpecifier: spec.moduleSpecifier,
-        defaultImport: spec.defaultImport,
-        namedImports: namedImports.length > 0 ? namedImports : undefined,
-    };
-}
-/**
- * Create interface declaration structure
- */
-export function createInterface(name, properties, options) {
-    return {
-        kind: StructureKind.Interface,
-        name,
-        isExported: options?.isExported ?? true,
-        extends: options?.extends,
-        docs: options?.docs ? [{ description: options.docs.join('\n') }] : undefined,
-        properties: properties.map((prop) => ({
-            kind: StructureKind.PropertySignature,
-            name: prop.name,
-            type: prop.type,
-            hasQuestionToken: prop.optional,
-            docs: prop.docs ? [{ description: prop.docs.join('\n') }] : undefined,
-        })),
-    };
-}
-/**
- * Create filter interface with standard PostGraphile operators
- */
-export function createFilterInterface(name, fieldFilters, options) {
-    const properties = [
-        ...fieldFilters.map((f) => ({
-            name: f.fieldName,
-            type: f.filterType,
-            optional: true,
-        })),
-        { name: 'and', type: `${name}[]`, optional: true, docs: ['Logical AND'] },
-        { name: 'or', type: `${name}[]`, optional: true, docs: ['Logical OR'] },
-        { name: 'not', type: name, optional: true, docs: ['Logical NOT'] },
-    ];
-    return createInterface(name, properties, { isExported: options?.isExported ?? true });
-}
-// ============================================================================
-// Type alias builders
-// ============================================================================
-/**
- * Create type alias declaration structure
- */
-export function createTypeAlias(name, type, options) {
-    return {
-        kind: StructureKind.TypeAlias,
-        name,
-        type,
-        isExported: options?.isExported ?? true,
-        docs: options?.docs ? [{ description: options.docs.join('\n') }] : undefined,
-    };
-}
-/**
- * Create union type from string literals
- */
-export function createUnionType(values) {
-    return values.map((v) => `'${v}'`).join(' | ');
-}
-// ============================================================================
-// Variable/constant builders
-// ============================================================================
-/**
- * Create const variable statement structure
- */
-export function createConst(name, initializer, options) {
-    return {
-        kind: StructureKind.VariableStatement,
-        declarationKind: VariableDeclarationKind.Const,
-        isExported: options?.isExported ?? true,
-        docs: options?.docs ? [{ description: options.docs.join('\n') }] : undefined,
-        declarations: [
-            {
-                name,
-                type: options?.type,
-                initializer,
-            },
-        ],
-    };
-}
-/**
- * Create a template literal string (for GraphQL documents)
- */
-export function createTemplateLiteral(content) {
-    return '`\n' + content + '\n`';
-}
-/**
- * Create function declaration structure
- */
-export function createFunction(name, parameters, returnType, body, options) {
-    return {
-        kind: StructureKind.Function,
-        name,
-        isExported: options?.isExported ?? true,
-        isAsync: options?.isAsync,
-        parameters: parameters.map((p) => ({
-            name: p.name,
-            type: p.type,
-            hasQuestionToken: p.optional,
-            initializer: p.initializer,
-        })),
-        returnType,
-        statements: body,
-    };
-}
-// ============================================================================
-// Export builders
-// ============================================================================
-/**
- * Create re-export statement
- */
-export function createReExport(names, moduleSpecifier, isTypeOnly = false) {
-    const typePrefix = isTypeOnly ? 'type ' : '';
-    return `export ${typePrefix}{ ${names.join(', ')} } from '${moduleSpecifier}';`;
-}
-/**
- * Create barrel export statement
- */
-export function createBarrelExport(moduleSpecifier) {
-    return `export * from '${moduleSpecifier}';`;
-}
-// ============================================================================
-// Section comment helpers
-// ============================================================================
-/**
- * Create a section divider comment for generated code
- */
-export function createSectionComment(title) {
-    return [
-        '// ============================================================================',
-        `// ${title}`,
-        '// ============================================================================',
-    ].join('\n');
-}
-/**
- * Add a section comment to source file with proper spacing
- */
-export function addSectionComment(sourceFile, title) {
-    sourceFile.addStatements(`\n${createSectionComment(title)}\n\n`);
-}