graphql-to-openapi


Convert a graphql query + graphql schema into an openapi spec.

Demo

Not to be confused with the obviously more useful
openapi-to-graphql.

Usage via CLI

``
npx graphql-to-openapi --yaml --schema --query
`

Unknown Scalar Configuration via the CLI

Unknown scalars are scalar types in the graphql schema that do not obviously map to an openapi type.

The default behavior for unknown scalars is to treat them as string types in the output openapi schema.
If you desire to override that behavior, supply a scalar config file to the graphq-to-openapi tool:

`
Example CLI usage:

npx graphql-to-openapi --scalarConfigFile myScalarConfig.json --yaml --schema --query

---

myScalarConfig.json:
{
"DateTimeScalar": {
"type": "string",
"description": "YYYY-MM-DD date",
"example": "2017-01-01",
"format": "date",
"pattern": "YYYY-MM-DD",
"minLength": 0,
"maxLength": 10
}
}
`

Usage as a module

`typescript
import { graphqlToOpenApi } from 'graphql-to-openapi';

const { error, openApiSchema, queryErrors, schemaError } = graphqlToOpenApi({
schema,
query,
});

// error will contain any graphql-to-openapi errors if they exist.
// graphql-to-openapi only throws an error if you've failed to name
// the input query. The name of the input query is used to define the
// openapi route name.

// schemaError is an error in the parsing of the input schema.

// queryErrors are errors associated with parsing and validating the input query.
// This includes any validation issues when matching the query with the schema.

// openApiSchema will contain the deserialized openapi schema for the
// specified query.
`

For Developers contributing to this project

$3

1. Clone the github repo git clone git@github.com/schwer/graphql-to-openapi
1. npm install // install dependencies
1. npm run test:watch

$3

1. The docs subdirectory contains a vite static web app.
1. cd docs && npm run start`