1.0.0 • Published 2 years ago
tycloud97-lemon-core v1.0.0
lemon-core
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
fromDynomoDB
viaDynamoStream
.
Architecture
Basic MicroService Architecutre with API
+ SNS
+ SQS
.
NextHandler
: basic controller method to handle user serviceNextDecoder
: mapper fromhttpMethod + id + cmd
toNextHandler
NextContext
: initial requester's context withidentity
.
Protocol Service
- support inter-communication between micro services
execute()
: synchronized call via lambda execution byAPI
Handler.notifiy()
: async call bySNS
handler w/ lambda callback.enqueue()
: async call bySQS
handler w/ lambda callback.broadcast()
: publish message viaSNS
, and handled byNotification
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
- 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.
TODO TASK
- use environ as default region like
ap-southeast-1
(or use current region). - draw protocol's sequence diagram w/
callback
mechanism. - on protocol, use local account name as accountId for NextContext.
- for protocol.enqueue(), use the optional delayed wait time.
- notification-handler is directly subscribed to
SNS
likelemon-hello-out
. - for protocol.brodcast(), use
SNS
to receive events (along with https) @200121
VERSION INFO
Version | Description |
---|---|
2.2.20 | cleanse and move an extra feature from aws-s3-service to 'lemon-images-api' |
2.2.19 | fix an issue and add filtering feature for ES6 autocomplete search . |
2.2.18 | support $U.jwt(passcode).encode(...) w/ jsonwebtoken . |
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 | fix 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 | fix 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.8 | minor changes. |
2.2.7 | fix status is not defined . |
2.2.6 | improve search , and support cookie in NextContext. |
2.2.5 | add Access-Control-Allow-Headers for CORS. |
2.2.4 | update package modules npm update --save . |
2.2.3 | support x-lemon-language header in identity. |
2.2.2 | fix result of sns/sqn event handler |
2.2.1 | fix missing export of a class declaration. |
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.15 | support $U.FN() for float-number. |
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.9 | improve lock() and search() . |
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.4 | optimized ProtocolService w/ callback. |
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 | show 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.4 | improve test-helper w/ environ , credentials |
2.0.3 | support StorageService along with DynamoStorageService |
2.0.2 | refactoring, and support ProtocolService |
2.0.1 | fix package dependencies. |
2.0.0 | remove lemon-engine , and support typescript fully. |
1.2.15 | improve doReportError with error message |
1.2.12 | support doReportMetric() for saving metric data. |