nitro-graphql 2.0.0-beta.36 → 2.0.0-beta.38

package/dist/nitro/routes/apollo-server.mjs

@@ -0,0 +1,71 @@
+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 { ApolloServerPluginLandingPageDisabled } from "@apollo/server/plugin/disabled";
+import { ApolloServerPluginLandingPageLocalDefault } from "@apollo/server/plugin/landingPage/default";
+import { startServerAndCreateH3Handler } from "nitro-graphql/apollo";
+
+//#region src/nitro/routes/apollo-server.ts
+let apolloServer = null;
+let serverStarted = false;
+async function createApolloServer() {
+	if (!apolloServer) {
+		const schema = await createMergedSchema({
+			schemas,
+			resolvers,
+			directives,
+			moduleConfig
+		});
+		const securityConfig = moduleConfig.security || {
+			introspection: true,
+			playground: true,
+			maskErrors: false,
+			disableSuggestions: false
+		};
+		const plugins = [];
+		if (securityConfig.playground) plugins.push(ApolloServerPluginLandingPageLocalDefault({ embed: true }));
+		else plugins.push(ApolloServerPluginLandingPageDisabled());
+		const userFacingCodes = [
+			"BAD_USER_INPUT",
+			"GRAPHQL_VALIDATION_FAILED",
+			"UNAUTHENTICATED",
+			"FORBIDDEN",
+			"BAD_REQUEST"
+		];
+		apolloServer = new ApolloServer(defu({
+			schema,
+			introspection: securityConfig.introspection,
+			plugins,
+			formatError: securityConfig.maskErrors ? (formattedError, _error) => {
+				const code = formattedError?.extensions?.code;
+				if (code && userFacingCodes.includes(code)) return formattedError;
+				return {
+					message: "Internal server error",
+					extensions: { code: "INTERNAL_SERVER_ERROR" }
+				};
+			} : void 0
+		}, importedConfig));
+		if (!serverStarted) {
+			await apolloServer.start();
+			serverStarted = true;
+		}
+	}
+	return apolloServer;
+}
+let serverPromise = null;
+var apollo_server_default = defineEventHandler(async (event) => {
+	if (!serverPromise) serverPromise = createApolloServer();
+	return startServerAndCreateH3Handler(await serverPromise, {
+		context: async () => ({ event }),
+		serverAlreadyStarted: true
+	})(event);
+});
+
+//#endregion
+export { apollo_server_default as default };

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/nitro/routes/graphql-yoga.d.mts

@@ -0,0 +1,6 @@
+import * as nitro_deps_h33 from "nitro/deps/h3";
+
+//#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">
@@ -28,17 +28,28 @@ new window.EmbeddedSandbox({
 </html>`;
 let yoga;
 var graphql_yoga_default = defineEventHandler(async (event) => {
-	if (!yoga) yoga = createYoga(defu({
-		schema: await createMergedSchema({
+	if (!yoga) {
+		const schema = await createMergedSchema({
 			schemas,
 			resolvers,
 			directives,
 			moduleConfig
-		}),
-		graphqlEndpoint: "/api/graphql",
-		landingPage: false,
-		renderGraphiQL: () => apolloSandboxHtml
-	}, importedConfig));
+		});
+		const securityConfig = moduleConfig.security || {
+			introspection: true,
+			playground: true,
+			maskErrors: false,
+			disableSuggestions: false
+		};
+		yoga = createYoga(defu({
+			schema,
+			graphqlEndpoint: "/api/graphql",
+			landingPage: securityConfig.playground,
+			graphiql: securityConfig.playground ? { defaultQuery: "# Welcome to GraphQL\n#\n# Try running a query!\n" } : false,
+			renderGraphiQL: securityConfig.playground ? () => apolloSandboxHtml : void 0,
+			maskedErrors: securityConfig.maskErrors
+		}, importedConfig));
+	}
 	const response = await yoga.handleRequest(event.req, event);
 	if (event.res.status && event.res.status !== 200) return new Response(response.body, {
 		...response,

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

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

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/nitro/setup/logging.d.mts

@@ -0,0 +1,17 @@
+import { SecurityConfig } from "../types.mjs";
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/setup/logging.d.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
+ */
+declare function resolveSecurityConfig(config?: SecurityConfig): Required<SecurityConfig>;
+/**
+ * Log startup information
+ */
+declare function logStartupInfo(nitro: Nitro, serverEnabled: boolean): void;
+//#endregion
+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 };

package/dist/{setup → nitro/setup}/ts-config.mjs

@@ -1,8 +1,8 @@
-import { getDefaultPaths, getTypesConfig, resolveFilePath } from "../utils/path-resolver.mjs";
-import { relativeWithDot } from "../utils/imports.mjs";
+import { relativeWithDot } from "../../core/utils/imports.mjs";
+import { getDefaultPaths, getTypesConfig, resolveFilePath } from "../paths.mjs";
 import { dirname, join, resolve } from "pathe";
 
-//#region src/setup/ts-config.ts
+//#region src/nitro/setup/ts-config.ts
 /**
 * Setup TypeScript path aliases for GraphQL types
 * Called via nitro:config hook to extend tsconfig.json

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

@@ -1,6 +1,7 @@
+import { resolveSecurityConfig } from "./setup/logging.mjs";
 import { Nitro } from "nitro/types";
 
-//#region src/setup.d.ts
+//#region src/nitro/setup.d.ts
 
 /**
  * Main setup function for nitro-graphql
@@ -8,4 +9,4 @@ import { Nitro } from "nitro/types";
  */
 declare function setupNitroGraphQL(nitro: Nitro): Promise<void>;
 //#endregion
-export { setupNitroGraphQL };
+export { resolveSecurityConfig, setupNitroGraphQL };