nitro-graphql 2.0.0-beta.72 → 2.0.0-beta.73

package/dist/nitro/types/augmentation.d.mts

@@ -0,0 +1,59 @@
+import { ScannedResolver } from "../../core/types/scanning.mjs";
+import { NitroGraphQLOptions } from "./config.mjs";
+
+//#region src/nitro/types/augmentation.d.ts
+/**
+ * Immutable scan state snapshot
+ * Built atomically from local scan + extend results.
+ * All consumers (virtual modules, codegen, logging) read from this single snapshot.
+ * Never mutate — replace the entire object for updates.
+ */
+interface GraphQLScanState {
+  readonly schemas: readonly string[];
+  readonly resolvers: readonly ScannedResolver[];
+  readonly directives: readonly ScannedResolver[];
+  readonly documents: readonly string[];
+  readonly directiveSchemas: string | null;
+  readonly extendConfigs: readonly string[];
+  readonly extendSchemas: readonly string[];
+}
+declare module 'nitro/types' {
+  interface Nitro {
+    /** @deprecated Use nitro.graphql.state.schemas — kept for backward compatibility */
+    scanSchemas: string[];
+    /** @deprecated Use nitro.graphql.state.documents */
+    scanDocuments: string[];
+    /** @deprecated Use nitro.graphql.state.resolvers */
+    scanResolvers: ScannedResolver[];
+    /** @deprecated Use nitro.graphql.state.directives */
+    scanDirectives: ScannedResolver[];
+    graphql: {
+      /** Immutable scan state — the single source of truth for all scanned files */state: GraphQLScanState; /** Absolute path to GraphQL build directory (e.g. /project/.graphql) */
+      buildDir: string; /** Directories watched for file changes in dev mode */
+      watchDirs: string[]; /** Absolute path to client GraphQL directory (e.g. /project/graphql) */
+      clientDir: string; /** Absolute path to server GraphQL directory (e.g. /project/server/graphql) */
+      serverDir: string; /** Relative paths (from rootDir) — used for display and config resolution */
+      dir: {
+        build: string;
+        client: string;
+        server: string;
+      }; /** @deprecated Use nitro.graphql.state.directiveSchemas */
+      directiveSchemas: string | null; /** @deprecated Use nitro.graphql.state.extendConfigs */
+      extendConfigs: string[]; /** @deprecated Use nitro.graphql.state.extendSchemas */
+      extendSchemas: string[];
+    };
+  }
+}
+declare module 'nitro/types' {
+  interface NitroOptions {
+    graphql?: NitroGraphQLOptions;
+  }
+  interface NitroRuntimeConfig {
+    graphql?: NitroGraphQLOptions;
+  }
+  interface NitroConfig {
+    graphql?: NitroGraphQLOptions;
+  }
+}
+//#endregion
+export { GraphQLScanState };

package/dist/nitro/types/augmentation.mjs

@@ -0,0 +1 @@
+export {};

package/dist/nitro/types/config.d.mts

