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

package/dist/core/schema/builder.d.mts

@@ -46,9 +46,11 @@ declare function createMergedSchema(options: CreateMergedSchemaOptions): Promise
 /**
  * Base schema with empty Query and Mutation types.
  * Required for 'extend type Query' syntax to work.
- * Shared between CLI and Nitro.
+ * Shared between CLI, Yoga, and Apollo routes.
  */
 declare const BASE_SCHEMA = "type Query { _empty: String }\ntype Mutation { _empty: String }";
+/** BASE_SCHEMA wrapped as a SchemaDefinition for virtual module usage */
+declare const BASE_SCHEMA_DEF: SchemaDefinition;
 /**
  * Build a GraphQL schema from file paths (CLI usage)
  * Reads schema files, merges them, and builds an executable schema
@@ -56,4 +58,4 @@ declare const BASE_SCHEMA = "type Query { _empty: String }\ntype Mutation { _emp
  */
 declare function buildGraphQLSchema(schemaPaths: string[]): Promise<GraphQLSchema | null>;
 //#endregion
-export { BASE_SCHEMA, CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, buildGraphQLSchema, createMergedSchema, parse, subscribe, validate };
+export { BASE_SCHEMA, BASE_SCHEMA_DEF, CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, buildGraphQLSchema, createMergedSchema, parse, subscribe, validate };

package/dist/core/schema/builder.mjs

@@ -4,7 +4,6 @@ import { buildSchema, parse, parse as parse$1, print, subscribe, validate } from
 import { readFileSync } from "node:fs";
 import { mergeResolvers, mergeTypeDefs } from "@graphql-tools/merge";
 import { makeExecutableSchema } from "@graphql-tools/schema";
-
 //#region src/core/schema/builder.ts
 /**
 * Create a merged GraphQL schema from schemas, resolvers, and directives
@@ -50,10 +49,12 @@ async function createMergedSchema(options) {
 /**
 * Base schema with empty Query and Mutation types.
 * Required for 'extend type Query' syntax to work.
-* Shared between CLI and Nitro.
+* Shared between CLI, Yoga, and Apollo routes.
 */
 const BASE_SCHEMA = `type Query { _empty: String }
 type Mutation { _empty: String }`;
