[5.0.0] IAM Click Listener - API update

[nan-li]

Description

One Line Summary

IAM Click Listener - API update

Details

Motivation

IAM Click Listener - API update

Scope

• Rename click block to OSInAppMessageClickListener
• Rename setClickHandler to addClickListener
• Add a remove method for the click listener
• OSInAppMessageAction has basically been renamed to OSInAppMessageClickResult
• OSInAppMessageClickEvent will be passed to developers instead of OSInAppMessageAction and the event will contain an in app message and a click result.
• Supports adding and removing multiple click listeners

Public API

OneSignal.InAppMessages namespace
    + (void)addClickListener:(NSObject<OSInAppMessageClickListener> *_Nullable)listener
    + (void)removeClickListener:(NSObject<OSInAppMessageClickListener> *_Nullable)listener

OSInAppMessageClickListener
    - (void)onClickInAppMessage:(OSInAppMessageClickEvent *_Nonnull)event
    func onClick(event: OSNotificationClickEvent) // For Swift API refined

OSInAppMessageClickEvent
    @property (nonatomic, readonly, nonnull) OSInAppMessage *message
    @property (nonatomic, readonly, nonnull) OSInAppMessageClickResult *result
    - (NSDictionary *_Nonnull)jsonRepresentation

OSInAppMessageClickResult
    @property (strong, nonatomic, nullable) NSString *actionId
    @property (strong, nonatomic, nullable) NSString *url
    @property (nonatomic) BOOL closingMessage
    @property (nonatomic) OSInAppMessageActionUrlType urlTarget
    - (NSDictionary *_Nonnull)jsonRepresentation

OSInAppMessageActionUrlType
    typedef NS_ENUM(NSUInteger, OSInAppMessageActionUrlType) 
        OSInAppMessageActionUrlTypeSafari
        OSInAppMessageActionUrlTypeWebview
        OSInAppMessageActionUrlTypeReplaceContent

Testing

Manual testing

Manual testing with iPhone 13 physical device running iOS 16.x.

• test click listener fired, adding, removing multiple, and inspecting the properties and objects on the event and jsonRepresentation of them.

Affected code checklist

• Notifications
  • Display
  • Open
  • Push Processing
  • Confirm Deliveries
• Outcomes
• Sessions
• In-App Messaging
• REST API requests
• Public API changes

Checklist

Overview

• I have filled out all REQUIRED sections above
• PR does one thing
• Any Public API changes are explained in the PR details and conform to existing APIs

Testing

• I have included test coverage for these changes, or explained why they are not needed
• All automated tests pass, or I explained why that is not possible
• I have personally tested this on my device, or explained why that is not possible

Final pass

• Code is as readable as possible.
• I have reviewed this PR myself, ensuring it meets each checklist item

---

This change is