6.0.0

Purchasely iOS SDK 6.0.0

6.0.0 is a major release with breaking changes. It modernizes SDK initialization and the paywall display surface, replaces the global action interceptor with a granular per-action API, adds Swift Package Manager support, and lands cross-platform parity and reliability fixes. Most read-only call sites keep compiling; anything that configures the SDK or drives paywall display will need updates.

👉 Before upgrading, read the full Migration Guide. Every breaking change below links to a numbered section there with before/after code.

---

Highlights

🔧 Fluent initialization builder

Purchasely.start(withAPIKey:…) is replaced by a fluent Purchasely.apiKey(…)…start() chain with async/await and completion-handler variants. ⚠️ The default running mode changed from .full to .observer — add .runningMode(.full) explicitly if you validate transactions.

🎯 Per-action interceptor API

setPaywallActionsInterceptor (one global handler, ambiguous boolean) is replaced by per-action Purchasely.interceptAction(.login) { … } returning an explicit PLYInterceptResult (.success / .failed / .notHandled), with async/await support and richer PLYInterceptorInfo context.

🧱 Consolidated paywall display around PLYPresentationBuilder

A single fluent builder now owns presentation, display, and dismissal end-to-end. It replaces the fetchPresentation(…) family, the UIViewController- and SwiftUI-view-returning factories, and showController(…). Supports content id, color and header-button overrides, and lifecycle callbacks (onPresented, onCloseRequested, onDismissed).

📦 Enriched dismiss outcome

PLYPresentationBuilder.onDismissed and the renamed setDefaultPresentationDismissHandler now deliver a PLYPresentationOutcome carrying purchaseResult, plan, presentation, a new PLYCloseReason (.button / .interactiveDismiss / .programmatic / .none), and a reserved error field.

📐 Transition sizing (height / width / dismissible)

PLYTransition (formerly PLYDisplayMode) gains additive sizing for drawer/popin — fixed pixels or percentage, plus a dismissible flag that blocks ambient dismiss when false. PLYDimension is now public so you can build sized transitions in code.

🍎 Direct SwiftUI access

PLYPresentation.swiftUIView gives SwiftUI consumers a paywall View directly off the preloaded presentation, replacing the old controller.PresentationView indirection.

---

Breaking changes

Full details and before/after code in the Migration Guide.

Initialization & configuration

• §1 — Purchasely.start(withAPIKey:…) removed → use the Purchasely.apiKey(…) builder. Default running mode is now .observer (was .full).
• Pre-start class funcs (setEnvironment, setThemeMode, etc.) deprecated (removed in v7).

Action interceptors

• §2 — setPaywallActionsInterceptor() removed → Purchasely.interceptAction().
• §3 — PLYPresentationInfo removed → PLYInterceptorInfo.
• §4 — paywallActionsInterceptor parameter removed from start().
• §5 — PLYPaywallActionsInterceptor typealias removed.

Presentation & display

• §6 — PLYPresentation is now a protocol (was a class); reads/methods compile unchanged.
• §7 — PLYPresentationViewController.PresentationView removed.
• §8/§9 — public delegate signatures and PLYInterceptorInfo.presentation take any PLYPresentation.
• §10 — Purchasely.fetchPresentation(…) removed → PLYPresentationBuilder.
• §11 — closeDisplayedPresentation() removed → closeAllScreens().
• §12 — UIViewController-returning factories removed → PLYPresentationBuilder.
• §13 — Purchasely.display(…) simplified to a one-liner (transition: param; vendor-ID/completion/async overloads removed).
• §14 — setDefaultPresentationResultHandler renamed to setDefaultPresentationDismissHandler, now delivers PLYPresentationOutcome.
• §15 — SwiftUI embedded-view factories removed → PLYPresentationBuilder + presentation.swiftUIView.
• §21 — showController(_:type:from:) and PLYUIControllerType removed.
• §22 — legacy "My Subscriptions" screen removed, along with PLYEvent.subscriptionsListViewed and .cancellationReasonPublished.

Renames (no compat aliases)

• §17 — PLYDisplayMode → PLYTransition, PLYDisplayModeType → PLYTransitionType, PLYPresentation.id → .screenId, PLYPresentation.displayMode → .transition, PLYPresentationBuilder.onClose → .onCloseRequested, clientPresentationOpened(with:) → clientPresentationDisplayed(with:).

Deeplinks & attributes

• §16 — ply/products/* and ply/plans/* deeplinks removed → use ply/presentations/<id> or ply/placements/<id>.
• §18 — readyToOpenDeeplink(_:) → allowDeeplink(_:); isDeeplinkHandled(deeplink:) → handleDeeplink(_:).
• §19 — allowCampaigns now defaults to true (was false) and waits for configuration before displaying.
• §20 — PLYAttribute.oneSignalPlayerId removed → oneSignalExternalId / oneSignalUserId. Backend targeting rules keyed on onesignal_player_id must be repointed to onesignal_external_id.

---

Internal improvements (no code changes required)

• AsyncStream action executor: Fixed an issue with double-completion actions from a single tap.
• Unified display architecture: all presentations display through a single PLYWindow code path, fixing flow-state and missed-event edge cases.
• Flow state corruption fix: no more orphaned SDK windows or corrupted flow state after certain dismiss sequences.
• StoreKit: removed the FB22760273 commitment-price workaround (fixed by Apple); billing-plan-scoped offers for iOS 26.4 monthly commitment.
• Numerous layout, header-button, tvOS focus, and iPad flow-close fixes.