smplkit 3.0.13 → 3.0.14

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

@@ -18,10 +18,13 @@ module SmplkitGeneratedClient::App
   class PlanListResponse < ApiModelBase
     attr_accessor :data
 
+    attr_accessor :meta
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'data' => :'data'
+        :'data' => :'data',
+        :'meta' => :'meta'
       }
     end
 
@@ -38,7 +41,8 @@ module SmplkitGeneratedClient::App
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'data' => :'Array<PlanResource>'
+        :'data' => :'Array<PlanResource>',
+        :'meta' => :'ListMeta'
       }
     end
 
@@ -71,6 +75,12 @@ module SmplkitGeneratedClient::App
       else
         self.data = nil
       end
+
+      if attributes.key?(:'meta')
+        self.meta = attributes[:'meta']
+      else
+        self.meta = nil
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -82,6 +92,10 @@ module SmplkitGeneratedClient::App
         invalid_properties.push('invalid value for "data", data cannot be nil.')
       end
 
+      if @meta.nil?
+        invalid_properties.push('invalid value for "meta", meta cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -90,6 +104,7 @@ module SmplkitGeneratedClient::App
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @data.nil?
+      return false if @meta.nil?
       true
     end
 
@@ -103,12 +118,23 @@ module SmplkitGeneratedClient::App
       @data = data
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] meta Value to be assigned
+    def meta=(meta)
+      if meta.nil?
+        fail ArgumentError, 'meta cannot be nil'
+      end
+
+      @meta = meta
+    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
+          data == o.data &&
+          meta == o.meta
     end
 
     # @see the `==` method
@@ -120,7 +146,7 @@ module SmplkitGeneratedClient::App
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [data].hash
+      [data, meta].hash
     end
 
     # Builds the object from hash

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

@@ -18,10 +18,13 @@ module SmplkitGeneratedClient::App
   class ProductListResponse < ApiModelBase
     attr_accessor :data
 
+    attr_accessor :meta
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'data' => :'data'
+        :'data' => :'data',
+        :'meta' => :'meta'
       }
     end
 
@@ -38,7 +41,8 @@ module SmplkitGeneratedClient::App
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'data' => :'Array<ProductResource>'
+        :'data' => :'Array<ProductResource>',
+        :'meta' => :'ListMeta'
       }
     end
 
@@ -71,6 +75,12 @@ module SmplkitGeneratedClient::App
       else
         self.data = nil
       end
+
+      if attributes.key?(:'meta')
+        self.meta = attributes[:'meta']
+      else
+        self.meta = nil
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -82,6 +92,10 @@ module SmplkitGeneratedClient::App
         invalid_properties.push('invalid value for "data", data cannot be nil.')
       end
 
+      if @meta.nil?
+        invalid_properties.push('invalid value for "meta", meta cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -90,6 +104,7 @@ module SmplkitGeneratedClient::App
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @data.nil?
+      return false if @meta.nil?
       true
     end
 
@@ -103,12 +118,23 @@ module SmplkitGeneratedClient::App
       @data = data
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] meta Value to be assigned
+    def meta=(meta)
+      if meta.nil?
+        fail ArgumentError, 'meta cannot be nil'
+      end
+
+      @meta = meta
+    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
+          data == o.data &&
+          meta == o.meta
     end
 
     # @see the `==` method
@@ -120,7 +146,7 @@ module SmplkitGeneratedClient::App
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [data].hash
+      [data, meta].hash
     end
 
     # Builds the object from hash

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

@@ -18,10 +18,13 @@ module SmplkitGeneratedClient::App
   class ServiceListResponse < ApiModelBase
     attr_accessor :data
 
+    attr_accessor :meta
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
-        :'data' => :'data'
+        :'data' => :'data',
+        :'meta' => :'meta'
       }
     end
 
@@ -38,7 +41,8 @@ module SmplkitGeneratedClient::App
     # Attribute type mapping.
     def self.openapi_types
       {
-        :'data' => :'Array<ServiceResource>'
+        :'data' => :'Array<ServiceResource>',
+        :'meta' => :'ListMeta'
       }
     end
 
@@ -71,6 +75,12 @@ module SmplkitGeneratedClient::App
       else
         self.data = nil
       end
+
+      if attributes.key?(:'meta')
+        self.meta = attributes[:'meta']
+      else
+        self.meta = nil
+      end
     end
 
     # Show invalid properties with the reasons. Usually used together with valid?
@@ -82,6 +92,10 @@ module SmplkitGeneratedClient::App
         invalid_properties.push('invalid value for "data", data cannot be nil.')
       end
 
