Détail du package

@throskam/oas-impl

throskam17MIT0.3.0

OpenAPI Specification Implementation for Node.js

openapi, oas, node, server

readme

OpenAPI Specification Implementation

An OpenAPI v3 specification implementation.

Features

  • Request and Response validation (based on ajv)
  • Request and Response coersion (type casting and defaults setting)
  • Response generation (customizable)

Dependencies

Installation

npm install @throskam/oas-impl

Usage

import oas from 'oas-impl'

/** Create a request dispatcher for the given openapi v3 specifcation. */
const dispatch = oas(document, option)

/**
 * Dispatch the request and get the corresponding route object containing
 * contextual information and dedicated utility methods.
 * See documentation for more details.
 */
const route = dispatch(method, path)

Documentation

See DOC.md

Contributing

See CONTRIBUTING.md

Roadmap

  • [feature] validator: security (apiKey, http, oauth2 and openIdConnect)
  • [feature] coercer: parameter style
  • [feature] coercer: parameter explode
  • [feature] coercer: content mediaType (JSON.parse, form, text, ...)
  • [feature] coercer: content encoding
  • [feature] coercer: response links
  • [feature] validator: response links
  • [feature] generator: response links
  • [feature] validator: parameter query allowReserved
  • [feature] validator: discrimator
  • [feature] validator: deprecated
  • [feature] generator: random
  • [feature] coercer: async
  • [feature] generator: async
  • [feature] validator: async