nitro-graphql 2.0.0-beta.37 → 2.0.0-beta.39

package/dist/core/scanning/common.mjs

@@ -0,0 +1,60 @@
+import { GLOB_SCAN_PATTERN } from "../constants.mjs";
+import { join, relative } from "pathe";
+import { glob } from "tinyglobby";
+
+//#region src/core/scanning/common.ts
+/**
+* Scan a directory for files matching a glob pattern
+*/
+async function scanDirectory(ctx, baseDir, subDir, globPattern = GLOB_SCAN_PATTERN) {
+	return (await glob(join(subDir, globPattern), {
+		cwd: baseDir,
+		dot: true,
+		ignore: ctx.ignorePatterns,
+		absolute: true
+	}).catch((error) => {
+		if (error?.code === "ENOTDIR") {
+			ctx.logger.warn(`Ignoring \`${join(baseDir, subDir)}\`. It must be a directory.`);
+			return [];
+		}
+		throw error;
+	})).map((fullPath) => ({
+		fullPath,
+		path: relative(join(baseDir, subDir), fullPath)
+	})).sort((a, b) => a.path.localeCompare(b.path));
+}
+/**
+* Deduplicate files by fullPath
+*/
+function deduplicateFiles(files) {
+	const seenPaths = /* @__PURE__ */ new Set();
+	return files.filter((file) => {
+		if (seenPaths.has(file.fullPath)) return false;
+		seenPaths.add(file.fullPath);
+		return true;
+	});
+}
+/**
+* Filter files by extension
+*/
+function filterByExtension(files, extensions) {
+	return files.filter((file) => extensions.some((ext) => file.fullPath.endsWith(ext)));
+}
+/**
+* Extract file paths from scanned files
+*/
+function extractPaths(files) {
+	return files.map((f) => f.fullPath);
+}
+/**
+* Scan directory with layer support
+* Encapsulates the common pattern of scanning main directory + layer directories
+*/
+async function scanWithLayers(ctx, options) {
+	const mainFiles = await scanDirectory(ctx, options.mainDir, options.mainSubDir, options.pattern);
+	const layerFiles = await Promise.all((options.layerDirs || []).map((layerDir) => scanDirectory(ctx, layerDir, options.layerSubDir, options.pattern))).then((r) => r.flat());
+	return deduplicateFiles([...mainFiles, ...layerFiles]);
+}
+
+//#endregion
+export { deduplicateFiles, extractPaths, filterByExtension, scanDirectory, scanWithLayers };

package/dist/core/scanning/directives.d.mts

@@ -0,0 +1,10 @@
+import { ScanContext, ScanResult, ScannedResolver } from "../types/scanning.mjs";
+
+//#region src/core/scanning/directives.d.ts
+
+/**
+ * Scan for directive files (.directive.ts/.js)
+ */
+declare function scanDirectivesCore(ctx: ScanContext): Promise<ScanResult<ScannedResolver>>;
+//#endregion
+export { scanDirectivesCore };

package/dist/core/scanning/directives.mjs

@@ -0,0 +1,29 @@
+import { DIRECTIVE_GLOB_PATTERN } from "../constants.mjs";
+import { scanWithAST } from "./ast-scanner.mjs";
+import { hash } from "ohash";
+
+//#region src/core/scanning/directives.ts
+/**
+* Parse a defineDirective call and return the import info
+*/
+function parseDirectiveCall(calleeName, exportName, filePath) {
+	if (calleeName !== "defineDirective") return null;
+	return {
+		name: exportName,
+		type: "directive",
+		as: `_${hash(exportName + filePath).replace(/-/g, "").slice(0, 6)}`
+	};
+}
+/**
+* Scan for directive files (.directive.ts/.js)
+*/
+function scanDirectivesCore(ctx) {
+	return scanWithAST(ctx, {
+		pattern: DIRECTIVE_GLOB_PATTERN,
+		parseCall: parseDirectiveCall,
+		emitWarnings: false
+	});
+}
+
+//#endregion
+export { scanDirectivesCore };

package/dist/core/scanning/documents.d.mts