@@ -0,0 +1,327 @@
+import { ClientCodegenConfig, ExternalServiceCodegenConfig, SdkCodegenConfig, ServerCodegenConfig } from "../../core/types/codegen.mjs";
+import { CoreFederationConfig, CoreSecurityConfig } from "../../core/types/config.mjs";
+import { LocalDirExtendSource as LocalDirExtendSource$1 } from "../../core/extend/loader.mjs";
+import { IResolvers } from "@graphql-tools/utils";
+
+//#region src/nitro/types/config.d.ts
+/**
+ * File generation control:
+ * - false: Do not generate this file
+ * - true: Generate at default location
+ * - string: Generate at custom path (supports placeholders: {serviceName}, {buildDir}, {rootDir}, {framework})
+ */
+type FileGenerationConfig = boolean | string;
+/**
+ * Service-specific path overrides for external GraphQL services
+ * These paths override global config for this specific service
+ */
+interface ExternalServicePaths {
+  /** SDK file path (overrides global sdk.external config) */
+  sdk?: FileGenerationConfig;
+  /** Type definitions file path (overrides global types.external config) */
+  types?: FileGenerationConfig;
+  /** Ofetch client file path (overrides global clientUtils.ofetch config) */
+  ofetch?: FileGenerationConfig;
+}
+/**
+ * External GraphQL service configuration
+ * Extends the core codegen type with Nitro-specific path overrides
+ */
+interface ExternalGraphQLService extends ExternalServiceCodegenConfig {
+  /**
+   * Optional: Service-specific path overrides
+   * These paths take precedence over global config (sdk, types, clientUtils)
+   * Supports placeholders: {serviceName}, {buildDir}, {rootDir}, {framework}, {typesDir}, {clientDir}
+   */
+  paths?: ExternalServicePaths;
+}
+/**
+ * Federation configuration
+ * Extends core federation with Nitro-specific fields
+ */
+interface FederationConfig extends CoreFederationConfig {
+  /** Enable Apollo Federation subgraph support */
+  enabled: boolean;
+  /** Service version for federation */
+  serviceVersion?: string;
+  /** Service URL for federation gateway */
+  serviceUrl?: string;
+}
+/**
+ * SDK files configuration
+ * Control auto-generation of GraphQL SDK files
+ */
+interface SdkConfig {
+  /** Enable/disable all SDK files */
+  enabled?: boolean;
+  /** app/graphql/default/sdk.ts - Main service SDK */
+  main?: FileGenerationConfig;
+  /** app/graphql/{serviceName}/sdk.ts - External service SDKs */
+  external?: FileGenerationConfig;
+}
+/**
+ * Type files configuration
+ * Control auto-generation of TypeScript type definition files
+ */
+interface TypesConfig {
+  /** Enable/disable all type files */
+  enabled?: boolean;
+  /** .nitro/types/nitro-graphql-server.d.ts - Server-side types */
+  server?: FileGenerationConfig;
+  /** .nitro/types/nitro-graphql-client.d.ts - Client-side types */
+  client?: FileGenerationConfig;
+  /** .nitro/types/nitro-graphql-client-{serviceName}.d.ts - External service types */
+  external?: FileGenerationConfig;
+}
+/**
+ * WebSocket transport configuration for subscriptions
+ */
+interface WebSocketTransportConfig {
+  /**
+   * Enable WebSocket transport
+   * @default true when subscriptions.enabled is true
+   */
+  enabled?: boolean;
+  /**
+   * WebSocket endpoint path
+   * @default Same as GraphQL HTTP endpoint
+   */
+  path?: string;
+  /**
+   * Connection initialization timeout in milliseconds
+   * @default 10000
+   */
+  connectionTimeout?: number;
+  /**
+   * Keep-alive ping interval in milliseconds
+   * @default 30000
+   */
+  pingInterval?: number;
+}
+/**
+ * SSE (Server-Sent Events) transport configuration for subscriptions
+ * Only available with GraphQL Yoga framework
+ */
+interface SSETransportConfig {
+  /**
+   * Enable SSE transport
+   * @default true for GraphQL Yoga
+   */
+  enabled?: boolean;
+}
+/**
+ * PubSub configuration for subscription event distribution
+ */
+interface PubSubConfig {
+  /**
+   * Use built-in in-memory PubSub
+   * Suitable for single-instance deployments
+   * @default true
+   */
+  useBuiltin?: boolean;
+  /**
+   * Path to custom PubSub module
+   * The module should export a PubSub-compatible instance
+   * When provided, built-in PubSub is disabled
+   */
+  customPath?: string;
+}
+/**
+ * GraphQL Subscriptions configuration
+ */
+interface SubscriptionsConfig {
+  /**
+   * Enable subscriptions support
+   * @default false
+   */
+  enabled?: boolean;
+  /**
+   * WebSocket transport configuration
+   */
+  websocket?: WebSocketTransportConfig;
+  /**
+   * SSE transport configuration (GraphQL Yoga only)
+   */
+  sse?: SSETransportConfig;
+  /**
+   * PubSub configuration for event distribution
+   */
+  pubsub?: PubSubConfig;
+}
+/**
+ * Client utilities configuration
+ * Controls auto-generation of client utility files
+ */
+interface ClientUtilsConfig {
+  /** Master switch for client utilities */
+  enabled?: boolean;
+  /** Index file output path */
+  index?: FileGenerationConfig;
+  /** Ofetch client output path */
+  ofetch?: FileGenerationConfig;
+}
+/**
+ * Path configuration with placeholders
+ * Supports: {buildDir}, {rootDir}, {typesDir}, {serverDir}, {clientDir}, {serviceName}
+ */
+interface PathsConfig {
+  /** Server GraphQL directory (default: 'server/graphql') */
+  serverDir?: string;
+  /** Client GraphQL directory (default: 'app/graphql' or 'graphql') */
+  clientDir?: string;
+  /** Types output directory (default: '{buildDir}/types') */
+  typesDir?: string;
+}
+/**
+ * Watch mode configuration
+ */
+interface WatchConfig {
+  /** Debounce time in ms for file change detection */
+  debounce?: number;
+}
+/**
+ * Runtime file generation configuration
+ * Generates resolvers.ts, schema.ts for standalone server usage
+ */
+interface RuntimeConfig {
+  /** Output directory for runtime files (defaults to '{buildDir}/runtime') */
+  outDir?: string;
+  /** What to include in generation */
+  include?: {
+    resolvers?: boolean;
+    schema?: boolean;
+    index?: boolean;
+  };
+}
+/**
+ * Explicit paths extend source (legacy)
+ */
+interface ExplicitPathsExtendSource {
+  /** Explicit manifest path */
+  manifest?: string;
+  /** Explicit resolver paths (legacy, prefer manifest) */
+  resolvers?: string | string[];
+  /** Explicit schema paths (legacy, prefer manifest) */
+  schemas?: string | string[];
+}
+/**
+ * Extend source - package path or detailed config
+ * - string: package name or local path, requires nitro-graphql.config.ts in package root
+ * - LocalDirExtendSource: local directories with serverDir/clientDir
+ * - ExplicitPathsExtendSource: explicit paths (legacy)
+ */
+type ExtendSource = string | LocalDirExtendSource | ExplicitPathsExtendSource;
+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;
+  };
+  playground?: boolean;
+  typedefs?: string[];
+  resolvers?: Array<IResolvers<any, any>>;
+  loader?: {
+    include?: RegExp;
+    exclude?: RegExp;
+    validate?: boolean;
+  };
+  codegen?: {
+    server?: ServerCodegenConfig;
+    client?: ClientCodegenConfig;
+    clientSDK?: SdkCodegenConfig;
+  };
+  /** External GraphQL services to generate types and SDKs for */
+  externalServices?: ExternalGraphQLService[];
+  /** Apollo Federation configuration */
+  federation?: FederationConfig;
+  /** Server GraphQL directory path (default: 'server/graphql') */
+  serverDir?: string;
+  /** Client GraphQL directory path (default: 'app/graphql' for Nuxt, 'graphql' for Nitro) */
+  clientDir?: string;
+  /** Types directory path (default: '{buildDir}/types') */
+  typesDir?: string;
+  /**
+   * SDK files configuration
+   * Set to false to disable all SDK generation
+   */
+  sdk?: false | SdkConfig;
+  /**
+   * Type files configuration
+   * Set to false to disable all type generation
+   */
+  types?: false | TypesConfig;
+  /**
+   * Security configuration for production environments
+   * Auto-detects NODE_ENV and applies secure defaults in production
+   */
+  security?: CoreSecurityConfig;
+  /**
+   * Extend GraphQL server with external packages
+   * Auto-appends /resolvers and /schema to each package path
+   * @example extend: ['@myorg/graphql', './generated']
+   */
+  extend?: ExtendSource[];
+  /**
+   * Skip local file scanning, use only extend sources
+   * When true, only files from `extend` are used (local server/graphql ignored)
+   * @default false
+   */
+  skipLocalScan?: boolean;
+  /**
+   * GraphQL Subscriptions configuration
+   * Enables real-time subscriptions via WebSocket and/or SSE transports
+   */
+  subscriptions?: SubscriptionsConfig;
+}
+/**
+ * Extended options for standalone CLI usage
+ * Adds fields that are implicit in Nitro module context (rootDir, buildDir, etc.)
+ */
+interface CLIGraphQLOptions extends NitroGraphQLOptions {
+  /** Root directory of the project (implicit in Nitro module context) */
+  rootDir: string;
+  /** Build output directory (implicit in Nitro module context) */
+  buildDir: string;
+  /** Server GraphQL directory (resolved) */
+  serverDir: string;
+  /** Client GraphQL directory (resolved) */
+  clientDir: string;
+  /** Types output directory */
+  typesDir: string;
+  /**
+   * Client utilities configuration
+   * Controls auto-generation of client utility files (index.ts, ofetch.ts)
+   * Set to false to disable all client utilities generation
+   */
+  clientUtils?: false | ClientUtilsConfig;
+  /**
+   * Path configuration with placeholders
+   * Allows overriding default paths for generated files
+   */
+  paths?: PathsConfig;
+  /**
+   * Patterns to ignore during file scanning
+   * Defaults to node_modules and dist directories
+   */
+  ignore: string[];
+  /**
+   * Watch mode configuration
+   * Enables automatic type regeneration on file changes
+   */
+  watch?: WatchConfig;
+  /**
+   * Runtime file generation configuration
+   * Generates resolvers.ts, schema.ts for standalone server usage
+   * Set to true for default behavior or provide config object
+   */
+  runtime?: boolean | RuntimeConfig;
+}
+//#endregion
+export { CLIGraphQLOptions, ClientUtilsConfig, ExplicitPathsExtendSource, ExtendSource, ExternalGraphQLService, ExternalServicePaths, FederationConfig, FileGenerationConfig, type LocalDirExtendSource$1 as LocalDirExtendSource, NitroGraphQLOptions, PathsConfig, PubSubConfig, RuntimeConfig, SSETransportConfig, SdkConfig, SubscriptionsConfig, TypesConfig, WatchConfig, WebSocketTransportConfig };