+/** BASE_SCHEMA wrapped as a SchemaDefinition for virtual module usage */
+const BASE_SCHEMA_DEF = { def: BASE_SCHEMA };
 /**
 * Build a GraphQL schema from file paths (CLI usage)
 * Reads schema files, merges them, and builds an executable schema
@@ -73,6 +74,5 @@ async function buildGraphQLSchema(schemaPaths) {
 		return null;
 	}
 }
-
 //#endregion
-export { BASE_SCHEMA, buildGraphQLSchema, createMergedSchema, parse, subscribe, validate };
+export { BASE_SCHEMA, BASE_SCHEMA_DEF, buildGraphQLSchema, createMergedSchema, parse, subscribe, validate };

package/dist/core/schema/federation.mjs

@@ -1,6 +1,5 @@
 import { LOG_TAG } from "../constants.mjs";
 import { consola as consola$1 } from "consola";
-
 //#region src/core/schema/federation.ts
 const logger = consola$1.withTag(LOG_TAG);
 /**
@@ -35,6 +34,5 @@ function warnFederationUnavailable() {
 function resetFederationCache() {
 	buildSubgraphSchemaCache = null;
 }
-
 //#endregion
-export { loadFederationSupport, resetFederationCache, warnFederationUnavailable };
+export { loadFederationSupport, resetFederationCache, warnFederationUnavailable };

package/dist/core/schema/index.d.mts

@@ -1,3 +1,3 @@
-import { BASE_SCHEMA, CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, buildGraphQLSchema, createMergedSchema, parse, subscribe, validate } from "./builder.mjs";
+import { BASE_SCHEMA, BASE_SCHEMA_DEF, CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, buildGraphQLSchema, createMergedSchema, parse, subscribe, validate } from "./builder.mjs";
 import { loadFederationSupport, resetFederationCache, warnFederationUnavailable } from "./federation.mjs";
-export { BASE_SCHEMA, CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, buildGraphQLSchema, createMergedSchema, loadFederationSupport, parse, resetFederationCache, subscribe, validate, warnFederationUnavailable };
+export { BASE_SCHEMA, BASE_SCHEMA_DEF, CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, buildGraphQLSchema, createMergedSchema, loadFederationSupport, parse, resetFederationCache, subscribe, validate, warnFederationUnavailable };

package/dist/core/schema/index.mjs

@@ -1,4 +1,3 @@
 import { loadFederationSupport, resetFederationCache, warnFederationUnavailable } from "./federation.mjs";
-import { BASE_SCHEMA, buildGraphQLSchema, createMergedSchema, parse, subscribe, validate } from "./builder.mjs";
-
-export { BASE_SCHEMA, buildGraphQLSchema, createMergedSchema, loadFederationSupport, parse, resetFederationCache, subscribe, validate, warnFederationUnavailable };
+import { BASE_SCHEMA, BASE_SCHEMA_DEF, buildGraphQLSchema, createMergedSchema, parse, subscribe, validate } from "./builder.mjs";
+export { BASE_SCHEMA, BASE_SCHEMA_DEF, buildGraphQLSchema, createMergedSchema, loadFederationSupport, parse, resetFederationCache, subscribe, validate, warnFederationUnavailable };

package/dist/core/server/apollo.d.mts

@@ -0,0 +1,20 @@
+import { CoreServerOptions } from "./types.mjs";
+import { ApolloServer, BaseContext } from "@apollo/server";
+
+//#region src/core/server/apollo.d.ts
+/**
+ * Error codes that represent user-facing errors and should not be masked
+ * in production. All other error codes are treated as internal and masked.
+ */
+declare const APOLLO_USER_FACING_ERROR_CODES: readonly ["BAD_USER_INPUT", "GRAPHQL_VALIDATION_FAILED", "UNAUTHENTICATED", "FORBIDDEN", "BAD_REQUEST"];
+/**
+ * Create an Apollo Server instance
+ *
+ * Follows the same factory pattern as createYogaServer:
+ * - Takes CoreServerOptions
+ * - Applies security defaults
+ * - Merges user config via defu
+ */
+declare function createApolloServerInstance(options: CoreServerOptions): Promise<ApolloServer<BaseContext>>;
+//#endregion
+export { APOLLO_USER_FACING_ERROR_CODES, createApolloServerInstance };

package/dist/core/server/apollo.mjs

@@ -0,0 +1,54 @@
+import { createMergedSchema } from "../schema/builder.mjs";
+import { resolveSecurityDefaults } from "./types.mjs";
+import defu from "defu";
+import { ApolloServer } from "@apollo/server";
+import { ApolloServerPluginLandingPageDisabled } from "@apollo/server/plugin/disabled";
+import { ApolloServerPluginLandingPageLocalDefault } from "@apollo/server/plugin/landingPage/default";
+//#region src/core/server/apollo.ts
+/**
+* Error codes that represent user-facing errors and should not be masked
+* in production. All other error codes are treated as internal and masked.
+*/
+const APOLLO_USER_FACING_ERROR_CODES = [
+	"BAD_USER_INPUT",
+	"GRAPHQL_VALIDATION_FAILED",
+	"UNAUTHENTICATED",
+	"FORBIDDEN",
+	"BAD_REQUEST"
+];
+/**
+* Create an Apollo Server instance
+*
+* Follows the same factory pattern as createYogaServer:
+* - Takes CoreServerOptions
+* - Applies security defaults
+* - Merges user config via defu
+*/
+async function createApolloServerInstance(options) {
+	const { schemas, resolvers, directives, moduleConfig, security, importedConfig } = options;
+	const schema = await createMergedSchema({
+		schemas,
+		resolvers,
+		directives: directives || [],
+		moduleConfig
+	});
+	const securityConfig = resolveSecurityDefaults(security);
+	const plugins = securityConfig.playground ? [ApolloServerPluginLandingPageLocalDefault({ embed: true })] : [ApolloServerPluginLandingPageDisabled()];
+	const server = new ApolloServer(defu({
+		schema,
+		introspection: securityConfig.introspection,
+		plugins,
+		formatError: securityConfig.maskErrors ? (formattedError) => {
+			const code = formattedError?.extensions?.code;
+			if (code && APOLLO_USER_FACING_ERROR_CODES.includes(code)) return formattedError;
+			return {
+				message: "Internal server error",
+				extensions: { code: "INTERNAL_SERVER_ERROR" }
+			};
+		} : void 0
+	}, importedConfig));
+	await server.start();
+	return server;
+}
+//#endregion
+export { APOLLO_USER_FACING_ERROR_CODES, createApolloServerInstance };

