soth-mitm 0.2.0

use super::close_codes::{CloseReasonCode, ParseFailureCode};
use super::event_emitters::{emit_connect_parse_failed, emit_stream_closed, unknown_context};
use super::event_emitters_protocol::emit_http3_passthrough_event;
use super::flow_connect_tunnel_support::{flow_action_label, parse_http3_passthrough_hint};
use super::flow_forward_proxy_http1::handle_forward_http1_proxy_request;
use super::flow_forward_proxy_http1_helpers::{
    is_forward_http1_request_candidate, is_self_listener_target,
};
use super::flow_intercept::intercept_http_connection;
use super::flow_policy_snapshot::{clear_flow_policy_snapshot, resolve_flow_policy_snapshot};
use super::http_body_relay::write_proxy_response;
use super::http_head_parser::read_connect_head;
use super::io_timeouts::{
    copy_bidirectional_with_websocket_idle_timeout, is_idle_watchdog_timeout,
    is_stream_stage_timeout, write_all_with_idle_timeout,
};
use super::route_planner_model::{FlowRoutePlanner, RouteBinding, RouteConnectIntent, RouteTarget};
use super::route_planner_transport::connect_via_route;
use super::RuntimeHandles;
use crate::engine::{parse_connect_request_head_with_mode, ConnectParseError, MitmEngine};
use crate::observe::{EventConsumer, FlowContext};
use crate::policy::{FlowAction, PolicyEngine};
use crate::protocol::ApplicationProtocol;
use crate::types::ProcessInfo;
use std::io;
use std::sync::Arc;
use tokio::net::TcpStream;

pub(crate) async fn handle_client<P, S>(
    runtime: RuntimeHandles<P, S>,
    downstream: TcpStream,
    client_addr: String,
    flow_id: crate::types::FlowId,
    process_info: Option<ProcessInfo>,
    max_connect_head_bytes: usize,
    max_http_head_bytes: usize,
    flow_guard: &mut crate::server::runtime_governor::FlowRuntimeGuard,
) -> io::Result<()>
where
    P: PolicyEngine + Send + Sync + 'static,
    S: EventConsumer + Send + Sync + 'static,
{
    let close_context = unknown_context(flow_id, client_addr.clone());
    let engine_instance_id = runtime.engine.instance_id();
    let flow_hooks = Arc::clone(&runtime.flow_hooks);
    let result = handle_client_inner(
        runtime,
        downstream,
        client_addr,
        flow_id,
        process_info,
        max_connect_head_bytes,
        max_http_head_bytes,
        flow_guard,
    )
    .await;
    clear_flow_policy_snapshot(engine_instance_id, flow_id);
    flow_hooks.on_stream_end(close_context).await;
    result
}

