Added API logEventForTransaction for StoreKit2 Support

[NidhiDixit09]

Reference

SDK-XXXX -- <TITLE>.

Summary

Motivation

Type Of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

Testing Instructions

cc @BranchMetrics/saas-sdk-devs for visibility.

[matter-code-review]

Summary By MatterAI

🔄 What Changed

This PR introduces StoreKit 2 support by adding a new Swift extension to BranchEvent that enables logging purchase events directly from StoreKit 2 transactions. It includes a new logEventForTransaction method that extracts product and transaction details from StoreKit 2 and automatically populates a Branch PURCHASE event. The changes also involve adding a new Swift target to the package configuration and updating the .gitignore file.

🔍 Impact of the Change

The addition enables Branch SDK to capture comprehensive in-app purchase data from StoreKit 2 transactions, including subscription details, ownership types, and revocation information. This enhances Branch's ability to track and attribute iOS app purchases with greater accuracy and detail. The changes are additive and don't modify existing functionality.

📁 Total Files Changed

File	ChangeLog
Package.swift	Added new BranchSwiftSDK target and updated library targets to include it
BranchEvent+StoreKit2.swift	New Swift extension implementing StoreKit 2 transaction logging functionality
BranchEvent.h	Added eventName property to public interface
BranchEvent.m	Removed redundant eventName property declaration
.gitignore	Added .build directory to ignored files

🧪 Test Added/Recommended

Recommended

1. Unit tests for logEventForTransaction method covering various transaction types (consumable, non-consumable, auto-renewable subscriptions)
2. Integration tests verifying correct event data mapping from StoreKit 2 transactions to Branch events
3. Error handling tests for scenarios where product loading fails or transaction data is incomplete
4. Subscription-specific tests covering introductory offers and subscription period formatting

🔒Security Vulnerabilities

No security vulnerabilities detected. The implementation follows secure coding practices with proper error handling and data validation.

[matter-code-review]

Important

PR Review Skipped

PR review skipped as per the configuration setting. Run a manually review by commenting /matter review

💡Tips to use MatterAI

Command List

• /matter summary: Generate AI Summary for the PR
• /matter review: Generate AI Reviews for the latest commit in the PR
• /matter review-full: Generate AI Reviews for the complete PR
• /matter release-notes: Generate AI release-notes for the PR
• /matter : Chat with your PR with MatterAI Agent
• /matter remember : Generate AI memories for the PR
• /matter explain: Get an explanation of the PR
• /matter help: Show the list of available commands and documentation
• Need help? Join our Discord server: https://discord.gg/fJU5DvanU3

[matter-code-review]

Note

PR Review Skipped

PR review skipped as no relevant changes found due to large diff hunk OR part of a non-reviewable file.

📄Files skipped in review

• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined

💡Tips to use MatterAI

Command List

• /matter summary: Generate AI Summary for the PR
• /matter review: Generate AI Reviews for the latest commit in the PR
• /matter review-full: Generate AI Reviews for the complete PR
• /matter release-notes: Generate AI release-notes for the PR
• /matter : Chat with your PR with MatterAI Agent
• /matter remember : Generate AI memories for the PR
• /matter explain: Get an explanation of the PR
• /matter help: Show the list of available commands and documentation
• Need help? Join our Discord server: https://discord.gg/fJU5DvanU3

[matter-code-review]

Note

PR Review Skipped

PR review skipped as no relevant changes found due to large diff hunk OR part of a non-reviewable file.

📄Files skipped in review

• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined

💡Tips to use MatterAI

Command List

• /matter summary: Generate AI Summary for the PR
• /matter review: Generate AI Reviews for the latest commit in the PR
• /matter review-full: Generate AI Reviews for the complete PR
• /matter release-notes: Generate AI release-notes for the PR
• /matter : Chat with your PR with MatterAI Agent
• /matter remember : Generate AI memories for the PR
• /matter explain: Get an explanation of the PR
• /matter help: Show the list of available commands and documentation
• Need help? Join our Discord server: https://discord.gg/fJU5DvanU3

[matter-code-review]

Note

PR Review Skipped

PR review skipped as no relevant changes found due to large diff hunk OR part of a non-reviewable file.

📄Files skipped in review

• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined
• undefined: undefined

💡Tips to use MatterAI

Command List

• /matter summary: Generate AI Summary for the PR
• /matter review: Generate AI Reviews for the latest commit in the PR
• /matter review-full: Generate AI Reviews for the complete PR
• /matter release-notes: Generate AI release-notes for the PR
• /matter : Chat with your PR with MatterAI Agent
• /matter remember : Generate AI memories for the PR
• /matter explain: Get an explanation of the PR
• /matter help: Show the list of available commands and documentation
• Need help? Join our Discord server: https://discord.gg/fJU5DvanU3