nitro-graphql 2.0.0-beta.36 → 2.0.0-beta.38

package/dist/core/constants.mjs

@@ -0,0 +1,210 @@
+import { CurrencyResolver, DateTimeISOResolver, DateTimeResolver, JSONObjectResolver, JSONResolver, NonEmptyStringResolver, UUIDResolver } from "graphql-scalars";
+
+//#region src/core/constants.ts
+/**
+* Constants and magic strings used throughout nitro-graphql core
+* Centralizing these values prevents typos and makes refactoring easier
+*/
+/**
+* Default scalar type mappings for GraphQL codegen
+* These scalars are commonly used and have proper TypeScript type mappings
+*/
+const DEFAULT_GRAPHQL_SCALARS = {
+	DateTime: DateTimeResolver.extensions.codegenScalarType,
+	DateTimeISO: DateTimeISOResolver.extensions.codegenScalarType,
+	UUID: UUIDResolver.extensions.codegenScalarType,
+	JSON: JSONResolver.extensions.codegenScalarType,
+	JSONObject: JSONObjectResolver.extensions.codegenScalarType,
+	NonEmptyString: NonEmptyStringResolver.extensions.codegenScalarType,
+	Currency: CurrencyResolver.extensions.codegenScalarType,
+	File: {
+		input: "File",
+		output: "File"
+	}
+};
+/**
+* GraphQL schema file extensions
+*/
+const GRAPHQL_EXTENSIONS = [".graphql", ".gql"];
+/**
+* Resolver file extensions
+*/
+const RESOLVER_EXTENSIONS = [".resolver.ts", ".resolver.js"];
+/**
+* Directive file extensions
+*/
+const DIRECTIVE_EXTENSIONS = [".directive.ts", ".directive.js"];
+/**
+* Combined pattern for glob scanning
+*/
+const GLOB_SCAN_PATTERN = "**/*.{graphql,gql,js,mjs,cjs,ts,mts,cts,tsx,jsx}";
+/**
+* GraphQL file pattern for glob
+*/
+const GRAPHQL_GLOB_PATTERN = "**/*.graphql";
+/**
+* Resolver file pattern for glob
+*/
+const RESOLVER_GLOB_PATTERN = "**/*.resolver.{ts,js}";
+/**
+* Directive file pattern for glob
+*/
+const DIRECTIVE_GLOB_PATTERN = "**/*.directive.{ts,js}";
+/**
+* Framework names
+*/
+const FRAMEWORK_NUXT = "nuxt";
+const FRAMEWORK_NITRO = "nitro";
+const FRAMEWORK_STANDALONE = "standalone";
+/**
+* GraphQL server framework identifiers
+*/
+const GRAPHQL_FRAMEWORK_YOGA = "graphql-yoga";
+const GRAPHQL_FRAMEWORK_APOLLO = "apollo-server";
+/**
+* Default directory names for GraphQL files
+*/
+const DIR_SERVER_GRAPHQL = "server/graphql";
+const DIR_ROUTES_GRAPHQL = "routes/graphql";
+const DIR_APP_GRAPHQL = "app/graphql";
+const DIR_CLIENT_GRAPHQL = "graphql";
+const DIR_EXTERNAL = "external";
+/**
+* Windows-compatible server GraphQL directory
+*/
+const DIR_SERVER_GRAPHQL_WIN = "server\\graphql";
+/**
+* Build directory names
+*/
+const DIR_BUILD_NITRO = ".nitro";
+const DIR_BUILD_NUXT = ".nuxt";
+/**
+* Default GraphQL endpoint paths
+*/
+const ENDPOINT_GRAPHQL = "/api/graphql";
+const ENDPOINT_HEALTH = "/api/graphql/health";
+const ENDPOINT_DEBUG = "/_nitro/graphql/debug";
+/**
+* Configuration and scaffold file names
+*/
+const FILE_GRAPHQL_CONFIG = "graphql.config.ts";
+const FILE_SCHEMA_GRAPHQL = "schema.graphql";
+const FILE_SCHEMA_TS = "schema.ts";
+const FILE_CONFIG_TS = "config.ts";
+const FILE_CONTEXT_DTS = "context.d.ts";
+const FILE_CONTEXT_TS = "context.ts";
+const FILE_INDEX_TS = "index.ts";
+const FILE_OFETCH_TS = "ofetch.ts";
+const FILE_SDK_TS = "sdk.ts";
+const FILE_DIRECTIVES_GRAPHQL = "_directives.graphql";
+/**
+* Generated type definition file names
+*/
+const FILE_SERVER_TYPES = "nitro-graphql-server.d.ts";
+const FILE_CLIENT_TYPES = "nitro-graphql-client.d.ts";
+const FILE_GRAPHQL_DTS = "graphql.d.ts";
+/**
+* Generated type file name patterns with placeholders
+*/
+const PATTERN_CLIENT_EXTERNAL_TYPES = "nitro-graphql-client-{serviceName}.d.ts";
+/**
+* Rollup/Rolldown chunk output paths
+*/
+const CHUNK_PATH_GRAPHQL = "chunks/graphql/[name].mjs";
+const CHUNK_PATH_UNKNOWN = "chunks/_/[name].mjs";
+/**
+* Default chunk names
+*/
+const CHUNK_NAME_SCHEMAS = "schemas";
+const CHUNK_NAME_RESOLVERS = "resolvers";
+/**
+* Valid define function names for resolver exports
+*/
+const DEFINE_FUNCTIONS = [
+	"defineResolver",
+	"defineQuery",
+	"defineMutation",
+	"defineField",
+	"defineSubscription",
+	"defineDirective"
+];
+const DEFINE_RESOLVER = "defineResolver";
+const DEFINE_QUERY = "defineQuery";
+const DEFINE_MUTATION = "defineMutation";
+const DEFINE_FIELD = "defineField";
+const DEFINE_SUBSCRIPTION = "defineSubscription";
+const DEFINE_DIRECTIVE = "defineDirective";
+const DEFINE_GRAPHQL_CONFIG = "defineGraphQLConfig";
+const DEFINE_SCHEMA = "defineSchema";
+/**
+* Built-in GraphQL scalar types (should not be flagged as duplicates)
+*/
+const BUILTIN_SCALARS = [
+	"String",
+	"Int",
+	"Float",
+	"Boolean",
+	"ID",
+	"DateTime",
+	"JSON"
+];
+/**
+* Codegen parser dependencies (always external)
+*/
+const CODEGEN_EXTERNALS = ["oxc-parser", "@oxc-parser"];
+/**
+* Apollo Federation dependencies (external when federation disabled)
+*/
+const FEDERATION_EXTERNALS = [
+	"@apollo/subgraph",
+	"@apollo/federation-internals",
+	"@apollo/cache-control-types"
+];
+/**
+* Supported HTTP methods for GraphQL endpoints
+*/
+const GRAPHQL_HTTP_METHODS = [
+	"GET",
+	"POST",
+	"OPTIONS"
+];
+/**
+* Default paths for type generation (relative to buildDir)
+*/
+const DEFAULT_SERVER_TYPES_PATH = ".graphql/nitro-graphql-server.d.ts";
+const DEFAULT_CLIENT_TYPES_PATH = ".graphql/nitro-graphql-client.d.ts";
+/**
+* Valid resolver export types detected from AST parsing
+*/
+const RESOLVER_TYPE_QUERY = "query";
+const RESOLVER_TYPE_MUTATION = "mutation";
+const RESOLVER_TYPE_RESOLVER = "resolver";
+const RESOLVER_TYPE_TYPE = "type";
+const RESOLVER_TYPE_SUBSCRIPTION = "subscription";
+const RESOLVER_TYPE_DIRECTIVE = "directive";
+/**
+* Placeholder strings used in path resolution
+*/
+const PLACEHOLDER_SERVICE_NAME = "{serviceName}";
+const PLACEHOLDER_BUILD_DIR = "{buildDir}";
+const PLACEHOLDER_ROOT_DIR = "{rootDir}";
+const PLACEHOLDER_FRAMEWORK = "{framework}";
+const PLACEHOLDER_TYPES_DIR = "{typesDir}";
+const PLACEHOLDER_SERVER_GRAPHQL = "{serverGraphql}";
+const PLACEHOLDER_CLIENT_GRAPHQL = "{clientGraphql}";
+/**
+* Logger tag for nitro-graphql module
+*/
+const LOG_TAG = "nitro-graphql";
+/**
+* HTTP status codes for error handling
+*/
+const HTTP_STATUS_BAD_REQUEST = 400;
+const HTTP_STATUS_INTERNAL_ERROR = 500;
+/**
+* Default service directory name for main service
+*/
+const SERVICE_DEFAULT = "default";
+
+//#endregion
+export { BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, CODEGEN_EXTERNALS, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_GRAPHQL_CONFIG, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SCHEMA, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_BUILD_NITRO, DIR_BUILD_NUXT, DIR_CLIENT_GRAPHQL, DIR_EXTERNAL, DIR_ROUTES_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, FEDERATION_EXTERNALS, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_CONTEXT_TS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_GRAPHQL_DTS, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_GRAPHQL, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, FRAMEWORK_STANDALONE, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_INTERNAL_ERROR, LOG_TAG, PATTERN_CLIENT_EXTERNAL_TYPES, PLACEHOLDER_BUILD_DIR, PLACEHOLDER_CLIENT_GRAPHQL, PLACEHOLDER_FRAMEWORK, PLACEHOLDER_ROOT_DIR, PLACEHOLDER_SERVER_GRAPHQL, PLACEHOLDER_SERVICE_NAME, PLACEHOLDER_TYPES_DIR, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN, RESOLVER_TYPE_DIRECTIVE, RESOLVER_TYPE_MUTATION, RESOLVER_TYPE_QUERY, RESOLVER_TYPE_RESOLVER, RESOLVER_TYPE_SUBSCRIPTION, RESOLVER_TYPE_TYPE, SERVICE_DEFAULT };

