bacnet-server 0.15.0

//! ReinitializeDevice (Clause 16.4): the application handler that carries a
//! request out, the requester context it receives, the builder setters for
//! the handler and the password, and the guarded reply the full server and
//! endpoint sessions share.

use std::panic::{AssertUnwindSafe, catch_unwind};

use bacnet_transport::port::{DirectScIdentity, TransportProvenance};
use bacnet_types::enums::{AuditOperation, ReinitializedState};

use super::requests::confirmed_response::error_apdu_from_error;
use super::*;

/// Carries out a ReinitializeDevice request (Clause 16.4) on a full server or
/// an endpoint session.
///
/// It is called only for a request that decoded, passed its password check
/// and names a state the clause defines. `Ok(())` sends the SimpleACK; an
/// `Err` is sent in its place. The rules:
///
/// - **Reply first, restart later.** The SimpleACK goes out only after the
///   handler returns, so it must not restart the device inline. Accept or
///   refuse, prepare, and register the restart (or the backup or restore
///   step) with [`ReinitializeContext::after_reply`]: Clause 16.4.2 has the
///   device acknowledge the request before it shuts down.
/// - **The after-reply hook.** It runs once the SimpleACK has been handed
///   to the transport (#1565). On MS/TP, handed off means queued: on the
///   reply channel or the transmit queue the frame still waits for the
///   token, so stopping the server or the port at once can drop the reply
///   there. Wait a short while (a few token rotations) first. It
///   never runs for a request answered
///   with an Error: the handler refused it or panicked, or the Network Port
///   activation below failed. Nor does it run when the reply could not be
///   handed over; the requester retries then. [`BACnetServer::stop`] seals
///   responses and aborts request tasks before joining them, so a restart
///   path that stops the server starts from the hook, never from the
///   handler. On a full server, accepted WARMSTART/COLDSTART ends
///   DISABLE_INITIATION as the handler accepts (Clause 16.1.2), cancels its
///   timer and resumes held COV, even if the reply later fails.
/// - **Be quick.** It runs synchronously on a runtime worker with the object
///   database write-locked, so every other request waits for it. Hand slow
///   work, such as writing backup files, to a task. On an endpoint session a
///   blocking handler stalls the whole session. Never wait on another task
///   or thread from it (a `block_on`, a channel receive, a join): if that
///   work needs the database, the server deadlocks.
/// - **Database edits are raw.** On a full server, changes made through the
///   `&mut ObjectDatabase` skip what [`BACnetServer::write_local`] adds
///   around a write: the Object_Name uniqueness check, the COV fanout, the
///   event pass, Schedule and Command follow-ups, and the Audit record. A
///   change that needs them, as ACTIVATE_CHANGES work on Network Port or
///   Device properties may, belongs in `write_local`, called after the
///   reply from a task the handler schedules (for example by sending the
///   change to the code that holds the server).
/// - **Network Port changes activate around it.** For ACTIVATE_CHANGES or
///   WARMSTART the server first checks that the values written to Network
///   Port objects would still be taken
///   ([`ObjectDatabase::check_network_port_changes`]), and refuses with
///   PROPERTY / INVALID_CONFIGURATION_DATA (Clause 16.4.1.3.1) before the
///   handler runs if not. Once the handler accepts, the server puts them
///   into effect under the same lock and clears Changes_Pending (Clause
///   12.56.13), the transport's BDT for one
///   ([`ObjectDatabase::activate_network_port_changes`]): all or none per
///   port, not across ports. A refusal then is answered the same way and
///   leaves them pending. With no handler set, a registered port's
///   pending-activation rows refuse writes, since nothing could activate
///   them.
/// - **Colour outputs on an in-process restart.** A server start drives each
///   Color and Color Temperature output to its default (#1526). An
///   application that carries WARMSTART or COLDSTART out in process, without
///   building a new server, should do the same: call `start_output` on each
///   colour object, which is safe to call again (a zero default then keeps
///   the current value). It is a raw database edit, so it sends no COV
///   notification of its own.
/// - **Audited once accepted.** With Audit Reporters configured, an accepted
///   request (the handler accepted and any Network Port activation took)
///   records DEVICE_RESET, DEVICE_BACKUP or DEVICE_RESTORE from the
///   requester (Clause 19.6, Table 19-5, #1564); ACTIVATE_CHANGES, which
///   the table doesn't list, and every refusal record nothing. Report a
///   reset made for the application's own reasons with
///   [`BACnetServer::report_device_reset_local`].
/// - **Gate the requester.** Without `reinit_password` any peer reaches the
///   handler. Neither [`MutationPolicy`](crate::mutation::MutationPolicy)
///   nor the [`ServerPolicy`](crate::ServerPolicy) covers ReinitializeDevice, so check the
///   [`ReinitializeContext`] to restrict sources.
/// - **Refuse with [`Error::protocol`].** Its class and code go back in an
///   Error PDU, for example DEVICE / CONFIGURATION_IN_PROGRESS (Clause
///   16.4.1.3.1). Once the handler has run, the request may no longer be
///   rejected (Clause 20.1.8), so an [`Error::reject`], or any error other
///   than an Error PDU's `Remote` or `Structured`, is sent as SERVICES / OTHER. A panic is
///   caught (with unwind builds) and also answered SERVICES / OTHER, since
///   the handler may have partly acted.
pub type ReinitializeHandler =
    Arc<dyn Fn(&ReinitializeContext, &mut ObjectDatabase) -> Result<(), Error> + Send + Sync>;

