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

package/dist/core/codegen/vue-subscription-builder.mjs

@@ -0,0 +1,351 @@
+import { extractSubscriptions } from "./subscription-extractor.mjs";
+//#region src/core/codegen/vue-subscription-builder.ts
+/**
+* Generate subscription builder code (Drizzle-style API) + Vue Composables
+* Returns empty string if subscriptions are not enabled or no subscription operations found
+*/
+function generateSubscriptionBuilder(docs, subscriptionsEnabled) {
+	if (!subscriptionsEnabled) return "";
+	const subscriptions = extractSubscriptions(docs);
+	if (subscriptions.length === 0) return "";
+	let output = `
+// === Subscription Imports ===
+import { ref, onUnmounted, computed } from 'vue'
+import type { Ref } from 'vue'
+import type {
+  ConnectionState,
+  SubscriptionHandle,
+  SubscriptionSession,
+  SubscriptionTransport,
+  TransportOptions,
+} from 'nitro-graphql/subscribe'
+import { subscriptionClient } from './subscribe'
+
+// === Subscription Types ===
+export type { ConnectionState, SubscriptionHandle, SubscriptionSession, SubscriptionTransport, TransportOptions }
+
+export interface UseSubscriptionOptions<T> {
+  /** Auto-start subscription on mount (default: false) */
+  immediate?: boolean
+  /** Callback when subscription starts */
+  onStart?: () => void
+  /** Callback when subscription stops */
+  onStop?: () => void
+  /** Callback when data is received */
+  onData?: (data: T) => void
+  /** Callback when error occurs */
+  onError?: (error: Error) => void
+  /** Callback when WebSocket connects */
+  onConnected?: () => void
+  /** Callback when WebSocket reconnects */
+  onReconnected?: () => void
+  /** Callback when WebSocket disconnects */
+  onDisconnected?: () => void
+  /** Callback when connection state changes */
+  onStateChange?: (state: ConnectionState) => void
+  /** Use existing session for multiplexing (pass result from useSubscriptionSession) */
+  session?: UseSubscriptionSessionReturn
+  /** Transport type: 'websocket' (default), 'sse', or 'auto' (WS first, SSE fallback) */
+  transport?: SubscriptionTransport
+}
+
+export interface UseSubscriptionReturn<T> {
+  /** Reactive subscription data */
+  data: Ref<T | null>
+  /** Reactive error state */
+  error: Ref<Error | null>
+  /** Is subscription active */
+  isActive: Ref<boolean>
+  /** Connection state */
+  state: Ref<ConnectionState>
+  /** Active transport type ('websocket' | 'sse') */
+  transport: Ref<'websocket' | 'sse'>
+  /** Start subscription */
+  start: () => void
+  /** Stop subscription */
+  stop: () => void
+  /** Restart subscription */
+  restart: () => void
+}
+
+// === Subscription Builder (Drizzle-style API) ===
+interface SubscriptionBuilder<TData> {
+  onData(fn: (data: TData) => void): SubscriptionBuilder<TData>
+  onError(fn: (error: Error) => void): SubscriptionBuilder<TData>
+  start(): SubscriptionHandle
+  subscribe(fn: (data: TData) => void): SubscriptionHandle
+}
+
+function createSubscriptionBuilder<TData>(query: string, variables: unknown): SubscriptionBuilder<TData> {
+  let onDataFn: ((data: TData) => void) | undefined
+  let onErrorFn: ((error: Error) => void) | undefined
+
+  const builder: SubscriptionBuilder<TData> = {
+    onData(fn: (data: TData) => void) {
+      onDataFn = fn
+      return builder
+    },
+    onError(fn: (error: Error) => void) {
+      onErrorFn = fn
+      return builder
+    },
+    start(): SubscriptionHandle {
+      return subscriptionClient.subscribe(query, variables, onDataFn, onErrorFn)
+    },
+    subscribe(fn: (data: TData) => void): SubscriptionHandle {
+      return subscriptionClient.subscribe(query, variables, fn, undefined)
+    },
+  }
+
+  return builder
+}
+
+export const subscription = {
+`;
+	for (const sub of subscriptions) if (sub.hasVariables) output += `  ${sub.typeName}(variables: Types.${sub.typeName}SubscriptionVariables): SubscriptionBuilder<Types.${sub.typeName}Subscription['${sub.fieldName}']> {
+    return createSubscriptionBuilder<Types.${sub.typeName}Subscription['${sub.fieldName}']>(${sub.typeName}Document, variables)
+  },
+`;
+	else output += `  ${sub.typeName}(): SubscriptionBuilder<Types.${sub.typeName}Subscription['${sub.fieldName}']> {
+    return createSubscriptionBuilder<Types.${sub.typeName}Subscription['${sub.fieldName}']>(${sub.typeName}Document, undefined)
+  },
+`;
+	output += `}
+
+// === Framework-Agnostic Session (for non-Vue usage) ===
+/**
+ * Create a multiplexed subscription session (framework-agnostic)
+ * All subscriptions share a single WebSocket connection.
+ *
+ * @example
+ * // Vanilla JS / Node.js / React / etc.
+ * const session = createSubscriptionSession()
+ * const sub1 = session.subscribe(query1, vars1, onData1)
+ * const sub2 = session.subscribe(query2, vars2, onData2)
+ * // Both use the same WebSocket connection
+ * sub1.unsubscribe()
+ * session.close() // Close all
+ *
+ * @returns SubscriptionSession - Framework-agnostic session object
+ */
+export function createSubscriptionSession(): SubscriptionSession {
+  return subscriptionClient.createSession()
+}
+
+// === Vue Composable: useSubscriptionSession (Multiplexing) ===
+export interface UseSubscriptionSessionReturn {
+  /** The underlying session object */
+  session: SubscriptionSession
+  /** Subscribe using the shared session */
+  subscribe: <TData = unknown>(
+    query: string,
+    variables: unknown,
+    onData?: (data: TData) => void,
+    onError?: (error: Error) => void,
+  ) => SubscriptionHandle
+  /** Close all subscriptions and the connection */
+  close: () => void
+  /** Is the session connected (reactive) */
+  isConnected: Ref<boolean>
+  /** Current connection state (reactive) */
+  state: Ref<ConnectionState>
+  /** Number of active subscriptions (reactive) */
+  subscriptionCount: Ref<number>
+}
+
+/**
+ * Vue composable for multiplexed subscription session
+ * Provides reactive state and automatic cleanup on unmount.
+ *
+ * @example
+ * // Vue 3 component
+ * const session = useSubscriptionSession()
+ * const { data } = useCountdown({ from: 10 }, { session })
+ * // Session auto-closes on component unmount
+ *
+ * @returns UseSubscriptionSessionReturn - Vue-reactive session wrapper
+ */
+export function useSubscriptionSession(): UseSubscriptionSessionReturn {
+  const session = subscriptionClient.createSession()
+
+  // Use refs for reactivity (session getters are not reactive)
+  const isConnected = ref(session.isConnected)
+  const state = ref<ConnectionState>(session.state)
+  const subscriptionCount = ref(session.subscriptionCount)
+
+  // Update refs when session state changes
+  function updateRefs() {
+    isConnected.value = session.isConnected
+    state.value = session.state
+    subscriptionCount.value = session.subscriptionCount
+  }
+
+  // Subscribe to session state changes for automatic reactivity
+  const unsubscribeStateChange = session.onStateChange(() => {
+    updateRefs()
+  })
+
+  function subscribe<TData = unknown>(
+    query: string,
+    variables: unknown,
+    onData?: (data: TData) => void,
+    onError?: (error: Error) => void,
+  ): SubscriptionHandle {
+    return session.subscribe(query, variables, onData as (data: unknown) => void, onError)
+  }
+
+  function close() {
+    session.close()
+  }
+
+  onUnmounted(() => {
+    unsubscribeStateChange()
+    close()
+  })
+
+  return {
+    session,
+    subscribe,
+    close,
+    isConnected,
+    state,
+    subscriptionCount,
+  }
+}
+
+// === Vue Composables ===
+function createUseSubscription<TData, TVariables = undefined>(
+  query: string,
+  getVariables: () => TVariables,
+): (options?: UseSubscriptionOptions<TData>) => UseSubscriptionReturn<TData> {
+  return (options: UseSubscriptionOptions<TData> = {}): UseSubscriptionReturn<TData> => {
+    const data = ref<TData | null>(null) as Ref<TData | null>
+    const error = ref<Error | null>(null)
+    const isActive = ref(false)
+    const state = ref<ConnectionState>('idle')
+    const transport = ref<'websocket' | 'sse'>('websocket')
+    let handle: SubscriptionHandle | null = null
+
+    // Resolve transport options
+    const transportOptions: TransportOptions = {
+      transport: options.transport,
+    }
+
+    function start() {
+      stop()
+      isActive.value = true
+      error.value = null
+      options.onStart?.()
+
+      const variables = getVariables()
+
+      if (options.session) {
+        // Use existing session for multiplexing (WebSocket only)
+        handle = options.session.subscribe<TData>(
+          query,
+          variables,
+          (d: TData) => {
+            data.value = d
+            options.onData?.(d)
+          },
+          (e: Error) => {
+            error.value = e
+            options.onError?.(e)
+          },
+        )
+        transport.value = 'websocket'
+      } else {
+        // Create dedicated connection with transport selection
+        handle = subscriptionClient.subscribe<TData>(
+          query,
+          variables,
+          (d: TData) => {
+            data.value = d
+            options.onData?.(d)
+          },
+          (e: Error) => {
+            error.value = e
+            options.onError?.(e)
+          },
+          transportOptions,
+        )
+        // Update transport ref from handle
+        transport.value = handle.transport
+      }
+    }
+
+    function stop() {
+      if (handle) {
+        handle.unsubscribe()
+        handle = null
+        isActive.value = false
+        options.onStop?.()
+      }
+    }
+
+    function restart() {
+      stop()
+      start()
+    }
+
+    if (options.immediate) {
+      start()
+    }
+
+    onUnmounted(stop)
+
+    return { data, error, isActive, state, transport, start, stop, restart }
+  }
+}
+
+// === Subscription Return Types ===
+`;
+	for (const sub of subscriptions) {
+		const typeName = `Types.${sub.typeName}Subscription['${sub.fieldName}']`;
+		output += `/** Return type for use${sub.typeName} composable */
+export type Use${sub.typeName}Return = UseSubscriptionReturn<${typeName}>
+`;
+	}
+	output += `
+// === Vue Composables ===
+`;
+	for (const sub of subscriptions) {
+		const typeName = `Types.${sub.typeName}Subscription['${sub.fieldName}']`;
+		const varsType = `Types.${sub.typeName}SubscriptionVariables`;
+		if (sub.hasVariables) output += `/**
+ * Vue composable for ${sub.typeName} subscription
+ * @param variables - Subscription variables
+ * @param options - Subscription options (immediate, onData, onError, session, etc.)
+ * @returns Reactive subscription state: { data, error, isActive, state, start, stop, restart }
+ */
+export function use${sub.typeName}(
+  variables: ${varsType},
+  options?: UseSubscriptionOptions<${typeName}>,
+): Use${sub.typeName}Return {
+  return createUseSubscription<${typeName}, ${varsType}>(
+    ${sub.typeName}Document,
+    () => variables,
+  )(options)
+}
+
+`;
+		else output += `/**
+ * Vue composable for ${sub.typeName} subscription
+ * @param options - Subscription options (immediate, onData, onError, session, etc.)
+ * @returns Reactive subscription state: { data, error, isActive, state, start, stop, restart }
+ */
+export function use${sub.typeName}(
+  options?: UseSubscriptionOptions<${typeName}>,
+): Use${sub.typeName}Return {
+  return createUseSubscription<${typeName}, undefined>(
+    ${sub.typeName}Document,
+    () => undefined,
+  )(options)
+}
+
+`;
+	}
+	return output;
+}
+//#endregion
+export { generateSubscriptionBuilder };