package/dist/core/index.d.mts

@@ -0,0 +1,32 @@
+import { BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, CODEGEN_EXTERNALS, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_GRAPHQL_CONFIG, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SCHEMA, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_BUILD_NITRO, DIR_BUILD_NUXT, DIR_CLIENT_GRAPHQL, DIR_EXTERNAL, DIR_ROUTES_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, DefineFunction, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, FEDERATION_EXTERNALS, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_CONTEXT_TS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_GRAPHQL_DTS, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_GRAPHQL, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, FRAMEWORK_STANDALONE, Framework, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, GraphQLFramework, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_INTERNAL_ERROR, LOG_TAG, PATTERN_CLIENT_EXTERNAL_TYPES, PLACEHOLDER_BUILD_DIR, PLACEHOLDER_CLIENT_GRAPHQL, PLACEHOLDER_FRAMEWORK, PLACEHOLDER_ROOT_DIR, PLACEHOLDER_SERVER_GRAPHQL, PLACEHOLDER_SERVICE_NAME, PLACEHOLDER_TYPES_DIR, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN, RESOLVER_TYPE_DIRECTIVE, RESOLVER_TYPE_MUTATION, RESOLVER_TYPE_QUERY, RESOLVER_TYPE_RESOLVER, RESOLVER_TYPE_SUBSCRIPTION, RESOLVER_TYPE_TYPE, ResolverType, SERVICE_DEFAULT } from "./constants.mjs";
+import { ClientCodegenConfig, ClientCodegenInput, ClientCodegenResult, ExternalServiceCodegenConfig, ScalarType, SchemaLoadOptions, SdkCodegenConfig, ServerCodegenConfig, ServerCodegenInput, ServerCodegenResult } from "./types/codegen.mjs";
+import { CoreClientUtilsConfig, CoreCodegenConfig, CoreConfig, CoreContext, CoreExternalService, CoreFederationConfig, CoreGraphQLOptions, CoreLogger, CorePathsConfig, CoreScaffoldConfig, CoreSdkConfig, CoreSecurityConfig, CoreTypesConfig } from "./types/config.mjs";
+import { DefineDirectiveConfig, DirectiveArgument, DirectiveDefinition, Flatten, GraphQLArgumentType, GraphQLBaseType, GraphQLScalarType } from "./types/define.mjs";
+import { ResolverImport, ScanContext, ScanResult, ScannedFile, ScannedResolver } from "./types/scanning.mjs";
+import "./types/index.mjs";
+import { loadGraphQLDocuments } from "./codegen/document-loader.mjs";
+import { GraphQLLoadSchemaOptions, GraphQLTypeDefPointer, downloadAndSaveSchema, graphQLLoadSchemaSync, loadExternalSchema } from "./codegen/schema-loader.mjs";
+import { DEFAULT_CLIENT_CODEGEN_CONFIG, generateClientTypesCore, generateExternalClientTypesCore } from "./codegen/client.mjs";
+import { GENERATED_FILE_HEADER, pluginContent } from "./codegen/plugin.mjs";
+import { generateResolverModule, generateRuntimeIndex, generateSchemaModule } from "./codegen/runtime.mjs";
+import { DEFAULT_SERVER_CODEGEN_CONFIG, generateServerTypesCore, generateTypes } from "./codegen/server.mjs";
+import { validateNoDuplicateTypes } from "./codegen/validation.mjs";
+import "./codegen/index.mjs";
+import { CreateCoreConfigOptions, createCoreConfig, createCoreContext, createScanContext, mergeGraphQLOptions } from "./config.mjs";
+import { ASTScanConfig, scanWithAST } from "./scanning/ast-scanner.mjs";
+import { deduplicateFiles, extractPaths, filterByExtension, scanDirectory } from "./scanning/common.mjs";
+import { scanDirectivesCore } from "./scanning/directives.mjs";
+import { ScanDocumentsOptions, scanDocumentsCore } from "./scanning/documents.mjs";
+import { scanResolversCore } from "./scanning/resolvers.mjs";
+import { scanGraphqlCore, scanSchemasCore } from "./scanning/schemas.mjs";
+import { CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, buildGraphQLSchema, createMergedSchema } from "./schema/builder.mjs";
+import { loadFederationSupport, resetFederationCache, warnFederationUnavailable } from "./schema/federation.mjs";
+import "./schema/index.mjs";
+import { DirectiveFileRef, DirectiveParser, ParsedDirective, directiveParser, generateDirectiveSchema, generateDirectiveSchemas } from "./utils/directive-parser.mjs";
+import { MaskErrorOptions, createDefaultMaskError } from "./utils/errors.mjs";
+import { ensureDir, readFileSafe, writeFile, writeFileIfChanged } from "./utils/file-io.mjs";
+import { getImportId, relativeWithDot } from "./utils/imports.mjs";
+import { createLogger, createSilentLogger, defaultLogger } from "./utils/logger.mjs";
+import { OfetchTemplateOptions, generateOfetchTemplate } from "./utils/ofetch-templates.mjs";
+import { validateExternalServices } from "./validation/external-services.mjs";
+export { ASTScanConfig, BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, CODEGEN_EXTERNALS, ClientCodegenConfig, ClientCodegenInput, ClientCodegenResult, CoreClientUtilsConfig, CoreCodegenConfig, CoreConfig, CoreContext, CoreExternalService, CoreFederationConfig, CoreGraphQLOptions, CoreLogger, CorePathsConfig, CoreScaffoldConfig, CoreSdkConfig, CoreSecurityConfig, CoreTypesConfig, CreateCoreConfigOptions, CreateMergedSchemaOptions, DEFAULT_CLIENT_CODEGEN_CONFIG, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_SERVER_CODEGEN_CONFIG, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_GRAPHQL_CONFIG, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SCHEMA, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_BUILD_NITRO, DIR_BUILD_NUXT, DIR_CLIENT_GRAPHQL, DIR_EXTERNAL, DIR_ROUTES_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, DefineDirectiveConfig, DefineFunction, DirectiveArgument, DirectiveDefinition, DirectiveFileRef, DirectiveParser, DirectiveWrapper, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, ExternalServiceCodegenConfig, FEDERATION_EXTERNALS, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_CONTEXT_TS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_GRAPHQL_DTS, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_GRAPHQL, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, FRAMEWORK_STANDALONE, Flatten, Framework, GENERATED_FILE_HEADER, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, GraphQLArgumentType, GraphQLBaseType, GraphQLFramework, GraphQLLoadSchemaOptions, GraphQLScalarType, GraphQLTypeDefPointer, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_INTERNAL_ERROR, LOG_TAG, MaskErrorOptions, ModuleConfig, OfetchTemplateOptions, PATTERN_CLIENT_EXTERNAL_TYPES, PLACEHOLDER_BUILD_DIR, PLACEHOLDER_CLIENT_GRAPHQL, PLACEHOLDER_FRAMEWORK, PLACEHOLDER_ROOT_DIR, PLACEHOLDER_SERVER_GRAPHQL, PLACEHOLDER_SERVICE_NAME, PLACEHOLDER_TYPES_DIR, ParsedDirective, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN, RESOLVER_TYPE_DIRECTIVE, RESOLVER_TYPE_MUTATION, RESOLVER_TYPE_QUERY, RESOLVER_TYPE_RESOLVER, RESOLVER_TYPE_SUBSCRIPTION, RESOLVER_TYPE_TYPE, ResolverDefinition, ResolverImport, ResolverType, SERVICE_DEFAULT, ScalarType, ScanContext, ScanDocumentsOptions, ScanResult, ScannedFile, ScannedResolver, SchemaDefinition, SchemaLoadOptions, SdkCodegenConfig, ServerCodegenConfig, ServerCodegenInput, ServerCodegenResult, buildGraphQLSchema, createCoreConfig, createCoreContext, createDefaultMaskError, createLogger, createMergedSchema, createScanContext, createSilentLogger, deduplicateFiles, defaultLogger, directiveParser, downloadAndSaveSchema, ensureDir, extractPaths, filterByExtension, generateClientTypesCore, generateDirectiveSchema, generateDirectiveSchemas, generateExternalClientTypesCore, generateOfetchTemplate, generateResolverModule, generateRuntimeIndex, generateSchemaModule, generateServerTypesCore, generateTypes, getImportId, graphQLLoadSchemaSync, loadExternalSchema, loadFederationSupport, loadGraphQLDocuments, mergeGraphQLOptions, pluginContent, readFileSafe, relativeWithDot, resetFederationCache, scanDirectivesCore, scanDirectory, scanDocumentsCore, scanGraphqlCore, scanResolversCore, scanSchemasCore, scanWithAST, validateExternalServices, validateNoDuplicateTypes, warnFederationUnavailable, writeFile, writeFileIfChanged };

