expo-live-activity 0.2.0-alpha3 → 0.2.0-alpha5

package/README.md

@@ -12,9 +12,11 @@
 - Listen and handle changes in push notification tokens associated with a live activity.
 
 ## Platform compatibility
-**Note:** This module is intended for use on **iOS devices only**. When methods are invoked on platforms other than iOS, they will throw an error, ensuring that they are used in the correct context.
+**Note:** This module is intended for use on **iOS devices only**. The minimal iOS version that supports Live Activities is 16.2. When methods are invoked on platforms other than iOS or on older iOS versions, they will log an error, ensuring that they are used in the correct context.
 
 ## Installation
+> [!NOTE]  
+> The library isn't supported in Expo Go, to set it up correctly you need to use [Expo DevClient](https://docs.expo.dev/versions/latest/sdk/dev-client/) .
 To begin using `expo-live-activity`, follow the installation and configuration steps outlined below:
 
 ### Step 1: Installation
@@ -33,49 +35,41 @@ The module comes with a built-in config plugin that creates a target in iOS with
       }
    }
    ```
+   If you want to update Live Acitivity with push notifications you can add option `"enablePushNotifications": true`:
+   ```json
+   {
+    "expo": {
+      "plugins": [
+        [
+          "expo-live-activity",
+          {
+            "enablePushNotifications": true
+          }
+        ]
+      ]
+    }
+   }
+   ```
 2. **Assets configuration:**
    Place images intended for live activities in the `assets/liveActivity` folder. The plugin manages these assets automatically.
 
+Then prebuild your app with:
+```sh
+npx expo prebuild --clean  
+```
+
 ### Step 3: Usage in Your React Native App
 Import the functionalities provided by the `expo-live-activity` module in your JavaScript or TypeScript files:
 ```javascript
 import * as LiveActivity from "expo-live-activity";
 ```
 
-## Push notifications
-By default, updating live activity is possible only via API. There is also a way to update live activity using push notifications. To enable that feature, add `"enablePushNotifications": true`. Then, the notification payload should be looking like this:
-
-```json
-{
-    "aps":{
-        "event":"update",
-        "content-state":{
-            "title":"Hello",
-            "subtitle":"World",
-            "date":1754064245000
-        },
-        "timestamp":1754063621319
-    }
-}
-```
-
-Where `date` value is a timestamp in milliseconds corresponding to the target point of the counter displayed in live activity view.
-
-## Image support
-Live activity view also supports image display. There are two dedicated fields for that:
-- `imageName`
-- `dynamicIslandImageName`
-Currently, it's possible to set them only via API, but we plan on to add that feature to push notifications as well. The value of each field can be:
-- a string which maps to an asset name
-- a URL to remote image
-The latter requires adding "App Groups" capability to both "main app" and "live activity" targets.
-
 ## API
 `expo-live-activity` module exports three primary functions to manage live activities:
 
 ### Managing Live Activities
-- **`startActivity(state: LiveActivityState, styles?: LiveActivityStyles)`**:
-  Start a new live activity. Takes a `state` configuration object for initial activity state and an optional `styles` object to customize appearance. It returns the `ID` of the created live activity, which should be stored for future reference.
+- **`startActivity(state: LiveActivityState, config?: LiveActivityConfig): string | undefined`**:
+  Start a new live activity. Takes a `state` configuration object for initial activity state and an optional `config` object to customize appearance or behavior. It returns the `ID` of the created live activity, which should be stored for future reference. If the live activity can't be created (eg. on android or iOS lower than 16.2), it will return `undefined`.
 
 - **`updateActivity(id: string, state: LiveActivityState)`**:
   Update an existing live activity. The `state` object should contain updated information. The `activityId` indicates which activity should be updated.
@@ -84,23 +78,27 @@ The latter requires adding "App Groups" capability to both "main app" and "live
   Terminate an ongoing live activity. The `state` object should contain the final state of the activity. The `activityId` indicates which activity should be stopped.
 
 ### Handling Push Notification Tokens
-- **`addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription)`**:
+- **`addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription | undefined`**:
   Subscribe to changes in the push notification token associated with live activities.
 
+
+### Deep linking
+When starting a new live activity, it's possible to pass `deepLinkUrl` field in `config` object. This can be any string that you can handle in your main app target. 
+
 ### State Object Structure
 The `state` object should include:
 ```javascript
 {
   title: string;
   subtitle?: string;
-  date?: number; // Set as epoch time in milliseconds
+  date?: number; // Set as epoch time in milliseconds. This is used as an end date in a timer.
   imageName?: string; // Matches the name of the image in 'assets/live-activity'
   dynamicIslandImageName?: string; // Matches the name of the image in 'assets/live-activity'
 };
 ```
 
-### Styles Object Structure
-The `styles` object should include:
+### Config Object Structure
+The `config` object should include:
 ```typescript
 {
    backgroundColor?: string;
@@ -108,6 +106,7 @@ The `styles` object should include:
    subtitleColor?: string;
    progressViewTint?: string;
    progressViewLabelColor?: string;
+   deepLinkUrl?: string;
    timerType?: DynamicIslandTimerType; // "circular" | "digital" - defines timer appereance on the dynamic island
 };
 ```
@@ -123,16 +122,17 @@ const state = {
   dynamicIslandImageName: "dynamic_island_image"
 };
 
-const styles = {
+const config = {
   backgroundColor: "#FFFFFF",
   titleColor: "#000000",
   subtitleColor: "#333333",
   progressViewTint: "#4CAF50",
   progressViewLabelColor: "#FFFFFF",
+  deepLinkUrl: "/dashboard",
   timerType: "circular"
 };
 
-const activityId = LiveActivity.startActivity(state, styles);
+const activityId = LiveActivity.startActivity(state, config);
 // Store activityId for future reference
 ```
 This will initiate a live activity with the specified title, subtitle, image from your configured assets folder and a time to which there will be a countdown in a progress view.