package/dist/core/constants.d.mts

@@ -20,6 +20,10 @@ declare const DEFAULT_GRAPHQL_SCALARS: {
     readonly output: "File";
   };
 };
+/**
+ * Default patterns to always ignore during scanning and file watching
+ */
+declare const DEFAULT_IGNORE_PATTERNS: readonly ["**/node_modules/**", "**/.git/**", "**/.output/**", "**/.nitro/**", "**/.nuxt/**", "**/.graphql/**", "**/dist/**"];
 /**
  * GraphQL schema file extensions
  */
@@ -53,31 +57,22 @@ declare const DIRECTIVE_GLOB_PATTERN: "**/*.directive.{ts,js}";
  */
 declare const FRAMEWORK_NUXT: "nuxt";
 declare const FRAMEWORK_NITRO: "nitro";
-declare const FRAMEWORK_STANDALONE: "standalone";
 /**
  * GraphQL server framework identifiers
  */
 declare const GRAPHQL_FRAMEWORK_YOGA: "graphql-yoga";
 declare const GRAPHQL_FRAMEWORK_APOLLO: "apollo-server";
-type Framework = typeof FRAMEWORK_NUXT | typeof FRAMEWORK_NITRO | typeof FRAMEWORK_STANDALONE;
 type GraphQLFramework = typeof GRAPHQL_FRAMEWORK_YOGA | typeof GRAPHQL_FRAMEWORK_APOLLO;
 /**
  * Default directory names for GraphQL files
  */
 declare const DIR_SERVER_GRAPHQL: "server/graphql";
