npmpackage.info

serverless-http

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

3.2.0

1,752

NOASSERTION

JavaScript

4.57 kB

36,431,198 3.2

Installations

npm install serverless-http

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>=12.0

Node Version

18.12.1

NPM Version

9.2.0 Score

98.8

Supply Chain

100

Quality

80.9

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

5

Total

134

Closed

37

Merged

92

Issues

Open

50

Total

169

Closed

119

Releases

Unable to fetch releases

Contributors

Unable to fetch Contributors

View all 49 contributors

Languages

JavaScript

TypeScript

JavaScript (99.41%)

TypeScript (0.59%)

Developer

dougmoscrop

Download Statistics

Total Downloads

36,431,198

Last Day

40,686

Last Week

158,435

Last Month

712,324

Last Year

9,154,913

GitHub Statistics

1,752 Stars

340 Commits

167 Forks

18 Watching

7 Branches

49 Contributors

Bundle Size

17.16 kB

Minified

4.57 kB

Minified + Gzipped

Bundlephobia

Maintainers

Package Meta Information

Latest Version

3.2.0

Package Id

serverless-http@3.2.0

Unpacked Size

35.78 kB

Size

10.64 kB

File Count

NPM Version

9.2.0

Node Version

18.12.1

Publised On

11 Mar 2023

Total Downloads

Cumulative downloads

Total Downloads

36,431,198

Last day

17.1%

40,686

Compared to previous day

Last week

-14.2%

158,435

Compared to previous week

Last month

712,324

Compared to previous month

Last year

28%

9,154,913

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Versions

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.

Support

Supported Frameworks

(* Experimental)

Node (http.createServer)
Connect
Express
Koa
Restana
Sails *
Hapi *
Fastify *
Restify *
Polka *
Loopback *

Supported Providers

AWS
Azure (Experimental, untested, probably outdated)

Examples

Please check the examples folder!

Usage example using the Koa framework

1const serverless = require('serverless-http');
2const Koa = require('koa'); // or any supported framework
3
4const app = new Koa();
5
6app.use(/* register your middleware as normal */);
7
8// this is it!
9module.exports.handler = serverless(app);
10
11// or as a promise
12const handler = serverless(app);
13module.exports.handler = async (event, context) => {
14  // you can do other things here
15  const result = await handler(event, context);
16  // and here
17  return result;
18};

Usage example using the Express framework with Azure

1
2const serverless = require('serverless-http');
3const express = require('express');
4
5const app = express();
6
7app.use(/* register your middleware as normal */);
8
9const handler = serverless(app, { provider: 'azure' });
10module.exports.funcName = async (context, req) => {
11  context.res = await handler(context, req);
12}
13

Other examples

json-server-less-λ - 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.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

9

License

Determines if the project has defined a license.

6

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

3

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

0

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

Score

3.2

/10

Last Scanned on 2025-01-27

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to serverless-http

tencent-serverless-http

1.3.2

This library enables you to utilize Tencent Cloud API Gateway to respond to web and API requests using your existing Node.js application framework.

serverless-offline

14.4.0

Emulate AWS λ and API Gateway locally when developing your Serverless project

@midwayjs/serverless-http-parser

3.20.0

parse http/apigw trigger event to koa ctx.

@tsed/platform-serverless-http

8.4.5

Module to support Serverless HTTP function with Ts.ED

serverless-http

Installations

Developer Guide

Yes

CommonJS

>=12.0

18.12.1

9.2.0

Score

Pull Requests

5

134

37

92

Issues

50

169

119

Releases

Unable to fetch releases

Contributors

Unable to fetch Contributors

Languages

Developer

dougmoscrop

Download Statistics

GitHub Statistics

Bundle Size

17.16 kB

4.57 kB

Maintainers

Package Meta Information

Total Downloads

36,431,198

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

serverless-http

Description

Sponsors

Upstash: Serverless Database for Redis

Support

Supported Frameworks

Supported Providers

Examples

Usage example using the Koa framework

Usage example using the Express framework with Azure

Other examples

Limitations

Contributing

Further Reading

10

10

9

6

3

0

0

0

0

0

0

0

0

3.2

/10

Other packages similar to serverless-http