fraiseql-core 2.19.1

//! Compiled Schema Types
//!
//! This module defines the Rust-owned schema representation loaded from a compiled
//! schema at startup time.
//!
//! # Architecture
//!
//! ```text
//! Authoring language                   Rust
//! (Python, TS, Go, …)                 ────
//! @fraiseql.type    ─┐
//! @fraiseql.query    ├─→ schema.json ─→ fraiseql-cli compile ─→ CompiledSchema
//! @fraiseql.mutation─┘                                           (Rust-owned)
//!                                                                      │
//!                                                                      ▼
//!                                                            Axum serves requests
//!                                                    (authoring language not involved)
//! ```
//!
//! # Key Invariant
//!
//! After `CompiledSchema::from_json()`, all data is **Rust-owned**.
//! No authoring-language objects are referenced during request handling.
//!
//! # Usage
//!
//! ```no_run
//! // Requires: a compiled schema JSON file from `fraiseql-cli compile`.
//! use fraiseql_core::schema::CompiledSchema;
//! # fn example() -> Result<(), Box<dyn std::error::Error>> {
//! # let json_str = r#"{"types":[],"queries":[]}"#;
//! // From schema.compiled.json produced by `fraiseql-cli compile`
//! let schema = CompiledSchema::from_json(json_str, false)?;
//!
//! // From CLI config file
//! let schema = CompiledSchema::from_json(&std::fs::read_to_string("schema.json")?, false)?;
//!
//! // Access schema info
//! println!("Types: {}", schema.types.len());
//! println!("Queries: {}", schema.queries.len());
//! # Ok(())
//! # }
//! ```

mod changelog;
mod compiled;
pub(crate) use compiled::fact_field;
mod config_types;
mod dependency_graph;
pub mod derived_inputs;
pub mod domain_types;
pub mod fact_table_surface;
mod field_type;
mod graphql_type_defs;
pub mod graphql_value;
mod hierarchy;
mod introspection;
pub mod locale;
mod observer_types;
mod scalar_types;
pub mod security_config;
mod source_probe;
mod source_types;
mod subscribable_ddl;
mod subscription_policy;
mod subscription_types;

pub use changelog::inject_changelog;
pub use compiled::{
    AUTO_PARAM_NAMES, AppleSocialConfig, ArgumentDefinition, AuthClientConfig, AuthDatabaseConfig,
    AutoParams, CURRENT_FRAISEQL_VERSION, CascadeSource, CompiledSchema, CursorType, DerivedState,
    DirectiveDefinition, DirectiveLocationKind, DiscordSocialConfig, EmailKind, EmailTemplate,
    FacebookSocialConfig, FactInjectOrigin, FactInjectScope, FederationKeyProblem,
    GitHubSocialConfig, GoogleSocialConfig, InputStyle, LocalAuthConfig, LocalEmailConfig,
    LocalizedIndexAdvice, MutationDefinition, MutationOperation, NativeColumn, PaginationOrder,
    PkceClientConfig, ProducerVersion, QueryDefinition, SessionConfig, SessionTransport,
    SocialAuthConfig, SubscribableEntity, canonicalize_json, check_email_header, content_hash_of,
    is_fact_table_root, is_safe_sql_identifier, otp_allowed_statement, render_email_template,
    render_link_template,
};
pub use config_types::{
    AuthorizationPolicy, AuthorizationRule, Cardinality, ChangelogConfig, CircuitBreakerConfig,
    CrudNamingConfig, CrudNamingPreset, DEFAULT_MAX_QUERY_DEPTH, DebugConfig, DeleteResponse,
    EnterpriseSecurityConfig, EntityCircuitBreakerOverride, FederationConfig, FederationEntity,
    FieldAuthRule, GrpcConfig, McpConfig, McpTransport, NamingConvention, NativeJoin,
    ObserversBackend, ObserversConfig, Relationship, RestConfig, SessionVariableMapping,
    SessionVariableSource, SessionVariablesConfig, SubscriptionHooksConfig, SubscriptionsConfig,
    ValidationConfig,
};
pub use dependency_graph::{ChangeImpact, CyclePath, SchemaDependencyGraph};
pub use field_type::{
    BUILTIN_SCALARS, DeprecationInfo, DistanceMetric, FieldDefinition, FieldDenyPolicy,
    FieldEncryptionConfig, FieldType, VectorConfig, VectorIndexType,
};
pub use graphql_type_defs::{
    EnumDefinition, EnumValueDefinition, InputFieldDefinition, InputObjectDefinition,
    InterfaceDefinition, SqlProjectionHint, StoredEnumValue, TypeDefinition, UnionDefinition,
    gated_field, translations_base,
};
pub use graphql_value::GraphQLValue;
pub use hierarchy::{HierarchiesConfig, HierarchyDefinition};
pub(crate) use introspection::CallerIntrospection;
pub use introspection::{
    DirectiveLocation, IntrospectionBuilder, IntrospectionDirective, IntrospectionEnumValue,
    IntrospectionField, IntrospectionInputValue, IntrospectionResponses, IntrospectionSchema,
    IntrospectionType, IntrospectionTypeRef, IntrospectionValidationRule, TypeKind,
    published_scalar_names,
};
pub use locale::{
    LOCALE_SESSION_VAR, LOCALIZED_INPUT_TYPE, LOCALIZED_STRING_INPUT_TYPE, LOCALIZED_STRING_TYPE,
    LocaleConfig, LocaleInputs, LocaleSource, TRANSLATIONS_SUFFIX,
};
pub use observer_types::{ObserverDefinition, RetryConfig};
pub use scalar_types::{RICH_SCALARS, is_known_scalar};
pub use security_config::{
    ApiKeySecurityConfig, CodeChallengeMethod, CostBudgetConfig, DEFAULT_RATE_LIMIT_MAX_BUCKETS,
    EncryptionAlgorithm, ErrorSanitizationConfig, InjectedParamSource, KeySource,
    PkceSecurityConfig, RateLimitingSecurityConfig, RlsConfig, RoleDefinition, SecurityConfig,
    ServiceAccountConfig, StateEncryptionConfig, StaticApiKeyEntry, TenancyConfig, TenancyMode,
    TokenRevocationSecurityConfig, TrustedDocumentMode, TrustedDocumentsConfig,
};
pub(crate) use source_probe::regclass_literal;
pub use source_probe::{
    SourceKind, SourceProbe, refuse_standby_unreadable_sources, refuse_unproven_native_joins,
    sql_source_probes, standby_unreadable_sources,
};
pub use source_types::{RunAs, SourceDefinition};
pub use subscribable_ddl::generate_capture_trigger_ddl;
pub use subscription_policy::{OwnerCondition, SubscriptionPolicy};
pub use subscription_types::{
    FilterOperator, StaticFilterCondition, SubscriptionDefinition, SubscriptionFilter,
};

#[cfg(test)]
mod tests;