-declare const DIR_ROUTES_GRAPHQL: "routes/graphql";
 declare const DIR_APP_GRAPHQL: "app/graphql";
 declare const DIR_CLIENT_GRAPHQL: "graphql";
-declare const DIR_EXTERNAL: "external";
 /**
  * Windows-compatible server GraphQL directory
  */
 declare const DIR_SERVER_GRAPHQL_WIN: "server\\graphql";
-/**
- * Build directory names
- */
-declare const DIR_BUILD_NITRO: ".nitro";
-declare const DIR_BUILD_NUXT: ".nuxt";
 /**
  * Default GraphQL endpoint paths
  */
@@ -88,11 +83,9 @@ declare const ENDPOINT_DEBUG: "/_nitro/graphql/debug";
  * Configuration and scaffold file names
  */
 declare const FILE_GRAPHQL_CONFIG: "graphql.config.ts";
-declare const FILE_SCHEMA_GRAPHQL: "schema.graphql";
 declare const FILE_SCHEMA_TS: "schema.ts";
 declare const FILE_CONFIG_TS: "config.ts";
 declare const FILE_CONTEXT_DTS: "context.d.ts";
-declare const FILE_CONTEXT_TS: "context.ts";
 declare const FILE_INDEX_TS: "index.ts";
 declare const FILE_OFETCH_TS: "ofetch.ts";
 declare const FILE_SDK_TS: "sdk.ts";
