@bubblsdk/react-native-sdk 4.1.7 → 5.0.0-alpha.2

package/package.json

@@ -1,48 +1,129 @@
 {
   "name": "@bubblsdk/react-native-sdk",
-  "version": "4.1.7",
-  "description": "React Native wrapper for Bubbl SDK v3 native Android and iOS cores.",
-  "main": "src/index.ts",
-  "module": "src/index.ts",
-  "types": "src/index.ts",
-  "react-native": "src/index.ts",
-  "source": "src/index.ts",
+  "version": "5.0.0-alpha.2",
+  "description": "Bubbl for React Native: geofenced and scheduled notifications, surveys and analytics, over the native Bubbl SDKs.",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/commonjs/src/index.d.ts",
+  "react-native": "./src/index.ts",
+  "source": "./src/index.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "import": {
+        "types": "./lib/typescript/module/src/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/src/index.d.ts",
+        "default": "./lib/commonjs/index.js"
+      }
+    },
+    "./app.plugin.js": "./app.plugin.js",
+    "./jest": "./jest/index.js",
+    "./jest": "./jest/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android/build.gradle",
+    "android/src",
+    "ios",
+    "ios-sdk",
+    "ios-extension",
+    "BubblReactNativeSdk.podspec",
+    "plugin/build",
+    "app.plugin.js",
+    "jest",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
+    "!**/__tests__",
+    "!**/.*"
+  ],
   "repository": {
     "type": "git",
     "url": "git+https://github.com/bubbl-platform/renewed-sdk.git",
     "directory": "react-native"
   },
-  "license": "SEE LICENSE IN LICENSE",
+  "license": "Apache-2.0",
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "node ../scripts/validate-wrapper-surfaces.mjs --react-native",
-    "test": "node ../scripts/validate-wrapper-surfaces.mjs --react-native",
-    "typecheck": "node ../scripts/validate-wrapper-surfaces.mjs --react-native"
+    "build": "bob build && tsc -p plugin",
+    "test": "jest",
+    "typecheck": "tsc --noEmit && tsc -p plugin --noEmit",
+    "prepack": "npm run sync:ios && npm run build",
+    "sync:ios": "node scripts/sync-ios-sources.mjs"
   },
-  "files": [
-    "android/build.gradle",
-    "android/src",
-    "ios/BubblSdk.swift",
-    "ios/BubblSdkBridge.m",
-    "src",
-    "BubblReactNativeSdk.podspec",
-    "react-native.config.js",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
   "peerDependencies": {
+    "@expo/config-plugins": ">=9",
     "react": "*",
     "react-native": ">=0.76"
   },
+  "peerDependenciesMeta": {
+    "@expo/config-plugins": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@expo/config-plugins": "^57.0.9",
+    "@react-native/babel-preset": "0.87.1",
+    "@react-native/jest-preset": "^0.87.1",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.20.4",
+    "@types/react": "^19.1.0",
+    "jest": "^30.0.0",
+    "react": "19.2.3",
+    "react-native": "0.87.1",
+    "react-native-builder-bob": "^0.43.1",
+    "typescript": "^5.9.0"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "commonjs",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
   "codegenConfig": {
     "name": "BubblSdkSpec",
     "type": "modules",
-    "jsSrcsDir": "src/specs",
+    "jsSrcsDir": "src",
     "android": {
       "javaPackageName": "tech.bubbl.reactnative"
+    },
+    "ios": {
+      "modulesProvider": {
+        "BubblSdk": "BubblSdk"
+      }
     }
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/lib/",
+      "<rootDir>/example/",
+      "<rootDir>/example-expo/"
+    ]
   }
 }

package/plugin/build/imageNotifications.d.ts

