@constructive-io/graphql-codegen 3.2.0 → 3.3.0

package/core/codegen/templates/client.node.ts

@@ -1,337 +0,0 @@
-/**
- * GraphQL client configuration and execution (Node.js with native http/https)
- *
- * This is the RUNTIME code that gets copied to generated output.
- * Uses native Node.js http/https modules.
- *
- * NOTE: This file is read at codegen time and written to output.
- * Any changes here will affect all generated clients.
- */
-
-import http from 'node:http';
-import https from 'node:https';
-
-// ============================================================================
-// HTTP Request Helper
-// ============================================================================
-
-interface HttpResponse {
-  statusCode: number;
-  statusMessage: string;
-  data: string;
-}
-
-/**
- * Make an HTTP/HTTPS request using native Node modules
- */
-function makeRequest(
-  url: URL,
-  options: http.RequestOptions,
-  body: string
-): Promise<HttpResponse> {
-  return new Promise((resolve, reject) => {
-    const protocol = url.protocol === 'https:' ? https : http;
-
-    const req = protocol.request(url, options, (res) => {
-      let data = '';
-      res.setEncoding('utf8');
-      res.on('data', (chunk: string) => {
-        data += chunk;
-      });
-      res.on('end', () => {
-        resolve({
-          statusCode: res.statusCode || 0,
-          statusMessage: res.statusMessage || '',
-          data,
-        });
-      });
-    });
-
-    req.on('error', reject);
-    req.write(body);
-    req.end();
-  });
-}
-
-// ============================================================================
-// Configuration
-// ============================================================================
-
-export interface GraphQLClientConfig {
-  /** GraphQL endpoint URL */
-  endpoint: string;
-  /** Default headers to include in all requests */
-  headers?: Record<string, string>;
-  /** Dynamic headers callback called on every request */
-  getHeaders?: () => Record<string, string>;
-}
-
-let globalConfig: GraphQLClientConfig | null = null;
-
-/**
- * Configure the GraphQL client
- *
- * @example
- * ```ts
- * import { configure } from './generated';
- *
- * configure({
- *   endpoint: 'https://api.example.com/graphql',
- *   headers: {
- *     Authorization: 'Bearer <token>',
- *   },
- * });
- * ```
- */
-export function configure(config: GraphQLClientConfig): void {
-  globalConfig = config;
-}
-
-/**
- * Get the current configuration
- * @throws Error if not configured
- */
-export function getConfig(): GraphQLClientConfig {
-  if (!globalConfig) {
-    throw new Error(
-      'GraphQL client not configured. Call configure() before making requests.'
-    );
-  }
-  return globalConfig;
-}
-
-/**
- * Set a single header value
- * Useful for updating Authorization after login
- *
- * @example
- * ```ts
- * setHeader('Authorization', 'Bearer <new-token>');
- * ```
- */
-export function setHeader(key: string, value: string): void {
-  const config = getConfig();
-  globalConfig = {
-    ...config,
-    headers: { ...config.headers, [key]: value },
-  };
-}
-
-/**
- * Merge multiple headers into the current configuration
- *
- * @example
- * ```ts
- * setHeaders({ Authorization: 'Bearer <token>', 'X-Custom': 'value' });
- * ```
- */
-export function setHeaders(headers: Record<string, string>): void {
-  const config = getConfig();
-  globalConfig = {
-    ...config,
-    headers: { ...config.headers, ...headers },
-  };
-}
-
-// ============================================================================
-// Error handling
-// ============================================================================
-
-export interface GraphQLError {
-  message: string;
-  locations?: Array<{ line: number; column: number }>;
-  path?: Array<string | number>;
-  extensions?: Record<string, unknown>;
-}
-
-export class GraphQLClientError extends Error {
-  constructor(
-    message: string,
-    public errors: GraphQLError[],
-    public statusCode?: number
-  ) {
-    super(message);
-    this.name = 'GraphQLClientError';
-  }
-}
-
-// ============================================================================
-// Execution
-// ============================================================================
-
-export interface ExecuteOptions {
-  /** Override headers for this request */
-  headers?: Record<string, string>;
-}
-
-/**
- * Execute a GraphQL operation
- *
- * @example
- * ```ts
- * const result = await execute<CarsQueryResult, CarsQueryVariables>(
- *   carsQueryDocument,
- *   { first: 10 }
- * );
- * ```
- */
-export async function execute<
-  TData = unknown,
-  TVariables = Record<string, unknown>,
->(
-  document: string,
-  variables?: TVariables,
-  options?: ExecuteOptions
-): Promise<TData> {
-  const config = getConfig();
-  const url = new URL(config.endpoint);
-  const dynamicHeaders = config.getHeaders?.() ?? {};
-
-  const body = JSON.stringify({
-    query: document,
-    variables,
-  });
-
-  const requestOptions: http.RequestOptions = {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      ...config.headers,
-      ...dynamicHeaders,
-      ...options?.headers,
-    },
-  };
-
-  const response = await makeRequest(url, requestOptions, body);
-
-  if (response.statusCode < 200 || response.statusCode >= 300) {
-    throw new Error(`HTTP ${response.statusCode}: ${response.statusMessage}`);
-  }
-
-  const json = JSON.parse(response.data) as {
-    data?: TData;
-    errors?: GraphQLError[];
-  };
-
-  if (json.errors && json.errors.length > 0) {
-    throw new GraphQLClientError(
-      json.errors[0].message || 'GraphQL request failed',
-      json.errors,
-      response.statusCode
-    );
-  }
-
-  return json.data as TData;
-}
-
-/**
- * Execute a GraphQL operation with full response (data + errors)
- * Useful when you want to handle partial data with errors
- */
-export async function executeWithErrors<
-  TData = unknown,
-  TVariables = Record<string, unknown>,
->(
-  document: string,
-  variables?: TVariables,
-  options?: ExecuteOptions
-): Promise<{ data: TData | null; errors: GraphQLError[] | null }> {
-  const config = getConfig();
-  const url = new URL(config.endpoint);
-  const dynamicHeaders = config.getHeaders?.() ?? {};
-
-  const body = JSON.stringify({
-    query: document,
-    variables,
-  });
-
-  const requestOptions: http.RequestOptions = {
-    method: 'POST',
-    headers: {
-      'Content-Type': 'application/json',
-      ...config.headers,
-      ...dynamicHeaders,
-      ...options?.headers,
-    },
-  };
-
-  const response = await makeRequest(url, requestOptions, body);
-
-  if (response.statusCode < 200 || response.statusCode >= 300) {
-    return {
-      data: null,
-      errors: [{ message: `HTTP ${response.statusCode}: ${response.statusMessage}` }],
-    };
-  }
-
-  const json = JSON.parse(response.data) as {
-    data?: TData;
-    errors?: GraphQLError[];
-  };
-
-  return {
-    data: json.data ?? null,
-    errors: json.errors ?? null,
-  };
-}
-
-// ============================================================================
-// QueryClient Factory
-// ============================================================================
-
-/**
- * Default QueryClient configuration optimized for GraphQL
- *
- * These defaults provide a good balance between freshness and performance:
- * - staleTime: 1 minute - data considered fresh, won't refetch
- * - gcTime: 5 minutes - unused data kept in cache
- * - refetchOnWindowFocus: false - don't refetch when tab becomes active
- * - retry: 1 - retry failed requests once
- */
-export const defaultQueryClientOptions = {
-  defaultOptions: {
-    queries: {
-      staleTime: 1000 * 60, // 1 minute
-      gcTime: 1000 * 60 * 5, // 5 minutes
-      refetchOnWindowFocus: false,
-      retry: 1,
-    },
-  },
-};
-
-/**
- * QueryClient options type for createQueryClient
- */
-export interface CreateQueryClientOptions {
-  defaultOptions?: {
-    queries?: {
-      staleTime?: number;
-      gcTime?: number;
-      refetchOnWindowFocus?: boolean;
-      retry?: number | boolean;
-      retryDelay?: number | ((attemptIndex: number) => number);
-    };
-    mutations?: {
-      retry?: number | boolean;
-      retryDelay?: number | ((attemptIndex: number) => number);
-    };
-  };
-}
-
-// Note: createQueryClient is available when using with @tanstack/react-query
-// Import QueryClient from '@tanstack/react-query' and use these options:
-//
-// import { QueryClient } from '@tanstack/react-query';
-// const queryClient = new QueryClient(defaultQueryClientOptions);
-//
-// Or merge with your own options:
-// const queryClient = new QueryClient({
-//   ...defaultQueryClientOptions,
-//   defaultOptions: {
-//     ...defaultQueryClientOptions.defaultOptions,
-//     queries: {
-//       ...defaultQueryClientOptions.defaultOptions.queries,
-//       staleTime: 30000, // Override specific options
-//     },
-//   },
-// });

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

