[Release] - 12.3.0 (#792)

Author: dtroupe-plaid

CHANGELOG.md

@@ -1,5 +1,65 @@
 # RELEASES
 
+## LinkKit V12.3.0 — 2025-07-24
+
+#### Requirements
+
+This SDK now works with any supported version of React Native.
+
+### Android
+
+Android SDK [5.2.0](https://github.com/plaid/plaid-link-android/releases/tag/v5.2.0)
+
+### Additions
+
+- Add ISSUE_FOLLOWED, IDENTITY_MATCH_PASSED, and IDENTITY_MATCH_FAILED event names and issue_id event metadata field.
+
+### Changes
+
+- Improve destroy() API behavior in edge cases.
+
+### Removals
+
+- Reduce SDK size by 11.5% down from 5.0MB to 4.5MB. 
+- Remove the androidx.recyclerview:recyclerview, androidx.constraintlayout:constraintlayout, and io.coil-kt:coil dependencies.
+
+#### Requirements
+
+| Name | Version |
+|------|---------|
+| Android Studio | 4.0+ |
+| Kotlin | 1.9.25+ (Kotlin integrations only) |
+
+### iOS
+
+iOS SDK [6.3.0](https://github.com/plaid/plaid-link-ios/releases/tag/6.3.0)
+
+### SwiftUI API Enhancements
+
+- Added `makePlaidLinkSheet()` to `Handler`: a convenience method that returns a `View` to present LinkKit using `.fullScreenCover` in SwiftUI applications.
+- Added `plaidLink(isPresented:handler:)`: a SwiftUI view modifier to attach LinkKit to any `View`, such as a `Button`, using a pre-configured handler.
+- Added `plaidLink(isPresented:token:onSuccess:onExit:onEvent:onLoad:errorView:)`: a flexible SwiftUI modifier for creating LinkKit sessions with just a link token and callbacks—no `Handler` required.
+
+### Testing
+
+- Improved FinanceKit testing capabilities in Sandbox.
+
+### Event Tracking Improvements
+
+- Added event names:
+  - `IDENTITY_MATCH_PASSED`
+  - `IDENTITY_MATCH_FAILED`
+  - `ISSUE_FOLLOWED`
+  - `SELECT_ACCOUNT`
+
+#### Requirements
+
+| Name | Version |
+|------|---------|
+| Xcode | >= 16.1.0 |
+| iOS | >= 14.0 |
+
+
 ## LinkKit V12.2.1 — 2025-06-21
 
 #### Requirements

README.md

@@ -206,6 +206,7 @@ While these older versions are expected to continue to work without disruption,
 
 | Plaid SDK Version | Min React Native Version | Android SDK | Android Min Version | Android Compile Version| iOS SDK | iOS Min Version | Status                        |
 |-------------------|--------------------------|-------------|---------------------|------------------------|---------|-----------------|-------------------------------|
+| 12.3.0            | *                        | [5.2.0+]    | 21                  | 34                     | >=6.3.0 |  14.0           | Active, supports Xcode 16.1.0 |
 | 12.2.1            | *                        | [5.1.1+]    | 21                  | 34                     | >=6.2.1 |  14.0           | Active, supports Xcode 16.1.0 |
 | 12.2.0            | *                        | [5.1.1+]    | 21                  | 34                     | >=6.2.1 |  14.0           | Active, supports Xcode 16.1.0 |
 | 12.1.1            | *                        | [5.0.0+]    | 21                  | 34                     | >=6.1.0 |  14.0           | Active, supports Xcode 16.1.0 |

android/build.gradle

@@ -106,6 +106,6 @@ repositories {
 
 dependencies {
     implementation "com.facebook.react:react-native:+"
-    implementation "com.plaid.link:sdk-core:5.1.1"
+    implementation "com.plaid.link:sdk-core:5.2.0"
     implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
 }

android/src/main/AndroidManifest.xml

@@ -4,7 +4,7 @@
   <application>
     <meta-data
       android:name="com.plaid.link.react_native"
-      android:value="12.2.1" />
+      android:value="12.3.0" />
   </application>
 
 </manifest>

android/src/main/java/com/plaid/gson/RNEventMetadataAdapter.kt

@@ -36,6 +36,7 @@ class RNEventMetadataAdapter : JsonSerializer<LinkEventMetadata> {
       addProperty("linkSessionId", src.linkSessionId)
       addProperty("mfaType", src.mfaType)
       addProperty("requestId", src.requestId)
+      addProperty("issueId", src.issueId)
       addProperty("timestamp", src.timestamp)
       addProperty("viewName", src.viewName?.jsonValue ?: "")
       addProperty("metadata_json", src.metadataJson)

ios/RNLinksdk.mm

@@ -28,7 +28,7 @@ @implementation RNLinksdk
 RCT_EXPORT_MODULE();
 
 + (NSString*)sdkVersion {
-    return @"12.2.1"; // SDK_VERSION
+    return @"12.3.0"; // SDK_VERSION
 }
 
 + (NSString*)objCBridgeVersion {
@@ -350,6 +350,7 @@ + (NSDictionary *)dictionaryFromEvent:(PLKLinkEvent *)event {
             @"linkSessionId": metadata.linkSessionID ?: @"",
             @"mfaType": [self stringForMfaType:metadata.mfaType] ?: @"",
             @"requestId": metadata.requestID ?: @"",
+            @"issueId": metadata.issueID ?: @"",
             @"timestamp": [self iso8601StringFromDate:metadata.timestamp] ?: @"",
             @"viewName": [self stringForViewName:metadata.viewName] ?: @"",
             @"metadata_json": metadata.metadataJSON ?: @"",
@@ -522,6 +523,16 @@ + (NSString *)stringForEventName:(PLKEventName *)eventName {
             return @"AUTO_SELECT_SAVED_INSTITUTION";
         case PLKEventNameValuePlaidCheckPane:
             return @"PLAID_CHECK_PANE";
+        case PLKEventNameValueAutoSubmitPhone:
+            return @"AUTO_SUBMIT_PHONE";
+        case PLKEventNameValueIdentityMatchPassed:
+            return @"IDENTITY_MATCH_PASSED";
+        case PLKEventNameValueIdentityMatchFailed:
+            return @"IDENTITY_MATCH_FAILED";
+        case PLKEventNameValueIssueFollowed:
+            return @"ISSUE_FOLLOWED";
+        case PLKEventNameValueSelectAccount:
+            return @"SELECT_ACCOUNT";
     }
      return @"unknown";
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-plaid-link-sdk",
-  "version": "12.2.1",
+  "version": "12.3.0",
   "description": "React Native Plaid Link SDK",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

react-native-plaid-link-sdk.podspec

@@ -35,5 +35,5 @@ Pod::Spec.new do |s|
   end
 
   s.dependency 'React-Core'
-  s.dependency 'Plaid', '~> 6.2.1'
+  s.dependency 'Plaid', '~> 6.3.0'
 end

src/Types.ts

@@ -439,13 +439,16 @@ export interface LinkEventMetadata {
 
 export enum LinkEventName {
     AUTO_SELECT_SAVED_INSTITUTION = 'AUTO_SELECT_SAVED_INSTITUTION',
+    AUTO_SUBMIT_PHONE = 'AUTO_SUBMIT_PHONE',
     BANK_INCOME_INSIGHTS_COMPLETED = 'BANK_INCOME_INSIGHTS_COMPLETED',
     CLOSE_OAUTH = 'CLOSE_OAUTH',
     CONNECT_NEW_INSTITUTION = 'CONNECT_NEW_INSTITUTION',
     ERROR = 'ERROR',
     EXIT = 'EXIT',
     FAIL_OAUTH = 'FAIL_OAUTH',
     HANDOFF = 'HANDOFF',
+    IDENTITY_MATCH_PASSED = 'IDENTITY_MATCH_PASSED',
+    IDENTITY_MATCH_FAILED = 'IDENTITY_MATCH_FAILED',
     IDENTITY_VERIFICATION_CLOSE_UI = 'IDENTITY_VERIFICATION_CLOSE_UI',
     IDENTITY_VERIFICATION_CREATE_SESSION = 'IDENTITY_VERIFICATION_CREATE_SESSION',
     IDENTITY_VERIFICATION_FAIL_SESSION = 'IDENTITY_VERIFICATION_FAIL_SESSION',
@@ -458,6 +461,7 @@ export enum LinkEventName {
     IDENTITY_VERIFICATION_RESUME_SESSION = 'IDENTITY_VERIFICATION_RESUME_SESSION',
     IDENTITY_VERIFICATION_RESUME_UI = 'IDENTITY_VERIFICATION_RESUME_UI',
     IDENTITY_VERIFICATION_START_STEP = 'IDENTITY_VERIFICATION_START_STEP',
+    ISSUE_FOLLOWED = 'ISSUE_FOLLOWED',
     LAYER_NOT_AVAILABLE = 'LAYER_NOT_AVAILABLE',
     LAYER_READY = 'LAYER_READY',
     MATCHED_CONSENT = 'MATCHED_CONSENT',
@@ -473,6 +477,7 @@ export enum LinkEventName {
     REMEMBER_ME_ENABLED = 'REMEMBER_ME_ENABLED',
     REMEMBER_ME_HOLDOUT = 'REMEMBER_ME_HOLDOUT',
     SEARCH_INSTITUTION = 'SEARCH_INSTITUTION',
+    SELECT_ACCOUNT = 'SELECT_ACCOUNT',
     SELECT_AUTH_TYPE = 'SELECT_AUTH_TYPE',
     SELECT_BRAND = 'SELECT_BRAND',
     SELECT_DEGRADED_INSTITUTION = 'SELECT_DEGRADED_INSTITUTION',
@@ -491,6 +496,7 @@ export enum LinkEventName {
     SUBMIT_EMAIL = 'SUBMIT_EMAIL',
     SUBMIT_MFA = 'SUBMIT_MFA',
     SUBMIT_PHONE = 'SUBMIT_PHONE',
+    SUBMIT_OTP = 'SUBMIT_OTP',
     SUBMIT_ROUTING_NUMBER = 'SUBMIT_ROUTING_NUMBER',
     TRANSITION_VIEW = 'TRANSITION_VIEW',
     VERIFY_PHONE = 'VERIFY_PHONE',