From 1609d24a81629949d2c7da597c255eb137e0de02 Mon Sep 17 00:00:00 2001
From: dtroupe <dtroupe@plaid.com>
Date: Fri, 27 Mar 2026 12:33:58 -0700
Subject: [PATCH 1/2] sync financekit

---
 example/screens/SyncFinanceKitScreen.tsx      | 243 +++++++++++++++++-
 ios/src/ReactNativePlaidLinkSdkModule.swift   |  73 ++++++
 src/ReactNativePlaidLinkSdk.types.ts          | 198 ++++++++------
 src/ReactNativePlaidLinkSdkModule.ts          |  14 +-
 .../ReactNativePlaidLinkSdkModule.ts          |   2 +-
 .../createPlaidHeadlessSession.test.ts        |   6 +-
 src/__tests__/createPlaidLayerSession.test.ts |  14 +-
 src/__tests__/createPlaidLinkSession.test.ts  |  14 +-
 src/__tests__/listener-lifecycle.test.ts      |   8 +-
 src/__tests__/types.test.ts                   |  90 ++++++-
 src/index.ts                                  |  40 ++-
 11 files changed, 577 insertions(+), 125 deletions(-)

diff --git a/example/screens/SyncFinanceKitScreen.tsx b/example/screens/SyncFinanceKitScreen.tsx
index d03c57b8..c23b917e 100644
--- a/example/screens/SyncFinanceKitScreen.tsx
+++ b/example/screens/SyncFinanceKitScreen.tsx
@@ -1,11 +1,246 @@
-import { SafeAreaView, Text, Button } from "react-native";
+import { useState } from "react";
+import {
+  Button,
+  SafeAreaView,
+  ScrollView,
+  Text,
+  View,
+  Switch,
+  ActivityIndicator,
+  Platform,
+  StyleSheet,
+} from "react-native";
+import {
+  syncFinanceKit,
+  FinanceKitSyncBehavior,
+} from "react-native-plaid-link-sdk";
+import ReactNativePlaidLinkSdk from "react-native-plaid-link-sdk";
+import {
+  ErrorView,
+  SdkVersionView,
+  TokenInputView,
+} from "../components/components";
 import { styles } from "../styles/common";
+import { isValidToken } from "../utils/validation";
+
+type Props = { onBack: () => void };
+
+export function SyncFinanceKitScreen({ onBack }: Props) {
+  const [token, setToken] = useState("");
+  const [isSyncing, setIsSyncing] = useState(false);
+  const [requestAuthorizationIfNeeded, setRequestAuthorizationIfNeeded] =
+    useState(true);
+  const [syncBehavior] = useState<FinanceKitSyncBehavior>(
+    FinanceKitSyncBehavior.SIMULATED
+  );
+  const [errorMessage, setErrorMessage] = useState<string | null>(null);
+  const [statusMessage, setStatusMessage] = useState<string | null>(null);
+  const [statusIsError, setStatusIsError] = useState(false);
+
+  const handleSync = async () => {
+    if (!token.trim()) {
+      setErrorMessage("Please enter a link token");
+      return;
+    }
+
+    if (!isValidToken(token)) {
+      setErrorMessage("Invalid token format");
+      return;
+    }
+
+    if (Platform.OS !== "ios") {
+      setErrorMessage("FinanceKit is only available on iOS");
+      return;
+    }
+
+    setIsSyncing(true);
+    setErrorMessage(null);
+    setStatusMessage(null);
+
+    try {
+      await syncFinanceKit({
+        token: token.trim(),
+        requestAuthorizationIfNeeded,
+        syncBehavior,
+      });
+      setStatusMessage("Sync completed successfully");
+      setStatusIsError(false);
+      setIsSyncing(false);
+    } catch (e: any) {
+      const message = e.message ?? "Sync failed";
+      setStatusMessage(message);
+      setStatusIsError(true);
+      setIsSyncing(false);
+    }
+  };
+
+  const canSync = isValidToken(token) && !isSyncing && Platform.OS === "ios";
 
-export function SyncFinanceKitScreen({ onBack }: { onBack: () => void }) {
   return (
     <SafeAreaView style={styles.container}>
-      <Button title="← Back" onPress={onBack} />
-      <Text style={styles.title}>Sync FinanceKit</Text>
+      <ScrollView style={styles.container}>
+        <View style={styles.backButton}>
+          <Button title="← Back" onPress={onBack} />
+        </View>
+
+        <View style={styles.content}>
+          <Text style={styles.title}>Sync FinanceKit Example</Text>
+          <SdkVersionView version={ReactNativePlaidLinkSdk.sdkVersion} />
+
+          <TokenInputView token={token} onTokenChange={setToken} />
+
+          <View style={componentStyles.warningBox}>
+            <Text style={componentStyles.warningTitle}>⚠️ IMPORTANT</Text>
+            <Text style={componentStyles.warningText}>Requirements:</Text>
+            <Text style={componentStyles.requirementText}>
+              1. You MUST have a FinanceKit entitlement from Apple (or the app
+              will crash)
+            </Text>
+            <Text style={componentStyles.requirementText}>
+              2. The link token must be associated with an access token from a
+              previous session where the user linked their Apple Card
+            </Text>
+            <Text style={componentStyles.requirementText}>
+              3. iOS 17.4 or later is required
+            </Text>
+          </View>
+
+          <View style={componentStyles.toggleContainer}>
+            <View style={componentStyles.toggleRow}>
+              <Text style={componentStyles.toggleLabel}>
+                Request Authorization If Needed
+              </Text>
+              <Switch
+                value={requestAuthorizationIfNeeded}
+                onValueChange={setRequestAuthorizationIfNeeded}
+                disabled={isSyncing}
+              />
+            </View>
+
+            <View style={componentStyles.toggleRow}>
+              <Text style={componentStyles.toggleLabel}>
+                Sync Behavior: Simulated
+              </Text>
+              <Switch value={true} disabled={true} />
+            </View>
+          </View>
+
+          {errorMessage && <ErrorView message={errorMessage} />}
+
+          {statusMessage && (
+            <View
+              style={[
+                componentStyles.statusBox,
+                statusIsError
+                  ? componentStyles.statusError
+                  : componentStyles.statusSuccess,
+              ]}
+            >
+              <Text
+                style={[
+                  componentStyles.statusText,
+                  statusIsError
+                    ? componentStyles.statusTextError
+                    : componentStyles.statusTextSuccess,
+                ]}
+              >
+                {statusMessage}
+              </Text>
+            </View>
+          )}
+
+          <View
+            style={[styles.button, !canSync && styles.buttonDisabled]}
+            pointerEvents={canSync ? "auto" : "none"}
+          >
+            <Button
+              title={isSyncing ? "Syncing..." : "Sync FinanceKit"}
+              onPress={handleSync}
+              disabled={!canSync}
+              color="#fff"
+            />
+            {isSyncing && (
+              <ActivityIndicator color="#fff" style={styles.spinner} />
+            )}
+          </View>
+        </View>
+      </ScrollView>
     </SafeAreaView>
   );
 }
+
+const componentStyles = StyleSheet.create({
+  warningBox: {
+    width: "100%",
+    maxWidth: 400,
+    padding: 12,
+    backgroundColor: "#FFF3CD",
+    borderRadius: 10,
+    borderWidth: 1,
+    borderColor: "#FFE69C",
+  },
+  warningTitle: {
+    fontSize: 16,
+    fontWeight: "700",
+    color: "#FF9500",
+    marginBottom: 8,
+    textAlign: "center",
+  },
+  warningText: {
+    fontSize: 14,
+    fontWeight: "600",
+    color: "#333",
+    marginBottom: 8,
+  },
+  requirementText: {
+    fontSize: 13,
+    color: "#333",
+    marginBottom: 6,
+    lineHeight: 18,
+  },
+  toggleContainer: {
+    width: "100%",
+    maxWidth: 400,
+    padding: 16,
+    backgroundColor: "#fff",
+    borderRadius: 10,
+    gap: 16,
+  },
+  toggleRow: {
+    flexDirection: "row",
+    justifyContent: "space-between",
+    alignItems: "center",
+  },
+  toggleLabel: {
+    fontSize: 14,
+    fontWeight: "600",
+    color: "#333",
+    flex: 1,
+    marginRight: 12,
+  },
+  statusBox: {
+    width: "100%",
+    maxWidth: 400,
+    padding: 12,
+    borderRadius: 10,
+    borderWidth: 1,
+  },
+  statusSuccess: {
+    backgroundColor: "#D1F2EB",
+    borderColor: "#A9DFBF",
+  },
+  statusError: {
+    backgroundColor: "#FADBD8",
+    borderColor: "#F5B7B1",
+  },
+  statusText: {
+    fontSize: 14,
+    textAlign: "center",
+  },
+  statusTextSuccess: {
+    color: "#27AE60",
+  },
+  statusTextError: {
+    color: "#E74C3C",
+  },
+});
diff --git a/ios/src/ReactNativePlaidLinkSdkModule.swift b/ios/src/ReactNativePlaidLinkSdkModule.swift
index 58f25705..ee17c082 100644
--- a/ios/src/ReactNativePlaidLinkSdkModule.swift
+++ b/ios/src/ReactNativePlaidLinkSdkModule.swift
@@ -276,6 +276,36 @@ public class ReactNativePlaidLinkSdkModule: Module {
                 promise.resolve()
             }
         }
