@visibe.ai/node 0.1.7 → 0.1.9

package/dist/cjs/api.js

@@ -12,6 +12,35 @@ class APIClient {
         if (!this._enabled) {
             process.emitWarning('[Visibe] No API key provided — tracing is disabled. Set VISIBE_API_KEY or pass apiKey= to enable.', { type: 'VisibleSDKWarning', code: 'VISIBE_NO_API_KEY' });
         }
+        else if (options.apiKey &&
+            !options.apiKey.startsWith('sk_live_') &&
+            !options.apiKey.startsWith('sk_test_')) {
+            process.emitWarning('[Visibe] API key format unrecognized (expected sk_live_* or sk_test_*).', { type: 'VisibleSDKWarning', code: 'VISIBE_INVALID_KEY_FORMAT' });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // validateKey() — called once at startup in the background.
+    // Hits GET /api/auth/validate with the API key.
+    // On 401 (invalid/revoked key): disables tracing and prints a clear warning.
+    // On network error or non-401 failure: stays enabled (lenient — don't punish
+    // users for flaky networks at startup).
+    // ---------------------------------------------------------------------------
+    async validateKey() {
+        try {
+            const response = await fetch(`${this.apiUrl}/api/auth/validate`, {
+                method: 'GET',
+                headers: { 'Authorization': `Bearer ${this.apiKey}` },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (response.status === 401) {
+                this._enabled = false;
+                process.emitWarning('[Visibe] Invalid API key — tracing is disabled. Check your VISIBE_API_KEY.', { type: 'VisibleSDKWarning', code: 'VISIBE_INVALID_API_KEY' });
+            }
+            // 200 → valid, stay enabled. Other status codes → lenient, stay enabled.
+        }
+        catch {
+            // Network error / timeout → lenient, stay enabled.
+        }
     }
     async _request(method, path, body) {
         if (!this._enabled)

package/dist/cjs/client.js

@@ -20,6 +20,13 @@ class Visibe {
         this.debug = debug;
         this.apiClient = new api_1.APIClient({ apiKey, apiUrl });
         this.batcher = new api_1.SpanBatcher(this.apiClient);
+        // Fire-and-forget background key validation.
+        // Runs ~80ms after startup — well before the 2s batcher flush window.
+        // On invalid key: disables tracing and prints a warning.
+        // On network error: stays enabled (lenient).
+        if (this.apiClient._enabled) {
+            this.apiClient.validateKey().catch(() => { });
+        }
     }
     // ---------------------------------------------------------------------------
     // instrument() — wrap a client so each call creates its own trace.

package/dist/cjs/index.js

@@ -53,7 +53,7 @@ function patchFramework(framework, client) {
             case 'openai': {
                 const openaiModule = require('openai');
                 _originalOpenAI = openaiModule.OpenAI;
-                openaiModule.OpenAI = class extends _originalOpenAI {
+                const PatchedOpenAI = class extends _originalOpenAI {
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     constructor(...args) {
                         super(...args);
@@ -63,12 +63,16 @@ function patchFramework(framework, client) {
                         catch { /* never crash new OpenAI() */ }
                     }
                 };
+                openaiModule.OpenAI = PatchedOpenAI;
+                // Also patch .default so that `import OpenAI from 'openai'` (esModuleInterop)
+                // picks up the instrumented class — TypeScript compiles default imports to .default.
+                openaiModule.default = PatchedOpenAI;
                 break;
             }
             case 'anthropic': {
                 const anthropicModule = require('@anthropic-ai/sdk');
                 _originalAnthropic = anthropicModule.Anthropic;
-                anthropicModule.Anthropic = class extends _originalAnthropic {
+                const PatchedAnthropic = class extends _originalAnthropic {
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     constructor(...args) {
                         super(...args);
@@ -78,6 +82,9 @@ function patchFramework(framework, client) {
                         catch { /* never crash new Anthropic() */ }
                     }
                 };
+                anthropicModule.Anthropic = PatchedAnthropic;
+                // Also patch .default for esModuleInterop default import support.
+                anthropicModule.default = PatchedAnthropic;
                 break;
             }
             case 'bedrock': {
@@ -173,6 +180,7 @@ async function shutdown() {
     try {
         if (_originalOpenAI) {
             require('openai').OpenAI = _originalOpenAI;
+            require('openai').default = _originalOpenAI;
             _originalOpenAI = null;
         }
     }
@@ -180,6 +188,7 @@ async function shutdown() {
     try {
         if (_originalAnthropic) {
             require('@anthropic-ai/sdk').Anthropic = _originalAnthropic;
+            require('@anthropic-ai/sdk').default = _originalAnthropic;
             _originalAnthropic = null;
         }
     }

package/dist/esm/api.js

@@ -9,6 +9,35 @@ export class APIClient {
         if (!this._enabled) {
             process.emitWarning('[Visibe] No API key provided — tracing is disabled. Set VISIBE_API_KEY or pass apiKey= to enable.', { type: 'VisibleSDKWarning', code: 'VISIBE_NO_API_KEY' });
         }
+        else if (options.apiKey &&
+            !options.apiKey.startsWith('sk_live_') &&
+            !options.apiKey.startsWith('sk_test_')) {
+            process.emitWarning('[Visibe] API key format unrecognized (expected sk_live_* or sk_test_*).', { type: 'VisibleSDKWarning', code: 'VISIBE_INVALID_KEY_FORMAT' });
+        }
+    }
+    // ---------------------------------------------------------------------------
+    // validateKey() — called once at startup in the background.
+    // Hits GET /api/auth/validate with the API key.
+    // On 401 (invalid/revoked key): disables tracing and prints a clear warning.
+    // On network error or non-401 failure: stays enabled (lenient — don't punish
+    // users for flaky networks at startup).
+    // ---------------------------------------------------------------------------
+    async validateKey() {
+        try {
+            const response = await fetch(`${this.apiUrl}/api/auth/validate`, {
+                method: 'GET',
+                headers: { 'Authorization': `Bearer ${this.apiKey}` },
+                signal: AbortSignal.timeout(5000),
+            });
+            if (response.status === 401) {
+                this._enabled = false;
+                process.emitWarning('[Visibe] Invalid API key — tracing is disabled. Check your VISIBE_API_KEY.', { type: 'VisibleSDKWarning', code: 'VISIBE_INVALID_API_KEY' });
+            }
+            // 200 → valid, stay enabled. Other status codes → lenient, stay enabled.
+        }
+        catch {
+            // Network error / timeout → lenient, stay enabled.
+        }
     }
     async _request(method, path, body) {
         if (!this._enabled)

package/dist/esm/client.js

@@ -17,6 +17,13 @@ export class Visibe {
         this.debug = debug;
         this.apiClient = new APIClient({ apiKey, apiUrl });
         this.batcher = new SpanBatcher(this.apiClient);
+        // Fire-and-forget background key validation.
+        // Runs ~80ms after startup — well before the 2s batcher flush window.
+        // On invalid key: disables tracing and prints a warning.
+        // On network error: stays enabled (lenient).
+        if (this.apiClient._enabled) {
+            this.apiClient.validateKey().catch(() => { });
+        }
     }
     // ---------------------------------------------------------------------------
     // instrument() — wrap a client so each call creates its own trace.

package/dist/esm/index.js

@@ -47,7 +47,7 @@ function patchFramework(framework, client) {
             case 'openai': {
                 const openaiModule = require('openai');
                 _originalOpenAI = openaiModule.OpenAI;
-                openaiModule.OpenAI = class extends _originalOpenAI {
+                const PatchedOpenAI = class extends _originalOpenAI {
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     constructor(...args) {
                         super(...args);
@@ -57,12 +57,16 @@ function patchFramework(framework, client) {
                         catch { /* never crash new OpenAI() */ }
                     }
                 };
+                openaiModule.OpenAI = PatchedOpenAI;
+                // Also patch .default so that `import OpenAI from 'openai'` (esModuleInterop)
+                // picks up the instrumented class — TypeScript compiles default imports to .default.
+                openaiModule.default = PatchedOpenAI;
                 break;
             }
             case 'anthropic': {
                 const anthropicModule = require('@anthropic-ai/sdk');
                 _originalAnthropic = anthropicModule.Anthropic;
-                anthropicModule.Anthropic = class extends _originalAnthropic {
+                const PatchedAnthropic = class extends _originalAnthropic {
                     // eslint-disable-next-line @typescript-eslint/no-explicit-any
                     constructor(...args) {
                         super(...args);
@@ -72,6 +76,9 @@ function patchFramework(framework, client) {
                         catch { /* never crash new Anthropic() */ }
                     }
                 };
+                anthropicModule.Anthropic = PatchedAnthropic;
+                // Also patch .default for esModuleInterop default import support.
+                anthropicModule.default = PatchedAnthropic;
                 break;
             }
             case 'bedrock': {
@@ -167,6 +174,7 @@ export async function shutdown() {
     try {
         if (_originalOpenAI) {
             require('openai').OpenAI = _originalOpenAI;
+            require('openai').default = _originalOpenAI;
             _originalOpenAI = null;
         }
     }
@@ -174,6 +182,7 @@ export async function shutdown() {
     try {
         if (_originalAnthropic) {
             require('@anthropic-ai/sdk').Anthropic = _originalAnthropic;
+            require('@anthropic-ai/sdk').default = _originalAnthropic;
             _originalAnthropic = null;
         }
     }

package/dist/types/api.d.ts

@@ -2,12 +2,13 @@ export declare class APIClient {
     readonly apiUrl: string;
     private readonly apiKey;
     private readonly timeout;
-    readonly _enabled: boolean;
+    _enabled: boolean;
     constructor(options: {
         apiUrl?: string;
         apiKey?: string;
         timeout?: number;
     });
+    validateKey(): Promise<void>;
     private _request;
     createTrace(data: object): Promise<boolean>;
     sendSpan(traceId: string, span: object): Promise<boolean>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visibe.ai/node",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "AI Agent Observability — Track OpenAI, LangChain, LangGraph, Bedrock, Vercel AI, Anthropic",
   "main": "dist/cjs/index.js",
   "module": "dist/esm/index.js",