1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
// =============================================================================
// Copyright (c) 2025 - 2026 Haixing Hu.
//
// SPDX-License-Identifier: Apache-2.0
//
// Licensed under the Apache License, Version 2.0.
// =============================================================================
//! Recovery states for failed synchronous writes.
/// Provider-confirmed recovery state when a write commit fails.
///
/// # Examples
///
/// ```rust
/// use qubit_fs::write::WriteFailureState;
///
/// let state = WriteFailureState::RetryableNotPublished;
/// match state {
/// WriteFailureState::RetryableNotPublished => println!("retry the commit"),
/// WriteFailureState::NotPublished => println!("clean up the unpublished target"),
/// WriteFailureState::Published => println!("preserve the published target; clean up only the session or staging resources"),
/// WriteFailureState::Indeterminate => println!("resolve publication status"),
/// }
/// ```
///
/// `Published` means the destination must be preserved; do not retry
/// publication as though it had failed. Cleanup applies only to resources still
/// owned by the writer, such as a session or staging data. Successful cleanup
/// does not roll back the published target.