@@ -102,7 +95,6 @@ declare const FILE_DIRECTIVES_GRAPHQL: "_directives.graphql";
  */
 declare const FILE_SERVER_TYPES: "nitro-graphql-server.d.ts";
 declare const FILE_CLIENT_TYPES: "nitro-graphql-client.d.ts";
-declare const FILE_GRAPHQL_DTS: "graphql.d.ts";
 /**
  * Generated type file name patterns with placeholders
  */
@@ -127,21 +119,10 @@ declare const DEFINE_MUTATION: "defineMutation";
 declare const DEFINE_FIELD: "defineField";
 declare const DEFINE_SUBSCRIPTION: "defineSubscription";
 declare const DEFINE_DIRECTIVE: "defineDirective";
-declare const DEFINE_GRAPHQL_CONFIG: "defineGraphQLConfig";
-declare const DEFINE_SCHEMA: "defineSchema";
-type DefineFunction = typeof DEFINE_FUNCTIONS[number];
 /**
  * Built-in GraphQL scalar types (should not be flagged as duplicates)
  */
 declare const BUILTIN_SCALARS: readonly ["String", "Int", "Float", "Boolean", "ID", "DateTime", "JSON"];
-/**
- * Codegen parser dependencies (always external)
- */
-declare const CODEGEN_EXTERNALS: readonly ["oxc-parser", "@oxc-parser"];
-/**
- * Apollo Federation dependencies (external when federation disabled)
- */
-declare const FEDERATION_EXTERNALS: readonly ["@apollo/subgraph", "@apollo/federation-internals", "@apollo/cache-control-types"];
 /**
  * Supported HTTP methods for GraphQL endpoints
  */
