@futdevpro/nts-dynamo 1.15.156 → 1.15.160

package/build/_services/base/db.service.js

@@ -1,1357 +1,1357 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_DBService = void 0;
-const tslib_1 = require("tslib");
-const mongoose = tslib_1.__importStar(require("mongoose"));
-const mongoose_1 = require("mongoose");
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const archive_util_1 = require("../../_collections/archive.util");
-const field_encryption_util_1 = require("../../_collections/field-encryption.util");
-const global_settings_const_1 = require("../../_collections/global-settings.const");
-/**
- * DB Service for MongoDB
- */
-class DyNTS_DBService {
-    dataParams;
-    serviceName;
-    dataModel /* : mongoose.Model<T> */; // = mongoose.model(this.dataParams.dataName, this.getSchema());
-    /* private depDataName: string; */
-    depKeys = [];
-    defaultErrorUserMsg = `We encountered an unhandled DB Error, ` +
-        `\nplease contact the responsible development team.`;
-    /**
-     * @param dataName name the model
-     * @param typeSample sample data for scheme creation (dont include DyFM_Metadata!)
-     * @param schemaSettings additional settings for specific parameters as unique, required, minlength or maxlength
-     * schemaSettings also MUST contain specific types that differs from the listed above (Array, Date)
-     */
-    constructor(dataParams) {
-        this.dataParams = dataParams;
-        try {
-            this.serviceName = this.constructor?.name;
-            if (!this.dataParams.dataName || typeof this.dataParams.dataName !== 'string') {
-                throw new Error(`dbName not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`);
-            }
-            if (!this.dataParams.constructed?.()) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    error: new Error(`DataModelParams is not constructed properly! (${this.dataParams.dataName}) ` +
-                        `Use the DyFM_DataModel_Params.constructor to construct it properly! (NTS DB)`),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-C01`,
-                    additionalContent: { dataParams: this.dataParams },
-                    __localStack: this.dataParams.stackLocation,
-                });
-            }
-            try {
-                this.dataModel = mongoose.model(this.dataParams.dataName, this.getSchema());
-            }
-            catch (error) {
-                if (mongoose.models[this.dataParams.dataName]) {
-                    this.dataModel = mongoose.models[this.dataParams.dataName];
-                }
-                else {
-                    throw error;
-                }
-            }
-            this.lookForDependencyDataSettings();
-        }
-        catch (error) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                message: `DyNTS_DBService construction failed! "${dataParams.dataName}" - "${this.serviceName}"`,
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-C00`,
-                level: fsm_dynamo_1.DyFM_ErrorLevel.critical,
-                additionalContent: { dataParams: this.dataParams },
-                error,
-            });
-        }
-    }
-    /**
-     * save new data
-     * @param data data
-     * @returns data
-     */
-    async createData(data, issuer) {
-        data.__created = new Date();
-        data.__lastModified = new Date();
-        data.__createdBy = issuer;
-        data.__lastModifiedBy = issuer;
-        // AT-REST field-encryption (opt-in): az encrypt:true mezőket a persist ELŐTT titkosítjuk, egy
-        // KLÓNON (a hívó `data`-ja plaintext marad). NO-OP, ha nincs encrypt:true mező.
-        const encData = field_encryption_util_1.DyNTS_FieldEncryption_Util.encryptDoc(data, this.dataParams.properties);
-        const dataModel = new this.dataModel(encData);
-        const newData = await dataModel.save().then((res) => {
-            if (res) {
-                return res?.toObject();
-            }
-            else {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('createData', new Error(`createData failed, save "${this.dataParams.dataName}" result not found! (NTS DB)`), issuer),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-CD1`,
-                    additionalContent: { data },
-                    issuer,
-                });
-            }
-        }).catch((error) => {
-            if (error?.flag?.includes('DYNAMO')) {
-                throw error;
-            }
-            else {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('createData', error, issuer),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-CD0`,
-                    additionalContent: {
-                        data: data,
-                        dataModel: this.dataModel,
-                    },
-                    message: `createData failed, Create new "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                        `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                    issuer,
-                });
-            }
-        });
-        return this.stringifyDataId(newData, 'createData');
-    }
-    /**
-     * Find data by _id and update
-     * @param data data
-     * @returns data
-     */
-    async modifyData(data, issuer, dontUpdateModified) {
-        if (this.dataParams.forbidModify) {
-            await this.modifyThrowMethod(data, issuer);
-        }
-        if (!dontUpdateModified) {
-            data.__lastModified = new Date();
-            data.__lastModifiedBy = issuer;
-        }
-        // AT-REST field-encryption (opt-in): az encrypt:true mezőket a persist ELŐTT titkosítjuk, egy
-        // KLÓNON. KRITIKUS: a `findByIdAndUpdate` MEGKERÜLI a mongoose settereket/pre-save-hookokat, ezért
-        // a titkosítás itt, app-rétegben történik (nem mongoose-hookban). A hívó `data`-ja plaintext marad,
-        // így a `stringifyDataId(data)` alant no-op decrypttel a plaintextet adja vissza. NO-OP enc-mező nélkül.
-        const encData = field_encryption_util_1.DyNTS_FieldEncryption_Util.encryptDoc(data, this.dataParams.properties);
-        /**
-         * EZ A SZAR TELJESEN SZAR, nem friss, nem a db-be mentett adatokat ad vissza,
-         * átír random value-kat össze vissza, WTF
-         * */
-        /* let newData: T = */
-        await this.dataModel.findByIdAndUpdate(data._id, encData) /* .then((res) => {
-          if (res) {
-            //return res?.toObject() as T;
-          } else {
-            throw new DyFM_Error({
-              ...this._getDefaultErrorSettings(
-                'modifyData',
-                new Error(`modifyData failed, modify "${this.dataParams.dataName}" result not found! (NTS DB)`),
-                issuer,
-              ),
-    
-              status: 204,
-              errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FU1`,
-              additionalContent: { data },
-              issuer,
-            });
-          }
-        }) */
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('modifyData', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FU0`,
-                additionalContent: { data },
-                message: `modifyData "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-        return this.stringifyDataId(data, 'modifyData');
-    }
-    // TODO: Missing issuer
-    /**
-     * returns data by _id,
-     * @param id id
-     * @returns data
-     */
-    async getDataById(id) {
-        if (!id) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataById', new Error(`No ID provided! (NTS DB)`)),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GI1`,
-                message: `get "${this.dataParams.dataName}" by ID was unsuccessful (NTS DB)`,
-            });
-        }
-        const data = await this.dataModel
-            .findById(id)
-            .then((res) => res?.toObject() ?? null)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataById', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GI0`,
-                additionalContent: { id },
-                message: `get "${this.dataParams.dataName}" by ID was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        return this.stringifyDataId(data, 'getDataById');
-    }
-    // TODO: Missing issuer
-    /**
-     * get data by dependency data id,
-     * !!!: throws error if not found (errorCode on not found: NTS-DBS-GD2)
-     *
-     * @param dependencyIdsFilter id
-     * @returns data
-     */
-    async getDataByDependencyId(dependencyIdsFilter) {
-        if (!this.depKeys.length) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataByDependencyId', new Error(`dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`)),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GD0`,
-            });
-        }
-        const data = await this.dataModel
-            .findOne(dependencyIdsFilter)
-            .then((res) => res?.toObject() ?? null)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataByDependencyId', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GD1`,
-                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
-                message: `get "${this.dataParams.dataName}" by ` +
-                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        return this.stringifyDataId(data, 'getDataByDependencyId');
-    }
-    // TODO: Missing issuer
-    async getDataListByIds(ids, findDeleted) {
-        const dataList = await this.dataModel
-            .find({ _id: { $in: ids } })
-            .then((res) => res ?? [])
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataListByIds', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GDL0`,
-                additionalContent: { ids },
-                message: `get "${this.dataParams.dataName}" by IDs was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        if (!findDeleted) {
-            return dataList.filter((data) => !data._deleted).map((data) => this.stringifyDataId(data, 'getDataListByDependencyId'));
-        }
-        else {
-            return dataList.map((data) => this.stringifyDataId(data, 'getDataListByDependencyId'));
-        }
-    }
-    // TODO: Missing issuer
-    /**
-     * get data by dependency data id,
-     * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLD2)
-     *
-     * @param dependencyIdsFilter id
-     * @returns dataList
-     */
-    async getDataListByDependencyId(dependencyIdsFilter, findDeleted) {
-        if (!this.depKeys.length) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataListByDependencyId', new Error(`isDependencyHook not setted up for this dataModel (${this.dataParams.dataName}) (NTS DB)`)),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLD0`,
-                additionalContent: {
-                    dataModel: this.dataModel,
-                },
-            });
-        }
-        const dataList = await this.dataModel
-            .find(dependencyIdsFilter)
-            .then((res) => res ?? [])
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataListByDependencyId', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLD1`,
-                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
-                message: `get "${this.dataParams.dataName}" by ` +
-                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        if (!findDeleted) {
-            return dataList.filter((data) => !data._deleted).map((data) => this.stringifyDataId(data, 'getDataListByDependencyId'));
-        }
-        else {
-            return dataList.map((data) => this.stringifyDataId(data, 'getDataListByDependencyId'));
-        }
-    }
-    // TODO: Missing issuer
-    /**
-     * get multiple data objects by a list of DependencyIDs,
-     * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLDS2)
-     *
-     * @param ids ids
-     * @returns dataList
-     */
-    async getDataListByDependencyIds(dependencyKey, dependencyIds, findDeleted) {
-        if (!this.depKeys.length) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataListByDependencyIds', new Error(`getDataListByDependencyIds not setted up for this db-service ` +
-                    `(${this.dataParams.dataName}) (NTS DB)`)),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLDS0`,
-            });
-        }
-        if (!dependencyIds?.length) {
-            return [];
-        }
-        if (!dependencyKey) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataListByDependencyIds', new Error(`dependencyKey is missing! (${this.dataParams.dataName}) (NTS DB)`)),
-            });
-        }
-        if (!this.depKeys.includes(dependencyKey)) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataListByDependencyIds', new Error(`dependencyKey is not valid! (${dependencyKey}) (NTS DB)`)),
-            });
-        }
-        const dataList = await this.dataModel
-            .find({
-            [dependencyKey]: { $in: dependencyIds },
-        })
-            .then((res) => res ?? [])
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDataListByDependencyIds', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLDS1`,
-                additionalContent: { dependencyIds },
-                message: `get "${this.dataParams.dataName}" by "${dependencyKey}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        if (!findDeleted) {
-            return dataList.filter((data) => !data._deleted).map((data) => this.stringifyDataId(data, 'getDataListByDependencyIds'));
-        }
-        else {
-            return dataList.map((data) => this.stringifyDataId(data, 'getDataListByDependencyIds'));
-        }
-    }
-    // TODO: Missing issuer
-    /**
-     * returns all data from database,
-     * !!!: throws error if not found (errorCode on not found: NTS-DBS-GA1)
-     *
-     * @returns dataList
-     */
-    async getAll(findDeleted) {
-        const dataList = await this.dataModel
-            .find()
-            .then((res) => res ?? [])
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getAll', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GA0`,
-                message: `get all "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        if (!findDeleted) {
-            return dataList.filter((data) => !data._deleted).map((data) => this.stringifyDataId(data, 'getAll'));
-        }
-        else {
-            return dataList.map((data) => this.stringifyDataId(data, 'getAll'));
-        }
-    }
-    async markDeletedById(id, issuer) {
-        if (this.dataParams.forbidDelete) {
-            await this.deleteThrowMethod(id, issuer);
-        }
-        await this.dataModel.findByIdAndUpdate(id, {
-            _deleted: new Date(),
-            _deletedBy: issuer,
-        }).catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('markDeletedById', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-MD0`,
-                additionalContent: { id },
-                message: `mark deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-    }
-    async markDeletedByDependencyId(dependencyIdsFilter, issuer) {
-        if (this.dataParams.forbidDelete) {
-            await this.deleteThrowMethod(dependencyIdsFilter, issuer);
-        }
-        await this.dataModel.updateMany(dependencyIdsFilter, {
-            _deleted: new Date(),
-            _deletedBy: issuer,
-        }).catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('markDeletedByDependencyId', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-MDD0`,
-                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
-                message: `markDeleted "${this.dataParams.dataName}" by ` +
-                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-    }
-    async restoreDeletedById(id, issuer) {
-        await this.dataModel.findByIdAndUpdate(id, {
-            _deleted: null,
-            __lastModified: new Date(),
-            __lastModifiedBy: issuer,
-        }).catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('restoreDeletedById', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-RD0`,
-                additionalContent: { id },
-                message: `restoreDeleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-    }
-    async restoreDeletedByDependencyId(dependencyIdsFilter, issuer) {
-        await this.dataModel.updateMany(dependencyIdsFilter, {
-            _deleted: null,
-            __lastModified: new Date(),
-            __lastModifiedBy: issuer,
-        }).catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('restoreDeletedByDependencyId', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-RDD0`,
-                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
-                message: `restoreDeleted "${this.dataParams.dataName}" by ` +
-                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-    }
-    // TODO: Missing issuer
-    async getDeletedDataList() {
-        const dataList = await this.dataModel
-            .getAll()
-            .then((res) => res ?? [])
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('getDeletedData', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GDD0`,
-                message: `get deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        return dataList.filter((data) => Boolean(data._deleted)).map((data) => this.stringifyDataId(data, 'getDeletedData'));
-    }
-    // TODO: Missing issuer
-    /**
-     * deleted data by id
-     * @param id id
-     */
-    async trueDeleteDataById(id) {
-        if (this.dataParams.forbidDelete) {
-            await this.deleteThrowMethod(id /* , issuer */);
-        }
-        await this.dataModel
-            .findByIdAndDelete(id)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('deleteDataById', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DD0`,
-                additionalContent: { id },
-                message: `delete "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-    }
-    deleteDataById = this.trueDeleteDataById;
-    // TODO: Missing issuer
-    /**
-     * deleted data by id
-     * @param dependencyId id
-     */
-    async trueDeleteDataByDependencyId(dependencyIdsFilter) {
-        if (this.dataParams.forbidDelete) {
-            await this.deleteThrowMethod(dependencyIdsFilter /* , issuer */);
-        }
-        if (!this.depKeys.length) {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('deleteDataByDependencyId', new Error(`dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`)),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DDD0`,
-            });
-        }
-        await this.dataModel
-            .deleteMany(dependencyIdsFilter)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('deleteDataByDependencyId', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DDD1`,
-                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
-                message: `delete "${this.dataParams.dataName}" by ` +
-                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-    }
-    deleteDataByDependencyId = this.trueDeleteDataByDependencyId;
-    // TODO: Missing issuer
-    async trueDeleteAllData() {
-        if (this.dataParams.forbidDelete) {
-            await this.deleteThrowMethod(null /* , issuer */);
-        }
-        await this.dataModel.deleteMany().catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('deleteAllData', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DAD0`,
-                message: `delete all "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-    }
-    deleteAllData = this.trueDeleteAllData;
-    // TODO: Missing issuer
-    /**
-     * returns search result for searchBy object params
-     * can use lists or xRange values for searchBy obj properties
-     *
-     * @param filterBy filter
-     * @param narrowByDependencyIds id
-     * @returns dataList
-     */
-    /**
-     * BFR-AM-013 — LEAN + projektált + BATCH-elt cursor-scan (OOM-safe nagy collection-ökhöz).
-     *
-     * A teljes result-set SOSEM él egyszerre a heapen: a Mongo-cursor batch-enként adagolja a
-     * PLAIN (lean, nem-Mongoose-doc) objektumokat a `handler`-nek — a Mongoose-doc-boxing tranziens
-     * (a 32k-vektoros LVS-hidratálás 93%-heap-spike-jának gyökere) kimarad. A `projection`-nel csak
-     * a szükséges mezők jönnek (pl. `{ vectorId: 1, embedding: 1 }` a content-szöveg NÉLKÜL).
-     * Visszaadja a feldolgozott dokumentumok számát.
-     */
-    async findLeanBatched(filterBy, set) {
-        const batchSize = set.batchSize && set.batchSize > 0 ? set.batchSize : 500;
-        const cursor = this.dataModel.find(filterBy, set.projection).lean().cursor();
-        let batch = [];
-        let total = 0;
-        for await (const doc of cursor) {
-            batch.push(doc);
-            total++;
-            if (batch.length >= batchSize) {
-                await set.handler(batch);
-                batch = [];
-            }
-        }
-        if (batch.length) {
-            await set.handler(batch);
-        }
-        return total;
-    }
-    async searchData(filterBy, narrowByDependencyIds, narrowByDependencyKey, findDeleted) {
-        const filter = {};
-        if (0 < narrowByDependencyIds.length) {
-            if (!this.depKeys.length) {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('searchData', new Error(`dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`)),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-SD0`,
-                });
-            }
-            if (!narrowByDependencyKey) {
-                if (this.depKeys.length === 1) {
-                    narrowByDependencyKey = this.depKeys[0];
-                }
-                else {
-                    throw new fsm_dynamo_1.DyFM_Error({
-                        ...this._getDefaultErrorSettings('searchData', new Error(`dependencyKey is missing! (${this.dataParams.dataName}) (NTS DB)`)),
-                    });
-                }
-            }
-            filter[narrowByDependencyKey] = { $in: narrowByDependencyIds };
-        }
-        Object.values(this.dataParams.properties).forEach((modelParam) => {
-            if ((filterBy[modelParam.key] !== null && filterBy[modelParam.key] !== undefined) ||
-                filterBy[modelParam.key + 'Range']) {
-                if (modelParam.key.includes('Range') || modelParam.type.includes('[]')) {
-                    // inverz search filter (for Range and Array functions)
-                    if (modelParam.key.includes('Range')) {
-                        const searchParamKeyWithoutRange = modelParam.key.split('Range')[0];
-                        if (filterBy[searchParamKeyWithoutRange] !== null &&
-                            filterBy[searchParamKeyWithoutRange] !== undefined) {
-                            filter[modelParam.key] = {
-                                from: { $lte: filterBy[searchParamKeyWithoutRange] },
-                                to: { $gte: filterBy[searchParamKeyWithoutRange] },
-                            };
-                        }
-                    }
-                    else {
-                        if (filterBy[modelParam.key] !== null &&
-                            filterBy[modelParam.key] !== undefined) {
-                            filter[modelParam.key] = { $in: filterBy[modelParam.key] };
-                        }
-                    }
-                }
-                else {
-                    // basic search filter
-                    if (filterBy[modelParam.key + 'Range']) {
-                        if (filterBy[modelParam.key + 'Range'].from ||
-                            filterBy[modelParam.key + 'Range'].to) {
-                            filter[modelParam.key] = {};
-                            if (filterBy[modelParam.key + 'Range'].from) {
-                                filter[modelParam.key].$gte = filterBy[modelParam.key + 'Range'].from;
-                            }
-                            if (filterBy[modelParam.key + 'Range'].to) {
-                                filter[modelParam.key].$lte = filterBy[modelParam.key + 'Range'].to;
-                            }
-                        }
-                    }
-                    else if (filterBy[modelParam.key] !== null &&
-                        filterBy[modelParam.key] !== undefined) {
-                        if (filterBy[modelParam.key].lenght > 0) {
-                            filter[modelParam.key] = { $in: filterBy[modelParam.key] };
-                        }
-                    }
-                }
-            }
-        });
-        let dataList = await this.dataModel
-            .find(filter)
-            .then((res) => res ?? [])
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('searchData', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-SD1`,
-                additionalContent: { filterBy, narrowByDependencyIds },
-                message: `search "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        if (!findDeleted && filterBy._deleted === undefined) {
-            dataList = dataList.filter((data) => !data._deleted);
-        }
-        return dataList.map((data) => this.stringifyDataId(data, 'searchData'));
-    }
-    // ----------------------------------------------------------------------------------
-    // ----------------------------------------------------------------------------------
-    // ----------------------------------------------------------------------------------
-    // DIRECT Basic MONGOOSE FUNCTIONS (with error handlings)
-    /**
-     * Find the data first by any of its parameters,
-     * !!!: throws error if not found (errorCode on not found: NTS-DBS-FO1)
-     *
-     * @param filterBy if you can, use unique parameters for find!
-     *
-     * @example
-     * // by email:
-     * { email: email }
-     * //
-     * @example
-     * // or by id that is in list:
-     * { userIds: { $in: this.userId } }
-     * // or by userIds:
-     * { userId: { $in: userIds } }
-     * //
-     * @example
-     * // or by number or Date that is Greater Than AND Less Than:
-     * { points: { $gt: 2, $lt: 14 } }
-     * // further tools (syntax matches with $gt):
-     * $eq:  // Matches values that are EQual to a specified value.
-     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
-     * $lte: // Matches values that are Less Than or Equal to a specified value.
-     * $ne:  // Matches all values that are Not Equal to a specified value.
-     * $nin: // Matches None of the values specified IN an array.
-     * //
-     * @returns {T} data: T
-     */
-    async findOne(filterBy) {
-        const data = await this.dataModel
-            .findOne(filterBy)
-            .then((res) => res ?? null)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('findOne', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FO0`,
-                additionalContent: { filterBy },
-                message: `findOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        return this.stringifyDataId(data, 'findOne');
-    }
-    /**
-     * #MONGOOSE FUNCTION
-     * Find the data first by any of its parameters,
-     * !!!: throws error if not found (errorCode on not found: NTS-DBS-F1)
-     *
-     * @param filterBy if you can, use unique parameters for find!
-     *
-     * @example
-     * // by email:
-     * { email: email }
-     * //
-     * @example
-     * // or by id that is in list:
-     * { userIds: { $in: this.userId } }
-     * // or by userIds:
-     * { userId: { $in: userIds } }
-     * //
-     * @example
-     * // or by number or Date that is Greater Than AND Less Than:
-     * { points: { $gt: 2, $lt: 14 } }
-     * // further tools (syntax matches with $gt):
-     * $eq:  // Matches values that are EQual to a specified value.
-     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
-     * $lte: // Matches values that are Less Than or Equal to a specified value.
-     * $ne:  // Matches all values that are Not Equal to a specified value.
-     * $nin: // Matches None of the values specified IN an array.
-     * //
-     * @param options BFR-008: opcionalis projection/limit/sort — DB-szinten szukit (a nagy mezok be sem toltodnek)
-     * @returns {T[]} dataList: T[]
-     */
-    async find(filterBy, findDeleted, options) {
-        // BFR-OVERSEER-008 — options megadasakor a soft-delete szures QUERY-szintre kerul: limit mellett a
-        // memoriabeli post-filter hibas darabszamot adna, projekcio mellett (kihagyott `_deleted` mezovel)
-        // hibasan atengedne a torolt dokumentumokat. A `_deleted` soft-delete-kor `new Date()`, egyebkent
-        // HIANYZIK → a Mongo `_deleted: null` (missing VAGY null) a post-filter `!data._deleted` ekvivalense.
-        const deletedGuardInQuery = !!options && !findDeleted && filterBy._deleted === undefined;
-        const effectiveFilter = deletedGuardInQuery
-            ? { ...filterBy, _deleted: null }
-            : filterBy;
-        // A szukites (select/sort/limit) DB-szinten tortenik → a nagy mezok be sem toltodnek a heap-be.
-        let query = this.dataModel.find(effectiveFilter);
-        if (options?.projection) {
-            query = query.select(options.projection);
-        }
-        if (options?.sort) {
-            query = query.sort(options.sort);
-        }
-        if (options?.limit) {
-            query = query.limit(options.limit);
-        }
-        let dataList = await query
-            .then((res) => res ?? [])
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('find', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-F0`,
-                additionalContent: { filterBy },
-                message: `find "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        if (!findDeleted && !deletedGuardInQuery && filterBy._deleted === undefined) {
-            dataList = dataList.filter((data) => !data._deleted);
-        }
-        return dataList.map((data) => this.stringifyDataId(data, 'find'));
-    }
-    /**
-     * #MONGOOSE FUNCTION
-     * Find the data first by any of its parameters
-     * WARNING: This function will not gives you back the total number of data in the database!
-     *
-     * @param filterBy if you can, use unique parameters for find!
-     *
-     * @example
-     * // by email:
-     * { email: email }
-     * //
-     * @example
-     * // or by id that is in list:
-     * { userIds: { $in: this.userId } }
-     * // or by userIds:
-     * { userId: { $in: userIds } }
-     * //
-     * @example
-     * // or by number or Date that is Greater Than AND Less Than:
-     * { points: { $gt: 2, $lt: 14 } }
-     * // further tools (syntax matches with $gt):
-     * $eq:  // Matches values that are EQual to a specified value.
-     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
-     * $lte: // Matches values that are Less Than or Equal to a specified value.
-     * $ne:  // Matches all values that are Not Equal to a specified value.
-     * $nin: // Matches None of the values specified IN an array.
-     * //
-     * @param page page
-     * @param pageSize pageSize
-     * @param sort
-     * @example
-     * // by dateTime (this uses the basic sort function):
-     * { dateTime: -1 }
-     * //
-     * @returns {T[]} dataList: T[]
-     */
-    async findWithPaging(filterBy, page, pageSize, sort) {
-        /* if (filterBy['_deleted'] === undefined) {
-          filterBy['_deleted'] = null;
-        } */
-        const dataList = await this.dataModel
-            .find(filterBy)
-            .sort(sort)
-            .skip(page * pageSize)
-            .limit(pageSize)
-            .then((res) => res ?? [])
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('findWithPaging', error),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-WP0`,
-                additionalContent: { filterBy, page, pageSize, sort },
-                message: `findWithPaging "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-            });
-        });
-        /* if ((filterBy as DyFM_DBFilterSimple<T>)._deleted === undefined) {
-          dataList = dataList.filter((data: T): boolean => !data._deleted);
-        } */
-        return dataList.map((data) => this.stringifyDataId(data, 'find'));
-    }
-    /**
-     * #MONGOOSE FUNCTION
-     * Find data by _id and update
-     *
-     * @param id id
-     * @param update update
-     * @returns data
-     */
-    async findByIdAndUpdate(id, update, issuer, dontUpdateModified) {
-        if (this.dataParams.forbidModify) {
-            await this.modifyThrowMethod(update, issuer);
-        }
-        if (!dontUpdateModified) {
-            update.__lastModified = new Date();
-            update.__lastModifiedBy = issuer;
-        }
-        const data = await this.dataModel
-            .findByIdAndUpdate(id, update)
-            .then((res) => res?.toObject() ?? null)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('findByIdAndUpdate', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FIU0`,
-                additionalContent: { id, update },
-                message: `findByIdAndUpdate "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-        return this.stringifyDataId(data, 'findByIdAndUpdate');
-    }
-    /**
-     * #MONGOOSE FUNCTION
-     * Atomi compare-and-set: filter-alapú find + update EGY műveletben, a MÓDOSÍTOTT dokumentum
-     * visszaadásával (BFR-FDPTOKENSERVICE-006).
-     *
-     * A `findByIdAndUpdate` (id-only, nem filterezhető) és az `updateOne` (filterezhető, de void —
-     * nem különíthető el a winner/loser konkurens state-átmenetnél) egyike sem elég CAS-hoz: egy
-     * state-machine `transitionStatus`-jellegű átmenetnél a filter a FELTÉTEL (pl. `{_id, status:
-     * 'locked'}`), és a visszatérő érték dönti el, hogy EZ a hívás nyerte-e az átmenetet.
-     * `null` = nincs match (a feltétel már nem áll — a versenytárs nyert / state-collision).
-     *
-     * A `__lastModified`/`forbidModify` szemantika a `findByIdAndUpdate`-tel EGYEZŐ (egységes
-     * update-viselkedés a base-ben); a `{ new: true }` a MÓDOSÍTOTT dokumentumot adja vissza.
-     */
-    async findOneAndUpdate(filterBy, update, issuer, dontUpdateModified) {
-        if (this.dataParams.forbidModify) {
-            await this.modifyThrowMethod(update, issuer);
-        }
-        if (!dontUpdateModified) {
-            update.__lastModified = new Date();
-            update.__lastModifiedBy = issuer;
-        }
-        const data = await this.dataModel
-            .findOneAndUpdate(filterBy, update, { new: true })
-            .then((res) => res?.toObject() ?? null)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('findOneAndUpdate', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FOU0`,
-                additionalContent: { filterBy, update },
-                message: `findOneAndUpdate "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-        // no-match (CAS lost / feltétel nem áll): a null ÉRVÉNYES eredmény, nem hiba
-        if (!data) {
-            return null;
-        }
-        return this.stringifyDataId(data, 'findOneAndUpdate');
-    }
-    /**
-     * #MONGOOSE FUNCTION
-     * Find the data first by any of its parameters
-     *
-     * @param filter This uses the basic Mongoose updateOne.
-     * If you can, use unique parameters for find!
-     * @example
-     * // by email:
-     * { email: email }
-     * //
-     * @example
-     * // or by id that is in list:
-     * { userIds: { $in: this.userId } }
-     * // or by userIds:
-     * { userId: { $in: userIds } }
-     * //
-     * @example
-     * // or by number or Date that is Greater Than AND Less Than:
-     * { points: { $gt: 2, $lt: 14 } }
-     * // further tools (syntax matches with $gt):
-     * $eq:  // Matches values that are EQual to a specified value.
-     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
-     * $lte: // Matches values that are Less Than or Equal to a specified value.
-     * $ne:  // Matches all values that are Not Equal to a specified value.
-     * $nin: // Matches None of the values specified IN an array.
-     * //
-     *
-     * @param update this uses the basic Mongoose updateOne
-     * @example
-     * // increase a specific value (here by 15):
-     * { $inc: { popularity: 15 } }
-     * //
-     * @example
-     * // or add element to a list:
-     * { $push: { reactions: this.newReaction }
-     * // or add multiple elements to a list
-     * { $push: { schedule: {$each: [ monday, tuesday, wednesday ] } } }
-     * //
-     * @example
-     * // or all at once
-     * {
-     *   $inc: { popularity: this.newVote.amount },
-     *   emailVerified: true,
-     *   $push: { reactions: this.newReaction }
-     * }
-     * // further tools (syntax matches with $inc):
-     * $currentDate: // Sets the value of a field to current date, either as a Date or a Timestamp.
-     * $min:         // Only updates the field if the specified value is less than the existing field value.
-     * $max:         // Only updates the field if the specified value is greater than the existing field value.
-     * $mul:         // Multiplies the value of the field by the specified amount.
-     * $rename:      // Renames a field.
-     * $unset:       // Removes the specified field from a document. (set: "" to value)
-     * //
-     */
-    async updateOne(filterBy, update, issuer, dontUpdateModified) {
-        if (this.dataParams.forbidModify) {
-            await this.modifyThrowMethod(update, issuer);
-        }
-        if (!dontUpdateModified) {
-            update.__lastModified = new Date();
-            update.__lastModifiedBy = issuer;
-        }
-        await this.dataModel
-            .updateOne(filterBy, update)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('updateOne', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-UO0`,
-                additionalContent: { filterBy, update },
-                message: `updateOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-    }
-    /**
-     * #MONGOOSE FUNCTION
-     * update one parameter by a specific
-     *
-     * @param filter This uses the basic Mongoose updateMany.
-     * @example
-     * // by email:
-     * { email: email }
-     * //
-     * @example
-     * // or by id that is in list:
-     * { userIds: { $in: this.userId } }
-     * // or by userIds:
-     * { userId: { $in: userIds } }
-     * //
-     * @example
-     * // or by number or Date that is Greater Than AND Less Than:
-     * { points: { $gt: 2, $lt: 14 } }
-     * // further tools (syntax matches with $gt):
-     * $eq:  // Matches values that are EQual to a specified value.
-     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
-     * $lte: // Matches values that are Less Than or Equal to a specified value.
-     * $ne:  // Matches all values that are Not Equal to a specified value.
-     * $nin: // Matches None of the values specified IN an array.
-     * //
-     *
-     * @param update this uses the basic Mongoose updateOne
-     * @example
-     * // increase a specific value (here by 15):
-     * { $inc: { popularity: 15 } }
-     * //
-     * @example
-     * // or add element to a list:
-     * { $push: { reactions: this.newReaction }
-     * // or add multiple elements to a list
-     * { $push: { schedule: {$each: [ monday, tuesday, wednesday ] } } }
-     * //
-     * @example
-     * // or all at once
-     * {
-     *   $inc: { popularity: this.newVote.amount },
-     *   emailVerified: true,
-     *   $push: { reactions: this.newReaction }
-     * }
-     * // further tools (syntax matches with $inc):
-     * $currentDate: // Sets the value of a field to current date, either as a Date or a Timestamp.
-     * $min:         // Only updates the field if the specified value is less than the existing field value.
-     * $max:         // Only updates the field if the specified value is greater than the existing field value.
-     * $mul:         // Multiplies the value of the field by the specified amount.
-     * $rename:      // Renames a field.
-     * $unset:       // Removes the specified field from a document. (set: "" to value)
-     * //
-     */
-    async updateMany(filterBy, update, issuer, dontUpdateModified) {
-        if (this.dataParams.forbidModify) {
-            await this.modifyThrowMethod(update, issuer);
-        }
-        if (!dontUpdateModified) {
-            update.__lastModified = new Date();
-            update.__lastModifiedBy = issuer;
-        }
-        await this.dataModel
-            .updateMany(filterBy, update)
-            .catch((error) => {
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings('updateMany', error, issuer),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-UM0`,
-                additionalContent: { filterBy, update },
-                message: `updateMany "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
-                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
-                issuer,
-            });
-        });
-    }
-    /**
-     * {
-        "mappings": {
-          "dynamic": true,
-          "fields": {
-            "embedding": {
-              "type": "knnVector",
-              "dimensions": 768
-            }
-          }
-        }
-      }
-     */
-    /**
-     *
-     * @param set db.collection.aggregate([
-        {
-          $vectorSearch: {
-            index: "index_neve",
-            queryVector: [a keresett embedding],
-            path: "title.embedding",
-            numCandidates: 100,
-            limit: 5
-          }
-        },
-        {
-          $vectorSearch: {
-            index: "index_neve",
-            queryVector: [a keresett embedding],
-            path: "description.embedding",
-            numCandidates: 100,
-            limit: 5
-          }
-        }
-      ]);
-     * @returns
-     */
-    async aggregate(set) {
-        return this.dataModel.aggregate(set);
-    }
-    // ----------------------------------------------------------------------------------
-    // ----------------------------------------------------------------------------------
-    // ----------------------------------------------------------------------------------
-    // PRIVATE FUNCTIONS
-    stringifyDataId(data, fnName) {
-        // AT-REST field-decryption (opt-in): ez a KÖZÖS read+write post-processor (minden read + a
-        // create/modify EREDMÉNYE is átmegy rajta), ezért itt fejtjük vissza az encrypt:true envelope-
-        // mezőket load után. NO-OP, ha nincs encrypt:true mező (ugyanaz a referencia — nulla változás).
-        data = field_encryption_util_1.DyNTS_FieldEncryption_Util.decryptDoc(data, this.dataParams.properties);
-        if (data?._id && (typeof data._id !== 'string' || typeof data._id === 'object')) {
-            data._id = `${data._id}`;
-            if (typeof data._id !== 'string' || typeof data._id === 'object') {
-                data = JSON.parse(JSON.stringify(data));
-                if (typeof data._id !== 'string' || typeof data._id === 'object') {
-                    fsm_dynamo_1.DyFM_Log.error(`data._id stringifying failed! Please notfiy the DynamoNTS developers! (${fnName})`, new Error());
-                }
-            }
-        }
-        return data;
-    }
-    _getDefaultErrorSettings(fnName, error, issuer) {
-        return {
-            status: error?.___status ?? 500,
-            message: error?.message ??
-                error?._message ??
-                `${fnName} was UNSUCCESSFUL (NTS-DB)`,
-            addECToUserMsg: !error?.__userMessage,
-            userMessage: error?.__userMessage ?? this.defaultErrorUserMsg,
-            issuer: issuer,
-            issuerService: this.serviceName,
-            error: error,
-        };
-    }
-    // ----------------------------------------------------------------------------------
-    // PRIVATE BUILD FUNCTIONS
-    /**
-     * builds and returns mongoose schema
-     * @returns schema
-     */
-    getSchema() {
-        this.dataParams.properties = this.addMetadataToProperties(this.dataParams.properties);
-        if (this.dataParams.dataName.includes(archive_util_1.DyNTS_archiveSuffix)) {
-            this.dataParams.properties = this.addArchiveMetadataToProperties(this.dataParams.properties);
-        }
-        const schemaSettings = this.buildMongooseSchemaSettingsObjByModelParams(this.dataParams.properties);
-        /* schema = this.addMetadataToSchema(schema); */
-        /* if (this.dataParams.dataName.includes(DyNTS_archiveSuffix)) {
-          schema = this.addArchiveMetadataToSchema(schema);
-        } */
-        if (schemaSettings['_id']) {
-            delete schemaSettings['_id'];
-        }
-        return new mongoose_1.Schema(schemaSettings);
-    }
-    /**
-     * builds mongoose schema building settings object by dynamoDataModelParamsList
-     * @param properties DynamoNTSDataPropertyParams
-     * @returns mongoose schema object
-     */
-    buildMongooseSchemaSettingsObjByModelParams(properties) {
-        const schemaSettingsObj = {};
-        /* if (!properties) {
-          properties = this.dataParams.properties;
-        } */
-        Object.values(properties).forEach((property) => {
-            if (!property) {
-                fsm_dynamo_1.DyFM_Log.warn(`property is undefined on "${this.dataParams.dataName}" (NTS DB)`);
-                return;
-            }
-            if (!property.key) {
-                const missingKeys = Object.keys(properties).filter((key) => !properties[key].key);
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('buildMongooseSchemaByModelParams', new Error(`property.key is undefined on "${this.dataParams.dataName}" (NTS DB) ` +
-                        `(keys: ${Object.keys(properties).join(', ')}) ` +
-                        `(missing keys: ${missingKeys.join(', ')})`)),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-BMSBP0`,
-                    additionalContent: {
-                        property: property,
-                        dataParams: this.dataParams,
-                        missingKeys: missingKeys,
-                    },
-                });
-            }
-            if (property.forbidden) {
-                return;
-            }
-            const beType = this.getBEType(property.type);
-            /* TODO if (beType === Array && property.archiveable && !property.archiveListAfter) {
-              property.archiveListAfter = DyNTS_global_settings.archiveListAfter;
-            } */
-            if (beType !== Object ||
-                !property?.subObjectParams ||
-                (property?.subObjectParams &&
-                    Object.keys(property.subObjectParams).length == 0)) {
-                schemaSettingsObj[property.key] = {
-                    type: beType,
-                };
-                if (property.index) {
-                    schemaSettingsObj[property.key].index = true;
-                }
-                if (property.unique) {
-                    schemaSettingsObj[property.key].unique = true;
-                }
-                if (property.required) {
-                    schemaSettingsObj[property.key].required = true;
-                }
-                if (property.minlength) {
-                    schemaSettingsObj[property.key].minlength = property.minlength;
-                }
-                if (property.maxlength) {
-                    schemaSettingsObj[property.key].maxlength = property.maxlength;
-                }
-            }
-            else {
-                schemaSettingsObj[property.key] = this.buildMongooseSchemaSettingsObjByModelParams(property.subObjectParams);
-            }
-        });
-        return schemaSettingsObj;
-    }
-    getBEType(type) {
-        switch (type) {
-            case fsm_dynamo_1.DyFM_BasicProperty_Type.string:
-                return String;
-            case fsm_dynamo_1.DyFM_BasicProperty_Type.number:
-                return Number;
-            case fsm_dynamo_1.DyFM_BasicProperty_Type.boolean:
-                return Boolean;
-            case fsm_dynamo_1.DyFM_BasicProperty_Type.date:
-                return Date;
-            case fsm_dynamo_1.DyFM_BasicProperty_Type.object:
-                return Object;
-            case fsm_dynamo_1.DyFM_BasicProperty_Type.array:
-                return Array;
-            case fsm_dynamo_1.DyFM_BasicProperty_Type.function:
-                return Function;
-            default:
-                fsm_dynamo_1.DyFM_Log.H_info('wtf', fsm_dynamo_1.DyFM_Object.cleanObject(this.dataParams));
-                throw new fsm_dynamo_1.DyFM_Error({
-                    error: new Error(`Invalid property type: "${type}" (${this.dataParams.dataName})` +
-                        (this.dataParams.constructed?.() ? '' : ('\nThe dataParams is not constructed properly! \n' +
-                            'Use the DyFM_DataModel_Params.constructor to construct it properly!'))),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GTP0`,
-                    additionalContent: { type: type, dataParams: this.dataParams },
-                    __localStack: this.dataParams.stackLocation,
-                });
-        }
-        /* switch (type.toLocaleLowerCase()) {
-          case DyFM_BasicProperty_Type.string:
-          case 'string':
-            return String;
-            
-          case DyFM_BasicProperty_Type.number:
-          case 'number':
-            return Number;
-    
-          case DyFM_BasicProperty_Type.boolean:
-          case 'boolean':
-            return Boolean;
-    
-          case DyFM_BasicProperty_Type.date:
-          case 'date':
-            return Date;
-    
-          case DyFM_BasicProperty_Type.object:
-          case 'object':
-            return Object;
-    
-          case DyFM_BasicProperty_Type.array:
-          case 'array':
-            return Array;
-            
-          default:
-            if (type.includes('[]') || type.includes('array')) {
-              return Array;
-            } else if (type.includes('=>') || type.includes('function')) {
-              return Function;
-            } else {
-              return Object;
-            }
-        } */
-    }
-    /**
-     * adds dynamo metadata settings to any mongoose schema building settings object
-     * @param schema schema to update
-     * @returns updated schema
-     */
-    /* private addMetadataToSchema(schema: any): any {
-      schema.__created = { type: Date };
-      schema.__createdBy = { type: String };
-      schema.__lastModified = { type: Date };
-      schema.__lastModifiedBy = { type: String };
-  
-      schema._deleted = { type: Date };
-      schema._deletedBy = { type: String };
-      
-      return schema;
-    } */
-    /**
-     * adds dynamo metadata settings to any mongoose schema building settings object
-     * @param properties properties to update
-     * @returns updated properties
-     */
-    addMetadataToProperties(properties) {
-        // TOD: ezek a kikommentelt "required: true"-k kellenek, csak félő, hogy gondokat okoznak a 
-        // jelenlegi rendszerekben, ezért akkor kell majd visszarakni, ha lesz tesztelői ÉS fejlesztői kapacitás rá
-        if (!properties.__created) {
-            properties.__created = {
-                key: '__created', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date /* , required: true */,
-            };
-        }
-        if (!properties.__createdBy) {
-            properties.__createdBy = {
-                key: '__createdBy', type: fsm_dynamo_1.DyFM_BasicProperty_Type.string /* , required: true */,
-            };
-        }
-        if (!properties.__lastModified) {
-            properties.__lastModified = {
-                key: '__lastModified', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date /* , required: true */,
-            };
-        }
-        if (!properties.__lastModifiedBy) {
-            properties.__lastModifiedBy = {
-                key: '__lastModifiedBy', type: fsm_dynamo_1.DyFM_BasicProperty_Type.string /* , required: true */,
-            };
-        }
-        if (!properties._deleted) {
-            properties._deleted = {
-                key: '_deleted', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date,
-            };
-        }
-        if (!properties._deletedBy) {
-            properties._deletedBy = {
-                key: '_deletedBy', type: fsm_dynamo_1.DyFM_BasicProperty_Type.string,
-            };
-        }
-        if (!properties._archived) {
-            properties._archived = {
-                key: '_archived', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date,
-            };
-        }
-        return properties;
-    }
-    /* private addArchiveMetadataToSchema(schema: any): any {
-      schema._originalId = { type: String, required: true, index: true, unique: true };
-      schema._archived = { type: Date, required: true };
-  
-      return schema;
-    } */
-    addArchiveMetadataToProperties(properties) {
-        if (!properties._originalId) {
-            properties._originalId = {
-                key: '_originalId', type: fsm_dynamo_1.DyFM_BasicProperty_Type.string,
-                required: true, index: true, unique: true,
-            };
-        }
-        if (!properties._archived) {
-            properties._archived = {
-                key: '_archived', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date,
-                required: true,
-            };
-        }
-        else if (properties._archived.required === undefined) {
-            properties._archived.required = true;
-        }
-        return properties;
-    }
-    /**
-     * sets depDataKey
-     */
-    lookForDependencyDataSettings() {
-        const dependencyParams = Object.values(this.dataParams.properties).filter((modelParams) => Boolean(modelParams.dependencyDataName));
-        if (dependencyParams) {
-            this.depKeys.push(...dependencyParams.map((dependencyParam) => dependencyParam.key));
-        }
-    }
-    async deleteThrowMethod(data, issuer) {
-        throw new fsm_dynamo_1.DyFM_Error({
-            error: new Error(`Forbidden to delete any data! (${this.dataParams.dataName})`),
-            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-CDAD`,
-            additionalContent: { dataParams: this.dataParams, data: data },
-            issuer: issuer,
-        });
-    }
-    ;
-    async modifyThrowMethod(data, issuer) {
-        throw new fsm_dynamo_1.DyFM_Error({
-            error: new Error(`Forbidden to modify any data! (${this.dataParams.dataName})`),
-            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-CDAD`,
-            additionalContent: { dataParams: this.dataParams, data: data },
-            issuer: issuer,
-        });
-    }
-}
-exports.DyNTS_DBService = DyNTS_DBService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_DBService = void 0;
+const tslib_1 = require("tslib");
+const mongoose = tslib_1.__importStar(require("mongoose"));
+const mongoose_1 = require("mongoose");
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const archive_util_1 = require("../../_collections/archive.util");
+const field_encryption_util_1 = require("../../_collections/field-encryption.util");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+/**
+ * DB Service for MongoDB
+ */
+class DyNTS_DBService {
+    dataParams;
+    serviceName;
+    dataModel /* : mongoose.Model<T> */; // = mongoose.model(this.dataParams.dataName, this.getSchema());
+    /* private depDataName: string; */
+    depKeys = [];
+    defaultErrorUserMsg = `We encountered an unhandled DB Error, ` +
+        `\nplease contact the responsible development team.`;
+    /**
+     * @param dataName name the model
+     * @param typeSample sample data for scheme creation (dont include DyFM_Metadata!)
+     * @param schemaSettings additional settings for specific parameters as unique, required, minlength or maxlength
+     * schemaSettings also MUST contain specific types that differs from the listed above (Array, Date)
+     */
+    constructor(dataParams) {
+        this.dataParams = dataParams;
+        try {
+            this.serviceName = this.constructor?.name;
+            if (!this.dataParams.dataName || typeof this.dataParams.dataName !== 'string') {
+                throw new Error(`dbName not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`);
+            }
+            if (!this.dataParams.constructed?.()) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    error: new Error(`DataModelParams is not constructed properly! (${this.dataParams.dataName}) ` +
+                        `Use the DyFM_DataModel_Params.constructor to construct it properly! (NTS DB)`),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-C01`,
+                    additionalContent: { dataParams: this.dataParams },
+                    __localStack: this.dataParams.stackLocation,
+                });
+            }
+            try {
+                this.dataModel = mongoose.model(this.dataParams.dataName, this.getSchema());
+            }
+            catch (error) {
+                if (mongoose.models[this.dataParams.dataName]) {
+                    this.dataModel = mongoose.models[this.dataParams.dataName];
+                }
+                else {
+                    throw error;
+                }
+            }
+            this.lookForDependencyDataSettings();
+        }
+        catch (error) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                message: `DyNTS_DBService construction failed! "${dataParams.dataName}" - "${this.serviceName}"`,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-C00`,
+                level: fsm_dynamo_1.DyFM_ErrorLevel.critical,
+                additionalContent: { dataParams: this.dataParams },
+                error,
+            });
+        }
+    }
+    /**
+     * save new data
+     * @param data data
+     * @returns data
+     */
+    async createData(data, issuer) {
+        data.__created = new Date();
+        data.__lastModified = new Date();
+        data.__createdBy = issuer;
+        data.__lastModifiedBy = issuer;
+        // AT-REST field-encryption (opt-in): az encrypt:true mezőket a persist ELŐTT titkosítjuk, egy
+        // KLÓNON (a hívó `data`-ja plaintext marad). NO-OP, ha nincs encrypt:true mező.
+        const encData = field_encryption_util_1.DyNTS_FieldEncryption_Util.encryptDoc(data, this.dataParams.properties);
+        const dataModel = new this.dataModel(encData);
+        const newData = await dataModel.save().then((res) => {
+            if (res) {
+                return res?.toObject();
+            }
+            else {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('createData', new Error(`createData failed, save "${this.dataParams.dataName}" result not found! (NTS DB)`), issuer),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-CD1`,
+                    additionalContent: { data },
+                    issuer,
+                });
+            }
+        }).catch((error) => {
+            if (error?.flag?.includes('DYNAMO')) {
+                throw error;
+            }
+            else {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('createData', error, issuer),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-CD0`,
+                    additionalContent: {
+                        data: data,
+                        dataModel: this.dataModel,
+                    },
+                    message: `createData failed, Create new "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                        `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                    issuer,
+                });
+            }
+        });
+        return this.stringifyDataId(newData, 'createData');
+    }
+    /**
+     * Find data by _id and update
+     * @param data data
+     * @returns data
+     */
+    async modifyData(data, issuer, dontUpdateModified) {
+        if (this.dataParams.forbidModify) {
+            await this.modifyThrowMethod(data, issuer);
+        }
+        if (!dontUpdateModified) {
+            data.__lastModified = new Date();
+            data.__lastModifiedBy = issuer;
+        }
+        // AT-REST field-encryption (opt-in): az encrypt:true mezőket a persist ELŐTT titkosítjuk, egy
+        // KLÓNON. KRITIKUS: a `findByIdAndUpdate` MEGKERÜLI a mongoose settereket/pre-save-hookokat, ezért
+        // a titkosítás itt, app-rétegben történik (nem mongoose-hookban). A hívó `data`-ja plaintext marad,
+        // így a `stringifyDataId(data)` alant no-op decrypttel a plaintextet adja vissza. NO-OP enc-mező nélkül.
+        const encData = field_encryption_util_1.DyNTS_FieldEncryption_Util.encryptDoc(data, this.dataParams.properties);
+        /**
+         * EZ A SZAR TELJESEN SZAR, nem friss, nem a db-be mentett adatokat ad vissza,
+         * átír random value-kat össze vissza, WTF
+         * */
+        /* let newData: T = */
+        await this.dataModel.findByIdAndUpdate(data._id, encData) /* .then((res) => {
+          if (res) {
+            //return res?.toObject() as T;
+          } else {
+            throw new DyFM_Error({
+              ...this._getDefaultErrorSettings(
+                'modifyData',
+                new Error(`modifyData failed, modify "${this.dataParams.dataName}" result not found! (NTS DB)`),
+                issuer,
+              ),
+    
+              status: 204,
+              errorCode: `${DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FU1`,
+              additionalContent: { data },
+              issuer,
+            });
+          }
+        }) */
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('modifyData', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FU0`,
+                additionalContent: { data },
+                message: `modifyData "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+        return this.stringifyDataId(data, 'modifyData');
+    }
+    // TODO: Missing issuer
+    /**
+     * returns data by _id,
+     * @param id id
+     * @returns data
+     */
+    async getDataById(id) {
+        if (!id) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataById', new Error(`No ID provided! (NTS DB)`)),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GI1`,
+                message: `get "${this.dataParams.dataName}" by ID was unsuccessful (NTS DB)`,
+            });
+        }
+        const data = await this.dataModel
+            .findById(id)
+            .then((res) => res?.toObject() ?? null)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataById', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GI0`,
+                additionalContent: { id },
+                message: `get "${this.dataParams.dataName}" by ID was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        return this.stringifyDataId(data, 'getDataById');
+    }
+    // TODO: Missing issuer
+    /**
+     * get data by dependency data id,
+     * !!!: throws error if not found (errorCode on not found: NTS-DBS-GD2)
+     *
+     * @param dependencyIdsFilter id
+     * @returns data
+     */
+    async getDataByDependencyId(dependencyIdsFilter) {
+        if (!this.depKeys.length) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataByDependencyId', new Error(`dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`)),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GD0`,
+            });
+        }
+        const data = await this.dataModel
+            .findOne(dependencyIdsFilter)
+            .then((res) => res?.toObject() ?? null)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataByDependencyId', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GD1`,
+                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
+                message: `get "${this.dataParams.dataName}" by ` +
+                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        return this.stringifyDataId(data, 'getDataByDependencyId');
+    }
+    // TODO: Missing issuer
+    async getDataListByIds(ids, findDeleted) {
+        const dataList = await this.dataModel
+            .find({ _id: { $in: ids } })
+            .then((res) => res ?? [])
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataListByIds', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GDL0`,
+                additionalContent: { ids },
+                message: `get "${this.dataParams.dataName}" by IDs was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        if (!findDeleted) {
+            return dataList.filter((data) => !data._deleted).map((data) => this.stringifyDataId(data, 'getDataListByDependencyId'));
+        }
+        else {
+            return dataList.map((data) => this.stringifyDataId(data, 'getDataListByDependencyId'));
+        }
+    }
+    // TODO: Missing issuer
+    /**
+     * get data by dependency data id,
+     * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLD2)
+     *
+     * @param dependencyIdsFilter id
+     * @returns dataList
+     */
+    async getDataListByDependencyId(dependencyIdsFilter, findDeleted) {
+        if (!this.depKeys.length) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataListByDependencyId', new Error(`isDependencyHook not setted up for this dataModel (${this.dataParams.dataName}) (NTS DB)`)),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLD0`,
+                additionalContent: {
+                    dataModel: this.dataModel,
+                },
+            });
+        }
+        const dataList = await this.dataModel
+            .find(dependencyIdsFilter)
+            .then((res) => res ?? [])
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataListByDependencyId', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLD1`,
+                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
+                message: `get "${this.dataParams.dataName}" by ` +
+                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        if (!findDeleted) {
+            return dataList.filter((data) => !data._deleted).map((data) => this.stringifyDataId(data, 'getDataListByDependencyId'));
+        }
+        else {
+            return dataList.map((data) => this.stringifyDataId(data, 'getDataListByDependencyId'));
+        }
+    }
+    // TODO: Missing issuer
+    /**
+     * get multiple data objects by a list of DependencyIDs,
+     * !!!: throws error if not found (errorCode on not found: NTS-DBS-GLDS2)
+     *
+     * @param ids ids
+     * @returns dataList
+     */
+    async getDataListByDependencyIds(dependencyKey, dependencyIds, findDeleted) {
+        if (!this.depKeys.length) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataListByDependencyIds', new Error(`getDataListByDependencyIds not setted up for this db-service ` +
+                    `(${this.dataParams.dataName}) (NTS DB)`)),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLDS0`,
+            });
+        }
+        if (!dependencyIds?.length) {
+            return [];
+        }
+        if (!dependencyKey) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataListByDependencyIds', new Error(`dependencyKey is missing! (${this.dataParams.dataName}) (NTS DB)`)),
+            });
+        }
+        if (!this.depKeys.includes(dependencyKey)) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataListByDependencyIds', new Error(`dependencyKey is not valid! (${dependencyKey}) (NTS DB)`)),
+            });
+        }
+        const dataList = await this.dataModel
+            .find({
+            [dependencyKey]: { $in: dependencyIds },
+        })
+            .then((res) => res ?? [])
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDataListByDependencyIds', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GLDS1`,
+                additionalContent: { dependencyIds },
+                message: `get "${this.dataParams.dataName}" by "${dependencyKey}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        if (!findDeleted) {
+            return dataList.filter((data) => !data._deleted).map((data) => this.stringifyDataId(data, 'getDataListByDependencyIds'));
+        }
+        else {
+            return dataList.map((data) => this.stringifyDataId(data, 'getDataListByDependencyIds'));
+        }
+    }
+    // TODO: Missing issuer
+    /**
+     * returns all data from database,
+     * !!!: throws error if not found (errorCode on not found: NTS-DBS-GA1)
+     *
+     * @returns dataList
+     */
+    async getAll(findDeleted) {
+        const dataList = await this.dataModel
+            .find()
+            .then((res) => res ?? [])
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getAll', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GA0`,
+                message: `get all "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        if (!findDeleted) {
+            return dataList.filter((data) => !data._deleted).map((data) => this.stringifyDataId(data, 'getAll'));
+        }
+        else {
+            return dataList.map((data) => this.stringifyDataId(data, 'getAll'));
+        }
+    }
+    async markDeletedById(id, issuer) {
+        if (this.dataParams.forbidDelete) {
+            await this.deleteThrowMethod(id, issuer);
+        }
+        await this.dataModel.findByIdAndUpdate(id, {
+            _deleted: new Date(),
+            _deletedBy: issuer,
+        }).catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('markDeletedById', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-MD0`,
+                additionalContent: { id },
+                message: `mark deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+    }
+    async markDeletedByDependencyId(dependencyIdsFilter, issuer) {
+        if (this.dataParams.forbidDelete) {
+            await this.deleteThrowMethod(dependencyIdsFilter, issuer);
+        }
+        await this.dataModel.updateMany(dependencyIdsFilter, {
+            _deleted: new Date(),
+            _deletedBy: issuer,
+        }).catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('markDeletedByDependencyId', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-MDD0`,
+                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
+                message: `markDeleted "${this.dataParams.dataName}" by ` +
+                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+    }
+    async restoreDeletedById(id, issuer) {
+        await this.dataModel.findByIdAndUpdate(id, {
+            _deleted: null,
+            __lastModified: new Date(),
+            __lastModifiedBy: issuer,
+        }).catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('restoreDeletedById', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-RD0`,
+                additionalContent: { id },
+                message: `restoreDeleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+    }
+    async restoreDeletedByDependencyId(dependencyIdsFilter, issuer) {
+        await this.dataModel.updateMany(dependencyIdsFilter, {
+            _deleted: null,
+            __lastModified: new Date(),
+            __lastModifiedBy: issuer,
+        }).catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('restoreDeletedByDependencyId', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-RDD0`,
+                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
+                message: `restoreDeleted "${this.dataParams.dataName}" by ` +
+                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+    }
+    // TODO: Missing issuer
+    async getDeletedDataList() {
+        const dataList = await this.dataModel
+            .getAll()
+            .then((res) => res ?? [])
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('getDeletedData', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GDD0`,
+                message: `get deleted "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        return dataList.filter((data) => Boolean(data._deleted)).map((data) => this.stringifyDataId(data, 'getDeletedData'));
+    }
+    // TODO: Missing issuer
+    /**
+     * deleted data by id
+     * @param id id
+     */
+    async trueDeleteDataById(id) {
+        if (this.dataParams.forbidDelete) {
+            await this.deleteThrowMethod(id /* , issuer */);
+        }
+        await this.dataModel
+            .findByIdAndDelete(id)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('deleteDataById', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DD0`,
+                additionalContent: { id },
+                message: `delete "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+    }
+    deleteDataById = this.trueDeleteDataById;
+    // TODO: Missing issuer
+    /**
+     * deleted data by id
+     * @param dependencyId id
+     */
+    async trueDeleteDataByDependencyId(dependencyIdsFilter) {
+        if (this.dataParams.forbidDelete) {
+            await this.deleteThrowMethod(dependencyIdsFilter /* , issuer */);
+        }
+        if (!this.depKeys.length) {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('deleteDataByDependencyId', new Error(`dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`)),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DDD0`,
+            });
+        }
+        await this.dataModel
+            .deleteMany(dependencyIdsFilter)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('deleteDataByDependencyId', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DDD1`,
+                additionalContent: { dependencyIdsFilter: dependencyIdsFilter },
+                message: `delete "${this.dataParams.dataName}" by ` +
+                    `"${Object.keys(dependencyIdsFilter).join(', ')}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+    }
+    deleteDataByDependencyId = this.trueDeleteDataByDependencyId;
+    // TODO: Missing issuer
+    async trueDeleteAllData() {
+        if (this.dataParams.forbidDelete) {
+            await this.deleteThrowMethod(null /* , issuer */);
+        }
+        await this.dataModel.deleteMany().catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('deleteAllData', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-DAD0`,
+                message: `delete all "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+    }
+    deleteAllData = this.trueDeleteAllData;
+    // TODO: Missing issuer
+    /**
+     * returns search result for searchBy object params
+     * can use lists or xRange values for searchBy obj properties
+     *
+     * @param filterBy filter
+     * @param narrowByDependencyIds id
+     * @returns dataList
+     */
+    /**
+     * BFR-AM-013 — LEAN + projektált + BATCH-elt cursor-scan (OOM-safe nagy collection-ökhöz).
+     *
+     * A teljes result-set SOSEM él egyszerre a heapen: a Mongo-cursor batch-enként adagolja a
+     * PLAIN (lean, nem-Mongoose-doc) objektumokat a `handler`-nek — a Mongoose-doc-boxing tranziens
+     * (a 32k-vektoros LVS-hidratálás 93%-heap-spike-jának gyökere) kimarad. A `projection`-nel csak
+     * a szükséges mezők jönnek (pl. `{ vectorId: 1, embedding: 1 }` a content-szöveg NÉLKÜL).
+     * Visszaadja a feldolgozott dokumentumok számát.
+     */
+    async findLeanBatched(filterBy, set) {
+        const batchSize = set.batchSize && set.batchSize > 0 ? set.batchSize : 500;
+        const cursor = this.dataModel.find(filterBy, set.projection).lean().cursor();
+        let batch = [];
+        let total = 0;
+        for await (const doc of cursor) {
+            batch.push(doc);
+            total++;
+            if (batch.length >= batchSize) {
+                await set.handler(batch);
+                batch = [];
+            }
+        }
+        if (batch.length) {
+            await set.handler(batch);
+        }
+        return total;
+    }
+    async searchData(filterBy, narrowByDependencyIds, narrowByDependencyKey, findDeleted) {
+        const filter = {};
+        if (0 < narrowByDependencyIds.length) {
+            if (!this.depKeys.length) {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('searchData', new Error(`dependencyDataIdKey not setted up for this db-service (${this.dataParams.dataName}) (NTS DB)`)),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-SD0`,
+                });
+            }
+            if (!narrowByDependencyKey) {
+                if (this.depKeys.length === 1) {
+                    narrowByDependencyKey = this.depKeys[0];
+                }
+                else {
+                    throw new fsm_dynamo_1.DyFM_Error({
+                        ...this._getDefaultErrorSettings('searchData', new Error(`dependencyKey is missing! (${this.dataParams.dataName}) (NTS DB)`)),
+                    });
+                }
+            }
+            filter[narrowByDependencyKey] = { $in: narrowByDependencyIds };
+        }
+        Object.values(this.dataParams.properties).forEach((modelParam) => {
+            if ((filterBy[modelParam.key] !== null && filterBy[modelParam.key] !== undefined) ||
+                filterBy[modelParam.key + 'Range']) {
+                if (modelParam.key.includes('Range') || modelParam.type.includes('[]')) {
+                    // inverz search filter (for Range and Array functions)
+                    if (modelParam.key.includes('Range')) {
+                        const searchParamKeyWithoutRange = modelParam.key.split('Range')[0];
+                        if (filterBy[searchParamKeyWithoutRange] !== null &&
+                            filterBy[searchParamKeyWithoutRange] !== undefined) {
+                            filter[modelParam.key] = {
+                                from: { $lte: filterBy[searchParamKeyWithoutRange] },
+                                to: { $gte: filterBy[searchParamKeyWithoutRange] },
+                            };
+                        }
+                    }
+                    else {
+                        if (filterBy[modelParam.key] !== null &&
+                            filterBy[modelParam.key] !== undefined) {
+                            filter[modelParam.key] = { $in: filterBy[modelParam.key] };
+                        }
+                    }
+                }
+                else {
+                    // basic search filter
+                    if (filterBy[modelParam.key + 'Range']) {
+                        if (filterBy[modelParam.key + 'Range'].from ||
+                            filterBy[modelParam.key + 'Range'].to) {
+                            filter[modelParam.key] = {};
+                            if (filterBy[modelParam.key + 'Range'].from) {
+                                filter[modelParam.key].$gte = filterBy[modelParam.key + 'Range'].from;
+                            }
+                            if (filterBy[modelParam.key + 'Range'].to) {
+                                filter[modelParam.key].$lte = filterBy[modelParam.key + 'Range'].to;
+                            }
+                        }
+                    }
+                    else if (filterBy[modelParam.key] !== null &&
+                        filterBy[modelParam.key] !== undefined) {
+                        if (filterBy[modelParam.key].lenght > 0) {
+                            filter[modelParam.key] = { $in: filterBy[modelParam.key] };
+                        }
+                    }
+                }
+            }
+        });
+        let dataList = await this.dataModel
+            .find(filter)
+            .then((res) => res ?? [])
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('searchData', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-SD1`,
+                additionalContent: { filterBy, narrowByDependencyIds },
+                message: `search "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        if (!findDeleted && filterBy._deleted === undefined) {
+            dataList = dataList.filter((data) => !data._deleted);
+        }
+        return dataList.map((data) => this.stringifyDataId(data, 'searchData'));
+    }
+    // ----------------------------------------------------------------------------------
+    // ----------------------------------------------------------------------------------
+    // ----------------------------------------------------------------------------------
+    // DIRECT Basic MONGOOSE FUNCTIONS (with error handlings)
+    /**
+     * Find the data first by any of its parameters,
+     * !!!: throws error if not found (errorCode on not found: NTS-DBS-FO1)
+     *
+     * @param filterBy if you can, use unique parameters for find!
+     *
+     * @example
+     * // by email:
+     * { email: email }
+     * //
+     * @example
+     * // or by id that is in list:
+     * { userIds: { $in: this.userId } }
+     * // or by userIds:
+     * { userId: { $in: userIds } }
+     * //
+     * @example
+     * // or by number or Date that is Greater Than AND Less Than:
+     * { points: { $gt: 2, $lt: 14 } }
+     * // further tools (syntax matches with $gt):
+     * $eq:  // Matches values that are EQual to a specified value.
+     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
+     * $lte: // Matches values that are Less Than or Equal to a specified value.
+     * $ne:  // Matches all values that are Not Equal to a specified value.
+     * $nin: // Matches None of the values specified IN an array.
+     * //
+     * @returns {T} data: T
+     */
+    async findOne(filterBy) {
+        const data = await this.dataModel
+            .findOne(filterBy)
+            .then((res) => res ?? null)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('findOne', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FO0`,
+                additionalContent: { filterBy },
+                message: `findOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        return this.stringifyDataId(data, 'findOne');
+    }
+    /**
+     * #MONGOOSE FUNCTION
+     * Find the data first by any of its parameters,
+     * !!!: throws error if not found (errorCode on not found: NTS-DBS-F1)
+     *
+     * @param filterBy if you can, use unique parameters for find!
+     *
+     * @example
+     * // by email:
+     * { email: email }
+     * //
+     * @example
+     * // or by id that is in list:
+     * { userIds: { $in: this.userId } }
+     * // or by userIds:
+     * { userId: { $in: userIds } }
+     * //
+     * @example
+     * // or by number or Date that is Greater Than AND Less Than:
+     * { points: { $gt: 2, $lt: 14 } }
+     * // further tools (syntax matches with $gt):
+     * $eq:  // Matches values that are EQual to a specified value.
+     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
+     * $lte: // Matches values that are Less Than or Equal to a specified value.
+     * $ne:  // Matches all values that are Not Equal to a specified value.
+     * $nin: // Matches None of the values specified IN an array.
+     * //
+     * @param options BFR-008: opcionalis projection/limit/sort — DB-szinten szukit (a nagy mezok be sem toltodnek)
+     * @returns {T[]} dataList: T[]
+     */
+    async find(filterBy, findDeleted, options) {
+        // BFR-OVERSEER-008 — options megadasakor a soft-delete szures QUERY-szintre kerul: limit mellett a
+        // memoriabeli post-filter hibas darabszamot adna, projekcio mellett (kihagyott `_deleted` mezovel)
+        // hibasan atengedne a torolt dokumentumokat. A `_deleted` soft-delete-kor `new Date()`, egyebkent
+        // HIANYZIK → a Mongo `_deleted: null` (missing VAGY null) a post-filter `!data._deleted` ekvivalense.
+        const deletedGuardInQuery = !!options && !findDeleted && filterBy._deleted === undefined;
+        const effectiveFilter = deletedGuardInQuery
+            ? { ...filterBy, _deleted: null }
+            : filterBy;
+        // A szukites (select/sort/limit) DB-szinten tortenik → a nagy mezok be sem toltodnek a heap-be.
+        let query = this.dataModel.find(effectiveFilter);
+        if (options?.projection) {
+            query = query.select(options.projection);
+        }
+        if (options?.sort) {
+            query = query.sort(options.sort);
+        }
+        if (options?.limit) {
+            query = query.limit(options.limit);
+        }
+        let dataList = await query
+            .then((res) => res ?? [])
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('find', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-F0`,
+                additionalContent: { filterBy },
+                message: `find "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        if (!findDeleted && !deletedGuardInQuery && filterBy._deleted === undefined) {
+            dataList = dataList.filter((data) => !data._deleted);
+        }
+        return dataList.map((data) => this.stringifyDataId(data, 'find'));
+    }
+    /**
+     * #MONGOOSE FUNCTION
+     * Find the data first by any of its parameters
+     * WARNING: This function will not gives you back the total number of data in the database!
+     *
+     * @param filterBy if you can, use unique parameters for find!
+     *
+     * @example
+     * // by email:
+     * { email: email }
+     * //
+     * @example
+     * // or by id that is in list:
+     * { userIds: { $in: this.userId } }
+     * // or by userIds:
+     * { userId: { $in: userIds } }
+     * //
+     * @example
+     * // or by number or Date that is Greater Than AND Less Than:
+     * { points: { $gt: 2, $lt: 14 } }
+     * // further tools (syntax matches with $gt):
+     * $eq:  // Matches values that are EQual to a specified value.
+     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
+     * $lte: // Matches values that are Less Than or Equal to a specified value.
+     * $ne:  // Matches all values that are Not Equal to a specified value.
+     * $nin: // Matches None of the values specified IN an array.
+     * //
+     * @param page page
+     * @param pageSize pageSize
+     * @param sort
+     * @example
+     * // by dateTime (this uses the basic sort function):
+     * { dateTime: -1 }
+     * //
+     * @returns {T[]} dataList: T[]
+     */
+    async findWithPaging(filterBy, page, pageSize, sort) {
+        /* if (filterBy['_deleted'] === undefined) {
+          filterBy['_deleted'] = null;
+        } */
+        const dataList = await this.dataModel
+            .find(filterBy)
+            .sort(sort)
+            .skip(page * pageSize)
+            .limit(pageSize)
+            .then((res) => res ?? [])
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('findWithPaging', error),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-WP0`,
+                additionalContent: { filterBy, page, pageSize, sort },
+                message: `findWithPaging "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+            });
+        });
+        /* if ((filterBy as DyFM_DBFilterSimple<T>)._deleted === undefined) {
+          dataList = dataList.filter((data: T): boolean => !data._deleted);
+        } */
+        return dataList.map((data) => this.stringifyDataId(data, 'find'));
+    }
+    /**
+     * #MONGOOSE FUNCTION
+     * Find data by _id and update
+     *
+     * @param id id
+     * @param update update
+     * @returns data
+     */
+    async findByIdAndUpdate(id, update, issuer, dontUpdateModified) {
+        if (this.dataParams.forbidModify) {
+            await this.modifyThrowMethod(update, issuer);
+        }
+        if (!dontUpdateModified) {
+            update.__lastModified = new Date();
+            update.__lastModifiedBy = issuer;
+        }
+        const data = await this.dataModel
+            .findByIdAndUpdate(id, update)
+            .then((res) => res?.toObject() ?? null)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('findByIdAndUpdate', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FIU0`,
+                additionalContent: { id, update },
+                message: `findByIdAndUpdate "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+        return this.stringifyDataId(data, 'findByIdAndUpdate');
+    }
+    /**
+     * #MONGOOSE FUNCTION
+     * Atomi compare-and-set: filter-alapú find + update EGY műveletben, a MÓDOSÍTOTT dokumentum
+     * visszaadásával (BFR-FDPTOKENSERVICE-006).
+     *
+     * A `findByIdAndUpdate` (id-only, nem filterezhető) és az `updateOne` (filterezhető, de void —
+     * nem különíthető el a winner/loser konkurens state-átmenetnél) egyike sem elég CAS-hoz: egy
+     * state-machine `transitionStatus`-jellegű átmenetnél a filter a FELTÉTEL (pl. `{_id, status:
+     * 'locked'}`), és a visszatérő érték dönti el, hogy EZ a hívás nyerte-e az átmenetet.
+     * `null` = nincs match (a feltétel már nem áll — a versenytárs nyert / state-collision).
+     *
+     * A `__lastModified`/`forbidModify` szemantika a `findByIdAndUpdate`-tel EGYEZŐ (egységes
+     * update-viselkedés a base-ben); a `{ new: true }` a MÓDOSÍTOTT dokumentumot adja vissza.
+     */
+    async findOneAndUpdate(filterBy, update, issuer, dontUpdateModified) {
+        if (this.dataParams.forbidModify) {
+            await this.modifyThrowMethod(update, issuer);
+        }
+        if (!dontUpdateModified) {
+            update.__lastModified = new Date();
+            update.__lastModifiedBy = issuer;
+        }
+        const data = await this.dataModel
+            .findOneAndUpdate(filterBy, update, { new: true })
+            .then((res) => res?.toObject() ?? null)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('findOneAndUpdate', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-FOU0`,
+                additionalContent: { filterBy, update },
+                message: `findOneAndUpdate "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+        // no-match (CAS lost / feltétel nem áll): a null ÉRVÉNYES eredmény, nem hiba
+        if (!data) {
+            return null;
+        }
+        return this.stringifyDataId(data, 'findOneAndUpdate');
+    }
+    /**
+     * #MONGOOSE FUNCTION
+     * Find the data first by any of its parameters
+     *
+     * @param filter This uses the basic Mongoose updateOne.
+     * If you can, use unique parameters for find!
+     * @example
+     * // by email:
+     * { email: email }
+     * //
+     * @example
+     * // or by id that is in list:
+     * { userIds: { $in: this.userId } }
+     * // or by userIds:
+     * { userId: { $in: userIds } }
+     * //
+     * @example
+     * // or by number or Date that is Greater Than AND Less Than:
+     * { points: { $gt: 2, $lt: 14 } }
+     * // further tools (syntax matches with $gt):
+     * $eq:  // Matches values that are EQual to a specified value.
+     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
+     * $lte: // Matches values that are Less Than or Equal to a specified value.
+     * $ne:  // Matches all values that are Not Equal to a specified value.
+     * $nin: // Matches None of the values specified IN an array.
+     * //
+     *
+     * @param update this uses the basic Mongoose updateOne
+     * @example
+     * // increase a specific value (here by 15):
+     * { $inc: { popularity: 15 } }
+     * //
+     * @example
+     * // or add element to a list:
+     * { $push: { reactions: this.newReaction }
+     * // or add multiple elements to a list
+     * { $push: { schedule: {$each: [ monday, tuesday, wednesday ] } } }
+     * //
+     * @example
+     * // or all at once
+     * {
+     *   $inc: { popularity: this.newVote.amount },
+     *   emailVerified: true,
+     *   $push: { reactions: this.newReaction }
+     * }
+     * // further tools (syntax matches with $inc):
+     * $currentDate: // Sets the value of a field to current date, either as a Date or a Timestamp.
+     * $min:         // Only updates the field if the specified value is less than the existing field value.
+     * $max:         // Only updates the field if the specified value is greater than the existing field value.
+     * $mul:         // Multiplies the value of the field by the specified amount.
+     * $rename:      // Renames a field.
+     * $unset:       // Removes the specified field from a document. (set: "" to value)
+     * //
+     */
+    async updateOne(filterBy, update, issuer, dontUpdateModified) {
+        if (this.dataParams.forbidModify) {
+            await this.modifyThrowMethod(update, issuer);
+        }
+        if (!dontUpdateModified) {
+            update.__lastModified = new Date();
+            update.__lastModifiedBy = issuer;
+        }
+        await this.dataModel
+            .updateOne(filterBy, update)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('updateOne', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-UO0`,
+                additionalContent: { filterBy, update },
+                message: `updateOne "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+    }
+    /**
+     * #MONGOOSE FUNCTION
+     * update one parameter by a specific
+     *
+     * @param filter This uses the basic Mongoose updateMany.
+     * @example
+     * // by email:
+     * { email: email }
+     * //
+     * @example
+     * // or by id that is in list:
+     * { userIds: { $in: this.userId } }
+     * // or by userIds:
+     * { userId: { $in: userIds } }
+     * //
+     * @example
+     * // or by number or Date that is Greater Than AND Less Than:
+     * { points: { $gt: 2, $lt: 14 } }
+     * // further tools (syntax matches with $gt):
+     * $eq:  // Matches values that are EQual to a specified value.
+     * $gte: // Matches values that are Greater Than OR Equal to a specified value.
+     * $lte: // Matches values that are Less Than or Equal to a specified value.
+     * $ne:  // Matches all values that are Not Equal to a specified value.
+     * $nin: // Matches None of the values specified IN an array.
+     * //
+     *
+     * @param update this uses the basic Mongoose updateOne
+     * @example
+     * // increase a specific value (here by 15):
+     * { $inc: { popularity: 15 } }
+     * //
+     * @example
+     * // or add element to a list:
+     * { $push: { reactions: this.newReaction }
+     * // or add multiple elements to a list
+     * { $push: { schedule: {$each: [ monday, tuesday, wednesday ] } } }
+     * //
+     * @example
+     * // or all at once
+     * {
+     *   $inc: { popularity: this.newVote.amount },
+     *   emailVerified: true,
+     *   $push: { reactions: this.newReaction }
+     * }
+     * // further tools (syntax matches with $inc):
+     * $currentDate: // Sets the value of a field to current date, either as a Date or a Timestamp.
+     * $min:         // Only updates the field if the specified value is less than the existing field value.
+     * $max:         // Only updates the field if the specified value is greater than the existing field value.
+     * $mul:         // Multiplies the value of the field by the specified amount.
+     * $rename:      // Renames a field.
+     * $unset:       // Removes the specified field from a document. (set: "" to value)
+     * //
+     */
+    async updateMany(filterBy, update, issuer, dontUpdateModified) {
+        if (this.dataParams.forbidModify) {
+            await this.modifyThrowMethod(update, issuer);
+        }
+        if (!dontUpdateModified) {
+            update.__lastModified = new Date();
+            update.__lastModifiedBy = issuer;
+        }
+        await this.dataModel
+            .updateMany(filterBy, update)
+            .catch((error) => {
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings('updateMany', error, issuer),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-UM0`,
+                additionalContent: { filterBy, update },
+                message: `updateMany "${this.dataParams.dataName}" was unsuccessful (NTS DB)` +
+                    `\n  error: ${fsm_dynamo_1.DyFM_Error.getErrorMessage(error)}`,
+                issuer,
+            });
+        });
+    }
+    /**
+     * {
+        "mappings": {
+          "dynamic": true,
+          "fields": {
+            "embedding": {
+              "type": "knnVector",
+              "dimensions": 768
+            }
+          }
+        }
+      }
+     */
+    /**
+     *
+     * @param set db.collection.aggregate([
+        {
+          $vectorSearch: {
+            index: "index_neve",
+            queryVector: [a keresett embedding],
+            path: "title.embedding",
+            numCandidates: 100,
+            limit: 5
+          }
+        },
+        {
+          $vectorSearch: {
+            index: "index_neve",
+            queryVector: [a keresett embedding],
+            path: "description.embedding",
+            numCandidates: 100,
+            limit: 5
+          }
+        }
+      ]);
+     * @returns
+     */
+    async aggregate(set) {
+        return this.dataModel.aggregate(set);
+    }
+    // ----------------------------------------------------------------------------------
+    // ----------------------------------------------------------------------------------
+    // ----------------------------------------------------------------------------------
+    // PRIVATE FUNCTIONS
+    stringifyDataId(data, fnName) {
+        // AT-REST field-decryption (opt-in): ez a KÖZÖS read+write post-processor (minden read + a
+        // create/modify EREDMÉNYE is átmegy rajta), ezért itt fejtjük vissza az encrypt:true envelope-
+        // mezőket load után. NO-OP, ha nincs encrypt:true mező (ugyanaz a referencia — nulla változás).
+        data = field_encryption_util_1.DyNTS_FieldEncryption_Util.decryptDoc(data, this.dataParams.properties);
+        if (data?._id && (typeof data._id !== 'string' || typeof data._id === 'object')) {
+            data._id = `${data._id}`;
+            if (typeof data._id !== 'string' || typeof data._id === 'object') {
+                data = JSON.parse(JSON.stringify(data));
+                if (typeof data._id !== 'string' || typeof data._id === 'object') {
+                    fsm_dynamo_1.DyFM_Log.error(`data._id stringifying failed! Please notfiy the DynamoNTS developers! (${fnName})`, new Error());
+                }
+            }
+        }
+        return data;
+    }
+    _getDefaultErrorSettings(fnName, error, issuer) {
+        return {
+            status: error?.___status ?? 500,
+            message: error?.message ??
+                error?._message ??
+                `${fnName} was UNSUCCESSFUL (NTS-DB)`,
+            addECToUserMsg: !error?.__userMessage,
+            userMessage: error?.__userMessage ?? this.defaultErrorUserMsg,
+            issuer: issuer,
+            issuerService: this.serviceName,
+            error: error,
+        };
+    }
+    // ----------------------------------------------------------------------------------
+    // PRIVATE BUILD FUNCTIONS
+    /**
+     * builds and returns mongoose schema
+     * @returns schema
+     */
+    getSchema() {
+        this.dataParams.properties = this.addMetadataToProperties(this.dataParams.properties);
+        if (this.dataParams.dataName.includes(archive_util_1.DyNTS_archiveSuffix)) {
+            this.dataParams.properties = this.addArchiveMetadataToProperties(this.dataParams.properties);
+        }
+        const schemaSettings = this.buildMongooseSchemaSettingsObjByModelParams(this.dataParams.properties);
+        /* schema = this.addMetadataToSchema(schema); */
+        /* if (this.dataParams.dataName.includes(DyNTS_archiveSuffix)) {
+          schema = this.addArchiveMetadataToSchema(schema);
+        } */
+        if (schemaSettings['_id']) {
+            delete schemaSettings['_id'];
+        }
+        return new mongoose_1.Schema(schemaSettings);
+    }
+    /**
+     * builds mongoose schema building settings object by dynamoDataModelParamsList
+     * @param properties DynamoNTSDataPropertyParams
+     * @returns mongoose schema object
+     */
+    buildMongooseSchemaSettingsObjByModelParams(properties) {
+        const schemaSettingsObj = {};
+        /* if (!properties) {
+          properties = this.dataParams.properties;
+        } */
+        Object.values(properties).forEach((property) => {
+            if (!property) {
+                fsm_dynamo_1.DyFM_Log.warn(`property is undefined on "${this.dataParams.dataName}" (NTS DB)`);
+                return;
+            }
+            if (!property.key) {
+                const missingKeys = Object.keys(properties).filter((key) => !properties[key].key);
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('buildMongooseSchemaByModelParams', new Error(`property.key is undefined on "${this.dataParams.dataName}" (NTS DB) ` +
+                        `(keys: ${Object.keys(properties).join(', ')}) ` +
+                        `(missing keys: ${missingKeys.join(', ')})`)),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-BMSBP0`,
+                    additionalContent: {
+                        property: property,
+                        dataParams: this.dataParams,
+                        missingKeys: missingKeys,
+                    },
+                });
+            }
+            if (property.forbidden) {
+                return;
+            }
+            const beType = this.getBEType(property.type);
+            /* TODO if (beType === Array && property.archiveable && !property.archiveListAfter) {
+              property.archiveListAfter = DyNTS_global_settings.archiveListAfter;
+            } */
+            if (beType !== Object ||
+                !property?.subObjectParams ||
+                (property?.subObjectParams &&
+                    Object.keys(property.subObjectParams).length == 0)) {
+                schemaSettingsObj[property.key] = {
+                    type: beType,
+                };
+                if (property.index) {
+                    schemaSettingsObj[property.key].index = true;
+                }
+                if (property.unique) {
+                    schemaSettingsObj[property.key].unique = true;
+                }
+                if (property.required) {
+                    schemaSettingsObj[property.key].required = true;
+                }
+                if (property.minlength) {
+                    schemaSettingsObj[property.key].minlength = property.minlength;
+                }
+                if (property.maxlength) {
+                    schemaSettingsObj[property.key].maxlength = property.maxlength;
+                }
+            }
+            else {
+                schemaSettingsObj[property.key] = this.buildMongooseSchemaSettingsObjByModelParams(property.subObjectParams);
+            }
+        });
+        return schemaSettingsObj;
+    }
+    getBEType(type) {
+        switch (type) {
+            case fsm_dynamo_1.DyFM_BasicProperty_Type.string:
+                return String;
+            case fsm_dynamo_1.DyFM_BasicProperty_Type.number:
+                return Number;
+            case fsm_dynamo_1.DyFM_BasicProperty_Type.boolean:
+                return Boolean;
+            case fsm_dynamo_1.DyFM_BasicProperty_Type.date:
+                return Date;
+            case fsm_dynamo_1.DyFM_BasicProperty_Type.object:
+                return Object;
+            case fsm_dynamo_1.DyFM_BasicProperty_Type.array:
+                return Array;
+            case fsm_dynamo_1.DyFM_BasicProperty_Type.function:
+                return Function;
+            default:
+                fsm_dynamo_1.DyFM_Log.H_info('wtf', fsm_dynamo_1.DyFM_Object.cleanObject(this.dataParams));
+                throw new fsm_dynamo_1.DyFM_Error({
+                    error: new Error(`Invalid property type: "${type}" (${this.dataParams.dataName})` +
+                        (this.dataParams.constructed?.() ? '' : ('\nThe dataParams is not constructed properly! \n' +
+                            'Use the DyFM_DataModel_Params.constructor to construct it properly!'))),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-GTP0`,
+                    additionalContent: { type: type, dataParams: this.dataParams },
+                    __localStack: this.dataParams.stackLocation,
+                });
+        }
+        /* switch (type.toLocaleLowerCase()) {
+          case DyFM_BasicProperty_Type.string:
+          case 'string':
+            return String;
+            
+          case DyFM_BasicProperty_Type.number:
+          case 'number':
+            return Number;
+    
+          case DyFM_BasicProperty_Type.boolean:
+          case 'boolean':
+            return Boolean;
+    
+          case DyFM_BasicProperty_Type.date:
+          case 'date':
+            return Date;
+    
+          case DyFM_BasicProperty_Type.object:
+          case 'object':
+            return Object;
+    
+          case DyFM_BasicProperty_Type.array:
+          case 'array':
+            return Array;
+            
+          default:
+            if (type.includes('[]') || type.includes('array')) {
+              return Array;
+            } else if (type.includes('=>') || type.includes('function')) {
+              return Function;
+            } else {
+              return Object;
+            }
+        } */
+    }
+    /**
+     * adds dynamo metadata settings to any mongoose schema building settings object
+     * @param schema schema to update
+     * @returns updated schema
+     */
+    /* private addMetadataToSchema(schema: any): any {
+      schema.__created = { type: Date };
+      schema.__createdBy = { type: String };
+      schema.__lastModified = { type: Date };
+      schema.__lastModifiedBy = { type: String };
+  
+      schema._deleted = { type: Date };
+      schema._deletedBy = { type: String };
+      
+      return schema;
+    } */
+    /**
+     * adds dynamo metadata settings to any mongoose schema building settings object
+     * @param properties properties to update
+     * @returns updated properties
+     */
+    addMetadataToProperties(properties) {
+        // TOD: ezek a kikommentelt "required: true"-k kellenek, csak félő, hogy gondokat okoznak a 
+        // jelenlegi rendszerekben, ezért akkor kell majd visszarakni, ha lesz tesztelői ÉS fejlesztői kapacitás rá
+        if (!properties.__created) {
+            properties.__created = {
+                key: '__created', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date /* , required: true */,
+            };
+        }
+        if (!properties.__createdBy) {
+            properties.__createdBy = {
+                key: '__createdBy', type: fsm_dynamo_1.DyFM_BasicProperty_Type.string /* , required: true */,
+            };
+        }
+        if (!properties.__lastModified) {
+            properties.__lastModified = {
+                key: '__lastModified', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date /* , required: true */,
+            };
+        }
+        if (!properties.__lastModifiedBy) {
+            properties.__lastModifiedBy = {
+                key: '__lastModifiedBy', type: fsm_dynamo_1.DyFM_BasicProperty_Type.string /* , required: true */,
+            };
+        }
+        if (!properties._deleted) {
+            properties._deleted = {
+                key: '_deleted', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date,
+            };
+        }
+        if (!properties._deletedBy) {
+            properties._deletedBy = {
+                key: '_deletedBy', type: fsm_dynamo_1.DyFM_BasicProperty_Type.string,
+            };
+        }
+        if (!properties._archived) {
+            properties._archived = {
+                key: '_archived', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date,
+            };
+        }
+        return properties;
+    }
+    /* private addArchiveMetadataToSchema(schema: any): any {
+      schema._originalId = { type: String, required: true, index: true, unique: true };
+      schema._archived = { type: Date, required: true };
+  
+      return schema;
+    } */
+    addArchiveMetadataToProperties(properties) {
+        if (!properties._originalId) {
+            properties._originalId = {
+                key: '_originalId', type: fsm_dynamo_1.DyFM_BasicProperty_Type.string,
+                required: true, index: true, unique: true,
+            };
+        }
+        if (!properties._archived) {
+            properties._archived = {
+                key: '_archived', type: fsm_dynamo_1.DyFM_BasicProperty_Type.date,
+                required: true,
+            };
+        }
+        else if (properties._archived.required === undefined) {
+            properties._archived.required = true;
+        }
+        return properties;
+    }
+    /**
+     * sets depDataKey
+     */
+    lookForDependencyDataSettings() {
+        const dependencyParams = Object.values(this.dataParams.properties).filter((modelParams) => Boolean(modelParams.dependencyDataName));
+        if (dependencyParams) {
+            this.depKeys.push(...dependencyParams.map((dependencyParam) => dependencyParam.key));
+        }
+    }
+    async deleteThrowMethod(data, issuer) {
+        throw new fsm_dynamo_1.DyFM_Error({
+            error: new Error(`Forbidden to delete any data! (${this.dataParams.dataName})`),
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-CDAD`,
+            additionalContent: { dataParams: this.dataParams, data: data },
+            issuer: issuer,
+        });
+    }
+    ;
+    async modifyThrowMethod(data, issuer) {
+        throw new fsm_dynamo_1.DyFM_Error({
+            error: new Error(`Forbidden to modify any data! (${this.dataParams.dataName})`),
+            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-DBS-CDAD`,
+            additionalContent: { dataParams: this.dataParams, data: data },
+            issuer: issuer,
+        });
+    }
+}
+exports.DyNTS_DBService = DyNTS_DBService;
 //# sourceMappingURL=db.service.js.map