+
+        AsyncFunction(ModuleFunctionName.syncFinanceKit.rawValue) { (token: String, requestAuthorizationIfNeeded: Bool, syncBehavior: Int, promise: Promise) in
+            if #available(iOS 17.4, *) {
+                let behavior: PlaidFinanceKit.SyncBehavior = syncBehavior == 0 ? .live : .simulated
+                
+                PlaidFinanceKit.sync(
+                    token: token,
+                    requestAuthorizationIfNeeded: requestAuthorizationIfNeeded,
+                    syncBehavior: behavior,
+                    completion: { result in
+                        DispatchQueue.main.async {
+                            switch result {
+                            case .success:
+                                promise.resolve()
+                            case .failure(let error):
+                                let errorDict = error.asFinanceKitErrorDictionary
+                                promise.reject(
+                                    errorDict["errorCode"] as? String ?? "FINANCE_KIT_ERROR",
+                                    errorDict["errorMessage"] as? String ?? error.localizedDescription
+                                )
+                            }
+                        }
+                    }
+                )
+            } else {
+                DispatchQueue.main.async {
+                    promise.reject("UNSUPPORTED_IOS_VERSION", "FinanceKit requires iOS 17.4 or later")
+                }
+            }
+        }
     }
 
     // MARK: Enums
@@ -296,6 +326,7 @@ public class ReactNativePlaidLinkSdkModule: Module {
         case openLayerSession
         case submitLayerData
         case startHeadlessSession
+        case syncFinanceKit
     }
 
     // MARK: Private
@@ -452,3 +483,45 @@ struct LayerSubmissionData: SubmissionData {
     let dateOfBirth: String?
     let params: [String: String]?
 }