/// Records an accepted ReinitializeDevice request on an endpoint session
/// (#1564): the Table 19-5 operation and the requester, called under the
/// database guard once the request is accepted. The session supplies it
/// when its Audit Reporter is configured.
pub type EndpointReinitializeAudit = Arc<
    dyn Fn(&mut ObjectDatabase, AuditOperation, &bacnet_objects::device::AuditWriteSource)
        + Send
        + Sync,
>;

/// The ReinitializeDevice request a [`ReinitializeHandler`] is asked to carry
/// out, and who sent it.
///
/// The addresses are claims, not an authenticated operator. For routed
/// traffic `source_mac` is the last router, so restrict routed requesters by
/// `source_network`. Only the certificate accessors are verified:
/// [`principal`](Self::principal) names the direct SC peer that sent the
/// request itself, and is `None` for a routed one;
/// [`forwarding_peer_principal`](Self::forwarding_peer_principal) and
/// [`direct_sc_identity`](Self::direct_sc_identity) name the immediate hop,
/// a router included. Neither the mutation policy nor the
/// [`ServerPolicy`](crate::ServerPolicy) sees this service, so a handler that
/// serves only some peers checks them here.
///
/// The server builds the context; [`new`](Self::new) lets a test build one
/// to call a handler directly.
#[derive(Clone, PartialEq, Eq)]
#[non_exhaustive]
pub struct ReinitializeContext {
    /// The requested state, one of those Clause 16.4 defines.
    pub state: ReinitializedState,
    /// Immediate data-link peer (or router) address.
    pub source_mac: MacAddr,
    /// Originating NPDU source when the request was routed.
    pub source_network: Option<NpduAddress>,
    /// Immutable ingress snapshot, retained after the admitting connection closes.
    pub provenance: TransportProvenance,
    /// Confirmed-request invoke identifier.
    pub invoke_id: u8,
    /// Work registered with [`after_reply`](Self::after_reply). Clones
    /// share it, so a hook registered through a clone still belongs to the
    /// request.
    after_reply: AfterReplyHooks,
}

/// One piece of work registered with [`ReinitializeContext::after_reply`].
type AfterReplyHook = Box<dyn FnOnce() + Send>;

/// The hooks a request's handler registered, shared by its context's clones.
#[derive(Clone, Default)]
struct AfterReplyHooks(Arc<std::sync::Mutex<Vec<AfterReplyHook>>>);

impl AfterReplyHooks {
    fn hooks(&self) -> std::sync::MutexGuard<'_, Vec<AfterReplyHook>> {
        self.0
            .lock()
            .unwrap_or_else(std::sync::PoisonError::into_inner)
    }

    fn take(&self) -> AfterReply {
        AfterReply(std::mem::take(&mut *self.hooks()))
    }
}

/// Hooks are work the handler scheduled, not part of the request, so they
/// never make two contexts unequal.
impl PartialEq for AfterReplyHooks {
    fn eq(&self, _: &Self) -> bool {
        true
    }
}

impl Eq for AfterReplyHooks {}

