https://github.com/dougmoscrop/serverless-http

Use your existing middleware framework (e.g. Express, Koa) in AWS Lambda 🎉
https://github.com/dougmoscrop/serverless-http

Last synced: about 2 months ago
JSON representation

Use your existing middleware framework (e.g. Express, Koa) in AWS Lambda 🎉

• Host: GitHub
• URL: https://github.com/dougmoscrop/serverless-http
• Owner: dougmoscrop
• License: other
• Created: 2016-10-07T00:22:15.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2023-10-17T21:16:40.000Z (11 months ago)
• Last Synced: 2024-04-14T07:38:07.239Z (5 months ago)
• Language: JavaScript
• Homepage:
• Size: 3.76 MB
• Stars: 1,698
• Watchers: 18
• Forks: 163
• Open Issues: 51
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# serverless-http

## Description

This module allows you to 'wrap' your API for serverless use. No HTTP server, no ports or sockets. Just your code in the same execution pipeline you are already familiar with.

## Sponsors

Thank you to Upstash for reaching out to sponsor this project!

  

  

  

  

Upstash: Serverless Database for Redis


  


    
Serverless Redis with global replication and durable storage

    
Price scales to zero with per request pricing

    
Built-in REST API designed for serverless and edge functions

  

  

[Start for free in 30 seconds!](https://upstash.com/?utm_source=serverless-http)


## Support

### Supported Frameworks

(* Experimental)

* Node (http.createServer)

* Connect

* Express

* Koa

* Restana

* Sails *

* Hapi *

* Fastify *

* Restify *

* Polka *

* Loopback *

### Supported Providers

* AWS

* [Genezio](https://genezio.com/deploy-nodejs-express-on-genezio-serverless/)

* Azure (Experimental, untested, probably outdated)

## Deploy a Hello Word on Genezio

:rocket: You can deploy your own hello world example using the Express framework to Genezio with one click:

[![Deploy to Genezio](https://raw.githubusercontent.com/Genez-io/graphics/main/svg/deploy-button.svg)](https://app.genez.io/start/deploy?repository=https://github.com/Genez-io/express-getting-started)

## Examples

Please check the `examples` folder!

### Usage example using the Koa framework

```javascript

const serverless = require('serverless-http');

const Koa = require('koa'); // or any supported framework

const app = new Koa();

app.use(/* register your middleware as normal */);

// this is it!

module.exports.handler = serverless(app);

// or as a promise

const handler = serverless(app);

module.exports.handler = async (event, context) => {

  // you can do other things here

  const result = await handler(event, context);

  // and here

  return result;

};

```

### Usage example using the Express framework with Azure

```javascript

const serverless = require('serverless-http');

const express = require('express');

const app = express();

app.use(/* register your middleware as normal */);

const handler = serverless(app, { provider: 'azure' });

module.exports.funcName = async (context, req) => {

  context.res = await handler(context, req);

}

```

### Other examples

[json-server-less-λ](https://github.com/pharindoko/json-server-less-lambda) - using serverless-http with json-server and serverless framework in AWS

## Limitations

Your code is running in a serverless environment. You cannot rely on your server being 'up' in the sense that you can/should not use in-memory sessions, web sockets, etc. You are also subject to provider specific restrictions on request/response size, duration, etc.

> Think of this as a familiar way of expressing your app logic, *not* trying to make serverless do something it cannot.

## Contributing

Pull requests are welcome! Especially test scenarios for different situations and configurations.

## Further Reading

Here are some [more detailed examples](./docs/EXAMPLES.md) and [advanced configuration options](./docs/ADVANCED.md) as well as [provider-specific documentation](./docs/PROVIDERS.md)