qubit-redact 0.5.0

// =============================================================================
//    Copyright (c) 2026 Haixing Hu.
//
//    SPDX-License-Identifier: Apache-2.0
//
//    Licensed under the Apache License, Version 2.0.
// =============================================================================
// qubit-style: allow multiple-public-types
//! Structured HTTP body state retained between admission and rendering.

use serde_json::Value;

/// Structured body state retained between admission and rendering.
pub(super) enum AdmittedBody {
    /// The body is not one complete top-level JSON document.
    Other,
    /// One top-level JSON document admitted under the shared budgets.
    Json(
        /// Parsed tree retained so rendering does not parse the input again.
        Value,
    ),
    /// A body selected as JSON failed syntactic validation.
    InvalidJson,
    /// Non-empty NDJSON lines admitted under the shared budgets.
    Ndjson {
        /// Parsed values and empty records in source-line order.
        lines: Vec<Option<Value>>,
        /// Whether the complete source ended with a newline.
        trailing_newline: bool,
    },
    /// A body selected as NDJSON contained an invalid non-empty line.
    InvalidNdjson,
    /// A multipart body whose nested structured parts were admitted once.
    Multipart(AdmittedMultipart),
}

/// Parsed multipart bodies retained between admission and rendering.
pub(super) struct AdmittedMultipart {
    /// Structured values indexed by multipart segment position.
    pub(super) parts: Vec<Option<AdmittedMultipartBody>>,
}

/// One nested structured multipart body retained by admission.
pub(super) enum AdmittedMultipartBody {
    /// One complete JSON value.
    Json(Value),
    /// NDJSON records preserving empty lines and final newline state.
    Ndjson {
        /// Parsed source records in order.
        lines: Vec<Option<Value>>,
        /// Whether the source ended with a newline.
        trailing_newline: bool,
    },
}