package/dist/core/server/index.d.mts

@@ -1,4 +1,6 @@
+import { CoreSecurityConfig } from "../types/config.mjs";
 import { CoreServerInstance, CoreServerOptions, ServerFactory } from "./types.mjs";
+import { APOLLO_USER_FACING_ERROR_CODES, createApolloServerInstance } from "./apollo.mjs";
 import { APOLLO_SANDBOX_CDN, createSandboxResponse, fetchSandboxScript } from "./sandbox.mjs";
-import { BASE_SCHEMA, apolloSandboxHtml, createYogaServer } from "./yoga.mjs";
-export { APOLLO_SANDBOX_CDN, type CoreServerInstance, type CoreServerOptions, type ServerFactory, BASE_SCHEMA as YOGA_BASE_SCHEMA, apolloSandboxHtml, createSandboxResponse, createYogaServer, fetchSandboxScript };
+import { apolloSandboxHtml, createYogaServer } from "./yoga.mjs";
+export { APOLLO_SANDBOX_CDN, APOLLO_USER_FACING_ERROR_CODES, type CoreSecurityConfig, type CoreServerInstance, type CoreServerOptions, type ServerFactory, apolloSandboxHtml, createApolloServerInstance, createSandboxResponse, createYogaServer, fetchSandboxScript };

package/dist/core/server/index.mjs

@@ -1,4 +1,4 @@
+import { APOLLO_USER_FACING_ERROR_CODES, createApolloServerInstance } from "./apollo.mjs";
 import { APOLLO_SANDBOX_CDN, createSandboxResponse, fetchSandboxScript } from "./sandbox.mjs";
-import { BASE_SCHEMA, apolloSandboxHtml, createYogaServer } from "./yoga.mjs";
-
-export { APOLLO_SANDBOX_CDN, BASE_SCHEMA as YOGA_BASE_SCHEMA, apolloSandboxHtml, createSandboxResponse, createYogaServer, fetchSandboxScript };
+import { apolloSandboxHtml, createYogaServer } from "./yoga.mjs";
+export { APOLLO_SANDBOX_CDN, APOLLO_USER_FACING_ERROR_CODES, apolloSandboxHtml, createApolloServerInstance, createSandboxResponse, createYogaServer, fetchSandboxScript };

package/dist/core/server/sandbox.mjs

@@ -34,6 +34,5 @@ async function createSandboxResponse() {
 		});
 	}
 }
-
 //#endregion
-export { APOLLO_SANDBOX_CDN, createSandboxResponse, fetchSandboxScript };
+export { APOLLO_SANDBOX_CDN, createSandboxResponse, fetchSandboxScript };

package/dist/core/server/types.d.mts

@@ -1,20 +1,8 @@
+import { CoreSecurityConfig } from "../types/config.mjs";
 import { DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition } from "../schema/builder.mjs";
 import { GraphQLSchema } from "graphql";
 
 //#region src/core/server/types.d.ts
-/**
- * Security configuration for GraphQL server
- */
-interface CoreSecurityConfig {
-  /** Enable GraphQL introspection (default: true in dev, false in prod) */
-  introspection?: boolean;
-  /** Enable GraphQL playground/sandbox (default: true in dev, false in prod) */
-  playground?: boolean;
-  /** Mask error messages in responses (default: false in dev, true in prod) */
-  maskErrors?: boolean;
-  /** Disable field suggestions in error messages */
-  disableSuggestions?: boolean;
-}
 /**
  * Options for creating a GraphQL server instance
  */
