stackone_client 0.6.0 → 0.7.0

data/lib/stack_one/proxy.rb

@@ -7,6 +7,7 @@ require 'faraday'
 require 'faraday/multipart'
 require 'faraday/retry'
 require 'sorbet-runtime'
+require_relative 'sdk_hooks/hooks'
 require_relative 'utils/retries'
 
 module StackOne
@@ -21,8 +22,8 @@ module StackOne
     end
 
 
-    sig { params(proxy_request_body: ::StackOne::Shared::ProxyRequestBody, x_account_id: ::String, retries: T.nilable(Utils::RetryConfig)).returns(::StackOne::Operations::StackoneProxyRequestResponse) }
-    def proxy_request(proxy_request_body, x_account_id, retries = nil)
+    sig { params(proxy_request_body: ::StackOne::Shared::ProxyRequestBody, x_account_id: ::String, retries: T.nilable(Utils::RetryConfig), timeout_ms: T.nilable(Integer)).returns(::StackOne::Operations::StackoneProxyRequestResponse) }
+    def proxy_request(proxy_request_body, x_account_id, retries = nil, timeout_ms = nil)
       # proxy_request - Proxy Request
       request = ::StackOne::Operations::StackoneProxyRequestRequest.new(
         
@@ -36,6 +37,14 @@ module StackOne
       req_content_type, data, form = Utils.serialize_request_body(request, :proxy_request_body, :json)
       headers['content-type'] = req_content_type
       raise StandardError, 'request body is required' if data.nil? && form.nil?
+
+      if form
+        body = Utils.encode_form(form)
+      elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
+        body = URI.encode_www_form(data)
+      else
+        body = data
+      end
       headers['Accept'] = '*/*'
       headers['user-agent'] = @sdk_configuration.user_agent
       retries ||= @sdk_configuration.retry_config
@@ -52,19 +61,61 @@ module StackOne
       retry_options = retries.to_faraday_retry_options(initial_time: Time.now)
       retry_options[:retry_statuses] = [429, 408]
 
+      security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil
+
+      timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+      timeout ||= @sdk_configuration.timeout
+
       connection = @sdk_configuration.client.dup
       connection.request :retry, retry_options
 
-      r = connection.post(url) do |req|
-        req.headers = headers
-        security = !@sdk_configuration.nil? && !@sdk_configuration.security_source.nil? ? @sdk_configuration.security_source.call : nil
-        Utils.configure_request_security(req, security) if !security.nil?
-        if form
-          req.body = Utils.encode_form(form)
-        elsif Utils.match_content_type(req_content_type, 'application/x-www-form-urlencoded')
-          req.body = URI.encode_www_form(data)
+      hook_ctx = SDKHooks::HookContext.new(
+        base_url: base_url,
+        oauth2_scopes: [],
+        operation_id: 'stackone_proxy_request',
+        security_source: @sdk_configuration.security_source
+      )
+
+      error = T.let(nil, T.nilable(StandardError))
+      r = T.let(nil, T.nilable(Faraday::Response))
+      
+      begin
+        r = connection.post(url) do |req|
+          req.body = body
+          req.headers.merge!(headers)
+          req.options.timeout = timeout unless timeout.nil?
+          Utils.configure_request_security(req, security)
+
+          @sdk_configuration.hooks.before_request(
+            hook_ctx: SDKHooks::BeforeRequestHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            request: req
+          )
+        end
+      rescue StandardError => e
+        error = e
+      ensure
+        if r.nil? || Utils.error_status?(r.status)
+          r = @sdk_configuration.hooks.after_error(
+            error: error,
+            hook_ctx: SDKHooks::AfterErrorHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: r
+          )
         else
-          req.body = data
+          r = @sdk_configuration.hooks.after_success(
+            hook_ctx: SDKHooks::AfterSuccessHookContext.new(
+              hook_ctx: hook_ctx
+            ),
+            response: r
+          )
+        end
+        
+        if r.nil?
+          raise error if !error.nil?
+          raise 'no response'
         end
       end
 

data/lib/stack_one/sdk_hooks/hooks.rb

@@ -0,0 +1,101 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+require_relative './types'
+
+require 'sorbet-runtime'
+
+module StackOne
+  module SDKHooks
+    class Hooks
+      extend T::Sig
+
+      sig { void }
+      def initialize
+        @sdk_init_hooks = T.let([], T::Array[AbstractSDKInitHook])
+        @before_request_hooks = T.let([], T::Array[AbstractBeforeRequestHook])
+        @after_success_hooks = T.let([], T::Array[AbstractAfterSuccessHook])
+        @after_error_hooks = T.let([], T::Array[AbstractAfterErrorHook])
+      end
+
+      sig { params(hook: AbstractSDKInitHook).void }
+      def register_sdk_init_hook(hook)
+        @sdk_init_hooks << hook
+      end
+
+      sig { params(hook: AbstractBeforeRequestHook).void }
+      def register_before_request_hook(hook)
+        @before_request_hooks << hook
+      end
+
+      sig { params(hook: AbstractAfterSuccessHook).void }
+      def register_after_success_hook(hook)
+        @after_success_hooks << hook
+      end
+
+      sig { params(hook: AbstractAfterErrorHook).void }
+      def register_after_error_hook(hook)
+        @after_error_hooks << hook
+      end
+
+      sig do
+        params(
+          base_url: String,
+          client: Faraday::Connection
+        ).returns([String, Faraday::Connection])
+      end
+      def sdk_init(base_url:, client:)
+        @sdk_init_hooks.each do |hook|
+          base_url, client = hook.sdk_init(base_url: base_url, client: client)
+        end
+
+        return base_url, client
+      end
+
+      sig do
+        params(
+          hook_ctx: BeforeRequestHookContext,
+          request: Faraday::Request
+        ).returns(Faraday::Request)
+      end
+      def before_request(hook_ctx:, request:)
+        @before_request_hooks.each do |hook|
+          request = hook.before_request(hook_ctx: hook_ctx, request: request)
+        end
+
+        request
+      end
+
+      sig do
+        params(
+          hook_ctx: AfterSuccessHookContext,
+          response: Faraday::Response
+        ).returns(Faraday::Response)
+      end
+      def after_success(hook_ctx:, response:)
+        @after_success_hooks.each do |hook|
+          response = hook.after_success(hook_ctx: hook_ctx, response: response)
+        end
+
+        response
+      end
+
+      sig do
+        params(
+          error: T.nilable(StandardError),
+          hook_ctx: AfterErrorHookContext,
+          response: T.nilable(Faraday::Response)
+        ).returns(T.nilable(Faraday::Response))
+      end
+      def after_error(error:, hook_ctx:, response:)
+        @after_error_hooks.each do |hook|
+          response = hook.after_error(error: error, hook_ctx: hook_ctx, response: response)
+        end
+
+        response
+      end
+    end
+  end
+end

data/lib/stack_one/sdk_hooks/types.rb

@@ -0,0 +1,152 @@
+# Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+
+# typed: true
+# frozen_string_literal: true
+
+require 'sorbet-runtime'
+
+module StackOne
+  module SDKHooks
+    class HookContext
+      extend T::Sig
+
+      sig { returns(String) }
+      attr_accessor :base_url
+
+      sig { returns(T.nilable(T::Array[String])) }
+      attr_accessor :oauth2_scopes
+
+      sig { returns(String) }
+      attr_accessor :operation_id
+
+      sig { returns(T.nilable(T.proc.returns(T.untyped))) }
+      attr_accessor :security_source
+
+      sig do
+        params(
+          base_url: String,
+          oauth2_scopes: T.nilable(T::Array[String]),
+          operation_id: String,
+          security_source: T.nilable(T.proc.returns(T.untyped))
+        ).void
+      end
+      def initialize(base_url:, oauth2_scopes:, operation_id:, security_source:)
+        @base_url = T.let(base_url, String)
+        @oauth2_scopes = T.let(oauth2_scopes, T.nilable(T::Array[String]))
+        @operation_id = T.let(operation_id, String)
+        @security_source = T.let(security_source, T.nilable(T.proc.returns(T.untyped)))
+      end
+    end
+
+    class BeforeRequestHookContext < HookContext
+      extend T::Sig
+
+      sig do
+        params(
+          hook_ctx: HookContext
+        ).void
+      end
+      def initialize(hook_ctx:)
+        super(
+          base_url: hook_ctx.base_url,
+          operation_id: hook_ctx.operation_id,
+          oauth2_scopes: hook_ctx.oauth2_scopes,
+          security_source: hook_ctx.security_source
+        )
+      end
+    end
+
+    class AfterSuccessHookContext < HookContext
+      extend T::Sig
+
+      sig do
+        params(
+          hook_ctx: HookContext
+        ).void
+      end
+      def initialize(hook_ctx:)
+        super(
+          base_url: hook_ctx.base_url,
+          operation_id: hook_ctx.operation_id,
+          oauth2_scopes: hook_ctx.oauth2_scopes,
+          security_source: hook_ctx.security_source
+        )
+      end
+    end
+
+    class AfterErrorHookContext < HookContext
+      extend T::Sig
+
+      sig do
+        params(
+          hook_ctx: HookContext
+        ).void
+      end
+      def initialize(hook_ctx:)
+        super(
+          base_url: hook_ctx.base_url,
+          operation_id: hook_ctx.operation_id,
+          oauth2_scopes: hook_ctx.oauth2_scopes,
+          security_source: hook_ctx.security_source
+        )
+      end
+    end
+
+    module AbstractSDKInitHook
+      extend T::Sig
+      extend T::Helpers
+      abstract!
+
+      sig do
+        abstract.params(
+          base_url: String,
+          client: Faraday::Connection
+        ).returns([String, Faraday::Connection])
+      end
+      def sdk_init(base_url:, client:); end
+    end
+
+    module AbstractBeforeRequestHook
+      extend T::Sig
+      extend T::Helpers
+      abstract!
+
+      sig do
+        abstract.params(
+          hook_ctx: BeforeRequestHookContext,
+          request: Faraday::Request
+        ).returns(Faraday::Request)
+      end
+      def before_request(hook_ctx:, request:); end
+    end
+
+    module AbstractAfterSuccessHook
+      extend T::Sig
+      extend T::Helpers
+      abstract!
+
+      sig do
+        abstract.params(
+          hook_ctx: AfterSuccessHookContext,
+          response: Faraday::Response
+        ).returns(Faraday::Response)
+      end
+      def after_success(hook_ctx:, response:); end
+    end
+
+    module AbstractAfterErrorHook
+      extend T::Sig
+      extend T::Helpers
+      abstract!
+
+      sig do
+        abstract.params(
+          error: T.nilable(StandardError),
+          hook_ctx: AfterErrorHookContext,
+          response: T.nilable(Faraday::Response)
+        ).returns(T.nilable(Faraday::Response))
+      end
+      def after_error(error:, hook_ctx:, response:); end
+    end
+  end
+end

data/lib/stack_one/sdkconfiguration.rb

@@ -7,6 +7,7 @@ require 'faraday'
 require 'faraday/multipart'
 require 'faraday/retry'
 require 'sorbet-runtime'
+require_relative 'sdk_hooks/hooks'
 require_relative 'utils/retries'
 
 module StackOne
@@ -21,7 +22,9 @@ module StackOne
     extend T::Sig
 
     field :client, T.nilable(Faraday::Connection)
+    field :hooks, ::StackOne::SDKHooks::Hooks
     field :retry_config, T.nilable(::StackOne::Utils::RetryConfig)
+    field :timeout, T.nilable(Float)
     field :security_source, T.nilable(T.proc.returns(T.nilable(::StackOne::Shared::Security)))
     field :server_url, T.nilable(String)
     field :server_idx, T.nilable(Integer)
@@ -34,17 +37,21 @@ module StackOne
     sig do
       params(
         client: T.nilable(Faraday::Connection),
+        hooks: ::StackOne::SDKHooks::Hooks,
         retry_config: T.nilable(::StackOne::Utils::RetryConfig),
+        timeout_ms: T.nilable(Integer),
         security: T.nilable(::StackOne::Shared::Security),
         security_source: T.nilable(T.proc.returns(::StackOne::Shared::Security)),
         server_url: T.nilable(String),
         server_idx: T.nilable(Integer)
       ).void
     end
-    def initialize(client, retry_config, security, security_source, server_url, server_idx)
+    def initialize(client, hooks, retry_config, timeout_ms, security, security_source, server_url, server_idx)
       @client = client
+      @hooks = hooks
       @retry_config = retry_config
       @server_url = server_url
+      @timeout = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
       @server_idx = server_idx.nil? ? 0 : server_idx
       raise StandardError, "Invalid server index #{server_idx}" if @server_idx.negative? || @server_idx >= SERVERS.length
       if !security_source.nil?
@@ -54,9 +61,9 @@ module StackOne
       end
       @language = 'ruby'
       @openapi_doc_version = '1.0.0'
-      @sdk_version = '0.6.0'
-      @gen_version = '2.548.6'
-      @user_agent = 'speakeasy-sdk/ruby 0.6.0 2.548.6 1.0.0 stackone_client'
+      @sdk_version = '0.7.0'
+      @gen_version = '2.559.0'
+      @user_agent = 'speakeasy-sdk/ruby 0.7.0 2.559.0 1.0.0 stackone_client'
     end
 
     sig { returns([String, T::Hash[Symbol, String]]) }

data/lib/stack_one/stackone.rb

@@ -7,6 +7,7 @@ require 'faraday'
 require 'faraday/multipart'
 require 'faraday/retry'
 require 'sorbet-runtime'
+require_relative 'sdk_hooks/hooks'
 require_relative 'utils/retries'
 
 module StackOne
@@ -21,6 +22,7 @@ module StackOne
       params(
         client: T.nilable(Faraday::Connection),
         retry_config: T.nilable(::StackOne::Utils::RetryConfig),
+        timeout_ms: T.nilable(Integer),
         security: T.nilable(::StackOne::Shared::Security),
         security_source: T.nilable(T.proc.returns(::StackOne::Shared::Security)),
         server_idx: T.nilable(Integer),
@@ -28,23 +30,27 @@ module StackOne
         url_params: T.nilable(T::Hash[Symbol, String])
       ).void
     end
-    def initialize(client: nil, retry_config: nil, security: nil, security_source: nil, server_idx: nil, server_url: nil, url_params: nil)
+    def initialize(client: nil, retry_config: nil, timeout_ms: nil, security: nil, security_source: nil, server_idx: nil, server_url: nil, url_params: nil)
       ## Instantiates the SDK configuring it with the provided parameters.
       # @param [T.nilable(Faraday::Connection)] client The faraday HTTP client to use for all operations
       # @param [T.nilable(::StackOne::Utils::RetryConfig)] retry_config The retry configuration to use for all operations
+      # @param [T.nilable(Integer)] timeout_ms Request timeout in milliseconds for all operations
       # @param [T.nilable(::StackOne::Shared::Security)] security: The security details required for authentication
       # @param [T.proc.returns(T.nilable(::StackOne::Shared::Security))] security_source: A function that returns security details required for authentication
       # @param [T.nilable(::Integer)] server_idx The index of the server to use for all operations
       # @param [T.nilable(::String)] server_url The server URL to use for all operations
       # @param [T.nilable(::Hash<::Symbol, ::String>)] url_params Parameters to optionally template the server URL with
 
-      if client.nil?
-        client = Faraday.new(request: {
-                          params_encoder: Faraday::FlatParamsEncoder
-                        }) do |f|
-          f.request :multipart, {}
-          # f.response :logger
-        end
+      connection_options = {
+        request: {
+          params_encoder: Faraday::FlatParamsEncoder
+        }
+      }
+      connection_options[:request][:timeout] = (timeout_ms.to_f / 1000) unless timeout_ms.nil?
+
+      client ||= Faraday.new(**connection_options) do |f|
+        f.request :multipart, {}
+        # f.response :logger, nil, { headers: true, bodies: true, errors: true }
       end
 
       if !server_url.nil?
@@ -54,14 +60,22 @@ module StackOne
       end
 
       server_idx = 0 if server_idx.nil?
+      hooks = SDKHooks::Hooks.new
       @sdk_configuration = SDKConfiguration.new(
         client,
+        hooks,
         retry_config,
+        timeout_ms,
         security,
         security_source,
         server_url,
         server_idx
       )
+
+      original_server_url = @sdk_configuration.get_server_details.first
+      new_server_url, @sdk_configuration.client = hooks.sdk_init(base_url: original_server_url, client: client)
+      @sdk_configuration.server_url = new_server_url if new_server_url != original_server_url
+
       init_sdks
     end
 

data/lib/stack_one/utils/utils.rb

@@ -351,6 +351,15 @@ module StackOne
       server_url.delete_suffix('/') + path
     end
 
+    sig { params(status: Integer).returns(T::Boolean) }
+    def self.error_status?(status)
+      status_major = status / 100
+      return true if status_major == 4
+      return true if status_major == 5
+
+      false
+    end
+
     sig { params(content_type: String, pattern: String).returns(T::Boolean) }
     def self.match_content_type(content_type, pattern)
       return true if content_type == pattern || ['*', '*/*'].include?(pattern)
@@ -365,6 +374,7 @@ module StackOne
 
     sig { params(req: Faraday::Request, security: Object).void }
     def self.configure_request_security(req, security)
+      return if security.nil?
       sec_fields = security.fields
       sec_fields.each do |sec_field|
         value = security.send(sec_field.name)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: stackone_client
 version: !ruby/object:Gem::Version
-  version: 0.6.0
+  version: 0.7.0
 platform: ruby
 authors:
 - StackOne
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-03-14 00:00:00.000000000 Z
+date: 2025-03-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -526,12 +526,16 @@ files:
 - lib/stack_one/models/operations/hris_update_employee_employment_response.rb
 - lib/stack_one/models/operations/hris_update_employee_request.rb
 - lib/stack_one/models/operations/hris_update_employee_response.rb
+- lib/stack_one/models/operations/hris_update_employee_time_off_request_request.rb
+- lib/stack_one/models/operations/hris_update_employee_time_off_request_response.rb
 - lib/stack_one/models/operations/hris_update_employee_work_eligibility_request_request.rb
 - lib/stack_one/models/operations/hris_update_employee_work_eligibility_request_response.rb
 - lib/stack_one/models/operations/hris_update_time_off_request_request.rb
 - lib/stack_one/models/operations/hris_update_time_off_request_response.rb
 - lib/stack_one/models/operations/hris_upload_employee_document_request.rb
 - lib/stack_one/models/operations/hris_upload_employee_document_response.rb
+- lib/stack_one/models/operations/iam_delete_user_request.rb
+- lib/stack_one/models/operations/iam_delete_user_response.rb
 - lib/stack_one/models/operations/iam_get_group_request.rb
 - lib/stack_one/models/operations/iam_get_group_response.rb
 - lib/stack_one/models/operations/iam_get_policy_request.rb
@@ -552,6 +556,8 @@ files:
 - lib/stack_one/models/operations/iam_list_users_queryparam_filter.rb
 - lib/stack_one/models/operations/iam_list_users_request.rb
 - lib/stack_one/models/operations/iam_list_users_response.rb
+- lib/stack_one/models/operations/iam_update_user_request.rb
+- lib/stack_one/models/operations/iam_update_user_response.rb
 - lib/stack_one/models/operations/job_status.rb
 - lib/stack_one/models/operations/lms_batch_upsert_content_request.rb
 - lib/stack_one/models/operations/lms_batch_upsert_content_response.rb
@@ -1190,6 +1196,9 @@ files:
 - lib/stack_one/models/shared/iamrole_value.rb
 - lib/stack_one/models/shared/iamroleresult.rb
 - lib/stack_one/models/shared/iamrolespaginated.rb
+- lib/stack_one/models/shared/iamupdateuserrequestdto.rb
+- lib/stack_one/models/shared/iamupdateuserrequestdto_status.rb
+- lib/stack_one/models/shared/iamupdateuserrequestdto_value.rb
 - lib/stack_one/models/shared/iamuser.rb
 - lib/stack_one/models/shared/iamuser_avatar.rb
 - lib/stack_one/models/shared/iamuser_category.rb
@@ -1491,6 +1500,9 @@ files:
 - lib/stack_one/models/shared/updateemployeeapimodel_work_location.rb
 - lib/stack_one/models/shared/updatepackage.rb
 - lib/stack_one/models/shared/updateresult.rb
+- lib/stack_one/models/shared/updateuserapimodel.rb
+- lib/stack_one/models/shared/updateuserapimodel_status.rb
+- lib/stack_one/models/shared/updateuserapimodel_value.rb
 - lib/stack_one/models/shared/upsertresult.rb
 - lib/stack_one/models/shared/upsertresultdataexternalreferencemodel.rb
 - lib/stack_one/models/shared/userresult.rb
@@ -1511,6 +1523,8 @@ files:
 - lib/stack_one/models/shared/workeligibilityresult.rb
 - lib/stack_one/models/shared/writeresultapimodel.rb
 - lib/stack_one/proxy.rb
+- lib/stack_one/sdk_hooks/hooks.rb
+- lib/stack_one/sdk_hooks/types.rb
 - lib/stack_one/sdkconfiguration.rb
 - lib/stack_one/stackone.rb
 - lib/stack_one/utils/retries.rb