nitro-graphql 2.0.0-beta.1 → 2.0.0-beta.11

package/dist/index.d.ts

@@ -1,8 +1,8 @@
 import { StandardSchemaV1 } from "./types/standard-schema.js";
-import { CodegenClientConfig, CodegenServerConfig, ExternalGraphQLService, FederationConfig, GenImport, GenericSdkConfig, NitroGraphQLOptions } from "./types/index.js";
+import { ClientUtilsConfig, CodegenClientConfig, CodegenServerConfig, ExternalGraphQLService, ExternalServicePaths, FederationConfig, FileGenerationConfig, GenImport, GenericSdkConfig, NitroGraphQLOptions, PathsConfig, ScaffoldConfig, SdkConfig, TypesConfig } from "./types/index.js";
 import * as nitro_types0 from "nitro/types";
 
 //#region src/index.d.ts
 declare const _default: nitro_types0.NitroModule;
 //#endregion
-export { CodegenClientConfig, CodegenServerConfig, ExternalGraphQLService, FederationConfig, GenImport, GenericSdkConfig, NitroGraphQLOptions, StandardSchemaV1, _default as default };
+export { ClientUtilsConfig, CodegenClientConfig, CodegenServerConfig, ExternalGraphQLService, ExternalServicePaths, FederationConfig, FileGenerationConfig, GenImport, GenericSdkConfig, NitroGraphQLOptions, PathsConfig, ScaffoldConfig, SdkConfig, StandardSchemaV1, TypesConfig, _default as default };

package/dist/index.js

@@ -1,8 +1,10 @@
 import { generateDirectiveSchemas } from "./utils/directive-parser.js";
 import { generateLayerIgnorePatterns, getLayerAppDirectories, getLayerServerDirectories, relativeWithDot, scanDirectives, scanDocs, scanResolvers, scanSchemas, validateExternalServices } from "./utils/index.js";
+import { writeFileIfNotExists } from "./utils/file-generator.js";
+import { getScaffoldConfig, resolveFilePath, shouldGenerateScaffold } from "./utils/path-resolver.js";
 import { clientTypeGeneration, serverTypeGeneration } from "./utils/type-generation.js";
 import { rollupConfig } from "./rollup.js";