package/dist/nitro/types/config.mjs

@@ -0,0 +1 @@
+export {};

package/dist/nitro/types/define.d.mts

@@ -0,0 +1,13 @@
+import { ClientCodegenConfig, ExternalServiceCodegenConfig, SdkCodegenConfig, ServerCodegenConfig } from "../../core/types/codegen.mjs";
+import { CoreSecurityConfig } from "../../core/types/config.mjs";
+import { DefineDirectiveConfig, DirectiveArg, DirectiveArgument, DirectiveDefinition, DirectiveLocationName, Flatten, GraphQLArgumentType, GraphQLBaseType, GraphQLScalarType } from "../../core/types/define.mjs";
+import { StandardSchemaV1 } from "../../core/types/standard-schema.mjs";
+import { ApolloServerOptions } from "@apollo/server";
+import { YogaServerOptions } from "graphql-yoga";
+import { H3Event } from "nitro/h3";
+import { NPMConfig } from "#graphql/server";
+
+//#region src/nitro/types/define.d.ts
+type DefineServerConfig<T extends NPMConfig = NPMConfig> = T['framework'] extends 'graphql-yoga' ? Partial<YogaServerOptions<H3Event, Partial<H3Event>>> : T['framework'] extends 'apollo-server' ? Partial<ApolloServerOptions<H3Event>> : Partial<YogaServerOptions<H3Event, Partial<H3Event>>> | Partial<ApolloServerOptions<H3Event>>;
+//#endregion
+export { type ClientCodegenConfig, type ClientCodegenConfig as CodegenClientConfig, type ServerCodegenConfig as CodegenServerConfig, type DefineDirectiveConfig, DefineServerConfig, type DirectiveArg, type DirectiveArgument, type DirectiveDefinition, type DirectiveLocationName, type ExternalServiceCodegenConfig, type Flatten, type SdkCodegenConfig as GenericSdkConfig, type GraphQLArgumentType, type GraphQLBaseType, type GraphQLScalarType, type SdkCodegenConfig, type CoreSecurityConfig as SecurityConfig, type ServerCodegenConfig, type StandardSchemaV1 };