/// The after-reply hooks of an accepted request, taken from its context.
/// Empty for a request answered with an Error.
#[derive(Default)]
#[must_use = "an accepted request's hooks run once its reply is handed off"]
pub(in crate::server) struct AfterReply(Vec<AfterReplyHook>);

impl AfterReply {
    /// Whether no hook waits, as for every refusal.
    #[cfg(test)]
    pub(in crate::server) fn is_empty(&self) -> bool {
        self.0.is_empty()
    }

    /// Run each hook in registration order, once the SimpleACK has been
    /// handed to the transport, with no server lock held. A panicking hook
    /// is logged and the rest still run.
    pub(in crate::server) fn run(self) {
        for hook in self.0 {
            if catch_unwind(AssertUnwindSafe(hook)).is_err() {
                warn!("ReinitializeDevice after-reply hook panicked");
            }
        }
    }
}

impl ReinitializeContext {
    /// A context with these fields, for calling a handler outside the server,
    /// such as in its unit tests. Outside `bacnet-transport` only
    /// [`TransportProvenance::unverified`] can be built.
    pub fn new(
        state: ReinitializedState,
        source_mac: MacAddr,
        source_network: Option<NpduAddress>,
        provenance: TransportProvenance,
        invoke_id: u8,
    ) -> Self {
        Self {
            state,
            source_mac,
            source_network,
            provenance,
            invoke_id,
            after_reply: AfterReplyHooks::default(),
        }
    }

    /// Run `hook` once this request's SimpleACK has been handed to the
    /// transport, with no server lock held: the place to restart, or to
    /// start the backup or restore step, after replying (Clause 16.4.2).
    ///
    /// Hooks run in the order registered, on the task that answered the
    /// request, so each should be quick and hand longer work to a task or
    /// thread of its own. On MS/TP, handed off means queued: the frame
    /// still waits for the token, so a hook that stops the server or the
    /// port at once can drop the reply; wait a short while first. Hooks
    /// registered through a clone of the context after the handler returns
    /// never run. They are dropped unrun when the request is
    /// answered with an Error instead (the handler refused it or panicked,
    /// or the Network Port activation after it failed), when the reply
    /// could not be handed over, and when [`BACnetServer::stop`] aborts the
    /// request task first. A panic in one is logged and the next still runs.
    /// A context built with [`new`](Self::new) outside the server never runs
    /// its hooks unless a test runs them itself.
    pub fn after_reply(&self, hook: impl FnOnce() + Send + 'static) {
        self.after_reply.hooks().push(Box::new(hook));
    }

    /// Test seam: take and run the hooks registered so far, as the server
    /// does once the reply is handed off, and return how many there were.
    /// For a binding's tests of a handler built on [`after_reply`](Self::after_reply);
    /// never call it from a handler.
    #[doc(hidden)]
    pub fn run_after_reply_for_test(&self) -> usize {
        let hooks = self.after_reply.take();
        let count = hooks.0.len();
        hooks.run();
        count
    }

    /// The principal of the peer that originated the request: the verified
    /// leaf certificate of a direct BACnet/SC connection, when the request
    /// carries no routed source. `None` for other ingress, hub-relayed and
    /// routed requests included (see [`crate::policy`]).
    pub fn principal(&self) -> Option<bacnet_transport::port::ScPrincipal> {
        crate::policy::originating_principal(&self.provenance, self.source_network.as_ref())
    }

    /// The principal of the direct BACnet/SC peer that handed this request
    /// over, a router included when the request was routed; `None` off a
    /// verified direct SC connection. Trusting it trusts everything that
    /// peer forwards.
    pub fn forwarding_peer_principal(&self) -> Option<bacnet_transport::port::ScPrincipal> {
        self.provenance.principal()
    }

    crate::policy::certificate_accessors!();

    /// The immediate direct-SC hop's verified leaf and connection incarnation:
    /// for a routed request, the router that forwarded it. Absent off a
    /// verified direct SC connection. Separate from claimed addresses.
    pub fn direct_sc_identity(&self) -> Option<DirectScIdentity> {
        self.provenance.direct_sc_identity()
    }

