observa-sdk 0.0.1 → 0.0.2

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,6 +427,10 @@ var Observa = class {
     }
     try {
       const url = `${this.apiUrl}/api/v1/traces/ingest`;
+      console.log(`[Observa] Sending trace to: ${url}`);
+      console.log(`[Observa] Trace ID: ${trace.traceId}`);
+      console.log(`[Observa] Tenant: ${trace.tenantId}, Project: ${trace.projectId}`);
+      console.log(`[Observa] API Key present: ${this.apiKey ? "Yes" : "No"} (length: ${this.apiKey?.length || 0})`);
       const response = await fetch(url, {
         method: "POST",
         headers: {
@@ -435,6 +439,7 @@ var Observa = class {
         },
         body: JSON.stringify(trace)
       });
+      console.log(`[Observa] Response status: ${response.status} ${response.statusText}`);
       if (!response.ok) {
         const errorText = await response.text().catch(() => "Unknown error");
         let errorJson;
@@ -447,12 +452,18 @@ var Observa = class {
           `[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}`);
+      } else {
+        console.log(`\u2705 [Observa] Trace sent successfully - Trace ID: ${trace.traceId}`);
       }
     } 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.stack) {
+          console.error("[Observa] Error stack:", error.stack);
+        }
+      }
     }
   }
 };

package/dist/index.js

@@ -402,6 +402,10 @@ var Observa = class {
     }
     try {
       const url = `${this.apiUrl}/api/v1/traces/ingest`;
+      console.log(`[Observa] Sending trace to: ${url}`);
+      console.log(`[Observa] Trace ID: ${trace.traceId}`);
+      console.log(`[Observa] Tenant: ${trace.tenantId}, Project: ${trace.projectId}`);
+      console.log(`[Observa] API Key present: ${this.apiKey ? "Yes" : "No"} (length: ${this.apiKey?.length || 0})`);
       const response = await fetch(url, {
         method: "POST",
         headers: {
@@ -410,6 +414,7 @@ var Observa = class {
         },
         body: JSON.stringify(trace)
       });
+      console.log(`[Observa] Response status: ${response.status} ${response.statusText}`);
       if (!response.ok) {
         const errorText = await response.text().catch(() => "Unknown error");
         let errorJson;
@@ -422,12 +427,18 @@ var Observa = class {
           `[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}`);
+      } else {
+        console.log(`\u2705 [Observa] Trace sent successfully - Trace ID: ${trace.traceId}`);
       }
     } 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.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.2",
   "description": "Enterprise-grade observability SDK for AI applications. Track and monitor LLM interactions with zero friction.",
   "type": "module",
   "main": "./dist/index.cjs",