@@ -50,5 +38,10 @@ interface CoreServerInstance {
  * Factory function type for creating GraphQL servers
  */
 type ServerFactory = (options: CoreServerOptions) => Promise<CoreServerInstance>;
+/**
+ * Resolve security config with safe defaults
+ * Used by both Yoga and Apollo server factories
+ */
+declare function resolveSecurityDefaults(security?: CoreSecurityConfig): Required<CoreSecurityConfig>;
 //#endregion
-export { CoreSecurityConfig, CoreServerInstance, CoreServerOptions, ServerFactory };
+export { CoreServerInstance, CoreServerOptions, ServerFactory, resolveSecurityDefaults };

package/dist/core/server/types.mjs

@@ -1 +1,15 @@
-export {  };
+//#region src/core/server/types.ts
+/**
+* Resolve security config with safe defaults
+* Used by both Yoga and Apollo server factories
+*/
+function resolveSecurityDefaults(security) {
+	return {
+		introspection: security?.introspection ?? true,
+		playground: security?.playground ?? true,
+		maskErrors: security?.maskErrors ?? false,
+		disableSuggestions: security?.disableSuggestions ?? false
+	};
+}
+//#endregion
+export { resolveSecurityDefaults };

package/dist/core/server/yoga.d.mts

@@ -1,12 +1,6 @@
-import { SchemaDefinition } from "../schema/builder.mjs";
 import { CoreServerInstance, CoreServerOptions } from "./types.mjs";
 
 //#region src/core/server/yoga.d.ts
-/**
- * Base schema definition for Yoga server
- * Uses shared BASE_SCHEMA string from builder
- */
-declare const BASE_SCHEMA: SchemaDefinition;
 /**
  * Apollo Sandbox HTML template
  * Shared between CLI and Nitro for consistent playground experience
@@ -39,4 +33,4 @@ declare const apolloSandboxHtml = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n
  */
 declare function createYogaServer(options: CoreServerOptions): Promise<CoreServerInstance>;
 //#endregion
-export { BASE_SCHEMA, apolloSandboxHtml, createYogaServer };
+export { apolloSandboxHtml, createYogaServer };

package/dist/core/server/yoga.mjs

@@ -1,14 +1,9 @@
-import { BASE_SCHEMA as BASE_SCHEMA$1, createMergedSchema } from "../schema/builder.mjs";
+import { createMergedSchema } from "../schema/builder.mjs";
+import { resolveSecurityDefaults } from "./types.mjs";
 import defu from "defu";
 import { createYoga } from "graphql-yoga";
-
 //#region src/core/server/yoga.ts
 /**
-* Base schema definition for Yoga server
-* Uses shared BASE_SCHEMA string from builder
-*/
-const BASE_SCHEMA = { def: BASE_SCHEMA$1 };
-/**
 * Apollo Sandbox HTML template
 * Shared between CLI and Nitro for consistent playground experience
 */
@@ -65,12 +60,7 @@ async function createYogaServer(options) {
 		directives: directives || [],
 		moduleConfig
 	});
