nitro-graphql 2.0.0-beta.31 → 2.0.0-beta.33

package/dist/utils/type-generation.d.mts

@@ -1,12 +1,6 @@
-import { Nitro } from "nitro/types";
-
-//#region src/utils/type-generation.d.ts
-declare function serverTypeGeneration(app: Nitro, options?: {
-  silent?: boolean;
-}): Promise<void>;
-declare function clientTypeGeneration(nitro: Nitro, options?: {
-  silent?: boolean;
-  isInitial?: boolean;
-}): Promise<void>;
-//#endregion
-export { clientTypeGeneration, serverTypeGeneration };
+import { generateMainClientTypes } from "../codegen/client-types.mjs";
+import { generateExternalServicesTypes } from "../codegen/external-types.mjs";
+import { generateServerTypes } from "../codegen/server-types.mjs";
+import { validateNoDuplicateTypes } from "../codegen/validation.mjs";
+import { generateClientTypes } from "../codegen/index.mjs";
+export { generateClientTypes, generateExternalServicesTypes, generateMainClientTypes, generateServerTypes, validateNoDuplicateTypes };

package/dist/utils/type-generation.mjs

@@ -1,420 +1,7 @@
-import { downloadAndSaveSchema, generateClientTypes, generateExternalClientTypes, loadExternalSchema, loadGraphQLDocuments } from "./client-codegen.mjs";
-import { writeFileIfNotExists } from "./file-generator.mjs";
-import { getClientUtilsConfig, getDefaultPaths, getSdkConfig, getTypesConfig, resolveFilePath, shouldGenerateClientUtils, shouldGenerateTypes } from "./path-resolver.mjs";
-import { generateTypes } from "./server-codegen.mjs";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import consola from "consola";
-import { basename, dirname, join, resolve } from "pathe";
-import { buildSchema, parse } from "graphql";
-import { loadFilesSync } from "@graphql-tools/load-files";
-import { mergeTypeDefs } from "@graphql-tools/merge";
-import { printSchemaWithDirectives } from "@graphql-tools/utils";
+import { generateMainClientTypes } from "../codegen/client-types.mjs";
+import { generateExternalServicesTypes } from "../codegen/external-types.mjs";
+import { validateNoDuplicateTypes } from "../codegen/validation.mjs";
+import { generateServerTypes } from "../codegen/server-types.mjs";
+import { generateClientTypes } from "../codegen/index.mjs";
 
