alchemymvc 1.3.21 → 1.4.0-alpha.1

package/lib/core/client_alchemy.js

@@ -3,7 +3,7 @@
  *
  * @constructor
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    0.1.0
  * @version  1.3.21
  */
@@ -32,9 +32,9 @@ var Alchemy = Function.inherits('Alchemy.Client.Base', function Alchemy() {
 /**
  * A reference to the main hawkejs instance
  *
- * @author    Jelle De Loecker   <jelle@elevenways.be>
- * @since     1.2.3
- * @version   1.2.3
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.2.3
+ * @version  1.2.3
  */
 Alchemy.setProperty(function hawkejs() {
 	return window.hawkejs;
@@ -43,9 +43,9 @@ Alchemy.setProperty(function hawkejs() {
 /**
  * Called in the onScene static method of the Alchemy helper
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     1.0.5
- * @version   1.0.7
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.0.5
+ * @version  1.0.7
  */
 Alchemy.setMethod(function initScene(scene, options) {
 
@@ -71,12 +71,12 @@ Alchemy.setMethod(function initScene(scene, options) {
 	/**
 	 * Automatically add json-dry decoding to jQuery libraries
 	 *
-	 * @author    Jelle De Loecker   <jelle@develry.be>
-	 * @since     0.2.0
-	 * @version   1.1.0
+	 * @author   Jelle De Loecker <jelle@elevenways.be>
+	 * @since    0.2.0
+	 * @version  1.1.0
 	 *
-	 * @param     {String}   name
-	 * @param     {String}   path
+	 * @param    {string}   name
+	 * @param    {string}   path
 	 */
 	scene.on('script', function newScriptLoaded(name, path) {
 
@@ -134,12 +134,12 @@ Alchemy.setMethod(function initScene(scene, options) {
 /**
  * Log a distinct warning
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.0
  * @version  1.3.1
  *
- * @param    {String}   id
- * @param    {String}   message
+ * @param    {string}   id
+ * @param    {string}   message
  * @param    {Object}   options
  *
  * @return   {Object}
@@ -202,13 +202,13 @@ Alchemy.setMethod(function distinctProblem(id, message, options = {}) {
 /**
  * Register a custom handler
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.21
  * @version  1.3.21
  *
- * @param   {string|symbol}  type
- * @param   {Function}       callback
- * @param   {Number}         weight
+ * @param    {string|symbol}  type
+ * @param    {Function}       callback
+ * @param    {number}         weight
  */
 Alchemy.setMethod(function registerCustomHandler(type, callback, weight) {
 
@@ -233,13 +233,13 @@ Alchemy.setMethod(function registerCustomHandler(type, callback, weight) {
 /**
  * Get the highest priority custom handler of the given type
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.21
  * @version  1.3.21
  *
- * @param   {string|symbol}  type
+ * @param    {string|symbol}  type
  *
- * @return  {Function}
+ * @return   {Function}
  */
 Alchemy.setMethod(function getCustomHandler(type) {
 
@@ -253,13 +253,13 @@ Alchemy.setMethod(function getCustomHandler(type) {
 /**
  * Get all the custom handlers of the given type
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.21
  * @version  1.3.21
  *
- * @param   {string|symbol}  type
+ * @param    {string|symbol}  type
  *
- * @return  {Function[]}
+ * @return   {Function[]}
  */
 Alchemy.setMethod(function getAllCustomHandlers(type) {
 
@@ -275,23 +275,22 @@ Alchemy.setMethod(function getAllCustomHandlers(type) {
 /**
  * Actually print a log message
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    0.4.0
- * @version  1.1.0
+ * @version  1.4.0
  *
- * @param    {Number}   level
+ * @param    {number}   level
  * @param    {Array}    args
  * @param    {Object}   options
  */
 Alchemy.setMethod(function printLog(level, args, options) {
 
-	var type,
-	    line;
-
-	if (this.settings.silent) {
+	if (Blast.isServer && this.settings.debugging.silent) {
 		return;
 	}
 
+	let type;
+
 	if (!Array.isArray(args)) {
 		args = [args];
 	}
@@ -314,9 +313,9 @@ Alchemy.setMethod(function printLog(level, args, options) {
 /**
  * Create an alias to the __ command
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.4.0
- * @version   1.0.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.4.0
+ * @version  1.0.5
  */
 Alchemy.setMethod(function __(domain, key, parameters) {
 	return hawkejs.scene.generalView.__(domain, key, parameters);
@@ -325,9 +324,9 @@ Alchemy.setMethod(function __(domain, key, parameters) {
 /**
  * Create an alias to the __d command
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.4.0
- * @version   1.0.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.4.0
+ * @version  1.0.5
  */
 Alchemy.setMethod(function __d(domain, key, parameters) {
 	return hawkejs.scene.generalView.__d(domain, key, parameters);
@@ -336,11 +335,11 @@ Alchemy.setMethod(function __d(domain, key, parameters) {
 /**
  * Set the permission checker
  *
- * @author    Jelle De Loecker   <jelle@elevenways.be>
- * @since     1.2.5
- * @version   1.2.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.2.5
+ * @version  1.2.5
  *
- * @param     {Object}   instance
+ * @param    {Object}   instance
  */
 Alchemy.setMethod(function setPermissionChecker(instance) {
 
@@ -356,13 +355,13 @@ Alchemy.setMethod(function setPermissionChecker(instance) {
 /**
  * Cast to an object id
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.0.0
  * @version  1.1.0
  *
- * @param    {String|ObjectID}   str
+ * @param    {string|ObjectID}   str
  *
- * @return   {String}
+ * @return   {string}
  */
 Alchemy.setMethod(function castObjectId(str) {
 
@@ -391,13 +390,13 @@ Alchemy.setMethod(function castObjectId(str) {
 /**
  * Is the given parameter an object id (string or instance)
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.0.4
  * @version  1.3.16
  *
- * @param    {String|ObjectId}   obj
+ * @param    {string|ObjectId}   obj
  *
- * @return   {Boolean}
+ * @return   {boolean}
  */
 Alchemy.setMethod(function isObjectId(obj) {
 
@@ -423,13 +422,13 @@ Alchemy.setMethod(function isObjectId(obj) {
 /**
  * Get validator class constructor
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     1.0.5
- * @version   1.1.0
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.0.5
+ * @version  1.1.0
  *
- * @param     {String}   name
+ * @param    {string}   name
  *
- * @return    {Function|null}
+ * @return   {Function|null}
  */
 Alchemy.setMethod(function getValidatorClass(name) {
 
@@ -447,13 +446,13 @@ Alchemy.setMethod(function getValidatorClass(name) {
 /**
  * Get the display title of something
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.13
  * @version  1.3.14
  *
  * @param    {Object}   value
  *
- * @return   {String}
+ * @return   {string}
  */
 Alchemy.setMethod(function getDisplayTitle(value, max_length) {
 
@@ -504,13 +503,13 @@ Alchemy.setMethod(function getDisplayTitle(value, max_length) {
 /**
  * Pick a translation
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    0.0.1
  * @version  1.1.0
  *
- * @param    {String|Array}    prefix       The prefix to get
+ * @param    {string|Array}    prefix       The prefix to get
  * @param    {Object}          choices      The available choices
- * @param    {Boolean}         allow_empty  Empty strings are not allowed by default
+ * @param    {boolean}         allow_empty  Empty strings are not allowed by default
  */
 Alchemy.setMethod(function pickTranslation(_prefix, choices, allow_empty) {
 
@@ -559,11 +558,11 @@ Alchemy.setMethod(function pickTranslation(_prefix, choices, allow_empty) {
 /**
  * Get the prefixes
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     1.1.0
- * @version   1.1.0
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.1.0
+ * @version  1.1.0
  *
- * @return    {Object}
+ * @return   {Object}
  */
 Alchemy.setMethod(function getPrefixes() {
 
@@ -577,13 +576,13 @@ Alchemy.setMethod(function getPrefixes() {
 /**
  * Safely checksum a variable
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     1.1.5
- * @version   1.1.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.1.5
+ * @version  1.1.5
  *
- * @param     {*}        value
+ * @param    {*}        value
  *
- * @return    {String}
+ * @return   {string}
  */
 Alchemy.setMethod(function checksum(value) {
 
@@ -602,12 +601,12 @@ Alchemy.setMethod(function checksum(value) {
 /**
  * Mark element as active or not
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.3.0
- * @version   1.1.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.3.0
+ * @version  1.1.5
  *
- * @param     {Element}   element
- * @param     {Number}    active_nr
+ * @param    {Element}   element
+ * @param    {number}    active_nr
  */
 Alchemy.setMethod(function markLinkElement(element, active_nr) {
 
@@ -633,13 +632,13 @@ Alchemy.setMethod(function markLinkElement(element, active_nr) {
 /**
  * Get the configuration for the given route
  *
- * @author    Jelle De Loecker   <jelle@elevenways.be>
- * @since     1.2.7
- * @version   1.2.7
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.2.7
+ * @version  1.2.7
  *
- * @param     {String}   name         The route name
+ * @param    {string}   name         The route name
  *
- * @return    {Object}
+ * @return   {Object}
  */
 Alchemy.setMethod(function routeConfig(name) {
 
@@ -659,7 +658,7 @@ const markLinkElement = Alchemy.prototype.markLinkElement;
 /**
  * Get a live map of all the routes
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.8
  * @version  1.3.8
  *
@@ -672,7 +671,7 @@ Alchemy.setMethod(function getRoutes() {
 /**
  * The live-map dictionary creator
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.3.8
  * @version  1.3.8
  *
@@ -711,13 +710,6 @@ function getRoutesDict() {
 
 // From here on, only client-side code is added
 if (Blast.isBrowser) {
-	window.LocalDateTime = Blast.Classes.Develry.LocalDateTime;
-	window.LocalDate = Blast.Classes.Develry.LocalDate;
-	window.LocalTime = Blast.Classes.Develry.LocalTime;
-	window.Decimal = Blast.Classes.Develry.Decimal;
-	window.MutableDecimal = Blast.Classes.Develry.MutableDecimal;
-	window.FixedDecimal = Blast.Classes.Develry.FixedDecimal;
-	window.MutableFixedDecimal = Blast.Classes.Develry.MutableFixedDecimal;
 	window.alchemy = new Alchemy();
 } else {
 	return;
@@ -726,7 +718,7 @@ if (Blast.isBrowser) {
 /**
  * Create a socket.io connection to the server
  *
- * @author   Jelle De Loecker   <jelle@develry.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    0.0.1
  * @version  1.0.5
  *
@@ -748,11 +740,11 @@ Alchemy.setMethod(function connect(callback) {
 /**
  * Submit a message to the server
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.0.1
- * @version   1.0.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.0.1
+ * @version  1.0.5
  *
- * @param    {String}   type
+ * @param    {string}   type
  * @param    {Object}   data
  * @param    {Function} callback
  */
@@ -763,11 +755,11 @@ Alchemy.setMethod(function submit(type, data, callback) {
 /**
  * Create a namespace and inform the server
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.2.0
- * @version   1.0.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.2.0
+ * @version  1.0.5
  *
- * @param    {String}   type    The typename of link to create
+ * @param    {string}   type    The typename of link to create
  * @param    {Object}   data    The initial data to submit
  *
  * @return   {Linkup}
@@ -779,12 +771,12 @@ Alchemy.setMethod(function linkup(type, data, cb) {
 /**
  * Mark links as active using breadcrumbs
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.3.0
- * @version   1.3.8
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.3.0
+ * @version  1.3.8
  *
- * @param     {Object}   variables
- * @param     {Object}   render_data
+ * @param    {Object}   variables
+ * @param    {Object}   render_data
  */
 Alchemy.setMethod(function markLinks(variables, render_data) {
 
@@ -875,9 +867,9 @@ Alchemy.setMethod(function markLinks(variables, render_data) {
 /**
  * Reload all stylesheets
  *
- * @author    Jelle De Loecker   <jelle@elevenways.be>
- * @since     1.0.0
- * @version   1.3.8
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.0.0
+ * @version  1.3.8
  */
 Alchemy.setMethod(function reloadStylesheets() {
 
@@ -907,9 +899,9 @@ Alchemy.setMethod(function reloadStylesheets() {
 /**
  * Change the language
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.4.1
- * @version   1.2.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.4.1
+ * @version  1.2.5
  */
 Alchemy.setMethod(function switchLanguage(prefix) {
 
@@ -953,9 +945,9 @@ Alchemy.setMethod(function switchLanguage(prefix) {
 /**
  * Navigate to the url & return false
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     1.1.0
- * @version   1.1.0
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.1.0
+ * @version  1.1.0
  */
 function doNavigate(url) {
 
@@ -969,15 +961,15 @@ function doNavigate(url) {
 /**
  * Goto the given url
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.4.1
- * @version   1.1.0
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.4.1
+ * @version  1.1.0
  *
- * @param     {String|RURL}   href
- * @param     {Object}        options
- * @param     {Function}      callback
+ * @param    {string|RURL}   href
+ * @param    {Object}        options
+ * @param    {Function}      callback
  *
- * @return    {Pledge}
+ * @return   {Pledge}
  */
 Alchemy.setMethod(function openUrl(href, options, callback) {
 
@@ -1036,15 +1028,15 @@ Alchemy.setMethod(function openUrl(href, options, callback) {
 /**
  * Fetch data from the server
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.4.0
- * @version   1.1.0
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.4.0
+ * @version  1.1.0
  *
- * @param     {String}   href
- * @param     {Object}   options
- * @param     {Function} callback
+ * @param    {string}   href
+ * @param    {Object}   options
+ * @param    {Function} callback
  *
- * @return    {Pledge}
+ * @return   {Pledge}
  */
 Alchemy.decorateMethod(Blast.Decorators.memoize({max_age: 500, ignore_callbacks: true}), function fetch(href, options, callback) {
 
@@ -1079,14 +1071,14 @@ Alchemy.decorateMethod(Blast.Decorators.memoize({max_age: 500, ignore_callbacks:
 /**
  * Get a route
  *
- * @author    Jelle De Loecker   <jelle@elevenways.be>
- * @since     1.1.0
- * @version   1.3.0
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.1.0
+ * @version  1.3.0
  *
- * @param     {String}   href         The href or route name
- * @param     {Object}   parameters   Route parameters
+ * @param    {string}   href         The href or route name
+ * @param    {Object}   parameters   Route parameters
  *
- * @return    {String}
+ * @return   {string}
  */
 Alchemy.setMethod(function routeUrl(href, parameters, options) {
 	let temp = hawkejs.scene.helpers.Router.routeUrl(href, parameters, options);
@@ -1105,9 +1097,9 @@ Alchemy.setMethod(function routeUrl(href, parameters, options) {
 /**
  * Send binding data to the server
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     0.2.0
- * @version   1.0.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    0.2.0
+ * @version  1.0.5
  */
 Alchemy.setMethod(function sendBindingRequests() {
 
@@ -1153,9 +1145,9 @@ Alchemy.setMethod(function sendBindingRequests() {
 /**
  * Enable websockets
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     1.0.5
- * @version   1.3.10
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.0.5
+ * @version  1.3.10
  */
 Alchemy.setMethod(function enableWebsockets() {
 
@@ -1278,12 +1270,12 @@ Alchemy.setMethod(function enableWebsockets() {
 /**
  * Handle an error
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     1.0.5
- * @version   1.0.5
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.0.5
+ * @version  1.0.5
  *
- * @param     {Error}   err
- * @param     {Object}  config
+ * @param    {Error}   err
+ * @param    {Object}  config
  */
 Alchemy.setMethod(function handleError(err, config) {
 
@@ -1318,11 +1310,11 @@ Alchemy.setMethod(function handleError(err, config) {
 /**
  * Sync data with the server
  *
- * @author    Jelle De Loecker   <jelle@develry.be>
- * @since     1.0.6
- * @version   1.0.6
+ * @author   Jelle De Loecker <jelle@elevenways.be>
+ * @since    1.0.6
+ * @version  1.0.6
  *
- * @return    {Pledge}
+ * @return   {Pledge}
  */
 Alchemy.setMethod(function syncDataWithServer() {
 
@@ -1356,7 +1348,7 @@ Alchemy.setMethod(function syncDataWithServer() {
 /**
  * Create a new schema on the client
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.2.1
  * @version  1.2.1
  *
@@ -1370,14 +1362,14 @@ Alchemy.setMethod(function createSchema(parent) {
 /**
  * Get a client-side model
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.2.4
  * @version  1.2.4
  *
- * @param   {String}   name
- * @param   {Object}   options
+ * @param    {string}   name
+ * @param    {Object}   options
  *
- * @return  {Model}
+ * @return   {Model}
  */
 Alchemy.setMethod(function getClientModel(name, init, options) {
 	return Classes.Alchemy.Client.Base.prototype.getModel.call(this, name, init, options);
@@ -1386,13 +1378,13 @@ Alchemy.setMethod(function getClientModel(name, init, options) {
 /**
  * Check if the current client-side user has a certain permission
  *
- * @author   Jelle De Loecker   <jelle@elevenways.be>
+ * @author   Jelle De Loecker <jelle@elevenways.be>
  * @since    1.2.7
  * @version  1.2.7
  *
- * @param   {String}   permission
+ * @param    {string}   permission
  *
- * @return  {Boolean}
+ * @return   {boolean}
  */
 Alchemy.setMethod(function hasPermission(permission) {