total5 0.0.1-1

package/builders.js

@@ -0,0 +1,1435 @@
+// Total.js Builders
+// The MIT License
+// Copyright 2023 (c) Peter Širka <petersirka@gmail.com>
+
+'use strict';
+
+const REG_ARGS = /\{{1,2}[a-z0-9_.-\s]+\}{1,2}/gi;
+
+var transforms = { error: {}, restbuilder: {} };
+var restbuilderupgrades = [];
+
+function Options(ctrl, error) {
+	var t = this;
+	t.controller = ctrl;
+	t.error = error || new ErrorBuilder();
+	t.response = {};
+}
+
+Options.prototype = {
+
+	get client() {
+		return this.controller;
+	},
+
+	get websocket() {
+		return this.controller.parent;
+	},
+
+	get value() {
+		return this.payload;
+	},
+
+	get model() {
+		return this.payload;
+	},
+
+	set value(value) {
+		this.payload = value;
+	},
+
+	set model(value) {
+		this.payload = value;
+	},
+
+	get url() {
+		return (this.controller ? this.controller.url : '') || '';
+	},
+
+	get uri() {
+		return this.controller ? this.controller.uri : null;
+	},
+
+	get path() {
+		return (this.controller ? this.controller.pathname : EMPTYARRAY);
+	},
+
+	get split() {
+		return (this.controller ? this.controller.split : EMPTYARRAY);
+	},
+
+	get split2() {
+		return (this.controller ? this.controller.split2 : EMPTYARRAY);
+	},
+
+	get language() {
+		return (this.controller ? this.controller.language : '') || '';
+	},
+
+	get ip() {
+		return this.controller ? this.controller.ip : null;
+	},
+
+	get files() {
+		return this.controller ? this.controller.files : null;
+	},
+
+	get body() {
+		return this.controller ? this.controller.body : null;
+	},
+
+	get mobile() {
+		return this.controller ? this.controller.mobile : null;
+	},
+
+	get headers() {
+		return this.controller ? this.controller.headers : null;
+	},
+
+	get ua() {
+		return this.controller ? this.controller.ua : null;
+	}
+};
+
+Options.prototype.action = function(schema, payload) {
+	return F.action(schema, payload, this.controller);
+};
+
+Options.prototype.publish = function(value) {
+	var self = this;
+	var name = self.id;
+	if (F.TMS.cache.socket && F.TMS.cache.pcache[name] && F.TMS.cache.publishers[name]) {
+
+		var tmp = {};
+		if (tmp) {
+			for (var key in value) {
+				if (!self.$publish || self.$publish[key])
+					tmp[key] = value[key];
+			}
+		}
+
+		F.stats.performance.publish++;
+		F.TMS.cache.socket.send({ type: 'publish', id: name, data: tmp }, client => client.tmsready);
+	}
+	return self;
+};
+
+Options.prototype.on = function(name, fn) {
+	var self = this;
+	if (!self.events)
+		self.events = {};
+	if (!self.events[name])
+		self.events[name] = [];
+	self.events[name].push(fn);
+	return self;
+};
+
+Options.prototype.emit = function(name, a, b, c, d) {
+
+	var self = this;
+
+	if (!self.events || !self.events[name])
+		return false;
+
+	for (var evt of self.events[name])
+		evt.call(self, a, b, c, d);
+
+	return true;
+};
+
+Options.prototype.cancel = function() {
+	var self = this;
+	self.callback = self.next = null;
+	self.error = null;
+	self.controller = null;
+	self.model = null;
+	self.options = null;
+	return self;
+};
+
+Options.prototype.redirect = function(url) {
+	this.redirect(url);
+	this.cancel();
+};
+
+Options.prototype.audit = function(message, type) {
+	F.audit(this, message ? this.variables(message) : '', type);
+};
+
+Options.prototype.success = function(value) {
+	var self = this;
+	if (self.TYPE === 'auth')
+		self.callback(value);
+	else
+		self.callback(DEF.onSuccess(value));
+};
+
+Options.prototype.callback = function(value) {
+
+	var self = this;
+
+	if (arguments.length == 0) {
+		return function(err, response) {
+			err && self.error.push(err);
+			self.callback(response);
+		};
+	}
+
+	self.$callback(self.error.items.length ? self.error : null, value);
+};
+
+Options.prototype.done = function(arg) {
+	var self = this;
+	return function(err, response) {
+		if (err) {
+			err && self.error.push(err);
+			self.callback();
+		} else {
+			if (self.TYPE === 'auth')
+				self.callback(arg === true ? response : arg);
+			else
+				self.callback(DEF.onSuccess(arg === true ? response : arg));
+		}
+	};
+};
+
+Options.prototype.invalid = function(error, path, index) {
+	var self = this;
+	self.error.push(error, path, index);
+	self.$callback(error);
+};
+
+Options.prototype.cookie = function(name, value, expire, options) {
+	var self = this;
+	if (value === undefined)
+		return self.controller.cookie(name);
+	if (value === null)
+		expire = '-1 day';
+	self.controller.cookie(name, value, expire, options);
+	return self;
+};
+
+Options.prototype.variables = function(str, data) {
+
+	if (str.indexOf('{') === -1)
+		return str;
+
+	var $ = this;
+
+	return str.replace(REG_ARGS, function(text) {
+		var l = text[1] === '{' ? 2 : 1;
+		var key = text.substring(l, text.length - l).trim();
+		var val = null;
+		var five = key.substring(0, 5);
+		if (five === 'user.') {
+			if ($.user) {
+				key = key.substring(5);
+				val = key.indexOf('.') === -1 ? $.user[key] : F.TUtils.get($.user, key);
+			}
+		} else if (five === 'data.') {
+			if (data) {
+				key = key.substring(5);
+				val = key.indexOf('.') === -1 ? data[key] : F.TUtils.get(data, key);
+			}
+		} else {
+			var six = key.substring(0, 6);
+			if (six === 'model.' || six === 'value.') {
+				if ($.model) {
+					key = key.substring(6);
+					val = key.indexOf('.') === -1 ? $.model[key] : F.TUtils.get($.model, key);
+				}
+			} else if (six === 'query.')
+				val = $.query[key.substring(6)];
+			else if (key.substring(0, 7) === 'params.')
+				val = $.params[key.substring(7)];
+		}
+		return val == null ? text : val;
+	});
+
+};
+
+function ErrorBuilder() {
+	var t = this;
+	t.items = [];
+	// t.replacer = null;
+	t.status = 400;
+	t.prefix = '';
+}
+
+ErrorBuilder.prototype = {
+	get length() {
+		return this.items.length;
+	}
+};
+
+ErrorBuilder.prototype.push = function(err, path, index) {
+	var self = this;
+
+	if (!err)
+		err = 401;
+
+	if (err > 399) {
+		self.status = err;
+		self.items.push({ error: F.TUtils.httpstatus(err) });
+	} else
+		self.items.push({ error: err.toString(), path: path, index: index });
+	return self;
+};
+
+ErrorBuilder.prototype.push2 = function(name, path, index) {
+	var self = this;
+	self.items.push({ name: self.prefix + name, error: '@', path: path, index: index });
+	return self;
+};
+
+ErrorBuilder.assign = function(arr) {
+	var builder = new ErrorBuilder();
+	if (arr instanceof Array) {
+		for (var i = 0; i < arr.length; i++) {
+			if (arr[i].error)
+				builder.items.push(arr[i]);
+		}
+	} else {
+		var type = typeof(arr);
+		if (type === 'number' || type === 'string')
+			builder.push(arr);
+		else if (arr instanceof Error)
+			builder.push(arr + '');
+	}
+	return builder;
+};
+
+ErrorBuilder.prototype.replace = function(search, value) {
+	var self = this;
+	if (!self.replacer)
+		self.replacer = {};
+	self.replacer[search] = value;
+	return self;
+};
+
+ErrorBuilder.prototype.output = function(language = 'default') {
+
+	var self = this;
+	var output = [];
+
+	for (let m of self.items) {
+
+		let err = m.error;
+
+		if (err[0] == '@')
+			err = F.resource(language, 'T' + (err === '@' ? m.name : err.substring(1)).hash(true).toString(36)) || 'The field "' + m.name + '" is invalid';
+
+		if (self.replacer) {
+			for (let key in self.replacer)
+				err = err.replaceAll(key, self.replacer[key]);
+		}
+
+		output.push({ name: m.name, error: err, path: m.path, index: m.index });
+	}
+
+	if (ErrorBuilder.$transform)
+		output = ErrorBuilder.$transform(output, language);
+
+	return output;
+};
+
+ErrorBuilder.prototype.toString = function(language = 'default') {
+	var self = this;
+	var output = self.output(language);
+	var str = '';
+	for (let err of output)
+		str += (str ? '\n' : '') + err.error;
+	return str;
+};
+
+ErrorBuilder.transform = function(callback) {
+	ErrorBuilder.$transform = callback;
+};
+
+function RESTBuilder(url) {
+
+	this.$length = 0;
+	this.$transform = transforms.restbuilder_default;
+	this.$persistentcookies = false;
+
+	this.options = { url: url, timeout: 10000, method: 'GET', resolve: true, headers: { 'user-agent': 'Total.js/v' + F.version_header, accept: 'application/json, text/plain, text/plain, text/xml' }};
+
+	// this.$data = {};
+	// this.$nodnscache = true;
+	// this.$expire;
+	// this.$redirect
+
+	// Auto Total.js Error Handling
+	this.$errorbuilderhandler = true;
+}
+
+RESTBuilder.make = function(fn) {
+	var instance = new RESTBuilder();
+	fn && fn(instance);
+	return instance;
+};
+
+RESTBuilder.url = function(url) {
+	return new RESTBuilder(url);
+};
+
+RESTBuilder.GET = function(url, data) {
+	var builder = new RESTBuilder(url);
+	builder.options.query = data;
+	return builder;
+};
+
+RESTBuilder.API = function(url, name, data) {
+	var builder = new RESTBuilder(url);
+	builder.operation = name;
+	builder.options.method = 'POST';
+	builder.raw(data, 'raw');
+	return builder;
+};
+
+RESTBuilder.POST = function(url, data) {
+	var builder = new RESTBuilder(url);
+	builder.options.method = 'POST';
+	data && builder.raw(data, 'json');
+	return builder;
+};
+
+RESTBuilder.PUT = function(url, data) {
+	var builder = new RESTBuilder(url);
+	builder.options.method = 'PUT';
+	data && builder.raw(data, 'json');
+	return builder;
+};
+
+RESTBuilder.DELETE = function(url, data) {
+	var builder = new RESTBuilder(url);
+	builder.$method = 'delete';
+	builder.options.method = 'DELETE';
+	data && builder.raw(data, 'json');
+	return builder;
+};
+
+RESTBuilder.PATCH = function(url, data) {
+	var builder = new RESTBuilder(url);
+	builder.$method = 'patch';
+	builder.options.method = 'PATCH';
+	data && builder.raw(data, 'json');
+	return builder;
+};
+
+RESTBuilder.HEAD = function(url) {
+	var builder = new RESTBuilder(url);
+	builder.options.method = 'HEAD';
+	return builder;
+};
+
+RESTBuilder.upgrade = function(fn) {
+	restbuilderupgrades.push(fn);
+};
+
+var RESTP = RESTBuilder.prototype;
+
+RESTP.insecure = function() {
+	this.options.insecure = true;
+	return this;
+};
+
+RESTP.error = function(err) {
+	this.$errorhandler = err;
+	return this;
+};
+
+RESTP.noparse = function() {
+	this.$noparse = true;
+	return this;
+};
+
+RESTP.debug = function() {
+	this.$debug = true;
+	return this;
+};
+
+RESTP.unixsocket = function(socket, path) {
+	var self = this;
+	self.options.unixsocket = { socket: socket, path: path };
+	return self;
+};
+
+RESTP.promise = function($) {
+	var self = this;
+	return new Promise(function(resolve, reject) {
+		self.exec(function(err, response) {
+			if (err) {
+				if ($ && $.invalid)
+					$.invalid(err);
+				else
+					reject(err);
+			} else
+				resolve(response);
+		});
+	});
+};
+
+RESTP.proxy = function(value) {
+	this.options.proxy = value;
+	return this;
+};
+
+RESTP.url = function(url) {
+	if (url === undefined)
+		return this.options.url;
+	this.options.url = url;
+	return this;
+};
+
+RESTP.cert = function(key, cert, dhparam) {
+	this.options.key = key;
+	this.options.cert = cert;
+	this.options.dhparam = dhparam;
+	return this;
+};
+
+RESTP.file = function(name, filename, buffer) {
+
+	var self = this;
+	var obj = { name: name, filename: filename };
+
+	if (buffer) {
+		if (typeof(buffer) === 'string') {
+			if (buffer.isURL())
+				obj.url = buffer;
+			else
+				obj.path = buffer;
+		} else
+			obj.buffer = buffer;
+	}
+
+	if (self.options.files)
+		self.options.files.push(obj);
+	else
+		self.options.files = [obj];
+
+	return self;
+};
+
+RESTP.timeout = function(number) {
+	this.options.timeout = number;
+	return this;
+};
+
+RESTP.maxlength = function(number) {
+	this.options.limit = number;
+	return this;
+};
+
+RESTP.auth = function(user, password) {
+	this.options.headers.authorization = password == null ? user : 'Basic ' + Buffer.from(user + ':' + password).toString('base64');
+	return this;
+};
+
+RESTP.convert = function(convert) {
+	this.$convert = convert;
+	return this;
+};
+
+RESTP.nodnscache = function() {
+	this.options.resolve = false;
+	return this;
+};
+
+RESTP.nocache = function() {
+	this.$nocache = true;
+	return this;
+};
+
+RESTP.make = function(fn) {
+	fn.call(this, this);
+	return this;
+};
+
+RESTP.xhr = function() {
+	this.options.xhr = true;
+	return this;
+};
+
+RESTP.method = function(method, data) {
+	this.options.method = method.charCodeAt(0) > 96 ? method.toUpperCase() : method;
+	data && this.raw(data, 'json');
+	return this;
+};
+
+RESTP.referer = RESTP.referrer = function(value) {
+	this.options.headers.Referer = value;
+	return this;
+};
+
+RESTP.origin = function(value) {
+	this.options.headers.Origin = value;
+	return this;
+};
+
+RESTP.robot = function() {
+	if (this.options.headers['User-Agent'])
+		this.options.headers['User-Agent'] += ' Bot';
+	else
+		this.options.headers['User-Agent'] = 'Bot';
+	return this;
+};
+
+RESTP.mobile = function() {
+	if (this.options.headers['User-Agent'])
+		this.options.headers['User-Agent'] += ' iPhone';
+	else
+		this.options.headers['User-Agent'] = 'iPhone';
+	return this;
+};
+
+RESTP.put = RESTP.PUT = function(data) {
+	this.options.method = 'PUT';
+	data && this.raw(data, this.options.type || 'json');
+	return this;
+};
+
+RESTP.delete = RESTP.DELETE = function(data) {
+	this.options.method = 'DELETE';
+	data && this.raw(data, this.options.type || 'json');
+	return this;
+};
+
+RESTP.get = RESTP.GET = function(data) {
+	this.options.method = 'GET';
+	this.options.query = data;
+	return this;
+};
+
+RESTP.post = RESTP.POST = function(data) {
+	this.options.method = 'POST';
+	data && this.raw(data, this.options.type || 'json');
+	return this;
+};
+
+RESTP.head = RESTP.HEAD = function() {
+	this.options.method = 'HEAD';
+	return this;
+};
+
+RESTP.patch = RESTP.PATCH = function(data) {
+	this.options.method = 'PATCH';
+	data && this.raw(data, this.options.type || 'json');
+	return this;
+};
+
+RESTP.json = function(data) {
+	data && this.raw(data, 'json');
+	if (this.options.method === 'GET')
+		this.options.method = 'POST';
+	return this;
+};
+
+RESTP.urlencoded = function(data) {
+	if (this.options.method === 'GET')
+		this.options.method = 'POST';
+	this.options.type = 'urlencoded';
+	data && this.raw(data, this.options.type);
+	return this;
+};
+
+RESTP.accept = function(ext) {
+	var type;
+	if (ext.length > 8)
+		type = ext;
+	else
+		type = F.TUtils.contentTypes[ext];
+	this.options.headers.Accept = type;
+	return this;
+};
+
+RESTP.xml = function(data, replace) {
+
+	if (this.options.method === 'GET')
+		this.options.method = 'POST';
+
+	if (replace)
+		this.$replace = true;
+
+	this.options.type = 'xml';
+	data && this.raw(data, this.options.type);
+	return this;
+};
+
+RESTP.redirect = function(value) {
+	this.options.noredirect = !value;
+	return this;
+};
+
+RESTP.raw = function(value, type) {
+	this.options.type = type;
+	this.options.body = value;
+	return this;
+};
+
+RESTP.text = RESTP.plain = function(val) {
+	this.$plain = true;
+	this.options.body = val;
+	this.options.type = 'plain';
+	return this;
+};
+
+RESTP.cook = function(value) {
+	this.options.cook = value !== false;
+	return this;
+};
+
+RESTP.cookies = function(obj) {
+	this.options.cookies = obj;
+	return this;
+};
+
+RESTP.cookie = function(name, value) {
+	if (!this.options.cookies)
+		this.options.cookies = {};
+	this.options.cookies[name] = value;
+	return this;
+};
+
+RESTP.header = function(name, value) {
+	this.options.headers[name] = value;
+	return this;
+};
+
+RESTP.type = function(value) {
+	this.options.headers['Content-Type'] = value;
+	return this;
+};
+
+function execrestbuilder(instance, callback) {
+	instance.exec(callback);
+}
+
+RESTP.callback = function(fn) {
+
+	var self = this;
+
+	if (typeof(fn) === 'function') {
+		setImmediate(execrestbuilder, self, fn);
+		return self;
+	}
+
+	self.$ = fn;
+	setImmediate(execrestbuilder, self);
+	return new Promise(function(resolve, reject) {
+		self.$resolve = resolve;
+		self.$reject = reject;
+	});
+};
+
+RESTP.csrf = function(value) {
+	this.options.headers['X-Csrf-Token'] = value;
+	return this;
+};
+
+RESTP.encrypt = function(key) {
+	this.options.encrypt = key || DEF.secret_encryption;
+	return this;
+};
+
+RESTP.compress = function(val) {
+	this.$compress = val == null || val == true;
+	return this;
+};
+
+RESTP.cache = function(expire) {
+	this.$expire = expire;
+	return this;
+};
+
+RESTP.set = function(name, value) {
+	if (!this.options.body)
+		this.options.body = {};
+	if (typeof(name) !== 'object') {
+		this.options.body[name] = value;
+	} else {
+		for (var key in name)
+			this.options.body[key] = name[key];
+	}
+	return this;
+};
+
+RESTP.rem = function(name) {
+	if (this.options.body && this.options.body[name])
+		this.options.body[name] = undefined;
+	return this;
+};
+
+RESTP.progress = function(fn) {
+	this.options.onprogress = fn;
+	return this;
+};
+
+RESTP.stream = function(callback) {
+	var self = this;
+	self.options.custom = true;
+	setImmediate(streamresponse, self, callback);
+	return self;
+};
+
+function streamresponse(builder, callback) {
+	builder.exec(callback);
+}
+
+RESTP.keepalive = function() {
+	this.options.keepalive = true;
+	return this;
+};
+
+RESTP.exec = function(callback) {
+
+	if (!callback)
+		callback = NOOP;
+
+	var self = this;
+
+	if (self.operation) {
+
+		// API
+		if (self.options.body)
+			self.options.body = { data: self.options.body };
+		else
+			self.options.body = {};
+
+		if (self.options.query) {
+			self.options.body.query = self.options.query;
+			self.options.query = null;
+		}
+
+		self.options.body.schema = self.operation;
+		self.options.body = JSON.stringify(self.options.body, self.$compress ? exports.json2replacer : null);
+		self.options.type = 'json';
+	}
+
+	if (self.options.files && self.options.method === 'GET')
+		self.options.method = 'POST';
+
+	if (self.options.body && !self.options.files && typeof(self.options.body) !== 'string' && self.options.type !== 'raw')
+		self.options.body = self.options.type === 'urlencoded' ? F.TUtils.toURLEncode(self.options.body) : JSON.stringify(self.options.body);
+
+	if (self.options.unixsocket && self.options.url) {
+		if (!self.options.path)
+			self.options.path = self.options.url;
+		self.options.url = undefined;
+	}
+
+	self.$callback = callback;
+
+	if (restbuilderupgrades.length) {
+		for (var i = 0; i < restbuilderupgrades.length; i++)
+			restbuilderupgrades[i](self);
+	}
+
+	var key;
+
+	if (self.$expire && !self.$nocache) {
+		key = 'restbuilder' + ((self.options.url || '') + (self.options.socketpath || '') + (self.options.path || '') + (self.options.body || '')).hash(true);
+		var data = F.cache.read(key);
+		if (data) {
+			data = data.value;
+			if (self.$resolve) {
+				self.$resolve(data);
+				self.$reject = null;
+				self.$resolve = null;
+			} else
+				callback(null, data, data);
+			return self;
+		}
+	}
+
+	self.$cachekey = key;
+	self.options.callback = restbuilder_callback;
+	self.options.response = {};
+	self.options.response.builder = self;
+	self.request = F.TUtils.request(self.options);
+	return self;
+};
+
+function restbuilder_callback(err, response) {
+
+	var self = response.builder;
+
+	if (self.options.custom) {
+		if (self.$resolve) {
+			if (err)
+				self.$.invalid(err);
+			else
+				self.$resolve(response);
+			self.$ = null;
+			self.$reject = null;
+			self.$resolve = null;
+		} else
+			self.$callback.call(self, err, response);
+		return;
+	}
+
+	var callback = self.$callback;
+	var key = self.$cachekey;
+	var type = err ? '' : response.headers['content-type'] || '';
+	var output = new RESTBuilderResponse();
+
+	if (self.options.cook && self.options.cookies)
+		output.cookies = self.options.cookies;
+
+	if (type) {
+		var index = type.lastIndexOf(';');
+		if (index !== -1)
+			type = type.substring(0, index).trim();
+	}
+
+	var ishead = response.status === 204;
+	if (ishead) {
+		output.value = response.status < 400;
+	} else if (self.$plain || self.$noparse) {
+		output.value = response.body;
+	} else {
+		switch (type.toLowerCase()) {
+			case 'text/xml':
+			case 'application/xml':
+				output.value = response.body ? response.body.parseXML(self.$replace ? true : false) : {};
+				break;
+			case 'application/x-www-form-urlencoded':
+				output.value = response.body ? DEF.parsers.urlencoded(response.body) : {};
+				break;
+			case 'application/json':
+			case 'text/json':
+				output.value = response.body ? response.body.parseJSON(true) : null;
+				break;
+			default:
+				output.value = response.body && response.body.isJSON() ? response.body.parseJSON(true) : null;
+				break;
+		}
+	}
+
+	if (output.value == null)
+		output.value = EMPTYOBJECT;
+
+	output.response = response.body;
+	output.status = response.status;
+	output.headers = response.headers;
+	output.hostname = response.host;
+	output.origin = response.origin;
+	output.cache = false;
+
+	if (self.$debug)
+		console.log('--DEBUG-- RESTBuilder: ' + response.status + ' ' + self.options.method + ' ' + QUERIFY(self.options.url || (self.options.unixsocket + self.options.path), self.options.query), '|', 'Error:', err, '|', 'Response:', response.body);
+
+	var val = output.value;
+
+	if (!err && output.status >= 400) {
+		err = output.status;
+		if (val instanceof Array && val.length && val[0] && val[0].error)
+			err = ErrorBuilder.assign(val);
+		else
+			err = null;
+	}
+
+	if (!err && key)
+		F.cache.add(key, output, self.$expire);
+
+	if (self.$errorbuilderhandler) {
+		// Is the response Total.js ErrorBuilder?
+		if (val instanceof Array && val.length && val[0] && val[0].error) {
+			err = ErrorBuilder.assign(val);
+			if (err)
+				val = null;
+		}
+	}
+
+	if (!err && output.status >= 400)
+		err = output.status;
+
+	if (!err && self.$jsonschema && val) {
+		let jsresponse = $jsonschema.transform(val);
+		if (jsresponse.error)
+			err = jsresponse.error;
+		else
+			val = jsresponse.response;
+	}
+
+	if (self.$resolve) {
+
+		if (err)
+			self.$.invalid(err);
+		else
+			self.$resolve(val);
+
+		self.$ = null;
+		self.$reject = null;
+		self.$resolve = null;
+
+	} else {
+		callback(err, val, output);
+		output.cache = true;
+	}
+
+}
+
+function RESTBuilderResponse() {}
+
+RESTBuilderResponse.prototype.cookie = function(name) {
+
+	var self = this;
+	if (self.cookies)
+		return F.TUtils.decodeURIComponent(self.cookies[name] || '');
+
+	self.cookies = {};
+
+	var cookies = self.headers['set-cookie'];
+	if (!cookies)
+		return '';
+
+	if (typeof(cookies) === 'string')
+		cookies = [cookies];
+
+	for (var i = 0; i < cookies.length; i++) {
+		var line = cookies[i].split(';', 1)[0];
+		var index = line.indexOf('=');
+		if (index !== -1)
+			self.cookies[line.substring(0, index)] = line.substring(index + 1);
+	}
+
+	return F.TUtils.decodeURIComponent(self.cookies[name] || '');
+};
+
+function parseactioncache(obj, meta) {
+
+	var query = meta.query;
+	var user = meta.user;
+	var params = meta.params;
+	var language = meta.language;
+	var search = meta.id || meta.key;
+
+	if (typeof(user) === 'string')
+		user = user.split(',').trim();
+	else if (user === true)
+		user = ['id'];
+	else
+		user = null;
+
+	if (typeof(params) === 'string')
+		params = params.split(',').trim();
+	else if (params === true) {
+		if (obj.jsparams) {
+			params = [];
+			for (var key in obj.jsparams.properties)
+				params.push(key);
+		} else
+			params = null;
+	} else
+		params = null;
+
+	if (typeof(query) === 'string')
+		query = query.split(',').trim();
+	else if (query === true) {
+		if (obj.jsquery) {
+			query = [];
+			for (var key in obj.jsquery.properties)
+				query.push(key);
+		} else
+			query = null;
+	} else
+		query = null;
+
+	return function($, value) {
+		if (value === undefined) {
+
+			var key = 'action|' + (search ? (search + '|') : '') + $.ID;
+			var sum = '';
+			var tmp;
+
+			if (language)
+				sum += ($.language || '');
+
+			if (query) {
+				for (let key of query) {
+					tmp = $.query[key];
+					if (tmp)
+						sum += '|' + tmp;
+				}
+			}
+
+			if (params) {
+				for (let key of params) {
+					tmp = $.params[key];
+					if (tmp)
+						sum += '|' + tmp;
+				}
+			}
+
+			if (user && $.user) {
+				for (let key of user) {
+					tmp = $.user[key];
+					if (tmp)
+						sum += '|' + tmp;
+				}
+			}
+
+			$.cachekey = key + sum;
+			return F.cache.read($.cachekey);
+		}
+
+		$.cachekey && F.cache.set($.cachekey, value && value.success ? CLONE(value) : value, meta.expire || '5 minutes');
+	};
+
+}
+
+exports.newaction = function(name, obj) {
+
+	if (typeof(name) === 'object') {
+		obj = name;
+		name = obj.id || obj.name;
+	}
+
+	var url = name;
+	var tmp = name.split('/').trim();
+	if (tmp.length)
+		obj.$url = url.replace(/\//g, '_').toLowerCase();
+
+	if (F.actions[name])
+		F.actions[name].remove();
+
+	F.actions[name] = obj;
+	obj.id = name;
+	obj.jsinput = obj.input ? F.TUtils.jsonschema(obj.input, true) : null;
+	obj.jsoutput = obj.output ? F.TUtils.jsonschema(obj.output, true) : null;
+	obj.jsparams = obj.params ? F.TUtils.jsonschema(obj.params, true) : null;
+	obj.jsquery = obj.query ? F.TUtils.jsonschema(obj.query, true) : null;
+	obj.options = {};
+	obj.options.csrf = obj.csrf;
+	obj.options.encrypt = obj.encrypt;
+	obj.options.compress = obj.compress;
+
+	if (obj.cache)
+		obj.cache = parseactioncache(obj, obj.cache);
+
+	if (obj.middleware)
+		obj.middleware = obj.middleware.replace(/,/g, ' ').replace(/\s{2,}/, ' ');
+
+	obj.remove = function() {
+		obj.route && obj.route.remove();
+		delete F.actions[obj.id];
+		obj = null;
+		F.makesourcemap && F.makesourcemap();
+	};
+
+	if (obj.route) {
+		if (obj.route.indexOf('-->') === -1)
+			obj.route = obj.route + '  ' + (obj.input ? '+' : '-') + obj.$url + '  *  -->  ' + name;
+		var flags = null;
+		if (obj.encrypt)
+			flags = '@encrypt';
+		obj.route = F.route(obj.route, flags || []);
+	}
+
+	if (obj.permissions && typeof(obj.permissions) === 'string')
+		obj.permissions = obj.permissions.split(/,|;/).trim();
+
+	if (obj.publish) {
+
+		var tmsschema = obj.publish == true ? (obj.input || obj.output) : obj.publish;
+
+		if (typeof(tmsschema) === 'string') {
+			if (tmsschema[0] === '+')
+				tmsschema = (obj.input || obj.output) + ',' + tmsschema.substring(1);
+
+			var keys = tmsschema.split(',');
+			obj.$publish = [];
+			for (var key of keys) {
+				var index = key.indexOf(':');
+				obj.$publish.push(index === -1 ? key : key.substring(0, index));
+			}
+		}
+
+		F.TMS.newpublish(name, tmsschema);
+	}
+
+	F.makesourcemap && F.makesourcemap();
+	return obj;
+};
+
+function ActionCaller() {
+	var self = this;
+	self.$ = new Options();
+	self.error = new ErrorBuilder();
+	self.options = {};
+	self.actions = [];
+	setImmediate(self => self.exec(), self);
+}
+
+ActionCaller.prototype.debug = function() {
+	this.options.debug = true;
+	return this;
+};
+
+ActionCaller.prototype.params = function(value) {
+	this.options.params = value;
+	return this;
+};
+
+ActionCaller.prototype.exec = function() {
+
+	var self = this;
+	var id = self.actions.shift();
+
+	if (!id) {
+		self.finish && self.finish();
+		self.error = null;
+		self.options = null;
+		self.$ = null;
+		return;
+	}
+
+	var meta = F.temporary.actions[id];
+	if (!meta) {
+
+		let arr = id.split(' ');
+
+		meta = {};
+		meta.response = arr[1] ? true : false;
+		meta.id = arr[0];
+		meta.payload = null;
+
+		let c = meta.id[0];
+		if (c === '+' || c === '-' || c === '%') {
+			// + payload
+			// - without payload
+			// % partial payload
+			meta.payload = c;
+			meta.id = meta.id.substring(1);
+		}
+
+		F.temporary.actions[id] = meta;
+	}
+
+	var action = F.actions[meta.id];
+
+	if (!action) {
+		self.error.push('The action "{0}" not found'.format(meta.id));
+		self.cancel();
+		return;
+	}
+
+	var type = meta.payload || (action.input ? '+' : '-');
+	var $ = self.$;
+
+	$.id = id;
+	$.error = self.error;
+	$.controller = self.controller;
+	$.fields = action.fields;
+	$.user = self.options.user;
+
+	$.$callback = function(err, response) {
+		if (err) {
+			// close
+			self.cancel();
+		} else {
+			$.response[$.id] = response;
+			meta.response && self.finish && self.finish(response);
+			self.exec();
+		}
+	};
+
+	if (action.user && !$.user) {
+		$.invalid(401);
+		return;
+	}
+
+	if (action.sa) {
+		if (!$.user || (!$.user.sa && !$.user.su)) {
+			$.invalid(401);
+			return;
+		}
+	}
+
+	if (action.permissions) {
+		let permissions = action.permissions.slice(0);
+		permissions.unshift($);
+		if (F.unauthorized.apply(global, permissions)) {
+			self.finish = null;
+			self.cancel();
+			return;
+		}
+	}
+
+	var params = self.options.params || EMPTYOBJECT;
+	var query = self.options.query || EMPTYOBJECT;
+	var payload = self.options.payload || EMPTYOBJECT;
+	var response = null;
+
+	if (action.jsquery) {
+		self.error.prefix = 'query.';
+		response = action.jsquery.transform(query, false, self.error);
+		self.error.prefix = '';
+		if (response.error) {
+			self.cancel();
+			return;
+		}
+		$.query = response.response;
+	}
+
+	if (action.jsparams) {
+		self.error.prefix = 'params.';
+		response = action.jsparams.transform(params, false, self.error);
+		self.error.prefix = '';
+		if (response.error) {
+			self.cancel();
+			return;
+		}
+		$.params = response.response;
+	}
+
+	if (action.jsinput && type !== '-') {
+		response = action.jsinput.transform(payload, type === '%', self.error);
+		if (response.error) {
+			self.cancel();
+			return;
+		}
+		$.payload = response.response;
+	}
+
+	action.action($, $.payload);
+};
+
+ActionCaller.prototype.finish = function(value) {
+	var self = this;
+	self.finish = null;
+	self.options.callback(self.error.length ? self.error : null, value === undefined ? self.$.response : value);
+	self.options.callback = null;
+};
+
+ActionCaller.prototype.cancel = function() {
+	var self = this;
+	self.actions.length = 0;
+	self.exec();
+};
+
+ActionCaller.prototype.payload = function(value) {
+	this.options.payload = value;
+	return this;
+};
+
+ActionCaller.prototype.query = function(value) {
+	this.options.query = value;
+	return this;
+};
+
+ActionCaller.prototype.user = function(value) {
+
+	if (value instanceof Options)
+		value = value.user;
+
+	this.options.user = value;
+	return this;
+};
+
+ActionCaller.prototype.language = function(value) {
+	this.options.language = value;
+	return this;
+};
+
+ActionCaller.prototype.error = function(value) {
+	this.options.error = value;
+	return this;
+};
+
+ActionCaller.prototype.done = function($, fn) {
+	this.options.callback = function(err, response) {
+		if (err)
+			$.invalid(err);
+		else
+			fn(response);
+	};
+	return this;
+};
+
+ActionCaller.prototype.callback = function(value) {
+	this.options.callback = value;
+	return this;
+};
+
+ActionCaller.prototype.promise = function($) {
+	var self = this;
+	return new Promise(function(resolve, reject) {
+		self.options.callback = function(err, response) {
+			if (err) {
+				self.options.error && self.options.error(err);
+				if ($ && $.invalid)
+					$.invalid(err);
+				else
+					reject(err);
+			} else
+				resolve(response);
+		};
+	});
+};
+
+ActionCaller.prototype.autorespond = function() {
+	var self = this;
+	self.options.callback = function(err, response) {
+		if (err)
+			self.controller.invalid(err);
+		else
+			self.controller.json(response);
+	};
+	return self;
+};
+
+ActionCaller.prototype.controller = function(ctrl) {
+
+	if (ctrl instanceof Options)
+		ctrl = ctrl.controller;
+
+	this.options.controller = ctrl;
+	return this;
+};
+
+exports.action = function(name, payload, controller) {
+
+	var key = '$' + name;
+	var actions = F.temporary.actions[key];
+
+	if (!actions) {
+		actions = name.replace(/(\s)?\(response\)/i, '\0').split(/\s|\,|\n/);
+		let isresponse = false;
+		for (let i = 0; i < actions.length; i++) {
+			actions[i] = actions[i].replaceAll('\0', ' (response)');
+			if (actions[i].indexOf('(') !== -1)
+				isresponse = true;
+		}
+
+		if (actions.length === 1 && !isresponse)
+			actions[0] += ' (response)';
+		F.temporary.actions[key] = actions;
+	}
+
+	var action = new ActionCaller();
+	action.controller = controller;
+	action.payload = payload;
+	action.actions = actions.slice(0);
+	action.options.payload = payload;
+	action.options.user = controller?.user;
+	action.options.query = controller?.query;
+	action.options.params = controller?.params;
+	return action;
+};
+
+exports.newschema = function(name, callback) {
+	var $ = {};
+	$.name = name;
+	$.actions = {};
+	$.action = function(aname, meta) {
+		return $.actions[aname] = F.newaction(name + '/' + aname, meta);
+	};
+	callback($);
+};
+
+exports.RESTBuilder = RESTBuilder;
+exports.ErrorBuilder = ErrorBuilder;
+exports.Options = Options;