-//#region src/utils/type-generation.ts
-const logger = consola.withTag("nitro-graphql");
-let buildSubgraphSchema = null;
-async function loadFederationSupport() {
-	if (buildSubgraphSchema !== null) return buildSubgraphSchema;
-	try {
-		buildSubgraphSchema = (await import("@apollo/subgraph")).buildSubgraphSchema;
-	} catch {
-		buildSubgraphSchema = false;
-	}
-	return buildSubgraphSchema;
-}
-function generateGraphQLIndexFile(nitro, clientDir, externalServices = []) {
-	if (!shouldGenerateClientUtils(nitro)) return;
-	const placeholders = getDefaultPaths(nitro);
-	const clientUtilsConfig = getClientUtilsConfig(nitro);
-	const indexPath = resolveFilePath(clientUtilsConfig.index, clientUtilsConfig.enabled, true, "{clientGraphql}/index.ts", placeholders);
-	if (!indexPath) return;
-	if (!existsSync(indexPath)) {
-		let indexContent = `// This file is auto-generated once by nitro-graphql for quick start
-// You can modify this file according to your needs
-//
-// Export your main GraphQL service (auto-generated)
-export * from './default/ofetch'
-
-// Export external GraphQL services (auto-generated for existing services)
-// When you add new external services, don't forget to add their exports here:
-// export * from './yourServiceName/ofetch'
-`;
-		for (const service of externalServices) indexContent += `export * from './${service.name}/ofetch'\n`;
-		writeFileIfNotExists(indexPath, indexContent, "client index.ts");
-	}
-}
-function generateNuxtOfetchClient(nitro, clientDir, serviceName = "default") {
-	if (!shouldGenerateClientUtils(nitro)) return;
-	const placeholders = {
-		...getDefaultPaths(nitro),
-		serviceName
-	};
-	const clientUtilsConfig = getClientUtilsConfig(nitro);
-	const ofetchPath = resolveFilePath(clientUtilsConfig.ofetch, clientUtilsConfig.enabled, true, "{clientGraphql}/{serviceName}/ofetch.ts", placeholders);
-	if (!ofetchPath) return;
-	const serviceDir = dirname(ofetchPath);
-	if (!existsSync(serviceDir)) mkdirSync(serviceDir, { recursive: true });
-	if (existsSync(ofetchPath)) return;
-	writeFileIfNotExists(ofetchPath, nitro.options.framework?.name === "nuxt" ? `// This file is auto-generated once by nitro-graphql for quick start
-// You can modify this file according to your needs
-import type { Requester } from './sdk'
-import { getSdk } from './sdk'
-
-export function createGraphQLClient(endpoint: string): Requester {
-  return async <R>(doc: string, vars?: any): Promise<R> => {
-    const headers = import.meta.server ? useRequestHeaders() : undefined
-
-    const result = await $fetch(endpoint, {
-      method: 'POST',
-      body: { query: doc, variables: vars },
-      headers: {
-        'Content-Type': 'application/json',
-        ...headers,
-      },
-    })
-
-    return result as R
-  }
-}
-
-export const $sdk = getSdk(createGraphQLClient('/api/graphql'))` : `// This file is auto-generated once by nitro-graphql for quick start
-// You can modify this file according to your needs
-import type { Requester } from './sdk'
-import { ofetch } from 'ofetch'
-import { getSdk } from './sdk'
-
-export function createGraphQLClient(endpoint: string): Requester {
-  return async <R>(doc: string, vars?: any): Promise<R> => {
-    const result = await ofetch(endpoint, {
-      method: 'POST',
-      body: { query: doc, variables: vars },
-      headers: {
-        'Content-Type': 'application/json',
-      },
-    })
-
-    return result as R
-  }
-}
-
-export const $sdk = getSdk(createGraphQLClient('/api/graphql'))`, `${serviceName} ofetch.ts`);
-}
-function generateExternalOfetchClient(nitro, service, endpoint) {
-	if (!shouldGenerateClientUtils(nitro)) return;
-	const serviceName = service.name;
-	const placeholders = {
-		...getDefaultPaths(nitro),
-		serviceName
-	};
-	const clientUtilsConfig = getClientUtilsConfig(nitro);
-	const ofetchPath = resolveFilePath(service.paths?.ofetch ?? clientUtilsConfig.ofetch, clientUtilsConfig.enabled, true, "{clientGraphql}/{serviceName}/ofetch.ts", placeholders);
-	if (!ofetchPath) return;
-	const serviceDir = dirname(ofetchPath);
-	if (!existsSync(serviceDir)) mkdirSync(serviceDir, { recursive: true });
-	if (!existsSync(ofetchPath)) {
-		const capitalizedServiceName = serviceName.charAt(0).toUpperCase() + serviceName.slice(1);
-		writeFileIfNotExists(ofetchPath, nitro.options.framework?.name === "nuxt" ? `// This file is auto-generated once by nitro-graphql for quick start
-// You can modify this file according to your needs
-import type { Sdk, Requester } from './sdk'
-import { getSdk } from './sdk'
-
-export function create${capitalizedServiceName}GraphQLClient(endpoint: string = '${endpoint}'): Requester {
-  return async <R>(doc: string, vars?: any): Promise<R> => {
-    const headers = import.meta.server ? useRequestHeaders() : undefined
-
-    const result = await $fetch(endpoint, {
-      method: 'POST',
-      body: { query: doc, variables: vars },
-      headers: {
-        'Content-Type': 'application/json',
-        ...headers,
-      },
-    })
-
-    return result as R
-  }
-}
-
-export const $${serviceName}Sdk: Sdk = getSdk(create${capitalizedServiceName}GraphQLClient())` : `// This file is auto-generated once by nitro-graphql for quick start
-// You can modify this file according to your needs
-import type { Sdk, Requester } from './sdk'
-import { ofetch } from 'ofetch'
-import { getSdk } from './sdk'
-
-export function create${capitalizedServiceName}GraphQLClient(endpoint: string = '${endpoint}'): Requester {
-  return async <R>(doc: string, vars?: any): Promise<R> => {
-    const result = await ofetch(endpoint, {
-      method: 'POST',
-      body: { query: doc, variables: vars },
-      headers: {
-        'Content-Type': 'application/json',
-      },
-    })
-
-    return result as R
-  }
-}
-
-export const $${serviceName}Sdk: Sdk = getSdk(create${capitalizedServiceName}GraphQLClient())`, `${serviceName} external ofetch.ts`);
-	}
-}
-/**
-* Check for duplicate type definitions using a simpler approach
-* Try to build each schema individually - if that succeeds but merging fails, we have duplicates
-* @returns true if validation passes, false if duplicates found
-*/
-function validateNoDuplicateTypes(schemas, schemaStrings) {
-	const individualSchemasByFile = /* @__PURE__ */ new Map();
-	schemaStrings.forEach((schemaContent, index) => {
-		const schemaPath = schemas[index];
-		const fileName = basename(schemaPath);
-		try {
-			parse(schemaContent);
-			individualSchemasByFile.set(fileName, schemaContent);
-		} catch (error) {
-			consola.warn(`Invalid GraphQL syntax in ${fileName}:`, error);
-			throw error;
-		}
-	});
-	try {
-		mergeTypeDefs([schemaStrings.join("\n\n")], {
-			throwOnConflict: false,
-			commentDescriptions: true,
-			sort: true
-		});
-		mergeTypeDefs([schemaStrings.join("\n\n")], {
-			throwOnConflict: true,
-			commentDescriptions: true,
-			sort: true
-		});
-	} catch (conflictError) {
-		if (conflictError?.message?.includes("already defined with a different type")) throw conflictError;
-	}
-	const typeNames = /* @__PURE__ */ new Set();
-	const duplicateTypes = [];
-	schemaStrings.forEach((schemaContent, index) => {
-		const fileName = basename(schemas[index]);
-		try {
-			parse(schemaContent).definitions.forEach((def) => {
-				if (def.kind === "ObjectTypeDefinition" || def.kind === "InterfaceTypeDefinition" || def.kind === "UnionTypeDefinition" || def.kind === "EnumTypeDefinition" || def.kind === "InputObjectTypeDefinition" || def.kind === "ScalarTypeDefinition") {
-					const typeName = def.name.value;
-					if ([
-						"String",
-						"Int",
-						"Float",
-						"Boolean",
-						"ID",
-						"DateTime",
-						"JSON"
-					].includes(typeName)) return;
-					if (typeNames.has(typeName)) {
-						const existing = duplicateTypes.find((d) => d.type === typeName);
-						if (existing) existing.files.push(fileName);
-						else {
-							const firstFile = schemas.find((_, i) => {
-								const content = schemaStrings[i];
-								if (!content) return false;
-								try {
-									return parse(content).definitions.some((d) => (d.kind === "ObjectTypeDefinition" || d.kind === "InterfaceTypeDefinition" || d.kind === "UnionTypeDefinition" || d.kind === "EnumTypeDefinition" || d.kind === "InputObjectTypeDefinition" || d.kind === "ScalarTypeDefinition") && d.name.value === typeName);
-								} catch {
-									return false;
-								}
-							});
-							duplicateTypes.push({
-								type: typeName,
-								files: [basename(firstFile || ""), fileName]
-							});
-						}
-					} else typeNames.add(typeName);
-				}
-			});
-		} catch {}
-	});
-	if (duplicateTypes.length > 0) {
-		let errorMessage = "⚠️  DUPLICATE TYPE DEFINITIONS DETECTED!\n\n";
-		duplicateTypes.forEach(({ type, files }) => {
-			errorMessage += `❌ Type "${type}" is defined in multiple files:\n`;
-			files.forEach((fileName) => {
-				const fullPath = schemas.find((path) => basename(path) === fileName) || fileName;
-				errorMessage += `   • ${fullPath}\n`;
-			});
-			errorMessage += "\n";
-		});
-		errorMessage += "💡 Each GraphQL type should only be defined once.\n";
-		errorMessage += "   Consider using \"extend type\" syntax instead of duplicate definitions.\n";
-		errorMessage += `\n🔍 Found ${duplicateTypes.length} duplicate type(s): ${duplicateTypes.map((d) => d.type).join(", ")}`;
-		consola.error(errorMessage);
-		return false;
-	}
-	return true;
-}
-async function serverTypeGeneration(app, options = {}) {
-	try {
-		if (!shouldGenerateTypes(app)) {
-			logger.debug("Server type generation is disabled");
-			return;
-		}
-		const schemas = app.scanSchemas || [];
-		if (!schemas.length) {
-			if (!options.silent) consola.info("No GraphQL definitions found for server type generation.");
-			return;
-		}
-		const schemaStrings = loadFilesSync(schemas).map((schema$1) => typeof schema$1 === "string" ? schema$1 : schema$1.loc?.source?.body || "").filter(Boolean);
-		if (!validateNoDuplicateTypes(schemas, schemaStrings)) return;
-		const federationEnabled = app.options.graphql?.federation?.enabled === true;
-		const mergedSchemas = mergeTypeDefs([schemaStrings.join("\n\n")], {
-			throwOnConflict: true,
-			commentDescriptions: true,
-			sort: true
-		});
-		let schema;
-		if (federationEnabled) {
-			const buildSubgraph = await loadFederationSupport();
-			if (!buildSubgraph) throw new Error("Federation is enabled but @apollo/subgraph is not installed. Run: pnpm add @apollo/subgraph");
-			schema = buildSubgraph([{ typeDefs: parse(mergedSchemas) }]);
-		} else schema = buildSchema(mergedSchemas);
-		const data = await generateTypes(app.options.graphql?.framework || "graphql-yoga", schema, app.options.graphql ?? {});
-		const printSchema = printSchemaWithDirectives(schema);
-		const schemaPath = resolve(app.graphql.buildDir, "schema.graphql");
-		mkdirSync(dirname(schemaPath), { recursive: true });
-		writeFileSync(schemaPath, printSchema, "utf-8");
-		const placeholders = getDefaultPaths(app);
-		const typesConfig = getTypesConfig(app);
-		const serverTypesPath = resolveFilePath(typesConfig.server, typesConfig.enabled, true, "{typesDir}/nitro-graphql-server.d.ts", placeholders);
-		if (serverTypesPath) {
-			mkdirSync(dirname(serverTypesPath), { recursive: true });
-			writeFileSync(serverTypesPath, data, "utf-8");
-			if (!options.silent) logger.success(`Generated server types at: ${serverTypesPath}`);
-		}
-	} catch (error) {
-		logger.error("Server schema generation error:", error);
-	}
-}
-async function clientTypeGeneration(nitro, options = {}) {
-	try {
-		if (nitro.scanSchemas && nitro.scanSchemas.length > 0) await generateMainClientTypes(nitro, options);
-		if (nitro.options.graphql?.externalServices?.length) await generateExternalServicesTypes(nitro, options);
-	} catch (error) {
-		logger.error("Client schema generation error:", error);
-	}
-}
-/**
-* Check for old structure files and warn user about manual migration
-*/
-function checkOldStructure(clientDir) {
-	const oldOfetchPath = resolve(clientDir, "ofetch.ts");
-	const oldSdkPath = resolve(clientDir, "sdk.ts");
-	if (existsSync(oldOfetchPath) || existsSync(oldSdkPath)) {
-		const foundFiles = [];
-		if (existsSync(oldOfetchPath)) foundFiles.push("app/graphql/ofetch.ts");
-		if (existsSync(oldSdkPath)) foundFiles.push("app/graphql/sdk.ts");
-		consola.error(`⚠️  OLD GRAPHQL STRUCTURE DETECTED!
-
-📁 Found old files in app/graphql/ directory that need to be moved:
-   • ${foundFiles.join("\n   • ")}
-
-🔄 Please manually move these files to the new structure:
-   • app/graphql/ofetch.ts → app/graphql/default/ofetch.ts
-   • app/graphql/sdk.ts → app/graphql/default/sdk.ts
-
-📝 Also update your app/graphql/index.ts to include:
-   export * from './default/ofetch'
-
-💡 After moving, update your imports to use:
-   import { $sdk } from "#graphql/client"
-
-🚫 The old files will cause import conflicts until moved!`);
-	}
-}
-async function generateMainClientTypes(nitro, options = {}) {
-	checkOldStructure(nitro.graphql.clientDir);
-	const docs = nitro.scanDocuments;
-	const loadDocs = await loadGraphQLDocuments(docs);
-	const schemaFilePath = join(nitro.graphql.buildDir, "schema.graphql");
-	if (!existsSync(schemaFilePath)) {
-		if (!options.silent) consola.info("Schema file not ready yet for client type generation. Server types need to be generated first.");
-		return;
-	}
-	const graphqlString = readFileSync(schemaFilePath, "utf-8");
-	const federationEnabled = nitro.options.graphql?.federation?.enabled === true;
-	let schema;
-	if (federationEnabled) {
-		const buildSubgraph = await loadFederationSupport();
-		if (!buildSubgraph) throw new Error("Federation is enabled but @apollo/subgraph is not installed. Run: pnpm add @apollo/subgraph");
-		schema = buildSubgraph([{ typeDefs: parse(graphqlString) }]);
-	} else schema = buildSchema(graphqlString);
-	const types = await generateClientTypes(schema, loadDocs, nitro.options.graphql?.codegen?.client ?? {}, nitro.options.graphql?.codegen?.clientSDK ?? {}, void 0, void 0, void 0, options);
-	if (types === false) return;
-	const placeholders = getDefaultPaths(nitro);
-	const typesConfig = getTypesConfig(nitro);
-	const sdkConfig = getSdkConfig(nitro);
-	const clientTypesPath = resolveFilePath(typesConfig.client, typesConfig.enabled, true, "{typesDir}/nitro-graphql-client.d.ts", placeholders);
-	if (clientTypesPath) {
-		mkdirSync(dirname(clientTypesPath), { recursive: true });
-		writeFileSync(clientTypesPath, types.types, "utf-8");
-		if (!options.silent) logger.success(`Generated client types at: ${clientTypesPath}`);
-	}
-	const sdkPath = resolveFilePath(sdkConfig.main, sdkConfig.enabled, true, "{clientGraphql}/default/sdk.ts", placeholders);
-	if (sdkPath) {
-		mkdirSync(dirname(sdkPath), { recursive: true });
-		writeFileSync(sdkPath, types.sdk, "utf-8");
-		if (!options.silent) logger.success(`Generated SDK at: ${sdkPath}`);
-	}
-	generateNuxtOfetchClient(nitro, nitro.graphql.clientDir, "default");
-	const externalServices = nitro.options.graphql?.externalServices || [];
-	if (externalServices.length > 0) generateGraphQLIndexFile(nitro, nitro.graphql.clientDir, externalServices);
-}
-async function generateExternalServicesTypes(nitro, options = {}) {
-	const externalServices = nitro.options.graphql?.externalServices || [];
-	for (const service of externalServices) try {
-		if (!options.silent) consola.info(`[graphql:${service.name}] Processing external service`);
-		await downloadAndSaveSchema(service, nitro.options.buildDir);
-		const schema = await loadExternalSchema(service, nitro.options.buildDir);
-		if (!schema) {
-			consola.warn(`[graphql:${service.name}] Failed to load schema, skipping`);
-			continue;
-		}
-		const documentPatterns = service.documents || [];
-		let loadDocs = [];
-		if (documentPatterns.length > 0) try {
-			loadDocs = await loadGraphQLDocuments(documentPatterns);
-			if (!loadDocs || loadDocs.length === 0) {
-				consola.warn(`[graphql:${service.name}] No GraphQL documents found, skipping service generation`);
-				continue;
-			}
-		} catch (error) {
-			consola.warn(`[graphql:${service.name}] No documents found, skipping service generation:`, error);
-			continue;
-		}
-		const types = await generateExternalClientTypes(service, schema, loadDocs);
-		if (types === false) {
-			consola.warn(`[graphql:${service.name}] Type generation failed`);
-			continue;
-		}
-		const placeholders = {
-			...getDefaultPaths(nitro),
-			serviceName: service.name
-		};
-		const typesConfig = getTypesConfig(nitro);
-		const sdkConfig = getSdkConfig(nitro);
-		const serviceTypesPath = resolveFilePath(service.paths?.types ?? typesConfig.external, typesConfig.enabled, true, "{typesDir}/nitro-graphql-client-{serviceName}.d.ts", placeholders);
-		if (serviceTypesPath) {
-			mkdirSync(dirname(serviceTypesPath), { recursive: true });
-			writeFileSync(serviceTypesPath, types.types, "utf-8");
-			if (!options.silent) consola.success(`[graphql:${service.name}] Generated types at: ${serviceTypesPath}`);
-		}
-		const serviceSdkPath = resolveFilePath(service.paths?.sdk ?? sdkConfig.external, sdkConfig.enabled, true, "{clientGraphql}/{serviceName}/sdk.ts", placeholders);
-		if (serviceSdkPath) {
-			mkdirSync(dirname(serviceSdkPath), { recursive: true });
-			writeFileSync(serviceSdkPath, types.sdk, "utf-8");
-			if (!options.silent) consola.success(`[graphql:${service.name}] Generated SDK at: ${serviceSdkPath}`);
-		}
-		generateExternalOfetchClient(nitro, service, service.endpoint);
-		if (!options.silent) consola.success(`[graphql:${service.name}] External service types generated successfully`);
-	} catch (error) {
-		consola.error(`[graphql:${service.name}] External service generation failed:`, error);
-	}
-}
-
-//#endregion
-export { clientTypeGeneration, serverTypeGeneration };
+export { generateClientTypes, generateExternalServicesTypes, generateMainClientTypes, generateServerTypes, validateNoDuplicateTypes };

