javonet-ruby-sdk 2.6.8 → 2.6.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 64594a08282eb8db907b43ea836c9ebf444e2fe9c9aaaf436294952c0977de40
-  data.tar.gz: d9bbd4889a2363b1a87d132884d10c51838ecf4387e661f4e87751fd3e0bcc96
+  metadata.gz: bd483c1827f1c74cb5fc63d48819267cf05fa9dad0be8776a602be8da4461048
+  data.tar.gz: 2fe10b5e45c087b9642d47d9ec7dd8cb422113a2a7c9b2a6f5ee5fa608849d4d
 SHA512:
-  metadata.gz: c4ca5e21b95637ee70e302546bb72b9981cf56f2f622640fa714e1706d05c97c7c7552474cdc927beeb5d9709d6b462b36d7ffb601222467be93c988050114a7
-  data.tar.gz: 0b840b8e096f32d1a11c86ad7afd9dc0ce23f0fc3eb3161deb3eb1efb2f431f360756d032d6ae10d435f6d950b503ac8843e6cb3c43eb39cadd438c31945c959
+  metadata.gz: 2adb3e843603f22ddb1656865fe6a9038856c40fe128a9db8590f4368afba23d4552b9bed5dcc8b5508f3567f683367c454a195327ba446bfa346ec9b0d43cae
+  data.tar.gz: 1f2166306bc0ba00930878fffe6434dcbe6819995268e12599911f48d5e54b20a9b499d82d84c635f6762c14915c8c6298d1ab209e6b6557006bbfebf01dea3c

data/VERSION

@@ -1 +1 @@
-2.6.8
+2.6.10

data/lib/javonet-ruby-sdk/Binaries/Native/Linux/ARM64/version.txt

@@ -1 +1 @@
-2.6.8
+2.6.10

data/lib/javonet-ruby-sdk/Binaries/Native/Linux/X64/version.txt

@@ -1 +1 @@
-2.6.8
+2.6.10

data/lib/javonet-ruby-sdk/Binaries/Native/MacOs/ARM64/version.txt

@@ -1 +1 @@
-2.6.8
+2.6.10

data/lib/javonet-ruby-sdk/Binaries/Native/MacOs/X64/version.txt

@@ -1 +1 @@
-2.6.8
+2.6.10

data/lib/javonet-ruby-sdk/Binaries/Native/Windows/X64/version.txt

@@ -1 +1 @@
-'2.6.8' 
+'2.6.10' 

data/lib/javonet-ruby-sdk/Binaries/Native/Windows/X86/version.txt

@@ -1 +1 @@
-'2.6.8' 
+'2.6.10' 

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

@@ -22,6 +22,11 @@ __export(Handler_exports, {
   handlers: () => handlers
 });
 module.exports = __toCommonJS(Handler_exports);
+var import_CommandType = require("../../utils/CommandType.cjs");
+var import_Command = require("../../utils/Command.cjs");
+var import_TypesHandler = require("../../utils/TypesHandler.cjs");
+var import_ExceptionSerializer = require("../../utils/exception/ExceptionSerializer.cjs");
+var import_AbstractHandler = require("./AbstractHandler.cjs");
 var import_ReferencesCache = require("../referenceCache/ReferencesCache.cjs");
 var import_ValueHandler = require("./ValueHandler.cjs");
 var import_LoadLibraryHandler = require("./LoadLibraryHandler.cjs");
