JabbitListener

Watches what happens to jobs, for logging, analytics and crash reporting.

Every method has an empty body, so an implementation overrides only what it cares about. Install one — or several — through jabbit { listener(...) }.

Callbacks arrive on whichever thread the job changed on, and a listener that throws is logged and skipped rather than allowed to break the scheduler. They are meant for quick, non-blocking work: anything slower belongs in a coroutine the listener launches itself.

jabbit {
    worker(SyncJob) { SyncWorker(api) }

    listener(object : JabbitListener {
        override fun onFailed(job: JobInfo, error: Throwable?) {
            crashReporter.report("job ${job.typeName} failed: ${job.failureReason}", error)
        }
    })
}

On Android the scheduler is WorkManager, which also cancels work on its own — after WorkManager.cancelAllWork(), or when the application data is cleared. Those cancellations do not reach onCancelled, because they never pass through Jabbit.