schematichq 1.4.0

data/lib/schematic/features/types/count_features_request.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class CountFeaturesRequest < Internal::Types::Model
+        field :ids, -> { String }, optional: true, nullable: false
+        field :q, -> { String }, optional: true, nullable: false
+        field :without_company_override_for, -> { String }, optional: true, nullable: false
+        field :plan_version_id, -> { String }, optional: true, nullable: false
+        field :without_plan_entitlement_for, -> { String }, optional: true, nullable: false
+        field :feature_type, -> { Schematic::Types::FeatureType }, optional: true, nullable: false
+        field :boolean_require_event, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/count_features_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class CountFeaturesResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::CountResponse }, optional: false, nullable: false
+        field :params, -> { Schematic::Features::Types::CountFeaturesParams }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/count_flags_params.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      # Input parameters
+      class CountFlagsParams < Internal::Types::Model
+        field :feature_id, -> { String }, optional: true, nullable: false
+        field :ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+        field :q, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/count_flags_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class CountFlagsRequest < Internal::Types::Model
+        field :feature_id, -> { String }, optional: true, nullable: false
+        field :ids, -> { String }, optional: true, nullable: false
+        field :q, -> { String }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/count_flags_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class CountFlagsResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::CountResponse }, optional: false, nullable: false
+        field :params, -> { Schematic::Features::Types::CountFlagsParams }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/create_feature_request_body.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class CreateFeatureRequestBody < Internal::Types::Model
+        field :description, -> { String }, optional: false, nullable: false
+        field :event_subtype, -> { String }, optional: true, nullable: false
+        field :feature_type, -> { Schematic::Types::FeatureType }, optional: false, nullable: false
+        field :flag, -> { Schematic::Types::CreateOrUpdateFlagRequestBody }, optional: true, nullable: false
+        field :icon, -> { String }, optional: true, nullable: false
+        field :lifecycle_phase, -> { Schematic::Types::FeatureLifecyclePhase }, optional: true, nullable: false
+        field :maintainer_id, -> { String }, optional: true, nullable: false
+        field :name, -> { String }, optional: false, nullable: false
+        field :plural_name, -> { String }, optional: true, nullable: false
+        field :singular_name, -> { String }, optional: true, nullable: false
+        field :trait_id, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/create_feature_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class CreateFeatureResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::FeatureDetailResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/create_flag_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class CreateFlagResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::FlagDetailResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/delete_feature_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class DeleteFeatureResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::DeleteResponse }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/delete_flag_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class DeleteFlagResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::DeleteResponse }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/get_feature_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class GetFeatureResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::FeatureDetailResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/get_flag_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class GetFlagResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::FlagDetailResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/list_features_params.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      # Input parameters
+      class ListFeaturesParams < Internal::Types::Model
+        field :boolean_require_event, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        field :feature_type, -> { Internal::Types::Array[Schematic::Types::FeatureType] }, optional: true, nullable: false
+        field :ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+        field :plan_version_id, -> { String }, optional: true, nullable: false
+        field :q, -> { String }, optional: true, nullable: false
+        field :without_company_override_for, -> { String }, optional: true, nullable: false
+        field :without_plan_entitlement_for, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/list_features_request.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class ListFeaturesRequest < Internal::Types::Model
+        field :ids, -> { String }, optional: true, nullable: false
+        field :q, -> { String }, optional: true, nullable: false
+        field :without_company_override_for, -> { String }, optional: true, nullable: false
+        field :plan_version_id, -> { String }, optional: true, nullable: false
+        field :without_plan_entitlement_for, -> { String }, optional: true, nullable: false
+        field :feature_type, -> { Schematic::Types::FeatureType }, optional: true, nullable: false
+        field :boolean_require_event, -> { Internal::Types::Boolean }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/list_features_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class ListFeaturesResponse < Internal::Types::Model
+        field :data, -> { Internal::Types::Array[Schematic::Types::FeatureDetailResponseData] }, optional: false, nullable: false
+        field :params, -> { Schematic::Features::Types::ListFeaturesParams }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/list_flags_params.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      # Input parameters
+      class ListFlagsParams < Internal::Types::Model
+        field :feature_id, -> { String }, optional: true, nullable: false
+        field :ids, -> { Internal::Types::Array[String] }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+        field :q, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/list_flags_request.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class ListFlagsRequest < Internal::Types::Model
+        field :feature_id, -> { String }, optional: true, nullable: false
+        field :ids, -> { String }, optional: true, nullable: false
+        field :q, -> { String }, optional: true, nullable: false
+        field :limit, -> { Integer }, optional: true, nullable: false
+        field :offset, -> { Integer }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/list_flags_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class ListFlagsResponse < Internal::Types::Model
+        field :data, -> { Internal::Types::Array[Schematic::Types::FlagDetailResponseData] }, optional: false, nullable: false
+        field :params, -> { Schematic::Features::Types::ListFlagsParams }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/update_feature_request_body.rb

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class UpdateFeatureRequestBody < Internal::Types::Model
+        field :feature_id, -> { String }, optional: false, nullable: false
+        field :description, -> { String }, optional: true, nullable: false
+        field :event_subtype, -> { String }, optional: true, nullable: false
+        field :feature_type, -> { Schematic::Types::FeatureType }, optional: true, nullable: false
+        field :flag, -> { Schematic::Types::CreateOrUpdateFlagRequestBody }, optional: true, nullable: false
+        field :icon, -> { String }, optional: true, nullable: false
+        field :lifecycle_phase, -> { Schematic::Types::FeatureLifecyclePhase }, optional: true, nullable: false
+        field :maintainer_id, -> { String }, optional: true, nullable: false
+        field :name, -> { String }, optional: true, nullable: false
+        field :plural_name, -> { String }, optional: true, nullable: false
+        field :singular_name, -> { String }, optional: true, nullable: false
+        field :trait_id, -> { String }, optional: true, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/update_feature_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class UpdateFeatureResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::FeatureDetailResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/update_flag_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class UpdateFlagResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::FlagDetailResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/update_flag_rules_request_body.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class UpdateFlagRulesRequestBody < Internal::Types::Model
+        field :flag_id, -> { String }, optional: false, nullable: false
+        field :rules, -> { Internal::Types::Array[Schematic::Types::CreateOrUpdateRuleRequestBody] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/features/types/update_flag_rules_response.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Features
+    module Types
+      class UpdateFlagRulesResponse < Internal::Types::Model
+        field :data, -> { Schematic::Types::RulesDetailResponseData }, optional: false, nullable: false
+        field :params, -> { Internal::Types::Hash[String, Object] }, optional: false, nullable: false
+      end
+    end
+  end
+end

data/lib/schematic/internal/errors/constraint_error.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Internal
+    module Errors
+      class ConstraintError < StandardError
+      end
+    end
+  end
+end

data/lib/schematic/internal/errors/type_error.rb

@@ -0,0 +1,10 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Internal
+    module Errors
+      class TypeError < StandardError
+      end
+    end
+  end
+end

data/lib/schematic/internal/http/base_request.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Internal
+    module Http
+      # @api private
+      class BaseRequest
+        attr_reader :base_url, :path, :method, :headers, :query, :request_options
+
+        # @param base_url [String] The base URL for the request
+        # @param path [String] The path for the request
+        # @param method [String] The HTTP method for the request (:get, :post, etc.)
+        # @param headers [Hash] Additional headers for the request (optional)
+        # @param query [Hash] Query parameters for the request (optional)
+        # @param request_options [Schematic::RequestOptions, Hash{Symbol=>Object}, nil]
+        def initialize(base_url:, path:, method:, headers: {}, query: {}, request_options: {})
+          @base_url = base_url
+          @path = path
+          @method = method
+          @headers = headers
+          @query = query
+          @request_options = request_options
+        end
+
+        # @return [Hash] The query parameters merged with additional query parameters from request options.
+        def encode_query
+          additional_query = @request_options&.dig(:additional_query_parameters) || @request_options&.dig("additional_query_parameters") || {}
+          @query.merge(additional_query)
+        end
+
+        # Child classes should implement:
+        # - encode_headers: Returns the encoded HTTP request headers.
+        # - encode_body: Returns the encoded HTTP request body.
+
+        private
+
+        # Merges additional_headers from request_options into sdk_headers, filtering out
+        # any keys that collide with SDK-set or client-protected headers (case-insensitive).
+        # @param sdk_headers [Hash] Headers set by the SDK for this request type.
+        # @param protected_keys [Array<String>] Additional header keys that must not be overridden.
+        # @return [Hash] The merged headers.
+        def merge_additional_headers(sdk_headers, protected_keys: [])
+          additional_headers = @request_options&.dig(:additional_headers) || @request_options&.dig("additional_headers") || {}
+          all_protected = (sdk_headers.keys + protected_keys).to_set { |k| k.to_s.downcase }
+          filtered = additional_headers.reject { |key, _| all_protected.include?(key.to_s.downcase) }
+          sdk_headers.merge(filtered)
+        end
+      end
+    end
+  end
+end

data/lib/schematic/internal/http/raw_client.rb

@@ -0,0 +1,214 @@
+# frozen_string_literal: true
+
+module Schematic
+  module Internal
+    module Http
+      # @api private
+      class RawClient
+        # Default HTTP status codes that trigger a retry
+        RETRYABLE_STATUSES = [408, 429, 500, 502, 503, 504, 521, 522, 524].freeze
+        # Initial delay between retries in seconds
+        INITIAL_RETRY_DELAY = 0.5
+        # Maximum delay between retries in seconds
+        MAX_RETRY_DELAY = 60.0
+        # Jitter factor for randomizing retry delays (20%)
+        JITTER_FACTOR = 0.2
+
+        # @return [String] The base URL for requests
+        attr_reader :base_url
+
+        # @param base_url [String] The base url for the request.
+        # @param max_retries [Integer] The number of times to retry a failed request, defaults to 2.
+        # @param timeout [Float] The timeout for the request, defaults to 60.0 seconds.
+        # @param headers [Hash] The headers for the request.
+        def initialize(base_url:, max_retries: 2, timeout: 60.0, headers: {})
+          @base_url = base_url
+          @max_retries = max_retries
+          @timeout = timeout
+          @default_headers = {
+            "X-Fern-Language": "Ruby",
+            "X-Fern-SDK-Name": "schematic",
+            "X-Fern-SDK-Version": "0.0.1"
+          }.merge(headers)
+        end
+
+        # @param request [Schematic::Internal::Http::BaseRequest] The HTTP request.
+        # @return [HTTP::Response] The HTTP response.
+        def send(request)
+          url = build_url(request)
+          attempt = 0
+          response = nil
+
+          loop do
+            http_request = build_http_request(
+              url:,
+              method: request.method,
+              headers: request.encode_headers(protected_keys: @default_headers.keys),
+              body: request.encode_body
+            )
+
+            conn = connect(url)
+            conn.open_timeout = @timeout
+            conn.read_timeout = @timeout
+            conn.write_timeout = @timeout
+            conn.continue_timeout = @timeout
+
+            response = conn.request(http_request)
+
+            break unless should_retry?(response, attempt)
+
+            delay = retry_delay(response, attempt)
+            sleep(delay)
+            attempt += 1
+          end
+
+          response
+        end
+
+        # Determines if a request should be retried based on the response status code.
+        # @param response [Net::HTTPResponse] The HTTP response.
+        # @param attempt [Integer] The current retry attempt (0-indexed).
+        # @return [Boolean] Whether the request should be retried.
+        def should_retry?(response, attempt)
+          return false if attempt >= @max_retries
+
+          status = response.code.to_i
+          RETRYABLE_STATUSES.include?(status)
+        end
+
+        # Calculates the delay before the next retry attempt using exponential backoff with jitter.
+        # Respects Retry-After header if present.
+        # @param response [Net::HTTPResponse] The HTTP response.
+        # @param attempt [Integer] The current retry attempt (0-indexed).
+        # @return [Float] The delay in seconds before the next retry.
+        def retry_delay(response, attempt)
+          # Check for Retry-After header (can be seconds or HTTP date)
+          retry_after = response["Retry-After"]
+          if retry_after
+            delay = parse_retry_after(retry_after)
+            return [delay, MAX_RETRY_DELAY].min if delay&.positive?
+          end
+
+          # Exponential backoff with jitter: base_delay * 2^attempt
+          base_delay = INITIAL_RETRY_DELAY * (2**attempt)
+          add_jitter([base_delay, MAX_RETRY_DELAY].min)
+        end
+
+        # Parses the Retry-After header value.
+        # @param value [String] The Retry-After header value (seconds or HTTP date).
+        # @return [Float, nil] The delay in seconds, or nil if parsing fails.
+        def parse_retry_after(value)
+          # Try parsing as integer (seconds)
+          seconds = Integer(value, exception: false)
+          return seconds.to_f if seconds
+
+          # Try parsing as HTTP date
+          begin
+            retry_time = Time.httpdate(value)
+            delay = retry_time - Time.now
+            delay.positive? ? delay : nil
+          rescue ArgumentError
+            nil
+          end
+        end
+
+        # Adds random jitter to a delay value.
+        # @param delay [Float] The base delay in seconds.
+        # @return [Float] The delay with jitter applied.
+        def add_jitter(delay)
+          jitter = delay * JITTER_FACTOR * (rand - 0.5) * 2
+          [delay + jitter, 0].max
+        end
+
+        LOCALHOST_HOSTS = %w[localhost 127.0.0.1 [::1]].freeze
+
+        # @param request [Schematic::Internal::Http::BaseRequest] The HTTP request.
+        # @return [URI::Generic] The URL.
+        def build_url(request)
+          encoded_query = request.encode_query
+
+          # If the path is already an absolute URL, use it directly
+          if request.path.start_with?("http://", "https://")
+            url = request.path
+            url = "#{url}?#{encode_query(encoded_query)}" if encoded_query&.any?
+            parsed = URI.parse(url)
+            validate_https!(parsed)
+            return parsed
+          end
+
+          path = request.path.start_with?("/") ? request.path[1..] : request.path
+          base = request.base_url || @base_url
+          url = "#{base.chomp("/")}/#{path}"
+          url = "#{url}?#{encode_query(encoded_query)}" if encoded_query&.any?
+          parsed = URI.parse(url)
+          validate_https!(parsed)
+          parsed
+        end
+
+        # Raises if the URL uses http:// for a non-localhost host, which would
+        # send authentication credentials in plaintext.
+        # @param url [URI::Generic] The parsed URL.
+        def validate_https!(url)
+          return if url.scheme != "http"
+          return if LOCALHOST_HOSTS.include?(url.host)
+
+          raise ArgumentError, "Refusing to send request to non-HTTPS URL: #{url}. " \
+                               "HTTP is only allowed for localhost. Use HTTPS or pass a localhost URL."
+        end
+
+        # @param url [URI::Generic] The url to the resource.
+        # @param method [String] The HTTP method to use.
+        # @param headers [Hash] The headers for the request.
+        # @param body [String, nil] The body for the request.
+        # @return [HTTP::Request] The HTTP request.
+        def build_http_request(url:, method:, headers: {}, body: nil)
+          request = Net::HTTPGenericRequest.new(
+            method,
+            !body.nil?,
+            method != "HEAD",
+            url
+          )
+
+          request_headers = @default_headers.merge(headers)
+          request_headers.each { |name, value| request[name] = value }
+          request.body = body if body
+
+          request
+        end
+
+        # @param query [Hash] The query for the request.
+        # @return [String, nil] The encoded query.
+        def encode_query(query)
+          query.to_h.empty? ? nil : URI.encode_www_form(query)
+        end
+
+        # @param url [URI::Generic] The url to connect to.
+        # @return [Net::HTTP] The HTTP connection.
+        def connect(url)
+          is_https = (url.scheme == "https")
+
+          port = if url.port
+                   url.port
+                 elsif is_https
+                   Net::HTTP.https_default_port
+                 else
+                   Net::HTTP.http_default_port
+                 end
+
+          http = Net::HTTP.new(url.host, port)
+          http.use_ssl = is_https
+          http.verify_mode = OpenSSL::SSL::VERIFY_PEER if is_https
+          # NOTE: We handle retries at the application level with HTTP status code awareness,
+          # so we set max_retries to 0 to disable Net::HTTP's built-in network-level retries.
+          http.max_retries = 0
+          http
+        end
+
+        # @return [String]
+        def inspect
+          "#<#{self.class.name}:0x#{object_id.to_s(16)} @base_url=#{@base_url.inspect}>"
+        end
+      end
+    end
+  end
+end