Guides

Release Notes

v2.2.1 (August 20, 2026)

  • Fixed: the sandbox environment now points to https://sandbox-sync.aero.inc (previously https://sandbox.aerosync.com). If you allowlist AeroSync domains in a firewall or CSP policy, update it to the new host.

v2.2.0 (August 20, 2026)

  • Added typed multi-account success models — AerosyncSuccessPayload, AerosyncSingleAccountSuccessPayload, AerosyncMultiAccountSuccessPayload, AerosyncLinkedAccount
  • Call AerosyncSuccessPayload.parse(from:) inside onSuccess to parse the raw JSON string into a single-account or multi-account case; switch on the enum to narrow
  • No breaking changes — parsing is entirely optional, existing integrations remain unchanged

v2.1.0 (June 9, 2026)

  • Removed: AerosyncEmbeddedView (to be re-introduced in a future release)
  • Removed: dev and staging environments — use "sandbox" for non-production testing
  • Changed: removed all debug print statements from production code paths
  • Breaking changes: aeroPassUserUuid became required; dev/staging environments no longer supported; AerosyncEmbeddedView removed

v2.0.4 (January 29, 2026)

First stable 2.x release — combines everything introduced across 2.0.0-rc.1–rc.3, plus its own fix:

  • Added AerosyncEmbeddedView, a lightweight bank search and selection interface, with automatic transition to the full widget
  • Added aeroPassUserUuid (required), configurationId, stateCode, manualLinkOnly, and handleMFA/jobId/connectionId for MFA re-authentication
  • Removed the old consumerId and userId parameters
  • Fixed a critical issue where SDK callbacks (onSuccess, onEvent, onClose) stopped firing on iOS 26.2, caused by a race condition between native SDK initialization and web app readiness — resolved via persistent coordinator instances and setting window.iOSReady directly. Tested on iOS 26.2 (iPhone 14/15) and iOS 18.0 (backward compatibility verified)
  • Also restored onBankClick event forwarding and fixed a retain cycle

v1.2.1 (January 11, 2026)

  • Backport of the same iOS 26.2 message-handler compatibility fix as v2.0.4, released to the legacy 1.x line — no breaking changes, drop-in replacement for 1.2.0

v1.2.0 (July 24, 2025)

  • Added theme parameter to customize widget appearance — supports "light" (default) and "dark"
  • Fully backward compatible; existing implementations default to the light theme

v1.1.0 (October 17, 2024)

  • Added a new Sandbox environment — a safe, isolated space for testing and development that replicates the production setup

v1.0.2 (February 2, 2024)

  • Added MFA flow handling
  • Added swipe gesture navigation (swipe right to go back, swipe left to go forward)

v1.0.1 (December 19, 2023)

  • Removed the dev environment from available options

v1.0.0 (December 12, 2023)

  • Fixed onLoad firing on every navigation instead of only on the initial page load
📘

Upgrading from v1.2.1?

See the Migrating from 1.x section of the iOS SDK doc for a full parameter-by-parameter migration table, or the iOS SDK (Legacy v1.2.1) page for the old API reference.

Updated about 1 month ago

Did this page help you?