package/dist/nitro/types/define.mjs

@@ -0,0 +1 @@
+export {};

package/dist/nitro/types/index.d.mts

@@ -0,0 +1,10 @@
+import { ClientCodegenConfig, ExternalServiceCodegenConfig, SdkCodegenConfig, ServerCodegenConfig } from "../../core/types/codegen.mjs";
+import { CoreSecurityConfig } from "../../core/types/config.mjs";
+import { ResolverImport, ScannedResolver } from "../../core/types/scanning.mjs";
+import { DefineDirectiveConfig, DirectiveArg, DirectiveArgument, DirectiveDefinition, DirectiveLocationName, Flatten, GraphQLArgumentType, GraphQLBaseType, GraphQLScalarType } from "../../core/types/define.mjs";
+import { StandardSchemaV1 } from "../../core/types/standard-schema.mjs";
+import { DefineServerConfig } from "./define.mjs";
+import { LocalDirExtendSource } from "../../core/extend/loader.mjs";
+import { CLIGraphQLOptions, ClientUtilsConfig, ExplicitPathsExtendSource, ExtendSource, ExternalGraphQLService, ExternalServicePaths, FederationConfig, FileGenerationConfig, NitroGraphQLOptions, PathsConfig, PubSubConfig, RuntimeConfig, SSETransportConfig, SdkConfig, SubscriptionsConfig, TypesConfig, WatchConfig, WebSocketTransportConfig } from "./config.mjs";
+import { GraphQLScanState } from "./augmentation.mjs";
+export { type CLIGraphQLOptions, type ClientCodegenConfig, type ClientUtilsConfig, type ClientCodegenConfig as CodegenClientConfig, type ServerCodegenConfig as CodegenServerConfig, type DefineDirectiveConfig, type DefineServerConfig, type DirectiveArg, type DirectiveArgument, type DirectiveDefinition, type DirectiveLocationName, type ExplicitPathsExtendSource, type ExtendSource, type ExternalGraphQLService, type ExternalServiceCodegenConfig, type ExternalServicePaths, type FederationConfig, type FileGenerationConfig, type Flatten, type SdkCodegenConfig as GenericSdkConfig, type GraphQLArgumentType, type GraphQLBaseType, type GraphQLScalarType, type GraphQLScanState, type LocalDirExtendSource, type NitroGraphQLOptions, type PathsConfig, type PubSubConfig, type ResolverImport, type RuntimeConfig, type SSETransportConfig, type ScannedResolver, type SdkCodegenConfig, type SdkConfig, type CoreSecurityConfig as SecurityConfig, type ServerCodegenConfig, type StandardSchemaV1, type SubscriptionsConfig, type TypesConfig, type WatchConfig, type WebSocketTransportConfig };

