expo-live-activity 0.4.2 → 0.4.3-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": {

package/build/index.d.ts

@@ -59,7 +59,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 +88,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":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAKrD,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAE3B,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D,KAAK,eAAe,GAChB;IACE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,GACD;IACE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAEL,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,OAAO,GACf;IACE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GACD,MAAM,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,CAAA;AAE7E,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEpD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,CAAA;AAClD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,cAAc,CAAA;IACrB,MAAM,EAAE,cAAc,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAA;AAElF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,sBAAsB,CAAA;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,UAAU,CAAC,EAAE,eAAe,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,qCAAqC,GAAG;IAClD,wBAAwB,EAAE,MAAM,CAAA;CACjC,CAAA;AAED,KAAK,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAE3E,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,aAAa,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAA;IAC7D,0BAA0B,EAAE,CAAC,MAAM,EAAE,qCAAqC,KAAK,IAAI,CAAA;IACnF,aAAa,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACrD,CAAA;AA8DD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAErG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAEhE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAElE;AAED,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GACpD,QAAQ,CAAC,iBAAiB,CAAC,CAE7B;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,CAAC,KAAK,EAAE,qCAAqC,KAAK,IAAI,GAC/D,QAAQ,CAAC,iBAAiB,CAAC,CAG7B;AAED,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GAC7C,QAAQ,CAAC,iBAAiB,CAAC,CAE7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAKrD,KAAK,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAE3B,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,CAAA;AAE3D,KAAK,eAAe,GAChB;IACE,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB,GACD;IACE,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAEL,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,eAAe,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,OAAO,GACf;IACE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,GACD,MAAM,CAAA;AAEV,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,aAAa,GAAG,cAAc,CAAA;AAE7E,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEpD,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,GAAG,MAAM,GAAG,CAAA;AAClD,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,cAAc,CAAA;IACrB,MAAM,EAAE,cAAc,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,YAAY,CAAA;AAElF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,sBAAsB,CAAA;IAClC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,UAAU,CAAC,EAAE,eAAe,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,0BAA0B,GAAG;IACvC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,qCAAqC,GAAG;IAClD,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAA;CACxC,CAAA;AAED,KAAK,aAAa,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,CAAA;AAE3E,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,aAAa,CAAA;CAC7B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,EAAE,CAAC,MAAM,EAAE,0BAA0B,KAAK,IAAI,CAAA;IAC7D,0BAA0B,EAAE,CAAC,MAAM,EAAE,qCAAqC,KAAK,IAAI,CAAA;IACnF,aAAa,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACrD,CAAA;AA8DD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,kBAAkB,GAAG,QAAQ,CAAC,MAAM,CAAC,CAErG;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAEhE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,OAElE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,mBAAmB,EAAE,CAAC,KAAK,EAAE,0BAA0B,KAAK,IAAI,GAC/D,QAAQ,CAAC,iBAAiB,CAAC,CAG7B;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,CAAC,KAAK,EAAE,qCAAqC,KAAK,IAAI,GAC/D,QAAQ,CAAC,iBAAiB,CAAC,CAG7B;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,CAAC,KAAK,EAAE,mBAAmB,KAAK,IAAI,GACnD,QAAQ,CAAC,iBAAiB,CAAC,CAG7B"}

package/build/index.js

@@ -74,16 +74,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\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 | 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, ...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\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

