lemon-core 3.2.8 → 3.2.9

package/dist/cores/elastic/elastic6-service.js

@@ -8,11 +8,30 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+var __asyncValues = (this && this.__asyncValues) || function (o) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var m = o[Symbol.asyncIterator], i;
+    return m ? m.call(o) : (o = typeof __values === "function" ? __values(o) : o[Symbol.iterator](), i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i);
+    function verb(n) { i[n] = o[n] && function (v) { return new Promise(function (resolve, reject) { v = o[n](v), settle(resolve, reject, v.done, v.value); }); }; }
+    function settle(resolve, reject, d, v) { Promise.resolve(v).then(function(v) { resolve({ value: v, done: d }); }, reject); }
+};
+var __await = (this && this.__await) || function (v) { return this instanceof __await ? (this.v = v, this) : new __await(v); }
+var __asyncGenerator = (this && this.__asyncGenerator) || function (thisArg, _arguments, generator) {
+    if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
+    var g = generator.apply(thisArg, _arguments || []), i, q = [];
+    return i = {}, verb("next"), verb("throw"), verb("return"), i[Symbol.asyncIterator] = function () { return this; }, i;
+    function verb(n) { if (g[n]) i[n] = function (v) { return new Promise(function (a, b) { q.push([n, v, a, b]) > 1 || resume(n, v); }); }; }
+    function resume(n, v) { try { step(g[n](v)); } catch (e) { settle(q[0][3], e); } }
+    function step(r) { r.value instanceof __await ? Promise.resolve(r.value.v).then(fulfill, reject) : settle(q[0][2], r); }
+    function fulfill(value) { resume("next", value); }
+    function reject(value) { resume("throw", value); }
+    function settle(f, v) { if (f(v), q.shift(), q.length) resume(q[0][0], q[0][1]); }
+};
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DummyElastic6Service = exports.$ERROR = exports.Elastic6Service = exports.$hangul = exports.elasticsearch = void 0;
+exports.DummyElastic6Service = exports.$ERROR = exports.Elastic6Service = exports.ElasticIndexService = exports.$hangul = exports.elasticsearch = void 0;
 /**
  * `elastic6-service.ts`
  * - common service for elastic-search v6
@@ -32,32 +51,35 @@ const hangul_service_1 = __importDefault(require("./hangul-service"));
 exports.$hangul = hangul_service_1.default;
 const tools_1 = require("../../tools");
 const test_helper_1 = require("../../common/test-helper");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
 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}`;
+/** ****************************************************************************************************************
+ *  Elastic Index Service
+ ** ****************************************************************************************************************/
 /**
- * class: `Elastic6Service`
- * - basic CRUD service for Elastic Search 6
+ * abstarct class: `ElasticIndexService`
+ * - abstract class for basic Elasticsearch CRUD operations
+ * - common operations that are shared across different versions.
+ * TODO - support `Elastic` and `OpenSearch`
  */
