mind-client-js 0.20.0

package/js/namespaces/uApi.js

@@ -0,0 +1,157 @@
+/*###############################################################
+#                                                               #
+# Copyright (c) 2026 DnaSoft BV and/or its subsidiaries.        #
+# All rights reserved.                                          #
+#                                                               #
+#   This source code contains the intellectual property         #
+#   of its copyright holder(s), and is made available           #
+#   under a license.  If you do not know the terms of           #
+#   the license, please stop and do not read further.           #
+#                                                               #
+###############################################################*/
+
+const utils = require("../utils");
+const errors = require('../errors.js')
+
+const funct = module.exports = {
+    method: function (that, reader, writer, fn, namespace, args) {
+        const RESP3 = that.RESP3
+        const package = []
+
+        return new Promise(function (resolve, reject) {
+            if (that.connected === false || that.loggedIn === false) {
+                reject(new Error(errors.NOT_LOGGED_IN + 'Not logged in'))
+
+                return
+            }
+
+            // validate parameters
+            try {
+                parseParams(fn, args, that)
+
+            } catch (err) {
+                reject(err)
+
+                return
+            }
+
+            // prepare parameters
+            args.forEach((arg, ix) => {
+                switch (typeof arg) {
+                    case 'undefined':
+                        args[ix] = '___'
+
+                        break
+                    case 'boolean':
+                        args[ix] = arg === true ? '1' : '0'
+
+                        break
+                    case 'number':
+                        args[ix] = arg.toString()
+
+                        break
+                    case 'object':
+                        args[ix] = JSON.stringify(arg)
+
+                        break
+                    default:
+                }
+            })
+
+            // prepare package
+            package.push(RESP3.build.blob(namespace + '.' + fn.name))
+            args.forEach(arg => {
+                package.push(RESP3.build.blob(arg))
+            })
+
+            // send package
+            writer('*' + (package.length) + RESP3.CRLF + package.join(''))
+
+            reader(data => {
+                if (data.charAt(0) === '-') {
+                    // process eventual simple error
+                    reject(new Error(RESP3.parse.simpleError(data)))
+
+                    return
+
+                } else if (data.charAt(0) === '!') {
+                    // process eventual blob error
+                    reject(new Error(RESP3.build.blobError(data)))
+
+                    return
+                }
+
+                // check whether it needs to return a value or just resolve()
+                if (fn.returns && typeof fn.returns === 'string') {
+                    resolve(RESP3.parse.returns(data, fn.returns))
+
+                } else resolve()
+            })
+        })
+    }
+}
+
+const parseParams = function (fn, args, that) {
+    if (fn.parameters && fn.parameters.length > 0) {
+        // when # of params is < that requested
+        if (fn.parameters.length !== args.length) {
+            throw new Error(errors.METHOD_BAD_ARGS_NUMBER + 'Expected ' + fn.parameters.length + ' parameters, got ' + args.length + '.')
+        }
+
+        // validate datatype of each parameter
+        fn.parameters.forEach(function (param, ix) {
+            switch (param.datatype) {
+                case 'int':
+                case 'float': {
+                    if (typeof args[ix] !== 'number' && typeof args[ix] !== 'undefined') {
+                        throw new Error(errors.PARAM_NOT_NUMBER + 'Parameter ' + (ix + 1) + ': "' + param.name + '" must be a number.')
+                    }
+
+                    if (args[ix].toString().indexOf('.') > -1 && param.datatype === 'int') {
+                        throw new Error(errors.PARAM_NOT_INT + 'Parameter ' + (ix + 1) + ': "' + param.name + '" must be an int.')
+                    }
+
+                    break
+                }
+
+                case 'varByRef': {
+                    if (typeof args[ix] !== 'string' && typeof args[ix] !== 'undefined') {
+                        throw new Error(errors.PARAM_NOT_STRING + 'Parameter ' + (ix + 1) + ': "' + param.name + '" must be a string populated with the var name.')
+
+                    }
+
+                    let found = false
+                    Object.keys(that.db.vars).forEach(function (varName) {
+                        if (varName === args[ix]) found = true;
+                    })
+
+                    if (found === false) {
+                        throw new Error(errors.PARAM_NOT_EXISTING + 'Parameter ' + (ix + 1) + ': "' + param.name + '" var: "' + args[ix] + '" was not declared.')
+                    }
+
+                    break
+                }
+
+                case 'json': {
+                    if (typeof args[ix] !== 'string' && typeof args[ix] !== 'undefined') {
+                        throw new Error(errors.PARAM_NOT_STRING + 'Parameter ' + (ix + 1) + ': "' + param.name + '" must be a string.')
+                    }
+
+                    break
+                }
+
+                default: {
+                    if (typeof args[ix] !== param.datatype && typeof args[ix] !== 'undefined') {
+                        throw new Error(errors.PARAM_BAD_DATA_TYPE + 'Parameter ' + (ix + 1) + ': "' + param.name + '" must be a ' + param.datatype + '.')
+                    }
+
+                    break
+                }
+            }
+        })
+
+        // when args are passed, but not needed
+    } else if ((!fn.parameters || fn.parameters.length === 0) && args.length > 0) {
+        throw (new Error('This method has no parameters'))
+    }
+}

package/js/namespaces/vars.js

@@ -0,0 +1,51 @@
+/*###############################################################
+#                                                               #
+# Copyright (c) 2026 DnaSoft BV and/or its subsidiaries.        #
+# All rights reserved.                                          #
+#                                                               #
+#   This source code contains the intellectual property         #
+#   of its copyright holder(s), and is made available           #
+#   under a license.  If you do not know the terms of           #
+#   the license, please stop and do not read further.           #
+#                                                               #
+###############################################################*/
+
+const GlvnManagement = require('../extends/glvnManagement')
+
+class Vars extends GlvnManagement {
+    _type = 'vars'
+
+    _init = function (obj) {
+        Object.defineProperties(obj, {
+            _type: {
+                enumerable: false,
+                configurable: false,
+                writable: false
+            },
+        })
+
+        Object.defineProperties(obj, {
+            addName: {
+                enumerable: true,
+                configurable: false,
+                writable: false
+            },
+        })
+
+        Object.defineProperties(obj, {
+            removeName: {
+                enumerable: true,
+                configurable: false,
+                writable: false
+            },
+        })
+
+        Object.defineProperties(obj, {
+            _init: {
+                enumerable: false,
+            }
+        })
+    }
+}
+
+module.exports = Vars