@corebos/ws-lib/WSClientm.js

CoreBOS Web service client Library

// Include crypto-js library if you need to use doLoginPortal

const _servicebase = 'webservice.php';
var _serviceurl = '';

// Webservice user credentials
var _serviceuser= false;
var _servicekey = false;

// Webservice login validity
var _servertime = false;
var _expiretime = false;
var _servicetoken=false;

// Webservice login credentials
var _sessionid  = '';
var _userid     = false;
var _cbwsOptions = [];

// Webservice login user data
var _entityid = ''
var _language = ''

// Last operation error information
var _lasterror = false;

// Version
var version = 'coreBOS2.1';

var fetchOptions = {
	mode: 'cors',
	headers: {
		'Content-type': 'application/x-www-form-urlencoded; charset=UTF-8',
		'corebos-authorization': _sessionid,
	}
};

export function setURL(cburl, fetchingOptions=null) {
	if (window.coreBOS === undefined) {
		window.coreBOS = {};
	}
	//Session Expiry event
	window.coreBOS.SessionExpired = new CustomEvent('coreBOSSessionExpiredEvent', {});
	//Authorization Required event
	window.coreBOS.AuthorizationRequired = new CustomEvent('coreBOSAuthorizationRequiredEvent', {});

	if (cburl && cburl!=='') {
		// Format the url before appending servicebase
		_serviceurl = cburl + (cburl.substr(cburl.length - 1) === '/' ? '' : '/') + _servicebase;
	}
	if (fetchingOptions) {
		_setFetchOptions(fetchingOptions);
	}
}

function getURL() {
	return _serviceurl;
}

function _setFetchOptions({mode, headers}) {
	fetchOptions.mode = mode;
	fetchOptions.headers = headers;
}

/**
 * valueMapParam = 'elements' || 'element'
 */
function addcbWsOptions(operation, valueMap=null, resource='', valueMapParam = 'element') {
	let reqData = `operation=${operation}`;
	if (valueMap && (typeof valueMap === 'object' || Array.isArray(valueMap))) {
		reqData += `&${valueMapParam}=${JSON.stringify(valueMap)}`;
	} else if (valueMap) {
		reqData += `&${valueMapParam}=${valueMap}`;
	}
	if (resource) {
		reqData += `&elementType=${resource}`;
	}
	if (_cbwsOptions && _cbwsOptions.length > 0) {
		reqData += `&cbwsOptions=${JSON.stringify(_cbwsOptions)}`;
		_cbwsOptions = [];
	}
	return reqData;
}

function setConnection(logindata) {
	setSession(logindata);
	setURL(logindata.host);
}

export function setSession(logindata) {
	_sessionid = logindata.sessionName;
	_userid = logindata.userId;
	if (fetchOptions && fetchOptions.headers) {
		fetchOptions.headers["corebos-authorization"] = logindata.sessionName;
	}
}

export function getSession() {
	return {
		'sessionName': _sessionid,
		'userId': _userid
	};
}

export function getEntityId() {
	return {
		'entityid': _entityid,
	};
}

export function getLanguage() {
	return {
		'language': _language,
	};
}

/**
 * Get actual record id from the response id.
 */
export function getRecordId(id) {
	if (typeof id === 'undefined') {
		return 0;
	}
	var ids = id.split('x');
	return ids[1];
}

/**
 * Check if result has any error.
 */
export function hasError(resultdata) {
	if (resultdata != null && resultdata['success'] === false) {
		_lasterror = resultdata['error'].code + ': ' + resultdata['error'].message;
		return true;
	}
	_lasterror = 'none';
	return false;
}

/**
 * Get last operation error information
 */
export function lastError () {
	return _lasterror;
}

/* parse return status */
export function status(response) {
	if (response.status >= 200 && response.status < 300) {
		return Promise.resolve(response);
	} else {
		return Promise.reject(new Error(response.statusText));
	}
}

/* get data from response */
export function getData(response) {
	return response.json();
}

/**
 * Perform the challenge
 * @access private
 */
function __doChallenge(username) {
	// reqtype = 'GET';
	let params = '?operation=getchallenge&username=' + username;
	fetchOptions.method = 'get';
	delete fetchOptions.body;
	return fetch(_serviceurl + params, fetchOptions)
		.then(status)
		.then(getData);
}

/**
 * Login Operation
 */