@@ -151,38 +132,9 @@ declare const GRAPHQL_HTTP_METHODS: readonly ["GET", "POST", "OPTIONS"];
  */
 declare const DEFAULT_SERVER_TYPES_PATH: ".graphql/nitro-graphql-server.d.ts";
 declare const DEFAULT_CLIENT_TYPES_PATH: ".graphql/nitro-graphql-client.d.ts";
-/**
- * Valid resolver export types detected from AST parsing
- */
-declare const RESOLVER_TYPE_QUERY: "query";
-declare const RESOLVER_TYPE_MUTATION: "mutation";
-declare const RESOLVER_TYPE_RESOLVER: "resolver";
-declare const RESOLVER_TYPE_TYPE: "type";
-declare const RESOLVER_TYPE_SUBSCRIPTION: "subscription";
-declare const RESOLVER_TYPE_DIRECTIVE: "directive";
-type ResolverType = typeof RESOLVER_TYPE_QUERY | typeof RESOLVER_TYPE_MUTATION | typeof RESOLVER_TYPE_RESOLVER | typeof RESOLVER_TYPE_TYPE | typeof RESOLVER_TYPE_SUBSCRIPTION | typeof RESOLVER_TYPE_DIRECTIVE;
-/**
- * Placeholder strings used in path resolution
- */
-declare const PLACEHOLDER_SERVICE_NAME: "{serviceName}";
-declare const PLACEHOLDER_BUILD_DIR: "{buildDir}";
-declare const PLACEHOLDER_ROOT_DIR: "{rootDir}";
-declare const PLACEHOLDER_FRAMEWORK: "{framework}";
-declare const PLACEHOLDER_TYPES_DIR: "{typesDir}";
-declare const PLACEHOLDER_SERVER_DIR: "{serverDir}";
-declare const PLACEHOLDER_CLIENT_DIR: "{clientDir}";
 /**
  * Logger tag for nitro-graphql module
  */
 declare const LOG_TAG: "nitro-graphql";
-/**
- * HTTP status codes for error handling
- */
-declare const HTTP_STATUS_BAD_REQUEST: 400;
-declare const HTTP_STATUS_INTERNAL_ERROR: 500;
-/**
- * Default service directory name for main service
- */
-declare const SERVICE_DEFAULT: "default";
 //#endregion
-export { BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, CODEGEN_EXTERNALS, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_GRAPHQL_CONFIG, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SCHEMA, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_BUILD_NITRO, DIR_BUILD_NUXT, DIR_CLIENT_GRAPHQL, DIR_EXTERNAL, DIR_ROUTES_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, DefineFunction, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, FEDERATION_EXTERNALS, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_CONTEXT_TS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_GRAPHQL_DTS, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_GRAPHQL, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, FRAMEWORK_STANDALONE, Framework, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, GraphQLFramework, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_INTERNAL_ERROR, LOG_TAG, PATTERN_CLIENT_EXTERNAL_TYPES, PLACEHOLDER_BUILD_DIR, PLACEHOLDER_CLIENT_DIR, PLACEHOLDER_FRAMEWORK, PLACEHOLDER_ROOT_DIR, PLACEHOLDER_SERVER_DIR, PLACEHOLDER_SERVICE_NAME, PLACEHOLDER_TYPES_DIR, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN, RESOLVER_TYPE_DIRECTIVE, RESOLVER_TYPE_MUTATION, RESOLVER_TYPE_QUERY, RESOLVER_TYPE_RESOLVER, RESOLVER_TYPE_SUBSCRIPTION, RESOLVER_TYPE_TYPE, ResolverType, SERVICE_DEFAULT };
+export { BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_IGNORE_PATTERNS, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_CLIENT_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, GraphQLFramework, LOG_TAG, PATTERN_CLIENT_EXTERNAL_TYPES, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN };

package/dist/core/constants.mjs