package/dist/utils/validation.d.mts

@@ -0,0 +1,11 @@
+//#region src/utils/validation.d.ts
+/**
+ * Validation utilities
+ * Configuration validation helpers
+ */
+/**
+ * Validate external GraphQL service configuration
+ */
+declare function validateExternalServices(services: unknown[]): string[];
+//#endregion
+export { validateExternalServices };

package/dist/utils/validation.mjs

@@ -0,0 +1,34 @@
+//#region src/utils/validation.ts
+/**
+* Validation utilities
+* Configuration validation helpers
+*/
+/**
+* Validate external GraphQL service configuration
+*/
+function validateExternalServices(services) {
+	const errors = [];
+	const serviceNames = /* @__PURE__ */ new Set();
+	for (const [index, service] of services.entries()) {
+		const prefix = `externalServices[${index}]`;
+		if (!service || typeof service !== "object") {
+			errors.push(`${prefix} must be an object`);
+			continue;
+		}
+		if (!("name" in service) || typeof service.name !== "string") errors.push(`${prefix}.name is required and must be a string`);
+		else if (serviceNames.has(service.name)) errors.push(`${prefix}.name "${service.name}" must be unique`);
+		else serviceNames.add(service.name);
+		if (!("schema" in service) || !service.schema) errors.push(`${prefix}.schema is required`);
+		if (!("endpoint" in service) || typeof service.endpoint !== "string") errors.push(`${prefix}.endpoint is required and must be a string`);
+		else try {
+			new URL(service.endpoint);
+		} catch {
+			errors.push(`${prefix}.endpoint "${service.endpoint}" must be a valid URL`);
+		}
+		if ("name" in service && service.name && typeof service.name === "string" && !/^[a-z]\w*$/i.test(service.name)) errors.push(`${prefix}.name "${service.name}" must be a valid identifier (letters, numbers, underscore, starting with letter)`);
+	}
+	return errors;
+}
+
+//#endregion
+export { validateExternalServices };

