Phone normalization in Rails

business.rb

# app/models/business.rb
class Business < ApplicationRecord
  attribute :phone, PhoneType.new
end

Gemfile

gem "phonelib"

phone_lib.rb

# config/initializers/phone_lib.rb
Phonelib.default_country = "US"
Phonelib.extension_separate_symbols = ["x", ";"]

phone_type.rb

class PhoneType < ActiveRecord::Type::String

  # store values in DB using the E.164 standard
  #
  # Examples:
  #   US: +15012223333
  #   US w/ extension: +15012223333;44
  #   International: +447911123456
  #
  def serialize(value)
    if value.present?
      parsed_phone = Phonelib.parse(value)
      return super(value.to_s.strip.presence) unless parsed_phone.valid?

      super(parsed_phone.full_e164)
    else
      super(nil)
    end
  end

  # format values to human readable
  #
  # Examples:
  #   US: (501) 222-3333
  #   US w/ extension: (501) 222-3333 x44
  #   International: +44 791 112 3456
  #
  def deserialize(value)
    parsed_phone = Phonelib.parse(value)
    return value unless parsed_phone.valid?

    formatted_phone =
      if parsed_phone.country == "US"
        parsed_phone.full_national
      else
        parsed_phone.full_international
      end

    # format E.164 extension separator as friendlier "x123"
    formatted_phone.gsub!(";", " x")
    formatted_phone
  end

end