lemon-core 4.1.15 → 4.2.1

package/dist/cores/storage/proxy-storage-service.js

@@ -1,13 +1,4 @@
 "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());
-    });
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UniqueFieldManager = exports.ModelUtil = exports.TypedStorageService = exports.ProxyStorageService = exports.GeneralModelFilter = exports.GeneralKeyMaker = void 0;
 /**
@@ -32,6 +23,8 @@ const NS = engine_1.$U.NS('PSTR', 'blue'); // NAMESPACE TO BE PRINTED.
  * - use ':' as delimiter to join [ns, type, id]
  */
 class GeneralKeyMaker {
+    NS;
+    DELIMITER;
     constructor(ns = '', delimiter = ':') {
         this.NS = ns;
         this.DELIMITER = delimiter;
@@ -53,6 +46,7 @@ exports.GeneralKeyMaker = GeneralKeyMaker;
  */
 // eslint-disable-next-line prettier/prettier
 class GeneralModelFilter {
+    FIELDS;
     /**
      * default constructor
      */
@@ -216,6 +210,12 @@ exports.GeneralModelFilter = GeneralModelFilter;
  */
 // eslint-disable-next-line prettier/prettier
 class ProxyStorageService {
+    static AUTO_SEQUENCE = 1000000;
+    static TYPE_SEQUENCE = 'sequence';
+    idName;
+    service;
+    storage;
+    filters;
     /**
      * create proxed storage-service.
      *
@@ -226,66 +226,6 @@ class ProxyStorageService {
      * @param idName    (optional) internal partition-key (default as '_id')
      */
     constructor(service, storage, fields, filters, idName) {
-        /**
-         * say hello()
-         */
-        this.hello = () => `proxy-storage-service:${this.storage.hello()}`;
-        /**
-         * read by _id
-         */
-        this.read = (_id) => this.storage.read(_id);
-        /**
-         * read multiple models.
-         */
-        this.mread = (ids) => this.storage.mread(ids);
-        /**
-         * read or create by _id
-         */
-        this.readOrCreate = (_id, model) => this.storage.readOrCreate(_id, model);
-        /**
-         * save by _id
-         */
-        this.save = (_id, model) => this.storage.save(_id, model);
-        /**
-         * update by _id
-         */
-        this.update = (_id, model, incrementals) => this.storage.update(_id, model, incrementals);
-        /**
-         * update multiple models.
-         */
-        this.mupdate = (list) => this.storage.mupdate(list);
-        /**
-         * increment by _id
-         */
-        this.increment = (_id, model, $update) => this.storage.increment(_id, model, $update);
-        /**
-         * delete by _id
-         */
-        this.delete = (_id) => this.storage.delete(_id);
-        /**
-         * get key-id by type+id
-         */
-        this.asKey = (type, id) => {
-            if (typeof this.service.asKey == 'function') {
-                return this.service.asKey(type, `${id}`);
-            }
-            const $key = this.service.asKey$(type, `${id}`);
-            return $key[this.idName];
-        };
-        /**
-         * timer to generate the current-time (msec)
-         */
-        this.$timer = null;
-        this.setTimer = (timer) => {
-            const previous = this.$timer;
-            this.$timer = timer;
-            return previous;
-        };
-        this.getTime = () => {
-            if (this.$timer)
-                return this.$timer();
-            return new Date().getTime();
-        };
         this.idName = idName === undefined ? '_id' : `${idName || ''}`;
         this.service = service;
         this.storage =
@@ -305,6 +245,52 @@ class ProxyStorageService {
         const res = new ProxyStorageService(service, storage, fields, filters, idName);
         return res;
     }
+    /**
+     * say hello()
+     */
+    hello = () => `proxy-storage-service:${this.storage.hello()}`;
+    /**
+     * read by _id
+     */
+    read = (_id) => this.storage.read(_id);
+    /**
+     * read multiple models.
+     */
+    mread = (ids) => this.storage.mread(ids);
+    /**
+     * read or create by _id
+     */
+    readOrCreate = (_id, model) => this.storage.readOrCreate(_id, model);
+    /**
+     * save by _id
+     */
+    save = (_id, model) => this.storage.save(_id, model);
+    /**
+     * update by _id
+     */
+    update = (_id, model, incrementals) => this.storage.update(_id, model, incrementals);
+    /**
+     * update multiple models.
+     */
+    mupdate = (list) => this.storage.mupdate(list);
+    /**
+     * increment by _id
+     */
+    increment = (_id, model, $update) => this.storage.increment(_id, model, $update);
+    /**
+     * delete by _id
+     */
+    delete = (_id) => this.storage.delete(_id);
+    /**
+     * get key-id by type+id
+     */
+    asKey = (type, id) => {
+        if (typeof this.service.asKey == 'function') {
+            return this.service.asKey(type, `${id}`);
+        }
+        const $key = this.service.asKey$(type, `${id}`);
+        return $key[this.idName];
+    };
     /**
      * get next auto-sequence number.
      *
@@ -312,43 +298,53 @@ class ProxyStorageService {
      * @param nextInit  (optional) initial next value if not exist.
      * @param nextStep  (optional) the incremental step to get next. (default 1)
      */
-    nextSeq(type, nextInit, nextStep = 1) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const errScope = `nextSeq(${type !== null && type !== void 0 ? type : ''})`;
-            (0, engine_1._log)(NS, `${errScope}...`);
-            if (typeof nextInit === 'number' && nextInit < 0)
-                throw new Error(`@nextInit[${nextInit}] is invalid - ${errScope}`);
-            if (typeof nextStep !== 'number' || nextStep < 0)
-                throw new Error(`@stepNext[${nextStep}] is invalid - ${errScope}`);
-            const { createdAt, updatedAt } = this.asTime();
-            const _id = this.asKey(ProxyStorageService.TYPE_SEQUENCE, `${type}`);
-            const _next = () => __awaiter(this, void 0, void 0, function* () {
-                // it will create new row if not exists. (like upset)
-                //TODO - improve the initial `next` if not exits.
-                const res = yield this.storage.increment(_id, { next: nextStep }, { updatedAt });
-                if (res.next == 1) {
-                    const $key = this.service.asKey$(ProxyStorageService.TYPE_SEQUENCE, `${type}`);
-                    nextInit = nextInit === undefined || nextInit === null ? ProxyStorageService.AUTO_SEQUENCE : nextInit;
-                    const $upd = { next: nextInit };
-                    const $inc = Object.assign(Object.assign({}, $key), { createdAt, updatedAt });
-                    return this.storage.increment(_id, $upd, $inc); //* increment w/ update-set
-                }
-                return res;
-            });
-            const res = yield _next();
-            return res.next;
-        });
+    async nextSeq(type, nextInit, nextStep = 1) {
+        const errScope = `nextSeq(${type ?? ''})`;
+        (0, engine_1._log)(NS, `${errScope}...`);
+        if (typeof nextInit === 'number' && nextInit < 0)
+            throw new Error(`@nextInit[${nextInit}] is invalid - ${errScope}`);
+        if (typeof nextStep !== 'number' || nextStep < 0)
+            throw new Error(`@stepNext[${nextStep}] is invalid - ${errScope}`);
+        const { createdAt, updatedAt } = this.asTime();
+        const _id = this.asKey(ProxyStorageService.TYPE_SEQUENCE, `${type}`);
+        const _next = async () => {
+            // it will create new row if not exists. (like upset)
+            //TODO - improve the initial `next` if not exits.
+            const res = await this.storage.increment(_id, { next: nextStep }, { updatedAt });
+            if (res.next == 1) {
+                const $key = this.service.asKey$(ProxyStorageService.TYPE_SEQUENCE, `${type}`);
+                nextInit = nextInit === undefined || nextInit === null ? ProxyStorageService.AUTO_SEQUENCE : nextInit;
+                const $upd = { next: nextInit };
+                const $inc = { ...$key, createdAt, updatedAt };
+                return this.storage.increment(_id, $upd, $inc); //* increment w/ update-set
+            }
+            return res;
+        };
+        const res = await _next();
+        return res.next;
     }
     /**
      * get uuid by type.
      * @param type
      */
-    nextUuid(type) {
-        return __awaiter(this, void 0, void 0, function* () {
-            (0, engine_1._log)(NS, `nextUuid(${type})..`);
-            return engine_1.$U.uuid();
-        });
+    async nextUuid(type) {
+        (0, engine_1._log)(NS, `nextUuid(${type})..`);
+        return engine_1.$U.uuid();
     }
+    /**
+     * timer to generate the current-time (msec)
+     */
+    $timer = null;
+    setTimer = (timer) => {
+        const previous = this.$timer;
+        this.$timer = timer;
+        return previous;
+    };
+    getTime = () => {
+        if (this.$timer)
+            return this.$timer();
+        return new Date().getTime();
+    };
     /**
      * get time-stamp as now.
      */
@@ -363,12 +359,10 @@ class ProxyStorageService {
      * delete sequence-key.
      * @param type      type of seqeunce.
      */
-    clearSeq(type) {
-        return __awaiter(this, void 0, void 0, function* () {
-            (0, engine_1._log)(NS, `nextSeq(${type})..`);
-            const _id = this.asKey(ProxyStorageService.TYPE_SEQUENCE, `${type}`);
-            yield this.storage.delete(_id);
-        });
+    async clearSeq(type) {
+        (0, engine_1._log)(NS, `nextSeq(${type})..`);
+        const _id = this.asKey(ProxyStorageService.TYPE_SEQUENCE, `${type}`);
+        await this.storage.delete(_id);
     }
     /**
      * read model by key + id with optional auto creation.
@@ -377,22 +371,20 @@ class ProxyStorageService {
      * @param id        node-id
      * @param $create   (optional) initial model if not exist. (or throw 404 error)
      */
-    doRead(type, id, $create) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const $key = this.service.asKey$(type, id);
-            const _id = this.asKey(type, id);
-            const model = yield this.storage.read(_id).catch((e) => {
-                if (`${e.message}`.startsWith('404 NOT FOUND') && $create) {
-                    const { createdAt, updatedAt } = this.asTime();
-                    return this.storage.update(_id, Object.assign(Object.assign(Object.assign({}, $create), $key), { createdAt, updatedAt, deletedAt: 0 }));
-                }
-                throw e;
-            });
-            //* make sure it has `_id`
-            model[this.idName] = _id;
-            const res = this.filters.afterRead(model);
-            return res;
+    async doRead(type, id, $create) {
+        const $key = this.service.asKey$(type, id);
+        const _id = this.asKey(type, id);
+        const model = await this.storage.read(_id).catch((e) => {
+            if (`${e.message}`.startsWith('404 NOT FOUND') && $create) {
+                const { createdAt, updatedAt } = this.asTime();
+                return this.storage.update(_id, { ...$create, ...$key, createdAt, updatedAt, deletedAt: 0 });
+            }
+            throw e;
         });
+        //* make sure it has `_id`
+        model[this.idName] = _id;
+        const res = this.filters.afterRead(model);
+        return res;
     }
     /**
      * recursively remove undefined values from object.
@@ -433,37 +425,31 @@ class ProxyStorageService {
      * @param context       (optional) next-context for reporting
      * @returns notify message-id (or error)
      */
-    reportBatchError(operation, total, failed, context) {
-        var _a;
-        return __awaiter(this, void 0, void 0, function* () {
-            const totalFailed = (_a = failed === null || failed === void 0 ? void 0 : failed.length) !== null && _a !== void 0 ? _a : 0;
-            if (totalFailed <= 0)
-                return;
-            const successCount = total - totalFailed;
-            const error = new Error(`Batch ${operation} failed: ${totalFailed}/${total} items`);
-            const data = {
-                dt: engine_1.$U.dt(),
-                total_count: total,
-                failed_count: totalFailed,
-                success_count: successCount,
-                failed_items: failed && Array.isArray(failed)
-                    ? failed
-                        .filter((item) => item != null)
-                        .map((item) => {
-                        var _a, _b;
-                        return ({
-                            id: (_b = (_a = item === null || item === void 0 ? void 0 : item.id) !== null && _a !== void 0 ? _a : item === null || item === void 0 ? void 0 : item._id) !== null && _b !== void 0 ? _b : 'unknown',
-                            error: (item === null || item === void 0 ? void 0 : item.error) ? `${item.error}`.substring(0, 100) : 'Unknown error',
-                        });
-                    })
-                    : failed,
-                context,
-            };
-            // report error
-            return (0, engine_1.doReportError)(error, context, null, data).catch(e => {
-                (0, engine_1._err)(NS, `! failed to report ${operation} error via SNS:`, e);
-                return `ERR: ${(0, test_helper_1.GETERR)(e)}`;
-            });
+    async reportBatchError(operation, total, failed, context) {
+        const totalFailed = failed?.length ?? 0;
+        if (totalFailed <= 0)
+            return;
+        const successCount = total - totalFailed;
+        const error = new Error(`Batch ${operation} failed: ${totalFailed}/${total} items`);
+        const data = {
+            dt: engine_1.$U.dt(),
+            total_count: total,
+            failed_count: totalFailed,
+            success_count: successCount,
+            failed_items: failed && Array.isArray(failed)
+                ? failed
+                    .filter((item) => item != null)
+                    .map((item) => ({
+                    id: item?.id ?? item?._id ?? 'unknown',
+                    error: item?.error ? `${item.error}`.substring(0, 100) : 'Unknown error',
+                }))
+                : failed,
+            context,
+        };
+        // report error
+        return (0, engine_1.doReportError)(error, context, null, data).catch(e => {
+            (0, engine_1._err)(NS, `! failed to report ${operation} error via SNS:`, e);
+            return `ERR: ${(0, test_helper_1.GETERR)(e)}`;
         });
     }
     /**
@@ -473,30 +459,27 @@ class ProxyStorageService {
      * @param ids       node-ids
      * @param options   (optional) options for batch read error reporting
      */
-    doReadMulti(type, ids, options) {
-        var _a, _b;
-        return __awaiter(this, void 0, void 0, function* () {
-            const throwable = (_a = options === null || options === void 0 ? void 0 : options.throwable) !== null && _a !== void 0 ? _a : true;
-            const total = (_b = ids === null || ids === void 0 ? void 0 : ids.length) !== null && _b !== void 0 ? _b : 0;
-            const result = { success: [], failed: [], total };
-            if (!ids || total === 0)
-                return result;
-            const _ids = ids.map(id => this.asKey(type, id));
-            const res = yield this.storage.mread(_ids);
-            result.success = (res.success || []).map((model) => {
-                const res = this.filters.afterRead(model);
-                return res;
-            });
-            result.failed = (res.failed || []).map((model) => {
-                const res = this.filters.afterRead(model);
-                return res;
-            });
-            //* send Slack notification if there are failed items
-            if (result.failed.length > 0 && throwable) {
-                yield this.reportBatchError('read', total, result.failed, options === null || options === void 0 ? void 0 : options.context);
-            }
+    async doReadMulti(type, ids, options) {
+        const throwable = options?.throwable ?? true;
+        const total = ids?.length ?? 0;
+        const result = { success: [], failed: [], total };
+        if (!ids || total === 0)
             return result;
+        const _ids = ids.map(id => this.asKey(type, id));
+        const res = await this.storage.mread(_ids);
+        result.success = (res.success || []).map((model) => {
+            const res = this.filters.afterRead(model);
+            return res;
         });
+        result.failed = (res.failed || []).map((model) => {
+            const res = this.filters.afterRead(model);
+            return res;
+        });
+        //* send Slack notification if there are failed items
+        if (result.failed.length > 0 && throwable) {
+            await this.reportBatchError('read', total, result.failed, options?.context);
+        }
+        return result;
     }
     /**
      * delete model by id.
@@ -505,18 +488,16 @@ class ProxyStorageService {
      * @param id        node-id
      * @param destroy   flag to destroy (real delete)
      */
-    doDelete(type, id, destroy = true) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const _id = this.asKey(type, id);
-            if (destroy === undefined || destroy === true)
-                return this.storage.delete(_id);
-            const { createdAt, updatedAt, deletedAt } = this.asTime();
-            const $up = { updatedAt, deletedAt };
-            const $org = yield this.read(_id); //* it will make 404 if not found.
-            if (!$org.createdAt)
-                $up.createdAt = createdAt;
-            return this.update(_id, $up);
-        });
+    async doDelete(type, id, destroy = true) {
+        const _id = this.asKey(type, id);
+        if (destroy === undefined || destroy === true)
+            return this.storage.delete(_id);
+        const { createdAt, updatedAt, deletedAt } = this.asTime();
+        const $up = { updatedAt, deletedAt };
+        const $org = await this.read(_id); //* it will make 404 if not found.
+        if (!$org.createdAt)
+            $up.createdAt = createdAt;
+        return this.update(_id, $up);
     }
     /**
      * update model (or it will create automatically)
@@ -527,21 +508,18 @@ class ProxyStorageService {
      * @param incrementals (optional) fields to increment
      * @param options   (optional) options for update
      */
-    doUpdate(type, id, node, incrementals, options) {
-        var _a;
-        return __awaiter(this, void 0, void 0, function* () {
-            const onlyValid = (_a = options === null || options === void 0 ? void 0 : options.onlyValid) !== null && _a !== void 0 ? _a : true;
-            const $inc = this.removeUndefined(Object.assign({}, incrementals), onlyValid); //* make copy & clean.
-            const _id = this.asKey(type, id);
-            // const $key = this.service.asKey$(type, id);
-            const node2 = this.filters.beforeUpdate(Object.assign(Object.assign({}, node), { [this.idName]: _id }), $inc);
-            delete node2['_id'];
-            const { updatedAt } = this.asTime();
-            // remove undefined values before saving to DynamoDB
-            const cleaned = this.removeUndefined(Object.assign(Object.assign({}, node2), { updatedAt }), onlyValid);
-            const model = yield this.update(_id, cleaned, $inc);
-            return this.filters.afterUpdate(model);
-        });
+    async doUpdate(type, id, node, incrementals, options) {
+        const onlyValid = options?.onlyValid ?? true;
+        const $inc = this.removeUndefined({ ...incrementals }, onlyValid); //* make copy & clean.
+        const _id = this.asKey(type, id);
+        // const $key = this.service.asKey$(type, id);
+        const node2 = this.filters.beforeUpdate({ ...node, [this.idName]: _id }, $inc);
+        delete node2['_id'];
+        const { updatedAt } = this.asTime();
+        // remove undefined values before saving to DynamoDB
+        const cleaned = this.removeUndefined({ ...node2, updatedAt }, onlyValid);
+        const model = await this.update(_id, cleaned, $inc);
+        return this.filters.afterUpdate(model);
     }
     /**
      * update multiple models (or it will create automatically)
@@ -550,42 +528,39 @@ class ProxyStorageService {
      * @param list      list of models (should include id)
      * @param options   (optional) options for batch update
      */
-    doUpdateMulti(type, list, options) {
-        var _a, _b, _c;
-        return __awaiter(this, void 0, void 0, function* () {
-            const onlyValid = (_a = options === null || options === void 0 ? void 0 : options.onlyValid) !== null && _a !== void 0 ? _a : true;
-            const throwable = (_b = options === null || options === void 0 ? void 0 : options.throwable) !== null && _b !== void 0 ? _b : true;
-            const total = (_c = list === null || list === void 0 ? void 0 : list.length) !== null && _c !== void 0 ? _c : 0;
-            const result = { success: [], failed: [], total };
-            if (!list || total === 0)
-                return result;
-            const { updatedAt } = this.asTime();
-            const items = list.map((node) => {
-                const id = node.id;
-                if (!id)
-                    throw new Error('@id is required!');
-                const _id = this.asKey(type, id);
-                const node2 = this.filters.beforeUpdate(Object.assign(Object.assign({}, node), { [this.idName]: _id }), undefined);
-                delete node2['_id'];
-                // remove undefined values before saving to DynamoDB
-                const cleaned = this.removeUndefined(Object.assign(Object.assign({}, node2), { [this.idName]: _id, updatedAt }), onlyValid);
-                return cleaned;
-            });
-            const res = yield this.storage.mupdate(items);
-            result.success = (res.success || []).map((model) => {
-                const res = this.filters.afterUpdate(model);
-                return res;
-            });
-            result.failed = (res.failed || []).map((model) => {
-                const res = this.filters.afterUpdate(model);
-                return res;
-            });
-            //* send Slack notification if there are failed items
-            if (result.failed.length > 0 && throwable) {
-                yield this.reportBatchError('update', total, result.failed, options === null || options === void 0 ? void 0 : options.context);
-            }
+    async doUpdateMulti(type, list, options) {
+        const onlyValid = options?.onlyValid ?? true;
+        const throwable = options?.throwable ?? true;
+        const total = list?.length ?? 0;
+        const result = { success: [], failed: [], total };
+        if (!list || total === 0)
             return result;
+        const { updatedAt } = this.asTime();
+        const items = list.map((node) => {
+            const id = node.id;
+            if (!id)
+                throw new Error('@id is required!');
+            const _id = this.asKey(type, id);
+            const node2 = this.filters.beforeUpdate({ ...node, [this.idName]: _id }, undefined);
+            delete node2['_id'];
+            // remove undefined values before saving to DynamoDB
+            const cleaned = this.removeUndefined({ ...node2, [this.idName]: _id, updatedAt }, onlyValid);
+            return cleaned;
         });
+        const res = await this.storage.mupdate(items);
+        result.success = (res.success || []).map((model) => {
+            const res = this.filters.afterUpdate(model);
+            return res;
+        });
+        result.failed = (res.failed || []).map((model) => {
+            const res = this.filters.afterUpdate(model);
+            return res;
+        });
+        //* send Slack notification if there are failed items
+        if (result.failed.length > 0 && throwable) {
+            await this.reportBatchError('update', total, result.failed, options?.context);
+        }
+        return result;
     }
     /**
      * update model (or it will create automatically)
@@ -593,13 +568,11 @@ class ProxyStorageService {
      * @param type      model-type
      * @param id        node-id
      */
-    doIncrement(type, id, $inc, $up) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const _id = this.asKey(type, id);
-            const { updatedAt } = this.asTime();
-            const model = yield this.increment(_id, Object.assign({}, $inc), Object.assign(Object.assign({}, $up), { updatedAt }));
-            return this.filters.afterUpdate(model);
-        });
+    async doIncrement(type, id, $inc, $up) {
+        const _id = this.asKey(type, id);
+        const { updatedAt } = this.asTime();
+        const model = await this.increment(_id, { ...$inc }, { ...$up, updatedAt });
+        return this.filters.afterUpdate(model);
     }
     /**
      * save model by checking origin node.
@@ -612,44 +585,41 @@ class ProxyStorageService {
      * @param $create   (optional) initial creation model if not found.
      * @param options   (optional) options for save
      */
-    doSave(type, id, node, $create, options) {
-        var _a;
-        return __awaiter(this, void 0, void 0, function* () {
-            const onlyValid = (_a = options === null || options === void 0 ? void 0 : options.onlyValid) !== null && _a !== void 0 ? _a : true;
-            //* read origin model w/o error.
-            const $org = (yield this.doRead(type, id, null).catch(e => {
-                if (`${e.message}`.startsWith('404 NOT FOUND'))
-                    return null; // mark null to create later.
-                throw e;
-            }));
-            //* if `$create` is undefined, create it with default $key.
-            const _id = this.asKey(type, id);
-            const model = Object.assign({}, node); // copy from param.
-            model[this.idName] = _id; //* make sure the internal id
-            //* apply filter.
-            const $ups = this.filters.beforeSave(model, $org); //* `$org` should be null if create.
-            (0, engine_1._log)(NS, `> ${type}[${id}].update =`, engine_1.$U.json($ups));
-            //* if null, then nothing to update.
-            if (!$ups) {
-                const res = { [this.idName]: _id };
-                return res;
-            }
-            //* determine of create or update.
-            const { createdAt, updatedAt } = this.asTime();
-            if ($org) {
-                const $save = Object.assign(Object.assign({}, $ups), { updatedAt });
-                const res = yield this.doUpdate(type, id, $save, undefined, { onlyValid });
-                return this.filters.afterSave(res, $org); //* `$org` should be valid if update.
-            }
-            else {
-                const $key = this.service.asKey$(type, id);
-                const $save = Object.assign(Object.assign(Object.assign(Object.assign({}, $ups), $create), $key), { createdAt, updatedAt: createdAt, deletedAt: 0 });
-                // remove undefined values before saving to DynamoDB
-                const cleaned = this.removeUndefined($save, onlyValid);
-                const res = yield this.storage.save(_id, cleaned);
-                return this.filters.afterSave(res, null); //* `$org` should be null if create.
-            }
-        });
+    async doSave(type, id, node, $create, options) {
+        const onlyValid = options?.onlyValid ?? true;
+        //* read origin model w/o error.
+        const $org = (await this.doRead(type, id, null).catch(e => {
+            if (`${e.message}`.startsWith('404 NOT FOUND'))
+                return null; // mark null to create later.
+            throw e;
+        }));
+        //* if `$create` is undefined, create it with default $key.
+        const _id = this.asKey(type, id);
+        const model = { ...node }; // copy from param.
+        model[this.idName] = _id; //* make sure the internal id
+        //* apply filter.
+        const $ups = this.filters.beforeSave(model, $org); //* `$org` should be null if create.
+        (0, engine_1._log)(NS, `> ${type}[${id}].update =`, engine_1.$U.json($ups));
+        //* if null, then nothing to update.
+        if (!$ups) {
+            const res = { [this.idName]: _id };
+            return res;
+        }
+        //* determine of create or update.
+        const { createdAt, updatedAt } = this.asTime();
+        if ($org) {
+            const $save = { ...$ups, updatedAt };
+            const res = await this.doUpdate(type, id, $save, undefined, { onlyValid });
+            return this.filters.afterSave(res, $org); //* `$org` should be valid if update.
+        }
+        else {
+            const $key = this.service.asKey$(type, id);
+            const $save = { ...$ups, ...$create, ...$key, createdAt, updatedAt: createdAt, deletedAt: 0 };
+            // remove undefined values before saving to DynamoDB
+            const cleaned = this.removeUndefined($save, onlyValid);
+            const res = await this.storage.save(_id, cleaned);
+            return this.filters.afterSave(res, null); //* `$org` should be null if create.
+        }
     }
     /**
      * lock data-entry by type+id w/ limited time tick
@@ -662,56 +632,52 @@ class ProxyStorageService {
      * @param tick      tick count to wait.
      * @param interval  timeout interval per each tick (in msec, default 1000 = 1sec)
      */
-    doLock(type, id, tick, interval) {
-        return __awaiter(this, void 0, void 0, function* () {
-            tick = engine_1.$U.N(tick, 30);
-            interval = engine_1.$U.N(interval, 1000);
-            if (typeof tick != 'number' || tick < 0)
-                throw new Error(`@tick (${tick}) is not valid!`);
-            if (typeof interval != 'number' || interval < 1)
-                throw new Error(`@interval (${interval}) is not valid!`);
-            const _id = this.asKey(type, id);
-            //* WARN! DO NOT MAKE ANY MODEL CREATION IN HERE.
-            // const $org = await this.storage.readOrCreate(_id, { lock: 0, ...$key } as any);
-            // _log(NS, `> $org[${type}/${id}].lock =`, $org.lock);
-            const thiz = this;
-            //* wait some time.
-            const wait = (timeout) => __awaiter(this, void 0, void 0, function* () {
-                return new Promise(resolve => {
-                    setTimeout(() => {
-                        resolve(timeout);
-                    }, timeout);
-                });
-            });
-            const incLock = (_id, lock) => __awaiter(this, void 0, void 0, function* () {
-                const $up = {};
-                const $in = { lock };
-                return thiz.storage.update(_id, $up, $in).then($t2 => {
-                    return engine_1.$U.N($t2.lock, 1);
-                });
+    async doLock(type, id, tick, interval) {
+        tick = engine_1.$U.N(tick, 30);
+        interval = engine_1.$U.N(interval, 1000);
+        if (typeof tick != 'number' || tick < 0)
+            throw new Error(`@tick (${tick}) is not valid!`);
+        if (typeof interval != 'number' || interval < 1)
+            throw new Error(`@interval (${interval}) is not valid!`);
+        const _id = this.asKey(type, id);
+        //* WARN! DO NOT MAKE ANY MODEL CREATION IN HERE.
+        // const $org = await this.storage.readOrCreate(_id, { lock: 0, ...$key } as any);
+        // _log(NS, `> $org[${type}/${id}].lock =`, $org.lock);
+        const thiz = this;
+        //* wait some time.
+        const wait = async (timeout) => new Promise(resolve => {
+            setTimeout(() => {
+                resolve(timeout);
+            }, timeout);
+        });
+        const incLock = async (_id, lock) => {
+            const $up = {};
+            const $in = { lock };
+            return thiz.storage.update(_id, $up, $in).then($t2 => {
+                return engine_1.$U.N($t2.lock, 1);
             });
-            //* recursive to wait lock()
-            const waitLock = (_id, ttl, int) => __awaiter(this, void 0, void 0, function* () {
-                //* try to check the current value.....
-                const lock = yield incLock(_id, 0).then(n => {
-                    if (n > 1)
-                        return n;
-                    //* then, try to increment the lock
-                    return incLock(_id, ttl > 0 ? 1 : 0);
-                });
-                (0, engine_1._log)(NS, `! waitLock(${_id}, ${ttl}). lock =`, lock);
-                if (lock == 1 || lock == 0) {
-                    return true;
-                }
-                else if (ttl > 0 && lock > 1) {
-                    return wait(int).then(() => waitLock(_id, ttl - 1, int));
-                }
-                else {
-                    throw new Error(`400 TIMEOUT - model[${_id}].lock = ${lock}`);
-                }
+        };
+        //* recursive to wait lock()
+        const waitLock = async (_id, ttl, int) => {
+            //* try to check the current value.....
+            const lock = await incLock(_id, 0).then(n => {
+                if (n > 1)
+                    return n;
+                //* then, try to increment the lock
+                return incLock(_id, ttl > 0 ? 1 : 0);
             });
-            return waitLock(_id, tick, interval);
-        });
+            (0, engine_1._log)(NS, `! waitLock(${_id}, ${ttl}). lock =`, lock);
+            if (lock == 1 || lock == 0) {
+                return true;
+            }
+            else if (ttl > 0 && lock > 1) {
+                return wait(int).then(() => waitLock(_id, ttl - 1, int));
+            }
+            else {
+                throw new Error(`400 TIMEOUT - model[${_id}].lock = ${lock}`);
+            }
+        };
+        return waitLock(_id, tick, interval);
     }
     /**
      * release lock by resetting lock = 0.
@@ -719,15 +685,13 @@ class ProxyStorageService {
      * @param type  model-type
      * @param id    model-id
      */
-    doRelease(type, id) {
-        return __awaiter(this, void 0, void 0, function* () {
-            (0, engine_1._log)(NS, `doRelease(${type}, ${id})... `);
-            const _id = this.asKey(type, id);
-            const $up = { lock: 0 };
-            const node = yield this.storage.update(_id, $up).catch(() => ({ lock: 0 }));
-            const lock = engine_1.$U.N(node.lock, 1);
-            return lock === 0 ? true : false;
-        });
+    async doRelease(type, id) {
+        (0, engine_1._log)(NS, `doRelease(${type}, ${id})... `);
+        const _id = this.asKey(type, id);
+        const $up = { lock: 0 };
+        const node = await this.storage.update(_id, $up).catch(() => ({ lock: 0 }));
+        const lock = engine_1.$U.N(node.lock, 1);
+        return lock === 0 ? true : false;
     }
     /**
      * create storage-service w/ fields list.
@@ -771,178 +735,178 @@ class ProxyStorageService {
     }
 }
 exports.ProxyStorageService = ProxyStorageService;
-ProxyStorageService.AUTO_SEQUENCE = 1000000;
-ProxyStorageService.TYPE_SEQUENCE = 'sequence';
 /**
  * class: `TypedStorageService`
  * - wrap id with type + id.
  */
 // eslint-disable-next-line prettier/prettier
 class TypedStorageService {
+    type;
+    storage;
     constructor(service, type) {
-        /**
-         * show self service name
-         */
-        this.hello = () => `typed-storage-service:${this.type}/${this.storage.hello()}`;
-        /**
-         * get next auto-sequence id in number like `1000003`.
-         *
-         * @param step (optional) next step value (must be >0) (`0` means getting the current value)
-         */
-        this.nextId = (step) => {
-            return this.storage.nextSeq(this.type, undefined, step);
-        };
-        /**
-         * get uuid like `d01764cd-9ef2-41e2-9e88-68e79555c979`
-         */
-        this.nextUuid = () => this.storage.nextUuid(this.type);
-        /**
-         * read model by key + id with optional auto creation.
-         * - throws '404 NOT FOUND' if not found.
-         *
-         * @param id        node-id
-         */
-        this.read = (id) => this.storage.doRead(this.type, `${id || ''}`);
-        /**
-         * read multiple models (batch).
-         *
-         * @param ids       list of node-id
-         * @param options   (optional) options for batch read error reporting
-         */
-        this.mread = (ids, options) => this.storage.doReadMulti(this.type, ids, options);
-        /**
-         * read model by key + id with optional auto creation.
-         *
-         * @param id        node-id
-         * @param model     initial model if not exist. (or throw 404 error)
-         */
-        this.readOrCreate = (id, model) => this.storage.doRead(this.type, `${id || ''}`, model);
-        /**
-         * update model (or it will create automatically)
-         *
-         * @param id        node-id
-         * @param model     model to update
-         * @param incrementals (optional) fields to increment.
-         * @param options   (optional) options for update
-         */
-        this.update = (id, model, incrementals, options) => this.storage.doUpdate(this.type, `${id || ''}`, model, incrementals, options);
-        /**
-         * update multiple models in batch (or it will create automatically)
-         * - automatically removes undefined values (DynamoDB does not support undefined)
-         *
-         * @param list      list of models (should include id)
-         * @param options   (optional) options for batch update error reporting
-         */
-        this.mupdate = (list, options) => this.storage.doUpdateMulti(this.type, list, options);
-        /**
-         * insert model w/ auto generated id
-         *
-         * @param model     model to insert
-         */
-        this.insert = (node) => __awaiter(this, void 0, void 0, function* () {
-            return this.nextId().then(_ => {
-                const id = `${_}`;
-                (0, engine_1._log)(NS, `> next-id[${this.type}] =`, id);
-                return this.readOrCreate(id, Object.assign(Object.assign({}, node), { id }));
-            });
-        });
-        /**
-         * update model (or it will create automatically)
-         *
-         * ```ts
-         * //before: { count: 1 };
-         * const res = await storage.increment(1, { count: 2 }, { total: 2 });
-         * //after : { count: 3, total: 2 }
-         * ```
-         *
-         * @param id            node-id
-         * @param $increments   model only with numbers
-         */
-        this.increment = (id, $increments, $update) => this.storage.doIncrement(this.type, `${id || ''}`, $increments, $update);
-        /**
-         * delete model by id.
-         *
-         * @param id        node-id
-         * @param destroy   flag to destroy (real delete)
-         */
-        this.delete = (id, destroy) => this.storage.doDelete(this.type, `${id || ''}`, destroy === undefined ? true : destroy);
-        /**
-         * save model by checking origin node.
-         * - use `doSave()` rather than `doUpdate()` for both create & update.
-         * - if `$create` is null, throw 404 error it if not found.
-         *
-         * @param id        node-id
-         * @param node      node to save (or update)
-         * @param $create   (optional) initial creation model.
-         */
-        this.save = (id, model, $create) => this.storage.doSave(this.type, `${id || ''}`, model, $create);
-        /**
-         * lock data-entry by type+id w/ limited time tick
-         * - WARN! must release lock by `release(id)`
-         *
-         * `total-waited-time = tick * interval (msec)`
-         *
-         * **[UPDATES]**
-         * 1. read original node (or, throw 404 error)
-         * 2. use internal lock.
-         *
-         * @param id        model-id to lock
-         * @param tick      tick count to wait.
-         * @param interval  timeout interval per each tick (in msec, default 1000 = 1sec)
-         */
-        this.lock = (id, tick, interval) => this.storage
-            .doRead(this.type, `${id || ''}`, null)
-            .then(node => this.storage.doLock(this.type, node.id, tick, interval));
-        /**
-         * release lock by resetting lock = 0.
-         * @param id    model-id
-         */
-        this.release = (id) => this.storage.doRelease(this.type, `${id || ''}`);
-        /**
-         * using `lock()`, guard func with auto lock & release.
-         *
-         * ```ts
-         * const res = await storage.guard(async ()=>{
-         *  return 'abc';
-         * });
-         * // res === 'abc'
-         * ```
-         */
-        this.guard = (id, handler, tick, interval) => __awaiter(this, void 0, void 0, function* () {
-            let locked = false;
-            return this.lock(id, tick, interval)
-                .then((_) => {
-                locked = _;
-                try {
-                    return handler();
-                }
-                catch (e) {
-                    return Promise.reject(e);
-                }
-            })
-                .then((_) => {
-                if (locked)
-                    return this.release(id).then(() => _);
-                return _;
-            })
-                .catch((e) => {
-                if (locked)
-                    return this.release(id).then(() => Promise.reject(e));
-                // throw e;
-                return Promise.reject(e);
-            });
-        });
-        /**
-         * make `UniqueFieldManager` for field.
-         */
-        this.makeUniqueFieldManager = (field) => new UniqueFieldManager(this, field);
-        /**
-         * make `GeneralAPIController` for REST API w/ supporting basic CRUD
-         */
-        this.makeGeneralAPIController = (search, uniqueField) => new general_api_controller_1.GeneralAPIController(this.type, this, search, uniqueField);
         this.storage = service;
         this.type = type;
     }
+    /**
+     * show self service name
+     */
+    hello = () => `typed-storage-service:${this.type}/${this.storage.hello()}`;
+    /**
+     * get next auto-sequence id in number like `1000003`.
+     *
+     * @param step (optional) next step value (must be >0) (`0` means getting the current value)
+     */
+    nextId = (step) => {
+        return this.storage.nextSeq(this.type, undefined, step);
+    };
+    /**
+     * get uuid like `d01764cd-9ef2-41e2-9e88-68e79555c979`
+     */
+    nextUuid = () => this.storage.nextUuid(this.type);
+    /**
+     * read model by key + id with optional auto creation.
+     * - throws '404 NOT FOUND' if not found.
+     *
+     * @param id        node-id
+     */
+    read = (id) => this.storage.doRead(this.type, `${id || ''}`);
+    /**
+     * read multiple models (batch).
+     *
+     * @param ids       list of node-id
+     * @param options   (optional) options for batch read error reporting
+     */
+    mread = (ids, options) => this.storage.doReadMulti(this.type, ids, options);
+    /**
+     * read model by key + id with optional auto creation.
+     *
+     * @param id        node-id
+     * @param model     initial model if not exist. (or throw 404 error)
+     */
+    readOrCreate = (id, model) => this.storage.doRead(this.type, `${id || ''}`, model);
+    /**
+     * update model (or it will create automatically)
+     *
+     * @param id        node-id
+     * @param model     model to update
+     * @param incrementals (optional) fields to increment.
+     * @param options   (optional) options for update
+     */
+    update = (id, model, incrementals, options) => this.storage.doUpdate(this.type, `${id || ''}`, model, incrementals, options);
+    /**
+     * update multiple models in batch (or it will create automatically)
+     * - automatically removes undefined values (DynamoDB does not support undefined)
+     *
+     * @param list      list of models (should include id)
+     * @param options   (optional) options for batch update error reporting
+     */
+    mupdate = (list, options) => this.storage.doUpdateMulti(this.type, list, options);
+    /**
+     * insert model w/ auto generated id
+     *
+     * @param model     model to insert
+     */
+    insert = async (node) => {
+        return this.nextId().then(_ => {
+            const id = `${_}`;
+            (0, engine_1._log)(NS, `> next-id[${this.type}] =`, id);
+            return this.readOrCreate(id, { ...node, id });
+        });
+    };
+    /**
+     * update model (or it will create automatically)
+     *
+     * ```ts
+     * //before: { count: 1 };
+     * const res = await storage.increment(1, { count: 2 }, { total: 2 });
+     * //after : { count: 3, total: 2 }
+     * ```
+     *
+     * @param id            node-id
+     * @param $increments   model only with numbers
+     */
+    increment = (id, $increments, $update) => this.storage.doIncrement(this.type, `${id || ''}`, $increments, $update);
+    /**
+     * delete model by id.
+     *
+     * @param id        node-id
+     * @param destroy   flag to destroy (real delete)
+     */
+    delete = (id, destroy) => this.storage.doDelete(this.type, `${id || ''}`, destroy === undefined ? true : destroy);
+    /**
+     * save model by checking origin node.
+     * - use `doSave()` rather than `doUpdate()` for both create & update.
+     * - if `$create` is null, throw 404 error it if not found.
+     *
+     * @param id        node-id
+     * @param node      node to save (or update)
+     * @param $create   (optional) initial creation model.
+     */
+    save = (id, model, $create) => this.storage.doSave(this.type, `${id || ''}`, model, $create);
+    /**
+     * lock data-entry by type+id w/ limited time tick
+     * - WARN! must release lock by `release(id)`
+     *
+     * `total-waited-time = tick * interval (msec)`
+     *
+     * **[UPDATES]**
+     * 1. read original node (or, throw 404 error)
+     * 2. use internal lock.
+     *
+     * @param id        model-id to lock
+     * @param tick      tick count to wait.
+     * @param interval  timeout interval per each tick (in msec, default 1000 = 1sec)
+     */
+    lock = (id, tick, interval) => this.storage
+        .doRead(this.type, `${id || ''}`, null)
+        .then(node => this.storage.doLock(this.type, node.id, tick, interval));
+    /**
+     * release lock by resetting lock = 0.
+     * @param id    model-id
+     */
+    release = (id) => this.storage.doRelease(this.type, `${id || ''}`);
+    /**
+     * using `lock()`, guard func with auto lock & release.
+     *
+     * ```ts
+     * const res = await storage.guard(async ()=>{
+     *  return 'abc';
+     * });
+     * // res === 'abc'
+     * ```
+     */
+    guard = async (id, handler, tick, interval) => {
+        let locked = false;
+        return this.lock(id, tick, interval)
+            .then((_) => {
+            locked = _;
+            try {
+                return handler();
+            }
+            catch (e) {
+                return Promise.reject(e);
+            }
+        })
+            .then((_) => {
+            if (locked)
+                return this.release(id).then(() => _);
+            return _;
+        })
+            .catch((e) => {
+            if (locked)
+                return this.release(id).then(() => Promise.reject(e));
+            // throw e;
+            return Promise.reject(e);
+        });
+    };
+    /**
+     * make `UniqueFieldManager` for field.
+     */
+    makeUniqueFieldManager = (field) => new UniqueFieldManager(this, field);
+    /**
+     * make `GeneralAPIController` for REST API w/ supporting basic CRUD
+     */
+    makeGeneralAPIController = (search, uniqueField) => new general_api_controller_1.GeneralAPIController(this.type, this, search, uniqueField);
 }
 exports.TypedStorageService = TypedStorageService;
 /**
@@ -950,43 +914,43 @@ exports.TypedStorageService = TypedStorageService;
  * - Helper functions for model.
  */
 class ModelUtil {
+    static selfRead = (self, key, defValue) => {
+        const value = self[key];
+        return value === undefined ? defValue : value;
+    };
+    static selfPop = (self, key, defValue) => {
+        const value = ModelUtil.selfRead(self, key, defValue);
+        delete self[key];
+        return value;
+    };
+    /**
+     * attach `.pop()` method to object.
+     *
+     * ```js
+     * const data = CoreModelUtil.buildPop({'a':1});
+     * assert( 1 === data.pop('a) );
+     * const final = data.pop();
+     * assert( final == data );
+     */
+    static buildPop = (thiz, popName = 'pop') => {
+        if (!thiz)
+            throw new Error('@thiz (object) is required!');
+        if (typeof thiz[popName] != 'undefined')
+            throw new Error(`.[${popName}] is duplicated!`);
+        thiz[popName] = function (key, defValue) {
+            if (!key) {
+                //* clear pop() if key is null.
+                delete this[popName];
+                return this;
+            }
+            else {
+                return ModelUtil.selfPop(this, key, defValue);
+            }
+        };
+        return thiz;
+    };
 }
 exports.ModelUtil = ModelUtil;
-ModelUtil.selfRead = (self, key, defValue) => {
-    const value = self[key];
-    return value === undefined ? defValue : value;
-};
-ModelUtil.selfPop = (self, key, defValue) => {
-    const value = ModelUtil.selfRead(self, key, defValue);
-    delete self[key];
-    return value;
-};
-/**
- * attach `.pop()` method to object.
- *
- * ```js
- * const data = CoreModelUtil.buildPop({'a':1});
- * assert( 1 === data.pop('a) );
- * const final = data.pop();
- * assert( final == data );
- */
-ModelUtil.buildPop = (thiz, popName = 'pop') => {
-    if (!thiz)
-        throw new Error('@thiz (object) is required!');
-    if (typeof thiz[popName] != 'undefined')
-        throw new Error(`.[${popName}] is duplicated!`);
-    thiz[popName] = function (key, defValue) {
-        if (!key) {
-            //* clear pop() if key is null.
-            delete this[popName];
-            return this;
-        }
-        else {
-            return ModelUtil.selfPop(this, key, defValue);
-        }
-    };
-    return thiz;
-};
 /**
  * class: `UniqueFieldManager`
  * - support `.{field}` is unique in typed-storage-service.
@@ -996,12 +960,15 @@ ModelUtil.buildPop = (thiz, popName = 'pop') => {
  * - set `.meta` as origin id.
  */
 class UniqueFieldManager {
+    type;
+    field;
+    storage;
     constructor(storage, field = 'name') {
-        this.hello = () => `unique-field-manager:${this.type}/${this.field}:${this.storage.hello()}`;
         this.type = storage.type;
         this.storage = storage;
         this.field = field;
     }
+    hello = () => `unique-field-manager:${this.type}/${this.field}:${this.storage.hello()}`;
     /**
      * validate value format
      * - just check empty string.
@@ -1026,51 +993,49 @@ class UniqueFieldManager {
      * @param value unique value in same type group.
      * @param $creates (optional) create-set if not found.
      */
-    findOrCreate(value, $creates) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!value || typeof value != 'string')
-                throw new Error(`@${this.field} (string) is required!`);
-            if (!this.validate(value))
-                throw new Error(`@${this.field} (${value || ''}) is not valid!`);
-            const ID = this.asLookupId(value);
-            const field = `${this.field}`;
-            if (!$creates) {
-                // STEP.1 read the origin name map
-                const $map = yield this.storage.read(ID).catch(test_helper_1.NUL404);
-                const rid = $map && $map.meta;
-                if (!rid)
-                    throw new Error(`404 NOT FOUND - ${this.type}:${field}/${value}`);
-                // STEP.2 read the target node by stereo key.
-                const model = yield this.storage.read(rid);
-                return model;
-            }
-            else {
-                // STEP.0 validate if value is same
-                const $any = $creates || {};
-                if ($any[field] !== undefined && $any[field] !== value)
-                    throw new Error(`@${this.field} (${value}) is not same as (${$any[field]})!`);
-                // STEP.1 read the origin value map
-                const $new = { stereo: '#', meta: `${$creates.id || ''}`, [field]: value };
-                const $map = yield this.storage.readOrCreate(ID, $new);
-                const rid = ($map && $map.meta) || $creates.id;
-                //* check if already saved, and id is differ.
-                if ($any['id'] && $any['id'] != rid)
-                    throw new Error(`@id (${rid}) is not same as (${$any['id']})`);
-                // STEP.2 read the target node or create.
-                const $temp = Object.assign(Object.assign({}, $creates), { [field]: value });
-                const model = rid ? yield this.storage.readOrCreate(rid, $temp) : yield this.storage.insert($temp);
-                model[field] = value;
-                // STEP.3 update lookup key.
-                const newId = `${rid || model.id || ''}`;
-                if ($map.meta != newId) {
-                    const $upt = { meta: newId };
-                    yield this.storage.update(ID, $upt);
-                    $map.meta = newId;
-                }
-                //* returns.
-                return model;
+    async findOrCreate(value, $creates) {
+        if (!value || typeof value != 'string')
+            throw new Error(`@${this.field} (string) is required!`);
+        if (!this.validate(value))
+            throw new Error(`@${this.field} (${value || ''}) is not valid!`);
+        const ID = this.asLookupId(value);
+        const field = `${this.field}`;
+        if (!$creates) {
+            // STEP.1 read the origin name map
+            const $map = await this.storage.read(ID).catch(test_helper_1.NUL404);
+            const rid = $map && $map.meta;
+            if (!rid)
+                throw new Error(`404 NOT FOUND - ${this.type}:${field}/${value}`);
+            // STEP.2 read the target node by stereo key.
+            const model = await this.storage.read(rid);
+            return model;
+        }
+        else {
+            // STEP.0 validate if value is same
+            const $any = $creates || {};
+            if ($any[field] !== undefined && $any[field] !== value)
+                throw new Error(`@${this.field} (${value}) is not same as (${$any[field]})!`);
+            // STEP.1 read the origin value map
+            const $new = { stereo: '#', meta: `${$creates.id || ''}`, [field]: value };
+            const $map = await this.storage.readOrCreate(ID, $new);
+            const rid = ($map && $map.meta) || $creates.id;
+            //* check if already saved, and id is differ.
+            if ($any['id'] && $any['id'] != rid)
+                throw new Error(`@id (${rid}) is not same as (${$any['id']})`);
+            // STEP.2 read the target node or create.
+            const $temp = { ...$creates, [field]: value };
+            const model = rid ? await this.storage.readOrCreate(rid, $temp) : await this.storage.insert($temp);
+            model[field] = value;
+            // STEP.3 update lookup key.
+            const newId = `${rid || model.id || ''}`;
+            if ($map.meta != newId) {
+                const $upt = { meta: newId };
+                await this.storage.update(ID, $upt);
+                $map.meta = newId;
             }
-        });
+            //* returns.
+            return model;
+        }
     }
     /**
      * update lookup table (or create)
@@ -1078,26 +1043,24 @@ class UniqueFieldManager {
      * @param model target model
      * @param value (optional) new value of model.
      */
-    updateLookup(model, value) {
-        return __awaiter(this, void 0, void 0, function* () {
-            value = value || model[this.field];
-            if (!this.validate(value))
-                throw new Error(`@${this.field} (${value || ''}) is not valid!`);
-            const ID = this.asLookupId(value);
-            const field = `${this.field}`;
-            // STEP.0 validate if value has changed
-            const $any = model;
-            if ($any[field] && $any[field] !== value)
-                throw new Error(`@${this.field} (${value}) is not same as (${$any[field]})!`);
-            // STEP.1 check if value is duplicated.
-            const $org = yield this.storage.read(ID).catch(test_helper_1.NUL404);
-            const rid = $org && $org.meta;
-            if ($org && rid != model.id)
-                throw new Error(`400 DUPLICATED NAME - ${field}[${value}] is duplicated to ${this.type}[${rid}]`);
-            // STEP.2 save the name mapping.
-            const $new = Object.assign(Object.assign({}, model), { [field]: value, id: model.id });
-            return yield this.findOrCreate(value, $new);
-        });
+    async updateLookup(model, value) {
+        value = value || model[this.field];
+        if (!this.validate(value))
+            throw new Error(`@${this.field} (${value || ''}) is not valid!`);
+        const ID = this.asLookupId(value);
+        const field = `${this.field}`;
+        // STEP.0 validate if value has changed
+        const $any = model;
+        if ($any[field] && $any[field] !== value)
+            throw new Error(`@${this.field} (${value}) is not same as (${$any[field]})!`);
+        // STEP.1 check if value is duplicated.
+        const $org = await this.storage.read(ID).catch(test_helper_1.NUL404);
+        const rid = $org && $org.meta;
+        if ($org && rid != model.id)
+            throw new Error(`400 DUPLICATED NAME - ${field}[${value}] is duplicated to ${this.type}[${rid}]`);
+        // STEP.2 save the name mapping.
+        const $new = { ...model, [field]: value, id: model.id };
+        return await this.findOrCreate(value, $new);
     }
 }
 exports.UniqueFieldManager = UniqueFieldManager;