Struct IntermediateSchema 

pub struct IntermediateSchema {

    pub version: String,
    pub types: Vec<IntermediateType>,
    pub enums: Vec<IntermediateEnum>,
    pub input_types: Vec<IntermediateInputObject>,
    pub interfaces: Vec<IntermediateInterface>,
    pub unions: Vec<IntermediateUnion>,
    pub queries: Vec<IntermediateQuery>,
    pub mutations: Vec<IntermediateMutation>,
    pub subscriptions: Vec<IntermediateSubscription>,
    pub fragments: Option<Vec<IntermediateFragment>>,
    pub directives: Option<Vec<IntermediateDirective>>,
    pub fact_tables: Option<Vec<IntermediateFactTable>>,
    pub aggregate_queries: Option<Vec<IntermediateAggregateQuery>>,
    pub observers: Option<Vec<IntermediateObserver>>,
    pub sources: Option<Vec<SourceDefinition>>,
    pub functions: Option<Vec<FunctionDefinition>>,
    pub functions_config: Option<IntermediateFunctionsConfig>,
    pub custom_scalars: Option<Vec<IntermediateScalar>>,
    pub security: Option<Value>,
    pub auth: Option<Value>,
    pub observers_config: Option<Value>,
    pub federation_config: Option<Value>,
    pub subscriptions_config: Option<SubscriptionsConfig>,
    pub validation_config: Option<ValidationConfig>,
    pub debug_config: Option<DebugConfig>,
    pub mcp_config: Option<McpConfig>,
    pub rest_config: Option<RestConfig>,
    pub grpc_config: Option<GrpcConfig>,
    pub query_defaults: Option<IntermediateQueryDefaults>,
    pub inject_defaults: Option<IntermediateInjectDefaults>,
    pub naming_convention: NamingConvention,
    pub session_variables: Option<SessionVariablesConfig>,
    pub locale: Option<LocaleConfig>,
    pub hierarchies_config: Option<HierarchiesConfig>,
    pub changelog_config: Option<ChangelogConfig>,
}

Intermediate schema - universal format from all language libraries

deny_unknown_fields is the load-bearing attribute on this struct

Every field below carries #[serde(default)], because an SDK legitimately omits most of them. Without deny_unknown_fields, that combination means any key the compiler does not read binds to an empty default and the compile reports success. That is not a hypothetical: it is the mechanism behind nine separate shipped defects.

• #847 — seven SDKs emitted inject_defaults; the compiler had never heard of the key. An operator configuring a project-wide tenant predicate got ✓ Schema compiled successfully and not one operation with a tenant filter.
• #848 — four SDKs emitted is_input; the type compiled as an output type and the served schema violated GraphQL §3.10.
• #756 — the merger wrote args/required, this struct read arguments/nullable. Every TOML-declared operation argument disappeared.
• #806/#807 — inject vs inject_params, and five spellings of requires_scope. Queries compiled with no tenant predicate; gated fields compiled as public.

In each case the author was explicit and the compiler was silent. Denying unknown fields converts every one of those into an error naming the offending key, and — the point of putting it here rather than patching each instance — it does the same for the tenth key, which has not been invented yet.

Consequence to accept deliberately: a key an SDK emits that this struct does not declare now fails the compile. That is the intended breaking change. A producer emitting a key no consumer reads was never doing anything; now it says so.

Fields

version: String

Schema format version

types: Vec<IntermediateType>

GraphQL object types

enums: Vec<IntermediateEnum>

GraphQL enum types

input_types: Vec<IntermediateInputObject>

GraphQL input object types

interfaces: Vec<IntermediateInterface>

GraphQL interface types (per GraphQL spec §3.7)

unions: Vec<IntermediateUnion>

GraphQL union types (per GraphQL spec §3.10)

queries: Vec<IntermediateQuery>

GraphQL queries

mutations: Vec<IntermediateMutation>

GraphQL mutations

subscriptions: Vec<IntermediateSubscription>

GraphQL subscriptions

fragments: Option<Vec<IntermediateFragment>>

GraphQL fragments (reusable field selections)

directives: Option<Vec<IntermediateDirective>>

GraphQL directive definitions (custom directives)

fact_tables: Option<Vec<IntermediateFactTable>>

Analytics fact tables (optional)

aggregate_queries: Option<Vec<IntermediateAggregateQuery>>

Analytics aggregate queries (optional)

observers: Option<Vec<IntermediateObserver>>

Observer definitions (database change event listeners)

sources: Option<Vec<SourceDefinition>>