@@ -0,0 +1,35 @@
+import { type ConfigPlugin, type ExportedConfig, type XcodeProject } from '@expo/config-plugins';
+/**
+ * ios.imageNotifications: pictures on Bubbl's pushes. Adds a Notification Service Extension target
+ * whose whole code is `class NotificationService: BubblNotificationService {}` (the iOS SDK's, from
+ * this package's ios-extension pod), its Podfile target, and EAS Build's entry for it (so EAS signs
+ * it). The same as the README's steps for a React Native CLI app, done at prebuild.
+ */
+/** The extension's target (and folder) name: not BubblNotificationService, the module it imports. */
+export declare const EXTENSION_TARGET = "BubblNotificationExtension";
+/**
+ * The extension's files, named after it: the xcode package reuses an existing file reference with the
+ * same path, so a common name (NotificationService.swift, Info.plist) could pick up another target's.
+ */
+export declare const SWIFT_FILE = "BubblNotificationExtension.swift";
+export declare const PLIST_FILE = "BubblNotificationExtension-Info.plist";
+/** The extension's Info.plist, with the app's version and build number (App Store requires them to match). */
+export declare function extensionInfoPlist(version: string, buildNumber: string): string;
+/** The Podfile with the extension's target, which gets Bubbl's service pod and nothing else. */
+export declare function podfileWithExtension(podfile: string): string;
+/**
+ * extra.eas.build.experimental.ios.appExtensions with the extension, which EAS Build needs to
+ * provision and sign it (anything else there is kept).
+ */
+export declare function withEasAppExtension(config: ExportedConfig, bundleIdentifier: string): ExportedConfig;
+/**
+ * The Xcode project with the extension target: its files in a group, its Sources, Frameworks
+ * and Resources phases, built before the app (a target dependency) and embedded in it (right
+ * after the app's Resources, ahead of the script phases, which Xcode otherwise reports as a
+ * build cycle). Nothing changes when the target is already there (a second prebuild).
+ */
+export declare function addNotificationExtension(project: XcodeProject, options: {
+    bundleIdentifier: string;
+    developmentTeam?: string;
+}): XcodeProject;
+export declare const withImageNotifications: ConfigPlugin;

package/plugin/build/imageNotifications.js

