feat: Align CocoaPods ObjC module name and kit imports

[denischilik]

Summary

• Set mParticle-Apple-SDK pod module_name to mParticle_Apple_SDK_ObjC and mParticle-Apple-SDK-Umbrella to mParticle_Apple_SDK for consistency with SPM product naming.
• Replace __has_include / bracket imports of mParticle_Apple_SDK/mParticle.h with @import mParticle_Apple_SDK_ObjC; across kit public headers, implementation files, tests, and Obj-C SPM examples.

Testing

• trunk check (pre-push hook) passed on pushed commit.

Made with Cursor

[cursor]

PR Summary

Medium Risk
Renames the CocoaPods module for the core ObjC SDK and updates many kit headers/examples to match, which can break downstream imports or kit builds if any module names or include paths are missed. Also changes release/publish automation and pod linting to publish an additional pod, so CI/release workflows could fail if ordering or dependency constraints are wrong.

Overview
Aligns CocoaPods module naming with SPM products by changing the mParticle-Apple-SDK pod module_name to mParticle_Apple_SDK_ObjC and updating kits/tests/SPM ObjC examples to import the SDK via @import mParticle_Apple_SDK_ObjC; / #import <mParticle_Apple_SDK.h> instead of __has_include-based header paths.

Introduces a new CocoaPods spec mParticle-Apple-SDK-Umbrella.podspec (Swift-only umbrella sources, module mParticle_Apple_SDK) and updates CI/release workflows to lint/include it, bump its version during kit lint, and publish pods in dependency order (Swift → ObjC → umbrella).

^{Reviewed by Cursor Bugbot for commit b1c007e. Bugbot is set up for automated code reviews on this repo. Configure here.}

[github-actions]

📦 SDK Size Impact Report

Measures how much the SDK adds to an app's size (with-SDK minus without-SDK).

Metric	Target Branch	This PR	Change
App Bundle Impact	1.75 MB	1.75 MB	+N/A
Executable Impact	848 bytes	848 bytes	+N/A
XCFramework Size	6.38 MB	6.38 MB	+N/A

➡️ SDK size impact change is minimal.

Raw measurements

Target branch (main):

{"baseline_app_size_kb":84,"baseline_executable_size_bytes":75464,"with_sdk_app_size_kb":1880,"with_sdk_executable_size_bytes":76312,"sdk_impact_kb":1796,"sdk_executable_impact_bytes":848,"xcframework_size_kb":6532}

This PR:

{"baseline_app_size_kb":84,"baseline_executable_size_bytes":75464,"with_sdk_app_size_kb":1880,"with_sdk_executable_size_bytes":76312,"sdk_impact_kb":1796,"sdk_executable_impact_bytes":848,"xcframework_size_kb":6532}

[nickolas-dimitrakas]

I would also add the umbrella podspec to the build-kits.yml workflow as well. And it needs to be added to the release-draft.yml array

[cursor]

SPM examples use unreliable bare header import

Medium Severity

All SPM ObjC example apps changed from @import mParticle_Apple_SDK; (a proper Clang module import) to #import <mParticle_Apple_SDK.h> (a bare header import). In SPM, public headers from ObjC targets are namespaced under the module name (mParticle_Apple_SDK_ObjC), so a bare #import <mParticle_Apple_SDK.h> without the module prefix may not resolve in the header search paths. These examples are built in CI via build-kits.yml. The previous @import mParticle_Apple_SDK; or @import mParticle_Apple_SDK_ObjC; are the reliable approaches for SPM consumers.

Additional Locations (2)

• Kits/rokt/rokt/Example/SPM-Objc-Example/SPM-Objc-Example/AppDelegate.m#L1-L2
• Kits/appsflyer/appsflyer-6/Example/SPM-Objc-Example/SPM-Objc-Example/AppDelegate.m#L1-L2

 

^{Reviewed by Cursor Bugbot for commit 41a1722. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

There are 3 total unresolved issues (including 2 from previous reviews).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 1a27d2e. Configure here.}

[cursor]

Firebase kit headers inconsistently skip module import

Medium Severity

These four Firebase kit public headers use #import "mParticle.h" while every other kit in this PR was updated to use @import mParticle_Apple_SDK_ObjC;. The quote-style import in a public header is fragile — it depends on the consumer's header search path configuration rather than the module system. All four Firebase/Firebase GA4 kit headers (versions 11 and 12) have this same inconsistency.

Additional Locations (2)

• Kits/google-analytics-firebase-ga4/firebase-ga4-12/Sources/mParticle-FirebaseGA4/include/MPKitFirebaseGA4Analytics.h#L1-L2
• Kits/google-analytics-firebase/firebase-11/Sources/mParticle-Firebase/include/MPKitFirebase.h#L1-L2

 

^{Reviewed by Cursor Bugbot for commit 1a27d2e. Configure here.}

[BrandonStalnaker]

this is part 1, part 2 here #733