wse-client 1.2.1 → 1.3.0

package/README.md

@@ -25,7 +25,9 @@ The engine is Rust-accelerated via PyO3. Up to **2M msg/s** sustained throughput
 
 ## Quick Start
 
-### Server (Python)
+### Server (Python) -- Router Mode
+
+Embed WSE into your existing FastAPI app on the same port:
 
 ```python
 from fastapi import FastAPI
@@ -43,6 +45,31 @@ app.include_router(wse, prefix="/wse")
 await wse.publish("notifications", {"text": "Order shipped!", "order_id": 42})
 ```
 
+### Server (Python) -- Standalone Mode
+
+Run the Rust WebSocket server on a dedicated port for maximum throughput:
+
+```python
+from wse_server._wse_accel import RustWSEServer
+
+server = RustWSEServer(
+    "0.0.0.0", 5006,
+    max_connections=10000,
+    jwt_secret=b"your-secret-key",     # Rust JWT validation in handshake
+    jwt_issuer="your-app",
+    jwt_audience="your-api",
+)
+server.start()
+
+# Drain inbound events in a background thread
+while True:
+    events = server.drain_inbound(256, 50)  # batch size, timeout ms
+    for event in events:
+        handle(event)
+```
+
+Standalone mode gives you a dedicated Rust tokio runtime on its own port -- no FastAPI overhead, no GIL on the hot path. This is how WSE achieves 2M msg/s.
+
 ### Client (React)
 
 ```tsx
@@ -217,9 +244,11 @@ Client (React + TypeScript)              Server (Python + Rust)
 ========================                 ========================
 
 useWSE hook                              FastAPI Router (/wse)
-    |                                        |
-    v                                        v
-ConnectionPool                           Rust Engine (PyO3)
+    |                                     -- OR --
+    v                                    RustWSEServer (standalone :5006)
+ConnectionPool                               |
+    |  (multi-endpoint,                      v
+    |   health scoring)              Rust Engine (PyO3)
     |  (multi-endpoint,                      |  (drain mode,
     |   health scoring)                      |   write coalescing)
     v                                        v

package/dist/constants.d.ts

@@ -1,5 +1,5 @@
 export declare const WS_PROTOCOL_VERSION = 1;
-export declare const WS_CLIENT_VERSION = "1.0.3";
+export declare const WS_CLIENT_VERSION = "1.3.0";
 export declare const HEARTBEAT_INTERVAL = 15000;
 export declare const IDLE_TIMEOUT = 40000;
 export declare const CONNECTION_TIMEOUT = 10000;

package/dist/constants.js

@@ -5,7 +5,7 @@
 // Protocol Constants
 // ---------------------------------------------------------------------------
 export const WS_PROTOCOL_VERSION = 1;
-export const WS_CLIENT_VERSION = '1.0.3';
+export const WS_CLIENT_VERSION = '1.3.0';
 // ---------------------------------------------------------------------------
 // Connection Constants
 // ---------------------------------------------------------------------------

package/dist/index.d.ts

@@ -21,5 +21,5 @@ export type { OfflineQueueConfig } from './services/OfflineQueue';
 export { EventHandlers } from './handlers/EventHandlers';
 export { registerAllHandlers } from './handlers/index';
 export * from './constants';
-export declare const WSE_VERSION = "1.0.3";
+export declare const WSE_VERSION = "1.3.0";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -44,5 +44,5 @@ export * from './constants';
 // ---------------------------------------------------------------------------
 // Version Info
 // ---------------------------------------------------------------------------
-export const WSE_VERSION = '1.0.3';
+export const WSE_VERSION = '1.3.0';
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wse-client",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "WSE (WebSocket Engine) React client. Type-safe hooks, auto-reconnect, offline queue, E2E encryption.",
   "main": "dist/index.js",
   "module": "dist/index.js",