apimatic-plaid-sdk 0.0.1

data/lib/plaid/models/cash_type.rb

@@ -0,0 +1,305 @@
+# plaid
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Plaid
+  # Activity that modifies a cash position
+  class CashType < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Fees paid for account maintenance
+    # @return [String]
+    attr_accessor :account_fee
+
+    # Inflow of assets into a tax-advantaged account
+    # @return [String]
+    attr_accessor :contribution
+
+    # Inflow of cash into an account
+    # @return [String]
+    attr_accessor :deposit
+
+    # Inflow of cash from a dividend
+    # @return [String]
+    attr_accessor :dividend
+
+    # Inflow of stock from a distribution
+    # @return [String]
+    attr_accessor :stock_distribution
+
+    # Inflow of cash from interest
+    # @return [String]
+    attr_accessor :interest
+
+    # Fees paid for legal charges or services
+    # @return [String]
+    attr_accessor :legal_fee
+
+    # Long-term capital gain received as cash
+    # @return [String]
+    attr_accessor :long_term_capital_gain
+
+    # Fees paid for investment management of a mutual fund or other pooled
+    # investment vehicle
+    # @return [String]
+    attr_accessor :management_fee
+
+    # Fees paid for maintaining margin debt
+    # @return [String]
+    attr_accessor :margin_expense
+
+    # Inflow of cash from a non-qualified dividend
+    # @return [String]
+    attr_accessor :non_qualified_dividend
+
+    # Taxes paid on behalf of the investor for non-residency in investment
+    # jurisdiction
+    # @return [String]
+    attr_accessor :non_resident_tax
+
+    # Pending inflow of cash
+    # @return [String]
+    attr_accessor :pending_credit
+
+    # Pending outflow of cash
+    # @return [String]
+    attr_accessor :pending_debit
+
+    # Inflow of cash from a qualified dividend
+    # @return [String]
+    attr_accessor :qualified_dividend
+
+    # Short-term capital gain received as cash
+    # @return [String]
+    attr_accessor :short_term_capital_gain
+
+    # Taxes paid on behalf of the investor
+    # @return [String]
+    attr_accessor :tax
+
+    # Taxes withheld on behalf of the customer
+    # @return [String]
+    attr_accessor :tax_withheld
+
+    # Fees incurred for transfer of a holding or account
+    # @return [String]
+    attr_accessor :transfer_fee
+
+    # Fees related to adminstration of a trust account
+    # @return [String]
+    attr_accessor :trust_fee
+
+    # Unqualified capital gain received as cash
+    # @return [String]
+    attr_accessor :unqualified_gain
+
+    # Outflow of cash from an account
+    # @return [String]
+    attr_accessor :withdrawal
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['account_fee'] = 'account fee'
+      @_hash['contribution'] = 'contribution'
+      @_hash['deposit'] = 'deposit'
+      @_hash['dividend'] = 'dividend'
+      @_hash['stock_distribution'] = 'stock distribution'
+      @_hash['interest'] = 'interest'
+      @_hash['legal_fee'] = 'legal fee'
+      @_hash['long_term_capital_gain'] = 'long-term capital gain'
+      @_hash['management_fee'] = 'management fee'
+      @_hash['margin_expense'] = 'margin expense'
+      @_hash['non_qualified_dividend'] = 'non-qualified dividend'
+      @_hash['non_resident_tax'] = 'non-resident tax'
+      @_hash['pending_credit'] = 'pending credit'
+      @_hash['pending_debit'] = 'pending debit'
+      @_hash['qualified_dividend'] = 'qualified dividend'
+      @_hash['short_term_capital_gain'] = 'short-term capital gain'
+      @_hash['tax'] = 'tax'
+      @_hash['tax_withheld'] = 'tax withheld'
+      @_hash['transfer_fee'] = 'transfer fee'
+      @_hash['trust_fee'] = 'trust fee'
+      @_hash['unqualified_gain'] = 'unqualified gain'
+      @_hash['withdrawal'] = 'withdrawal'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      %w[
+        account_fee
+        contribution
+        deposit
+        dividend
+        stock_distribution
+        interest
+        legal_fee
+        long_term_capital_gain
+        management_fee
+        margin_expense
+        non_qualified_dividend
+        non_resident_tax
+        pending_credit
+        pending_debit
+        qualified_dividend
+        short_term_capital_gain
+        tax
+        tax_withheld
+        transfer_fee
+        trust_fee
+        unqualified_gain
+        withdrawal
+      ]
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(account_fee: SKIP, contribution: SKIP, deposit: SKIP,
+                   dividend: SKIP, stock_distribution: SKIP, interest: SKIP,
+                   legal_fee: SKIP, long_term_capital_gain: SKIP,
+                   management_fee: SKIP, margin_expense: SKIP,
+                   non_qualified_dividend: SKIP, non_resident_tax: SKIP,
+                   pending_credit: SKIP, pending_debit: SKIP,
+                   qualified_dividend: SKIP, short_term_capital_gain: SKIP,
+                   tax: SKIP, tax_withheld: SKIP, transfer_fee: SKIP,
+                   trust_fee: SKIP, unqualified_gain: SKIP, withdrawal: SKIP,
+                   additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @account_fee = account_fee unless account_fee == SKIP
+      @contribution = contribution unless contribution == SKIP
+      @deposit = deposit unless deposit == SKIP
+      @dividend = dividend unless dividend == SKIP
+      @stock_distribution = stock_distribution unless stock_distribution == SKIP
+      @interest = interest unless interest == SKIP
+      @legal_fee = legal_fee unless legal_fee == SKIP
+      @long_term_capital_gain = long_term_capital_gain unless long_term_capital_gain == SKIP
+      @management_fee = management_fee unless management_fee == SKIP
+      @margin_expense = margin_expense unless margin_expense == SKIP
+      @non_qualified_dividend = non_qualified_dividend unless non_qualified_dividend == SKIP
+      @non_resident_tax = non_resident_tax unless non_resident_tax == SKIP
+      @pending_credit = pending_credit unless pending_credit == SKIP
+      @pending_debit = pending_debit unless pending_debit == SKIP
+      @qualified_dividend = qualified_dividend unless qualified_dividend == SKIP
+      @short_term_capital_gain = short_term_capital_gain unless short_term_capital_gain == SKIP
+      @tax = tax unless tax == SKIP
+      @tax_withheld = tax_withheld unless tax_withheld == SKIP
+      @transfer_fee = transfer_fee unless transfer_fee == SKIP
+      @trust_fee = trust_fee unless trust_fee == SKIP
+      @unqualified_gain = unqualified_gain unless unqualified_gain == SKIP
+      @withdrawal = withdrawal unless withdrawal == SKIP
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      account_fee = hash.key?('account fee') ? hash['account fee'] : SKIP
+      contribution = hash.key?('contribution') ? hash['contribution'] : SKIP
+      deposit = hash.key?('deposit') ? hash['deposit'] : SKIP
+      dividend = hash.key?('dividend') ? hash['dividend'] : SKIP
+      stock_distribution =
+        hash.key?('stock distribution') ? hash['stock distribution'] : SKIP
+      interest = hash.key?('interest') ? hash['interest'] : SKIP
+      legal_fee = hash.key?('legal fee') ? hash['legal fee'] : SKIP
+      long_term_capital_gain =
+        hash.key?('long-term capital gain') ? hash['long-term capital gain'] : SKIP
+      management_fee =
+        hash.key?('management fee') ? hash['management fee'] : SKIP
+      margin_expense =
+        hash.key?('margin expense') ? hash['margin expense'] : SKIP
+      non_qualified_dividend =
+        hash.key?('non-qualified dividend') ? hash['non-qualified dividend'] : SKIP
+      non_resident_tax =
+        hash.key?('non-resident tax') ? hash['non-resident tax'] : SKIP
+      pending_credit =
+        hash.key?('pending credit') ? hash['pending credit'] : SKIP
+      pending_debit = hash.key?('pending debit') ? hash['pending debit'] : SKIP
+      qualified_dividend =
+        hash.key?('qualified dividend') ? hash['qualified dividend'] : SKIP
+      short_term_capital_gain =
+        hash.key?('short-term capital gain') ? hash['short-term capital gain'] : SKIP
+      tax = hash.key?('tax') ? hash['tax'] : SKIP
+      tax_withheld = hash.key?('tax withheld') ? hash['tax withheld'] : SKIP
+      transfer_fee = hash.key?('transfer fee') ? hash['transfer fee'] : SKIP
+      trust_fee = hash.key?('trust fee') ? hash['trust fee'] : SKIP
+      unqualified_gain =
+        hash.key?('unqualified gain') ? hash['unqualified gain'] : SKIP
+      withdrawal = hash.key?('withdrawal') ? hash['withdrawal'] : SKIP
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      CashType.new(account_fee: account_fee,
+                   contribution: contribution,
+                   deposit: deposit,
+                   dividend: dividend,
+                   stock_distribution: stock_distribution,
+                   interest: interest,
+                   legal_fee: legal_fee,
+                   long_term_capital_gain: long_term_capital_gain,
+                   management_fee: management_fee,
+                   margin_expense: margin_expense,
+                   non_qualified_dividend: non_qualified_dividend,
+                   non_resident_tax: non_resident_tax,
+                   pending_credit: pending_credit,
+                   pending_debit: pending_debit,
+                   qualified_dividend: qualified_dividend,
+                   short_term_capital_gain: short_term_capital_gain,
+                   tax: tax,
+                   tax_withheld: tax_withheld,
+                   transfer_fee: transfer_fee,
+                   trust_fee: trust_fee,
+                   unqualified_gain: unqualified_gain,
+                   withdrawal: withdrawal,
+                   additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} account_fee: #{@account_fee}, contribution: #{@contribution}, deposit:"\
+      " #{@deposit}, dividend: #{@dividend}, stock_distribution: #{@stock_distribution}, interest:"\
+      " #{@interest}, legal_fee: #{@legal_fee}, long_term_capital_gain:"\
+      " #{@long_term_capital_gain}, management_fee: #{@management_fee}, margin_expense:"\
+      " #{@margin_expense}, non_qualified_dividend: #{@non_qualified_dividend}, non_resident_tax:"\
+      " #{@non_resident_tax}, pending_credit: #{@pending_credit}, pending_debit:"\
+      " #{@pending_debit}, qualified_dividend: #{@qualified_dividend}, short_term_capital_gain:"\
+      " #{@short_term_capital_gain}, tax: #{@tax}, tax_withheld: #{@tax_withheld}, transfer_fee:"\
+      " #{@transfer_fee}, trust_fee: #{@trust_fee}, unqualified_gain: #{@unqualified_gain},"\
+      " withdrawal: #{@withdrawal}, additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} account_fee: #{@account_fee.inspect}, contribution:"\
+      " #{@contribution.inspect}, deposit: #{@deposit.inspect}, dividend: #{@dividend.inspect},"\
+      " stock_distribution: #{@stock_distribution.inspect}, interest: #{@interest.inspect},"\
+      " legal_fee: #{@legal_fee.inspect}, long_term_capital_gain:"\
+      " #{@long_term_capital_gain.inspect}, management_fee: #{@management_fee.inspect},"\
+      " margin_expense: #{@margin_expense.inspect}, non_qualified_dividend:"\
+      " #{@non_qualified_dividend.inspect}, non_resident_tax: #{@non_resident_tax.inspect},"\
+      " pending_credit: #{@pending_credit.inspect}, pending_debit: #{@pending_debit.inspect},"\
+      " qualified_dividend: #{@qualified_dividend.inspect}, short_term_capital_gain:"\
+      " #{@short_term_capital_gain.inspect}, tax: #{@tax.inspect}, tax_withheld:"\
+      " #{@tax_withheld.inspect}, transfer_fee: #{@transfer_fee.inspect}, trust_fee:"\
+      " #{@trust_fee.inspect}, unqualified_gain: #{@unqualified_gain.inspect}, withdrawal:"\
+      " #{@withdrawal.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/plaid/models/categories_get_response.rb

@@ -0,0 +1,93 @@
+# plaid
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Plaid
+  # CategoriesGetResponse defines the response schema for `/categories/get`
+  class CategoriesGetResponse < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # An array of all of the transaction categories used by Plaid.
+    # @return [Array[Category]]
+    attr_accessor :categories
+
+    # A unique identifier for the request, which can be used for
+    # troubleshooting. This identifier, like all Plaid identifiers, is case
+    # sensitive.
+    # @return [String]
+    attr_accessor :request_id
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['categories'] = 'categories'
+      @_hash['request_id'] = 'request_id'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(categories:, request_id:, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @categories = categories
+      @request_id = request_id
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      # Parameter is an array, so we need to iterate through it
+      categories = nil
+      unless hash['categories'].nil?
+        categories = []
+        hash['categories'].each do |structure|
+          categories << (Category.from_hash(structure) if structure)
+        end
+      end
+
+      categories = nil unless hash.key?('categories')
+      request_id = hash.key?('request_id') ? hash['request_id'] : nil
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      CategoriesGetResponse.new(categories: categories,
+                                request_id: request_id,
+                                additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} categories: #{@categories}, request_id: #{@request_id},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} categories: #{@categories.inspect}, request_id: #{@request_id.inspect},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/plaid/models/category.rb

@@ -0,0 +1,93 @@
+# plaid
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Plaid
+  # Information describing a transaction category
+  class Category < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # An identifying number for the category. `category_id` is a Plaid-specific
+    # identifier and does not necessarily correspond to merchant category codes.
+    # @return [String]
+    attr_accessor :category_id
+
+    # `place` for physical transactions or `special` for other transactions such
+    # as bank charges.
+    # @return [String]
+    attr_accessor :group
+
+    # A hierarchical array of the categories to which this `category_id`
+    # belongs.
+    # @return [Array[String]]
+    attr_accessor :hierarchy
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['category_id'] = 'category_id'
+      @_hash['group'] = 'group'
+      @_hash['hierarchy'] = 'hierarchy'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(category_id:, group:, hierarchy:, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @category_id = category_id
+      @group = group
+      @hierarchy = hierarchy
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      category_id = hash.key?('category_id') ? hash['category_id'] : nil
+      group = hash.key?('group') ? hash['group'] : nil
+      hierarchy = hash.key?('hierarchy') ? hash['hierarchy'] : nil
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      Category.new(category_id: category_id,
+                   group: group,
+                   hierarchy: hierarchy,
+                   additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} category_id: #{@category_id}, group: #{@group}, hierarchy: #{@hierarchy},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} category_id: #{@category_id.inspect}, group: #{@group.inspect}, hierarchy:"\
+      " #{@hierarchy.inspect}, additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/plaid/models/cause.rb

@@ -0,0 +1,88 @@
+# plaid
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Plaid
+  # An error object and associated `item_id` used to identify a specific Item
+  # and error when a batch operation operating on multiple Items has encountered
+  # an error in one of the Items.
+  class Cause < BaseModel
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # The `item_id` of the Item associated with this webhook, warning, or error
+    # @return [String]
+    attr_accessor :item_id
+
+    # We use standard HTTP response codes for success and failure notifications,
+    # and our errors are further classified by `error_type`. In general, 200
+    # HTTP codes correspond to success, 40X codes are for developer- or
+    # user-related failures, and 50X codes are for Plaid-related issues.  Error
+    # fields will be `null` if no error has occurred.
+    # @return [Error]
+    attr_accessor :error
+
+    # A mapping from model property names to API property names.
+    def self.names
+      @_hash = {} if @_hash.nil?
+      @_hash['item_id'] = 'item_id'
+      @_hash['error'] = 'error'
+      @_hash
+    end
+
+    # An array for optional fields
+    def self.optionals
+      []
+    end
+
+    # An array for nullable fields
+    def self.nullables
+      []
+    end
+
+    def initialize(item_id:, error:, additional_properties: nil)
+      # Add additional model properties to the instance
+      additional_properties = {} if additional_properties.nil?
+
+      @item_id = item_id
+      @error = error
+      @additional_properties = additional_properties
+    end
+
+    # Creates an instance of the object from a hash.
+    def self.from_hash(hash)
+      return nil unless hash
+
+      # Extract variables from the hash.
+      item_id = hash.key?('item_id') ? hash['item_id'] : nil
+      error = Error.from_hash(hash['error']) if hash['error']
+
+      # Create a new hash for additional properties, removing known properties.
+      new_hash = hash.reject { |k, _| names.value?(k) }
+
+      additional_properties = APIHelper.get_additional_properties(
+        new_hash, proc { |value| value }
+      )
+
+      # Create object from extracted values.
+      Cause.new(item_id: item_id,
+                error: error,
+                additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} item_id: #{@item_id}, error: #{@error}, additional_properties:"\
+      " #{@additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} item_id: #{@item_id.inspect}, error: #{@error.inspect},"\
+      " additional_properties: #{@additional_properties}>"
+    end
+  end
+end

data/lib/plaid/models/code.rb

@@ -0,0 +1,56 @@
+# plaid
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Plaid
+  # A code representing the rationale for permitting or declining the proposed
+  # transfer. Possible values are: `NSF` – Transaction likely to result in a
+  # return due to insufficient funds. `RISK` - Transaction is high-risk.
+  # `MANUALLY_VERIFIED_ITEM` – Item created via same-day micro deposits, limited
+  # information available. Plaid can only offer `permitted` as a transaction
+  # decision. `LOGIN_REQUIRED` – Unable to collect the account information
+  # required for an authorization decision due to Item staleness. Can be
+  # rectified using Link update mode. `ERROR` – Unable to collect the account
+  # information required for an authorization decision due to an error.
+  class Code
+    CODE = [
+      # TODO: Write general description for NSF
+      NSF = 'NSF'.freeze,
+
+      # TODO: Write general description for RISK
+      RISK = 'RISK'.freeze,
+
+      # TODO: Write general description for MANUALLY_VERIFIED_ITEM
+      MANUALLY_VERIFIED_ITEM = 'MANUALLY_VERIFIED_ITEM'.freeze,
+
+      # TODO: Write general description for LOGIN_REQUIRED
+      LOGIN_REQUIRED = 'LOGIN_REQUIRED'.freeze,
+
+      # TODO: Write general description for ERROR
+      ERROR = 'ERROR'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      true
+    end
+
+    def self.from_value(value, default_value = NSF)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'nsf' then NSF
+      when 'risk' then RISK
+      when 'manually_verified_item' then MANUALLY_VERIFIED_ITEM
+      when 'login_required' then LOGIN_REQUIRED
+      when 'error' then ERROR
+      else
+        default_value
+      end
+    end
+  end
+end

data/lib/plaid/models/confidence.rb

@@ -0,0 +1,45 @@
+# plaid
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module Plaid
+  # The confidence that Plaid can support the user in the income verification
+  # flow. One of the following: `"HIGH"`: This precheck information submitted is
+  # definitively tied to a Plaid-supported integration. "`LOW`": This precheck
+  # information submitted is known not to be supported by Plaid. `"UNKNOWN"`: It
+  # was not possible to determine if the user is supportable with the
+  # information passed.
+  class Confidence
+    CONFIDENCE = [
+      # TODO: Write general description for HIGH
+      HIGH = 'HIGH'.freeze,
+
+      # TODO: Write general description for LOW
+      LOW = 'LOW'.freeze,
+
+      # TODO: Write general description for UNKNOWN
+      UNKNOWN = 'UNKNOWN'.freeze
+    ].freeze
+
+    def self.validate(value)
+      return false if value.nil?
+
+      true
+    end
+
+    def self.from_value(value, default_value = HIGH)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'high' then HIGH
+      when 'low' then LOW
+      when 'unknown' then UNKNOWN
+      else
+        default_value
+      end
+    end
+  end
+end