lemon-core 2.2.20 → 3.1.0

package/dist/cores/elastic6-service.js

@@ -19,47 +19,127 @@ exports.DummyElastic6Service = exports.$ERROR = exports.Elastic6Service = void 0
  *
  * @author      Steve Jung <steve@lemoncloud.io>
  * @date        2019-11-20 initial version via backbone
+ * @date        2022-02-21 optimized error handler, and search.
+ * @date        2022-02-22 optimized w/ elastic client (elasticsearch-js)
  *
  * @copyright (C) 2019 LemonCloud Co Ltd. - All Rights Reserved.
  */
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 const engine_1 = require("../engine/");
-const NS = engine_1.$U.NS('ES6', 'green'); // NAMESPACE TO BE PRINTED.
-const elasticsearch_1 = __importDefault(require("elasticsearch"));
+const elasticsearch_1 = __importDefault(require("@elastic/elasticsearch"));
 const hangul_service_1 = __importDefault(require("./hangul-service"));
 const tools_1 = require("../tools");
-//! create(or get) instance.
-const instance = (endpoint) => {
-    return Elastic6Service.instance(endpoint);
-};
+const test_helper_1 = require("../common/test-helper");
+const NS = engine_1.$U.NS('ES6', 'green'); // NAMESPACE TO BE PRINTED.
+/**
+ * convert to string.
+ */
+const _S = (v, def = '') => typeof v === 'string' ? v : v === undefined || v === null ? def : typeof v === 'object' ? engine_1.$U.json(v) : `${v}`;
 /**
  * class: `Elastic6Service`
  * - basic CRUD service for Elastic Search 6
  */
 class Elastic6Service {
+    /**
+     * default constuctor w/ options.
+     * @param options { endpoint, indexName } is required.
+     */
     constructor(options) {
         /**
          * say hello of identity.
          */
-        this.hello = () => `elastic6-service:${this.options.indexName}`;
-        engine_1._inf(NS, `Elastic6Service(${options.indexName}/${options.idName})...`);
+        this.hello = () => `elastic6-service:${this.options.indexName}:${this.version}`;
+        (0, engine_1._inf)(NS, `Elastic6Service(${options.indexName}/${options.idName})...`);
         if (!options.endpoint)
             throw new Error('.endpoint (URL) is required');
         if (!options.indexName)
             throw new Error('.indexName (string) is required');
         // default option values: docType='_doc', idName='$id'
-        this.options = Object.assign({ docType: '_doc', idName: '$id' }, options);
+        const { client } = Elastic6Service.instance(options.endpoint);
+        this._options = Object.assign({ docType: '_doc', idName: '$id', version: '6.8' }, options);
+        this._client = client;
     }
     /**
      * simple instance maker.
+     *
+     * ```js
+     * const { client } = Elastic6Service.instance(endpoint);
+     * ```
+     *
      * @param endpoint  service-url
      * @param version   Elasticsearch version (default: '6.8')
      * @see https://www.elastic.co/guide/en/elasticsearch/client/javascript-api/16.x/configuration.html
      */
     static instance(endpoint) {
-        const client = new elasticsearch_1.default.Client({ host: endpoint });
+        const client = new elasticsearch_1.default.Client({
+            node: endpoint,
+            ssl: {
+                ca: process.env.elasticsearch_certificate,
+                rejectUnauthorized: false,
+            },
+        });
         return { client };
     }
+    /**
+     * get the client instance.
+     */
+    get client() {
+        return this._client;
+    }
+    /**
+     * get the current options.
+     */
+    get options() {
+        return this._options;
+    }
+    get version() {
+        const ver = engine_1.$U.F(this.options.version, 6.8);
+        return ver;
+    }
+    /**
+     * list of index
+     */
+    listIndices() {
+        return __awaiter(this, void 0, void 0, function* () {
+            (0, engine_1._log)(NS, `- listIndices()`);
+            //! call create index..
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.cat.indices({ format: 'json' });
+            (0, engine_1._log)(NS, `> indices =`, engine_1.$U.json(res));
+            // eslint-disable-next-line prettier/prettier
+            const list0 = Array.isArray(res) ? res : (res === null || res === void 0 ? void 0 : res.body) && Array.isArray(res === null || res === void 0 ? void 0 : res.body) ? res === null || res === void 0 ? void 0 : res.body : null;
+            if (!list0)
+                throw new Error(`@result<${typeof res}> is invalid - ${engine_1.$U.json(res)}!`);
+            // {"docs.count": "84", "docs.deleted": "7", "health": "green", "index": "dev-eureka-alarms-v1", "pri": "5", "pri.store.size": "234.3kb", "rep": "1", "status": "open", "store.size": "468.6kb", "uuid": "xPp-Sx86SgmhAWxT3cGAFw"}
+            const list = list0.map(N => ({
+                pri: engine_1.$U.N(N['pri']),
+                rep: engine_1.$U.N(N['rep']),
+                docsCount: engine_1.$U.N(N['docs.count']),
+                docsDeleted: engine_1.$U.N(N['docs.deleted']),
+                health: _S(N['health']),
+                index: _S(N['index']),
+                status: _S(N['status']),
+                uuid: _S(N['uuid']),
+                priStoreSize: _S(N['pri.store.size']),
+                storeSize: _S(N['store.size']),
+            }));
+            //! returns.
+            return { list };
+        });
+    }
+    /**
+     * find the index by name
+     */
+    findIndex(indexName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            indexName = indexName || this.options.indexName;
+            (0, engine_1._log)(NS, `- findIndex(${indexName})`);
+            const { list } = yield this.listIndices();
+            const found = list.findIndex(N => N.index == indexName);
+            return found >= 0 ? list[found] : null;
+        });
+    }
     /**
      * create index by name
      *
@@ -67,31 +147,36 @@ class Elastic6Service {
      */
     createIndex(settings) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName, docType, idName, timeSeries } = this.options;
-            settings = settings || Elastic6Service.prepareSettings(docType, idName, timeSeries);
+            const { indexName, docType, idName, timeSeries, version } = this.options;
+            settings = settings || Elastic6Service.prepareSettings({ docType, idName, timeSeries, version });
             if (!indexName)
                 new Error('@index is required!');
-            engine_1._log(NS, `- createIndex(${indexName})`);
-            settings = settings || {};
+            (0, engine_1._log)(NS, `- createIndex(${indexName})`);
             //! prepare payload
             const payload = Object.assign({ settings: {
                     number_of_shards: 5,
                     number_of_replicas: 1,
                 } }, settings);
-            engine_1._log(NS, `> settings[${indexName}] = `, engine_1.$U.json(payload));
+            (0, engine_1._log)(NS, `> settings[${indexName}] = `, engine_1.$U.json(payload));
             //! call create index..
