lemon-core / V4

Lemon Core Bootloader for Serverless Micro-Service

• Support multiple event sources with single lambda function as below figure.

• Fully support typescript types (80%).

• Support Data Synchronization to Elasticsearch from DynomoDB via DynamoStream.

• The way to migrate v3 to v4: SEE HOW_TO_UPGRADE_V4

  

Architecture

Basic MicroService Architecutre with API + SNS + SQS.

• NextHandler: basic controller method to handle user service

• NextDecoder: mapper from httpMethod + id + cmd to NextHandler

• NextContext: initial requester's context with identity.

  

Protocol Service

• support inter-communication between micro services

• execute(): synchronized call via lambda execution by API Handler.

• notifiy(): async call by SNS handler w/ lambda callback.

• enqueue(): async call by SQS handler w/ lambda callback.

• broadcast(): publish message via SNS, and handled by Notification handler.

  

import $engine, { ProtocolParam, ProtocolService, CallbackParam } from 'lemon-core';
// use the internal instance from $engine.
const service: ProtocolService = $engine.cores.protocol.service;
const protocol: ProtocolParam = service.fromURL(context, 'api://lemon-hello-api/hello/echo', param, body);
const callback: CallbackParam = { type: 'hooks', id: `${id}` };
// queue protocol in 30 seconds delayed.
const queueId = await service.enqueue(protocol, callback, 30);

Usage

1. install lemon-core module (>= 2.1.0).

npm install lemon-core --save

TODO - TBD in detail.

Contribution

Plz, request PR.

See CODE_OF_CONDUCT

LICENSE

MIT - (C) 2019 LemonCloud Co Ltd. - All Rights Reserved.

---

VERSION INFO

Version	Description
4.0.7	optimized verifyJWT() w/ more detail error.
4.0.6	optimized loadProfile() as sync call.
4.0.5	improve $protocol w/ lambda invoke.
4.0.0	optimized with nodejs22.
3.2.16	improve ALBHandler to support elb event.
3.2.15	improve NextContext to support referer and origin header.
3.2.13	improve createSigV4Proxy() to support the sig-v4 request to AWS.
3.2.12	improve buildResponse() to determin content-type of html.
3.2.11	updated elastic6-service to support SearchProxy.
3.2.10	updated elastic6-service to fix 400 ILLEGAL ARGUMENT (script parsing).
3.2.9	improve elastic6-service w/ latest open-search.
3.2.8	updated ttypescript^1.5.15, and optimized.
3.2.7	cleanup log message in AWSS3Service, and optimized.
3.2.6	improve listObjects() in AWSS3Service w/ prefix.
3.2.5	improve doReportError in lambda-web-handler.
3.2.4	updated with lemon-model@1.0.2.
3.2.3	support ES7.10, and improve sync to elastic.
3.2.1	improve getIdentityId() w/ env:LOCAL_ACCOUNT.
3.2.0	upgrade all packages, and clear audit fix.
3.1.2	refactoring with lemon-model@1.0.0 for shared types.
3.1.1	support ManagerProxy, AbstractProxy and $ES6. (x-lemon-identity as WebToken)
3.1.0	upgrade typescript^4.6.2, and optimized.
3.0.2	support helpers like $T.
3.0.0	improve search-client with @elastic/elasticsearch@7.12 to support AWS OpenSearch 1.1 (compartible with ES6.2).
2.2.20	improve an extra feature from aws-s3-service to 'lemon-images-api'
2.2.19	improve search filtering feature for ES6 autocomplete search.
2.2.18	support $U.jwt(passcode).encode(...) w/ npm.
2.2.16	hot-fix utf8 encoding of json in AWS.S3.
2.2.15	hot-fix Cannot read property 'setIndex' of null in Dynamo.
2.2.14	support CacheService, and support appending entry into list in Dynamo.
2.2.13	improve LambdaWEBHandler to support custom web-response including headers.
2.2.12	improve AWSS3Service to use pure JS image library because of AWS compatibility issue.
2.2.11	improve AWSS3Service by adding handy method and metadata+tag handling
2.2.10	improve Access-Control-Allow-Origin w/ Access-Control-Allow-Credentials: true.
2.2.9	support content-type:application/x-www-form-urlencoded form data.
2.2.6	improve search, and support cookie in NextContext.
2.2.5	support Access-Control-Allow-Headers for CORS.
2.2.3	support x-lemon-language header in identity.
2.2.0	support AbstractManager for the template of model managers.
2.1.17	support filter() in DynamoStream.
2.1.16	improve lock() w/ 404 error, and .aggregations in QueryResult.
2.1.14	support hash param for MocksAPIService.
2.1.13	support HttpStorage, $U.crypto2, and /favicon.ico.
2.1.12	support userAgent in NextContext.
2.1.11	improve syncToElastic6, and DynamoScanService.
2.1.10	support loadProfile(), and lookup-id style.
2.1.8	improve express of request-context.
2.1.7	improve TypedStorageService w/ save().
2.1.5	support GeneralAPIController along w/ UniqueFieldManager.
2.1.3	support asNextIdentityAccess() for access identity.
2.1.2	support ProxyStorageService for shared common storage.
2.1.1	support enqueue() with delayed-seconds.
2.1.0	support ProtocolService for inter communication of micro-services.
2.0.10	support to display the current name/version by GET /.
2.0.9	improve Elastic6Service + Elastic6QueryService.
2.0.8	improve APIService w/ mocks data.
2.0.7	improve StorageService along w/ dummy-storage-service.
2.0.6	support CoreWEBController, and lambda.cores.web.addController(...)
2.0.5	support APIService, and fix engine.initialize()
2.0.3	support StorageService along with DynamoStorageService
2.0.0	improve lemon-engine, and support typescript fully.
1.2.15	improve doReportError with error message
1.2.12	support doReportMetric() for saving metric data.