@@ -22,6 +22,18 @@ const DEFAULT_GRAPHQL_SCALARS = {
 	}
 };
 /**
+* Default patterns to always ignore during scanning and file watching
+*/
+const DEFAULT_IGNORE_PATTERNS = [
+	"**/node_modules/**",
+	"**/.git/**",
+	"**/.output/**",
+	"**/.nitro/**",
+	"**/.nuxt/**",
+	"**/.graphql/**",
+	"**/dist/**"
+];
+/**
 * GraphQL schema file extensions
 */
 const GRAPHQL_EXTENSIONS = [".graphql", ".gql"];
@@ -54,7 +66,6 @@ const DIRECTIVE_GLOB_PATTERN = "**/*.directive.{ts,js}";
 */
 const FRAMEWORK_NUXT = "nuxt";
 const FRAMEWORK_NITRO = "nitro";
-const FRAMEWORK_STANDALONE = "standalone";
 /**
 * GraphQL server framework identifiers
 */
@@ -64,20 +75,13 @@ const GRAPHQL_FRAMEWORK_APOLLO = "apollo-server";
 * Default directory names for GraphQL files
 */
 const DIR_SERVER_GRAPHQL = "server/graphql";
-const DIR_ROUTES_GRAPHQL = "routes/graphql";
 const DIR_APP_GRAPHQL = "app/graphql";
 const DIR_CLIENT_GRAPHQL = "graphql";
-const DIR_EXTERNAL = "external";
 /**
 * Windows-compatible server GraphQL directory
 */
 const DIR_SERVER_GRAPHQL_WIN = "server\\graphql";
 /**
-* Build directory names
-*/
-const DIR_BUILD_NITRO = ".nitro";
-const DIR_BUILD_NUXT = ".nuxt";
-/**
 * Default GraphQL endpoint paths
 */
 const ENDPOINT_GRAPHQL = "/api/graphql";
@@ -87,11 +91,9 @@ const ENDPOINT_DEBUG = "/_nitro/graphql/debug";
 * Configuration and scaffold file names
 */
 const FILE_GRAPHQL_CONFIG = "graphql.config.ts";
-const FILE_SCHEMA_GRAPHQL = "schema.graphql";
 const FILE_SCHEMA_TS = "schema.ts";
 const FILE_CONFIG_TS = "config.ts";
 const FILE_CONTEXT_DTS = "context.d.ts";
-const FILE_CONTEXT_TS = "context.ts";
 const FILE_INDEX_TS = "index.ts";
 const FILE_OFETCH_TS = "ofetch.ts";
 const FILE_SDK_TS = "sdk.ts";
@@ -101,7 +103,6 @@ const FILE_DIRECTIVES_GRAPHQL = "_directives.graphql";
 */
 const FILE_SERVER_TYPES = "nitro-graphql-server.d.ts";
 const FILE_CLIENT_TYPES = "nitro-graphql-client.d.ts";
-const FILE_GRAPHQL_DTS = "graphql.d.ts";
 /**
 * Generated type file name patterns with placeholders
 */
@@ -133,8 +134,6 @@ const DEFINE_MUTATION = "defineMutation";
 const DEFINE_FIELD = "defineField";
 const DEFINE_SUBSCRIPTION = "defineSubscription";
 const DEFINE_DIRECTIVE = "defineDirective";
-const DEFINE_GRAPHQL_CONFIG = "defineGraphQLConfig";
-const DEFINE_SCHEMA = "defineSchema";
 /**
 * Built-in GraphQL scalar types (should not be flagged as duplicates)
 */
