nitro-graphql 2.0.0-beta.37 → 2.0.0-beta.39

package/dist/nitro/index.mjs

@@ -0,0 +1,65 @@
+import { NitroAdapter } from "./adapter.mjs";
+import { resolveSecurityConfig } from "./setup/logging.mjs";
+import { setupNitroGraphQL } from "./setup.mjs";
+import { readFile } from "node:fs/promises";
+import defu from "defu";
+
+//#region src/nitro/index.ts
+/**
+* Vite plugin to load GraphQL files as strings AND auto-register Nitro module
+* This prevents Vite from trying to parse .graphql/.gql files as JavaScript
+* and automatically sets up the nitro-graphql module via the nitro: hook
+*
+* @example - Vite usage
+* ```ts
+* import { defineConfig } from 'vite'
+* import { nitro } from 'nitro/vite'
+* import graphql from 'nitro-graphql'
+*
+* export default defineConfig({
+*   plugins: [
+*     graphql({ framework: 'graphql-yoga' }), // Auto-registers Nitro module
+*     nitro()
+*   ]
+* })
+* ```
+*
+*
+* @example - Nitro direct usage
+* ```ts
+*
+* import graphql from 'nitro-graphql'
+*
+* export default defineConfig({
+*   modules: [
+*    graphql({ framework: 'graphql-yoga' }) // Auto-registers Nitro module
+*   ]
+* })
+* ```
+*/
+function graphqlModule(options) {
+	return {
+		name: "nitro-graphql",
+		enforce: "pre",
+		async load(id) {
+			if (!/\.(?:graphql|gql)$/i.test(id)) return null;
+			try {
+				const content = await readFile(id, "utf-8");
+				return `export default ${JSON.stringify(content)}`;
+			} catch (error) {
+				if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") return null;
+				throw error;
+			}
+		},
+		nitro: { async setup(nitro) {
+			if (options) nitro.options.graphql = defu(nitro.options.graphql || {}, options);
+			nitro.options.graphql = nitro.options.graphql || {};
+			nitro.options.graphql._vitePlugin = true;
+			await setupNitroGraphQL(nitro);
+		} }
+	};
+}
+var nitro_default = graphqlModule;
+
+//#endregion
+export { NitroAdapter, nitro_default as default, resolveSecurityConfig, setupNitroGraphQL };

package/dist/{utils/path-resolver.d.mts → nitro/paths.d.mts}

@@ -1,7 +1,7 @@
-import { ClientUtilsConfig, FileGenerationConfig, ScaffoldConfig, SdkConfig, TypesConfig } from "../types/index.mjs";
+import { FileGenerationConfig, SdkConfig, TypesConfig } from "./types.mjs";
 import { Nitro } from "nitro/types";
 
-//#region src/utils/path-resolver.d.ts
+//#region src/nitro/paths.d.ts
 
 /**
  * Placeholder values for path resolution
@@ -34,22 +34,6 @@ declare function shouldGenerateFile(config: FileGenerationConfig | undefined, ca
  * Returns: resolved absolute path or null if file should not be generated
  */
 declare function resolveFilePath(config: FileGenerationConfig | undefined, categoryEnabled: boolean | undefined, topLevelEnabled: boolean, defaultPath: string, placeholders: PathPlaceholders): string | null;
-/**
- * Check if scaffold files should be generated (category-level check)
- */
-declare function shouldGenerateScaffold(nitro: Nitro): boolean;
-/**
- * Get scaffold configuration (handles false case)
- */
-declare function getScaffoldConfig(nitro: Nitro): ScaffoldConfig;
-/**
- * Check if client utilities should be generated (category-level check)
- */
-declare function shouldGenerateClientUtils(nitro: Nitro): boolean;
-/**
- * Get client utilities configuration (handles false case)
- */
-declare function getClientUtilsConfig(nitro: Nitro): ClientUtilsConfig;
 /**
  * Check if SDK files should be generated (category-level check)
  */
@@ -67,4 +51,4 @@ declare function shouldGenerateTypes(nitro: Nitro): boolean;
  */
 declare function getTypesConfig(nitro: Nitro): TypesConfig;
 //#endregion
