aingle_cortex 0.6.3

Córtex API - REST/GraphQL/SPARQL interface for AIngle semantic graphs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

// Copyright 2019-2026 Apilium Technologies OÜ. All rights reserved.
// SPDX-License-Identifier: Apache-2.0 OR Commercial

//! GraphQL API for Córtex
//!
//! Provides a complete GraphQL schema with queries, mutations, and subscriptions
//! for interacting with the AIngle semantic graph.

mod resolvers;
mod schema;
mod subscriptions;

pub use resolvers::*;
pub use schema::*;
pub use subscriptions::*;

use async_graphql::Schema;
use async_graphql_axum::{GraphQLRequest, GraphQLResponse};
use axum::{
    extract::State,
    response::{Html, IntoResponse},
    Router,
};

use crate::state::AppState;

/// GraphQL schema type
pub type CortexSchema = Schema<QueryRoot, MutationRoot, SubscriptionRoot>;

/// Create GraphQL schema
pub fn create_schema(state: AppState) -> CortexSchema {
    Schema::build(QueryRoot, MutationRoot, SubscriptionRoot)
        .data(state)
        .finish()
}

/// Create GraphQL router
///
/// Note: Placeholder — GraphQL endpoints will be wired in a future release
pub fn router(_state: AppState, _playground: bool) -> Router {
    Router::new()
}

/// GraphQL handler
async fn graphql_handler(
    State(schema): State<CortexSchema>,
    req: GraphQLRequest,
) -> GraphQLResponse {
    schema.execute(req.into_inner()).await.into()
}

/// GraphiQL IDE
async fn graphql_playground() -> impl IntoResponse {
    Html(async_graphql::http::GraphiQLSource::build()
        .endpoint("/graphql")
        .subscription_endpoint("/graphql/ws")
        .finish())
}