@@ -1,41 +0,0 @@
-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/core/codegen/gql-ast.js

@@ -1,312 +0,0 @@
-/**
- * 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, getConditionTypeName, getOrderByTypeName, getScalarFields, getPrimaryKeyInfo, 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 conditionType = getConditionTypeName(table);
-    const orderByType = getOrderByTypeName(table);
-    const scalarFields = getScalarFields(table);
-    // Variable definitions - all pagination arguments from PostGraphile
-    const variableDefinitions = [
-        t.variableDefinition({
-            variable: t.variable({ name: 'first' }),
-            type: t.namedType({ type: 'Int' }),
-        }),
-        t.variableDefinition({
-            variable: t.variable({ name: 'last' }),
-            type: t.namedType({ type: 'Int' }),
-        }),
-        t.variableDefinition({
-            variable: t.variable({ name: 'offset' }),
-            type: t.namedType({ type: 'Int' }),
-        }),
-        t.variableDefinition({
-            variable: t.variable({ name: 'before' }),
-            type: t.namedType({ type: 'Cursor' }),
-        }),
-        t.variableDefinition({
-            variable: t.variable({ name: 'after' }),
-            type: t.namedType({ type: 'Cursor' }),
-        }),
-        t.variableDefinition({
-            variable: t.variable({ name: 'filter' }),
-            type: t.namedType({ type: filterType }),
-        }),
-        t.variableDefinition({
-            variable: t.variable({ name: 'condition' }),
-            type: t.namedType({ type: conditionType }),
-        }),
-        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: 'last', value: t.variable({ name: 'last' }) }),
-        t.argument({ name: 'offset', value: t.variable({ name: 'offset' }) }),
-        t.argument({ name: 'before', value: t.variable({ name: 'before' }) }),
-        t.argument({ name: 'after', value: t.variable({ name: 'after' }) }),
-        t.argument({ name: 'filter', value: t.variable({ name: 'filter' }) }),
-        t.argument({ name: 'condition', value: t.variable({ name: 'condition' }) }),
-        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);
-    // Get primary key info dynamically from table constraints
-    const pkFields = getPrimaryKeyInfo(table);
-    // For simplicity, use first PK field (most common case)
-    const pkField = pkFields[0];
-    // Variable definitions - use dynamic PK field name and type
-    const variableDefinitions = [
-        t.variableDefinition({
-            variable: t.variable({ name: pkField.name }),
-            type: t.nonNullType({ type: t.namedType({ type: pkField.gqlType }) }),
-        }),
-    ];
-    // Query arguments - use dynamic PK field name
-    const args = [
-        t.argument({ name: pkField.name, value: t.variable({ name: pkField.name }) }),
-    ];
-    // 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' }),
-                                ],
-                            }),
-                        }),
-                    ],
-                }),
-            }),
-        ],
-    });
-}
-// ============================================================================
-// Print utilities
-// ============================================================================
-/**
- * Print AST to GraphQL string
- */
-export function printGraphQL(ast) {
-    return print(ast);
-}