feat: Add IntegrationTests project with Tuist and WireMock setup

- Add Tuist project configuration for IntegrationTests
- Add WireMock recorder script for API mocking
- Add initial test app implementation
- Add proxy mappings for events and identify endpoints
- Add README and generation scripts

Add NO_OPEN parameter to generate.sh to control Xcode opening

- Remove unused configuration variables
- Add NO_OPEN parameter (defaults to false)
- Conditionally call tuist generate with --no-open flag when NO_OPEN=true
- Allows generate.sh to be used both standalone (opens Xcode) and from other scripts (skips Xcode)

Refactor run_wiremock_recorder.sh to use detached mode with auto-cleanup

- Add generate.sh call at the beginning to build project
- Run WireMock in detached mode (-d flag) with named container
- Extract logic into three functions: start_wiremock, wait_for_wiremock, stop_wiremock
- Add health check waiting for WireMock to be ready (checks admin API)
- Implement trap for automatic cleanup on EXIT/INT/TERM signals
- Script now stays running until interrupted, ensuring proper container cleanup

Add build_application function to run_wiremock_recorder.sh

Add reset_simulators function

Add find_device, start_simulator and install_application functions

Add launch_application and wait_for_app_completion functions

Add automatic device selection and test execution flow

- Add find_available_device() function to automatically select available iPhone simulator
- Add find_app_path() function to locate built application
- Add complete test execution flow after WireMock starts
- Update device priority list to include iPhone 17
- Move DEVICE_NAME to global variables for dynamic assignment

Fix build command to use generic iOS Simulator platform and add quiet mode

- Change destination to 'generic/platform=iOS Simulator' to avoid dependency on specific device name
- Add -quiet flag to reduce build output verbosity

- change order

Update README: clarify purpose as API recording tool for testing

- Update description to focus on recording API requests for later use in tests
- Simplify prerequisites and overview sections
- Remove detailed technical sections (Build Process, WireMock Recording, Device Selection, Benefits)
- Consolidate troubleshooting into single section for port conflicts
- Remove CI/CD integration examples
- Update development workflow to emphasize recording purpose

Use local SDK sources directly instead of building xcframework

- Update Project.swift to use .local(path: '../') package reference
- Remove Tuist/Package.swift to allow Xcode to resolve local package
- Simplify generate.sh to only generate project (no xcframework build)
- Update README to reflect new simpler approach
- Remove temp_artifacts directory (no longer needed)

Benefits:
- No need to rebuild xcframework for every change
- Xcode automatically picks up latest source code changes
- Much faster development workflow
- Simpler and more maintainable approach

Remove generate.sh script and update documentation

- Delete generate.sh (no longer needed - tuist generate is called directly)
- Update README to remove generate.sh section
- Simplify available scripts documentation to only show run_wiremock_recorder.sh

- add documentation how to use tuist

- cleanup .gitignore

Remove comment

Author: denischilik

IntegrationTests/.gitignore

@@ -0,0 +1,17 @@
+# Temporary artifacts directory
+temp_artifacts/
+
+# Xcode
+*.xcworkspace
+!*.xcworkspace/contents.xcworkspacedata
+!*.xcworkspace/xcshareddata/
+IntegrationTests.xcodeproj/
+Derived/
+
+# Build artifacts
+build/
+*.app
+
+# Tuist
+.tuist/
+

IntegrationTests/Project.swift

@@ -0,0 +1,25 @@
+import ProjectDescription
+
+let project = Project(
+    name: "IntegrationTests",
+    packages: [
+        .local(path: "../")
+    ],
+    targets: [
+        .target(
+            name: "IntegrationTests",
+            destinations: .iOS,
+            product: .app,
+            bundleId: "com.mparticle.IntegrationTests",
+            deploymentTargets: .iOS("14.0"),
+            sources: ["Sources/**"],
+            dependencies: [
+                .package(product: "mParticle-Apple-SDK", type: .runtime)
+            ]
+        )
+    ],
+    additionalFiles: [
+        .glob(pattern: "wiremock-recordings/**/*.json"),
+        .glob(pattern: "*.sh")
+    ]
+)

IntegrationTests/README.md

