# openapi-types-aws

> [![NPM version](https://badge.fury.io/js/openapi-types-aws.svg)](https://badge.fury.io/js/openapi-types-aws) [![PyPI version](https://badge.fury.io/py/openapi-types-aws.svg)](https://badge.fury.io/py/openapi-types-aws) ![Release](https://github.com/mmulle

Latest version **0.0.1** (published 2020-12-31) · Apache-2.0 license · 0 weekly downloads

## Install

```sh
npm install openapi-types-aws
pnpm add openapi-types-aws
yarn add openapi-types-aws
bun add openapi-types-aws
```

## Health

**Score 25/100 (F)** — status: abandoned.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.1 |
| Published | 2020-12-31 |
| First published | 2020-12-31 |
| Weekly downloads | 0 |
| License | Apache-2.0 |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 1 |
| Unpacked size | 22.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Author | Martin Mueller |
| Maintainers | damadden88 |
| Keywords | aws, extension, oas, openapi, type |

## Links

- npm: https://www.npmjs.com/package/openapi-types-aws
- npm.io page: https://npm.io/package/openapi-types-aws

## Dependencies (1)

- [openapi3-ts](https://npm.io/package/openapi3-ts.md) ^2.0.0

## Alternatives

- [update-check](https://npm.io/package/update-check.md) — 4.0M weekly downloads
- [react-native-onesignal](https://npm.io/package/react-native-onesignal.md) — 134.5K weekly downloads
- [react-redux-toastr](https://npm.io/package/react-redux-toastr.md) — 33.7K weekly downloads
- [@nocobase/plugin-notification-manager](https://npm.io/package/@nocobase/plugin-notification-manager.md) — 2.0K weekly downloads
- [react-simple-toasts](https://npm.io/package/react-simple-toasts.md) — 1.9K weekly downloads

## Recent versions

- 0.0.1 (latest) — 2020-12-31

## README

[![NPM version](https://badge.fury.io/js/openapi-types-aws.svg)](https://badge.fury.io/js/openapi-types-aws)
[![PyPI version](https://badge.fury.io/py/openapi-types-aws.svg)](https://badge.fury.io/py/openapi-types-aws)
![Release](https://github.com/mmuller88/openapi-types-aws/workflows/Release/badge.svg)

# openapi-types-aws

OpenApi V3 Types based on https://github.com/metadevpro/openapi3-ts but extended with AWS Extensions like

```JSON
"x-amazon-apigateway-integration": {
  "uri": "arn:aws:apigateway:eu-central-1:lambda:path/2015-03-31/functions/arn:aws:lambda:eu-central-1:981237193288:function:getOneConfApi/invocations",
  "passthroughBehavior": "when_no_match",
  "httpMethod": "POST",
  "type": "aws_proxy"
},
```

For type support in Python at compiler time you need to declare the Document directly!

# Features

- OpenApi V3 supported

# Example

```ts
import * as openapi from 'openapi-types-aws';

const openApi: openapi.OpenAPIObjectAWS = {
  openapi: '3.0.2',
  info: {
    title: 'Swagger Petstore - OpenAPI 3.0',
    description:
      "This is a sample Pet Store Server based on the OpenAPI 3.0 specification.  You can find out more about\nSwagger at [http://swagger.io](http://swagger.io). In the third iteration of the pet store, we've switched to the design first approach!\nYou can now help us improve the API whether it's by making changes to the definition itself or to the code.\nThat way, with time, we can improve the API in general, and expose some of the new features in OAS3.\n\nSome useful links:\n- [The Pet Store repository](https://github.com/swagger-api/swagger-petstore)\n- [The source API definition for the Pet Store](https://github.com/swagger-api/swagger-petstore/blob/master/src/main/resources/openapi.yaml)",
    termsOfService: 'http://swagger.io/terms/',
    contact: { email: 'apiteam@swagger.io' },
    license: {
      name: 'Apache 2.0',
      url: 'http://www.apache.org/licenses/LICENSE-2.0.html',
    },
    version: '1.0.5',
  },
  externalDocs: {
    description: 'Find out more about Swagger',
    url: 'http://swagger.io',
  },
  servers: [
    { url: 'https://8jcspmriad.execute-api.eu-central-1.amazonaws.com/prod' },
  ],
  tags: [
    {
      name: 'pet',
      description: 'Everything about your Pets',
      externalDocs: {
        description: 'Find out more',
        url: 'http://swagger.io',
      },
    },
    { name: 'store', description: 'Operations about user' },
    {
      name: 'user',
      description: 'Access to Petstore orders',
      externalDocs: {
        description: 'Find out more about our store',
        url: 'http://swagger.io',
      },
    },
  ],
  paths: {
    '/pet': {
      put: {
        tags: ['pet'],
        summary: 'Update an existing pet',
        description: 'Update an existing pet by Id',
        operationId: 'updatePet',
        requestBody: {
          description: 'Update an existent pet in the store',
          content: {
            'application/json': {
              schema: { $ref: '#/components/schemas/Pet' },
            },
            'application/xml': {
              schema: { $ref: '#/components/schemas/Pet' },
            },
            'application/x-www-form-urlencoded': {
              schema: { $ref: '#/components/schemas/Pet' },
            },
          },
          required: true,
        },
        responses: {
          200: {
            description: 'Successful operation',
            content: {
              'application/xml': {
                schema: { $ref: '#/components/schemas/Pet' },
              },
              'application/json': {
                schema: { $ref: '#/components/schemas/Pet' },
              },
            },
          },
          400: { description: 'Invalid ID supplied' },
          404: { description: 'Pet not found' },
          405: { description: 'Validation exception' },
        },
        'x-amazon-apigateway-integration': {
          uri:
            'arn:aws:apigateway:eu-central-1:lambda:path/2015-03-31/functions/arn:aws:lambda:eu-central-1:981237193288:function:getOneConfApi/invocations',
          passthroughBehavior: openapi.PassthroughBehavior.when_no_match,
          httpMethod: openapi.HttpMethods.POST,
          type: openapi.Type.aws_proxy,
        },
        security: [{ petstore_auth: ['write:pets', 'read:pets'] }],
      },
    },
  },
};
```

# Thanks To

- kogosoftwarellc for the base package
- to the awesome [Projen](https://github.com/projen/projen) Project and its community

---
_Source: https://npm.io/package/openapi-types-aws · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