async fn handle_client_inner<P, S>(
    runtime: RuntimeHandles<P, S>,
    mut downstream: TcpStream,
    client_addr: String,
    flow_id: crate::types::FlowId,
    process_info: Option<ProcessInfo>,
    max_connect_head_bytes: usize,
    max_http_head_bytes: usize,
    flow_guard: &mut crate::server::runtime_governor::FlowRuntimeGuard,
) -> io::Result<()>
where
    P: PolicyEngine + Send + Sync + 'static,
    S: EventConsumer + Send + Sync + 'static,
{
    let engine = Arc::clone(&runtime.engine);
    let cert_store = Arc::clone(&runtime.cert_store);
    let runtime_governor = Arc::clone(&runtime.runtime_governor);
    let tls_diagnostics = Arc::clone(&runtime.tls_diagnostics);
    let tls_learning = Arc::clone(&runtime.tls_learning);
    let flow_hooks = Arc::clone(&runtime.flow_hooks);
    let upstream_tls_cache = Arc::clone(&runtime.upstream_tls_cache);
    let listener_addr = downstream.local_addr().ok();

    let mut input =
        match read_connect_head(&mut downstream, max_connect_head_bytes, &runtime_governor).await {
            Ok(parsed) => parsed,
            Err(error) => {
                let parse_code = match error.kind() {
                    io::ErrorKind::UnexpectedEof => ParseFailureCode::IncompleteHeaders,
                    io::ErrorKind::InvalidData => ParseFailureCode::HeaderTooLarge,
                    _ => ParseFailureCode::ReadError,
                };

                let context = unknown_context(flow_id, client_addr);

                emit_connect_parse_failed(
                    &engine,
                    context.clone(),
                    parse_code,
                    Some(error.to_string()),
                );
                emit_stream_closed(
                    &engine,
                    context,
                    CloseReasonCode::ConnectParseFailed,
                    Some(format!("{}: {error}", parse_code.as_str())),
                    None,
                    None,
                );

                if error.kind() != io::ErrorKind::UnexpectedEof {
                    let status = if parse_code == ParseFailureCode::HeaderTooLarge {
                        "431 Request Header Fields Too Large"
                    } else {
                        "400 Bad Request"
                    };
                    write_proxy_response(
                        &mut downstream,
                        status,
                        "invalid or incomplete CONNECT request",
                    )
                    .await?;
                }
                return Ok(());
            }
        };

    let (connect, header_len) =
        match parse_connect_request_head_with_mode(&input, engine.config.connect_parse_mode) {
            Ok(parsed) => parsed,
            Err(ConnectParseError::MethodNotConnect)
                if is_forward_http1_request_candidate(&input) =>
            {
                return handle_forward_http1_proxy_request(
                    engine,
                    runtime_governor,
                    flow_hooks,
                    downstream,
                    client_addr,
                    flow_id,
                    process_info.clone(),
                    input,
                    max_http_head_bytes,
                    listener_addr,
                    Some(flow_guard),
                )
                .await;
            }
            Err(parse_error) => {
                let context = unknown_context(flow_id, client_addr);
                emit_connect_parse_failed(
                    &engine,
                    context.clone(),
                    ParseFailureCode::Parser(parse_error),
                    None,
                );
                emit_stream_closed(
                    &engine,
                    context,
                    CloseReasonCode::ConnectParseFailed,
                    Some(parse_error.code().to_string()),
                    None,
                    None,
                );
                write_proxy_response(
                    &mut downstream,
                    "400 Bad Request",
                    "invalid CONNECT request",
                )
                .await?;
                return Ok(());
            }
        };

    let (listen_addr, listen_port) = listener_addr
        .map(|addr| (addr.ip().to_string(), addr.port()))
        .unwrap_or_else(|| (engine.config.listen_addr.clone(), engine.config.listen_port));

    if is_self_listener_target(
        &connect.server_host,
        connect.server_port,
        &listen_addr,
        listen_port,
    ) {
        let context = FlowContext {
            flow_id,
            client_addr,
            server_host: connect.server_host,
            server_port: connect.server_port,
            protocol: ApplicationProtocol::Tunnel,
        };
        write_proxy_response(
            &mut downstream,
            "508 Loop Detected",
            "proxy CONNECT target resolves to listener itself",
        )
        .await?;
        emit_stream_closed(
            &engine,
            context,
            CloseReasonCode::RoutePlannerFailed,
            Some(format!(
                "connect self-target loop detected: listener {listen_addr}:{listen_port}"
            )),
            None,
            None,
        );
        return Ok(());
    }

    let mut route_planner = FlowRoutePlanner::default();
    let route = match route_planner.bind_once(
        &engine.config,
        RouteTarget::new(connect.server_host.clone(), connect.server_port, None),
    ) {
        Ok(binding) => binding,
        Err(error) => {
            let context = FlowContext {
                flow_id,
                client_addr,
                server_host: connect.server_host,
                server_port: connect.server_port,
                protocol: ApplicationProtocol::Tunnel,
            };
            write_proxy_response(
                &mut downstream,
                "502 Bad Gateway",
                "route planner failed for CONNECT target",
            )
            .await?;
            emit_stream_closed(
                &engine,
                context,
                CloseReasonCode::RoutePlannerFailed,
                Some(error.to_string()),
                None,
                None,
            );
            return Ok(());
        }
    };

    let policy_snapshot = resolve_flow_policy_snapshot(
        &engine,
        flow_id,
        client_addr.clone(),
        route.target_host.clone(),
        route.target_port,
        route.policy_path.clone(),
        process_info.clone(),
    );

    let context = FlowContext {
        flow_id: policy_snapshot.flow_id,
        client_addr,
        server_host: route.target_host.clone(),
        server_port: route.target_port,
        protocol: ApplicationProtocol::Tunnel,
    };

    let http3_requested_by = if engine.config.http3_passthrough {
        parse_http3_passthrough_hint(&input[..header_len])
    } else {
        None
    };
    if let Some(requested_by) = http3_requested_by {
        if policy_snapshot.action != FlowAction::Block {
            emit_http3_passthrough_event(
                &engine,
                context.clone(),
                requested_by,
                flow_action_label(policy_snapshot.action),
            );
        }
    }
    let mut action = if http3_requested_by.is_some() && policy_snapshot.action != FlowAction::Block
    {
        FlowAction::Tunnel
    } else {
        policy_snapshot.action
    };
    if action == FlowAction::Intercept
        && !flow_hooks
            .should_intercept_tls(context.clone(), process_info.clone())
            .await
    {
        action = FlowAction::Tunnel;
    }

    match action {
        FlowAction::Block => {
            flow_guard.release_permit();
            write_proxy_response(&mut downstream, "403 Forbidden", &policy_snapshot.reason).await?;
            emit_stream_closed(
                &engine,
                context,
                CloseReasonCode::Blocked,
                Some(policy_snapshot.reason),
                None,
                None,
            );
            Ok(())
        }
        FlowAction::Tunnel => {
            // Release the intercept permit — tunnel connections are blind
            // byte-copy and don't use the detect/classify pipeline.
            flow_guard.release_permit();
            tunnel_connection(
                engine,
                context,
                route,
                &mut downstream,
                &mut input,
                header_len,
            )
            .await
        }
        FlowAction::Intercept => {
            intercept_http_connection(
                engine,
                cert_store,
                runtime_governor,
                tls_diagnostics,
                tls_learning,
                flow_hooks,
                upstream_tls_cache,
                context,
                process_info,
                route,
                policy_snapshot.override_state,
                downstream,
                max_http_head_bytes,
            )
            .await
        }
    }
}