@@ -0,0 +1,21 @@
+import { CoreExternalService } from "../types/config.mjs";
+import { ScanContext, ScanResult } from "../types/scanning.mjs";
+
+//#region src/core/scanning/documents.d.ts
+
+/**
+ * Options for scanning documents
+ */
+interface ScanDocumentsOptions {
+  /** External services to exclude from main scan */
+  externalServices?: CoreExternalService[];
+  /** Client directory relative path */
+  clientDirRelative?: string;
+}
+/**
+ * Scan for GraphQL client documents (.graphql) in client directory
+ * Excludes files from external service directories
+ */
+declare function scanDocumentsCore(ctx: ScanContext, options?: ScanDocumentsOptions): Promise<ScanResult<string>>;
+//#endregion
+export { ScanDocumentsOptions, scanDocumentsCore };

package/dist/core/scanning/documents.mjs

@@ -0,0 +1,43 @@
+import { GRAPHQL_GLOB_PATTERN } from "../constants.mjs";
+import { scanWithLayers } from "./common.mjs";
+import { relative } from "pathe";
+
+//#region src/core/scanning/documents.ts
+/**
+* Scan for GraphQL client documents (.graphql) in client directory
+* Excludes files from external service directories
+*/
+async function scanDocumentsCore(ctx, options = {}) {
+	const warnings = [];
+	const errors = [];
+	try {
+		const clientDirRelative = options.clientDirRelative || relative(ctx.rootDir, ctx.clientDir);
+		const allFiles = await scanWithLayers(ctx, {
+			mainDir: ctx.rootDir,
+			mainSubDir: clientDirRelative,
+			layerDirs: ctx.layerAppDirs,
+			layerSubDir: "graphql",
+			pattern: GRAPHQL_GLOB_PATTERN
+		});
+		const externalPatterns = (options.externalServices || []).flatMap((service) => service.documents || []);
+		return {
+			items: allFiles.filter((f) => !f.path.startsWith("external/")).filter((f) => {
+				const relativePath = f.path;
+				for (const pattern of externalPatterns) if (pattern.replace(/* @__PURE__ */ new RegExp(`^${clientDirRelative.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}/`), "").split("/")[0] === relativePath.split("/")[0]) return false;
+				return true;
+			}).map((f) => f.fullPath),
+			warnings,
+			errors
+		};
+	} catch (error) {
+		errors.push(`Document scanning error: ${error}`);
+		return {
+			items: [],
+			warnings,
+			errors
+		};
+	}
+}
+
+//#endregion
+export { scanDocumentsCore };

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

@@ -0,0 +1,7 @@
+import { ASTScanConfig, scanWithAST } from "./ast-scanner.mjs";
+import { deduplicateFiles, extractPaths, filterByExtension, scanDirectory } from "./common.mjs";
+import { scanDirectivesCore } from "./directives.mjs";
+import { ScanDocumentsOptions, scanDocumentsCore } from "./documents.mjs";
+import { scanResolversCore } from "./resolvers.mjs";
+import { scanGraphqlCore, scanSchemasCore } from "./schemas.mjs";
+export { type ASTScanConfig, type ScanDocumentsOptions, deduplicateFiles, extractPaths, filterByExtension, scanDirectivesCore, scanDirectory, scanDocumentsCore, scanGraphqlCore, scanResolversCore, scanSchemasCore, scanWithAST };

package/dist/core/scanning/index.mjs

@@ -0,0 +1,8 @@
+import { deduplicateFiles, extractPaths, filterByExtension, scanDirectory } from "./common.mjs";
+import { scanWithAST } from "./ast-scanner.mjs";
+import { scanDirectivesCore } from "./directives.mjs";
+import { scanDocumentsCore } from "./documents.mjs";
+import { scanResolversCore } from "./resolvers.mjs";
+import { scanGraphqlCore, scanSchemasCore } from "./schemas.mjs";
+
+export { deduplicateFiles, extractPaths, filterByExtension, scanDirectivesCore, scanDirectory, scanDocumentsCore, scanGraphqlCore, scanResolversCore, scanSchemasCore, scanWithAST };

package/dist/core/scanning/resolvers.d.mts

