nitro-graphql 2.0.0-beta.4 → 2.0.0-beta.40

package/dist/core/constants.d.mts

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

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 };