Add tracing capabilities to OpenAIEndpoint

ChangeLog.md

@@ -3,8 +3,9 @@ OpenAI APIs for XP ChangeLog
 
 ## ?.?.? / ????-??-??
 
+* Added tracing capabilities to `com.openai.rest.OpenAIEndpoint` class
+  (@thekid)
 * Merged PR #2: Implement REST API - including support for streaming
   (@thekid)
 * Merged PR #1: Add integration tests for `cl100k_base` and `o200k_base`
-  (@thekid)
-* First public release - (@thekid)
+  (@thekid)

composer.json

@@ -7,6 +7,7 @@
   "keywords": ["module", "xp"],
   "require" : {
     "xp-framework/core": "^12.0 | ^11.0 | ^10.0",
+    "xp-framework/logging": "^11.2",
     "xp-forge/rest-client": "^5.6",
     "php" : ">=7.4.0"
   },

src/main/php/com/openai/rest/OpenAIEndpoint.class.php

@@ -1,8 +1,9 @@
 <?php namespace com\openai\rest;
 
+use util\log\Traceable;
 use webservices\rest\Endpoint;
 
-class OpenAIEndpoint {
+class OpenAIEndpoint implements Traceable {
   private $endpoint;
 
   /**
@@ -14,6 +15,15 @@ public function __construct($arg) {
     $this->endpoint= $arg instanceof Endpoint ? $arg : new Endpoint($arg);
   }
 
+  /**
+   * Provides a log category for tracing requests
+   *
+   * @param  ?util.log.LogCategory $cat
+   */
+  public function setTrace($cat) {
+    $this->endpoint->setTrace($cat);
+  }
+
   /** Returns an API */
   public function api(string $path, array $segments= []): Api {
     return new Api($this->endpoint->resource(ltrim($path, '/'), $segments));