@getlimelight/sdk 0.4.1 → 0.4.2

package/dist/index.d.mts

@@ -470,6 +470,26 @@ interface ParsedStackTrace {
     raw: string;
 }
 
+interface RequestBridgeConfig {
+    url: string;
+    method?: HttpMethod | string;
+    headers?: Record<string, string>;
+    body?: any;
+    name?: string;
+    graphql?: {
+        operationName?: string;
+        operationType?: GraphqlOprtation | "query" | "mutation" | "subscription";
+        variables?: any;
+        query?: string;
+    };
+}
+interface ResponseBridgeConfig {
+    status: number;
+    statusText?: string;
+    headers?: Record<string, string>;
+    body?: any;
+}
+
 declare class LimelightClient {
     private ws;
     private config;
@@ -485,6 +505,7 @@ declare class LimelightClient {
     private consoleInterceptor;
     private renderInterceptor;
     private stateInterceptor;
+    private requestBridge;
     constructor();
     /**
      * Configures the Limelight client with the provided settings.
@@ -545,6 +566,29 @@ declare class LimelightClient {
      * @returns {void}
      */
     reset(): void;
+    /**
+     * Manually register a request with Limelight.
+     * Use this when your app makes network requests outside of fetch/XHR
+     * (e.g., through native modules).
+     *
+     * @param config - Request configuration
+     * @returns A request ID to use with endRequest() or failRequest()
+     */
+    startRequest(config: RequestBridgeConfig): string;
+    /**
+     * Complete a manually tracked request with a successful response.
+     *
+     * @param requestId - The ID returned from startRequest()
+     * @param response - Response data
+     */
+    endRequest(requestId: string, response: ResponseBridgeConfig): void;
+    /**
+     * Complete a manually tracked request with an error.
+     *
+     * @param requestId - The ID returned from startRequest()
+     * @param error - The error that occurred
+     */
+    failRequest(requestId: string, error: Error | string): void;
 }
 declare const Limelight: LimelightClient;
 
@@ -562,4 +606,4 @@ declare global {
     }
 }
 
-export { type BaseNetworkEvent, BodyFormat, type ConnectEvent, type ConnectionEvent, type ConsoleEvent, ConsoleLevel, ConsoleSource, ConsoleType, EventType, type GraphQLRequest, type GraphQLResponse, GraphqlOprtation, HttpMethod, HttpStatusClass, Limelight, type LimelightConfig, type LimelightEvent, type LimelightMessage, type NetworkErrorEvent, type NetworkEvent, NetworkPhase, type NetworkRequest, type NetworkRequestWithResponse, type NetworkResponse, NetworkType, type ParsedStackTrace, type SerializedBody, type Session, type StackFrame };
+export { type BaseNetworkEvent, BodyFormat, type ConnectEvent, type ConnectionEvent, type ConsoleEvent, ConsoleLevel, ConsoleSource, ConsoleType, EventType, type GraphQLRequest, type GraphQLResponse, GraphqlOprtation, HttpMethod, HttpStatusClass, Limelight, type LimelightConfig, type LimelightEvent, type LimelightMessage, type NetworkErrorEvent, type NetworkEvent, NetworkPhase, type NetworkRequest, type NetworkRequestWithResponse, type NetworkResponse, NetworkType, type ParsedStackTrace, type RequestBridgeConfig, type ResponseBridgeConfig, type SerializedBody, type Session, type StackFrame };

package/dist/index.d.ts

@@ -470,6 +470,26 @@ interface ParsedStackTrace {
     raw: string;
 }
 