package/dist/nitro/types/index.mjs

@@ -0,0 +1 @@
+export {};

package/dist/nitro/virtual/debug-info.d.mts

@@ -0,0 +1,9 @@
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/virtual/debug-info.d.ts
+declare const debugInfo: {
+  id: string;
+  getCode: (nitro: Nitro) => string;
+};
+//#endregion
+export { debugInfo };

package/dist/nitro/virtual/debug-info.mjs

@@ -0,0 +1,35 @@
+import { safeGenerateModuleCode } from "./utils.mjs";
+//#region src/nitro/virtual/debug-info.ts
+const debugInfo = {
+	id: "#nitro-graphql/debug-info",
+	getCode: (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"),
+			"pubsub": safeGenerateModuleCode(nitro, "#nitro-graphql/pubsub")
+		};
+		const info = {
+			isDev: nitro.options.dev,
+			framework: nitro.options.framework.name,
+			graphqlFramework: nitro.options.graphql?.framework,
+			federation: nitro.options.graphql?.federation,
+			scanned: {
+				schemas: nitro.graphql.state.schemas.length,
+				schemaFiles: [...nitro.graphql.state.schemas],
+				resolvers: nitro.graphql.state.resolvers.length,
+				resolverFiles: [...nitro.graphql.state.resolvers],
+				directives: nitro.graphql.state.directives.length,
+				directiveFiles: [...nitro.graphql.state.directives],
+				documents: nitro.graphql.state.documents.length,
+				documentFiles: [...nitro.graphql.state.documents]
+			},
+			virtualModules: virtualModuleCodes
+		};
+		return `export const debugInfo = ${JSON.stringify(info, null, 2)};`;
+	}
+};
+//#endregion
+export { debugInfo };

