@futdevpro/nts-dynamo 1.15.154 → 1.15.156

package/build/_services/core/api.service.js

@@ -1,457 +1,457 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyNTS_ApiService = void 0;
-const tslib_1 = require("tslib");
-const Axios = tslib_1.__importStar(require("axios"));
-const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
-const global_settings_const_1 = require("../../_collections/global-settings.const");
-/**
- * This predefined Api service contains the basic API call function which can be used in various ways
- */
-class DyNTS_ApiService {
-    static defaultErrorUserMsg = `We encountered a BackEnd API Error, ` +
-        `\nplease contact the responsible development team.\n` +
-        `\n(Internal BE to BE error)`;
-    /**
-     * if the callParams.getFullResponse is set to true,
-     * use the Axios.AxiosResponse type as T_Response
-     *
-     * @param callParams
-     * @param inputParams
-     * @returns
-     */
-    static async startApiCall(
-    /**
-     * you must setup the basic api call params with this.
-     * follow the instructions in the constructor: new DyNTS_ApiCall_Params({ ... })
-     */
-    callParams, 
-    /**
-     * you can pass data and other inputs in this section
-     */
-    inputParams) {
-        let url;
-        try {
-            let a;
-            url = callParams.baseUrl + callParams.endpoint;
-            const axios = Axios.default.create();
-            if (!callParams.baseUrl) {
-                fsm_dynamo_1.DyFM_Log.warn(`WARNING: missing baseUrl in api call (${callParams.name})`);
-            }
-            if (!callParams.endpoint) {
-                fsm_dynamo_1.DyFM_Log.warn(`WARNING: missing endpoint in api call (${callParams.name})`);
-            }
-            if (callParams.pathParamKeys.length) {
-                callParams.pathParamKeys.forEach(key => {
-                    if (!inputParams?.pathParams?.[key]) {
-                        throw new fsm_dynamo_1.DyFM_Error({
-                            ...this._getDefaultErrorSettings('startApiCall', new Error(`missing pathParam: "${key}" (${callParams.name})`)),
-                            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SAC1`,
-                        });
-                    }
-                });
-            }
-            if (callParams?.httpOptions) {
-                this.setupAxiosConfig(callParams, axios);
-            }
-            if (inputParams?.pathParams) {
-                url = this.setupPathParams(inputParams.pathParams, url, callParams);
-            }
-            /* if (inputParams?.queryParams) {
-              this.setupQueryParams<T_Body>(inputParams, callParams);
-            } */
-            if (global_settings_const_1.DyNTS_global_settings.log_settings.api_events) {
-                this.logEvent(url, inputParams, callParams);
-            }
-            switch (callParams.type) {
-                case fsm_dynamo_1.DyFM_HttpCallType.get:
-                    if (inputParams?.body) {
-                        fsm_dynamo_1.DyFM_Log.warn(`WARNING you cant send body in get calls (${callParams.name})`);
-                    }
-                    a = await this.get(axios, url, callParams);
-                    break;
-                case fsm_dynamo_1.DyFM_HttpCallType.delete:
-                    if (inputParams?.body) {
-                        fsm_dynamo_1.DyFM_Log.warn('WARNING you cant send body in delete calls');
-                    }
-                    a = await this.delete(axios, url, callParams);
-                    break;
-                case fsm_dynamo_1.DyFM_HttpCallType.post:
-                case fsm_dynamo_1.DyFM_HttpCallType.put:
-                case fsm_dynamo_1.DyFM_HttpCallType.patch:
-                    if (!inputParams?.body) {
-                        if (!inputParams) {
-                            inputParams = {};
-                        }
-                        inputParams.body = {};
-                    }
-                    a = await this.postPutPatch(axios, callParams, url, inputParams);
-                    break;
-                default:
-                    throw new fsm_dynamo_1.DyFM_Error({
-                        ...this._getDefaultErrorSettings('startApiCall', new Error(`unknown api call type: ${callParams.type}`)),
-                        errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SAC0`,
-                        additionalContent: {
-                            callParams,
-                            inputParams,
-                        },
-                    });
-            }
-            if (a?.flag?.includes(fsm_dynamo_1.DyFM_errorFlag)) {
-                throw a;
-            }
-            return a;
-            /* if (callParams.getFullResponse) {
-              return a as T_Response Axios.AxiosResponse;
-      
-            } else {
-              return a as T_Response;
-            } */
-        }
-        catch (error) {
-            if (error?.flag?.includes(fsm_dynamo_1.DyFM_errorFlag)) {
-                throw error;
-                /* } else if ((error?.response?.data as DyFM_Error)?.flag?.includes(DyFM_errorFlag) &&
-                  [
-                    DyFM_ErrorLevel.user,
-                    DyFM_ErrorLevel.debug,
-                    DyFM_ErrorLevel.info,
-                    DyFM_ErrorLevel.known,
-                    DyFM_ErrorLevel.warning,
-                  ].includes((error?.response?.data as DyFM_Error)?.level)
-                ) {
-                  return error; */
-            }
-            else {
-                this.handleError(callParams, error, inputParams, url);
-            }
-        }
-    }
-    /* private static setupQueryParams<T_Body = any>(
-      inputParams: DyNTS_ApiCallInputParams<T_Body>, callParams: DyNTS_ApiCall_Params) {
-      const httpParams = new HttpParams();
-  
-      for (const queryParamKey in inputParams.queryParams) {
-        if (inputParams.queryParams[queryParamKey]) {
-          switch (typeof inputParams.queryParams[queryParamKey]) {
-            case 'number':
-              httpParams.set(queryParamKey, inputParams.queryParams[queryParamKey].toString());
-              break;
-  
-            case 'string':
-              httpParams.set(queryParamKey, inputParams.queryParams[queryParamKey]);
-              break;
-  
-            default:
-              console.error('DYNAMO-NTS ERROR: \n wrong query param type', '\n\n', new Error());
-              break;
-          }
-        }
-      }
-      callParams.httpOptions.params = httpParams;
-    } */
-    static handleError(callParams, error, inputParams, url) {
-        const errorMsg = fsm_dynamo_1.DyFM_Error.isDyFMError(error?.response?.data) ?
-            fsm_dynamo_1.DyFM_Error.getAnyMessage(error?.response?.data) :
-            fsm_dynamo_1.DyFM_Error.getAnyMessage(error);
-        let msg = `\n--->   API ERROR: "${callParams?.name}" failed (${fsm_dynamo_1.DyFM_Error.getErrorStatus(error)})...` +
-            `\n         endpoint: ${callParams?.type} "${callParams?.baseUrl}${callParams?.endpoint}"` +
-            `\n         BE-BE requestStackLocation: "${callParams?.stack}"` +
-            `\n         error: "${fsm_dynamo_1.DyFM_Error.getAnyMessage(error)}"` +
-            (error?.__localStack ? `\n         error localStack: "${error?.__localStack}"` : '') +
-            `\n         localStack: "${(0, fsm_dynamo_1.DyFM_getLocalStackLocation)(1)}"`;
-        if (global_settings_const_1.DyNTS_global_settings.log_settings.detailedErrors) {
-            fsm_dynamo_1.DyFM_Log.S_error(`${msg}\ncallParams:`, callParams);
-        }
-        else {
-            fsm_dynamo_1.DyFM_Log.S_error(msg);
-        }
-        try {
-            const strError = JSON.stringify(error);
-            if (strError.length < 1000) {
-                msg += `\nerrorObject: ${JSON.stringify(strError, null, 2)}`;
-            }
-        }
-        catch {
-            fsm_dynamo_1.DyFM_Log.error(`error is not parsable`);
-        }
-        if (error &&
-            typeof error?.error === 'string' &&
-            callParams?.httpOptions?.responseType === fsm_dynamo_1.DyFM_HttpResponseType.text) {
-            error.error = fsm_dynamo_1.DyFM_Object.failableSafeParseJSON(error?.error);
-        }
-        if (fsm_dynamo_1.DyFM_Error.isDyFMError(error?.response?.data)) {
-            fsm_dynamo_1.DyFM_Log.error(`\n'${callParams.name}' was UNSUCCESSFUL` /* , new Error() */);
-            const dyfmErrorInAxiosResponse = error?.response?.data;
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings(callParams.name + ' startApiCall', dyfmErrorInAxiosResponse),
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-HE1`,
-                // BFR-DYNAMOBUILDER-006: a BELSŐ BE-BE URL (Docker-hostname+port) NEM kerülhet a _message-be —
-                // non-prod env-en a teljes error kimegy a kliensnek → info-disclosure. A _message csak a
-                // hívás NEVÉT hordozza; az URL + callParams a confidentialContent-be megy (error-store-ba
-                // perzisztálódik, a response-strip env-FÜGGETLENÜL levágja).
-                message: `API call "${callParams.name}" failed on the other end!` +
-                    `\nerror response found: ${errorMsg}`,
-                error: dyfmErrorInAxiosResponse,
-                additionalContent: {
-                    callName: callParams.name,
-                },
-                confidentialContent: {
-                    url: url,
-                    callParams: callParams,
-                    inputParams: inputParams,
-                    response: error?.response,
-                },
-            });
-        }
-        else if (error?.code === 'ENOTFOUND') {
-            fsm_dynamo_1.DyFM_Log.error(`\n'${callParams.name}' was UNSUCCESSFUL` /* , new Error() */);
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings(callParams.name + ' startApiCall', error),
-                status: 404,
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-HE2`,
-                message: `DNS error; address cannot be resolved! (call: "${callParams.name}")`,
-                additionalContent: {
-                    callName: callParams.name,
-                },
-                confidentialContent: {
-                    url: url,
-                    callParams: callParams,
-                    inputParams: inputParams,
-                    response: error?.response,
-                },
-            });
-        }
-        else if (error?.code === 'ECONNREFUSED') {
-            fsm_dynamo_1.DyFM_Log.error(`\n'${callParams.name}' was UNSUCCESSFUL` /* , new Error() */);
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings(callParams.name + ' startApiCall', error),
-                status: 404,
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-HE3`,
-                // BFR-DYNAMOBUILDER-006: az URL confidentialContent-be (nem a _message-be) — belső host-leak ellen.
-                message: `Can't connect to the endpoint! (call: "${callParams.name}")`,
-                additionalContent: {
-                    callName: callParams.name,
-                },
-                confidentialContent: {
-                    url: url,
-                    callParams: callParams,
-                    inputParams: inputParams,
-                    response: error?.response,
-                },
-            });
-        }
-        else if (error?.config && error?.message) {
-            let msg = error?.message;
-            let status = error?.response?.status ||
-                error?.status ||
-                /* get status from "status code {3 digits}" that might be in the middle of the message */
-                +error?.message?.match?.(/status code (\d{3})/)?.[1] ||
-                500;
-            if (error?.message?.includes('status code')) {
-                // BFR-DYNAMOBUILDER-006: a _message CSAK a hívás-nevet + path-param-KULCSOKAT hordozza —
-                // a belső endpoint/URL/stack a confidentialContent-be megy (response-ba SOHA).
-                msg += ` "${callParams.name}"` +
-                    `\npathParams: ${inputParams?.pathParams ?
-                        Object.keys(inputParams.pathParams).join(', ') :
-                        '-no path params-'}`;
-            }
-            throw new fsm_dynamo_1.DyFM_Error({
-                ...this._getDefaultErrorSettings(callParams.name + ' startApiCall', error),
-                status: status,
-                message: msg,
-                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-HE4`,
-                additionalContent: {
-                    callName: callParams.name,
-                },
-                confidentialContent: {
-                    url: url,
-                    endpoint: `${callParams.type} "${callParams.baseUrl}${callParams.endpoint}"`,
-                    endpointStackLocation: callParams.stack,
-                    callParams: callParams,
-                    inputParams: inputParams,
-                    response: error?.response,
-                },
-            });
-        }
-        else {
-            fsm_dynamo_1.DyFM_Error.logSimple(`"${callParams.name}" api call was UNSUCCESSFUL`, error);
-            /* if (
-              DyNTS_global_settings.log_settings.detailedErrors ||
-              !(error instanceof DyFM_Error)
-            ) {
-              DyFM_Log.error(
-                `"${callParams.name}" api call was UNSUCCESSFUL`,
-                '\nERROR:', error
-              );
-            } else {
-              error.logSimple(`"${callParams.name}" api call was UNSUCCESSFUL`);
-            } */
-            throw error;
-        }
-    }
-    static async postPutPatch(axios, callParams, url, inputParams) {
-        return await axios[callParams.type](url, inputParams.body, callParams.httpOptions).then((res) => {
-            if (global_settings_const_1.DyNTS_global_settings.log_settings.api_events) {
-                if (global_settings_const_1.DyNTS_global_settings.log_settings.api_responseContents) {
-                    fsm_dynamo_1.DyFM_Log.success(`--->   "${callParams.name}" api call was successful`, res.data);
-                }
-                else {
-                    fsm_dynamo_1.DyFM_Log.success(`--->   "${callParams.name}" api call was successful`);
-                }
-            }
-            if (callParams.getFullResponse) {
-                return res;
-            }
-            else {
-                return res.data;
-            }
-        });
-    }
-    static async delete(axios, url, callParams) {
-        return await axios.delete(url, callParams.httpOptions).then((res) => {
-            if (global_settings_const_1.DyNTS_global_settings.log_settings.api_events) {
-                if (global_settings_const_1.DyNTS_global_settings.log_settings.api_responseContents) {
-                    fsm_dynamo_1.DyFM_Log.success(`"${callParams.name}" api call was successful`, res.data);
-                }
-                else {
-                    fsm_dynamo_1.DyFM_Log.success(`"${callParams.name}" api call was successful`);
-                }
-            }
-            if (callParams.getFullResponse) {
-                return res;
-            }
-            else {
-                return res.data;
-            }
-        });
-    }
-    static async get(axios, url, callParams) {
-        return await axios.get(url, callParams.httpOptions).then((res) => {
-            if (global_settings_const_1.DyNTS_global_settings.log_settings.api_events) {
-                if (global_settings_const_1.DyNTS_global_settings.log_settings.api_responseContents) {
-                    fsm_dynamo_1.DyFM_Log.success(`"${callParams.name}" api call was successful`, res.data);
-                }
-                else {
-                    fsm_dynamo_1.DyFM_Log.success(`"${callParams.name}" api call was successful`);
-                }
-            }
-            if (callParams.getFullResponse) {
-                return res;
-            }
-            else {
-                return res.data;
-            }
-        });
-    }
-    static logEvent(url, inputParams, callParams) {
-        if (global_settings_const_1.DyNTS_global_settings.log_settings.api_requestContents) {
-            fsm_dynamo_1.DyFM_Log.log(`<---   outgoing API call: "${callParams?.name}" ` +
-                `\n(${url})` +
-                `\nbody:`, inputParams?.body);
-        }
-        else {
-            fsm_dynamo_1.DyFM_Log.log(`<---   outgoing API call: "${callParams?.name}"`);
-        }
-        if (global_settings_const_1.DyNTS_global_settings.log_settings.api_requestSettings) {
-            fsm_dynamo_1.DyFM_Log.log(`callParams:`, callParams);
-            fsm_dynamo_1.DyFM_Log.log('inputParams:', {
-                pathParams: inputParams.pathParams ?? {},
-                body: inputParams.body ?? null,
-            });
-        }
-    }
-    static setupAxiosConfig(callParams, axios) {
-        // Ensure axios.defaults exists
-        if (!axios.defaults) {
-            fsm_dynamo_1.DyFM_Log.error(`ERROR: axios.defaults is undefined in setupAxiosConfig for call (cant set headers and other options): "${callParams.name}"`, '\n  stack:', callParams.stack);
-            return;
-        }
-        // Set headers
-        if (callParams.httpOptions?.headers) {
-            axios.defaults.headers.common ??= {};
-            for (const headerKey in callParams.httpOptions.headers) {
-                if (!callParams.httpOptions.headers[headerKey]) {
-                    throw new fsm_dynamo_1.DyFM_Error({
-                        ...this._getDefaultErrorSettings('setupHeaders', new Error(`missing header: ${headerKey}`)),
-                        errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SH0`,
-                    });
-                }
-                axios.defaults.headers.common[headerKey] = callParams.httpOptions.headers[headerKey];
-            }
-        }
-        // Set other Axios configuration options
-        if (callParams.httpOptions?.httpsAgent) {
-            axios.defaults.httpsAgent = callParams.httpOptions.httpsAgent;
-        }
-        if (callParams.httpOptions?.httpAgent) {
-            axios.defaults.httpAgent = callParams.httpOptions.httpAgent;
-        }
-        if (callParams.httpOptions?.timeout !== undefined) {
-            axios.defaults.timeout = callParams.httpOptions.timeout;
-        }
-        if (callParams.httpOptions?.maxRedirects !== undefined) {
-            axios.defaults.maxRedirects = callParams.httpOptions.maxRedirects;
-        }
-        if (callParams.httpOptions?.withCredentials !== undefined) {
-            axios.defaults.withCredentials = callParams.httpOptions.withCredentials;
-        }
-        if (callParams.httpOptions?.responseType !== undefined) {
-            axios.defaults.responseType = callParams.httpOptions.responseType;
-        }
-    }
-    static setupPathParams(pathParams, url, callParams) {
-        for (const pathParamKey in pathParams) {
-            if (pathParams[pathParamKey]) {
-                const paramType = typeof pathParams[pathParamKey];
-                switch (paramType) {
-                    case 'number':
-                        url = url.replace(`:${pathParamKey}`, pathParams[pathParamKey].toString());
-                        break;
-                    case 'string':
-                        url = url.replace(`:${pathParamKey}`, pathParams[pathParamKey]);
-                        break;
-                    default:
-                        /* DyFM_Log.error(
-                          `DYNAMO-NTS ERROR:`+
-                          `\nwrong path param type: (${pathParamKey}): ${paramType} ` +
-                          `\n${pathParams[pathParamKey]}` +
-                          `\nMUST BE string or number` +
-                          `\n\n`,
-                          new Error()
-                        ); */
-                        throw new fsm_dynamo_1.DyFM_Error({
-                            ...this._getDefaultErrorSettings('setupPathParams', new Error(`wrong path param type: (${pathParamKey}): "${paramType}" (${callParams.name})` +
-                                `\n${pathParams[pathParamKey]}`)),
-                            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SP1`,
-                            additionalContent: {
-                                pathParams: pathParams,
-                                url: url,
-                            },
-                        });
-                }
-            }
-            else {
-                throw new fsm_dynamo_1.DyFM_Error({
-                    ...this._getDefaultErrorSettings('setupPathParams', new Error(`missing pathParam: "${pathParamKey}" (${callParams.name})`)),
-                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SP0`,
-                });
-            }
-        }
-        return url;
-    }
-    static _getDefaultErrorSettings(fnName, error) {
-        return {
-            status: error?.___status ?? 500,
-            message: error?.message ??
-                error?._message ??
-                `${fnName} was UNSUCCESSFUL (NTS)`,
-            addECToUserMsg: !error?.__userMessage,
-            userMessage: error?.__userMessage ?? this.defaultErrorUserMsg,
-            issuerService: `${this?.constructor?.name}-${this?.name}-DyNTS_ApiService`,
-            error: error,
-        };
-    }
-}
-exports.DyNTS_ApiService = DyNTS_ApiService;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyNTS_ApiService = void 0;
+const tslib_1 = require("tslib");
+const Axios = tslib_1.__importStar(require("axios"));
+const fsm_dynamo_1 = require("@futdevpro/fsm-dynamo");
+const global_settings_const_1 = require("../../_collections/global-settings.const");
+/**
+ * This predefined Api service contains the basic API call function which can be used in various ways
+ */
+class DyNTS_ApiService {
+    static defaultErrorUserMsg = `We encountered a BackEnd API Error, ` +
+        `\nplease contact the responsible development team.\n` +
+        `\n(Internal BE to BE error)`;
+    /**
+     * if the callParams.getFullResponse is set to true,
+     * use the Axios.AxiosResponse type as T_Response
+     *
+     * @param callParams
+     * @param inputParams
+     * @returns
+     */
+    static async startApiCall(
+    /**
+     * you must setup the basic api call params with this.
+     * follow the instructions in the constructor: new DyNTS_ApiCall_Params({ ... })
+     */
+    callParams, 
+    /**
+     * you can pass data and other inputs in this section
+     */
+    inputParams) {
+        let url;
+        try {
+            let a;
+            url = callParams.baseUrl + callParams.endpoint;
+            const axios = Axios.default.create();
+            if (!callParams.baseUrl) {
+                fsm_dynamo_1.DyFM_Log.warn(`WARNING: missing baseUrl in api call (${callParams.name})`);
+            }
+            if (!callParams.endpoint) {
+                fsm_dynamo_1.DyFM_Log.warn(`WARNING: missing endpoint in api call (${callParams.name})`);
+            }
+            if (callParams.pathParamKeys.length) {
+                callParams.pathParamKeys.forEach(key => {
+                    if (!inputParams?.pathParams?.[key]) {
+                        throw new fsm_dynamo_1.DyFM_Error({
+                            ...this._getDefaultErrorSettings('startApiCall', new Error(`missing pathParam: "${key}" (${callParams.name})`)),
+                            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SAC1`,
+                        });
+                    }
+                });
+            }
+            if (callParams?.httpOptions) {
+                this.setupAxiosConfig(callParams, axios);
+            }
+            if (inputParams?.pathParams) {
+                url = this.setupPathParams(inputParams.pathParams, url, callParams);
+            }
+            /* if (inputParams?.queryParams) {
+              this.setupQueryParams<T_Body>(inputParams, callParams);
+            } */
+            if (global_settings_const_1.DyNTS_global_settings.log_settings.api_events) {
+                this.logEvent(url, inputParams, callParams);
+            }
+            switch (callParams.type) {
+                case fsm_dynamo_1.DyFM_HttpCallType.get:
+                    if (inputParams?.body) {
+                        fsm_dynamo_1.DyFM_Log.warn(`WARNING you cant send body in get calls (${callParams.name})`);
+                    }
+                    a = await this.get(axios, url, callParams);
+                    break;
+                case fsm_dynamo_1.DyFM_HttpCallType.delete:
+                    if (inputParams?.body) {
+                        fsm_dynamo_1.DyFM_Log.warn('WARNING you cant send body in delete calls');
+                    }
+                    a = await this.delete(axios, url, callParams);
+                    break;
+                case fsm_dynamo_1.DyFM_HttpCallType.post:
+                case fsm_dynamo_1.DyFM_HttpCallType.put:
+                case fsm_dynamo_1.DyFM_HttpCallType.patch:
+                    if (!inputParams?.body) {
+                        if (!inputParams) {
+                            inputParams = {};
+                        }
+                        inputParams.body = {};
+                    }
+                    a = await this.postPutPatch(axios, callParams, url, inputParams);
+                    break;
+                default:
+                    throw new fsm_dynamo_1.DyFM_Error({
+                        ...this._getDefaultErrorSettings('startApiCall', new Error(`unknown api call type: ${callParams.type}`)),
+                        errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SAC0`,
+                        additionalContent: {
+                            callParams,
+                            inputParams,
+                        },
+                    });
+            }
+            if (a?.flag?.includes(fsm_dynamo_1.DyFM_errorFlag)) {
+                throw a;
+            }
+            return a;
+            /* if (callParams.getFullResponse) {
+              return a as T_Response Axios.AxiosResponse;
+      
+            } else {
+              return a as T_Response;
+            } */
+        }
+        catch (error) {
+            if (error?.flag?.includes(fsm_dynamo_1.DyFM_errorFlag)) {
+                throw error;
+                /* } else if ((error?.response?.data as DyFM_Error)?.flag?.includes(DyFM_errorFlag) &&
+                  [
+                    DyFM_ErrorLevel.user,
+                    DyFM_ErrorLevel.debug,
+                    DyFM_ErrorLevel.info,
+                    DyFM_ErrorLevel.known,
+                    DyFM_ErrorLevel.warning,
+                  ].includes((error?.response?.data as DyFM_Error)?.level)
+                ) {
+                  return error; */
+            }
+            else {
+                this.handleError(callParams, error, inputParams, url);
+            }
+        }
+    }
+    /* private static setupQueryParams<T_Body = any>(
+      inputParams: DyNTS_ApiCallInputParams<T_Body>, callParams: DyNTS_ApiCall_Params) {
+      const httpParams = new HttpParams();
+  
+      for (const queryParamKey in inputParams.queryParams) {
+        if (inputParams.queryParams[queryParamKey]) {
+          switch (typeof inputParams.queryParams[queryParamKey]) {
+            case 'number':
+              httpParams.set(queryParamKey, inputParams.queryParams[queryParamKey].toString());
+              break;
+  
+            case 'string':
+              httpParams.set(queryParamKey, inputParams.queryParams[queryParamKey]);
+              break;
+  
+            default:
+              console.error('DYNAMO-NTS ERROR: \n wrong query param type', '\n\n', new Error());
+              break;
+          }
+        }
+      }
+      callParams.httpOptions.params = httpParams;
+    } */
+    static handleError(callParams, error, inputParams, url) {
+        const errorMsg = fsm_dynamo_1.DyFM_Error.isDyFMError(error?.response?.data) ?
+            fsm_dynamo_1.DyFM_Error.getAnyMessage(error?.response?.data) :
+            fsm_dynamo_1.DyFM_Error.getAnyMessage(error);
+        let msg = `\n--->   API ERROR: "${callParams?.name}" failed (${fsm_dynamo_1.DyFM_Error.getErrorStatus(error)})...` +
+            `\n         endpoint: ${callParams?.type} "${callParams?.baseUrl}${callParams?.endpoint}"` +
+            `\n         BE-BE requestStackLocation: "${callParams?.stack}"` +
+            `\n         error: "${fsm_dynamo_1.DyFM_Error.getAnyMessage(error)}"` +
+            (error?.__localStack ? `\n         error localStack: "${error?.__localStack}"` : '') +
+            `\n         localStack: "${(0, fsm_dynamo_1.DyFM_getLocalStackLocation)(1)}"`;
+        if (global_settings_const_1.DyNTS_global_settings.log_settings.detailedErrors) {
+            fsm_dynamo_1.DyFM_Log.S_error(`${msg}\ncallParams:`, callParams);
+        }
+        else {
+            fsm_dynamo_1.DyFM_Log.S_error(msg);
+        }
+        try {
+            const strError = JSON.stringify(error);
+            if (strError.length < 1000) {
+                msg += `\nerrorObject: ${JSON.stringify(strError, null, 2)}`;
+            }
+        }
+        catch {
+            fsm_dynamo_1.DyFM_Log.error(`error is not parsable`);
+        }
+        if (error &&
+            typeof error?.error === 'string' &&
+            callParams?.httpOptions?.responseType === fsm_dynamo_1.DyFM_HttpResponseType.text) {
+            error.error = fsm_dynamo_1.DyFM_Object.failableSafeParseJSON(error?.error);
+        }
+        if (fsm_dynamo_1.DyFM_Error.isDyFMError(error?.response?.data)) {
+            fsm_dynamo_1.DyFM_Log.error(`\n'${callParams.name}' was UNSUCCESSFUL` /* , new Error() */);
+            const dyfmErrorInAxiosResponse = error?.response?.data;
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings(callParams.name + ' startApiCall', dyfmErrorInAxiosResponse),
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-HE1`,
+                // BFR-DYNAMOBUILDER-006: a BELSŐ BE-BE URL (Docker-hostname+port) NEM kerülhet a _message-be —
+                // non-prod env-en a teljes error kimegy a kliensnek → info-disclosure. A _message csak a
+                // hívás NEVÉT hordozza; az URL + callParams a confidentialContent-be megy (error-store-ba
+                // perzisztálódik, a response-strip env-FÜGGETLENÜL levágja).
+                message: `API call "${callParams.name}" failed on the other end!` +
+                    `\nerror response found: ${errorMsg}`,
+                error: dyfmErrorInAxiosResponse,
+                additionalContent: {
+                    callName: callParams.name,
+                },
+                confidentialContent: {
+                    url: url,
+                    callParams: callParams,
+                    inputParams: inputParams,
+                    response: error?.response,
+                },
+            });
+        }
+        else if (error?.code === 'ENOTFOUND') {
+            fsm_dynamo_1.DyFM_Log.error(`\n'${callParams.name}' was UNSUCCESSFUL` /* , new Error() */);
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings(callParams.name + ' startApiCall', error),
+                status: 404,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-HE2`,
+                message: `DNS error; address cannot be resolved! (call: "${callParams.name}")`,
+                additionalContent: {
+                    callName: callParams.name,
+                },
+                confidentialContent: {
+                    url: url,
+                    callParams: callParams,
+                    inputParams: inputParams,
+                    response: error?.response,
+                },
+            });
+        }
+        else if (error?.code === 'ECONNREFUSED') {
+            fsm_dynamo_1.DyFM_Log.error(`\n'${callParams.name}' was UNSUCCESSFUL` /* , new Error() */);
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings(callParams.name + ' startApiCall', error),
+                status: 404,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-HE3`,
+                // BFR-DYNAMOBUILDER-006: az URL confidentialContent-be (nem a _message-be) — belső host-leak ellen.
+                message: `Can't connect to the endpoint! (call: "${callParams.name}")`,
+                additionalContent: {
+                    callName: callParams.name,
+                },
+                confidentialContent: {
+                    url: url,
+                    callParams: callParams,
+                    inputParams: inputParams,
+                    response: error?.response,
+                },
+            });
+        }
+        else if (error?.config && error?.message) {
+            let msg = error?.message;
+            let status = error?.response?.status ||
+                error?.status ||
+                /* get status from "status code {3 digits}" that might be in the middle of the message */
+                +error?.message?.match?.(/status code (\d{3})/)?.[1] ||
+                500;
+            if (error?.message?.includes('status code')) {
+                // BFR-DYNAMOBUILDER-006: a _message CSAK a hívás-nevet + path-param-KULCSOKAT hordozza —
+                // a belső endpoint/URL/stack a confidentialContent-be megy (response-ba SOHA).
+                msg += ` "${callParams.name}"` +
+                    `\npathParams: ${inputParams?.pathParams ?
+                        Object.keys(inputParams.pathParams).join(', ') :
+                        '-no path params-'}`;
+            }
+            throw new fsm_dynamo_1.DyFM_Error({
+                ...this._getDefaultErrorSettings(callParams.name + ' startApiCall', error),
+                status: status,
+                message: msg,
+                errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-HE4`,
+                additionalContent: {
+                    callName: callParams.name,
+                },
+                confidentialContent: {
+                    url: url,
+                    endpoint: `${callParams.type} "${callParams.baseUrl}${callParams.endpoint}"`,
+                    endpointStackLocation: callParams.stack,
+                    callParams: callParams,
+                    inputParams: inputParams,
+                    response: error?.response,
+                },
+            });
+        }
+        else {
+            fsm_dynamo_1.DyFM_Error.logSimple(`"${callParams.name}" api call was UNSUCCESSFUL`, error);
+            /* if (
+              DyNTS_global_settings.log_settings.detailedErrors ||
+              !(error instanceof DyFM_Error)
+            ) {
+              DyFM_Log.error(
+                `"${callParams.name}" api call was UNSUCCESSFUL`,
+                '\nERROR:', error
+              );
+            } else {
+              error.logSimple(`"${callParams.name}" api call was UNSUCCESSFUL`);
+            } */
+            throw error;
+        }
+    }
+    static async postPutPatch(axios, callParams, url, inputParams) {
+        return await axios[callParams.type](url, inputParams.body, callParams.httpOptions).then((res) => {
+            if (global_settings_const_1.DyNTS_global_settings.log_settings.api_events) {
+                if (global_settings_const_1.DyNTS_global_settings.log_settings.api_responseContents) {
+                    fsm_dynamo_1.DyFM_Log.success(`--->   "${callParams.name}" api call was successful`, res.data);
+                }
+                else {
+                    fsm_dynamo_1.DyFM_Log.success(`--->   "${callParams.name}" api call was successful`);
+                }
+            }
+            if (callParams.getFullResponse) {
+                return res;
+            }
+            else {
+                return res.data;
+            }
+        });
+    }
+    static async delete(axios, url, callParams) {
+        return await axios.delete(url, callParams.httpOptions).then((res) => {
+            if (global_settings_const_1.DyNTS_global_settings.log_settings.api_events) {
+                if (global_settings_const_1.DyNTS_global_settings.log_settings.api_responseContents) {
+                    fsm_dynamo_1.DyFM_Log.success(`"${callParams.name}" api call was successful`, res.data);
+                }
+                else {
+                    fsm_dynamo_1.DyFM_Log.success(`"${callParams.name}" api call was successful`);
+                }
+            }
+            if (callParams.getFullResponse) {
+                return res;
+            }
+            else {
+                return res.data;
+            }
+        });
+    }
+    static async get(axios, url, callParams) {
+        return await axios.get(url, callParams.httpOptions).then((res) => {
+            if (global_settings_const_1.DyNTS_global_settings.log_settings.api_events) {
+                if (global_settings_const_1.DyNTS_global_settings.log_settings.api_responseContents) {
+                    fsm_dynamo_1.DyFM_Log.success(`"${callParams.name}" api call was successful`, res.data);
+                }
+                else {
+                    fsm_dynamo_1.DyFM_Log.success(`"${callParams.name}" api call was successful`);
+                }
+            }
+            if (callParams.getFullResponse) {
+                return res;
+            }
+            else {
+                return res.data;
+            }
+        });
+    }
+    static logEvent(url, inputParams, callParams) {
+        if (global_settings_const_1.DyNTS_global_settings.log_settings.api_requestContents) {
+            fsm_dynamo_1.DyFM_Log.log(`<---   outgoing API call: "${callParams?.name}" ` +
+                `\n(${url})` +
+                `\nbody:`, inputParams?.body);
+        }
+        else {
+            fsm_dynamo_1.DyFM_Log.log(`<---   outgoing API call: "${callParams?.name}"`);
+        }
+        if (global_settings_const_1.DyNTS_global_settings.log_settings.api_requestSettings) {
+            fsm_dynamo_1.DyFM_Log.log(`callParams:`, callParams);
+            fsm_dynamo_1.DyFM_Log.log('inputParams:', {
+                pathParams: inputParams.pathParams ?? {},
+                body: inputParams.body ?? null,
+            });
+        }
+    }
+    static setupAxiosConfig(callParams, axios) {
+        // Ensure axios.defaults exists
+        if (!axios.defaults) {
+            fsm_dynamo_1.DyFM_Log.error(`ERROR: axios.defaults is undefined in setupAxiosConfig for call (cant set headers and other options): "${callParams.name}"`, '\n  stack:', callParams.stack);
+            return;
+        }
+        // Set headers
+        if (callParams.httpOptions?.headers) {
+            axios.defaults.headers.common ??= {};
+            for (const headerKey in callParams.httpOptions.headers) {
+                if (!callParams.httpOptions.headers[headerKey]) {
+                    throw new fsm_dynamo_1.DyFM_Error({
+                        ...this._getDefaultErrorSettings('setupHeaders', new Error(`missing header: ${headerKey}`)),
+                        errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SH0`,
+                    });
+                }
+                axios.defaults.headers.common[headerKey] = callParams.httpOptions.headers[headerKey];
+            }
+        }
+        // Set other Axios configuration options
+        if (callParams.httpOptions?.httpsAgent) {
+            axios.defaults.httpsAgent = callParams.httpOptions.httpsAgent;
+        }
+        if (callParams.httpOptions?.httpAgent) {
+            axios.defaults.httpAgent = callParams.httpOptions.httpAgent;
+        }
+        if (callParams.httpOptions?.timeout !== undefined) {
+            axios.defaults.timeout = callParams.httpOptions.timeout;
+        }
+        if (callParams.httpOptions?.maxRedirects !== undefined) {
+            axios.defaults.maxRedirects = callParams.httpOptions.maxRedirects;
+        }
+        if (callParams.httpOptions?.withCredentials !== undefined) {
+            axios.defaults.withCredentials = callParams.httpOptions.withCredentials;
+        }
+        if (callParams.httpOptions?.responseType !== undefined) {
+            axios.defaults.responseType = callParams.httpOptions.responseType;
+        }
+    }
+    static setupPathParams(pathParams, url, callParams) {
+        for (const pathParamKey in pathParams) {
+            if (pathParams[pathParamKey]) {
+                const paramType = typeof pathParams[pathParamKey];
+                switch (paramType) {
+                    case 'number':
+                        url = url.replace(`:${pathParamKey}`, pathParams[pathParamKey].toString());
+                        break;
+                    case 'string':
+                        url = url.replace(`:${pathParamKey}`, pathParams[pathParamKey]);
+                        break;
+                    default:
+                        /* DyFM_Log.error(
+                          `DYNAMO-NTS ERROR:`+
+                          `\nwrong path param type: (${pathParamKey}): ${paramType} ` +
+                          `\n${pathParams[pathParamKey]}` +
+                          `\nMUST BE string or number` +
+                          `\n\n`,
+                          new Error()
+                        ); */
+                        throw new fsm_dynamo_1.DyFM_Error({
+                            ...this._getDefaultErrorSettings('setupPathParams', new Error(`wrong path param type: (${pathParamKey}): "${paramType}" (${callParams.name})` +
+                                `\n${pathParams[pathParamKey]}`)),
+                            errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SP1`,
+                            additionalContent: {
+                                pathParams: pathParams,
+                                url: url,
+                            },
+                        });
+                }
+            }
+            else {
+                throw new fsm_dynamo_1.DyFM_Error({
+                    ...this._getDefaultErrorSettings('setupPathParams', new Error(`missing pathParam: "${pathParamKey}" (${callParams.name})`)),
+                    errorCode: `${global_settings_const_1.DyNTS_global_settings.systemShortCodeName}|DyNTS-API-SP0`,
+                });
+            }
+        }
+        return url;
+    }
+    static _getDefaultErrorSettings(fnName, error) {
+        return {
+            status: error?.___status ?? 500,
+            message: error?.message ??
+                error?._message ??
+                `${fnName} was UNSUCCESSFUL (NTS)`,
+            addECToUserMsg: !error?.__userMessage,
+            userMessage: error?.__userMessage ?? this.defaultErrorUserMsg,
+            issuerService: `${this?.constructor?.name}-${this?.name}-DyNTS_ApiService`,
+            error: error,
+        };
+    }
+}
+exports.DyNTS_ApiService = DyNTS_ApiService;
 //# sourceMappingURL=api.service.js.map