Appearance
Host seams (the legitimate public extension points)
The public binary exposes a single host-supplied hook: logHandler (§2.2) — the sink the SDK writes its logs to (unset = silent). App identity is supplied once as configuration via SB_AppConfig (appType / appFlavor / appDisplayName / enableCrashlytics) passed to initialize (§2.1).
Everything a host previously wired as a supplied callback or implemented interface is now delivered through the observable event streams (§3.2) — the host observes, it does not implement a seam:
- Sync notifications — observe
syncCompletedand arm your own "haven't synced" reminder from it (it fires on both the detailed drain and the nothing-to-fetch short-circuit, so either way the band was reached). Removed in favour of this: asyncNotificationActionsstream of explicit SCHEDULE/CANCEL requests, which armed off connection events rather than off a sync. - A session that ended without the user asking — observe
reauthenticationRequired, run teardown, and route to login (§3.2.2). (signOutCompletewas the old signal and is no longer emitted.) - Lapsed device subscription — observe
subscriptionLost, sign out, and explain why (§3.2.1). - Analytics — observe
analyticsEventsand forward them to your analytics provider (event set: §3.2.3).