@@ -148,18 +147,6 @@ const BUILTIN_SCALARS = [
 	"JSON"
 ];
 /**
-* Codegen parser dependencies (always external)
-*/
-const CODEGEN_EXTERNALS = ["oxc-parser", "@oxc-parser"];
-/**
-* Apollo Federation dependencies (external when federation disabled)
-*/
-const FEDERATION_EXTERNALS = [
-	"@apollo/subgraph",
-	"@apollo/federation-internals",
-	"@apollo/cache-control-types"
-];
-/**
 * Supported HTTP methods for GraphQL endpoints
 */
 const GRAPHQL_HTTP_METHODS = [
@@ -173,36 +160,8 @@ const GRAPHQL_HTTP_METHODS = [
 const DEFAULT_SERVER_TYPES_PATH = ".graphql/nitro-graphql-server.d.ts";
 const DEFAULT_CLIENT_TYPES_PATH = ".graphql/nitro-graphql-client.d.ts";
 /**
-* Valid resolver export types detected from AST parsing
-*/
-const RESOLVER_TYPE_QUERY = "query";
-const RESOLVER_TYPE_MUTATION = "mutation";
-const RESOLVER_TYPE_RESOLVER = "resolver";
-const RESOLVER_TYPE_TYPE = "type";
-const RESOLVER_TYPE_SUBSCRIPTION = "subscription";
-const RESOLVER_TYPE_DIRECTIVE = "directive";
-/**
-* Placeholder strings used in path resolution
-*/
-const PLACEHOLDER_SERVICE_NAME = "{serviceName}";
-const PLACEHOLDER_BUILD_DIR = "{buildDir}";
-const PLACEHOLDER_ROOT_DIR = "{rootDir}";
-const PLACEHOLDER_FRAMEWORK = "{framework}";
-const PLACEHOLDER_TYPES_DIR = "{typesDir}";
-const PLACEHOLDER_SERVER_DIR = "{serverDir}";
-const PLACEHOLDER_CLIENT_DIR = "{clientDir}";
-/**
 * Logger tag for nitro-graphql module
 */
 const LOG_TAG = "nitro-graphql";
-/**
-* HTTP status codes for error handling
-*/
-const HTTP_STATUS_BAD_REQUEST = 400;
-const HTTP_STATUS_INTERNAL_ERROR = 500;
-/**
-* Default service directory name for main service
-*/
-const SERVICE_DEFAULT = "default";
 //#endregion
-export { BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, CODEGEN_EXTERNALS, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_GRAPHQL_CONFIG, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SCHEMA, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_BUILD_NITRO, DIR_BUILD_NUXT, DIR_CLIENT_GRAPHQL, DIR_EXTERNAL, DIR_ROUTES_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, FEDERATION_EXTERNALS, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_CONTEXT_TS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_GRAPHQL_DTS, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_GRAPHQL, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, FRAMEWORK_STANDALONE, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, HTTP_STATUS_BAD_REQUEST, HTTP_STATUS_INTERNAL_ERROR, LOG_TAG, PATTERN_CLIENT_EXTERNAL_TYPES, PLACEHOLDER_BUILD_DIR, PLACEHOLDER_CLIENT_DIR, PLACEHOLDER_FRAMEWORK, PLACEHOLDER_ROOT_DIR, PLACEHOLDER_SERVER_DIR, PLACEHOLDER_SERVICE_NAME, PLACEHOLDER_TYPES_DIR, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN, RESOLVER_TYPE_DIRECTIVE, RESOLVER_TYPE_MUTATION, RESOLVER_TYPE_QUERY, RESOLVER_TYPE_RESOLVER, RESOLVER_TYPE_SUBSCRIPTION, RESOLVER_TYPE_TYPE, SERVICE_DEFAULT };
+export { BUILTIN_SCALARS, CHUNK_NAME_RESOLVERS, CHUNK_NAME_SCHEMAS, CHUNK_PATH_GRAPHQL, CHUNK_PATH_UNKNOWN, DEFAULT_CLIENT_TYPES_PATH, DEFAULT_GRAPHQL_SCALARS, DEFAULT_IGNORE_PATTERNS, DEFAULT_SERVER_TYPES_PATH, DEFINE_DIRECTIVE, DEFINE_FIELD, DEFINE_FUNCTIONS, DEFINE_MUTATION, DEFINE_QUERY, DEFINE_RESOLVER, DEFINE_SUBSCRIPTION, DIRECTIVE_EXTENSIONS, DIRECTIVE_GLOB_PATTERN, DIR_APP_GRAPHQL, DIR_CLIENT_GRAPHQL, DIR_SERVER_GRAPHQL, DIR_SERVER_GRAPHQL_WIN, ENDPOINT_DEBUG, ENDPOINT_GRAPHQL, ENDPOINT_HEALTH, FILE_CLIENT_TYPES, FILE_CONFIG_TS, FILE_CONTEXT_DTS, FILE_DIRECTIVES_GRAPHQL, FILE_GRAPHQL_CONFIG, FILE_INDEX_TS, FILE_OFETCH_TS, FILE_SCHEMA_TS, FILE_SDK_TS, FILE_SERVER_TYPES, FRAMEWORK_NITRO, FRAMEWORK_NUXT, GLOB_SCAN_PATTERN, GRAPHQL_EXTENSIONS, GRAPHQL_FRAMEWORK_APOLLO, GRAPHQL_FRAMEWORK_YOGA, GRAPHQL_GLOB_PATTERN, GRAPHQL_HTTP_METHODS, LOG_TAG, PATTERN_CLIENT_EXTERNAL_TYPES, RESOLVER_EXTENSIONS, RESOLVER_GLOB_PATTERN };

package/dist/core/create-config.d.mts

@@ -0,0 +1,31 @@
+import { CoreConfig, CoreLogger } from "./types/config.mjs";
+import { ScanContext } from "./types/scanning.mjs";
+
+//#region src/core/create-config.d.ts
+/**
+ * Options for creating a CoreConfig
+ */
+interface CreateCoreConfigOptions {
+  rootDir: string;
+  buildDir?: string;
+  serverDir?: string;
+  clientDir?: string;
+  isNuxt?: boolean;
+  isDev?: boolean;
+  logger?: CoreLogger;
+  ignorePatterns?: string[];
+  security?: CoreConfig['security'];
+  federation?: CoreConfig['federation'];
+  codegen?: CoreConfig['codegen'];
+  externalServices?: CoreConfig['externalServices'];
+}
+/**
+ * Create a CoreConfig with sensible defaults
+ */
+declare function createCoreConfig(options: CreateCoreConfigOptions): CoreConfig;
+/**
+ * Create a ScanContext from CoreConfig
+ */
+declare function createScanContext(config: CoreConfig): ScanContext;
+//#endregion
+export { CreateCoreConfigOptions, createCoreConfig, createScanContext };

package/dist/core/create-config.mjs

@@ -0,0 +1,42 @@
+import { GRAPHQL_FRAMEWORK_YOGA } from "./constants.mjs";
+import { createLogger } from "./utils/logger.mjs";
+import { resolve } from "pathe";
+//#region src/core/create-config.ts
+/**
+* Create a CoreConfig with sensible defaults
+*/
+function createCoreConfig(options) {
+	const { rootDir, isNuxt = false, isDev = process.env.NODE_ENV !== "production", logger = createLogger(), ignorePatterns = [], security, federation, codegen, externalServices } = options;
+	const buildDir = options.buildDir || resolve(rootDir, isNuxt ? ".nuxt" : ".nitro");
+	return {
+		rootDir,
+		buildDir,
+		serverDir: options.serverDir || resolve(rootDir, "server/graphql"),
+		clientDir: options.clientDir || resolve(rootDir, isNuxt ? "app/graphql" : "graphql"),
+		typesDir: resolve(buildDir, "types"),
+		framework: GRAPHQL_FRAMEWORK_YOGA,
+		isNuxt,
+		isDev,
+		logger,
+		ignorePatterns,
+		security,
+		federation,
+		codegen,
+		externalServices
+	};
+}
+/**
+* Create a ScanContext from CoreConfig
+*/
+function createScanContext(config) {
+	return {
+		rootDir: config.rootDir,
+		serverDir: config.serverDir,
+		clientDir: config.clientDir,
+		ignorePatterns: config.ignorePatterns,
+		isDev: config.isDev,
+		logger: config.logger
+	};
+}
+//#endregion
+export { createCoreConfig, createScanContext };

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

@@ -1,2 +1,2 @@
-import { DebugInfo, escapeHtml, generateDebugHtml } from "./template.mjs";
-export { DebugInfo, escapeHtml, generateDebugHtml };
+import { DebugInfo, generateDebugHtml } from "./template.mjs";
+export { DebugInfo, generateDebugHtml };