expo-live-activity 0.4.2 → 0.5.0-alpha1

package/Package.swift

@@ -0,0 +1,16 @@
+// swift-tools-version: 5.7
+
+import PackageDescription
+
+let package = Package(
+  name: "ExpoLiveActivity",
+  platforms: [.iOS(.v16)],
+  products: [.library(name: "ExpoLiveActivity", targets: ["ExpoLiveActivity"])],
+  targets: [
+    .target(
+      name: "ExpoLiveActivity",
+      path: "ios-files",
+      exclude: ["LiveActivityWidgetBundle.swift"]
+    ),
+  ]
+)

package/README.md

@@ -44,7 +44,7 @@ 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`:
+   If you want to update Live Activity with push notifications you can add option `"enablePushNotifications": true`:
    ```json
    {
      "expo": {
@@ -132,9 +132,12 @@ The `state` object should include:
 {
   title: string;
   subtitle?: string;
-  progressBar: { // Only one property, either date or progress, is available at a time as they share a single progress bar component
-    date?: number; // Set as epoch time in milliseconds. This is used as an end date in a timer.
-    progress?: number; //Set amount of progress in the progress bar
+  progressBar: { // Only one property (date, progress, or elapsedTimer) is available at a time
+    date?: number; // Set as epoch time in milliseconds. This is used as an end date in a countdown timer.
+    progress?: number; // Set amount of progress in the progress bar (0-1)
+    elapsedTimer?: { // Count up timer (elapsed time from start)
+      startDate: number; // Epoch time in milliseconds when the timer started
+    };
   };
   imageName?: string; // Matches the name of the image in 'assets/liveActivity'
   dynamicIslandImageName?: string; // Matches the name of the image in 'assets/liveActivity'
@@ -157,7 +160,7 @@ The `config` object should include:
    padding?: Padding // number | {top?: number bottom?: number ...}
    imagePosition?: ImagePosition; // 'left' | 'right';
    imageAlign?: ImageAlign; // 'top' | 'center' | 'bottom'
-   imageSize?: ImageSize // { width: number|`${number}%`, height: number|`${number}%` } | undefined (defaults to 64pt)
+   imageSize?: ImageSize // { width?: number|`${number}%`, height?: number|`${number}%` } | undefined (defaults to 64pt)
    contentFit?: ImageContentFit; // 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'
 };
 ```
@@ -202,6 +205,26 @@ const activityId = LiveActivity.startActivity(state, config)
 
 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.
 
+Using an elapsed timer:
+
+```typescript
+const elapsedTimerState: LiveActivity.LiveActivityState = {
+  title: 'Walk in Progress',
+  subtitle: 'With Max the Dog',
+  progressBar: {
+    elapsedTimer: {
+      startDate: Date.now() - 5 * 60 * 1000, // Started 5 minutes ago
+    },
+  },
+  imageName: 'dog_walking',
+  dynamicIslandImageName: 'dog_icon',
+}
+
+const activityId = LiveActivity.startActivity(elapsedTimerState, config)
+```
+
+The elapsed timer will automatically update every second based on the `startDate` you provide.
+
 Subscribing to push token changes:
 
 ```typescript
@@ -246,7 +269,8 @@ Example payload for starting Live Activity:
       "timerEndDateInMilliseconds": 1754410997000,
       "progress": 0.5,
       "imageName": "live_activity_image",
-      "dynamicIslandImageName": "dynamic_island_image"
+      "dynamicIslandImageName": "dynamic_island_image",
+      "elapsedTimerStartDateInMilliseconds": null
     },
     "timestamp": 1754491435000, // timestamp of when the push notification was sent
     "attributes-type": "LiveActivityAttributes",
@@ -290,7 +314,36 @@ Example payload for updating Live Activity:
 }
 ```
 
-Where `timerEndDateInMilliseconds` value is a timestamp in milliseconds corresponding to the target point of the counter displayed in Live Activity view.
+Where `timerEndDateInMilliseconds` value is a timestamp in milliseconds corresponding to the target point of the countdown displayed in Live Activity view.
+
+Example payload for starting Live Activity with elapsed timer:
+
+```json
+{
+  "aps": {
+    "event": "start",
+    "content-state": {
+      "title": "Walk in Progress",
+      "subtitle": "With Max",
+      "timerEndDateInMilliseconds": null,
+      "progress": null,
+      "imageName": "dog_walking",
+      "dynamicIslandImageName": "dog_icon",
+      "elapsedTimerStartDateInMilliseconds": 1754410997000
+    },
+    "timestamp": 1754491435000,
+    "attributes-type": "LiveActivityAttributes",
+    "attributes": {
+      "name": "WalkActivity",
+      "backgroundColor": "001A72",
+      "titleColor": "EBEBF0",
+      "progressViewLabelColor": "FFFFFF"
+    }
+  }
+}
+```
+
+Where `elapsedTimerStartDateInMilliseconds` is the timestamp (in milliseconds) when the elapsed timer started counting up.
 
 ## Image support
 

package/build/index.d.ts

@@ -1,12 +1,33 @@
 import { EventSubscription } from 'expo-modules-core';
 type Voidable<T> = T | void;
 export type DynamicIslandTimerType = 'circular' | 'digital';
+export type ElapsedTimer = {
+    startDate: number;
+};
 type ProgressBarType = {
     date?: number;
     progress?: undefined;
+    elapsedTimer?: undefined;
+    currentStep?: undefined;
+    totalSteps?: undefined;
 } | {
     date?: undefined;
     progress?: number;
+    elapsedTimer?: undefined;
+    currentStep?: undefined;
+    totalSteps?: undefined;
+} | {
+    date?: undefined;
+    progress?: undefined;
+    elapsedTimer?: ElapsedTimer;
+    currentStep?: undefined;
+    totalSteps?: undefined;
+} | {
+    date?: undefined;
+    progress?: undefined;
+    elapsedTimer?: undefined;
+    currentStep?: number;
+    totalSteps?: number;
 };
 export type LiveActivityState = {
     title: string;
@@ -14,6 +35,7 @@ export type LiveActivityState = {
     progressBar?: ProgressBarType;
     imageName?: string;
     dynamicIslandImageName?: string;
+    smallImageName?: string;
 };
 export type NativeLiveActivityState = {
     title: string;
@@ -35,8 +57,8 @@ export type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch';
 export type ImageAlign = 'top' | 'center' | 'bottom';
 export type ImageDimension = number | `${number}%`;
 export type ImageSize = {
-    width: ImageDimension;
-    height: ImageDimension;
+    width?: ImageDimension;
+    height?: ImageDimension;
 };
 export type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down';
 export type LiveActivityConfig = {
@@ -51,7 +73,10 @@ export type LiveActivityConfig = {
     imagePosition?: ImagePosition;
     imageAlign?: ImageAlign;
     imageSize?: ImageSize;
+    smallImageSize?: ImageSize;
     contentFit?: ImageContentFit;
+    progressSegmentActiveColor?: string;
+    progressSegmentInactiveColor?: string;
 };
 export type ActivityTokenReceivedEvent = {
     activityID: string;
@@ -59,7 +84,7 @@ export type ActivityTokenReceivedEvent = {
     activityPushToken: string;
 };
 export type ActivityPushToStartTokenReceivedEvent = {
-    activityPushToStartToken: string;
+    activityPushToStartToken: string | null;
 };
 type ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended';
 export type ActivityUpdateEvent = {
@@ -88,8 +113,19 @@ export declare function stopActivity(id: string, state: LiveActivityState): any;
  * @param {LiveActivityState} state The updated state for the live activity.
  */
 export declare function updateActivity(id: string, state: LiveActivityState): any;
-export declare function addActivityTokenListener(listener: (event: ActivityTokenReceivedEvent) => void): Voidable<EventSubscription>;
+/**
+ * @param {function} updateTokenListener The listener function that will be called when an update token is received.
+ */
+export declare function addActivityTokenListener(updateTokenListener: (event: ActivityTokenReceivedEvent) => void): Voidable<EventSubscription>;
+/**
+ * Adds a listener that is called when a push-to-start token is received. Supported only on iOS > 17.2.
+ * On earlier iOS versions, the listener will return null as a token.
+ * @param {function} listener The listener function that will be called when the observer starts and then when a push-to-start token is received.
+ */
 export declare function addActivityPushToStartTokenListener(listener: (event: ActivityPushToStartTokenReceivedEvent) => void): Voidable<EventSubscription>;
-export declare function addActivityUpdatesListener(listener: (event: ActivityUpdateEvent) => void): Voidable<EventSubscription>;
+/**
+ * @param {function} statusListener The listener function that will be called when an activity status changes.
+ */
+export declare function addActivityUpdatesListener(statusListener: (event: ActivityUpdateEvent) => void): Voidable<EventSubscription>;
 export {};
 //# 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":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/index.js

@@ -9,8 +9,12 @@ function assertIOS(name) {
 function normalizeConfig(config) {
     if (config === undefined)
         return config;
-    const { padding, imageSize, ...base } = config;
-    const normalized = { ...base };
+    const { padding, imageSize, smallImageSize, progressSegmentActiveColor, progressSegmentInactiveColor, ...base } = config;
+    const normalized = {
+        ...base,
+        progressSegmentActiveColor,
+        progressSegmentInactiveColor,
+    };
     // Normalize padding: keep number in padding, object in paddingDetails
     if (typeof padding === 'number') {
         normalized.padding = padding;
@@ -18,34 +22,43 @@ function normalizeConfig(config) {
     else if (typeof padding === 'object') {
         normalized.paddingDetails = padding;
     }
-    // Normalize imageSize: object with width/height each a number (points) or percent string like '50%'
-    if (imageSize) {
+    // Helper to parse a dimension value (number or percent string like '50%')
+    const parseDimension = (value, fieldName) => {
+        if (value === undefined)
+            return {};
+        if (typeof value === 'number')
+            return { absolute: value };
         const regExp = /^(100(?:\.0+)?|\d{1,2}(?:\.\d+)?)%$/; // Matches 0.0% to 100.0%
-        const { width, height } = imageSize;
-        if (typeof width === 'number') {
-            normalized.imageWidth = width;
-        }
-        else if (typeof width === 'string') {
-            const match = width.trim().match(regExp);
-            if (match) {
-                normalized.imageWidthPercent = Number(match[1]);
-            }
-            else {
-                throw new Error('imageSize.width percent string must be in format "0%" to "100%"');
-            }
-        }
-        if (typeof height === 'number') {
-            normalized.imageHeight = height;
-        }
-        else if (typeof height === 'string') {
-            const match = height.trim().match(regExp);
-            if (match) {
-                normalized.imageHeightPercent = Number(match[1]);
-            }
-            else {
-                throw new Error('imageSize.height percent string must be in format "0%" to "100%"');
-            }
-        }
+        const match = value.trim().match(regExp);
+        if (match)
+            return { percent: Number(match[1]) };
+        throw new Error(`${fieldName} percent string must be in format "0%" to "100%"`);
+    };
+    // Normalize imageSize
+    if (imageSize) {
+        const w = parseDimension(imageSize.width, 'imageSize.width');
+        const h = parseDimension(imageSize.height, 'imageSize.height');
+        if (w.absolute !== undefined)
+            normalized.imageWidth = w.absolute;
+        if (w.percent !== undefined)
+            normalized.imageWidthPercent = w.percent;
+        if (h.absolute !== undefined)
+            normalized.imageHeight = h.absolute;
+        if (h.percent !== undefined)
+            normalized.imageHeightPercent = h.percent;
+    }
+    // Normalize smallImageSize
+    if (smallImageSize) {
+        const w = parseDimension(smallImageSize.width, 'smallImageSize.width');
+        const h = parseDimension(smallImageSize.height, 'smallImageSize.height');
+        if (w.absolute !== undefined)
+            normalized.smallImageWidth = w.absolute;
+        if (w.percent !== undefined)
+            normalized.smallImageWidthPercent = w.percent;
+        if (h.absolute !== undefined)
+            normalized.smallImageHeight = h.absolute;
+        if (h.percent !== undefined)
+            normalized.smallImageHeightPercent = h.percent;
     }
     return normalized;
 }
@@ -74,16 +87,27 @@ export function updateActivity(id, state) {
     if (assertIOS('updateActivity'))
         return ExpoLiveActivityModule.updateActivity(id, state);
 }
-export function addActivityTokenListener(listener) {
+/**
+ * @param {function} updateTokenListener The listener function that will be called when an update token is received.
+ */
+export function addActivityTokenListener(updateTokenListener) {
     if (assertIOS('addActivityTokenListener'))
-        return ExpoLiveActivityModule.addListener('onTokenReceived', listener);
+        return ExpoLiveActivityModule.addListener('onTokenReceived', updateTokenListener);
 }
+/**
+ * Adds a listener that is called when a push-to-start token is received. Supported only on iOS > 17.2.
+ * On earlier iOS versions, the listener will return null as a token.
+ * @param {function} listener The listener function that will be called when the observer starts and then when a push-to-start token is received.
+ */
 export function addActivityPushToStartTokenListener(listener) {
     if (assertIOS('addActivityPushToStartTokenListener'))
         return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener);
 }
-export function addActivityUpdatesListener(listener) {
+/**
+ * @param {function} statusListener The listener function that will be called when an activity status changes.
+ */
+export function addActivityUpdatesListener(statusListener) {
     if (assertIOS('addActivityUpdatesListener'))
-        return ExpoLiveActivityModule.addListener('onStateChange', listener);
+        return ExpoLiveActivityModule.addListener('onStateChange', statusListener);
 }
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventSubscription } from 'expo-modules-core'\nimport { Platform } from 'react-native'\n\nimport ExpoLiveActivityModule from './ExpoLiveActivityModule'\n\ntype Voidable<T> = T | void\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\ntype ProgressBarType =\n  | {\n      date?: number\n      progress?: undefined\n    }\n  | {\n      date?: undefined\n      progress?: number\n    }\n\nexport type LiveActivityState = {\n  title: string\n  subtitle?: string\n  progressBar?: ProgressBarType\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type NativeLiveActivityState = {\n  title: string\n  subtitle?: string\n  date?: number\n  progress?: number\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type Padding =\n  | {\n      top?: number\n      bottom?: number\n      left?: number\n      right?: number\n      vertical?: number\n      horizontal?: number\n    }\n  | number\n\nexport type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch'\n\nexport type ImageAlign = 'top' | 'center' | 'bottom'\n\nexport type ImageDimension = number | `${number}%`\nexport type ImageSize = {\n  width: ImageDimension\n  height: ImageDimension\n}\n\nexport type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'\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  padding?: Padding\n  imagePosition?: ImagePosition\n  imageAlign?: ImageAlign\n  imageSize?: ImageSize\n  contentFit?: ImageContentFit\n}\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string\n  activityName: string\n  activityPushToken: string\n}\n\nexport type ActivityPushToStartTokenReceivedEvent = {\n  activityPushToStartToken: string\n}\n\ntype ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended'\n\nexport type ActivityUpdateEvent = {\n  activityID: string\n  activityName: string\n  activityState: ActivityState\n}\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void\n  onPushToStartTokenReceived: (params: ActivityPushToStartTokenReceivedEvent) => void\n  onStateChange: (params: ActivityUpdateEvent) => void\n}\n\nfunction assertIOS(name: string) {\n  const isIOS = Platform.OS === 'ios'\n\n  if (!isIOS) console.error(`${name} is only available on iOS`)\n\n  return isIOS\n}\n\nfunction normalizeConfig(config?: LiveActivityConfig) {\n  if (config === undefined) return config\n\n  const { padding, imageSize, ...base } = config\n  type NormalizedConfig = LiveActivityConfig & {\n    paddingDetails?: Padding\n    imageWidth?: number\n    imageHeight?: number\n    imageWidthPercent?: number\n    imageHeightPercent?: number\n  }\n  const normalized: NormalizedConfig = { ...base }\n\n  // Normalize padding: keep number in padding, object in paddingDetails\n  if (typeof padding === 'number') {\n    normalized.padding = padding\n  } else if (typeof padding === 'object') {\n    normalized.paddingDetails = padding\n  }\n\n  // Normalize imageSize: object with width/height each a number (points) or percent string like '50%'\n  if (imageSize) {\n    const regExp = /^(100(?:\\.0+)?|\\d{1,2}(?:\\.\\d+)?)%$/ // Matches 0.0% to 100.0%\n\n    const { width, height } = imageSize\n\n    if (typeof width === 'number') {\n      normalized.imageWidth = width\n    } else if (typeof width === 'string') {\n      const match = width.trim().match(regExp)\n      if (match) {\n        normalized.imageWidthPercent = Number(match[1])\n      } else {\n        throw new Error('imageSize.width percent string must be in format \"0%\" to \"100%\"')\n      }\n    }\n\n    if (typeof height === 'number') {\n      normalized.imageHeight = height\n    } else if (typeof height === 'string') {\n      const match = height.trim().match(regExp)\n      if (match) {\n        normalized.imageHeightPercent = Number(match[1])\n      } else {\n        throw new Error('imageSize.height percent string must be in format \"0%\" to \"100%\"')\n      }\n    }\n  }\n\n  return normalized\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): Voidable<string> {\n  if (assertIOS('startActivity')) return ExpoLiveActivityModule.startActivity(state, normalizeConfig(config))\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 (assertIOS('stopActivity')) 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 */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('updateActivity')) return ExpoLiveActivityModule.updateActivity(id, state)\n}\n\nexport function addActivityTokenListener(\n  listener: (event: ActivityTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityTokenListener')) return ExpoLiveActivityModule.addListener('onTokenReceived', listener)\n}\n\nexport function addActivityPushToStartTokenListener(\n  listener: (event: ActivityPushToStartTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityPushToStartTokenListener'))\n    return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener)\n}\n\nexport function addActivityUpdatesListener(\n  listener: (event: ActivityUpdateEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityUpdatesListener')) return ExpoLiveActivityModule.addListener('onStateChange', listener)\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["import { EventSubscription } from 'expo-modules-core'\nimport { Platform } from 'react-native'\n\nimport ExpoLiveActivityModule from './ExpoLiveActivityModule'\n\ntype Voidable<T> = T | void\n\nexport type DynamicIslandTimerType = 'circular' | 'digital'\n\nexport type ElapsedTimer = {\n  startDate: number // milliseconds timestamp (past time when timer started)\n}\n\ntype ProgressBarType =\n  | {\n      date?: number\n      progress?: undefined\n      elapsedTimer?: undefined\n      currentStep?: undefined\n      totalSteps?: undefined\n    }\n  | {\n      date?: undefined\n      progress?: number\n      elapsedTimer?: undefined\n      currentStep?: undefined\n      totalSteps?: undefined\n    }\n  | {\n      date?: undefined\n      progress?: undefined\n      elapsedTimer?: ElapsedTimer\n      currentStep?: undefined\n      totalSteps?: undefined\n    }\n  | {\n      date?: undefined\n      progress?: undefined\n      elapsedTimer?: undefined\n      currentStep?: number\n      totalSteps?: number\n    }\n\nexport type LiveActivityState = {\n  title: string\n  subtitle?: string\n  progressBar?: ProgressBarType\n  imageName?: string\n  dynamicIslandImageName?: string\n  smallImageName?: string\n}\n\nexport type NativeLiveActivityState = {\n  title: string\n  subtitle?: string\n  date?: number\n  progress?: number\n  imageName?: string\n  dynamicIslandImageName?: string\n}\n\nexport type Padding =\n  | {\n      top?: number\n      bottom?: number\n      left?: number\n      right?: number\n      vertical?: number\n      horizontal?: number\n    }\n  | number\n\nexport type ImagePosition = 'left' | 'right' | 'leftStretch' | 'rightStretch'\n\nexport type ImageAlign = 'top' | 'center' | 'bottom'\n\nexport type ImageDimension = number | `${number}%`\nexport type ImageSize = {\n  width?: ImageDimension\n  height?: ImageDimension\n}\n\nexport type ImageContentFit = 'cover' | 'contain' | 'fill' | 'none' | 'scale-down'\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  padding?: Padding\n  imagePosition?: ImagePosition\n  imageAlign?: ImageAlign\n  imageSize?: ImageSize\n  smallImageSize?: ImageSize\n  contentFit?: ImageContentFit\n  progressSegmentActiveColor?: string\n  progressSegmentInactiveColor?: string\n}\n\nexport type ActivityTokenReceivedEvent = {\n  activityID: string\n  activityName: string\n  activityPushToken: string\n}\n\nexport type ActivityPushToStartTokenReceivedEvent = {\n  activityPushToStartToken: string | null\n}\n\ntype ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended'\n\nexport type ActivityUpdateEvent = {\n  activityID: string\n  activityName: string\n  activityState: ActivityState\n}\n\nexport type LiveActivityModuleEvents = {\n  onTokenReceived: (params: ActivityTokenReceivedEvent) => void\n  onPushToStartTokenReceived: (params: ActivityPushToStartTokenReceivedEvent) => void\n  onStateChange: (params: ActivityUpdateEvent) => void\n}\n\nfunction assertIOS(name: string) {\n  const isIOS = Platform.OS === 'ios'\n\n  if (!isIOS) console.error(`${name} is only available on iOS`)\n\n  return isIOS\n}\n\nfunction normalizeConfig(config?: LiveActivityConfig) {\n  if (config === undefined) return config\n\n  const { padding, imageSize, smallImageSize, progressSegmentActiveColor, progressSegmentInactiveColor, ...base } =\n    config\n  type NormalizedConfig = LiveActivityConfig & {\n    paddingDetails?: Padding\n    imageWidth?: number\n    imageHeight?: number\n    imageWidthPercent?: number\n    imageHeightPercent?: number\n    smallImageWidth?: number\n    smallImageHeight?: number\n    smallImageWidthPercent?: number\n    smallImageHeightPercent?: number\n  }\n  const normalized: NormalizedConfig = {\n    ...base,\n    progressSegmentActiveColor,\n    progressSegmentInactiveColor,\n  }\n\n  // Normalize padding: keep number in padding, object in paddingDetails\n  if (typeof padding === 'number') {\n    normalized.padding = padding\n  } else if (typeof padding === 'object') {\n    normalized.paddingDetails = padding\n  }\n\n  // Helper to parse a dimension value (number or percent string like '50%')\n  const parseDimension = (\n    value: ImageDimension | undefined,\n    fieldName: string\n  ): { absolute?: number; percent?: number } => {\n    if (value === undefined) return {}\n\n    if (typeof value === 'number') return { absolute: value }\n    const regExp = /^(100(?:\\.0+)?|\\d{1,2}(?:\\.\\d+)?)%$/ // Matches 0.0% to 100.0%\n    const match = value.trim().match(regExp)\n    if (match) return { percent: Number(match[1]) }\n    throw new Error(`${fieldName} percent string must be in format \"0%\" to \"100%\"`)\n  }\n\n  // Normalize imageSize\n  if (imageSize) {\n    const w = parseDimension(imageSize.width, 'imageSize.width')\n    const h = parseDimension(imageSize.height, 'imageSize.height')\n    if (w.absolute !== undefined) normalized.imageWidth = w.absolute\n    if (w.percent !== undefined) normalized.imageWidthPercent = w.percent\n    if (h.absolute !== undefined) normalized.imageHeight = h.absolute\n    if (h.percent !== undefined) normalized.imageHeightPercent = h.percent\n  }\n\n  // Normalize smallImageSize\n  if (smallImageSize) {\n    const w = parseDimension(smallImageSize.width, 'smallImageSize.width')\n    const h = parseDimension(smallImageSize.height, 'smallImageSize.height')\n    if (w.absolute !== undefined) normalized.smallImageWidth = w.absolute\n    if (w.percent !== undefined) normalized.smallImageWidthPercent = w.percent\n    if (h.absolute !== undefined) normalized.smallImageHeight = h.absolute\n    if (h.percent !== undefined) normalized.smallImageHeightPercent = h.percent\n  }\n\n  return normalized\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): Voidable<string> {\n  if (assertIOS('startActivity')) return ExpoLiveActivityModule.startActivity(state, normalizeConfig(config))\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 (assertIOS('stopActivity')) 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 */\nexport function updateActivity(id: string, state: LiveActivityState) {\n  if (assertIOS('updateActivity')) return ExpoLiveActivityModule.updateActivity(id, state)\n}\n\n/**\n * @param {function} updateTokenListener The listener function that will be called when an update token is received.\n */\nexport function addActivityTokenListener(\n  updateTokenListener: (event: ActivityTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityTokenListener'))\n    return ExpoLiveActivityModule.addListener('onTokenReceived', updateTokenListener)\n}\n\n/**\n * Adds a listener that is called when a push-to-start token is received. Supported only on iOS > 17.2.\n * On earlier iOS versions, the listener will return null as a token.\n * @param {function} listener The listener function that will be called when the observer starts and then when a push-to-start token is received.\n */\nexport function addActivityPushToStartTokenListener(\n  listener: (event: ActivityPushToStartTokenReceivedEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityPushToStartTokenListener'))\n    return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener)\n}\n\n/**\n * @param {function} statusListener The listener function that will be called when an activity status changes.\n */\nexport function addActivityUpdatesListener(\n  statusListener: (event: ActivityUpdateEvent) => void\n): Voidable<EventSubscription> {\n  if (assertIOS('addActivityUpdatesListener'))\n    return ExpoLiveActivityModule.addListener('onStateChange', statusListener)\n}\n"]}