@@ -0,0 +1,10 @@
+import { ScanContext, ScanResult, ScannedResolver } from "../types/scanning.mjs";
+
+//#region src/core/scanning/resolvers.d.ts
+
+/**
+ * Scan for resolver files and parse their exports
+ */
+declare function scanResolversCore(ctx: ScanContext): Promise<ScanResult<ScannedResolver>>;
+//#endregion
+export { scanResolversCore };

package/dist/core/scanning/resolvers.mjs

@@ -0,0 +1,58 @@
+import { DEFINE_FUNCTIONS, RESOLVER_GLOB_PATTERN } from "../constants.mjs";
+import { scanWithAST } from "./ast-scanner.mjs";
+import { hash } from "ohash";
+
+//#region src/core/scanning/resolvers.ts
+/**
+* Parse a define* function call and return the import info
+*/
+function parseResolverCall(calleeName, exportName, filePath) {
+	const aliasHash = `_${hash(exportName + filePath).replace(/-/g, "").slice(0, 6)}`;
+	switch (calleeName) {
+		case "defineResolver": return {
+			name: exportName,
+			type: "resolver",
+			as: aliasHash
+		};
+		case "defineQuery": return {
+			name: exportName,
+			type: "query",
+			as: aliasHash
+		};
+		case "defineMutation": return {
+			name: exportName,
+			type: "mutation",
+			as: aliasHash
+		};
+		case "defineField": return {
+			name: exportName,
+			type: "type",
+			as: aliasHash
+		};
+		case "defineSubscription": return {
+			name: exportName,
+			type: "subscription",
+			as: aliasHash
+		};
+		case "defineDirective": return {
+			name: exportName,
+			type: "directive",
+			as: aliasHash
+		};
+		default: return null;
+	}
+}
+/**
+* Scan for resolver files and parse their exports
+*/
+function scanResolversCore(ctx) {
+	return scanWithAST(ctx, {
+		pattern: RESOLVER_GLOB_PATTERN,
+		parseCall: parseResolverCall,
+		emitWarnings: true,
+		validFunctions: DEFINE_FUNCTIONS
+	});
+}
+
+//#endregion
+export { scanResolversCore };

package/dist/core/scanning/schemas.d.mts

@@ -0,0 +1,14 @@
+import { ScanContext, ScanResult } from "../types/scanning.mjs";
+
+//#region src/core/scanning/schemas.d.ts
+
+/**
+ * Scan for GraphQL schema files (.graphql) in server directory
+ */
+declare function scanSchemasCore(ctx: ScanContext): Promise<ScanResult<string>>;
+/**
+ * Scan for GraphQL files (.graphql, .gql) in server directory
+ */
+declare function scanGraphqlCore(ctx: ScanContext): Promise<ScanResult<string>>;
+//#endregion
+export { scanGraphqlCore, scanSchemasCore };

package/dist/core/scanning/schemas.mjs

@@ -0,0 +1,64 @@
+import { GRAPHQL_GLOB_PATTERN } from "../constants.mjs";
+import { extractPaths, scanWithLayers } from "./common.mjs";
+import { relative } from "pathe";
+
+//#region src/core/scanning/schemas.ts
+/**
+* Scan for GraphQL schema files (.graphql) in server directory
+*/
+async function scanSchemasCore(ctx) {
+	const warnings = [];
+	const errors = [];
+	try {
+		const serverDirRelative = relative(ctx.rootDir, ctx.serverDir);
+		return {
+			items: extractPaths(await scanWithLayers(ctx, {
+				mainDir: ctx.rootDir,
+				mainSubDir: serverDirRelative,
+				layerDirs: ctx.layerServerDirs,
+				layerSubDir: "graphql",
+				pattern: GRAPHQL_GLOB_PATTERN
+			})),
+			warnings,
+			errors
+		};
+	} catch (error) {
+		errors.push(`Schema scanning error: ${error}`);
+		return {
+			items: [],
+			warnings,
+			errors
+		};
+	}
+}
+/**
+* Scan for GraphQL files (.graphql, .gql) in server directory
+*/
+async function scanGraphqlCore(ctx) {
+	const warnings = [];
+	const errors = [];
+	try {
+		const serverDirRelative = relative(ctx.rootDir, ctx.serverDir);
+		return {
+			items: extractPaths(await scanWithLayers(ctx, {
+				mainDir: ctx.rootDir,
+				mainSubDir: serverDirRelative,
+				layerDirs: ctx.layerServerDirs,
+				layerSubDir: "graphql",
+				pattern: "**/*.{graphql,gql}"
+			})),
+			warnings,
+			errors
+		};
+	} catch (error) {
+		errors.push(`GraphQL scanning error: ${error}`);
+		return {
+			items: [],
+			warnings,
+			errors
+		};
+	}
+}
+
+//#endregion
+export { scanGraphqlCore, scanSchemasCore };