+      if @meta.nil?
+        invalid_properties.push('invalid value for "meta", meta cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -90,6 +104,7 @@ module SmplkitGeneratedClient::App
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @data.nil?
+      return false if @meta.nil?
       true
     end
 
@@ -103,12 +118,23 @@ module SmplkitGeneratedClient::App
       @data = data
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] meta Value to be assigned
+    def meta=(meta)
+      if meta.nil?
+        fail ArgumentError, 'meta cannot be nil'
+      end
+
+      @meta = meta
+    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
+          data == o.data &&
+          meta == o.meta
     end
 
     # @see the `==` method
@@ -120,7 +146,7 @@ module SmplkitGeneratedClient::App
     # Calculates hash code according to all attributes.
     # @return [Integer] Hash code
     def hash
-      [data].hash
+      [data, meta].hash
     end
 
     # Builds the object from hash

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

@@ -42,7 +42,7 @@ module SmplkitGeneratedClient::App
     def self.openapi_types
       {
         :'data' => :'Array<UserResource>',
-        :'meta' => :'UserListMeta'
+        :'meta' => :'ListMeta'
       }
     end
 
@@ -78,6 +78,8 @@ module SmplkitGeneratedClient::App
 
       if attributes.key?(:'meta')
         self.meta = attributes[:'meta']
+      else
+        self.meta = nil
       end
     end
 
@@ -90,6 +92,10 @@ module SmplkitGeneratedClient::App
         invalid_properties.push('invalid value for "data", data cannot be nil.')
       end
 
+      if @meta.nil?
+        invalid_properties.push('invalid value for "meta", meta cannot be nil.')
+      end
+
       invalid_properties
     end
 
@@ -98,6 +104,7 @@ module SmplkitGeneratedClient::App
     def valid?
       warn '[DEPRECATED] the `valid?` method is obsolete'
       return false if @data.nil?
+      return false if @meta.nil?
       true
     end
 
@@ -111,6 +118,16 @@ module SmplkitGeneratedClient::App
       @data = data
     end
 
+    # Custom attribute writer method with validation
+    # @param [Object] meta Value to be assigned
+    def meta=(meta)
+      if meta.nil?
+        fail ArgumentError, 'meta cannot be nil'
+      end
+
+      @meta = meta
+    end
+
     # Checks equality by comparing each attribute.
     # @param [Object] Object to be compared
     def ==(o)

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

@@ -49,6 +49,9 @@ require 'smplkit_app_client/models/context_type_list_response'
 require 'smplkit_app_client/models/context_type_request'
 require 'smplkit_app_client/models/context_type_resource'
 require 'smplkit_app_client/models/context_type_response'
+require 'smplkit_app_client/models/context_value'
+require 'smplkit_app_client/models/context_value_list_response'
+require 'smplkit_app_client/models/context_value_resource'
 require 'smplkit_app_client/models/email'
 require 'smplkit_app_client/models/email_resource'
 require 'smplkit_app_client/models/email_response'
@@ -74,6 +77,7 @@ require 'smplkit_app_client/models/invoice_list_response'
 require 'smplkit_app_client/models/invoice_resource'
 require 'smplkit_app_client/models/invoice_single_response'
 require 'smplkit_app_client/models/limit_definition'
+require 'smplkit_app_client/models/list_meta'
 require 'smplkit_app_client/models/login_request'
 require 'smplkit_app_client/models/metric_attributes'
 require 'smplkit_app_client/models/metric_bulk_request'
@@ -86,7 +90,7 @@ require 'smplkit_app_client/models/metric_rollup_list_response'
 require 'smplkit_app_client/models/metric_rollup_resource'
 require 'smplkit_app_client/models/next_tier_response'
 require 'smplkit_app_client/models/oidc_provider'
-require 'smplkit_app_client/models/page_meta'
+require 'smplkit_app_client/models/pagination_meta'
 require 'smplkit_app_client/models/payment_method'
 require 'smplkit_app_client/models/payment_method_list_response'
 require 'smplkit_app_client/models/payment_method_request'
@@ -121,7 +125,6 @@ require 'smplkit_app_client/models/subscription_resource'
 require 'smplkit_app_client/models/subscription_response'
 require 'smplkit_app_client/models/subscription_response_attributes'
 require 'smplkit_app_client/models/user'
-require 'smplkit_app_client/models/user_list_meta'
 require 'smplkit_app_client/models/user_list_response'
 require 'smplkit_app_client/models/user_request'
 require 'smplkit_app_client/models/user_resource'
@@ -135,6 +138,7 @@ require 'smplkit_app_client/api/account_api'
 require 'smplkit_app_client/api/auth_api'
 require 'smplkit_app_client/api/billing_api'
 require 'smplkit_app_client/api/context_types_api'
