javonet-ruby-sdk 2.5.9 → 2.5.11

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/core/handler/GetStaticMethodAsDelegateHandler.js

@@ -0,0 +1,74 @@
+// eslint-disable-next-line no-unused-vars
+const { Command } = require('../../..')
+const AbstractHandler = require('./AbstractHandler')
+
+/**
+ * Handles retrieving a static method as a delegate.
+ */
+class GetStaticMethodAsDelegateHandler extends AbstractHandler {
+    /** @type {Array<*>} */
+    args = []
+
+    constructor() {
+        super()
+        /** @type {Function|null} */
+        this.method = null
+        /** @type {number} */
+        this.requiredParametersCount = 2
+    }
+
+    /**
+     * Processes a command to retrieve a static method as a delegate.
+     * @param {Command} command - The command containing payload data.
+     * @param {Array<*>} command.payload - The payload containing type, method name, and arguments.
+     * @returns {Function} The delegate for the static method.
+     * @throws {Error} If the parameters mismatch or the method cannot be found.
+     */
+    process(command) {
+        if (command.payload.length < this.requiredParametersCount) {
+            throw new Error(`${this.constructor.name} parameters mismatch`)
+        }
+
+        const type = command.payload[0]
+        const methodName = command.payload[1]
+        this.args = command.payload.length > 2 ? command.payload.slice(2) : []
+
+        // Find the method on the type
+        this.method = this.getMethod(type, methodName)
+        if (!this.method) {
+            throw this.createMethodNotFoundError(type, methodName)
+        }
+
+        // Create a delegate from the method
+        const methodDelegate = this.method.bind(this)
+        return methodDelegate
+    }
+
+    /**
+     * Retrieves the method from the type.
+     * @param {Object} type - The class or constructor to search for the method.
+     * @param {string} methodName - The name of the method.
+     * @param {Array<Function>} argsType - The argument types.
+     * @param {Object} modifier - Parameter modifier (not used in JS implementation).
+     * @returns {Function|null} The found method or null if not found.
+     */
+    getMethod(type, methodName) {
+        const method = type[methodName]
+        return typeof method === 'function' ? method : null
+    }
+
+    /**
+     * Creates an error message when the method is not found.
+     * @param {Object} type - The class or constructor.
+     * @param {string} methodName - The method name.
+     * @returns {Error} The error with detailed message.
+     */
+    createMethodNotFoundError(type, methodName) {
+        const methods = Object.keys(type).filter((key) => typeof type[key] === 'function')
+        const availableMethods = methods.map((name) => `${name}()`)
+        const message = `Method ${methodName} not found in class ${type.name}. Available public static methods:\n${availableMethods.join('\n')}`
+        return new Error(message)
+    }
+}
+
+module.exports = new GetStaticMethodAsDelegateHandler()

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/core/handler/Handler.js

@@ -23,6 +23,11 @@ const EnableTypeHandler = require('./EnableTypeHandler')
 const { CommandType, Command, ExceptionSerializer } = require('../../..')
 const ReferencesCache = require('../referenceCache/ReferencesCache')
 const InvokeStandaloneMethodHandler = require('./InvokeStandaloneMethodHandler')
