Add RealtimeApi::socket() to access the underlying network socket

ChangeLog.md

@@ -3,6 +3,8 @@ OpenAI APIs for XP ChangeLog
 
 ## ?.?.? / ????-??-??
 
+* Added `RealtimeApi::socket()` to access the underlying network socket
+  (@thekid)
 * Merged PR #17: Move the `Tools` class to the com.openai.tools package
   (@thekid)
 

src/main/php/com/openai/realtime/RealtimeApi.class.php

@@ -43,6 +43,9 @@ public function __construct($endpoint) {
     });
   }
 
+  /** @return peer.Socket */
+  public function socket() { return $this->ws->socket(); }
+
   /** @param ?util.log.LogCategory $cat */
   public function setTrace($cat) {
     $this->cat= $cat;

src/test/php/com/openai/unittest/RealtimeApiTest.class.php

@@ -2,6 +2,7 @@
 
 use com\openai\realtime\RealtimeApi;
 use lang\IllegalStateException;
+use peer\Socket;
 use test\{Assert, Expect, Test, Values};
 
 class RealtimeApiTest {
@@ -26,6 +27,11 @@ public function initially_not_connected() {
     Assert::false($c->connected());
   }
 
+  #[Test]
+  public function socket_accessor() {
+    Assert::instance(Socket::class, (new RealtimeApi(self::URI))->socket());
+  }
+
   #[Test]
   public function connect() {
     $c= new RealtimeApi(new TestingSocket([self::SESSION_CREATED]));