observa-sdk 0.0.1 → 0.0.3

package/README.md

@@ -15,6 +15,7 @@ npm install observa-sdk
 Get your API key by signing up at [https://app.observa.ai/signup](https://app.observa.ai/signup) (or your Observa API endpoint).
 
 The signup process automatically:
+
 - Creates your tenant account
 - Sets up a default "Production" project
 - Provisions your Tinybird token
@@ -53,12 +54,15 @@ const observa = init({
 });
 
 // Track AI interactions with simple wrapping
-const response = await observa.track(
-  { query: "What is the weather?" },
-  () => fetch("https://api.openai.com/v1/chat/completions", {
+const response = await observa.track({ query: "What is the weather?" }, () =>
+  fetch("https://api.openai.com/v1/chat/completions", {
     method: "POST",
-    headers: { /* ... */ },
-    body: JSON.stringify({ /* ... */ }),
+    headers: {
+      /* ... */
+    },
+    body: JSON.stringify({
+      /* ... */
+    }),
   })
 );
 ```
@@ -116,6 +120,7 @@ The SDK supports JWT-formatted API keys that encode tenant context:
 ```
 
 **JWT Structure**:
+
 - `tenantId` (required): Unique identifier for the tenant/organization
 - `projectId` (required): Project identifier within the tenant
 - `environment` (optional): `"dev"` or `"prod"` (defaults to `"dev"`)
@@ -163,6 +168,7 @@ Initialize the Observa SDK instance.
 Track an AI interaction.
 
 **Parameters**:
+
 - `event.query` (required): The user query/prompt
 - `event.context` (optional): Additional context
 - `event.model` (optional): Model identifier
@@ -172,6 +178,7 @@ Track an AI interaction.
 **Returns**: `Promise<Response>` (the original response, unmodified)
 
 **Example**:
+
 ```typescript
 const response = await observa.track(
   {
@@ -179,17 +186,18 @@ const response = await observa.track(
     model: "gpt-4",
     metadata: { userId: "123" },
   },
-  () => fetch("https://api.openai.com/v1/chat/completions", {
-    method: "POST",
-    headers: {
-      "Authorization": `Bearer ${openaiKey}`,
-      "Content-Type": "application/json",
-    },
-    body: JSON.stringify({
-      model: "gpt-4",
-      messages: [{ role: "user", content: "What is machine learning?" }],
-    }),
-  })
+  () =>
+    fetch("https://api.openai.com/v1/chat/completions", {
+      method: "POST",
+      headers: {
+        Authorization: `Bearer ${openaiKey}`,
+        "Content-Type": "application/json",
+      },
+      body: JSON.stringify({
+        model: "gpt-4",
+        messages: [{ role: "user", content: "What is machine learning?" }],
+      }),
+    })
 );
 ```
 
@@ -248,4 +256,3 @@ The entire onboarding process takes less than 5 minutes, and you can start track
 ## License
 
 MIT
-

package/dist/index.cjs

@@ -427,32 +427,55 @@ var Observa = class {
     }
     try {
       const url = `${this.apiUrl}/api/v1/traces/ingest`;
-      const response = await fetch(url, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${this.apiKey}`,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(trace)
-      });
-      if (!response.ok) {
-        const errorText = await response.text().catch(() => "Unknown error");
-        let errorJson;
-        try {
-          errorJson = JSON.parse(errorText);
-        } catch {
-          errorJson = { error: errorText };
+      console.log(`[Observa] Sending trace - URL: ${url}, TraceID: ${trace.traceId}, Tenant: ${trace.tenantId}, Project: ${trace.projectId}, APIKey: ${this.apiKey ? `Yes(${this.apiKey.length} chars)` : "No"}`);
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 1e4);
+      try {
+        const response = await fetch(url, {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(trace),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        console.log(`[Observa] Response status: ${response.status} ${response.statusText}`);
+        if (!response.ok) {
+          const errorText = await response.text().catch(() => "Unknown error");
+          let errorJson;
+          try {
+            errorJson = JSON.parse(errorText);
+          } catch {
+            errorJson = { error: errorText };
+          }
+          console.error(
+            `[Observa] Backend API error: ${response.status} ${response.statusText}`,
+            errorJson.error || errorText
+          );
+        } else {
+          console.log(`\u2705 [Observa] Trace sent successfully - Trace ID: ${trace.traceId}`);
         }
-        console.error(
-          `[Observa] Backend API error: ${response.status} ${response.statusText}`,
-          errorJson.error || errorText
-        );
-      } else if (!this.isProduction) {
-        console.log(`\u2705 [Observa] Trace sent successfully`);
-        console.log(`   Trace ID: ${trace.traceId}`);
+      } catch (fetchError) {
+        clearTimeout(timeoutId);
+        if (fetchError instanceof Error && fetchError.name === "AbortError") {
+          console.error("[Observa] Request timeout after 10 seconds");
+        }
+        throw fetchError;
       }
     } catch (error) {
       console.error("[Observa] Failed to send trace:", error);
+      if (error instanceof Error) {
+        console.error("[Observa] Error message:", error.message);
+        console.error("[Observa] Error name:", error.name);
+        if (error.name === "AbortError") {
+          console.error("[Observa] Request timed out - check network connectivity and API URL");
+        }
+        if (error.stack) {
+          console.error("[Observa] Error stack:", error.stack);
+        }
+      }
     }
   }
 };

package/dist/index.js

@@ -402,32 +402,55 @@ var Observa = class {
     }
     try {
       const url = `${this.apiUrl}/api/v1/traces/ingest`;
-      const response = await fetch(url, {
-        method: "POST",
-        headers: {
-          Authorization: `Bearer ${this.apiKey}`,
-          "Content-Type": "application/json"
-        },
-        body: JSON.stringify(trace)
-      });
-      if (!response.ok) {
-        const errorText = await response.text().catch(() => "Unknown error");
-        let errorJson;
-        try {
-          errorJson = JSON.parse(errorText);
-        } catch {
-          errorJson = { error: errorText };
+      console.log(`[Observa] Sending trace - URL: ${url}, TraceID: ${trace.traceId}, Tenant: ${trace.tenantId}, Project: ${trace.projectId}, APIKey: ${this.apiKey ? `Yes(${this.apiKey.length} chars)` : "No"}`);
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 1e4);
+      try {
+        const response = await fetch(url, {
+          method: "POST",
+          headers: {
+            Authorization: `Bearer ${this.apiKey}`,
+            "Content-Type": "application/json"
+          },
+          body: JSON.stringify(trace),
+          signal: controller.signal
+        });
+        clearTimeout(timeoutId);
+        console.log(`[Observa] Response status: ${response.status} ${response.statusText}`);
+        if (!response.ok) {
+          const errorText = await response.text().catch(() => "Unknown error");
+          let errorJson;
+          try {
+            errorJson = JSON.parse(errorText);
+          } catch {
+            errorJson = { error: errorText };
+          }
+          console.error(
+            `[Observa] Backend API error: ${response.status} ${response.statusText}`,
+            errorJson.error || errorText
+          );
+        } else {
+          console.log(`\u2705 [Observa] Trace sent successfully - Trace ID: ${trace.traceId}`);
         }
-        console.error(
-          `[Observa] Backend API error: ${response.status} ${response.statusText}`,
-          errorJson.error || errorText
-        );
-      } else if (!this.isProduction) {
-        console.log(`\u2705 [Observa] Trace sent successfully`);
-        console.log(`   Trace ID: ${trace.traceId}`);
+      } catch (fetchError) {
+        clearTimeout(timeoutId);
+        if (fetchError instanceof Error && fetchError.name === "AbortError") {
+          console.error("[Observa] Request timeout after 10 seconds");
+        }
+        throw fetchError;
       }
     } catch (error) {
       console.error("[Observa] Failed to send trace:", error);
+      if (error instanceof Error) {
+        console.error("[Observa] Error message:", error.message);
+        console.error("[Observa] Error name:", error.name);
+        if (error.name === "AbortError") {
+          console.error("[Observa] Request timed out - check network connectivity and API URL");
+        }
+        if (error.stack) {
+          console.error("[Observa] Error stack:", error.stack);
+        }
+      }
     }
   }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "observa-sdk",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Enterprise-grade observability SDK for AI applications. Track and monitor LLM interactions with zero friction.",
   "type": "module",
   "main": "./dist/index.cjs",