package/dist/{utils/schema-builder.d.mts → core/schema/builder.d.mts}

@@ -1,7 +1,7 @@
 import { DirectiveDefinition } from "../types/define.mjs";
 import { GraphQLSchema } from "graphql";
 
-//#region src/utils/schema-builder.d.ts
+//#region src/core/schema/builder.d.ts
 
 /**
  * Schema definition from virtual module
@@ -44,5 +44,10 @@ interface CreateMergedSchemaOptions {
  * Supports Apollo Federation when enabled
  */
 declare function createMergedSchema(options: CreateMergedSchemaOptions): Promise<GraphQLSchema>;
+/**
+ * Build a GraphQL schema from file paths (CLI usage)
+ * Reads schema files, merges them, and builds an executable schema
+ */
+declare function buildGraphQLSchema(schemaPaths: string[]): Promise<GraphQLSchema | null>;
 //#endregion
-export { CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, createMergedSchema };
+export { CreateMergedSchemaOptions, DirectiveWrapper, ModuleConfig, ResolverDefinition, SchemaDefinition, buildGraphQLSchema, createMergedSchema };

package/dist/{utils/schema-builder.mjs → core/schema/builder.mjs}

@@ -1,10 +1,11 @@
 import { loadFederationSupport, warnFederationUnavailable } from "./federation.mjs";
 import { consola as consola$1 } from "consola";
-import { parse } from "graphql";
+import { buildSchema, parse, print } from "graphql";
+import { readFileSync } from "node:fs";
 import { mergeResolvers, mergeTypeDefs } from "@graphql-tools/merge";
 import { makeExecutableSchema } from "@graphql-tools/schema";
 
-//#region src/utils/schema-builder.ts
+//#region src/core/schema/builder.ts
 /**
 * Create a merged GraphQL schema from schemas, resolvers, and directives
 * Supports Apollo Federation when enabled
@@ -46,6 +47,24 @@ async function createMergedSchema(options) {
 		throw error;
 	}
 }
+/**
+* Build a GraphQL schema from file paths (CLI usage)
+* Reads schema files, merges them, and builds an executable schema
+*/
+async function buildGraphQLSchema(schemaPaths) {
+	if (schemaPaths.length === 0) return null;
+	try {
+		const mergedTypeDefs = mergeTypeDefs(schemaPaths.map((path) => readFileSync(path, "utf-8")), {
+			throwOnConflict: true,
+			commentDescriptions: true,
+			sort: true
+		});
+		return buildSchema(typeof mergedTypeDefs === "string" ? mergedTypeDefs : print(mergedTypeDefs));
+	} catch (error) {
+		consola$1.error("Failed to build GraphQL schema:", error);
+		return null;
+	}
+}
 
 //#endregion
-export { createMergedSchema };
+export { buildGraphQLSchema, createMergedSchema };

package/dist/{utils → core/schema}/federation.d.mts

@@ -1,14 +1,19 @@
 import { DocumentNode, GraphQLSchema } from "graphql";
 
-//#region src/utils/federation.d.ts
+//#region src/core/schema/federation.d.ts
 
 /**
- * Type for buildSubgraphSchema function from @apollo/subgraph
+ * Module type for buildSubgraphSchema
  */
