@constructive-io/graphql-codegen 2.19.0 → 2.20.0

package/esm/cli/codegen/filters.js

@@ -0,0 +1,351 @@
+import { getFilterTypeName, getOrderByTypeName, getScalarFilterType, getScalarFields, toScreamingSnake, getGeneratedFileHeader, } from './utils';
+// ============================================================================
+// Base filter type definitions
+// ============================================================================
+/**
+ * Generate all base PostGraphile filter types
+ * These are shared across all tables
+ */
+export function generateBaseFilterTypes() {
+    return `${getGeneratedFileHeader('PostGraphile base filter types')}
+
+// ============================================================================
+// String filters
+// ============================================================================
+
+export interface StringFilter {
+  isNull?: boolean;
+  equalTo?: string;
+  notEqualTo?: string;
+  distinctFrom?: string;
+  notDistinctFrom?: string;
+  in?: string[];
+  notIn?: string[];
+  lessThan?: string;
+  lessThanOrEqualTo?: string;
+  greaterThan?: string;
+  greaterThanOrEqualTo?: string;
+  includes?: string;
+  notIncludes?: string;
+  includesInsensitive?: string;
+  notIncludesInsensitive?: string;
+  startsWith?: string;
+  notStartsWith?: string;
+  startsWithInsensitive?: string;
+  notStartsWithInsensitive?: string;
+  endsWith?: string;
+  notEndsWith?: string;
+  endsWithInsensitive?: string;
+  notEndsWithInsensitive?: string;
+  like?: string;
+  notLike?: string;
+  likeInsensitive?: string;
+  notLikeInsensitive?: string;
+}
+
+export interface StringListFilter {
+  isNull?: boolean;
+  equalTo?: string[];
+  notEqualTo?: string[];
+  distinctFrom?: string[];
+  notDistinctFrom?: string[];
+  lessThan?: string[];
+  lessThanOrEqualTo?: string[];
+  greaterThan?: string[];
+  greaterThanOrEqualTo?: string[];
+  contains?: string[];
+  containedBy?: string[];
+  overlaps?: string[];
+  anyEqualTo?: string;
+  anyNotEqualTo?: string;
+  anyLessThan?: string;
+  anyLessThanOrEqualTo?: string;
+  anyGreaterThan?: string;
+  anyGreaterThanOrEqualTo?: string;
+}
+
+// ============================================================================
+// Numeric filters
+// ============================================================================
+
+export interface IntFilter {
+  isNull?: boolean;
+  equalTo?: number;
+  notEqualTo?: number;
+  distinctFrom?: number;
+  notDistinctFrom?: number;
+  in?: number[];
+  notIn?: number[];
+  lessThan?: number;
+  lessThanOrEqualTo?: number;
+  greaterThan?: number;
+  greaterThanOrEqualTo?: number;
+}
+
+export interface IntListFilter {
+  isNull?: boolean;
+  equalTo?: number[];
+  notEqualTo?: number[];
+  distinctFrom?: number[];
+  notDistinctFrom?: number[];
+  lessThan?: number[];
+  lessThanOrEqualTo?: number[];
+  greaterThan?: number[];
+  greaterThanOrEqualTo?: number[];
+  contains?: number[];
+  containedBy?: number[];
+  overlaps?: number[];
+  anyEqualTo?: number;
+  anyNotEqualTo?: number;
+  anyLessThan?: number;
+  anyLessThanOrEqualTo?: number;
+  anyGreaterThan?: number;
+  anyGreaterThanOrEqualTo?: number;
+}
+
+export interface FloatFilter {
+  isNull?: boolean;
+  equalTo?: number;
+  notEqualTo?: number;
+  distinctFrom?: number;
+  notDistinctFrom?: number;
+  in?: number[];
+  notIn?: number[];
+  lessThan?: number;
+  lessThanOrEqualTo?: number;
+  greaterThan?: number;
+  greaterThanOrEqualTo?: number;
+}
+
+export interface BigIntFilter {
+  isNull?: boolean;
+  equalTo?: string;
+  notEqualTo?: string;
+  distinctFrom?: string;
+  notDistinctFrom?: string;
+  in?: string[];
+  notIn?: string[];
+  lessThan?: string;
+  lessThanOrEqualTo?: string;
+  greaterThan?: string;
+  greaterThanOrEqualTo?: string;
+}
+
+export interface BigFloatFilter {
+  isNull?: boolean;
+  equalTo?: string;
+  notEqualTo?: string;
+  distinctFrom?: string;
+  notDistinctFrom?: string;
+  in?: string[];
+  notIn?: string[];
+  lessThan?: string;
+  lessThanOrEqualTo?: string;
+  greaterThan?: string;
+  greaterThanOrEqualTo?: string;
+}
+
+// ============================================================================
+// Boolean filter
+// ============================================================================
+
+export interface BooleanFilter {
+  isNull?: boolean;
+  equalTo?: boolean;
+  notEqualTo?: boolean;
+  distinctFrom?: boolean;
+  notDistinctFrom?: boolean;
+  in?: boolean[];
+  notIn?: boolean[];
+}
+
+// ============================================================================
+// UUID filter
+// ============================================================================
+
+export interface UUIDFilter {
+  isNull?: boolean;
+  equalTo?: string;
+  notEqualTo?: string;
+  distinctFrom?: string;
+  notDistinctFrom?: string;
+  in?: string[];
+  notIn?: string[];
+  lessThan?: string;
+  lessThanOrEqualTo?: string;
+  greaterThan?: string;
+  greaterThanOrEqualTo?: string;
+}
+
+export interface UUIDListFilter {
+  isNull?: boolean;
+  equalTo?: string[];
+  notEqualTo?: string[];
+  distinctFrom?: string[];
+  notDistinctFrom?: string[];
+  lessThan?: string[];
+  lessThanOrEqualTo?: string[];
+  greaterThan?: string[];
+  greaterThanOrEqualTo?: string[];
+  contains?: string[];
+  containedBy?: string[];
+  overlaps?: string[];
+  anyEqualTo?: string;
+  anyNotEqualTo?: string;
+  anyLessThan?: string;
+  anyLessThanOrEqualTo?: string;
+  anyGreaterThan?: string;
+  anyGreaterThanOrEqualTo?: string;
+}
+
+// ============================================================================
+// Date/Time filters
+// ============================================================================
+
+export interface DatetimeFilter {
+  isNull?: boolean;
+  equalTo?: string;
+  notEqualTo?: string;
+  distinctFrom?: string;
+  notDistinctFrom?: string;
+  in?: string[];
+  notIn?: string[];
+  lessThan?: string;
+  lessThanOrEqualTo?: string;
+  greaterThan?: string;
+  greaterThanOrEqualTo?: string;
+}
+
+export interface DateFilter {
+  isNull?: boolean;
+  equalTo?: string;
+  notEqualTo?: string;
+  distinctFrom?: string;
+  notDistinctFrom?: string;
+  in?: string[];
+  notIn?: string[];
+  lessThan?: string;
+  lessThanOrEqualTo?: string;
+  greaterThan?: string;
+  greaterThanOrEqualTo?: string;
+}
+
+export interface TimeFilter {
+  isNull?: boolean;
+  equalTo?: string;
+  notEqualTo?: string;
+  distinctFrom?: string;
+  notDistinctFrom?: string;
+  in?: string[];
+  notIn?: string[];
+  lessThan?: string;
+  lessThanOrEqualTo?: string;
+  greaterThan?: string;
+  greaterThanOrEqualTo?: string;
+}
+
+// ============================================================================
+// JSON filter
+// ============================================================================
+
+export interface JSONFilter {
+  isNull?: boolean;
+  equalTo?: unknown;
+  notEqualTo?: unknown;
+  distinctFrom?: unknown;
+  notDistinctFrom?: unknown;
+  in?: unknown[];
+  notIn?: unknown[];
+  contains?: unknown;
+  containedBy?: unknown;
+  containsKey?: string;
+  containsAllKeys?: string[];
+  containsAnyKeys?: string[];
+}
+`;
+}
+// ============================================================================
+// Table-specific filter generators
+// ============================================================================
+/**
+ * Generate filter interface for a specific table
+ */
+export function generateTableFilter(table) {
+    const filterTypeName = getFilterTypeName(table);
+    const scalarFields = getScalarFields(table);
+    const fieldFilters = scalarFields
+        .map((field) => {
+        const filterType = getFieldFilterType(field);
+        if (!filterType)
+            return null;
+        return `  ${field.name}?: ${filterType};`;
+    })
+        .filter(Boolean)
+        .join('\n');
+    return `export interface ${filterTypeName} {
+${fieldFilters}
+  /** Logical AND */
+  and?: ${filterTypeName}[];
+  /** Logical OR */
+  or?: ${filterTypeName}[];
+  /** Logical NOT */
+  not?: ${filterTypeName};
+}`;
+}
+/**
+ * Get the filter type for a specific field
+ */
+function getFieldFilterType(field) {
+    const { gqlType, isArray } = field.type;
+    // Handle array types
+    if (isArray) {
+        const cleanType = gqlType.replace(/!/g, '');
+        switch (cleanType) {
+            case 'String':
+                return 'StringListFilter';
+            case 'Int':
+                return 'IntListFilter';
+            case 'UUID':
+                return 'UUIDListFilter';
+            default:
+                return null;
+        }
+    }
+    return getScalarFilterType(gqlType);
+}
+// ============================================================================
+// OrderBy enum generators
+// ============================================================================
+/**
+ * Generate OrderBy type for a specific table
+ */
+export function generateTableOrderBy(table) {
+    const orderByTypeName = getOrderByTypeName(table);
+    const scalarFields = getScalarFields(table);
+    const fieldOrderBys = scalarFields.flatMap((field) => {
+        const screamingName = toScreamingSnake(field.name);
+        return [`'${screamingName}_ASC'`, `'${screamingName}_DESC'`];
+    });
+    // Add standard PostGraphile order options
+    const standardOrderBys = [
+        "'NATURAL'",
+        "'PRIMARY_KEY_ASC'",
+        "'PRIMARY_KEY_DESC'",
+    ];
+    const allOrderBys = [...fieldOrderBys, ...standardOrderBys];
+    return `export type ${orderByTypeName} = ${allOrderBys.join(' | ')};`;
+}
+// ============================================================================
+// Combined generators for hook files
+// ============================================================================
+/**
+ * Generate inline filter and orderBy types for a query hook file
+ * These are embedded directly in the hook file for self-containment
+ */
+export function generateInlineFilterTypes(table) {
+    const filterDef = generateTableFilter(table);
+    const orderByDef = generateTableOrderBy(table);
+    return `${filterDef}
+
+${orderByDef}`;
+}

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

