nitro-graphql 1.7.0 → 1.8.0

package/dist/index.mjs

@@ -31,7 +31,8 @@ function resolveSecurityConfig(config) {
 var src_default = defineNitroModule({
 	name: "nitro-graphql",
 	async setup(nitro) {
-		if (!nitro.options.graphql?.framework) consola.warn("No GraphQL framework specified. Please set graphql.framework to \"graphql-yoga\" or \"apollo-server\".");
+		const serverEnabled = nitro.options.graphql?.server !== false;
+		if (serverEnabled && !nitro.options.graphql?.framework) consola.warn("No GraphQL framework specified. Please set graphql.framework to \"graphql-yoga\" or \"apollo-server\".");
 		if (nitro.options.graphql?.externalServices?.length) {
 			const validationErrors = validateExternalServices(nitro.options.graphql.externalServices);
 			if (validationErrors.length > 0) {
@@ -117,123 +118,133 @@ var src_default = defineNitroModule({
 			watcher.close();
 		});
 		const tsconfigDir = dirname(resolve(nitro.options.buildDir, nitro.options.typescript.tsconfigPath));
-		nitro.scanSchemas = await scanSchemas(nitro);
+		if (serverEnabled) {
+			nitro.scanSchemas = await scanSchemas(nitro);
+			nitro.scanResolvers = await scanResolvers(nitro);
+			const directives = await scanDirectives(nitro);
+			nitro.scanDirectives = directives;
+			await generateDirectiveSchemas(nitro, directives);
+		} else {
+			nitro.scanSchemas = [];
+			nitro.scanResolvers = [];
+			nitro.scanDirectives = [];
+		}
 		nitro.scanDocuments = await scanDocs(nitro);
-		nitro.scanResolvers = await scanResolvers(nitro);
-		const directives = await scanDirectives(nitro);
-		nitro.scanDirectives = directives;
-		await generateDirectiveSchemas(nitro, directives);
 		nitro.hooks.hook("dev:start", async () => {
-			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);
+			let schemas = [];
+			let resolvers = [];
+			let directives = [];
+			if (serverEnabled) {
+				schemas = await scanSchemas(nitro);
+				nitro.scanSchemas = schemas;
+				resolvers = await scanResolvers(nitro);
+				nitro.scanResolvers = resolvers;
+				directives = await scanDirectives(nitro);
+				nitro.scanDirectives = directives;
+				await generateDirectiveSchemas(nitro, directives);
+			}
 			const docs = await scanDocs(nitro);
 			nitro.scanDocuments = docs;
 			if (nitro.options.dev) {
 				const runtimeSecurityConfig = nitro.options.runtimeConfig.graphql?.security;
 				const isProd = process.env.NODE_ENV === "production";
-				consola.box({
-					title: "Nitro GraphQL",
-					message: [
-						`Framework: ${nitro.options.graphql?.framework || "Not configured"}`,
-						`Environment: ${isProd ? "production" : "development"}`,
-						`Schemas: ${schemas.length}`,
-						`Resolvers: ${resolvers.length}`,
-						`Directives: ${directives$1.length}`,
-						`Documents: ${docs.length}`,
-						"",
-						"Security:",
-						`├─ Introspection: ${runtimeSecurityConfig?.introspection ? "enabled" : "disabled"}`,
-						`├─ Playground: ${runtimeSecurityConfig?.playground ? "enabled" : "disabled"}`,
-						`├─ Error Masking: ${runtimeSecurityConfig?.maskErrors ? "enabled" : "disabled"}`,
-						`└─ Field Suggestions: ${runtimeSecurityConfig?.disableSuggestions ? "disabled" : "enabled"}`,
-						"",
-						"Debug Dashboard: /_nitro/graphql/debug"
-					].join("\n"),
-					style: {
-						borderColor: isProd ? "yellow" : "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.");
+				if (serverEnabled) {
+					consola.box({
+						title: "Nitro GraphQL",
+						message: [
+							`Framework: ${nitro.options.graphql?.framework || "Not configured"}`,
+							`Environment: ${isProd ? "production" : "development"}`,
+							`Schemas: ${schemas.length}`,
+							`Resolvers: ${resolvers.length}`,
+							`Directives: ${directives.length}`,
+							`Documents: ${docs.length}`,
+							"",
+							"Security:",
+							`├─ Introspection: ${runtimeSecurityConfig?.introspection ? "enabled" : "disabled"}`,
+							`├─ Playground: ${runtimeSecurityConfig?.playground ? "enabled" : "disabled"}`,
+							`├─ Error Masking: ${runtimeSecurityConfig?.maskErrors ? "enabled" : "disabled"}`,
+							`└─ Field Suggestions: ${runtimeSecurityConfig?.disableSuggestions ? "disabled" : "enabled"}`,
+							"",
+							"Debug Dashboard: /_nitro/graphql/debug"
+						].join("\n"),
+						style: {
+							borderColor: isProd ? "yellow" : "cyan",
+							borderStyle: "rounded"
+						}
+					});
+					if (resolvers.length === 0) consola.warn("[nitro-graphql] No resolvers found. Check /_nitro/graphql/debug for details.");
+				} else {
+					const externalServicesCount = nitro.options.graphql?.externalServices?.length || 0;
+					consola.box({
+						title: "Nitro GraphQL (Client Only)",
+						message: [
+							"Server mode: disabled",
+							`External Services: ${externalServicesCount}`,
+							`Documents: ${docs.length}`
+						].join("\n"),
+						style: {
+							borderColor: "blue",
+							borderStyle: "rounded"
+						}
+					});
+				}
 			}
 		});
-		await rollupConfig(nitro);
-		await serverTypeGeneration(nitro);
+		if (serverEnabled) await rollupConfig(nitro);
+		else nitro.hooks.hook("dev:reload", async () => {
+			await clientTypeGeneration(nitro);
+		});
+		if (serverEnabled) await serverTypeGeneration(nitro);
 		await clientTypeGeneration(nitro);
 		nitro.hooks.hook("close", async () => {
-			await serverTypeGeneration(nitro);
+			if (serverEnabled) await serverTypeGeneration(nitro);
 			await clientTypeGeneration(nitro);
 		});
-		const runtime = fileURLToPath(new URL("routes", import.meta.url));
-		const methods = [
-			"get",
-			"post",
-			"options"
-		];
-		if (nitro.options.graphql?.framework === "graphql-yoga") for (const method of methods) nitro.options.handlers.push({
-			route: nitro.options.runtimeConfig.graphql?.endpoint?.graphql || "/api/graphql",
-			handler: join(runtime, "graphql-yoga"),
-			method
-		});
-		if (nitro.options.graphql?.framework === "apollo-server") for (const method of 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.graphql?.subscriptions?.enabled) {
-			nitro.options.experimental ||= {};
-			nitro.options.experimental.websocket = true;
-			const wsEndpoint = nitro.options.runtimeConfig.graphql?.endpoint?.ws || nitro.options.graphql?.subscriptions?.endpoint || "/api/graphql/ws";
-			if (nitro.options.graphql?.framework === "graphql-yoga") nitro.options.handlers.push({
-				route: wsEndpoint,
-				handler: join(runtime, "graphql-yoga-ws")
+		if (serverEnabled) {
+			const runtime = fileURLToPath(new URL("routes", import.meta.url));
+			const methods = [
+				"get",
+				"post",
+				"options"
+			];
+			if (nitro.options.graphql?.framework === "graphql-yoga") for (const method of methods) nitro.options.handlers.push({
+				route: nitro.options.runtimeConfig.graphql?.endpoint?.graphql || "/api/graphql",
+				handler: join(runtime, "graphql-yoga"),
+				method
 			});
-			if (nitro.options.graphql?.framework === "apollo-server") nitro.options.handlers.push({
-				route: wsEndpoint,
-				handler: join(runtime, "apollo-server-ws")
+			if (nitro.options.graphql?.framework === "apollo-server") for (const method of methods) nitro.options.handlers.push({
+				route: nitro.options.runtimeConfig.graphql?.endpoint?.graphql || "/api/graphql",
+				handler: join(runtime, "apollo-server"),
+				method
 			});
-			nitro.options.plugins ??= [];
-			nitro.options.plugins.push(join(runtime, "ws-shutdown"));
-			consola.info(`[nitro-graphql] WebSocket subscriptions enabled at: ${wsEndpoint}`);
-		}
-		if (nitro.options.dev) {
 			nitro.options.handlers.push({
+				route: nitro.options.runtimeConfig.graphql?.endpoint?.healthCheck || "/api/graphql/health",
+				handler: join(runtime, "health"),
+				method: "get"
+			});
+			if (nitro.options.graphql?.subscriptions?.enabled) {
+				nitro.options.experimental ||= {};
+				nitro.options.experimental.websocket = true;
+				const wsEndpoint = nitro.options.runtimeConfig.graphql?.endpoint?.ws || nitro.options.graphql?.subscriptions?.endpoint || "/api/graphql/ws";
+				if (nitro.options.graphql?.framework === "graphql-yoga") nitro.options.handlers.push({
+					route: wsEndpoint,
+					handler: join(runtime, "graphql-yoga-ws")
+				});
+				if (nitro.options.graphql?.framework === "apollo-server") nitro.options.handlers.push({
+					route: wsEndpoint,
+					handler: join(runtime, "apollo-server-ws")
+				});
+				nitro.options.plugins ??= [];
+				nitro.options.plugins.push(join(runtime, "ws-shutdown"));
+				consola.info(`[nitro-graphql] WebSocket subscriptions enabled at: ${wsEndpoint}`);
+			}
+			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) {
+		if (serverEnabled && nitro.options.imports) {
 			nitro.options.imports.presets ??= [];
 			nitro.options.imports.presets.push({
 				from: fileURLToPath(new URL("utils/define", import.meta.url)),
@@ -250,7 +261,7 @@ var src_default = defineNitroModule({
 				]
 			});
 		}
-		nitro.hooks.hook("rollup:before", (_, rollupConfig$1) => {
+		if (serverEnabled) 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) => {
@@ -271,11 +282,14 @@ var src_default = defineNitroModule({
 			types.tsConfig.compilerOptions.paths ??= {};
 			const placeholders = getDefaultPaths(nitro);
 			const typesConfig = getTypesConfig(nitro);
-			const serverTypesPath = resolveFilePath(typesConfig.server, typesConfig.enabled, true, "{typesDir}/nitro-graphql-server.d.ts", placeholders);
-			if (serverTypesPath) types.tsConfig.compilerOptions.paths["#graphql/server"] = [relativeWithDot(tsconfigDir, serverTypesPath)];
+			let serverTypesPath = null;
+			if (serverEnabled) {
+				serverTypesPath = resolveFilePath(typesConfig.server, typesConfig.enabled, true, "{typesDir}/nitro-graphql-server.d.ts", placeholders);
+				if (serverTypesPath) types.tsConfig.compilerOptions.paths["#graphql/server"] = [relativeWithDot(tsconfigDir, serverTypesPath)];
+				types.tsConfig.compilerOptions.paths["#graphql/schema"] = [relativeWithDot(tsconfigDir, join(nitro.graphql.serverDir, "schema.ts"))];
+			}
 			const clientTypesPath = resolveFilePath(typesConfig.client, typesConfig.enabled, true, "{typesDir}/nitro-graphql-client.d.ts", placeholders);
 			if (clientTypesPath) types.tsConfig.compilerOptions.paths["#graphql/client"] = [relativeWithDot(tsconfigDir, clientTypesPath)];
-			types.tsConfig.compilerOptions.paths["#graphql/schema"] = [relativeWithDot(tsconfigDir, join(nitro.graphql.serverDir, "schema.ts"))];
 			if (nitro.options.graphql?.externalServices?.length) for (const service of nitro.options.graphql.externalServices) {
 				const servicePlaceholders = {
 					...placeholders,
@@ -304,8 +318,9 @@ var src_default = defineNitroModule({
 		if (shouldGenerateScaffold(nitro)) {
 			const placeholders = getDefaultPaths(nitro);
 			const scaffoldConfig = getScaffoldConfig(nitro);
-			const graphqlConfigPath = resolveFilePath(scaffoldConfig.graphqlConfig, scaffoldConfig.enabled, true, "graphql.config.ts", placeholders);
-			if (graphqlConfigPath) writeFileIfNotExists(graphqlConfigPath, `
+			if (serverEnabled) {
+				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> {
@@ -320,17 +335,17 @@ export default <IGraphQLConfig> {
       },
     },
 }`, "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({
+				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({
 
 })
 `, "server schema.ts");
-			if (serverConfigPath) writeFileIfNotExists(serverConfigPath, `// Example GraphQL config file please change it to your needs
+				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'
 
@@ -346,7 +361,7 @@ export default defineGraphQLConfig({
 // },
 })
 `, "server config.ts");
-			if (serverContextPath) writeFileIfNotExists(serverContextPath, `// Example context definition - please change it to your needs
+				if (serverContextPath) writeFileIfNotExists(serverContextPath, `// Example context definition - please change it to your needs
 // import type { Database } from '../utils/useDb'
 
 declare module 'h3' {
@@ -362,15 +377,16 @@ declare module 'h3' {
     // }
   }
 }`, "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");
-			}
-			if (nitro.options.graphql?.subscriptions?.enabled) {
-				if (!existsSync(nitro.graphql.clientDir)) mkdirSync(nitro.graphql.clientDir, { recursive: true });
-				const defaultDir = resolve(nitro.graphql.clientDir, "default");
-				if (!existsSync(defaultDir)) mkdirSync(defaultDir, { recursive: true });
-				writeFileIfNotExists(resolve(defaultDir, "subscribe.ts"), subscribeClientTemplate, "subscribe.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");
+				}
+				if (nitro.options.graphql?.subscriptions?.enabled) {
+					if (!existsSync(nitro.graphql.clientDir)) mkdirSync(nitro.graphql.clientDir, { recursive: true });
+					const defaultDir = resolve(nitro.graphql.clientDir, "default");
+					if (!existsSync(defaultDir)) mkdirSync(defaultDir, { recursive: true });
+					writeFileIfNotExists(resolve(defaultDir, "subscribe.ts"), subscribeClientTemplate, "subscribe.ts");
+				}
 			}
 		} else consola.info("[nitro-graphql] Scaffold file generation is disabled (library mode)");
 	}

package/dist/rollup.mjs

@@ -62,15 +62,13 @@ function virtualSchemas(app) {
 			}
 			const importStatements = imports.map((handler) => `import ${getImportId(handler)} from '${handler}';`);
 			const schemaArray = imports.map((h) => `{ def: ${getImportId(h)} }`);
-			const code = `
+			return `
 ${importStatements.join("\n")}
 
 export const schemas = [
 ${schemaArray.join(",\n")}
 ];
     `;
-			if (app.options.dev) app.logger.success(`[nitro-graphql] Generated virtual schema module: ${imports.length} schema(s)`);
-			return code;
 		} catch (error) {
 			app.logger.error("[nitro-graphql] Failed to generate virtual schema module:", error);
 			return "export const schemas = []";
@@ -108,7 +106,7 @@ function virtualResolvers(app) {
 				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");
-			const code = [
+			return [
 				...importsContent,
 				"",
 				"export const resolvers = [",
@@ -116,11 +114,6 @@ function virtualResolvers(app) {
 				"]",
 				""
 			].join("\n");
-			if (app.options.dev) {
-				const totalExports = imports.reduce((sum, r) => sum + r.imports.length, 0);
-				app.logger.success(`[nitro-graphql] Generated virtual resolver module: ${totalExports} export(s) from ${imports.length} file(s)`);
-			}
-			return code;
 		} catch (error) {
 			app.logger.error("[nitro-graphql] Failed to generate virtual resolver module:", error);
 			return "export const resolvers = []";
@@ -155,7 +148,7 @@ function virtualDirectives(app) {
 				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");
-			const code = [
+			return [
 				...importsContent,
 				"",
 				"export const directives = [",
@@ -163,11 +156,6 @@ function virtualDirectives(app) {
 				"]",
 				""
 			].join("\n");
-			if (app.options.dev) {
-				const totalExports = imports.reduce((sum, d) => sum + d.imports.length, 0);
-				app.logger.success(`[nitro-graphql] Generated virtual directive module: ${totalExports} directive(s) from ${imports.length} file(s)`);
-			}
-			return code;
 		} catch (error) {
 			app.logger.error("[nitro-graphql] Failed to generate virtual directive module:", error);
 			return "export const directives = []";

package/dist/routes/apollo-server-ws.d.mts

@@ -1,4 +1,4 @@
-import * as h39 from "h3";
+import * as h33 from "h3";
 
 //#region src/routes/apollo-server-ws.d.ts
 
@@ -7,6 +7,6 @@ import * as h39 from "h3";
  * Called by the Nitro runtime plugin on server close.
  */
 declare function shutdownAllConnections(): Promise<void>;
-declare const _default: h39.EventHandler<h39.EventHandlerRequest, never>;
+declare const _default: h33.EventHandler<h33.EventHandlerRequest, never>;
 //#endregion
 export { _default as default, shutdownAllConnections };

package/dist/routes/graphql-yoga-ws.d.mts

@@ -1,4 +1,4 @@
-import * as h31 from "h3";
+import * as h37 from "h3";
 
 //#region src/routes/graphql-yoga-ws.d.ts
 
@@ -7,6 +7,6 @@ import * as h31 from "h3";
  * Called by the Nitro runtime plugin on server close.
  */
 declare function shutdownAllConnections(): Promise<void>;
-declare const _default: h31.EventHandler<h31.EventHandlerRequest, never>;
+declare const _default: h37.EventHandler<h37.EventHandlerRequest, never>;
 //#endregion
 export { _default as default, shutdownAllConnections };

package/dist/routes/graphql-yoga.d.mts

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

package/dist/routes/health.d.mts

@@ -1,7 +1,7 @@
-import * as h37 from "h3";
+import * as h31 from "h3";
 
 //#region src/routes/health.d.ts
-declare const _default: h37.EventHandler<h37.EventHandlerRequest, Promise<{
+declare const _default: h31.EventHandler<h31.EventHandlerRequest, Promise<{
   status: string;
   message: string;
   timestamp: string;

package/dist/types/index.d.mts

@@ -79,10 +79,13 @@ interface ExternalServicePaths {
 interface ExternalGraphQLService {
   /** Unique name for this service (used for file naming and type generation) */
   name: string;
-  /** Schema source - can be URL(s) for remote schemas or file path(s) for local schemas */
-  schema: string | string[];
-  /** GraphQL endpoint for this service */
+  /** GraphQL endpoint for this service (also used as schema source if `schema` is not specified) */
   endpoint: string;
+  /**
+   * Schema source - can be URL(s) for remote schemas or file path(s) for local schemas
+   * @default Uses `endpoint` for introspection if not specified
+   */
+  schema?: string | string[];
   /** Optional headers for schema introspection and client requests */
   headers?: Record<string, string> | (() => Record<string, string>);
   /** Optional: specific document patterns for this service */
@@ -235,6 +238,13 @@ interface SecurityConfig {
 }
 interface NitroGraphQLOptions {
   framework: 'graphql-yoga' | 'apollo-server';
+  /**
+   * Enable/disable GraphQL server functionality
+   * When set to false, only external services client types will be generated
+   * Server routes, resolvers, schemas, and directives will not be processed
+   * @default true
+   */
+  server?: boolean;
   endpoint?: {
     graphql?: string;
     healthCheck?: string;

package/dist/utils/client-codegen.mjs

@@ -53,7 +53,8 @@ async function graphQLLoadSchemaSync(schemaPointers, data = {}) {
 async function loadExternalSchema(service, buildDir) {
 	try {
 		const headers = typeof service.headers === "function" ? service.headers() : service.headers || {};
-		const schemas = Array.isArray(service.schema) ? service.schema : [service.schema];
+		const schemaSource = service.schema ?? service.endpoint;
+		const schemas = Array.isArray(schemaSource) ? schemaSource : [schemaSource];
 		if (service.downloadSchema && buildDir) {
 			const defaultPath = resolve(buildDir, "graphql", "schemas", `${service.name}.graphql`);
 			const schemaFilePath = service.downloadPath ? resolve(service.downloadPath) : defaultPath;
@@ -88,14 +89,15 @@ function isUrl(path) {
 * Download and save schema from external service
 */
 async function downloadAndSaveSchema(service, buildDir) {
-	const downloadMode = service.downloadSchema;
+	const schemaSource = service.schema ?? service.endpoint;
+	const schemas = Array.isArray(schemaSource) ? schemaSource : [schemaSource];
+	const hasUrlSchemas = schemas.some((schema) => isUrl(schema));
+	const downloadMode = service.downloadSchema ?? (hasUrlSchemas ? true : false);
 	if (!downloadMode || downloadMode === "manual") return;
 	const defaultPath = resolve(buildDir, "graphql", "schemas", `${service.name}.graphql`);
 	const schemaFilePath = service.downloadPath ? resolve(service.downloadPath) : defaultPath;
 	try {
 		const headers = typeof service.headers === "function" ? service.headers() : service.headers || {};
-		const schemas = Array.isArray(service.schema) ? service.schema : [service.schema];
-		const hasUrlSchemas = schemas.some((schema) => isUrl(schema));
 		const hasLocalSchemas = schemas.some((schema) => !isUrl(schema));
 		let shouldDownload = false;
 		const fileExists = existsSync(schemaFilePath);

package/dist/utils/index.mjs

@@ -216,7 +216,6 @@ function validateExternalServices(services) {
 		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);

package/dist/utils/type-generation.mjs

@@ -232,7 +232,6 @@ async function serverTypeGeneration(app) {
 		if (serverTypesPath) {
 			mkdirSync(dirname(serverTypesPath), { recursive: true });
 			writeFileSync(serverTypesPath, data, "utf-8");
-			consola.success(`[nitro-graphql] Generated server types at: ${serverTypesPath}`);
 		}
 	} catch (error) {
 		consola.error("Server schema generation error:", error);
@@ -293,13 +292,11 @@ async function generateMainClientTypes(nitro) {
 	if (clientTypesPath) {
 		mkdirSync(dirname(clientTypesPath), { recursive: true });
 		writeFileSync(clientTypesPath, types.types, "utf-8");
-		consola.success(`[nitro-graphql] 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");
-		consola.success(`[nitro-graphql] Generated SDK at: ${sdkPath}`);
 	}
 	if (nitro.options.framework?.name === "nuxt") {
 		generateNuxtOfetchClient(nitro, nitro.graphql.clientDir, "default");
@@ -310,7 +307,6 @@ async function generateMainClientTypes(nitro) {
 async function generateExternalServicesTypes(nitro) {
 	const externalServices = nitro.options.graphql?.externalServices || [];
 	for (const service of externalServices) try {
-		consola.info(`[graphql:${service.name}] Processing external service`);
 		await downloadAndSaveSchema(service, nitro.options.buildDir);
 		const schema = await loadExternalSchema(service, nitro.options.buildDir);
 		if (!schema) {
@@ -344,16 +340,13 @@ async function generateExternalServicesTypes(nitro) {
 		if (serviceTypesPath) {
 			mkdirSync(dirname(serviceTypesPath), { recursive: true });
 			writeFileSync(serviceTypesPath, types.types, "utf-8");
-			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");
-			consola.success(`[graphql:${service.name}] Generated SDK at: ${serviceSdkPath}`);
 		}
 		if (nitro.options.framework?.name === "nuxt") generateExternalOfetchClient(nitro, service, service.endpoint);
-		consola.success(`[graphql:${service.name}] External service types generated successfully`);
 	} catch (error) {
 		consola.error(`[graphql:${service.name}] External service generation failed:`, error);
 	}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nitro-graphql",
   "type": "module",
-  "version": "1.7.0",
+  "version": "1.8.0",
   "description": "GraphQL integration for Nitro",
   "license": "MIT",
   "repository": {