package/dist/core/index.mjs

@@ -0,0 +1,26 @@
+import { BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, CODEGEN_EXTERNALS, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_GRAPHQL_CONFIG, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SCHEMA, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_BUILD_NITRO, DIR_BUILD_NUXT, DIR_CLIENT_GRAPHQL, DIR_EXTERNAL, DIR_ROUTES_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, FEDERATION_EXTERNALS, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_CONTEXT_TS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_GRAPHQL_DTS, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_GRAPHQL, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, FRAMEWORK_STANDALONE, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_INTERNAL_ERROR, LOG_TAG, PATTERN_CLIENT_EXTERNAL_TYPES, PLACEHOLDER_BUILD_DIR, PLACEHOLDER_CLIENT_GRAPHQL, PLACEHOLDER_FRAMEWORK, PLACEHOLDER_ROOT_DIR, PLACEHOLDER_SERVER_GRAPHQL, PLACEHOLDER_SERVICE_NAME, PLACEHOLDER_TYPES_DIR, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN, RESOLVER_TYPE_DIRECTIVE, RESOLVER_TYPE_MUTATION, RESOLVER_TYPE_QUERY, RESOLVER_TYPE_RESOLVER, RESOLVER_TYPE_SUBSCRIPTION, RESOLVER_TYPE_TYPE, SERVICE_DEFAULT } from "./constants.mjs";
+import { GENERATED_FILE_HEADER, pluginContent } from "./codegen/plugin.mjs";
+import { loadGraphQLDocuments } from "./codegen/document-loader.mjs";
+import { ensureDir, readFileSafe, writeFile, writeFileIfChanged } from "./utils/file-io.mjs";
+import { downloadAndSaveSchema, graphQLLoadSchemaSync, loadExternalSchema } from "./codegen/schema-loader.mjs";
+import { DEFAULT_CLIENT_CODEGEN_CONFIG, generateClientTypesCore, generateExternalClientTypesCore } from "./codegen/client.mjs";
+import { generateResolverModule, generateRuntimeIndex, generateSchemaModule } from "./codegen/runtime.mjs";
+import { DEFAULT_SERVER_CODEGEN_CONFIG, generateServerTypesCore, generateTypes } from "./codegen/server.mjs";
+import { validateNoDuplicateTypes } from "./codegen/validation.mjs";
+import { createLogger, createSilentLogger, defaultLogger } from "./utils/logger.mjs";
+import { createCoreConfig, createCoreContext, createScanContext, mergeGraphQLOptions } from "./config.mjs";
+import { deduplicateFiles, extractPaths, filterByExtension, scanDirectory } from "./scanning/common.mjs";
+import { scanWithAST } from "./scanning/ast-scanner.mjs";
+import { scanDirectivesCore } from "./scanning/directives.mjs";
+import { scanDocumentsCore } from "./scanning/documents.mjs";
+import { scanResolversCore } from "./scanning/resolvers.mjs";
+import { scanGraphqlCore, scanSchemasCore } from "./scanning/schemas.mjs";
+import { loadFederationSupport, resetFederationCache, warnFederationUnavailable } from "./schema/federation.mjs";
+import { buildGraphQLSchema, createMergedSchema } from "./schema/builder.mjs";
+import { DirectiveParser, directiveParser, generateDirectiveSchema, generateDirectiveSchemas } from "./utils/directive-parser.mjs";
+import { createDefaultMaskError } from "./utils/errors.mjs";
+import { getImportId, relativeWithDot } from "./utils/imports.mjs";
+import { generateOfetchTemplate } from "./utils/ofetch-templates.mjs";
+import { validateExternalServices } from "./validation/external-services.mjs";
+
+export { BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, CODEGEN_EXTERNALS, DEFAULT_CLIENT_CODEGEN_CONFIG, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_SERVER_CODEGEN_CONFIG, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_GRAPHQL_CONFIG, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SCHEMA, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_BUILD_NITRO, DIR_BUILD_NUXT, DIR_CLIENT_GRAPHQL, DIR_EXTERNAL, DIR_ROUTES_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, DirectiveParser, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, FEDERATION_EXTERNALS, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_CONTEXT_TS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_GRAPHQL_DTS, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_GRAPHQL, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, FRAMEWORK_STANDALONE, GENERATED_FILE_HEADER, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_INTERNAL_ERROR, LOG_TAG, PATTERN_CLIENT_EXTERNAL_TYPES, PLACEHOLDER_BUILD_DIR, PLACEHOLDER_CLIENT_GRAPHQL, PLACEHOLDER_FRAMEWORK, PLACEHOLDER_ROOT_DIR, PLACEHOLDER_SERVER_GRAPHQL, PLACEHOLDER_SERVICE_NAME, PLACEHOLDER_TYPES_DIR, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN, RESOLVER_TYPE_DIRECTIVE, RESOLVER_TYPE_MUTATION, RESOLVER_TYPE_QUERY, RESOLVER_TYPE_RESOLVER, RESOLVER_TYPE_SUBSCRIPTION, RESOLVER_TYPE_TYPE, SERVICE_DEFAULT, buildGraphQLSchema, createCoreConfig, createCoreContext, createDefaultMaskError, createLogger, createMergedSchema, createScanContext, createSilentLogger, deduplicateFiles, defaultLogger, directiveParser, downloadAndSaveSchema, ensureDir, extractPaths, filterByExtension, generateClientTypesCore, generateDirectiveSchema, generateDirectiveSchemas, generateExternalClientTypesCore, generateOfetchTemplate, generateResolverModule, generateRuntimeIndex, generateSchemaModule, generateServerTypesCore, generateTypes, getImportId, graphQLLoadSchemaSync, loadExternalSchema, loadFederationSupport, loadGraphQLDocuments, mergeGraphQLOptions, pluginContent, readFileSafe, relativeWithDot, resetFederationCache, scanDirectivesCore, scanDirectory, scanDocumentsCore, scanGraphqlCore, scanResolversCore, scanSchemasCore, scanWithAST, validateExternalServices, validateNoDuplicateTypes, warnFederationUnavailable, writeFile, writeFileIfChanged };