-export { PathPlaceholders, getClientUtilsConfig, getDefaultPaths, getScaffoldConfig, getSdkConfig, getTypesConfig, replacePlaceholders, resolveFilePath, shouldGenerateClientUtils, shouldGenerateFile, shouldGenerateScaffold, shouldGenerateSdk, shouldGenerateTypes };
+export { PathPlaceholders, getDefaultPaths, getSdkConfig, getTypesConfig, replacePlaceholders, resolveFilePath, shouldGenerateFile, shouldGenerateSdk, shouldGenerateTypes };

package/dist/{utils/path-resolver.mjs → nitro/paths.mjs}

@@ -1,6 +1,6 @@
 import { isAbsolute, resolve } from "pathe";
 
-//#region src/utils/path-resolver.ts
+//#region src/nitro/paths.ts
 /**
 * Replace placeholders in a path string
 * Supports: {serviceName}, {buildDir}, {rootDir}, {framework}, {typesDir}, {serverGraphql}, {clientGraphql}
@@ -55,40 +55,6 @@ function resolveFilePath(config, categoryEnabled, topLevelEnabled, defaultPath,
 	return resolve(placeholders.rootDir, resolvedDefault);
 }
 /**
-* Check if scaffold files should be generated (category-level check)
-*/
-function shouldGenerateScaffold(nitro) {
-	const scaffoldConfig = nitro.options.graphql?.scaffold;
-	if (scaffoldConfig === false) return false;
-	if (scaffoldConfig && scaffoldConfig.enabled === false) return false;
-	return true;
-}
-/**
-* Get scaffold configuration (handles false case)
-*/
-function getScaffoldConfig(nitro) {
-	const scaffoldConfig = nitro.options.graphql?.scaffold;
-	if (scaffoldConfig === false) return { enabled: false };
-	return scaffoldConfig || {};
-}
-/**
-* Check if client utilities should be generated (category-level check)
-*/
-function shouldGenerateClientUtils(nitro) {
-	const clientUtilsConfig = nitro.options.graphql?.clientUtils;
-	if (clientUtilsConfig === false) return false;
-	if (clientUtilsConfig && clientUtilsConfig.enabled === false) return false;
-	return true;
-}
-/**
-* Get client utilities configuration (handles false case)
-*/
-function getClientUtilsConfig(nitro) {
-	const clientUtilsConfig = nitro.options.graphql?.clientUtils;
-	if (clientUtilsConfig === false) return { enabled: false };
-	return clientUtilsConfig || {};
-}
-/**
 * Check if SDK files should be generated (category-level check)
 */
 function shouldGenerateSdk(nitro) {
@@ -124,4 +90,4 @@ function getTypesConfig(nitro) {
 }
 
 //#endregion
-export { getClientUtilsConfig, getDefaultPaths, getScaffoldConfig, getSdkConfig, getTypesConfig, replacePlaceholders, resolveFilePath, shouldGenerateClientUtils, shouldGenerateFile, shouldGenerateScaffold, shouldGenerateSdk, shouldGenerateTypes };
+export { getDefaultPaths, getSdkConfig, getTypesConfig, replacePlaceholders, resolveFilePath, shouldGenerateFile, shouldGenerateSdk, shouldGenerateTypes };

package/dist/{rollup.d.mts → nitro/rollup.d.mts}

@@ -1,6 +1,6 @@
 import { Nitro } from "nitro/types";
 
-//#region src/rollup.d.ts
+//#region src/nitro/rollup.d.ts
 declare function rollupConfig(nitro: Nitro): Promise<void>;
 //#endregion
 export { rollupConfig };

package/dist/{rollup.mjs → nitro/rollup.mjs}

@@ -1,23 +1,13 @@
-import { generateServerTypes } from "./codegen/server-types.mjs";
-import { generateClientTypes } from "./codegen/index.mjs";
-import { scanGraphql } from "./utils/scanning/schemas.mjs";
-import { virtualGraphQLConfig, virtualModuleConfig } from "./virtual/generators/config.mjs";
-import { virtualDebugInfo } from "./virtual/generators/debug.mjs";
-import { virtualDirectives } from "./virtual/generators/directives.mjs";
-import { virtualResolvers } from "./virtual/generators/resolvers.mjs";
-import { virtualSchemas } from "./virtual/generators/schemas.mjs";
+import { NitroAdapter } from "./adapter.mjs";
+import { generateClientTypes, generateServerTypes } from "./codegen.mjs";
+import { registerAllVirtualModules } from "./virtual/generators.mjs";
 import { readFile } from "node:fs/promises";
-import { fileURLToPath } from "node:url";
 import { parse } from "graphql";
+import { fileURLToPath } from "node:url";
 
-//#region src/rollup.ts
+//#region src/nitro/rollup.ts
 async function rollupConfig(nitro) {
-	virtualSchemas(nitro);
-	virtualResolvers(nitro);
-	virtualDirectives(nitro);
-	virtualGraphQLConfig(nitro);
-	virtualModuleConfig(nitro);
-	virtualDebugInfo(nitro);
+	registerAllVirtualModules(nitro);
 	nitro.hooks.hook("rollup:before", (_, rollupConfig$1) => {
 		rollupConfig$1.plugins = rollupConfig$1.plugins || [];
 		const { include = /\.(?:graphql|gql)$/i, exclude, validate = false } = nitro.options.graphql?.loader || {};
@@ -31,12 +21,10 @@ async function rollupConfig(nitro) {
 						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;
+							const internalRes = await this.resolve(id, runtimeDir, { skipSelf: true });
+							if (internalRes) return internalRes.id;
 						}
+						return null;
 					}
 				},
 				load: {
@@ -90,8 +78,8 @@ async function rollupConfig(nitro) {
 				buildStart: {
 					order: "pre",
 					async handler() {
-						const graphqlFiles = await scanGraphql(nitro);
-						for (const file of graphqlFiles) this.addWatchFile(file);
+						const result = await NitroAdapter.scanGraphql(nitro);
+						for (const file of result.items) this.addWatchFile(file);
 					}
 				}
 			});

package/dist/{routes → nitro/routes}/apollo-server.d.mts

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

package/dist/{routes → nitro/routes}/apollo-server.mjs

@@ -1,17 +1,17 @@
-import { createMergedSchema } from "../utils/schema-builder.mjs";
+import { createMergedSchema } from "../../core/schema/builder.mjs";
 import defu from "defu";
+import { ApolloServer } from "@apollo/server";
+import { defineEventHandler } from "nitro/h3";
 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 { ApolloServerPluginLandingPageDisabled } from "@apollo/server/plugin/disabled";
 import { ApolloServerPluginLandingPageLocalDefault } from "@apollo/server/plugin/landingPage/default";
-import { startServerAndCreateH3Handler } from "nitro-graphql/utils/apollo";
-import { defineEventHandler } from "nitro/h3";
+import { startServerAndCreateH3Handler } from "nitro-graphql/apollo";
 
-//#region src/routes/apollo-server.ts
+//#region src/nitro/routes/apollo-server.ts
 let apolloServer = null;
 let serverStarted = false;
 async function createApolloServer() {

package/dist/{routes → nitro/routes}/debug-template.d.mts

@@ -1,4 +1,4 @@
-//#region src/routes/debug-template.d.ts
+//#region src/nitro/routes/debug-template.d.ts
 /**
  * Debug dashboard HTML template
  * Extracted from debug.ts to reduce file complexity

package/dist/{routes → nitro/routes}/debug-template.mjs

@@ -1,4 +1,4 @@
-//#region src/routes/debug-template.ts
+//#region src/nitro/routes/debug-template.ts
 /**
 * Debug dashboard HTML template
 * Extracted from debug.ts to reduce file complexity

package/dist/{routes → nitro/routes}/debug.d.mts

@@ -1,6 +1,6 @@
 import * as nitro_deps_h31 from "nitro/deps/h3";
 
-//#region src/routes/debug.d.ts
+//#region src/nitro/routes/debug.d.ts
 
 /**
  * Debug endpoint for inspecting virtual modules and GraphQL setup
@@ -31,30 +31,24 @@ declare const _default: nitro_deps_h31.EventHandlerWithFetch<nitro_deps_h31.Even
     documentFiles: any;
   };
   runtime: {
-    loadedResolvers: number;
-    loadedSchemas: number;
-    loadedDirectives: number;
+    loadedResolvers: any;
+    loadedSchemas: any;
+    loadedDirectives: any;
   };
   virtualModules: any;
   virtualModuleSamples: {
     'server-resolvers': {
-      resolverCount: number;
-      sample: {
-        hasResolver: boolean;
-        resolverKeys: string[];
-      }[];
+      resolverCount: any;
+      sample: any;
     };
     'server-schemas': {
-      schemaCount: number;
-      sample: {
-        defLength: number;
-        defPreview: string;
-      }[];
+      schemaCount: any;
+      sample: any;
     };
     'server-directives': {
-      directiveCount: number;
+      directiveCount: any;
     };
-    'module-config': Record<string, any>;
+    'module-config': any;
   };
 }>>;
 //#endregion

package/dist/{routes → nitro/routes}/debug.mjs

@@ -1,12 +1,12 @@
 import { generateHtmlDashboard } from "./debug-template.mjs";
+import { defineEventHandler, getQuery } from "nitro/h3";
 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 { defineEventHandler, getQuery } from "nitro/h3";
 import { debugInfo } from "#nitro-graphql/debug-info";
 
-//#region src/routes/debug.ts
+//#region src/nitro/routes/debug.ts
 /**
 * Debug endpoint for inspecting virtual modules and GraphQL setup
 * Only available in development mode

package/dist/{routes → nitro/routes}/graphql-yoga.d.mts

@@ -1,6 +1,6 @@
 import * as nitro_deps_h33 from "nitro/deps/h3";
 
-//#region src/routes/graphql-yoga.d.ts
+//#region src/nitro/routes/graphql-yoga.d.ts
 declare const _default: nitro_deps_h33.EventHandlerWithFetch<nitro_deps_h33.EventHandlerRequest, Promise<Response>>;
 //#endregion
 export { _default as default };

package/dist/{routes → nitro/routes}/graphql-yoga.mjs

@@ -1,14 +1,14 @@
-import { createMergedSchema } from "../utils/schema-builder.mjs";
+import { createMergedSchema } from "../../core/schema/builder.mjs";
 import defu from "defu";
+import { defineEventHandler } from "nitro/h3";
 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 { defineEventHandler } from "nitro/h3";
 import { createYoga } from "graphql-yoga";
 
-//#region src/routes/graphql-yoga.ts
+//#region src/nitro/routes/graphql-yoga.ts
 const apolloSandboxHtml = `<!DOCTYPE html>
 <html lang="en">
 <body style="margin: 0; overflow-x: hidden; overflow-y: hidden">

package/dist/{routes → nitro/routes}/health.d.mts

@@ -1,6 +1,6 @@
 import * as nitro_deps_h35 from "nitro/deps/h3";
 
-//#region src/routes/health.d.ts
+//#region src/nitro/routes/health.d.ts
 declare const _default: nitro_deps_h35.EventHandlerWithFetch<nitro_deps_h35.EventHandlerRequest, Promise<{
   status: string;
   message: string;

package/dist/{routes → nitro/routes}/health.mjs

@@ -2,7 +2,7 @@ import { defineEventHandler } from "nitro/h3";
 import { $fetch } from "nitro/deps/ofetch";
 import { useRuntimeConfig } from "nitro/runtime-config";
 
-//#region src/routes/health.ts
+//#region src/nitro/routes/health.ts
 var health_default = defineEventHandler(async (event) => {
 	const runtime = useRuntimeConfig();
 	if (!runtime.graphql || !runtime.graphql.endpoint?.graphql) {

package/dist/nitro/setup/file-watcher.d.mts

@@ -0,0 +1,16 @@
+import { FSWatcher } from "chokidar";
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/setup/file-watcher.d.ts
+
+/**
+ * Setup file watcher for GraphQL files (schemas, resolvers, directives, documents)
+ * Watches for changes and triggers type regeneration and dev server reload
+ */
+declare function setupFileWatcher(nitro: Nitro, watchDirs: string[]): FSWatcher;
+/**
+ * Determine which directories to watch based on framework and configuration
+ */
+declare function getWatchDirectories(nitro: Nitro): string[];
+//#endregion
+export { getWatchDirectories, setupFileWatcher };

package/dist/{setup → nitro/setup}/file-watcher.mjs

@@ -1,17 +1,13 @@
-import { DIRECTIVE_EXTENSIONS, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, GRAPHQL_EXTENSIONS, LOG_TAG, RESOLVER_EXTENSIONS } from "../constants.mjs";
-import { generateServerTypes } from "../codegen/server-types.mjs";
-import { generateClientTypes } from "../codegen/index.mjs";
-import { DEFAULT_WATCHER_IGNORE_INITIAL, DEFAULT_WATCHER_PERSISTENT } from "../config/defaults.mjs";
-import { generateDirectiveSchemas } from "../utils/directive-parser.mjs";
-import { generateLayerIgnorePatterns, getLayerAppDirectories, getLayerServerDirectories } from "../utils/layers.mjs";
-import { scanDirectives } from "../utils/scanning/directives.mjs";
-import { scanResolvers } from "../utils/scanning/resolvers.mjs";
-import { scanSchemas } from "../utils/scanning/schemas.mjs";
+import { DIRECTIVE_EXTENSIONS, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, GRAPHQL_EXTENSIONS, LOG_TAG, RESOLVER_EXTENSIONS } from "../../core/constants.mjs";
+import { generateDirectiveSchemas } from "../../core/utils/directive-parser.mjs";
+import { NitroAdapter } from "../adapter.mjs";
+import { generateClientTypes, generateServerTypes } from "../codegen.mjs";
+import { DEFAULT_WATCHER_IGNORE_INITIAL, DEFAULT_WATCHER_PERSISTENT } from "../config.mjs";
 import consola from "consola";
 import { join } from "pathe";
 import { watch } from "chokidar";
 
-//#region src/setup/file-watcher.ts
+//#region src/nitro/setup/file-watcher.ts
 const logger = consola.withTag(LOG_TAG);
 /**
 * Setup file watcher for GraphQL files (schemas, resolvers, directives, documents)
@@ -21,21 +17,21 @@ function setupFileWatcher(nitro, watchDirs) {
 	const watcher = watch(watchDirs, {
 		persistent: DEFAULT_WATCHER_PERSISTENT,
 		ignoreInitial: DEFAULT_WATCHER_IGNORE_INITIAL,
-		ignored: [...nitro.options.ignore, ...generateLayerIgnorePatterns()]
+		ignored: nitro.options.ignore
 	});
 	watcher.on("all", async (_, path) => {
 		const isGraphQLFile = GRAPHQL_EXTENSIONS.some((ext) => path.endsWith(ext));
 		const isResolverFile = RESOLVER_EXTENSIONS.some((ext) => path.endsWith(ext));
 		const isDirectiveFile = DIRECTIVE_EXTENSIONS.some((ext) => path.endsWith(ext));
 		if (isGraphQLFile || isResolverFile || isDirectiveFile) if (path.includes(nitro.graphql.serverDir) || path.includes(DIR_SERVER_GRAPHQL) || path.includes(DIR_SERVER_GRAPHQL_WIN) || isResolverFile || isDirectiveFile) {
-			const directives = await scanDirectives(nitro);
-			nitro.scanDirectives = directives;
+			const directivesResult = await NitroAdapter.scanDirectives(nitro);
+			nitro.scanDirectives = directivesResult.items;
 			if (!nitro.scanSchemas) nitro.scanSchemas = [];
-			const directivesPath = await generateDirectiveSchemas(nitro, directives);
-			const schemas = await scanSchemas(nitro);
+			const directivesPath = await generateDirectiveSchemas(nitro, directivesResult.items);
+			const schemas = (await NitroAdapter.scanSchemas(nitro)).items;
 			if (directivesPath && !schemas.includes(directivesPath)) schemas.push(directivesPath);
 			nitro.scanSchemas = schemas;
-			await scanResolvers(nitro).then((r) => nitro.scanResolvers = r);
+			nitro.scanResolvers = (await NitroAdapter.scanResolvers(nitro)).items;
 			logger.success("Types regenerated");
 			await generateServerTypes(nitro, { silent: true });
 			await generateClientTypes(nitro, { silent: true });
@@ -55,8 +51,8 @@ function getWatchDirectories(nitro) {
 	switch (nitro.options.framework.name) {
 		case "nuxt": {
 			watchDirs.push(nitro.graphql.clientDir);
-			const layerServerDirs = getLayerServerDirectories(nitro);
-			const layerAppDirs = getLayerAppDirectories(nitro);
+			const layerServerDirs = nitro.options.graphql?.layerServerDirs || [];
+			const layerAppDirs = nitro.options.graphql?.layerAppDirs || [];
 			for (const layerServerDir of layerServerDirs) watchDirs.push(join(layerServerDir, "graphql"));
 			for (const layerAppDir of layerAppDirs) watchDirs.push(join(layerAppDir, "graphql"));
 			break;

package/dist/{setup.d.mts → nitro/setup/logging.d.mts}

@@ -1,7 +1,7 @@
-import { SecurityConfig } from "./types/index.mjs";
+import { SecurityConfig } from "../types.mjs";
 import { Nitro } from "nitro/types";
 
-//#region src/setup.d.ts
+//#region src/nitro/setup/logging.d.ts
 
 /**
  * Resolves security configuration with environment-aware defaults
@@ -10,9 +10,8 @@ import { Nitro } from "nitro/types";
  */
 declare function resolveSecurityConfig(config?: SecurityConfig): Required<SecurityConfig>;
 /**
- * Main setup function for nitro-graphql
- * Coordinates all initialization steps for the module
+ * Log startup information
  */
-declare function setupNitroGraphQL(nitro: Nitro): Promise<void>;
+declare function logStartupInfo(nitro: Nitro, serverEnabled: boolean): void;
 //#endregion
-export { resolveSecurityConfig, setupNitroGraphQL };
+export { logStartupInfo, resolveSecurityConfig };

package/dist/nitro/setup/logging.mjs

@@ -0,0 +1,66 @@
+import consola from "consola";
+
+//#region src/nitro/setup/logging.ts
+/**
+* Resolves security configuration with environment-aware defaults
+* In production: introspection off, playground off, errors masked, suggestions disabled
+* In development: introspection on, playground on, errors shown, suggestions enabled
+*/
+function resolveSecurityConfig(config) {
+	const isProd = process.env.NODE_ENV === "production";
+	return {
+		introspection: config?.introspection ?? !isProd,
+		playground: config?.playground ?? !isProd,
+		maskErrors: config?.maskErrors ?? isProd,
+		disableSuggestions: config?.disableSuggestions ?? isProd
+	};
+}
+/**
+* Log startup information
+*/
+function logStartupInfo(nitro, serverEnabled) {
+	const externalServicesCount = nitro.options.graphql?.externalServices?.length || 0;
+	const docs = nitro.scanDocuments || [];
+	const isProd = process.env.NODE_ENV === "production";
+	if (serverEnabled) {
+		const securityConfig = resolveSecurityConfig(nitro.options.graphql?.security);
+		const framework = nitro.options.graphql?.framework || "unknown";
+		const schemas = nitro.scanSchemas?.length || 0;
+		const resolvers = nitro.scanResolvers?.length || 0;
+		consola.box({
+			title: "Nitro GraphQL",
+			message: [
+				`Framework: ${framework}`,
+				`Environment: ${isProd ? "production" : "development"}`,
+				`Schemas: ${schemas}`,
+				`Resolvers: ${resolvers}`,
+				externalServicesCount > 0 ? `External Services: ${externalServicesCount}` : "",
+				docs.length > 0 ? `Documents: ${docs.length}` : "",
+				"",
+				"Security:",
+				`├─ Introspection: ${securityConfig.introspection ? "enabled" : "disabled"}`,
+				`├─ Playground: ${securityConfig.playground ? "enabled" : "disabled"}`,
+				`├─ Error Masking: ${securityConfig.maskErrors ? "enabled" : "disabled"}`,
+				`└─ Field Suggestions: ${securityConfig.disableSuggestions ? "disabled" : "enabled"}`
+			].filter(Boolean).join("\n"),
+			style: {
+				borderColor: isProd ? "yellow" : "cyan",
+				borderStyle: "rounded"
+			}
+		});
+	} else consola.box({
+		title: "Nitro GraphQL (Client Only)",
+		message: [
+			"Server mode: disabled",
+			`External Services: ${externalServicesCount}`,
+			`Documents: ${docs.length}`
+		].join("\n"),
+		style: {
+			borderColor: "blue",
+			borderStyle: "rounded"
+		}
+	});
+}
+
+//#endregion
+export { logStartupInfo, resolveSecurityConfig };

package/dist/nitro/setup/rollup-integration.d.mts

@@ -0,0 +1,16 @@
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/setup/rollup-integration.d.ts
+
+/**
+ * Setup Rollup/Rolldown chunking configuration for GraphQL files
+ * Creates separate chunks for schemas and resolvers to optimize bundle size
+ */
+declare function setupRollupChunking(nitro: Nitro): void;
+/**
+ * Configure external dependencies for Rollup
+ * Marks codegen and federation packages as external
+ */
+declare function setupRollupExternals(nitro: Nitro): void;
+//#endregion
+export { setupRollupChunking, setupRollupExternals };

package/dist/{setup → nitro/setup}/rollup-integration.mjs

@@ -1,6 +1,6 @@
-import { CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, GRAPHQL_EXTENSIONS, RESOLVER_EXTENSIONS } from "../constants.mjs";
+import { CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, GRAPHQL_EXTENSIONS, RESOLVER_EXTENSIONS } from "../../core/constants.mjs";
 
-//#region src/setup/rollup-integration.ts
+//#region src/nitro/setup/rollup-integration.ts
 /**
 * Setup Rollup/Rolldown chunking configuration for GraphQL files
 * Creates separate chunks for schemas and resolvers to optimize bundle size

package/dist/nitro/setup/routes.d.mts

@@ -0,0 +1,10 @@
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/setup/routes.d.ts
+
+/**
+ * Register GraphQL route handlers
+ */
+declare function registerRouteHandlers(nitro: Nitro): void;
+//#endregion
+export { registerRouteHandlers };

package/dist/nitro/setup/routes.mjs

@@ -0,0 +1,35 @@
+import { ENDPOINT_DEBUG, GRAPHQL_HTTP_METHODS } from "../../core/constants.mjs";
+import { join } from "pathe";
+import { fileURLToPath } from "node:url";
+
+//#region src/nitro/setup/routes.ts
+/**
+* Register GraphQL route handlers
+*/
+function registerRouteHandlers(nitro) {
+	const runtime = fileURLToPath(new URL("../routes", import.meta.url));
+	const framework = nitro.options.graphql?.framework;
+	if (framework === "graphql-yoga") for (const method of GRAPHQL_HTTP_METHODS) nitro.options.handlers.push({
+		route: nitro.options.runtimeConfig.graphql?.endpoint?.graphql || "/api/graphql",
+		handler: join(runtime, "graphql-yoga"),
+		method
+	});
+	if (framework === "apollo-server") for (const method of GRAPHQL_HTTP_METHODS) nitro.options.handlers.push({
+		route: nitro.options.runtimeConfig.graphql?.endpoint?.graphql || "/api/graphql",
+		handler: join(runtime, "apollo-server"),
+		method
+	});
+	nitro.options.handlers.push({
+		route: nitro.options.runtimeConfig.graphql?.endpoint?.healthCheck || "/api/graphql/health",
+		handler: join(runtime, "health"),
+		method: "GET"
+	});
+	if (nitro.options.dev) nitro.options.handlers.push({
+		route: ENDPOINT_DEBUG,
+		handler: join(runtime, "debug"),
+		method: "GET"
+	});
+}
+
+//#endregion
+export { registerRouteHandlers };

package/dist/nitro/setup/ts-config.d.mts

@@ -0,0 +1,11 @@
+import { Nitro, NitroTypes } from "nitro/types";
+
+//#region src/nitro/setup/ts-config.d.ts
+
+/**
+ * Setup TypeScript path aliases for GraphQL types
+ * Called via nitro:config hook to extend tsconfig.json
+ */
+declare function setupTypeScriptPaths(nitro: Nitro, types: NitroTypes): void;
+//#endregion
+export { setupTypeScriptPaths };