feat: rename podspecs to umbrella + ObjC core (#733)

* Add mParticle-Apple-SDK-Umbrella.podspec for Swift umbrella (CocoaPods)

Made-with: Cursor

* ci: publish CocoaPods Swift → core → umbrella in release-publish

Made-with: Cursor

* Align CocoaPods ObjC module imports across kits

- Set mParticle-Apple-SDK pod module_name to mParticle_Apple_SDK_ObjC and
  mParticle-Apple-SDK-Umbrella to mParticle_Apple_SDK.
- Replace __has_include mParticle_Apple_SDK/mParticle.h blocks with
  @import mParticle_Apple_SDK_ObjC in kit headers, sources, tests, and
  Obj-C SPM examples.

Made-with: Cursor

* fix(kits): enable Clang modules for Apptimize and Adobe Xcode projects

Set CLANG_ENABLE_MODULES on mParticle-Apptimize and mParticle-Adobe project
configs. Replace @import mParticle_Apple_SDK_ObjC in kit public headers with
explicit umbrella imports so builds succeed when modules are disabled or for
Firebase/GA4 kits that need mParticle_Apple_SDK.h.

Made-with: Cursor

* fix(kits): restore @import mParticle_Apple_SDK_ObjC in public headers

Revert bracket imports; keep using the ObjC module import with Clang modules
enabled where configured (e.g. Apptimize, Adobe Xcode projects).

Made-with: Cursor

* update imports in example apps

* update pod lint

* update release scripts

* update workflows

* reorder dependencies

* fix(ci): Bump Umbrella podspec version in pod lint CI step

Made-with: Cursor

* revert headers

* try to fix rokt lint

* remove trailing \

* feat(cocoapods): rename podspecs to umbrella + ObjC core

- mParticle-Apple-SDK.podspec: Swift umbrella (public pod name unchanged)
- mParticle-Apple-SDK-ObjC.podspec: ObjC core (replaces former root podspec)
- Remove mParticle-Apple-SDK-Umbrella.podspec
- Update release workflows, release.sh, AGENTS.md, and Xcode project refs

Made-with: Cursor

* remove app extention

---------

Co-authored-by: Nickolas Dimitrakas <nickolas.dimitrakas@rokt.com>
Co-authored-by: Thomson Thomas <125323226+thomson-t@users.noreply.github.com>

Author: 3 people

.github/workflows/build-and-lint.yml

@@ -38,7 +38,7 @@ jobs:
         run: find . -path '*.podspec' -exec perl -pi -e 's/.+\.social_media_url.+//' {} \;
 
       - name: Lint with CocoaPods
-        run: pod lib lint --include-podspecs=mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec
+        run: pod lib lint mParticle-Apple-SDK.podspec --include-podspecs="{mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec,mParticle-Apple-SDK-ObjC.podspec,mParticle-Apple-SDK.podspec}"
 
       - name: Undo twitter change to podspec
         run: git checkout *.podspec

.github/workflows/build-kits.yml

@@ -43,14 +43,15 @@ jobs:
           # TODO: Remove the sed bumps and --include-podspecs once mParticle-Apple-SDK v9.0
           # is published to CocoaPods CDN.
           sed -i '' 's/s\.version[[:space:]]*=.*/s.version          = "9.0.0"/' mParticle-Apple-SDK.podspec
+          sed -i '' 's/s\.version[[:space:]]*=.*/s.version          = "9.0.0"/' mParticle-Apple-SDK-ObjC.podspec
           sed -i '' 's/s\.version[[:space:]]*=.*/s.version          = "9.0.0"/' mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec
 
           echo "Linting: ${{ matrix.kit.podspec }}"
           for attempt in 1 2 3; do
             pod lib lint "${{ matrix.kit.podspec }}" \
               --allow-warnings \
               --skip-import-validation \
-              --include-podspecs="{mParticle-Apple-SDK.podspec,mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec}" \
+              --include-podspecs="{mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec,mParticle-Apple-SDK-ObjC.podspec,mParticle-Apple-SDK.podspec}" \
               && break
             [ $attempt -lt 3 ] && echo "Attempt $attempt failed, retrying in 60s..." && sleep 60 || exit 1
           done

.github/workflows/release-draft.yml

@@ -71,6 +71,7 @@ jobs:
         run: |
           PODSPECS=(
             "mParticle-Apple-SDK.podspec"
+            "mParticle-Apple-SDK-ObjC.podspec"
             "mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec"
           )
           while IFS= read -r spec; do
@@ -119,14 +120,14 @@ jobs:
           kits-path: Kits
 
       # --- Commit, push, and create PR ---
-
       - name: Commit version changes
         run: |
           git add \
             CHANGELOG.md \
             VERSION \
             Framework/Info.plist \
             mParticle-Apple-SDK.podspec \
+            mParticle-Apple-SDK-ObjC.podspec \
             mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec \
             mParticle-Apple-SDK/MPIConstants.m \
             IntegrationTests/wiremock-recordings/mappings/*.json \

.github/workflows/release-publish.yml

@@ -93,7 +93,13 @@ jobs:
         if: env.DRY_RUN != 'true'
         env:
           COCOAPODS_TRUNK_TOKEN: ${{ secrets.COCOAPODS_TRUNK_TOKEN }}
-        run: pod trunk push mParticle-Apple-SDK.podspec --allow-warnings --synchronous
+        run: |
+          set -euo pipefail
+          PUSH_FLAGS=(--allow-warnings --synchronous)
+          # Order matters: Swift pod → ObjC core (depends on Swift) → umbrella Swift (depends on ObjC).
+          pod trunk push mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec "${PUSH_FLAGS[@]}"
+          pod trunk push mParticle-Apple-SDK-ObjC.podspec "${PUSH_FLAGS[@]}"
+          pod trunk push mParticle-Apple-SDK.podspec "${PUSH_FLAGS[@]}"
 
       - name: Summary
         run: |

AGENTS.md

@@ -43,7 +43,7 @@ You are a senior iOS SDK engineer specializing in customer data platform (CDP) S
   - Build: via Xcode scheme or `xcodebuild`.
   - Run unit tests: `Rokt_WidgetTests/` or via Xcode (Command + U).
   - Lint: `trunk check` (primary enforcement tool).
-  - Pod lint: `pod lib lint mParticle-Apple-SDK.podspec`.
+  - Pod lint: `pod lib lint mParticle-Apple-SDK.podspec --include-podspecs="{mParticle-Apple-SDK-Swift/mParticle-Apple-SDK-Swift.podspec,mParticle-Apple-SDK-ObjC.podspec,mParticle-Apple-SDK.podspec}"` (same as CI).
   - Size report: Check binary size impact via CI workflow.
 - Always validate changes with the full sequence in "Code style, quality, and validation" below before proposing or committing.
 
@@ -104,7 +104,8 @@ You are a senior iOS SDK engineer specializing in customer data platform (CDP) S
 - `Scripts/` — Build, release, and utility scripts.
   - `xcframework.sh`, `check_coverage.sh`.
 - `Package.swift` — SPM manifest (swift-tools-version 5.5).
-- `mParticle-Apple-SDK.podspec` — CocoaPods spec (v8.41.1).
+- `mParticle-Apple-SDK.podspec` — CocoaPods umbrella (Swift sources; consumer-facing pod name `mParticle-Apple-SDK`).
+- `mParticle-Apple-SDK-ObjC.podspec` — CocoaPods ObjC core (`mParticle-Apple-SDK-ObjC`).
 - `PrivacyInfo.xcprivacy` — iOS privacy manifest.
 - `ARCHITECTURE.md` — Architecture documentation with sequence diagrams.
 - `CHANGELOG.md` — Release notes (extensive).
@@ -125,7 +126,7 @@ You are a senior iOS SDK engineer specializing in customer data platform (CDP) S
   1. `trunk check` — to lint, format-check, and catch style/quality issues.
   2. Build the SDK: via Xcode or `xcodebuild` for both iOS and tvOS.
   3. Run unit tests: both Objective-C and Swift test suites in `UnitTests/`.
-  4. `pod lib lint mParticle-Apple-SDK.podspec` — verify CocoaPods spec is valid.
+  4. `pod lib lint` with `--include-podspecs` for Swift + ObjC + umbrella (see Quick Start) — verify CocoaPods specs.
   5. If change affects code, assets, or dependencies: check coverage via `Scripts/check_coverage.sh`.
   - Only propose / commit changes if all steps pass cleanly.
   - If `trunk check` suggests auto-fixes, apply them first and re-validate.

Kits/adjust/adjust-5/Example/SPM-Objc-Example/SPM-Objc-Example/AppDelegate.m

@@ -1,5 +1,5 @@
 #import "AppDelegate.h"
-@import mParticle_Apple_SDK;
+#import <mParticle_Apple_SDK.h>
 @import mParticle_Adjust;
 
 @interface AppDelegate ()

Kits/adjust/adjust-5/Sources/mParticle-Adjust/include/MPKitAdjust.h

@@ -1,9 +1,5 @@
 #import <Foundation/Foundation.h>
-#if defined(__has_include) && __has_include(<mParticle_Apple_SDK/mParticle.h>)
-    #import <mParticle_Apple_SDK/mParticle.h>
-#else
-    #import "mParticle.h"
-#endif
+@import mParticle_Apple_SDK_ObjC;
 
 extern NSString * _Nonnull const MPKitAdjustAttributionResultKey;
 extern NSString * _Nonnull const MPKitAdjustErrorKey;

Kits/adobe/adobe-5/Example/SPM-Objc-Example/SPM-Objc-Example/AppDelegate.m

@@ -1,5 +1,5 @@
 #import "AppDelegate.h"
-#import "mParticle.h"
+#import <mParticle_Apple_SDK.h>
 #import "MPKitAdobe.h"
 
 @interface AppDelegate ()

Kits/adobe/adobe-5/Sources/mParticle-Adobe/MPIAdobe.m

@@ -1,9 +1,5 @@
 #import "MPIAdobe.h"
-#if defined(__has_include) && __has_include(<mParticle_Apple_SDK/mParticle.h>)
-    #import <mParticle_Apple_SDK/mParticle.h>
-#else
-    #import "mParticle.h"
-#endif
+@import mParticle_Apple_SDK_ObjC;
 
 NSString *const MPIAdobeErrorKey = @"MPIAdobeErrorKey";
 

Kits/adobe/adobe-5/Sources/mParticle-Adobe/include/MPKitAdobe.h

@@ -1,9 +1,5 @@
 #import <Foundation/Foundation.h>
-#if defined(__has_include) && __has_include(<mParticle_Apple_SDK/mParticle.h>)
-    #import <mParticle_Apple_SDK/mParticle.h>
-#else
-    #import "mParticle.h"
-#endif
+@import mParticle_Apple_SDK_ObjC;
 
 #pragma mark - MPIAdobeApi
 @interface MPIAdobeApi : NSObject