@spec format_transport_message(String.t(), map()) :: map()

Creates a transport message in the expected format.

Formats messages according to the transport protocol specifications for use in testing scenarios.

@spec mock_connection(
  atom(),
  keyword()
) :: %{transport: atom(), config: map(), pid: pid() | nil}

Simulates a transport connection for testing.

This function creates a mock connection that can be used in tests to verify transport behavior without external dependencies.

@spec mock_http_headers(keyword()) :: map()

Creates transport headers for HTTP testing.

Generates appropriate headers for different HTTP test scenarios, including authentication headers and content type headers.

@spec mock_transport_config(
  atom(),
  keyword()
) :: map()

Creates a mock transport configuration for testing.

Parameters

• transport_type - The type of transport (:http, :stdio, :beam, :test)
• opts - Additional options for the transport

Returns

A transport configuration map suitable for testing.

@spec simulate_transport_error(atom()) :: {:error, term()}

Simulates transport errors for testing error handling.

Creates various error scenarios that can occur during transport operations to test error handling and recovery mechanisms.

@spec start_mock_transport(
  atom(),
  keyword()
) :: {:ok, pid()} | {:error, term()}

Creates a mock transport process for testing.

This creates a GenServer process that simulates transport behavior for testing purposes without requiring actual network connections.

@spec validate_transport_config(map()) :: :ok | {:error, String.t()}

Validates transport configuration for testing.

Ensures that transport configurations are valid and contain required fields for testing scenarios.