feat: add TLS/SSL configuration, proxy support, and connection statistics


Major features:
- Add TLS/SSL configuration API for WebSocket client, server, and HTTP requests
- SetTLSCertAndKey, SetTLSCAFile, SetTLSCiphers methods
- HostnameValidation property for certificate verification
- Add proxy support (HTTP/HTTPS/SOCKS5) for WebSocket and HTTP clients
- SetProxy, ClearProxy methods and HasProxy property
- Add connection statistics for WebSocket client (for debug)
- MessagesSent/Received, BytesSent/Received, PingsSent/Received, etc.
- Add timeout configuration options
- PingTimeout, IdleTimeout, SendTimeout, CloseTimeout, HandshakeTimeout
- Add HTTP authentication methods (SetBasicAuth, SetBearerAuth, ClearAuth)
- Add WebSocket subprotocol support (AddSubProtocol, RemoveSubProtocol, ClearSubProtocols)
- Add connection pooling and keep-alive options for HTTP requests
- Add write_flg parameter to WriteJSON for JSON formatting control (closes #10)

Build system:
- Rebuild OpenSSL static libraries
- Add NOMINMAX define for Windows to fix std::min/max conflicts
- Add /ignore:4099 linker flag to suppress PDB warnings

Refactoring:
- Rename ws_natives.cpp to ws_natives_client.cpp for clarity
- Split ws.inc into ws_client.inc and ws_server.inc for better organization
- Convert IXWebSocket and zlib to git submodules
- Move AMBuilder files for third-party libraries to root third_party directory
- Rename WebsocketState enum to WebSocketState for consistency
- Replace DisableDeflate/IsDeflateEnabled with PerMessageDeflate property
- Change default ping interval to -1 (disabled) for WebSocket server

Documentation:
- Update README with proxy support, SSL dependencies, and build instructions
- Add comprehensive API documentation for new features
- Add WSS (WebSocket Secure) server example script
- Note about forked IXWebSocket with core modifications

Author: ProjectSky

.gitmodules

@@ -0,0 +1,7 @@
+[submodule "third_party/ixwebsocket"]
+	path = third_party/ixwebsocket
+	url = https://github.com/ProjectSky/IXWebSocket.git
+	branch = cpp17-refactor
+[submodule "third_party/zlib"]
+	path = third_party/zlib
+	url = https://github.com/madler/zlib.git

AMBuildScript

@@ -156,6 +156,7 @@ class ExtensionConfig(object):
 			'user32.lib',
 			'gdi32.lib',
 			'advapi32.lib',
+			'/ignore:4099' # PDB warnings
 		]
 
 		if builder.options.opt == '1':
@@ -186,6 +187,7 @@ class ExtensionConfig(object):
 		cxx.defines += [
 			'_WINDOWS',
 			'_WIN32_WINNT=0x0601',
+			'NOMINMAX',
 		]
 
 	def Library(self, context, compiler, name):

AMBuilder

@@ -1,8 +1,8 @@
 # vim: set sts=2 ts=8 sw=2 tw=99 et ft=python:
 import os
 
-ixwebsocket = builder.Build('third_party/ixwebsocket/AMBuilder')
-libz = builder.Build('third_party/zlib/AMBuilder')
+ixwebsocket = builder.Build('third_party/ixwebsocket.AMBuilder')
+libz = builder.Build('third_party/zlib.AMBuilder')
 
 for cxx in builder.targets:
   binary = Extension.Library(builder, cxx, 'websocket.ext')
@@ -14,15 +14,15 @@ for cxx in builder.targets:
     'src/ws_server.cpp',
     'src/http_request.cpp',
     'src/http_natives.cpp',
-    'src/ws_natives.cpp',
+    'src/ws_natives_client.cpp',
     'src/ws_natives_server.cpp',
     os.path.join(Extension.sm_root, 'public', 'smsdk_ext.cpp'),
   ]
 
   binary.compiler.includes += [
     os.path.join(builder.sourcePath, 'src'),
     os.path.join(builder.sourcePath, 'public'),
-    os.path.join(builder.sourcePath, 'third_party', 'ixwebsocket'),
+    os.path.join(builder.sourcePath, 'third_party', 'ixwebsocket', 'ixwebsocket'),
     os.path.join(builder.sourcePath, 'third_party', 'zlib'),
   ]
 

