fern_gusto 0.0.6.pre.alpha6

data/lib/fern_gusto.rb

@@ -0,0 +1,310 @@
+require_relative "base_gusto"
+
+
+module Gusto
+  # Authentication configuration for system access token
+  class SystemAccessTokenAuth
+    # @return [Symbol] The type of authentication, always :system_access_token
+    attr_accessor :type
+    # @return [String] The client ID for system access token authentication
+    attr_accessor :client_id
+    # @return [String] The client secret for system access token authentication
+    attr_accessor :client_secret
+
+    # @param type [Symbol] The type of authentication, should be :system_access_token
+    # @param client_id [String] The client ID for system access token authentication
+    # @param client_secret [String] The client secret for system access token authentication
+    def initialize(type:, client_id:, client_secret:)
+      @type = type
+      @client_id = client_id
+      @client_secret = client_secret
+    end
+  end
+
+  # Authentication configuration for company access token
+  class CompanyAccessTokenAuth
+    # @return [Symbol] The type of authentication, always :company_access_token
+    attr_accessor :type
+    # @return [String] The access token for company access token authentication
+    attr_accessor :access_token
+    # @return [String] The client ID for company access token authentication
+    attr_accessor :client_id
+    # @return [String] The client secret for company access token authentication
+    attr_accessor :client_secret
+    # @return [String] The redirect URI for company access token authentication
+    attr_accessor :redirect_uri
+    # @return [String] The refresh token for company access token authentication
+    attr_accessor :refresh_token
+
+    # @param type [Symbol] The type of authentication, should be :company_access_token
+    # @param access_token [String] The access token for company access token authentication
+    # @param client_id [String] The client ID for company access token authentication
+    # @param client_secret [String] The client secret for company access token authentication
+    # @param redirect_uri [String] The redirect URI for company access token authentication
+    # @param refresh_token [String] The refresh token for company access token authentication
+    def initialize(type:, access_token:, client_id:, client_secret:, redirect_uri:, refresh_token:)
+      @type = type
+      @access_token = access_token
+      @client_id = client_id
+      @client_secret = client_secret
+      @redirect_uri = redirect_uri
+      @refresh_token = refresh_token
+    end
+  end
+
+  # Authentication configuration for token authentication
+  class TokenAuth
+    # @return [Symbol] The type of authentication, always :token
+    attr_accessor :type
+    # @return [String] The token for token authentication
+    attr_accessor :token
+
+    # @param type [Symbol] The type of authentication, should be :token
+    # @param token [String] The token for token authentication
+    def initialize(type:, token:)
+      @type = type
+      @token = token
+    end
+  end
+
+  class Client < BaseClient
+
+    # Options for initializing the Gusto client
+    class Options
+      # @return [Gusto::Environment] The Gusto environment to connect to
+      attr_accessor :environment
+      # @return [SystemAccessTokenAuth, CompanyAccessTokenAuth, TokenAuth] Authentication configuration
+      attr_accessor :auth
+
+      # @param environment [Gusto::Environment] The Gusto environment to connect to
+      # @param auth [SystemAccessTokenAuth, CompanyAccessTokenAuth, TokenAuth] Authentication configuration
+      def initialize(environment:, auth:)
+        @environment = environment
+        @auth = auth
+      end
+    end
+
+    # Instantiate a new Gusto API client
+    #
+    # @example Create client with system access token auth
+    #   auth = Gusto::SystemAccessTokenAuth.new(
+    #     type: :system_access_token,
+    #     client_id: 'client_id',
+    #     client_secret: 'client_secret'
+    #   )
+    #   client = Gusto::Client.new(auth: auth, environment: :production)
+    #
+    # @example Create client with company access token auth
+    #   auth = Gusto::CompanyAccessTokenAuth.new(
+    #     type: :company_access_token,
+    #     client_id: 'client_id',
+    #     client_secret: 'client_secret',
+    #     redirect_uri: 'https://example.com/callback',
+    #     refresh_token: 'refresh_token',
+    #     access_token: 'access_token'
+    #   )
+    #   client = Gusto::Client.new(auth: auth, environment: :production)
+    #
+    # @example Create client with token auth
+    #   auth = Gusto::TokenAuth.new(
+    #     type: :token,
+    #     token: 'token'
+    #   )
+    #   client = Gusto::Client.new(auth: auth, environment: :production)
+    #
+    # @param auth [SystemAccessTokenAuth, CompanyAccessTokenAuth, TokenAuth] Authentication configuration
+    # @param environment [Gusto::Environment] The Gusto environment to connect to
+    # @param base_url [String] The base URL for API requests
+    # @param max_retries [Long] The number of times to retry a failed request, defaults to 2
+    # @param timeout_in_seconds [Long] The timeout for API requests in seconds
+    # @param gusto_api_version [String] Determines the date-based API version associated with your API call
+    # @return [Gusto::Client]
+    def initialize(auth:, environment: Gusto::Environment::DEMO, base_url: nil, max_retries: nil, timeout_in_seconds: nil, gusto_api_version: nil)
+      token_supplier = case auth
+      when SystemAccessTokenAuth
+        refresher = SystemAccessTokenRefresher.new(
+          auth.client_id,
+          auth.client_secret
+        )
+        -> { refresher.get_token }
+      when CompanyAccessTokenAuth
+        refresher = CompanyAccessTokenRefresher.new(
+          auth.client_id,
+          auth.client_secret,
+          auth.redirect_uri,
+          auth.refresh_token
+        )
+        -> { refresher.get_token }
+      when TokenAuth
+        -> { auth.token }
+      end
+
+      @request_client = Gusto::RequestClient.new(
+        base_url: base_url,
+        environment: environment,
+        max_retries: max_retries,
+        timeout_in_seconds: timeout_in_seconds,
+        token: token_supplier,
+        gusto_api_version: gusto_api_version
+      )
+
+      super(
+        environment: environment,
+        token: token_supplier.call,
+      )
+    end
+  end
+
+  class AsyncClient < BaseAsyncClient
+    # Options for initializing the Gusto async client
+    class Options
+      # @return [Gusto::Environment] The Gusto environment to connect to
+      attr_accessor :environment
+      # @return [SystemAccessTokenAuth, CompanyAccessTokenAuth, TokenAuth] Authentication configuration
+      attr_accessor :auth
+
+      # @param environment [Gusto::Environment] The Gusto environment to connect to
+      # @param auth [SystemAccessTokenAuth, CompanyAccessTokenAuth, TokenAuth] Authentication configuration
+      def initialize(environment:, auth:)
+        @environment = environment
+        @auth = auth
+      end
+    end
+
+    # Instantiate a new asynchronous Gusto API client
+    #
+    # @example Create async client with system access token auth
+    #   auth = Gusto::SystemAccessTokenAuth.new(
+    #     type: :system_access_token,
+    #     client_id: 'client_id',
+    #     client_secret: 'client_secret'
+    #   )
+    #   client = Gusto::AsyncClient.new(auth: auth, environment: :production)
+    #
+    # @example Create async client with company access token auth
+    #   auth = Gusto::CompanyAccessTokenAuth.new(
+    #     type: :company_access_token,
+    #     client_id: 'client_id',
+    #     client_secret: 'client_secret',
+    #     redirect_uri: 'https://example.com/callback',
+    #     refresh_token: 'refresh_token',
+    #     access_token: 'access_token'
+    #   )
+    #   client = Gusto::AsyncClient.new(auth: auth, environment: :production)
+    #
+    # @example Create async client with token auth
+    #   auth = Gusto::TokenAuth.new(
+    #     type: :token,
+    #     token: 'token'
+    #   )
+    #   client = Gusto::AsyncClient.new(auth: auth, environment: :production)
+    #
+    # @param auth [SystemAccessTokenAuth, CompanyAccessTokenAuth, TokenAuth] Authentication configuration
+    # @param environment [Gusto::Environment] The Gusto environment to connect to
+    # @param base_url [String] The base URL for API requests
+    # @param max_retries [Long] The number of times to retry a failed request, defaults to 2
+    # @param timeout_in_seconds [Long] The timeout for API requests in seconds
+    # @param gusto_api_version [String] Determines the date-based API version associated with your API call
+    # @return [Gusto::AsyncClient]
+    def initialize(auth:, environment: Gusto::Environment::DEMO, base_url: nil, max_retries: nil, timeout_in_seconds: nil, gusto_api_version: nil)
+      token_supplier = case auth
+      when SystemAccessTokenAuth
+        refresher = SystemAccessTokenRefresher.new(
+          auth.client_id,
+          auth.client_secret
+        )
+        -> { refresher.get_token }
+      when CompanyAccessTokenAuth
+        refresher = CompanyAccessTokenRefresher.new(
+          auth.client_id,
+          auth.client_secret,
+          auth.redirect_uri,
+          auth.refresh_token
+        )
+        -> { refresher.get_token }
+      when TokenAuth
+        -> { auth.token }
+      end
+
+      @async_request_client = Gusto::AsyncRequestClient.new(
+        base_url: base_url,
+        environment: environment,
+        max_retries: max_retries,
+        timeout_in_seconds: timeout_in_seconds,
+        token: token_supplier,
+        gusto_api_version: gusto_api_version
+      )
+
+      super(
+        environment: environment,
+        token: token_supplier
+      )
+    end
+  end
+
+  class SystemAccessTokenRefresher
+    EXPIRY_BUFFER_MS = 60 * 1000 # 1 minute buffer
+
+    def initialize(client_id, client_secret)
+      @client_id = client_id
+      @client_secret = client_secret
+      @token = nil
+      @token_expiry = nil
+    end
+
+    def get_token
+      if @token && @token_expiry && @token_expiry > Time.now + EXPIRY_BUFFER_MS
+        return @token
+      end
+
+      client = Gusto::BaseClient.new(token: nil)
+      response = client.token.get_system_access_token(
+        client_id: @client_id,
+        client_secret: @client_secret
+      )
+
+      @token = response.access_token
+      @token_expiry = Time.now + response.expires_in
+
+      @token
+    end
+  end
+
+  class CompanyAccessTokenRefresher
+    EXPIRY_BUFFER_MS = 60 * 1000 # 1 minute buffer
+
+    def initialize(client_id, client_secret, redirect_uri, refresh_token)
+      @client_id = client_id
+      @client_secret = client_secret
+      @redirect_uri = redirect_uri
+      @refresh_token = refresh_token
+      @token = nil
+      @token_expiry = nil
+    end
+
+    def get_token
+      if @token && @token_expiry && @token_expiry > Time.now + EXPIRY_BUFFER_MS
+        return @token
+      end
+
+      client = Gusto::BaseClient.new(token: nil)
+      response = client.token.refresh(
+        client_id: @client_id,
+        client_secret: @client_secret,
+        redirect_uri: @redirect_uri,
+        refresh_token: @refresh_token,
+        grant_type: "refresh_token"
+      )
+
+      raise GustoError, "Expected access token in response but got null" unless response.access_token
+      raise GustoError, "Expected refresh token in response but got null" unless response.refresh_token
+      raise GustoError, "Expected expires_in in response but got null" unless response.expires_in
+
+      @token = response.access_token
+      @refresh_token = response.refresh_token
+      @token_expiry = Time.now + response.expires_in
+
+      @token
+    end
+  end
+end

