mind-client-js 0.20.0

package/js/dynamic-pool.js

@@ -0,0 +1,145 @@
+/*###############################################################
+#                                                               #
+# 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 errors = require('./errors')
+
+module.exports = {
+    createNewSession: async function (that, classModule, timeout) {
+        return new Promise(async (resolve, reject) => {
+                const session = new classModule.exports.session
+
+            if (that.maxSize > 0 && Object.keys(that.sessions).length === that.maxSize) {
+                reject(new Error(errors.POOL_NO_MORE_SLOTS + 'you reached the maximum number of slots available for this pool'))
+
+                return
+            }
+
+                try {
+                    await session.connect(that.host, that.port, that.username, that.password, that.options)
+
+                    Object.assign(that.sessions, {
+                        [session.session.GUID]: {
+                            session: session,
+                            inUse: true
+                        }
+                    })
+
+                    Object.assign(session, {
+                        done: function () {
+                            that.sessions[session.session.GUID].inUse = false
+                        }
+                    })
+
+                    // mount handler to remove entry from sessions{} when remote disconnect occurs
+                    session.on('disconnect', function () {
+                        delete that.sessions[this.session.GUID]
+
+                        that.stats.remoteDisconnects++
+                    })
+
+                    resolve([session, session.session.GUID])
+
+                } catch
+                    (err) {
+                    reject(err)
+                }
+            }
+        )
+    },
+
+    getSessionByGUID: async function (that, classModule, GUID, timeout) {
+        return new Promise(async (resolve, reject) => {
+            try {
+                if (that.sessions[GUID] === undefined) {
+                    reject(new Error(errors.POOL_GUID_NOT_FOUND + 'guid does not exist'))
+
+                    return
+                }
+
+                // TODO: this should be change in a queue with 0 ms timer
+                if (that.sessions[GUID].inUse === true) {
+                    that.stats.inUseError++
+
+                    reject(new Error(errors.POOL_SESSION_IN_USE + 'session in use'))
+
+                    return
+                }
+
+                that.sessions[GUID].inUse = true
+
+                resolve(that.sessions[GUID].session)
+
+            } catch (err) {
+                reject(err)
+            }
+        })
+    },
+
+    terminateSession: async function (that, GUID) {
+        return new Promise(async (resolve, reject) => {
+            try {
+                if (that.sessions[GUID] === undefined) {
+                    reject(new Error(errors.POOL_GUID_NOT_FOUND + 'guid does not exist'))
+
+                    return
+                }
+
+                that.sessions[GUID].session.disconnect()
+                delete that.sessions[GUID]
+
+                resolve()
+
+            } catch (err) {
+                reject(err)
+            }
+        })
+    },
+
+    terminatePool: async function (that) {
+        return new Promise(async (resolve, reject) => {
+            try {
+                for (const [guid, session] of Object.entries(that.sessions)) {
+                    await session.session.disconnect()
+                    delete that.sessions[guid]
+                }
+
+                resolve()
+
+            } catch (err) {
+                reject(err)
+            }
+        })
+    },
+
+    getStatus: async function (that, GUID) {
+        return new Promise(async (resolve, reject) => {
+
+        })
+    },
+
+    verifyConnection: async function (that, classModule) {
+        return new Promise(async (resolve, reject) => {
+            const session = new classModule.exports.session
+
+            try {
+                await session.connect(that.host, that.port, that.username, that.password, that.options)
+
+                resolve()
+
+            } catch (err) {
+                reject(err)
+            }
+
+            session.disconnect()
+        })
+    },
+}

package/js/errors.js

@@ -0,0 +1,84 @@
+/*###############################################################
+#                                                               #
+# 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.           #
+#                                                               #
+###############################################################*/
+
+module.exports = {
+    NOT_LOGGED_IN: 'NOT_LOGGED_IN,',
+
+    LOG_STR_NOT_A_STRING: 'LOG_STR_NOT_A_STRING,',
+
+    NAME_ALREADY_REGISTERED: 'NAME_ALREADY_REGISTERED,',
+    NAME_NOT_FOUND: 'NAME_NOT_FOUND,',
+    NAME_EMPTY_OR_NOT_STRING: 'NAME_EMPTY_OR_NOT_STRING,',
+    ERROR_ADDING_NAME: 'ERROR_ADDING_NAME,',
+
+    POOL_SIZE_NOT_MIN_TWO: 'POOL_SIZE_NOT_MIN_TWO.',
+
+    HOST_MUST_BE_STRING: 'HOST_MUST_BE_STRING,',
+    PORT_MUST_BE_NUMBER: 'PORT_MUST_BE_NUMBER,',
+    USERNAME_MUST_BE_STRING: 'USERNAME_MUST_BE_STRING,',
+    PASSWORD_MUST_BE_STRING: 'PASSWORD_MUST_BE_STRING,',
+    TIMEOUT_MUST_BE_NUMBER: 'TIMEOUT_MUST_BE_NUMBER,',
+    TIMEOUT_NOT_POSITIVE_NUMBER: 'TIMEOUT_NOT_POSITIVE_NUMBER,',
+
+    METHOD_BAD_ARGS_NUMBER: 'METHOD_BAD_ARGS_NUMBER,',
+    METHOD_PARAM_NOT_NUMBER: 'METHOD_PARAM_NOT_NUMBER,',
+    METHOD_PARAM_NOT_STRING: 'METHOD_PARAM_NOT_STRING,',
+    METHOD_PARAM_NOT_VAR_NAME: 'METHOD_PARAM_NOT_VAR_NAME,',
+
+    PARAM_NOT_STRING: 'PARAM_NOT_STRING,',
+    PARAM_NOT_NUMBER: 'PARAM_NOT_NUMBER,',
+    PARAM_NOT_INT: 'PARAM_NOT_INT,',
+    PARAM_NOT_BOOLEAN: 'PARAM_NOT_BOOLEAN,',
+    PARAM_NOT_OBJECT: 'PARAM_NOT_OBJECT,',
+    PARAM_IS_ARRAY: 'PARAM_IS_ARRAY,',
+    PARAM_NOT_ARRAY: 'PARAM_NOT_ARRAY,',
+    PARAM_NOT_GREATER_THAN_ZERO: 'PARAM_NOT_GREATER_THAN_ZERO,',
+    PARAM_NOT_ZERO_OR_GREATER: 'PARAM_NOT_ZERO_OR_GREATER,',
+    PARAM_NOT_ZERO_OR_ONE: 'PARAM_NOT_ZERO_OR_ONE,',
+    PARAM_NOT_BETWEEN_ZERO_AND_ONE: 'PARAM_NOT_BETWEEN_ZERO_AND_ONE,',
+    PARAM_NOT_BETWEEN_ZERO_AND_THREE: 'PARAM_NOT_BETWEEN_ZERO_AND_THREE,',
+    PARAM_NOT_STRING_OR_NUMBER: 'PARAM_NOT_STRING_OR_NUMBER,',
+    PARAM_NOT_STRING_OR_EMPTY: 'PARAM_NOT_STRING_OR_EMPTY,',
+    PARAM_BAD_VALUE: 'PARAM_BAD_VALUE,',
+    INVALID_PARAM: 'INVALID_PARAM,',
+    PARAM_MISSING: 'PARAM_MISSING,',
+    PARAM_BAD_DATA_TYPE: 'PARAM_BAD_DATA_TYPE,',
+    PARAM_NOT_ALLOWED: 'PARAM_NOT_ALLOWED,',
+    PARAM_NOT_EXISTING: 'PARAM_NOT_EXISTING,',
+    PARAM_IS_EMPTY: 'PARAM_IS_EMPTY,',
+
+    BAD_SYNTAX: 'BAD_SYNTAX,',
+    STRING_IS_EMPTY: 'STRING_IS_EMPTY,',
+
+    VERBATIM_TYPE_NOT_3_CHARS: 'VERBATIM_TYPE_NOT_3_CHARS,',
+
+    FILENAME_NOT_PROVIDED: 'FILENAME_NOT_PROVIDED,',
+    FILENAME_NOT_STRING: 'FILENAME_NOT_STRING,',
+    PATH_NOT_PROVIDED: 'PATH_NOT_PROVIDED,',
+    PATH_NOT_STRING: 'PATH_NOT_STRING,',
+
+    BAD_SERVER_VERSION: 'BAD_SERVER_VERSION,',
+    ERROR_OCCURRED: 'ERROR_OCCURRED,',
+    NO_COMMAND_PROVIDED: 'NO_COMMAND_PROVIDED,`',
+
+
+    TIMEOUT_OCCURRED: 'TIMEOUT_OCCURRED,',
+    SOCKET_DISCONNECTED: 'SOCKET_DISCONNECTED,',
+
+    POOL_NO_MORE_SLOTS: 'POOL_NO_MORE_SLOTS,',
+    POOL_GUID_NOT_FOUND: 'POOL_GUID_NOT_FOUND,',
+    POOL_SESSION_IN_USE: 'POOL_SESSION_IN_USE,',
+    POOL_DEVOPS_SESSION_IN_USE: 'POOL_DEVOPS_SESSION_IN_USE,',
+    POOL_NOT_INITIALIZED: 'POOL_NOT_INITIALIZED,',
+    POOL_NEWSIZE_SAME_AS_SIZE: 'POOL_NEWSIZE_SAME_AS_SIZE,',
+    POOL_TOO_MANY_SESSIONS_IN_USE: 'POOL_TOO_MANY_SESSIONS_IN_USE,'
+}

