javonet-nodejs-sdk 2.5.16 → 2.5.18

package/lib/utils/connectionData/WsConnectionData.js

@@ -1,6 +1,11 @@
+// @ts-check
 import { ConnectionType } from '../ConnectionType.js'
 import { IConnectionData } from './IConnectionData.js'
 
+/**
+ * @typedef {import('../ConnectionType.js').ConnectionType} ConnectionType
+ */
+
 /**
  * Represents WebSocket connection data.
  * @extends IConnectionData
@@ -40,6 +45,10 @@ class WsConnectionData extends IConnectionData {
         return [this.connectionType, 0, 0, 0, 0, 0, 0]
     }
 
+    /**
+     * @param {WsConnectionData} other
+     * @returns {boolean}
+     */
     equals(other) {
         return other instanceof WsConnectionData && this._hostname === other.hostname
     }

package/lib/utils/nodejs/connectionData/TcpConnectionData.js

@@ -1,12 +1,28 @@
+// @ts-check
 import { IConnectionData } from '../../connectionData/IConnectionData.js'
 import { ConnectionType } from '../../ConnectionType.js'
 import { getRequire, isNodejsRuntime } from '../../Runtime.js'
 
 const requireDynamic = getRequire(import.meta.url)
+
 /**
+ * @typedef {import('../../ConnectionType.js').ConnectionType} ConnectionType
  * @extends IConnectionData
  */
 export class TcpConnectionData extends IConnectionData {
+    /** @type {string} */
+    ipAddress = ''
+    /** @type {number} */
+    _port = 0
+    /** @type {string} */
+    _hostname = ''
+    /** @type {ConnectionType} */
+    _connectionType = ConnectionType.TCP
+
+    /**
+     * @param {string} hostname
+     * @param {number} port
+     */
     constructor(hostname, port) {
         super()
         this._port = port
@@ -19,6 +35,9 @@ export class TcpConnectionData extends IConnectionData {
         }
     }
 
+    /**
+     * @returns {ConnectionType}
+     */
     get connectionType() {
         return this._connectionType
     }
@@ -40,7 +59,7 @@ export class TcpConnectionData extends IConnectionData {
 
     /**
      * @param {string} hostname
-     * @returns {string|null}
+     * @returns {string}
      */
     resolveIpAddress(hostname) {
         try {
@@ -54,24 +73,29 @@ export class TcpConnectionData extends IConnectionData {
                     const dns = requireDynamic('dns')
 
                     // If it's not an IP address, try to resolve it as a hostname
-                    return dns.resolve4(hostname, (err, addresses) => {
+                    return dns.resolve4(hostname, (/** @type {Error | null} */ err, /** @type {string[]} */ addresses) => {
                         if (err) {
                             console.error(err)
-                            return null
+                            return ''
                         }
                         return addresses[0]
                     })
-                    // eslint-disable-next-line no-unused-vars
                 }
             }
+            return ''
         } catch (error) {
-            if (error.code === 'MODULE_NOT_FOUND') {
+            const err = /** @type {{code?: string}} */ (error)
+            if (err.code === 'MODULE_NOT_FOUND') {
                 throw new Error('dns module not found. Please install it using npm install dns')
             }
             throw error
         }
     }
 
+    /**
+     * Serializes the connection data.
+     * @returns {number[]} An array of connection data values.
+     */
     serializeConnectionData() {
         let result = [this.connectionType]
         result = result.concat(this.#getAddressBytes())
@@ -79,10 +103,16 @@ export class TcpConnectionData extends IConnectionData {
         return result
     }
 
+    /**
+     * @returns {number[]} An array of address bytes.
+     */
     #getAddressBytes() {
         return this.ipAddress.split('.').map(Number)
     }
 
+    /**
+     * @returns {number[]} An array of port bytes.
+     */
     #getPortBytes() {
         return [this._port & 0xff, this._port >> 8]
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "javonet-nodejs-sdk",
-    "version": "2.5.16",
+    "version": "2.5.18",
     "description": "Javonet allows you to reference and use modules or packages written in (Java/Kotlin/Groovy/Clojure, C#/VB.NET, Ruby, Perl, Python, JavaScript/TypeScript) like they were created in your technology. It works on Linux/Windows and MacOS for applications created in JVM, CLR/Netcore, Perl, Python, Ruby, NodeJS, C++ or GoLang and gives you unparalleled freedom and flexibility with native performance in building your mixed-technologies products. Let it be accessing best AI or cryptography libraries, devices SDKs, legacy client modules, internal custom packages or anything from public repositories available on NPM, Nuget, PyPI, Maven/Gradle, RubyGems or GitHub. Get free from programming languages barriers today! For more information check out our guides at https://www.javonet.com/guides/v2/",
     "keywords": [],
     "author": "SdNCenter Sp. z o. o.",
@@ -8,6 +8,9 @@
     "main": "./dist/sdk/Javonet.cjs",
     "module": "./lib/sdk/Javonet.js",
     "types": "./dist/types/sdk/Javonet.d.ts",
+    "browser": {
+        "./lib/utils/CreateRequire.node.js": "./lib/utils/CreateRequire.browser.js"
+    },
     "type": "module",
     "files": [
         "dist",
@@ -18,7 +21,13 @@
         ".": {
             "types": "./dist/types/sdk/Javonet.d.ts",
             "import": "./lib/sdk/Javonet.js",
+            "browser": "./lib/sdk/Javonet.js",
             "require": "./dist/sdk/Javonet.cjs"
+        },
+        "./lib/utils/CreateRequire.node.js": {
+            "browser": "./lib/utils/CreateRequire.browser.js",
+            "node": "./lib/utils/CreateRequire.node.js",
+            "default": "./lib/utils/CreateRequire.node.js"
         }
     },
     "scripts": {
@@ -33,6 +42,7 @@
         "format": "prettier --write ."
     },
     "dependencies": {
+        "@types/ws": "^8.18.1",
         "buffer": "^6.0.3",
         "glob": "^10.4.5",
         "uuid": "^10.0.0"
@@ -69,8 +79,8 @@
     "peerDependencies": {
         "crypto": "^1.0.1",
         "dns": "^0.2.2",
-        "ws": "^8.0.0",
-        "fs-extra": "^11.2.0"
+        "fs-extra": "^11.2.0",
+        "ws": "^8.0.0"
     },
     "peerDependenciesMeta": {
         "ws": {

package/dist/sdk/tools/browser/ConfigSourceResolver.cjs

@@ -1,153 +0,0 @@
-"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 ConfigSourceResolver_exports = {};
-__export(ConfigSourceResolver_exports, {
-  ConfigSourceResolver: () => ConfigSourceResolver
-});
-module.exports = __toCommonJS(ConfigSourceResolver_exports);
-function hasOwnProperty(obj, key) {
-  return Object.prototype.hasOwnProperty.call(obj, key);
-}
-class ConfigSourceResolver {
-  /**
-   *
-   * @param {object | string} configSource
-   */
-  constructor(configSource) {
-    if (typeof configSource === "string") {
-      try {
-        this.jsonObject = JSON.parse(configSource);
-      } catch (err) {
-        throw new Error(
-          `Failed to parse configSource as JSON: ${err instanceof Error ? err.message : "Unknown error"}`
-        );
-      }
-    } else if (configSource && typeof configSource === "object") {
-      this.jsonObject = configSource;
-    } else {
-      throw new Error("configSource must be a JSON object or JSON string");
-    }
-  }
-  getLicenseKey() {
-    if (!hasOwnProperty(this.jsonObject, "licenseKey")) {
-      throw new Error(
-        "License key not found in configuration file. Please check your configuration file."
-      );
-    }
-    return this.jsonObject.licenseKey;
-  }
-  getRuntimes() {
-    return this.jsonObject.runtimes;
-  }
-  /**
-   * @param {string} runtimeName
-   * @param {string} configName
-   * @returns {any}
-   */
-  getRuntime(runtimeName, configName) {
-    const runtimes = this.getRuntimes();
-    if (hasOwnProperty(runtimes, runtimeName)) {
-      const runtime = runtimes[runtimeName];
-      if (Array.isArray(runtime)) {
-        for (let item of runtime) {
-          if (item.name === configName) {
-            return item;
-          }
-        }
-      } else if (runtime?.name === configName) {
-        return runtime;
-      }
-    }
-    throw new Error(
-      `Runtime config ${configName} not found in configuration file for runtime ${runtimeName}. Please check your configuration file.`
-    );
-  }
-  /**
-   * @param {string} runtimeName
-   * @param {string} configName
-   * @returns {any}
-   */
-  getChannel(runtimeName, configName) {
-    const runtime = this.getRuntime(runtimeName, configName);
-    if (!hasOwnProperty(runtime, "channel")) {
-      throw new Error(
-        `Channel key not found in configuration file for config ${configName}. Please check your configuration file.`
-      );
-    }
-    return runtime.channel;
-  }
-  /**
-   * @param {string} runtimeName
-   * @param {string} configName
-   * @returns {any}
-   */
-  getChannelType(runtimeName, configName) {
-    const channel = this.getChannel(runtimeName, configName);
-    if (!hasOwnProperty(channel, "type")) {
-      throw new Error(
-        `Channel type not found in configuration file for config ${configName}. Please check your configuration file.`
-      );
-    }
-    return channel.type;
-  }
-  /**
-   * @param {string} runtimeName
-   * @param {string} configName
-   * @returns {any}
-   */
-  getChannelHost(runtimeName, configName) {
-    const channel = this.getChannel(runtimeName, configName);
-    if (!hasOwnProperty(channel, "host")) {
-      throw new Error(
-        `Channel host not found in configuration file for config ${configName}. Please check your configuration file.`
-      );
-    }
-    return channel.host;
-  }
-  /**
-   * @param {string} runtimeName
-   * @param {string} configName
-   * @returns {any}
-   */
-  getChannelPort(runtimeName, configName) {
-    const channel = this.getChannel(runtimeName, configName);
-    if (!hasOwnProperty(channel, "port")) {
-      throw new Error(
-        `Channel port not found in configuration file for config ${configName}. Please check your configuration file.`
-      );
-    }
-    return channel.port;
-  }
-  /**
-   * @param {string} runtimeName
-   * @param {string} configName
-   * @returns {any}
-   */
-  getModules(runtimeName, configName) {
-    const runtime = this.getRuntime(runtimeName, configName);
-    if (hasOwnProperty(runtime, "modules")) {
-      return runtime.modules;
-    }
-    return "";
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ConfigSourceResolver
-});

package/dist/sdk/tools/nodejs/JsonFileResolver.cjs

@@ -1,120 +0,0 @@
-"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 JsonFileResolver_exports = {};
-__export(JsonFileResolver_exports, {
-  JsonFileResolver: () => JsonFileResolver
-});
-module.exports = __toCommonJS(JsonFileResolver_exports);
-var import_Runtime = require("../../../utils/Runtime.cjs");
-const import_meta = {};
-const requireDynamic = (0, import_Runtime.getRequire)(import_meta.url);
-let fsExtra = null;
-function hasOwnProperty(obj, key) {
-  return Object.prototype.hasOwnProperty.call(obj, key);
-}
-class JsonFileResolver {
-  constructor(path) {
-    this.path = path;
-    try {
-      if (!fsExtra) {
-        fsExtra = requireDynamic("fs-extra");
-      }
-      const data = fsExtra.readFileSync(this.path, "utf8");
-      this.jsonObject = JSON.parse(data);
-    } catch (err) {
-      throw err;
-    }
-  }
-  getLicenseKey() {
-    if (!hasOwnProperty(this.jsonObject, "licenseKey")) {
-      throw new Error(
-        "License key not found in configuration file. Please check your configuration file."
-      );
-    }
-    return this.jsonObject.licenseKey;
-  }
-  getRuntimes() {
-    return this.jsonObject.runtimes;
-  }
-  getRuntime(runtimeName, configName) {
-    const runtimes = this.getRuntimes();
-    if (hasOwnProperty(runtimes, runtimeName)) {
-      const runtime = runtimes[runtimeName];
-      if (Array.isArray(runtime)) {
-        for (let item of runtime) {
-          if (item.name === configName) {
-            return item;
-          }
-        }
-      } else if (runtime.name === configName) {
-        return runtime;
-      }
-    }
-    throw new Error(
-      `Runtime config ${configName} not found in configuration file for runtime ${runtimeName}. Please check your configuration file.`
-    );
-  }
-  getChannel(runtimeName, configName) {
-    const runtime = this.getRuntime(runtimeName, configName);
-    if (!hasOwnProperty(runtime, "channel")) {
-      throw new Error(
-        `Channel key not found in configuration file for config ${configName}. Please check your configuration file.`
-      );
-    }
-    return runtime.channel;
-  }
-  getChannelType(runtimeName, configName) {
-    const channel = this.getChannel(runtimeName, configName);
-    if (!hasOwnProperty(channel, "type")) {
-      throw new Error(
-        `Channel type not found in configuration file for config ${configName}. Please check your configuration file.`
-      );
-    }
-    return channel.type;
-  }
-  getChannelHost(runtimeName, configName) {
-    const channel = this.getChannel(runtimeName, configName);
-    if (!hasOwnProperty(channel, "host")) {
-      throw new Error(
-        `Channel host not found in configuration file for config ${configName}. Please check your configuration file.`
-      );
-    }
-    return channel.host;
-  }
-  getChannelPort(runtimeName, configName) {
-    const channel = this.getChannel(runtimeName, configName);
-    if (!hasOwnProperty(channel, "port")) {
-      throw new Error(
-        `Channel port not found in configuration file for config ${configName}. Please check your configuration file.`
-      );
-    }
-    return channel.port;
-  }
-  getModules(runtimeName, configName) {
-    const runtime = this.getRuntime(runtimeName, configName);
-    if (hasOwnProperty(runtime, "modules")) {
-      return runtime.modules;
-    }
-    return "";
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  JsonFileResolver
-});

package/dist/types/sdk/tools/browser/ConfigSourceResolver.d.ts

@@ -1,46 +0,0 @@
-export class ConfigSourceResolver {
-    /**
-     *
-     * @param {object | string} configSource
-     */
-    constructor(configSource: object | string);
-    jsonObject: any;
-    getLicenseKey(): any;
-    getRuntimes(): any;
-    /**
-     * @param {string} runtimeName
-     * @param {string} configName
-     * @returns {any}
-     */
-    getRuntime(runtimeName: string, configName: string): any;
-    /**
-     * @param {string} runtimeName
-     * @param {string} configName
-     * @returns {any}
-     */
-    getChannel(runtimeName: string, configName: string): any;
-    /**
-     * @param {string} runtimeName
-     * @param {string} configName
-     * @returns {any}
-     */
-    getChannelType(runtimeName: string, configName: string): any;
-    /**
-     * @param {string} runtimeName
-     * @param {string} configName
-     * @returns {any}
-     */
-    getChannelHost(runtimeName: string, configName: string): any;
-    /**
-     * @param {string} runtimeName
-     * @param {string} configName
-     * @returns {any}
-     */
-    getChannelPort(runtimeName: string, configName: string): any;
-    /**
-     * @param {string} runtimeName
-     * @param {string} configName
-     * @returns {any}
-     */
-    getModules(runtimeName: string, configName: string): any;
-}

package/dist/types/sdk/tools/nodejs/JsonFileResolver.d.ts

@@ -1,13 +0,0 @@
-export class JsonFileResolver {
-    constructor(path: any);
-    path: any;
-    jsonObject: any;
-    getLicenseKey(): any;
-    getRuntimes(): any;
-    getRuntime(runtimeName: any, configName: any): any;
-    getChannel(runtimeName: any, configName: any): any;
-    getChannelType(runtimeName: any, configName: any): any;
-    getChannelHost(runtimeName: any, configName: any): any;
-    getChannelPort(runtimeName: any, configName: any): any;
-    getModules(runtimeName: any, configName: any): any;
-}

package/dist/types/utils/nodejs/TypesConverter.d.ts

@@ -1,48 +0,0 @@
-/**
- * ConvertTypeHandler class handles the conversion of JType to Type.
- */
-export class ConvertTypeHandler {
-    /**
-     * Minimum required parameters count for the command.
-     * @type {number}
-     */
-    requiredParametersCount: number;
-    /**
-     * Processes the given command to convert JType to Type.
-     * @param {Object} command - The command to process.
-     * @returns {any} The converted type.
-     */
-    process(command: Object): any;
-    /**
-     * Validates the command to ensure it has enough parameters.
-     * @param {Object} command - The command to validate.
-     */
-    validateCommand(command: Object): void;
-}
-/**
- * TypesConverter class provides utilities for converting between types.
- */
-export class TypesConverter {
-    /**
-     * Converts a JavaScript type to a JType equivalent.
-     * @param {Function} type - The JavaScript type.
-     * @returns {number} The corresponding JType.
-     */
-    static convertTypeToJType(type: Function): number;
-    /**
-     * Converts a JType to a JavaScript type equivalent.
-     * @param {number} type - The JType to convert.
-     * @returns {Function} The corresponding JavaScript type.
-     */
-    static convertJTypeToType(type: number): Function;
-}
-/**
- * Enum for JType mappings.
- */
-export type JType = number;
-export namespace JType {
-    let Boolean: number;
-    let Float: number;
-    let String: number;
-    let Null: number;
-}

package/dist/utils/nodejs/TypesConverter.cjs

@@ -1,102 +0,0 @@
-"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 TypesConverter_exports = {};
-__export(TypesConverter_exports, {
-  ConvertTypeHandler: () => ConvertTypeHandler,
-  JType: () => JType,
-  TypesConverter: () => TypesConverter
-});
-module.exports = __toCommonJS(TypesConverter_exports);
-class ConvertTypeHandler {
-  constructor() {
-    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");
-    }
-  }
-}
-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;
-    }
-  }
-}
-const JType = {
-  Boolean: 1,
-  Float: 2,
-  String: 3,
-  Null: 4
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ConvertTypeHandler,
-  JType,
-  TypesConverter
-});

package/lib/declarations.d.ts

@@ -1,35 +0,0 @@
-declare enum RuntimeName {
-    Clr = 0,
-    Go = 1,
-    Jvm = 2,
-    Netcore = 3,
-    Perl = 4,
-    Python = 5,
-    Ruby = 6,
-    Nodejs = 7,
-    Cpp = 8,
-}
-
-interface RuntimeChannel {
-    type: 'inMemory' | 'tcp' | 'webSocket'
-    host?: string
-    port?: number
-}
-
-interface Runtime {
-    name: string
-    customOptions: string
-    modules: string
-    channel: RuntimeChannel
-    runtimeName: RuntimeName
-}
-
-type Runtimes = {
-    [Key in keyof typeof RuntimeName]: Runtime[]
-}
-
-export interface ConfigSource {
-    [key: string]: any
-    licenseKey: string
-    runtimes: Partial<Runtimes>
-}