package/dist/virtual/generators/config.d.mts

@@ -0,0 +1,22 @@
+import { Nitro } from "nitro/types";
+
+//#region src/virtual/generators/config.d.ts
+
+/**
+ * Generate virtual module code for GraphQL config (from server/graphql/config.ts)
+ */
+declare function generateGraphQLConfigModule(nitro: Nitro): string;
+/**
+ * Register the GraphQL config virtual module with Nitro
+ */
+declare function virtualGraphQLConfig(nitro: Nitro): void;
+/**
+ * Generate virtual module code for module config (serialized graphql options)
+ */
+declare function generateModuleConfigModule(nitro: Nitro): string;
+/**
+ * Register the module config virtual module with Nitro
+ */
+declare function virtualModuleConfig(nitro: Nitro): void;
+//#endregion
+export { generateGraphQLConfigModule, generateModuleConfigModule, virtualGraphQLConfig, virtualModuleConfig };

package/dist/virtual/generators/config.mjs

@@ -0,0 +1,36 @@
+import { resolve } from "pathe";
+
+//#region src/virtual/generators/config.ts
+/**
+* Generate virtual module code for GraphQL config (from server/graphql/config.ts)
+*/
+function generateGraphQLConfigModule(nitro) {
+	return `import config from '${resolve(nitro.graphql.serverDir, "config.ts")}'
+const importedConfig = config
+export { importedConfig }
+`;
+}
+/**
+* Register the GraphQL config virtual module with Nitro
+*/
+function virtualGraphQLConfig(nitro) {
+	nitro.options.virtual ??= {};
+	nitro.options.virtual["#nitro-graphql/graphql-config"] = () => generateGraphQLConfigModule(nitro);
+}
+/**
+* Generate virtual module code for module config (serialized graphql options)
+*/
+function generateModuleConfigModule(nitro) {
+	const moduleConfig = nitro.options.graphql || {};
+	return `export const moduleConfig = ${JSON.stringify(moduleConfig, null, 2)};`;
+}
+/**
+* Register the module config virtual module with Nitro
+*/
+function virtualModuleConfig(nitro) {
+	nitro.options.virtual ??= {};
+	nitro.options.virtual["#nitro-graphql/module-config"] = () => generateModuleConfigModule(nitro);
+}
+
+//#endregion
+export { generateGraphQLConfigModule, generateModuleConfigModule, virtualGraphQLConfig, virtualModuleConfig };