+interface RequestBridgeConfig {
+    url: string;
+    method?: HttpMethod | string;
+    headers?: Record<string, string>;
+    body?: any;
+    name?: string;
+    graphql?: {
+        operationName?: string;
+        operationType?: GraphqlOprtation | "query" | "mutation" | "subscription";
+        variables?: any;
+        query?: string;
+    };
+}
+interface ResponseBridgeConfig {
+    status: number;
+    statusText?: string;
+    headers?: Record<string, string>;
+    body?: any;
+}
+
 declare class LimelightClient {
     private ws;
     private config;
@@ -485,6 +505,7 @@ declare class LimelightClient {
     private consoleInterceptor;
     private renderInterceptor;
     private stateInterceptor;
+    private requestBridge;
     constructor();
     /**
      * Configures the Limelight client with the provided settings.
@@ -545,6 +566,29 @@ declare class LimelightClient {
      * @returns {void}
      */
     reset(): void;
+    /**
+     * Manually register a request with Limelight.
+     * Use this when your app makes network requests outside of fetch/XHR
+     * (e.g., through native modules).
+     *
+     * @param config - Request configuration
+     * @returns A request ID to use with endRequest() or failRequest()
+     */
+    startRequest(config: RequestBridgeConfig): string;
+    /**
+     * Complete a manually tracked request with a successful response.
+     *
+     * @param requestId - The ID returned from startRequest()
+     * @param response - Response data
+     */
+    endRequest(requestId: string, response: ResponseBridgeConfig): void;
+    /**
+     * Complete a manually tracked request with an error.
+     *
+     * @param requestId - The ID returned from startRequest()
+     * @param error - The error that occurred
+     */
+    failRequest(requestId: string, error: Error | string): void;
 }
 declare const Limelight: LimelightClient;
 
@@ -562,4 +606,4 @@ declare global {
     }
 }
 
-export { type BaseNetworkEvent, BodyFormat, type ConnectEvent, type ConnectionEvent, type ConsoleEvent, ConsoleLevel, ConsoleSource, ConsoleType, EventType, type GraphQLRequest, type GraphQLResponse, GraphqlOprtation, HttpMethod, HttpStatusClass, Limelight, type LimelightConfig, type LimelightEvent, type LimelightMessage, type NetworkErrorEvent, type NetworkEvent, NetworkPhase, type NetworkRequest, type NetworkRequestWithResponse, type NetworkResponse, NetworkType, type ParsedStackTrace, type SerializedBody, type Session, type StackFrame };
+export { type BaseNetworkEvent, BodyFormat, type ConnectEvent, type ConnectionEvent, type ConsoleEvent, ConsoleLevel, ConsoleSource, ConsoleType, EventType, type GraphQLRequest, type GraphQLResponse, GraphqlOprtation, HttpMethod, HttpStatusClass, Limelight, type LimelightConfig, type LimelightEvent, type LimelightMessage, type NetworkErrorEvent, type NetworkEvent, NetworkPhase, type NetworkRequest, type NetworkRequestWithResponse, type NetworkResponse, NetworkType, type ParsedStackTrace, type RequestBridgeConfig, type ResponseBridgeConfig, type SerializedBody, type Session, type StackFrame };

package/dist/index.js

@@ -84,17 +84,17 @@ var BodyFormat = /* @__PURE__ */ ((BodyFormat2) => {
   BodyFormat2["UNSERIALIZABLE"] = "UNSERIALIZABLE";
   return BodyFormat2;
 })(BodyFormat || {});
