@getlimelight/sdk 0.4.6 → 0.5.2

package/dist/index.d.mts

@@ -7,7 +7,8 @@ declare enum NetworkPhase {
     CONNECT = "CONNECT",
     REQUEST = "REQUEST",
     RESPONSE = "RESPONSE",
-    ERROR = "ERROR"
+    ERROR = "ERROR",
+    ABORT = "ABORT"
 }
 declare enum BodyFormat {
     TEXT = "TEXT",
@@ -92,7 +93,7 @@ interface NetworkResponse extends BaseNetworkEvent {
  * NETWORK ERROR (3rd possible outcome)
  */
 interface NetworkErrorEvent extends BaseNetworkEvent {
-    phase: NetworkPhase.ERROR;
+    phase: NetworkPhase.ERROR | NetworkPhase.ABORT;
     errorMessage: string;
     stack?: string;
 }
@@ -210,6 +211,25 @@ declare enum GraphqlOprtation {
     SUB = "SUBSCRIPTION"
 }
 
+declare enum CommandType {
+    CLEAR_RENDERS = "CLEAR_RENDERS",
+    ACK = "ACK"
+}
+interface BaseCommand {
+    type: CommandType;
+    id?: string;
+}
+interface ClearRendersCommand extends BaseCommand {
+    type: CommandType.CLEAR_RENDERS;
+}
+type Command = ClearRendersCommand;
+interface CommandAckEvent {
+    phase: CommandType.ACK;
+    commandId: string;
+    type: CommandType;
+    success: boolean;
+}
+
 /**
  * Render lifecycle phases
  */
@@ -450,7 +470,7 @@ interface ConnectionEvent {
 /**
  * Union type representing all possible Limelight messages.
  */
-type LimelightMessage = NetworkRequest | NetworkResponse | NetworkErrorEvent | ConsoleEvent | ConnectionEvent | RenderSnapshot | TransactionEvent | StateInitEvent | StateUpdateEvent;
+type LimelightMessage = NetworkRequest | NetworkResponse | NetworkErrorEvent | ConsoleEvent | ConnectionEvent | RenderSnapshot | TransactionEvent | StateInitEvent | StateUpdateEvent | CommandAckEvent;
 
 /**
  * Represents a single frame in a stack trace.
@@ -512,6 +532,7 @@ declare class LimelightClient {
     private renderInterceptor;
     private stateInterceptor;
     private requestBridge;
+    private commandHandler;
     constructor();
     /**
      * Configures the Limelight client with the provided settings.
@@ -612,4 +633,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 RequestBridgeConfig, type ResponseBridgeConfig, type SerializedBody, type Session, type StackFrame };
+export { type BaseCommand, type BaseNetworkEvent, BodyFormat, type ClearRendersCommand, type Command, type CommandAckEvent, CommandType, 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

@@ -7,7 +7,8 @@ declare enum NetworkPhase {
     CONNECT = "CONNECT",
     REQUEST = "REQUEST",
     RESPONSE = "RESPONSE",
-    ERROR = "ERROR"
+    ERROR = "ERROR",
+    ABORT = "ABORT"
 }
 declare enum BodyFormat {
     TEXT = "TEXT",
@@ -92,7 +93,7 @@ interface NetworkResponse extends BaseNetworkEvent {
  * NETWORK ERROR (3rd possible outcome)
  */
 interface NetworkErrorEvent extends BaseNetworkEvent {
-    phase: NetworkPhase.ERROR;
+    phase: NetworkPhase.ERROR | NetworkPhase.ABORT;
     errorMessage: string;
     stack?: string;
 }
@@ -210,6 +211,25 @@ declare enum GraphqlOprtation {
     SUB = "SUBSCRIPTION"
 }
 
+declare enum CommandType {
+    CLEAR_RENDERS = "CLEAR_RENDERS",
+    ACK = "ACK"
+}
+interface BaseCommand {
+    type: CommandType;
+    id?: string;
+}
+interface ClearRendersCommand extends BaseCommand {
+    type: CommandType.CLEAR_RENDERS;
+}
+type Command = ClearRendersCommand;
+interface CommandAckEvent {
+    phase: CommandType.ACK;
+    commandId: string;
+    type: CommandType;
+    success: boolean;
+}
+
 /**
  * Render lifecycle phases
  */
@@ -450,7 +470,7 @@ interface ConnectionEvent {
 /**
  * Union type representing all possible Limelight messages.
  */
-type LimelightMessage = NetworkRequest | NetworkResponse | NetworkErrorEvent | ConsoleEvent | ConnectionEvent | RenderSnapshot | TransactionEvent | StateInitEvent | StateUpdateEvent;
+type LimelightMessage = NetworkRequest | NetworkResponse | NetworkErrorEvent | ConsoleEvent | ConnectionEvent | RenderSnapshot | TransactionEvent | StateInitEvent | StateUpdateEvent | CommandAckEvent;
 
 /**
  * Represents a single frame in a stack trace.
@@ -512,6 +532,7 @@ declare class LimelightClient {
     private renderInterceptor;
     private stateInterceptor;
     private requestBridge;
+    private commandHandler;
     constructor();
     /**
      * Configures the Limelight client with the provided settings.
@@ -612,4 +633,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 RequestBridgeConfig, type ResponseBridgeConfig, type SerializedBody, type Session, type StackFrame };
+export { type BaseCommand, type BaseNetworkEvent, BodyFormat, type ClearRendersCommand, type Command, type CommandAckEvent, CommandType, 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

@@ -21,6 +21,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   BodyFormat: () => BodyFormat,
+  CommandType: () => CommandType,
   ConsoleLevel: () => ConsoleLevel,
   ConsoleSource: () => ConsoleSource,
   ConsoleType: () => ConsoleType,
@@ -72,6 +73,7 @@ var NetworkPhase = /* @__PURE__ */ ((NetworkPhase2) => {
   NetworkPhase2["REQUEST"] = "REQUEST";
   NetworkPhase2["RESPONSE"] = "RESPONSE";
   NetworkPhase2["ERROR"] = "ERROR";
+  NetworkPhase2["ABORT"] = "ABORT";
   return NetworkPhase2;
 })(NetworkPhase || {});
 var BodyFormat = /* @__PURE__ */ ((BodyFormat2) => {
@@ -118,6 +120,13 @@ var GraphqlOprtation = /* @__PURE__ */ ((GraphqlOprtation2) => {
   return GraphqlOprtation2;
 })(GraphqlOprtation || {});
 
+// src/types/commands.ts
+var CommandType = /* @__PURE__ */ ((CommandType2) => {
+  CommandType2["CLEAR_RENDERS"] = "CLEAR_RENDERS";
+  CommandType2["ACK"] = "ACK";
+  return CommandType2;
+})(CommandType || {});
+
 // src/helpers/detection/detectConsoleType.ts
 var detectConsoleType = (level, args) => {
   const messageStr = args.map((arg) => {
@@ -267,7 +276,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.6" : "test-version";
+var SDK_VERSION = true ? "0.5.2" : "test-version";
 var RENDER_THRESHOLDS = {
   HOT_VELOCITY: 5,
   HIGH_RENDER_COUNT: 50,
@@ -838,13 +847,14 @@ var NetworkInterceptor = class {
       } catch (err) {
         const errorMessage = err instanceof Error ? err.message : String(err);
         const errorStack = err instanceof Error ? err.stack : void 0;
+        const isAbort = err instanceof DOMException && err.name === "AbortError";
         let errorEvent = {
           id: requestId,
           sessionId: self.getSessionId(),
           timestamp: Date.now(),
-          phase: "ERROR" /* ERROR */,
+          phase: isAbort ? "ABORT" /* ABORT */ : "ERROR" /* ERROR */,
           networkType: "fetch" /* FETCH */,
-          errorMessage,
+          errorMessage: isAbort ? "Request aborted" : errorMessage,
           stack: errorStack
         };
         if (self.config?.beforeSend) {
@@ -1028,14 +1038,14 @@ var XHRInterceptor = class {
           self.sendMessage(responseEvent);
           cleanup.call(this);
         };
-        const sendError = (errorMessage) => {
+        const sendError = (errorMessage, phase = "ERROR" /* ERROR */) => {
           if (responseSent) return;
           responseSent = true;
           let errorEvent = {
             id: data.id,
             sessionId: self.getSessionId(),
             timestamp: Date.now(),
-            phase: "ERROR" /* ERROR */,
+            phase,
             networkType: "xhr" /* XHR */,
             errorMessage
           };
@@ -1061,7 +1071,7 @@ var XHRInterceptor = class {
           cleanup.call(this);
         };
         const abortHandler = function() {
-          sendError("Request aborted");
+          sendError("Request aborted", "ABORT" /* ABORT */);
           cleanup.call(this);
         };
         const timeoutHandler = function() {
@@ -1162,12 +1172,10 @@ var RenderInterceptor = class {
     }, RENDER_THRESHOLDS.SNAPSHOT_INTERVAL_MS);
     this.isSetup = true;
   }
-  resetProfiles() {
-    this.profiles.clear();
-    this.pendingUnmounts = [];
-    this.currentCommitComponents.clear();
-    this.componentIdCounter = 0;
-  }
+  /**
+   * Installs or wraps the React DevTools global hook.
+   * Returns true if successful, false otherwise.
+   */
   installHook() {
     const globalObj = typeof window !== "undefined" ? window : typeof global !== "undefined" ? global : null;
     if (!globalObj) return false;
@@ -1180,6 +1188,11 @@ var RenderInterceptor = class {
     }
     return true;
   }
+  /**
+   * Wraps an existing React DevTools hook to intercept render events.
+   * Preserves original functionality.
+   * @param hook - The existing React DevTools hook
+   */
   wrapExistingHook(hook) {
     this.originalHook = hook;
     this.originalOnCommitFiberRoot = hook.onCommitFiberRoot?.bind(hook);
@@ -1193,6 +1206,11 @@ var RenderInterceptor = class {
       this.handleCommitFiberUnmount(rendererID, fiber);
     };
   }
+  /**
+   * Creates a new React DevTools hook to intercept render events.
+   * @param globalObj - The global object (window or global)
+   * @param hookKey - The key for the React DevTools hook
+   */
   createHook(globalObj, hookKey) {
     const renderers = /* @__PURE__ */ new Map();
     let rendererIdCounter = 0;
@@ -1215,6 +1233,8 @@ var RenderInterceptor = class {
   /**
    * Handles a fiber root commit - walks tree and ACCUMULATES into profiles.
    * Two-pass: first count components, then accumulate with distributed cost.
+   * @param rendererID - The renderer ID
+   * @param root - The fiber root
    */
   handleCommitFiberRoot(_rendererID, root) {
     this.currentCommitComponents.clear();
@@ -1230,6 +1250,7 @@ var RenderInterceptor = class {
   }
   /**
    * First pass: count rendered components for cost distribution.
+   * @param fiber - The current fiber node
    */
   countRenderedComponents(fiber) {
     if (!fiber) return;
@@ -1239,6 +1260,11 @@ var RenderInterceptor = class {
     this.countRenderedComponents(fiber.child);
     this.countRenderedComponents(fiber.sibling);
   }
+  /**
+   * Handles a fiber unmount - marks component as unmounted.
+   * @param rendererID - The renderer ID
+   * @param fiber - The fiber being unmounted
+   */
   handleCommitFiberUnmount(_rendererID, fiber) {
     if (!this.isUserComponent(fiber)) return;
     const componentId = this.fiberToComponentId.get(fiber);
@@ -1252,20 +1278,28 @@ var RenderInterceptor = class {
   }
   /**
    * Walks fiber tree and accumulates render stats into profiles.
+   * @param fiber - The current fiber node
+   * @param parentComponentId - The parent component ID
+   * @param depth - The current depth in the tree
    */
   walkFiberTree(fiber, parentComponentId, depth) {
     if (!fiber) return;
+    let currentParentId = parentComponentId;
     if (this.isUserComponent(fiber) && this.didFiberRender(fiber)) {
       const componentId = this.getOrCreateComponentId(fiber);
       this.accumulateRender(fiber, componentId, parentComponentId, depth);
       this.currentCommitComponents.add(componentId);
-      parentComponentId = componentId;
+      currentParentId = componentId;
     }
-    this.walkFiberTree(fiber.child, parentComponentId, depth + 1);
+    this.walkFiberTree(fiber.child, currentParentId, depth + 1);
     this.walkFiberTree(fiber.sibling, parentComponentId, depth);
   }
   /**
    * Core accumulation logic - this is where we build up the profile.
+   * @param fiber - The current fiber node
+   * @param componentId - The component ID
+   * @param parentComponentId - The parent component ID
+   * @param depth - The current depth in the tree
    */
   accumulateRender(fiber, componentId, parentComponentId, depth) {
     const now = Date.now();
@@ -1326,7 +1360,9 @@ var RenderInterceptor = class {
     this.updateSuspiciousFlag(profile);
   }
   /**
-   * NEW: Accumulate prop change details into the profile.
+   * Accumulate prop change details into the profile.
+   * @param profile - The component profile
+   * @param changes - The list of prop change details
    */
   accumulatePropChanges(profile, changes) {
     const stats = profile.propChangeStats;
@@ -1355,7 +1391,9 @@ var RenderInterceptor = class {
     }
   }
   /**
-   *  Build prop change snapshot for emission.
+   * Build prop change snapshot for emission.
+   * @param profile - The component profile
+   * @returns The prop change snapshot or undefined
    */
   buildPropChangeSnapshot(profile) {
     const stats = profile.propChangeStats;
@@ -1373,6 +1411,10 @@ var RenderInterceptor = class {
     });
     return { topChangedProps };
   }
+  /**
+   * Updates the suspicious flag based on render velocity and count.
+   * @param profile - The component profile
+   */
   updateSuspiciousFlag(profile) {
     const velocity = this.calculateVelocity(profile);
     if (velocity > RENDER_THRESHOLDS.HOT_VELOCITY) {
@@ -1391,6 +1433,8 @@ var RenderInterceptor = class {
   /**
    * Calculates renders per second from velocity window.
    * Cheap: just count / window duration, no array operations.
+   * @param profile - The component profile
+   * @returns The calculated velocity
    */
   calculateVelocity(profile) {
     const now = Date.now();
@@ -1403,6 +1447,8 @@ var RenderInterceptor = class {
   }
   /**
    * Emits a snapshot of all profiles with deltas.
+   * Only emits profiles that have significant changes since last emit.
+   * Also emits unmounts.
    */
   emitSnapshot() {
     const now = Date.now();
@@ -1486,7 +1532,11 @@ var RenderInterceptor = class {
     this.sendMessage(message);
   }
   /**
-   *  Now returns prop change details when applicable.
+   * Now returns prop change details when applicable.
+   * Infers the cause of the render by comparing current and previous fiber states.
+   * @param fiber - The current fiber node
+   * @param parentComponentId - The parent component ID
+   * @returns The inferred render cause
    */
   inferRenderCause(fiber, parentComponentId) {
     const alternate = fiber.alternate;
@@ -1535,6 +1585,9 @@ var RenderInterceptor = class {
   /**
    * Diff props to find which keys changed and whether it's reference-only.
    * This is the key insight generator.
+   * @param prevProps - The previous props
+   * @param nextProps - The next props
+   * @returns List of prop change details
    */
   diffProps(prevProps, nextProps) {
     if (!prevProps || !nextProps) {
@@ -1562,8 +1615,11 @@ var RenderInterceptor = class {
     return changes;
   }
   /**
-   *  Shallow equality check to determine if a prop is reference-only change.
+   * Shallow equality check to determine if a prop is reference-only change.
    * We only go one level deep to keep it fast.
+   * @param a - The first value
+   * @param b - The second value
+   * @returns True if shallow equal, false otherwise
    */
   isShallowEqual(a, b) {
     if (a === b) return true;
@@ -1590,13 +1646,28 @@ var RenderInterceptor = class {
     }
     return a === b;
   }
+  /**
+   * Determines if a fiber represents a user-defined component.
+   * @param fiber - The fiber node
+   * @returns True if user component, false otherwise
+   */
   isUserComponent(fiber) {
     const tag = fiber.tag;
     return tag === 0 /* FunctionComponent */ || tag === 1 /* ClassComponent */ || tag === 11 /* ForwardRef */ || tag === 14 /* MemoComponent */ || tag === 15 /* SimpleMemoComponent */;
   }
+  /**
+   * Determines if a fiber performed work during the commit.
+   * @param fiber - The fiber node
+   * @returns True if performed work, false otherwise
+   */
   didFiberRender(fiber) {
     return (fiber.flags & 1 /* PerformedWork */) !== 0;
   }
+  /**
+   * Gets or creates a unique component ID for a fiber.
+   * @param fiber - The fiber node
+   * @returns The unique component ID
+   */
   getOrCreateComponentId(fiber) {
     let id = this.fiberToComponentId.get(fiber);
     if (id) return id;
@@ -1611,6 +1682,11 @@ var RenderInterceptor = class {
     this.fiberToComponentId.set(fiber, id);
     return id;
   }
+  /**
+   * Gets the display name of a component from a fiber.
+   * @param fiber - The fiber node
+   * @returns The component name
+   */
   getComponentName(fiber) {
     const type = fiber.type;
     if (!type) return "Unknown";
@@ -1628,6 +1704,11 @@ var RenderInterceptor = class {
     }
     return "Unknown";
   }
+  /**
+   * Gets the component type from a fiber.
+   * @param fiber - The fiber node
+   * @returns The component type
+   */
   getComponentType(fiber) {
     switch (fiber.tag) {
       case 0 /* FunctionComponent */:
@@ -1661,6 +1742,9 @@ var RenderInterceptor = class {
   getSuspiciousComponents() {
     return Array.from(this.profiles.values()).filter((p) => p.isSuspicious);
   }
+  /**
+   * Cleans up and restores original hook behavior.
+   */
   cleanup() {
     if (!this.isSetup) return;
     this.emitSnapshot();
@@ -1686,6 +1770,16 @@ var RenderInterceptor = class {
     this.config = null;
     this.isSetup = false;
   }
+  /**
+   * Resets all collected profiles
+   */
+  resetProfiles() {
+    this.profiles.clear();
+    this.fiberToComponentId = /* @__PURE__ */ new WeakMap();
+    this.pendingUnmounts = [];
+    this.currentCommitComponents.clear();
+    this.componentIdCounter = 0;
+  }
 };
 
 // src/limelight/interceptors/StateInterceptor.ts
@@ -1724,7 +1818,7 @@ var StateInterceptor = class {
       );
       return;
     }
-    const state = this.getState(store, library);
+    const state = this.getState(store);
     const initEvent = {
       phase: "STATE:INIT" /* INIT */,
       sessionId: this.getSessionId(),
@@ -1741,6 +1835,8 @@ var StateInterceptor = class {
   }
   /**
    * Unregister a store and stop listening to changes.
+   * Can be called manually via Limelight.removeStore().
+   * @param name The name of the store to unregister
    */
   unregisterStore(name) {
     const store = this.stores.get(name);
@@ -1751,6 +1847,7 @@ var StateInterceptor = class {
   }
   /**
    * Emit an event, applying beforeSend hook if configured
+   * @param event The event to emit
    */
   emitEvent(event) {
     if (this.config?.beforeSend) {
@@ -1769,6 +1866,8 @@ var StateInterceptor = class {
   }
   /**
    * Detect whether a store is Zustand or Redux
+   * @param store The store to inspect
+   * @return StateLibrary or null if unknown
    */
   detectLibrary(store) {
     if (!store || typeof store !== "function" && typeof store !== "object") {
@@ -1787,13 +1886,19 @@ var StateInterceptor = class {
   }
   /**
    * Get current state from a store
+   * @param store The store to get state from
+   * @return The current state
    */
-  getState(store, library) {
+  getState(store) {
     const storeAny = store;
     return storeAny.getState();
   }
   /**
    * Subscribe to store changes
+   * @param store The store to subscribe to
+   * @param library The detected state library
+   * @param storeName The name of the store
+   * @return Unsubscribe function
    */
   subscribe(store, library, storeName) {
     const storeAny = store;
@@ -1805,6 +1910,9 @@ var StateInterceptor = class {
   }
   /**
    * Subscribe to Zustand store changes
+   * @param store The Zustand store
+   * @param storeName The name of the store
+   * @return Unsubscribe function
    */
   subscribeZustand(store, storeName) {
     return store.subscribe((state, prevState) => {
@@ -1827,6 +1935,9 @@ var StateInterceptor = class {
   }
   /**
    * Subscribe to Redux store changes
+   * @param store The Redux store
+   * @param storeName The name of the store
+   * @return Unsubscribe function
    */
   subscribeRedux(store, storeName) {
     let lastAction = { type: "@@INIT" };
@@ -1862,6 +1973,9 @@ var StateInterceptor = class {
   }
   /**
    * Infer action name from stack trace for Zustand
+   * @param state The new state
+   * @param prevState The previous state
+   * @return Inferred StateAction
    */
   inferZustandAction(state, prevState) {
     const actionType = this.parseActionFromStack(this.captureStackTrace());
@@ -1873,6 +1987,8 @@ var StateInterceptor = class {
   }
   /**
    * Parse function name from stack trace
+   * @param stack The stack trace string
+   * @return The inferred action name
    */
   parseActionFromStack(stack) {
     if (!stack) return "set";
@@ -1903,6 +2019,9 @@ var StateInterceptor = class {
   }
   /**
    * Compute what keys changed between states (shallow)
+   * @param state The new state
+   * @param prevState The previous state
+   * @return Partial state with only changed keys
    */
   computePartialState(state, prevState) {
     if (typeof state !== "object" || state === null || typeof prevState !== "object" || prevState === null) {
@@ -1943,7 +2062,7 @@ var StateInterceptor = class {
   }
 };
 
-// src/limelight/interceptors/RequestBridge.ts
+// src/limelight/bridges/RequestBridge.ts
 var RequestBridge = class {
   constructor(sendMessage, getSessionId) {
     this.sendMessage = sendMessage;
@@ -2110,6 +2229,42 @@ var RequestBridge = class {
   }
 };
 
+// src/limelight/handlers/CommandHandler.ts
+var CommandHandler = class {
+  constructor(interceptors, sendMessage, getConfig) {
+    this.interceptors = interceptors;
+    this.sendMessage = sendMessage;
+    this.getConfig = getConfig;
+  }
+  /**
+   * Handles an incoming command.
+   * @param command - The command to handle
+   */
+  handle(command) {
+    const config = this.getConfig();
+    if (config?.enableInternalLogging) {
+      console.log("[Limelight] Received command:", command.type);
+    }
+    switch (command.type) {
+      case "CLEAR_RENDERS" /* CLEAR_RENDERS */:
+        this.interceptors.render.resetProfiles();
+        break;
+      default:
+        if (config?.enableInternalLogging) {
+          console.warn("[Limelight] Unknown command:", command.type);
+        }
+    }
+    if (command.id) {
+      this.sendMessage({
+        phase: "ACK" /* ACK */,
+        commandId: command.id,
+        type: command.type,
+        success: true
+      });
+    }
+  }
+};
+
 // src/limelight/LimelightClient.ts
 var LimelightClient = class {
   ws = null;
@@ -2127,6 +2282,7 @@ var LimelightClient = class {
   renderInterceptor;
   stateInterceptor;
   requestBridge;
+  commandHandler = null;
   constructor() {
     this.networkInterceptor = new NetworkInterceptor(
       this.sendMessage.bind(this),
@@ -2152,6 +2308,11 @@ var LimelightClient = class {
       this.sendMessage.bind(this),
       () => this.sessionId
     );
+    this.commandHandler = new CommandHandler(
+      { render: this.renderInterceptor },
+      this.sendMessage.bind(this),
+      () => this.config
+    );
   }
   /**
    * Configures the Limelight client with the provided settings.
@@ -2258,6 +2419,16 @@ var LimelightClient = class {
         this.flushMessageQueue();
         this.sendMessage(message);
       };
+      this.ws.onmessage = (event) => {
+        try {
+          const command = JSON.parse(event.data);
+          this.commandHandler?.handle(command);
+        } catch (error) {
+          if (this.config?.enableInternalLogging) {
+            console.error("[Limelight] Failed to parse command:", error);
+          }
+        }
+      };
       this.ws.onerror = (error) => {
         if (this.config?.enableInternalLogging) {
           console.error("[Limelight] WebSocket error:", error);
@@ -2437,6 +2608,7 @@ var Limelight = new LimelightClient();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BodyFormat,
+  CommandType,
   ConsoleLevel,
   ConsoleSource,
   ConsoleType,