feat: add alog and trace for BTS event handlers

.changeset/olive-hounds-enter.md

@@ -0,0 +1,5 @@
+---
+"@lynx-js/react": patch
+---
+
+Add alog and trace for BTS event handlers.

packages/react/runtime/src/lifecycle/event/delayEvents.ts

@@ -1,9 +1,9 @@
 // Copyright 2025 The Lynx Authors. All rights reserved.
 // Licensed under the Apache License Version 2.0 that can be found in the
 // LICENSE file in the root directory of this source tree.
-let delayedEvents: [handlerName: string, data: unknown][] | undefined;
+let delayedEvents: [handlerName: string, data: EventDataType][] | undefined;
 
-function delayedPublishEvent(handlerName: string, data: unknown): void {
+function delayedPublishEvent(handlerName: string, data: EventDataType): void {
   delayedEvents ??= [];
   delayedEvents.push([handlerName, data]);
 }

packages/react/runtime/src/lynx/tt.ts

@@ -180,7 +180,7 @@ function onLifecycleEventImpl(type: LifecycleConstant, data: unknown): void {
       break;
     }
     case LifecycleConstant.publishEvent: {
-      const { handlerName, data: d } = data as { handlerName: string; data: unknown };
+      const { handlerName, data: d } = data as { handlerName: string; data: EventDataType };
       lynxCoreInject.tt.publishEvent(handlerName, d);
       break;
     }
@@ -201,25 +201,58 @@ function flushDelayedLifecycleEvents(): void {
   flushingDelayedLifecycleEvents = false;
 }
 
-function publishEvent(handlerName: string, data: unknown) {
+function publishEvent(handlerName: string, data: EventDataType) {
   lynxCoreInject.tt.callBeforePublishEvent?.(data);
   const eventHandler = backgroundSnapshotInstanceManager.getValueBySign(
     handlerName,
-  );
+  ) as ((data: unknown) => void) | undefined;
+
+  if (__PROFILE__) {
+    profileStart(`ReactLynx::publishEvent`, {
+      args: {
+        handlerName,
+        type: data.type,
+        snapshotInstanceType: backgroundSnapshotInstanceManager.values.get(
+          Number(handlerName.split(':')[0]),
+        )?.type ?? '',
+        jsFunctionName: eventHandler?.name ?? '',
+      },
+    });
+  }
+  if (typeof __ALOG__ !== 'undefined' && __ALOG__) {
+    console.alog?.(
+      `[ReactLynxDebug] BTS received event:\n` + JSON.stringify(
+        {
+          handlerName,
+          type: data.type,
+          snapshotInstanceType: backgroundSnapshotInstanceManager.values.get(
+            Number(handlerName.split(':')[0]),
+          )?.type ?? '',
+          jsFunctionName: eventHandler?.name ?? '',
+        },
+        null,
+        2,
+      ),
+    );
+  }
+
   if (eventHandler) {
     try {
-      (eventHandler as (...args: unknown[]) => void)(data);
+      eventHandler(data);
     } catch (e) {
       lynx.reportError(e as Error);
     }
   }
+  if (__PROFILE__) {
+    profileEnd();
+  }
 }
 
-function publicComponentEvent(_componentId: string, handlerName: string, data: unknown) {
+function publicComponentEvent(_componentId: string, handlerName: string, data: EventDataType) {
   publishEvent(handlerName, data);
 }
 
-function delayedPublicComponentEvent(_componentId: string, handlerName: string, data: unknown) {
+function delayedPublicComponentEvent(_componentId: string, handlerName: string, data: EventDataType) {
   delayedPublishEvent(handlerName, data);
 }
 

packages/react/runtime/types/types.d.ts

@@ -177,6 +177,11 @@ declare global {
     removeComponents: () => void;
   }
 
+  declare interface EventDataType {
+    type: string;
+    [prop: string]: unknown;
+  }
+
   namespace lynxCoreInject {
     const tt: {
       _params: {
@@ -185,8 +190,8 @@ declare global {
       };
 
       OnLifecycleEvent: ([type, data]: [LifecycleConstant, unknown]) => void;
-      publishEvent: (handlerName: string, data: unknown) => void;
-      publicComponentEvent: (componentId: string, handlerName: string, data: unknown) => void;
+      publishEvent: (handlerName: string, data: EventDataType) => void;
+      publicComponentEvent: (componentId: string, handlerName: string, data: EventDataType) => void;
       callDestroyLifetimeFun: () => void;
       updateGlobalProps: (newData: Record<string, unknown>) => void;
       updateCardData: (newData: Record<string, any>, options?: Record<string, unknown>) => void;