+
+@available(iOS 17.4, *)
+fileprivate extension LinkKit.FinanceKitError {
+    var asFinanceKitErrorDictionary: [String: Any] {
+        let errorType: Int
+        let errorCode: String
+        let errorMessage: String
+        
+        switch self {
+        case .invalidToken:
+            errorType = 0
+            errorCode = "INVALID_TOKEN"
+            errorMessage = self.localizedDescription
+        case .permissionError:
+            errorType = 1
+            errorCode = "PERMISSION_ERROR"
+            errorMessage = self.localizedDescription
+        case .linkApiError:
+            errorType = 2
+            errorCode = "LINK_API_ERROR"
+            errorMessage = self.localizedDescription
+        case .permissionAccessError:
+            errorType = 3
+            errorCode = "PERMISSION_ACCESS_ERROR"
+            errorMessage = self.localizedDescription
+        case .unknown(let error):
+            errorType = 4
+            errorCode = "UNKNOWN"
+            errorMessage = error.localizedDescription
+        @unknown default:
+            errorType = 4
+            errorCode = "UNKNOWN"
+            errorMessage = self.localizedDescription
+        }
+        
+        return [
+            "errorType": errorType,
+            "errorCode": errorCode,
+            "errorMessage": errorMessage,
+        ]
+    }
+}
diff --git a/src/ReactNativePlaidLinkSdk.types.ts b/src/ReactNativePlaidLinkSdk.types.ts
index 3cd4a0d9..139e2452 100644
--- a/src/ReactNativePlaidLinkSdk.types.ts
+++ b/src/ReactNativePlaidLinkSdk.types.ts
@@ -98,323 +98,320 @@ export interface LinkAccountSubtype {}
 export class LinkAccountSubtypeCredit implements LinkAccountSubtype {
   public static readonly ALL = new LinkAccountSubtypeCredit(
     LinkAccountType.CREDIT,
-    LinkAccountSubtypes.ALL,
+    LinkAccountSubtypes.ALL
   );
   public static readonly CREDIT_CARD = new LinkAccountSubtypeCredit(
     LinkAccountType.CREDIT,
-    LinkAccountSubtypes.CREDIT_CARD,
+    LinkAccountSubtypes.CREDIT_CARD
   );
   public static readonly PAYPAL = new LinkAccountSubtypeCredit(
     LinkAccountType.CREDIT,
-    LinkAccountSubtypes.PAYPAL,
+    LinkAccountSubtypes.PAYPAL
   );
 
   private constructor(
     public readonly type: LinkAccountType,
-    public readonly subtype: LinkAccountSubtype,
+    public readonly subtype: LinkAccountSubtype
   ) {}
 }
 
 export class LinkAccountSubtypeDepository implements LinkAccountSubtype {
   public static readonly ALL = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.ALL,
+    LinkAccountSubtypes.ALL
   );
   public static readonly CASH_MANAGEMENT = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.CASH_MANAGEMENT,
+    LinkAccountSubtypes.CASH_MANAGEMENT
   );
   public static readonly CD = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.CD,
+    LinkAccountSubtypes.CD
   );
   public static readonly CHECKING = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.CHECKING,
+    LinkAccountSubtypes.CHECKING
   );
   public static readonly EBT = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.EBT,
+    LinkAccountSubtypes.EBT
   );
   public static readonly HSA = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.HSA,
+    LinkAccountSubtypes.HSA
   );
   public static readonly MONEY_MARKET = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.MONEY_MARKET,
+    LinkAccountSubtypes.MONEY_MARKET
   );
   public static readonly PAYPAL = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.PAYPAL,
+    LinkAccountSubtypes.PAYPAL
   );
   public static readonly PREPAID = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.PREPAID,
+    LinkAccountSubtypes.PREPAID
   );
   public static readonly SAVINGS = new LinkAccountSubtypeDepository(
     LinkAccountType.DEPOSITORY,
-    LinkAccountSubtypes.SAVINGS,
+    LinkAccountSubtypes.SAVINGS
   );
 
   private constructor(
     public readonly type: LinkAccountType,
-    public readonly subtype: LinkAccountSubtype,
+    public readonly subtype: LinkAccountSubtype
   ) {}
 }
 
 export class LinkAccountSubtypeInvestment implements LinkAccountSubtype {
   public static readonly ALL = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.ALL,
+    LinkAccountSubtypes.ALL
   );
   public static readonly BROKERAGE = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.BROKERAGE,
+    LinkAccountSubtypes.BROKERAGE
   );
   public static readonly CASH_ISA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.CASH_ISA,
+    LinkAccountSubtypes.CASH_ISA
   );
   public static readonly EDUCATION_SAVINGS_ACCOUNT =
     new LinkAccountSubtypeInvestment(
       LinkAccountType.INVESTMENT,
-      LinkAccountSubtypes.EDUCATION_SAVINGS_ACCOUNT,
+      LinkAccountSubtypes.EDUCATION_SAVINGS_ACCOUNT
     );
   public static readonly FIXED_ANNUNITY = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.FIXED_ANNUNITY,
+    LinkAccountSubtypes.FIXED_ANNUNITY
   );
   public static readonly GIC = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.GIC,
+    LinkAccountSubtypes.GIC
   );
   public static readonly HEALTH_REIMBURSEMENT_ARRANGEMENT =
     new LinkAccountSubtypeInvestment(
       LinkAccountType.INVESTMENT,
-      LinkAccountSubtypes.HEALTH_REIMBURSEMENT_ARRANGEMENT,
+      LinkAccountSubtypes.HEALTH_REIMBURSEMENT_ARRANGEMENT
     );
   public static readonly HSA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.HSA,
+    LinkAccountSubtypes.HSA
   );
   public static readonly INVESTMENT_401A = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.FOUR_0_1_A,
+    LinkAccountSubtypes.FOUR_0_1_A
   );
   public static readonly INVESTMENT_401K = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.FOUR_0_1_K,
+    LinkAccountSubtypes.FOUR_0_1_K
   );
   public static readonly INVESTMENT_403B = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.FOUR_0_3_B,
+    LinkAccountSubtypes.FOUR_0_3_B
   );
   public static readonly INVESTMENT_457B = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.FOUR_5_7_B,
+    LinkAccountSubtypes.FOUR_5_7_B
   );
   public static readonly INVESTMENT_529 = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.FIVE_2_9,
+    LinkAccountSubtypes.FIVE_2_9
   );
   public static readonly IRA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.IRA,
+    LinkAccountSubtypes.IRA
   );
   public static readonly ISA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.ISA,
+    LinkAccountSubtypes.ISA
   );
   public static readonly KEOGH = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.KEOGH,
+    LinkAccountSubtypes.KEOGH
   );
   public static readonly LIF = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.LIF,
+    LinkAccountSubtypes.LIF
   );
   public static readonly LIRA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.LIRA,
+    LinkAccountSubtypes.LIRA
   );
   public static readonly LRIF = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.LRIF,
+    LinkAccountSubtypes.LRIF
   );
   public static readonly LRSP = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.LRSP,
+    LinkAccountSubtypes.LRSP
   );
   public static readonly MUTUAL_FUND = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.MUTUAL_FUND,
+    LinkAccountSubtypes.MUTUAL_FUND
   );
   public static readonly NON_TAXABLE_BROKERAGE_ACCOUNT =
     new LinkAccountSubtypeInvestment(
       LinkAccountType.INVESTMENT,
-      LinkAccountSubtypes.NON_TAXABLE_BROKERAGE_ACCOUNT,
+      LinkAccountSubtypes.NON_TAXABLE_BROKERAGE_ACCOUNT
     );
   public static readonly PENSION = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.PENSION,
