enabled

val enabled: Boolean = true

Master gate for the push subsystem.

true (default) → FCM token fetch runs at init, inbound FCM data is rendered, Swan.requestFcmToken works as documented.

false → no token fetch at init; Swan.requestFcmToken returns Result.failure(IllegalStateException("Push disabled")); Swan.handleFcmInbound silently drops the message (the manifest-declared service cannot be unregistered at runtime, but the inbound hook is a no-op so nothing is rendered, no warm-start tap fires, no delivery ACK is sent); onNewToken rotations do NOT POST to /device/push-subscription.

Setting this to false does NOT revoke a previously-synced token from the backend — call Swan.unsubscribePush explicitly for that. The gate is purely "future inbound is suppressed"; existing subscriptions stay alive until explicit revoke.