onesignal-expo-plugin 2.5.1 → 2.7.0

package/README.md

@@ -58,19 +58,18 @@ Add the plugin to the **front** of the [plugin array](https://docs.expo.dev/vers
 
 or
 
-**app.config.js**
+**app.config.js/ts**
 
 ```js
+import withOneSignal from 'onesignal-expo-plugin/plugin';
+
 export default {
   ...
   plugins: [
-    [
-      "onesignal-expo-plugin",
-      {
-        mode: "development",
-      }
-    ]
-  ]
+    withOneSignal({
+      mode: 'development',
+    }),
+  ],
 };
 ```
 
@@ -90,9 +89,18 @@ You can pass props to the plugin config object to configure:
 | `appGroupName`           | optional       | Used to configure a custom iOS [App Group](https://documentation.onesignal.com/docs/ios-sdk-setup#step-3-create-an-app-group) name. If not provided, defaults to `"group.{ios.bundleIdentifier}.onesignal"`. e.g: `"group.com.example.myapp.onesignal2"`.                                                                                                                     |
 | `nseBundleIdentifier`    | optional       | Used to configure a custom bundle identifier suffix for the iOS Notification Service Extension. The full bundle identifier will be `"{ios.bundleIdentifier}.{nseBundleIdentifier}"`. If not provided, defaults to `"OneSignalNotificationServiceExtension"`.                                                                                                                  |
 | `disableNSE`             | optional       | If `true`, the iOS Notification Service Extension (NSE) will not be added to the project. The NSE is required for badges, confirmed delivery, media attachments, and action buttons. Only disable this if you only need basic push notifications.                                                                                                                             |
+| `disableLocation`        | optional       | If `true`, the native OneSignal location module will be excluded from iOS and Android builds. Use this if your app does not call `OneSignal.Location` and should not link native location APIs.                                                                                                                                                                               |
 | `sounds`                 | optional       | An array of local paths to custom notification sound files (`.wav` only, ≤30 seconds). Files are copied into the app bundle on iOS and `res/raw/` on Android. e.g: `["./assets/notification_sound.wav"]`. See https://documentation.onesignal.com/docs/customize-notification-sounds.                                                                                         |
 | `liveActivities`         | optional       | Opt in to scaffolding an iOS Widget Extension target for OneSignal Live Activities. Use `{}` for the default `OneSignalWidget` target, or pass `targetName`, `bundleIdentifierSuffix`, `widgetFilePath`, or `deploymentTarget` to customize it. See [Live Activities](#live-activities).                                                                                      |
 
+### Disabling Location
+
+When `disableLocation` is enabled, the plugin configures native dependency
+resolution so `react-native-onesignal` excludes the location module. On iOS, it
+writes the Podfile environment setting used during CocoaPods resolution. On
+Android, it writes `onesignal.disableLocation=true` to the generated Gradle
+properties.
+
 ### Live Activities
 
 Set `liveActivities` to an object to add the native iOS Widget Extension files and Podfile target required for OneSignal Live Activities.

package/dist/index.d.ts

@@ -1,100 +1,6 @@
+import { t as OneSignalPluginProps } from "./types-1HFwNzon.js";
 import { ConfigPlugin } from "expo/config-plugins.js";
 
-//#region src/types/types.d.ts
-/**
- * Configuration for the iOS Widget Extension target that hosts Live Activities.
- */
-type OneSignalLiveActivityProps = {
-  /**
-   * (optional) Custom widget extension target name. Defaults to "OneSignalWidget".
-   * The full bundle identifier becomes "{ios.bundleIdentifier}.{bundleIdentifierSuffix ?? targetName}".
-   */
-  targetName?: string;
-  /**
-   * (optional) Suffix appended to ios.bundleIdentifier for the widget extension. Defaults to targetName.
-   */
-  bundleIdentifierSuffix?: string;
-  /**
-   * (optional) Local path to a custom Live Activity widget Swift file. If omitted, ships a default
-   * widget built on `DefaultLiveActivityAttributes` so it works with `OneSignal.LiveActivities.setupDefault()`.
-   */
-  widgetFilePath?: string;
-  /**
-   * (optional) IPHONEOS_DEPLOYMENT_TARGET for the widget extension. Defaults to "16.2" (ActivityKit minimum).
-   * Values below 16.2 are clamped with a warning. Independent of the NSE's `iPhoneDeploymentTarget` prop.
-   */
-  deploymentTarget?: string;
-};
-/**
- * OneSignalPluginProps refer to the properties set by the user in their app config file (e.g: app.json)
- */
-type OneSignalPluginProps = {
-  /**
-   * (required) Used to configure APNs environment entitlement. "development" or "production"
-   */
-  mode: 'development' | 'production';
-  /**
-   * (optional) Used to configure Apple Team ID. You can find your Apple Team ID by running expo credentials:manager e.g: "91SW8A37CR"
-   * @deprecated Use `ios.appleTeamId` in your Expo config instead. This prop will be removed in a future major release.
-   */
-  devTeam?: string;
-  /**
-   * (optional) Target IPHONEOS_DEPLOYMENT_TARGET value to be used when adding the iOS NSE. A deployment target is nothing more than
-   * the minimum version of the operating system the application can run on. This value should match the value in your Podfile e.g: "12.0".
-   */
-  iPhoneDeploymentTarget?: string;
-  /**
-   * (optional) The small notification icons for Android.  Images will be automatically scaled up/down, the recommended size
-   * is 96x96 to always scale down.
-   */
-  smallIcons?: string[];
-  /**
-   * (optional) The accent color to use for notification icons on Android. Must be a valid Android color resource, for example: "#FF0000"
-   */
-  smallIconAccentColor?: string;
-  /**
-   * (optional) The large notification icons for Android. Images will be automatically scaled up/down to 256x256.
-   */
-  largeIcons?: string[];
-  /**
-   * (optional) Local path to a custom Notification Service Extension (NSE) source file.
-   * Both Swift (`.swift`) and Objective-C (`.m`) are supported. For `.m`, an optional sibling
-   * `NotificationService.h` will be picked up if present; otherwise the plugin's default header
-   * is used. Typically a copy of `serviceExtensionFiles/NotificationService.swift` or
-   * `NotificationService.m`, altered to support custom logic.
-   */
-  iosNSEFilePath?: string;
-  /**
-   * (optional) Used to configure a custom iOS app group name. If not provided, defaults to "group.{ios.bundleIdentifier}.onesignal".
-   * @see https://documentation.onesignal.com/docs/ios-sdk-setup#step-3-create-an-app-group
-   */
-  appGroupName?: string;
-  /**
-   * (optional) Used to configure a custom bundle identifier suffix for the iOS Notification Service Extension.
-   * The full bundle identifier will be "{ios.bundleIdentifier}.{nseBundleIdentifier}".
-   * If not provided, defaults to "OneSignalNotificationServiceExtension".
-   */
-  nseBundleIdentifier?: string;
-  /**
-   * (optional) If true, the iOS Notification Service Extension (NSE) will not be added to the project.
-   * The NSE is required for badges, confirmed delivery, media attachments, and action buttons.
-   * Only disable if you only need basic push notifications.
-   */
-  disableNSE?: boolean;
-  /**
-   * (optional) An array of local paths to custom notification sound files (.wav only).
-   * Files are added to the iOS app bundle and Android res/raw/.
-   * @see https://documentation.onesignal.com/docs/customize-notification-sounds
-   */
-  sounds?: string[];
-  /**
-   * (optional) Opt in to scaffolding an iOS Widget Extension target for Live Activities.
-   * Presence of this prop enables Live Activity setup. Requires iOS 16.1+ and a .p8 APNs key.
-   * @see https://documentation.onesignal.com/docs/cross-platform-live-activity-setup
-   */
-  liveActivities?: OneSignalLiveActivityProps;
-};
-//#endregion
 //#region src/onesignal/withOneSignal.d.ts
 declare const withOneSignal: ConfigPlugin<OneSignalPluginProps>;
 //#endregion

package/dist/index.js

@@ -28,21 +28,6 @@ let _expo_image_utils = require("@expo/image-utils");
 let expo_config_plugins_js = require("expo/config-plugins.js");
 let fs_promises = require("fs/promises");
 fs_promises = __toESM(fs_promises);
-//#region src/types/types.ts
-const ONESIGNAL_PLUGIN_PROPS = [
-	"mode",
-	"devTeam",
-	"iPhoneDeploymentTarget",
-	"smallIcons",
-	"largeIcons",
-	"iosNSEFilePath",
-	"smallIconAccentColor",
-	"appGroupName",
-	"nseBundleIdentifier",
-	"disableNSE",
-	"sounds",
-	"liveActivities"
-];
 const TARGETED_DEVICE_FAMILY = `"1,2"`;
 const GROUP_IDENTIFIER_TEMPLATE_REGEX = /{{GROUP_IDENTIFIER}}/gm;
 const BUNDLE_SHORT_VERSION_TEMPLATE_REGEX = /{{BUNDLE_SHORT_VERSION}}/gm;
@@ -51,9 +36,10 @@ const NSE_PRINCIPAL_CLASS_TEMPLATE_REGEX = /{{NSE_PRINCIPAL_CLASS}}/gm;
 const NSE_TARGET_NAME = "OneSignalNotificationServiceExtension";
 /** Default Swift template shipped under serviceExtensionFiles/. */
 const NSE_SOURCE_FILE = "NotificationService.swift";
-const NSE_PODFILE_SNIPPET = `
+const onesignalExtensionPodDependencies = (disableLocation) => disableLocation ? ["pod 'OneSignalXCFramework/OneSignal', '>= 5.0', '< 6.0'", "pod 'OneSignalXCFramework/OneSignalInAppMessages', '>= 5.0', '< 6.0'"].join("\n  ") : "pod 'OneSignalXCFramework', '>= 5.0', '< 6.0'";
+const nsePodfileSnippet = (disableLocation = false) => `
 target '${NSE_TARGET_NAME}' do
-  pod 'OneSignalXCFramework', '>= 5.0', '< 6.0'
+  ${onesignalExtensionPodDependencies(disableLocation)}
   use_frameworks! :linkage => podfile_properties['ios.useFrameworks'].to_sym if podfile_properties['ios.useFrameworks']
 end`;
 const NSE_PODFILE_REGEX = new RegExp(`target '${NSE_TARGET_NAME}'`);
@@ -63,9 +49,9 @@ const LIVE_ACTIVITY_DEPLOYMENT_TARGET = "16.2";
 const LIVE_ACTIVITY_BUNDLE_FILE = "OneSignalWidgetBundle.swift";
 const LIVE_ACTIVITY_WIDGET_FILE = "OneSignalWidgetLiveActivity.swift";
 const LIVE_ACTIVITY_INFO_PLIST_FILE = `${LIVE_ACTIVITY_TARGET_NAME}-Info.plist`;
-const liveActivityPodfileSnippet = (targetName) => `
+const liveActivityPodfileSnippet = (targetName, disableLocation = false) => `
 target '${targetName}' do
-  pod 'OneSignalXCFramework', '>= 5.0', '< 6.0'
+  ${onesignalExtensionPodDependencies(disableLocation)}
   use_frameworks! :linkage => podfile_properties['ios.useFrameworks'].to_sym if podfile_properties['ios.useFrameworks']
 end`;
 const liveActivityPodfileRegex = (targetName) => new RegExp(`target '${targetName}'`);
@@ -83,6 +69,27 @@ var OneSignalLog = class {
 //#region src/support/helpers.ts
 const HEX_COLOR_6_REGEX = /^#?[0-9A-Fa-f]{6}$/;
 const HEX_COLOR_8_REGEX = /^#?[0-9A-Fa-f]{8}$/;
+const ONESIGNAL_PLUGIN_PROPS = [
+	"mode",
+	"devTeam",
+	"iPhoneDeploymentTarget",
+	"smallIcons",
+	"largeIcons",
+	"iosNSEFilePath",
+	"smallIconAccentColor",
+	"appGroupName",
+	"nseBundleIdentifier",
+	"disableNSE",
+	"disableLocation",
+	"sounds",
+	"liveActivities"
+];
+const LIVE_ACTIVITY_PROPS = [
+	"targetName",
+	"bundleIdentifierSuffix",
+	"widgetFilePath",
+	"deploymentTarget"
+];
 /**
 * Converts a hex color string (#RGB, #RRGGBB, or #AARRGGBB) to an
 * 8-character ARGB hex string (no '#') expected by the OneSignal Android SDK.
@@ -108,6 +115,7 @@ function validatePluginProps(props) {
 	if (props.appGroupName && typeof props.appGroupName !== "string") throw new Error("OneSignal Expo Plugin: 'appGroupName' must be a string.");
 	if (props.nseBundleIdentifier && typeof props.nseBundleIdentifier !== "string") throw new Error("OneSignal Expo Plugin: 'nseBundleIdentifier' must be a string.");
 	if (props.disableNSE !== void 0 && typeof props.disableNSE !== "boolean") throw new Error("OneSignal Expo Plugin: 'disableNSE' must be a boolean.");
+	if (props.disableLocation !== void 0 && typeof props.disableLocation !== "boolean") throw new Error("OneSignal Expo Plugin: 'disableLocation' must be a boolean.");
 	if (props.sounds !== void 0) {
 		if (!Array.isArray(props.sounds)) throw new Error("OneSignal Expo Plugin: 'sounds' must be an array.");
 		for (const sound of props.sounds) {
@@ -118,19 +126,13 @@ function validatePluginProps(props) {
 	if (props.liveActivities !== void 0) {
 		if (props.liveActivities === null || Array.isArray(props.liveActivities) || typeof props.liveActivities !== "object") throw new Error("OneSignal Expo Plugin: 'liveActivities' must be an object.");
 		const liveActivities = props.liveActivities;
-		const liveActivityProps = [
-			"targetName",
-			"bundleIdentifierSuffix",
-			"widgetFilePath",
-			"deploymentTarget"
-		];
 		for (const prop of Object.keys(liveActivities)) {
-			if (!liveActivityProps.includes(prop)) throw new Error(`OneSignal Expo Plugin: You have provided an invalid property "${prop}" to 'liveActivities'.`);
+			if (!LIVE_ACTIVITY_PROPS.some((allowedProp) => allowedProp === prop)) throw new Error(`OneSignal Expo Plugin: You have provided an invalid property "${prop}" to 'liveActivities'.`);
 			if (typeof liveActivities[prop] !== "string") throw new Error(`OneSignal Expo Plugin: 'liveActivities.${prop}' must be a string.`);
 		}
 	}
 	const inputProps = Object.keys(props);
-	for (const prop of inputProps) if (!ONESIGNAL_PLUGIN_PROPS.includes(prop)) throw new Error(`OneSignal Expo Plugin: You have provided an invalid property "${prop}" to the OneSignal plugin.`);
+	for (const prop of inputProps) if (!ONESIGNAL_PLUGIN_PROPS.some((allowedProp) => allowedProp === prop)) throw new Error(`OneSignal Expo Plugin: You have provided an invalid property "${prop}" to the OneSignal plugin.`);
 }
 /**
 * Detect whether the customer's NSE is Swift or Objective-C from `iosNSEFilePath`.
@@ -175,6 +177,7 @@ function resolveDevTeam(config, props) {
 * @see https://documentation.onesignal.com/docs/react-native-sdk-setup#step-4-install-for-ios-using-cocoapods-for-ios-apps
 */
 const RESOURCE_ROOT_PATH = "android/app/src/main/res/";
+const ONESIGNAL_DISABLE_LOCATION_GRADLE_PROPERTY = "onesignal.disableLocation";
 const SMALL_ICON_DIRS_TO_SIZE = {
 	"drawable-mdpi": 24,
 	"drawable-hdpi": 36,
@@ -218,6 +221,21 @@ const withSmallIconAccentColor = (config, onesignalProps) => {
 		return config;
 	});
 };
+const withLocationModuleGradleProperty = (config, onesignalProps) => {
+	if (onesignalProps.disableLocation == null) return config;
+	return (0, expo_config_plugins_js.withGradleProperties)(config, (config) => {
+		const properties = config.modResults;
+		const existingIndex = properties.findIndex((entry) => entry.type === "property" && entry.key === ONESIGNAL_DISABLE_LOCATION_GRADLE_PROPERTY);
+		const property = {
+			type: "property",
+			key: ONESIGNAL_DISABLE_LOCATION_GRADLE_PROPERTY,
+			value: onesignalProps.disableLocation ? "true" : "false"
+		};
+		if (existingIndex === -1) properties.push(property);
+		else properties[existingIndex] = property;
+		return config;
+	});
+};
 async function saveIconsArrayAsync(projectRoot, icons, dirsToSize, defaultName) {
 	for (let i = 0; i < icons.length; i++) {
 		const outputName = i === 0 ? defaultName : void 0;
@@ -262,6 +280,7 @@ const withOneSignalAndroid = (config, props) => {
 	config = withSmallIcons(config, props);
 	config = withLargeIcons(config, props);
 	config = withSmallIconAccentColor(config, props);
+	config = withLocationModuleGradleProperty(config, props);
 	config = withSoundFiles$1(config, props);
 	return config;
 };
@@ -385,14 +404,26 @@ var NseUpdaterManager = class {
 };
 //#endregion
 //#region src/support/updatePodfile.ts
-async function updatePodfile(iosPath) {
+const ONESIGNAL_DISABLE_LOCATION_ENV = "ENV['ONESIGNAL_DISABLE_LOCATION']";
+const ONESIGNAL_DISABLE_LOCATION_REGEX = /^(?:ENV\[['"]ONESIGNAL_DISABLE_LOCATION['"]\]\s*=\s*['"](true|false)['"]|\$OneSignalDisableLocation\s*=\s*(true|false))\s*$/m;
+async function updatePodfile(iosPath, disableLocation = false) {
 	if ((await FileManager.readFile(`${iosPath}/Podfile`)).match(NSE_PODFILE_REGEX)) {
 		OneSignalLog.log(`${NSE_TARGET_NAME} target already added to Podfile. Skipping...`);
 		return;
 	}
-	await fs_promises.default.appendFile(`${iosPath}/Podfile`, NSE_PODFILE_SNIPPET);
+	await fs_promises.default.appendFile(`${iosPath}/Podfile`, nsePodfileSnippet(disableLocation));
 	OneSignalLog.log(`${NSE_TARGET_NAME} target added to Podfile.`);
 }
+async function updatePodfileLocationModule(iosPath, disableLocation) {
+	const podfilePath = `${iosPath}/Podfile`;
+	const podfile = await FileManager.readFile(podfilePath);
+	const nextValue = `${ONESIGNAL_DISABLE_LOCATION_ENV} = '${disableLocation ? "true" : "false"}'`;
+	if (ONESIGNAL_DISABLE_LOCATION_REGEX.test(podfile)) {
+		await fs_promises.default.writeFile(podfilePath, podfile.replace(ONESIGNAL_DISABLE_LOCATION_REGEX, nextValue));
+		return;
+	}
+	await fs_promises.default.writeFile(podfilePath, `${nextValue}\n${podfile}`);
+}
 //#endregion
 //#region src/onesignal/withOneSignalLiveActivity.ts
 /**
@@ -436,7 +467,7 @@ const withLiveActivityPodfile = (config, props) => {
 			OneSignalLog.log(`${targetName} target already added to Podfile. Skipping...`);
 			return config;
 		}
-		await fs.promises.appendFile(podfilePath, liveActivityPodfileSnippet(targetName));
+		await fs.promises.appendFile(podfilePath, liveActivityPodfileSnippet(targetName, props.disableLocation === true));
 		OneSignalLog.log(`${targetName} target added to Podfile.`);
 		return config;
 	}]);
@@ -581,9 +612,17 @@ const withEasManagedCredentials = (config, props) => {
 	config.extra = getEasManagedCredentialsConfigExtra(config, props?.appGroupName, props?.nseBundleIdentifier, props?.liveActivities, props?.disableNSE);
 	return config;
 };
-const withOneSignalPodfile = (config) => {
+const withOneSignalPodfile = (config, props) => {
+	return (0, expo_config_plugins_js.withDangerousMod)(config, ["ios", async (config) => {
+		await updatePodfile(path.join(config.modRequest.projectRoot, "ios"), props.disableLocation === true);
+		return config;
+	}]);
+};
+const withLocationModulePodfile = (config, props) => {
+	const disableLocation = props.disableLocation;
+	if (disableLocation == null) return config;
 	return (0, expo_config_plugins_js.withDangerousMod)(config, ["ios", async (config) => {
-		await updatePodfile(path.join(config.modRequest.projectRoot, "ios"));
+		await updatePodfileLocationModule(path.join(config.modRequest.projectRoot, "ios"), disableLocation);
 		return config;
 	}]);
 };
@@ -686,6 +725,7 @@ const withSoundFiles = (config, onesignalProps) => {
 const withOneSignalIos = (config, props) => {
 	config = withAppEnvironment(config, props);
 	config = withRemoteNotificationsPermissions(config, props);
+	config = withLocationModulePodfile(config, props);
 	if (!props.disableNSE) {
 		config = withCustomAppGroupsKey(config, props);
 		config = withAppGroupPermissions(config, props);

package/dist/plugin.d.ts

@@ -0,0 +1,8 @@
+import { t as OneSignalPluginProps } from "./types-1HFwNzon.js";
+
+//#region package.json.d.ts
+declare let name: string;
+//#endregion
+//#region src/onesignal/plugin.d.ts
+declare const withOneSignal: (props: OneSignalPluginProps) => [typeof name, OneSignalPluginProps];
+export = withOneSignal;

package/dist/plugin.js

@@ -0,0 +1,7 @@
+//#region package.json
+var name = "onesignal-expo-plugin";
+//#endregion
+//#region src/onesignal/plugin.ts
+const withOneSignal = (props) => [name, props];
+//#endregion
+module.exports = withOneSignal;

package/dist/types-1HFwNzon.d.ts

@@ -0,0 +1,101 @@
+//#region src/types.d.ts
+/**
+ * Configuration for the iOS Widget Extension target that hosts Live Activities.
+ */
+type OneSignalLiveActivityProps = {
+  /**
+   * (optional) Custom widget extension target name. Defaults to "OneSignalWidget".
+   * The full bundle identifier becomes "{ios.bundleIdentifier}.{bundleIdentifierSuffix ?? targetName}".
+   */
+  targetName?: string;
+  /**
+   * (optional) Suffix appended to ios.bundleIdentifier for the widget extension. Defaults to targetName.
+   */
+  bundleIdentifierSuffix?: string;
+  /**
+   * (optional) Local path to a custom Live Activity widget Swift file. If omitted, ships a default
+   * widget built on `DefaultLiveActivityAttributes` so it works with `OneSignal.LiveActivities.setupDefault()`.
+   */
+  widgetFilePath?: string;
+  /**
+   * (optional) IPHONEOS_DEPLOYMENT_TARGET for the widget extension. Defaults to "16.2" (ActivityKit minimum).
+   * Values below 16.2 are clamped with a warning. Independent of the NSE's `iPhoneDeploymentTarget` prop.
+   */
+  deploymentTarget?: string;
+};
+/**
+ * OneSignalPluginProps refer to the properties set by the user in their app config file (e.g: app.json)
+ */
+type OneSignalPluginProps = {
+  /**
+   * (required) Used to configure APNs environment entitlement. "development" or "production"
+   */
+  mode: 'development' | 'production';
+  /**
+   * (optional) Used to configure Apple Team ID. You can find your Apple Team ID by running expo credentials:manager e.g: "91SW8A37CR"
+   * @deprecated Use `ios.appleTeamId` in your Expo config instead. This prop will be removed in a future major release.
+   */
+  devTeam?: string;
+  /**
+   * (optional) Target IPHONEOS_DEPLOYMENT_TARGET value to be used when adding the iOS NSE. A deployment target is nothing more than
+   * the minimum version of the operating system the application can run on. This value should match the value in your Podfile e.g: "12.0".
+   */
+  iPhoneDeploymentTarget?: string;
+  /**
+   * (optional) The small notification icons for Android.  Images will be automatically scaled up/down, the recommended size
+   * is 96x96 to always scale down.
+   */
+  smallIcons?: string[];
+  /**
+   * (optional) The accent color to use for notification icons on Android. Must be a valid Android color resource, for example: "#FF0000"
+   */
+  smallIconAccentColor?: string;
+  /**
+   * (optional) The large notification icons for Android. Images will be automatically scaled up/down to 256x256.
+   */
+  largeIcons?: string[];
+  /**
+   * (optional) Local path to a custom Notification Service Extension (NSE) source file.
+   * Both Swift (`.swift`) and Objective-C (`.m`) are supported. For `.m`, an optional sibling
+   * `NotificationService.h` will be picked up if present; otherwise the plugin's default header
+   * is used. Typically a copy of `serviceExtensionFiles/NotificationService.swift` or
+   * `NotificationService.m`, altered to support custom logic.
+   */
+  iosNSEFilePath?: string;
+  /**
+   * (optional) Used to configure a custom iOS app group name. If not provided, defaults to "group.{ios.bundleIdentifier}.onesignal".
+   * @see https://documentation.onesignal.com/docs/ios-sdk-setup#step-3-create-an-app-group
+   */
+  appGroupName?: string;
+  /**
+   * (optional) Used to configure a custom bundle identifier suffix for the iOS Notification Service Extension.
+   * The full bundle identifier will be "{ios.bundleIdentifier}.{nseBundleIdentifier}".
+   * If not provided, defaults to "OneSignalNotificationServiceExtension".
+   */
+  nseBundleIdentifier?: string;
+  /**
+   * (optional) If true, the iOS Notification Service Extension (NSE) will not be added to the project.
+   * The NSE is required for badges, confirmed delivery, media attachments, and action buttons.
+   * Only disable if you only need basic push notifications.
+   */
+  disableNSE?: boolean;
+  /**
+   * (optional) If true, the native OneSignal location module will be excluded from iOS and Android builds.
+   * OneSignal.Location APIs will not collect location and will no-op or return false.
+   */
+  disableLocation?: boolean;
+  /**
+   * (optional) An array of local paths to custom notification sound files (.wav only).
+   * Files are added to the iOS app bundle and Android res/raw/.
+   * @see https://documentation.onesignal.com/docs/customize-notification-sounds
+   */
+  sounds?: string[];
+  /**
+   * (optional) Opt in to scaffolding an iOS Widget Extension target for Live Activities.
+   * Presence of this prop enables Live Activity setup. Requires iOS 16.1+ and a .p8 APNs key.
+   * @see https://documentation.onesignal.com/docs/cross-platform-live-activity-setup
+   */
+  liveActivities?: OneSignalLiveActivityProps;
+};
+//#endregion
+export { OneSignalPluginProps as t };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "onesignal-expo-plugin",
-  "version": "2.5.1",
+  "version": "2.7.0",
   "description": "OneSignal Expo config plugin for adding iOS and Android push notification support to managed Expo apps.",
   "keywords": [
     "EAS",
@@ -30,6 +30,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./plugin": {
+      "types": "./dist/plugin.d.ts",
+      "default": "./dist/plugin.js"
+    },
     "./package.json": "./package.json"
   },
   "scripts": {