+    LinkAccountSubtypes.PENSION
   );
   public static readonly PLAN = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.PLAN,
+    LinkAccountSubtypes.PLAN
   );
   public static readonly PRIF = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.PRIF,
+    LinkAccountSubtypes.PRIF
   );
   public static readonly PROFIT_SHARING_PLAN = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.PROFIT_SHARING_PLAN,
+    LinkAccountSubtypes.PROFIT_SHARING_PLAN
   );
   public static readonly RDSP = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.RDSP,
+    LinkAccountSubtypes.RDSP
   );
   public static readonly RESP = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.RESP,
+    LinkAccountSubtypes.RESP
   );
   public static readonly RETIREMENT = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.RETIREMENT,
+    LinkAccountSubtypes.RETIREMENT
   );
   public static readonly RLIF = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.RLIF,
+    LinkAccountSubtypes.RLIF
   );
   public static readonly ROTH = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.ROTH,
+    LinkAccountSubtypes.ROTH
   );
   public static readonly ROTH_401K = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.ROTH_401K,
+    LinkAccountSubtypes.ROTH_401K
   );
   public static readonly RRIF = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.RRIF,
+    LinkAccountSubtypes.RRIF
   );
   public static readonly RRSP = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.RRSP,
+    LinkAccountSubtypes.RRSP
   );
   public static readonly SARSEP = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.SARSEP,
+    LinkAccountSubtypes.SARSEP
   );
   public static readonly SEP_IRA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.SEP_IRA,
+    LinkAccountSubtypes.SEP_IRA
   );
   public static readonly SIMPLE_IRA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.SIMPLE_IRA,
+    LinkAccountSubtypes.SIMPLE_IRA
   );
   public static readonly SIIP = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.SIPP,
+    LinkAccountSubtypes.SIPP
   );
   public static readonly STOCK_PLAN = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.STOCK_PLAN,
+    LinkAccountSubtypes.STOCK_PLAN
   );
   public static readonly TFSA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.TFSA,
+    LinkAccountSubtypes.TFSA
   );
   public static readonly THRIFT_SAVINGS_PLAN = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.THRIFT_SAVINGS_PLAN,
+    LinkAccountSubtypes.THRIFT_SAVINGS_PLAN
   );
   public static readonly TRUST = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.TRUST,
+    LinkAccountSubtypes.TRUST
   );
   public static readonly UGMA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.UGMA,
+    LinkAccountSubtypes.UGMA
   );
   public static readonly UTMA = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.UTMA,
+    LinkAccountSubtypes.UTMA
   );
   public static readonly VARIABLE_ANNUITY = new LinkAccountSubtypeInvestment(
     LinkAccountType.INVESTMENT,
-    LinkAccountSubtypes.VARIABLE_ANNUITY,
+    LinkAccountSubtypes.VARIABLE_ANNUITY
   );
 
   private constructor(
     public readonly type: LinkAccountType,
-    public readonly subtype: LinkAccountSubtype,
+    public readonly subtype: LinkAccountSubtype
   ) {}
 }
 
 export class LinkAccountSubtypeLoan implements LinkAccountSubtype {
   public static readonly ALL = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.ALL,
+    LinkAccountSubtypes.ALL
   );
   public static readonly AUTO = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.AUTO,
+    LinkAccountSubtypes.AUTO
   );
   public static readonly BUSINESS = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.BUSINESS,
+    LinkAccountSubtypes.BUSINESS
   );
   public static readonly COMMERCIAL = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.COMMERCIAL,
+    LinkAccountSubtypes.COMMERCIAL
   );
   public static readonly CONSTRUCTION = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.CONSTRUCTION,
+    LinkAccountSubtypes.CONSTRUCTION
   );
   public static readonly CONSUMER = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.CONSUMER,
+    LinkAccountSubtypes.CONSUMER
   );
   public static readonly HOME_EQUITY = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.HOME_EQUITY,
+    LinkAccountSubtypes.HOME_EQUITY
   );
   public static readonly LINE_OF_CREDIT = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.LINE_OF_CREDIT,
+    LinkAccountSubtypes.LINE_OF_CREDIT
   );
   public static readonly LOAN = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.LOAN,
+    LinkAccountSubtypes.LOAN
   );
   public static readonly MORTGAGE = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.MORTGAGE,
+    LinkAccountSubtypes.MORTGAGE
   );
   public static readonly OVERDRAFT = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.OVERDRAFT,