package/dist/core/scanning/ast-scanner.d.mts

@@ -0,0 +1,23 @@
+import { ResolverImport, ScanContext, ScanResult, ScannedResolver } from "../types/scanning.mjs";
+
+//#region src/core/scanning/ast-scanner.d.ts
+
+/**
+ * Configuration for AST-based scanning
+ */
+interface ASTScanConfig {
+  /** Glob pattern for files to scan */
+  pattern: string;
+  /** Parse a function call and return import info, or null if not a valid export */
+  parseCall: (calleeName: string, exportName: string, filePath: string) => ResolverImport | null;
+  /** Whether to emit warnings for common issues (default: true for resolvers) */
+  emitWarnings?: boolean;
+  /** Valid function names for warning messages */
+  validFunctions?: readonly string[];
+}
+/**
+ * Scan files matching a pattern and parse their exports using AST
+ */
+declare function scanWithAST(ctx: ScanContext, config: ASTScanConfig): Promise<ScanResult<ScannedResolver>>;
+//#endregion
+export { ASTScanConfig, scanWithAST };

package/dist/core/scanning/ast-scanner.mjs

@@ -0,0 +1,103 @@
+import { scanWithLayers } from "./common.mjs";
+import { readFile } from "node:fs/promises";
+import { basename, relative } from "pathe";
+import { parseSync } from "oxc-parser";
+
+//#region src/core/scanning/ast-scanner.ts
+/**
+* Scan files matching a pattern and parse their exports using AST
+*/
+async function scanWithAST(ctx, config) {
+	const warnings = [];
+	const errors = [];
+	try {
+		const serverDirRelative = relative(ctx.rootDir, ctx.serverDir);
+		const files = await scanWithLayers(ctx, {
+			mainDir: ctx.rootDir,
+			mainSubDir: serverDirRelative,
+			layerDirs: ctx.layerServerDirs,
+			layerSubDir: "graphql",
+			pattern: config.pattern
+		});
+		const results = [];
+		for (const file of files) try {
+			const fileContent = await readFile(file.fullPath, "utf-8");
+			const parsed = parseSync(file.fullPath, fileContent);
+			if (parsed.errors && parsed.errors.length > 0) {
+				if (ctx.isDev) {
+					const fileName = basename(file.fullPath);
+					const firstError = parsed.errors[0];
+					const location = firstError?.labels?.[0];
+					const lineInfo = location ? `:${location.start}` : "";
+					const message = firstError?.message.split(",")[0] || "Syntax error";
+					errors.push(`${fileName}${lineInfo} - ${message}`);
+				}
+				continue;
+			}
+			const result = parseExports(file.fullPath, parsed.program, config);
+			if (ctx.isDev && config.emitWarnings && result.warnings.length > 0) {
+				const relPath = relative(ctx.rootDir, file.fullPath);
+				for (const warning of result.warnings) warnings.push(`${relPath}: ${warning}`);
+			}
+			if (result.resolver.imports.length > 0) results.push(result.resolver);
+		} catch (error) {
+			const relPath = relative(ctx.rootDir, file.fullPath);
+			errors.push(`Failed to parse file ${relPath}: ${error}`);
+		}
+		return {
+			items: results,
+			warnings,
+			errors
+		};
+	} catch (error) {
+		errors.push(`Scanning error: ${error}`);
+		return {
+			items: [],
+			warnings,
+			errors
+		};
+	}
+}
+/**
+* Parse exports from AST program
+*/
+function parseExports(filePath, program, config) {
+	const warnings = [];
+	const resolver = {
+		specifier: filePath,
+		imports: []
+	};
+	let hasDefaultExport = false;
+	let hasNamedExport = false;
+	const namedExports = [];
+	for (const node of program.body) {
+		if (node.type === "ExportDefaultDeclaration") hasDefaultExport = true;
+		if (node.type === "ExportNamedDeclaration" && node.declaration && node.declaration.type === "VariableDeclaration") {
+			for (const decl of node.declaration.declarations) if (decl.type === "VariableDeclarator" && decl.init && decl.id.type === "Identifier") {
+				hasNamedExport = true;
+				namedExports.push(decl.id.name);
+				if (decl.init && decl.init.type === "CallExpression") {
+					if (decl.init.callee.type === "Identifier") {
+						const imp = config.parseCall(decl.init.callee.name, decl.id.name, filePath);
+						if (imp) resolver.imports.push(imp);
+					}
+				}
+			}
+		}
+	}
+	if (config.emitWarnings) {
+		if (hasDefaultExport && !hasNamedExport) warnings.push("Using default export instead of named export. Must use named exports like \"export const myResolver = defineQuery(...)\". Default exports are not detected.");
+		if (resolver.imports.length === 0 && hasNamedExport) {
+			const validFunctions = config.validFunctions?.join(", ") || "define* functions";
+			warnings.push(`File has named exports [${namedExports.join(", ")}] but none use the required define functions (${validFunctions}). Exports will not be registered.`);
+		}
+		if (!hasDefaultExport && !hasNamedExport) warnings.push("No exports found. Files must export using define* functions.");
+	}
+	return {
+		resolver,
+		warnings
+	};
+}
+
+//#endregion
+export { scanWithAST };