-var HttpMethod = /* @__PURE__ */ ((HttpMethod4) => {
-  HttpMethod4["GET"] = "GET";
-  HttpMethod4["POST"] = "POST";
-  HttpMethod4["PUT"] = "PUT";
-  HttpMethod4["PATCH"] = "PATCH";
-  HttpMethod4["DELETE"] = "DELETE";
-  HttpMethod4["HEAD"] = "HEAD";
-  HttpMethod4["OPTIONS"] = "OPTIONS";
-  HttpMethod4["TRACE"] = "TRACE";
-  HttpMethod4["CONNECT"] = "CONNECT";
-  return HttpMethod4;
+var HttpMethod = /* @__PURE__ */ ((HttpMethod5) => {
+  HttpMethod5["GET"] = "GET";
+  HttpMethod5["POST"] = "POST";
+  HttpMethod5["PUT"] = "PUT";
+  HttpMethod5["PATCH"] = "PATCH";
+  HttpMethod5["DELETE"] = "DELETE";
+  HttpMethod5["HEAD"] = "HEAD";
+  HttpMethod5["OPTIONS"] = "OPTIONS";
+  HttpMethod5["TRACE"] = "TRACE";
+  HttpMethod5["CONNECT"] = "CONNECT";
+  return HttpMethod5;
 })(HttpMethod || {});
 var HttpStatusClass = /* @__PURE__ */ ((HttpStatusClass2) => {
   HttpStatusClass2[HttpStatusClass2["INFORMATIONAL"] = 100] = "INFORMATIONAL";
@@ -235,6 +235,15 @@ var parseGraphQL = (body) => {
   }
 };
 
+// src/helpers/graphql/normalizeOperationType.ts
+var normalizeOperationType = (type) => {
+  if (!type) return null;
+  if (type === "query") return "query";
+  if (type === "mutation") return "mutation";
+  if (type === "subscription") return "subscription";
+  return type;
+};
+
 // src/constants/index.ts
 var SENSITIVE_HEADERS = [
   "authorization",
@@ -258,7 +267,7 @@ var SENSITIVE_HEADERS = [
 var LIMELIGHT_WEB_WSS_URL = "wss://api.getlimelight.io";
 var LIMELIGHT_DESKTOP_WSS_URL = "ws://localhost:8484";
 var WS_PATH = "/limelight";
-var SDK_VERSION = true ? "0.4.1" : "test-version";
+var SDK_VERSION = true ? "0.4.2" : "test-version";
 var RENDER_THRESHOLDS = {
   HOT_VELOCITY: 5,
   HIGH_RENDER_COUNT: 50,
@@ -1932,6 +1941,165 @@ var StateInterceptor = class {
   }
 };
 
+// src/limelight/interceptors/RequestBridge.ts
+var RequestBridge = class {
+  constructor(sendMessage, getSessionId) {
+    this.sendMessage = sendMessage;
+    this.getSessionId = getSessionId;
+  }
+  pendingRequests = /* @__PURE__ */ new Map();
+  config = null;
+  /**
+   * Updates the config reference (called when LimelightClient configures)
+   * @param config The new Limelight configuration or null to disable
+   */
+  setConfig(config) {
+    this.config = config;
+  }
+  /**
+   * Starts tracking a manual request. Returns a requestId to use with endRequest/failRequest.
+   * @param config The request configuration
+   * @returns The generated request ID
+   */
+  startRequest(config) {
+    const requestId = generateRequestId();
+    const startTime = Date.now();
+    this.pendingRequests.set(requestId, { startTime, config });
+    const method = config.method?.toUpperCase() || "POST";
+    const headers = config.headers || {};
+    const requestBody = serializeBody(
+      typeof config.body === "string" ? config.body : JSON.stringify(config.body),
+      this.config?.disableBodyCapture
+    );
+    let requestEvent = {
+      id: requestId,
+      sessionId: this.getSessionId(),
+      timestamp: startTime,
+      phase: "REQUEST" /* REQUEST */,
+      networkType: "fetch" /* FETCH */,
+      url: config.url,
+      method,
+      headers: redactSensitiveHeaders(headers),
+      body: requestBody,
+      name: config.name || formatRequestName(config.url),
+      initiator: "manual",
+      requestSize: requestBody?.size ?? 0,
+      graphql: config.graphql ? {
+        operationName: config.graphql.operationName,
+        operationType: normalizeOperationType(config.graphql.operationType),
+        variables: config.graphql.variables,
+        query: config.graphql.query
+      } : void 0
+    };
+    if (this.config?.beforeSend) {
+      const modifiedEvent = this.config.beforeSend(requestEvent);
+      if (!modifiedEvent) {
+        this.pendingRequests.delete(requestId);
+        return requestId;
+      }
+      if (modifiedEvent.phase !== "REQUEST" /* REQUEST */) {
+        console.error("[Limelight] beforeSend must return same event type");
+        return requestId;
+      }
+      requestEvent = modifiedEvent;
+    }
+    this.sendMessage(requestEvent);
+    return requestId;
+  }
+  /**
+   * Completes a tracked request with a successful response.
+   * @param requestId The ID returned from startRequest
+   * @param response The response data
+   */
+  endRequest(requestId, response) {
+    const pending = this.pendingRequests.get(requestId);
+    if (!pending) {
+      if (this.config?.enableInternalLogging) {
+        console.warn(
+          `[Limelight] No pending request found for id: ${requestId}`
+        );
+      }
+      return;
+    }
+    this.pendingRequests.delete(requestId);
+    const endTime = Date.now();
+    const duration = endTime - pending.startTime;
+    const responseHeaders = response.headers || {};
+    const responseBody = serializeBody(
+      typeof response.body === "string" ? response.body : JSON.stringify(response.body),
+      this.config?.disableBodyCapture
+    );
+    let responseEvent = {
+      id: requestId,
+      sessionId: this.getSessionId(),
+      timestamp: endTime,
+      phase: "RESPONSE" /* RESPONSE */,
+      networkType: "fetch" /* FETCH */,
+      status: response.status,
+      statusText: response.statusText || "",
+      headers: redactSensitiveHeaders(responseHeaders),
+      body: responseBody,
+      duration,
+      responseSize: responseBody?.size ?? 0,
+      redirected: false,
+      ok: response.status >= 200 && response.status < 300
+    };
+    if (this.config?.beforeSend) {
+      const modifiedEvent = this.config.beforeSend(responseEvent);
+      if (!modifiedEvent) {
+        return;
+      }
+      if (modifiedEvent.phase !== "RESPONSE" /* RESPONSE */) {
+        console.error("[Limelight] beforeSend must return same event type");
+        return;
+      }
+      responseEvent = modifiedEvent;
+    }
+    this.sendMessage(responseEvent);
+  }
+  /**
+   * Completes a tracked request with an error.
+   * @param requestId The ID returned from startRequest
+   * @param error The error object or message
+   */
+  failRequest(requestId, error) {
+    const pending = this.pendingRequests.get(requestId);
+    if (!pending) {
+      if (this.config?.enableInternalLogging) {
+        console.warn(
+          `[Limelight] No pending request found for id: ${requestId}`
+        );
+      }
+      return;
+    }
+    this.pendingRequests.delete(requestId);
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    const errorStack = error instanceof Error ? error.stack : void 0;
+    let errorEvent = {
+      id: requestId,
+      sessionId: this.getSessionId(),
+      timestamp: Date.now(),
+      phase: "ERROR" /* ERROR */,
+      networkType: "fetch" /* FETCH */,
+      errorMessage,
+      stack: errorStack
+    };
+    if (this.config?.beforeSend) {
+      const modifiedEvent = this.config.beforeSend(errorEvent);
+      if (modifiedEvent && modifiedEvent.phase === "ERROR" /* ERROR */) {
+        errorEvent = modifiedEvent;
+      }
+    }
+    this.sendMessage(errorEvent);
+  }
+  /**
+   * Cleans up any pending requests (called on disconnect)
+   */
+  cleanup() {
+    this.pendingRequests.clear();
+  }
+};
+
 // src/limelight/LimelightClient.ts
 var LimelightClient = class {
   ws = null;
@@ -1948,6 +2116,7 @@ var LimelightClient = class {
   consoleInterceptor;
   renderInterceptor;
   stateInterceptor;
+  requestBridge;
   constructor() {
     this.networkInterceptor = new NetworkInterceptor(
       this.sendMessage.bind(this),
@@ -1969,6 +2138,10 @@ var LimelightClient = class {
       this.sendMessage.bind(this),
       () => this.sessionId
     );
+    this.requestBridge = new RequestBridge(
+      this.sendMessage.bind(this),
+      () => this.sessionId
+    );
   }
   /**
    * Configures the Limelight client with the provided settings.
@@ -1997,6 +2170,7 @@ var LimelightClient = class {
       return;
     }
     this.sessionId = createSessionId();
+    this.requestBridge.setConfig(this.config);
     try {
       if (this.config.enableNetworkInspector) {
         this.networkInterceptor.setup(this.config);
@@ -2204,6 +2378,7 @@ var LimelightClient = class {
     this.consoleInterceptor.cleanup();
     this.renderInterceptor.cleanup();
     this.stateInterceptor.cleanup();
+    this.requestBridge.cleanup();
     this.reconnectAttempts = 0;
     this.messageQueue = [];
   }
@@ -2218,6 +2393,35 @@ var LimelightClient = class {
     this.config = null;
     this.sessionId = "";
   }
+  /**
+   * Manually register a request with Limelight.
+   * Use this when your app makes network requests outside of fetch/XHR
+   * (e.g., through native modules).
+   *
+   * @param config - Request configuration
+   * @returns A request ID to use with endRequest() or failRequest()
+   */
+  startRequest(config) {
+    return this.requestBridge.startRequest(config);
+  }
+  /**
+   * Complete a manually tracked request with a successful response.
+   *
+   * @param requestId - The ID returned from startRequest()
+   * @param response - Response data
+   */
+  endRequest(requestId, response) {
+    this.requestBridge.endRequest(requestId, response);
+  }
+  /**
+   * Complete a manually tracked request with an error.
+   *
+   * @param requestId - The ID returned from startRequest()
+   * @param error - The error that occurred
+   */
+  failRequest(requestId, error) {
+    this.requestBridge.failRequest(requestId, error);
+  }
 };
 var Limelight = new LimelightClient();
 // Annotate the CommonJS export names for ESM import in node: