smplkit 3.0.2 → 3.0.4

data/lib/smplkit/_generated/app/lib/smplkit_app_client/models/environment_usage_response.rb

@@ -0,0 +1,165 @@
+=begin
+#smplkit API
+
+#API for the smplkit platform.
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'date'
+require 'time'
+
+module SmplkitGeneratedClient::App
+  # JSON:API single-resource response envelope for environment-usage counts.
+  class EnvironmentUsageResponse < ApiModelBase
+    attr_accessor :data
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        :'data' => :'data'
+      }
+    end
+
+    # Returns attribute mapping this model knows about
+    def self.acceptable_attribute_map
+      attribute_map
+    end
+
+    # Returns all the JSON keys this model knows about
+    def self.acceptable_attributes
+      acceptable_attribute_map.values
+    end
+
+    # Attribute type mapping.
+    def self.openapi_types
+      {
+        :'data' => :'EnvironmentUsageResource'
+      }
+    end
+
+    # List of attributes with nullable: true
+    def self.openapi_nullable
+      Set.new([
+      ])
+    end
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      if (!attributes.is_a?(Hash))
+        fail ArgumentError, "The input argument (attributes) must be a hash in `SmplkitGeneratedClient::App::EnvironmentUsageResponse` initialize method"
+      end
+
+      # check to see if the attribute exists and convert string to symbol for hash key
+      acceptable_attribute_map = self.class.acceptable_attribute_map
+      attributes = attributes.each_with_object({}) { |(k, v), h|
+        if (!acceptable_attribute_map.key?(k.to_sym))
+          fail ArgumentError, "`#{k}` is not a valid attribute in `SmplkitGeneratedClient::App::EnvironmentUsageResponse`. Please check the name to make sure it's valid. List of attributes: " + acceptable_attribute_map.keys.inspect
+        end
+        h[k.to_sym] = v
+      }
+
+      if attributes.key?(:'data')
+        self.data = attributes[:'data']
+      else
+        self.data = nil
+      end
+    end
+
+    # Show invalid properties with the reasons. Usually used together with valid?
+    # @return Array for valid properties with the reasons
+    def list_invalid_properties
+      warn '[DEPRECATED] the `list_invalid_properties` method is obsolete'
+      invalid_properties = Array.new
+      if @data.nil?
+        invalid_properties.push('invalid value for "data", data cannot be nil.')
+      end
+
+      invalid_properties
+    end
+
+    # Check to see if the all the properties in the model are valid
+    # @return true if the model is valid
+    def valid?
+      warn '[DEPRECATED] the `valid?` method is obsolete'
+      return false if @data.nil?
+      true
+    end
+
+    # Custom attribute writer method with validation
+    # @param [Object] data Value to be assigned
+    def data=(data)
+      if data.nil?
+        fail ArgumentError, 'data cannot be nil'
+      end
+
+      @data = data
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] Object to be compared
+    def ==(o)
+      return true if self.equal?(o)
+      self.class == o.class &&
+          data == o.data
+    end
+
+    # @see the `==` method
+    # @param [Object] Object to be compared
+    def eql?(o)
+      self == o
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Integer] Hash code
+    def hash
+      [data].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = self.send(attr)
+        if value.nil?
+          is_nullable = self.class.openapi_nullable.include?(attr)
+          next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
+        end
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+  end
+
+end

data/lib/smplkit/_generated/app/lib/smplkit_app_client.rb

@@ -57,6 +57,9 @@ require 'smplkit_app_client/models/environment_list_response'
 require 'smplkit_app_client/models/environment_request'
 require 'smplkit_app_client/models/environment_resource'
 require 'smplkit_app_client/models/environment_response'
+require 'smplkit_app_client/models/environment_usage'
+require 'smplkit_app_client/models/environment_usage_resource'
+require 'smplkit_app_client/models/environment_usage_response'
 require 'smplkit_app_client/models/error'
 require 'smplkit_app_client/models/error_response'
 require 'smplkit_app_client/models/invitation'

data/lib/smplkit/_generated/app/spec/api/environments_api_spec.rb

@@ -46,9 +46,10 @@ describe 'EnvironmentsApi' do
 
   # unit tests for delete_environment
   # Delete Environment
-  # Delete an environment by id.
+  # Delete an environment by id. When `cascade=true` is set, also remove every per-environment reference held by flags, configs, and loggers in the corresponding services before deleting the environment row. The default `cascade=false` deletes only the environment row, leaving downstream references in place.
   # @param id 
   # @param [Hash] opts the optional parameters