@@ -0,0 +1,198 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withImageNotifications = exports.PLIST_FILE = exports.SWIFT_FILE = exports.EXTENSION_TARGET = void 0;
+exports.extensionInfoPlist = extensionInfoPlist;
+exports.podfileWithExtension = podfileWithExtension;
+exports.withEasAppExtension = withEasAppExtension;
+exports.addNotificationExtension = addNotificationExtension;
+const config_plugins_1 = require("@expo/config-plugins");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * ios.imageNotifications: pictures on Bubbl's pushes. Adds a Notification Service Extension target
+ * whose whole code is `class NotificationService: BubblNotificationService {}` (the iOS SDK's, from
+ * this package's ios-extension pod), its Podfile target, and EAS Build's entry for it (so EAS signs
+ * it). The same as the README's steps for a React Native CLI app, done at prebuild.
+ */
+/** The extension's target (and folder) name: not BubblNotificationService, the module it imports. */
+exports.EXTENSION_TARGET = 'BubblNotificationExtension';
+/**
+ * The extension's deployment target when the app's can't be read: React Native's floor, which its
+ * pod (built for React Native's floor too) needs. It shows pictures on iOS 17 and up.
+ */
+const DEPLOYMENT_TARGET = '15.1';
+/**
+ * The extension's files, named after it: the xcode package reuses an existing file reference with the
+ * same path, so a common name (NotificationService.swift, Info.plist) could pick up another target's.
+ */
+exports.SWIFT_FILE = `${exports.EXTENSION_TARGET}.swift`;
+exports.PLIST_FILE = `${exports.EXTENSION_TARGET}-Info.plist`;
+const SERVICE_SWIFT = `// Written by @bubblsdk/react-native-sdk (ios.imageNotifications): pictures on Bubbl's pushes.
+import BubblNotificationService
+
+class NotificationService: BubblNotificationService {}
+`;
+/** The extension's Info.plist, with the app's version and build number (App Store requires them to match). */
+function extensionInfoPlist(version, buildNumber) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>CFBundleDevelopmentRegion</key>
+	<string>$(DEVELOPMENT_LANGUAGE)</string>
+	<key>CFBundleDisplayName</key>
+	<string>${exports.EXTENSION_TARGET}</string>
+	<key>CFBundleExecutable</key>
+	<string>$(EXECUTABLE_NAME)</string>
+	<key>CFBundleIdentifier</key>
+	<string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
+	<key>CFBundleInfoDictionaryVersion</key>
+	<string>6.0</string>
+	<key>CFBundleName</key>
+	<string>$(PRODUCT_NAME)</string>
+	<key>CFBundlePackageType</key>
+	<string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
+	<key>CFBundleShortVersionString</key>
+	<string>${escapeXml(version)}</string>
+	<key>CFBundleVersion</key>
+	<string>${escapeXml(buildNumber)}</string>
+	<key>NSExtension</key>
+	<dict>
+		<key>NSExtensionPointIdentifier</key>
+		<string>com.apple.usernotifications.service</string>
+		<key>NSExtensionPrincipalClass</key>
+		<string>$(PRODUCT_MODULE_NAME).NotificationService</string>
+	</dict>
+</dict>
+</plist>
+`;
+}
+function escapeXml(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+const PODFILE_MARK = '# @bubblsdk/react-native-sdk (ios.imageNotifications)';
+/** The Podfile with the extension's target, which gets Bubbl's service pod and nothing else. */
+function podfileWithExtension(podfile) {
+    if (podfile.includes(PODFILE_MARK)) {
+        return podfile;
+    }
+    return `${podfile.trimEnd()}
+
+${PODFILE_MARK}: pictures on Bubbl's pushes.
+target '${exports.EXTENSION_TARGET}' do
+  pod 'BubblReactNativeNotificationService', :path => File.join(File.dirname(\`node --print "require.resolve('@bubblsdk/react-native-sdk/package.json')"\`.strip), 'ios-extension')
+end
+`;
+}
+/**
+ * extra.eas.build.experimental.ios.appExtensions with the extension, which EAS Build needs to
+ * provision and sign it (anything else there is kept).
+ */
+function withEasAppExtension(config, bundleIdentifier) {
+    const extra = (config.extra ?? {});
+    const eas = extra.eas ?? {};
+    const build = eas.build ?? {};
+    const experimental = build.experimental ?? {};
+    const ios = experimental.ios ?? {};
+    const others = (ios.appExtensions ?? []).filter((ext) => ext.targetName !== exports.EXTENSION_TARGET);
+    const extension = { targetName: exports.EXTENSION_TARGET, bundleIdentifier, entitlements: {} };
+    config.extra = {
+        ...extra,
+        eas: { ...eas, build: { ...build, experimental: { ...experimental, ios: { ...ios, appExtensions: [...others, extension] } } } },
+    };
+    return config;
+}
+/**
+ * The Xcode project with the extension target: its files in a group, its Sources, Frameworks
+ * and Resources phases, built before the app (a target dependency) and embedded in it (right
+ * after the app's Resources, ahead of the script phases, which Xcode otherwise reports as a
+ * build cycle). Nothing changes when the target is already there (a second prebuild).
+ */
+function addNotificationExtension(project, options) {
+    // Its name is quoted once written out ("BubblNotificationExtension"), and bare before.
+    if (project.pbxTargetByName(exports.EXTENSION_TARGET) || project.pbxTargetByName(`"${exports.EXTENSION_TARGET}"`)) {
+        return project;
+    }
+    const objects = project.hash.project.objects;
+    // addTarget makes the app depend on the extension, but only when both sections exist.
+    objects.PBXTargetDependency = objects.PBXTargetDependency ?? {};
+    objects.PBXContainerItemProxy = objects.PBXContainerItemProxy ?? {};
+    const app = project.getFirstTarget();
+    const group = project.addPbxGroup([exports.SWIFT_FILE, exports.PLIST_FILE], exports.EXTENSION_TARGET, exports.EXTENSION_TARGET);
+    const mainGroup = project.getFirstProject().firstProject.mainGroup;
+    project.addToPbxGroup(group.uuid, mainGroup);
+    const target = project.addTarget(exports.EXTENSION_TARGET, 'app_extension', exports.EXTENSION_TARGET, `${options.bundleIdentifier}.${exports.EXTENSION_TARGET}`);
+    project.addBuildPhase([exports.SWIFT_FILE], 'PBXSourcesBuildPhase', 'Sources', target.uuid);
+    project.addBuildPhase([], 'PBXFrameworksBuildPhase', 'Frameworks', target.uuid);
+    project.addBuildPhase([], 'PBXResourcesBuildPhase', 'Resources', target.uuid);
+    embedAfterResources(project, app.uuid);
+    const configurations = project.pbxXCBuildConfigurationSection();
+    for (const [key, configuration] of Object.entries(configurations)) {
+        if (key.endsWith('_comment') || configuration.buildSettings?.PRODUCT_NAME !== `"${exports.EXTENSION_TARGET}"`) {
+            continue;
+        }
+        Object.assign(configuration.buildSettings, {
+            INFOPLIST_FILE: `${exports.EXTENSION_TARGET}/${exports.PLIST_FILE}`,
+            // The app's, as Xcode gives a new extension.
+            IPHONEOS_DEPLOYMENT_TARGET: appSetting(project, app.firstTarget, 'IPHONEOS_DEPLOYMENT_TARGET') ?? DEPLOYMENT_TARGET,
+            SWIFT_VERSION: '5.0',
+            // The app's (Expo's own mod sets every target's to the app's on later prebuilds anyway).
+            TARGETED_DEVICE_FAMILY: appSetting(project, app.firstTarget, 'TARGETED_DEVICE_FAMILY') ?? '"1,2"',
+            CLANG_ENABLE_MODULES: 'YES',
+            CODE_SIGN_STYLE: 'Automatic',
+            ...(options.developmentTeam ? { DEVELOPMENT_TEAM: options.developmentTeam } : {}),
+        });
+    }
+    return project;
+}
+/** A build setting of the app target (its first configuration that has it). */
+function appSetting(project, app, name) {
+    const lists = project.pbxXCConfigurationList();
+    const configurations = project.pbxXCBuildConfigurationSection();
+    return lists[app.buildConfigurationList]?.buildConfigurations
+        ?.map((entry) => configurations[entry.value]?.buildSettings?.[name])
+        .find((value) => value !== undefined);
+}
+/**
+ * Moves the "Copy Files" phase the xcode package just appended to the app (the last one: the app
+ * may have its own) to just after the app's Resources.
+ */
+function embedAfterResources(project, appUuid) {
+    const phases = project.pbxNativeTargetSection()[appUuid].buildPhases;
+    const embed = phases.map((phase) => phase.comment).lastIndexOf('Copy Files');
+    if (embed < 0 || !phases.some((phase) => phase.comment === 'Resources')) {
+        return;
+    }
+    const [phase] = phases.splice(embed, 1);
+    phases.splice(phases.findIndex((p) => p.comment === 'Resources') + 1, 0, phase);
+}
+const withImageNotifications = (config) => {
+    const bundleIdentifier = config.ios?.bundleIdentifier;
+    if (!bundleIdentifier) {
+        throw new Error('@bubblsdk/react-native-sdk: ios.imageNotifications needs ios.bundleIdentifier in the app config ' +
+            '(the extension\'s is it plus .BubblNotificationExtension).');
+    }
+    config = withEasAppExtension(config, `${bundleIdentifier}.${exports.EXTENSION_TARGET}`);
+    config = (0, config_plugins_1.withDangerousMod)(config, [
+        'ios',
+        (config) => {
+            const dir = (0, node_path_1.join)(config.modRequest.platformProjectRoot, exports.EXTENSION_TARGET);
+            (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+            (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, exports.SWIFT_FILE), SERVICE_SWIFT);
+            (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, exports.PLIST_FILE), extensionInfoPlist(config.version ?? '1.0.0', config.ios?.buildNumber ?? '1'));
+            return config;
+        },
+    ]);
+    config = (0, config_plugins_1.withXcodeProject)(config, (config) => {
+        config.modResults = addNotificationExtension(config.modResults, {
+            bundleIdentifier,
+            developmentTeam: config.ios?.appleTeamId,
+        });
+        return config;
+    });
+    return (0, config_plugins_1.withPodfile)(config, (config) => {
+        config.modResults.contents = podfileWithExtension(config.modResults.contents);
+        return config;
+    });
+};
+exports.withImageNotifications = withImageNotifications;

package/plugin/build/index.d.ts

@@ -0,0 +1,84 @@
+import { AndroidConfig, type ConfigPlugin, type XcodeProject } from '@expo/config-plugins';
+/**
+ * The Expo config plugin: what `npx expo prebuild` needs to add to the native projects for
+ * Bubbl, from one entry in app.json:
+ *
+ *     "plugins": [["@bubblsdk/react-native-sdk", { "android": { "cleartextHosts": ["10.0.2.2"] } }]]
+ *
+ * Android: the Bubbl SDK's manifest already brings its permissions, receivers and screens; this
+ * only raises the app's minSdkVersion to the SDK's, and (for development against a local API)
+ * allows plain http to the hosts listed.
+ *
+ * iOS: the location usage strings (the app's own, or Bubbl's defaults), the push entitlement
+ * (aps-environment: Bubbl sends to APNs directly), iOS 17 as the deployment target, and (for
+ * development) local networking over http; optionally (ios.imageNotifications) the extension that
+ * shows the pictures on Bubbl's pushes.
+ */
+export type BubblPluginProps = {
+    ios?: {
+        /** NSLocationWhenInUseUsageDescription, when the app doesn't set its own. */
+        locationWhenInUse?: string;
+        /** NSLocationAlwaysAndWhenInUseUsageDescription, when the app doesn't set its own. */
+        locationAlways?: string;
+        /** aps-environment: "development" (the default; App Store builds are re-signed for production) or "production". */
+        apsEnvironment?: 'development' | 'production';
+        /** NSAllowsLocalNetworking, for development against a local Bubbl API over http. Leave out of release builds. */
+        allowLocalNetworking?: boolean;
+        /**
+         * Pictures on Bubbl's pushes: adds a Notification Service Extension target
+         * (BubblNotificationExtension, bundle id: the app's + .BubblNotificationExtension), its Podfile
+         * target and its EAS Build entry. Needs ios.bundleIdentifier.
+         */
+        imageNotifications?: boolean;
+        /**
+         * Background app refresh: iOS wakes the app now and then and Bubbl sends what's queued. Adds
+         * "tech.bubbl.sdk.refresh" to BGTaskSchedulerPermittedIdentifiers and "fetch" to
+         * UIBackgroundModes (the app's own entries are kept).
+         */
+        backgroundRefresh?: boolean;
+    };
+    android?: {
+        /**
+         * Hosts the app may reach over plain http, for development against a local Bubbl API (e.g.
+         * "10.0.2.2", the emulator's host). Leave out of release builds: Bubbl only allows http to
+         * localhost, 10.0.2.2 and *.test anyway.
+         */
+        cleartextHosts?: string[];
+    };
+};
+/**
+ * The Bubbl Android SDK's minSdkVersion: Android 6 and up install it (Bubbl runs on 8.1, API 27,
+ * and up, and does nothing below). Expo's own default is higher, so this rarely changes anything.
+ */
+export declare const ANDROID_MIN_SDK = 23;
+type PropertiesItem = AndroidConfig.Properties.PropertiesItem;
+/**
+ * gradle.properties with android.minSdkVersion (which Expo's Android template reads) at least
+ * the SDK's: raised when an app set it lower; left alone when higher or unset (Expo's default,
+ * higher than the SDK's, applies then).
+ */
+export declare function raiseMinSdk(items: PropertiesItem[]): PropertiesItem[];
+export declare function networkSecurityConfig(hosts: string[]): string;
+/**
+ * The Bubbl iOS SDK's deployment target: iOS 13 and up install it (Bubbl runs on 17 and up and does
+ * nothing below). React Native's and Expo's own floors are higher, so this rarely changes anything.
+ */
+export declare const IOS_DEPLOYMENT_TARGET = "13.0";
+type Plist = Record<string, unknown>;
+/** Info.plist with Bubbl's keys: the app's own usage strings win over Bubbl's defaults. */
+export declare function bubblInfoPlist(plist: Plist, ios?: BubblPluginProps['ios']): Plist;
+/** The Bubbl iOS SDK's background refresh task. */
+export declare const BACKGROUND_REFRESH_TASK = "tech.bubbl.sdk.refresh";
+/**
+ * The deployment target, at least the SDK's: a lower one is raised, a higher one kept, and none
+ * stays none (Expo's and React Native's own default, higher than the SDK's, applies then).
+ */
+export declare function raiseDeploymentTarget(current: string | undefined): string | undefined;
+/**
+ * The app target's and the project's IPHONEOS_DEPLOYMENT_TARGET at least the SDK's where they're
+ * set (a higher one is kept). Podfile.properties.json has the pods'; this is the app's own. Other
+ * targets (an app's widget, say) are left as they are.
+ */
+export declare function raiseAppDeploymentTarget(project: XcodeProject): XcodeProject;
+declare const _default: ConfigPlugin<void | BubblPluginProps>;
+export default _default;

package/plugin/build/index.js

@@ -0,0 +1,176 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BACKGROUND_REFRESH_TASK = exports.IOS_DEPLOYMENT_TARGET = exports.ANDROID_MIN_SDK = void 0;
+exports.raiseMinSdk = raiseMinSdk;
+exports.networkSecurityConfig = networkSecurityConfig;
+exports.bubblInfoPlist = bubblInfoPlist;
+exports.raiseDeploymentTarget = raiseDeploymentTarget;
+exports.raiseAppDeploymentTarget = raiseAppDeploymentTarget;
+const config_plugins_1 = require("@expo/config-plugins");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const imageNotifications_1 = require("./imageNotifications");
+/**
+ * The Bubbl Android SDK's minSdkVersion: Android 6 and up install it (Bubbl runs on 8.1, API 27,
+ * and up, and does nothing below). Expo's own default is higher, so this rarely changes anything.
+ */
+exports.ANDROID_MIN_SDK = 23;
+const NETWORK_CONFIG = 'bubbl_network_security_config';
+/**
+ * gradle.properties with android.minSdkVersion (which Expo's Android template reads) at least
+ * the SDK's: raised when an app set it lower; left alone when higher or unset (Expo's default,
+ * higher than the SDK's, applies then).
+ */
+function raiseMinSdk(items) {
+    const key = 'android.minSdkVersion';
+    const existing = items.find((item) => item.type === 'property' && item.key === key);
+    if (!existing || existing.type !== 'property') {
+        return items;
+    }
+    if (Number.parseInt(existing.value, 10) >= exports.ANDROID_MIN_SDK) {
+        return items;
+    }
+    return items.map((item) => (item === existing ? { ...existing, value: String(exports.ANDROID_MIN_SDK) } : item));
+}
+const withMinSdk = (config) => (0, config_plugins_1.withGradleProperties)(config, (config) => {
+    config.modResults = raiseMinSdk(config.modResults);
+    return config;
+});
+/** Plain http to the development hosts listed: a network security config naming only those. */
+const withCleartextHosts = (config, hosts) => {
+    config = (0, config_plugins_1.withDangerousMod)(config, [
+        'android',
+        (config) => {
+            const dir = (0, node_path_1.join)(config.modRequest.platformProjectRoot, 'app', 'src', 'main', 'res', 'xml');
+            (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+            (0, node_fs_1.writeFileSync)((0, node_path_1.join)(dir, `${NETWORK_CONFIG}.xml`), networkSecurityConfig(hosts));
+            return config;
+        },
+    ]);
+    return (0, config_plugins_1.withAndroidManifest)(config, (config) => {
+        const application = config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(config.modResults);
+        const existing = application.$['android:networkSecurityConfig'];
+        if (existing && existing !== `@xml/${NETWORK_CONFIG}`) {
+            throw new Error(`@bubblsdk/react-native-sdk: the app already has a network security config (${existing}). ` +
+                'Add the cleartext hosts to it yourself and leave android.cleartextHosts out.');
+        }
+        application.$['android:networkSecurityConfig'] = `@xml/${NETWORK_CONFIG}`;
+        return config;
+    });
+};
+function networkSecurityConfig(hosts) {
+    const domains = hosts.map((host) => `        <domain includeSubdomains="false">${escapeXml(host)}</domain>`).join('\n');
+    return [
+        '<?xml version="1.0" encoding="utf-8"?>',
+        '<!-- Written by @bubblsdk/react-native-sdk (android.cleartextHosts): plain http for development only. -->',
+        '<network-security-config>',
+        '    <domain-config cleartextTrafficPermitted="true">',
+        domains,
+        '    </domain-config>',
+        '</network-security-config>',
+        '',
+    ].join('\n');
+}
+function escapeXml(text) {
+    return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+/**
+ * The Bubbl iOS SDK's deployment target: iOS 13 and up install it (Bubbl runs on 17 and up and does
+ * nothing below). React Native's and Expo's own floors are higher, so this rarely changes anything.
+ */
+exports.IOS_DEPLOYMENT_TARGET = '13.0';
+const DEFAULT_WHEN_IN_USE = 'Your location is used to show offers and messages for places near you.';
+const DEFAULT_ALWAYS = 'Your location is used, even when the app is closed, to show offers and messages when you arrive at places.';
+/** Info.plist with Bubbl's keys: the app's own usage strings win over Bubbl's defaults. */
+function bubblInfoPlist(plist, ios = {}) {
+    const result = { ...plist };
+    result.NSLocationWhenInUseUsageDescription = ios.locationWhenInUse ?? plist.NSLocationWhenInUseUsageDescription ?? DEFAULT_WHEN_IN_USE;
+    result.NSLocationAlwaysAndWhenInUseUsageDescription =
+        ios.locationAlways ?? plist.NSLocationAlwaysAndWhenInUseUsageDescription ?? DEFAULT_ALWAYS;
+    if (ios.allowLocalNetworking) {
+        const ats = plist.NSAppTransportSecurity ?? {};
+        result.NSAppTransportSecurity = { ...ats, NSAllowsLocalNetworking: true };
+    }
+    if (ios.backgroundRefresh) {
+        result.BGTaskSchedulerPermittedIdentifiers = withItem(plist.BGTaskSchedulerPermittedIdentifiers, exports.BACKGROUND_REFRESH_TASK);
+        result.UIBackgroundModes = withItem(plist.UIBackgroundModes, 'fetch');
+    }
+    return result;
+}
+/** The Bubbl iOS SDK's background refresh task. */
+exports.BACKGROUND_REFRESH_TASK = 'tech.bubbl.sdk.refresh';
+/** A plist array with `item` in it once, the app's own entries kept in order. */
+function withItem(list, item) {
+    const items = Array.isArray(list) ? list.filter((entry) => typeof entry === 'string') : [];
+    return items.includes(item) ? items : [...items, item];
+}
+/**
+ * The deployment target, at least the SDK's: a lower one is raised, a higher one kept, and none
+ * stays none (Expo's and React Native's own default, higher than the SDK's, applies then).
+ */
+function raiseDeploymentTarget(current) {
+    const version = (text) => text.split('.').map((part) => Number.parseInt(part, 10) || 0);
+    if (!current) {
+        return current;
+    }
+    const [major = 0, minor = 0] = version(current);
+    const [minMajor = 0, minMinor = 0] = version(exports.IOS_DEPLOYMENT_TARGET);
+    return major > minMajor || (major === minMajor && minor >= minMinor) ? current : exports.IOS_DEPLOYMENT_TARGET;
+}
+/**
+ * The app target's and the project's IPHONEOS_DEPLOYMENT_TARGET at least the SDK's where they're
+ * set (a higher one is kept). Podfile.properties.json has the pods'; this is the app's own. Other
+ * targets (an app's widget, say) are left as they are.
+ */
+function raiseAppDeploymentTarget(project) {
+    const lists = project.pbxXCConfigurationList();
+    const configurations = project.pbxXCBuildConfigurationSection();
+    const app = project.getFirstTarget()?.firstTarget;
+    const projectList = project.getFirstProject().firstProject.buildConfigurationList;
+    for (const listId of [app?.buildConfigurationList, projectList]) {
+        for (const entry of (listId && lists[listId]?.buildConfigurations) || []) {
+            const settings = configurations[entry.value]?.buildSettings;
+            if (!settings) {
+                continue;
+            }
+            const current = settings.IPHONEOS_DEPLOYMENT_TARGET;
+            if (current !== undefined) {
+                settings.IPHONEOS_DEPLOYMENT_TARGET = raiseDeploymentTarget(String(current).replace(/"/g, ''));
+            }
+        }
+    }
+    return project;
+}
+const withBubblIos = (config, ios = {}) => {
+    config = (0, config_plugins_1.withInfoPlist)(config, (config) => {
+        config.modResults = bubblInfoPlist(config.modResults, ios);
+        return config;
+    });
+    config = (0, config_plugins_1.withEntitlementsPlist)(config, (config) => {
+        config.modResults['aps-environment'] = ios.apsEnvironment ?? config.modResults['aps-environment'] ?? 'development';
+        return config;
+    });
+    config = (0, config_plugins_1.withPodfileProperties)(config, (config) => {
+        const target = raiseDeploymentTarget(config.modResults['ios.deploymentTarget']);
+        if (target) {
+            config.modResults['ios.deploymentTarget'] = target;
+        }
+        return config;
+    });
+    config = (0, config_plugins_1.withXcodeProject)(config, (config) => {
+        config.modResults = raiseAppDeploymentTarget(config.modResults);
+        return config;
+    });
+    return ios.imageNotifications ? (0, imageNotifications_1.withImageNotifications)(config) : config;
+};
+const withBubbl = (config, props) => {
+    config = withMinSdk(config);
+    const hosts = props?.android?.cleartextHosts?.filter((host) => host.trim() !== '') ?? [];
+    if (hosts.length > 0) {
+        config = withCleartextHosts(config, hosts);
+    }
+    return withBubblIos(config, props?.ios);
+};
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const pkg = require('../../package.json');
+exports.default = (0, config_plugins_1.createRunOncePlugin)(withBubbl, pkg.name, pkg.version);

package/src/BubblModule.ts

@@ -0,0 +1,2 @@
+/** The native module, or null where it isn't in the build. On the web, BubblModule.web.ts. */
+export { default } from './NativeBubblSdk';

package/src/BubblModule.web.ts

@@ -0,0 +1,9 @@
+import type { Spec } from './NativeBubblSdk';
+
+/**
+ * No native module on the web, and react-native-web has no TurboModuleRegistry to ask for one, so
+ * NativeBubblSdk.ts isn't loaded at all: Bubbl's calls do nothing there.
+ */
+const BubblModule: Spec | null = null;
+
+export default BubblModule;