-type BuildSubgraphSchemaFn = (options: {
+interface SubgraphModule {
   typeDefs: DocumentNode;
-  resolvers: Record<string, unknown>;
-}) => GraphQLSchema;
+  resolvers?: Record<string, unknown>;
+}
+/**
+ * Type for buildSubgraphSchema function from @apollo/subgraph
+ * Accepts either an array of modules or a single options object
+ */
+type BuildSubgraphSchemaFn = (modulesOrOptions: SubgraphModule[] | SubgraphModule) => GraphQLSchema;
 /**
  * Dynamically load @apollo/subgraph for federation support.
  * Returns the buildSubgraphSchema function if available, or false if the package is not installed.

package/dist/{utils → core/schema}/federation.mjs

@@ -1,7 +1,7 @@
 import { LOG_TAG } from "../constants.mjs";
 import { consola as consola$1 } from "consola";
 
-//#region src/utils/federation.ts
+//#region src/core/schema/federation.ts
 const logger = consola$1.withTag(LOG_TAG);
 /**
 * Cached result: function if available, false if not available, null if not checked yet

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

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

package/dist/core/schema/index.mjs

@@ -0,0 +1,4 @@
+import { loadFederationSupport, resetFederationCache, warnFederationUnavailable } from "./federation.mjs";
+import { buildGraphQLSchema, createMergedSchema } from "./builder.mjs";
+
+export { buildGraphQLSchema, createMergedSchema, loadFederationSupport, resetFederationCache, warnFederationUnavailable };

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

@@ -0,0 +1,58 @@
+import { CoreConfig, CoreContext, CoreLogger } from "./config.mjs";
+import { ScanContext, ScanResult, ScannedResolver } from "./scanning.mjs";
+import "./index.mjs";
+
+//#region src/core/types/adapter.d.ts
+
+/**
+ * Framework adapter interface
+ * Adapters convert framework-specific types to core types
+ */
+interface FrameworkAdapter<TFramework = unknown> {
+  /** Adapter name for logging */
+  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 };

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

@@ -0,0 +1,133 @@
+import { Source } from "@graphql-tools/utils";
+import { GraphQLSchema } from "graphql";
+
+//#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
+ */
+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;
+}
+/**
+ * Client codegen configuration
+ */
+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>;
+  typedDocumentNode?: boolean;
+  [key: string]: unknown;
+}
+/**
+ * SDK codegen configuration
+ */
+interface SdkCodegenConfig extends ClientCodegenConfig {
+  [key: string]: unknown;
+}
+/**
+ * Input for server type generation
+ */
+interface ServerCodegenInput {
+  /** GraphQL framework name */
+  framework: string;
+  /** Parsed GraphQL schema */
+  schema: GraphQLSchema;
+  /** Server codegen configuration */
+  config?: ServerCodegenConfig;
+  /** Whether federation is enabled */
+  federationEnabled?: boolean;
+  /** Output filename (optional) */
+  outputPath?: string;
+}
+/**
+ * Result of server type generation
+ */
+interface ServerCodegenResult {
+  /** Generated TypeScript types content */
+  types: string;
+  /** Printed GraphQL schema */
+  schemaString: string;
+}
+/**
+ * Input for client type generation
+ */
+interface ClientCodegenInput {
+  /** Parsed GraphQL schema */
+  schema: GraphQLSchema;
+  /** Loaded GraphQL documents */
+  documents: Source[];
+  /** Client codegen configuration */
+  config?: ClientCodegenConfig;
+  /** SDK codegen configuration */
+  sdkConfig?: SdkCodegenConfig;
+  /** Output filename (optional) */
+  outputPath?: string;
+  /** Service name for external services */
+  serviceName?: string;
+  /** Virtual types import path */
+  virtualTypesPath?: string;
+  /** Generation options */
+  options?: {
+    silent?: boolean;
+    isInitial?: boolean;
+  };
+}
+/**
+ * Result of client type generation
+ */
+interface ClientCodegenResult {
+  /** Generated TypeScript types content */
+  types: string;
+  /** Generated SDK content */
+  sdk: string;
+}
+/**
+ * External service configuration for codegen
+ */
+interface ExternalServiceCodegenConfig {
+  name: string;
+  schema: string | string[];
+  endpoint: string;
+  headers?: Record<string, string> | (() => Record<string, string>);
+  documents?: string[];
+  downloadSchema?: boolean | 'once' | 'always' | 'manual';
+  downloadPath?: string;
+  codegen?: {
+    client?: ClientCodegenConfig;
+    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 };