lemon-core 3.0.0 → 3.1.1

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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"}

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

@@ -0,0 +1,192 @@
+import { GeneralItem, Incrementable } from './../core-types';
+import AWS from 'aws-sdk';
+export declare type KEY_TYPE = 'number' | 'string';
+export interface DynamoOption {
+    tableName: string;
+    idName: string;
+    sortName?: string;
+    idType?: KEY_TYPE;
+    sortType?: KEY_TYPE;
+}
+/**
+ * type `Updatable`: parameter for updateItem
+ *  - update field
+ *  - 'setIndex': array of [index, value] - replace elements in list field
+ *  - 'removeIndex': array of indices - remove elements from list field
+ */
+export interface Updatable {
+    [key: string]: GeneralItem['key'] | {
+        setIndex: [number, string | number][];
+    } | {
+        removeIndex: number[];
+    };
+}
+/**
+ * class: `DynamoService`
+ * - basic CRUD service for AWS DynamoDB.
+ */
+export declare class DynamoService<T extends GeneralItem> {
+    protected options: DynamoOption;
+    constructor(options: DynamoOption);
+    /**
+     * say hello of identity.
+     */
+    hello: () => string;
+    /**
+     * simple instance maker.
+     * @param region    (default as `ap-northeast-2`)
+     */
+    static instance(region?: string): {
+        dynamo: AWS.DynamoDB;
+        dynamostr: AWS.DynamoDBStreams;
+        dynamodoc: AWS.DynamoDB.DocumentClient;
+    };
+    /**
+     * export to test..
+     */
+    static normalize: (data: any) => any;
+    /**
+     * prepare `CreateTable` payload.
+     *
+     * @param ReadCapacityUnits
+     * @param WriteCapacityUnits
+     * @param StreamEnabled
+     */
+    prepareCreateTable(ReadCapacityUnits?: number, WriteCapacityUnits?: number, StreamEnabled?: boolean): {
+        TableName: string;
+        KeySchema: {
+            AttributeName: string;
+            KeyType: string;
+        }[];
+        AttributeDefinitions: {
+            AttributeName: string;
+            AttributeType: any;
+        }[];
+        ProvisionedThroughput: {
+            ReadCapacityUnits: number;
+            WriteCapacityUnits: number;
+        };
+        StreamSpecification: {
+            StreamEnabled: boolean;
+            StreamViewType: string;
+        };
+    };
+    /**
+     * prepare `DeleteTable` payload.
+     */
+    prepareDeleteTable(): {
+        TableName: string;
+    };
+    /**
+     * prepare `SaveItem` payload.
+     *
+     * @param id            partition-key
+     * @param item
+     */
+    prepareSaveItem(id: string, item: T): {
+        TableName: string;
+        Item: any;
+    };
+    /**
+     * prepare `Key` by id + sort key.
+     *
+     * @param id            partition-key
+     * @param sort          sort-key
+     */
+    prepareItemKey(id: string, sort: any): {
+        TableName: string;
+        Key: {
+            [x: string]: string;
+        };
+    };
+    /**
+     * prepare `UpdateItem` payload.
+     *
+     * @param id            partition-key
+     * @param sort          sort-key
+     * @param $update       update set
+     * @param $increment    increment set.
+     */
+    prepareUpdateItem(id: string, sort: any, $update: Updatable, $increment?: Incrementable): any;
+    /**
+     * create-table
+     *
+     * @param ReadCapacityUnits
+     * @param WriteCapacityUnits
+     */
+    createTable(ReadCapacityUnits?: number, WriteCapacityUnits?: number): Promise<import("aws-sdk/lib/request").PromiseResult<AWS.DynamoDB.CreateTableOutput, AWS.AWSError>>;
+    /**
+     * delete-table
+     *
+     */
+    deleteTable(): Promise<import("aws-sdk/lib/request").PromiseResult<AWS.DynamoDB.DeleteTableOutput, AWS.AWSError>>;
+    /**
+     * read-item
+     * - read whole data of item.
+     *
+     * @param id
+     * @param sort
+     */
+    readItem(id: string, sort?: string | number): Promise<T>;
+    /**
+     * save-item
+     * - save whole data with param (use update if partial save)
+     *
+     * **WARN** overwrited if exists.
+     *
+     * @param id
+     * @param item
+     */
+    saveItem(id: string, item: T): Promise<T>;
+    /**
+     * delete-item
+     * - destroy whole data of item.
+     *
+     * @param id
+     * @param sort
+     */
+    deleteItem(id: string, sort?: string | number): Promise<T>;
+    /**
+     * update-item (or increment-item)
+     * - update or create if not exists.
+     *
+     * @param id
+     * @param sort
+     * @param updates
+     * @param increments
+     */
+    updateItem(id: string, sort: string | number, updates: Updatable, increments?: Incrementable): Promise<T>;
+}
+/** ****************************************************************************************************************
+ *  Dummy Dynamo Service
+ ** ****************************************************************************************************************/
+/**
+ * class: `DummyDynamoService`
+ * - service in-memory dummy data
+ */
+export declare class DummyDynamoService<T extends GeneralItem> extends DynamoService<T> {
+    constructor(dataFile: string, options: DynamoOption);
+    private buffer;
+    load(data: T[]): void;
+    /**
+     * say hello()
+     */
+    hello: () => string;
+    /**
+     * ONLY FOR DUMMY
+     * - send list of data.
+     *
+     * @param page  page number starts from 1
+     * @param limit limit of count.
+     */
+    listItems(page?: number, limit?: number): Promise<{
+        page: number;
+        limit: number;
+        total: number;
+        list: T[];
+    }>;
+    readItem(id: string, sort?: string | number): Promise<T>;
+    saveItem(id: string, item: T): Promise<T>;
+    deleteItem(id: string, sort?: string | number): Promise<T>;
+    updateItem(id: string, sort: string | number, updates: T, increments?: Incrementable): Promise<T>;
+}