@situm/react-native 3.3.6 → 3.4.1

package/lib/typescript/src/wayfinding/hooks/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/wayfinding/hooks/index.ts"],"names":[],"mappings":"AA0CA,eAAO,MAAM,gBAAgB;;;;;;;8BAwFY,GAAG;+BAiDR,GAAG;;CAyEtC,CAAC;AAEF,QAAA,MAAM,QAAQ,WAQb,CAAC;AAEF,eAAe,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/wayfinding/hooks/index.ts"],"names":[],"mappings":"AA4CA,eAAO,MAAM,gBAAgB;;;;;;;8BAsFY,GAAG;+BAiDR,GAAG;;CAgFtC,CAAC;AAEF,QAAA,MAAM,QAAQ,WAQb,CAAC;AAEF,eAAe,QAAQ,CAAC"}

package/lib/typescript/src/wayfinding/types/index.d.ts

@@ -41,6 +41,9 @@ export interface OnFloorChangedResult {
     fromFloorName: string;
     toFloorName: string;
 }
+export interface OnExternalLinkClickedResult {
+    url: string;
+}
 export interface Destination {
     category: string;
     identifier?: string;

package/lib/typescript/src/wayfinding/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/wayfinding/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACnC,iBAAiB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAChD,aAAa,EAAE,CAAC,EACd,UAAU,EACV,iBAAqD,GACtD,EAAE;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;KACvC,KAAK,IAAI,CAAC;IACX,eAAe,EAAE,CAAC,EAChB,GAAG,EACH,GAAG,EACH,eAAe,EACf,cAAc,EACd,iBAAqD,GACtD,EAAE;QACD,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,eAAe,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;KACvC,KAAK,IAAI,CAAC;IACX,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,KAAK,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CACvC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/wayfinding/types/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@situm/react-native",
-  "version": "3.3.6",
+  "version": "3.4.1",
   "description": "Set of utilities that allow any developer to build React Native location based apps using Situm's indoor positioning system.",
   "private": false,
   "repository": "https://github.com/situmtech/react-native",
@@ -49,7 +49,7 @@
     "typescript": "tsc --noEmit",
     "lint:fix": "eslint \"src/**/*.{js,ts,tsx}\" --fix",
     "lint": "eslint \"src/**/*.{js,jsx,ts,tsx}\"",
-    "prepare": "bob build",
+    "prepare": "bob build; yarn doc",
     "release": "release-it",
     "example": "yarn --cwd example",
     "build:android": "cd example/android && ./gradlew assembleDebug --no-daemon --console=plain -PreactNativeArchitectures=arm64-v8a",

package/src/index.ts

@@ -1,7 +1,7 @@
 import SitumPlugin from "./sdk";
 
 // Definitions
-export type * from "./sdk/types";
+export * from "./sdk/types";
 export type * from "./wayfinding/types";
 
 // APIs

package/src/sdk/index.ts

@@ -6,28 +6,34 @@ import { NativeEventEmitter, NativeModules, Platform } from "react-native";
 import packageJson from "../../package.json";
 import { logError } from "../utils/logError";
 import type { SitumPluginInterface } from "./nativeInterface";
-import type {
-  Building,
-  BuildingInfo,
-  ConfigurationOptions,
-  Directions,
-  DirectionsOptions,
-  Error,
-  Floor,
-  Geofence,
-  Location,
-  LocationRequest,
-  LocationStatus,
-  NavigationProgress,
-  NavigationRequest,
-  Poi,
-  PoiCategory,
-  PoiIcon,
-  Point,
-  SdkVersion,
+import {
+  type Building,
+  type BuildingInfo,
+  type ConfigurationOptions,
+  type Directions,
+  type DirectionsOptions,
+  type Error,
+  ErrorCode,
+  ErrorType,
+  type Floor,
+  type Geofence,
+  type Location,
+  type LocationRequest,
+  type LocationStatus,
+  type NavigationProgress,
+  type NavigationRequest,
+  type Poi,
+  type PoiCategory,
+  type PoiIcon,
+  type Point,
+  type SdkVersion,
 } from "./types";
 import { SdkNavigationUpdateType } from "./types/constants";
-import { exceptionWrapper, promiseWrapper } from "./utils";
+import {
+  exceptionWrapper,
+  locationErrorAdapter,
+  promiseWrapper,
+} from "./utils";
 
 export type * from "./types";
 export * from "./types/constants";
@@ -233,13 +239,24 @@ export default class SitumPlugin {
 
   /**
    * Returns the device identifier that has generated the location
-   *
-   * @returns void
-   * @throw Exception
    */
   static getDeviceId = () => {
-    return exceptionWrapper<string>(({ onSuccess }) => {
-      RNCSitumPlugin.getDeviceId(onSuccess);
+    return promiseWrapper<string>(({ onSuccess, onError }) => {
+      RNCSitumPlugin.getDeviceId((response) => {
+        //@ts-ignore
+        if (response?.deviceId) {
+          // Resolve with the actual deviceId
+          //@ts-ignore
+          onSuccess(response.deviceId);
+        } else {
+          // Reject if deviceId is not available in the response
+          onError({
+            code: ErrorCode.UNKNOWN,
+            message: "Couldn't get device ID",
+            type: ErrorType.CRITICAL,
+          });
+        }
+      });
     });
   };
 
@@ -461,13 +478,11 @@ export default class SitumPlugin {
    */
   static removeNavigationUpdates = () => {
     return promiseWrapper<void>(({ onCallback }) => {
-      if (!SitumPlugin.navigationIsRunning()) {
-        throw "Situm > hook > Navigation updates were not active.";
-      }
+      if (!SitumPlugin.navigationIsRunning()) return;
 
       navigationRunning = false;
-      RNCSitumPlugin.removeNavigationUpdates((reponse) => {
-        onCallback(reponse, "Failed to remove navigation updates");
+      RNCSitumPlugin.removeNavigationUpdates((response) => {
+        onCallback(response, "Failed to remove navigation updates");
       });
     });
   };
@@ -576,8 +591,13 @@ export default class SitumPlugin {
    *
    * @param callback the function called when there is an error
    */
-  static onLocationError = (callback: (status: Error) => void) => {
-    SitumPluginEventEmitter.addListener("locationError", callback);
+  static onLocationError = (callback: (error: Error) => void) => {
+    SitumPluginEventEmitter.addListener("locationError", (error) => {
+      const adaptedError = locationErrorAdapter(error);
+      if (adaptedError.type === ErrorType.CRITICAL)
+        this.removeLocationUpdates();
+      callback(adaptedError);
+    });
   };
 
   /**

package/src/sdk/types/constants.ts

@@ -30,7 +30,7 @@ export enum LocationStatusName {
 /**
  * Available accessibility modes used in the {@link DirectionsRequest}.
  *
- * @property CHOOSE_SHORTEST The route should choose the best route, without taking into account if it is accessible or not
+ * @property CHOOSE_SHORTEST The route should choose the best route, without taking into account if it is accessible or not.
  * This option is the default so you don't have to do anything in order to use it
  * @property ONLY_ACCESSIBLE The route should always use accessible nodes.
  * @property ONLY_NOT_ACCESSIBLE_FLOOR_CHANGES The route should never use accessible floor changes (use this to force routes not to use lifts).

package/src/sdk/types/index.ts

@@ -496,17 +496,45 @@ export type RealTimeData = {
   locations: Location[];
 };
 
+/**
+ * @name SdkVersion
+ * @description Represents the version information of the SDK and its compatibility with different platforms.
+ *
+ * @type
+ * @property {string} react_native - The version of React Native used in the SDK.
+ * @property {string} [ios] - Optional. The specific version of the Situm SDK for the iOS platform.
+ * @property {string} [android] - Optional. The specific version of the Situm SDK for the Android platform.
+ */
 export type SdkVersion = {
   react_native: string;
   ios?: string;
   android?: string;
 };
 
+/**
+ * @name ConfigurationOptions
+ * @description Configuration options for initializing the SDK or other modules.
+ *
+ * @type
+ * @property {boolean} [useRemoteConfig] - Optional. Determines whether to use Remote Configuration settings.
+ * @property {number} [cacheMaxAge] - Optional. The maximum age of the cache in seconds.
+ */
 export type ConfigurationOptions = {
   useRemoteConfig?: boolean;
   cacheMaxAge?: number;
 };
 
+/**
+ * @name Location
+ * @description Represents a location with various attributes including position, accuracy, and bearing.
+ *
+ * @interface
+ * @property {Position} [position] - Optional. The position information of the location.
+ * @property {number} [accuracy] - Optional. The accuracy of the location information in meters.
+ * @property {Object} [bearing] - Optional. Bearing information including degrees and degreesClockwise.
+ * @property {boolean} [hasBearing] - Optional. Indicates if bearing information is available.
+ * @property {LocationStatusName} status - The status of the location update.
+ */
 export interface Location {
   position?: Position;
   accuracy?: number;
@@ -532,14 +560,67 @@ export interface Position {
   buildingIdentifier?: string;
   floorIdentifier?: string;
 }
+
+/**
+ * @name LocationStatus
+ * @description Represents the status of a location, including a name and a numeric code.
+ *
+ * @interface
+ * @property {LocationStatusName} statusName - The name of the location status.
+ * @property {number} statusCode - The numeric code representing the location status.
+ */
 export interface LocationStatus {
   statusName: LocationStatusName;
   statusCode: number;
 }
 
+/**
+ * @name ErrorType
+ * @description Enumeration of error types to categorize the severity of errors.
+ *
+ * @enum {string}
+ * @property {string} CRITICAL - Represents critical errors that will cause the system not to work (e.g. positioning will be stopped).
+ * @property {string} NON_CRITICAL - Represents non-critical errors that are less severe.
+ */
+export enum ErrorType {
+  CRITICAL = "CRITICAL",
+  NON_CRITICAL = "NON_CRITICAL",
+}
+
+/**
+ * @name ErrorCode
+ * @description Enumeration of error codes provided by Situm SDK.
+ *
+ * @enum {string}
+ * @property {string} LOCATION_PERMISSION_DENIED - Indicates that location permissions were not granted by the user.
+ * @property {string} BLUETOOTH_PERMISSION_DENIED - Indicates that Bluetooth permissions were not granted.
+ * @property {string} BLUETOOTH_DISABLED - Indicates that Bluetooth is disabled on the device.
+ * @property {string} LOCATION_DISABLED - Indicates that the location services are disabled on the device.
+ * @property {string} REDUCED_ACCURACY - Indicates that the precise location has been turned off on the device.
+ * @property {string} UNKNOWN - Represents an unknown error or an error that does not fit other categories.
+ */
+export enum ErrorCode {
+  LOCATION_PERMISSION_DENIED = "LOCATION_PERMISSION_DENIED",
+  BLUETOOTH_PERMISSION_DENIED = "BLUETOOTH_PERMISSION_DENIED",
+  BLUETOOTH_DISABLED = "BLUETOOTH_DISABLED",
+  LOCATION_DISABLED = "LOCATION_DISABLED",
+  REDUCED_ACCURACY = "REDUCED_ACCURACY",
+  UNKNOWN = "UNKNOWN",
+}
+
+/**
+ * @name Error
+ * @description Represents an error with a specific code, message, and type.
+ *
+ * @interface
+ * @property {ErrorCode} code - The specific error code associated with this error.
+ * @property {string} message - A descriptive message providing more details about the error.
+ * @property {ErrorType} type - The type of the error indicating its severity (critical or non-critical).
+ */
 export interface Error {
-  code?: number;
+  code: ErrorCode;
   message: string;
+  type: ErrorType;
 }
 
 // TODO: add types

package/src/sdk/utils.ts

@@ -1,5 +1,6 @@
 import { logError } from "..";
 import type { Error } from "./types";
+import { ErrorCode, ErrorType } from "./types";
 
 type PromiseResolve<T> = (response: T) => void;
 type PromiseReject = (error?: Error) => void;
@@ -23,8 +24,9 @@ export const handleAsyncCallback = (
     resolve();
   } else {
     reject({
-      code: -1,
+      code: ErrorCode.UNKNOWN,
       message: errorMessage || "Unknown error.",
+      type: ErrorType.NON_CRITICAL,
     });
   }
 };
@@ -121,9 +123,47 @@ export const promiseWrapper = <T>(
     } catch (error) {
       logError(error);
       reject({
-        code: error?.code || -1,
+        code: ErrorCode.UNKNOWN,
         message: error?.message || "Unknown error.",
+        type: ErrorType.NON_CRITICAL,
       });
     }
   });
 };
+
+export function locationErrorAdapter(error): Error {
+  let adaptedCode = ErrorCode.UNKNOWN;
+  const adaptedMessage = error.message;
+  const adaptedType = ErrorType.CRITICAL;
+
+  switch (error.code.toString()) {
+    case "8001": // MISSING_LOCATION_PERMISSION
+    case "8": // kSITLocationErrorLocationDisabled
+    case "9": // kSITLocationErrorLocationRestricted
+    case "10": // kSITLocationErrorLocationAuthStatusNotDetermined
+      adaptedCode = ErrorCode.LOCATION_PERMISSION_DENIED;
+      break;
+    case "8002": // LOCATION_DISABLED
+      adaptedCode = ErrorCode.LOCATION_DISABLED;
+      break;
+    case "8012": // MISSING_BLUETOOTH_PERMISSION
+      adaptedCode = ErrorCode.BLUETOOTH_PERMISSION_DENIED;
+      break;
+    case "8100": //BLUETOOTH_DISABLED. 8100 ->This number does not exist in Situm SDK. We made it up in SitumMapper.java (RN adapter)
+    case "6": // kSITLocationErrorBluetoothisOff
+      adaptedCode = ErrorCode.BLUETOOTH_DISABLED;
+      break;
+    case "11": //kSITLocationErrorLocationAccuracyAuthorizationStatusReducedAccuracy
+      adaptedCode = ErrorCode.REDUCED_ACCURACY;
+      break;
+    // Add more cases as needed
+  }
+
+  const returnError: Error = {
+    code: adaptedCode,
+    message: adaptedMessage,
+    type: adaptedType,
+  };
+
+  return returnError;
+}

package/src/utils/requestPermission.ts

@@ -8,7 +8,7 @@ import {
 
 // TODO: can requestMultiple be used ?
 const checkIOSPermissions = async () => {
-  let granted = await request(PERMISSIONS.IOS.LOCATION_WHEN_IN_USE);
+  const granted = await request(PERMISSIONS.IOS.LOCATION_WHEN_IN_USE);
 
   // Check if already denied
   if (granted !== RESULTS.GRANTED) {
@@ -19,24 +19,7 @@ const checkIOSPermissions = async () => {
     "Situm > permissions > LOCATION_WHEN_IN_USE permission granted"
   );
 
-  //@ts-ignore
-  if (parseInt(Platform.Version, 10) > 12) {
-    granted = await request(PERMISSIONS.IOS.BLUETOOTH_PERIPHERAL);
-
-    if (granted === RESULTS.GRANTED) {
-      console.debug(
-        "Situm > permissions > BLUETOOTH_PERIPHERAL permission granted"
-      );
-      return true;
-    } else {
-      throw "Situm > permissions > BLUETOOTH_PERIPHERAL permission not granted";
-    }
-  } else {
-    console.debug(
-      "Situm > permissions > BLUETOOTH_PERIPHERAL permissions not required"
-    );
-    return true;
-  }
+  return true;
 };
 
 const checkAndroidPermissions = async () => {

package/src/wayfinding/components/MapView.tsx

@@ -8,6 +8,7 @@ import React, {
   useState,
 } from "react";
 import {
+  Linking,
   Platform,
   type StyleProp,
   StyleSheet,
@@ -26,6 +27,7 @@ import {
   type MapViewRef,
   type NavigateToPointPayload,
   type NavigateToPoiPayload,
+  type OnExternalLinkClickedResult,
   type OnFloorChangedResult,
   type OnPoiDeselectedResult,
   type OnPoiSelectedResult,
@@ -69,6 +71,13 @@ export interface MapViewProps {
   onLoad?: (event: any) => void;
   onLoadError?: (event: MapViewError) => void;
   onFloorChanged?: (event: OnFloorChangedResult) => void;
+  /**
+   * Callback invoked when the user clicks on a link in the MapView that leads to a website different from the MapView's domain.
+   * If this callback is not set, the link will be opened in the system's default browser by default.
+   * @param event OnExternalLinkClickedResult object.
+   * @returns
+   */
+  onExternalLinkClicked?: (event: OnExternalLinkClickedResult) => void;
 }
 
 const MapView = React.forwardRef<MapViewRef, MapViewProps>(
@@ -81,6 +90,7 @@ const MapView = React.forwardRef<MapViewRef, MapViewProps>(
       onPoiSelected = () => {},
       onPoiDeselected = () => {},
       onFloorChanged = () => {},
+      onExternalLinkClicked = undefined,
     },
     ref
   ) => {
@@ -230,7 +240,13 @@ const MapView = React.forwardRef<MapViewRef, MapViewProps>(
           },
         };
       },
-      [stopNavigation, _navigateToPoi, _navigateToPoint, _selectPoi]
+      [
+        stopNavigation,
+        _navigateToPoi,
+        _navigateToPoint,
+        _selectPoi,
+        _selectPoiCategory,
+      ]
     );
 
     useEffect(() => {
@@ -344,6 +360,25 @@ const MapView = React.forwardRef<MapViewRef, MapViewProps>(
       }
     };
 
+    const _onShouldStartLoadWithRequest = (request) => {
+      if (
+        request &&
+        request.url &&
+        !request.url.startsWith(configuration.viewerDomain || SITUM_BASE_DOMAIN)
+      ) {
+        if (
+          onExternalLinkClicked &&
+          typeof onExternalLinkClicked === "function"
+        ) {
+          onExternalLinkClicked({ url: request.url });
+        } else {
+          Linking.openURL(request.url);
+        }
+        return false;
+      }
+      return true;
+    };
+
     return (
       <WebView
         ref={webViewRef}
@@ -367,6 +402,7 @@ const MapView = React.forwardRef<MapViewRef, MapViewProps>(
         startInLoadingState={true}
         cacheEnabled
         onMessage={handleRequestFromViewer}
+        onShouldStartLoadWithRequest={_onShouldStartLoadWithRequest}
         onError={(evt: WebViewErrorEvent) => {
           if (!onLoadError) return;
           const { nativeEvent } = evt;

package/src/wayfinding/hooks/index.ts

@@ -5,6 +5,8 @@ import SitumPlugin from "../../sdk";
 import {
   type Building,
   type Error,
+  ErrorCode,
+  ErrorType,
   type Location,
   type LocationStatus,
   type NavigationProgress,
@@ -77,8 +79,6 @@ export const useSitumInternal = () => {
 
     SitumPlugin.onLocationError((err: Error) => {
       console.error(`Situm > hook > Error while positioning: ${err}}`);
-      //@ts-ignore
-      dispatch(setError({ message: err, code: 3001 } as SDKError));
     });
 
     SitumPlugin.onLocationStopped(() => {
@@ -207,7 +207,14 @@ export const useSitumInternal = () => {
           });
         } catch (e) {
           console.error(`Situm > hook > Could not update navigation ${e}`);
-          dispatch(setError({ message: "error", code: 3051 } as Error));
+          //TODO: Remove this and emit these errors in SitumPlugin.onNavigationError
+          dispatch(
+            setError({
+              message: "Could not update navigation",
+              code: ErrorCode.UNKNOWN,
+              type: ErrorType.NON_CRITICAL,
+            } as Error)
+          );
           stopNavigation();
         }
       })
@@ -219,11 +226,11 @@ export const useSitumInternal = () => {
   };
 
   const stopNavigation = () => {
-    console.debug("Situm > hook > Stopping navigation");
     // TODO: we should delegate this to the sdk plugin
     if (!navigation || navigation?.status === NavigationStatus.STOP) {
       return;
     }
+    console.debug("Situm > hook > Stopping navigation");
 
     SitumPlugin.removeNavigationUpdates()
       .then(() => {

package/src/wayfinding/types/index.ts

@@ -58,6 +58,10 @@ export interface OnFloorChangedResult {
   toFloorName: string;
 }
 
+export interface OnExternalLinkClickedResult {
+  url: string;
+}
+
 export interface Destination {
   category: string;
   identifier?: string;