    /// The requester as an endpoint's Audit record names it: its address,
    /// the originating one when routed, with the request's invoke ID.
    pub(in crate::server) fn audit_source(&self) -> bacnet_objects::device::AuditWriteSource {
        use bacnet_types::constructed::{BACnetAddress, BACnetRecipient};
        let (network_number, mac_address) = match &self.source_network {
            Some(source) => (source.network, source.mac_address.clone()),
            None => (0, self.source_mac.clone()),
        };
        bacnet_objects::device::AuditWriteSource {
            device: BACnetRecipient::Address(BACnetAddress {
                network_number,
                mac_address,
            }),
            invoke_id: self.invoke_id,
        }
    }
}

impl std::fmt::Debug for ReinitializeContext {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        f.debug_struct("ReinitializeContext")
            .field("state", &self.state)
            .field("source_mac_len", &self.source_mac.len())
            .field(
                "source_network",
                &self
                    .source_network
                    .as_ref()
                    .map(|s| (s.network, s.mac_address.len())),
            )
            .field("provenance", &self.provenance)
            .field("invoke_id", &self.invoke_id)
            .finish_non_exhaustive()
    }
}

/// Where a ReinitializeDevice request came from: its [`ReinitializeContext`]
/// short of the state, which decoding supplies.
pub(in crate::server) struct Requester {
    source_mac: MacAddr,
    source_network: Option<NpduAddress>,
    provenance: TransportProvenance,
}

impl Requester {
    pub(in crate::server) fn new(
        source_mac: &[u8],
        source_network: Option<&NpduAddress>,
        provenance: TransportProvenance,
    ) -> Self {
        Self {
            source_mac: MacAddr::from_slice(source_mac),
            source_network: source_network.cloned(),
            provenance,
        }
    }
}

/// Answer a ReinitializeDevice request: decode it, check its password and its
/// state, then run `handler` with the database write-locked. A valid request
/// with no handler is refused with SERVICES / SERVICE_REQUEST_DENIED.
///
/// `still_open` runs once the write lock is held, so an owner that closed
/// while the request waited refuses it before the handler runs.
/// `on_accepted` runs only once the request is accepted, meaning the handler
/// accepted it and any Network Port activation succeeded, under the same
/// guard and with no suspension before the reply is built: the place for the
/// DCC restart transition and the Audit record (#1564).
///
/// A SimpleACK comes back with the hooks the handler registered, for the
/// caller to run once it has handed the reply off. An Error comes back with
/// none: they were dropped here.
pub(in crate::server) async fn response(
    db: &RwLock<ObjectDatabase>,
    request: &ConfirmedRequestPdu,
    password: &Option<String>,
    handler: Option<&ReinitializeHandler>,
    requester: Requester,
    still_open: impl FnOnce() -> Result<(), Error>,
    on_accepted: impl FnOnce(&ReinitializeContext, &mut ObjectDatabase),
) -> (Apdu, AfterReply) {
    let outcome = match handlers::handle_reinitialize_device(&request.service_request, password) {
        Ok(state) => match handler {
            Some(handler) => {
                let context = ReinitializeContext::new(
                    state,
                    requester.source_mac,
                    requester.source_network,
                    requester.provenance,
                    request.invoke_id,
                );
                let mut db = db.write().await;
                let outcome = still_open()
                    .and_then(|()| check_network_ports(state, &mut db))
                    .and_then(|()| invoke(handler, &context, &mut db))
                    .and_then(|()| activate_network_ports(state, &mut db));
                // Taken under the guard, so a clone the handler kept adds
                // nothing later. A refusal drops them here, unrun.
                let hooks = context.after_reply.take();
                outcome.map(|()| {
                    on_accepted(&context, &mut db);
                    hooks
                })
            }
            None => Err(services_error(ErrorCode::SERVICE_REQUEST_DENIED)),
        },
        Err(error) => Err(error),
    };
    match outcome {
        Ok(hooks) => {
            let ack = Apdu::SimpleAck(SimpleAck {
                invoke_id: request.invoke_id,
                service_choice: request.service_choice,
            });
            (ack, hooks)
        }
        Err(error) => (
            error_apdu_from_error(request.invoke_id, request.service_choice, &error),
            AfterReply::default(),
        ),
    }
}