-class Elastic6Service {
+class ElasticIndexService {
     /**
      * default constuctor w/ options.
      * @param options { endpoint, indexName } is required.
      */
     constructor(options) {
-        /**
-         * say hello of identity.
-         */
-        this.hello = () => `elastic6-service:${this.options.indexName}:${this.version}`;
-        (0, engine_1._inf)(NS, `Elastic6Service(${options.indexName}/${options.idName})...`);
+        (0, engine_1._inf)(NS, `ElasticIndexService(${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'
-        const { client } = Elastic6Service.instance(options.endpoint);
+        const { client } = ElasticIndexService.instance(options.endpoint);
         this._options = Object.assign({ docType: '_doc', idName: '$id', version: '6.8' }, options);
         this._client = client;
     }
@@ -65,7 +87,7 @@ class Elastic6Service {
      * simple instance maker.
      *
      * ```js
-     * const { client } = Elastic6Service.instance(endpoint);
+     * const { client } = ElasticIndexService.instance(endpoint);
      * ```
      *
      * @param endpoint  service-url
@@ -93,18 +115,157 @@ class Elastic6Service {
     get options() {
         return this._options;
     }
+    /**
+     * get the version from options
+     */
     get version() {
         const ver = engine_1.$U.F(this.options.version, 6.8);
         return ver;
     }
+}
+exports.ElasticIndexService = ElasticIndexService;
+/**
+ * class: `Elastic6Service`
+ * - extends `ElasticIndexService` and adds version-specific implementation
+ */
+class Elastic6Service extends ElasticIndexService {
+    /**
+     * default constuctor w/ options.
+     * @param options { endpoint, indexName } is required.
+     */
+    constructor(options) {
+        super(options);
+        /**
+         * say hello of identity.
+         */
+        this.hello = () => `elastic6-service:${this.options.indexName}:${this.options.version}`;
+        (0, engine_1._inf)('Elastic6Service', `Elastic6Service(${options.indexName}/${options.idName})...`);
+    }
+    /**
+     * get isOldES6
+     * - used when setting doctype
+     * - used when verifying mismatched error and results of search
+     */
+    get isOldES6() {
+        return this.parsedVersion.major < 7 && this.parsedVersion.engine === 'es';
+    }
+    /**
+     * get isOldES71
+     * - used when verifying mismatched error
+     */
+    get isOldES71() {
+        return this.parsedVersion.major == 7 && this.parsedVersion.minor == 1 && this.parsedVersion.engine === 'es';
+    }
+    /**
+     * get isLatestOS2
+     * - used when verifying results of search
+     */
+    get isLatestOS2() {
+        return this.parsedVersion.major >= 2 && this.parsedVersion.engine === 'os';
+    }
+    /**
+     * get the parsedVersion
+     */
+    get parsedVersion() {
+        return this.parseVersion(this.options.version);
+    }
+    /**
+     * get the root version from client
+     *
+     * @protected only for internal test.
+     */
+    getVersion(options) {
+        var _a, _b, _c;
+        return __awaiter(this, void 0, void 0, function* () {
+            const isDump = (_a = options === null || options === void 0 ? void 0 : options.dump) !== null && _a !== void 0 ? _a : false;
+            // it consumes about >20ms
+            const info = yield this.client.info();
+            const rootVersion = engine_1.$U.S(info.body.version.number);
+            const parsedVersion = this.parseVersion(rootVersion, { throwable: true });
+            if (isDump) {
+                //* save into `info.json`.
+                const description = Object.assign({ '!': `${(_b = this.parsedVersion) === null || _b === void 0 ? void 0 : _b.engine}${this.options.version} client info` }, info);
+                const filePath = path_1.default.resolve(__dirname, `../../../data/samples/${(_c = this.parsedVersion) === null || _c === void 0 ? void 0 : _c.engine}${this.options.version}/info.json`);
+                yield this.saveInfoToFile(description, filePath);
+            }
+            return parsedVersion;
+        });
+    }
+    /**
+     * check whether the service version matches the version provided in the options.
+     *
+     * @protected only for internal test.
+     */
+    executeSelfTest() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // STEP.1 read the parsed-version.
+            const optionVersion = this.parsedVersion;
+            // STEP.2 get the real version via `getVersion()`
+            const rootVersion = yield this.getVersion();
+            // STEP.3 validate version
+            const isEqual = optionVersion.engine === rootVersion.engine &&
+                optionVersion.major === rootVersion.major &&
+                optionVersion.minor === rootVersion.minor;
+            // Return the comparison result
+            return {
+                isEqual: isEqual,
+                optionVersion: optionVersion,
+                rootVersion: rootVersion,
+            };
+        });
+    }
+    /**
+     * parse version according to Semantic Versioning (SemVer) rules.
+     *
+     * @param version The version string to parse (e.g., "1.2.3", "1.2.3-alpha.1", "1.2.3+build.001").
+     * @param options Optional configuration for throwable behavior.
+     * @returns A ParsedVersion object or null if parsing fails and throwable is false.
+     */
+    parseVersion(version, options) {
+        var _a;
+        const isThrowable = (_a = options === null || options === void 0 ? void 0 : options.throwable) !== null && _a !== void 0 ? _a : true;
+        if (!version && isThrowable)
+            throw new Error(`@version (string) is required!`);
+        // RegEx to match Semantic Versioning patterns
+        const match = version === null || version === void 0 ? void 0 : version.match(/^(\d{1,2})(?:\.(\d{1,2}))?(?:\.(\d{1,2}))?(?:-([a-zA-Z0-9-.]+))?(?:\+([a-zA-Z0-9-.]+))?$/);
+        if (!match) {
+            if (isThrowable)
+                throw new Error(`@version[${version}] is invalid - fail to parse`);
+            return null;
+        }
+        const res = Object.assign(Object.assign({ engine: engine_1.$U.N(match[1], 10) < 6 ? 'os' : 'es', major: engine_1.$U.N(match[1], 10), minor: match[2] !== undefined ? engine_1.$U.N(match[2], 10) : 0, patch: match[3] !== undefined ? engine_1.$U.N(match[3], 10) : 0 }, (match[4] !== undefined ? { prerelease: match[4] } : {})), (match[5] !== undefined ? { build: match[5] } : {}));
+        return res;
+    }
+    /**
+     * save info to a JSON file.
+     * @param info - The information to be saved
+     * @param filePath - The file path where should be saved.
+     */
+    saveInfoToFile(info, filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const directory = path_1.default.dirname(filePath);
+                // check whether directory exists
+                if (!fs_1.default.existsSync(directory)) {
+                    fs_1.default.mkdirSync(directory, { recursive: true });
+                }
+                // write info to file
+                fs_1.default.writeFileSync(filePath, JSON.stringify(info, null, 2));
+            }
+            catch (_a) {
+                exports.$ERROR.handler('saveIntoFile', e => {
+                    throw e;
+                });
+            }
+        });
+    }
     /**
      * 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);
+            //* prepare client..
             const client = this.client;
             const res = yield client.cat.indices({ format: 'json' });
             (0, engine_1._log)(NS, `> indices =`, engine_1.$U.json(res));
@@ -125,12 +286,35 @@ class Elastic6Service {
                 priStoreSize: _S(N['pri.store.size']),
                 storeSize: _S(N['store.size']),
             }));
-            //! returns.
             return { list };
         });
     }
+    /**
+     * get mapping of an index
+     * @param indexName - name of the index
+     */
+    getIndexMapping() {
+        var _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const client = this.client;
+            const indexName = this.options.indexName;
+            const res = yield client.indices.getMapping({ index: indexName }).catch(
+            // $ERROR.throwAsJson,
+            exports.$ERROR.handler('getMapping', 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;
+            }));
+            const mapping = (res === null || res === void 0 ? void 0 : res.body) ? (_a = res.body[indexName]) === null || _a === void 0 ? void 0 : _a.mappings : null;
+            if (!mapping)
+                throw new Error(`@indexName[${indexName}] is not found - ${engine_1.$U.json(res)}!`);
+            return mapping;
+        });
+    }
     /**
      * find the index by name
+     * @param indexName - name of the index
      */
     findIndex(indexName) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -143,8 +327,7 @@ class Elastic6Service {
     }
     /**
      * create index by name
-     *
-     * @param settings      creating settings
+     * @param settings - creating settings
      */
     createIndex(settings) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -153,14 +336,13 @@ class Elastic6Service {
             if (!indexName)
                 new Error('@index is required!');
             (0, engine_1._log)(NS, `- createIndex(${indexName})`);
-            //! prepare payload
+            //* prepare payload
             const payload = Object.assign({ settings: {
                     number_of_shards: 5,
                     number_of_replicas: 1,
                 } }, settings);
             (0, engine_1._log)(NS, `> settings[${indexName}] = `, engine_1.$U.json(payload));
-            //! call create index..
-            // const { client } = instance(endpoint);
+            //* call create index..
             const client = this.client;
             const res = yield client.indices.create({ index: indexName, body: payload }).catch(
             // $ERROR.throwAsJson,
@@ -172,7 +354,7 @@ class Elastic6Service {
             }));
             // if (res) throw res;
             (0, engine_1._log)(NS, `> create[${indexName}] =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
-            //! build result.
+            //* build result.
             return {
                 status: res.statusCode,
                 index: indexName,
@@ -189,7 +371,7 @@ class Elastic6Service {
             if (!indexName)
                 new Error('@index is required!');
             (0, engine_1._log)(NS, `- destroyIndex(${indexName})`);
-            //! call create index..
+            //* call destroy index..
             // const { client } = instance(endpoint);
             const client = this.client;
             const res = yield client.indices.delete({ index: indexName }).catch(
@@ -218,7 +400,7 @@ class Elastic6Service {
             if (!indexName)
                 throw new Error('.indexName is required!');
             (0, engine_1._log)(NS, `- refreshIndex(${indexName})`);
-            //! call refresh index..
+            //* call refresh index..
             // const { client } = instance(endpoint);
             const client = this.client;
             const res = yield client.indices.refresh({ index: indexName }).catch(
@@ -242,7 +424,7 @@ class Elastic6Service {
             if (!indexName)
                 throw new Error('.indexName is required!');
             (0, engine_1._log)(NS, `- flushIndex(${indexName})`);
-            //! call flush index..
+            //* call flush index..
             // const { client } = instance(endpoint);
             const client = this.client;
             const res = yield client.indices.flush({ index: indexName }).catch(
@@ -263,9 +445,9 @@ class Elastic6Service {
     describe() {
         return __awaiter(this, void 0, void 0, function* () {
             const { indexName } = this.options;
-            //! call create index..
+            //* call create index..
             (0, engine_1._log)(NS, `- describe(${indexName})`);
-            //! read settings.
+            //* read settings.
             // const { client } = instance(endpoint);
             const client = this.client;
             const res = yield client.indices.getSettings({ index: indexName }).catch(
@@ -280,20 +462,20 @@ class Elastic6Service {
             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.
+            //* read mappings.
             const res2 = yield client.indices.getMapping({ index: indexName });
             (0, engine_1._log)(NS, `> mappings[${indexName}] =`, engine_1.$U.json(res2));
             const mappings = (res2.body && res2.body[indexName] && res2.body[indexName].mappings) || {};
-            //! returns
+            //* returns
             return { settings, mappings };
         });
     }
     /**
      * save single item
      *
-     * @param id    id
-     * @param item  item to save
-     * @param type  document type (default: doc-type given at construction time)
+     * @param id - id
+     * @param item - item to save
+     * @param type - document type (default: doc-type given at construction time)
      */
     saveItem(id, item, type) {
         var _a, _b;
@@ -306,7 +488,11 @@ class Elastic6Service {
             const body = Object.assign(Object.assign({}, item), { [idName]: id });
             const body2 = this.popullateAutocompleteFields(body);
             type = `${type || docType}`;
-            const params = { index: indexName, type, id, body: body2 };
+            const params = { index: indexName, id, body: body2 };
+            // check version to include 'type' in params
+            if (this.isOldES6) {
+                params.type = type;
+            }
             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));
@@ -315,12 +501,14 @@ class Elastic6Service {
             // $ERROR.throwAsJson,
             exports.$ERROR.handler('save', e => {
                 const msg = (0, test_helper_1.GETERR)(e);
-                //! try to update document..
+                //* try to overwrite document..
                 if (msg.startsWith('409 VERSION CONFLICT ENGINE')) {
-                    delete body2[idName]; // do set id while update
+                    // 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);
+                    const param2 = { index: indexName, id, body: Object.assign({}, body2) };
+                    if (this.isOldES6)
+                        param2.type = type;
+                    return client.index(param2);
                 }
                 throw e;
             }));
@@ -334,7 +522,8 @@ class Elastic6Service {
     /**
      * push item for time-series data.
      *
-     * @param item  item to push
+     * @param item - item to push
+     * @param type - document type (default: doc-type given at construction time)
      */
     pushItem(item, type) {
         var _a, _b;
@@ -367,8 +556,8 @@ class Elastic6Service {
     /**
      * read item with projections
      *
-     * @param id        item-id
-     * @param views     projections
+     * @param id - item-id
+     * @param views - projections
      */
     readItem(id, views) {
         var _a, _b, _c;
@@ -394,6 +583,8 @@ class Elastic6Service {
                 const msg = (0, test_helper_1.GETERR)(e);
                 if (msg.startsWith('404 NOT FOUND'))
                     throw new Error(`404 NOT FOUND - id:${id}`);
+                if (msg.startsWith('404 INDEX NOT FOUND'))
+                    throw new Error(`404 NOT FOUND - index:${indexName}`);
                 throw e;
             }));
             (0, engine_1._log)(NS, `> read[${id}].res =`, engine_1.$U.json(Object.assign(Object.assign({}, res), { meta: undefined })));
@@ -410,7 +601,7 @@ class Elastic6Service {
     /**
      * delete item with projections
      *
-     * @param id        item-id
+     * @param id - item-id
      */
     deleteItem(id) {
         var _a, _b, _c, _d;
@@ -426,6 +617,8 @@ class Elastic6Service {
                 const msg = (0, test_helper_1.GETERR)(e);
                 if (msg.startsWith('404 NOT FOUND'))
                     throw new Error(`404 NOT FOUND - id:${id}`);
+                if (msg.startsWith('404 INDEX NOT FOUND'))
+                    throw new Error(`404 NOT FOUND - index:${indexName}`);
                 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}
@@ -438,11 +631,17 @@ class Elastic6Service {
         });
     }
     /**
-     * update item
+     * update item (throw if not exist)
+     * `update table set a=1, b=b+2 where id='a1'`
+     * 0. no of `a1` -> 1,2 (created)
+     * 1. a,b := 10,20 -> 11,22
+     * 2. a,b := 10,null -> 11,2 (upsert)
+     * 3. a,b := null,20 -> 1,22
      *
-     * @param id        item-id
-     * @param item      item to update
-     * @param options   (optional) request option of client.
+     * @param id - item-id
+     * @param item - item to update
+     * @param increments - item to increase
+     * @param options - (optional) request option of client.
      */
     updateItem(id, item, increments, options) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -450,29 +649,55 @@ class Elastic6Service {
             const type = `${docType}`;
             (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;
+            //* prepare params.
+            const params = { index: indexName, id, body: {} };
+            // check version to include 'type' in params
+            if (this.isOldES6) {
+                params.type = type;
+            }
+            const scripts = [];
             if (increments) {
-                //! it will create if not exists.
+                //* it will create if not exists.
                 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;
-                }, []);
-                if (version < 7.0)
-                    params.body.lang = 'painless';
-                params.body.script = scripts.join('; ');
+                Object.entries(increments).forEach(([key, val]) => {
+                    if (Array.isArray(val)) {
+                        // If the value is an array, append it to the existing array in the source
+                        scripts.push(`if (ctx._source.${key} != null && ctx._source.${key} instanceof List) {
+                            ctx._source.${key}.addAll(params.increments.${key});
+                        } else {
+                            ctx._source.${key} = params.increments.${key};
+                        }`);
+                    }
+                    else {
+                        // If the value is a number, increment the existing field
+                        scripts.push(`if (ctx._source.${key} != null) {
+                            ctx._source.${key} += params.increments.${key};
+                        } else {
+                            ctx._source.${key} = params.increments.${key};
+                        }`);
+                    }
+                });
+            }
+            if (item) {
+                // Handle item updates in the script
+                Object.entries(item).forEach(([key]) => {
+                    scripts.push(`ctx._source.${key} = params.item.${key};`);
+                });
             }
+            params.body.script = {
+                source: scripts.join(' '),
+                lang: 'painless',
+                params: { item, increments },
+            };
             (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, options).catch(exports.$ERROR.handler('update', (e, E) => {
                 const msg = (0, test_helper_1.GETERR)(e);
-                //! id 아이템이 없을 경우 발생함.
+                //* id 아이템이 없을 경우 발생함.
                 if (msg.startsWith('404 DOCUMENT MISSING'))
                     throw new Error(`404 NOT FOUND - id:${id}`);
-                //! 해당 속성이 없을때 업데이트 하려면 생길 수 있음.
+                //* 해당 속성이 없을때 업데이트 하려면 생길 수 있음.
                 if (msg.startsWith('400 REMOTE TRANSPORT'))
                     throw new Error(`400 INVALID FIELD - id:${id}`);
                 if (msg.startsWith('404 NOT FOUND'))
@@ -483,6 +708,8 @@ class Elastic6Service {
                     throw e; // at ES6.8
                 if (msg.startsWith('400 ILLEGAL ARGUMENT'))
                     throw e; // at ES7.1
+                if (msg.startsWith('400 MAPPER PARSING'))
+                    throw e;
                 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}
@@ -496,6 +723,8 @@ class Elastic6Service {
     }
     /**
      * run search and get the raw response.
+     * @param body - Elasticsearch Query DSL that defines the search request (e.g., size, query, filters).
+     * @param searchType - type of search (e.g., 'query_then_fetch', 'dfs_query_then_fetch').
      */
     searchRaw(body, searchType) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -506,7 +735,11 @@ class Elastic6Service {
             (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 };
+            const params = { index: indexName, body, searchType };
+            // check version to include 'type' in params
+            if (this.isOldES6) {
+                params.type = type;
+            }
             (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;
@@ -520,12 +753,15 @@ class Elastic6Service {
             // _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 raw results.
             return $res === null || $res === void 0 ? void 0 : $res.body;
         });
     }
     /**
      * run search, and get the formatmted response.
+     * @param body - Elasticsearch Query DSL that defines the search request (e.g., size, query, filters).
+     * @param searchType - type of search (e.g., 'query_then_fetch', 'dfs_query_then_fetch').
+     *
      */
     search(body, searchType) {
         var _a, _b, _c;
@@ -545,6 +781,70 @@ class Elastic6Service {
             };
         });
     }
+    /**
+     * search all until limit (-1 means no-limit)
+     * @param body - Elasticsearch Query DSL that defines the search request (e.g., size, query, filters).
+     * @param params - parameters including search type, limit, and retry options.
+     */
+    searchAll(body, params) {
+        var e_1, _a;
+        return __awaiter(this, void 0, void 0, function* () {
+            const list = [];
+            try {
+                for (var _b = __asyncValues(this.generateSearchResult(body, params)), _c; _c = yield _b.next(), !_c.done;) {
+                    const chunk = _c.value;
+                    chunk.forEach((N) => list.push(N));
+                }
+            }
+            catch (e_1_1) { e_1 = { error: e_1_1 }; }
+            finally {
+                try {
+                    if (_c && !_c.done && (_a = _b.return)) yield _a.call(_b);
+                }
+                finally { if (e_1) throw e_1.error; }
+            }
+            return list;
+        });
+    }
+    /**
+     * create async generator that yields items queried until last
+     *
+     * @param body - Elasticsearch Query DSL that defines the search request (e.g., size, query, filters).
+     * @param params - parameters including search type, limit, and retry options.
+     */
+    generateSearchResult(body, params) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        return __asyncGenerator(this, arguments, function* generateSearchResult_1() {
+            const doRetry = (_b = (_a = params === null || params === void 0 ? void 0 : params.retryOptions) === null || _a === void 0 ? void 0 : _a.do) !== null && _b !== void 0 ? _b : false;
+            const t = (_d = (_c = params === null || params === void 0 ? void 0 : params.retryOptions) === null || _c === void 0 ? void 0 : _c.t) !== null && _d !== void 0 ? _d : 5000;
+            const maxRetries = (_f = (_e = params === null || params === void 0 ? void 0 : params.retryOptions) === null || _e === void 0 ? void 0 : _e.maxRetries) !== null && _f !== void 0 ? _f : 3;
+            let limit = (_g = params === null || params === void 0 ? void 0 : params.limit) !== null && _g !== void 0 ? _g : -1;
+            let retryCount = 0;
+            if (!body.sort)
+                body.sort = '_doc';
+            do {
+                try {
+                    const { list, last } = yield __await(this.search(body, params === null || params === void 0 ? void 0 : params.searchType));
+                    body.search_after = last;
+                    if (list.length === 0 && !body.search_after) {
+                        break;
+                    }
+                    yield yield __await(list);
+                }
+                catch (e) {
+                    const msg = (0, test_helper_1.GETERR)(e);
+                    if (doRetry && msg.startsWith('429 UNKNOWN') && retryCount < maxRetries) {
+                        retryCount++;
+                        yield __await((0, test_helper_1.waited)(t));
+                        continue;
+                    }
+                    else {
+                        throw e;
+                    }
+                }
+            } while (body.search_after && (limit === -1 || --limit > 0));
+        });
+    }
     /**
      * prepare default setting
      * - migrated from engine-v2.
@@ -562,7 +862,7 @@ class Elastic6Service {
         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.
+        //* core config.
         const CONF_ES_DOCTYPE = docType;
         const CONF_ID_NAME = idName;
         const CONF_ES_TIMESERIES = !!timeSeries;
@@ -642,7 +942,7 @@ class Elastic6Service {
                 },
             },
         };
-        //! default settings.
+        //* default settings.
         const ES_SETTINGS = {
             settings: {
                 number_of_shards: shards,
@@ -677,33 +977,33 @@ class Elastic6Service {
                         autocomplete_case_sensitive: {
                             type: 'custom',
                             tokenizer: 'edge_30grams',
-                            filter: version < 7.0 ? ['standard'] : [], //! error - The [standard] token filter has been removed.
+                            filter: version < 7 && version >= 6 ? ['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,
+            //* since 7.x. no mapping for types.
+            mappings: version < 7 && version >= 6 ? { [CONF_ES_DOCTYPE]: ES_MAPPINGS } : ES_MAPPINGS,
         };
-        //! timeseries 데이터로, 기본 timestamp 값을 넣어준다. (주의! save시 current-time 값 자동 저장)
+        //* timeseries 데이터로, 기본 timestamp 값을 넣어준다. (주의! save시 current-time 값 자동 저장)
         if (!!CONF_ES_TIMESERIES) {
             ES_SETTINGS.settings.refresh_interval = '5s';
-            if (version < 7.0) {
+            if (version < 7 && version >= 6) {
                 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.
+                //* 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.
+                //* clear mappings.
                 const CLEANS = '@version,created_at,updated_at,deleted_at'.split(',');
                 CLEANS.map(key => delete ES_SETTINGS.properties[key]);
             }
         }
-        //! returns settings.
+        //* returns settings.
         return ES_SETTINGS;
     }
     /**
@@ -797,26 +1097,33 @@ exports.$ERROR = {
         const status = `${E.statusCode || ''}`;
         const message = `${E.message || E.msg || ''}`;
         const reason = ((E) => {
-            var _a, _b, _c, _d;
-            //! from ES7.1
+            var _a, _b, _c, _d, _e, _f;
+            //* 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') };
+                const $res = exports.$ERROR.parseMeta(E.meta);
+                //* find the reason.
+                const reason = (_c = (_b = $res.body) === null || _b === void 0 ? void 0 : _b.error) === null || _c === void 0 ? void 0 : _c.reason;
+                const result = { status, type: type || (status === 404 ? 'NOT FOUND' : 'UNKNOWN') };
+                if (typeof reason !== 'undefined') {
+                    result.reason = reason;
+                }
+                return result;
             }
-            //! from ES6.2
+            //* from ES6.2
             if (!E.response)
                 return null;
             const $res = exports.$ERROR.parseMeta(E.response);
-            //! find the root-cause.
+            //* 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 cause = pic1((_d = $res === null || $res === void 0 ? void 0 : $res.error) === null || _d === void 0 ? void 0 : _d.root_cause);
+            const status = engine_1.$U.N(((_e = $res.error) === null || _e === void 0 ? void 0 : _e.status) || $res.status);
+            const reason = _S((_f = $res.error) === null || _f === void 0 ? void 0 : _f.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.
+        //* 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),
@@ -825,13 +1132,14 @@ exports.$ERROR = {
     },
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     handler: (name, cb) => (e) => {
+        var _a, _b, _c, _d, _e;
         const E = exports.$ERROR.asError(e);
-        //! unknown error found..
+        //* 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;
         }
-        const $e = new Error(`${E.status} ${E.reason.type} - ${E.message}`);
+        const $e = new Error(`${E.status} ${(_b = (_a = E.reason) === null || _a === void 0 ? void 0 : _a.type) !== null && _b !== void 0 ? _b : ''} - ${(_e = (_d = (_c = E.reason) === null || _c === void 0 ? void 0 : _c.reason) !== null && _d !== void 0 ? _d : E.message) !== null && _e !== void 0 ? _e : ''}`);
         if (cb)
             return cb($e, E);
         throw $e;
@@ -894,10 +1202,28 @@ class DummyElastic6Service extends Elastic6Service {
             const org = yield this.readItem(id);
             const item = Object.assign(Object.assign(Object.assign({}, org), updates), { _version: Number(org._version || 0) + 1 });
             if (increments) {
-                //TODO - support increments in dummy.
+                Object.entries(increments).forEach(([key, value]) => {
+                    if (Array.isArray(value)) {
+                        // case of arrary increment
+                        if (Array.isArray(item[key])) {
+                            item[key] = [...item[key], ...value];
+                        }
+                        else {
+                            item[key] = value;
+                        }
+                    }
+                    else {
+                        if (typeof item[key] === 'number') {
+                            item[key] = item[key] + value;
+                        }
+                        else {
+                            item[key] = value;
+                        }
+                    }
+                });
             }
             this.buffer[id] = item;
-            return item;
+            return Object.assign({ id: id, _version: Number(org._version || 0) + 1 }, updates);
         });
     }
 }