+    LinkAccountSubtypes.OVERDRAFT
   );
   public static readonly STUDENT = new LinkAccountSubtypeLoan(
     LinkAccountType.LOAN,
-    LinkAccountSubtypes.STUDENT,
+    LinkAccountSubtypes.STUDENT
   );
 
   private constructor(
     public readonly type: LinkAccountType,
-    public readonly subtype: LinkAccountSubtype,
+    public readonly subtype: LinkAccountSubtype
   ) {}
 }
 
 export class LinkAccountSubtypeUnknown implements LinkAccountSubtype {
-  constructor(
-    public readonly type: string,
-    public readonly subtype: string,
-  ) {}
+  constructor(public readonly type: string, public readonly subtype: string) {}
 }
 
 export interface LinkSuccess {
@@ -832,3 +829,48 @@ export interface PlaidLayerSession {
 export interface PlaidHeadlessSession {
   start: () => Promise<void>;
 }
+
+export enum FinanceKitSyncBehavior {
+  LIVE = 0,
+  SIMULATED = 1,
+}
+
+export enum FinanceKitErrorType {
+  InvalidToken = 0,
+  PermissionError = 1,
+  LinkApiError = 2,
+  PermissionAccessError = 3,
+  Unknown = 4,
+}
+
+interface InvalidTokenError {
+  type: FinanceKitErrorType.InvalidToken;
+  message: string;
+}
+
+interface PermissionError {
+  type: FinanceKitErrorType.PermissionError;
+  message: string;
+}
+
+interface LinkApiError {
+  type: FinanceKitErrorType.LinkApiError;
+  message: string;
+}
+
+interface PermissionAccessError {
+  type: FinanceKitErrorType.PermissionAccessError;
+  message: string;
+}
+
+interface UnknownError {
+  type: FinanceKitErrorType.Unknown;
+  message: string;
+}
+
+export type FinanceKitError =
+  | InvalidTokenError
+  | PermissionError
+  | LinkApiError
+  | PermissionAccessError
+  | UnknownError;
diff --git a/src/ReactNativePlaidLinkSdkModule.ts b/src/ReactNativePlaidLinkSdkModule.ts
index f3be487b..63176e4b 100644
--- a/src/ReactNativePlaidLinkSdkModule.ts
+++ b/src/ReactNativePlaidLinkSdkModule.ts
@@ -1,6 +1,9 @@
 import { NativeModule, requireNativeModule } from "expo";
 
-import { ReactNativePlaidLinkSdkModuleEvents } from "./ReactNativePlaidLinkSdk.types";
+import {
+  ReactNativePlaidLinkSdkModuleEvents,
+  FinanceKitSyncBehavior,
+} from "./ReactNativePlaidLinkSdk.types";
 
 declare class ReactNativePlaidLinkSdkModule extends NativeModule<ReactNativePlaidLinkSdkModuleEvents> {
   sdkVersion: string;
@@ -13,11 +16,16 @@ declare class ReactNativePlaidLinkSdkModule extends NativeModule<ReactNativePlai
   submitLayerData(
     phoneNumber?: string,
     dateOfBirth?: string,
-    params?: Record<string, string>,
+    params?: Record<string, string>
+  ): Promise<void>;
+  syncFinanceKit(
+    token: string,
+    requestAuthorizationIfNeeded: boolean,
+    syncBehavior: FinanceKitSyncBehavior
   ): Promise<void>;
 }
 
 // This call loads the native module object from the JSI.
 export default requireNativeModule<ReactNativePlaidLinkSdkModule>(
-  "ReactNativePlaidLinkSdk",
+  "ReactNativePlaidLinkSdk"
 );
diff --git a/src/__mocks__/ReactNativePlaidLinkSdkModule.ts b/src/__mocks__/ReactNativePlaidLinkSdkModule.ts
index 3d87e02f..b603522a 100644
--- a/src/__mocks__/ReactNativePlaidLinkSdkModule.ts
+++ b/src/__mocks__/ReactNativePlaidLinkSdkModule.ts
@@ -21,7 +21,7 @@ const mockNativeModule = {
 
   submitLayerData: jest.fn(
     (phone?: string, dob?: string, params?: Record<string, string>) =>
-      Promise.resolve(),
+      Promise.resolve()
   ),
 
   addListener: jest
diff --git a/src/__tests__/createPlaidHeadlessSession.test.ts b/src/__tests__/createPlaidHeadlessSession.test.ts
index b837040a..7b6f766d 100644
--- a/src/__tests__/createPlaidHeadlessSession.test.ts
+++ b/src/__tests__/createPlaidHeadlessSession.test.ts
@@ -26,7 +26,7 @@ describe("createPlaidHeadlessSession", () => {
     const session = await createPlaidHeadlessSession(config);
 
     expect(NativePlaidModule.createPlaidHeadlessSession).toHaveBeenCalledWith(
-      "headless-token-123",
+      "headless-token-123"
     );
     expect(session).toHaveProperty("start");
     expect(typeof session.start).toBe("function");
@@ -216,11 +216,11 @@ describe("createPlaidHeadlessSession", () => {
     };
 
     await expect(createPlaidHeadlessSession(config)).rejects.toThrow(
-      "Headless session creation failed",
+      "Headless session creation failed"
     );
     expect(console.error).toHaveBeenCalledWith(
       "[PlaidLink] createPlaidHeadlessSession failed:",
-      mockError,
+      mockError
     );
   });
 
diff --git a/src/__tests__/createPlaidLayerSession.test.ts b/src/__tests__/createPlaidLayerSession.test.ts
index 7141462d..f4672031 100644
--- a/src/__tests__/createPlaidLayerSession.test.ts
+++ b/src/__tests__/createPlaidLayerSession.test.ts
@@ -26,7 +26,7 @@ describe("createPlaidLayerSession", () => {
     const session = await createPlaidLayerSession(config);
 
     expect(NativePlaidModule.createPlaidLayerSession).toHaveBeenCalledWith(
-      "layer-token-123",
+      "layer-token-123"
     );
     expect(session).toHaveProperty("open");
     expect(session).toHaveProperty("submit");
@@ -96,21 +96,21 @@ describe("createPlaidLayerSession", () => {
     expect(NativePlaidModule.submitLayerData).toHaveBeenCalledWith(
       "555-1234",
       undefined,
-      undefined,
+      undefined
     );
 
     await session.submit({ dateOfBirth: "1990-01-01" });
     expect(NativePlaidModule.submitLayerData).toHaveBeenCalledWith(
       undefined,
       "1990-01-01",
-      undefined,
+      undefined
     );
 
     await session.submit({ params: { foo: "bar", baz: "qux" } });
     expect(NativePlaidModule.submitLayerData).toHaveBeenCalledWith(
       undefined,
       undefined,
-      { foo: "bar", baz: "qux" },
+      { foo: "bar", baz: "qux" }
     );
 
     await session.submit({
@@ -121,7 +121,7 @@ describe("createPlaidLayerSession", () => {
     expect(NativePlaidModule.submitLayerData).toHaveBeenCalledWith(
       "555-9999",
       "1985-12-25",
-      { key: "value" },
+      { key: "value" }
     );
   });
 
@@ -182,11 +182,11 @@ describe("createPlaidLayerSession", () => {
     };
 
     await expect(createPlaidLayerSession(config)).rejects.toThrow(
-      "Layer session creation failed",
+      "Layer session creation failed"
     );
     expect(console.error).toHaveBeenCalledWith(
       "[PlaidLink] createPlaidLayerSession failed:",
-      mockError,
+      mockError
     );
   });
 });
diff --git a/src/__tests__/createPlaidLinkSession.test.ts b/src/__tests__/createPlaidLinkSession.test.ts
index cca4ba07..fb55383c 100644
--- a/src/__tests__/createPlaidLinkSession.test.ts
+++ b/src/__tests__/createPlaidLinkSession.test.ts
@@ -26,22 +26,22 @@ describe("createPlaidLinkSession", () => {
     const session = await createPlaidLinkSession(config);
 
     expect(NativePlaidModule.createPlaidLinkSession).toHaveBeenCalledWith(
-      "link-sandbox-token-123",
+      "link-sandbox-token-123"
     );
     expect(session).toHaveProperty("open");
     expect(typeof session.open).toBe("function");
     expect(NativePlaidModule.addListener).toHaveBeenCalledTimes(3);
     expect(NativePlaidModule.addListener).toHaveBeenCalledWith(
       "onSuccess",
-      expect.any(Function),
+      expect.any(Function)
     );
     expect(NativePlaidModule.addListener).toHaveBeenCalledWith(
       "onExit",
-      expect.any(Function),
+      expect.any(Function)
     );
     expect(NativePlaidModule.addListener).toHaveBeenCalledWith(
       "onEvent",
-      expect.any(Function),
+      expect.any(Function)
     );
   });
 
@@ -209,7 +209,7 @@ describe("createPlaidLinkSession", () => {
     expect(onEventMock).toHaveBeenCalledWith(mockEvent2);
 
     expect(
-      (NativePlaidModule as any).__getListenerCount("onEvent"),
+      (NativePlaidModule as any).__getListenerCount("onEvent")
     ).toBeGreaterThan(0);
   });
 
@@ -227,11 +227,11 @@ describe("createPlaidLinkSession", () => {
     };
 
     await expect(createPlaidLinkSession(config)).rejects.toThrow(
-      "Native session creation failed",
+      "Native session creation failed"
     );
     expect(console.error).toHaveBeenCalledWith(
       "[PlaidLink] createPlaidLinkSession failed:",
-      mockError,
+      mockError
     );
   });
 
diff --git a/src/__tests__/listener-lifecycle.test.ts b/src/__tests__/listener-lifecycle.test.ts
index 0ce986cf..8d41f41b 100644
--- a/src/__tests__/listener-lifecycle.test.ts
+++ b/src/__tests__/listener-lifecycle.test.ts
@@ -26,13 +26,13 @@ describe("Listener Lifecycle", () => {
     await createPlaidLinkSession(config);
 
     expect(
-      (NativePlaidModule as any).__getListenerCount("onSuccess"),
+      (NativePlaidModule as any).__getListenerCount("onSuccess")
     ).toBeGreaterThan(0);
     expect(
-      (NativePlaidModule as any).__getListenerCount("onExit"),
+      (NativePlaidModule as any).__getListenerCount("onExit")
     ).toBeGreaterThan(0);
     expect(
-      (NativePlaidModule as any).__getListenerCount("onEvent"),
+      (NativePlaidModule as any).__getListenerCount("onEvent")
     ).toBeGreaterThan(0);
 
     const mockSuccess: LinkSuccess = {
@@ -293,7 +293,7 @@ describe("Listener Lifecycle", () => {
     });
 
     expect(
-      (NativePlaidModule as any).__getListenerCount("onEvent"),
+      (NativePlaidModule as any).__getListenerCount("onEvent")
     ).toBeGreaterThan(0);
   });
 
diff --git a/src/__tests__/types.test.ts b/src/__tests__/types.test.ts
index 16008dbe..eaf6358c 100644
--- a/src/__tests__/types.test.ts
+++ b/src/__tests__/types.test.ts
@@ -14,6 +14,9 @@ import {
   LinkErrorType,
   LinkEventName,
   LinkIOSPresentationStyle,
+  FinanceKitSyncBehavior,
+  FinanceKitErrorType,
+  FinanceKitError,
 } from "../ReactNativePlaidLinkSdk.types";
 
 describe("Type Definitions", () => {
@@ -71,13 +74,13 @@ describe("Type Definitions", () => {
       it("has institution error codes", () => {
         expect(LinkErrorCode.INSTITUTION_DOWN).toBe("INSTITUTION_DOWN");
         expect(LinkErrorCode.INSTITUTION_NOT_RESPONDING).toBe(
-          "INSTITUTION_NOT_RESPONDING",
+          "INSTITUTION_NOT_RESPONDING"
         );
       });
 
       it("has API error codes", () => {
         expect(LinkErrorCode.INTERNAL_SERVER_ERROR).toBe(
-          "INTERNAL_SERVER_ERROR",
+          "INTERNAL_SERVER_ERROR"
         );
         expect(LinkErrorCode.PLANNED_MAINTENANCE).toBe("PLANNED_MAINTENANCE");
       });
@@ -96,13 +99,13 @@ describe("Type Definitions", () => {
     describe("LinkAccountVerificationStatus", () => {
       it("has correct values", () => {
         expect(
-          LinkAccountVerificationStatus.PENDING_AUTOMATIC_VERIFICATION,
+          LinkAccountVerificationStatus.PENDING_AUTOMATIC_VERIFICATION
         ).toBe("pending_automatic_verification");
         expect(LinkAccountVerificationStatus.PENDING_MANUAL_VERIFICATION).toBe(
-          "pending_manual_verification",
+          "pending_manual_verification"
         );
         expect(LinkAccountVerificationStatus.MANUALLY_VERIFIED).toBe(
-          "manually_verified",
+          "manually_verified"
         );
       });
     });
@@ -111,7 +114,7 @@ describe("Type Definitions", () => {
       it("has correct values", () => {
         expect(LinkExitMetadataStatus.CONNECTED).toBe("connected");
         expect(LinkExitMetadataStatus.REQUIRES_CREDENTIALS).toBe(
-          "requires_credentials",
+          "requires_credentials"
         );
         expect(LinkExitMetadataStatus.REQUIRES_CODE).toBe("requires_code");
       });
@@ -210,7 +213,7 @@ describe("Type Definitions", () => {
       it("handles arbitrary types", () => {
         const unknown = new LinkAccountSubtypeUnknown(
           "custom_type",
-          "custom_subtype",
+          "custom_subtype"
         );
         expect(unknown.type).toBe("custom_type");
         expect(unknown.subtype).toBe("custom_subtype");
@@ -438,7 +441,7 @@ describe("Type Definitions", () => {
 
       expect(linkSuccess).toBeDefined();
       expect(linkSuccess.metadata.accounts[0].verificationStatus).toBe(
-        "manually_verified",
+        "manually_verified"
       );
     });
 
@@ -501,4 +504,75 @@ describe("Type Definitions", () => {
       expect(linkEvent.metadata.institutionId).toBeDefined();
     });
   });
+
+  describe("FinanceKit Types", () => {
+    describe("FinanceKitSyncBehavior", () => {
+      it("has correct values", () => {
+        expect(FinanceKitSyncBehavior.LIVE).toBe(0);
+        expect(FinanceKitSyncBehavior.SIMULATED).toBe(1);
+      });
+    });
+
+    describe("FinanceKitErrorType", () => {
+      it("has correct values", () => {
+        expect(FinanceKitErrorType.InvalidToken).toBe(0);
+        expect(FinanceKitErrorType.PermissionError).toBe(1);
+        expect(FinanceKitErrorType.LinkApiError).toBe(2);
+        expect(FinanceKitErrorType.PermissionAccessError).toBe(3);
+        expect(FinanceKitErrorType.Unknown).toBe(4);
+      });
+    });
+
+    describe("FinanceKitError", () => {
+      it("InvalidTokenError structure", () => {
+        const error: FinanceKitError = {
+          type: FinanceKitErrorType.InvalidToken,
+          message: "Invalid token provided",
+        };
+
+        expect(error.type).toBe(FinanceKitErrorType.InvalidToken);
+        expect(error.message).toBe("Invalid token provided");
+      });
+
+      it("PermissionError structure", () => {
+        const error: FinanceKitError = {
+          type: FinanceKitErrorType.PermissionError,
+          message: "Permission denied",
+        };
+
+        expect(error.type).toBe(FinanceKitErrorType.PermissionError);
+        expect(error.message).toBe("Permission denied");
+      });
+
+      it("LinkApiError structure", () => {
+        const error: FinanceKitError = {
+          type: FinanceKitErrorType.LinkApiError,
+          message: "API error occurred",
+        };
+
+        expect(error.type).toBe(FinanceKitErrorType.LinkApiError);
+        expect(error.message).toBe("API error occurred");
+      });
+
+      it("PermissionAccessError structure", () => {
+        const error: FinanceKitError = {
+          type: FinanceKitErrorType.PermissionAccessError,
+          message: "Cannot access permissions",
+        };
+
+        expect(error.type).toBe(FinanceKitErrorType.PermissionAccessError);
+        expect(error.message).toBe("Cannot access permissions");
+      });
+
+      it("UnknownError structure", () => {
+        const error: FinanceKitError = {
+          type: FinanceKitErrorType.Unknown,
+          message: "An unknown error occurred",
+        };
+
+        expect(error.type).toBe(FinanceKitErrorType.Unknown);
+        expect(error.message).toBe("An unknown error occurred");
+      });
+    });
+  });
 });
diff --git a/src/index.ts b/src/index.ts
index d0fa2ca0..de31e829 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -8,6 +8,7 @@ import {
   PlaidLayerSession,
   PlaidHeadlessSession,
   SubmissionData,
+  FinanceKitSyncBehavior,
 } from "./ReactNativePlaidLinkSdk.types";
 import NativePlaidModule from "./ReactNativePlaidLinkSdkModule";
 
@@ -27,7 +28,7 @@ function cleanupListeners() {
 }
 
 export async function createPlaidLinkSession(
-  config: LinkTokenConfiguration,
+  config: LinkTokenConfiguration
 ): Promise<PlaidLinkSession> {
   try {
     cleanupListeners();
@@ -37,7 +38,7 @@ export async function createPlaidLinkSession(
       (success: LinkSuccess) => {
         config.onSuccess(success);
         cleanupListeners();
-      },
+      }
     );
 
     exitSub = NativePlaidModule.addListener("onExit", (exit: LinkExit) => {
@@ -66,7 +67,7 @@ export async function createPlaidLinkSession(
 }
 
 export async function createPlaidLayerSession(
-  config: LayerTokenConfiguration,
+  config: LayerTokenConfiguration
 ): Promise<PlaidLayerSession> {
   try {
     cleanupListeners();
@@ -74,7 +75,7 @@ export async function createPlaidLayerSession(
     console.log("[PlaidLink] createPlaidLayerSession - setting up listeners");
     console.log(
       "[PlaidLink] onEvent callback provided:",
-      typeof config.onEvent,
+      typeof config.onEvent
     );
 
     successSub = NativePlaidModule.addListener(
@@ -83,7 +84,7 @@ export async function createPlaidLayerSession(
         console.log("[PlaidLink] JS received onSuccess event");
         config.onSuccess(success);
         cleanupListeners();
-      },
+      }
     );
 
     exitSub = NativePlaidModule.addListener("onExit", (exit: LinkExit) => {
@@ -112,7 +113,7 @@ export async function createPlaidLayerSession(
         return NativePlaidModule.submitLayerData(
           data.phoneNumber,
           data.dateOfBirth,
-          data.params,
+          data.params
         );
       },
     };
@@ -123,13 +124,13 @@ export async function createPlaidLayerSession(
 }
 
 export async function createPlaidHeadlessSession(
-  config: LinkTokenConfiguration,
+  config: LinkTokenConfiguration
 ): Promise<PlaidHeadlessSession> {
   try {
     cleanupListeners();
 
     console.log(
-      "[PlaidLink] createPlaidHeadlessSession - setting up listeners",
+      "[PlaidLink] createPlaidHeadlessSession - setting up listeners"
     );
 
     successSub = NativePlaidModule.addListener(
@@ -138,7 +139,7 @@ export async function createPlaidHeadlessSession(
         console.log("[PlaidLink] JS received onSuccess event");
         config.onSuccess(success);
         cleanupListeners();
-      },
+      }
     );
 
     exitSub = NativePlaidModule.addListener("onExit", (exit: LinkExit) => {
@@ -153,7 +154,7 @@ export async function createPlaidHeadlessSession(
     });
 
     console.log(
-      "[PlaidLink] Listeners registered, creating native headless session",
+      "[PlaidLink] Listeners registered, creating native headless session"
     );
     await NativePlaidModule.createPlaidHeadlessSession(config.token);
 
@@ -175,5 +176,24 @@ export async function createPlaidHeadlessSession(
   }
 }
 
+export async function syncFinanceKit(config: {
+  token: string;
+  requestAuthorizationIfNeeded?: boolean;
+  syncBehavior?: FinanceKitSyncBehavior;
+}): Promise<void> {
+  try {
+    console.log("[PlaidLink] syncFinanceKit called");
+    await NativePlaidModule.syncFinanceKit(
+      config.token,
+      config.requestAuthorizationIfNeeded ?? true,
+      config.syncBehavior ?? FinanceKitSyncBehavior.LIVE
+    );
+    console.log("[PlaidLink] syncFinanceKit completed successfully");
+  } catch (e) {
+    console.error("[PlaidLink] syncFinanceKit failed:", e);
+    throw e;
+  }
+}
+
 export { default } from "./ReactNativePlaidLinkSdkModule";
 export * from "./ReactNativePlaidLinkSdk.types";

From 4269a31dd0b388543736be0ed9e4b597d9ae04c3 Mon Sep 17 00:00:00 2001
From: dtroupe <dtroupe@plaid.com>
Date: Fri, 27 Mar 2026 12:40:46 -0700
Subject: [PATCH 2/2] prevent android financekit sync

---
 .../ReactNativePlaidLinkSdkModule.ts          |   8 ++
 src/__tests__/syncFinanceKit.test.ts          | 109 ++++++++++++++++++
 src/index.ts                                  |   6 +
 3 files changed, 123 insertions(+)
 create mode 100644 src/__tests__/syncFinanceKit.test.ts

diff --git a/src/__mocks__/ReactNativePlaidLinkSdkModule.ts b/src/__mocks__/ReactNativePlaidLinkSdkModule.ts
index b603522a..25c4a524 100644
--- a/src/__mocks__/ReactNativePlaidLinkSdkModule.ts
+++ b/src/__mocks__/ReactNativePlaidLinkSdkModule.ts
@@ -24,6 +24,14 @@ const mockNativeModule = {
       Promise.resolve()
   ),
 
+  syncFinanceKit: jest.fn(
+    (
+      token: string,
+      requestAuthorizationIfNeeded: boolean,
+      syncBehavior: number
+    ) => Promise.resolve()
+  ),
+
   addListener: jest
     .fn()
     .mockImplementation((eventName: string, callback: Function) => {
diff --git a/src/__tests__/syncFinanceKit.test.ts b/src/__tests__/syncFinanceKit.test.ts
new file mode 100644
index 00000000..7c9b4ee5
--- /dev/null
+++ b/src/__tests__/syncFinanceKit.test.ts
@@ -0,0 +1,109 @@
+import { Platform } from "react-native";
+import { FinanceKitSyncBehavior } from "../ReactNativePlaidLinkSdk.types";
+import NativePlaidModule from "../ReactNativePlaidLinkSdkModule";
+import { syncFinanceKit } from "../index";
+
+jest.mock("react-native", () => ({
+  Platform: {
+    OS: "ios",
+  },
+}));
+
+describe("syncFinanceKit", () => {
+  beforeEach(() => {
+    jest.clearAllMocks();
+    (console.error as jest.Mock).mockClear();
+    (console.log as jest.Mock).mockClear();
+    (Platform as any).OS = "ios";
+  });
+
+  it("calls native module with correct parameters on iOS", async () => {
+    const config = {
+      token: "link-sandbox-token-123",
+      requestAuthorizationIfNeeded: true,
+      syncBehavior: FinanceKitSyncBehavior.LIVE,
+    };
+
+    await syncFinanceKit(config);
+
+    expect(NativePlaidModule.syncFinanceKit).toHaveBeenCalledWith(
+      "link-sandbox-token-123",
+      true,
+      FinanceKitSyncBehavior.LIVE
+    );
+  });
+
+  it("uses default values for optional parameters", async () => {
+    const config = {
+      token: "link-sandbox-token-123",
+    };
+
+    await syncFinanceKit(config);
+
+    expect(NativePlaidModule.syncFinanceKit).toHaveBeenCalledWith(
+      "link-sandbox-token-123",
+      true,
+      FinanceKitSyncBehavior.LIVE
+    );
+  });
+
+  it("accepts custom requestAuthorizationIfNeeded value", async () => {
+    const config = {
+      token: "link-sandbox-token-123",
+      requestAuthorizationIfNeeded: false,
+    };
+
+    await syncFinanceKit(config);
+
+    expect(NativePlaidModule.syncFinanceKit).toHaveBeenCalledWith(
+      "link-sandbox-token-123",
+      false,
+      FinanceKitSyncBehavior.LIVE
+    );
+  });
+
+  it("accepts SIMULATED sync behavior", async () => {
+    const config = {
+      token: "link-sandbox-token-123",
+      requestAuthorizationIfNeeded: true,
+      syncBehavior: FinanceKitSyncBehavior.SIMULATED,
+    };
+
+    await syncFinanceKit(config);
+
+    expect(NativePlaidModule.syncFinanceKit).toHaveBeenCalledWith(
+      "link-sandbox-token-123",
+      true,
+      FinanceKitSyncBehavior.SIMULATED
+    );
+  });
+
+  it("throws error on Android", async () => {
+    (Platform as any).OS = "android";
+
+    const config = {
+      token: "link-sandbox-token-123",
+    };
+
+    await expect(syncFinanceKit(config)).rejects.toThrow(
+      "FinanceKit is only available on iOS"
+    );
+
+    expect(NativePlaidModule.syncFinanceKit).not.toHaveBeenCalled();
+  });
+
+  it("propagates native module errors", async () => {
+    const nativeError = new Error("INVALID_TOKEN: Token is invalid");
+    (NativePlaidModule.syncFinanceKit as jest.Mock).mockRejectedValueOnce(
+      nativeError
+    );
+
+    const config = {
+      token: "invalid-token",
+    };
+
+    await expect(syncFinanceKit(config)).rejects.toThrow(
+      "INVALID_TOKEN: Token is invalid"
+    );
+  });
+});
diff --git a/src/index.ts b/src/index.ts
index de31e829..adb7f01d 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -1,3 +1,5 @@
+import { Platform } from "react-native";
+
 import {
   LinkExit,
   LinkEvent,
@@ -181,6 +183,10 @@ export async function syncFinanceKit(config: {
   requestAuthorizationIfNeeded?: boolean;
   syncBehavior?: FinanceKitSyncBehavior;
 }): Promise<void> {
+  if (Platform.OS === "android") {
+    throw new Error("FinanceKit is only available on iOS");
+  }
+
   try {
     console.log("[PlaidLink] syncFinanceKit called");
     await NativePlaidModule.syncFinanceKit(