Product
Introducing Enhanced Alert Actions and Triage Functionality
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
@6river/openapi-schema-to-json-schema
Advanced tools
Readme
A little NodeJS package to convert OpenAPI Schema Object or Parameter Object to JSON Schema.
Currently converts from OpenAPI 3.0 to JSON Schema Draft 4.
OpenAPI is a specification for describing RESTful APIs. OpenAPI v3.0 allows us to describe the structures of request and response payloads in a detailed manner. This would, theoretically, mean that we should be able to automatically validate request and response payloads. However, as of writing there aren't many validators around.
The good news is that there are many validators for JSON Schema for different languages. The bad news is that OpenAPI v3.0 is not entirely compatible with JSON Schema. The Schema Object of OpenAPI v3.0 is an extended subset of JSON Schema Specification Wright Draft 00 with some differences. This will be resolved in OpenAPI v3.1, but until then... this tool will fill that gap.
There is also a CLI tool for creating a JSON of schemas from the whole API specification.
If you need to do the conversion in reverse, checkout json-schema-to-openapi-schema.
nullable
and adds "null"
to type
array if nullable
is true
allOf
s etc.discriminator
, deprecated
etc. unless specified otherwisepatternProperties
with x-patternProperties
in the Schema ObjectNOTE: $ref
s are not handled in any way, so please use a resolver such as json-schema-ref-parser or swagger-cli bundle prior to using this package.
npm install --save @openapi-contrib/openapi-schema-to-json-schema
Here's a small example to get the idea:
var toJsonSchema = require('@openapi-contrib/openapi-schema-to-json-schema');
var schema = {
type: 'string',
format: 'date-time',
nullable: true
};
var convertedSchema = toJsonSchema(schema);
console.log(convertedSchema);
The example prints out
{
type: ['string', 'null'],
format: 'date-time',
'$schema': 'http://json-schema.org/draft-04/schema#'
}
Provide the function the schema object with possible options.
The function accepts options
object as the second argument.
cloneSchema
(boolean)If set to false
, converts the provided schema in place. If true
, clones the schema by converting it to JSON and back. The overhead of the cloning is usually negligible. Defaults to true
.
dateToDateTime
(boolean)This is false
by default and leaves date
format as is. If set to true
, sets format: 'date'
to format: 'date-time'
.
For example
var schema = {
type: 'string',
format: 'date'
};
var convertedSchema = toJsonSchema(schema, { dateToDateTime: true });
console.log(convertedSchema);
prints
{
type: 'string',
format: 'date-time',
'$schema': 'http://json-schema.org/draft-04/schema#'
}
keepNotSupported
(array)By default, the following fields are removed from the result schema: nullable
, discriminator
, readOnly
, writeOnly
, xml
, externalDocs
, example
and deprecated
as they are not supported by JSON Schema Draft 4. Provide an array of the ones you want to keep (as strings) and they won't be removed.
removeReadOnly
(boolean)If set to true
, will remove properties set as readOnly
. If the property is set as required
, it will be removed from the required
array as well. The property will be removed even if readOnly
is set to be kept with keepNotSupported
.
removeWriteOnly
(boolean)Similar to removeReadOnly
, but for writeOnly
properties.
supportPatternProperties
(boolean)If set to true
and x-patternProperties
property is present, change x-patternProperties
to patternProperties
and call patternPropertiesHandler
. If patternPropertiesHandler
is not defined, call the default handler. See patternPropertiesHandler
for more information.
patternPropertiesHandler
(function)Provide a function to handle pattern properties and set supportPatternProperties
to take effect. The function takes the schema where x-patternProperties
is defined on the root level. At this point x-patternProperties
is changed to patternProperties
. It must return the modified schema.
If the handler is not provided, the default handler is used. If additionalProperties
is set and is an object, the default handler sets it to false if the additionalProperties
object has deep equality with a pattern object inside patternProperties
. This is because we might want to define additionalProperties
in OpenAPI spec file, but want to validate against a pattern. The pattern would turn out to be useless if additionalProperties
of the same structure were allowed. Create you own handler to override this functionality.
See test/pattern_properties.test.js
for examples how this works.
OpenAPI parameters can be converted:
var toJsonSchema = require('@openapi-contrib/openapi-schema-to-json-schema').fromParameter;
var param = {
name: 'parameter name',
in: 'query',
schema: {
type: 'string',
format: 'date'
}
}
var convertedSchema = toJsonSchema(param);
console.log(convertedSchema);
The result is as follows:
{
type: 'string',
format: 'date',
'$schema': 'http://json-schema.org/draft-04/schema#'
}
When a parameter has several schemas (one per MIME type) a map is returned instead.
{
name: 'parameter name',
in: 'query',
content: {
'application/javascript': {
schema: {
type: 'string'
}
},
'text/css': {
schema: {
type: 'string'
}
}
}
}
would be converted to:
{
'application/javascript': {
type: 'string',
'$schema': 'http://json-schema.org/draft-04/schema#'
},
'text/css': {
type: 'string',
'$schema': 'http://json-schema.org/draft-04/schema#'
}
}
This package is Treeware. If you use it in production, then we ask that you buy the world a tree to thank us for our work. By contributing to the Treeware forest you’ll be creating employment for local families and restoring wildlife habitats.
Copyright 2021 the OpenAPI Contrib organization. Code released under the MIT License.
FAQs
Converts OpenAPI Schema Object to JSON Schema
The npm package @6river/openapi-schema-to-json-schema receives a total of 2 weekly downloads. As such, @6river/openapi-schema-to-json-schema popularity was classified as not popular.
We found that @6river/openapi-schema-to-json-schema demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 4 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Product
Socket now supports four distinct alert actions instead of the previous two, and alert triaging allows users to override the actions taken for all individual alerts.
Security News
Polyfill.io has been serving malware for months via its CDN, after the project's open source maintainer sold the service to a company based in China.
Security News
OpenSSF is warning open source maintainers to stay vigilant against reputation farming on GitHub, where users artificially inflate their status by manipulating interactions on closed issues and PRs.