fraiseql-cli 2.16.0

CLI tools for FraiseQL v2 - Schema compilation and development utilities
Documentation
use indexmap::IndexMap;
use regex::Regex;

use super::{
    ExtractedSchema, Language, Result, SchemaExtractor, map_primitive_type, map_type,
    parse_annotation_params, to_snake_case,
};
use crate::schema::intermediate::{
    IntermediateArgument, IntermediateField, IntermediateQuery, IntermediateType,
};

pub(super) struct ScalaExtractor;

impl SchemaExtractor for ScalaExtractor {
    fn extract(&self, source: &str) -> Result<ExtractedSchema> {
        let mut types = Vec::new();
        let mut queries = Vec::new();

        // @Type(sqlSource = "v_author") case class Author(...)
        let type_re = Regex::new(r"@Type\(([^)]*)\)\s*case\s+class\s+(\w+)\s*\(([^)]*)\)")?;
        // @Query(...) def name(
        let query_re = Regex::new(r"@Query\(([^)]*)\)\s*def\s+(\w+)")?;

        for cap in type_re.captures_iter(source) {
            let params = parse_annotation_params(&cap[1]);
            let name = cap[2].to_string();
            let body = &cap[3];

            let fields = extract_scala_fields(body);
            let description = params.get("description").cloned();

            types.push(IntermediateType {
                sql_source: None,
                name,
                fields,
                description,
                implements: Vec::new(),
                requires_role: None,
                is_error: false,
                is_input: false,
                relay: false,
                embedded: false,
                subscribable_tables: None,
                subscribable_pre_image: false,
                // `extract` scrapes source text; no language has a relationship annotation for it
                // to find, and it already omits `inject_params` and `subscribable_tables` on the
                // same grounds. Authoring one goes through the SDK or `fraiseql.toml` (#1266).
                relationships: Vec::new(),
                inject_params: indexmap::IndexMap::new(),
            });
        }

        for cap in query_re.captures_iter(source) {
            let params = parse_annotation_params(&cap[1]);
            let name = cap[2].to_string();
            let return_type = params.get("returnType").cloned().unwrap_or_default();
            let returns_list = params.get("returnArray").is_some_and(|v| v == "true");
            let sql_source = params.get("sqlSource").cloned();

            let arguments = extract_scala_query_args(
                source,
                cap.get(0).expect("regex group 0 is always Some on a successful match").end(),
            );

            queries.push(IntermediateQuery {
                count: false,
                name,
                return_type,
                returns_list,
                nullable: false,
                arguments,
                description: None,
                sql_source,
                // `extract` scrapes source text and produces no `functions` section, so it
                // cannot produce the declaration a `function = "<name>"` binding must pair
                // with (#1329). Authoring a function-backed field goes through the SDK.
                function: None,
                auto_params: None,
                deprecated: None,
                jsonb_column: None,
                relay: false,
                inject: IndexMap::default(),
                exclude_inject_defaults: Vec::new(),
                read_routing: fraiseql_core::db::types::ReadRouting::default(),
                cache_ttl_seconds: None,
                additional_views: vec![],
                requires_role: None,
                requires_actor: Vec::new(),
                relay_cursor_type: None,
                // `extract` scans SDK source text; it does not parse REST annotations.
                rest: None,
                rest_stream: false,
                // `extract` scrapes source text; the pagination-order override (#1303) is an
                // authoring decision, made through the SDK or `fraiseql.toml`. Absent, the
                // compiler derives the entity identity, which is the right answer here.
                pagination_order: None,
            });
        }

        Ok(ExtractedSchema { types, queries })
    }
}

pub(super) fn extract_scala_fields(body: &str) -> Vec<IntermediateField> {
    let mut fields = Vec::new();
    // name: Type, or name: Option[Type]
    let field_re = Regex::new(r"(\w+)\s*:\s*(Option\[\w+\]|\w+)").expect("valid regex");

    for cap in field_re.captures_iter(body) {
        let raw_name = &cap[1];
        let type_str = &cap[2];
        let field_name = to_snake_case(raw_name);
        let (graphql_type, nullable) = map_type(Language::Scala, type_str);

        fields.push(IntermediateField {
            vector_config: None,
            vector_distance: None,
            name: field_name,
            field_type: graphql_type,
            nullable,
            description: None,
            directives: None,
            // #1329: refusal-only on a field; `extract` never authors one.
            function: None,
            deprecated: None,
            requires_scope: None,
            on_deny: None,
            authorize: None,
            hierarchy: None,
            unique: None,
        });
    }
    fields
}

pub(super) fn extract_scala_query_args(source: &str, fn_start: usize) -> Vec<IntermediateArgument> {
    let mut args = Vec::new();
    let rest = &source[fn_start..];
    let Some(open) = rest.find('(') else {
        return args;
    };
    let Some(close) = rest[open..].find(')') else {
        return args;
    };
    let sig = &rest[open + 1..open + close];

    let arg_re = Regex::new(r"(\w+)\s*:\s*(\w+)").expect("valid regex");
    for cap in arg_re.captures_iter(sig) {
        let name = cap[1].to_string();
        let type_str = &cap[2];
        let graphql_type = map_primitive_type(type_str);
        args.push(IntermediateArgument {
            name,
            arg_type: graphql_type,
            nullable: false,
            default: None,
            description: None,
            deprecated: None,
        });
    }
    args
}