+require 'smplkit_app_client/api/context_values_api'
 require 'smplkit_app_client/api/contexts_api'
 require 'smplkit_app_client/api/email_registrations_api'
 require 'smplkit_app_client/api/emails_api'

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

@@ -74,6 +74,9 @@ describe 'APIKeysApi' do
   # @param [Hash] opts the optional parameters
   # @option opts [String] :filter_status 
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `expires_at`, `-expires_at`, `last_used_at`, `-last_used_at`, `name`, `-name`, `status`, `-status`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [ApiKeyListResponse]
   describe 'list_api_keys test' do
     it 'should work' do

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

@@ -93,9 +93,12 @@ describe 'BillingApi' do
 
   # unit tests for list_invoices
   # List Invoices
-  # Return invoice history for the account from Stripe.  Default sort is `-created_at` (newest first).
+  # Return invoice history for the account from Stripe.  Default sort is `-created_at` (newest first). The endpoint fetches the most recent 100 invoices from Stripe (its per-request cap) and pages over the result in memory; clients should not depend on more than 100 invoices being visible at once.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`, `status`, `-status`, `total`, `-total`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [InvoiceListResponse]
   describe 'list_invoices test' do
     it 'should work' do
@@ -108,6 +111,9 @@ describe 'BillingApi' do
   # List all payment methods for the account. Default is returned first, then newest first.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`, `exp_year`, `-exp_year`, `is_default`, `-is_default`, `updated_at`, `-updated_at`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [PaymentMethodListResponse]
   describe 'list_payment_methods test' do
     it 'should work' do

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

@@ -73,6 +73,9 @@ describe 'ContextTypesApi' do
   # List all context types for the authenticated account.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `created_at`, `-created_at`, `key`, `-key`, `name`, `-name`, `updated_at`, `-updated_at`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [ContextTypeListResponse]
   describe 'list_context_types test' do
     it 'should work' do

data/lib/smplkit/_generated/app/spec/api/context_values_api_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'
+
+# Unit tests for SmplkitGeneratedClient::App::ContextValuesApi
+# Automatically generated by openapi-generator (https://openapi-generator.tech)
+# Please update as you see appropriate
+describe 'ContextValuesApi' do
+  before do
+    # run before each test
+    @api_instance = SmplkitGeneratedClient::App::ContextValuesApi.new
+  end
+
+  after do
+    # run after each test
+  end
+
+  describe 'test an instance of ContextValuesApi' do
+    it 'should create an instance of ContextValuesApi' do
+      expect(@api_instance).to be_instance_of(SmplkitGeneratedClient::App::ContextValuesApi)
+    end
+  end
+
+  # unit tests for list_context_values
+  # List Context Values
+  # Return distinct values observed for a single attribute across context instances of one context type. The intended use case is a typeahead picker in a rule-building UI: the customer chooses a context type and an attribute name, then this endpoint streams back the distinct values matching what they've typed so far.  `filter[context_type]` and `filter[attribute]` are required. `filter[attribute]` accepts any attribute name — including the two first-class columns `key` and `name` — and is treated uniformly from the customer's perspective; the server adjusts the underlying query accordingly.  `filter[search]` does a case-insensitive starts-with match. The returned set excludes empty strings and NULL values.
+  # @param [Hash] opts the optional parameters
+  # @option opts [String] :filter_context_type Context type key whose instances should be searched (e.g. `user`).
+  # @option opts [String] :filter_attribute Attribute name whose distinct values should be returned (e.g. `first_name`). Accepts `key` and `name` as well as any attribute key stored on the context instance.
+  # @option opts [String] :filter_search Optional case-insensitive starts-with match against the projected attribute value. When omitted, all distinct values are returned in the page.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
+  # @return [ContextValueListResponse]
+  describe 'list_context_values test' 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/api/contexts_api_spec.rb

@@ -70,10 +70,14 @@ describe 'ContextsApi' do
 
   # unit tests for list_contexts
   # List Contexts
-  # List all context instances for the authenticated account.
+  # List context instances for the authenticated account. `filter[context_type]` narrows the result to one context type. `filter[search]` does a case-insensitive substring match against the context `key`, `name`, and every attribute value, returning any context where at least one of those fields contains the search term.
   # @param [Hash] opts the optional parameters
-  # @option opts [String] :filter_context_type 
+  # @option opts [String] :filter_context_type Limit results to context instances of this context type (e.g. `user`).
+  # @option opts [String] :filter_search Case-insensitive substring match against the `key`, `name`, and any attribute value. A context is returned if at least one of those fields contains the search term.
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `created_at`, `-created_at`, `key`, `-key`, `name`, `-name`, `updated_at`, `-updated_at`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [ContextListResponse]
   describe 'list_contexts test' do
     it 'should work' do

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

