refactor: lazy WebSocket, sync context creation, unified tokio runtime (4.0.5)

- Lazy WebSocket connection: WS connects on first use instead of at creation.
  QuoteContext and TradeContext no longer perform any I/O at construction time.

- Sync context creation: QuoteContext::new / TradeContext::new are now
  infallible synchronous functions returning Self directly.
  All language bindings updated accordingly:
  - C: lb_quote/trade_context_new returns the context pointer directly
  - C++: QuoteContext/TradeContext::create returns the object directly
  - Java: QuoteContext/TradeContext.create() returns the object directly
  - Node.js: QuoteContext/TradeContext.new is now a sync static method
  - Python: AsyncQuoteContext/TradeContext.create is now a sync classmethod
  - Rust blocking: QuoteContextSync/TradeContextSync::new returns Self directly

- Unified tokio runtime: a single global LazyLock<Runtime> in the longbridge
  crate is shared across all bindings; no more per-binding runtimes.

- member_id / quote_level / quote_package_details promoted to async API
  methods (were previously sync fields); updated across all bindings.

- Java: fix Javadoc formatting in QuoteContext/TradeContext examples,
  add missing content package classes to compile task, use platform-aware
  classpath separator in Makefile.toml, add --enable-native-access=ALL-UNNAMED.

- Node.js: update all doc-comment examples to sync QuoteContext/TradeContext.new.

- Bump version to 4.0.5.

Author: sunli829

CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+# [4.0.5]
+
+## Changed
+
+- **All bindings:** `QuoteContext::new` / `TradeContext::new` are now synchronous and infallible — no more `await` or `.get()` at construction time. The WebSocket connection is established lazily on first use.
+- **All bindings:** `member_id`, `quote_level`, and `quote_package_details` are now async methods (were previously sync fields/properties).
+- **Rust:** A single global Tokio runtime is shared across all SDK components; per-binding runtimes removed.
+
+## Fixed
+
+- **Java:** Restored broken Javadoc comment formatting in `QuoteContext` and `TradeContext` example blocks.
+- **Java:** `Makefile.toml` now uses a platform-aware classpath separator (`:` on Unix, `;` on Windows) and adds `--enable-native-access=ALL-UNNAMED` to suppress JVM native-access warnings on JDK 17+.
+- **Java:** Added missing `content` package classes (`ContentContext`, `NewsItem`, `TopicItem`) to the compile task.
+- **Node.js:** Updated all doc-comment examples to use sync `QuoteContext.new(config)` / `TradeContext.new(config)`.
+
 # [4.0.4]
 
 ## Fixed

Cargo.toml

@@ -3,19 +3,19 @@ resolver = "3"
 members = ["rust", "python", "nodejs", "java", "c", "mcp"]
 
 [workspace.package]
-version = "4.0.4"
+version = "4.0.5"
 edition = "2024"
 
 [profile.release]
 lto = true
 
 [workspace.dependencies]
-longbridge-wscli = { path = "rust/crates/wsclient", version = "4.0.4" }
-longbridge-httpcli = { path = "rust/crates/httpclient", version = "4.0.4" }
-longbridge-proto = { path = "rust/crates/proto", version = "4.0.4" }
-longbridge-candlesticks = { path = "rust/crates/candlesticks", version = "4.0.4" }
-longbridge-oauth = { path = "rust/crates/oauth", version = "4.0.4" }
-longbridge = { path = "rust", version = "4.0.4" }
+longbridge-wscli = { path = "rust/crates/wsclient", version = "4.0.5" }
+longbridge-httpcli = { path = "rust/crates/httpclient", version = "4.0.5" }
+longbridge-proto = { path = "rust/crates/proto", version = "4.0.5" }
+longbridge-candlesticks = { path = "rust/crates/candlesticks", version = "4.0.5" }
+longbridge-oauth = { path = "rust/crates/oauth", version = "4.0.5" }
+longbridge = { path = "rust", version = "4.0.5" }
 
 tokio = "1.47.1"
 tokio-tungstenite = "0.27.0"

c/csrc/include/longbridge.h

@@ -4261,9 +4261,7 @@ struct lb_oauth_t *lb_oauth_clone(const struct lb_oauth_t *oauth);
  */
 void lb_oauth_free(struct lb_oauth_t *oauth);
 
-void lb_quote_context_new(const struct lb_config_t *config,
-                          lb_async_callback_t callback,
-                          void *userdata);
+const struct lb_quote_context_t *lb_quote_context_new(const struct lb_config_t *config);
 
 void lb_quote_context_retain(const struct lb_quote_context_t *ctx);
 
@@ -4278,9 +4276,13 @@ void *lb_quote_context_userdata(const struct lb_quote_context_t *ctx);
 void lb_quote_context_set_free_userdata_func(const struct lb_quote_context_t *ctx,
                                              lb_free_userdata_func_t f);
 
-int64_t lb_quote_context_member_id(const struct lb_quote_context_t *ctx);
+void lb_quote_context_member_id(const struct lb_quote_context_t *ctx,
+                                lb_async_callback_t callback,
+                                void *userdata);
 
-const char *lb_quote_context_quote_level(const struct lb_quote_context_t *ctx);
+void lb_quote_context_quote_level(const struct lb_quote_context_t *ctx,
+                                  lb_async_callback_t callback,
+                                  void *userdata);
 
 void lb_quote_context_quote_package_details(const struct lb_quote_context_t *ctx,
                                             lb_async_callback_t callback,
@@ -4704,9 +4706,7 @@ void lb_quote_context_history_market_temperature(const struct lb_quote_context_t
                                                  lb_async_callback_t callback,
                                                  void *userdata);
 
-void lb_trade_context_new(const struct lb_config_t *config,
-                          lb_async_callback_t callback,
-                          void *userdata);
+const struct lb_trade_context_t *lb_trade_context_new(const struct lb_config_t *config);
 
 void lb_trade_context_retain(const struct lb_trade_context_t *ctx);
 

c/src/async_call.rs

@@ -1,21 +1,9 @@
-use std::{
-    ffi::c_void,
-    future::Future,
-    sync::{Arc, LazyLock},
-};
+use std::{ffi::c_void, future::Future, sync::Arc};
 
 use longbridge::Result;
-use tokio::runtime::Runtime;
 
 use crate::error::CError;
 
-static RUNTIME: LazyLock<Runtime> = LazyLock::new(|| {
-    tokio::runtime::Builder::new_multi_thread()
-        .enable_all()
-        .build()
-        .expect("create tokio runtime")
-});
-
 pub type CAsyncCallback = extern "C" fn(*const CAsyncResult);
 
 #[derive(Debug, Copy, Clone)]
@@ -128,14 +116,13 @@ pub(crate) fn execute_async<P, F, T>(
     P: Send,
 {
     unsafe {
-        let _guard = RUNTIME.enter();
         let ctx_pointer = ctx as usize;
         let userdata_pointer = userdata as usize;
 
         if !ctx.is_null() {
             Arc::increment_strong_count(ctx);
         }
-        tokio::spawn(async move {
+        longbridge::runtime_handle().spawn(async move {
             match fut.await {
                 Ok(res) => {
                     let mut res = res.to_async_result(ctx_pointer as *const c_void);