Releases: IBM/openapi-to-graphql
Releases · IBM/openapi-to-graphql
Renaming OASGraph
We renamed OASGraph to OpenAPI-to-GraphQL. This path updates the README to reflect this change. OASGraph is deprecated, but development will continue on OpenAPI-to-GraphQL.
OpenAPI-to-GraphQL v0.15.0
OpenAPI-to-GraphQL v0.15.0
- Multi-OAS support
- Create GraphQL interfaces using multiple APIs
- Inter-OAS links
- Allows you to create nested objects the resolve on different APIs
- Custom resolvers
- Allows complete control over the generated resolvers. Opens many new doors such as creating resolvers that do not depend on a REST API backend or implementing caching.
- Added cookie authentication
- We now have full API key location support (i.e. "query", "header", and "cookie")!
- Exposed Request options, allowing fine control over generated resolvers
- Error extensions
- Errors during query execution are now clearly displayed
- Collapse links so that GraphQL object types can use links defined in different OAS operations objects
- Use Prettier for consistent formatting
- Simplified code base
Regarding CLI-specific improvements:
- CORS support
Special thanks to @thejibz, @JamesDuf, @jduffy3, @SrChip15 for contributing to this update!
Release notes
OASGraph v0.14.1
- Added Typescript declaration files
Special thanks to @treffynnon for contributing to this update!
Release notes
OASGraph v0.14.0
- Added the
operationIdFieldNames
option- Normally, query field names (as opposed to mutation field names) will be derived from the return type type name. This option will create query field names based off of the
operationId
, like how mutation field names are normally processed.
- Normally, query field names (as opposed to mutation field names) will be derived from the return type type name. This option will create query field names based off of the
Release notes
OASGraph v0.13.0
- Added method and path to link descriptions
- Now you can see which fields are created from links and what REST calls they correspond to
- Added support for constant and variable link parameters
- Previously, OASGraph could only support link parameters where the value is unmodified. However, link parameters can also be constants or concatenated with constants. Now we have support for all of these cases.
- Added full link support
- Draw from any runtime expression
- Added baseUrl option
- Allows you to manually input a base URL on which all paths will be built on
- Useful for testing and development, where the base URL may be changing and/or may not be finalized
- Capitalize (input) object types
- It is a common GraphQL convention that (input) object types should be capitalized. We now do so.
- Sort operations and fields by name
CLI v0.3.0
- Added YAML support
- Added CORS option
- Added baseUrl option
- See above
Special thanks to @Tonours and @thejibz for contributing to this update!
Added new tutorials and features
- Added new tutorials
- Added new features to the CLI tool (port selection, web-hosted OAS, and output schema)
- Updated test command,
npm test
, to start the example APIs used for testing - Added Travis CI
v0.9.0
- Added a very simple CLI tool that will read an OAS, create a GraphQL interface, and deploy a server.
- Added a quick start guide with a linked video that describes how the CLI tool is used.
- Added support for header and cookie parameters. Now fully supports all parameter locations as listed in the OAS.