hypertube-binaries 3.0.3 → 3.0.4

package/Binaries/Native/Windows/ARM64/_HypertubeNativeErrorLogger_2026-05-06.txt

@@ -0,0 +1,124 @@
+2026-05-06 20:28:10	Thread ID: 7296	Proxy configuration not found in configuration source. Check your configuration:
+{
+  "licenseKey": "your-license-key"
+}
+2026-05-06 20:28:11	Thread ID: 7296	Proxy configuration not found in configuration source. Check your configuration:
+{
+  "licenseKey": "your-license-key"
+}
+2026-05-06 20:28:11	Thread ID: 7296	Proxy configuration not found in configuration source. Check your configuration:
+{
+  "licenseKey": "your-license-key"
+}
+2026-05-06 20:28:11	Thread ID: 7296	Proxy configuration not found in configuration source. Check your configuration:
+{
+  "licenseKey": "your-license-key"
+}
+2026-05-06 20:28:11	Thread ID: 7296	Runtime config default not found in configuration source for runtime invalid_runtime_name. Check your configuration:
+{
+  "licenseKey": "unit-tests-key",
+  "loggingLevel": "runtimeInfo",
+  "proxy": {
+    "host": "test",
+    "username": "test",
+    "password": "test",
+    "domain": "test"
+  },
+  "runtimes": {
+    "jvm": [
+      {
+        "name": "default",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "inMemory",
+          "runtimePath": "/test/path/to/jvm/runtime"
+        }
+      },
+      {
+        "name": "custom1",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "tcp",
+          "host": "127.0.0.1",
+          "port": 8083
+        }
+      }
+    ],
+    "netcore": [
+      {
+        "name": "default",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "tcp",
+          "host": "127.0.0.1",
+          "port": 8080
+        }
+      },
+      {
+        "name": "custom1",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "tcp",
+          "host": "127.0.0.1",
+          "port": 8081
+        }
+      }
+    ],
+    "python": [
+      {
+        "name": "default",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "inMemory"
+        }
+      },
+      {
+        "name": "with-modules-relative",
+        "customOptions": "",
+        "modules": "../python-package",
+        "channel": {
+          "type": "inMemory"
+        }
+      }
+    ],
+    "ruby": {
+      "name": "default",
+      "customOptions": "",
+      "modules": "",
+      "channel": {
+        "type": "tcp",
+        "host": "127.0.0.1",
+        "port": 8082
+      }
+    },
+    "nodejs": {
+      "name": "default",
+      "customOptions": "",
+      "modules": "",
+      "channel": {
+        "type": "inMemory"
+      }
+    },
+    "clr": {
+      "name": "default",
+      "customOptions": "",
+      "modules": "",
+      "channel": {
+        "type": "inMemory"
+      }
+    },
+    "perl": {
+      "name": "default",
+      "customOptions": "",
+      "modules": "",
+      "channel": {
+        "type": "inMemory"
+      }
+    }
+  }
+}

package/Binaries/Native/Windows/X64/_HypertubeNativeErrorLogger_2026-05-06.txt

@@ -0,0 +1,124 @@
+2026-05-06 20:31:56	Thread ID: 6804	Proxy configuration not found in configuration source. Check your configuration:
+{
+  "licenseKey": "your-license-key"
+}
+2026-05-06 20:31:56	Thread ID: 6804	Proxy configuration not found in configuration source. Check your configuration:
+{
+  "licenseKey": "your-license-key"
+}
+2026-05-06 20:31:56	Thread ID: 6804	Proxy configuration not found in configuration source. Check your configuration:
+{
+  "licenseKey": "your-license-key"
+}
+2026-05-06 20:31:56	Thread ID: 6804	Proxy configuration not found in configuration source. Check your configuration:
+{
+  "licenseKey": "your-license-key"
+}
+2026-05-06 20:31:56	Thread ID: 6804	Runtime config default not found in configuration source for runtime invalid_runtime_name. Check your configuration:
+{
+  "licenseKey": "unit-tests-key",
+  "loggingLevel": "runtimeInfo",
+  "proxy": {
+    "host": "test",
+    "username": "test",
+    "password": "test",
+    "domain": "test"
+  },
+  "runtimes": {
+    "jvm": [
+      {
+        "name": "default",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "inMemory",
+          "runtimePath": "/test/path/to/jvm/runtime"
+        }
+      },
+      {
+        "name": "custom1",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "tcp",
+          "host": "127.0.0.1",
+          "port": 8083
+        }
+      }
+    ],
+    "netcore": [
+      {
+        "name": "default",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "tcp",
+          "host": "127.0.0.1",
+          "port": 8080
+        }
+      },
+      {
+        "name": "custom1",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "tcp",
+          "host": "127.0.0.1",
+          "port": 8081
+        }
+      }
+    ],
+    "python": [
+      {
+        "name": "default",
+        "customOptions": "",
+        "modules": "",
+        "channel": {
+          "type": "inMemory"
+        }
+      },
+      {
+        "name": "with-modules-relative",
+        "customOptions": "",
+        "modules": "../python-package",
+        "channel": {
+          "type": "inMemory"
+        }
+      }
+    ],
+    "ruby": {
+      "name": "default",
+      "customOptions": "",
+      "modules": "",
+      "channel": {
+        "type": "tcp",
+        "host": "127.0.0.1",
+        "port": 8082
+      }
+    },
+    "nodejs": {
+      "name": "default",
+      "customOptions": "",
+      "modules": "",
+      "channel": {
+        "type": "inMemory"
+      }
+    },
+    "clr": {
+      "name": "default",
+      "customOptions": "",
+      "modules": "",
+      "channel": {
+        "type": "inMemory"
+      }
+    },
+    "perl": {
+      "name": "default",
+      "customOptions": "",
+      "modules": "",
+      "channel": {
+        "type": "inMemory"
+      }
+    }
+  }
+}

