comments for better readability

Author: googsvg

src/main/kotlin/com/nylas/models/NylasApiError.kt

@@ -41,6 +41,17 @@ data class NylasApiError(
   override var headers: Map<String, List<String>>? = null,
 ) : AbstractNylasApiError(message, statusCode, requestId, headers) {
 
+  /**
+   * Formats the error as a human-readable string.
+   *
+   * Example output:
+   * ```
+   * NylasApiError: Bad Request (HTTP 400)
+   * Validation errors:
+   *   - when.end_time: must be after start_time
+   * Request ID: abc-123
+   * ```
+   */
   override fun toString(): String {
     val sb = StringBuilder()
     sb.append("NylasApiError: $message")

src/main/kotlin/com/nylas/models/UpdateEventRequest.kt

@@ -281,6 +281,7 @@ data class UpdateEventRequest(
          */
         fun build(): Timespan {
           // Validate that if both times are set, endTime must be after startTime
+          // Local variables for smart-cast null safety
           val start = startTime
           val end = endTime
           if (start != null && end != null) {