javonet-ruby-sdk 2.5.15 → 2.5.17

data/lib/javonet-ruby-sdk/Binaries/Nodejs/dist/sdk/ConfigRuntimeFactory.cjs

@@ -0,0 +1,198 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var ConfigRuntimeFactory_exports = {};
+__export(ConfigRuntimeFactory_exports, {
+  ConfigRuntimeFactory: () => ConfigRuntimeFactory
+});
+module.exports = __toCommonJS(ConfigRuntimeFactory_exports);
+var import_WsConnectionData = require("../utils/connectionData/WsConnectionData.cjs");
+var import_TcpConnectionData = require("../utils/nodejs/connectionData/TcpConnectionData.cjs");
+var import_RuntimeName = require("../utils/RuntimeName.cjs");
+var import_RuntimeNameHandler = require("../utils/RuntimeNameHandler.cjs");
+var import_RuntimeContext = require("./RuntimeContext.cjs");
+var import_ConfigSourceResolver = require("./tools/browser/ConfigSourceResolver.cjs");
+var import_Runtime = require("../utils/Runtime.cjs");
+var import_JsonFileResolver = require("./tools/nodejs/JsonFileResolver.cjs");
+var import_InMemoryConnectionData = require("../utils/connectionData/InMemoryConnectionData.cjs");
+const import_meta = {};
+const requireDynamic = (0, import_Runtime.getRequire)(import_meta.url);
+class ConfigRuntimeFactory {
+  /** @type {import('../core/transmitter/Transmitter.js') | null} */
+  transmitter = null;
+  /**
+   * @param {object | string} configSource
+   * @param {import('../core/transmitter/Transmitter.js') | null} transmitter
+   */
+  constructor(configSource, transmitter = null) {
+    this.configSource = configSource;
+    this.transmitter = transmitter;
+    if ((0, import_Runtime.isNodejsRuntime)()) {
+      this.transmitter?.setConfigSource(configSource);
+    }
+  }
+  /**
+   * Creates RuntimeContext instance to interact with the .NET Framework runtime.
+   * @param {string} [configName="default"] - The name of the configuration to use (optional).
+   * @return {RuntimeContext} a RuntimeContext instance for the .NET Framework runtime
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/runtime-context)
+   */
+  clr(configName = "default") {
+    return this.#getRuntimeContext(import_RuntimeName.RuntimeName.Clr, configName);
+  }
+  /**
+   * Creates RuntimeContext instance to interact with the JVM runtime.
+   * @param {string} [configName="default"] - The name of the configuration to use (optional).
+   * @return {RuntimeContext} a RuntimeContext instance for the JVM runtime
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/runtime-context)
+   */
+  jvm(configName = "default") {
+    return this.#getRuntimeContext(import_RuntimeName.RuntimeName.Jvm, configName);
+  }
+  /**
+   * Creates RuntimeContext instance to interact with the .NET runtime.
+   * @param {string} [configName="default"] - The name of the configuration to use (optional).
+   * @return {RuntimeContext} a RuntimeContext instance for the .NET runtime
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/runtime-context)
+   */
+  netcore(configName = "default") {
+    return this.#getRuntimeContext(import_RuntimeName.RuntimeName.Netcore, configName);
+  }
+  /**
+   * Creates RuntimeContext instance to interact with the Perl runtime.
+   * @param {string} [configName="default"] - The name of the configuration to use (optional).
+   * @return {RuntimeContext} a RuntimeContext instance for the Perl runtime
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/runtime-context)
+   */
+  perl(configName = "default") {
+    return this.#getRuntimeContext(import_RuntimeName.RuntimeName.Perl, configName);
+  }
+  /**
+   * Creates RuntimeContext instance to interact with the Python runtime.
+   * @param {string} [configName="default"] - The name of the configuration to use (optional).
+   * @return {RuntimeContext} a RuntimeContext instance for the Python runtime
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/runtime-context)
+   */
+  python(configName = "default") {
+    return this.#getRuntimeContext(import_RuntimeName.RuntimeName.Python, configName);
+  }
+  /**
+   * Creates RuntimeContext instance to interact with the Ruby runtime.
+   * @param {string} [configName="default"] - The name of the configuration to use (optional).
+   * @return {RuntimeContext} a RuntimeContext instance for the Ruby runtime
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/runtime-context)
+   */
+  ruby(configName = "default") {
+    return this.#getRuntimeContext(import_RuntimeName.RuntimeName.Ruby, configName);
+  }
+  /**
+   * Creates RuntimeContext instance to interact with Node.js runtime.
+   * @param {string} [configName="default"] - The name of the configuration to use (optional).
+   * @return {RuntimeContext} a RuntimeContext instance for the Node.js runtime
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/runtime-context)
+   */
+  nodejs(configName = "default") {
+    return this.#getRuntimeContext(import_RuntimeName.RuntimeName.Nodejs, configName);
+  }
+  /**
+   * Creates RuntimeContext instance to interact with the Python 2.7 runtime.
+   * @param {string} [configName="default"] - The name of the configuration to use (optional).
+   * @return {RuntimeContext} a RuntimeContext instance for the Python 2.7 runtime
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/runtime-context)
+   */
+  python27(configName = "default") {
+    return this.#getRuntimeContext(import_RuntimeName.RuntimeName.Python27, configName);
+  }
+  /**
+   * @param {number} runtime
+   * @param {string} configName
+   * @returns
+   */
+  #getRuntimeContext(runtime, configName = "default") {
+    if ((0, import_Runtime.isBrowserRuntime)()) {
+      const jfr = new import_ConfigSourceResolver.ConfigSourceResolver(this.configSource);
+      const connType = jfr.getChannelType(import_RuntimeNameHandler.RuntimeNameHandler.getName(runtime), configName);
+      let connData = null;
+      if (connType === "webSocket") {
+        connData = new import_WsConnectionData.WsConnectionData(
+          jfr.getChannelHost(import_RuntimeNameHandler.RuntimeNameHandler.getName(runtime), configName)
+        );
+      } else {
+        throw new Error("Unsupported connection type: " + connType);
+      }
+      const rtmCtx = import_RuntimeContext.RuntimeContext.getInstance(runtime, connData);
+      this.#loadModules(runtime, configName, jfr, rtmCtx);
+      return rtmCtx;
+    }
+    if ((0, import_Runtime.isNodejsRuntime)()) {
+      let jfr = new import_JsonFileResolver.JsonFileResolver(this.configSource);
+      try {
+        const licenseKey = jfr.getLicenseKey();
+        this.transmitter?.activate(licenseKey);
+      } catch (error) {
+        throw error;
+      }
+      let rtmCtx = null;
+      let connData = null;
+      let connType = jfr.getChannelType(import_RuntimeNameHandler.RuntimeNameHandler.getName(runtime), configName);
+      if (connType === "inMemory") {
+        connData = new import_InMemoryConnectionData.InMemoryConnectionData();
+      } else if (connType === "tcp") {
+        connData = new import_TcpConnectionData.TcpConnectionData(
+          jfr.getChannelHost(import_RuntimeNameHandler.RuntimeNameHandler.getName(runtime), configName),
+          jfr.getChannelPort(import_RuntimeNameHandler.RuntimeNameHandler.getName(runtime), configName)
+        );
+      } else if (connType === "webSocket") {
+        connData = new import_WsConnectionData.WsConnectionData(
+          jfr.getChannelHost(import_RuntimeNameHandler.RuntimeNameHandler.getName(runtime), configName)
+        );
+      } else {
+        throw new Error("Unsupported connection type: " + connType);
+      }
+      rtmCtx = import_RuntimeContext.RuntimeContext.getInstance(runtime, connData);
+      this.#loadModules(runtime, configName, jfr, rtmCtx);
+      return rtmCtx;
+    }
+  }
+  // @ts-ignore
+  #loadModules(runtime, configName, jfr, rtmCtx) {
+    try {
+      const modules = jfr.getModules(import_RuntimeNameHandler.RuntimeNameHandler.getName(runtime), configName).split(",").filter((module2) => module2.trim() !== "");
+      if ((0, import_Runtime.isNodejsRuntime)()) {
+        if (typeof this.configSource !== "string") {
+          throw new Error("configSource is not a string");
+        }
+        const path = requireDynamic("path");
+        const configDirectoryAbsolutePath = path?.dirname(this.configSource);
+        modules.forEach((module2) => {
+          if (path?.isAbsolute(module2)) {
+            rtmCtx.loadLibrary(module2);
+          } else {
+            rtmCtx.loadLibrary(path?.join(configDirectoryAbsolutePath, module2));
+          }
+        });
+      }
+    } catch (error) {
+      throw error;
+    }
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ConfigRuntimeFactory
+});

