tracebeam-sdk 0.1.1 → 0.2.0

package/dist/{client-CaHega3m.d.mts → sdk-bh44OWR9.d.mts}

@@ -53,6 +53,8 @@ interface Event {
     tags: Tags;
     /** Additional context data */
     extra: Extra;
+    /** Request latency in milliseconds */
+    latency?: number;
 }
 /**
  * Options for capture methods
@@ -66,6 +68,8 @@ interface CaptureOptions {
     extra?: Extra;
     /** Custom timestamp (ISO 8601) */
     timestamp?: string;
+    /** Request latency in milliseconds */
+    latency?: number;
 }
 /**
  * Batch payload sent to Ingest API
@@ -97,111 +101,38 @@ interface TransportErrorResponse {
 type TransportResponse = TransportSuccessResponse | TransportErrorResponse;
 
 /**
- * TraceBeamSDK client for capturing and sending events
- *
- * @example
- * ```typescript
- * // Initialize from environment variables
- * const sdk = TraceBeamSDK.fromEnv();
- *
- * // Capture an exception
- * try {
- *   doSomething();
- * } catch (error) {
- *   sdk.captureException(error);
- * }
- *
- * // Capture a message
- * sdk.captureMessage('User signup completed', {
- *   level: 'info',
- *   tags: { feature: 'auth' }
- * });
- *
- * // Graceful shutdown
- * await sdk.close();
- * ```
+ * TraceBeamSDK client for capturing and sending events via OTLP
  */
 declare class TraceBeamSDK {
     private readonly config;
-    private readonly transport;
-    private readonly queue;
+    private provider;
+    private tracer;
+    private isInitialized;
     private globalTags;
     private globalExtra;
     private userId;
-    private isInitialized;
     /**
      * Create SDK instance from configuration
      */
     constructor(config: TraceBeamConfig);
-    /**
-     * Create SDK instance from environment variables
-     *
-     * Required env vars:
-     * - TRACEBEAM_API_KEY
-     * - TRACEBEAM_PROJECT_ID
-     *
-     * Optional env vars:
-     * - TRACEBEAM_ENVIRONMENT (default: 'development')
-     * - TRACEBEAM_ENDPOINT (default: 'https://ingest.tracebeam.io')
-     * - TRACEBEAM_BATCH_SIZE (default: 100)
-     * - TRACEBEAM_FLUSH_INTERVAL (default: 5000)
-     * - TRACEBEAM_HTTP_TIMEOUT (default: 10000)
-     * - TRACEBEAM_MAX_QUEUE_SIZE (default: 10000)
-     * - TRACEBEAM_SAMPLE_RATE (default: 1.0)
-     * - TRACEBEAM_DEBUG (default: false)
-     */
     static fromEnv(): TraceBeamSDK;
     /**
      * Capture an exception/error
-     * Returns immediately (non-blocking)
      */
-    captureException(error: Error | string, options?: CaptureOptions): void;
+    captureException(error: Error | string | unknown, options?: CaptureOptions): void;
     /**
-     * Capture a message/event
-     * Returns immediately (non-blocking)
+     * Capture a message
      */
     captureMessage(message: string, options?: CaptureOptions): void;
-    /**
-     * Set the current user ID
-     * Will be included in all subsequent events
-     */
     setUser(userId: string | null): void;
-    /**
-     * Set a global tag
-     * Will be included in all subsequent events
-     */
     setTag(key: string, value: string): void;
-    /**
-     * Set multiple global tags
-     * Will be included in all subsequent events
-     */
     setTags(tags: Tags): void;
-    /**
-     * Set global extra context
-     * Will be included in all subsequent events
-     */
     setExtra(key: string, value: unknown): void;
-    /**
-     * Set multiple global extra context values
-     */
     setExtras(extras: Extra): void;
-    /**
-     * Manually flush queued events
-     * Call this to ensure events are sent before process exit
-     */
     flush(): Promise<void>;
-    /**
-     * Graceful shutdown
-     * Flushes remaining events and stops background workers
-     */
     close(): Promise<void>;
-    /**
-     * Check if SDK is active and can capture events
-     */
     isActive(): boolean;
     private canCapture;
-    private createEventWithContext;
-    private handleFlush;
 }
 
-export { type CaptureOptions as C, type Event as E, type TraceBeamConfig as T, TraceBeamSDK as a, type EventLevel as b, type Tags as c, type Extra as d, type EventBatch as e, type TransportResponse as f, type TransportSuccessResponse as g, type TransportErrorResponse as h };
+export { type CaptureOptions as C, type EventLevel as E, type TraceBeamConfig as T, TraceBeamSDK as a, type Tags as b, type Extra as c, type Event as d, type EventBatch as e, type TransportSuccessResponse as f, type TransportErrorResponse as g, type TransportResponse as h };

package/dist/{client-CaHega3m.d.ts → sdk-bh44OWR9.d.ts}

@@ -53,6 +53,8 @@ interface Event {
     tags: Tags;
     /** Additional context data */
     extra: Extra;
+    /** Request latency in milliseconds */
+    latency?: number;
 }
 /**
  * Options for capture methods
@@ -66,6 +68,8 @@ interface CaptureOptions {
     extra?: Extra;
     /** Custom timestamp (ISO 8601) */
     timestamp?: string;
