tools/publish/src/rdf/ontology.rs

use crate::error;
use crate::rdf::vocab::gl;
use oxigraph::model::vocab::{rdf, rdfs, xsd};
use oxigraph::model::{Dataset, LiteralRef, NamedNode, NamedNodeRef, NamedOrBlankNode, NamedOrBlankNodeRef, Term, TermRef, Triple, TripleRef};
use oxigraph::sparql::{QueryResults, SparqlEvaluator};
use std::collections::{BTreeMap, BTreeSet, HashMap, HashSet};
use std::fmt::Display;
use std::path::{Path, PathBuf};
use std::sync::LazyLock;
use oxigraph::store::Store;
use tracing::{debug_span, info};
use crate::rdf::{conversion, materialize};
use crate::rdf::conversion::{quad_into_term, term_into_named_node, term_into_string, term_to_named_node};
use crate::rdf::language::LanguageCondition;

static PREFIXES: LazyLock<BTreeMap<String, String>> = LazyLock::new(|| {
    BTreeMap::from_iter([
        ("rdf", "http://www.w3.org/1999/02/22-rdf-syntax-ns#"),
        ("rdfs", "http://www.w3.org/2000/01/rdf-schema#"),
        ("owl", "http://www.w3.org/2002/07/owl#"),
        ("xsd", "http://www.w3.org/2001/XMLSchema#"),
        ("ldp", "http://www.w3.org/ns/ldp#"),
        ("dc", "http://purl.org/dc/elements/1.1/"),
        ("posix", "http://www.w3.org/ns/posix/stat#"),
        (
            "ebucore",
            "http://www.ebu.ch/metadata/ontologies/ebucore/ebucore#",
        ),
        ("premis", "http://www.loc.gov/premis/rdf/v1#"),
        ("premis3", "http://www.loc.gov/premis/rdf/v3/"),
        ("dcterms", "http://purl.org/dc/terms/"),
        ("fedora", "http://fedora.info/definitions/v4/repository#"),
        ("rdaa", "http://rdaregistry.info/Elements/a/"),
        ("rdac", "http://rdaregistry.info/Elements/c/"),
        ("rdae", "http://rdaregistry.info/Elements/e/"),
        ("rdai", "http://rdaregistry.info/Elements/i/"),
        ("rdam", "http://rdaregistry.info/Elements/m/"),
        ("rdan", "http://rdaregistry.info/Elements/n/"),
        ("rdap", "http://rdaregistry.info/Elements/p/"),
        ("rdaf", "http://rdaregistry.info/Elements/rof/"),
        ("rdat", "http://rdaregistry.info/Elements/t/"),
        ("rdau", "http://rdaregistry.info/Elements/u/"),
        ("rdaw", "http://rdaregistry.info/Elements/w/"),
        ("rdax", "http://rdaregistry.info/Elements/x/"),
        ("schema", "https://schema.org/"),
        ("quill", "http://fedora.quill.lan/rest/"),
        ("gl", "https://graphofliberty.org/2026/04/ont/"),
    ].map(|(k, v)| (k.to_string(), v.to_string())))
});

pub struct OntologyBuilder {
    path: Option<PathBuf>,
}

impl OntologyBuilder {
    pub fn with_path(mut self, path: impl AsRef<Path>) -> Self {
        let path = path.as_ref().to_owned();
        self.path = Some(path);
        self
    }

    pub fn build(self) -> error::Result<Ontology> {
        let mut store = if let Some(path) = self.path {
            Store::open_read_only(path)
        } else {
            Store::new()
        }?;

        let prefixes = PREFIXES
            .iter()
            .map(|(k, v)| (k.to_string(), v.to_string()))
            .collect::<HashMap<String, String>>();

        /*materialize::same_as(&mut store)?;
        materialize::super_properties(&mut store)?;
        materialize::super_classes(&mut store)?;
        debug_span!("Optimize Ontology").in_scope(|| store.optimize())?;*/

        let mut indexed_by = HashMap::new();
        for quad in store.quads_for_pattern(None, Some(gl::INDEXED_BY_FIELD), None, None)
            .filter_map(Result::ok) {
            if let NamedOrBlankNode::NamedNode(subject) = quad.subject
                && let Term::NamedNode(field) = quad.object {
                indexed_by.insert(subject, field);
            }
        }

        Ok(Ontology {
            store,
            prefixes,
        })
    }
}

pub struct IndexEntry {
    pub catalog_id: u64,
    pub fields: HashMap<String, String>,
}

#[derive(Clone, Debug)]
pub struct LabeledIri {
    pub iri: NamedNode,
    pub label: String,
}