data/lib/javonet-ruby-sdk/Binaries/Nodejs/dist/sdk/InvocationContext.cjs

@@ -0,0 +1,463 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var InvocationContext_exports = {};
+__export(InvocationContext_exports, {
+  InvocationContext: () => InvocationContext,
+  InvocationWsContext: () => InvocationWsContext
+});
+module.exports = __toCommonJS(InvocationContext_exports);
+var import_DelegatesCache = require("../core/delegatesCache/DelegatesCache.cjs");
+var import_Interpreter = require("../core/interpreter/Interpreter.cjs");
+var import_Command = require("../utils/Command.cjs");
+var import_CommandType = require("../utils/CommandType.cjs");
+var import_ConnectionType = require("../utils/ConnectionType.cjs");
+var import_ExceptionThrower = require("../utils/exception/ExceptionThrower.cjs");
+var import_RuntimeName = require("../utils/RuntimeName.cjs");
+class InvocationContext {
+  #runtimeName;
+  #connectionData;
+  #currentCommand;
+  #responseCommand;
+  #interpreter;
+  // eslint-disable-next-line no-unused-private-class-members
+  #isExecuted;
+  #resultValue;
+  constructor(runtimeName, connectionData, command, isExecuted = false) {
+    this.#runtimeName = runtimeName;
+    this.#connectionData = connectionData;
+    this.#currentCommand = command;
+    this.#responseCommand = null;
+    this.#isExecuted = isExecuted;
+    this.#interpreter = null;
+    this.#resultValue = null;
+  }
+  #createInstanceContext(localCommand) {
+    if (this.#connectionData.connectionType === import_ConnectionType.ConnectionType.WEB_SOCKET) {
+      return new InvocationWsContext(
+        this.#runtimeName,
+        this.#connectionData,
+        this.#buildCommand(localCommand)
+      );
+    }
+    return new InvocationContext(
+      this.#runtimeName,
+      this.#connectionData,
+      this.#buildCommand(localCommand)
+    );
+  }
+  get_current_command() {
+    return this.#currentCommand;
+  }
+  //destructor() {
+  //    if (this.#currentCommand.commandType === CommandType.Reference) {
+  //        this.#currentCommand = new Command(
+  //            this.#runtimeName,
+  //            CommandType.DestructReference,
+  //            this.#currentCommand.payload
+  //        );
+  //        this.execute();
+  //    }
+  //}
+  [Symbol.iterator] = function() {
+    if (this.#currentCommand.commandType !== import_CommandType.CommandType.Reference) {
+      throw new Error("Object is not iterable");
+    }
+    let position = -1;
+    let arraySize = this.getSize().execute().getValue();
+    return {
+      next: () => ({
+        value: this.getIndex(++position),
+        done: position >= arraySize
+      })
+    };
+  };
+  /**
+   * Executes the current command.
+   * Because invocation context is building the intent of executing particular expression on target environment, we call the initial state of invocation context as non-materialized.
+   * The non-materialized context wraps either single command or chain of recursively nested commands.
+   * Commands are becoming nested through each invocation of methods on Invocation Context.
+   * Each invocation triggers the creation of new Invocation Context instance wrapping the current command with new parent command valid for invoked method.
+   * Developer can decide on any moment of the materialization for the context taking full control of the chunks of the expression being transferred and processed on target runtime.
+   * @returns {InvocationContext} the InvocationContext after executing the command.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/execute-method)
+   * @method
+   */
+  execute() {
+    this.#interpreter = new import_Interpreter.Interpreter();
+    this.#responseCommand = this.#interpreter.execute(this.#currentCommand, this.#connectionData);
+    if (this.#responseCommand === void 0) {
+      throw new Error("responseCommand is undefined in Invocation Context execute method");
+    }
+    if (this.#responseCommand.commandType === import_CommandType.CommandType.Exception) {
+      throw import_ExceptionThrower.ExceptionThrower.throwException(this.#responseCommand);
+    }
+    if (this.#responseCommand.commandType === import_CommandType.CommandType.CreateClassInstance) {
+      this.#currentCommand = this.#responseCommand;
+      this.#isExecuted = true;
+      return this;
+    }
+    return new InvocationContext(this.#runtimeName, this.#connectionData, this.#responseCommand, true);
+  }
+  /**
+   * Invokes a static method on the target runtime.
+   * @param {string} methodName - The name of the method to invoke.
+   * @param {...any} args - Method arguments.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to invoke the static method.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/calling-methods/invoking-static-method)
+   * @method
+   */
+  invokeStaticMethod(methodName, ...args) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.InvokeStaticMethod, [
+      methodName,
+      ...args
+    ]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Retrieves the value of a static field from the target runtime.
+   * @param {string} fieldName - The name of the field to get.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to get the static field.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/fields-and-properties/getting-and-setting-values-for-static-fields-and-properties)
+   * @method
+   */
+  getStaticField(fieldName) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.GetStaticField, [fieldName]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Sets the value of a static field in the target runtime.
+   * @param {string} fieldName - The name of the field to set.
+   * @param {any} value - The new value of the field.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to set the static field.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/fields-and-properties/getting-and-setting-values-for-static-fields-and-properties)
+   * @method
+   */
+  setStaticField(fieldName, value) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.SetStaticField, [fieldName, value]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Creates a new instance of a class in the target runtime.
+   * @param {...any} args - The arguments to pass to the class constructor
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to create the instance.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/calling-methods/creating-instance-and-calling-instance-methods)
+   * @method
+   */
+  createInstance(...args) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.CreateClassInstance, args);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Retrieves the value of an instance field from the target runtime.
+   * @param {string} fieldName - The name of the field to get.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to get the instance field.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/fields-and-properties/getting-and-setting-values-for-instance-fields-and-properties)
+   * @method
+   */
+  getInstanceField(fieldName) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.GetInstanceField, [fieldName]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Sets the value of an instance field in the target runtime.
+   * @param {string} fieldName - The name of the field to set.
+   * @param {any} value - The new value of the field.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to set the instance field.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/fields-and-properties/getting-and-setting-values-for-instance-fields-and-properties)
+   * @method
+   */
+  setInstanceField(fieldName, value) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.SetInstanceField, [fieldName, value]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Invokes an instance method on the target runtime.
+   * @param {string} methodName - The name of the method to invoke.
+   * @param {...any} args - Method arguments.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to invoke the instance method.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/calling-methods/invoking-instance-method)
+   * @method
+   */
+  invokeInstanceMethod(methodName, ...args) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.InvokeInstanceMethod, [
+      methodName,
+      ...args
+    ]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Retrieves the value at a specific index in an array from the target runtime.
+   * @param {...any} indexes - the arguments to pass to the array getter. The first argument should be the index.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to get the index.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/arrays-and-collections/one-dimensional-arrays)
+   * @method
+   */
+  getIndex(...indexes) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.ArrayGetItem, indexes);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Sets the value at a specific index in an array in the target runtime.
+   * @param {number[]} indexes - The index to set the value at.
+   * @param {any} value - The value to set at the index.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to set the index.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/arrays-and-collections/one-dimensional-arrays)
+   * @method
+   */
+  setIndex(indexes, value) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.ArraySetItem, [indexes, value]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Retrieves the size of an array from the target runtime.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to get the size.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/arrays-and-collections/one-dimensional-arrays)
+   * @method
+   */
+  getSize() {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.ArrayGetSize, []);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Retrieves the rank of an array from the target runtime.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to get the rank.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/arrays-and-collections/one-dimensional-arrays)
+   * @method
+   */
+  getRank() {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.ArrayGetRank, []);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Invokes a generic static method on the target runtime.
+   * @param {string} methodName - The name of the method to invoke.
+   * @param {...any} args - Method arguments.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to invoke the generic static method.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/generics/calling-generic-static-method)
+   * @method
+   */
+  invokeGenericStaticMethod(methodName, ...args) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.InvokeGenericStaticMethod, [
+      methodName,
+      ...args
+    ]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Invokes a generic method on the target runtime.
+   * @param {string} methodName - The name of the method to invoke.
+   * @param {...any} args - Method arguments.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to invoke the generic method.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/generics/calling-generic-instance-method)
+   * @method
+   */
+  invokeGenericMethod(methodName, ...args) {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.InvokeGenericMethod, [
+      methodName,
+      ...args
+    ]);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Retrieves the name of an enum from the target runtime.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to get the enum name.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/enums/using-enum-type)
+   * @method
+   */
+  getEnumName() {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.GetEnumName, []);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Retrieves the value of an enum from the target runtime.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to get the enum value.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/enums/using-enum-type)
+   * @method
+   */
+  getEnumValue() {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.GetEnumValue, []);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Retrieves the value of a reference from the target runtime.
+   * @returns {InvocationContext} A new InvocationContext instance that wraps the command to get the ref value.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/methods-arguments/passing-arguments-by-reference-with-ref-keyword)
+   * @method
+   */
+  getRefValue() {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.GetRefValue, []);
+    return this.#createInstanceContext(localCommand);
+  }
+  /**
+   * Creates a null object of a specific type on the target runtime.
+   *
+   * @returns {InvocationContext} An InvocationContext instance with the command to create a null object.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/null-handling/create-null-object)
+   * @method
+   */
+  createNull() {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.CreateNull, []);
+    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 import_Command.Command(this.#runtimeName, import_CommandType.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 import_Command.Command(this.#runtimeName, import_CommandType.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.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/arrays-and-collections/retrieve-array)
+   * @method
+   */
+  retrieveArray() {
+    let localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.RetrieveArray, []);
+    let localInvCtx = new InvocationContext(
+      this.#runtimeName,
+      this.#connectionData,
+      this.#buildCommand(localCommand)
+    );
+    localInvCtx.execute();
+    return localInvCtx.#responseCommand.payload;
+  }
+  /**
+   * Returns the primitive value from the target runtime. This could be any primitive type in JavaScript,
+   * such as int, boolean, byte, char, long, double, float, etc.
+   * @returns {Command} The value of the current command.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/execute-method)
+   * @method
+   */
+  getValue() {
+    this.#resultValue = this.#currentCommand.payload[0];
+    return this.#resultValue;
+  }
+  #buildCommand = function(command) {
+    for (let i = 0; i < command.payload.length; i++) {
+      command.payload[i] = this.#encapsulatePayloadItem(command.payload[i]);
+    }
+    return command.prependArgToPayload(this.#currentCommand);
+  };
+  #encapsulatePayloadItem = function(payloadItem) {
+    if (payloadItem instanceof import_Command.Command) {
+      for (let i = 0; i < payloadItem.payload.length; i++) {
+        payloadItem.payload[i] = this.#encapsulatePayloadItem(payloadItem.payload[i]);
+      }
+      return payloadItem;
+    } else if (payloadItem instanceof InvocationContext) {
+      return payloadItem.get_current_command();
+    } else if (payloadItem instanceof Array) {
+      const copiedArray = payloadItem.map((item) => this.#encapsulatePayloadItem(item));
+      return new import_Command.Command(this.runtimeName, import_CommandType.CommandType.Array, copiedArray);
+    } 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 = [import_DelegatesCache.delegatesCacheInstance.addDelegate(payloadItem), import_RuntimeName.RuntimeName.Nodejs].push(
+        ...newArray
+      );
+      return new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.PassDelegate, args);
+    } else {
+      return new import_Command.Command(this.runtimeName, import_CommandType.CommandType.Value, [payloadItem]);
+    }
+  };
+}
+class InvocationWsContext extends InvocationContext {
+  #runtimeName;
+  #connectionData;
+  #currentCommand;
+  #responseCommand;
+  #interpreter;
+  // eslint-disable-next-line no-unused-private-class-members
+  #isExecuted;
+  // eslint-disable-next-line no-unused-private-class-members
+  #resultValue;
+  constructor(runtimeName, connectionData, command, isExecuted = false) {
+    super(runtimeName, connectionData, command, isExecuted);
+    this.#runtimeName = runtimeName;
+    this.#connectionData = connectionData;
+    this.#currentCommand = command;
+    this.#responseCommand = null;
+    this.#isExecuted = isExecuted;
+    this.#interpreter = null;
+    this.#resultValue = null;
+  }
+  /**
+   * Executes the current command.
+   * Because invocation context is building the intent of executing particular expression on target environment, we call the initial state of invocation context as non-materialized.
+   * The non-materialized context wraps either single command or chain of recursively nested commands.
+   * Commands are becoming nested through each invocation of methods on Invocation Context.
+   * Each invocation triggers the creation of new Invocation Context instance wrapping the current command with new parent command valid for invoked method.
+   * Developer can decide on any moment of the materialization for the context taking full control of the chunks of the expression being transferred and processed on target runtime.
+   * @returns {InvocationContext} the InvocationContext after executing the command.
+   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/execute-method)
+   * @method
+   */
+  async execute() {
+    this.#interpreter = new import_Interpreter.Interpreter();
+    this.#responseCommand = await this.#interpreter.executeAsync(
+      this.#currentCommand,
+      this.#connectionData
+    );
+    if (this.#responseCommand === void 0) {
+      throw new Error("responseCommand is undefined in Invocation Context execute method");
+    }
+    if (this.#responseCommand.commandType === import_CommandType.CommandType.Exception) {
+      throw import_ExceptionThrower.ExceptionThrower.throwException(this.#responseCommand);
+    }
+    if (this.#responseCommand.commandType === import_CommandType.CommandType.CreateClassInstance) {
+      this.#currentCommand = this.#responseCommand;
+      this.#isExecuted = true;
+      return this;
+    }
+    return new InvocationWsContext(this.#runtimeName, this.#connectionData, this.#responseCommand, true);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InvocationContext,
+  InvocationWsContext
+});