fix(api): sync public contracts and preserve OAuth compatibility

Gemfile.lock

@@ -97,7 +97,7 @@ GEM
     protocol-websocket (0.21.2)
       protocol-http (~> 0.2)
     racc (1.8.1)
-    rack (3.2.7)
+    rack (3.2.8)
     rainbow (3.1.1)
     rake (13.4.2)
     rb-fsevent (0.11.2)

README.md

@@ -270,8 +270,11 @@ end
 ```
 
 The method returns a frozen array of immutable `Volcano::LinkedOAuthProvider`
-values. It raises `Volcano::Error::SessionChangedError` if the active session
-changes while the request is in flight.
+values containing `provider`, `linked_at`, and `updated_at`; both timestamps are
+`Time` values. It accepts older responses with those three fields and current
+responses that also include provider identity fields. Malformed provider names
+or timestamps raise `TypeError`. It raises `Volcano::Error::SessionChangedError`
+if the active session changes while the request is in flight.
 
 ### Link an OAuth provider
 
@@ -1036,9 +1039,9 @@ durable executions rather than writing them. See
 ## Generated boundary
 
 The internal REST transport is generated from `openapi/openapi.yaml`, which
-matches the public bundle from [Hosting #991](https://github.com/Kong/volcano-hosting/pull/991)
-at commit `ef03f689e`.
-Its SHA-256 is `076d97809c95f50567d8b100f4188c1fe2b74e73a388e335c79850e66edfc0e4`.
+matches the public bundle from [Hosting #3213](https://github.com/Kong/volcano-hosting/pull/3213)
+at commit `134dfb1196d944b20d6fb9f0ddf4e9984af6287d`.
+Its SHA-256 is `8bc109d5034348f37d1ab4d5a968db51b376c85ebf8e6386ea49c4ddcc6b0f23`.
 Generation uses `@openapitools/openapi-generator-cli` 2.41.0 with OpenAPI
 Generator 7.17.0. Node is used only to regenerate the committed client and is
 not a gem runtime dependency.

Steepfile.transport

@@ -23,6 +23,7 @@ target :client_transport do
   check 'lib/volcano/generated_transport_upload_session_api.rb'
   check 'lib/volcano/generated_transport_upload_sessions.rb'
   library 'cgi'
+  library 'date'
   library 'json'
   library 'securerandom'
   library 'tempfile'

lib/volcano/generated/lib/volcano-generated/api/auth_configuration_api.rb

@@ -620,7 +620,7 @@ def get_auth_page_appearance_with_http_info(id, opts = {})
     # Get default email template by type
     # @param type [String] 
     # @param [Hash] opts the optional parameters
-    # @return [EmailTemplate]
+    # @return [DefaultEmailTemplate]
     def get_default_email_template(type, opts = {})
       data, _status_code, _headers = get_default_email_template_with_http_info(type, opts)
       data
@@ -629,7 +629,7 @@ def get_default_email_template(type, opts = {})
     # Get default email template by type
     # @param type [String] 
     # @param [Hash] opts the optional parameters
-    # @return [Array<(EmailTemplate, Integer, Hash)>] EmailTemplate data, response status code and response headers
+    # @return [Array<(DefaultEmailTemplate, Integer, Hash)>] DefaultEmailTemplate data, response status code and response headers
     def get_default_email_template_with_http_info(type, opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AuthConfigurationApi.get_default_email_template ...'
@@ -661,7 +661,7 @@ def get_default_email_template_with_http_info(type, opts = {})
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'EmailTemplate'
+      return_type = opts[:debug_return_type] || 'DefaultEmailTemplate'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || []
@@ -686,7 +686,7 @@ def get_default_email_template_with_http_info(type, opts = {})
     # Get default email templates
     # Returns the default email templates used when no custom template is configured.
     # @param [Hash] opts the optional parameters
-    # @return [ListEmailTemplates200Response]
+    # @return [GetDefaultEmailTemplates200Response]
     def get_default_email_templates(opts = {})
       data, _status_code, _headers = get_default_email_templates_with_http_info(opts)
       data
@@ -695,7 +695,7 @@ def get_default_email_templates(opts = {})
     # Get default email templates
     # Returns the default email templates used when no custom template is configured.
     # @param [Hash] opts the optional parameters
-    # @return [Array<(ListEmailTemplates200Response, Integer, Hash)>] ListEmailTemplates200Response data, response status code and response headers
+    # @return [Array<(GetDefaultEmailTemplates200Response, Integer, Hash)>] GetDefaultEmailTemplates200Response data, response status code and response headers
     def get_default_email_templates_with_http_info(opts = {})
       if @api_client.config.debugging
         @api_client.config.logger.debug 'Calling API: AuthConfigurationApi.get_default_email_templates ...'
@@ -718,7 +718,7 @@ def get_default_email_templates_with_http_info(opts = {})
       post_body = opts[:debug_body]
 
       # return_type
-      return_type = opts[:debug_return_type] || 'ListEmailTemplates200Response'
+      return_type = opts[:debug_return_type] || 'GetDefaultEmailTemplates200Response'
 
       # auth_names
       auth_names = opts[:debug_auth_names] || []
@@ -1337,7 +1337,7 @@ def render_managed_auth_page_with_http_info(id, page_type, opts = {})
     end
 
     # Send a test email using the project's saved SMTP config
-    # Sends a diagnostic email to `to_email` using the project's persisted `auth_config` SMTP credentials. If `html_body` or `text_body` is supplied, the override path is taken: those values (plus optional `subject`) are rendered through html/text templates against the project's `Data` and used as the body — used by the template editor's \"Send Test\" affordance to preview an unsaved template. With both bodies omitted, a hardcoded diagnostic message is sent and any `subject` field is ignored. Sending `subject` alone (no bodies) is rejected with 400 to avoid a silently-dropped subject or a blank message. Also rejects with 400 if `email_enabled=false`, `smtp_host` is empty, or the saved `smtp_password` can't be read and must be set again. 
+    # Sends a diagnostic email to `to_email` using the project's persisted `auth_config` SMTP credentials. If `html_body` or `text_body` is supplied, the override path is taken: those values (plus optional `subject`) are rendered through html/text templates against the project's `Data` and used as the body — used by the template editor's \"Send Test\" affordance to preview an unsaved template. With both bodies omitted, a hardcoded diagnostic message is sent and any `subject` field is ignored. Sending `subject` alone (no bodies) is rejected with 400 to avoid a silently-dropped subject or a blank message. Also rejects with 400 if `email_enabled=false`, `smtp_host` is empty, or the saved `smtp_password` can't be read and must be set again. Sender values with interior line breaks return 400 before SMTP delivery. Rendered override subjects containing a line break have outer whitespace trimmed; any remaining interior line break returns 400 before delivery. 
     # @param id [String] Project ID
     # @param test_email_request [TestEmailRequest] 
     # @param [Hash] opts the optional parameters
@@ -1348,7 +1348,7 @@ def test_email_config(id, test_email_request, opts = {})
     end
 
     # Send a test email using the project&#39;s saved SMTP config
-    # Sends a diagnostic email to &#x60;to_email&#x60; using the project&#39;s persisted &#x60;auth_config&#x60; SMTP credentials. If &#x60;html_body&#x60; or &#x60;text_body&#x60; is supplied, the override path is taken: those values (plus optional &#x60;subject&#x60;) are rendered through html/text templates against the project&#39;s &#x60;Data&#x60; and used as the body — used by the template editor&#39;s \&quot;Send Test\&quot; affordance to preview an unsaved template. With both bodies omitted, a hardcoded diagnostic message is sent and any &#x60;subject&#x60; field is ignored. Sending &#x60;subject&#x60; alone (no bodies) is rejected with 400 to avoid a silently-dropped subject or a blank message. Also rejects with 400 if &#x60;email_enabled&#x3D;false&#x60;, &#x60;smtp_host&#x60; is empty, or the saved &#x60;smtp_password&#x60; can&#39;t be read and must be set again. 
+    # Sends a diagnostic email to &#x60;to_email&#x60; using the project&#39;s persisted &#x60;auth_config&#x60; SMTP credentials. If &#x60;html_body&#x60; or &#x60;text_body&#x60; is supplied, the override path is taken: those values (plus optional &#x60;subject&#x60;) are rendered through html/text templates against the project&#39;s &#x60;Data&#x60; and used as the body — used by the template editor&#39;s \&quot;Send Test\&quot; affordance to preview an unsaved template. With both bodies omitted, a hardcoded diagnostic message is sent and any &#x60;subject&#x60; field is ignored. Sending &#x60;subject&#x60; alone (no bodies) is rejected with 400 to avoid a silently-dropped subject or a blank message. Also rejects with 400 if &#x60;email_enabled&#x3D;false&#x60;, &#x60;smtp_host&#x60; is empty, or the saved &#x60;smtp_password&#x60; can&#39;t be read and must be set again. Sender values with interior line breaks return 400 before SMTP delivery. Rendered override subjects containing a line break have outer whitespace trimmed; any remaining interior line break returns 400 before delivery. 
     # @param id [String] Project ID
     # @param test_email_request [TestEmailRequest] 
     # @param [Hash] opts the optional parameters