impl PartialEq for LabeledIri {
    fn eq(&self, other: &Self) -> bool {
        self.iri == other.iri
    }
}

impl Display for LabeledIri {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        write!(f, "{}", self.label)
    }
}

#[derive(Clone, Debug)]
pub struct IndexField {
    pub name: String,
    pub label: String,
}

pub struct Ontology {
    store: Store,
    prefixes: HashMap<String, String>,
}

impl Ontology {
    pub fn builder() -> OntologyBuilder {
        OntologyBuilder {
            path: None,
        }
    }

    pub fn prefixes(&self) -> &BTreeMap<String, String> {
        &*PREFIXES
    }

    pub fn index(&self, language: &LanguageCondition) -> error::Result<HashMap<NamedNode, IndexEntry>> {
        let language_filter = language.to_filter_expression("fieldValue");
        let query = format!(r#"SELECT ?individual ?catalogId ?fieldName ?fieldValue
WHERE {{
    ?class a gl:SearchableClass ;
    gl:catalogId ?catalogId ;
    gl:associatedProperty ?property .

    ?property gl:indexedByField/gl:fieldName ?fieldName .

    ?individual a ?class ;
    ?property ?fieldValue .

    {language_filter}
}}"#);
        let mut sparql = SparqlEvaluator::new()
            .with_prefix("gl", "https://graphofliberty.org/2026/04/ont/")?
            .parse_query(&query)?;
        sparql.dataset_mut().set_default_graph_as_union();

        let mut results = HashMap::new();
        if let QueryResults::Solutions(solutions) = sparql.on_store(&self.store).execute()? {
            for solution in solutions.filter_map(Result::ok) {
                let individual = solution.get("individual").and_then(conversion::term_to_named_node);
                let catalog_id = solution.get("catalogId").and_then(conversion::term_to_u64);
                let field_name = solution.get("fieldName").and_then(conversion::term_as_str);
                let field_value = solution.get("fieldValue").and_then(conversion::term_as_str);
                if let (Some(individual), Some(catalog_id), Some(field_name), Some(field_value)) = (individual, catalog_id, field_name, field_value) {
                    results.entry(individual.to_owned())
                        .and_modify(|entry: &mut IndexEntry| {
                            entry.fields.insert(field_name.to_owned(), field_value.to_owned());
                        }).or_insert(IndexEntry {
                            catalog_id,
                            fields: HashMap::from_iter([(field_name.to_owned(), field_value.to_owned())]),
                        });
                }
            }
        }

        Ok(results)
    }

    pub fn catalog_id(&self, class: &NamedNode) -> Option<u64> {
        self.store.quads_for_pattern(Some(class.into()), Some(gl::CATALOG_ID), None, None)
            .filter_map(Result::ok)
            .map(conversion::quad_into_term)
            .filter_map(conversion::term_into_u64)
            .next()
    }

    pub fn fields_for_class(&self, class: &NamedNode, language: &LanguageCondition) -> error::Result<Vec<IndexField>> {
        let language_filter = language.to_filter_expression("label");
        let query = format!(r#"SELECT DISTINCT ?name ?label {{
    {class} gl:associatedProperty/gl:indexedByField ?field .

    ?field gl:fieldName ?name ;
    gl:fieldLabel ?label .

    {language_filter}
}}"#);
        let mut sparql = SparqlEvaluator::new()
            .with_prefix("rdfs", "http://www.w3.org/2000/01/rdf-schema#")?
            .with_prefix("gl", "https://graphofliberty.org/2026/04/ont/")?
            .parse_query(&query)?;
        sparql.dataset_mut().set_default_graph_as_union();

        let mut results = Vec::new();
        if let QueryResults::Solutions(solutions) = sparql.on_store(&self.store).execute()? {
            for solution in solutions.filter_map(Result::ok) {
                let name = solution.get("name").and_then(conversion::term_as_str);
                let label = solution.get("label").and_then(conversion::term_as_str);

                if let Some(name) = name && let Some(label) = label {
                    results.push(IndexField {
                        name: name.to_string(),
                        label: label.to_string(),
                    });
                }
            }
        }
        Ok(results)
    }

    pub fn abbreviate(&self, node: NamedNodeRef<'_>) -> String {
        for (prefix_name, prefix_iri) in &self.prefixes {
            if let Some(local_name) = node.as_str().strip_prefix(prefix_iri) {
                return if local_name.is_empty() {
                    format!("{prefix_name}:")
                } else {
                    format!("{prefix_name}:{local_name}")
                };
            }
        }
        node.as_str().to_string()
    }