package/ios/ExpoLiveActivityModule.swift

@@ -18,6 +18,20 @@ public class ExpoLiveActivityModule: Module {
 
       @Field
       var progress: Double?
+
+      @Field
+      var elapsedTimer: ElapsedTimer?
+
+      @Field
+      var currentStep: Int?
+
+      @Field
+      var totalSteps: Int?
+
+      struct ElapsedTimer: Record {
+        @Field
+        var startDate: Double?
+      }
     }
 
     @Field
@@ -25,6 +39,9 @@ public class ExpoLiveActivityModule: Module {
 
     @Field
     var dynamicIslandImageName: String?
+
+    @Field
+    var smallImageName: String?
   }
 
   struct LiveActivityConfig: Record {
@@ -70,12 +87,30 @@ public class ExpoLiveActivityModule: Module {
     @Field
     var imageHeightPercent: Double?
 
+    @Field
+    var smallImageWidth: Int?
+
+    @Field
+    var smallImageHeight: Int?
+
+    @Field
+    var smallImageWidthPercent: Double?
+
+    @Field
+    var smallImageHeightPercent: Double?
+
     @Field
     var imageAlign: String?
 
     @Field
     var contentFit: String?
 
+    @Field
+    var progressSegmentActiveColor: String?
+
+    @Field
+    var progressSegmentInactiveColor: String?
+
     struct PaddingDetails: Record {
       @Field var top: Int?
       @Field var bottom: Int?
@@ -136,11 +171,19 @@ public class ExpoLiveActivityModule: Module {
     if let name = state.dynamicIslandImageName {
       newState.dynamicIslandImageName = try await resolveImage(from: name)
     }
+
+    if let name = state.smallImageName {
+      newState.smallImageName = try await resolveImage(from: name)
+    }
   }
 
   private func observePushToStartToken() {
     guard #available(iOS 17.2, *), ActivityAuthorizationInfo().areActivitiesEnabled else { return }
 
+    if let initialToken = (Activity<LiveActivityAttributes>.pushToStartToken?.reduce("") { $0 + String(format: "%02x", $1) }) {
+      sendPushToStartToken(activityPushToStartToken: initialToken)
+    }
+
     print("Observing push to start token updates...")
     Task {
       for await data in Activity<LiveActivityAttributes>.pushToStartTokenUpdates {
@@ -193,21 +236,34 @@ public class ExpoLiveActivityModule: Module {
       ?? false
   }
 
+  private var silentOnUnsupportedOS: Bool {
+    Bundle.main.object(forInfoDictionaryKey: "ExpoLiveActivity_SilentOnUnsupportedOS") as? Bool
+      ?? false
+  }
+
   public func definition() -> ModuleDefinition {
     Name("ExpoLiveActivity")
 
-    OnCreate {
+    OnStartObserving("onTokenReceived") {
+      observeLiveActivityUpdates()
+    }
+
+    OnStartObserving("onPushToStartTokenReceived") {
       if pushNotificationsEnabled {
         observePushToStartToken()
       }
-      observeLiveActivityUpdates()
     }
 
     Events("onTokenReceived", "onPushToStartTokenReceived", "onStateChange")
 
     Function("startActivity") {
       (state: LiveActivityState, maybeConfig: LiveActivityConfig?) -> String in
-      guard #available(iOS 16.2, *) else { throw UnsupportedOSException("16.2") }
+      guard #available(iOS 16.2, *) else {
+        if silentOnUnsupportedOS {
+          return ""
+        }
+        throw UnsupportedOSException("16.2")
+      }
 
       guard ActivityAuthorizationInfo().areActivitiesEnabled else {
         throw LiveActivitiesNotEnabledException()
@@ -241,15 +297,27 @@ public class ExpoLiveActivityModule: Module {
           imageHeight: config.imageHeight,
           imageWidthPercent: config.imageWidthPercent,
           imageHeightPercent: config.imageHeightPercent,
+          smallImageWidth: config.smallImageWidth,
+          smallImageHeight: config.smallImageHeight,
+          smallImageWidthPercent: config.smallImageWidthPercent,
+          smallImageHeightPercent: config.smallImageHeightPercent,
           imageAlign: config.imageAlign,
-          contentFit: config.contentFit
+          contentFit: config.contentFit,
+          progressSegmentActiveColor: config.progressSegmentActiveColor,
+          progressSegmentInactiveColor: config.progressSegmentInactiveColor
         )
 
         let initialState = LiveActivityAttributes.ContentState(
           title: state.title,
           subtitle: state.subtitle,
           timerEndDateInMilliseconds: state.progressBar?.date,
-          progress: state.progressBar?.progress
+          progress: state.progressBar?.progress,
+          imageName: state.imageName,
+          dynamicIslandImageName: state.dynamicIslandImageName,
+          smallImageName: state.smallImageName,
+          elapsedTimerStartDateInMilliseconds: state.progressBar?.elapsedTimer?.startDate,
+          currentStep: state.progressBar?.currentStep,
+          totalSteps: state.progressBar?.totalSteps
         )
 
         let activity = try Activity.request(
@@ -271,7 +339,12 @@ public class ExpoLiveActivityModule: Module {
     }
 
     Function("stopActivity") { (activityId: String, state: LiveActivityState) in
-      guard #available(iOS 16.2, *) else { throw UnsupportedOSException("16.2") }
+      guard #available(iOS 16.2, *) else {
+        if silentOnUnsupportedOS {
+          return
+        }
+        throw UnsupportedOSException("16.2")
+      }
 
       guard
         let activity = Activity<LiveActivityAttributes>.activities.first(where: {
@@ -285,7 +358,13 @@ public class ExpoLiveActivityModule: Module {
           title: state.title,
           subtitle: state.subtitle,
           timerEndDateInMilliseconds: state.progressBar?.date,
-          progress: state.progressBar?.progress
+          progress: state.progressBar?.progress,
+          imageName: state.imageName,
+          dynamicIslandImageName: state.dynamicIslandImageName,
+          smallImageName: state.smallImageName,
+          elapsedTimerStartDateInMilliseconds: state.progressBar?.elapsedTimer?.startDate,
+          currentStep: state.progressBar?.currentStep,
+          totalSteps: state.progressBar?.totalSteps
         )
         try await updateImages(state: state, newState: &newState)
         await activity.end(
@@ -297,6 +376,9 @@ public class ExpoLiveActivityModule: Module {
 
     Function("updateActivity") { (activityId: String, state: LiveActivityState) in
       guard #available(iOS 16.2, *) else {
+        if silentOnUnsupportedOS {
+          return
+        }
         throw UnsupportedOSException("16.2")
       }
 
@@ -312,7 +394,13 @@ public class ExpoLiveActivityModule: Module {
           title: state.title,
           subtitle: state.subtitle,
           timerEndDateInMilliseconds: state.progressBar?.date,
-          progress: state.progressBar?.progress
+          progress: state.progressBar?.progress,
+          imageName: state.imageName,
+          dynamicIslandImageName: state.dynamicIslandImageName,
+          smallImageName: state.smallImageName,
+          elapsedTimerStartDateInMilliseconds: state.progressBar?.elapsedTimer?.startDate,
+          currentStep: state.progressBar?.currentStep,
+          totalSteps: state.progressBar?.totalSteps
         )
         try await updateImages(state: state, newState: &newState)
         await activity.update(ActivityContent(state: newState, staleDate: nil))

package/ios/LiveActivityAttributes.swift

@@ -9,6 +9,10 @@ struct LiveActivityAttributes: ActivityAttributes {
     var progress: Double?
     var imageName: String?
     var dynamicIslandImageName: String?
+    var smallImageName: String?
+    var elapsedTimerStartDateInMilliseconds: Double?
+    var currentStep: Int?
+    var totalSteps: Int?
   }
 
   var name: String
@@ -26,8 +30,14 @@ struct LiveActivityAttributes: ActivityAttributes {
   var imageHeight: Int?
   var imageWidthPercent: Double?
   var imageHeightPercent: Double?
+  var smallImageWidth: Int?
+  var smallImageHeight: Int?
+  var smallImageWidthPercent: Double?
+  var smallImageHeightPercent: Double?
   var imageAlign: String?
   var contentFit: String?
+  var progressSegmentActiveColor: String?
+  var progressSegmentInactiveColor: String?
 
   enum DynamicIslandTimerType: String, Codable {
     case circular