maybe/app/models/provider.rb

class Provider
  include Retryable

  Response = Data.define(:success?, :data, :error)

  class Error < StandardError
    attr_reader :details, :provider

    def initialize(message, details: nil, provider: nil)
      super(message)
      @details = details
      @provider = provider
    end

    def as_json
      {
        provider: provider,
        message: message,
        details: details
      }
    end
  end

  private
    PaginatedData = Data.define(:paginated, :first_page, :total_pages)
    UsageData = Data.define(:used, :limit, :utilization, :plan)

    # Subclasses can specify errors that can be retried
    def retryable_errors
      []
    end

    def with_provider_response(retries: default_retries, error_transformer: nil, &block)
      data = if retries > 0
        retrying(retryable_errors, max_retries: retries) { yield }
      else
        yield
      end

      Response.new(
        success?: true,
        data: data,
        error: nil,
      )
    rescue => error
      transformed_error = if error_transformer
        error_transformer.call(error)
      else
        default_error_transformer(error)
      end

      Sentry.capture_exception(transformed_error)

      Response.new(
        success?: false,
        data: nil,
        error: transformed_error
      )
    end

    # Override to set class-level error transformation for methods using `with_provider_response`
    def default_error_transformer(error)
      if error.is_a?(Faraday::Error)
        Error.new(
          error.message,
          details: error.response&.dig(:body),
          provider: self.class.name
        )
      else
        Error.new(error.message, provider: self.class.name)
      end
    end

    # Override to set class-level number of retries for methods using `with_provider_response`
    def default_retries
      0
    end
end