    pub fn expand(&self, prefixed_iri: &str) -> Option<NamedNode> {
        let (prefix, name) = prefixed_iri.split_once(':')?;
        self.prefixes
            .get(prefix)
            .map(|base| NamedNode::new_unchecked(format!("{base}{name}")))
    }

    pub fn info(&self, iri: &NamedNode, language: &LanguageCondition) -> LabeledIri {
        let label = self.store.quads_for_pattern(Some(iri.as_ref().into()), Some(rdfs::LABEL), None, None)
            .filter_map(Result::ok)
            .map(quad_into_term)
            .filter(|term| language.primary_matches_term(term))
            .filter_map(term_into_string)
            .next()
            .unwrap_or_default();

        LabeledIri {
            iri: iri.clone(),
            label,
        }
    }

    pub fn searchable_classes(&self, language: &LanguageCondition) -> impl Iterator<Item = LabeledIri> {
        self.store.quads_for_pattern(None, Some(rdf::TYPE), Some(gl::SEARCHABLE.into()), None)
            .filter_map(Result::ok)
            .filter_map(|quad| {
                let label = self.store.quads_for_pattern(Some(quad.subject.as_ref().into()), Some(rdfs::LABEL), None, None)
                    .filter_map(Result::ok)
                    .map(quad_into_term)
                    .filter(|term| language.primary_matches_term(term))
                    .filter_map(term_into_string)
                    .next();
                if let Some(label) = label && let NamedOrBlankNode::NamedNode(subject) = quad.subject {
                    Some(LabeledIri {
                        iri: subject,
                        label,
                    })
                } else { None }
            })
    }

    pub fn subclasses_of(&self, class: &NamedNode) -> BTreeSet<NamedNode> {
        self.store.quads_for_pattern(None, Some(rdfs::SUB_CLASS_OF), Some(class.into()), None)
            .filter_map(Result::ok)
            .filter_map(|quad| if let NamedOrBlankNode::NamedNode(subject) = quad.subject {
                Some(subject)
            } else { None })
            .collect()
    }

    pub fn datatypes(&self) -> impl Iterator<Item = NamedNode> {
        self.store
            .quads_for_pattern(
                None,
                Some(rdf::TYPE),
                Some(TermRef::NamedNode(rdfs::DATATYPE)),
                None,
            )
            .filter_map(Result::ok)
            .filter_map(|quad| match quad.subject {
                NamedOrBlankNode::NamedNode(subject) => Some(subject),
                _ => None,
            })
    }

    pub fn is_read_only<'a>(&self, triple: impl Into<TripleRef<'a>>) -> bool {
        let triple = triple.into();
        let true_term = TermRef::Literal(LiteralRef::new_typed_literal("true", xsd::BOOLEAN));

        let subject = match (triple.predicate, triple.object) {
            (rdf::TYPE, TermRef::NamedNode(class)) => class,
            (predicate, _) => predicate,
        };

        self.store
            .quads_for_pattern(Some(NamedOrBlankNodeRef::NamedNode(subject)), Some(gl::READ_ONLY), Some(true_term), None)
            .filter_map(Result::ok)
            .count() >= 1
    }

    pub fn exclude_read_only(&self) -> impl Fn(TripleRef<'_>) -> bool + 'static {
        let true_term = TermRef::Literal(LiteralRef::new_typed_literal("true", xsd::BOOLEAN));
        let dataset = self.store
            .quads_for_pattern(None, Some(gl::READ_ONLY), Some(true_term), None)
            .filter_map(Result::ok)
            .collect::<Dataset>();
        move |triple| {
            dataset.quads_for_subject(triple.subject).count() == 0
        }
    }

    pub fn template_triples<'a>(
        &'a self,
        class: NamedNodeRef<'a>,
        subject: NamedNodeRef<'_>,
    ) -> Option<impl Iterator<Item = Triple>> {
        if let Some(quad) = self
            .store
            .quads_for_pattern(
                Some(NamedOrBlankNodeRef::NamedNode(class)),
                Some(gl::TEMPLATE),
                None,
                None,
            )
            .filter_map(Result::ok)
            .next()
        {
            if let Term::BlankNode(blank_node) = quad.object {
                let iter = self
                    .store
                    .quads_for_pattern(Some(NamedOrBlankNodeRef::BlankNode(blank_node.as_ref())), None, None, None)
                    .filter_map(Result::ok)
                    .map(Triple::from)
                    .map(move |mut triple| {
                        triple.subject = NamedOrBlankNode::NamedNode(subject.into_owned());
                        triple
                    });
                Some(iter)
            } else {
                None
            }
        } else {
            None
        }
    }
}