@@ -86,6 +86,9 @@ describe 'EnvironmentsApi' do
   # List all environments for the authenticated account.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `key`, `-key`, `name`, `-name`, `updated_at`, `-updated_at`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [EnvironmentListResponse]
   describe 'list_environments test' do
     it 'should work' do

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

@@ -63,6 +63,9 @@ describe 'InvitationsApi' do
   # @option opts [String] :filter_status 
   # @option opts [String] :filter_token 
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`, `email`, `-email`, `status`, `-status`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [InvitationListResponse]
   describe 'list_invitations test' do
     it 'should work' do

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

@@ -49,6 +49,9 @@ describe 'MetricsApi' do
   # Return distinct metric names recorded for the account, each with a representative unit. Plain-JSON response (not JSON:API) — this is metadata for discovery, not a metric resource.  Default sort is `name` ascending.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `name`, `-name`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [MetricNamesResponse]
   describe 'list_metric_names test' do
     it 'should work' do
@@ -64,6 +67,9 @@ describe 'MetricsApi' do
   # @param [Hash] opts the optional parameters
   # @option opts [String] :filter_recorded_at 
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `bucket`. Allowed values: `bucket`, `-bucket`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [MetricRollupListResponse]
   describe 'list_metric_rollups test' do
     it 'should work' do
@@ -78,6 +84,9 @@ describe 'MetricsApi' do
   # @param [Hash] opts the optional parameters
   # @option opts [String] :filter_recorded_at 
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `-recorded_at`. Allowed values: `recorded_at`, `-recorded_at`, `value`, `-value`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [MetricListResponse]
   describe 'list_metrics test' do
     it 'should work' do

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

@@ -37,6 +37,9 @@ describe 'PlansApi' do
   # Return all plan tier definitions as JSON:API resources.  Default sort is `sort_order` ascending — the natural ladder defined in `plans.yaml`. Pass `sort=display_name` for an alphabetical view.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `sort_order`. Allowed values: `display_name`, `-display_name`, `id`, `-id`, `sort_order`, `-sort_order`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [PlanListResponse]
   describe 'list_plans test' do
     it 'should work' do

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

@@ -37,6 +37,9 @@ describe 'ProductsApi' do
   # Return all flag-enabled products with their plans, limits, and marketing content.  Default sort is `display_name` ascending.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `display_name`. Allowed values: `display_name`, `-display_name`, `id`, `-id`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [ProductListResponse]
   describe 'list_products test' do
     it 'should work' do

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

@@ -73,6 +73,9 @@ describe 'ServicesApi' do
   # List all services for the authenticated account.
   # @param [Hash] opts the optional parameters
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `name`. Allowed values: `created_at`, `-created_at`, `key`, `-key`, `name`, `-name`, `updated_at`, `-updated_at`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [ServiceListResponse]
   describe 'list_services test' do
     it 'should work' do

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

@@ -73,9 +73,10 @@ describe 'UsersApi' do
   # @option opts [String] :filter_account 
   # @option opts [String] :filter_email 
   # @option opts [String] :filter_search Case-insensitive substring match against display_name and email. If the value is a valid UUID, also matches user id exactly.
-  # @option opts [Integer] :page_number 1-based page number
-  # @option opts [Integer] :page_size Items per page
   # @option opts [String] :sort Field to sort by. Prefix with `-` for descending order. Default: `email`. Allowed values: `created_at`, `-created_at`, `display_name`, `-display_name`, `email`, `-email`.
+  # @option opts [Integer] :page_number 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
+  # @option opts [Integer] :page_size Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
+  # @option opts [Boolean] :meta_total When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
   # @return [UserListResponse]
   describe 'list_users test' do
     it 'should work' do

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

@@ -33,4 +33,10 @@ describe SmplkitGeneratedClient::App::ApiKeyListResponse do
     end
   end
 
+  describe 'test attribute "meta"' 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/context_list_response_spec.rb

@@ -33,4 +33,10 @@ describe SmplkitGeneratedClient::App::ContextListResponse do
     end
   end
 
+  describe 'test attribute "meta"' 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/context_spec.rb

@@ -27,6 +27,12 @@ describe SmplkitGeneratedClient::App::Context do
     end
   end
 
+  describe 'test attribute "key"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
   describe 'test attribute "name"' do
     it 'should work' do
       # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/

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

@@ -33,4 +33,10 @@ describe SmplkitGeneratedClient::App::ContextTypeListResponse do
     end
   end
 
+  describe 'test attribute "meta"' do
+    it 'should work' do
+      # assertion here. ref: https://rspec.info/features/3-12/rspec-expectations/built-in-matchers/
+    end
+  end
+
 end