+    /** Request latency in milliseconds */
+    latency?: number;
 }
 /**
  * Batch payload sent to Ingest API
@@ -97,111 +101,38 @@ interface TransportErrorResponse {
 type TransportResponse = TransportSuccessResponse | TransportErrorResponse;
 
 /**
- * TraceBeamSDK client for capturing and sending events
- *
- * @example
- * ```typescript
- * // Initialize from environment variables
- * const sdk = TraceBeamSDK.fromEnv();
- *
- * // Capture an exception
- * try {
- *   doSomething();
- * } catch (error) {
- *   sdk.captureException(error);
- * }
- *
- * // Capture a message
- * sdk.captureMessage('User signup completed', {
- *   level: 'info',
- *   tags: { feature: 'auth' }
- * });
- *
- * // Graceful shutdown
- * await sdk.close();
- * ```
+ * TraceBeamSDK client for capturing and sending events via OTLP
  */
 declare class TraceBeamSDK {
     private readonly config;
-    private readonly transport;
-    private readonly queue;
+    private provider;
+    private tracer;
+    private isInitialized;
     private globalTags;
     private globalExtra;
     private userId;
-    private isInitialized;
     /**
      * Create SDK instance from configuration
      */
     constructor(config: TraceBeamConfig);
-    /**
-     * Create SDK instance from environment variables
-     *
-     * Required env vars:
-     * - TRACEBEAM_API_KEY
-     * - TRACEBEAM_PROJECT_ID
-     *
-     * Optional env vars:
-     * - TRACEBEAM_ENVIRONMENT (default: 'development')
-     * - TRACEBEAM_ENDPOINT (default: 'https://ingest.tracebeam.io')
-     * - TRACEBEAM_BATCH_SIZE (default: 100)
-     * - TRACEBEAM_FLUSH_INTERVAL (default: 5000)
-     * - TRACEBEAM_HTTP_TIMEOUT (default: 10000)
-     * - TRACEBEAM_MAX_QUEUE_SIZE (default: 10000)
-     * - TRACEBEAM_SAMPLE_RATE (default: 1.0)
-     * - TRACEBEAM_DEBUG (default: false)
-     */
     static fromEnv(): TraceBeamSDK;
     /**
      * Capture an exception/error
-     * Returns immediately (non-blocking)
      */
-    captureException(error: Error | string, options?: CaptureOptions): void;
+    captureException(error: Error | string | unknown, options?: CaptureOptions): void;
     /**
-     * Capture a message/event
-     * Returns immediately (non-blocking)
+     * Capture a message
      */
     captureMessage(message: string, options?: CaptureOptions): void;
-    /**
-     * Set the current user ID
-     * Will be included in all subsequent events
-     */
     setUser(userId: string | null): void;
-    /**
-     * Set a global tag
-     * Will be included in all subsequent events
-     */
     setTag(key: string, value: string): void;
-    /**
-     * Set multiple global tags
-     * Will be included in all subsequent events
-     */
     setTags(tags: Tags): void;
-    /**
-     * Set global extra context
-     * Will be included in all subsequent events
-     */
     setExtra(key: string, value: unknown): void;
-    /**
-     * Set multiple global extra context values
-     */
     setExtras(extras: Extra): void;
-    /**
-     * Manually flush queued events
-     * Call this to ensure events are sent before process exit
-     */
     flush(): Promise<void>;
-    /**
-     * Graceful shutdown
-     * Flushes remaining events and stops background workers
-     */
     close(): Promise<void>;
-    /**
-     * Check if SDK is active and can capture events
-     */
     isActive(): boolean;
     private canCapture;
-    private createEventWithContext;
-    private handleFlush;
 }
 
-export { type CaptureOptions as C, type Event as E, type TraceBeamConfig as T, TraceBeamSDK as a, type EventLevel as b, type Tags as c, type Extra as d, type EventBatch as e, type TransportResponse as f, type TransportSuccessResponse as g, type TransportErrorResponse as h };
+export { type CaptureOptions as C, type EventLevel as E, type TraceBeamConfig as T, TraceBeamSDK as a, type Tags as b, type Extra as c, type Event as d, type EventBatch as e, type TransportSuccessResponse as f, type TransportErrorResponse as g, type TransportResponse as h };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "tracebeam-sdk",
-    "version": "0.1.1",
+    "version": "0.2.0",
     "description": "Node.js SDK for TraceBeam API Observability Platform",
     "main": "dist/index.js",
     "module": "dist/index.js",
@@ -53,7 +53,7 @@
         "vitest": "^2.0.0"
     },
     "peerDependencies": {
-        "express": "^4.0.0 || ^5.0.0",
+        "express": "^5.2.1",
         "fastify": "^4.0.0 || ^5.0.0"
     },
     "peerDependenciesMeta": {
@@ -63,5 +63,14 @@
         "fastify": {
             "optional": true
         }
+    },
+    "dependencies": {
+        "@opentelemetry/api": "^1.9.0",
+        "@opentelemetry/auto-instrumentations-node": "^0.68.0",
+        "@opentelemetry/exporter-trace-otlp-http": "^0.210.0",
+        "@opentelemetry/resources": "^2.4.0",
+        "@opentelemetry/sdk-trace-node": "^2.4.0",
+        "@opentelemetry/semantic-conventions": "^1.39.0",
+        "@types/express": "^5.0.6"
     }
-}
+}