package/dist/nitro/virtual/graphql-config.d.mts

@@ -0,0 +1,9 @@
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/virtual/graphql-config.d.ts
+declare const graphqlConfig: {
+  id: string;
+  getCode: (nitro: Nitro) => string;
+};
+//#endregion
+export { graphqlConfig };

package/dist/nitro/virtual/graphql-config.mjs

@@ -0,0 +1,33 @@
+import { resolve } from "pathe";
+import { existsSync } from "node:fs";
+//#region src/nitro/virtual/graphql-config.ts
+const graphqlConfig = {
+	id: "#nitro-graphql/graphql-config",
+	getCode: (nitro) => {
+		const localConfigPath = resolve(nitro.graphql.serverDir, "config.ts");
+		const extendConfigs = [...nitro.graphql.state.extendConfigs];
+		const hasLocalConfig = existsSync(localConfigPath);
+		if (!hasLocalConfig && extendConfigs.length === 0) return `const importedConfig = {}
+export { importedConfig }
+`;
+		const imports = ["import { defu } from 'defu'"];
+		const configNames = [];
+		extendConfigs.forEach((configPath, index) => {
+			const configName = `extendConfig${index}`;
+			imports.push(`import ${configName} from '${configPath}'`);
+			configNames.push(configName);
+		});
+		if (hasLocalConfig) {
+			imports.push(`import localConfig from '${localConfigPath}'`);
+			configNames.push("localConfig");
+		}
+		const mergeArgs = configNames.reverse().join(", ");
+		return `${imports.join("\n")}
+
+const importedConfig = defu(${mergeArgs})
+export { importedConfig }
+`;
+	}
+};
+//#endregion
+export { graphqlConfig };

package/dist/nitro/virtual/index.d.mts

@@ -0,0 +1,25 @@
+import { debugInfo } from "./debug-info.mjs";
+import { graphqlConfig } from "./graphql-config.mjs";
+import { moduleConfig } from "./module-config.mjs";
+import { pubsub } from "./pubsub.mjs";
+import { serverDirectives } from "./server-directives.mjs";
+import { serverResolvers } from "./server-resolvers.mjs";
+import { serverSchemas } from "./server-schemas.mjs";
+import { validationSchemas } from "./validation-schemas.mjs";
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/virtual/index.d.ts
+/**
+ * Register all virtual modules with Nitro using eager snapshots.
+ * Code is generated immediately and captured as a string,
+ * so Rolldown always reads a consistent state.
+ */
+declare function registerAllVirtualModules(nitro: Nitro): void;
+/**
+ * Refresh virtual module snapshots after a rescan.
+ * Call this after nitro.scan* arrays have been fully updated
+ * (including extend results) to re-snapshot the virtual modules.
+ */
+declare function refreshVirtualModules(nitro: Nitro): void;
+//#endregion
+export { debugInfo, graphqlConfig, moduleConfig, pubsub, refreshVirtualModules, registerAllVirtualModules, serverDirectives, serverResolvers, serverSchemas, validationSchemas };

package/dist/nitro/virtual/index.mjs