@@ -0,0 +1,41 @@
+import type { DocumentNode } from 'graphql';
+import type { CleanTable } from '../../types/schema';
+export interface ListQueryConfig {
+    table: CleanTable;
+}
+/**
+ * Build a list query AST for a table
+ */
+export declare function buildListQueryAST(config: ListQueryConfig): DocumentNode;
+export interface SingleQueryConfig {
+    table: CleanTable;
+}
+/**
+ * Build a single item query AST for a table
+ */
+export declare function buildSingleQueryAST(config: SingleQueryConfig): DocumentNode;
+export interface CreateMutationConfig {
+    table: CleanTable;
+}
+/**
+ * Build a create mutation AST for a table
+ */
+export declare function buildCreateMutationAST(config: CreateMutationConfig): DocumentNode;
+export interface UpdateMutationConfig {
+    table: CleanTable;
+}
+/**
+ * Build an update mutation AST for a table
+ */
+export declare function buildUpdateMutationAST(config: UpdateMutationConfig): DocumentNode;
+export interface DeleteMutationConfig {
+    table: CleanTable;
+}
+/**
+ * Build a delete mutation AST for a table
+ */
+export declare function buildDeleteMutationAST(config: DeleteMutationConfig): DocumentNode;
+/**
+ * Print AST to GraphQL string
+ */
+export declare function printGraphQL(ast: DocumentNode): string;

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