-            const { client } = instance(endpoint);
-            const res = yield client.indices.create({ index: indexName, body: payload }).catch(exports.$ERROR.handler('create', e => {
-                engine_1._err(NS, `> create[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
-                if (`${e.message}`.startsWith('400 resource_already_exists_exception'))
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.indices.create({ index: indexName, body: payload }).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('create', e => {
+                const msg = (0, test_helper_1.GETERR)(e);
+                if (msg.startsWith('400 RESOURCE ALREADY EXISTS'))
                     throw new Error(`400 IN USE - index:${indexName}`);
                 throw e;
             }));
-            engine_1._log(NS, `> create[${indexName}] =`, engine_1.$U.json(res));
-            engine_1._log(NS, `> create[${indexName}].acknowledged =`, res.acknowledged); // true
-            engine_1._log(NS, `> create[${indexName}].index =`, res.index); // index
-            engine_1._log(NS, `> create[${indexName}].shards_acknowledged =`, res.shards_acknowledged); // true
-            return res;
+            // if (res) throw res;
+            (0, engine_1._log)(NS, `> create[${indexName}] =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            //! build result.
+            return {
+                status: res.statusCode,
+                index: indexName,
+                acknowledged: res.body.shards_acknowledged,
+            };
         });
     }
     /**
@@ -99,21 +184,28 @@ class Elastic6Service {
      */
     destroyIndex() {
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName } = this.options;
+            const { indexName } = this.options;
             if (!indexName)
                 new Error('@index is required!');
-            engine_1._log(NS, `- destroyIndex(${indexName})`);
+            (0, engine_1._log)(NS, `- destroyIndex(${indexName})`);
             //! call create index..
-            const { client } = instance(endpoint);
-            const res = yield client.indices.delete({ index: indexName }).catch(exports.$ERROR.handler('destroy', e => {
-                engine_1._err(NS, `> destory[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
-                if (`${e.message}`.startsWith('404 index_not_found_exception'))
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.indices.delete({ index: indexName }).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('destroy', e => {
+                const msg = (0, test_helper_1.GETERR)(e);
+                if (msg.startsWith('404 INDEX NOT FOUND'))
                     throw new Error(`404 NOT FOUND - index:${indexName}`);
                 throw e;
             }));
-            engine_1._log(NS, `> destroy[${indexName}] =`, engine_1.$U.json(res));
-            engine_1._log(NS, `> destroy[${indexName}].acknowledged =`, res.acknowledged); // true
-            return res;
+            // if (res) throw res;
+            (0, engine_1._log)(NS, `> destroy[${indexName}] =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            return {
+                status: res.statusCode,
+                index: indexName,
+                acknowledged: res.body.acknowledged,
+            };
         });
     }
     /**
@@ -121,18 +213,23 @@ class Elastic6Service {
      */
     refreshIndex() {
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName } = this.options;
+            const { indexName } = this.options;
             if (!indexName)
                 throw new Error('.indexName is required!');
-            engine_1._log(NS, `- refreshIndex(${indexName})`);
+            (0, engine_1._log)(NS, `- refreshIndex(${indexName})`);
             //! call refresh index..
-            const { client } = instance(endpoint);
-            const res = yield client.indices.refresh({ index: indexName }).catch(exports.$ERROR.handler('refresh', e => {
-                engine_1._err(NS, `> refresh[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.indices.refresh({ index: indexName }).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('refresh', e => {
+                const msg = (0, test_helper_1.GETERR)(e);
+                if (msg.startsWith('404 INDEX NOT FOUND'))
+                    throw new Error(`404 NOT FOUND - index:${indexName}`);
                 throw e;
             }));
-            engine_1._log(NS, `> refresh[${indexName}] =`, engine_1.$U.json(res));
-            return res;
+            (0, engine_1._log)(NS, `> refresh[${indexName}] =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            return res.body;
         });
     }
     /**
@@ -140,18 +237,23 @@ class Elastic6Service {
      */
     flushIndex() {
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName } = this.options;
+            const { indexName } = this.options;
             if (!indexName)
                 throw new Error('.indexName is required!');
-            engine_1._log(NS, `- flushIndex(${indexName})`);
+            (0, engine_1._log)(NS, `- flushIndex(${indexName})`);
             //! call flush index..
-            const { client } = instance(endpoint);
-            const res = yield client.indices.flush({ index: indexName }).catch(exports.$ERROR.handler('flush', e => {
-                engine_1._err(NS, `> flush[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.indices.flush({ index: indexName }).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('flush', e => {
+                const msg = (0, test_helper_1.GETERR)(e);
+                if (msg.startsWith('404 INDEX NOT FOUND'))
+                    throw new Error(`404 NOT FOUND - index:${indexName}`);
                 throw e;
             }));
-            engine_1._log(NS, `> flush[${indexName}] =`, engine_1.$U.json(res));
-            return res;
+            (0, engine_1._log)(NS, `> flush[${indexName}] =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            return res.body;
         });
     }
     /**
@@ -159,25 +261,28 @@ class Elastic6Service {
      */
     describe() {
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName } = this.options;
+            const { indexName } = this.options;
             //! call create index..
-            const { client } = instance(endpoint);
-            engine_1._log(NS, `- describe(${indexName})`);
+            (0, engine_1._log)(NS, `- describe(${indexName})`);
             //! read settings.
-            const res = yield client.indices.getSettings({ index: indexName }).catch(exports.$ERROR.handler('describe', e => {
-                engine_1._err(NS, `> describe[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
-                if (`${e.message}`.startsWith('404 index_not_found_exception'))
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.indices.getSettings({ index: indexName }).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('describe', e => {
+                const msg = (0, test_helper_1.GETERR)(e);
+                if (msg.startsWith('404 INDEX NOT FOUND'))
                     throw new Error(`404 NOT FOUND - index:${indexName}`);
                 throw e;
             }));
-            engine_1._log(NS, `> settings[${indexName}] =`, engine_1.$U.json(res));
-            const settings = (res[indexName] && res[indexName].settings) || {};
-            engine_1._log(NS, `> number_of_shards =`, settings.index && settings.index.number_of_shards); // 5
-            engine_1._log(NS, `> number_of_replicas =`, settings.index && settings.index.number_of_replicas); // 1
+            (0, engine_1._log)(NS, `> settings[${indexName}] =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            const settings = (res.body && res.body[indexName] && res.body[indexName].settings) || {};
+            (0, engine_1._log)(NS, `> number_of_shards =`, settings.index && settings.index.number_of_shards); // 5
+            (0, engine_1._log)(NS, `> number_of_replicas =`, settings.index && settings.index.number_of_replicas); // 1
             //! read mappings.
             const res2 = yield client.indices.getMapping({ index: indexName });
-            engine_1._log(NS, `> mappings[${indexName}] =`, engine_1.$U.json(res2));
-            const mappings = (res2[indexName] && res2[indexName].mappings) || {};
+            (0, engine_1._log)(NS, `> mappings[${indexName}] =`, engine_1.$U.json(res2));
+            const mappings = (res2.body && res2.body[indexName] && res2.body[indexName].mappings) || {};
             //! returns
             return { settings, mappings };
         });
@@ -190,43 +295,38 @@ class Elastic6Service {
      * @param type  document type (default: doc-type given at construction time)
      */
     saveItem(id, item, type) {
+        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName, docType, idName } = this.options;
-            const { client } = instance(endpoint);
-            engine_1._log(NS, `- saveItem(${id})`);
+            const { indexName, docType, idName } = this.options;
+            (0, engine_1._log)(NS, `- saveItem(${id})`);
+            // const { client } = instance(endpoint);
+            const client = this.client;
             // prepare item body and autocomplete fields
             const body = Object.assign(Object.assign({}, item), { [idName]: id });
-            this.prepareAutocompleteFields(body);
+            const body2 = this.popullateAutocompleteFields(body);
             type = `${type || docType}`;
-            const params = {
-                index: indexName,
-                type,
-                id,
-                body,
-            };
-            if (idName == '_id')
-                delete params.body[idName]; // `_id` is reserved in ES6.
-            engine_1._log(NS, `> params[${id}] =`, engine_1.$U.json(params));
+            const params = { index: indexName, type, id, body: body2 };
+            if (idName === '_id')
+                delete params.body[idName]; //WARN! `_id` is reserved in ES6.
+            (0, engine_1._log)(NS, `> params[${id}] =`, engine_1.$U.json(params));
             //NOTE - use npm `elasticsearch#13.2.0` for avoiding error.
-            const res = yield client.create(params).catch(exports.$ERROR.handler('save', e => {
-                engine_1._log(NS, `> save[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
-                if (`${e.message}`.startsWith('409 version_conflict_engine_exception')) {
-                    //! try to update document...
-                    delete body[idName]; // do set id while update
-                    const params = { index: indexName, type, id, body: { doc: body } };
-                    return client.update(params);
+            const res = yield client.create(params).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('save', e => {
+                const msg = (0, test_helper_1.GETERR)(e);
+                //! try to update document..
+                if (msg.startsWith('409 VERSION CONFLICT ENGINE')) {
+                    delete body2[idName]; // do set id while update
+                    // return this.updateItem(id, body2);
+                    const param2 = { index: indexName, type, id, body: { doc: body2 } };
+                    return client.update(param2);
                 }
                 throw e;
             }));
-            // {"_index":"test-v3","_type":"_doc","_id":"aaa","_version":1,"result":"created","_shards":{"total":2,"successful":2,"failed":0},"_seq_no":0,"_primary_term":1}
-            // {"_index":"test-v3","_type":"_doc","_id":"aaa","_version":1,"result":"noop","_shards":{"total":0,"successful":0,"failed":0}}
-            engine_1._log(NS, `> create[${id}].res =`, engine_1.$U.json(res));
-            engine_1._log(NS, `> create[${id}].result =`, res.result); // 'created','noop','updated'
-            engine_1._log(NS, `> create[${id}]._version =`, res._version); // 1
-            // return res;
-            const _version = engine_1.$U.N(res._version, 0);
-            const _id = res._id;
-            const res2 = Object.assign(Object.assign({}, item), { _id, _version });
+            (0, engine_1._log)(NS, `> create[${id}].res =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            const _version = engine_1.$U.N((_a = res.body) === null || _a === void 0 ? void 0 : _a._version, 0);
+            const _id = (_b = res.body) === null || _b === void 0 ? void 0 : _b._id;
+            const res2 = Object.assign(Object.assign({}, body), { _id, _version });
             return res2;
         });
     }
@@ -236,28 +336,30 @@ class Elastic6Service {
      * @param item  item to push
      */
     pushItem(item, type) {
+        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName, docType } = this.options;
-            const { client } = instance(endpoint);
+            const { indexName, docType } = this.options;
             const id = '';
             type = `${type || docType}`;
             const body = Object.assign({}, item);
-            this.prepareAutocompleteFields(body);
-            engine_1._log(NS, `- pushItem(${id})`);
-            const params = { index: indexName, type, body };
-            engine_1._log(NS, `> params[${id}] =`, engine_1.$U.json(params));
+            const body2 = this.popullateAutocompleteFields(body);
+            (0, engine_1._log)(NS, `- pushItem(${id})`);
+            const params = { index: indexName, type, body: body2 };
+            (0, engine_1._log)(NS, `> params[${id}] =`, engine_1.$U.json(params));
             //NOTE - use npm `elasticsearch#13.2.0` for avoiding error.
-            const res = yield client.index(params).catch(exports.$ERROR.handler('index', e => {
-                engine_1._err(NS, `> index[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.index(params).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('index', e => {
+                (0, engine_1._err)(NS, `> index[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
                 throw e;
             }));
             // {"_index":"test-v3","_type":"_doc","_id":"rTeHiW4BPb_liACrA9qa","_version":1,"result":"created","_shards":{"total":2,"successful":2,"failed":0},"_seq_no":2,"_primary_term":1}
-            engine_1._log(NS, `> create[${id}].res =`, engine_1.$U.json(res));
-            engine_1._log(NS, `> create[${id}].result =`, res.result); // 'created','noop','updated'
-            engine_1._log(NS, `> create[${id}]._version =`, res._version); // 1
-            const _id = res._id;
-            const _version = res._version;
-            const res2 = Object.assign(Object.assign({}, item), { _id, _version });
+            (0, engine_1._log)(NS, `> create[${id}].res =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            const _id = (_a = res.body) === null || _a === void 0 ? void 0 : _a._id;
+            const _version = (_b = res.body) === null || _b === void 0 ? void 0 : _b._version;
+            const res2 = Object.assign(Object.assign({}, body), { _id, _version });
             return res2;
         });
     }
@@ -268,34 +370,35 @@ class Elastic6Service {
      * @param views     projections
      */
     readItem(id, views) {
+        var _a, _b;
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName, docType } = this.options;
-            const { client } = instance(endpoint);
+            const { indexName, docType } = this.options;
             const type = `${docType}`;
-            engine_1._log(NS, `- readItem(${id})`);
+            (0, engine_1._log)(NS, `- readItem(${id})`);
             const params = { index: indexName, type, id };
             if (views) {
                 const fields = [];
-                const is_array = Array.isArray(views);
-                engine_1.$_.each(views, (v, k) => {
-                    fields.push(is_array ? v : k);
+                const keys = Array.isArray(views) ? views : Object.keys(views);
+                keys.forEach((k) => {
+                    fields.push(k);
                 });
                 params._source = fields;
             }
-            engine_1._log(NS, `> params[${id}] =`, engine_1.$U.json(params));
-            const res = yield client.get(params).catch(exports.$ERROR.handler('read', e => {
-                engine_1._err(NS, `> read[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
-                if (`${e.message}`.startsWith('404 Not Found'))
+            (0, engine_1._log)(NS, `> params[${id}] =`, engine_1.$U.json(params));
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.get(params).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('read', e => {
+                const msg = (0, test_helper_1.GETERR)(e);
+                if (msg.startsWith('404 NOT FOUND'))
                     throw new Error(`404 NOT FOUND - id:${id}`);
                 throw e;
             }));
-            // {"_index":"test-v3","_type":"_doc","_id":"aaa","_version":2,"found":true,"_source":{"name":"haha"}}
-            engine_1._log(NS, `> read[${id}].res =`, engine_1.$U.json(res));
-            engine_1._log(NS, `> create[${id}].found =`, res.found); // true
-            engine_1._log(NS, `> create[${id}]._version =`, res._version); // 2
-            const _id = res._id;
-            const _version = res._version;
-            const data = (res && res._source) || {};
+            (0, engine_1._log)(NS, `> read[${id}].res =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            const _id = (_a = res.body) === null || _a === void 0 ? void 0 : _a._id;
+            const _version = (_b = res.body) === null || _b === void 0 ? void 0 : _b._version;
+            const data = (res === null || res === void 0 ? void 0 : res._source) || {};
             // delete internal (analyzed) field
             delete data[Elastic6Service.DECOMPOSED_FIELD];
             delete data[Elastic6Service.QWERTY_FIELD];
@@ -309,26 +412,26 @@ class Elastic6Service {
      * @param id        item-id
      */
     deleteItem(id) {
+        var _a, _b, _c;
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName, docType } = this.options;
-            const { client } = instance(endpoint);
+            const { indexName, docType } = this.options;
             const type = `${docType}`;
-            engine_1._log(NS, `- readItem(${id})`);
+            (0, engine_1._log)(NS, `- readItem(${id})`);
             const params = { index: indexName, type, id };
-            engine_1._log(NS, `> params[${id}] =`, engine_1.$U.json(params));
-            const res = yield client.delete(params).catch(exports.$ERROR.handler('delete', e => {
-                engine_1._err(NS, `> delete[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
-                if (`${e.message}`.startsWith('404 Not Found'))
+            (0, engine_1._log)(NS, `> params[${id}] =`, engine_1.$U.json(params));
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.delete(params).catch(exports.$ERROR.handler('read', e => {
+                const msg = (0, test_helper_1.GETERR)(e);
+                if (msg.startsWith('404 NOT FOUND'))
                     throw new Error(`404 NOT FOUND - id:${id}`);
                 throw e;
             }));
             // {"_index":"test-v3","_type":"_doc","_id":"aaa","_version":3,"result":"deleted","_shards":{"total":2,"successful":2,"failed":0},"_seq_no":4,"_primary_term":1}
-            engine_1._log(NS, `> delete[${id}].res =`, engine_1.$U.json(res));
-            engine_1._log(NS, `> delete[${id}].result =`, res.result); // true
-            engine_1._log(NS, `> delete[${id}]._version =`, res._version); // 2
-            const _id = res._id;
-            const _version = res._version;
-            const data = (res && res._source) || {};
+            (0, engine_1._log)(NS, `> delete[${id}].res =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            const _id = (_a = res.body) === null || _a === void 0 ? void 0 : _a._id;
+            const _version = (_b = res.body) === null || _b === void 0 ? void 0 : _b._version;
+            const data = ((_c = res.body) === null || _c === void 0 ? void 0 : _c._source) || {};
             const res2 = Object.assign(Object.assign({}, data), { _id, _version });
             return res2;
         });
@@ -341,47 +444,105 @@ class Elastic6Service {
      */
     updateItem(id, item, increments) {
         return __awaiter(this, void 0, void 0, function* () {
-            const { endpoint, indexName, docType } = this.options;
-            const { client } = instance(endpoint);
+            const { indexName, docType, idName } = this.options;
             const type = `${docType}`;
-            engine_1._log(NS, `- updateItem(${id})`);
+            (0, engine_1._log)(NS, `- updateItem(${id})`);
             item = !item && increments ? undefined : item;
             //! prepare params.
             const params = { index: indexName, type, id, body: { doc: item } };
+            const version = this.version;
             if (increments) {
                 //! it will create if not exists.
-                params.body.upsert = Object.assign(Object.assign({}, increments), { [indexName]: id });
-                const scripts = engine_1.$_.reduce(increments, (L, val, key) => {
+                params.body.upsert = Object.assign(Object.assign({}, increments), { [idName]: id });
+                const scripts = Object.entries(increments).reduce((L, [key, val]) => {
                     L.push(`ctx._source.${key} += ${val}`);
                     return L;
                 }, []);
-                params.body.lang = 'painless';
+                if (version < 7.0)
+                    params.body.lang = 'painless';
                 params.body.script = scripts.join('; ');
             }
-            engine_1._log(NS, `> params[${id}] =`, engine_1.$U.json(params));
-            const res = yield client.update(params).catch(exports.$ERROR.handler('update', e => {
-                engine_1._err(NS, `> update[${indexName}].err =`, e instanceof Error ? e : engine_1.$U.json(e));
+            (0, engine_1._log)(NS, `> params[${id}] =`, engine_1.$U.json(params));
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const res = yield client.update(params).catch(exports.$ERROR.handler('update', (e, E) => {
+                const msg = (0, test_helper_1.GETERR)(e);
                 //! id 아이템이 없을 경우 발생함.
-                if (`${e.message}`.startsWith('404 document_missing_exception'))
+                if (msg.startsWith('404 DOCUMENT MISSING'))
                     throw new Error(`404 NOT FOUND - id:${id}`);
                 //! 해당 속성이 없을때 업데이트 하려면 생길 수 있음.
-                if (`${e.message}`.startsWith('400 remote_transport_exception'))
+                if (msg.startsWith('400 REMOTE TRANSPORT'))
                     throw new Error(`400 INVALID FIELD - id:${id}`);
-                if (`${e.message}`.startsWith('404 Not Found'))
+                if (msg.startsWith('404 NOT FOUND'))
                     throw new Error(`404 NOT FOUND - id:${id}`);
-                throw e;
+                if (msg.startsWith('400 ACTION REQUEST VALIDATION'))
+                    throw e;
+                if (msg.startsWith('400 INVALID FIELD'))
+                    throw e; // at ES6.8
+                if (msg.startsWith('400 ILLEGAL ARGUMENT'))
+                    throw e; // at ES7.1
+                throw E;
             }));
             // {"_index":"test-v3","_type":"_doc","_id":"aaa","_version":2,"result":"updated","_shards":{"total":2,"successful":2,"failed":0},"_seq_no":8,"_primary_term":1}
             // {"_index":"test-v3","_type":"_doc","_id":"aaa","_version":2,"result":"noop","_shards":{"total":0,"successful":0,"failed":0}}
-            engine_1._log(NS, `> update[${id}].res =`, engine_1.$U.json(res));
-            engine_1._log(NS, `> update[${id}].result =`, res.result); // true
-            engine_1._log(NS, `> update[${id}]._version =`, res._version); // 2
-            const _id = res._id;
-            const _version = res._version;
+            (0, engine_1._log)(NS, `> update[${id}].res =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
+            const _id = res.body._id;
+            const _version = res.body._version;
             const res2 = Object.assign(Object.assign({}, item), { _id, _version });
             return res2;
         });
     }
+    /**
+     * run search and get the raw response.
+     */
+    searchRaw(body, searchType) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!body)
+                throw new Error('@body (SearchBody) is required');
+            const { indexName, docType } = this.options;
+            (0, engine_1._log)(NS, `- search(${indexName}, ${searchType || ''})....`);
+            (0, engine_1._log)(NS, `> body =`, engine_1.$U.json(body));
+            const tmp = docType ? docType : '';
+            const type = docType ? `${docType}` : undefined;
+            const params = { index: indexName, type, body, searchType };
+            (0, engine_1._log)(NS, `> params[${tmp}] =`, engine_1.$U.json(Object.assign(Object.assign({}, params), { body: undefined })));
+            // const { client } = instance(endpoint);
+            const client = this.client;
+            const $res = yield client.search(params).catch(exports.$ERROR.handler('search', e => {
+                (0, engine_1._err)(NS, `> search[${indexName}].err =`, e);
+                throw e;
+            }));
+            // {"took":6,"timed_out":false,"_shards":{"total":4,"successful":4,"skipped":0,"failed":0},"hits":{"total":1,"max_score":0.2876821,"hits":[{"_index":"test-v3","_type":"_doc","_id":"aaa","_score":0.2876821,"_source":{"name":"AAA","@id":"aaa","a":-3,"b":-2}}]}}
+            // _log(NS, `> search[${id}].res =`, $U.json({ ...res, meta: undefined }));
+            // _log(NS, `> search[${tmp}].took =`, $res.took);
+            // _log(NS, `> search[${tmp}].hits.total =`, $res.hits?.total);
+            // _log(NS, `> search[${tmp}].hits.max_score =`, $res.hits?.max_score);
+            // _log(NS, `> search[${tmp}].hits.hits[0] =`, $res.hits && $U.json($res.hits.hits[0]));
+            //! return raw results.
+            return $res === null || $res === void 0 ? void 0 : $res.body;
+        });
+    }
+    /**
+     * run search, and get the formatmted response.
+     */
+    search(body, searchType) {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function* () {
+            const size = engine_1.$U.N(body.size, 0);
+            const response = yield this.searchRaw(body, searchType);
+            // return w/ transformed id
+            const hits = response.hits;
+            if (typeof hits !== 'object')
+                throw new Error(`.hits (object) is required - hits:${engine_1.$U.json(hits)}`);
+            //NOTE - ES6.8 w/ OS1.1
+            return {
+                total: typeof ((_a = hits.total) === null || _a === void 0 ? void 0 : _a.value) === 'number' ? (_b = hits.total) === null || _b === void 0 ? void 0 : _b.value : hits.total,
+                list: hits.hits.map((hit) => (Object.assign(Object.assign({}, hit._source), { _id: hit._id, _score: hit._score }))),
+                last: hits.hits.length === size && size > 0 ? (_c = hits.hits[size - 1]) === null || _c === void 0 ? void 0 : _c.sort : undefined,
+                aggregations: response.aggregations,
+            };
+        });
+    }
     /**
      * prepare default setting
      * - migrated from engine-v2.
@@ -392,14 +553,94 @@ class Elastic6Service {
      * @param replicas      number of replicas (default 1)
      * @param timeSeries    flag of TIMESERIES (default false)
      */
-    static prepareSettings(docType, idName, timeSeries, shards, replicas) {
-        shards = shards === undefined ? 4 : shards;
-        replicas = replicas === undefined ? 1 : replicas;
-        timeSeries = timeSeries === undefined ? false : timeSeries;
+    static prepareSettings(params) {
+        const docType = params.docType === undefined ? '_doc' : params.docType;
+        const idName = params.idName === undefined ? '$id' : params.idName;
+        const version = engine_1.$U.F(params.version === undefined ? '6.8' : params.version);
+        const shards = params.shards === undefined ? 4 : params.shards;
+        const replicas = params.replicas === undefined ? 1 : params.replicas;
+        const timeSeries = params.timeSeries === undefined ? false : params.timeSeries;
         //! core config.
         const CONF_ES_DOCTYPE = docType;
         const CONF_ID_NAME = idName;
         const CONF_ES_TIMESERIES = !!timeSeries;
+        const ES_MAPPINGS = {
+            // NOTE: the order of dynamic templates are important.
+            dynamic_templates: [
+                // 1. Search-as-You-Type (autocomplete search) - apply to '_decomposed.*' fields
+                {
+                    autocomplete: {
+                        path_match: `${Elastic6Service.DECOMPOSED_FIELD}.*`,
+                        mapping: {
+                            type: 'text',
+                            analyzer: 'autocomplete_case_insensitive',
+                            search_analyzer: 'standard',
+                        },
+                    },
+                },
+                // 2. Search-as-You-Type (Korean to Alphabet sequence in QWERTY/2벌식 keyboard) - apply to '_qwerty.*' fields
+                {
+                    autocomplete_qwerty: {
+                        path_match: `${Elastic6Service.QWERTY_FIELD}.*`,
+                        mapping: {
+                            type: 'text',
+                            analyzer: 'autocomplete_case_sensitive',
+                            search_analyzer: 'whitespace',
+                        },
+                    },
+                },
+                // 3. string type ID field
+                {
+                    string_id: {
+                        match_mapping_type: 'string',
+                        match: CONF_ID_NAME,
+                        mapping: {
+                            type: 'keyword',
+                            ignore_above: 256,
+                        },
+                    },
+                },
+                // 4. any other string fields - use Hangul analyzer and create 'keyword' sub-field
+                {
+                    strings: {
+                        match_mapping_type: 'string',
+                        mapping: {
+                            type: 'text',
+                            analyzer: 'hangul',
+                            search_analyzer: 'hangul',
+                            fields: {
+                                // keyword sub-field
+                                // 문자열 타입에 대한 템플릿을 지정하지 않으면 기본으로 ES가 '.keyword' 서브필드를 생성하나
+                                // 문자열 타입 템플릿 재정의 시 기본으로 생성되지 않으므로 명시적으로 선언함.
+                                keyword: {
+                                    type: 'keyword',
+                                    ignore_above: 256,
+                                },
+                            },
+                        },
+                    },
+                },
+            ],
+            properties: {
+                '@version': {
+                    type: 'keyword',
+                    index: false,
+                },
+                created_at: {
+                    type: 'date',
+                    format: 'strict_date_optional_time||epoch_millis',
+                },
+                updated_at: {
+                    type: 'date',
+                    format: 'strict_date_optional_time||epoch_millis',
+                },
+                deleted_at: {
+                    type: 'date',
+                    format: 'strict_date_optional_time||epoch_millis',
+                },
+            },
+        };
+        //! default settings.
         const ES_SETTINGS = {
             settings: {
                 number_of_shards: shards,
@@ -411,7 +652,7 @@ class Elastic6Service {
                             decompound: true,
                             deinflect: true,
                             index_eojeol: true,
-                            pos_tagging: false,
+                            pos_tagging: false, // 품사 태깅
                         },
                         edge_30grams: {
                             type: 'edge_ngram',
@@ -434,98 +675,31 @@ class Elastic6Service {
                         autocomplete_case_sensitive: {
                             type: 'custom',
                             tokenizer: 'edge_30grams',
-                            filter: ['standard'],
-                        },
-                    },
-                },
-            },
-            mappings: {
-                [CONF_ES_DOCTYPE]: {
-                    // NOTE: the order of dynamic templates are important.
-                    dynamic_templates: [
-                        // 1. Search-as-You-Type (autocomplete search) - apply to '_decomposed.*' fields
-                        {
-                            autocomplete: {
-                                path_match: `${Elastic6Service.DECOMPOSED_FIELD}.*`,
-                                mapping: {
-                                    type: 'text',
-                                    analyzer: 'autocomplete_case_insensitive',
-                                    search_analyzer: 'standard',
-                                },
-                            },
-                        },
-                        // 2. Search-as-You-Type (Korean to Alphabet sequence in QWERTY/2벌식 keyboard) - apply to '_qwerty.*' fields
-                        {
-                            autocomplete_qwerty: {
-                                path_match: `${Elastic6Service.QWERTY_FIELD}.*`,
-                                mapping: {
-                                    type: 'text',
-                                    analyzer: 'autocomplete_case_sensitive',
-                                    search_analyzer: 'whitespace',
-                                },
-                            },
-                        },
-                        // 3. string type ID field
-                        {
-                            string_id: {
-                                match_mapping_type: 'string',
-                                match: CONF_ID_NAME,
-                                mapping: {
-                                    type: 'keyword',
-                                    ignore_above: 256,
-                                },
-                            },
-                        },
-                        // 4. any other string fields - use Hangul analyzer and create 'keyword' sub-field
-                        {
-                            strings: {
-                                match_mapping_type: 'string',
-                                mapping: {
-                                    type: 'text',
-                                    analyzer: 'hangul',
-                                    search_analyzer: 'hangul',
-                                    fields: {
-                                        // keyword sub-field
-                                        // 문자열 타입에 대한 템플릿을 지정하지 않으면 기본으로 ES가 '.keyword' 서브필드를 생성하나
-                                        // 문자열 타입 템플릿 재정의 시 기본으로 생성되지 않으므로 명시적으로 선언함.
-                                        keyword: {
-                                            type: 'keyword',
-                                            ignore_above: 256,
-                                        },
-                                    },
-                                },
-                            },
-                        },
-                    ],
-                    properties: {
-                        '@version': {
-                            type: 'keyword',
-                            index: false,
-                        },
-                        created_at: {
-                            type: 'date',
-                            format: 'strict_date_optional_time||epoch_millis',
-                        },
-                        updated_at: {
-                            type: 'date',
-                            format: 'strict_date_optional_time||epoch_millis',
-                        },
-                        deleted_at: {
-                            type: 'date',
-                            format: 'strict_date_optional_time||epoch_millis',
+                            filter: version < 7.0 ? ['standard'] : [], //! error - The [standard] token filter has been removed.
                         },
                     },
                 },
             },
+            //! since 7.x. no mapping for types.
+            mappings: version < 7.0 ? { [CONF_ES_DOCTYPE]: ES_MAPPINGS } : ES_MAPPINGS,
         };
         //! timeseries 데이터로, 기본 timestamp 값을 넣어준다. (주의! save시 current-time 값 자동 저장)
         if (!!CONF_ES_TIMESERIES) {
             ES_SETTINGS.settings.refresh_interval = '5s';
-            ES_SETTINGS.mappings[CONF_ES_DOCTYPE].properties['@timestamp'] = { type: 'date', doc_values: true };
-            ES_SETTINGS.mappings[CONF_ES_DOCTYPE].properties['ip'] = { type: 'ip' };
-            //! clear mappings.
-            const CLEANS = '@version,created_at,updated_at,deleted_at'.split(',');
-            CLEANS.map(key => delete ES_SETTINGS.mappings[CONF_ES_DOCTYPE].properties[key]);
+            if (version < 7.0) {
+                ES_SETTINGS.mappings[CONF_ES_DOCTYPE].properties['@timestamp'] = { type: 'date', doc_values: true };
+                ES_SETTINGS.mappings[CONF_ES_DOCTYPE].properties['ip'] = { type: 'ip' };
+                //! clear mappings.
+                const CLEANS = '@version,created_at,updated_at,deleted_at'.split(',');
+                CLEANS.map(key => delete ES_SETTINGS.mappings[CONF_ES_DOCTYPE].properties[key]);
+            }
+            else {
+                ES_SETTINGS.mappings.properties['@timestamp'] = { type: 'date', doc_values: true };
+                ES_SETTINGS.mappings.properties['ip'] = { type: 'ip' };
+                //! clear mappings.
+                const CLEANS = '@version,created_at,updated_at,deleted_at'.split(',');
+                CLEANS.map(key => delete ES_SETTINGS.properties[key]);
+            }
         }
         //! returns settings.
         return ES_SETTINGS;
@@ -535,31 +709,31 @@ class Elastic6Service {
      * @param body  item body to be saved into ES6 index
      * @private
      */
-    prepareAutocompleteFields(body) {
+    popullateAutocompleteFields(body) {
         const { autocompleteFields } = this.options;
-        if (body && Array.isArray(autocompleteFields) && autocompleteFields.length > 0) {
-            body[Elastic6Service.DECOMPOSED_FIELD] = {};
-            body[Elastic6Service.QWERTY_FIELD] = {};
-            autocompleteFields.forEach(field => {
-                const value = body[field];
-                if (typeof value == 'string' || value) {
-                    // 한글의 경우 자모 분해 형태와 영자판 변형 형태를 제공하고, 영문의 경우 원본 텍스트만 제공한다.
-                    // 다만 사용자가 공백/하이픈을 생략하고 입력하는 경우에 대응하기 위해 공백/하이픈을 제거한 형태를 공통으로 제공한다.
-                    if (hangul_service_1.default.isHangul(value, true)) {
-                        // 자모 분해 (e.g. '레몬' -> 'ㄹㅔㅁㅗㄴ')
-                        const decomposed = hangul_service_1.default.asJamoSequence(value);
-                        const recomposed = decomposed.replace(/[ -]/g, '');
-                        body[Elastic6Service.DECOMPOSED_FIELD][field] = [decomposed, recomposed];
-                        // 영자판 (e.g. '레몬' -> 'fpahs')
-                        body[Elastic6Service.QWERTY_FIELD][field] = hangul_service_1.default.asAlphabetKeyStokes(value);
-                    }
-                    else {
-                        const recomposed = value.replace(/[ -]/g, '');
-                        body[Elastic6Service.DECOMPOSED_FIELD][field] = [value, recomposed];
-                    }
+        const isAutoComplete = autocompleteFields && Array.isArray(autocompleteFields) && autocompleteFields.length > 0;
+        if (!isAutoComplete)
+            return body;
+        return autocompleteFields.reduce((N, field) => {
+            const value = body[field];
+            if (typeof value == 'string' || value) {
+                // 한글의 경우 자모 분해 형태와 영자판 변형 형태를 제공하고, 영문의 경우 원본 텍스트만 제공한다.
+                // 다만 사용자가 공백/하이픈을 생략하고 입력하는 경우에 대응하기 위해 공백/하이픈을 제거한 형태를 공통으로 제공한다.
+                if (hangul_service_1.default.isHangul(value, true)) {
+                    // 자모 분해 (e.g. '레몬' -> 'ㄹㅔㅁㅗㄴ')
+                    const decomposed = hangul_service_1.default.asJamoSequence(value);
+                    const recomposed = decomposed.replace(/[ -]/g, '');
+                    N[Elastic6Service.DECOMPOSED_FIELD][field] = [decomposed, recomposed];
+                    // 영자판 (e.g. '레몬' -> 'fpahs')
+                    N[Elastic6Service.QWERTY_FIELD][field] = hangul_service_1.default.asAlphabetKeyStokes(value);
                 }
-            });
-        }
+                else {
+                    const recomposed = value.replace(/[ -]/g, '');
+                    N[Elastic6Service.DECOMPOSED_FIELD][field] = [value, recomposed];
+                }
+            }
+            return N;
+        }, Object.assign(Object.assign({}, body), { [Elastic6Service.DECOMPOSED_FIELD]: {}, [Elastic6Service.QWERTY_FIELD]: {} }));
     }
 }
 exports.Elastic6Service = Elastic6Service;
@@ -570,94 +744,96 @@ Elastic6Service.QWERTY_FIELD = '_qwerty';
  * error samples
  */
 exports.$ERROR = {
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    handler: (name, cb) => (e) => {
-        engine_1._err(NS, `! err[${name}]@a =`, e instanceof Error, engine_1.$U.json(e));
-        const status = `${e.statusCode || ''}`;
-        const message = `${e.message || e.msg || ''}`;
-        const error = ((e) => {
-            if (!e)
-                return {};
-            if (e.body && e.body.error) {
-                const error = e.body.error;
-                if (error.root_cause && Array.isArray(error.root_cause))
-                    return error.root_cause[0];
-                else if (error.root_cause)
-                    return error.root_cause;
-                return error;
+    asJson: (e) => {
+        const _pack = (o) => JSON.parse(JSON.stringify(o, Object.getOwnPropertyNames(o)));
+        if (e instanceof Error) {
+            const err = e;
+            const meta = err.meta && typeof err.meta === 'object' ? err.meta : undefined;
+            const $err = _pack(err);
+            return Object.assign(Object.assign({}, $err), { meta });
+        }
+        return e;
+    },
+    throwAsJson: (e) => {
+        throw exports.$ERROR.asJson(e);
+    },
+    parseMeta: (meta) => {
+        if (typeof meta === 'string' && meta) {
+            try {
+                if (meta.startsWith('[') && meta.endsWith(']')) {
+                    const list = JSON.parse(meta);
+                    const $ret = { list };
+                    return $ret;
+                }
+                else if (meta.startsWith('{') && meta.endsWith('}')) {
+                    return JSON.parse(meta);
+                }
+                else {
+                    const $ret = { type: 'string', value: meta };
+                    return $ret;
+                }
             }
-            else if (e.response) {
-                const error = typeof e.response == 'string' && e.response.startsWith('{') ? JSON.parse(e.response) : e.response;
-                if (error.root_cause && Array.isArray(error.root_cause))
-                    return error.root_cause[0];
-                else if (error.root_cause)
-                    return error.root_cause;
-                return error;
+            catch (e) {
+                const $ret = { type: 'string', value: meta, error: (0, test_helper_1.GETERR)(e) };
+                return $ret;
             }
-            else {
-                const type = e.statusCode || e.status || 0;
-                const reason = e.displayName || e.msg;
-                const path = e.path || '';
-                return { type, reason, path, message };
+        }
+        else if (meta === null || meta === undefined) {
+            return null;
+        }
+        else if (typeof meta === 'object') {
+            return meta;
+        }
+        else {
+            const type = typeof meta;
+            const $ret = { type, value: meta };
+            return $ret;
+        }
+    },
+    asError: (e) => {
+        const E = exports.$ERROR.asJson(e);
+        const status = `${E.statusCode || ''}`;
+        const message = `${E.message || E.msg || ''}`;
+        const reason = ((E) => {
+            var _a, _b, _c, _d;
+            //! from ES7.1
+            if (E.meta && typeof E.meta == 'object') {
+                const type = _S(E === null || E === void 0 ? void 0 : E.message).toUpperCase().split('_').slice(0, -1).join(' ');
+                const status = engine_1.$U.N((_a = E.meta) === null || _a === void 0 ? void 0 : _a.statusCode, type.includes('NOT FOUND') ? 404 : 400);
+                return { status, type: type || (status === 404 ? 'NOT FOUND' : 'UNKNOWN') };
             }
-        })(e);
-        error.status = error.status || status;
-        error.message = error.message || message;
-        //! print the unknown type exception
-        if (!error || error.status) {
-            // _err(NS, `! err[${name}]@b =`, e instanceof Error, $U.json(e));
-            // _err(NS, `> err[${name}]@c =`, $U.json(error));
-            // _err(NS, `> error[${name}].type =`, error.type);
-            // _err(NS, `> error[${name}].reason =`, error.reason);
-            // _err(NS, `> error[${name}].message =`, error.message);
+            //! from ES6.2
+            if (!E.response)
+                return null;
+            const $res = exports.$ERROR.parseMeta(E.response);
+            //! find the root-cause.
+            const pic1 = (N, i = 0) => (N && Array.isArray(N) ? N[i] : N);
+            const cause = pic1((_b = $res === null || $res === void 0 ? void 0 : $res.error) === null || _b === void 0 ? void 0 : _b.root_cause);
+            const status = engine_1.$U.N(((_c = $res.error) === null || _c === void 0 ? void 0 : _c.status) || $res.status);
+            const reason = _S((_d = $res.error) === null || _d === void 0 ? void 0 : _d.reason, $res.found === false || $res.result === 'not_found' ? 'NOT FOUND' : '');
+            const type = _S(cause === null || cause === void 0 ? void 0 : cause.type).toUpperCase().split('_').slice(0, -1).join(' ');
+            return { status, reason, cause, type: type || reason };
+        })(E);
+        //! FINAL. convert to error-object.
+        return {
+            status: engine_1.$U.N(status, (reason === null || reason === void 0 ? void 0 : reason.status) || 0),
+            message: message || (reason === null || reason === void 0 ? void 0 : reason.reason),
+            reason,
+        };
+    },
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    handler: (name, cb) => (e) => {
+        const E = exports.$ERROR.asError(e);
+        //! unknown error found..
+        if (!(E === null || E === void 0 ? void 0 : E.status)) {
+            (0, engine_1._err)(NS, `! err[${name}]@handler =`, e instanceof Error, engine_1.$U.json(e));
+            throw e;
         }
-        //! build Error instance.
-        const $e = new Error(`${error.status} ${error.type || error.reason || error.message} - ${error.reason || error.message}`);
+        const $e = new Error(`${E.status} ${E.reason.type} - ${E.message}`);
         if (cb)
-            return cb($e);
+            return cb($e, E);
         throw $e;
     },
-    index_not_found_exception: {
-        msg: '[index_not_found_exception] no such index, with { resource.type="index_or_alias" & resource.id="test-v2" & index_uuid="_na_" & index="test-v2" }',
-        path: '/test-v2',
-        query: {},
-        statusCode: 404,
-        response: '{"error":{"root_cause":[{"type":"index_not_found_exception","reason":"no such index","resource.type":"index_or_alias","resource.id":"test-v2","index_uuid":"_na_","index":"test-v2"}],"type":"index_not_found_exception","reason":"no such index","resource.type":"index_or_alias","resource.id":"test-v2","index_uuid":"_na_","index":"test-v2"},"status":404}',
-    },
-    resource_already_exists_exception: {
-        msg: '[resource_already_exists_exception] index [test-v2/R_X1Daw7S0e8qIh_W3M-Fg] already exists, with { index_uuid="R_X1Daw7S0e8qIh_W3M-Fg" & index="test-v2" }',
-        path: '/test-v2',
-        query: {},
-        body: '{"settings":{"index":{"number_of_shards":4,"number_of_replicas":1}},"template":"test-v2","mappings":{"_default_":{"dynamic_templates":[{"string_fields":{"match":"*_multi","match_mapping_type":"string","mapping":{"type":"multi_field","fields":{"{name}":{"type":"text","index":"analyzed","omit_norms":true,"index_options":"docs"},"{name}.raw":{"type":"text","index":"not_analyzed","ignore_above":256}}}}}],"_source":{"enabled":true},"properties":{"@version":{"type":"text","index":false},"title":{"type":"text"},"name":{"type":"text"},"created_at":{"type":"date","format":"strict_date_optional_time||epoch_millis"},"updated_at":{"type":"date","format":"strict_date_optional_time||epoch_millis"},"deleted_at":{"type":"date","format":"strict_date_optional_time||epoch_millis"},"@id":{"type":"text","fields":{"keyword":{"type":"keyword","ignore_above":256}}}}}}}',
-        statusCode: 400,
-        response: '{"error":{"root_cause":[{"type":"resource_already_exists_exception","reason":"index [test-v2/R_X1Daw7S0e8qIh_W3M-Fg] already exists","index_uuid":"R_X1Daw7S0e8qIh_W3M-Fg","index":"test-v2"}],"type":"resource_already_exists_exception","reason":"index [test-v2/R_X1Daw7S0e8qIh_W3M-Fg] already exists","index_uuid":"R_X1Daw7S0e8qIh_W3M-Fg","index":"test-v2"},"status":400}',
-    },
-    not_found: {
-        msg: 'Not Found',
-        path: '/test-v3/_doc/bbb',
-        query: {},
-        statusCode: 404,
-        response: '{"_index":"test-v3","_type":"_doc","_id":"bbb","found":false}',
-    },
-    action_request_validation_exception: {
-        msg: '[action_request_validation_exception] Validation Failed: 1: script or doc is missing;',
-        path: '/test-v3/_doc/aaa/_update',
-        query: {},
-        statusCode: 400,
-        response: '{"error":{"root_cause":[{"type":"action_request_validation_exception","reason":"Validation Failed: 1: script or doc is missing;"}],"type":"action_request_validation_exception","reason":"Validation Failed: 1: script or doc is missing;"},"status":400}',
-    },
-    remote_transport_exception: {
-        msg: '[remote_transport_exception] [rt8LrQT][x.x.x.x:9300][indices:data/write/update[s]]',
-        path: '/test-v3/_doc/aaa/_update',
-        query: {},
-        body: '{"upsert":{"count":2,"a":5},"script":"ctx._source.count += 2,ctx._source.a += 5"}',
-        statusCode: 400,
-        response: '{"error":{"root_cause":[{"type":"remote_transport_exception","reason":"[rt8LrQT][x.x.x.x:9300][indices:data/write/update[s]]"}],"type":"illegal_argument_exception","reason":"failed to execute script","caused_by":{"type":"script_exception","reason":"compile error","script_stack":["ctx._source.count += 2,ctx._source.a += 5","                      ^---- HERE"],"script":"ctx._source.count += 2,ctx._source.a += 5","lang":"painless","caused_by":{"type":"illegal_argument_exception","reason":"unexpected token [\',\'] was expecting one of [{<EOF>, \';\'}]."}}},"status":400}',
-    },
-    version_conflict_engine_exception: {
-        '!': '가끔씩 update할때 나는것 같음! 개선 필요 @191121',
-        msg: '[version_conflict_engine_exception] [item][TTDfu-tfwfoE0CFuQ=]: version conflict, current version [3] is different than the one provided [2], with { index_uuid="GxCGaNZoSZuoDFTmWfjqtg" & shard="4" & index="clusters-v1" }',
-    },
 };
 /** ****************************************************************************************************************
  *  Dummy Elastic6 Service
@@ -674,10 +850,10 @@ class DummyElastic6Service extends Elastic6Service {
          * say hello()
          */
         this.hello = () => `dummy-elastic6-service:${this.options.indexName}`;
-        engine_1._log(NS, `DummyElastic6Service(${dataFile || ''})...`);
+        (0, engine_1._log)(NS, `DummyElastic6Service(${dataFile || ''})...`);
         if (!dataFile)
             throw new Error('@dataFile(string) is required!');
-        const dummy = tools_1.loadDataYml(dataFile);
+        const dummy = (0, tools_1.loadDataYml)(dataFile);
         this.load(dummy.data);
     }
     load(data) {
@@ -714,7 +890,7 @@ class DummyElastic6Service extends Elastic6Service {
     updateItem(id, updates, increments) {
         return __awaiter(this, void 0, void 0, function* () {
             const org = yield this.readItem(id);
-            const item = Object.assign(Object.assign(Object.assign({}, org), updates), { _version: Number(org._version) + 1 });
+            const item = Object.assign(Object.assign(Object.assign({}, org), updates), { _version: Number(org._version || 0) + 1 });
             if (increments) {
                 //TODO - support increments in dummy.
             }