lemon-core 3.1.0 → 3.1.1

package/dist/cores/core-types.d.ts

@@ -42,23 +42,23 @@ export declare type NextMode = 'LIST' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PAT
  * - the context parameter for each next-handler `fx(id, param, body, context)`
  * - possible to query user's detail via OAuth Resource Server.
  */
-export interface NextIdentity {
+export interface NextIdentity<T = any> {
     /**
      * site-id (like domain group)
      */
-    sid: string;
+    sid?: string;
     /**
-     * user-id (user unique-id)
+     * user-id (user id)
      */
-    uid: string;
+    uid?: string;
     /**
      * group-id (group id)
      */
-    gid: string;
+    gid?: string;
     /**
      * roles  (like `user`, `admin`, `super`)
      */
-    roles: string[];
+    roles?: string[];
     /**
      * prefered language (like 'ko')
      * - use `x-lemon-language` header, or in `x-lemon-identity`
@@ -66,15 +66,40 @@ export interface NextIdentity {
      */
     lang?: string;
     /**
-     * something unknown.
+     * (optional) internal last-error message
+     * - if this is not empty, then DO NOT use this object.
+     * @since ver3.1.2 2022/MAY/15
      */
-    meta?: any;
+    error?: string;
+    /**
+     * something unknown having the original data.
+     */
+    meta?: T;
+}
+/**
+ * class: `NextIdentityJwt`
+ * - JWT-Token based identity
+ */
+export interface NextIdentityJwt<T = any> extends NextIdentity<T> {
+    /**
+     * issuer of jwt
+     * - must be in format of `kms/<alias>`
+     */
+    iss: string;
+    /**
+     * expired timestamp (sec)
+     */
+    exp: number;
+    /**
+     * issued timestamp (sec)
+     */
+    iat: number;
 }
 /**
  * class: `NextIdentityCognito`
  * - extended information w/ cognito identity.
  */
-export interface NextIdentityCognito extends NextIdentity {
+export interface NextIdentityCognito<T = any> extends NextIdentity<T> {
     /**
      * account-id of AWS Credential
      */
@@ -95,12 +120,17 @@ export interface NextIdentityCognito extends NextIdentity {
      * user-agent string like 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_14_4)'
      */
     userAgent?: string;
+    /**
+     * (optional) caller string like `AROXXXXXX:CognitoIdentityCredentials` from `APIGatewayEventIdentity`
+     * - available since `3.1.1`
+     */
+    caller?: string;
 }
 /**
  * class: `NextIdentityAcess`
  * - extended information w/ site + account access information.
  */
-export interface NextIdentityAccess extends NextIdentity {
+export interface NextIdentityAccess<T = any> extends NextIdentity<T> {
     /**
      * site-information for domain
      */
@@ -145,7 +175,7 @@ export interface NextIdentityAccess extends NextIdentity {
 }
 /**
  * class: `NextContext`
- * - information of caller's context.
+ * - information of caller's context w/ `next-identity`.
  */
 export interface NextContext<T extends NextIdentity = NextIdentity> {
     /**
@@ -169,7 +199,7 @@ export interface NextContext<T extends NextIdentity = NextIdentity> {
      */
     requestId?: string;
     /**
-     * id of account of initial request. (ex: `085403634746` for lemon profile)
+     * id of aws account number from initial request. (ex: `085403634746` for lemon profile)
      */
     accountId?: string;
     /**

package/dist/cores/dynamo/dynamo-query-service.d.ts

@@ -0,0 +1,52 @@
+import { GeneralItem } from '../core-types';
+import { DynamoOption } from './dynamo-service';
+/**
+ * class: QueryResult
+ * - result information of query.
+ */
+export interface DynamoQueryResult<T> {
+    list: T[];
+    count?: number;
+    last?: number;
+}
+/**
+ * feature: `DynamoSimpleQueriable`
+ * - simple query capable class.
+ */
+export interface DynamoSimpleQueriable<T extends GeneralItem> {
+    /**
+     * simple range query by `partition-key` w/ limit.
+     *
+     * @param pkey  value of partition-key
+     */
+    queryAll(pkey: string, limit?: number, isDesc?: boolean): Promise<DynamoQueryResult<T>>;
+    /**
+     * simple range query by `partition-key` and `range: sort-key` w/ limit.
+     *
+     * @param pkey  value of partition-key
+     * @param from  range start (included)
+     * @param to    range end (included)
+     * @param limit limit of page
+     * @param last  the last evaluated key (as sort-key)
+     */
+    queryRange(pkey: string, from: number, to: number, limit?: number, last?: number): Promise<DynamoQueryResult<T>>;
+}
+/**
+ * class: `DynamoQueryService`
+ * - support simple query like range search.
+ */
+export declare class DynamoQueryService<T extends GeneralItem> implements DynamoSimpleQueriable<T> {
+    protected options: DynamoOption;
+    constructor(options: DynamoOption);
+    /**
+     * say hello of identity.
+     */
+    hello: () => string;
+    queryAll(pkey: string, limit?: number, isDesc?: boolean): Promise<DynamoQueryResult<T>>;
+    queryRange(pkey: string, from: number, to: number, limit?: number, last?: number): Promise<DynamoQueryResult<T>>;
+    /**
+     * query by range of sort-key.
+     * NOTE - `dynamodb`의 일부 코드를 이용하여, 간단버전으로 지원함.
+     */
+    queryRangeBy(pkey: string, from: number, to: number, limit?: number, last?: number, isDesc?: boolean): Promise<DynamoQueryResult<T>>;
+}

package/dist/cores/dynamo/dynamo-query-service.js

@@ -0,0 +1,127 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoQueryService = void 0;
+/**
+ * `dynamo-query-service.ts`
+ * - common service to query with pkey+sort via dynamo
+ *
+ *
+ * @author      Steve Jung <steve@lemoncloud.io>
+ * @date        2019-11-6 initial version with `dynamodb` package.
+ *
+ * @copyright (C) 2019 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+const engine_1 = require("../../engine/");
+const dynamo_service_1 = require("./dynamo-service");
+const NS = engine_1.$U.NS('DYQR', 'green'); // NAMESPACE TO BE PRINTED.
+/** ****************************************************************************************************************
+ *  Service Main
+ ** ****************************************************************************************************************/
+const query_1 = __importDefault(require("../../lib/dynamo/query"));
+const serializer_1 = __importDefault(require("../../lib/dynamo/serializer"));
+/**
+ * class: `DynamoQueryService`
+ * - support simple query like range search.
+ */
+class DynamoQueryService {
+    constructor(options) {
+        /**
+         * say hello of identity.
+         */
+        this.hello = () => `dynamo-query-service:${this.options.tableName}`;
+        // eslint-disable-next-line prettier/prettier
+        (0, engine_1._inf)(NS, `DynamoQueryService(${options.tableName}/${options.idName}${options.sortName ? '/' : ''}${options.sortName || ''})...`);
+        if (!options.tableName)
+            throw new Error('.tableName is required');
+        if (!options.idName)
+            throw new Error('.idName is required');
+        this.options = options;
+    }
+    queryAll(pkey, limit, isDesc) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.queryRangeBy(pkey, -1, -1, limit, null, isDesc);
+        });
+    }
+    queryRange(pkey, from, to, limit, last) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.queryRangeBy(pkey, from, to, limit, last, false);
+        });
+    }
+    /**
+     * query by range of sort-key.
+     * NOTE - `dynamodb`의 일부 코드를 이용하여, 간단버전으로 지원함.
+     */
+    queryRangeBy(pkey, from, to, limit, last, isDesc) {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, engine_1._log)(NS, `queryRangeBy(${pkey}, ${from}, ${to})...`);
+            //! load table information..
+            const { tableName, idName, sortName, idType, sortType } = this.options;
+            const query = new query_1.default(pkey, { schema: { hashKey: idName, rangeKey: sortName }, tableName: () => tableName }, serializer_1.default);
+            // _log(NS, '> query =', query);
+            //! build query with builder.
+            if (sortName) {
+                const keyCondition = query.where(sortName);
+                from !== -1 && to !== -1 ? keyCondition.between(from, to) : keyCondition.gte(0);
+            }
+            isDesc ? query.descending() : query.ascending();
+            if (limit !== undefined)
+                query.limit(limit);
+            query.addKeyCondition(query.buildKey());
+            if (last) {
+                query.startKey(pkey, last);
+            }
+            //TODO - replace '@' prefix of properties.
+            const payload = query.buildRequest();
+            const filter = (N) => Object.keys(N).reduce((O, key) => {
+                const val = N[key];
+                key = key.startsWith('#@') ? '#_' + key.substring(2) : key;
+                key = key.startsWith(':@') ? ':_' + key.substring(2) : key;
+                O[key] = val;
+                return O;
+            }, {});
+            payload.ExpressionAttributeNames = filter(payload.ExpressionAttributeNames);
+            payload.ExpressionAttributeValues = filter(payload.ExpressionAttributeValues);
+            payload.KeyConditionExpression = payload.KeyConditionExpression.replace(/([\#\:])@/g, '$1_');
+            (0, engine_1._log)(NS, `> payload[${pkey}] =`, engine_1.$U.json(payload));
+            //! get instance of dynamodoc, and execute query().
+            const { dynamodoc } = dynamo_service_1.DynamoService.instance();
+            const res = yield dynamodoc.query(payload).promise();
+            if (res) {
+                // _log(NS, `> query[${pkey}].res =`, $U.json(res)); // `startKey`
+                const items = res.Items || [];
+                const count = res.Count;
+                const scannedCount = res.ScannedCount;
+                const $lek = res.LastEvaluatedKey || {};
+                const last = engine_1.$U.N($lek[sortName], 0);
+                (0, engine_1._log)(NS, `> query[${pkey}].items.len =`, items.length);
+                (0, engine_1._log)(NS, `> query[${pkey}].count =`, count);
+                (0, engine_1._log)(NS, `> query[${pkey}].scannedCount =`, scannedCount);
+                (0, engine_1._log)(NS, `> query[${pkey}].lastKey =`, last);
+                //! prepare result-set
+                const result = {
+                    list: items,
+                    count,
+                    last,
+                };
+                return result;
+            }
+            //! avoid null exception
+            return { list: [] };
+        });
+    }
+}
+exports.DynamoQueryService = DynamoQueryService;
+//# sourceMappingURL=dynamo-query-service.js.map

