tekimax-ts 0.1.2 → 0.1.3

package/dist/index.js

@@ -1499,7 +1499,51 @@ var userMessageItemParamSchema = import_zod103.z.object({
 });
 
 // src/client.ts
+var TekimaxResponse = class {
+  constructor(_raw) {
+    this._raw = _raw;
+  }
+  /**
+   * Access the raw response object returned by the API.
+   */
+  get raw() {
+    return this._raw;
+  }
+  /**
+   * Automatically extracts the text content from the response.
+   * It looks for the first "output_text" item in the response content.
+   */
+  get text() {
+    if (!this._raw.output) return void 0;
+    const textItem = this._raw.output.find(
+      (item) => item.type === "output_text"
+    );
+    return textItem?.text;
+  }
+  /**
+   * The ID of the response.
+   */
+  get id() {
+    return this._raw.id ?? void 0;
+  }
+  /**
+   * The model used to generate the response.
+   */
+  get model() {
+    return this._raw.model ?? void 0;
+  }
+};
 var TekimaxClient = class {
+  /**
+   * Creates a new TekimaxClient.
+   * 
+   * @param options - Configuration options for the client.
+   * @param options.baseUrl - The base URL of the API (default: "https://api.tekimax.com").
+   * @param options.apiKey - Your Tekimax API key.
+   * 
+   * @example
+   * const client = new TekimaxClient({ apiKey: "tm_..." });
+   */
   constructor(options = {}) {
     this.baseUrl = options.baseUrl || "https://api.tekimax.com";
     this.headers = {
@@ -1516,13 +1560,40 @@ var TekimaxClient = class {
     if (!response.ok) {
       throw new Error(`Tekimax API Error: ${response.status} ${response.statusText}`);
     }
-    return response.json();
+    const data = await response.json();
+    return new TekimaxResponse(data);
   }
-  async createSession(body) {
+  /**
+   * Creates a new session and sends the initial message.
+   * 
+   * @param message - The initial message text to start the session.
+   * @param options - Additional configuration options (model, temperature, etc.).
+   * 
+   * @example
+   * const response = await client.createSession("Hello, world!", { model: "gpt-4" });
+   * console.log(response.text);
+   */
+  async createSession(message, options) {
+    const body = {
+      ...options,
+      input: message
+    };
     return this.request("/responses", body);
   }
-  async sendMessage(body) {
-    return this.request("/responses", body);
+  /**
+   * Sends a message to an existing session or starts a new one if no previous_response_id is provided.
+   * 
+   * @param message - The message text to send.
+   * @param options - Additional configuration options.
+   * 
+   * @example
+   * const response = await client.sendMessage("What is the weather?", { 
+   *   previous_response_id: "resp_123" 
+   * });
+   * console.log(response.text);
+   */
+  async sendMessage(message, options) {
+    return this.createSession(message, options);
   }
 };
 // Annotate the CommonJS export names for ESM import in node:

package/dist/index.mjs

@@ -1286,7 +1286,51 @@ var userMessageItemParamSchema = z103.object({
 });
 
 // src/client.ts
+var TekimaxResponse = class {
+  constructor(_raw) {
+    this._raw = _raw;
+  }
+  /**
+   * Access the raw response object returned by the API.
+   */
+  get raw() {
+    return this._raw;
+  }
+  /**
+   * Automatically extracts the text content from the response.
+   * It looks for the first "output_text" item in the response content.
+   */
+  get text() {
+    if (!this._raw.output) return void 0;
+    const textItem = this._raw.output.find(
+      (item) => item.type === "output_text"
+    );
+    return textItem?.text;
+  }
+  /**
+   * The ID of the response.
+   */
+  get id() {
+    return this._raw.id ?? void 0;
+  }
+  /**
+   * The model used to generate the response.
+   */
+  get model() {
+    return this._raw.model ?? void 0;
+  }
+};
 var TekimaxClient = class {
+  /**
+   * Creates a new TekimaxClient.
+   * 
+   * @param options - Configuration options for the client.
+   * @param options.baseUrl - The base URL of the API (default: "https://api.tekimax.com").
+   * @param options.apiKey - Your Tekimax API key.
+   * 
+   * @example
+   * const client = new TekimaxClient({ apiKey: "tm_..." });
+   */
   constructor(options = {}) {
     this.baseUrl = options.baseUrl || "https://api.tekimax.com";
     this.headers = {
@@ -1303,13 +1347,40 @@ var TekimaxClient = class {
     if (!response.ok) {
       throw new Error(`Tekimax API Error: ${response.status} ${response.statusText}`);
     }
-    return response.json();
+    const data = await response.json();
+    return new TekimaxResponse(data);
   }
-  async createSession(body) {
+  /**
+   * Creates a new session and sends the initial message.
+   * 
+   * @param message - The initial message text to start the session.
+   * @param options - Additional configuration options (model, temperature, etc.).
+   * 
+   * @example
+   * const response = await client.createSession("Hello, world!", { model: "gpt-4" });
+   * console.log(response.text);
+   */
+  async createSession(message, options) {
+    const body = {
+      ...options,
+      input: message
+    };
     return this.request("/responses", body);
   }
-  async sendMessage(body) {
-    return this.request("/responses", body);
+  /**
+   * Sends a message to an existing session or starts a new one if no previous_response_id is provided.
+   * 
+   * @param message - The message text to send.
+   * @param options - Additional configuration options.
+   * 
+   * @example
+   * const response = await client.sendMessage("What is the weather?", { 
+   *   previous_response_id: "resp_123" 
+   * });
+   * console.log(response.text);
+   */
+  async sendMessage(message, options) {
+    return this.createSession(message, options);
   }
 };
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tekimax-ts",
-    "version": "0.1.2",
+    "version": "0.1.3",
     "description": "Tekimax TypeScript SDK generated with Kubb",
     "main": "dist/index.js",
     "module": "dist/index.mjs",

package/src/client.ts

@@ -1,9 +1,72 @@
-import { CreateResponseBody, ResponseResource } from "./gen/types";
+import { CreateResponseBody, ResponseResource, OutputTextContentParam } from "./gen/types";
 
+/**
+ * A wrapper around the raw API response that provides helper methods
+ * for common tasks like extracting text content.
+ */
+export class TekimaxResponse {
+    constructor(private readonly _raw: ResponseResource) { }
+
+    /**
+     * Access the raw response object returned by the API.
+     */
+    get raw(): ResponseResource {
+        return this._raw;
+    }
+
+    /**
+     * Automatically extracts the text content from the response.
+     * It looks for the first "output_text" item in the response content.
+     */
+    get text(): string | undefined {
+        if (!this._raw.output) return undefined;
+
+        // Find the first output item that is of type 'output_text'
+        const textItem = this._raw.output.find(
+            (item): item is Extract<typeof item, { type: "output_text" }> =>
+                item.type === "output_text"
+        );
+
+        return textItem?.text;
+    }
+
+    /**
+     * The ID of the response.
+     */
+    get id(): string | undefined {
+        return this._raw.id ?? undefined;
+    }
+
+    /**
+     * The model used to generate the response.
+     */
+    get model(): string | undefined {
+        return this._raw.model ?? undefined;
+    }
+}
+
+/**
+ * Options for sending a message or creating a session.
+ */
+export type MessageOptions = Omit<CreateResponseBody, "input" | "stream">;
+
+/**
+ * The main client for interacting with the Tekimax API.
+ */
 export class TekimaxClient {
     private baseUrl: string;
     private headers: HeadersInit;
 
+    /**
+     * Creates a new TekimaxClient.
+     * 
+     * @param options - Configuration options for the client.
+     * @param options.baseUrl - The base URL of the API (default: "https://api.tekimax.com").
+     * @param options.apiKey - Your Tekimax API key.
+     * 
+     * @example
+     * const client = new TekimaxClient({ apiKey: "tm_..." });
+     */
     constructor(options: { baseUrl?: string; apiKey?: string } = {}) {
         this.baseUrl = options.baseUrl || "https://api.tekimax.com";
         this.headers = {
@@ -12,7 +75,7 @@ export class TekimaxClient {
         };
     }
 
-    private async request<T>(path: string, body: any): Promise<T> {
+    private async request(path: string, body: any): Promise<TekimaxResponse> {
         const response = await fetch(`${this.baseUrl}${path}`, {
             method: "POST",
             headers: this.headers,
@@ -23,14 +86,41 @@ export class TekimaxClient {
             throw new Error(`Tekimax API Error: ${response.status} ${response.statusText}`);
         }
 
-        return response.json() as Promise<T>;
+        const data = await response.json() as ResponseResource;
+        return new TekimaxResponse(data);
     }
 
-    async createSession(body: CreateResponseBody): Promise<ResponseResource> {
-        return this.request<ResponseResource>("/responses", body);
+    /**
+     * Creates a new session and sends the initial message.
+     * 
+     * @param message - The initial message text to start the session.
+     * @param options - Additional configuration options (model, temperature, etc.).
+     * 
+     * @example
+     * const response = await client.createSession("Hello, world!", { model: "gpt-4" });
+     * console.log(response.text);
+     */
+    async createSession(message: string, options?: MessageOptions): Promise<TekimaxResponse> {
+        const body: CreateResponseBody = {
+            ...options,
+            input: message,
+        };
+        return this.request("/responses", body);
     }
 
-    async sendMessage(body: CreateResponseBody): Promise<ResponseResource> {
-        return this.request<ResponseResource>("/responses", body);
+    /**
+     * Sends a message to an existing session or starts a new one if no previous_response_id is provided.
+     * 
+     * @param message - The message text to send.
+     * @param options - Additional configuration options.
+     * 
+     * @example
+     * const response = await client.sendMessage("What is the weather?", { 
+     *   previous_response_id: "resp_123" 
+     * });
+     * console.log(response.text);
+     */
+    async sendMessage(message: string, options?: MessageOptions): Promise<TekimaxResponse> {
+        return this.createSession(message, options);
     }
 }

package/src/index.ts

@@ -1,3 +1,3 @@
 export * from "./gen/types";
 export * from "./gen/zod";
-export { TekimaxClient } from "./client";
+export { TekimaxClient, TekimaxResponse } from "./client";