/// Full-server acceptance also owns the DCC restart transition and the
/// request's Audit record (#1564), through `audit`, the requester's. Acquire
/// the timer slot before the handler's database lock, as DCC
/// replacement/expiry do.
///
/// An accepted restart that ends DISABLE_INITIATION records only its
/// DEVICE_RESET: the implicit re-enable is part of the reset, not a
/// DeviceCommunicationControl operation of its own.
pub(in crate::server) async fn server_response<T: TransportPort + 'static>(
    services: &super::request_services::RequestServices<T>,
    request: &ConfirmedRequestPdu,
    requester: Requester,
    audit: &mut super::audit_reporter::WriteAudit<'_, T>,
) -> (Apdu, AfterReply) {
    let cov_resume = services.cov_table.read().await.timed().clone();
    let mut slot = services.dcc_timer.lock().await;
    let mut restart_accepted = false;
    let reply = response(
        &services.db,
        request,
        &services.config.reinit_password,
        services.config.on_reinitialize.as_ref(),
        requester,
        || Ok(()),
        |context, db| {
            if matches!(
                context.state,
                ReinitializedState::WARMSTART | ReinitializedState::COLDSTART
            ) {
                super::dcc_timer::enable_for_restart(&slot, &services.comm_state, &cov_resume);
                restart_accepted = true;
            }
            if let Some(operation) = audit_operation(context.state) {
                audit.device_operation(db, operation);
            }
        },
    )
    .await;
    if restart_accepted {
        // The commit already happened. Cancellation during this borrowed join
        // retains the aborted handle for later replacement/shutdown cleanup.
        super::dcc_timer::cancel(&mut slot).await;
    }
    reply
}

/// The Audit operation an accepted request in `state` records (Clause 19.6,
/// Table 19-5, #1564): DEVICE_RESET for the two restarts, DEVICE_BACKUP for
/// the backup steps and DEVICE_RESTORE for the restore steps.
/// ACTIVATE_CHANGES has no row in the table, so it records nothing.
pub(in crate::server) fn audit_operation(state: ReinitializedState) -> Option<AuditOperation> {
    match state {
        ReinitializedState::COLDSTART | ReinitializedState::WARMSTART => {
            Some(AuditOperation::DEVICE_RESET)
        }
        ReinitializedState::START_BACKUP | ReinitializedState::END_BACKUP => {
            Some(AuditOperation::DEVICE_BACKUP)
        }
        ReinitializedState::START_RESTORE
        | ReinitializedState::END_RESTORE
        | ReinitializedState::ABORT_RESTORE => Some(AuditOperation::DEVICE_RESTORE),
        _ => None,
    }
}

/// Run `handler` under a panic guard. Execution has begun once it is called,
/// so the request may no longer draw a Reject (Clause 20.1.8): a panic, a
/// Reject, or an error with no class and code is answered SERVICES / OTHER.
fn invoke(
    handler: &ReinitializeHandler,
    context: &ReinitializeContext,
    db: &mut ObjectDatabase,
) -> Result<(), Error> {
    match catch_unwind(AssertUnwindSafe(|| handler(context, db))) {
        Ok(Ok(())) => Ok(()),
        Ok(Err(error @ (Error::Remote(RemoteError::Error { .. }) | Error::Structured { .. }))) => {
            Err(error)
        }
        Ok(Err(error)) => {
            debug!(%error, "ReinitializeDevice handler error answered SERVICES / OTHER");
            Err(services_error(ErrorCode::OTHER))
        }
        Err(_) => {
            warn!(
                state = context.state.to_raw(),
                invoke_id = context.invoke_id,
                "ReinitializeDevice handler panicked; answered SERVICES / OTHER"
            );
            Err(services_error(ErrorCode::OTHER))
        }
    }
}

/// Whether `state` activates the values written to Network Port objects
/// (Clause 12.56.13).
fn activates(state: ReinitializedState) -> bool {
    matches!(
        state,
        ReinitializedState::ACTIVATE_CHANGES | ReinitializedState::WARMSTART
    )
}

/// The reply when Network Port values fail validation on activation:
/// PROPERTY / INVALID_CONFIGURATION_DATA (Clause 16.4.1.3.1).
fn invalid_configuration(error: &Error) -> Error {
    debug!(%error, "Network Port activation refused");
    Error::protocol(ErrorClass::PROPERTY, ErrorCode::INVALID_CONFIGURATION_DATA)
}

/// Before the handler runs, check that the pending Network Port values
/// would still be taken, so a handler never schedules a restart for a
/// request that then fails.
fn check_network_ports(state: ReinitializedState, db: &mut ObjectDatabase) -> Result<(), Error> {
    if !activates(state) {
        return Ok(());
    }
    db.check_network_port_changes()
        .map_err(|error| invalid_configuration(&error))
}