package/dist/cores/dynamo/dynamo-query-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo-query-service.js","sourceRoot":"","sources":["../../../src/cores/dynamo/dynamo-query-service.ts"],"names":[],"mappings":"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"}

package/dist/cores/dynamo/dynamo-scan-service.d.ts

@@ -0,0 +1,70 @@
+import { GeneralItem } from '../core-types';
+import { DynamoOption } from './dynamo-service';
+interface ComparisonCondition {
+    key: string;
+    comparator: '=' | '!=' | '<=' | '<' | '>=' | '>';
+    value: number | string;
+}
+interface BetweenCondition {
+    key: string;
+    from: number | string;
+    to: number | string;
+}
+interface ExistenceCondition {
+    key: string;
+    exists: boolean;
+}
+interface StringCondition {
+    key: string;
+    operator: 'begins_with' | 'contains';
+    value: string;
+}
+/**
+ * interface: DynamoScanFilter
+ * - for joining multiple conditions with logical AND -> Array
+ * - for joining multiple conditions with logical OR -> { or: Array }
+ */
+declare type Condition = ComparisonCondition | BetweenCondition | ExistenceCondition | StringCondition;
+export declare type DynamoScanFilter = (Condition | {
+    not: Condition;
+}) | DynamoScanFilter[] | {
+    or: DynamoScanFilter[];
+};
+/**
+ * class: DynamoScanResult
+ * - result information of scan.
+ */
+export interface DynamoScanResult<T> {
+    list: T[];
+    count?: number;
+    last?: any;
+}
+/**
+ * feature: `DynamoSimpleScannable`
+ * - simple scan capable class.
+ */
+export interface DynamoSimpleScannable<T extends GeneralItem> {
+    /**
+     * simple filtered scan w/ limit.
+     *
+     * @param limit     limit of page
+     * @param last      the last evaluated key
+     * @param filter    scan filter
+     */
+    scan(limit?: number, last?: any, filter?: DynamoScanFilter): Promise<DynamoScanResult<T>>;
+}
+/**
+ * class: `DynamoScanService`
+ * - support simple scan like range scan.
+ */
+export declare class DynamoScanService<T extends GeneralItem> implements DynamoSimpleScannable<T> {
+    protected options: DynamoOption;
+    constructor(options: DynamoOption);
+    /**
+     * say hello of identity.
+     */
+    hello: () => string;
+    scan(limit?: number, last?: any, filter?: DynamoScanFilter): Promise<DynamoScanResult<T>>;
+    private buildPayload;
+}
+export {};

