Request-schema NPM

Request Schema make possible to define your schema in one place and then use request() without the need to specify type for each request.

schema object is a mix of plain JavaScript and TypeScript definition. That is possible with the powerful as keyword.

For now, request-schema only support axios, but agnostic HTTP client is coming soon.

npm i axios@0.18

Example

import { createAxiosInstance } from 'request-schema'

const schema = {
  'GET users': {
    url: 'users',
    method: 'GET',
    params: {} as {
      page?: number,
      pageSize?: number,
    },
    data: null,
    response: {} as {
      id: string,
      username: string,
      email: string
    }[]
  },
  'PATCH users/:id': {
    url: (params: { id: string }) => `users/${params.id}`,
    method: 'PATCH',
    params: null,
    data: {} as {
      username?: string,
      email?: string
    },
    response: {} as {
      id: string,
      username: string,
      email: string
    }
  },
}

const api = createAxiosInstance({ baseURL: '...' }, schema)

// GET
const user = await api.request({
  routeName: 'GET users',
  params: {
    page: 1,
    pageSize: 10
  },
})

// PATCH
const user = await api.request({
  routeName: 'PATCH users/:id',
  urlParams: {
    id: '1'
  },
  data: {
    username: 'John Doe'
  }
})

Properties url and method are used as JavaScript value

Properties params, data, response and url(params) are used as TypeScript definition.

TypeScript IntelliSense

routeName
data
params
urlParams
response

Things to know

Required and omited request properties

request-schema required 2 new properties on axios request config and omit 2 others.

It require:

routeName - use to get route config and definition
urlParams - object with params for url

It omit:

url
method

Theses 2 keys are already define in the schema

Schema keys names

Each keys of the schema object can be named like you want. In examples, names are GET users, GET users/:id, but you can named it GET_users, users get, retrieve users, update users/id, etc. Keys are use by TypeScript to find the correct route schema, so it's completely arbitrary