package/js/extends/global.js

@@ -0,0 +1,134 @@
+/*###############################################################
+#                                                               #
+# 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 Glvn = require("./glvn")
+const utils = require("../utils");
+const errors = require('../errors.js')
+
+class Global extends Glvn {
+    spaceOnDisk = function () {
+
+    }
+
+    addLock = function (timeout = 0) {
+        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.NOT_LOGGED_IN + 'Not logged in'))
+
+                return
+            }
+
+            if (typeof timeout !== 'number') {
+                reject(new Error(errors.TIMEOUT_MUST_BE_NUMBER + 'timeout must be a number'))
+            }
+
+            if (timeout < 0) {
+                reject(new Error(errors.TIMEOUT_NOT_POSITIVE_NUMBER + 'timeout must be a positive number'))
+            }
+
+            if (that.objRoot.process._groupLocksFlag === true) {
+                that.objRoot.process._locks.push(utils.generateGlvn(that))
+
+                resolve()
+
+                return
+            }
+
+            // send command
+            const opCode = 'glvn.addLock'
+
+            that.writer("*3" + RESP3.CRLF +
+                RESP3.build.blob(opCode) +
+                RESP3.build.blob(utils.generateGlvn(that)) +
+                RESP3.build.blob(timeout)
+            );
+
+            that._path = ''
+
+            that.reader(data => {
+                if (data.charAt(0) === '-') {
+                    reject(new Error(RESP3.parse.simpleError(data)))
+
+                    return
+                }
+
+                resolve()
+            })
+        })
+    }
+
+    removeLock = 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.NOT_LOGGED_IN + 'Not logged in'))
+
+                return
+            }
+
+            if (that.objRoot.process._groupLocksFlag === true) {
+                const glvn = utils.generateGlvn(that)
+
+                const ix = that.objRoot.process._locks.findIndex(lGlvn => glvn === lGlvn)
+                if (ix > -1) that.objRoot.process._locks.splice(ix, 1)
+
+                resolve()
+
+                return
+            }
+
+            // send command
+            const opCode = 'glvn.removeLock'
+
+            that.writer("*2" + RESP3.CRLF +
+                RESP3.build.blob(opCode) +
+                RESP3.build.blob(utils.generateGlvn(that))
+            );
+
+            that._path = ''
+
+            that.reader(data => {
+                if (data.charAt(0) === '-') {
+                    reject(new Error(RESP3.parse.simpleError(data)))
+
+                    return
+                }
+
+                resolve()
+            })
+        })
+    }
+
+    _init = function (obj) {
+        Object.defineProperties(obj, {
+            _path: {
+                enumerable: false,
+                configurable: false,
+                writable: true
+            },
+        })
+
+        Object.defineProperties(obj, {
+            _init: {
+                enumerable: false,
+            }
+        })
+    }
+
+}
+
+module.exports = Global