export async function doLogin(username, accesskey, withpassword) {
	// reqtype = 'POST';
	_serviceuser = username;
	_servicekey = accesskey;
	if (withpassword === undefined) {
		withpassword = false;
	}
	let login = false;
	await __doChallenge(username)
		.then(async function (data) {
			if (hasError(data) === false) {
				let result = data['result'];
				_servicetoken = result.token;
				_servertime = result.serverTime;
				_expiretime = result.expireTime;
				fetchOptions.method = 'post';
				let postdata = 'operation=login&username=' + username;
				postdata += '&accessKey=' + (withpassword ? _servicetoken + accesskey : cbMD5(_servicetoken + accesskey));
				fetchOptions.body = postdata;

				await fetch(_serviceurl, fetchOptions)
					.then(status)
					.then(getData)
					.then(logindata => {
						if (hasError(logindata) === false) {
							var result = logindata['result'];
							_sessionid = result.sessionName;
							_userid = result.userId;

							login = logindata;
							Promise.resolve(logindata);
						} else {
							Promise.reject(new Error('incorrect response: ' + lastError()));
						}
					})
					.catch(error => Promise.reject(error));
			} else {
				return new Error('incorrect response: ' + lastError());
			}
		})
		.catch(error => { Promise.reject(error)});
	return login;
}

/**
 * Do Login Portal Operation
 */
export async function doLoginPortal(username, password, hashmethod, entity) {
	// reqtype = 'GET';
	let login = false;
	await __doChallenge(username)
		.then(async function (data) {
			if (hasError(data) === false) {
				let result = data['result'];
				_servicetoken = result.token;
				_servertime = result.serverTime;
				_expiretime = result.expireTime;
				fetchOptions.method = 'get';
				let postdata = '?operation=loginPortal&username=' + username + '&entity=' + entity || 'Contacts';
				let hashed = ''

				switch (hashmethod) {
					case 'sha256':
						hashed = CryptoJS.SHA256(_servicetoken + password).toString();
						break;
					case 'sha512':
						hashed = CryptoJS.SHA512(_servicetoken + password).toString();
						break;
					case 'plaintext':
						hashed = _servicetoken + password;
						break;
					case 'md5':
					default:
						hashed = cbMD5(_servicetoken + password);
						break;
				}

				postdata += '&password=' + hashed;

				await fetch(_serviceurl + postdata, fetchOptions)
					.then(status)
					.then(getData)
					.then(logindata => {
						if (hasError(logindata) === false) {
							var result = logindata['result'];
							_sessionid = result.sessionName;
							_serviceuser = result.user.user_name;
							_servicekey = result.user.accesskey;
							_userid = result.userId;
							_entityid = result.entityid;
							_language = result.language;
							login = logindata;
							Promise.resolve(logindata);
						} else {
							Promise.reject(new Error('incorrect response: ' + lastError()));
						}
					})
					.catch(error => Promise.reject(error));
			} else {
				return new Error('incorrect response: ' + lastError());
			}
		})
		.catch(error => { Promise.reject(error)});
	return login;
}

/**
 * Logout Operation
 */