package/dist/core/scanning/common.d.mts

@@ -0,0 +1,37 @@
+import { ScanContext, ScannedFile } from "../types/scanning.mjs";
+
+//#region src/core/scanning/common.d.ts
+
+/**
+ * Scan a directory for files matching a glob pattern
+ */
+declare function scanDirectory(ctx: ScanContext, baseDir: string, subDir: string, globPattern?: string): Promise<ScannedFile[]>;
+/**
+ * Deduplicate files by fullPath
+ */
+declare function deduplicateFiles<T extends {
+  fullPath: string;
+}>(files: T[]): T[];
+/**
+ * Filter files by extension
+ */
+declare function filterByExtension<T extends {
+  fullPath: string;
+}>(files: T[], extensions: readonly string[]): T[];
+/**
+ * Extract file paths from scanned files
+ */
+declare function extractPaths(files: ScannedFile[]): string[];
+/**
+ * Scan directory with layer support
+ * Encapsulates the common pattern of scanning main directory + layer directories
+ */
+declare function scanWithLayers(ctx: ScanContext, options: {
+  mainDir: string;
+  mainSubDir: string;
+  layerDirs: string[] | undefined;
+  layerSubDir: string;
+  pattern: string;
+}): Promise<ScannedFile[]>;
+//#endregion
+export { deduplicateFiles, extractPaths, filterByExtension, scanDirectory, scanWithLayers };

