//! Async-graphql integration with Tide //! //! # Examples //! *[Full Example]()* #![warn(missing_docs)] #![allow(clippy::type_complexity)] #![allow(clippy::needless_doctest_main)] #![forbid(unsafe_code)] use async_graphql::http::MultipartOptions; use async_graphql::{resolver_utils::ObjectType, Schema, SubscriptionType}; use async_trait::async_trait; use tide::{ http::{ headers::{self, HeaderValue}, Method, }, Body, Request, Response, StatusCode, }; /// Create a new GraphQL endpoint with the schema and default multipart options. pub fn endpoint( schema: Schema, ) -> Endpoint { endpoint_options(schema, MultipartOptions::default()) } /// Create a new GraphQL endpoint with the schema and custom multipart options. pub fn endpoint_options( schema: Schema, opts: MultipartOptions, ) -> Endpoint { Endpoint { schema, opts } } /// A GraphQL endpoint. pub struct Endpoint { /// The schema of the endpoint. pub schema: Schema, /// The multipart options of the endpoint. pub opts: MultipartOptions, } // Manual impl to remove bounds on generics impl Clone for Endpoint { fn clone(&self) -> Self { Self { schema: self.schema.clone(), opts: self.opts, } } } #[async_trait] impl tide::Endpoint for Endpoint where Query: ObjectType + Send + Sync + 'static, Mutation: ObjectType + Send + Sync + 'static, Subscription: SubscriptionType + Send + Sync + 'static, TideState: Clone + Send + Sync + 'static, { async fn call(&self, request: Request) -> tide::Result { respond( self.schema .execute(receive_request_opts(request, self.opts).await?) .await, ) } } /// Convert a Tide request to a GraphQL request. pub async fn receive_request( request: Request, ) -> tide::Result { receive_request_opts(request, Default::default()).await } /// Convert a Tide request to a GraphQL request with options on how to receive multipart. pub async fn receive_request_opts( mut request: Request, opts: MultipartOptions, ) -> tide::Result { if request.method() == Method::Get { request.query() } else { let body = request.take_body(); let content_type = request .header(headers::CONTENT_TYPE) .and_then(|values| values.get(0)) .map(HeaderValue::as_str); async_graphql::http::receive_body(content_type, body, opts) .await .map_err(|e| tide::Error::new(StatusCode::BadRequest, e)) } } /// Convert a GraphQL response to a Tide response. pub fn respond(gql: async_graphql::Response) -> tide::Result { let mut response = Response::new(StatusCode::Ok); if gql.is_ok() { if let Some(cache_control) = gql.cache_control.value() { response.insert_header(headers::CACHE_CONTROL, cache_control); } } response.set_body(Body::from_json(&gql)?); Ok(response) }