+const GetStaticMethodAsDelegateHandler = require('./GetStaticMethodAsDelegateHandler')
+const GetInstanceMethodAsDelegateHandler = require('./GetInstanceMethodAsDelegateHandler')
+const PassDelegateHandler = require('./PassDelegateHandler')
+const InvokeDelegateHandler = require('./InvokeDelegateHandler')
+const { ConvertTypeHandler } = require('../../utils/TypesConverter')
 
 function isResponseSimpleType(response) {
     let type = typeof response
@@ -56,6 +61,11 @@ const handlers = {
     [CommandType.Array]: ArrayHandler,
     [CommandType.EnableNamespace]: EnableNamespaceHandler,
     [CommandType.EnableType]: EnableTypeHandler,
+    [CommandType.GetStaticMethodAsDelegate]: GetStaticMethodAsDelegateHandler,
+    [CommandType.GetInstanceMethodAsDelegate]: GetInstanceMethodAsDelegateHandler,
+    [CommandType.PassDelegate]: PassDelegateHandler,
+    [CommandType.InvokeDelegate]: InvokeDelegateHandler,
+    [CommandType.ConvertType]: ConvertTypeHandler,
 }
 
 Object.keys(handlers).forEach((commandTypeHandler) => {

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/core/handler/InvokeDelegateHandler.js

@@ -0,0 +1,36 @@
+const { DelegatesCache } = require('../../..')
+const AbstractHandler = require('./AbstractHandler')
+
+/**
+ * Handles invoking a delegate by GUID.
+ */
+class InvokeDelegateHandler extends AbstractHandler {
+    constructor() {
+        super()
+        /** @type {number} */
+        this.requiredParametersCount = 1
+    }
+
+    /**
+     * Processes a command to invoke a delegate.
+     * @param {Command} command - The command containing payload data.
+     * @returns {*} The result of the delegate invocation.
+     * @throws {Error} If the parameters mismatch or the delegate cannot be found.
+     */
+    process(command) {
+        const payload = command.payload
+        if (payload.length < this.requiredParametersCount) {
+            throw new Error(`${this.constructor.name} parameters mismatch`)
+        }
+
+        const guid = payload[0]
+        const delegate = DelegatesCache.getDelegate(guid)
+        if (!delegate) {
+            throw new Error('Delegate not found in cache')
+        }
+
+        return delegate
+    }
+}
+
+module.exports = new InvokeDelegateHandler()

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/core/handler/PassDelegateHandler.js

@@ -0,0 +1,157 @@
+// eslint-disable-next-line no-unused-vars
+const { Interpreter, Command, CommandType, InMemoryConnectionData, DelegatesCache } = require('../../..')
+const AbstractHandler = require('./AbstractHandler')
+
+/**
+ * PassDelegateHandler class responsible for processing a command to create a delegate.
+ */
+class PassDelegateHandler extends AbstractHandler {
+    constructor() {
+        super()
+        /**
+         * Minimum required parameters count for the command.
+         * @type {number}
+         */
+        this.requiredParametersCount = 1
+        this.interpreter = new Interpreter()
+    }
+
+    /**
+     * Processes the given command to create and compile a delegate.
+     * @param {Command} command - The command to process.
+     * @returns {Function} The compiled delegate function.
+     */
+    process(command) {
+        this.validateCommand(command)
+
+        const delegateGuid = command.payload[0]
+        const delegate = DelegatesCache.getDelegate(delegateGuid)
+
+        return delegate
+    }
+
+    /**
+     * Validates the command to ensure it has enough parameters.
+     * @param {Command} command - The command to validate.
+     */
+    validateCommand(command) {
+        if (command.payload.length < this.requiredParametersCount) {
+            throw new Error('PassDelegateHandler parameters mismatch')
+        }
+    }
+
+    /**
+     * Retrieves the arguments from the command payload.
+     * @param {Command} command - The command containing the payload.
+     * @returns {Array} The extracted arguments.
+     */
+    getArguments(command) {
+        return command.payload.length > 2 ? command.payload.slice(2) : []
+    }
+
+    /**
+     * Extracts argument types from the arguments array.
+     * @param {Array} args - The arguments array.
+     * @returns {Array} The argument types.
+     */
+    getArgumentTypes(args) {
+        return args.slice(0, -1).map((arg) => arg.constructor)
+    }
+
+    /**
+     * Retrieves the return type from the arguments array.
+     * @param {Array} args - The arguments array.
+     * @returns {Function} The return type.
+     */
+    getReturnType(args) {
+        return args[args.length - 1].constructor
+    }
+
+    /**
+     * Creates parameter expressions from argument types.
+     * @param {Array} argsTypes - The argument types.
+     * @returns {Array} The parameter expressions.
+     */
+    createParameters(argsTypes) {
+        return argsTypes.map((type, index) => ({ name: `arg${index}`, type }))
+    }
+
+    /**
+     * Creates an array of arguments for the delegate.
+     * @param {string} delegateGuid - The delegate identifier.
+     * @param {Array} parameters - The parameter expressions.
+     * @returns {Array} The arguments array.
+     */
+    createArgsArray(delegateGuid, parameters) {
+        return [delegateGuid, ...parameters.map((param) => param.name)]
+    }
+
+    /**
+     * Creates a command expression.
+     * @param {string} callingRuntimeName - The runtime name.
+     * @param {Array} payload - The arguments array.
+     * @returns {Object} The command object.
+     */
+    createCommand(callingRuntimeName, payload) {
+        return {
+            runtimeName: callingRuntimeName,
+            type: CommandType.InvokeDelegate,
+            payload,
+        }
+    }
+
+    /**
+     * Creates a method call to execute the command.
+     * @param {Command} command - The command object.
+     * @returns {Object} The response object.
+     */
+    createExecuteCall(command) {
+        return this.interpreter.execute(command, new InMemoryConnectionData())
+    }
+
+    /**
+     * Retrieves the response payload from the execution call.
+     * @param {Object} executeCall - The execution call.
+     * @returns {Array} The response payload.
+     */
+    getResponse(executeCall) {
+        return executeCall.payload
+    }
+
+    /**
+     * Converts the first element of the response to the return type.
+     * @param {Array} response - The response payload.
+     * @param {Function} returnType - The return type.
+     * @returns {*} The converted first element.
+     */
+    convertFirstElement(response, returnType) {
+        return returnType(response[0])
+    }
+
+    /**
+     * Creates a block of expressions for the delegate.
+     * @param {Function} returnType - The return type.
+     * @param {*} convertedFirstElement - The converted first element.
+     * @returns {Object} The block expression.
+     */
+    createBlock(returnType, convertedFirstElement) {
+        return { returnType, body: convertedFirstElement }
+    }
+
+    /**
+     * Creates a delegate type.
+     * @param {Array} parameters - The parameter expressions.
+     * @param {Function} returnType - The return type.
+     * @returns {Function} The delegate type.
+     */
+    createDelegateType(parameters, returnType) {
+        return (...args) => {
+            if (args.length !== parameters.length) {
+                throw new Error('Invalid argument count.')
+            }
+            return returnType
+        }
+    }
+}
+
+module.exports = new PassDelegateHandler()

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/core/transmitter/Transmitter.js

@@ -1,10 +1,6 @@
 const wrapper = require('./TransmitterWrapper')
 
 class Transmitter {
-    static initialize() {
-        return wrapper.initialize()
-    }
-
     static sendCommand(messageArray) {
         return wrapper.sendCommand(messageArray)
     }
@@ -16,6 +12,10 @@ class Transmitter {
     static setConfigSource(configSource) {
         return wrapper.setConfigSource(configSource)
     }
+
+    static setJavonetWorkingDirectory(workingDirectory) {
+        return wrapper.setJavonetWorkingDirectory(workingDirectory)
+    }
 }
 
 module.exports = Transmitter

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/core/transmitter/TransmitterWrapper.js

@@ -1,34 +1,47 @@
 let library
 
 class TransmitterWrapper {
-    static initialize() {
-        if (process.platform === 'win32')
-            library = require(
-                `${require('path').resolve(__dirname, '../../../../')}/build/Release/JavonetNodejsRuntimeAddon.node`
-            )
-        else if (process.platform === 'darwin')
-            library = require(
-                `${require('path').resolve(__dirname, '../../../../')}/build/Release/JavonetNodejsRuntimeAddon.node`
-            )
-        else
-            library = require(
-                `${require('path').resolve(__dirname, '../../../../')}/build/Release/JavonetNodejsRuntimeAddon.node`
-            )
+
+    static isNativeLibraryLoaded() {
+        return library !== undefined
+    }
+
+    static loadNativeLibrary() {
+        if (this.isNativeLibraryLoaded()) {
+            return
+        }
+
         let binariesRootPath = String(`${require('path').resolve(__dirname, '../../../../')}`)
-        return library.initializeTransmitter(binariesRootPath)
+
+        const nativeAddonPath = `${binariesRootPath}/build/Release/JavonetNodejsRuntimeAddon.node`
+
+        library = require(nativeAddonPath)
+
+        library.initializeTransmitter(binariesRootPath)
+        // eslint-disable-next-line no-unused-vars
+        const ReceiverNative = require('../receiver/ReceiverNative')
+        library.setReceiverNative(global.ReceiverNative)
     }
 
     static activate(licenseKey) {
+        this.loadNativeLibrary()
         return library.activate(licenseKey)
     }
 
     static sendCommand(messageArray) {
+        this.loadNativeLibrary()
         return library.sendCommand(messageArray)
     }
 
     static setConfigSource(configSource) {
+        this.loadNativeLibrary()
         return library.setConfigSource(configSource)
     }
+
+    static setJavonetWorkingDirectory(path) {
+        this.loadNativeLibrary()
+        library.setWorkingDirectory(path)
+    }
 }
 
 module.exports = TransmitterWrapper

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/sdk/ConfigRuntimeFactory.js

@@ -127,7 +127,7 @@ class ConfigRuntimeFactory {
     #loadModules(runtime, configName, jfr, rtmCtx) {
         const modules = jfr
             .getModules(RuntimeNameHandler.getName(runtime), configName)
-            .split(';')
+            .split(',')
             .filter((module) => module.trim() !== '')
 
         const configDirectoryAbsolutePath = require('path').dirname(this.path)

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/sdk/InvocationContext.js

@@ -1,8 +1,10 @@
+const DelegatesCache = require('../core/delegatesCache/DelegatesCache')
 const Interpreter = require('../core/interpreter/Interpreter')
 const Command = require('../utils/Command')
 const CommandType = require('../utils/CommandType')
 const ConnectionType = require('../utils/ConnectionType')
 const ExceptionThrower = require('../utils/exception/ExceptionThrower')
+const RuntimeName = require('../utils/RuntimeName')
 
 /**
  * InvocationContext is a class that represents a context for invoking commands.
@@ -338,6 +340,40 @@ class InvocationContext {
         return this.#createInstanceContext(localCommand)
     }
 
+    /**
+     * Creates a null object of a specific type on the target runtime.
+     * @param {string} methodName - The name of the method to invoke.
+     * @param {...any} args - Method arguments.
+     * @returns {InvocationContext} An InvocationContext instance with the command to create a null object.
+     * TODO: connect documentation page url
+     * @see [Javonet Guides](https://www.javonet.com/guides/)
+     * @method
+     */
+    getStaticMethodAsDelegate(methodName, ...args) {
+        const localCommand = new Command(this.#runtimeName, CommandType.GetStaticMethodAsDelegate, [
+            methodName,
+            ...args,
+        ])
+        return this.#createInstanceContext(localCommand)
+    }
+
+    /**
+     * Creates a null object of a specific type on the target runtime.
+     * @param {string} methodName - The name of the method to invoke.
+     * @param {...any} args - Method arguments.
+     * @returns {InvocationContext} An InvocationContext instance with the command to create a null object.
+     * TODO: connect documentation page url
+     * @see [Javonet Guides](https://www.javonet.com/guides/)
+     * @method
+     */
+    getInstanceMethodAsDelegate(methodName, ...args) {
+        const localCommand = new Command(this.#runtimeName, CommandType.GetInstanceMethodAsDelegate, [
+            methodName,
+            ...args,
+        ])
+        return this.#createInstanceContext(localCommand)
+    }
+
     /**
      * Retrieves an array from the target runtime.
      * @returns {InvocationContext} A new InvocationContext instance that wraps the command to retrieve the array.
@@ -390,6 +426,13 @@ class InvocationContext {
                 payloadItem[i] = this.#encapsulatePayloadItem(payloadItem[i])
             }
             return new Command(this.runtimeName, CommandType.Array, payloadItem)
+        } else if (typeof payloadItem === 'function') {
+            let newArray = new Array(payloadItem.length + 1)
+            for (let i = 0; i < newArray.length; i++) {
+                newArray[i] = typeof Object
+            }
+            const args = [DelegatesCache.addDelegate(payloadItem), RuntimeName.Nodejs].push(...newArray);
+            return new Command(this.#runtimeName, CommandType.PassDelegate, args)
         } else {
             return new Command(this.runtimeName, CommandType.Value, [payloadItem])
         }

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/sdk/Javonet.js

@@ -4,6 +4,7 @@ const Transmitter = require('../core/transmitter/Transmitter')
 const ConfigRuntimeFactory = require('./ConfigRuntimeFactory')
 const RuntimeLogger = require('../utils/RuntimeLogger')
 const TcpConnectionData = require('../utils/connectionData/TcpConnectionData')
+const { mkdirSync } = require('node:fs')
 
 /**
  * The Javonet class is a singleton class that serves as the entry point for interacting with Javonet.
@@ -14,7 +15,6 @@ const TcpConnectionData = require('../utils/connectionData/TcpConnectionData')
 class Javonet {
     // Static block to initialize the Transmitter
     static {
-        Transmitter.initialize()
         //SDKExceptionHelper.sendExceptionToAppInsights("SdkMessage", "Javonet SDK initialized");
     }
 
@@ -80,6 +80,22 @@ class Javonet {
     static setConfigSource(configSource) {
         Transmitter.setConfigSource(configSource)
     }
+
+    /**
+     * Sets the working directory for the Javonet SDK.
+     *
+     * @param {string} path - The working directory.
+     */
+    static setJavonetWorkingDirectory(path) {
+        path = path.replace(/\\/g, "/");
+        if (!path.endsWith("/")) {
+            path += "/";
+        }
+
+        mkdirSync(path, { recursive: true, mode: 0o700 });
+        Transmitter.setJavonetWorkingDirectory(path)
+    }
+
 }
 
 module.exports = {

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/sdk/RuntimeContext.js

@@ -5,6 +5,8 @@ const CommandType = require('../utils/CommandType')
 const { InvocationContext, InvocationWsContext } = require('./InvocationContext')
 const ConnectionType = require('../utils/ConnectionType')
 const ExceptionThrower = require('../utils/exception/ExceptionThrower')
+const DelegatesCache = require('../core/delegatesCache/DelegatesCache')
+const RuntimeName = require('../utils/RuntimeName')
 
 /**
  * Represents a single context which allows interaction with a selected technology.
@@ -251,6 +253,13 @@ class RuntimeContext {
                 payloadItem[i] = this.#encapsulatePayloadItem(payloadItem[i])
             }
             return new Command(this.runtimeName, CommandType.Array, payloadItem)
+        } else if (typeof payloadItem === 'function') {
+            let newArray = new Array(payloadItem.length + 1)
+            for (let i = 0; i < newArray.length; i++) {
+                newArray[i] = 'object'
+            }
+            const args = [DelegatesCache.addDelegate(payloadItem), RuntimeName.Nodejs].push(...newArray);
+            return new Command(this.runtimeName, CommandType.PassDelegate, args)
         } else {
             return new Command(this.runtimeName, CommandType.Value, [payloadItem])
         }

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/utils/CommandType.js

@@ -37,7 +37,12 @@ const CommandType = /** @type {const} */ ({
     EnableNamespace: 34,
     EnableType: 35,
     CreateNull: 36,
-    InvokeStandaloneMethod: 37,
+    GetStaticMethodAsDelegate: 37,
+    GetInstanceMethodAsDelegate: 38,
+    PassDelegate: 39,
+    InvokeDelegate: 40,
+    ConvertType: 41,
+    InvokeStandaloneMethod: 42,
 })
 
 module.exports = CommandType

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/utils/TypesConverter.js

@@ -0,0 +1,91 @@
+/**
+ * ConvertTypeHandler class handles the conversion of JType to Type.
+ */
+class ConvertTypeHandler {
+    constructor() {
+        /**
+         * Minimum required parameters count for the command.
+         * @type {number}
+         */
+        this.requiredParametersCount = 1
+    }
+
+    /**
+     * Processes the given command to convert JType to Type.
+     * @param {Object} command - The command to process.
+     * @returns {any} The converted type.
+     */
+    process(command) {
+        this.validateCommand(command)
+        return TypesConverter.convertJTypeToType(command.payload[0])
+    }
+
+    /**
+     * Validates the command to ensure it has enough parameters.
+     * @param {Object} command - The command to validate.
+     */
+    validateCommand(command) {
+        if (command.payload.length < this.requiredParametersCount) {
+            throw new Error('ConvertTypeHandler parameters mismatch')
+        }
+    }
+}
+
+/**
+ * TypesConverter class provides utilities for converting between types.
+ */
+class TypesConverter {
+    /**
+     * Converts a JavaScript type to a JType equivalent.
+     * @param {Function} type - The JavaScript type.
+     * @returns {number} The corresponding JType.
+     */
+    static convertTypeToJType(type) {
+        switch (type) {
+            case Boolean:
+                return JType.Boolean
+            case Number:
+                return JType.Float // Assuming Number maps to Float
+            case String:
+                return JType.String
+            case Object:
+                return JType.Null // Assuming Object maps to Null
+            default:
+                return JType.Null
+        }
+    }
+
+    /**
+     * Converts a JType to a JavaScript type equivalent.
+     * @param {number} type - The JType to convert.
+     * @returns {Function} The corresponding JavaScript type.
+     */
+    static convertJTypeToType(type) {
+        switch (type) {
+            case JType.Boolean:
+                return Boolean
+            case JType.Float:
+                return Number
+            case JType.String:
+                return String
+            case JType.Null:
+                return null
+            default:
+                return null
+        }
+    }
+}
+
+/**
+ * Enum for JType mappings.
+ * @readonly
+ * @enum {number}
+ */
+const JType = {
+    Boolean: 1,
+    Float: 2,
+    String: 3,
+    Null: 4,
+}
+
+module.exports = { ConvertTypeHandler, TypesConverter, JType }

data/lib/javonet-ruby-sdk/Binaries/Nodejs/lib/utils/guid/generateGuid.js

@@ -0,0 +1,9 @@
+function generateGUID() {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0
+        const v = c === 'x' ? r : (r & 0x3) | 0x8
+        return v.toString(16)
+    })
+}
+
+module.exports = generateGUID