mind-client-js 0.20.0

package/js/login.js

@@ -0,0 +1,215 @@
+/*###############################################################
+#                                                               #
+# Copyright (c) 2025-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 uapi = require("./uapi")
+const fs = require("fs");
+const errors = require("./errors");
+
+let driverName
+let driverDescription
+let driverVersion
+
+try {
+    pack = JSON.parse(fs.readFileSync(__dirname.substring(0, __dirname.lastIndexOf('\\')) + '/package.json', 'utf8'))
+    driverVersion = pack.version
+    driverDescription = pack.description
+    driverName = pack.name
+
+} catch (err) {
+    driverVersion = "test-mode"
+    driverDescription = "test-mode"
+    driverName = "test-mode"
+}
+
+module.exports = async function (that, writer, reader, resolve, reject, username, password, options) {
+    const opCode = 'server.login'
+    const credentials = username + ':' + password
+
+    that.RESP3._init(that)
+    const RESP3 = that.RESP3
+
+    // send command
+    writer(
+        "*6" + RESP3.CRLF +
+        RESP3.build.blob(opCode) +
+        RESP3.build.blob(credentials) +
+        RESP3.build.blob(driverName) +
+        RESP3.build.blob(driverVersion) +
+        RESP3.build.blob(driverDescription) +
+        RESP3.build.blob((options.uApi && options.uApi.appName) || '')
+    );
+
+    // process response
+    reader(data => {
+        if (data.charAt(0) === '-') {
+            reject(new Error(RESP3.parse.simpleError(data)))
+
+            return
+        }
+
+        const dataA = data.split(RESP3.CRLF)
+        let ix = 0
+        let iy = 0
+
+        // check header
+        if (dataA[ix].charAt(0) === '-') {
+            reject(new Error(dataA[0].slice(1)))
+
+            return
+        }
+
+        // proceed with the server array
+        ix += 2
+        const serverLength = parseInt(dataA[ix].slice(1))
+
+        iy = ix
+        for (ix = ix + 1; ix < iy + serverLength * 2; ix += 2) {
+            Object.defineProperties(that.server, {
+                [RESP3.parse.simpleString(dataA[ix])]: {
+                    value: RESP3.parse.simpleString(dataA[ix + 1]),
+                    enumerable: true,
+                    configurable: true
+                }
+            })
+        }
+
+        const mindVersion = that.server.mindVersion
+        if (mindVersion < that.requiresMind) {
+            reject(new Error(errors.BAD_SERVER_VERSION + 'invalid mind server version, expected ' + that.requiresMind + ' or higher, but found ' + mindVersion))
+
+            return
+        }
+
+        const sessionLength = parseInt(dataA[ix].slice(1))
+
+        // continue with session
+        iy = ix
+        for (ix = ix + 1; ix < iy + sessionLength * 3; ix += 2) {
+            const name = RESP3.parse.simpleString(dataA[ix])
+            const strValue = RESP3.parse.simpleString(dataA[ix + 1])
+
+            if (RESP3.parse.simpleString(dataA[ix]) === "pid") {
+                Object.defineProperties(that.process, {
+                    [RESP3.parse.simpleString(dataA[ix])]: {
+                        value: isNaN(parseInt(strValue)) ? strValue : parseInt(strValue),
+                        enumerable: true,
+                        configurable: true,
+                        writable: false
+                    }
+                })
+
+            } else {
+                Object.defineProperties(that.session, {
+                    [RESP3.parse.simpleString(dataA[ix])]: {
+                        value: isNaN(parseInt(strValue)) ? strValue : parseInt(strValue),
+                        enumerable: true,
+                        configurable: true,
+                        writable: false
+                    }
+                })
+            }
+        }
+
+        // finally the user api
+        const uApiJson = RESP3.parse.blob(data.slice(data.indexOf('\r\n$') + 2))
+        const uApi = JSON.parse(uApiJson === '' ? '{}' : uApiJson)
+
+        Object.defineProperties(that, {
+            uApi: {
+                value: uApi.client === undefined ? null : uApi.client,
+                enumerable: false,
+                configurable: true,
+                writable: false
+            }
+        })
+
+        // append reader, writer and root to make them available to deeper levels
+        appendToObject(that.fs, that)
+        appendToObject(that.process, that)
+        appendToObject(that.server, that)
+        appendToObject(that.session, that)
+        appendToObject(that.db, that)
+        appendToObject(that._staticPool, that)
+        appendToObject(that.db.vars, that)
+        appendToObject(that.db.globals, that)
+
+        // and initialize some classes
+        that.server._init(that.server)
+        that.process._init(that.process)
+        that.session._init(that.session)
+        that.db.globals._init(that.db.globals)
+        that.db.vars._init(that.db.vars)
+
+        // make RESP3 and _staticPool not enumerable
+        Object.defineProperties(that, {
+            RESP3: {
+                enumerable: false,
+                configurable: false
+            },
+            _staticPool: {
+                enumerable: false,
+                configurable: true
+            },
+        })
+
+        // now we can add vars and globals names, if any, from the options object
+        if (uApi && uApi.server && uApi.server.vars && uApi.server.vars.length > 0) {
+            uApi.server.vars.forEach(_var => {
+                try {
+                    that.db.vars.addName(_var)
+
+                } catch (err) {
+                    reject(new Error(errors.ERROR_ADDING_NAME + 'Error occurred adding var name: ' + _var + ': ' + err.message))
+                }
+            })
+        }
+
+        if (options && options.db && options.db.globals) {
+            options.db.globals.forEach(_var => {
+                try {
+                    that.db.globals.addName(_var)
+
+                } catch (err) {
+                    reject(new Error(errors.ERROR_ADDING_NAME + 'Error occurred adding global name: ' + _var + ': ' + err.message))
+                }
+            })
+        }
+
+        // and add, if present, the user API
+        if (that.uApi !== null) {
+            uapi.parse(that, writer, reader)
+        }
+
+        // resolve the promise
+        resolve()
+    })
+
+    const appendToObject = (namespace, that) => {
+        Object.defineProperties(namespace, {
+            objRoot: {
+                value: that,
+                enumerable: false,
+                configurable: false
+            },
+            writer: {
+                value: writer,
+                enumerable: false,
+                configurable: false
+            },
+            reader: {
+                value: reader,
+                enumerable: false,
+                configurable: false
+            }
+        })
+    }
+}

package/js/namespaces/RESP3.js

@@ -0,0 +1,211 @@
+/*###############################################################
+#                                                               #
+# 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.           #
+#                                                               #
+###############################################################*/
+
+class RESP3 {
+
+    build = {
+        blobError: str => '!' + str.length.toString() + '\r\n' + str + '\r\n',
+        simpleError: str => '-' + str + '\r\n',
+
+        simpleString: str => '+' + str + '\r\n',
+        blob: str => '$' + str.toString().length.toString() + '\r\n' + str.toString() + '\r\n',
+        verbatimString: (str, type) => {
+            if (type.length !== 3) {
+                throw new Error(errors.VERBATIM_TYPE_NOT_3_CHARS + 'Verbatim type MUST be 3 chars length!')
+            }
+
+            return '=' + (str.length + 4).toString() + '\r\n' + type + ':' + str + '\r\n'
+        },
+        streamedString: () => '',
+
+        _null: () => '_\r\n',
+        _true: () => '#t\r\n',
+        _false: () => '#f\r\n',
+
+        int: val => '#f' + val.toString() + '\r\n',
+        double: val => ',' + val.toString() + '\r\n',
+        bigNumber: val => '(' + val.toString() + '\r\n'
+    }
+
+    parse = {
+        extractToken: str => str.slice(1, str.slice(-2) === '\r\n' ? -2 : str.length),
+
+        map: str => str,
+
+        blob: str => str.slice(2 + str.indexOf('\r\n'), -2),
+
+        simpleString: function (str) {
+            return this.extractToken(str)
+        },
+
+        simpleError: function (str) {
+            return this.extractToken(str)
+        },
+
+        boolean: function (str) {
+            return this.extractToken(str) === 't'
+        },
+
+        null: function (str) {
+            return this.extractToken(str)
+        },
+
+        int: function (str) {
+            return parseInt(this.extractToken(str))
+        },
+
+        double: function (str) {
+            return parseFloat(this.extractToken(str))
+        },
+
+        bigNumber: function (str) {
+            return this.extractToken(str)
+        },
+
+        returns: function (str, returnDatatype) {
+            let type = str.charAt(0)
+
+            if (type === '') {
+                type = '|'
+                str = '\r\n' + str.slice(str.indexOf('\n') + 1)
+            }
+
+            switch (type) {
+                case '+':
+                    return this.simpleString(str)
+
+                case '$':
+                    return this.blob(str)
+
+                case ':':
+                    return this.int(str)
+
+                case '_':
+                    return null
+
+                case ',':
+                    return this.double(str)
+
+                case '#':
+                    return this.boolean(str)
+
+                case '|':
+                    if (returnDatatype === 'object') {
+                        return JSON.parse(str.slice(6 + str.indexOf('\r\n'), -2))
+
+                    } else {
+                        return str.slice(6 + str.indexOf('\r\n'), -2)
+                    }
+
+                default :
+                    return this.simpleError('+INVALID RESP3 datatype')
+            }
+        }
+    }
+
+    convert = {
+        jsArrayToRESP3: array => {
+
+        },
+
+        jsObjectToRESP3: object => {
+
+        }
+    }
+
+    _init = that => {
+        Object.defineProperties(that.RESP3, {
+            extractToken: {
+                value: str => str.slice(1, str.slice(-2) === '\r\n' ? -2 : str.length),
+                enumerable: false,
+                configurable: true,
+                writable: false
+            },
+            CRLF: {
+                value: '\r\n',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            LF: {
+                value: '\n',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            null: {
+                value: '_',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            boolean: {
+                value: '#',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            true: {
+                value: '#t',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            false: {
+                value: '#f',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            int: {
+                value: ':',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            double: {
+                value: ',',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            bigNumber: {
+                value: '(',
+                enumerable: true,
+                configurable: true,
+                writable: false
+            },
+
+            _init: {
+                enumerable: false,
+            }
+        })
+
+        Object.defineProperties(that.RESP3.parse, {
+            extractToken: {
+                enumerable: false,
+                configurable: true,
+                writable: false
+            },
+        })
+    }
+}
+
+module.exports = RESP3

package/js/namespaces/_staticPool.js

@@ -0,0 +1,156 @@
+/*###############################################################
+#                                                               #
+# 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')
+
+class _staticPool {
+    _register = function (pool) {
+        const that = this
+        const RESP3 = that.objRoot.RESP3
+        const pids = []
+
+        pool.sessions.forEach(session => {
+            pids.push(session.session.process.pid)
+        })
+
+        return new Promise(function (resolve, reject) {
+            if (that.objRoot.connected === false || that.objRoot.loggedIn === false) {
+                reject(new Error(errors.POOL_NOT_INITIALIZED + 'pool not initialized'))
+            }
+
+            // send command
+            const opCode = 'pool.register'
+
+            that.writer("*2" + RESP3.CRLF +
+                RESP3.build.blob(opCode) +
+                RESP3.build.blob(JSON.stringify(pids))
+            );
+
+            that.reader(data => {
+                if (data.charAt(0) === '-') {
+                    reject(new Error(RESP3.parse.simpleError(data)))
+
+                    return
+                }
+
+                resolve(RESP3.parse.simpleString(data))
+            })
+        })
+    }
+
+    _getPoolStats = function () {
+        const that = this
+        const RESP3 = that.objRoot.RESP3
+
+        return new Promise(function (resolve, reject) {
+            if (that.objRoot.connected === false || that.objRoot.loggedIn === false) {
+                reject(new Error(errors.POOL_NOT_INITIALIZED + 'Pool not initialized'))
+            }
+
+            // send command
+            const opCode = 'pool.getPoolStats'
+
+            that.writer("*1" + RESP3.CRLF +
+                RESP3.build.blob(opCode)
+            );
+
+            that.reader(data => {
+                if (data.charAt(0) === '-') {
+                    reject(new Error(RESP3.parse.simpleError(data)))
+
+                    return
+                }
+
+                resolve(JSON.parse(RESP3.parse.blob(data)))
+            })
+        })
+    }
+
+    _changeServerSetting = function (name, value) {
+        const that = this
+        const RESP3 = that.objRoot.RESP3
+
+        return new Promise(function (resolve, reject) {
+            if (that.objRoot.connected === false || that.objRoot.loggedIn === false) {
+                reject(new Error(errors.POOL_NOT_INITIALIZED + 'pool not initialized'))
+            }
+
+            if (typeof name !== 'string') {
+                reject(new Error(errors.PARAM_NOT_STRING + 'name must be a string'))
+
+                return
+            }
+
+            if (name === '') {
+                reject(new Error(errors.PARAM_NOT_STRING_OR_EMPTY + 'name must be a string longer than 0 chars'))
+
+                return
+            }
+
+            if (typeof value !== 'number') {
+                reject(new Error(errors.PARAM_NOT_NUMBER + 'value must be a number'))
+
+                return
+            }
+
+            // send command
+            const opCode = 'pool.changeServerSetting'
+
+            that.writer("*3" + RESP3.CRLF +
+                RESP3.build.blob(opCode) +
+                RESP3.build.blob(name) +
+                RESP3.build.blob(value)
+            );
+
+            that.reader(data => {
+                if (data.charAt(0) === '-') {
+                    reject(new Error(RESP3.parse.simpleError(data)))
+
+                    return
+                }
+
+                resolve()
+            })
+        })
+    }
+
+    _rundown = function () {
+        const that = this
+        const RESP3 = that.objRoot.RESP3
+
+        return new Promise(function (resolve, reject) {
+            if (that.objRoot.connected === false || that.objRoot.loggedIn === false) {
+                reject(new Error(errors.POOL_NOT_INITIALIZED + 'Pool not initialized'))
+            }
+
+            // send command
+            const opCode = 'pool.rundown'
+
+            that.writer("*1" + RESP3.CRLF +
+                RESP3.build.blob(opCode)
+            );
+
+            that.reader(data => {
+                if (data.charAt(0) === '-') {
+                    reject(new Error(RESP3.parse.simpleError(data)))
+
+                    return
+                }
+
+                resolve()
+            })
+        })
+    }
+}
+
+module.exports = _staticPool

package/js/namespaces/db.js

@@ -0,0 +1,23 @@
+/*###############################################################
+#                                                               #
+# 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 Vars = require('./vars')
+const Globals = require('./globals')
+
+class Db {
+    vars = new Vars
+    globals = new Globals
+
+}
+
+
+module.exports = Db

package/js/namespaces/dbms.js

@@ -0,0 +1,18 @@
+/*###############################################################
+#                                                               #
+# 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.           #
+#                                                               #
+###############################################################*/
+
+class Dbms {
+
+}
+
+
+module.exports = Dbms