package/dist/virtual/generators/debug.d.mts

@@ -0,0 +1,14 @@
+import { Nitro } from "nitro/types";
+
+//#region src/virtual/generators/debug.d.ts
+
+/**
+ * Generate virtual module code for debug info
+ */
+declare function generateDebugInfoModule(nitro: Nitro): string;
+/**
+ * Register the debug info virtual module with Nitro
+ */
+declare function virtualDebugInfo(nitro: Nitro): void;
+//#endregion
+export { generateDebugInfoModule, virtualDebugInfo };

package/dist/virtual/generators/debug.mjs

@@ -0,0 +1,53 @@
+//#region src/virtual/generators/debug.ts
+/**
+* Safely call a virtual module generator and capture its output
+*/
+function safeGenerateModuleCode(nitro, moduleName) {
+	try {
+		const generator = nitro.options.virtual?.[moduleName];
+		if (generator && typeof generator === "function") return generator();
+		return "// Module not found";
+	} catch (error) {
+		return `// Error generating: ${error instanceof Error ? error.message : String(error)}`;
+	}
+}
+/**
+* Generate virtual module code for debug info
+*/
+function generateDebugInfoModule(nitro) {
+	const virtualModuleCodes = {
+		"server-schemas": safeGenerateModuleCode(nitro, "#nitro-graphql/server-schemas"),
+		"server-resolvers": safeGenerateModuleCode(nitro, "#nitro-graphql/server-resolvers"),
+		"server-directives": safeGenerateModuleCode(nitro, "#nitro-graphql/server-directives"),
+		"module-config": safeGenerateModuleCode(nitro, "#nitro-graphql/module-config"),
+		"graphql-config": safeGenerateModuleCode(nitro, "#nitro-graphql/graphql-config")
+	};
+	const debugInfo = {
+		isDev: nitro.options.dev,
+		framework: nitro.options.framework.name,
+		graphqlFramework: nitro.options.graphql?.framework,
+		federation: nitro.options.graphql?.federation,
+		scanned: {
+			schemas: nitro.scanSchemas?.length || 0,
+			schemaFiles: nitro.scanSchemas || [],
+			resolvers: nitro.scanResolvers?.length || 0,
+			resolverFiles: nitro.scanResolvers || [],
+			directives: nitro.scanDirectives?.length || 0,
+			directiveFiles: nitro.scanDirectives || [],
+			documents: nitro.scanDocuments?.length || 0,
+			documentFiles: nitro.scanDocuments || []
+		},
+		virtualModules: virtualModuleCodes
+	};
+	return `export const debugInfo = ${JSON.stringify(debugInfo, null, 2)};`;
+}
+/**
+* Register the debug info virtual module with Nitro
+*/
+function virtualDebugInfo(nitro) {
+	nitro.options.virtual ??= {};
+	nitro.options.virtual["#nitro-graphql/debug-info"] = () => generateDebugInfoModule(nitro);
+}
+
+//#endregion
+export { generateDebugInfoModule, virtualDebugInfo };

package/dist/virtual/generators/directives.d.mts

@@ -0,0 +1,14 @@
+import { Nitro } from "nitro/types";
+
+//#region src/virtual/generators/directives.d.ts
+
+/**
+ * Generate virtual module code for server directives
+ */
+declare function generateDirectivesModule(nitro: Nitro): string;
+/**
+ * Register the directives virtual module with Nitro
+ */
+declare function virtualDirectives(nitro: Nitro): void;
+//#endregion
+export { generateDirectivesModule, virtualDirectives };