@@ -71,11 +76,8 @@ var import_GetAsyncOperationResultHandler = require("./GetAsyncOperationResultHa
 var import_AsKwargsHandler = require("./AsKwargsHandler.cjs");
 var import_GetResultTypeHandler = require("./GetResultTypeHandler.cjs");
 var import_GetGlobalFieldHandler = require("./GetGlobalFieldHandler.cjs");
-var import_CommandType = require("../../utils/CommandType.cjs");
-var import_Command = require("../../utils/Command.cjs");
-var import_TypesHandler = require("../../utils/TypesHandler.cjs");
-var import_ExceptionSerializer = require("../../utils/exception/ExceptionSerializer.cjs");
-var import_AbstractHandler = require("./AbstractHandler.cjs");
+var import_RegisterForUpdateHandler = require("./RegisterForUpdateHandler.cjs");
+var import_ValueForUpdateHandler = require("./ValueForUpdateHandler.cjs");
 const handlers = {
   [import_CommandType.CommandType.Value]: new import_ValueHandler.ValueHandler(),
   [import_CommandType.CommandType.LoadLibrary]: new import_LoadLibraryHandler.LoadLibraryHandler(),
@@ -124,7 +126,9 @@ const handlers = {
   [import_CommandType.CommandType.GetAsyncOperationResult]: new import_GetAsyncOperationResultHandler.GetAsyncOperationResultHandler(),
   [import_CommandType.CommandType.AsKwargs]: new import_AsKwargsHandler.AsKwargsHandler(),
   [import_CommandType.CommandType.GetResultType]: new import_GetResultTypeHandler.GetResultTypeHandler(),
-  [import_CommandType.CommandType.GetGlobalField]: new import_GetGlobalFieldHandler.GetGlobalFieldHandler()
+  [import_CommandType.CommandType.GetGlobalField]: new import_GetGlobalFieldHandler.GetGlobalFieldHandler(),
+  [import_CommandType.CommandType.RegisterForUpdate]: new import_RegisterForUpdateHandler.RegisterForUpdateHandler(),
+  [import_CommandType.CommandType.ValueForUpdate]: new import_ValueForUpdateHandler.ValueForUpdateHandler()
 };
 class Handler {
   /**
@@ -153,9 +157,19 @@ class Handler {
       const response = handlers[command.commandType].handleCommand(command);
       return this.parseCommand(response, command.runtimeName);
     } catch (e) {
-      return import_ExceptionSerializer.ExceptionSerializer.serializeException(e, command);
+      return Handler.resolveException(e, command);
     }
   }
+  /**
+   * Prefer innerException (or cause) when available.
+   * @param {any} error
+   * @param {Command} command
+   * @returns {Command}
+   */
+  static resolveException(error, command) {
+    const inner = error?.cause;
+    return import_ExceptionSerializer.ExceptionSerializer.serializeException(inner ?? error, command);
+  }
   /**
    * @param {any} response
    * @param {RuntimeName} runtimeName
@@ -167,13 +181,37 @@ class Handler {
         return this.parseCommand(resolvedResponse, runtimeName);
       });
     }
+    let responseCommand;
     if (import_TypesHandler.TypesHandler.isPrimitiveOrNullOrUndefined(response)) {
-      return import_Command.Command.createResponse(response, runtimeName);
+      responseCommand = import_Command.Command.createResponse(response, runtimeName);
     } else {
-      let cache = import_ReferencesCache.ReferencesCache.getInstance();
-      let uuid = cache.cacheReference(response);
-      return import_Command.Command.createReference(uuid, runtimeName);
+      const refCache = import_ReferencesCache.ReferencesCache.getInstance();
+      const uuid = refCache.cacheReference(response);
+      responseCommand = import_Command.Command.createReference(uuid, runtimeName);
+    }
+    const invocationContexts = import_RegisterForUpdateHandler.RegisterForUpdateHandler._invocationContexts.Value;
+    if (invocationContexts && invocationContexts.size > 0) {
+      const refCache = import_ReferencesCache.ReferencesCache.getInstance();
+      for (const [contextKey, instance] of invocationContexts.entries()) {
+        const instanceGuid = refCache.cacheReference(instance);
+        const updateContextCommand = new import_Command.Command(
+          runtimeName,
+          import_CommandType.CommandType.ValueForUpdate,
+          [
+            contextKey.toString(),
+            instanceGuid
+          ]
+        );
+        if (typeof responseCommand.addArgToPayload === "function") {
+          responseCommand = responseCommand.addArgToPayload(updateContextCommand);
+        } else {
+          responseCommand.payload = responseCommand.payload || [];
+          responseCommand.payload.push(updateContextCommand);
+        }
+      }
+      invocationContexts.clear();
     }
+    return responseCommand;
   }
 }
 // Annotate the CommonJS export names for ESM import in node:

data/lib/javonet-ruby-sdk/Binaries/Nodejs/dist/core/handler/InvokeInstanceMethodHandler.cjs

@@ -44,7 +44,7 @@ class InvokeInstanceMethodHandler extends import_AbstractHandler.AbstractHandler
         let methods = Object.getOwnPropertyNames(instance.__proto__).filter(function(property) {
           return typeof instance.__proto__[property] === "function";
         });
-        let message = `Method ${methodName} not found in object. Available methods:
+        let message = `Method ${methodName} not found in object ${instance.constructor.name}. Available methods:
 `;
         methods.forEach((methodIter) => {
           message += `${methodIter}

data/lib/javonet-ruby-sdk/Binaries/Nodejs/dist/core/handler/InvokeStaticMethodHandler.cjs

@@ -44,7 +44,7 @@ class InvokeStaticMethodHandler extends import_AbstractHandler.AbstractHandler {
         let methods = Object.getOwnPropertyNames(type).filter(function(property) {
           return typeof type[property] === "function";
         });
-        let message = `Method ${methodName} not found in class. Available methods:
+        let message = `Method ${methodName} not found in class ${type.name}. Available methods:
 `;
         methods.forEach((methodIter) => {
           message += `${methodIter}

data/lib/javonet-ruby-sdk/Binaries/Nodejs/dist/core/handler/RegisterForUpdateHandler.cjs

@@ -0,0 +1,60 @@
+"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 RegisterForUpdateHandler_exports = {};
+__export(RegisterForUpdateHandler_exports, {
+  RegisterForUpdateHandler: () => RegisterForUpdateHandler
+});
+module.exports = __toCommonJS(RegisterForUpdateHandler_exports);
+var import_AbstractHandler = require("./AbstractHandler.cjs");
+class RegisterForUpdateHandler extends import_AbstractHandler.AbstractHandler {
+  requiredParametersCount = 2;
+  /* type {Map<string, any>} */
+  static _invocationContexts = { Value: /* @__PURE__ */ new Map() };
+  /**
+   * Ensure context map exists and return it.
+   * @returns {Map<string, any>}
+   */
+  static getOrCreateContextMap() {
+    const container = RegisterForUpdateHandler._invocationContexts;
+    if (!container.Value) {
+      container.Value = /* @__PURE__ */ new Map();
+    }
+    return container.Value;
+  }
+  /**
+   * @param {any} command
+   * @returns {any}
+   */
+  process(command) {
+    if (command.payload.length < this.requiredParametersCount) {
+      throw new Error("RegisterForUpdateHandler parameters mismatch");
+    }
+    const objectToRegister = command.payload[0];
+    const guidToRegister = command.payload.length > 1 && typeof command.payload[1] === "string" ? command.payload[1] : "";
+    const contextMap = RegisterForUpdateHandler.getOrCreateContextMap();
+    if (!contextMap.has(guidToRegister)) {
+      contextMap.set(guidToRegister, objectToRegister);
+    }
+    return objectToRegister;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RegisterForUpdateHandler
+});

data/lib/javonet-ruby-sdk/Binaries/Nodejs/dist/core/handler/ValueForUpdateHandler.cjs

@@ -0,0 +1,36 @@
+"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 ValueForUpdateHandler_exports = {};
+__export(ValueForUpdateHandler_exports, {
+  ValueForUpdateHandler: () => ValueForUpdateHandler
+});
+module.exports = __toCommonJS(ValueForUpdateHandler_exports);
+var import_AbstractHandler = require("./AbstractHandler.cjs");
+class ValueForUpdateHandler extends import_AbstractHandler.AbstractHandler {
+  /**
+   * @param {any} command
+   */
+  process(command) {
+    throw new Error(`${this.constructor.name} is not implemented in Node.js`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ValueForUpdateHandler
+});

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

@@ -25,10 +25,22 @@ 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");
 var import_TypesHandler = require("../utils/TypesHandler.cjs");
+var import_uuid = require("uuid");
+class AsyncLock {
+  constructor() {
+    this._tail = Promise.resolve();
+  }
+  async lock() {
+    let release;
+    const prev = this._tail;
+    this._tail = new Promise((res) => release = res);
+    await prev;
+    return () => release(void 0);
+  }
+}
 class InvocationContext {
   /** @type {RuntimeNameType} */
   #runtimeName;
@@ -42,6 +54,12 @@ class InvocationContext {
   #isExecuted = false;
   /** @type {Interpreter | null} */
   #interpreter = null;
+  /** @type {string | null} */
+  #guid = null;
+  /** @type {AsyncLock} */
+  #materializationLock = new AsyncLock();
+  // Static map holding contexts waiting for materialization (guid -> InvocationContext)
+  static _invocationContexts = /* @__PURE__ */ new Map();
   /**
    *
    * @param {RuntimeNameType} runtimeName
@@ -56,6 +74,13 @@ class InvocationContext {
     this.#responseCommand = null;
     this.#isExecuted = isExecuted;
     this.#interpreter = null;
+    this.#guid = (0, import_uuid.v4)();
+  }
+  /**
+   * @returns {string} guid of this InvocationContext
+   */
+  getGuid() {
+    return this.#guid;
   }
   /**
    * @param {Command} localCommand
@@ -71,7 +96,7 @@ class InvocationContext {
   /**
    * @returns {Command|null}
    */
-  get_current_command() {
+  getCurrentCommand() {
     return this.#currentCommand;
   }
   //destructor() {
@@ -101,13 +126,8 @@ class InvocationContext {
   }
   /**
    * 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 {Promise<InvocationContext>} the InvocationContext after executing the command.
-   * @see [Javonet Guides](https://www.javonet.com/guides/v2/javascript/foundations/execute-method)
+   * Returns the InvocationContext after executing the command.
+   * @returns {Promise<InvocationContext>}
    * @method
    */
   async execute() {
@@ -117,19 +137,73 @@ class InvocationContext {
     if (!this.#interpreter) {
       this.#interpreter = new import_Interpreter.Interpreter();
     }
-    this.#responseCommand = await this.#interpreter.execute(this.#currentCommand, this.#connectionData);
-    if (!this.#responseCommand) {
-      throw new Error("responseCommand is undefined in Invocation Context execute method");
+    const entries = Array.from(InvocationContext._invocationContexts.entries());
+    entries.sort((a, b) => String(a[0]).localeCompare(String(b[0])));
+    const releases = [];
+    for (const [, ic] of entries) {
+      const release = await ic.#materializationLock.lock();
+      releases.push(release);
     }
-    if (this.#responseCommand.commandType === import_CommandType.CommandType.Exception) {
-      throw import_ExceptionThrower.ExceptionThrower.throwException(this.#responseCommand);
+    try {
+      this.#responseCommand = await this.#interpreter.execute(this.#currentCommand, this.#connectionData);
+      if (!this.#responseCommand) {
+        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);
+      }
+      this.#responseCommand = this.#processUpdateInvocationContextCommands(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);
+    } finally {
+      for (let i = releases.length - 1; i >= 0; i--) {
+        try {
+          releases[i]();
+        } catch {
+        }
+      }
     }
-    if (this.#responseCommand.commandType === import_CommandType.CommandType.CreateClassInstance) {
-      this.#currentCommand = this.#responseCommand;
-      this.#isExecuted = true;
-      return this;
+  }
+  /**
+   * Process UpdateInvocationContext commands in the provided responseCommand payload.
+   * For each ValueForUpdate command, set the referenced InvocationContext's currentCommand to a Reference command,
+   * remove that InvocationContext from the static map and remove ValueForUpdate items from response payload.
+   * @param {Command} responseCommand
+   * @returns {Command}
+   */
+  #processUpdateInvocationContextCommands(responseCommand) {
+    if (!responseCommand?.payload || responseCommand.payload.length === 0) {
+      return responseCommand;
+    }
+    const commandsToUpdate = [];
+    for (const item of responseCommand.payload) {
+      if (item instanceof import_Command.Command && item.commandType === import_CommandType.CommandType.ValueForUpdate) {
+        commandsToUpdate.push(item);
+      }
+    }
+    if (commandsToUpdate.length === 0) {
+      return responseCommand;
+    }
+    const updatedPayload = Array.from(responseCommand.payload);
+    for (const cmd of commandsToUpdate) {
+      const cmdPayload = cmd.payload;
+      if (cmdPayload && cmdPayload.length >= 2) {
+        const contextGuid = String(cmdPayload[0]);
+        const instanceGuid = String(cmdPayload[1]);
+        const invCtx = InvocationContext._invocationContexts.get(contextGuid);
+        if (invCtx) {
+          invCtx.#currentCommand = new import_Command.Command(invCtx.#runtimeName, import_CommandType.CommandType.Reference, [instanceGuid]);
+          InvocationContext._invocationContexts.delete(contextGuid);
+        }
+      }
+      const idx = updatedPayload.indexOf(cmd);
+      if (idx >= 0) updatedPayload.splice(idx, 1);
     }
-    return new InvocationContext(this.#runtimeName, this.#connectionData, this.#responseCommand, true);
+    return new import_Command.Command(responseCommand.runtimeName, responseCommand.commandType, updatedPayload);
   }
   /**
    * Invokes a static method on the target runtime.
@@ -171,14 +245,25 @@ class InvocationContext {
   }
   /**
    * Creates a new instance of a class in the target runtime.
+   * Adds the newly created context to the static invocation contexts map and
+   * includes the context GUID as the first argument of CreateClassInstance command payload.
    * @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);
+    const localCommand = new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.CreateClassInstance, [...args]);
+    const createInstanceInvCtx = this.#createInstanceContext(localCommand);
+    return createInstanceInvCtx.#registerForUpdate();
+  }
+  /**
+   * Registers the current InvocationContext for updates.
+   * @returns {InvocationContext}
+   */
+  #registerForUpdate() {
+    this.#currentCommand = this.#buildCommand(new import_Command.Command(this.#runtimeName, import_CommandType.CommandType.RegisterForUpdate, [this.getGuid()]));
+    InvocationContext._invocationContexts.set(this.getGuid(), this);
+    return this;
   }
   /**
    * Retrieves the value of an instance field from the target runtime.
@@ -450,7 +535,7 @@ class InvocationContext {
       }
       return payloadItem;
     } else if (payloadItem instanceof InvocationContext) {
-      return payloadItem.get_current_command();
+      return payloadItem.getCurrentCommand();
     } 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);

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

@@ -284,7 +284,7 @@ class RuntimeContext {
       }
       return payloadItem;
     } else if (payloadItem instanceof import_InvocationContext.InvocationContext) {
-      const command = payloadItem?.get_current_command();
+      const command = payloadItem?.getCurrentCommand();
       if (!command) {
         throw new Error("Command not found");
       }

data/lib/javonet-ruby-sdk/Binaries/Nodejs/dist/types/core/handler/Handler.d.ts

@@ -1,5 +1,12 @@
 export type RuntimeName = import("../../types.d.ts").RuntimeName;
 export class Handler {
+    /**
+     * Prefer innerException (or cause) when available.
+     * @param {any} error
+     * @param {Command} command
+     * @returns {Command}
+     */
+    static resolveException(error: any, command: Command): Command;
     /**
      * @param {import('../interpreter/Interpreter.js').Interpreter} interpreter
      */