package/dist/core/scanning/common.mjs

@@ -0,0 +1,60 @@
+import { GLOB_SCAN_PATTERN } from "../constants.mjs";
+import { join, relative } from "pathe";
+import { glob } from "tinyglobby";
+
+//#region src/core/scanning/common.ts
+/**
+* Scan a directory for files matching a glob pattern
+*/
+async function scanDirectory(ctx, baseDir, subDir, globPattern = GLOB_SCAN_PATTERN) {
+	return (await glob(join(subDir, globPattern), {
+		cwd: baseDir,
+		dot: true,
+		ignore: ctx.ignorePatterns,
+		absolute: true
+	}).catch((error) => {
+		if (error?.code === "ENOTDIR") {
+			ctx.logger.warn(`Ignoring \`${join(baseDir, subDir)}\`. It must be a directory.`);
+			return [];
+		}
+		throw error;
+	})).map((fullPath) => ({
+		fullPath,
+		path: relative(join(baseDir, subDir), fullPath)
+	})).sort((a, b) => a.path.localeCompare(b.path));
+}
+/**
+* Deduplicate files by fullPath
+*/
+function deduplicateFiles(files) {
+	const seenPaths = /* @__PURE__ */ new Set();
+	return files.filter((file) => {
+		if (seenPaths.has(file.fullPath)) return false;
+		seenPaths.add(file.fullPath);
+		return true;
+	});
+}
+/**
+* Filter files by extension
+*/
+function filterByExtension(files, extensions) {
+	return files.filter((file) => extensions.some((ext) => file.fullPath.endsWith(ext)));
+}
+/**
+* Extract file paths from scanned files
+*/
+function extractPaths(files) {
+	return files.map((f) => f.fullPath);
+}
+/**
+* Scan directory with layer support
+* Encapsulates the common pattern of scanning main directory + layer directories
+*/
+async function scanWithLayers(ctx, options) {
+	const mainFiles = await scanDirectory(ctx, options.mainDir, options.mainSubDir, options.pattern);
+	const layerFiles = await Promise.all((options.layerDirs || []).map((layerDir) => scanDirectory(ctx, layerDir, options.layerSubDir, options.pattern))).then((r) => r.flat());
+	return deduplicateFiles([...mainFiles, ...layerFiles]);
+}
+
+//#endregion
+export { deduplicateFiles, extractPaths, filterByExtension, scanDirectory, scanWithLayers };