/// Once the handler has accepted ACTIVATE_CHANGES or WARMSTART, put the
/// values written to Network Port objects into effect (Clause 12.56.13):
/// the transport's BDT, for one. The check before the handler makes a
/// refusal here a race with a change to the transport; it is answered the
/// same way, as an Error, since the request may no longer be rejected
/// (Clause 20.1.8).
fn activate_network_ports(state: ReinitializedState, db: &mut ObjectDatabase) -> Result<(), Error> {
    if !activates(state) {
        return Ok(());
    }
    db.activate_network_port_changes()
        .map(drop)
        .map_err(|error| invalid_configuration(&error))
}

fn services_error(code: ErrorCode) -> Error {
    Error::protocol(ErrorClass::SERVICES, code)
}

impl<T: TransportPort + 'static> BACnetServer<T> {
    /// Report a reset the application carries out for its own reasons, not
    /// at a peer's ReinitializeDevice request: a DEVICE_RESET Audit record
    /// from this device, with no invoke ID (Clause 19.6, Table 19-5 covers
    /// resets for any reason, #1564).
    ///
    /// An accepted WARMSTART or COLDSTART is recorded already; don't report
    /// it again. The record goes through the Reporter that monitors the
    /// local Device, under that Device's audit policy, as a peer's reset's
    /// does, and does nothing when no Reporter selects it. It returns once
    /// the record is admitted, not delivered, so call it before the restart
    /// begins and give delivery time before the process exits.
    ///
    /// # Errors
    ///
    /// The stopped-server error once [`stop`](Self::stop) has run.
    pub async fn report_device_reset_local(&self) -> Result<(), Error> {
        let network = self.active_network()?;
        let mut db = self.db.write().await;
        if let Some(mut audit) = super::audit_reporter::WriteAudit::local(
            &self.config,
            network,
            &self.notification_transactions,
            &db,
        ) {
            audit.device_operation(&mut db, AuditOperation::DEVICE_RESET);
        }
        Ok(())
    }
}

impl<T: TransportPort + 'static> ServerBuilder<T> {
    /// Set the password required for ReinitializeDevice requests.
    pub fn reinit_password(mut self, password: impl Into<String>) -> Self {
        self.config.reinit_password = Some(password.into());
        self
    }

    /// Set the ReinitializeDevice handler. It must reply before restarting and
    /// stay quick; see [`ReinitializeHandler`].
    pub fn on_reinitialize<F>(mut self, handler: F) -> Self
    where
        F: Fn(&ReinitializeContext, &mut ObjectDatabase) -> Result<(), Error>
            + Send
            + Sync
            + 'static,
    {
        self.config.on_reinitialize = Some(Arc::new(handler));
        self
    }
}

impl BipServerBuilder {
    /// Set the password required for ReinitializeDevice requests.
    pub fn reinit_password(mut self, password: impl Into<String>) -> Self {
        self.config.reinit_password = Some(password.into());
        self
    }

    /// Set the ReinitializeDevice handler. It must reply before restarting and
    /// stay quick; see [`ReinitializeHandler`].
    pub fn on_reinitialize<F>(mut self, handler: F) -> Self
    where
        F: Fn(&ReinitializeContext, &mut ObjectDatabase) -> Result<(), Error>
            + Send
            + Sync
            + 'static,
    {
        self.config.on_reinitialize = Some(Arc::new(handler));
        self
    }
}

#[cfg(feature = "sc-tls")]
impl super::ScServerBuilder {
    /// Set the password required for ReinitializeDevice requests.
    pub fn reinit_password(mut self, password: impl Into<String>) -> Self {
        self.config.reinit_password = Some(password.into());
        self
    }

    /// Set the ReinitializeDevice handler. It must reply before restarting and
    /// stay quick; see [`ReinitializeHandler`].
    pub fn on_reinitialize<F>(mut self, handler: F) -> Self
    where
        F: Fn(&ReinitializeContext, &mut ObjectDatabase) -> Result<(), Error>
            + Send
            + Sync
            + 'static,
    {
        self.config.on_reinitialize = Some(Arc::new(handler));
        self
    }
}

#[cfg(test)]
#[path = "reinitialize_hook_tests.rs"]
mod hook_tests;