async fn tunnel_connection<P, S>(
    engine: Arc<MitmEngine<P, S>>,
    context: FlowContext,
    route: RouteBinding,
    downstream: &mut TcpStream,
    input: &mut [u8],
    header_len: usize,
) -> io::Result<()>
where
    P: PolicyEngine + Send + Sync + 'static,
    S: EventConsumer + Send + Sync + 'static,
{
    let mut upstream = match connect_via_route(&route, RouteConnectIntent::TargetTunnel).await {
        Ok(stream) => stream,
        Err(error) => {
            let detail = format!(
                "upstream_connect_failed[{}]: {error}",
                route.route_mode_label()
            );
            write_proxy_response(downstream, "502 Bad Gateway", &detail).await?;
            emit_stream_closed(
                &engine,
                context,
                CloseReasonCode::UpstreamConnectFailed,
                Some(error.to_string()),
                None,
                None,
            );
            return Ok(());
        }
    };

    write_all_with_idle_timeout(
        downstream,
        b"HTTP/1.1 200 Connection Established\r\n\r\n",
        "connect_tunnel_established_write",
    )
    .await?;

    let buffered_client_data = &input[header_len..];
    if !buffered_client_data.is_empty() {
        write_all_with_idle_timeout(
            &mut upstream,
            buffered_client_data,
            "connect_tunnel_prefetch_write",
        )
        .await?;
    }

    match copy_bidirectional_with_websocket_idle_timeout(downstream, &mut upstream).await {
        Ok((from_client, from_server)) => {
            // Tunneled flows are blind TCP passthrough — no body inspection,
            // no buffering, no budget.  Always report clean EOF.
            emit_stream_closed(
                &engine,
                context,
                CloseReasonCode::RelayEof,
                None,
                Some(from_client),
                Some(from_server),
            );
            Ok(())
        }
        Err(error) => {
            let reason = if is_idle_watchdog_timeout(&error) {
                CloseReasonCode::IdleWatchdogTimeout
            } else if is_stream_stage_timeout(&error) {
                CloseReasonCode::StreamStageTimeout
            } else {
                CloseReasonCode::RelayError
            };
            emit_stream_closed(
                &engine,
                context,
                reason,
                Some(error.to_string()),
                None,
                None,
            );
            Err(error)
        }
    }
}

#[cfg(test)]
mod flow_connect_tunnel_tests {
    use super::parse_http3_passthrough_hint;

    #[test]
    fn detects_http3_passthrough_via_proxy_protocol_hint() {
        let head = b"CONNECT example.com:443 HTTP/1.1\r\nHost: example.com:443\r\nX-Proxy-Protocol: h3\r\n\r\n";
        assert_eq!(parse_http3_passthrough_hint(head), Some("x-proxy-protocol"));
    }

    #[test]
    fn detects_http3_passthrough_via_boolean_flag_hint() {
        let head = b"CONNECT example.com:443 HTTP/1.1\r\nHost: example.com:443\r\nX-HTTP3-Passthrough: yes\r\n\r\n";
        assert_eq!(
            parse_http3_passthrough_hint(head),
            Some("x-http3-passthrough")
        );
    }

    #[test]
    fn does_not_accept_vendor_specific_legacy_hint_headers() {
        let head = b"CONNECT example.com:443 HTTP/1.1\r\nHost: example.com:443\r\nX-Soth-Proxy-Protocol: h3\r\n\r\n";
        assert_eq!(parse_http3_passthrough_hint(head), None);
    }
}