@runtimescope/server-sdk 0.6.1 → 0.7.0

package/dist/index.d.cts

@@ -69,6 +69,8 @@ interface PerformanceEvent {
 type ServerRuntimeEvent = DatabaseEvent | ConsoleEvent | NetworkEvent | PerformanceEvent;
 interface ServerSdkConfig {
     serverUrl?: string;
+    /** Alias for serverUrl — matches the browser SDK's config */
+    endpoint?: string;
     appName?: string;
     sessionId?: string;
     /** API key for authenticated connections to the collector */
@@ -89,6 +91,12 @@ interface ServerSdkConfig {
     sampleRate?: number;
     maxEventsPerSecond?: number;
     maxQueueSize?: number;
+    /** Transport type: 'ws' (WebSocket, default) or 'http' (HTTP POST for serverless) */
+    transport?: 'ws' | 'http';
+    /** HTTP endpoint URL for HTTP transport (e.g., 'http://collector:9091/api/events') */
+    httpEndpoint?: string;
+    /** HTTP batch flush interval in ms (default: 1000) */
+    httpFlushIntervalMs?: number;
 }
 
 type EmitFn = (event: NetworkEvent) => void;
@@ -160,12 +168,46 @@ declare class Sampler {
     reset(): void;
 }
 
+interface HttpTransportOptions {
+    url: string;
+    sessionId: string;
+    appName: string;
+    sdkVersion: string;
+    authToken?: string;
+    maxQueueSize?: number;
+    flushIntervalMs?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+}
+declare class HttpTransport {
+    private queue;
+    private url;
+    private sessionId;
+    private appName;
+    private sdkVersion;
+    private authToken;
+    private maxQueueSize;
+    private maxRetries;
+    private retryDelayMs;
+    private flushTimer;
+    private _droppedCount;
+    private sessionRegistered;
+    constructor(options: HttpTransportOptions);
+    get droppedCount(): number;
+    sendEvent(event: ServerRuntimeEvent): void;
+    flush(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+
 declare class RuntimeScopeServer {
     private transport;
+    private httpTransport;
     private sessionId;
     private config;
     private sampler;
     private restoreFunctions;
+    /** Alias for `connect` — mirrors the browser SDK's init() API */
+    init(config?: ServerSdkConfig): void;
     connect(config?: ServerSdkConfig): void;
     disconnect(): void;
     get currentSessionId(): string;
@@ -183,4 +225,4 @@ declare class RuntimeScopeServer {
 }
 declare const RuntimeScope: RuntimeScopeServer;
 
-export { type ConsoleEvent, type DatabaseEvent, type MetricUnit, type NetworkEvent, type PerformanceEvent, RuntimeScope, Sampler, type ServerMetricName, type ServerRuntimeEvent, type ServerSdkConfig, _log, generateId, generateSessionId, getRequestContext, getSessionId, normalizeQuery, parseOperation, parseTablesAccessed, redactParams, runWithContext, runtimeScopeMiddleware };
+export { type ConsoleEvent, type DatabaseEvent, HttpTransport, type HttpTransportOptions, type MetricUnit, type NetworkEvent, type PerformanceEvent, RuntimeScope, Sampler, type ServerMetricName, type ServerRuntimeEvent, type ServerSdkConfig, _log, generateId, generateSessionId, getRequestContext, getSessionId, normalizeQuery, parseOperation, parseTablesAccessed, redactParams, runWithContext, runtimeScopeMiddleware };

package/dist/index.d.ts

@@ -69,6 +69,8 @@ interface PerformanceEvent {
 type ServerRuntimeEvent = DatabaseEvent | ConsoleEvent | NetworkEvent | PerformanceEvent;
 interface ServerSdkConfig {
     serverUrl?: string;
+    /** Alias for serverUrl — matches the browser SDK's config */
+    endpoint?: string;
     appName?: string;
     sessionId?: string;
     /** API key for authenticated connections to the collector */
@@ -89,6 +91,12 @@ interface ServerSdkConfig {
     sampleRate?: number;
     maxEventsPerSecond?: number;
     maxQueueSize?: number;
+    /** Transport type: 'ws' (WebSocket, default) or 'http' (HTTP POST for serverless) */
+    transport?: 'ws' | 'http';
+    /** HTTP endpoint URL for HTTP transport (e.g., 'http://collector:9091/api/events') */
+    httpEndpoint?: string;
+    /** HTTP batch flush interval in ms (default: 1000) */
+    httpFlushIntervalMs?: number;
 }
 
 type EmitFn = (event: NetworkEvent) => void;
@@ -160,12 +168,46 @@ declare class Sampler {
     reset(): void;
 }
 
+interface HttpTransportOptions {
+    url: string;
+    sessionId: string;
+    appName: string;
+    sdkVersion: string;
+    authToken?: string;
+    maxQueueSize?: number;
+    flushIntervalMs?: number;
+    maxRetries?: number;
+    retryDelayMs?: number;
+}
+declare class HttpTransport {
+    private queue;
+    private url;
+    private sessionId;
+    private appName;
+    private sdkVersion;
+    private authToken;
+    private maxQueueSize;
+    private maxRetries;
+    private retryDelayMs;
+    private flushTimer;
+    private _droppedCount;
+    private sessionRegistered;
+    constructor(options: HttpTransportOptions);
+    get droppedCount(): number;
+    sendEvent(event: ServerRuntimeEvent): void;
+    flush(): Promise<void>;
+    disconnect(): Promise<void>;
+}
+
 declare class RuntimeScopeServer {
     private transport;
+    private httpTransport;
     private sessionId;
     private config;
     private sampler;
     private restoreFunctions;
+    /** Alias for `connect` — mirrors the browser SDK's init() API */
+    init(config?: ServerSdkConfig): void;
     connect(config?: ServerSdkConfig): void;
     disconnect(): void;
     get currentSessionId(): string;
@@ -183,4 +225,4 @@ declare class RuntimeScopeServer {
 }
 declare const RuntimeScope: RuntimeScopeServer;
 
-export { type ConsoleEvent, type DatabaseEvent, type MetricUnit, type NetworkEvent, type PerformanceEvent, RuntimeScope, Sampler, type ServerMetricName, type ServerRuntimeEvent, type ServerSdkConfig, _log, generateId, generateSessionId, getRequestContext, getSessionId, normalizeQuery, parseOperation, parseTablesAccessed, redactParams, runWithContext, runtimeScopeMiddleware };
+export { type ConsoleEvent, type DatabaseEvent, HttpTransport, type HttpTransportOptions, type MetricUnit, type NetworkEvent, type PerformanceEvent, RuntimeScope, Sampler, type ServerMetricName, type ServerRuntimeEvent, type ServerSdkConfig, _log, generateId, generateSessionId, getRequestContext, getSessionId, normalizeQuery, parseOperation, parseTablesAccessed, redactParams, runWithContext, runtimeScopeMiddleware };

package/dist/index.js

@@ -128,6 +128,94 @@ var ServerTransport = class {
   }
 };
 
+// src/http-transport.ts
+var HttpTransport = class {
+  queue = [];
+  url;
+  sessionId;
+  appName;
+  sdkVersion;
+  authToken;
+  maxQueueSize;
+  maxRetries;
+  retryDelayMs;
+  flushTimer = null;
+  _droppedCount = 0;
+  sessionRegistered = false;
+  constructor(options) {
+    this.url = options.url;
+    this.sessionId = options.sessionId;
+    this.appName = options.appName;
+    this.sdkVersion = options.sdkVersion;
+    this.authToken = options.authToken;
+    this.maxQueueSize = options.maxQueueSize ?? 1e4;
+    this.maxRetries = options.maxRetries ?? 2;
+    this.retryDelayMs = options.retryDelayMs ?? 500;
+    const intervalMs = options.flushIntervalMs ?? 1e3;
+    this.flushTimer = setInterval(() => this.flush(), intervalMs);
+    if (this.flushTimer && typeof this.flushTimer === "object" && "unref" in this.flushTimer) {
+      this.flushTimer.unref();
+    }
+  }
+  get droppedCount() {
+    return this._droppedCount;
+  }
+  sendEvent(event) {
+    if (this.queue.length >= this.maxQueueSize) {
+      this.queue.shift();
+      this._droppedCount++;
+    }
+    this.queue.push(event);
+  }
+  async flush() {
+    if (this.queue.length === 0) return;
+    const batch = this.queue.splice(0);
+    const payload = {
+      sessionId: this.sessionId,
+      events: batch
+    };
+    if (!this.sessionRegistered) {
+      payload.appName = this.appName;
+      payload.sdkVersion = this.sdkVersion;
+    }
+    const body = JSON.stringify(payload);
+    for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+      try {
+        const headers = {
+          "Content-Type": "application/json"
+        };
+        if (this.authToken) {
+          headers["Authorization"] = `Bearer ${this.authToken}`;
+        }
+        const response = await fetch(this.url, {
+          method: "POST",
+          headers,
+          body,
+          signal: AbortSignal.timeout(5e3)
+        });
+        if (response.ok) {
+          this.sessionRegistered = true;
+          return;
+        }
+        if (response.status === 401 || response.status === 400) {
+          return;
+        }
+      } catch {
+      }
+      if (attempt < this.maxRetries) {
+        await new Promise((r) => setTimeout(r, this.retryDelayMs));
+      }
+    }
+  }
+  async disconnect() {
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+      this.flushTimer = null;
+    }
+    await this.flush();
+  }
+};
+
 // src/utils/id.ts
 import { randomBytes } from "crypto";
 function generateId() {
@@ -1351,26 +1439,51 @@ function runtimeScopeMiddleware(emit, sessionId, options) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.6.1";
+var SDK_VERSION = "0.7.0";
 var RuntimeScopeServer = class {
   transport = null;
+  httpTransport = null;
   sessionId = "";
   config = {};
   sampler = null;
   restoreFunctions = [];
+  /** Alias for `connect` — mirrors the browser SDK's init() API */
+  init(config = {}) {
+    return this.connect(config);
+  }
   connect(config = {}) {
     this.config = config;
     this.sessionId = config.sessionId ?? generateSessionId();
-    const serverUrl = config.serverUrl ?? "ws://127.0.0.1:9090";
-    this.transport = new ServerTransport({
-      url: serverUrl,
-      sessionId: this.sessionId,
-      appName: config.appName ?? "server-app",
-      sdkVersion: SDK_VERSION,
-      authToken: config.authToken,
-      maxQueueSize: config.maxQueueSize
-    });
-    this.transport.connect();
+    const serverUrl = config.serverUrl ?? config.endpoint ?? "ws://127.0.0.1:9090";
+    if (config.transport === "http") {
+      let httpUrl = config.httpEndpoint;
+      if (!httpUrl) {
+        const wsUrl = new URL(serverUrl);
+        wsUrl.protocol = wsUrl.protocol === "wss:" ? "https:" : "http:";
+        wsUrl.port = "9091";
+        wsUrl.pathname = "/api/events";
+        httpUrl = wsUrl.toString();
+      }
+      this.httpTransport = new HttpTransport({
+        url: httpUrl,
+        sessionId: this.sessionId,
+        appName: config.appName ?? "server-app",
+        sdkVersion: SDK_VERSION,
+        authToken: config.authToken,
+        maxQueueSize: config.maxQueueSize,
+        flushIntervalMs: config.httpFlushIntervalMs
+      });
+    } else {
+      this.transport = new ServerTransport({
+        url: serverUrl,
+        sessionId: this.sessionId,
+        appName: config.appName ?? "server-app",
+        sdkVersion: SDK_VERSION,
+        authToken: config.authToken,
+        maxQueueSize: config.maxQueueSize
+      });
+      this.transport.connect();
+    }
     if (config.sampleRate !== void 0 || config.maxEventsPerSecond !== void 0) {
       this.sampler = new Sampler({
         sampleRate: config.sampleRate,
@@ -1399,7 +1512,7 @@ var RuntimeScopeServer = class {
       } catch {
       }
     }
-    if (config.captureHttp) {
+    if (config.captureHttp !== false) {
       try {
         this.restoreFunctions.push(
           interceptHttp(emit, this.sessionId, {
@@ -1407,14 +1520,17 @@ var RuntimeScopeServer = class {
             maxBodySize: config.maxBodySize,
             redactHeaders: config.redactHeaders,
             // Auto-ignore the collector URL to prevent recursion
-            ignoreUrls: [serverUrl.replace("ws://", "").replace("wss://", "")],
+            ignoreUrls: [
+              serverUrl.replace("ws://", "").replace("wss://", ""),
+              ...config.httpEndpoint ? [config.httpEndpoint.replace(/^https?:\/\//, "")] : []
+            ],
             beforeSend: config.beforeSend
           })
         );
       } catch {
       }
     }
-    if (config.capturePerformance) {
+    if (config.capturePerformance !== false) {
       try {
         this.restoreFunctions.push(
           startPerfMetrics(emit, this.sessionId, {
@@ -1435,6 +1551,10 @@ var RuntimeScopeServer = class {
     }
     this.restoreFunctions = [];
     this.sampler = null;
+    if (this.httpTransport) {
+      this.httpTransport.disconnect();
+      this.httpTransport = null;
+    }
     this.transport?.disconnect();
     this.transport = null;
   }
@@ -1443,12 +1563,12 @@ var RuntimeScopeServer = class {
   }
   emitEvent(event) {
     if (this.sampler && !this.sampler.shouldSample(event)) return;
-    if (this.config.beforeSend) {
-      const filtered = this.config.beforeSend(event);
-      if (!filtered) return;
-      this.transport?.sendEvent(filtered);
+    const filtered = this.config.beforeSend ? this.config.beforeSend(event) : event;
+    if (!filtered) return;
+    if (this.httpTransport) {
+      this.httpTransport.sendEvent(filtered);
     } else {
-      this.transport?.sendEvent(event);
+      this.transport?.sendEvent(filtered);
     }
   }
   // --- Express/Connect Middleware ---
@@ -1569,6 +1689,7 @@ var RuntimeScopeServer = class {
 };
 var RuntimeScope = new RuntimeScopeServer();
 export {
+  HttpTransport,
   RuntimeScope,
   Sampler,
   _log,