@@ -150,3 +150,32 @@ useEffect(() => {
   return () => subscription.remove();
 }, []);
 ```
+## Push notifications
+By default, updating live activity is possible only via API. If you want to have possibility to update live activity using push notifications, you can enable that feature by adding `"enablePushNotifications": true` in the plugin config in your `app.json` or `app.config.ts` file. Then, the notification payload should look like this:
+
+```json
+{
+    "aps":{
+        "event":"update",
+        "content-state":{
+            "title":"Hello",
+            "subtitle":"World",
+            "timerEndDateInMilliseconds":1754064245000,
+            "imageName": "live_activity_image",
+            "dynamicIslandImageName": "dynamic_island_image"
+        },
+        "timestamp":1754063621319 // timestamp of when the push notification was sent
+    }
+}
+```
+
+Where `timerEndDateInMilliseconds` value is a timestamp in milliseconds corresponding to the target point of the counter displayed in live activity view.
+
+## Image support
+Live activity view also supports image display. There are two dedicated fields in the `state` object for that:
+- `imageName`
+- `dynamicIslandImageName`
+
+The value of each field can be:
+- a string which maps to an asset name
+- a URL to remote image - currently, it's possible to use this option only via API, but we plan on to add that feature to push notifications as well. It also requires adding "App Groups" capability to both "main app" and "live activity" targets.

package/build/index.d.ts

@@ -7,12 +7,13 @@ export type LiveActivityState = {
     imageName?: string;
     dynamicIslandImageName?: string;
 };
-export type LiveActivityStyles = {
+export type LiveActivityConfig = {
     backgroundColor?: string;
     titleColor?: string;
     subtitleColor?: string;
     progressViewTint?: string;
     progressViewLabelColor?: string;
+    deepLinkUrl?: string;
     timerType?: DynamicIslandTimerType;
 };
 export type ActivityTokenReceivedEvent = {
@@ -24,22 +25,19 @@ export type LiveActivityModuleEvents = {
 };
 /**
  * @param {LiveActivityState} state The state for the live activity.
- * @param {LiveActivityStyles} styles Live activity styling object.
- * @returns {string} The identifier of the started activity.
- * @throws {Error} When function is called on a platform different from iOS.
+ * @param {LiveActivityConfig} config Live activity config object.
+ * @returns {string} The identifier of the started activity or undefined if creating live activity failed.
  */
-export declare function startActivity(state: LiveActivityState, styles?: LiveActivityStyles): string;
+export declare function startActivity(state: LiveActivityState, config?: LiveActivityConfig): string | undefined;
 /**
  * @param {string} id The identifier of the activity to stop.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @throws {Error} When function is called on a platform different from iOS.
  */
 export declare function stopActivity(id: string, state: LiveActivityState): any;
 /**
  * @param {string} id The identifier of the activity to update.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @throws {Error} When function is called on a platform different from iOS.
  */
 export declare function updateActivity(id: string, state: LiveActivityState): any;
-export declare function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription;
+export declare function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription | undefined;
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,CAK3F;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAKhE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAKlE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAAG,iBAAiB,CAKjH"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAC;CAC/D,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAWvG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAShE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OASlE;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAAG,iBAAiB,GAAG,SAAS,CAM7H"}

package/build/index.js

@@ -2,41 +2,56 @@ import ExpoLiveActivityModule from "./ExpoLiveActivityModule";
 import { Platform } from "react-native";
 /**
  * @param {LiveActivityState} state The state for the live activity.
- * @param {LiveActivityStyles} styles Live activity styling object.
- * @returns {string} The identifier of the started activity.
- * @throws {Error} When function is called on a platform different from iOS.
+ * @param {LiveActivityConfig} config Live activity config object.
+ * @returns {string} The identifier of the started activity or undefined if creating live activity failed.
  */
-export function startActivity(state, styles) {
+export function startActivity(state, config) {
     if (Platform.OS !== "ios") {
-        throw new Error("startActivity is only available on iOS");
+        console.error("startActivity is only available on iOS");
+        return undefined;
+    }
+    try {
+        return ExpoLiveActivityModule.startActivity(state, config);
+    }
+    catch (error) {
+        console.error(`startActivity failed with an error: ${error}`);
+        return undefined;
     }
-    return ExpoLiveActivityModule.startActivity(state, styles);
 }
 /**
  * @param {string} id The identifier of the activity to stop.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @throws {Error} When function is called on a platform different from iOS.
  */
 export function stopActivity(id, state) {
     if (Platform.OS !== "ios") {
-        throw new Error("stopActivity is only available on iOS");
+        console.error("stopActivity is only available on iOS");
+    }
+    try {
+        return ExpoLiveActivityModule.stopActivity(id, state);
+    }
+    catch (error) {
+        console.error(`stopActivity failed with an error: ${error}`);
     }
-    return ExpoLiveActivityModule.stopActivity(id, state);
 }
 /**
  * @param {string} id The identifier of the activity to update.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @throws {Error} When function is called on a platform different from iOS.
  */
 export function updateActivity(id, state) {
     if (Platform.OS !== "ios") {
-        throw new Error("updateActivity is only available on iOS");
+        console.error("updateActivity is only available on iOS");
+    }
+    try {
+        return ExpoLiveActivityModule.updateActivity(id, state);
+    }
+    catch (error) {
+        console.error(`updateActivity failed with an error: ${error}`);
     }
-    return ExpoLiveActivityModule.updateActivity(id, state);
 }
 export function addActivityTokenListener(listener) {
     if (Platform.OS !== "ios") {
-        throw new Error("updateActivity is only available on iOS");
+        console.error("addActivityTokenListener is only available on iOS");
+        return undefined;
     }
     return ExpoLiveActivityModule.addListener('onTokenReceived', listener);
 }

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AA+BxC;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAA2B;IACjF,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,sBAAsB,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC7D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAwB;IAC/D,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,sBAAsB,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,KAAwB;IACjE,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,sBAAsB,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAqD;IAC5F,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,sBAAsB,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACzE,CAAC","sourcesContent":["import ExpoLiveActivityModule from \"./ExpoLiveActivityModule\";\nimport { Platform } from \"react-native\";\nimport { EventSubscription } from 'expo-modules-core';\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\nexport type LiveActivityState = {\n  title: string;\n  subtitle?: string;\n  date?: number;\n  imageName?: string;\n  dynamicIslandImageName?: string;\n};\n\nexport type LiveActivityStyles = {\n  backgroundColor?: string;\n  titleColor?: string;\n  subtitleColor?: string;\n  progressViewTint?: string;\n  progressViewLabelColor?: string;\n  timerType?: DynamicIslandTimerType;\n};\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string;\n  activityPushToken: string;\n};\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void;\n};\n\n/**\n * @param {LiveActivityState} state The state for the live activity.\n * @param {LiveActivityStyles} styles Live activity styling object.\n * @returns {string} The identifier of the started activity.\n * @throws {Error} When function is called on a platform different from iOS.\n */\nexport function startActivity(state: LiveActivityState, styles?: LiveActivityStyles): string {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"startActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.startActivity(state, styles);\n}\n\n/**\n * @param {string} id The identifier of the activity to stop.\n * @param {LiveActivityState} state The updated state for the live activity.\n * @throws {Error} When function is called on a platform different from iOS.\n */\nexport function stopActivity(id: string, state: LiveActivityState) {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"stopActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.stopActivity(id, state);\n}\n\n/**\n * @param {string} id The identifier of the activity to update.\n * @param {LiveActivityState} state The updated state for the live activity.\n * @throws {Error} When function is called on a platform different from iOS.\n */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"updateActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.updateActivity(id, state);\n}\n\nexport function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription {\n  if (Platform.OS !== \"ios\") {\n    throw new Error(\"updateActivity is only available on iOS\");\n  }\n  return ExpoLiveActivityModule.addListener('onTokenReceived', listener);\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,sBAAsB,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAgCxC;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,KAAwB,EAAE,MAA2B;IACjF,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACxD,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,IAAI,CAAC;QACH,OAAO,sBAAsB,CAAC,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC7D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,uCAAuC,KAAK,EAAE,CAAC,CAAC;QAC9D,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,EAAU,EAAE,KAAwB;IAC/D,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,CAAC;QACH,OAAO,sBAAsB,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,sCAAsC,KAAK,EAAE,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,EAAU,EAAE,KAAwB;IACjE,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,CAAC;QACH,OAAO,sBAAsB,CAAC,cAAc,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC1D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,wCAAwC,KAAK,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,QAAqD;IAC5F,IAAI,QAAQ,CAAC,EAAE,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,SAAS,CAAA;IAClB,CAAC;IACD,OAAO,sBAAsB,CAAC,WAAW,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;AACzE,CAAC","sourcesContent":["import ExpoLiveActivityModule from \"./ExpoLiveActivityModule\";\nimport { Platform } from \"react-native\";\nimport { EventSubscription } from 'expo-modules-core';\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\nexport type LiveActivityState = {\n  title: string;\n  subtitle?: string;\n  date?: number;\n  imageName?: string;\n  dynamicIslandImageName?: string;\n};\n\nexport type LiveActivityConfig = {\n  backgroundColor?: string;\n  titleColor?: string;\n  subtitleColor?: string;\n  progressViewTint?: string;\n  progressViewLabelColor?: string;\n  deepLinkUrl?: string;\n  timerType?: DynamicIslandTimerType;\n};\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string;\n  activityPushToken: string;\n};\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void;\n};\n\n/**\n * @param {LiveActivityState} state The state for the live activity.\n * @param {LiveActivityConfig} config Live activity config object.\n * @returns {string} The identifier of the started activity or undefined if creating live activity failed.\n */\nexport function startActivity(state: LiveActivityState, config?: LiveActivityConfig): string | undefined {\n  if (Platform.OS !== \"ios\") {\n    console.error(\"startActivity is only available on iOS\");\n    return undefined\n  }\n  try {\n    return ExpoLiveActivityModule.startActivity(state, config);\n  } catch (error) {\n    console.error(`startActivity failed with an error: ${error}`);\n    return undefined\n  }\n}\n\n/**\n * @param {string} id The identifier of the activity to stop.\n * @param {LiveActivityState} state The updated state for the live activity.\n */\nexport function stopActivity(id: string, state: LiveActivityState) {\n  if (Platform.OS !== \"ios\") {\n    console.error(\"stopActivity is only available on iOS\");\n  }\n  try {\n    return ExpoLiveActivityModule.stopActivity(id, state);\n  } catch (error) {\n    console.error(`stopActivity failed with an error: ${error}`);\n  }\n}\n\n/**\n * @param {string} id The identifier of the activity to update.\n * @param {LiveActivityState} state The updated state for the live activity.\n */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (Platform.OS !== \"ios\") {\n    console.error(\"updateActivity is only available on iOS\");\n  }\n  try {\n    return ExpoLiveActivityModule.updateActivity(id, state);\n  } catch (error) {\n    console.error(`updateActivity failed with an error: ${error}`);\n  }\n}\n\nexport function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription | undefined {\n  if (Platform.OS !== \"ios\") {\n    console.error(\"addActivityTokenListener is only available on iOS\");\n    return undefined\n  }\n  return ExpoLiveActivityModule.addListener('onTokenReceived', listener);\n}\n"]}

package/ios/ExpoLiveActivityModule.swift

@@ -1,9 +1,10 @@
 import ActivityKit
 import ExpoModulesCore
 
-enum ModuleErrors: Error {
-  case unsupported
-  case liveActivitiesNotEnabled
+enum LiveActivityErrors: Error {
+    case unsupportedOS
+    case liveActivitiesNotEnabled
+    case unexpetedError(Error)
 }
 
 public class ExpoLiveActivityModule: Module {
@@ -24,7 +25,7 @@ public class ExpoLiveActivityModule: Module {
     var dynamicIslandImageName: String?
   }
 
-  struct LiveActivityStyles: Record {
+  struct LiveActivityConfig: Record {
     @Field
     var backgroundColor: String?
 
@@ -39,6 +40,9 @@ public class ExpoLiveActivityModule: Module {
 
     @Field
     var progressViewLabelColor: String?
+    
+    @Field
+    var deepLinkUrl: String?
 
     @Field
     var timerType: DynamicIslandTimerType?
@@ -59,10 +63,6 @@ public class ExpoLiveActivityModule: Module {
     )
   }
 
-  func toContentStateDate(date: Double?) -> Date? {
-    return date.map { Date(timeIntervalSince1970: $0 / 1000) }
-  }
-
   func updateImages(state: LiveActivityState, newState: inout LiveActivityAttributes.ContentState) async throws {
     if let name = state.imageName {
       print("imageName: \(name)")
@@ -80,31 +80,33 @@ public class ExpoLiveActivityModule: Module {
 
     Events("onTokenReceived")
 
-    Function("startActivity") { (state: LiveActivityState, styles: LiveActivityStyles?) -> String in
+    Function("startActivity") { (state: LiveActivityState, maybeConfig: LiveActivityConfig?) -> String in
       print("Starting activity")
       if #available(iOS 16.2, *) {
         if ActivityAuthorizationInfo().areActivitiesEnabled {
           do {
+            let config = maybeConfig ?? LiveActivityConfig()
             let attributes = LiveActivityAttributes(
               name: "ExpoLiveActivity",
-              backgroundColor: styles?.backgroundColor,
-              titleColor: styles?.titleColor,
-              subtitleColor: styles?.subtitleColor,
-              progressViewTint: styles?.progressViewTint,
-              progressViewLabelColor: styles?.progressViewLabelColor,
-              timerType: styles?.timerType == .digital ? .digital : .circular
+              backgroundColor: config.backgroundColor,
+              titleColor: config.titleColor,
+              subtitleColor: config.subtitleColor,
+              progressViewTint: config.progressViewTint,
+              progressViewLabelColor: config.progressViewLabelColor,
+              deepLinkUrl: config.deepLinkUrl,
+              timerType: config.timerType == .digital ? .digital : .circular
             )
             let initialState = LiveActivityAttributes.ContentState(
               title: state.title,
               subtitle: state.subtitle,
-              date: toContentStateDate(date: state.date),
+              timerEndDateInMilliseconds: state.date,
             )
             let pushNotificationsEnabled =
-              Bundle.main.object(forInfoDictionaryKey: "ExpoLiveActivity_EnablePushNotifications")
+              Bundle.main.object(forInfoDictionaryKey: "ExpoLiveActivity_EnablePushNotifications") as? Bool
             let activity = try Activity.request(
               attributes: attributes,
               content: .init(state: initialState, staleDate: nil),
-              pushType: pushNotificationsEnabled == nil ? nil : .token
+              pushType: pushNotificationsEnabled == true ? .token : nil
             )
 
             Task {
@@ -124,11 +126,12 @@ public class ExpoLiveActivityModule: Module {
             return activity.id
           } catch (let error) {
             print("Error with live activity: \(error)")
+            throw LiveActivityErrors.unexpetedError(error)
           }
         }
-        throw ModuleErrors.liveActivitiesNotEnabled
+        throw LiveActivityErrors.liveActivitiesNotEnabled
       } else {
-        throw ModuleErrors.unsupported
+        throw LiveActivityErrors.unsupportedOS
       }
     }
 
@@ -138,7 +141,7 @@ public class ExpoLiveActivityModule: Module {
         var newState = LiveActivityAttributes.ContentState(
           title: state.title,
           subtitle: state.subtitle,
-          date: toContentStateDate(date: state.date),
+          timerEndDateInMilliseconds: state.date,
         )
         if let activity = Activity<LiveActivityAttributes>.activities.first(where: {
           $0.id == activityId
@@ -155,7 +158,7 @@ public class ExpoLiveActivityModule: Module {
           print("Didn't find activity with ID \(activityId)")
         }
       } else {
-        throw ModuleErrors.unsupported
+        throw LiveActivityErrors.unsupportedOS
       }
     }
 
@@ -165,7 +168,7 @@ public class ExpoLiveActivityModule: Module {
         var newState = LiveActivityAttributes.ContentState(
           title: state.title,
           subtitle: state.subtitle,
-          date: toContentStateDate(date: state.date),
+          timerEndDateInMilliseconds: state.date,
         )
         if let activity = Activity<LiveActivityAttributes>.activities.first(where: {
           $0.id == activityId
@@ -179,7 +182,7 @@ public class ExpoLiveActivityModule: Module {
           print("Didn't find activity with ID \(activityId)")
         }
       } else {
-        throw ModuleErrors.unsupported
+        throw LiveActivityErrors.unsupportedOS
       }
     }
   }

package/ios/LiveActivityAttributes.swift

@@ -12,7 +12,7 @@ struct LiveActivityAttributes: ActivityAttributes {
   public struct ContentState: Codable, Hashable {
     var title: String
     var subtitle: String?
-    var date: Date?
+    var timerEndDateInMilliseconds: Double?
     var imageName: String?
     var dynamicIslandImageName: String?
   }
@@ -23,7 +23,8 @@ struct LiveActivityAttributes: ActivityAttributes {
   var subtitleColor: String?
   var progressViewTint: String?
   var progressViewLabelColor: String?
-  var timerType: DynamicIslandTimerType
+  var deepLinkUrl: String?
+  var timerType: DynamicIslandTimerType?
 
   enum DynamicIslandTimerType: String, Codable {
     case circular

package/ios-files/LiveActivityView.swift

@@ -54,7 +54,7 @@ import WidgetKit
           }
         }
 
-        if let date = contentState.date {
+        if let date = contentState.timerEndDateInMilliseconds {
           ProgressView(timerInterval: Date.toTimerInterval(miliseconds: date))
             .tint(progressViewTint)
             .modifier(ConditionalForegroundViewModifier(color: attributes.progressViewLabelColor))

package/ios-files/LiveActivityWidget.swift

@@ -13,7 +13,7 @@ struct LiveActivityAttributes: ActivityAttributes {
   public struct ContentState: Codable, Hashable {
     var title: String
     var subtitle: String?
-    var date: Double?
+    var timerEndDateInMilliseconds: Double?
     var imageName: String?
     var dynamicIslandImageName: String?
   }
@@ -24,7 +24,8 @@ struct LiveActivityAttributes: ActivityAttributes {
   var subtitleColor: String?
   var progressViewTint: String?
   var progressViewLabelColor: String?
-  var timerType: DynamicIslandTimerType
+  var deepLinkUrl: String?
+  var timerType: DynamicIslandTimerType?
 
   enum DynamicIslandTimerType: String, Codable {
     case circular
@@ -37,49 +38,53 @@ struct LiveActivityWidget: Widget {
     ActivityConfiguration(for: LiveActivityAttributes.self) { context in
       LiveActivityView(contentState: context.state, attributes: context.attributes)
         .activityBackgroundTint(
-          context.attributes.backgroundColor != nil ? Color(hex: context.attributes.backgroundColor!) : nil
+          context.attributes.backgroundColor.map { Color(hex: $0) }
         )
         .activitySystemActionForegroundColor(Color.black)
-
+        .applyWidgetURL(from: context.attributes.deepLinkUrl)
     } dynamicIsland: { context in
       DynamicIsland {
         DynamicIslandExpandedRegion(.leading, priority: 1) {
           dynamicIslandExpandedLeading(title: context.state.title, subtitle: context.state.subtitle)
             .dynamicIsland(verticalPlacement: .belowIfTooWide)
             .padding(.leading, 5)
+            .applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
         DynamicIslandExpandedRegion(.trailing) {
           if let imageName = context.state.imageName {
             dynamicIslandExpandedTrailing(imageName: imageName)
               .padding(.trailing, 5)
+              .applyWidgetURL(from: context.attributes.deepLinkUrl)
           }
         }
         DynamicIslandExpandedRegion(.bottom) {
-          if let date = context.state.date {
+          if let date = context.state.timerEndDateInMilliseconds {
             dynamicIslandExpandedBottom(endDate: date, progressViewTint: context.attributes.progressViewTint)
               .padding(.horizontal, 5)
+              .applyWidgetURL(from: context.attributes.deepLinkUrl)
           }
         }
       } compactLeading: {
         if let dynamicIslandImageName = context.state.dynamicIslandImageName {
           resizableImage(imageName: dynamicIslandImageName)
             .frame(maxWidth: 23, maxHeight: 23)
+            .applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       } compactTrailing: {
-        if let date = context.state.date {
+        if let date = context.state.timerEndDateInMilliseconds {
           compactTimer(
             endDate: date,
-            timerType: context.attributes.timerType,
+            timerType: context.attributes.timerType ?? .circular,
             progressViewTint: context.attributes.progressViewTint
-          )
+          ).applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       } minimal: {
-        if let date = context.state.date {
+        if let date = context.state.timerEndDateInMilliseconds {
           compactTimer(
             endDate: date,
-            timerType: context.attributes.timerType,
+            timerType: context.attributes.timerType ?? .circular,
             progressViewTint: context.attributes.progressViewTint
-          )
+          ).applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       }
     }
@@ -100,7 +105,7 @@ struct LiveActivityWidget: Widget {
         .multilineTextAlignment(.trailing)
     } else {
       circularTimer(endDate: endDate)
-        .tint(progressViewTint != nil ? Color(hex: progressViewTint!) : nil)
+        .tint(progressViewTint.map { Color(hex: $0) })
     }
   }
 
@@ -133,7 +138,7 @@ struct LiveActivityWidget: Widget {
   private func dynamicIslandExpandedBottom(endDate: Double, progressViewTint: String?) -> some View {
     ProgressView(timerInterval: Date.toTimerInterval(miliseconds: endDate))
       .foregroundStyle(.white)
-      .tint(progressViewTint != nil ? Color(hex: progressViewTint!) : nil)
+      .tint(progressViewTint.map { Color(hex: $0) })
       .padding(.top, 5)
   }
 

package/ios-files/View+applyIfPresent.swift

@@ -0,0 +1,19 @@
+//
+//  View+applyIfPresent.swift
+//
+//
+//  Created by Artur Bilski on 05/08/2025.
+//
+
+import SwiftUI
+
+extension View {
+  @ViewBuilder
+  func applyIfPresent<T>(_ value: T?, transform: (Self, T) -> some View) -> some View {
+    if let value {
+      transform(self, value)
+    } else {
+      self
+    }
+  }
+}

package/ios-files/View+applyWidgetURL.swift

@@ -0,0 +1,15 @@
+//
+//  View+applyWidgetURL.swift
+//
+//
+//  Created by Artur Bilski on 05/08/2025.
+//
+
+import SwiftUI
+
+extension View {
+  @ViewBuilder
+  func applyWidgetURL(from urlString: String?) -> some View {
+    applyIfPresent(urlString) { view, string in view.widgetURL(URL(string: string))}
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-live-activity",
-  "version": "0.2.0-alpha3",
+  "version": "0.2.0-alpha5",
   "description": "A module for adding Live Activity to a React Native app for iOS.",
   "main": "build/index.js",
   "types": "build/index.d.ts",

package/plugin/build/lib/getWidgetFiles.js

@@ -97,7 +97,7 @@ function getWidgetFiles(targetPath) {
     const imagesXcassetsSource = path.join(liveActivityFilesPath, "Assets.xcassets");
     copyFolderRecursiveSync(imagesXcassetsSource, targetPath);
     // Move images to assets directory
-    if (fs.lstatSync(imageAssetsPath).isDirectory()) {
+    if (fs.existsSync(imageAssetsPath) && fs.lstatSync(imageAssetsPath).isDirectory()) {
         const imagesXcassetsTarget = path.join(targetPath, "Assets.xcassets");
         const files = fs.readdirSync(imageAssetsPath);
         files.forEach((file) => {
@@ -128,6 +128,9 @@ function getWidgetFiles(targetPath) {
             }
         });
     }
+    else {
+        console.warn(`Warning: Skipping adding images to live activity because directory does not exist at path: ${imageAssetsPath}`);
+    }
     return widgetFiles;
 }
 function copyFileSync(source, target) {

package/plugin/src/lib/getWidgetFiles.ts

@@ -75,7 +75,7 @@ export function getWidgetFiles(
   copyFolderRecursiveSync(imagesXcassetsSource, targetPath);
 
   // Move images to assets directory
-  if (fs.lstatSync(imageAssetsPath).isDirectory()) {
+  if (fs.existsSync(imageAssetsPath) && fs.lstatSync(imageAssetsPath).isDirectory()) {
     const imagesXcassetsTarget = path.join(targetPath, "Assets.xcassets");
 
     const files = fs.readdirSync(imageAssetsPath);
@@ -114,6 +114,8 @@ export function getWidgetFiles(
         );
       }
     })
+  } else {
+    console.warn(`Warning: Skipping adding images to live activity because directory does not exist at path: ${imageAssetsPath}`);
   }
 
   return widgetFiles;

package/src/index.ts

@@ -12,12 +12,13 @@ export type LiveActivityState = {
   dynamicIslandImageName?: string;
 };
 
-export type LiveActivityStyles = {
+export type LiveActivityConfig = {
   backgroundColor?: string;
   titleColor?: string;
   subtitleColor?: string;
   progressViewTint?: string;
   progressViewLabelColor?: string;
+  deepLinkUrl?: string;
   timerType?: DynamicIslandTimerType;
 };
 
@@ -32,44 +33,56 @@ export type LiveActivityModuleEvents = {
 
 /**
  * @param {LiveActivityState} state The state for the live activity.
- * @param {LiveActivityStyles} styles Live activity styling object.
- * @returns {string} The identifier of the started activity.
- * @throws {Error} When function is called on a platform different from iOS.
+ * @param {LiveActivityConfig} config Live activity config object.
+ * @returns {string} The identifier of the started activity or undefined if creating live activity failed.
  */
-export function startActivity(state: LiveActivityState, styles?: LiveActivityStyles): string {
+export function startActivity(state: LiveActivityState, config?: LiveActivityConfig): string | undefined {
   if (Platform.OS !== "ios") {
-    throw new Error("startActivity is only available on iOS");
+    console.error("startActivity is only available on iOS");
+    return undefined
+  }
+  try {
+    return ExpoLiveActivityModule.startActivity(state, config);
+  } catch (error) {
+    console.error(`startActivity failed with an error: ${error}`);
+    return undefined
   }
-  return ExpoLiveActivityModule.startActivity(state, styles);
 }
 
 /**
  * @param {string} id The identifier of the activity to stop.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @throws {Error} When function is called on a platform different from iOS.
  */
 export function stopActivity(id: string, state: LiveActivityState) {
   if (Platform.OS !== "ios") {
-    throw new Error("stopActivity is only available on iOS");
+    console.error("stopActivity is only available on iOS");
+  }
+  try {
+    return ExpoLiveActivityModule.stopActivity(id, state);
+  } catch (error) {
+    console.error(`stopActivity failed with an error: ${error}`);
   }
-  return ExpoLiveActivityModule.stopActivity(id, state);
 }
 
 /**
  * @param {string} id The identifier of the activity to update.
  * @param {LiveActivityState} state The updated state for the live activity.
- * @throws {Error} When function is called on a platform different from iOS.
  */
 export function updateActivity(id: string, state: LiveActivityState) {
   if (Platform.OS !== "ios") {
-    throw new Error("updateActivity is only available on iOS");
+    console.error("updateActivity is only available on iOS");
+  }
+  try {
+    return ExpoLiveActivityModule.updateActivity(id, state);
+  } catch (error) {
+    console.error(`updateActivity failed with an error: ${error}`);
   }
-  return ExpoLiveActivityModule.updateActivity(id, state);
 }
 
-export function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription {
+export function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): EventSubscription | undefined {
   if (Platform.OS !== "ios") {
-    throw new Error("updateActivity is only available on iOS");
+    console.error("addActivityTokenListener is only available on iOS");
+    return undefined
   }
   return ExpoLiveActivityModule.addListener('onTokenReceived', listener);
 }