Incoming handler

Because who needs a name

What is it?

It's a barebones way to write server api logic using the classic controller pattern, with very limited ceremony and very flexible to use and set up.

It's also been designed in a way to make it easy to deploy both as a traditional node server instance, or a lambda function or a cloudflare workers fetch handler

Installation

yarn add incoming-handler

Example usage

import { Controller, createInstance } from 'incoming-handler'
import { fetchThing, saveThing } from './libs/my-example-thing-fetcher'

class ThingController extends Controller {
  @GET('/thing/:id')
  async getThing({ params }) {
    const thing = fetchThing(params.id)
    return {
      ...thing,
    }
  }

  @POST('/thing/:id')
  async saveThing({ params, body }) {
    return saveThing(params.id, {
      ...body,
    })
  }
}

const instance = createInstance({ controllers: [new ThingController()] })

// If you want to start a local node server:
instance.startServer({
  host: 'localhost',
  port: 1337,
})

// or exposing to lambda handler:
export.handler = instance.getLambdaHandler()

// or implementing a fetch event handler in cloudflare workers:
addEventListener('fetch', instance.getFetchEventHandler())

TODOs

• support nested routes through controller decorator mapping
• cleaning up the controller action props and perhaps figuring out a way to type them properly.

Contributions

Contributions are welcome.

License

MIT