export function doLogout() {
	// reqtype = 'POST';
	let postdata = 'operation=logout&sessionName='+_sessionid;
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				_servicetoken = false;
				_servertime = false;
				_expiretime = false;
				_sessionid  = false;
				_userid = false;
				return Promise.resolve(data['result']);
			} else {
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

export function extendSession() {
	// reqtype = 'POST';
	let postdata = 'operation=extendsession';
	fetchOptions.body = postdata;
	fetchOptions.credentials = 'include';
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				_sessionid  = data['result'].sessionName;
				_userid = data['result'].userId;
				delete fetchOptions.credentials;
				return Promise.resolve(data['result']);
			} else {
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Query Operation.
 */
export function doQuery(query) {
	if (query.indexOf(';') === -1) {
		query += ';';
	}

	// reqtype = 'GET';
	let params = '?operation=query&query=' + query;
	fetchOptions.method = 'get';
	delete fetchOptions.body;
	return fetch(_serviceurl + params, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Query Operation with total number of rows
 */
export function doQueryWithTotal(query) {
	if (query.indexOf(';') === -1) {
		query += ';';
	}

	// reqtype = 'GET';
	let params = '?operation=query&query=' + query;
	fetchOptions.method = 'get';
	delete fetchOptions.body;
	return fetch(_serviceurl + params, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve({'result': data['result'], 'totalrows': data['moreinfo']['totalrows']});
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Get Result Column Names.
 */
export function getResultColumns(result) {
	let columns = [];
	if (result !== null && result.length !== 0) {
		let firstrecord = result[0];
		for (let key in firstrecord) {
			columns.push(key);
		}
	}
	return columns;
}

/**
 * List types (modules) available.
 */
export function doListTypes() {
	// reqtype = 'GET';
	let params = '?operation=listtypes';
	fetchOptions.method = 'get';
	delete fetchOptions.body;
	return fetch(_serviceurl + params, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				let result = data['result'];
				let modulenames = result['types'];
				let returnvalue = { };
				for (let mindex = 0; mindex < modulenames.length; ++mindex) {
					let modulename = modulenames[mindex];
					returnvalue[modulename] = {
						'name' : modulename
					};
				}
				return Promise.resolve(returnvalue);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Describe Operation
 */
export function doDescribe(module) {
	// reqtype = 'GET';
	let params = '?operation=describe&elementType=' + module;
	fetchOptions.method = 'get';
	delete fetchOptions.body;
	return fetch(_serviceurl + params, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Retrieve details of record
 */
export function doRetrieve(record) {
	// reqtype = 'GET';
	let params = '?operation=retrieve&id=' + record;
	fetchOptions.method = 'get';
	delete fetchOptions.body;
	return fetch(_serviceurl + params, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Upsert Operation
 */
export function doUpsert(module, createFields, searchOn, updateFields) {
	// reqtype = 'POST';
	let postdata = 'operation=upsert&sessionName='+_sessionid+'&elementType='+module+'&element='+JSON.stringify(createFields);
	postdata += '&searchOn=' + searchOn + '&updatedfields=' + updateFields;
	if (_cbwsOptions && _cbwsOptions.length > 0) {
		postdata += `&cbwsOptions=${JSON.stringify(_cbwsOptions)}`;
		_cbwsOptions = [];
	}
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Mass Update Operation
 */
export function doMassUpdate(elements) {
	// reqtype = 'POST';
	let postdata = addcbWsOptions('MassUpdate', elements, '', 'elements');
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Mass Upsert Operation
 */
export function doMassUpsert(elements) {
	// reqtype = 'POST';
	let postdata = addcbWsOptions('MassCreate', elements, '', 'elements');
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Mass Retrieve Operation
 */
export function doMassRetrieve(ids) {
	// reqtype = 'POST';
	let postdata = 'operation=MassRetrieve&ids=' + ids;
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Create Operation
 */
export function doCreate(module, valuemap) {
	// Assign record to logged in user if not specified
	if (valuemap['assigned_user_id'] == null) {
		valuemap['assigned_user_id'] = _userid;
	}

	// reqtype = 'POST';
	let postdata = addcbWsOptions('create', valuemap, module, 'element');
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Update Operation
 */
export function doUpdate(module, valuemap) {
	// Assign record to logged in user if not specified
	if (valuemap['assigned_user_id'] == null) {
		valuemap['assigned_user_id'] = _userid;
	}

	// reqtype = 'POST';
	let postdata = addcbWsOptions('update', valuemap, module, 'element');
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Revise Operation
 */
export function doRevise(module, valuemap) {
	// reqtype = 'POST';
	fetchOptions.body = addcbWsOptions('revise', valuemap, module, 'element');
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Delete Operation
 */
export function doDelete(id) {
	// reqtype = 'POST';
	let postdata = 'operation=delete&id=' + id;
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Mass Delete Operation
 */
export function doMassDelete(ids) {
	// reqtype = 'POST';
	let postdata = 'operation=MassDelete&ids=' + ids;
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Invoke custom operation
 */
export function doInvoke(method, params, type) {
	if (typeof(params) == 'undefined') {
		params = {};
	}

	var reqtype = 'post';
	if (typeof(type) != 'undefined') {
		reqtype = type.toUpperCase();
	}
	let postdata = addcbWsOptions(method);
	for (let key in params) {
		postdata += '&' + key + '=' + params[key];
	}
	let getparams = '';
	if (reqtype.toLowerCase()==='post') {
		fetchOptions.body = postdata;
	} else {
		delete fetchOptions.body;
		getparams = '?' + postdata;
	}
	fetchOptions.method = reqtype;
	return fetch(_serviceurl + getparams, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Validate Information
 */
export function doValidateInformation(record, module, recordInformation) {
	// reqtype = 'POST';
	recordInformation.module = recordInformation.module || module;
	recordInformation.record = recordInformation.record || record;
	let postdata = 'operation=ValidateInformation';
	postdata += '&context=' + JSON.stringify(recordInformation);
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (data.success) {
				return Promise.resolve(data['result']);
			} else {
				return Promise.reject(data['result']);
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Retrieve related records.
 */
export function doGetRelatedRecords(record, module, relatedModule, queryParameters) {
	// reqtype = 'POST';
	let postdata = 'operation=getRelatedRecords&id=' + record + '&module=' + module;
	postdata += '&relatedModule=' + relatedModule + '&queryParameters=' + JSON.stringify(queryParameters);
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Set relation between records.
 * param relate_this_id string ID of record we want to related other records with
 * param with_this_ids string/array either a string with one unique ID or an array of IDs to relate to the first parameter
 */
export function doSetRelated(relate_this_id, with_these_ids) {
	// reqtype = 'POST';
	let postdata = 'operation=SetRelation&relate_this_id=' + relate_this_id + '&with_these_ids=' + JSON.stringify(with_these_ids);
	fetchOptions.body = postdata;
	fetchOptions.method = 'post';
	return fetch(_serviceurl, fetchOptions)
		.then(status)
		.then(getData)
		.then(function (data) {
			if (hasError(data) === false) {
				return Promise.resolve(data['result']);
			} else {
				if (sessionValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.SessionExpired);
				}
				if (authorizationValidityDetector(data)) {
					window.dispatchEvent(window.coreBOS.AuthorizationRequired);
				}
				return Promise.reject(new Error('incorrect response: '+lastError()));
			}
		})
		.catch(function (error) {
			return Promise.reject(error);
		});
}

/**
 * Authorization Validity detector/Checker
 */
export function authorizationValidityDetector(error) {
	//let errorCode = error.split(':')[1]?.trim() ?? '';
	return (error.success===false && error.error.code === 'AUTHENTICATION_REQUIRED');
}

/**
 * Session Validity detector/Checker
 */
export function sessionValidityDetector(error) {
	//let errorCode = error.split(':')[1]?.trim() ?? '';
	return (error.success===false && error.error.code === 'INVALID_SESSIONID');
}

// MD5 (Message-Digest Algorithm) by WebToolkit
// eslint-disable-next-line
var cbMD5=function(s){function L(k,d){return(k<<d)|(k>>>(32-d))}function K(G,k){var I,d,F,H,x;F=(G&2147483648);H=(k&2147483648);I=(G&1073741824);d=(k&1073741824);x=(G&1073741823)+(k&1073741823);if(I&d){return(x^2147483648^F^H)}if(I|d){if(x&1073741824){return(x^3221225472^F^H)}else{return(x^1073741824^F^H)}}else{return(x^F^H)}}function r(d,F,k){return(d&F)|((~d)&k)}function q(d,F,k){return(d&k)|(F&(~k))}function p(d,F,k){return(d^F^k)}function n(d,F,k){return(F^(d|(~k)))}function u(G,F,aa,Z,k,H,I){G=K(G,K(K(r(F,aa,Z),k),I));return K(L(G,H),F)}function f(G,F,aa,Z,k,H,I){G=K(G,K(K(q(F,aa,Z),k),I));return K(L(G,H),F)}function D(G,F,aa,Z,k,H,I){G=K(G,K(K(p(F,aa,Z),k),I));return K(L(G,H),F)}function t(G,F,aa,Z,k,H,I){G=K(G,K(K(n(F,aa,Z),k),I));return K(L(G,H),F)}function e(G){var Z;var F=G.length;var x=F+8;var k=(x-(x%64))/64;var I=(k+1)*16;var aa=Array(I-1);var d=0;var H=0;while(H<F){Z=(H-(H%4))/4;d=(H%4)*8;aa[Z]=(aa[Z]|(G.charCodeAt(H)<<d));H++}Z=(H-(H%4))/4;d=(H%4)*8;aa[Z]=aa[Z]|(128<<d);aa[I-2]=F<<3;aa[I-1]=F>>>29;return aa}function B(x){var k="",F="",G,d;for(d=0;d<=3;d++){G=(x>>>(d*8))&255;F="0"+G.toString(16);k=k+F.substr(F.length-2,2)}return k}function J(k){k=k.replace(/rn/g,"n");var d="";for(var F=0;F<k.length;F++){var x=k.charCodeAt(F);if(x<128){d+=String.fromCharCode(x)}else{if((x>127)&&(x<2048)){d+=String.fromCharCode((x>>6)|192);d+=String.fromCharCode((x&63)|128)}else{d+=String.fromCharCode((x>>12)|224);d+=String.fromCharCode(((x>>6)&63)|128);d+=String.fromCharCode((x&63)|128)}}}return d}var C=Array();var P,h,E,v,g,Y,X,W,V;var S=7,Q=12,N=17,M=22;var A=5,z=9,y=14,w=20;var o=4,m=11,l=16,j=23;var U=6,T=10,R=15,O=21;s=J(s);C=e(s);Y=1732584193;X=4023233417;W=2562383102;V=271733878;for(P=0;P<C.length;P+=16){h=Y;E=X;v=W;g=V;Y=u(Y,X,W,V,C[P+0],S,3614090360);V=u(V,Y,X,W,C[P+1],Q,3905402710);W=u(W,V,Y,X,C[P+2],N,606105819);X=u(X,W,V,Y,C[P+3],M,3250441966);Y=u(Y,X,W,V,C[P+4],S,4118548399);V=u(V,Y,X,W,C[P+5],Q,1200080426);W=u(W,V,Y,X,C[P+6],N,2821735955);X=u(X,W,V,Y,C[P+7],M,4249261313);Y=u(Y,X,W,V,C[P+8],S,1770035416);V=u(V,Y,X,W,C[P+9],Q,2336552879);W=u(W,V,Y,X,C[P+10],N,4294925233);X=u(X,W,V,Y,C[P+11],M,2304563134);Y=u(Y,X,W,V,C[P+12],S,1804603682);V=u(V,Y,X,W,C[P+13],Q,4254626195);W=u(W,V,Y,X,C[P+14],N,2792965006);X=u(X,W,V,Y,C[P+15],M,1236535329);Y=f(Y,X,W,V,C[P+1],A,4129170786);V=f(V,Y,X,W,C[P+6],z,3225465664);W=f(W,V,Y,X,C[P+11],y,643717713);X=f(X,W,V,Y,C[P+0],w,3921069994);Y=f(Y,X,W,V,C[P+5],A,3593408605);V=f(V,Y,X,W,C[P+10],z,38016083);W=f(W,V,Y,X,C[P+15],y,3634488961);X=f(X,W,V,Y,C[P+4],w,3889429448);Y=f(Y,X,W,V,C[P+9],A,568446438);V=f(V,Y,X,W,C[P+14],z,3275163606);W=f(W,V,Y,X,C[P+3],y,4107603335);X=f(X,W,V,Y,C[P+8],w,1163531501);Y=f(Y,X,W,V,C[P+13],A,2850285829);V=f(V,Y,X,W,C[P+2],z,4243563512);W=f(W,V,Y,X,C[P+7],y,1735328473);X=f(X,W,V,Y,C[P+12],w,2368359562);Y=D(Y,X,W,V,C[P+5],o,4294588738);V=D(V,Y,X,W,C[P+8],m,2272392833);W=D(W,V,Y,X,C[P+11],l,1839030562);X=D(X,W,V,Y,C[P+14],j,4259657740);Y=D(Y,X,W,V,C[P+1],o,2763975236);V=D(V,Y,X,W,C[P+4],m,1272893353);W=D(W,V,Y,X,C[P+7],l,4139469664);X=D(X,W,V,Y,C[P+10],j,3200236656);Y=D(Y,X,W,V,C[P+13],o,681279174);V=D(V,Y,X,W,C[P+0],m,3936430074);W=D(W,V,Y,X,C[P+3],l,3572445317);X=D(X,W,V,Y,C[P+6],j,76029189);Y=D(Y,X,W,V,C[P+9],o,3654602809);V=D(V,Y,X,W,C[P+12],m,3873151461);W=D(W,V,Y,X,C[P+15],l,530742520);X=D(X,W,V,Y,C[P+2],j,3299628645);Y=t(Y,X,W,V,C[P+0],U,4096336452);V=t(V,Y,X,W,C[P+7],T,1126891415);W=t(W,V,Y,X,C[P+14],R,2878612391);X=t(X,W,V,Y,C[P+5],O,4237533241);Y=t(Y,X,W,V,C[P+12],U,1700485571);V=t(V,Y,X,W,C[P+3],T,2399980690);W=t(W,V,Y,X,C[P+10],R,4293915773);X=t(X,W,V,Y,C[P+1],O,2240044497);Y=t(Y,X,W,V,C[P+8],U,1873313359);V=t(V,Y,X,W,C[P+15],T,4264355552);W=t(W,V,Y,X,C[P+6],R,2734768916);X=t(X,W,V,Y,C[P+13],O,1309151649);Y=t(Y,X,W,V,C[P+4],U,4149444226);V=t(V,Y,X,W,C[P+11],T,3174756917);W=t(W,V,Y,X,C[P+2],R,718787259);X=t(X,W,V,Y,C[P+9],O,3951481745);Y=K(Y,h);X=K(X,E);W=K(W,v);V=K(V,g)}var i=B(Y)+B(X)+B(W)+B(V);return i.toLowerCase()};