+  # @option opts [Boolean] :cascade When `true`, remove every flag rule, env-level flag default, config override, and logger override scoped to this environment before deleting the environment row.
   # @return [nil]
   describe 'delete_environment test' do
     it 'should work' do
@@ -68,6 +69,18 @@ describe 'EnvironmentsApi' do
     end
   end
 
+  # unit tests for get_environment_usage
+  # Report Environment Usage
+  # Report how many flag rules, env-level flag defaults, config overrides, and logger overrides reference this environment. Used by the console's delete dialog so the user can see what would survive a non-cascading delete.
+  # @param id 
+  # @param [Hash] opts the optional parameters
+  # @return [EnvironmentUsageResponse]
+  describe 'get_environment_usage test' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   # unit tests for list_environments
   # List Environments
   # List all environments for the authenticated account.

data/lib/smplkit/_generated/app/spec/models/environment_usage_resource_spec.rb

@@ -0,0 +1,52 @@
+=begin
+#smplkit API
+
+#API for the smplkit platform.
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for SmplkitGeneratedClient::App::EnvironmentUsageResource
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe SmplkitGeneratedClient::App::EnvironmentUsageResource do
+  #let(:instance) { SmplkitGeneratedClient::App::EnvironmentUsageResource.new }
+
+  describe 'test an instance of EnvironmentUsageResource' do
+    it 'should create an instance of EnvironmentUsageResource' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(SmplkitGeneratedClient::App::EnvironmentUsageResource)
+    end
+  end
+
+  describe 'test attribute "id"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "type"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+      # validator = Petstore::EnumTest::EnumAttributeValidator.new('String', ["environment_usage"])
+      # validator.allowable_values.each do |value|
+      #   expect { instance.type = value }.not_to raise_error
+      # end
+    end
+  end
+
+  describe 'test attribute "attributes"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/lib/smplkit/_generated/app/spec/models/environment_usage_response_spec.rb

@@ -0,0 +1,36 @@
+=begin
+#smplkit API
+
+#API for the smplkit platform.
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for SmplkitGeneratedClient::App::EnvironmentUsageResponse
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe SmplkitGeneratedClient::App::EnvironmentUsageResponse do
+  #let(:instance) { SmplkitGeneratedClient::App::EnvironmentUsageResponse.new }
+
+  describe 'test an instance of EnvironmentUsageResponse' do
+    it 'should create an instance of EnvironmentUsageResponse' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(SmplkitGeneratedClient::App::EnvironmentUsageResponse)
+    end
+  end
+
+  describe 'test attribute "data"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/lib/smplkit/_generated/app/spec/models/environment_usage_spec.rb

@@ -0,0 +1,54 @@
+=begin
+#smplkit API
+
+#API for the smplkit platform.
+
+The version of the OpenAPI document: 0.1.0
+
+Generated by: https://openapi-generator.tech
+Generator version: 7.22.0
+
+=end
+
+require 'spec_helper'
+require 'json'
+require 'date'
+
+# Unit tests for SmplkitGeneratedClient::App::EnvironmentUsage
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe SmplkitGeneratedClient::App::EnvironmentUsage do
+  #let(:instance) { SmplkitGeneratedClient::App::EnvironmentUsage.new }
+
+  describe 'test an instance of EnvironmentUsage' do
+    it 'should create an instance of EnvironmentUsage' do
+      # uncomment below to test the instance creation
+      #expect(instance).to be_instance_of(SmplkitGeneratedClient::App::EnvironmentUsage)
+    end
+  end
+
+  describe 'test attribute "flag_rules"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "flag_env_defaults"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "config_overrides"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+  describe 'test attribute "logger_overrides"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
+end

data/lib/smplkit/_generated/audit/lib/smplkit_audit_client/api/actions_api.rb

@@ -20,11 +20,12 @@ module SmplkitGeneratedClient::Audit
       @api_client = api_client
     end
     # List Actions
-    # List the distinct `action` slugs recorded for this account.  Without `filter[resource_type]`, returns one row per distinct action. With `filter[resource_type]`, returns the actions recorded for that specific resource type.
+    # List the distinct `action` slugs recorded for this account.  Default sort is `key` ascending; pass `sort=-key` for descending. Without `filter[resource_type]`, returns one row per distinct action. With `filter[resource_type]`, returns the actions recorded for that specific resource type.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_resource_type 
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `key`, `-key`. (default to 'key')
     # @return [ActionListResponse]
     def list_actions(opts = {})
       data, _status_code, _headers = list_actions_with_http_info(opts)
