api-scaffolding

Install library

npm install api-scaffolding

Create api schema

import { Repository } from 'api-scaffolding'

const repo = new Repository()
  .setHandler((options) => {
    return fetch(options.url).then((response) => response.json())
  })
  .setDomains({
    api: 'https://jsonplaceholder.typicode.com',
  })

interface Post {
  userId: number
  id: number
  title: string
  body: string
}

interface Todo {
  userId: number
  id: number
  title: string
  completed: boolean
}

/**
 * Call function with optional generics
 * repo.use
 * with desired method (can be any string)
 * then call returned function with desired URL
 * dynamic parameters start with ":" Example :userId
 * these parameters will be automatically required on usage
 */

const api = {
  postModel: {
    findOne: repo.use('GET')('{{api}}/posts/:postId'),
    findAll: repo.use('GET')('{{api}}/posts'),
    create: repo.use>('POST')('{{api}}/posts'),
    update: repo.use('PUT')('{{api}}/posts/:postId'),
    patch: repo.use>('PATCH')('{{api}}/posts/:postId'),
    delete: repo.use('DELETE')('{{api}}/posts/:postId'),
    filter: repo.use('GET')('{{api}}/posts?userId=:userId'),
  },

  todoModel: {
    findOne: repo.use('GET')('{{api}}/todos/:todoId'),
  },

  use: (
    ...args: Parameters
  ) => repo.use(...args),
}

Usage

/* const post: Post */
const post = await api.postModel.findOne({ postId: '1' })

/* const posts: Post[] */
const posts = await api.postModel.findAll({})

await api.postModel.create({
  payload: {
    title: 'foo',
    body: 'bar',
    userId: 1,
  },
})

await api.postModel.update({
  postId: '1',
  payload: {
    id: 1,
    title: 'foo',
    body: 'bar',
    userId: 1,
  },
})

await api.postModel.patch({
  postId: '1',
  payload: {
    title: 'foo',
  },
})

await api.postModel.delete({
  postId: '1',
})

await api.postModel.filter({
  userId: '2',
})

await api.todoModel.findOne({
  todoId: '4',
})

await api.use('DELETE')('{{api}}/todos/:todoId')({ todoId: '1' })