@@ -141,6 +141,10 @@ public class ExpoLiveActivityModule: Module {
   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 {
@@ -196,11 +200,14 @@ public class ExpoLiveActivityModule: Module {
   public func definition() -> ModuleDefinition {
     Name("ExpoLiveActivity")
 
-    OnCreate {
+    OnStartObserving("onTokenReceived") {
+      observeLiveActivityUpdates()
+    }
+
+    OnStartObserving("onPushToStartTokenReceived") {
       if pushNotificationsEnabled {
         observePushToStartToken()
       }
-      observeLiveActivityUpdates()
     }
 
     Events("onTokenReceived", "onPushToStartTokenReceived", "onStateChange")

package/ios-files/LiveActivityView.swift

@@ -43,7 +43,7 @@ import WidgetKit
       attributes.progressViewTint.map { Color(hex: $0) }
     }
 
-    private var imageAlignment: Alignment {
+    private var imageVerticalAlignment: VerticalAlignment {
       switch attributes.imageAlign {
       case "center":
         return .center
@@ -54,7 +54,7 @@ import WidgetKit
       }
     }
 
-    private func alignedImage(imageName: String) -> some View {
+    private func alignedImage(imageName: String, horizontalAlignment: HorizontalAlignment) -> some View {
       let defaultHeight: CGFloat = 64
       let defaultWidth: CGFloat = 64
       let containerHeight = imageContainerSize?.height
@@ -94,7 +94,7 @@ import WidgetKit
 
       return ZStack(alignment: .center) {
         Group {
-          let fit = attributes.contentFit ?? "cover"
+          let fit = attributes.contentFit ?? "contain"
           switch fit {
           case "contain":
             Image.dynamic(assetNameOrPath: imageName).resizable().scaledToFit().frame(width: computedWidth, height: computedHeight)
@@ -135,7 +135,11 @@ import WidgetKit
           }
         }
       }
-      .frame(maxWidth: .infinity, maxHeight: .infinity, alignment: imageAlignment)
+      .frame(
+        maxWidth: .infinity,
+        maxHeight: .infinity,
+        alignment: Alignment(horizontal: horizontalAlignment, vertical: imageVerticalAlignment)
+      )
       .background(
         GeometryReader { proxy in
           Color.clear
@@ -191,7 +195,7 @@ import WidgetKit
         HStack(alignment: .center) {
           if hasImage, isLeftImage {
             if let imageName = contentState.imageName {
-              alignedImage(imageName: imageName)
+              alignedImage(imageName: imageName, horizontalAlignment: .leading)
             }
           }
 
@@ -221,9 +225,8 @@ import WidgetKit
           }.layoutPriority(1)
 
           if hasImage, !isLeftImage { // right side (default)
-            Spacer()
             if let imageName = contentState.imageName {
-              alignedImage(imageName: imageName)
+              alignedImage(imageName: imageName, horizontalAlignment: .trailing)
             }
           }
         }

package/ios-files/LiveActivityWidget.swift

@@ -2,14 +2,30 @@ import ActivityKit
 import SwiftUI
 import WidgetKit
 
-struct LiveActivityAttributes: ActivityAttributes {
-  struct ContentState: Codable, Hashable {
+public struct LiveActivityAttributes: ActivityAttributes {
+  public struct ContentState: Codable, Hashable {
     var title: String
     var subtitle: String?
     var timerEndDateInMilliseconds: Double?
     var progress: Double?
     var imageName: String?
     var dynamicIslandImageName: String?
+
+    public init(
+      title: String,
+      subtitle: String? = nil,
+      timerEndDateInMilliseconds: Double? = nil,
+      progress: Double? = nil,
+      imageName: String? = nil,
+      dynamicIslandImageName: String? = nil
+    ) {
+      self.title = title
+      self.subtitle = subtitle
+      self.timerEndDateInMilliseconds = timerEndDateInMilliseconds
+      self.progress = progress
+      self.imageName = imageName
+      self.dynamicIslandImageName = dynamicIslandImageName
+    }
   }
 
   var name: String
@@ -30,23 +46,78 @@ struct LiveActivityAttributes: ActivityAttributes {
   var imageAlign: String?
   var contentFit: String?
 
-  enum DynamicIslandTimerType: String, Codable {
+  public init(
+    name: String,
+    backgroundColor: String? = nil,
+    titleColor: String? = nil,
+    subtitleColor: String? = nil,
+    progressViewTint: String? = nil,
+    progressViewLabelColor: String? = nil,
+    deepLinkUrl: String? = nil,
+    timerType: DynamicIslandTimerType? = nil,
+    padding: Int? = nil,
+    paddingDetails: PaddingDetails? = nil,
+    imagePosition: String? = nil,
+    imageWidth: Int? = nil,
+    imageHeight: Int? = nil,
+    imageWidthPercent: Double? = nil,
+    imageHeightPercent: Double? = nil,
+    imageAlign: String? = nil,
+    contentFit: String? = nil
+  ) {
+    self.name = name
+    self.backgroundColor = backgroundColor
+    self.titleColor = titleColor
+    self.subtitleColor = subtitleColor
+    self.progressViewTint = progressViewTint
+    self.progressViewLabelColor = progressViewLabelColor
+    self.deepLinkUrl = deepLinkUrl
+    self.timerType = timerType
+    self.padding = padding
+    self.paddingDetails = paddingDetails
+    self.imagePosition = imagePosition
+    self.imageWidth = imageWidth
+    self.imageHeight = imageHeight
+    self.imageWidthPercent = imageWidthPercent
+    self.imageHeightPercent = imageHeightPercent
+    self.imageAlign = imageAlign
+    self.contentFit = contentFit
+  }
+
+  public enum DynamicIslandTimerType: String, Codable {
     case circular
     case digital
   }
 
-  struct PaddingDetails: Codable, Hashable {
+  public struct PaddingDetails: Codable, Hashable {
     var top: Int?
     var bottom: Int?
     var left: Int?
     var right: Int?
     var vertical: Int?
     var horizontal: Int?
+
+    public init(
+      top: Int? = nil,
+      bottom: Int? = nil,
+      left: Int? = nil,
+      right: Int? = nil,
+      vertical: Int? = nil,
+      horizontal: Int? = nil
+    ) {
+      self.top = top
+      self.bottom = bottom
+      self.left = left
+      self.right = right
+      self.vertical = vertical
+      self.horizontal = horizontal
+    }
   }
 }
 
-struct LiveActivityWidget: Widget {
-  var body: some WidgetConfiguration {
+@available(iOS 16.1, *)
+public struct LiveActivityWidget: Widget {
+  public var body: some WidgetConfiguration {
     ActivityConfiguration(for: LiveActivityAttributes.self) { context in
       LiveActivityView(contentState: context.state, attributes: context.attributes)
         .activityBackgroundTint(
@@ -76,6 +147,12 @@ struct LiveActivityWidget: Widget {
             )
             .padding(.horizontal, 5)
             .applyWidgetURL(from: context.attributes.deepLinkUrl)
+          } else if let progress = context.state.progress {
+            dynamicIslandExpandedBottomProgress(
+              progress: progress, progressViewTint: context.attributes.progressViewTint
+            )
+            .padding(.horizontal, 5)
+            .applyWidgetURL(from: context.attributes.deepLinkUrl)
           }
         }
       } compactLeading: {
@@ -91,6 +168,11 @@ struct LiveActivityWidget: Widget {
             timerType: context.attributes.timerType ?? .circular,
             progressViewTint: context.attributes.progressViewTint
           ).applyWidgetURL(from: context.attributes.deepLinkUrl)
+        } else if let progress = context.state.progress {
+          compactProgress(
+            progress: progress,
+            progressViewTint: context.attributes.progressViewTint
+          ).applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       } minimal: {
         if let date = context.state.timerEndDateInMilliseconds {
@@ -99,11 +181,18 @@ struct LiveActivityWidget: Widget {
             timerType: context.attributes.timerType ?? .circular,
             progressViewTint: context.attributes.progressViewTint
           ).applyWidgetURL(from: context.attributes.deepLinkUrl)
+        } else if let progress = context.state.progress {
+          compactProgress(
+            progress: progress,
+            progressViewTint: context.attributes.progressViewTint
+          ).applyWidgetURL(from: context.attributes.deepLinkUrl)
         }
       }
     }
   }
 
+  public init() {}
+
   @ViewBuilder
   private func compactTimer(
     endDate: Double,
@@ -166,4 +255,20 @@ struct LiveActivityWidget: Widget {
     )
     .progressViewStyle(.circular)
   }
+
+  private func compactProgress(
+    progress: Double,
+    progressViewTint: String?
+  ) -> some View {
+    ProgressView(value: progress)
+      .progressViewStyle(.circular)
+      .tint(progressViewTint.map { Color(hex: $0) })
+  }
+
+  private func dynamicIslandExpandedBottomProgress(progress: Double, progressViewTint: String?) -> some View {
+    ProgressView(value: progress)
+      .foregroundStyle(.white)
+      .tint(progressViewTint.map { Color(hex: $0) })
+      .padding(.top, 5)
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-live-activity",
-  "version": "0.4.2",
+  "version": "0.4.3-alpha1",
   "description": "A module for adding Live Activity to a React Native app for iOS.",
   "main": "build/index.js",
   "types": "build/index.d.ts",
@@ -9,6 +9,7 @@
     "clean": "expo-module clean",
     "clean:plugin": "rm -rf plugin/build plugin/tsconfig.tsbuildinfo",
     "format:check": "prettier --check .",
+    "format:fix": "prettier --write . && swiftformat --exclude \"**/node_modules/\" .",
     "lint": "expo-module eslint",
     "lint:libOnly": "expo-module eslint --ignore-pattern 'example/*'",
     "test": "expo-module test",
@@ -16,7 +17,10 @@
     "prepublishOnly": "expo-module prepublishOnly",
     "expo-module": "expo-module",
     "open:ios": "xed example/ios",
-    "typecheck": "tsc"
+    "typecheck": "tsc",
+    "generateTests": "node ./example/tests/scripts/generateFlows.js",
+    "runAllTests": "./example/tests/scripts/runAllTests.sh",
+    "generateTestReport": "node ./example/tests/scripts/generateReport.js"
   },
   "keywords": [
     "react-native",
@@ -47,7 +51,8 @@
     "expo": "~54.0.0",
     "expo-module-scripts": "^5.0.3",
     "prettier": "^3.6.2",
-    "react-native": "0.81.4"
+    "react-native": "0.81.4",
+    "pdf-lib": "^1.17.1"
   },
   "peerDependencies": {
     "expo": "*",

package/plugin/build/lib/getWidgetFiles.js

@@ -102,7 +102,7 @@ function getWidgetFiles(targetPath) {
         const imagesXcassetsTarget = path.join(targetPath, 'Assets.xcassets');
         const files = fs.readdirSync(imageAssetsPath);
         files.forEach((file) => {
-            if (path.extname(file).match(/\.(png|jpg|jpeg)$/)) {
+            if (path.extname(file).match(/\.(png|jpg|jpeg|svg)$/)) {
                 const source = path.join(imageAssetsPath, file);
                 const imageSetDir = path.join(imagesXcassetsTarget, `${path.basename(file, path.extname(file))}.imageset`);
                 // Create the .imageset directory if it doesn't exist

package/plugin/src/lib/getWidgetFiles.ts

@@ -78,7 +78,7 @@ export function getWidgetFiles(targetPath: string) {
     const files = fs.readdirSync(imageAssetsPath)
 
     files.forEach((file) => {
-      if (path.extname(file).match(/\.(png|jpg|jpeg)$/)) {
+      if (path.extname(file).match(/\.(png|jpg|jpeg|svg)$/)) {
         const source = path.join(imageAssetsPath, file)
         const imageSetDir = path.join(imagesXcassetsTarget, `${path.basename(file, path.extname(file))}.imageset`)
 

package/src/index.ts

@@ -79,7 +79,7 @@ export type ActivityTokenReceivedEvent = {
 }
 
 export type ActivityPushToStartTokenReceivedEvent = {
-  activityPushToStartToken: string
+  activityPushToStartToken: string | null
 }
 
 type ActivityState = 'active' | 'dismissed' | 'pending' | 'stale' | 'ended'
@@ -181,12 +181,21 @@ export function updateActivity(id: string, state: LiveActivityState) {
   if (assertIOS('updateActivity')) return ExpoLiveActivityModule.updateActivity(id, state)
 }
 
+/**
+ * @param {function} updateTokenListener The listener function that will be called when an update token is received.
+ */
 export function addActivityTokenListener(
-  listener: (event: ActivityTokenReceivedEvent) => void
+  updateTokenListener: (event: ActivityTokenReceivedEvent) => void
 ): Voidable<EventSubscription> {
-  if (assertIOS('addActivityTokenListener')) return ExpoLiveActivityModule.addListener('onTokenReceived', listener)
+  if (assertIOS('addActivityTokenListener'))
+    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: (event: ActivityPushToStartTokenReceivedEvent) => void
 ): Voidable<EventSubscription> {
@@ -194,8 +203,12 @@ export function addActivityPushToStartTokenListener(
     return ExpoLiveActivityModule.addListener('onPushToStartTokenReceived', listener)
 }
 
+/**
+ * @param {function} statusListener The listener function that will be called when an activity status changes.
+ */
 export function addActivityUpdatesListener(
-  listener: (event: ActivityUpdateEvent) => void
+  statusListener: (event: ActivityUpdateEvent) => void
 ): Voidable<EventSubscription> {
-  if (assertIOS('addActivityUpdatesListener')) return ExpoLiveActivityModule.addListener('onStateChange', listener)
+  if (assertIOS('addActivityUpdatesListener'))
+    return ExpoLiveActivityModule.addListener('onStateChange', statusListener)
 }