Added support for overriding various fields of outgoing requests

[mrashed-dev]

Description

This PR adds support for adding a new RequestOverride object which can be built with fields that can override:

• API URI
• API Key
• Timeout
• and, adding additional headers

for outgoing requests.

Usage

For all methods that call the Nylas API, there is now an additional overrides: RequestOverrides? field that takes in the built object and will override the specific outgoing call with whatever non-null values are present. This can also be used to add additional headers to outgoing calls. Here's an example:

package com.nylas

import com.nylas.models.RequestOverrides

object Main {
  @Throws(Exception::class)
  @JvmStatic
  fun main(args: Array<String>) {
    val nylas = NylasClient("API_KEY")
    
    val override = RequestOverrides(
      apiKey = "SECONDARY_API_KEY",
      apiUri = "https://random.api.nylas.com",
      timeout = 360,
      headers = mapOf("X-Header" to "value"),
    )
    
    val calendars = nylas.calendars().list("[email protected]", overrides = override)
  }
}

License

I confirm that this contribution is made under the terms of the MIT license and that I have the authority necessary to make this contribution on behalf of its copyright owner.

[codecov-commenter]

Codecov Report

Attention: Patch coverage is 94.49541% with 12 lines in your changes are missing coverage. Please review.

Project coverage is 80.46%. Comparing base (2a3eef8) to head (a4c2536).

Files	Patch %	Lines
src/main/kotlin/com/nylas/NylasClient.kt	68.42%	8 Missing and 4 partials ⚠️

Additional details and impacted files

@@             Coverage Diff              @@
##               main     #224      +/-   ##
============================================
+ Coverage     79.64%   80.46%   +0.81%     
- Complexity      209      281      +72     
============================================
  Files            29       29              
  Lines           732      824      +92     
  Branches         75       79       +4     
============================================
+ Hits            583      663      +80     
- Misses          111      119       +8     
- Partials         38       42       +4     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[atejada]

Looks good 👍