package/Binaries/Native/Windows/X64/version.txt

@@ -1 +1 @@
-'3.0.3' 
+'3.0.4' 

package/Binaries/Php/hypertube/core/transmitter/TransmitterWrapper.php

@@ -55,21 +55,21 @@ final class TransmitterWrapper
     {
         $archSuffix = self::detectArchitecture();
         $basePath = self::getWorkingDirectoryBasePath();
-        $osName = strtolower(PHP_OS);
+        $osFamily = PHP_OS_FAMILY;
 
-        if (strpos($osName, 'win') !== false) {
+        if ($osFamily === 'Windows') {
             return $basePath . '/Binaries/Native/Windows/' . $archSuffix . '/HypertubePhpRuntimeNative.dll';
         }
 
-        if (strpos($osName, 'darwin') !== false) {
+        if ($osFamily === 'Darwin') {
             return $basePath . '/Binaries/Native/MacOs/' . $archSuffix . '/libHypertubePhpRuntimeNative.dylib';
         }
 
-        if (strpos($osName, 'linux') !== false) {
+        if ($osFamily === 'Linux') {
             return $basePath . '/Binaries/Native/Linux/' . $archSuffix . '/libHypertubePhpRuntimeNative.so';
         }
 
-        throw new RuntimeException('Unsupported OS: ' . $osName);
+        throw new RuntimeException('Unsupported OS: ' . $osFamily);
     }
 
     private static function getWorkingDirectoryBasePath(): string

package/Binaries/Php/hypertube/core/webSocketClient/WebSocketClient.php

@@ -15,11 +15,11 @@ final class WebSocketClient
     private const UNSECURE_PORT_NUMBER = 80;
 
     /** Timeout for TCP connect and WebSocket handshake (seconds) */
-    private const CONNECT_TIMEOUT_SEC  = 5;
+    private const CONNECT_TIMEOUT_SEC  = 60;
 
     /** Timeout waiting for a response from the remote runtime (seconds).
-     *  Must be long enough for slow operations (e.g. GPGE package generation ~60s). */
-    private const RESPONSE_TIMEOUT_SEC = 80;
+     *  Must be long enough for slow operations (e.g. package generation ~60s). */
+    private const RESPONSE_TIMEOUT_SEC = 60;
 
     private const MAX_ATTEMPTS = 2;
 

package/Binaries/Php/hypertube/utils/connectiondata/TcpConnectionData.php

@@ -13,16 +13,39 @@ final class TcpConnectionData extends ConnectionData
     private int $port;
     private ConnectionType $connectionType;
 
-    public function __construct(
-        string $hostName,
-        int $port
-    ) {
-        $this->hostName = $hostName . ':' . $port;
+    public function __construct(string $hostname)
+    {
+        [$hostOnly, $port] = self::parseHostname($hostname);
+        $this->hostName = $hostOnly . ':' . $port;
         $this->port = $port;
-        $this->ipAddress = gethostbyname($hostName);
+        $this->ipAddress = gethostbyname($hostOnly);
         $this->connectionType = ConnectionType::TCP();
     }
 
+    private static function parseHostname(string $hostname): array
+    {
+        $value = trim($hostname);
+        if (stripos($value, 'tcp://') === 0) {
+            $value = substr($value, 6);
+        }
+        if (strpos($value, '/') !== false) {
+            throw new \InvalidArgumentException('TCP addresses do not support route paths.');
+        }
+
+        $colon = strrpos($value, ':');
+        if ($colon === false || $colon <= 0 || $colon >= strlen($value) - 1) {
+            throw new \InvalidArgumentException('TCP hostname must use host:port format.');
+        }
+
+        $hostOnly = trim(substr($value, 0, $colon));
+        $port = filter_var(substr($value, $colon + 1), FILTER_VALIDATE_INT);
+        if ($hostOnly === '' || $port === false || $port < 0 || $port > 65535) {
+            throw new \InvalidArgumentException('TCP hostname must contain a non-empty host and port between 0 and 65535.');
+        }
+
+        return [$hostOnly, $port];
+    }
+
     public function getConnectionType(): ConnectionType
     {
         return $this->connectionType;

package/Binaries/Python/hypertube/core/webSocketClient/WebSocketClient.py

@@ -14,6 +14,7 @@ from hypertube.utils.connectionData.WsConnectionData import WsConnectionData
 _clients: dict[str, WebSocketClient] = {}
 _clients_lock = threading.Lock()
 MAX_ATTEMPTS = 2
+DEFAULT_TIMEOUT_SECONDS = 60
 
 
 class WebSocketClient:
@@ -159,7 +160,12 @@ class WebSocketClient:
                 "The connection may have been closed or never established."
             )
         try:
-            response = self.ws.recv()
+            response = self.ws.recv(timeout=DEFAULT_TIMEOUT_SECONDS)
+        except TimeoutError as ex:
+            raise TimeoutError(
+                f"WebSocket receive from {self.uri} timed out after {DEFAULT_TIMEOUT_SECONDS} seconds. "
+                "The server may not have responded in time."
+            ) from ex
         except (ConnectionClosedOK, ConnectionClosedError) as ex:
             # Mirror C# behavior: close and raise WebSocketException
             try:

package/Binaries/Python/hypertube/utils/connectionData/TcpConnectionData.py

@@ -6,19 +6,43 @@ from hypertube.utils.connectionData.IConnectionData import IConnectionData
 
 class TcpConnectionData(IConnectionData):
 
-    def __init__(self, hostname: str, port: int):
+    def __init__(self, hostname: str):
         super().__init__()
-        self._hostname = f"{hostname}:{port}"
+        host_only, port = self.__parse_hostname(hostname)
+        self._hostname = f"{host_only}:{port}"
         self._port = port
         self._ip_address = ""
-        if hostname == "localhost":
+        if host_only == "localhost":
             self._ip_address = "127.0.0.1"
         else:
             try:
-                self._ip_address = socket.gethostbyname(hostname)
+                self._ip_address = socket.gethostbyname(host_only)
             except socket.gaierror:
                 self._ip_address = ""
 
+    @staticmethod
+    def __parse_hostname(hostname: str):
+        value = str(hostname).strip()
+        if value.lower().startswith("tcp://"):
+            value = value[6:]
+        if "/" in value:
+            raise ValueError("TCP addresses do not support route paths.")
+
+        colon = value.rfind(":")
+        if colon <= 0 or colon >= len(value) - 1:
+            raise ValueError("TCP hostname must use host:port format.")
+
+        host_only = value[:colon].strip()
+        try:
+            port = int(value[colon + 1:])
+        except Exception:
+            raise ValueError("TCP hostname must contain a numeric port.")
+
+        if not host_only or port < 0 or port > 65535:
+            raise ValueError("TCP hostname must contain a non-empty host and port between 0 and 65535.")
+
+        return host_only, port
+
     @property
     def connection_type(self):
         return ConnectionType.Tcp

package/Binaries/Ruby/core/web_socket_client/web_socket_client.rb

@@ -5,6 +5,7 @@ require 'websocket'
 
 class WebSocketClient
   MAX_ATTEMPTS = 2
+  DEFAULT_TIMEOUT_SECONDS = 60
 
   # Cache: URI(string) -> WebSocketClient
   @clients = {}
@@ -169,7 +170,7 @@ class WebSocketClient
 
   # Receive a full message payload as Array<Integer> (bytes)
   # Raises on CLOSE like the C# code (instead of returning nil).
-  def receive_bytes(timeout: 5)
+  def receive_bytes(timeout: DEFAULT_TIMEOUT_SECONDS)
     deadline = Time.now + timeout
     payload_chunks = []
 
@@ -251,7 +252,7 @@ class WebSocketClient
     write_all(@handshake.to_s)
     loop do
       break if @handshake.finished?
-      wait_timeout = @connect_timeout && @connect_timeout < 0 ? nil : (@connect_timeout || 5)
+      wait_timeout = @connect_timeout && @connect_timeout < 0 ? nil : (@connect_timeout || DEFAULT_TIMEOUT_SECONDS)
       raise "WebSocket connection to #{@uri}: handshake timeout. The server did not complete the WebSocket upgrade in time." unless IO.select([@socket], nil, nil, wait_timeout)
 
       data = @socket.read_nonblock(4096, exception: false)

package/Binaries/Ruby/utils/tcp_connection_data.rb

@@ -3,15 +3,16 @@
 class TcpConnectionData
   attr_reader :hostname, :ip_address, :port
 
-  def initialize(hostname, port)
-    @hostname = "#{hostname}:#{port}"
+  def initialize(hostname)
+    host_only, port = parse_hostname(hostname)
+    @hostname = "#{host_only}:#{port}"
     @port = port
     @headers = {}
-    if hostname == 'localhost'
+    if host_only == 'localhost'
       @ip_address = '127.0.0.1'
     else
       begin
-        @ip_address = IPSocket.getaddress(hostname)
+        @ip_address = IPSocket.getaddress(host_only)
       rescue SocketError
         raise 'Unable to resolve hostname to an IP address.'
       end
@@ -59,6 +60,25 @@ class TcpConnectionData
 
   private
 
+  def parse_hostname(hostname)
+    value = hostname.to_s.strip
+    value = value[6..-1] if value.downcase.start_with?('tcp://')
+    raise 'TCP addresses do not support route paths.' if value.include?('/')
+
+    colon = value.rindex(':')
+    raise 'TCP hostname must use host:port format.' if !colon || colon <= 0 || colon >= value.length - 1
+
+    host_only = value[0...colon].strip
+    port = Integer(value[colon + 1..-1])
+    if host_only.empty? || port.negative? || port > 65_535
+      raise 'TCP hostname must contain a non-empty host and port between 0 and 65535.'
+    end
+
+    [host_only, port]
+  rescue ArgumentError
+    raise 'TCP hostname must contain a numeric port.'
+  end
+
   def serialize_headers_for_key
     return '' if headers.nil? || headers.empty?
 

package/Binaries/version.txt

@@ -1 +1 @@
-3.0.3
+3.0.4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "hypertube-binaries",
-    "version": "3.0.3",
+    "version": "3.0.4",
     "description": "Hypertube 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.hypertube.dev/guides/v2/",
     "main": "index.js",
     "type": "commonjs",

package/Binaries/Native/Linux/ARM64/_HypertubeNativeErrorLogger_2026-05-05.txt

@@ -1,2 +0,0 @@
-2026-05-05 13:22:20	Thread ID: 266575848004128	Configuration source is not a valid JSON. Check your configuration:
-./config2.json

package/Binaries/Native/Linux/X64/_HypertubeNativeErrorLogger_2026-05-05.txt

@@ -1,2 +0,0 @@
-2026-05-05 13:25:39	Thread ID: 140094835955520	Configuration source is not a valid JSON. Check your configuration:
-./config2.json

package/Binaries/Native/MacOs/ARM64/_HypertubeNativeErrorLogger_2026-05-05.txt

@@ -1,2 +0,0 @@
-2026-05-05 15:22:42	Thread ID: 0x1e89410c0	Configuration source is not a valid JSON. Check your configuration:
-./config2.json

package/Binaries/Native/MacOs/X64/_HypertubeNativeErrorLogger_2026-05-05.txt

@@ -1,2 +0,0 @@
-2026-05-05 13:33:36	Thread ID: 0x7ff852d83840	Configuration source is not a valid JSON. Check your configuration:
-./config2.json

package/Binaries/Native/Windows/ARM64/_HypertubeNativeErrorLogger_2026-05-05.txt

@@ -1,2 +0,0 @@
-2026-05-05 13:28:49	Thread ID: 11276	Configuration source is not a valid JSON. Check your configuration:
-./config2.json

package/Binaries/Native/Windows/X64/_HypertubeNativeErrorLogger_2026-05-05.txt

@@ -1,2 +0,0 @@
-2026-05-05 13:27:28	Thread ID: 6032	Configuration source is not a valid JSON. Check your configuration:
-./config2.json