https://github.com/metadevpro/openapi3-ts

TS Model & utils for creating and exposing OpenAPI 3.x contracts.
https://github.com/metadevpro/openapi3-ts

openapi ts

Last synced: about 24 hours ago
JSON representation

TS Model & utils for creating and exposing OpenAPI 3.x contracts.

• Host: GitHub
• URL: https://github.com/metadevpro/openapi3-ts
• Owner: metadevpro
• License: mit
• Created: 2017-03-06T18:47:56.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2024-09-24T04:21:09.000Z (4 months ago)
• Last Synced: 2024-10-29T23:55:33.499Z (2 months ago)
• Topics: openapi, ts
• Language: TypeScript
• Homepage:
• Size: 807 KB
• Stars: 484
• Watchers: 7
• Forks: 64
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • Changelog: Changelog.md
  • License: LICENSE

Awesome Lists containing this project

• jimsghstars - metadevpro/openapi3-ts - TS Model & utils for creating and exposing OpenAPI 3.x contracts. (TypeScript)

README

        
# OpenApi3-TS

TypeScript library to help building OpenAPI 3.x compliant API contracts.

[![Coverage Status](https://coveralls.io/repos/github/metadevpro/openapi3-ts/badge.svg?branch=master)](https://coveralls.io/github/metadevpro/openapi3-ts?branch=master)

[![Known Vulnerabilities](https://snyk.io/test/github/metadevpro/openapi3-ts/badge.svg?targetFile=package.json)](https://snyk.io/test/github/metadevpro/openapi3-ts?targetFile=package.json)

[![npm version](https://badge.fury.io/js/openapi3-ts.svg)](http://badge.fury.io/js/openapi3-ts)

[![NPM](https://nodei.co/npm/openapi3-ts.png?downloads=true&downloadRank=true&stars=true)](https://nodei.co/npm/openapi3-ts/)

## Version 4

*Breaking change notice:*

Version 4.0 Adds explicit support for OAS 3.0 and OAS 3.1 as separate implementations.

### To use version 3.1 import

```js

import { oas31 } from 'openapi3-ts';

```

Or directly import from subpath:

```js

import { OpenAPIObject, OpenApiBuilder } from 'openapi3-ts/oas31';

```

### To use version 3.0 import

```js

import { oas30 } from 'openapi3-ts';

```

Or directly import from subpath:

```js

import { OpenAPIObject, OpenApiBuilder } from 'openapi3-ts/oas30';

```

## Includes

* `/src/model` TS typed interfaces for helping building a contract.

* `/src/dsl` Fluent DSL for building a contract.

## Install

Install package via **npm**:

```bash

npm i --save openapi3-ts

```

## Documentation, Versions, and Changelog

* [Documentation](docs/index.md).

* See [changelog](Changelog.md) for version and changes.

## References

* OpenAPI spec 3.1.0. [https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md)

## License

Licensed under the MIT License.

## Credits

**Contact:** Pedro J. Molina | github: [pjmolina](https://github.com/pjmolina) | twitter: [pmolinam](https://twitter.com/pmolinam)

(c) 2017-2024. [Pedro J. Molina](http://pjmolina.com) at Metadev S.L. [https://metadev.pro](https://metadev.pro) & contributors.