PackageScript

@@ -44,5 +44,5 @@ CopyFiles('scripting/include', 'addons/sourcemod/scripting/include',
   [ 'websocket.inc']
 )
 CopyFiles('scripting/include/websocket', 'addons/sourcemod/scripting/include/websocket',
-  [ 'ws.inc', 'http.inc']
+  [ 'http.inc', 'ws_client.inc', 'ws_server.inc']
 )

README.md

@@ -4,16 +4,20 @@
 This is a [SourceMod](http://www.sourcemod.net/) extension that provides some methods for HTTP JSON and websocket communication
 
 ## Features
-* Relies on [IXWebSocket](https://github.com/machinezone/IXWebSocket) which is C++ library for WebSocket client and server development. It has minimal dependencies
+* Relies on [IXWebSocket](https://github.com/ProjectSky/IXWebSocket/tree/cpp17-refactor) which is C++ library for WebSocket client and server development. It has minimal dependencies
 * Support TEXT and JSON data
 * Support client and server
 * Support permessage-deflate
 * Support SSL
 * Support x64
+* Support Proxy (HTTP/SOCKS5)
 * Support HTTP RESTful API with JSON and form data
 
 ## Dependencies
 * [sm-ext-json](https://github.com/ProjectSky/sm-ext-json) - **Optional**. Required only for JSON-related features. If not installed, TEXT-based WebSocket communication and non-JSON HTTP features will still work
+* **For Linux users** - **Required**: SSL/TLS support requires OpenSSL development packages
+  - For x64: `libssl-dev`
+  - For x86: `libssl-dev:i386`
 
 ## Installation
 1. **(Optional)** If you need JSON functionality, download and install [sm-ext-json](https://github.com/ProjectSky/sm-ext-json/releases) first
@@ -24,8 +28,9 @@ This is a [SourceMod](http://www.sourcemod.net/) extension that provides some me
 ``` sh
 sudo dpkg --add-architecture i386
 sudo apt-get update
-sudo apt-get install clang g++-multilib zlib1g-dev zlib1g-dev:i386 libssl-dev libssl-dev:i386
-clone project
+sudo apt-get install clang g++-multilib libssl-dev libssl-dev:i386
+git clone --recursive https://github.com/ProjectSky/sm-ext-websocket.git
+cd sm-ext-websocket
 mkdir build && cd build
 python ../configure.py --enable-optimize --symbol-files --sm-path=YOU_SOURCEMOD_PATH --targets=x86,x64
 ambuild
@@ -44,9 +49,13 @@ ambuild
 - [x] HTTP support
 - [x] Use sourcemod extension interface for JSON functionality instead of bundling json library
 - [x] Allow JSON library as an optional dependency
+- [x] TLS/SSL configuration API
+- [x] Proxy support
+- [x] Include IXWebSocket and libz via git submodules
 
 ## NOTES
 * Server will not process data during the hibernation. You can set sv_hibernate_when_empty to 0 to disable hibernation
+* This extension uses a [forked version of IXWebSocket](https://github.com/ProjectSky/IXWebSocket/tree/cpp17-refactor) with significant core modifications to support new features (proxy, connection pooling, statistics, timeouts, etc.). The upstream IXWebSocket library is not compatible with this extension
 
 ## Example
 * [Example Script](https://github.com/ProjectSky/sm-ext-websocket/tree/main/scripting)

scripting/http_test.sp

@@ -21,7 +21,7 @@ public void OnPluginStart()
 
 Action http_get(int args)
 {
-  HttpRequest request = new HttpRequest("https://httpbin.org/get");
+  HttpRequest request = new HttpRequest("http://127.0.0.1");
   request.AddHeader("User-Agent", "SourceMod HTTP Client");
   request.Get(OnHttpResponse);
   return Plugin_Handled;

scripting/include/websocket.inc

@@ -7,7 +7,8 @@
 #include <json>
 #define REQUIRE_EXTENSIONS
 #include <websocket/http>
-#include <websocket/ws>
+#include <websocket/ws_client>
+#include <websocket/ws_server>
 
 public Extension __ext_websocket = {
   name = "websocket",