<?php

declare(strict_types=1);

return [
    'retain_processed_jobs' => env('JOBS__RETAIN_PROCESSED_JOBS', false),

    /**
     * Where `jobs:queue sweep` reports a job left locked by a worker that died.
     *
     * The module's own `queue` stream is file-only, which reports nothing to anybody. An
     * app with a stream that mails or posts should name it here — a stranded job is
     * invisible otherwise, since nothing failed and nothing threw.
     */
    'alert_log_stream' => env('JOBS__ALERT_LOG_STREAM', 'queue'),

    /**
     * The handlers `jobs:queue` acts on when `--handler` is not given. Null is the whole
     * queue, which is the honest default for a queue nobody has told us anything about.
     *
     * An app where one family of jobs is what "the queue" means to whoever is woken up by
     * it — a sync pipeline whose failures stop everything behind them, say — can name those
     * handlers here, and the bare command will mean them. `--handler=all` still reaches the
     * rest, and `jobs:queue handlers` always lists everything.
     *
     * @var class-string[]|null
     */
    'default_handlers' => null,
];
