OpenApi-codegen-typescript

Installation

• yarn add -D openapi-codegen-typescript
• npm install openapi-codegen-typescript --save-dev

Description

What is this library for?

• For fetching json file (mostly for "Swagger json")

Example:

1const { fetchSwaggerJsonFile } = require('openapi-codegen-typescript');
2
3async function doSomething() {
4  const json = await fetchSwaggerJsonFile('https://custom/swagger.json');
5  console.log('Json Result', json);
6}

• For converting swagger.json file to typescript types

Example:

1const { fetchSwaggerJsonFile, convertToTypes } = require('openapi-codegen-typescript');
2
3async function doSomething() {
4  const json = await fetchSwaggerJsonFile('https://custom/swagger.json');
5  convertToTypes({ json, fileName: 'dtoAPI', folderPath: 'src/types/generated' });
6}

This function ('doSomething()') fetches json file from urls, then converts json to typescript "types" and writes "types" to file ('src/types/generated/dtoAPI')

• For generating mock files that are using converted types

Example:

1const { fetchSwaggerJsonFile, convertToTypes } = require('openapi-codegen-typescript');
2
3async function doSomething() {
4  const json = await fetchSwaggerJsonFile('https://custom/swagger.json');
5  convertToMocks({
6    json,
7    fileName: 'dtoAPI',
8    folderPath: 'src/mocks/generated',
9    typesPath: '../../types/generated/dtoAPI',
10  });
11}

This function ('doSomething()') fetches json file from urls, then converts json to "mocks" and writes "mocks" to file ('src/mocks/generated/dtoAPI') with imports from typescript types ('src/types/generated/dtoAPI')

Overriding enum schema type

You can override open-api enum types and mocks by specifying overrideSchemas prop.

Let's imagine that we have this schema enum type in a json file:

1{
2  "SomeType": {
3    "type": "string",
4    "description": "",
5    "x-enumNames": ["Audio", "Video", "Image", "Text", "Raw"],
6    "enum": ["Audio", "Video", "Image", "Text", "Raw"]
7  }
8}

Overriding example:

1const { fetchSwaggerJsonFile, convertToTypes, convertToMocks } = require('openapi-codegen-typescript');
2
3const url = 'https://someLinkToSwagger/v2/swagger.json';
4
5async function main() {
6  const json = await fetchSwaggerJsonFile(url);
7  const overrideSchemas = [
8    {
9      ServiceOfferKind: {
10        type: 'string',
11        description: 'Warning! This type is overrided',
12        enum: ['masteringAndDistribution', 'video', 'samples', 'mastering', 'distribution', 'sessions'],
13      },
14    },
15  ];
16
17  convertToTypes({
18    json,
19    fileName: 'typesAPI',
20    folderPath: 'src/types/generated',
21    overrideSchemas,
22  });
23  convertToMocks({
24    json,
25    fileName: 'mocksAPI',
26    folderPath: 'src/mocks/generated',
27    typesPath: '../../types/generated/typesAPI',
28    overrideSchemas,
29  });
30}
31
32main();

AllInOne Example:

1const { fetchSwaggerJsonFile, convertToTypes, convertToMocks } = require('openapi-codegen-typescript');
2
3const petShopLink = 'https://petstore.swagger.io/v2/swagger.json';
4
5async function main() {
6  const json = await fetchSwaggerJsonFile(petShopLink);
7  convertToTypes({ json, fileName: 'typesAPI', folderPath: 'src/types/generated' });
8  convertToMocks({
9    json,
10    fileName: 'mocksAPI',
11    folderPath: 'src/mocks/generated',
12    typesPath: '../../types/generated/typesAPI',
13  });
14}
15
16main();

Methods:

fetchSwaggerJsonFile(url)

url: string - url to swagger json file

Returns a swagger json object;

convertToTypes({ json, fileName, folderPath })

json: object - swagger json data; fileName: string - name of the file, where typescript types data will be saved; folderPath: string - folder path the fileName, where typescript types data will be saved;

Returns void;

convertToMocks({ json, fileName, folderPath, typesPath })

json: object - swagger json data; fileName: string - name of the file, where mocks data will be saved; folderPath: string - folder path the fileName, where mocks data will be saved; typesPath: string - folder path to types, where typescript types data are saved. Path to types will be inserted to the type imports in generated mocks (generated -> import {...} from typesPath;);

Returns void;