adding-deep-link

Adding Deep Link / Push Notification Logic

Add routing logic to ModuleWrapperPresenter.swift for deep links (.onOpenURL) or push notifications (.onNotificationReceived).

Where to Edit

Core/ModuleWrapper/ModuleWrapperPresenter.swift — both handlers live here:

• handleDeepLink(url:delegate:) — receives the URL
• handlePushNotificationReceived(notification:delegate:) — receives the notification

NavigationStack Warning

ModuleWrapperView does NOT have a NavigationStack. This limits available navigation:

Supported:

• router.showScreen(.fullScreenCover) { ... }
• router.showScreen(.sheet) { ... }
• router.showModal { ... }
• router.showAlert { ... }
• Update interactor state
• Post a NotificationCenter notification

NOT supported:

• router.showScreen(.push) — will silently fail

If you need .push navigation: Post a custom Notification.Name from the presenter and listen for it with .onNotificationReceived(name:) in a child view that has a NavigationStack (e.g., HomeView).

State-Aware Routing

Deep links and push notifications are sensitive to user state. Always check state before routing:

// Available on interactor (add to ModuleWrapperInteractor protocol as needed):
interactor.auth           // UserAuthInfo? — nil if not authenticated
interactor.currentUser    // UserModel? — nil if not loaded
interactor.isPremium      // Bool — entitlement status

// Available on delegate:
delegate.moduleId         // String — which module is active (Constants.tabbarModuleId or Constants.onboardingModuleId)

Common Guards

// Only handle in tabbar module (skip if user is onboarding)
guard delegate.moduleId == Constants.tabbarModuleId else { return }

// Require authentication
guard interactor.auth != nil else { return }

// Require premium
guard interactor.isPremium else { return }

Adding Interactor Properties

If ModuleWrapperInteractor doesn't expose what you need, add it to the protocol:

// In ModuleWrapperInteractor.swift:
@MainActor
protocol ModuleWrapperInteractor: GlobalInteractor {
    var auth: UserAuthInfo? { get }
}