@fintalk.ai/lambda-handlers 1.0.0

package/README.md

@@ -0,0 +1,152 @@
+# `@fintalk-ai/lambda-handlers`
+
+Lib para fazer wrapper de lambdas
+
+## Lambda trigada pela API Gateway como proxy (múltiplas rotas numa lambda)
+
+```javascript
+import { LambdaApiProxyHandler, Controller } from '@fintalk-ai/lambda-handlers'
+import { APIGatewayProxyHandler } from 'aws-lambda'
+import authentication from './authentication'
+import foo from './controllers/foo'
+
+const api = new LambdaApiProxyHandler({
+  base: process.env.ADMIN_API_BASE_PATH,
+})
+
+const foo: Controller = (req) => {
+  return Promise.resolve({
+    body: {
+      message: 'Hello World'
+    },
+  })
+}
+
+export const handler: APIGatewayProxyHandler = async (
+  event,
+  context,
+) => {
+  api.addRoute({
+    method: 'GET',
+    path: '/',
+    run: foo,
+    auth: authentication(['admin']),
+  })
+
+  return api.handler(event, context)
+}
+```
+
+## Lambda trigada pela API Gateway como proxy (uma rota por lambda)
+```javascript
+import { Controller, LambdaApiHandler } from '@fintalk-ai/lambda-handlers'
+import { APIGatewayProxyHandler } from 'aws-lambda'
+
+const getUserController: Controller = async (request) => {
+  const user = await getUser(request.params.id)
+
+  return {
+    body: user,
+  }
+}
+
+const apiHandler = new LambdaApiHandler(getUserController)
+
+export const handler: APIGatewayProxyHandler = async (
+  event,
+  context,
+) => {
+  return apiHandler.handler(event, context)
+}
+
+```
+
+
+## Lambda trigada por SQS
+
+```javascript
+import { LambdaSqsHandler, Worker } from '@fintalk-ai/lambda-handlers'
+import { SQSHandler } from 'aws-lambda'
+
+interface CreateUserMessage {
+  user_id: string
+}
+
+const workerCreateUser: Worker<CreateUserMessage> = async (messages) => {
+  for (const { body } of messages) {
+    const user = await getUser(body.user_id)
+  }
+}
+
+const sqsHandler = new LambdaSqsHandler(workerCreateUser)
+
+export const handler: SQSHandler = async (event) => {
+  return sqsHandler.handler(event)
+}
+
+```
+
+## Lambda trigada por SQS (Worker com processamento em paralelo)
+
+```javascript
+import { LambdaSqsHandlerV2, WorkerV2 } from '@fintalk-ai/lambda-handlers'
+import { SQSHandler } from 'aws-lambda'
+
+interface CreateUserMessage {
+  user_id: string
+}
+
+const workerCreateUser: WorkerV2<CreateUserMessage> = async (message, logger) => {
+  logger.debug('Start create user')
+  const user = await getUser(body.user_id)
+}
+
+const sqsHandler = new LambdaSqsHandler({
+  worker: workerCreateUser,
+  parallel: false,
+  service: 'msghandler',
+})
+
+export const handler: SQSHandler = async (event) => {
+  return sqsHandler.handler(event)
+}
+```
+
+A LambdaSqsHandlerV2 precisa ter o Report Batch Item Failures habilitado. Abaixo exemplo com terraform:
+
+```terraform
+resource "aws_lambda_event_source_mapping" "event_handler" {
+  event_source_arn        = module.sqs_event_handler.sqs_arn
+  function_name           = module.event_handler.arn
+  batch_size              = 1
+  function_response_types = ["ReportBatchItemFailures"]
+}
+```
+
+## Lambda trigada pelo sdk
+
+```javascript
+import { LambdaInvokeHandler, InvokeHandler } from '@fintalk-ai/lambda-handlers'
+import { Handler } from 'aws-lambda'
+
+interface CreateUserRequest {
+  user_id: string
+}
+
+interface CreateUserResponse {
+  message: string
+}
+
+const createUserInvoke: InvokeHandler<CreateUserRequest, CreateUserResponse> = async (event) => {
+  return {
+    message: event.user_id
+  }
+}
+
+const invokeHandler = new LambdaInvokeHandler(createUserInvoke)
+
+export const handler: Handler<CreateUserRequest, CreateUserResponse> = async (event) => {
+  return invokeHandler.handler(event)
+}
+
+```

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@fintalk.ai/lambda-handlers",
+  "version": "1.0.0",
+  "description": "> TODO: description",
+  "author": "Fintalk.AI",
+  "homepage": "https://github.com/fintalk-ai/lambda-handlers#readme",
+  "license": "MIT",
+  "main": "lib/index.js",
+  "directories": {
+    "lib": "lib"
+  },
+  "files": [
+    "lib"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fintalk-ai/lambda-handlers#readme"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rimraf lib",
+    "tsc": "tsc -p tsconfig.build.json",
+    "lint": "eslint --cache --ext .ts src/",
+    "test": "LOGGER_LEVEL=silent jest",
+    "test:coverage": "LOGGER_LEVEL=silent jest --coverage",
+    "build": "run-s clean tsc"
+  },
+  "bugs": {
+    "url": "https://github.com/fintalk-ai/lambda-handlers/issues"
+  },
+  "devDependencies": {
+    "@babel/preset-typescript": "^7.16.7",
+    "@stone-ton/eslint-config-ton": "^0.1.1",
+    "@types/aws-lambda": "^8.10.92",
+    "@types/jest": "^27.4.0",
+    "@types/node": "^17.0.13",
+    "@types/qs": "^6.9.7",
+    "@typescript-eslint/eslint-plugin": "^5.10.1",
+    "@typescript-eslint/parser": "^5.10.1",
+    "esbuild": "^0.14.21",
+    "esbuild-jest": "^0.5.0",
+    "eslint": "^8.14.0",
+    "eslint-config-standard": "^17.0.0",
+    "eslint-plugin-import": "^2.26.0",
+    "eslint-plugin-n": "^15.2.0",
+    "eslint-plugin-promise": "^6.0.0",
+    "fintalk-logger": "~1.1.3",
+    "jest": "^28.1.3",
+    "jest-mock": "^28.1.0",
+    "jest-mock-extended": "^2.0.6",
+    "node-match-path": "^0.6.3",
+    "qs": "^6.10.3",
+    "rimraf": "^3.0.2"
+  },
+  "peerDependencies": {
+    "@types/aws-lambda": ">=8.10.92",
+    "@types/qs": ">=6.9.7",
+    "fintalk-logger": "~1.1.3",
+    "node-match-path": ">=0.6.3",
+    "qs": ">=6.10.3"
+  },
+  "dependencies": {
+    "typescript": "^5.1.3"
+  }
+}