agora-appbuilder-core 4.1.24-beta.2 → 4.1.24-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agora-appbuilder-core",
-  "version": "4.1.24-beta.2",
+  "version": "4.1.24-beta.3",
   "description": "React Native template for RTE app builder",
   "main": "index.js",
   "files": [

package/template/customization-api/index.ts

@@ -21,6 +21,7 @@ export {customize, $config};
 export * from './action-library';
 export * from './app-state';
 export * from './customEvents';
+export * from './logger';
 export * from './sub-components';
 export * from './typeDefinition';
 export * from './utils';

package/template/customization-api/logger.ts

@@ -0,0 +1,33 @@
+import {
+  CustomizationLogType,
+  LogSource,
+  logger,
+} from '../src/logger/AppBuilderLogger';
+
+export type CustomizationLogLevel = 'debug' | 'info' | 'warn' | 'error';
+export type CustomizationLogData = Record<string, unknown>;
+export type CustomizationLogEvent = {
+  type: CustomizationLogType;
+  event: string;
+  data?: CustomizationLogData;
+  level?: CustomizationLogLevel;
+};
+
+/**
+ * Sends a customization event through the active App Builder log transport.
+ * The logger adds the current session, room, user, platform, and SDK context.
+ * Callers must redact credentials and other sensitive values before logging.
+ */
+export const logCustomizationEvent = ({
+  type,
+  event,
+  data,
+  level = 'info',
+}: CustomizationLogEvent) => {
+  if (data) {
+    logger[level](LogSource.CustomizationAPI, type, event, data);
+    return;
+  }
+
+  logger[level](LogSource.CustomizationAPI, type, event);
+};

package/template/defaultConfig.js

@@ -77,8 +77,8 @@ const DefaultConfig = {
   CHAT_ORG_NAME: "",
   CHAT_APP_NAME: "",
   CHAT_URL: "",
-  CLI_VERSION: "3.1.24-beta.2",
-  CORE_VERSION: "4.1.24-beta.2",
+  CLI_VERSION: "3.1.24-beta.3",
+  CORE_VERSION: "4.1.24-beta.3",
   DISABLE_LANDSCAPE_MODE: false,
   STT_AUTO_START: false,
   CLOUD_RECORDING_AUTO_START: false,

package/template/src/auth/AuthProvider.tsx

@@ -137,6 +137,15 @@ const AuthProvider = (props: AuthProviderProps) => {
     }
   }, [store?.token]);
 
+  // A running native app is already authenticated when it receives a URL
+  // event, so there may be no later token change to consume returnTo.
+  useEffect(() => {
+    if (authenticated && returnTo && (isAndroid() || isIOS())) {
+      history.push(returnTo);
+      setReturnTo('');
+    }
+  }, [authenticated, history, returnTo]);
+
   const deepLinkUrl = (link: string | null) => {
     if (link !== null) {
       if (lifecycle?.onDeepLink?.(link)) {

package/template/src/logger/AppBuilderLogger.tsx

@@ -38,6 +38,8 @@ export declare const StatusTypes: {
 
 export type StatusType = (typeof StatusTypes)[keyof typeof StatusTypes];
 
+export type CustomizationLogType = string;
+
 export enum LogSource {
   AgoraSDK = 'Agora-SDK',
   /** Logs related to all features */
@@ -107,10 +109,7 @@ type LogType = {
     | 'recording_delete'
     | 'ban_user';
   [LogSource.Events]: 'CUSTOM_EVENTS' | 'RTM_EVENTS';
-  [LogSource.CustomizationAPI]:
-    | 'Log'
-    | 'AI_AGENT_CUSTOMIZATION'
-    | 'EXTERNAL_CUSTOMIZATION';
+  [LogSource.CustomizationAPI]: CustomizationLogType;
   [LogSource.SDK]: 'Log' | 'Event';
 };