package/dist/core/scanning/directives.d.mts

@@ -0,0 +1,10 @@
+import { ScanContext, ScanResult, ScannedResolver } from "../types/scanning.mjs";
+
+//#region src/core/scanning/directives.d.ts
+
+/**
+ * Scan for directive files (.directive.ts/.js)
+ */
+declare function scanDirectivesCore(ctx: ScanContext): Promise<ScanResult<ScannedResolver>>;
+//#endregion
+export { scanDirectivesCore };

package/dist/core/scanning/directives.mjs

@@ -0,0 +1,29 @@
+import { DIRECTIVE_GLOB_PATTERN } from "../constants.mjs";
+import { scanWithAST } from "./ast-scanner.mjs";
+import { hash } from "ohash";
+
+//#region src/core/scanning/directives.ts
+/**
+* Parse a defineDirective call and return the import info
+*/
+function parseDirectiveCall(calleeName, exportName, filePath) {
+	if (calleeName !== "defineDirective") return null;
+	return {
+		name: exportName,
+		type: "directive",
+		as: `_${hash(exportName + filePath).replace(/-/g, "").slice(0, 6)}`
+	};
+}
+/**
+* Scan for directive files (.directive.ts/.js)
+*/
+function scanDirectivesCore(ctx) {
+	return scanWithAST(ctx, {
+		pattern: DIRECTIVE_GLOB_PATTERN,
+		parseCall: parseDirectiveCall,
+		emitWarnings: false
+	});
+}
+
+//#endregion
+export { scanDirectivesCore };

