Add Cardinal UI Type and Render Types

[jaxdesmarais]

Summary of changes

• Add uiType to BTThreeDSecureRequest
• Add renderTypes to BTThreeDSecureRequest
• Set default parameters in Demo app (from Cardinal docs)
• Add unit tests
• Android PR for this change: Add Cardinal UI Type and Render Type braintree_android#738 - we finally heard back from the merchants that these worked as expected, so exposing them on iOS

Checklist

• Added a changelog entry

Authors

• @jaxdesmarais

[jaxdesmarais]

Arrays of Int enums do not exist in Obj-C so we cannot use the cleaner version (array of enums) here. 😢 This seems to be the consensus on the best practice in these cases. Open to other ideas if folks find something that works better as this is certainly not the most Swift-y approach. But working in the confines of Obj-C it seems to be our best bet.

[sarahkoop]

I don't have any better ideas for this but curious if we are planning to remove obj-c support in the next major version?

[jaxdesmarais]

Currently there isn't a plan to remove Obj-C support in the next major version but we could consider discussing it further as an option! Or if Apple announces an official deprecation policy at some point it'd be a much easier choice.

[sshropshire]

Would the @objc annotation work for us (stack post)?

[jaxdesmarais]

That works for the enum but that's not the issue, the issue is that arrays of Int enums don't exist in Obj-C and enums can only be bridged to Int types to be interoperable with Obj-C. A Swift array is bridged to Obj-C's NSArray, and an Obj-C array should contain only pointers, but an enum of Int doesn't contain pointers so cannot be bridged.

[sshropshire]

Ah got it yeah. That makes sense. Swift does have OptionSet as an NS_OPTIONS equivalent, but I can't tell if option sets are accessible from Obj-C.

[jaxdesmarais]

🤔 we may be able to make that work - it'll need to be a class instead of a struct since structs don't exist in Obj-c, but I think that may be okay. I'll poke around at it a bit.

[jaxdesmarais]

Done: 5911c55. Great suggestion, that's way cleaner 🔥

[jaxdesmarais]

Also if anyone is interested this is how the implementation will look for Obj-C merchants:

BTThreeDSecureRequest *request = [[BTThreeDSecureRequest alloc] init];
request.renderTypes = @[BTThreeDSecureRenderType.oob, BTThreeDSecureRenderType.html, BTThreeDSecureRenderType.singleSelect, BTThreeDSecureRenderType.multiSelect, BTThreeDSecureRenderType.otp];