package/dist/cores/dynamo/dynamo-scan-service.js

@@ -0,0 +1,164 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DynamoScanService = void 0;
+/**
+ * `dynamo-scan-service.ts`
+ * - common service to scan with filters+sort via dynamo
+ *
+ *
+ * @author      Tim Hong <tim@lemoncloud.io>
+ * @date        2020-01-20 initial version
+ *
+ * @copyright (C) 2020 LemonCloud Co Ltd. - All Rights Reserved.
+ */
+const engine_1 = require("../../engine/");
+const dynamo_service_1 = require("./dynamo-service");
+const NS = engine_1.$U.NS('DSCN', 'green'); // NAMESPACE TO BE PRINTED.
+function isComparisonCondition(c) {
+    return 'comparator' in c;
+}
+function isBetweenCondition(c) {
+    return 'from' in c && 'to' in c;
+}
+function isExistenceCondition(c) {
+    return 'exists' in c;
+}
+function isStringCondition(c) {
+    return 'operator' in c;
+}
+/** ****************************************************************************************************************
+ *  Service Main
+ ** ****************************************************************************************************************/
+const scan_1 = __importDefault(require("../../lib/dynamo/scan"));
+const serializer_1 = __importDefault(require("../../lib/dynamo/serializer"));
+/**
+ * class: `DynamoScanService`
+ * - support simple scan like range scan.
+ */
+class DynamoScanService {
+    constructor(options) {
+        /**
+         * say hello of identity.
+         */
+        this.hello = () => `dynamo-scan-service:${this.options.tableName}`;
+        // eslint-disable-next-line prettier/prettier
+        (0, engine_1._inf)(NS, `DynamoScanService(${options.tableName}/${options.idName}${options.sortName ? '/' : ''}${options.sortName || ''})...`);
+        if (!options.tableName)
+            throw new Error('.tableName is required');
+        if (!options.idName)
+            throw new Error('.idName is required');
+        this.options = options;
+    }
+    scan(limit, last, filter) {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, engine_1._log)(NS, `scan()...`);
+            //! build scan input payload
+            const payload = this.buildPayload(limit, last, filter);
+            (0, engine_1._log)(NS, `> payload =`, engine_1.$U.json(payload));
+            //! get instance of dynamodoc, and execute query().
+            const { dynamodoc } = dynamo_service_1.DynamoService.instance();
+            const res = yield dynamodoc.scan(payload).promise();
+            (0, engine_1._log)(NS, `> scan.res =`, engine_1.$U.json(res));
+            const items = res.Items || [];
+            const count = res.Count;
+            const scannedCount = res.ScannedCount;
+            const $lek = res.LastEvaluatedKey || {};
+            (0, engine_1._log)(NS, `> scan.items.len =`, items.length);
+            (0, engine_1._log)(NS, `> scan.count =`, count);
+            (0, engine_1._log)(NS, `> scan.scannedCount =`, scannedCount);
+            (0, engine_1._log)(NS, `> scan.last =`, $lek);
+            //! return result-set
+            return {
+                list: items,
+                count,
+                last: $lek,
+            };
+        });
+    }
+    buildPayload(limit, last, filter) {
+        const { tableName, idName, sortName } = this.options;
+        const scan = new scan_1.default({ schema: { hashKey: idName, rangeKey: sortName }, tableName: () => tableName }, serializer_1.default);
+        // Limit & Last
+        if (limit > 0)
+            scan.limit(limit);
+        if (last)
+            scan.startKey(last[this.options.idName], last[this.options.sortName]);
+        // Filter
+        if (filter) {
+            const expAttrNames = {};
+            const expAttrValues = {};
+            const asFilterExpression = (filter) => {
+                const asAttrName = (key) => {
+                    const attrNameVar = `#${key}`;
+                    expAttrNames[attrNameVar] = key;
+                    return attrNameVar;
+                };
+                const asAttrValue = (key, value) => {
+                    const attrValueVar = (function () {
+                        for (let i = 0;; i++) {
+                            const valueVar = `:${key}${i}`;
+                            if (!(valueVar in expAttrValues))
+                                return valueVar;
+                        }
+                    })();
+                    expAttrValues[attrValueVar] = value;
+                    return attrValueVar;
+                };
+                if (Array.isArray(filter)) {
+                    return `(${filter.map(asFilterExpression).join(' AND ')})`;
+                }
+                else if ('or' in filter && Array.isArray(filter.or)) {
+                    return `(${filter.or.map(asFilterExpression).join(' OR ')})`;
+                }
+                else if ('not' in filter) {
+                    return `NOT ${asFilterExpression(filter.not)}`;
+                }
+                else {
+                    const cond = filter;
+                    if (isComparisonCondition(cond)) {
+                        const [name, value] = [asAttrName(cond.key), asAttrValue(cond.key, cond.value)];
+                        return cond.comparator === '!='
+                            ? `NOT ${name} = ${value}`
+                            : `${name} ${cond.comparator} ${value}`;
+                    }
+                    else if (isBetweenCondition(cond)) {
+                        const [name, from, to] = [
+                            asAttrName(cond.key),
+                            asAttrValue(cond.key, cond.from),
+                            asAttrValue(cond.key, cond.to),
+                        ];
+                        return `${name} BETWEEN ${from} AND ${to}`;
+                    }
+                    else if (isExistenceCondition(cond)) {
+                        const name = asAttrName(cond.key);
+                        return cond.exists ? `attribute_exists(${name})` : `attribute_not_exists(${name})`;
+                    }
+                    else if (isStringCondition(cond)) {
+                        const [name, value] = [asAttrName(cond.key), asAttrValue(cond.key, cond.value)];
+                        return `${cond.operator}(${name}, ${value})`;
+                    }
+                }
+            };
+            scan.filterExpression(asFilterExpression(filter));
+            if (Object.keys(expAttrNames).length)
+                scan.expressionAttributeNames(expAttrNames);
+            if (Object.keys(expAttrValues).length)
+                scan.expressionAttributeValues(expAttrValues);
+        }
+        return scan.buildRequest();
+    }
+}
+exports.DynamoScanService = DynamoScanService;
+//# sourceMappingURL=dynamo-scan-service.js.map

package/dist/cores/dynamo/dynamo-scan-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamo-scan-service.js","sourceRoot":"","sources":["../../../src/cores/dynamo/dynamo-scan-service.ts"],"names":[],"mappings":"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"}