@@ -0,0 +1,110 @@
+# Integration Tests
+
+Tools for recording mParticle Apple SDK API requests using WireMock for later use in integration testing.
+
+## Prerequisites
+
+Before getting started, install Tuist:
+
+```bash
+brew install tuist
+```
+
+Then generate the Xcode project:
+
+```bash
+cd IntegrationTests
+tuist generate
+```
+
+This will create the `IntegrationTests.xcodeproj` and `IntegrationTests.xcworkspace` files and automatically open them in Xcode.
+
+If you need to edit the Tuist project configuration (`Project.swift`):
+
+```bash
+tuist edit
+```
+
+This will open a temporary Xcode project for editing Tuist manifest files.
+
+If you encounter any issues with project generation, you can clean the Tuist cache first:
+
+```bash
+tuist clean
+tuist generate
+```
+
+## Overview
+
+This project provides tools for recording mParticle SDK API requests by:
+- Generating a test iOS app using Tuist
+- Linking directly to local SDK source code
+- Running the app in iOS Simulator
+- Recording all API traffic with WireMock for later use in testing
+
+The project uses Tuist with `.local(path: "../")` package reference, which allows Xcode to resolve the local SDK package and use source files directly, automatically picking up your latest code changes.
+
+## Available Scripts
+
+### `run_wiremock_recorder.sh` - Record API Requests for Testing
+
+Records all mParticle SDK API requests using WireMock for later use in integration testing.
+
+```bash
+./run_wiremock_recorder.sh
+```
+
+**What it does:**
+1. Generates Tuist project with local SDK sources
+2. Builds the integration test application
+3. Finds and resets iOS Simulators
+4. Automatically selects available iPhone simulator (iPhone 17/16/15 priority)
+5. Starts simulator
+6. Installs test application
+7. Starts WireMock in recording mode
+8. Launches test application
+9. Records all API traffic to mapping files
+10. Waits for application completion
+11. Stops WireMock and shows results
+
+**Recorded Files:**
+- `wiremock-recordings/mappings/*.json` - API request/response mappings
+- `wiremock-recordings/__files/*` - Response body files
+
+## Troubleshooting
+
+### Port Already in Use / No Recordings Created
+
+If you see "port already allocated" errors or if no API requests were recorded, it's likely that the ports (8080 and 443) where WireMock should be running are already occupied by another container or application.
+
+Check what's running on the ports:
+
+```bash
+# Check running Docker containers
+docker ps
+
+# Check what's using port 443
+lsof -i :443
+
+# Check what's using port 8080
+lsof -i :8080
+```
+
+Stop any conflicting Docker containers:
+
+```bash
+docker stop <container-name>
+docker rm <container-name>
+```
+
+If another application is using the ports, terminate it before running the script.
+
+## Development Workflow
+
+1. Make changes to SDK source code
+2. Run `./run_wiremock_recorder.sh`
+3. Script automatically uses your latest changes, runs the app, and records API traffic
+4. Review recorded mappings in `wiremock-recordings/`
+5. Commit mappings to document expected API behavior
+
+**Note:** No need to rebuild the SDK separately - the project links directly to source files and automatically picks up your changes!

IntegrationTests/Sources/main.swift

@@ -0,0 +1,43 @@
+//
+//  main.swift
+//  IntegrationTests
+//
+//  Created by Denis Chilik on 11/4/25.
+//
+
+import Foundation
+import mParticle_Apple_SDK
+
+
+var options = MParticleOptions(
+    key: "", // Put your key
+    secret: "" // Put your secret
+)
+
+var identityRequest = MPIdentityApiRequest.withEmptyUser()
+identityRequest.email = "foo@example.com";
+identityRequest.customerId = "123456";
+options.identifyRequest = identityRequest;
+
+options.onIdentifyComplete = { apiResult, error in
+    if let apiResult {
+        apiResult.user.setUserAttribute("example attribute key", value: "example attribute value")
+    }
+}
+options.logLevel = .verbose
+
+var networkOptions = MPNetworkOptions()
+networkOptions.configHost = "127.0.0.1"; // config2.mparticle.com
+networkOptions.eventsHost = "127.0.0.1"; // nativesdks.mparticle.com
+networkOptions.identityHost = "127.0.0.1"; // identity.mparticle.com
+networkOptions.pinningDisabled = true;
+
+options.networkOptions = networkOptions;
+let mparticle = MParticle.sharedInstance()
+mparticle.start(with: options)
+
+sleep(1)
+
+mparticle.logEvent("Simple Event Name", eventType: .other, eventInfo: ["SimpleKey": "SimpleValue"])
+
+sleep(7)

IntegrationTests/Tuist.swift

@@ -0,0 +1,3 @@
+import ProjectDescription
+
+let tuist = Tuist(project: .tuist())