@0x-jerry/openapi-ts v1.2.2

OpenAPI Code Generator

This package provide a quick way to transform OpenAPI schema or Swagger schema to client typescript code.

Usage

1. Generate client typescript code

import { generate } from '@0x-jerry/openapi-ts'

const apiUrl = 'http://doc-url/api-docs'

const swaggerSchema = await (await fetch(apiUrl)).json()

await generate({
  schema: swaggerSchema,
  output: 'api/generated',
})

2. Implement custom API adaptor api/_adapter.ts

import { type RequestParams } from '@0x-jerry/openapi-ts'

export interface Config {
  customOption?: any
}

export const _request = async <Return>(data: RequestParams<Config>) => {
  const resp = await doRequest({
    url: data.url,
    method: data.method,
    searchParams: data.query,
    body: data.data,
    config: data.config,
  })

  return resp as Return
}

3. Use generated code

import * as api from './api/generated'

const resp = await api.segment.to.path.$get({...})