data/lib/gemconfig.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+module Gusto
+  module Gemconfig
+    VERSION = ""
+    AUTHORS = [""].freeze
+    EMAIL = ""
+    SUMMARY = ""
+    DESCRIPTION = ""
+    HOMEPAGE = "https://github.com/fern-demo/gusto-ruby"
+    SOURCE_CODE_URI = "https://github.com/fern-demo/gusto-ruby"
+    CHANGELOG_URI = "https://github.com/fern-demo/gusto-ruby/blob/master/CHANGELOG.md"
+  end
+end

data/lib/gusto_legacy.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Gusto
+  class LegacyClient
+    # @return [Gusto::EmployeeBenefitsClient] 
+    attr_reader :employee_benefits
+
+    def initialize
+      @employee_benefits = EmployeeBenefitsClient.new
+    end
+  end
+
+  class EmployeeBenefitsClient
+    def create(employee_id:, body:)
+      # Implementation would go here
+      # This is just a stub to match the example usage
+    end
+  end
+end

data/lib/requests.rb

@@ -0,0 +1,206 @@
+# frozen_string_literal: true
+require_relative "environment"
+require "faraday"
+require "faraday/multipart"
+require "faraday/retry"
+require "faraday"
+require "faraday"
+require "faraday/multipart"
+require "async/http/faraday"
+require "faraday/retry"
+
+module Gusto
+  class RequestClient
+  # @return [Faraday] 
+    attr_reader :conn
+  # @return [String] 
+    attr_reader :base_url
+  # @return [String] 
+    attr_reader :token
+  # @return [String] 
+    attr_reader :default_environment
+
+
+    # @param base_url [String] 
+    # @param environment [Gusto::Environment] 
+    # @param max_retries [Long] The number of times to retry a failed request, defaults to 2.
+    # @param timeout_in_seconds [Long] 
+    # @param token [String] 
+    # @param gusto_api_version [String] Determines the date-based API version associated with your API call. If none is
+#  provided, your application's [minimum API
+#  https://docs.gusto.com/embedded-payroll/docs/api-versioning#minimum-api-version)
+#  is used.
+    # @return [Gusto::RequestClient]
+    def initialize(base_url: nil, environment: Gusto::Environment::DEMO, max_retries: nil, timeout_in_seconds: nil, token:, gusto_api_version: nil)
+      @default_environment = environment
+      @base_url = environment || base_url
+      @token = "Bearer #{token}"
+      @headers = {  }
+      unless gusto_api_version.nil?
+        @headers["X-Gusto-API-Version"] = gusto_api_version
+      end
+      @conn = Faraday.new(headers: @headers) do | faraday |
+  faraday.request :multipart
+  faraday.request :json
+  faraday.response :raise_error, include_request: true
+  unless max_retries.nil?
+    faraday.request :retry ,  { max: max_retries }
+  end
+  unless timeout_in_seconds.nil?
+    faraday.options.timeout = timeout_in_seconds
+  end
+end
+    end
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [String]
+    def get_url(request_options: nil)
+      request_options&.base_url || @default_environment || @base_url
+    end
+    # @return [Hash{String => String}]
+    def get_headers
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'fern_gusto', "X-Fern-SDK-Version": '0.0.6-alpha6' }
+      headers["Authorization"] = ((@token.is_a? Method) ? @token.call : @token) unless @token.nil?
+ headers
+    end
+  end
+  class AsyncRequestClient
+  # @return [Faraday] 
+    attr_reader :conn
+  # @return [String] 
+    attr_reader :base_url
+  # @return [String] 
+    attr_reader :token
+  # @return [String] 
+    attr_reader :default_environment
+
+
+    # @param base_url [String] 
+    # @param environment [Gusto::Environment] 
+    # @param max_retries [Long] The number of times to retry a failed request, defaults to 2.
+    # @param timeout_in_seconds [Long] 
+    # @param token [String] 
+    # @param gusto_api_version [String] Determines the date-based API version associated with your API call. If none is
+#  provided, your application's [minimum API
+#  https://docs.gusto.com/embedded-payroll/docs/api-versioning#minimum-api-version)
+#  is used.
+    # @return [Gusto::AsyncRequestClient]
+    def initialize(base_url: nil, environment: Gusto::Environment::DEMO, max_retries: nil, timeout_in_seconds: nil, token:, gusto_api_version: nil)
+      @default_environment = environment
+      @base_url = environment || base_url
+      @token = "Bearer #{token}"
+      @headers = {  }
+      unless gusto_api_version.nil?
+        @headers["X-Gusto-API-Version"] = gusto_api_version
+      end
+      @conn = Faraday.new(headers: @headers) do | faraday |
+  faraday.request :multipart
+  faraday.request :json
+  faraday.response :raise_error, include_request: true
+  faraday.adapter :async_http
+  unless max_retries.nil?
+    faraday.request :retry ,  { max: max_retries }
+  end
+  unless timeout_in_seconds.nil?
+    faraday.options.timeout = timeout_in_seconds
+  end
+end
+    end
+    # @param request_options [Gusto::RequestOptions] 
+    # @return [String]
+    def get_url(request_options: nil)
+      request_options&.base_url || @default_environment || @base_url
+    end
+    # @return [Hash{String => String}]
+    def get_headers
+      headers = { "X-Fern-Language": 'Ruby', "X-Fern-SDK-Name": 'fern_gusto', "X-Fern-SDK-Version": '0.0.6-alpha6' }
+      headers["Authorization"] = ((@token.is_a? Method) ? @token.call : @token) unless @token.nil?
+ headers
+    end
+  end
+# Additional options for request-specific configuration when calling APIs via the
+#  SDK.
+  class RequestOptions
+  # @return [String] 
+    attr_reader :base_url
+  # @return [String] 
+    attr_reader :token
+  # @return [String] Determines the date-based API version associated with your API call. If none is
+#  provided, your application's [minimum API
+#  https://docs.gusto.com/embedded-payroll/docs/api-versioning#minimum-api-version)
+#  is used.
+    attr_reader :gusto_api_version
+  # @return [Hash{String => Object}] 
+    attr_reader :additional_headers
+  # @return [Hash{String => Object}] 
+    attr_reader :additional_query_parameters
+  # @return [Hash{String => Object}] 
+    attr_reader :additional_body_parameters
+  # @return [Long] 
+    attr_reader :timeout_in_seconds
+
+
+    # @param base_url [String] 
+    # @param token [String] 
+    # @param gusto_api_version [String] Determines the date-based API version associated with your API call. If none is
+#  provided, your application's [minimum API
+#  https://docs.gusto.com/embedded-payroll/docs/api-versioning#minimum-api-version)
+#  is used.
+    # @param additional_headers [Hash{String => Object}] 
+    # @param additional_query_parameters [Hash{String => Object}] 
+    # @param additional_body_parameters [Hash{String => Object}] 
+    # @param timeout_in_seconds [Long] 
+    # @return [Gusto::RequestOptions]
+    def initialize(base_url: nil, token: nil, gusto_api_version: nil, additional_headers: nil, additional_query_parameters: nil, additional_body_parameters: nil, timeout_in_seconds: nil)
+      @base_url = base_url
+      @token = token
+      @gusto_api_version = gusto_api_version
+      @additional_headers = additional_headers
+      @additional_query_parameters = additional_query_parameters
+      @additional_body_parameters = additional_body_parameters
+      @timeout_in_seconds = timeout_in_seconds
+    end
+  end
+# Additional options for request-specific configuration when calling APIs via the
+#  SDK.
+  class IdempotencyRequestOptions
+  # @return [String] 
+    attr_reader :base_url
+  # @return [String] 
+    attr_reader :token
+  # @return [String] Determines the date-based API version associated with your API call. If none is
+#  provided, your application's [minimum API
+#  https://docs.gusto.com/embedded-payroll/docs/api-versioning#minimum-api-version)
+#  is used.
+    attr_reader :gusto_api_version
+  # @return [Hash{String => Object}] 
+    attr_reader :additional_headers
+  # @return [Hash{String => Object}] 
+    attr_reader :additional_query_parameters
+  # @return [Hash{String => Object}] 
+    attr_reader :additional_body_parameters
+  # @return [Long] 
+    attr_reader :timeout_in_seconds
+
+
+    # @param base_url [String] 
+    # @param token [String] 
+    # @param gusto_api_version [String] Determines the date-based API version associated with your API call. If none is
+#  provided, your application's [minimum API
+#  https://docs.gusto.com/embedded-payroll/docs/api-versioning#minimum-api-version)
+#  is used.
+    # @param additional_headers [Hash{String => Object}] 
+    # @param additional_query_parameters [Hash{String => Object}] 
+    # @param additional_body_parameters [Hash{String => Object}] 
+    # @param timeout_in_seconds [Long] 
+    # @return [Gusto::IdempotencyRequestOptions]
+    def initialize(base_url: nil, token: nil, gusto_api_version: nil, additional_headers: nil, additional_query_parameters: nil, additional_body_parameters: nil, timeout_in_seconds: nil)
+      @base_url = base_url
+      @token = token
+      @gusto_api_version = gusto_api_version
+      @additional_headers = additional_headers
+      @additional_query_parameters = additional_query_parameters
+      @additional_body_parameters = additional_body_parameters
+      @timeout_in_seconds = timeout_in_seconds
+    end
+  end
+end