@noxify/ts-lambda-api-local

ts-lambda-api-local

Extension module for the ts-lambda-api package which enables running lambda REST API's locally using express.

This module also provides Swagger UI support, powered by the swagger-ui-express npm package.

NPM Package GitHub Repo

Read the full typedoc documentation: https://djfdyuruiry.github.io/ts-lambda-api-local/

---

Getting Started

---

Note: These steps modify an existing ts-lambda-api app. If you don't have one, see the package documentation.

• Install this package and types for Node.js as dev dependencies:

npm install -D ts-lambda-api-local
npm install -D @types/node

• Create a new typescript file, add the following:

import * as path from "path"

import { ApiConsoleApp } from "ts-lambda-api-local"

// if you use a different directory, point to it here instead of 'controllers'
let app = new ApiConsoleApp(path.join(__dirname, "controllers"))

app.runServer(process.argv)

• Compile your application and run the new JS file using Node.js

• You can now call your API locally:

wget -qO - http://localhost:8080/api/v1/some-controller/

---

Command Line Arguments

---

ApiConsoleApp supports several optional command line parameters.

• -p or --port: Port to listen on, defaults to 8080
• -h or --host: Host to accept requests on, defaults to * (any hostname/ip)
• -c or --cors-origin: CORS origins to allow, defaults to * (any origin)

---

Configuration

---

Both the configureApp and configureApi methods documented in ts-lambda-api are available in the ApiConsoleApp class.

---

Swagger UI

---

To enable the Swagger UI page, simply enable open-api in your application config. The interface will then be available from the /swagger endpoint. For example, if you configured your app like below:

import * as path from "path"

import { AppConfig } from "ts-lambda-api"
import { ApiConsoleApp } from "ts-lambda-api-local"

let appConfig = new AppConfig()

appConfig.base = "/api/v1"
appConfig.version = "v1"
appConfig.openApi.enabled = true

let app = new ApiConsoleApp(path.join(__dirname, "controllers"))

app.runServer(process.argv)

Then, the Swagger UI interface will be available @ http://localhost:8080/api/v1/swagger

---

Packaging for Release

---

When you are packing up your lambda API for release to AWS, ensure that you have installed this package as a development dependency only, otherwise it will significantly slow down and bloat your lambda.