chore(internal): codegen related update (#277)

Author: stainless-app[bot]

buildSrc/src/main/kotlin/onebusaway-sdk.kotlin.gradle.kts

@@ -22,11 +22,12 @@ configure<SpotlessExtension> {
 
 tasks.withType<KotlinCompile>().configureEach {
     compilerOptions {
+        allWarningsAsErrors = true
         freeCompilerArgs = listOf(
-          "-Xjvm-default=all",
-          "-Xjdk-release=1.8",
-          // Suppress deprecation warnings because we may still reference and test deprecated members.
-          "-Xsuppress-warning=DEPRECATION"
+            "-Xjvm-default=all",
+            "-Xjdk-release=1.8",
+            // Suppress deprecation warnings because we may still reference and test deprecated members.
+            "-Xsuppress-warning=DEPRECATION"
         )
         jvmTarget.set(JvmTarget.JVM_1_8)
     }

onebusaway-sdk-kotlin-core/src/main/kotlin/org/onebusaway/services/async/AgenciesWithCoverageServiceAsync.kt

@@ -24,10 +24,7 @@ interface AgenciesWithCoverageServiceAsync {
         requestOptions: RequestOptions = RequestOptions.none(),
     ): AgenciesWithCoverageListResponse
 
-    /**
-     * Returns a list of all transit agencies currently supported by OneBusAway along with the
-     * center of their coverage area.
-     */
+    /** @see [list] */
     suspend fun list(requestOptions: RequestOptions): AgenciesWithCoverageListResponse =
         list(AgenciesWithCoverageListParams.none(), requestOptions)
 
@@ -47,10 +44,7 @@ interface AgenciesWithCoverageServiceAsync {
             requestOptions: RequestOptions = RequestOptions.none(),
         ): HttpResponseFor<AgenciesWithCoverageListResponse>
 
-        /**
-         * Returns a raw HTTP response for `get /api/where/agencies-with-coverage.json`, but is
-         * otherwise the same as [AgenciesWithCoverageServiceAsync.list].
-         */
+        /** @see [list] */
         @MustBeClosed
         suspend fun list(
             requestOptions: RequestOptions

onebusaway-sdk-kotlin-core/src/main/kotlin/org/onebusaway/services/async/ConfigServiceAsync.kt

@@ -21,7 +21,7 @@ interface ConfigServiceAsync {
         requestOptions: RequestOptions = RequestOptions.none(),
     ): ConfigRetrieveResponse
 
-    /** config */
+    /** @see [retrieve] */
     suspend fun retrieve(requestOptions: RequestOptions): ConfigRetrieveResponse =
         retrieve(ConfigRetrieveParams.none(), requestOptions)
 
@@ -40,10 +40,7 @@ interface ConfigServiceAsync {
             requestOptions: RequestOptions = RequestOptions.none(),
         ): HttpResponseFor<ConfigRetrieveResponse>
 
-        /**
-         * Returns a raw HTTP response for `get /api/where/config.json`, but is otherwise the same
-         * as [ConfigServiceAsync.retrieve].
-         */
+        /** @see [retrieve] */
         @MustBeClosed
         suspend fun retrieve(
             requestOptions: RequestOptions

onebusaway-sdk-kotlin-core/src/main/kotlin/org/onebusaway/services/async/CurrentTimeServiceAsync.kt

@@ -21,7 +21,7 @@ interface CurrentTimeServiceAsync {
         requestOptions: RequestOptions = RequestOptions.none(),
     ): CurrentTimeRetrieveResponse
 
-    /** current-time */
+    /** @see [retrieve] */
     suspend fun retrieve(requestOptions: RequestOptions): CurrentTimeRetrieveResponse =
         retrieve(CurrentTimeRetrieveParams.none(), requestOptions)
 
@@ -41,10 +41,7 @@ interface CurrentTimeServiceAsync {
             requestOptions: RequestOptions = RequestOptions.none(),
         ): HttpResponseFor<CurrentTimeRetrieveResponse>
 
-        /**
-         * Returns a raw HTTP response for `get /api/where/current-time.json`, but is otherwise the
-         * same as [CurrentTimeServiceAsync.retrieve].
-         */
+        /** @see [retrieve] */
         @MustBeClosed
         suspend fun retrieve(
             requestOptions: RequestOptions

onebusaway-sdk-kotlin-core/src/main/kotlin/org/onebusaway/services/blocking/AgenciesWithCoverageService.kt

@@ -24,10 +24,7 @@ interface AgenciesWithCoverageService {
         requestOptions: RequestOptions = RequestOptions.none(),
     ): AgenciesWithCoverageListResponse
 
-    /**
-     * Returns a list of all transit agencies currently supported by OneBusAway along with the
-     * center of their coverage area.
-     */
+    /** @see [list] */
     fun list(requestOptions: RequestOptions): AgenciesWithCoverageListResponse =
         list(AgenciesWithCoverageListParams.none(), requestOptions)
 
@@ -47,10 +44,7 @@ interface AgenciesWithCoverageService {
             requestOptions: RequestOptions = RequestOptions.none(),
         ): HttpResponseFor<AgenciesWithCoverageListResponse>
 
-        /**
-         * Returns a raw HTTP response for `get /api/where/agencies-with-coverage.json`, but is
-         * otherwise the same as [AgenciesWithCoverageService.list].
-         */
+        /** @see [list] */
         @MustBeClosed
         fun list(
             requestOptions: RequestOptions

onebusaway-sdk-kotlin-core/src/main/kotlin/org/onebusaway/services/blocking/ConfigService.kt

@@ -21,7 +21,7 @@ interface ConfigService {
         requestOptions: RequestOptions = RequestOptions.none(),
     ): ConfigRetrieveResponse
 
-    /** config */
+    /** @see [retrieve] */
     fun retrieve(requestOptions: RequestOptions): ConfigRetrieveResponse =
         retrieve(ConfigRetrieveParams.none(), requestOptions)
 
@@ -38,10 +38,7 @@ interface ConfigService {
             requestOptions: RequestOptions = RequestOptions.none(),
         ): HttpResponseFor<ConfigRetrieveResponse>
 
-        /**
-         * Returns a raw HTTP response for `get /api/where/config.json`, but is otherwise the same
-         * as [ConfigService.retrieve].
-         */
+        /** @see [retrieve] */
         @MustBeClosed
         fun retrieve(requestOptions: RequestOptions): HttpResponseFor<ConfigRetrieveResponse> =
             retrieve(ConfigRetrieveParams.none(), requestOptions)

onebusaway-sdk-kotlin-core/src/main/kotlin/org/onebusaway/services/blocking/CurrentTimeService.kt

@@ -21,7 +21,7 @@ interface CurrentTimeService {
         requestOptions: RequestOptions = RequestOptions.none(),
     ): CurrentTimeRetrieveResponse
 
-    /** current-time */
+    /** @see [retrieve] */
     fun retrieve(requestOptions: RequestOptions): CurrentTimeRetrieveResponse =
         retrieve(CurrentTimeRetrieveParams.none(), requestOptions)
 
@@ -40,10 +40,7 @@ interface CurrentTimeService {
             requestOptions: RequestOptions = RequestOptions.none(),
         ): HttpResponseFor<CurrentTimeRetrieveResponse>
 
-        /**
-         * Returns a raw HTTP response for `get /api/where/current-time.json`, but is otherwise the
-         * same as [CurrentTimeService.retrieve].
-         */
+        /** @see [retrieve] */
         @MustBeClosed
         fun retrieve(requestOptions: RequestOptions): HttpResponseFor<CurrentTimeRetrieveResponse> =
             retrieve(CurrentTimeRetrieveParams.none(), requestOptions)