-import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { existsSync, mkdirSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { watch } from "chokidar";
 import consola from "consola";
@@ -23,11 +25,13 @@ var src_default = defineNitroModule({
 			}
 			consola.info(`Configured ${nitro.options.graphql.externalServices.length} external GraphQL services`);
 		}
+		const { getDefaultPaths: getDefaultPaths$1 } = await import("./utils/path-resolver.js");
+		const defaultPaths = getDefaultPaths$1(nitro);
 		nitro.graphql ||= {
 			buildDir: "",
 			watchDirs: [],
-			clientDir: "",
-			serverDir: resolve(nitro.options.srcDir, "graphql"),
+			clientDir: defaultPaths.clientGraphql,
+			serverDir: defaultPaths.serverGraphql,
 			dir: {
 				build: relative(nitro.options.rootDir, nitro.options.buildDir),
 				client: "graphql",
@@ -59,11 +63,8 @@ var src_default = defineNitroModule({
 		const watchDirs = [];
 		switch (nitro.options.framework.name) {
 			case "nuxt": {
-				if (!nitro.graphql.clientDir) {
-					nitro.graphql.clientDir = resolve(nitro.options.rootDir, "app", "graphql");
-					nitro.graphql.dir.client = "app/graphql";
-				}
-				if (!nitro.options.graphql?.serverDir) nitro.graphql.serverDir = resolve(nitro.options.rootDir, "server", "graphql");
+				nitro.graphql.dir.client = relative(nitro.options.rootDir, nitro.graphql.clientDir);
+				nitro.graphql.dir.server = relative(nitro.options.rootDir, nitro.graphql.serverDir);
 				watchDirs.push(nitro.graphql.clientDir);
 				const layerServerDirs = getLayerServerDirectories(nitro);
 				const layerAppDirs = getLayerAppDirectories(nitro);
@@ -72,8 +73,10 @@ var src_default = defineNitroModule({
 				break;
 			}
 			case "nitro":
-				nitro.graphql.clientDir = resolve(nitro.options.rootDir, "graphql");
-				nitro.graphql.dir.client = "graphql";
+				nitro.graphql.dir.client = relative(nitro.options.rootDir, nitro.graphql.clientDir);
+				nitro.graphql.dir.server = relative(nitro.options.rootDir, nitro.graphql.serverDir);
+				watchDirs.push(nitro.graphql.clientDir);
+				watchDirs.push(nitro.graphql.serverDir);
 				break;
 			default:
 		}
@@ -90,7 +93,11 @@ var src_default = defineNitroModule({
 			ignoreInitial: true,
 			ignored: [...nitro.options.ignore, ...generateLayerIgnorePatterns(nitro)]
 		}).on("all", async (_, path) => {
-			if (path.endsWith(".graphql") || path.endsWith(".gql")) await clientTypeGeneration(nitro);
+			if (path.endsWith(".graphql") || path.endsWith(".gql")) if (path.includes(nitro.graphql.serverDir) || path.includes("server/graphql") || path.includes("server\\graphql")) {
+				await serverTypeGeneration(nitro);
+				await clientTypeGeneration(nitro);
+				await nitro.hooks.callHook("dev:reload");
+			} else await clientTypeGeneration(nitro);
 		});
 		nitro.hooks.hook("close", () => {
 			watcher.close();
@@ -104,12 +111,53 @@ var src_default = defineNitroModule({
 		nitro.scanDirectives = directives;
 		await generateDirectiveSchemas(nitro, directives);
 		nitro.hooks.hook("dev:start", async () => {
-			nitro.scanSchemas = await scanSchemas(nitro);
-			nitro.scanResolvers = await scanResolvers(nitro);
+			const schemas = await scanSchemas(nitro);
+			nitro.scanSchemas = schemas;
+			const resolvers = await scanResolvers(nitro);
+			nitro.scanResolvers = resolvers;
 			const directives$1 = await scanDirectives(nitro);
 			nitro.scanDirectives = directives$1;
 			await generateDirectiveSchemas(nitro, directives$1);
-			nitro.scanDocuments = await scanDocs(nitro);
+			const docs = await scanDocs(nitro);
+			nitro.scanDocuments = docs;
+			if (nitro.options.dev) {
+				consola.box({
+					title: "Nitro GraphQL",
+					message: [
+						`Framework: ${nitro.options.graphql?.framework || "Not configured"}`,
+						`Schemas: ${schemas.length}`,
+						`Resolvers: ${resolvers.length}`,
+						`Directives: ${directives$1.length}`,
+						`Documents: ${docs.length}`,
+						"",
+						"Debug Dashboard: /_nitro/graphql/debug"
+					].join("\n"),
+					style: {
+						borderColor: "cyan",
+						borderStyle: "rounded"
+					}
+				});
+				if (resolvers.length > 0) {
+					const totalExports = resolvers.reduce((sum, r) => sum + r.imports.length, 0);
+					const typeCount = {
+						query: 0,
+						mutation: 0,
+						resolver: 0,
+						type: 0,
+						subscription: 0,
+						directive: 0
+					};
+					for (const resolver of resolvers) for (const imp of resolver.imports) if (imp.type in typeCount) typeCount[imp.type]++;
+					const breakdown = [];
+					if (typeCount.query > 0) breakdown.push(`${typeCount.query} query`);
+					if (typeCount.mutation > 0) breakdown.push(`${typeCount.mutation} mutation`);
+					if (typeCount.resolver > 0) breakdown.push(`${typeCount.resolver} resolver`);
+					if (typeCount.type > 0) breakdown.push(`${typeCount.type} type`);
+					if (typeCount.subscription > 0) breakdown.push(`${typeCount.subscription} subscription`);
+					if (typeCount.directive > 0) breakdown.push(`${typeCount.directive} directive`);
+					if (breakdown.length > 0) consola.success(`[nitro-graphql] ${totalExports} resolver export(s): ${breakdown.join(", ")}`);
+				} else consola.warn("[nitro-graphql] No resolvers found. Check /_nitro/graphql/debug for details.");
+			}
 		});
 		await rollupConfig(nitro);
 		await serverTypeGeneration(nitro);
@@ -139,6 +187,14 @@ var src_default = defineNitroModule({
 			handler: join(runtime, "health"),
 			method: "GET"
 		});
+		if (nitro.options.dev) {
+			nitro.options.handlers.push({
+				route: "/_nitro/graphql/debug",
+				handler: join(runtime, "debug"),
+				method: "GET"
+			});
+			consola.info("[nitro-graphql] Debug dashboard available at: /_nitro/graphql/debug");
+		}
 		if (nitro.options.imports) {
 			nitro.options.imports.presets ??= [];
 			nitro.options.imports.presets.push({
@@ -158,11 +214,20 @@ var src_default = defineNitroModule({
 		nitro.hooks.hook("rollup:before", (_, rollupConfig$1) => {
 			const manualChunks = rollupConfig$1.output?.manualChunks;
 			const chunkFiles = rollupConfig$1.output?.chunkFileNames;
-			if (!rollupConfig$1.output.inlineDynamicImports) rollupConfig$1.output.manualChunks = (id, meta) => {
-				if (id.endsWith(".graphql") || id.endsWith(".gql")) return "schemas";
-				if (id.endsWith(".resolver.ts")) return "resolvers";
-				if (typeof manualChunks === "function") return manualChunks(id, meta);
-			};
+			if (!rollupConfig$1.output.inlineDynamicImports) {
+				rollupConfig$1.output.manualChunks = (id, meta) => {
+					if (id.endsWith(".graphql") || id.endsWith(".gql")) return "schemas";
+					if (id.endsWith(".resolver.ts")) return "resolvers";
+					if (typeof manualChunks === "function") return manualChunks(id, meta);
+				};
+				rollupConfig$1.output.advancedChunks = { groups: [{
+					name: "schemas",
+					test: /\.(?:graphql|gql)$/
+				}, {
+					name: "resolvers",
+					test: /\.resolver\.ts$/
+				}] };
+			}
 			rollupConfig$1.output.chunkFileNames = (chunkInfo) => {
 				if (chunkInfo.moduleIds && chunkInfo.moduleIds.some((id) => id.endsWith(".graphql") || id.endsWith(".resolver.ts") || id.endsWith(".gql"))) return `chunks/graphql/[name].mjs`;
 				if (typeof chunkFiles === "function") return chunkFiles(chunkInfo);
@@ -186,33 +251,39 @@ var src_default = defineNitroModule({
 			const nuxtOptions = nitro._nuxt?.options;
 			if (nuxtOptions) nuxtOptions.nitroGraphqlExternalServices = nitro.options.graphql?.externalServices || [];
 		});
-		if (!existsSync(join(nitro.options.rootDir, "graphql.config.ts"))) {
-			const schemaPath = relativeWithDot(nitro.options.rootDir, resolve(nitro.graphql.buildDir, "schema.graphql"));
-			const documentsPath = relativeWithDot(nitro.options.rootDir, resolve(nitro.graphql.clientDir, "**/*.{graphql,js,ts,jsx,tsx}"));
-			writeFileSync(join(nitro.options.rootDir, "graphql.config.ts"), `
+		if (shouldGenerateScaffold(nitro)) {
+			const placeholders = getDefaultPaths$1(nitro);
+			const scaffoldConfig = getScaffoldConfig(nitro);
+			const graphqlConfigPath = resolveFilePath(scaffoldConfig.graphqlConfig, scaffoldConfig.enabled, true, "graphql.config.ts", placeholders);
+			if (graphqlConfigPath) writeFileIfNotExists(graphqlConfigPath, `
 import type { IGraphQLConfig } from 'graphql-config'
 
 export default <IGraphQLConfig> {
     projects: {
       default: {
         schema: [
-          '${schemaPath}',
+          '${relativeWithDot(nitro.options.rootDir, resolve(nitro.graphql.buildDir, "schema.graphql"))}',
         ],
         documents: [
-          '${documentsPath}',
+          '${relativeWithDot(nitro.options.rootDir, resolve(nitro.graphql.clientDir, "**/*.{graphql,js,ts,jsx,tsx}"))}',
         ],
       },
     },
-}`, "utf-8");
-		}
-		if (!existsSync(nitro.graphql.serverDir)) mkdirSync(nitro.graphql.serverDir, { recursive: true });
-		if (!existsSync(join(nitro.graphql.serverDir, "schema.ts"))) writeFileSync(join(nitro.graphql.serverDir, "schema.ts"), `export default defineSchema({
+}`, "graphql.config.ts");
+			const serverSchemaPath = resolveFilePath(scaffoldConfig.serverSchema, scaffoldConfig.enabled, true, "{serverGraphql}/schema.ts", placeholders);
+			const serverConfigPath = resolveFilePath(scaffoldConfig.serverConfig, scaffoldConfig.enabled, true, "{serverGraphql}/config.ts", placeholders);
+			const serverContextPath = resolveFilePath(scaffoldConfig.serverContext, scaffoldConfig.enabled, true, "{serverGraphql}/context.ts", placeholders);
+			if (serverSchemaPath || serverConfigPath || serverContextPath) {
+				if (!existsSync(nitro.graphql.serverDir)) mkdirSync(nitro.graphql.serverDir, { recursive: true });
+			}
+			if (serverSchemaPath) writeFileIfNotExists(serverSchemaPath, `export default defineSchema({
 
 })
-`, "utf-8");
-		if (!existsSync(join(nitro.graphql.serverDir, "config.ts"))) writeFileSync(join(nitro.graphql.serverDir, "config.ts"), `// Example GraphQL config file please change it to your needs
+`, "server schema.ts");
+			if (serverConfigPath) writeFileIfNotExists(serverConfigPath, `// Example GraphQL config file please change it to your needs
 // import * as tables from '../drizzle/schema/index'
 // import { useDatabase } from '../utils/useDb'
+import { defineGraphQLConfig } from 'nitro-graphql/utils/define'
 
 export default defineGraphQLConfig({
 // graphql-yoga example config
@@ -225,8 +296,8 @@ export default defineGraphQLConfig({
 //   }
 // },
 })
-`, "utf-8");
-		if (!existsSync(join(nitro.graphql.serverDir, "context.ts"))) writeFileSync(join(nitro.graphql.serverDir, "context.ts"), `// Example context definition - please change it to your needs
+`, "server config.ts");
+			if (serverContextPath) writeFileIfNotExists(serverContextPath, `// Example context definition - please change it to your needs
 // import type { Database } from '../utils/useDb'
 
 declare module 'h3' {
@@ -241,11 +312,12 @@ declare module 'h3' {
     //   }
     // }
   }
-}`, "utf-8");
-		if (existsSync(join(nitro.graphql.serverDir, "context.d.ts"))) {
-			consola.warn("nitro-graphql: Found context.d.ts file. Please rename it to context.ts for the new structure.");
-			consola.info("The context file should now be context.ts instead of context.d.ts");
-		}
+}`, "server context.ts");
+			if (existsSync(join(nitro.graphql.serverDir, "context.d.ts"))) {
+				consola.warn("nitro-graphql: Found context.d.ts file. Please rename it to context.ts for the new structure.");
+				consola.info("The context file should now be context.ts instead of context.d.ts");
+			}
+		} else consola.info("[nitro-graphql] Scaffold file generation is disabled (library mode)");
 	}
 });
 

package/dist/rollup.js

@@ -1,5 +1,6 @@
 import { getImportId, scanGraphql } from "./utils/index.js";
 import { clientTypeGeneration, serverTypeGeneration } from "./utils/type-generation.js";
+import { fileURLToPath } from "node:url";
 import { resolve } from "pathe";
 import { readFile } from "node:fs/promises";
 import { parse } from "graphql";
@@ -12,32 +13,82 @@ async function rollupConfig(app) {
 	virtualDirectives(app);
 	getGraphQLConfig(app);
 	virtualModuleConfig(app);
+	virtualDebugInfo(app);
 	app.hooks.hook("rollup:before", (nitro, rollupConfig$1) => {
 		rollupConfig$1.plugins = rollupConfig$1.plugins || [];
-		const { include = /\.(graphql|gql)$/i, exclude, validate = false } = app.options.graphql?.loader || {};
+		const { include = /\.(?:graphql|gql)$/i, exclude, validate = false } = app.options.graphql?.loader || {};
 		if (Array.isArray(rollupConfig$1.plugins)) {
 			rollupConfig$1.plugins.push({
-				name: "nitro-graphql",
-				async load(id) {
-					if (exclude?.test?.(id)) return null;
-					if (!include.test(id)) return null;
-					try {
-						const content = await readFile(id, "utf-8");
-						if (validate) parse(content);
-						return `export default ${JSON.stringify(content)}`;
-					} catch (error) {
-						if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return null;
-						const message = error instanceof Error ? error.message : String(error);
-						this.error(`Failed to read GraphQL file ${id}: ${message}`);
+				name: "nitro-graphql:virtual",
+				resolveId: {
+					order: "pre",
+					filter: { id: /^#nitro-graphql\// },
+					async handler(id, parent, options) {
+						if (id.startsWith("#nitro-graphql/")) return `\0virtual:${id}`;
+						if (parent?.startsWith("\0virtual:#nitro-graphql")) {
+							const runtimeDir = fileURLToPath(new URL("routes", import.meta.url));
+							const internalRes = await this.resolve(id, runtimeDir, {
+								skipSelf: true,
+								...options
+							});
+							if (internalRes) return internalRes;
+						}
+					}
+				},
+				load: {
+					order: "pre",
+					filter: { id: /^\0virtual:#nitro-graphql\// },
+					handler(id) {
+						if (id.startsWith("\0virtual:#nitro-graphql/")) {
+							const moduleName = id.slice(9);
+							const generator = app.options.virtual?.[moduleName];
+							if (typeof generator === "function") try {
+								return {
+									code: generator(),
+									moduleType: "js"
+								};
+							} catch (error) {
+								const message = error instanceof Error ? error.message : String(error);
+								this.error(`Failed to generate virtual module ${moduleName}: ${message}`);
+							}
+							else this.error(`No generator function found for virtual module ${moduleName}`);
+						}
 					}
 				}
 			});
 			rollupConfig$1.plugins.push({
+				name: "nitro-graphql",
+				resolveId: {
+					order: "pre",
+					handler(id) {
+						if (/\.(?:graphql|gql)$/i.test(id)) return null;
+					}
+				},
+				load: {
+					order: "pre",
+					async handler(id) {
+						if (exclude?.test?.(id)) return null;
+						if (!include.test(id)) return null;
+						try {
+							const content = await readFile(id, "utf-8");
+							if (validate) parse(content);
+							return `export default ${JSON.stringify(content)}`;
+						} catch (error) {
+							if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return null;
+							const message = error instanceof Error ? error.message : String(error);
+							this.error(`Failed to read GraphQL file ${id}: ${message}`);
+						}
+					}
+				}
+			});
+			if (app.options.dev) rollupConfig$1.plugins.push({
 				name: "nitro-graphql-watcher",
-				async buildStart() {
-					const graphqlFiles = await scanGraphql(nitro);
-					for (const file of graphqlFiles) this.addWatchFile(file);
-					this.addWatchFile(app.graphql.serverDir);
+				buildStart: {
+					order: "pre",
+					async handler() {
+						const graphqlFiles = await scanGraphql(nitro);
+						for (const file of graphqlFiles) this.addWatchFile(file);
+					}
 				}
 			});
 		}
@@ -48,65 +99,117 @@ async function rollupConfig(app) {
 	});
 }
 function virtualSchemas(app) {
-	const getSchemas = () => {
-		return [...app.scanSchemas, ...app.options.graphql?.typedefs ?? []];
-	};
+	const getSchemas = () => [...app.scanSchemas, ...app.options.graphql?.typedefs ?? []];
 	app.options.virtual ??= {};
-	app.options.virtual["#nitro-internal-virtual/server-schemas"] = () => {
-		const imports = getSchemas();
-		return `
-${imports.map((handler) => `import ${getImportId(handler)} from '${handler}';`).join("\n")}
+	app.options.virtual["#nitro-graphql/server-schemas"] = () => {
+		try {
+			const imports = getSchemas();
+			if (imports.length === 0) {
+				if (app.options.dev) app.logger.warn("[nitro-graphql] No schemas found. Virtual module will export empty array.");
+				return "export const schemas = []";
+			}
+			const importStatements = imports.map((handler) => `import ${getImportId(handler)} from '${handler}';`);
+			const schemaArray = imports.map((h) => `{ def: ${getImportId(h)} }`);
+			return `
+${importStatements.join("\n")}
 
 export const schemas = [
-${imports.map((h) => `{ def: ${getImportId(h)} }`).join(",\n")}
+${schemaArray.join(",\n")}
 ];
     `;
+		} catch (error) {
+			app.logger.error("[nitro-graphql] Failed to generate virtual schema module:", error);
+			return "export const schemas = []";
+		}
 	};
 }
 function virtualResolvers(app) {
-	const getResolvers = () => {
-		return [...app.scanResolvers];
-	};
+	const getResolvers = () => [...app.scanResolvers];
 	app.options.virtual ??= {};
-	app.options.virtual["#nitro-internal-virtual/server-resolvers"] = () => {
-		const imports = getResolvers();
-		const importsContent = [...imports.map(({ specifier, imports: imports$1, options }) => {
-			return genImport(specifier, imports$1, options);
-		})];
-		const content = [
-			"export const resolvers = [",
-			imports.map(({ imports: imports$1 }) => imports$1.map((i) => `{ resolver: ${i.as} }`).join(",\n")).filter(Boolean).join(",\n"),
-			"]",
-			""
-		];
-		content.unshift(...importsContent);
-		return content.join("\n");
+	app.options.virtual["#nitro-graphql/server-resolvers"] = () => {
+		try {
+			const imports = getResolvers();
+			if (imports.length === 0) {
+				if (app.options.dev) app.logger.warn("[nitro-graphql] No resolvers found. Virtual module will export empty array.");
+				return "export const resolvers = []";
+			}
+			const importsContent = [];
+			const invalidImports = [];
+			for (const { specifier, imports: importList, options } of imports) try {
+				if (!importList || importList.length === 0) {
+					invalidImports.push(`${specifier}: No exports found`);
+					continue;
+				}
+				const importCode = genImport(specifier, importList, options);
+				importsContent.push(importCode);
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				invalidImports.push(`${specifier}: ${message}`);
+				if (app.options.dev) app.logger.error(`[nitro-graphql] Failed to generate import for ${specifier}:`, error);
+			}
+			if (invalidImports.length > 0 && app.options.dev) {
+				app.logger.warn("[nitro-graphql] Some resolver imports could not be generated:");
+				for (const msg of invalidImports) app.logger.warn(`  - ${msg}`);
+			}
+			const data = imports.map(({ imports: importList }) => importList.map((i) => `{ resolver: ${i.as} }`).join(",\n")).filter(Boolean).join(",\n");
+			return [
+				...importsContent,
+				"",
+				"export const resolvers = [",
+				data,
+				"]",
+				""
+			].join("\n");
+		} catch (error) {
+			app.logger.error("[nitro-graphql] Failed to generate virtual resolver module:", error);
+			return "export const resolvers = []";
+		}
 	};
 }
 function virtualDirectives(app) {
-	const getDirectives = () => {
-		return [...app.scanDirectives || []];
-	};
+	const getDirectives = () => app.scanDirectives || [];
 	app.options.virtual ??= {};
-	app.options.virtual["#nitro-internal-virtual/server-directives"] = () => {
-		const imports = getDirectives();
-		const importsContent = [...imports.map(({ specifier, imports: imports$1, options }) => {
-			return genImport(specifier, imports$1, options);
-		})];
-		const content = [
-			"export const directives = [",
-			imports.map(({ imports: imports$1 }) => imports$1.map((i) => `{ directive: ${i.as} }`).join(",\n")).filter(Boolean).join(",\n"),
-			"]",
-			""
-		];
-		content.unshift(...importsContent);
-		return content.join("\n");
+	app.options.virtual["#nitro-graphql/server-directives"] = () => {
+		try {
+			const imports = getDirectives();
+			if (imports.length === 0) return "export const directives = []";
+			const importsContent = [];
+			const invalidImports = [];
+			for (const { specifier, imports: importList, options } of imports) try {
+				if (!importList || importList.length === 0) {
+					invalidImports.push(`${specifier}: No exports found`);
+					continue;
+				}
+				const importCode = genImport(specifier, importList, options);
+				importsContent.push(importCode);
+			} catch (error) {
+				const message = error instanceof Error ? error.message : String(error);
+				invalidImports.push(`${specifier}: ${message}`);
+				if (app.options.dev) app.logger.error(`[nitro-graphql] Failed to generate import for directive ${specifier}:`, error);
+			}
+			if (invalidImports.length > 0 && app.options.dev) {
+				app.logger.warn("[nitro-graphql] Some directive imports could not be generated:");
+				for (const msg of invalidImports) app.logger.warn(`  - ${msg}`);
+			}
+			const data = imports.map(({ imports: importList }) => importList.map((i) => `{ directive: ${i.as} }`).join(",\n")).filter(Boolean).join(",\n");
+			return [
+				...importsContent,
+				"",
+				"export const directives = [",
+				data,
+				"]",
+				""
+			].join("\n");
+		} catch (error) {
+			app.logger.error("[nitro-graphql] Failed to generate virtual directive module:", error);
+			return "export const directives = []";
+		}
 	};
 }
 function getGraphQLConfig(app) {
 	const configPath = resolve(app.graphql.serverDir, "config.ts");
 	app.options.virtual ??= {};
-	app.options.virtual["#nitro-internal-virtual/graphql-config"] = () => {
+	app.options.virtual["#nitro-graphql/graphql-config"] = () => {
 		return `import config from '${configPath}'
 const importedConfig = config
 export { importedConfig }
@@ -115,11 +218,65 @@ export { importedConfig }
 }
 function virtualModuleConfig(app) {
 	app.options.virtual ??= {};
-	app.options.virtual["#nitro-internal-virtual/module-config"] = () => {
+	app.options.virtual["#nitro-graphql/module-config"] = () => {
 		const moduleConfig = app.options.graphql || {};
 		return `export const moduleConfig = ${JSON.stringify(moduleConfig, null, 2)};`;
 	};
 }
+function virtualDebugInfo(app) {
+	app.options.virtual ??= {};
+	app.options.virtual["#nitro-graphql/debug-info"] = () => {
+		const virtualModuleCodes = {};
+		try {
+			const schemasGenerator = app.options.virtual["#nitro-graphql/server-schemas"];
+			if (schemasGenerator && typeof schemasGenerator === "function") virtualModuleCodes["server-schemas"] = schemasGenerator();
+		} catch (error) {
+			virtualModuleCodes["server-schemas"] = `// Error generating: ${error instanceof Error ? error.message : String(error)}`;
+		}
+		try {
+			const resolversGenerator = app.options.virtual["#nitro-graphql/server-resolvers"];
+			if (resolversGenerator && typeof resolversGenerator === "function") virtualModuleCodes["server-resolvers"] = resolversGenerator();
+		} catch (error) {
+			virtualModuleCodes["server-resolvers"] = `// Error generating: ${error instanceof Error ? error.message : String(error)}`;
+		}
+		try {
+			const directivesGenerator = app.options.virtual["#nitro-graphql/server-directives"];
+			if (directivesGenerator && typeof directivesGenerator === "function") virtualModuleCodes["server-directives"] = directivesGenerator();
+		} catch (error) {
+			virtualModuleCodes["server-directives"] = `// Error generating: ${error instanceof Error ? error.message : String(error)}`;
+		}
+		try {
+			const moduleConfigGenerator = app.options.virtual["#nitro-graphql/module-config"];
+			if (moduleConfigGenerator && typeof moduleConfigGenerator === "function") virtualModuleCodes["module-config"] = moduleConfigGenerator();
+		} catch (error) {
+			virtualModuleCodes["module-config"] = `// Error generating: ${error instanceof Error ? error.message : String(error)}`;
+		}
+		try {
+			const graphqlConfigGenerator = app.options.virtual["#nitro-graphql/graphql-config"];
+			if (graphqlConfigGenerator && typeof graphqlConfigGenerator === "function") virtualModuleCodes["graphql-config"] = graphqlConfigGenerator();
+		} catch (error) {
+			virtualModuleCodes["graphql-config"] = `// Error generating: ${error instanceof Error ? error.message : String(error)}`;
+		}
+		const debugInfo = {
+			isDev: app.options.dev,
+			framework: app.options.framework.name,
+			graphqlFramework: app.options.graphql?.framework,
+			federation: app.options.graphql?.federation,
+			scanned: {
+				schemas: app.scanSchemas?.length || 0,
+				schemaFiles: app.scanSchemas || [],
+				resolvers: app.scanResolvers?.length || 0,
+				resolverFiles: app.scanResolvers || [],
+				directives: app.scanDirectives?.length || 0,
+				directiveFiles: app.scanDirectives || [],
+				documents: app.scanDocuments?.length || 0,
+				documentFiles: app.scanDocuments || []
+			},
+			virtualModules: virtualModuleCodes
+		};
+		return `export const debugInfo = ${JSON.stringify(debugInfo, null, 2)};`;
+	};
+}
 
 //#endregion
 export { rollupConfig };

package/dist/routes/apollo-server.d.ts

@@ -1,6 +1,6 @@
-import * as h33 from "h3";
+import * as h31 from "h3";
 
 //#region src/routes/apollo-server.d.ts
-declare const _default: h33.EventHandler<h33.EventHandlerRequest, unknown>;
+declare const _default: h31.EventHandlerWithFetch<h31.EventHandlerRequest, Promise<any>>;
 //#endregion
 export { _default as default };

package/dist/routes/apollo-server.js

@@ -2,11 +2,11 @@ import { consola as consola$1 } from "consola";
 import defu from "defu";
 import { parse } from "graphql";
 import { mergeResolvers, mergeTypeDefs } from "@graphql-tools/merge";
-import { importedConfig } from "#nitro-internal-virtual/graphql-config";
-import { moduleConfig } from "#nitro-internal-virtual/module-config";
-import { directives } from "#nitro-internal-virtual/server-directives";
-import { resolvers } from "#nitro-internal-virtual/server-resolvers";
-import { schemas } from "#nitro-internal-virtual/server-schemas";
+import { importedConfig } from "#nitro-graphql/graphql-config";
+import { moduleConfig } from "#nitro-graphql/module-config";
+import { directives } from "#nitro-graphql/server-directives";
+import { resolvers } from "#nitro-graphql/server-resolvers";
+import { schemas } from "#nitro-graphql/server-schemas";
 import { ApolloServer } from "@apollo/server";
 import { ApolloServerPluginLandingPageLocalDefault } from "@apollo/server/plugin/landingPage/default";
 import { makeExecutableSchema } from "@graphql-tools/schema";