chore(internal): codegen related update

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/ArrivalAndDepartureListParams.kt

@@ -22,10 +22,13 @@ constructor(
 
     fun stopId(): String = stopId
 
+    /** Include vehicles arriving or departing in the next n minutes. */
     fun minutesAfter(): Optional<Long> = Optional.ofNullable(minutesAfter)
 
+    /** Include vehicles having arrived or departed in the previous n minutes. */
     fun minutesBefore(): Optional<Long> = Optional.ofNullable(minutesBefore)
 
+    /** The specific time for querying the system status. */
     fun time(): Optional<OffsetDateTime> = Optional.ofNullable(time)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/ReportProblemWithStopRetrieveParams.kt

@@ -26,14 +26,19 @@ constructor(
 
     fun stopId(): String = stopId
 
+    /** A string code identifying the nature of the problem */
     fun code(): Optional<Code> = Optional.ofNullable(code)
 
+    /** Additional comment text supplied by the user describing the problem */
     fun userComment(): Optional<String> = Optional.ofNullable(userComment)
 
+    /** The reporting user’s current latitude */
     fun userLat(): Optional<Double> = Optional.ofNullable(userLat)
 
+    /** The reporting user’s location accuracy, in meters */
     fun userLocationAccuracy(): Optional<Double> = Optional.ofNullable(userLocationAccuracy)
 
+    /** The reporting user’s current longitude */
     fun userLon(): Optional<Double> = Optional.ofNullable(userLon)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/ReportProblemWithTripRetrieveParams.kt

@@ -31,24 +31,34 @@ constructor(
 
     fun tripId(): String = tripId
 
+    /** A string code identifying the nature of the problem */
     fun code(): Optional<Code> = Optional.ofNullable(code)
 
+    /** The service date of the trip */
     fun serviceDate(): Optional<Long> = Optional.ofNullable(serviceDate)
 
+    /** A stop ID indicating where the user is experiencing the problem */
     fun stopId(): Optional<String> = Optional.ofNullable(stopId)
 
+    /** Additional comment text supplied by the user describing the problem */
     fun userComment(): Optional<String> = Optional.ofNullable(userComment)
 
+    /** The reporting user’s current latitude */
     fun userLat(): Optional<Double> = Optional.ofNullable(userLat)
 
+    /** The reporting user’s location accuracy, in meters */
     fun userLocationAccuracy(): Optional<Double> = Optional.ofNullable(userLocationAccuracy)
 
+    /** The reporting user’s current longitude */
     fun userLon(): Optional<Double> = Optional.ofNullable(userLon)
 
+    /** Indicator if the user is on the transit vehicle experiencing the problem */
     fun userOnVehicle(): Optional<Boolean> = Optional.ofNullable(userOnVehicle)
 
+    /** The vehicle number, as reported by the user */
     fun userVehicleNumber(): Optional<String> = Optional.ofNullable(userVehicleNumber)
 
+    /** The vehicle actively serving the trip */
     fun vehicleId(): Optional<String> = Optional.ofNullable(vehicleId)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/ScheduleForRouteRetrieveParams.kt

@@ -19,6 +19,10 @@ constructor(
 
     fun routeId(): String = routeId
 
+    /**
+     * The date for which you want to request a schedule in the format YYYY-MM-DD (optional,
+     * defaults to current date)
+     */
     fun date(): Optional<LocalDate> = Optional.ofNullable(date)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/ScheduleForStopRetrieveParams.kt

@@ -19,6 +19,10 @@ constructor(
 
     fun stopId(): String = stopId
 
+    /**
+     * The date for which you want to request a schedule in the format YYYY-MM-DD (optional,
+     * defaults to the current date)
+     */
     fun date(): Optional<LocalDate> = Optional.ofNullable(date)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/SearchForRouteListParams.kt

@@ -16,8 +16,10 @@ constructor(
     private val additionalQueryParams: QueryParams,
 ) {
 
+    /** The string to search for. */
     fun input(): String = input
 
+    /** The max number of results to return. Defaults to 20. */
     fun maxCount(): Optional<Long> = Optional.ofNullable(maxCount)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/SearchForStopListParams.kt

@@ -16,8 +16,10 @@ constructor(
     private val additionalQueryParams: QueryParams,
 ) {
 
+    /** The string to search for. */
     fun input(): String = input
 
+    /** The max number of results to return. Defaults to 20. */
     fun maxCount(): Optional<Long> = Optional.ofNullable(maxCount)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/StopsForLocationListParams.kt

@@ -24,12 +24,16 @@ constructor(
 
     fun lon(): Double = lon
 
+    /** An alternative to radius to set the search bounding box (optional) */
     fun latSpan(): Optional<Double> = Optional.ofNullable(latSpan)
 
+    /** An alternative to radius to set the search bounding box (optional) */
     fun lonSpan(): Optional<Double> = Optional.ofNullable(lonSpan)
 
+    /** A search query string to filter the results */
     fun query(): Optional<String> = Optional.ofNullable(query)
 
+    /** The radius in meters to search within */
     fun radius(): Optional<Double> = Optional.ofNullable(radius)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/StopsForRouteListParams.kt

@@ -19,8 +19,10 @@ constructor(
 
     fun routeId(): String = routeId
 
+    /** Include polyline elements in the response (default true) */
     fun includePolylines(): Optional<Boolean> = Optional.ofNullable(includePolylines)
 
+    /** Specify service date (YYYY-MM-DD or epoch) (default today) */
     fun time(): Optional<String> = Optional.ofNullable(time)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/TripDetailRetrieveParams.kt

@@ -22,14 +22,21 @@ constructor(
 
     fun tripId(): String = tripId
 
+    /**
+     * Whether to include the full schedule element in the tripDetails section (defaults to true).
+     */
     fun includeSchedule(): Optional<Boolean> = Optional.ofNullable(includeSchedule)
 
+    /** Whether to include the full status element in the tripDetails section (defaults to true). */
     fun includeStatus(): Optional<Boolean> = Optional.ofNullable(includeStatus)
 
+    /** Whether to include the full trip element in the references section (defaults to true). */
     fun includeTrip(): Optional<Boolean> = Optional.ofNullable(includeTrip)
 
+    /** Service date for the trip as Unix time in milliseconds (optional). */
     fun serviceDate(): Optional<Long> = Optional.ofNullable(serviceDate)
 
+    /** Time parameter to query the system at a specific time (optional). */
     fun time(): Optional<Long> = Optional.ofNullable(time)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/TripForVehicleRetrieveParams.kt

@@ -21,12 +21,25 @@ constructor(
 
     fun vehicleId(): String = vehicleId
 
+    /**
+     * Determines whether full <schedule/> element is included in the <tripDetails/> section.
+     * Defaults to false.
+     */
     fun includeSchedule(): Optional<Boolean> = Optional.ofNullable(includeSchedule)
 
+    /**
+     * Determines whether the full <status/> element is included in the <tripDetails/> section.
+     * Defaults to true.
+     */
     fun includeStatus(): Optional<Boolean> = Optional.ofNullable(includeStatus)
 
+    /**
+     * Determines whether full <trip/> element is included in the <references/> section. Defaults to
+     * false.
+     */
     fun includeTrip(): Optional<Boolean> = Optional.ofNullable(includeTrip)
 
+    /** Time parameter to query the system at a specific time (optional). */
     fun time(): Optional<Long> = Optional.ofNullable(time)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/TripsForLocationListParams.kt

@@ -21,18 +21,25 @@ constructor(
     private val additionalQueryParams: QueryParams,
 ) {
 
+    /** The latitude coordinate of the search center */
     fun lat(): Double = lat
 
+    /** Latitude span of the search bounding box */
     fun latSpan(): Double = latSpan
 
+    /** The longitude coordinate of the search center */
     fun lon(): Double = lon
 
+    /** Longitude span of the search bounding box */
     fun lonSpan(): Double = lonSpan
 
+    /** Whether to include full schedule elements in the tripDetails section. Defaults to false. */
     fun includeSchedule(): Optional<Boolean> = Optional.ofNullable(includeSchedule)
 
+    /** Whether to include full trip elements in the references section. Defaults to false. */
     fun includeTrip(): Optional<Boolean> = Optional.ofNullable(includeTrip)
 
+    /** Specific time for the query. Defaults to the current time. */
     fun time(): Optional<Long> = Optional.ofNullable(time)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/TripsForRouteListParams.kt

@@ -20,10 +20,16 @@ constructor(
 
     fun routeId(): String = routeId
 
+    /** Determine whether full schedule elements are included. Defaults to false. */
     fun includeSchedule(): Optional<Boolean> = Optional.ofNullable(includeSchedule)
 
+    /**
+     * Determine whether full tripStatus elements with real-time information are included. Defaults
+     * to false.
+     */
     fun includeStatus(): Optional<Boolean> = Optional.ofNullable(includeStatus)
 
+    /** Query the system at a specific time. Useful for testing. */
     fun time(): Optional<Long> = Optional.ofNullable(time)
 
     fun _additionalHeaders(): Headers = additionalHeaders

onebusaway-sdk-java-core/src/main/kotlin/org/onebusaway/models/VehiclesForAgencyListParams.kt

@@ -18,6 +18,7 @@ constructor(
 
     fun agencyId(): String = agencyId
 
+    /** Specific time for querying the status (timestamp format) */
     fun time(): Optional<String> = Optional.ofNullable(time)
 
     fun _additionalHeaders(): Headers = additionalHeaders