@@ -32,11 +33,12 @@ module SmplkitGeneratedClient::Audit
     end
 
     # List Actions
-    # List the distinct `action` slugs recorded for this account.  Without `filter[resource_type]`, returns one row per distinct action. With `filter[resource_type]`, returns the actions recorded for that specific resource type.
+    # List the distinct `action` slugs recorded for this account.  Default sort is `key` ascending; pass `sort=-key` for descending. Without `filter[resource_type]`, returns one row per distinct action. With `filter[resource_type]`, returns the actions recorded for that specific resource type.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_resource_type 
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `key`, `-key`. (default to 'key')
     # @return [Array<(ActionListResponse, Integer, Hash)>] ActionListResponse data, response status code and response headers
     def list_actions_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -46,6 +48,10 @@ module SmplkitGeneratedClient::Audit
         fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling ActionsApi.list_actions, must be greater than or equal to 1.'
       end
 
+      allowable_values = ["key", "-key"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/v1/actions'
 
@@ -54,6 +60,7 @@ module SmplkitGeneratedClient::Audit
       query_params[:'filter[resource_type]'] = opts[:'filter_resource_type'] if !opts[:'filter_resource_type'].nil?
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
       query_params[:'page[after]'] = opts[:'page_after'] if !opts[:'page_after'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

data/lib/smplkit/_generated/audit/lib/smplkit_audit_client/api/events_api.rb

@@ -83,7 +83,7 @@ module SmplkitGeneratedClient::Audit
     end
 
     # List Events
-    # List audit events for this account.  Default sort is newest first. Filters are exact-match except `filter[occurred_at]`, which uses interval notation (e.g. `[2026-01-01T00:00:00Z,2026-01-31T00:00:00Z)`), and `filter[search]`, which is a case-insensitive substring match against `resource_id` or `description`.  To bound the rows scanned per request, the endpoint requires either:  - `filter[resource_id]` (which must be accompanied by   `filter[resource_type]`), or - `filter[occurred_at]` with a span no greater than 30 days.  `page[size]` defaults to 50 and must not exceed 1000.
+    # List audit events for this account.  Default sort is `-occurred_at` (newest occurrence first). Sort by `occurred_at` or `created_at`, ascending or descending — keep the same `sort` value across paginated requests so the cursor stays consistent. Filters are exact-match except `filter[occurred_at]`, which uses interval notation (e.g. `[2026-01-01T00:00:00Z,2026-01-31T00:00:00Z)`), and `filter[search]`, which is a case-insensitive substring match against `resource_id` or `description`.  To bound the rows scanned per request, the endpoint requires either:  - `filter[resource_id]` (which must be accompanied by   `filter[resource_type]`), or - `filter[occurred_at]` with a span no greater than 30 days.  `page[size]` defaults to 50 and must not exceed 1000.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_occurred_at 
     # @option opts [String] :filter_actor_type 
@@ -94,6 +94,7 @@ module SmplkitGeneratedClient::Audit
     # @option opts [String] :filter_search Case-insensitive substring match against `resource_id` or `description`. Use `filter[resource_id]` for an exact match on `resource_id`.
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-occurred_at`. Allowed values: `created_at`, `-created_at`, `occurred_at`, `-occurred_at`. (default to '-occurred_at')
     # @return [EventListResponse]
     def list_events(opts = {})
       data, _status_code, _headers = list_events_with_http_info(opts)
@@ -101,7 +102,7 @@ module SmplkitGeneratedClient::Audit
     end
 
     # List Events
-    # List audit events for this account.  Default sort is newest first. Filters are exact-match except `filter[occurred_at]`, which uses interval notation (e.g. `[2026-01-01T00:00:00Z,2026-01-31T00:00:00Z)`), and `filter[search]`, which is a case-insensitive substring match against `resource_id` or `description`.  To bound the rows scanned per request, the endpoint requires either:  - `filter[resource_id]` (which must be accompanied by   `filter[resource_type]`), or - `filter[occurred_at]` with a span no greater than 30 days.  `page[size]` defaults to 50 and must not exceed 1000.
+    # List audit events for this account.  Default sort is `-occurred_at` (newest occurrence first). Sort by `occurred_at` or `created_at`, ascending or descending — keep the same `sort` value across paginated requests so the cursor stays consistent. Filters are exact-match except `filter[occurred_at]`, which uses interval notation (e.g. `[2026-01-01T00:00:00Z,2026-01-31T00:00:00Z)`), and `filter[search]`, which is a case-insensitive substring match against `resource_id` or `description`.  To bound the rows scanned per request, the endpoint requires either:  - `filter[resource_id]` (which must be accompanied by   `filter[resource_type]`), or - `filter[occurred_at]` with a span no greater than 30 days.  `page[size]` defaults to 50 and must not exceed 1000.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_occurred_at 
     # @option opts [String] :filter_actor_type 
@@ -112,6 +113,7 @@ module SmplkitGeneratedClient::Audit
     # @option opts [String] :filter_search Case-insensitive substring match against `resource_id` or `description`. Use `filter[resource_id]` for an exact match on `resource_id`.
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-occurred_at`. Allowed values: `created_at`, `-created_at`, `occurred_at`, `-occurred_at`. (default to '-occurred_at')
     # @return [Array<(EventListResponse, Integer, Hash)>] EventListResponse data, response status code and response headers
     def list_events_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -121,6 +123,10 @@ module SmplkitGeneratedClient::Audit
         fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling EventsApi.list_events, must be greater than or equal to 1.'
       end
 
+      allowable_values = ["created_at", "-created_at", "occurred_at", "-occurred_at"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/v1/events'
 
@@ -135,6 +141,7 @@ module SmplkitGeneratedClient::Audit
       query_params[:'filter[search]'] = opts[:'filter_search'] if !opts[:'filter_search'].nil?
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
       query_params[:'page[after]'] = opts[:'page_after'] if !opts[:'page_after'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

data/lib/smplkit/_generated/audit/lib/smplkit_audit_client/api/forwarders_api.rb

@@ -280,7 +280,7 @@ module SmplkitGeneratedClient::Audit
     end
 
     # List Forwarder Deliveries
-    # List delivery log entries for a forwarder.  Default sort is newest first. Filter by `status` (one of `SUCCEEDED`, `FAILED`, `FILTERED_OUT`, `SKIPPED_DO_NOT_FORWARD` — case-insensitive), by `event_id`, or by a `created_at` range using interval notation (e.g. `[2026-01-01T00:00:00Z,*)`).
+    # List delivery log entries for a forwarder.  Default sort is `-created_at` (newest first). Filter by `status` (one of `SUCCEEDED`, `FAILED`, `FILTERED_OUT`, `SKIPPED_DO_NOT_FORWARD` — case-insensitive), by `event_id`, or by a `created_at` range using interval notation (e.g. `[2026-01-01T00:00:00Z,*)`).
     # @param forwarder_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_status 
@@ -288,6 +288,7 @@ module SmplkitGeneratedClient::Audit
     # @option opts [String] :filter_event_id 
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`. (default to '-created_at')
     # @return [ForwarderDeliveryListResponse]
     def list_forwarder_deliveries(forwarder_id, opts = {})
       data, _status_code, _headers = list_forwarder_deliveries_with_http_info(forwarder_id, opts)
@@ -295,7 +296,7 @@ module SmplkitGeneratedClient::Audit
     end
 
     # List Forwarder Deliveries
-    # List delivery log entries for a forwarder.  Default sort is newest first. Filter by `status` (one of `SUCCEEDED`, `FAILED`, `FILTERED_OUT`, `SKIPPED_DO_NOT_FORWARD` — case-insensitive), by `event_id`, or by a `created_at` range using interval notation (e.g. `[2026-01-01T00:00:00Z,*)`).
+    # List delivery log entries for a forwarder.  Default sort is `-created_at` (newest first). Filter by `status` (one of `SUCCEEDED`, `FAILED`, `FILTERED_OUT`, `SKIPPED_DO_NOT_FORWARD` — case-insensitive), by `event_id`, or by a `created_at` range using interval notation (e.g. `[2026-01-01T00:00:00Z,*)`).
     # @param forwarder_id [String] 
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_status 
@@ -303,6 +304,7 @@ module SmplkitGeneratedClient::Audit
     # @option opts [String] :filter_event_id 
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`. (default to '-created_at')
     # @return [Array<(ForwarderDeliveryListResponse, Integer, Hash)>] ForwarderDeliveryListResponse data, response status code and response headers
     def list_forwarder_deliveries_with_http_info(forwarder_id, opts = {})
       if @api_client.config.debugging
@@ -316,6 +318,10 @@ module SmplkitGeneratedClient::Audit
         fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling ForwardersApi.list_forwarder_deliveries, must be greater than or equal to 1.'
       end
 
+      allowable_values = ["created_at", "-created_at"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/v1/forwarders/{forwarder_id}/deliveries'.sub('{forwarder_id}', CGI.escape(forwarder_id.to_s))
 
@@ -326,6 +332,7 @@ module SmplkitGeneratedClient::Audit
       query_params[:'filter[event_id]'] = opts[:'filter_event_id'] if !opts[:'filter_event_id'].nil?
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
       query_params[:'page[after]'] = opts[:'page_after'] if !opts[:'page_after'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -362,12 +369,13 @@ module SmplkitGeneratedClient::Audit
     end
 
     # List Forwarders
-    # List forwarders for this account.
+    # List forwarders for this account.  Default sort is `-created_at` (newest first). Pagination uses cursor tokens; keep the same `sort` value across paginated requests.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_forwarder_type 
     # @option opts [Boolean] :filter_enabled 
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with &#x60;-&#x60; for descending order. Default: &#x60;-created_at&#x60;. Allowed values: &#x60;created_at&#x60;, &#x60;-created_at&#x60;, &#x60;updated_at&#x60;, &#x60;-updated_at&#x60;. (default to '-created_at')
     # @return [ForwarderListResponse]
     def list_forwarders(opts = {})
       data, _status_code, _headers = list_forwarders_with_http_info(opts)
@@ -375,12 +383,13 @@ module SmplkitGeneratedClient::Audit
     end
 
     # List Forwarders
-    # List forwarders for this account.
+    # List forwarders for this account.  Default sort is &#x60;-created_at&#x60; (newest first). Pagination uses cursor tokens; keep the same &#x60;sort&#x60; value across paginated requests.
     # @param [Hash] opts the optional parameters
     # @option opts [String] :filter_forwarder_type 
     # @option opts [Boolean] :filter_enabled 
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with &#x60;-&#x60; for descending order. Default: &#x60;-created_at&#x60;. Allowed values: &#x60;created_at&#x60;, &#x60;-created_at&#x60;, &#x60;updated_at&#x60;, &#x60;-updated_at&#x60;. (default to '-created_at')
     # @return [Array<(ForwarderListResponse, Integer, Hash)>] ForwarderListResponse data, response status code and response headers
     def list_forwarders_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -390,6 +399,10 @@ module SmplkitGeneratedClient::Audit
         fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling ForwardersApi.list_forwarders, must be greater than or equal to 1.'
       end
 
+      allowable_values = ["created_at", "-created_at", "updated_at", "-updated_at"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/v1/forwarders'
 
@@ -399,6 +412,7 @@ module SmplkitGeneratedClient::Audit
       query_params[:'filter[enabled]'] = opts[:'filter_enabled'] if !opts[:'filter_enabled'].nil?
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
       query_params[:'page[after]'] = opts[:'page_after'] if !opts[:'page_after'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

data/lib/smplkit/_generated/audit/lib/smplkit_audit_client/api/resource_types_api.rb

@@ -20,10 +20,11 @@ module SmplkitGeneratedClient::Audit
       @api_client = api_client
     end
     # List Resource Types
-    # List the distinct `resource_type` slugs recorded for this account.  The resource `id` is the slug itself. Useful for populating filter dropdowns in a UI.
+    # List the distinct `resource_type` slugs recorded for this account.  The resource `id` is the slug itself. Default sort is `key` ascending; pass `sort=-key` for descending. Useful for populating filter dropdowns in a UI.
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `key`, `-key`. (default to 'key')
     # @return [ResourceTypeListResponse]
     def list_resource_types(opts = {})
       data, _status_code, _headers = list_resource_types_with_http_info(opts)
@@ -31,10 +32,11 @@ module SmplkitGeneratedClient::Audit
     end
 
     # List Resource Types
-    # List the distinct `resource_type` slugs recorded for this account.  The resource `id` is the slug itself. Useful for populating filter dropdowns in a UI.
+    # List the distinct `resource_type` slugs recorded for this account.  The resource `id` is the slug itself. Default sort is `key` ascending; pass `sort=-key` for descending. Useful for populating filter dropdowns in a UI.
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :page_size 
     # @option opts [String] :page_after 
+    # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `key`, `-key`. (default to 'key')
     # @return [Array<(ResourceTypeListResponse, Integer, Hash)>] ResourceTypeListResponse data, response status code and response headers
     def list_resource_types_with_http_info(opts = {})
       if @api_client.config.debugging
@@ -44,6 +46,10 @@ module SmplkitGeneratedClient::Audit
         fail ArgumentError, 'invalid value for "opts[:"page_size"]" when calling ResourceTypesApi.list_resource_types, must be greater than or equal to 1.'
       end
 
+      allowable_values = ["key", "-key"]
+      if @api_client.config.client_side_validation && opts[:'sort'] && !allowable_values.include?(opts[:'sort'])
+        fail ArgumentError, "invalid value for \"sort\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/v1/resource_types'
 
@@ -51,6 +57,7 @@ module SmplkitGeneratedClient::Audit
       query_params = opts[:query_params] || {}
       query_params[:'page[size]'] = opts[:'page_size'] if !opts[:'page_size'].nil?
       query_params[:'page[after]'] = opts[:'page_after'] if !opts[:'page_after'].nil?
+      query_params[:'sort'] = opts[:'sort'] if !opts[:'sort'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}

data/lib/smplkit/_generated/audit/spec/api/actions_api_spec.rb

@@ -34,11 +34,12 @@ describe 'ActionsApi' do
 
   # unit tests for list_actions
   # List Actions
-  # List the distinct `action` slugs recorded for this account.  Without `filter[resource_type]`, returns one row per distinct action. With `filter[resource_type]`, returns the actions recorded for that specific resource type.
+  # List the distinct `action` slugs recorded for this account.  Default sort is `key` ascending; pass `sort=-key` for descending. Without `filter[resource_type]`, returns one row per distinct action. With `filter[resource_type]`, returns the actions recorded for that specific resource type.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :filter_resource_type 
   # @option opts [Integer] :page_size 
   # @option opts [String] :page_after 
+  # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `key`, `-key`.
   # @return [ActionListResponse]
   describe 'list_actions test' do
     it 'should work' do

data/lib/smplkit/_generated/audit/spec/api/events_api_spec.rb

@@ -46,7 +46,7 @@ describe 'EventsApi' do
 
   # unit tests for list_events
   # List Events
-  # List audit events for this account.  Default sort is newest first. Filters are exact-match except `filter[occurred_at]`, which uses interval notation (e.g. `[2026-01-01T00:00:00Z,2026-01-31T00:00:00Z)`), and `filter[search]`, which is a case-insensitive substring match against `resource_id` or `description`.  To bound the rows scanned per request, the endpoint requires either:  - `filter[resource_id]` (which must be accompanied by   `filter[resource_type]`), or - `filter[occurred_at]` with a span no greater than 30 days.  `page[size]` defaults to 50 and must not exceed 1000.
+  # List audit events for this account.  Default sort is `-occurred_at` (newest occurrence first). Sort by `occurred_at` or `created_at`, ascending or descending — keep the same `sort` value across paginated requests so the cursor stays consistent. Filters are exact-match except `filter[occurred_at]`, which uses interval notation (e.g. `[2026-01-01T00:00:00Z,2026-01-31T00:00:00Z)`), and `filter[search]`, which is a case-insensitive substring match against `resource_id` or `description`.  To bound the rows scanned per request, the endpoint requires either:  - `filter[resource_id]` (which must be accompanied by   `filter[resource_type]`), or - `filter[occurred_at]` with a span no greater than 30 days.  `page[size]` defaults to 50 and must not exceed 1000.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :filter_occurred_at 
   # @option opts [String] :filter_actor_type 
@@ -57,6 +57,7 @@ describe 'EventsApi' do
   # @option opts [String] :filter_search Case-insensitive substring match against `resource_id` or `description`. Use `filter[resource_id]` for an exact match on `resource_id`.
   # @option opts [Integer] :page_size 
   # @option opts [String] :page_after 
+  # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-occurred_at`. Allowed values: `created_at`, `-created_at`, `occurred_at`, `-occurred_at`.
   # @return [EventListResponse]
   describe 'list_events test' do
     it 'should work' do