Struct SchemaMerger 

pub struct SchemaMerger;

Schema merger combining language types and TOML config

Implementations

impl SchemaMerger

pub fn merge_files( types_path: &str, toml_path: &str, ) -> Result<IntermediateSchema>

Merge types.json file with TOML configuration

Arguments

• types_path - Path to types.json (from language implementation)
• toml_path - Path to fraiseql.toml (configuration)

Returns

Combined IntermediateSchema.

Errors

Returns an error if either file cannot be read or parsed, or if the merged result cannot be deserialized into an IntermediateSchema.

pub fn merge_toml_only(toml_path: &str) -> Result<IntermediateSchema>

Merge TOML-only (no types.json)

Arguments

• toml_path - Path to fraiseql.toml with inline type definitions

Returns

IntermediateSchema from TOML definitions.

Errors

Returns an error if the TOML file cannot be loaded, if validation fails, or if the merged result cannot be deserialized into an IntermediateSchema.

pub fn merge_from_directory( toml_path: &str, schema_dir: &str, ) -> Result<IntermediateSchema>

Merge from directory with auto-discovery

Arguments

• toml_path - Path to fraiseql.toml (configuration)
• schema_dir - Path to directory containing schema files

Returns

IntermediateSchema from loaded files + TOML definitions.

Errors

Returns an error if either file cannot be loaded or validated, if the directory cannot be read, or if the merged result cannot be deserialized.

pub fn merge_explicit_files( toml_path: &str, type_files: &[String], query_files: &[String], mutation_files: &[String], ) -> Result<IntermediateSchema>

Merge explicit file lists

Arguments

• toml_path - Path to fraiseql.toml (configuration)
• type_files - Vector of type file paths
• query_files - Vector of query file paths
• mutation_files - Vector of mutation file paths

Returns

IntermediateSchema from loaded files + TOML definitions

Errors

Returns an error if the TOML file cannot be loaded or validated, or if any of the type/query/mutation files fail to load or parse.

pub fn merge_from_domains(toml_path: &str) -> Result<IntermediateSchema>

Merge from domains (domain-based organization)

Arguments

• toml_path - Path to fraiseql.toml with domain_discovery enabled

Returns

IntermediateSchema from all domains (types.json, queries.json, mutations.json).

Errors

Returns an error if the TOML cannot be loaded or validated, if domain discovery fails, if any domain file cannot be parsed, or if the merged result cannot be deserialized.

pub fn merge_with_includes(toml_path: &str) -> Result<IntermediateSchema>

Merge with TOML includes (glob patterns for schema files)

Arguments

• toml_path - Path to fraiseql.toml with schema.includes section

Returns

IntermediateSchema from loaded files + TOML definitions.

Errors

Returns an error if the TOML cannot be loaded or validated, if any glob pattern is invalid, if a matched file cannot be parsed, or if the merged result cannot be deserialized.