Scheduled ingress source definitions (#573) — the dual of observers. Reuses the compiled SourceDefinition shape directly (it already carries serde defaults); the converter copies them into the compiled schema.

functions: Option<Vec<FunctionDefinition>>

Serverless function definitions (#1325) — the authoring dual of the compiled functions section.

Reuses the runtime shape (FunctionDefinition) directly, as sources does, so an authored declaration and the one the server dispatches are the same struct. The compiler pairs this list with the [functions] TOML group (module_dir, dlq_store) to emit the compiled section; the two halves have one owner each and neither may set the other’s keys.

Before #1325 nothing could write this section: IntermediateSchema had no field for it, so the only way to ship a function was to hand-edit schema.compiled.json — which the next fraiseql compile overwrote.

functions_config: Option<IntermediateFunctionsConfig>

Functions settings from the [functions] TOML table (#1325).

Injected by the merger, never present in schema.json — the same arrangement query_defaults has. The compiler pairs it with functions to emit the compiled section: the definitions are schema and these are deployment settings, one owner each (docs/architecture/config-vs-settings.md).

custom_scalars: Option<Vec<IntermediateScalar>>

Custom scalar type definitions

Defines custom GraphQL scalar types with validation rules. Custom scalars can be defined in Python, TypeScript, Java, Go, and Rust SDKs, and are compiled into the CompiledSchema’s CustomTypeRegistry.

security: Option<Value>

Security configuration (from fraiseql.toml) Compiled from the security section of fraiseql.toml at compile time. Optional - if not provided, defaults are used.

auth: Option<Value>

PKCE OAuth-client configuration (the [auth] PKCE group, #621).

The TOML merger emits the compiled auth object here (discovery_url, client_id, client_secret_env, server_redirect_uri); the converter carries it verbatim into CompiledSchema.auth. None when the group is absent.

observers_config: Option<Value>

Observers/event system configuration (from fraiseql.toml).

Contains backend connection settings (redis_url, nats_url, etc.) compiled from the [observers] TOML section. Embedded verbatim into the compiled schema.

federation_config: Option<Value>

Federation configuration.

Two authoring workflows feed this field:

• The TOML merger embeds the [federation] section under federation_config.
• Language SDKs (e.g. the Python SDK’s export_schema(federation=...)) emit the block under the top-level federation key in schema.json; the alias binds it here so the legacy JSON workflow does not silently drop it.

Carried verbatim by the converter into CompiledSchema.federation.

subscriptions_config: Option<SubscriptionsConfig>

WebSocket subscription configuration (hooks, limits).

Compiled from the [subscriptions] TOML section. Embedded verbatim into the compiled schema for server-side consumption.

validation_config: Option<ValidationConfig>

Query validation config (depth/complexity limits).

Compiled from [validation] in fraiseql.toml. Embedded into the compiled schema for server-side consumption.

debug_config: Option<DebugConfig>

Debug/development configuration.

Compiled from [debug] in fraiseql.toml. Embedded into the compiled schema for server-side consumption.

mcp_config: Option<McpConfig>

MCP (Model Context Protocol) server configuration.

Compiled from [mcp] in fraiseql.toml. Embedded into the compiled schema for server-side consumption.

rest_config: Option<RestConfig>

REST transport configuration.

Compiled from [rest] in fraiseql.toml. Embedded into the compiled schema for server-side consumption.

grpc_config: Option<GrpcConfig>

gRPC transport configuration.

Compiled from [grpc] in fraiseql.toml. Embedded verbatim into the compiled schema, whose grpc_config gates the transport (#780).

query_defaults: Option<IntermediateQueryDefaults>

Global auto-param defaults for list queries (injected from TOML by the merger).

Never present in schema.json — populated at compile time from [query_defaults] in fraiseql.toml. Used by the converter to resolve per-query auto_params.

inject_defaults: Option<IntermediateInjectDefaults>

Project-wide default injected parameters, from [inject_defaults].

Emitted as a top-level key by seven SDKs’ ConfigLoaders and consumed by the converter. See IntermediateInjectDefaults for the precedence rules and for why the merge happens after [fraiseql.tenancy] validation rather than before it (#847).

naming_convention: NamingConvention

Naming convention for GraphQL operation names.

Compiled from fraiseql.toml top-level naming_convention setting.

session_variables: Option<SessionVariablesConfig>

Session variable injection configuration.

When populated, the executor calls set_config() before each query and mutation to inject per-request values (JWT claims, HTTP headers, or literals) as PostgreSQL transaction-scoped settings.

Embedded verbatim from the session_variables key in schema.json.

locale: Option<LocaleConfig>

The request locale ([locale], #1512), carried from fraiseql.toml. Validated by the same LocaleConfig::validate the server runs at load.

hierarchies_config: Option<HierarchiesConfig>

Hierarchy definitions for ID-based ltree operators.

Compiled from the [hierarchies] TOML section. Maps hierarchy names to table/path_column pairs for subquery generation.

changelog_config: Option<ChangelogConfig>

Changelog GraphQL-exposure configuration.

Compiled from the [changelog] TOML section by the merger. Drives the converter’s injection of the EntityChangeLog / TransportCheckpoint types and their operations.

Trait Implementations

impl Clone for IntermediateSchema

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IntermediateSchema

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for IntermediateSchema

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for IntermediateSchema

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for IntermediateSchema

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for IntermediateSchema

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for IntermediateSchema