@@ -0,0 +1,288 @@
+/**
+ * GraphQL AST builders using gql-ast
+ *
+ * Provides utilities for generating GraphQL queries and mutations via AST
+ * instead of string concatenation.
+ */
+import * as t from 'gql-ast';
+import { print } from 'graphql';
+import { getTableNames, getAllRowsQueryName, getSingleRowQueryName, getCreateMutationName, getUpdateMutationName, getDeleteMutationName, getFilterTypeName, getOrderByTypeName, getScalarFields, ucFirst, } from './utils';
+// ============================================================================
+// Field selection builders
+// ============================================================================
+/**
+ * Create field selections from CleanField array
+ */
+function createFieldSelections(fields) {
+    return fields.map((field) => t.field({ name: field.name }));
+}
+/**
+ * Create pageInfo selection
+ */
+function createPageInfoSelection() {
+    return t.field({
+        name: 'pageInfo',
+        selectionSet: t.selectionSet({
+            selections: [
+                t.field({ name: 'hasNextPage' }),
+                t.field({ name: 'hasPreviousPage' }),
+                t.field({ name: 'startCursor' }),
+                t.field({ name: 'endCursor' }),
+            ],
+        }),
+    });
+}
+/**
+ * Build a list query AST for a table
+ */
+export function buildListQueryAST(config) {
+    const { table } = config;
+    const queryName = getAllRowsQueryName(table);
+    const filterType = getFilterTypeName(table);
+    const orderByType = getOrderByTypeName(table);
+    const scalarFields = getScalarFields(table);
+    // Variable definitions
+    const variableDefinitions = [
+        t.variableDefinition({
+            variable: t.variable({ name: 'first' }),
+            type: t.namedType({ type: 'Int' }),
+        }),
+        t.variableDefinition({
+            variable: t.variable({ name: 'offset' }),
+            type: t.namedType({ type: 'Int' }),
+        }),
+        t.variableDefinition({
+            variable: t.variable({ name: 'filter' }),
+            type: t.namedType({ type: filterType }),
+        }),
+        t.variableDefinition({
+            variable: t.variable({ name: 'orderBy' }),
+            type: t.listType({
+                type: t.nonNullType({ type: t.namedType({ type: orderByType }) }),
+            }),
+        }),
+    ];
+    // Query arguments
+    const args = [
+        t.argument({ name: 'first', value: t.variable({ name: 'first' }) }),
+        t.argument({ name: 'offset', value: t.variable({ name: 'offset' }) }),
+        t.argument({ name: 'filter', value: t.variable({ name: 'filter' }) }),
+        t.argument({ name: 'orderBy', value: t.variable({ name: 'orderBy' }) }),
+    ];
+    // Field selections
+    const fieldSelections = createFieldSelections(scalarFields);
+    // Connection fields
+    const connectionFields = [
+        t.field({ name: 'totalCount' }),
+        t.field({
+            name: 'nodes',
+            selectionSet: t.selectionSet({ selections: fieldSelections }),
+        }),
+        createPageInfoSelection(),
+    ];
+    return t.document({
+        definitions: [
+            t.operationDefinition({
+                operation: 'query',
+                name: `${ucFirst(queryName)}Query`,
+                variableDefinitions,
+                selectionSet: t.selectionSet({
+                    selections: [
+                        t.field({
+                            name: queryName,
+                            args,
+                            selectionSet: t.selectionSet({ selections: connectionFields }),
+                        }),
+                    ],
+                }),
+            }),
+        ],
+    });
+}
+/**
+ * Build a single item query AST for a table
+ */
+export function buildSingleQueryAST(config) {
+    const { table } = config;
+    const queryName = getSingleRowQueryName(table);
+    const scalarFields = getScalarFields(table);
+    // Variable definitions - assume UUID primary key
+    const variableDefinitions = [
+        t.variableDefinition({
+            variable: t.variable({ name: 'id' }),
+            type: t.nonNullType({ type: t.namedType({ type: 'UUID' }) }),
+        }),
+    ];
+    // Query arguments
+    const args = [
+        t.argument({ name: 'id', value: t.variable({ name: 'id' }) }),
+    ];
+    // Field selections
+    const fieldSelections = createFieldSelections(scalarFields);
+    return t.document({
+        definitions: [
+            t.operationDefinition({
+                operation: 'query',
+                name: `${ucFirst(queryName)}Query`,
+                variableDefinitions,
+                selectionSet: t.selectionSet({
+                    selections: [
+                        t.field({
+                            name: queryName,
+                            args,
+                            selectionSet: t.selectionSet({ selections: fieldSelections }),
+                        }),
+                    ],
+                }),
+            }),
+        ],
+    });
+}
+/**
+ * Build a create mutation AST for a table
+ */
+export function buildCreateMutationAST(config) {
+    const { table } = config;
+    const { typeName, singularName } = getTableNames(table);
+    const mutationName = getCreateMutationName(table);
+    const inputTypeName = `Create${typeName}Input`;
+    const scalarFields = getScalarFields(table);
+    // Variable definitions
+    const variableDefinitions = [
+        t.variableDefinition({
+            variable: t.variable({ name: 'input' }),
+            type: t.nonNullType({ type: t.namedType({ type: inputTypeName }) }),
+        }),
+    ];
+    // Mutation arguments
+    const args = [
+        t.argument({ name: 'input', value: t.variable({ name: 'input' }) }),
+    ];
+    // Field selections
+    const fieldSelections = createFieldSelections(scalarFields);
+    return t.document({
+        definitions: [
+            t.operationDefinition({
+                operation: 'mutation',
+                name: `${ucFirst(mutationName)}Mutation`,
+                variableDefinitions,
+                selectionSet: t.selectionSet({
+                    selections: [
+                        t.field({
+                            name: mutationName,
+                            args,
+                            selectionSet: t.selectionSet({
+                                selections: [
+                                    t.field({
+                                        name: singularName,
+                                        selectionSet: t.selectionSet({ selections: fieldSelections }),
+                                    }),
+                                ],
+                            }),
+                        }),
+                    ],
+                }),
+            }),
+        ],
+    });
+}
+/**
+ * Build an update mutation AST for a table
+ */
+export function buildUpdateMutationAST(config) {
+    const { table } = config;
+    const { typeName, singularName } = getTableNames(table);
+    const mutationName = getUpdateMutationName(table);
+    const inputTypeName = `Update${typeName}Input`;
+    const scalarFields = getScalarFields(table);
+    // Variable definitions
+    const variableDefinitions = [
+        t.variableDefinition({
+            variable: t.variable({ name: 'input' }),
+            type: t.nonNullType({ type: t.namedType({ type: inputTypeName }) }),
+        }),
+    ];
+    // Mutation arguments
+    const args = [
+        t.argument({ name: 'input', value: t.variable({ name: 'input' }) }),
+    ];
+    // Field selections
+    const fieldSelections = createFieldSelections(scalarFields);
+    return t.document({
+        definitions: [
+            t.operationDefinition({
+                operation: 'mutation',
+                name: `${ucFirst(mutationName)}Mutation`,
+                variableDefinitions,
+                selectionSet: t.selectionSet({
+                    selections: [
+                        t.field({
+                            name: mutationName,
+                            args,
+                            selectionSet: t.selectionSet({
+                                selections: [
+                                    t.field({
+                                        name: singularName,
+                                        selectionSet: t.selectionSet({ selections: fieldSelections }),
+                                    }),
+                                ],
+                            }),
+                        }),
+                    ],
+                }),
+            }),
+        ],
+    });
+}
+/**
+ * Build a delete mutation AST for a table
+ */
+export function buildDeleteMutationAST(config) {
+    const { table } = config;
+    const { typeName } = getTableNames(table);
+    const mutationName = getDeleteMutationName(table);
+    const inputTypeName = `Delete${typeName}Input`;
+    // Variable definitions
+    const variableDefinitions = [
+        t.variableDefinition({
+            variable: t.variable({ name: 'input' }),
+            type: t.nonNullType({ type: t.namedType({ type: inputTypeName }) }),
+        }),
+    ];
+    // Mutation arguments
+    const args = [
+        t.argument({ name: 'input', value: t.variable({ name: 'input' }) }),
+    ];
+    return t.document({
+        definitions: [
+            t.operationDefinition({
+                operation: 'mutation',
+                name: `${ucFirst(mutationName)}Mutation`,
+                variableDefinitions,
+                selectionSet: t.selectionSet({
+                    selections: [
+                        t.field({
+                            name: mutationName,
+                            args,
+                            selectionSet: t.selectionSet({
+                                selections: [
+                                    t.field({ name: 'clientMutationId' }),
+                                    t.field({ name: 'deletedId' }),
+                                ],
+                            }),
+                        }),
+                    ],
+                }),
+            }),
+        ],
+    });
+}
+// ============================================================================
+// Print utilities
+// ============================================================================
+/**
+ * Print AST to GraphQL string
+ */
+export function printGraphQL(ast) {
+    return print(ast);
+}