@@ -0,0 +1,45 @@
+import { debugInfo } from "./debug-info.mjs";
+import { graphqlConfig } from "./graphql-config.mjs";
+import { moduleConfig } from "./module-config.mjs";
+import { pubsub } from "./pubsub.mjs";
+import { serverDirectives } from "./server-directives.mjs";
+import { serverResolvers } from "./server-resolvers.mjs";
+import { serverSchemas } from "./server-schemas.mjs";
+import { validationSchemas } from "./validation-schemas.mjs";
+//#region src/nitro/virtual/index.ts
+const allModules = [
+	serverSchemas,
+	serverResolvers,
+	serverDirectives,
+	graphqlConfig,
+	moduleConfig,
+	validationSchemas,
+	pubsub,
+	debugInfo
+];
+/**
+* Register all virtual modules with Nitro using eager snapshots.
+* Code is generated immediately and captured as a string,
+* so Rolldown always reads a consistent state.
+*/
+function registerAllVirtualModules(nitro) {
+	nitro.options.virtual ??= {};
+	for (const mod of allModules) {
+		const code = mod.getCode(nitro);
+		nitro.options.virtual[mod.id] = () => code;
+	}
+}
+/**
+* Refresh virtual module snapshots after a rescan.
+* Call this after nitro.scan* arrays have been fully updated
+* (including extend results) to re-snapshot the virtual modules.
+*/
+function refreshVirtualModules(nitro) {
+	if (!nitro.options.virtual) return;
+	for (const mod of allModules) {
+		const code = mod.getCode(nitro);
+		nitro.options.virtual[mod.id] = () => code;
+	}
+}
+//#endregion
+export { debugInfo, graphqlConfig, moduleConfig, pubsub, refreshVirtualModules, registerAllVirtualModules, serverDirectives, serverResolvers, serverSchemas, validationSchemas };

package/dist/nitro/virtual/module-config.d.mts

@@ -0,0 +1,9 @@
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/virtual/module-config.d.ts
+declare const moduleConfig: {
+  id: string;
+  getCode: (nitro: Nitro) => string;
+};
+//#endregion
+export { moduleConfig };

package/dist/nitro/virtual/module-config.mjs

@@ -0,0 +1,10 @@
+//#region src/nitro/virtual/module-config.ts
+const moduleConfig = {
+	id: "#nitro-graphql/module-config",
+	getCode: (nitro) => {
+		const config = nitro.options.graphql || {};
+		return `export const moduleConfig = ${JSON.stringify(config, null, 2)};`;
+	}
+};
+//#endregion
+export { moduleConfig };

package/dist/nitro/virtual/pubsub.d.mts

@@ -0,0 +1,9 @@
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/virtual/pubsub.d.ts
+declare const pubsub: {
+  id: string;
+  getCode: (nitro: Nitro) => string;
+};
+//#endregion
+export { pubsub };

package/dist/nitro/virtual/pubsub.mjs

@@ -0,0 +1,17 @@
+//#region src/nitro/virtual/pubsub.ts
+const pubsub = {
+	id: "#nitro-graphql/pubsub",
+	getCode: (nitro) => {
+		const subscriptions = nitro.options.graphql?.subscriptions;
+		const pubsubConfig = subscriptions?.pubsub;
+		if (!subscriptions?.enabled) return `export const pubsub = null`;
+		if (pubsubConfig?.customPath) return `import customPubSub from '${pubsubConfig.customPath}'
+export const pubsub = customPubSub
+`;
+		return `import { createPubSub } from 'nitro-graphql/pubsub'
+export const pubsub = createPubSub()
+`;
+	}
+};
+//#endregion
+export { pubsub };

package/dist/nitro/virtual/server-directives.d.mts

@@ -0,0 +1,9 @@
+import { Nitro } from "nitro/types";
+
+//#region src/nitro/virtual/server-directives.d.ts
+declare const serverDirectives: {
+  id: string;
+  getCode: (nitro: Nitro) => string;
+};
+//#endregion
+export { serverDirectives };

package/dist/nitro/virtual/server-directives.mjs

@@ -0,0 +1,12 @@
+import { generateImportModule } from "./utils.mjs";
+//#region src/nitro/virtual/server-directives.ts
+const serverDirectives = {
+	id: "#nitro-graphql/server-directives",
+	getCode: (nitro) => {
+		const imports = [...nitro.graphql.state.directives];
+		if (!imports.length) return "export const directives = []";
+		return generateImportModule(imports, "directives", "directive");
+	}
+};
+//#endregion
+export { serverDirectives };