-	const securityConfig = security || {
-		introspection: true,
-		playground: true,
-		maskErrors: false,
-		disableSuggestions: false
-	};
+	const securityConfig = resolveSecurityDefaults(security);
 	const yoga = createYoga(defu({
 		schema,
 		graphqlEndpoint: endpoint,
@@ -84,6 +74,5 @@ async function createYogaServer(options) {
 		schema
 	};
 }
-
 //#endregion
-export { BASE_SCHEMA, apolloSandboxHtml, createYogaServer };
+export { apolloSandboxHtml, createYogaServer };

package/dist/core/types/adapter.d.mts

@@ -1,6 +1,5 @@
-import { CoreConfig, CoreContext, CoreLogger } from "./config.mjs";
-import { ScanContext, ScanResult, ScannedResolver } from "./scanning.mjs";
-import "./index.mjs";
+import { CoreConfig, CoreLogger } from "./config.mjs";
+import { ScanContext } from "./scanning.mjs";
 
 //#region src/core/types/adapter.d.ts
 /**
@@ -12,46 +11,10 @@ interface FrameworkAdapter<TFramework = unknown> {
   readonly name: string;
   /** Create core config from framework instance */
   createCoreConfig: (framework: TFramework) => CoreConfig;
-  /** Create core context from framework instance */
-  createCoreContext: (framework: TFramework) => CoreContext;
   /** Create scan context from framework instance */
   createScanContext: (framework: TFramework) => ScanContext;
   /** Get framework logger adapted to CoreLogger interface */
   getLogger: (framework: TFramework) => CoreLogger;
 }
-/**
- * Scan adapter interface
- * Provides high-level scanning operations using the framework adapter
- */
-interface ScanAdapter<TFramework = unknown> {
-  /** Scan for GraphQL schema files */
-  scanSchemas: (framework: TFramework) => Promise<ScanResult<string>>;
-  /** Scan for GraphQL files (schemas + operations) */
-  scanGraphql: (framework: TFramework) => Promise<ScanResult<string>>;
-  /** Scan for resolver files */
-  scanResolvers: (framework: TFramework) => Promise<ScanResult<ScannedResolver>>;
-  /** Scan for directive files */
-  scanDirectives: (framework: TFramework) => Promise<ScanResult<ScannedResolver>>;
-  /** Scan for client documents */
-  scanDocuments: (framework: TFramework) => Promise<ScanResult<string>>;
-}
-/**
- * Codegen adapter interface
- * Provides high-level codegen operations using the framework adapter
- */
-interface CodegenAdapter<TFramework = unknown> {
-  /** Generate server types */
-  generateServerTypes: (framework: TFramework, options?: {
-    silent?: boolean;
-  }) => Promise<void>;
-  /** Generate client types */
-  generateClientTypes: (framework: TFramework, options?: {
-    silent?: boolean;
-  }) => Promise<void>;
-}
-/**
- * Combined full adapter interface
- */
-interface FullFrameworkAdapter<TFramework = unknown> extends FrameworkAdapter<TFramework>, ScanAdapter<TFramework>, CodegenAdapter<TFramework> {}
 //#endregion
-export { CodegenAdapter, FrameworkAdapter, FullFrameworkAdapter, ScanAdapter };
+export { FrameworkAdapter };

package/dist/core/types/adapter.mjs

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

package/dist/core/types/codegen.d.mts

@@ -1,53 +1,37 @@
+import { TypeScriptPluginConfig } from "@graphql-codegen/typescript";
+import { plugin as plugin$1 } from "@graphql-codegen/typescript-generic-sdk";
+import { TypeScriptDocumentsPluginConfig } from "@graphql-codegen/typescript-operations";
 import { Source } from "@graphql-tools/utils";
 import { GraphQLSchema } from "graphql";
+import { TypeScriptResolversPluginConfig } from "@graphql-codegen/typescript-resolvers";
 
 //#region src/core/types/codegen.d.ts
-/**
- * Scalar type mapping (can be string or input/output object)
- */
-type ScalarType = string | {
-  input: string;
-  output: string;
-};
 /**
  * Server codegen configuration
+ * Extends @graphql-codegen/typescript + @graphql-codegen/typescript-resolvers
  */
-interface ServerCodegenConfig {
-  scalars?: Record<string, ScalarType>;
-  defaultScalarType?: string;
-  defaultMapper?: string;
-  contextType?: string;
-  maybeValue?: string;
-  inputMaybeValue?: string;
-  declarationKind?: string;
-  enumsAsTypes?: boolean;
-  federation?: boolean;
-  [key: string]: unknown;
-}
+type ServerCodegenConfig = TypeScriptPluginConfig & TypeScriptResolversPluginConfig;
 /**
  * Client codegen configuration
+ * Extends @graphql-codegen/typescript + @graphql-codegen/typescript-operations
  */
-interface ClientCodegenConfig {
-  emitLegacyCommonJSImports?: boolean;
-  useTypeImports?: boolean;
-  enumsAsTypes?: boolean;
-  strictScalars?: boolean;
-  maybeValue?: string;
-  inputMaybeValue?: string;
-  documentMode?: string;
-  pureMagicComment?: boolean;
-  dedupeOperationSuffix?: boolean;
-  rawRequest?: boolean;
-  scalars?: Record<string, ScalarType>;
+type ClientCodegenConfig = TypeScriptPluginConfig & TypeScriptDocumentsPluginConfig & {
+  /**
+   * Generate TypedDocumentNode exports for urql/Apollo Client compatibility.
+   * @default false
+   */
   typedDocumentNode?: boolean;
-  [key: string]: unknown;
-}
+};
 /**
  * SDK codegen configuration
+ * Derives from the generic-sdk plugin's config parameter type with string documentMode
  */
-interface SdkCodegenConfig extends ClientCodegenConfig {
-  [key: string]: unknown;
-}
+type DocumentModeConfig = Pick<Parameters<typeof plugin$1>[2], 'documentMode'>;
+type DocumentModeEnum = NonNullable<DocumentModeConfig['documentMode']>;
+type DocumentModeType = `${DocumentModeEnum}`;
+type SdkCodegenConfig = Omit<Parameters<typeof plugin$1>[2], 'documentMode'> & {
+  documentMode?: DocumentModeType;
+};
 /**
  * Input for server type generation
  */
@@ -114,7 +98,7 @@ interface ClientCodegenResult {
  */
 interface ExternalServiceCodegenConfig {
   name: string;
-  schema: string | string[];
+  schema?: string | string[];
   endpoint: string;
   headers?: Record<string, string> | (() => Record<string, string>);
   documents?: string[];
@@ -125,12 +109,5 @@ interface ExternalServiceCodegenConfig {
     clientSDK?: SdkCodegenConfig;
   };
 }
-/**
- * Schema loading options
- */
-interface SchemaLoadOptions {
-  headers?: Record<string, string>;
-  loaders?: unknown[];
-}
 //#endregion
-export { ClientCodegenConfig, ClientCodegenInput, ClientCodegenResult, ExternalServiceCodegenConfig, ScalarType, SchemaLoadOptions, SdkCodegenConfig, ServerCodegenConfig, ServerCodegenInput, ServerCodegenResult };
+export { ClientCodegenConfig, ClientCodegenInput, ClientCodegenResult, ExternalServiceCodegenConfig, SdkCodegenConfig, ServerCodegenConfig, ServerCodegenInput, ServerCodegenResult };

package/dist/core/types/codegen.mjs

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

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

@@ -1,4 +1,5 @@
 import { GraphQLFramework } from "../constants.mjs";
+import { ClientCodegenConfig, ExternalServiceCodegenConfig, SdkCodegenConfig, ServerCodegenConfig } from "./codegen.mjs";
 
 //#region src/core/types/config.d.ts
 /**
@@ -12,19 +13,9 @@ interface CoreLogger {
   success: (message: string, ...args: unknown[]) => void;
   debug: (message: string, ...args: unknown[]) => void;
 }
-/**
- * GraphQL codegen configuration
- */
-interface CoreCodegenConfig {
-  /** Server-side codegen options */
-  server?: Record<string, unknown>;
-  /** Client-side codegen options */
-  client?: Record<string, unknown>;
-  /** Client SDK codegen options */
-  clientSDK?: Record<string, unknown>;
-}
 /**
  * Security configuration options
+ * Single source of truth — re-exported as `SecurityConfig` in Nitro types
  */
 interface CoreSecurityConfig {
   /** Enable/disable GraphQL introspection */
@@ -37,28 +28,8 @@ interface CoreSecurityConfig {
   disableSuggestions?: boolean;
 }
 /**
- * External GraphQL service configuration
- */
-interface CoreExternalService {
-  /** Unique service name */
-  name: string;
-  /** GraphQL schema URL or file path */
-  schema: string;
-  /** GraphQL endpoint URL */
-  endpoint: string;
-  /** Headers for schema introspection */
-  headers?: Record<string, string> | (() => Record<string, string>);
-  /** Document patterns for this service */
-  documents?: string[];
-  /** Service-specific path overrides */
-  paths?: {
-    sdk?: string;
-    types?: string;
-    ofetch?: string;
-  };
-}
-/**
- * Apollo Federation configuration
+ * Federation configuration
+ * Base type — Nitro's FederationConfig extends this
  */
 interface CoreFederationConfig {
   /** Enable federation support */
@@ -67,80 +38,33 @@ interface CoreFederationConfig {
   serviceName?: string;
 }
 /**
- * Path configuration with placeholders
+ * Codegen configuration
+ * Uses the authoritative types from codegen.ts
  */
-interface CorePathsConfig {
-  /** 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;
-}
-/**
- * Type generation configuration
- */
-interface CoreTypesConfig {
-  /** Master switch for type generation */
-  enabled?: boolean;
-  /** Server types output path */
-  server?: boolean | string;
-  /** Client types output path */
-  client?: boolean | string;
-  /** External service types output path */
-  external?: boolean | string;
-}
-/**
- * SDK generation configuration
- */
-interface CoreSdkConfig {
-  /** Master switch for SDK generation */
-  enabled?: boolean;
-  /** Main SDK output path */
-  main?: boolean | string;
-  /** External service SDK output path */
-  external?: boolean | string;
-}
-/**
- * Client utilities configuration
- */
-interface CoreClientUtilsConfig {
-  /** Master switch for client utilities */
-  enabled?: boolean;
-  /** Index file output path */
-  index?: boolean | string;
-  /** Ofetch client output path */
-  ofetch?: boolean | string;
+interface CoreCodegenConfig {
+  /** Server-side codegen options */
+  server?: ServerCodegenConfig;
+  /** Client-side codegen options */
+  client?: ClientCodegenConfig;
+  /** Client SDK codegen options */
+  clientSDK?: SdkCodegenConfig;
 }
 /**
- * Core GraphQL options
- * Framework-agnostic GraphQL configuration
+ * External service with path overrides
+ * Extends the codegen base type with UI-facing path config
  */
-interface CoreGraphQLOptions {
-  /** GraphQL framework to use */
-  framework?: GraphQLFramework;
-  /** GraphQL endpoint path */
-  endpoint?: string;
-  /** Codegen configuration */
-  codegen?: CoreCodegenConfig;
-  /** Security configuration */
-  security?: CoreSecurityConfig;
-  /** External GraphQL services */
-  externalServices?: CoreExternalService[];
-  /** Apollo Federation configuration */
-  federation?: CoreFederationConfig;
-  /** Path configuration */
-  paths?: CorePathsConfig;
-  /** Type generation configuration */
-  types?: false | CoreTypesConfig;
-  /** SDK generation configuration */
-  sdk?: false | CoreSdkConfig;
-  /** Client utilities configuration */
-  clientUtils?: false | CoreClientUtilsConfig;
+interface CoreExternalService extends ExternalServiceCodegenConfig {
+  /** Service-specific path overrides */
+  paths?: {
+    sdk?: string | boolean;
+    types?: string | boolean;
+    ofetch?: string | boolean;
+  };
 }
 /**
  * Core configuration
- * Main configuration interface that replaces Nitro-specific options
+ * The resolved, fully-populated config used by core functions.
+ * Created by adapters from framework-specific types.
  */
 interface CoreConfig {
   /** Root directory of the project */
@@ -159,30 +83,18 @@ interface CoreConfig {
   isNuxt: boolean;
   /** Whether running in development mode */
   isDev: boolean;
-  /** GraphQL options */
-  graphqlOptions: CoreGraphQLOptions;
   /** Logger instance */
   logger: CoreLogger;
   /** Patterns to ignore during scanning */
   ignorePatterns: string[];
-}
-/**
- * Core context for runtime operations
- * Holds resolved configuration and state
- */
-interface CoreContext {
-  /** Resolved configuration */
-  config: CoreConfig;
-  /** GraphQL build directory */
-  graphqlBuildDir: string;
-  /** Watch directories for file watching */
-  watchDirs: string[];
-  /** Relative directory paths */
-  dir: {
-    build: string;
-    client: string;
-    server: string;
-  };
+  /** Security configuration */
+  security?: CoreSecurityConfig;
+  /** Federation configuration */
+  federation?: CoreFederationConfig;
+  /** Codegen configuration */
+  codegen?: CoreCodegenConfig;
+  /** External services */
+  externalServices?: CoreExternalService[];
 }
 //#endregion
-export { CoreClientUtilsConfig, CoreCodegenConfig, CoreConfig, CoreContext, CoreExternalService, CoreFederationConfig, CoreGraphQLOptions, CoreLogger, CorePathsConfig, CoreSdkConfig, CoreSecurityConfig, CoreTypesConfig };
+export { CoreCodegenConfig, CoreConfig, CoreExternalService, CoreFederationConfig, CoreLogger, CoreSecurityConfig };

package/dist/core/types/config.mjs

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