feat: add OSX desktop support (#220)

Author: tylerjroach

.claude/context/architecture/ARCHITECTURE.md

@@ -225,7 +225,8 @@ Mixpanel Servers
 ## Platform Dependencies
 
 - **Android**: Mixpanel Android SDK v8.0.3
-- **iOS**: Mixpanel-swift v5.0.0  
+- **iOS**: Mixpanel-swift 6.1.0
+- **macOS**: Mixpanel-swift 6.1.0
 - **Web**: Mixpanel JavaScript library (loaded from CDN)
 
 ## Example Usage

.claude/context/architecture/system-design.md

@@ -27,7 +27,7 @@ The Mixpanel Flutter SDK implements a federated plugin architecture that provide
 │  - Type conversion  │ - Type handler│  - safeJsify()      │
 ├─────────────────────┼───────────────┼──────────────────────┤
 │ Mixpanel Android    │ Mixpanel-swift│  Mixpanel JS        │
-│    SDK v8.0.3       │   SDK v5.0.0  │   (CDN loaded)      │
+│    SDK v8.0.3       │   SDK v6.1.0  │   (CDN loaded)      │
 └─────────────────────┴───────────────┴──────────────────────┘
                               ↓
                     Mixpanel Analytics Servers

.claude/context/codebase-map.md

@@ -75,7 +75,7 @@ mixpanel-flutter/
 
 - **ios/mixpanel_flutter.podspec**: iOS pod configuration
   - iOS deployment target: 12.0
-  - Mixpanel-swift dependency: ~> 5.1.0
+  - Mixpanel-swift dependency: 6.1.0
   - Swift version: 5.0
 
 - **analysis_options.yaml**: Dart static analysis rules

.github/actions/setup-flutter/action.yml

@@ -0,0 +1,61 @@
+# Inlined from subosito/flutter-action@fd55f4c5af5b953cc57a2be44cb082c8f6635e8e (v2.21.0)
+# to avoid its unpinned transitive use of actions/cache@v4
+name: Set up Flutter
+description: Setup Flutter SDK with optional caching (all action refs pinned to SHA)
+
+inputs:
+  channel:
+    description: The Flutter build release channel
+    required: false
+    default: stable
+  flutter-version:
+    description: The Flutter version to make available on the path
+    required: false
+    default: ""
+  cache:
+    description: Cache the Flutter SDK and pub dependencies
+    required: false
+    default: "true"
+
+runs:
+  using: composite
+  steps:
+    - name: Download flutter-action setup script
+      shell: bash
+      run: |
+        curl -sSL -o "$RUNNER_TEMP/flutter-setup.sh" \
+          "https://raw.githubusercontent.com/subosito/flutter-action/fd55f4c5af5b953cc57a2be44cb082c8f6635e8e/setup.sh"
+        chmod +x "$RUNNER_TEMP/flutter-setup.sh"
+
+    - name: Resolve Flutter version and cache keys
+      id: flutter-action
+      shell: bash
+      run: |
+        "$RUNNER_TEMP/flutter-setup.sh" -p \
+          -n '${{ inputs.flutter-version }}' \
+          -a '${{ runner.arch }}' \
+          ${{ inputs.channel }}
+
+    - name: Cache Flutter SDK
+      if: ${{ inputs.cache == 'true' }}
+      uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4
+      with:
+        path: ${{ steps.flutter-action.outputs.CACHE-PATH }}
+        key: ${{ steps.flutter-action.outputs.CACHE-KEY }}
+
+    - name: Cache pub dependencies
+      if: ${{ inputs.cache == 'true' }}
+      uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4
+      with:
+        path: ${{ steps.flutter-action.outputs.PUB-CACHE-PATH }}
+        key: ${{ steps.flutter-action.outputs.PUB-CACHE-KEY }}-${{ hashFiles('**/pubspec.lock') }}
+
+    - name: Install Flutter SDK
+      shell: bash
+      run: |
+        "$RUNNER_TEMP/flutter-setup.sh" \
+          -n '${{ steps.flutter-action.outputs.VERSION }}' \
+          -a '${{ steps.flutter-action.outputs.ARCHITECTURE }}' \
+          -c '${{ steps.flutter-action.outputs.CACHE-PATH }}' \
+          -d '${{ steps.flutter-action.outputs.PUB-CACHE-PATH }}' \
+          ${{ steps.flutter-action.outputs.CHANNEL }}

.github/copilot-instructions.md

@@ -72,7 +72,7 @@ android/
     └── MixpanelFlutterHelper.java  # Validation helpers
 
 ios/
-├── mixpanel_flutter.podspec        # iOS package (Mixpanel-swift 5.1.0)
+├── mixpanel_flutter.podspec        # iOS package (Mixpanel-swift 6.1.0)
 └── Classes/
     ├── SwiftMixpanelFlutterPlugin.swift # iOS platform channel
     └── MixpanelTypeHandler.swift        # Type serialization
@@ -214,7 +214,7 @@ When adding a new SDK method:
 
 **Production**:
 - Mixpanel Android SDK 8.2.0 (in `android/build.gradle`)
-- Mixpanel-swift 5.1.0 (in `ios/mixpanel_flutter.podspec`)
+- Mixpanel-swift 6.1.0 (in `ios/mixpanel_flutter.podspec` and `macos/mixpanel_flutter.podspec`)
 - Mixpanel JS (loaded from CDN in web/index.html)
 
 **Dev**:

.github/workflows/flutter.yml

@@ -6,17 +6,17 @@ on:
   pull_request:
     branches: [main]
 
+permissions:
+  contents: read
+
 jobs:
   test-main-code:
     runs-on: macos-latest
     steps:
-      - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5  # v2
-      - uses: actions/setup-java@b6e674f4b717d7b0ae3baee0fbe79f498905dfde  # v1
-        with:
-          java-version: "12.x"
-      - uses: subosito/flutter-action@4389e6cbc6cb8a4b18c628ff96ff90be0e926aa8  # v1
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+      - uses: ./.github/actions/setup-flutter
         with:
-          flutter-version: "3.16.0"
+          flutter-version: "3.41.0"
       - run: flutter pub get
       - run: flutter test
       - run: flutter analyze --no-pub --no-current-package --no-fatal-infos lib
@@ -29,9 +29,9 @@ jobs:
         with:
           java-version: "17"
           distribution: 'temurin'
-      - uses: subosito/flutter-action@4389e6cbc6cb8a4b18c628ff96ff90be0e926aa8  # v1
+      - uses: ./.github/actions/setup-flutter
         with:
-          flutter-version: "3.16.0"
+          flutter-version: "3.41.0"
       - name: Test Android integration
         working-directory: example
         run: flutter build apk
@@ -44,9 +44,9 @@ jobs:
         with:
           java-version: "17"
           distribution: 'temurin'
-      - uses: subosito/flutter-action@4389e6cbc6cb8a4b18c628ff96ff90be0e926aa8  # v1
+      - uses: ./.github/actions/setup-flutter
         with:
-          flutter-version: "3.16.0"
+          flutter-version: "3.41.0"
       - name: Clean
         working-directory: example
         run: flutter clean
@@ -59,3 +59,23 @@ jobs:
       - name: Test iOS integration
         working-directory: example
         run: flutter build ios --debug --simulator --no-codesign
+
+  test-macos-integration:
+    runs-on: macos-26
+    steps:
+      - uses: actions/checkout@34e114876b0b11c390a56381ad16ebd13914f8d5  # v4
+      - uses: ./.github/actions/setup-flutter
+        with:
+          flutter-version: "3.41.0"
+      - name: Clean
+        working-directory: example
+        run: flutter clean
+      - name: Flutter pub get
+        working-directory: example
+        run: flutter pub get
+      - name: CocoaPods update
+        working-directory: example/macos
+        run: pod repo update
+      - name: Test macOS integration
+        working-directory: example
+        run: flutter build macos --debug

AGENTS.md

@@ -11,7 +11,7 @@ This is the official Mixpanel Flutter SDK - a Flutter plugin providing analytics
 ### Key Technologies
 - **Flutter/Dart**: Core SDK implementation
 - **Platform Channels**: Communication between Dart and native code
-- **Native SDKs**: Mixpanel-Android (v8.0.3), Mixpanel-Swift (v5.0.0), Mixpanel-JS (CDN)
+- **Native SDKs**: Mixpanel-Android (v8.0.3), Mixpanel-Swift (6.1.0), Mixpanel-JS (CDN)
 - **Custom Serialization**: MixpanelMessageCodec for complex types
 - **Testing**: Flutter unit tests with mocked platform channels
 

CLAUDE.md

@@ -48,7 +48,8 @@ Future<void> methodName(parameters) async {
 
 ### Platform Dependencies
 - Android: Mixpanel Android SDK v8.0.3
-- iOS: Mixpanel-swift v5.0.0
+- iOS: Mixpanel-swift 6.1.0
+- macOS: Mixpanel-swift 6.1.0
 - Web: Mixpanel JavaScript library (loaded from CDN)
 
 ## Development Commands

example/.metadata

@@ -4,7 +4,27 @@
 # This file should be version controlled and should not be manually edited.
 
 version:
-  revision: 78910062997c3a836feee883712c241a5fd22983
-  channel: stable
+  revision: "90673a4eef275d1a6692c26ac80d6d746d41a73a"
+  channel: "stable"
 
 project_type: app
+
+# Tracks metadata for the flutter migrate command
+migration:
+  platforms:
+    - platform: root
+      create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a
+      base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a
+    - platform: macos
+      create_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a
+      base_revision: 90673a4eef275d1a6692c26ac80d6d746d41a73a
+
+  # User provided section
+
+  # List of Local paths (relative to this file) that should be
+  # ignored by the migrate tool.
+  #
+  # Files that are not part of the templates will be ignored by default.
+  unmanaged_files:
+    - 'lib/main.dart'
+    - 'ios/Runner.xcodeproj/project.pbxproj'

example/ios/Flutter/AppFrameworkInfo.plist

@@ -20,7 +20,5 @@
   <string>????</string>
   <key>CFBundleVersion</key>
   <string>1.0</string>
-  <key>MinimumOSVersion</key>
-  <string>13.0</string>
 </dict>
 </plist>