package/dist/core/scanning/documents.d.mts

@@ -0,0 +1,21 @@
+import { CoreExternalService } from "../types/config.mjs";
+import { ScanContext, ScanResult } from "../types/scanning.mjs";
+
+//#region src/core/scanning/documents.d.ts
+
+/**
+ * Options for scanning documents
+ */
+interface ScanDocumentsOptions {
+  /** External services to exclude from main scan */
+  externalServices?: CoreExternalService[];
+  /** Client directory relative path */
+  clientDirRelative?: string;
+}
+/**
+ * Scan for GraphQL client documents (.graphql) in client directory
+ * Excludes files from external service directories
+ */
+declare function scanDocumentsCore(ctx: ScanContext, options?: ScanDocumentsOptions): Promise<ScanResult<string>>;
+//#endregion
+export { ScanDocumentsOptions, scanDocumentsCore };

package/dist/core/scanning/documents.mjs

@@ -0,0 +1,43 @@
+import { GRAPHQL_GLOB_PATTERN } from "../constants.mjs";
+import { scanWithLayers } from "./common.mjs";
+import { relative } from "pathe";
+
+//#region src/core/scanning/documents.ts
+/**
+* Scan for GraphQL client documents (.graphql) in client directory
+* Excludes files from external service directories
+*/
+async function scanDocumentsCore(ctx, options = {}) {
+	const warnings = [];
+	const errors = [];
+	try {
+		const clientDirRelative = options.clientDirRelative || relative(ctx.rootDir, ctx.clientDir);
+		const allFiles = await scanWithLayers(ctx, {
+			mainDir: ctx.rootDir,
+			mainSubDir: clientDirRelative,
+			layerDirs: ctx.layerAppDirs,
+			layerSubDir: "graphql",
+			pattern: GRAPHQL_GLOB_PATTERN
+		});
+		const externalPatterns = (options.externalServices || []).flatMap((service) => service.documents || []);
+		return {
+			items: allFiles.filter((f) => !f.path.startsWith("external/")).filter((f) => {
+				const relativePath = f.path;
+				for (const pattern of externalPatterns) if (pattern.replace(/* @__PURE__ */ new RegExp(`^${clientDirRelative.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/`), "").split("/")[0] === relativePath.split("/")[0]) return false;
+				return true;
+			}).map((f) => f.fullPath),
+			warnings,
+			errors
+		};
+	} catch (error) {
+		errors.push(`Document scanning error: ${error}`);
+		return {
+			items: [],
+			warnings,
+			errors
+		};
+	}
+}
+
+//#endregion
+export { scanDocumentsCore };

package/dist/core/scanning/index.d.mts

@@ -0,0 +1,7 @@
+import { ASTScanConfig, scanWithAST } from "./ast-scanner.mjs";
+import { deduplicateFiles, extractPaths, filterByExtension, scanDirectory } from "./common.mjs";
+import { scanDirectivesCore } from "./directives.mjs";
+import { ScanDocumentsOptions, scanDocumentsCore } from "./documents.mjs";
+import { scanResolversCore } from "./resolvers.mjs";
+import { scanGraphqlCore, scanSchemasCore } from "./schemas.mjs";
+export { type ASTScanConfig, type ScanDocumentsOptions, deduplicateFiles, extractPaths, filterByExtension, scanDirectivesCore, scanDirectory, scanDocumentsCore, scanGraphqlCore, scanResolversCore, scanSchemasCore, scanWithAST };

package/dist/core/scanning/index.mjs

@@ -0,0 +1,8 @@
+import { deduplicateFiles, extractPaths, filterByExtension, scanDirectory } from "./common.mjs";
+import { scanWithAST } from "./ast-scanner.mjs";
+import { scanDirectivesCore } from "./directives.mjs";
+import { scanDocumentsCore } from "./documents.mjs";
+import { scanResolversCore } from "./resolvers.mjs";
+import { scanGraphqlCore, scanSchemasCore } from "./schemas.mjs";
+
+export { deduplicateFiles, extractPaths, filterByExtension, scanDirectivesCore, scanDirectory, scanDocumentsCore, scanGraphqlCore, scanResolversCore, scanSchemasCore, scanWithAST };

package/dist/core/scanning/resolvers.d.mts

@@ -0,0 +1,10 @@
+import { ScanContext, ScanResult, ScannedResolver } from "../types/scanning.mjs";
+
+//#region src/core/scanning/resolvers.d.ts
+
+/**
+ * Scan for resolver files and parse their exports
+ */
+declare function scanResolversCore(ctx: ScanContext): Promise<ScanResult<ScannedResolver>>;
+//#endregion
+export { scanResolversCore };