Module Integration

API Key Update (Required)

Starting with iOS SDK 5.0.0+, Lucra SDK initialization requires a new apiKey.

Documentation will be updated once this version is available

What changed

• A new apiKey is required during Lucra SDK initialization.

• The previous apiKey + apiUrl initialization pattern is no longer supported.

• Existing integrations on older SDK versions continue to function as-is.

Required action

• Update your Lucra SDK initialization to pass the new apiKey at runtime.

• Remove prior apiUrl reference.

Notes

• The apiKey used prior to this version will not work once this latest version is adopted.

• Please reach out to Lucra to obtain your new Sandbox and Production keys.

• Backend API keys are unchanged.

let client = LucraClient(config: .init(environment: .init(apiURL: <Your API URL>,
                                                          apiKey: <Your API Key>,
                                                          environment: <.sandbox, .production>,
                                                          urlScheme: <Your App URL Scheme>),
                                                          appearance: <Client Theme Object>))

NOTES:

1. Pass in nil for any fields you have not already collected. All nil values will be ignored persisting any values the user has entered through the Lucra SDK.

2. Once set, changing first_name, last_name, or city will result in the user being set to unverified and they will need to go thru the KYC flow again. This is due to legal/compliance measures.

Task {
   do {
      try await lucraClient.configure(user: .init(username: username,
                                                  avatarURL: avatarURL,
                                                  phoneNumber: phoneNumber,
                                                  email: email,
                                                  firstName: firstName,
                                                  lastName: lastName,
                                                  metadata: userMetadta
                                                  address: .init(address: address,
                                                                 addressCont: addressCont,
                                                                 city: city,
                                                                 state: state,
                                                                 zip: zip),
                                                  dateOfBirth: sendableDob))
    } catch {
       // Show error to user or handle it here
       print("Configure Error: \(error)")
    }
}

Receive User Updates

To receive updates when the user manually enters profile info inside the LucraSDK, subscribe to the user publisher value on LucraClient. This allows you to capture fields such as user address if you have not previously collected that in your app. Returns nil if user is not logged in.

lucraClient.$user.sink { user in
// If user is nil they have not logged in yet
}
.store(in: &cancellables)