addressfinder 1.6.2 → 1.8.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de05727d08ca624896115f6fe76ae68bb3dd36ed99195468153cf982c9af07a0
-  data.tar.gz: 30ba24d9f052a8884ec5772b8d0d492f1334636674ae29e265ddd3fb105d51dd
+  metadata.gz: 939c60d3f251b84c6fc378148d6d8d3480e2dcf2f171c27b7edef470d9b5a5b8
+  data.tar.gz: '07988c8cbbe65632d5551a11d9a02618360589c43ef2b3f3112159141b0a290d'
 SHA512:
-  metadata.gz: 160bee2722353ec131681b401a1ddb92748cb606b4e0bf5d1572a924becf1475a61431ef8382f39df9e361a4133d300714ec029033a631285f62f646c3428e17
-  data.tar.gz: e1d026848279132f2cd4b2e1ba35061adee84fcac56e89b54fc336b7caff2386e4123a9f5686ea0792dc371fd6a2ba6fa35195d8dfd28a858de43e376cc423f5
+  metadata.gz: 14d93058d16682693bf237678aed85bb496d71447ff16457c30a32785e2fde1ad263c0063eb3da5a54ce96df3d88733afcef9452eb97e9a0a3483a56cfc86083
+  data.tar.gz: 19825d8fefac06180ee9c8d7a62eb81ec1ee8a06b753272f2dace02620a6e07c231e062d2af4f39285baafae1b00c232fd5c8034332d5f522452dae10e842145

data/.travis.yml

@@ -1,6 +1,6 @@
 language: ruby
 rvm:
-  - 2.2.3
+  - 2.2.7
   - 2.3.1
   - 2.4.1
   - 2.6.3

data/CHANGELOG.md

@@ -1,3 +1,22 @@
+# AddressFinder 1.8.1 (October 2021) #
+
+* Prevent NZ bulk and verification calls from using V2 module
+
+# AddressFinder 1.8.0 (October 2021) #
+
+* Create a V2 Module for verification (Australia)
+* Remove PAF support from V1 verification API (Australia)
+* Include API version number in configuration
+
+# AddressFinder 1.7.1 (June 2, 2021) #
+
+* Add support for PAF verification
+* Rename cleanse to verification
+
+# AddressFinder 1.7.0 (May 4, 2020) #
+
+* Add support for Address Autocomplete API (Australia only)
+
 # AddressFinder 1.6.2 (September 23, 2019) #
 
 * Add support for an optional state_codes parameter in the Cleanse class

data/Dockerfile

@@ -0,0 +1,28 @@
+# Use the barebones version of Ruby 2.6.1
+FROM ruby:2.6
+
+# Install dependencies:
+# - build-essential: To ensure certain gems can be compiled
+# - nodejs: Compile assets
+# - bundler: ensure most recent version is installed
+RUN apt-get update && apt-get install -qq -y build-essential --fix-missing --no-install-recommends
+RUN gem install bundler
+
+# Set an environment variable to store where the app is installed to inside
+# of the Docker image.
+ENV LANG C.UTF-8
+ENV BUNDLE_PATH /bundle
+ENV INSTALL_PATH /addressfinder-ruby
+RUN mkdir -p $INSTALL_PATH
+
+# Create address verification directories
+RUN mkdir -p $INSTALL_PATH/verification/originals
+RUN mkdir -p $INSTALL_PATH/verification/verified
+
+# This sets the context of where commands will be ran in and is documented
+# on Docker's website extensively.
+WORKDIR $INSTALL_PATH
+
+ADD . $INSTALL_PATH
+
+RUN bundle install

data/Guardfile

@@ -1,4 +1,4 @@
-guard :rspec, cmd: 'rspec' do
+guard :rspec, cmd: 'bundle exec rspec' do
   watch(%r{^spec/.+_spec\.rb$})
   watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
   watch('spec/spec_helper.rb')  { "spec" }

data/LICENSE.md

@@ -0,0 +1,15 @@
+Copyright (c) 2015-present AddressFinder
+
+The intellectual property rights in this plugin are owned by AddressFinder Limited of Wellington New Zealand (referred to below as “we”, “us” or “our”) or its third party licensors.  The plugin may be accessed and used by AddressFinder customers only, subject to the following terms. If you are not, or are no longer, an AddressFinder customer you are not permitted to access or use the plugin in any way.
+
+If you are an AddressFinder customer (referred to below as “you” or “your”), the following terms apply in relation to your access and use of the plugin (and your access or use of the plugin confirms your acceptance of the following terms). If you do not accept the following terms you are not permitted to access or use the plugin in any way.
+* In these terms, “Terms and Conditions” means the applicable Terms and Conditions that you entered into, being either https://addressfinder.nz/legal/terms/ or https://addressfinder.com.au/legal/terms/, and “Services” and “Subscription Term” have the meaning given in the Terms and Conditions.
+* All rights, title and interest (including, without limitation, all intellectual property rights) in and to the plugin are owned by us or our third party licensors. Provided that you comply with these terms, and the Terms and Conditions, we grant you the right during your Subscription Term to: (a) access and use the plugin solely in connection with the Services and then only in combination with websites that you own or control; and (b) view the source code and configurations of the plugin solely for the purpose of evaluating the plugin in relation to its use in connection with the Services, and for no other purpose. This right is non-exclusive, non-transferable and may be revoked by us at any time. You are not granted any other rights or licences in relation to the plugin.
+* You must never copy, modify, publish, merge, distribute, resell, lease, transfer or sub-license, or create derivative works from, all or any part of the plugin. You must never access or use the plugin for any purpose related to building a product or service which competes with the Services or the plugin or has similar features or functionality. You must comply with all instructions or restrictions that we provide to you in relation to the plugin (including, without limitation, that we may post on this page from time to time).
+* The plugin is provided to you on an "as is" and "as available" basis and your use of it is at your sole risk. To the maximum extent permitted by law, we do not represent or warrant that the plugin will be secure, reliable, uninterrupted, always available, free of errors, omissions, inaccuracies, viruses or other destructive code, or that it will be fit for your purposes or for use in any specific technical environment or that any problems can or will be corrected. To the maximum extent permitted by law, we give no warranties in relation to the plugin. To avoid doubt, to the maximum extent permitted by law, we disclaim and exclude all implied representations, warranties and conditions (including any warranties of fitness for purpose, merchantability, title and non-infringement). Certain legislation may imply warranties or conditions, impose obligations or give statutory guarantees (together, Statutory Provisions) which cannot be excluded, restricted or modified except to a limited extent. These terms must be read subject to applicable Statutory Provisions. If the Statutory Provisions apply, notwithstanding any other provision of these terms, to the extent to which we are entitled to do so, we limit our liability in respect of any claim to: (a) in the case of goods, at our option: the replacement of the goods or the supply of equivalent goods; the repair of the goods; the payment of the cost of replacing the goods or acquiring equivalent goods; or the payment of having the goods repaired; and (b) in the case of services, at our option: the supply of the services again; or the payment of the cost of having the services supplied again. If you entered into our New Zealand Terms and Conditions, you represent to us that you are acquiring the right to use the plugin for the purposes of a business and so you agree that the provisions of the Consumer Guarantees Act 1993 do not apply to the plugin.
+* To the maximum extent permitted by law, we and Our Related Parties will not be liable to you or any third party for any loss or damage to data, breach of security, loss of profit, revenue, opportunity or saving, or any incidental, indirect, special or consequential loss or damage. To the maximum extent permitted by law, the total aggregate liability of us and Our Related Parties (together) to you under or in connection with these terms or its subject matter is limited to NZ$10. These limitations and exclusions of liability apply however liability arises, whether in contract, in tort (including negligence), for breach of statutory duty or otherwise.  You fully indemnify us from and against any claim, proceeding, damage, loss, liability, cost or expense (including legal costs on a solicitor and own client basis) arising from or connected to your use of plugin or breach of these terms. In these terms “Our Related Parties” means AddressFinder Pty Limited, ACN 606 672 333, any related company of us or AddressFinder Pty Limited (where “related company” has the meaning given in section 2(3) of the Companies Act 1993, and includes any company or similar entity which would be a related company within that definition if incorporated as a company in New Zealand) and our suppliers, contractors, directors, employees and agents.
+* We may change these terms at any time by emailing you, by updating the Terms and Conditions and/or by displaying or referring to the replacement terms on this page.  Your continued use of the plugin after you receive notice of any such changes will amount to your acceptance of those changes. If you don’t accept those changes you must immediately stop using the plugin.
+* Any waiver of any part of these terms must be in writing and signed by one of our authorised representatives. Any delay or failure by us to exercise any right does not prevent us from exercising that right, or any other right, on that or any other occasion.
+* Any unlawful or unenforceable provision of these terms will be deemed to be amended to the minimum extent necessary to ensure that it is not unlawful or unenforceable and, as far as is possible, to ensure that it is consistent with the intent and effect of the provision.  The remaining provisions will be enforceable as if such unlawful or unenforceable provision had not been included in these terms.  If the provision is unable to be amended without materially altering the intent and effect of the provision, it will be severed, and the remaining provisions will be enforceable.
+* The terms are governed by the laws of New Zealand and you and we submit to the non-exclusive jurisdiction of the New Zealand courts.
+

data/README.md

@@ -1,7 +1,7 @@
 # AddressFinder Ruby Gem
 
 [![Gem Version](https://badge.fury.io/rb/addressfinder.svg)](http://badge.fury.io/rb/addressfinder)
-[![Build  Status](https://travis-ci.org/AbleTech/addressfinder-ruby.svg)](https://travis-ci.org/AbleTech/addressfinder-ruby)
+[![Build  Status](https://travis-ci.com/github/AddressFinder/addressfinder-ruby.svg)](https://travis-ci.com/github/AddressFinder/addressfinder-ruby)
 
 A client library for accessing the [AddressFinder](https://addressfinder.nz/?utm_source=github&utm_medium=readme&utm_campaign=addressfinder_rubygem&utm_term=AddressFinder) APIs.
 
@@ -31,6 +31,7 @@ AddressFinder.configure do |af|
 
   # Optional
   af.default_country = 'nz' # default: nz
+  af.verification_version = 'v2' # default: v1
   af.timeout = 10 # default: 10 seconds
   af.retries = 12 # default: 12
   af.retry_delay = 5 # default: 5 seconds
@@ -56,7 +57,7 @@ For available parameters and example responses, see the API documentation pages
 #### Address Verification
 
 ```ruby
-result = AddressFinder.cleanse(q: '186 Willis St, Wellington', country: 'nz')
+result = AddressFinder.verification(q: '186 Willis St, Wellington', country: 'nz')
 
 if result
   $stdout.puts "Success: #{result.postal}"
@@ -65,7 +66,14 @@ else
 end
 ```
 
-#### Address Autocomplete
+**Note:** The deprecated method `cleanse` is still available now but will be dropped in the future.
+
+#### Address Search
+
+The Address Search API supports the following address sets:
+
+* New Zealand addresses
+* Australian addresses from the GNAF dataset only
 
 ```ruby
 begin
@@ -81,6 +89,26 @@ rescue AddressFinder::RequestRejectedError => e
 end
 ```
 
+#### Address Autocomplete
+
+The Address Autocomplete API supports the following address sets:
+
+* Australian addresses from the GNAF and PAF datasets only
+
+```ruby
+begin
+  results = AddressFinder.address_autocomplete(q: '275 high st, bel', au_paf: '1')
+  if results.any?
+    $stdout.puts "Success: #{results}"
+  else
+    $stdout.puts "Sorry, there were no address matches"
+  end
+rescue AddressFinder::RequestRejectedError => e
+  response = JSON.parse(e.body)
+  $stdout.puts response['message']
+end
+```
+
 #### Address Metadata
 
 ```ruby
@@ -136,12 +164,12 @@ end
 If you have a series of API requests, you can use the
 bulk method to re-use the HTTP connection.
 
-**Note:** The bulk method is currently only available for Address Verification (`#cleanse`).
+**Note:** The bulk method is currently only available for Address Verification (`#verification`).
 
 ```ruby
 AddressFinder.bulk do |af|
   CSV.foreach('auckland_addresses.csv') do |row|
-    result = af.cleanse(q: row[0], region_code: '1')
+    result = af.verification(q: row[0], region_code: '1')
 
     if result
       $stdout.puts "Success: #{result.postal}"
@@ -171,3 +199,12 @@ rescue AddressFinder::RequestRejectedError => e
 end
 ```
 
+### Testing
+
+You can run all the specs with the following command:
+
+`docker-compose up`
+
+You can `guard` for repeating test runs (while editing new code):
+
+`docker-compose run ruby bundle exec guard`

data/addressfinder.gemspec

@@ -5,11 +5,11 @@ Gem::Specification.new do |gem|
   gem.name          = "addressfinder"
   gem.version       = AddressFinder::VERSION
   gem.licenses      = ['MIT']
-  gem.authors       = ["Nigel Ramsay", "Naiki Pohe", "Sean Arnold", "Alexandre Barret"]
-  gem.email         = ["nigel.ramsay@abletech.co.nz", "naiki.pohe@abletech.co.nz", "seanarnie@gmail.com", "alex@abletech.nz"]
+  gem.authors       = ["Nigel Ramsay", "Naiki Pohe", "Sean Arnold", "Alexandre Barret", "Cassandre Guinut"]
+  gem.email         = ["nigel.ramsay@addressfinder.nz", "naiki.pohe@abletech.co.nz", "seanarnie@gmail.com", "alex@abletech.nz", "cassandre.guinut@addressfinder.nz"]
   gem.description   = %q{Ruby client library for AddressFinder}
   gem.summary       = %q{Provides easy access to AddressFinder APIs}
-  gem.homepage      = "https://github.com/AbleTech/addressfinder-ruby"
+  gem.homepage      = "https://github.com/AddressFinder/addressfinder-ruby"
 
   gem.files         = `git ls-files`.split($/)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
@@ -20,7 +20,7 @@ Gem::Specification.new do |gem|
   gem.add_dependency 'multi_json', '~> 1.11'
   gem.add_development_dependency 'rspec', '~> 3.3'
   gem.add_development_dependency 'guard-rspec', '~> 4.6'
-  gem.add_development_dependency 'rake', '~> 10.4'
+  gem.add_development_dependency 'rake', '~> 13.0'
   gem.add_development_dependency 'webmock', '~> 1.21'
-  gem.add_development_dependency 'listen', '~> 3.0.0'
+  gem.add_development_dependency 'listen', '~> 3.2'
 end

data/docker-compose.yml

@@ -0,0 +1,11 @@
+version: '3'
+services:
+  ruby:
+    build: .
+    volumes:
+      - .:/addressfinder-ruby
+      - bundle-cache:/bundle
+    command: bundle exec rspec
+
+volumes:
+  bundle-cache: {}

data/lib/addressfinder/address_autocomplete.rb

@@ -0,0 +1,77 @@
+require 'ostruct'
+
+module AddressFinder
+  class AddressAutocomplete
+
+    attr_reader :results
+
+    def initialize(params:, http:)
+      @http = http
+      @country = params.delete(:country) || 'au'
+
+      @params = params
+      @params[:key] ||= config.api_key
+      @params[:secret] ||= config.api_secret
+    end
+
+    def perform
+      validate_params
+      build_request
+      execute_request
+      build_result
+
+      self
+    end
+
+    private
+
+    attr_reader :request_uri, :params, :country, :http
+    attr_accessor :response_body, :response_status
+    attr_writer :results
+
+    def validate_params
+      if country != 'au'
+        raise AddressFinder::RequestRejectedError.new("400", "#address_autocomplete only available for Australian addresses")
+      end
+    end
+
+    def build_request
+      @request_uri = "/api/au/address/autocomplete.json?#{encoded_params}"
+    end
+
+    def encoded_params
+      Util.encode_and_join_params(params)
+    end
+
+    def execute_request
+      request = Net::HTTP::Get.new(request_uri)
+
+      response = http.request(request)
+
+      self.response_body = response.body
+      self.response_status = response.code
+    end
+
+    def build_result
+      case response_status
+      when '200'
+        self.results = response_hash['completions'].map do |result_hash|
+          Result.new(result_hash)
+        end
+      else
+        raise AddressFinder::RequestRejectedError.new(@response_status, @response_body)
+      end
+    end
+
+    def response_hash
+      @_response_hash ||= MultiJson.load(response_body)
+    end
+
+    def config
+      @_config ||= AddressFinder.configuration
+    end
+
+    class Result < OpenStruct
+    end
+  end
+end

data/lib/addressfinder/bulk.rb

@@ -1,32 +1,44 @@
 module AddressFinder
   class Bulk
-    def initialize(http:, &block)
+    def initialize(http:, verification_version:, default_country:, &block)
       @block = block
+      @verification_version = verification_version
+      @default_country = default_country
       @http_config = http
     end
 
     def perform
       http_config.start do |http|
-        block.call ClientProxy.new(http: http)
+        block.call ClientProxy.new(http: http, verification_version: verification_version, default_country: default_country)
       end
     end
 
     private
 
-    attr_reader :block, :http_config
+    attr_reader :block, :verification_version, :default_country, :http_config
 
     class ClientProxy
-      def initialize(http:)
+      def initialize(http:, verification_version:, default_country:)
+        @verification_version = verification_version
+        @default_country = default_country
         @http = http
       end
 
       def cleanse(args={})
-        AddressFinder::Cleanse.new(args.merge(http: http)).perform.result
+        AddressFinder::Verification.new(args.merge(http: http)).perform.result
+      end
+
+      def verification(args={})
+        if verification_version&.downcase == "v2" && (args[:country] || default_country) == 'au'
+          AddressFinder::V2::Au::Verification.new(args.merge(http: http)).perform.result
+        else
+          AddressFinder::Verification.new(args.merge(http: http)).perform.result
+        end
       end
 
       private
 
-      attr_reader :http
+      attr_reader :http, :verification_version, :default_country
     end
   end
 end

data/lib/addressfinder/configuration.rb

@@ -2,6 +2,7 @@ module AddressFinder
   class Configuration
     attr_accessor :api_key
     attr_accessor :api_secret
+    attr_accessor :verification_version
     attr_accessor :hostname
     attr_accessor :port
     attr_accessor :proxy_host
@@ -21,6 +22,7 @@ module AddressFinder
       self.retries = 12
       self.retry_delay = 5
       self.default_country = 'nz'
+      self.verification_version = 'v1'
     end
   end
 end

data/lib/addressfinder/v2/au/verification.rb

@@ -0,0 +1,96 @@
+require 'ostruct'
+
+module AddressFinder
+  module V2
+    module Au
+      class Verification
+
+        attr_reader :result
+
+        # V2 AU expected attributes:
+        # params[:q] --> the address query,
+        # params[:post_box] --> nil or '0'
+        # params[:census] --> '2011' or '2016' or nil,
+        # params[:domain] --> used for reporting does not affect query results
+        # params[:key] --> unique AddressFinder public key
+        # params[:secret] --> unique AddressFinder secret key
+        # params[:paf] --> nil or '1',
+        # params[:gnaf] --> nil or '1',
+        # params[:gps] --> nil or '1',
+        # params[:extended] --> nil or '1',
+        # params[:state_codes] --> string or array of strings: i.e.,['ACT', 'NSW'],
+        def initialize(q:, post_box: nil, census: nil, domain: nil, key: nil, secret: nil, paf: nil, gnaf: nil, gps: nil, state_codes: nil, extended: nil, http:, country: nil)
+          @params = {}
+          @params['q'] = q
+          @params['post_box'] = post_box if post_box
+          @params['census'] = census if census
+          @params['domain'] = domain || config.domain if (domain || config.domain)
+          @params['key'] = key || config.api_key
+          @params['secret'] = secret || config.api_secret
+          @params['paf'] = paf if paf
+          @params['gnaf'] = gnaf if gnaf
+          @params['gps'] = gps if gps
+          @params['extended'] = extended if extended
+          @params['state_codes'] = state_codes if state_codes
+
+          @params['format'] = 'json'
+          @http = http
+        end
+
+        def perform
+          build_request
+          execute_request
+          build_result
+
+          self
+        end
+
+        private
+
+        attr_reader :request_uri, :params, :http
+        attr_accessor :response_body, :response_status
+        attr_writer :result
+
+        def build_request
+          @request_uri = "/api/au/address/v2/verification?#{encoded_params}"
+        end
+
+        def execute_request
+          request = Net::HTTP::Get.new(request_uri)
+
+          response = http.request(request)
+
+          self.response_body = response.body
+          self.response_status = response.code
+        end
+
+        def build_result
+          if response_status != '200'
+            raise AddressFinder::RequestRejectedError.new(@response_status, @response_body)
+          end
+
+          if response_hash['matched']
+            self.result = Result.new(response_hash['address'] || response_hash)
+          else
+            self.result = nil
+          end
+        end
+
+        def encoded_params
+          Util.encode_and_join_params(params)
+        end
+
+        def response_hash
+          @_response_hash ||= MultiJson.load(response_body)
+        end
+
+        def config
+          @_config ||= AddressFinder.configuration
+        end
+
+        class Result < OpenStruct
+        end
+      end
+    end
+end
+end

data/lib/addressfinder/{cleanse.rb → verification.rb}

@@ -1,24 +1,44 @@
 require 'ostruct'
 
 module AddressFinder
-  class Cleanse
+  class Verification
 
     attr_reader :result
 
-    def initialize(q:, country: nil, delivered: nil, post_box: nil, rural: nil, region_code: nil, state_codes: nil, census: nil, domain: nil, key: nil, secret: nil, http:)
+    # AU V1 expected attributes:
+    # params[:state_codes] --> string or array of strings: i.e.,['ACT', 'NSW'],
+    # params[:census] --> '2011' or '2016' or nil,
+
+    # NZ expected attributes:
+    # params[:delivered] --> '0', '1', or nil,
+    # params[:post_box] --> '0', '1', or nil,
+    # params[:rural] --> '0', '1', or nil,
+    # params[:region_code] --> string, see options on addressfinder.nz or nil,
+    # params[:census] --> '2013', '2018' or nil
+
+    # Combined attributes
+    # params[:q] --> the address query,
+    # params[:domain] --> used for reporting does not affect query results
+    # params[:key] --> unique AddressFinder public key
+    # params[:secret] --> unique AddressFinder secret key
+    def initialize(q:, post_box: nil, census: nil, domain: nil, key: nil, secret: nil, state_codes: nil, delivered: nil, rural: nil, region_code: nil, country: nil, http:)
       @params = {}
+      # Common to AU and NZ
       @params['q'] = q
-      @params['delivered'] = delivered if delivered
       @params['post_box'] = post_box if post_box
-      @params['rural'] = rural if rural
-      @params['region_code'] = region_code if region_code
-      @params['state_codes'] = state_codes if state_codes
       @params['census'] = census if census
       @params['domain'] = domain || config.domain if (domain || config.domain)
-      @params['format'] = 'json'
       @params['key'] = key || config.api_key
       @params['secret'] = secret || config.api_secret
+      # AU params
+      @params['state_codes'] = state_codes if state_codes
+      # NZ params
+      @params['delivered'] = delivered if delivered
+      @params['rural'] = rural if rural
+      @params['region_code'] = region_code if region_code
       @country = country || config.default_country
+
+      @params['format'] = 'json'
       @http = http
     end
 
@@ -37,7 +57,7 @@ module AddressFinder
     attr_writer :result
 
     def build_request
-      @request_uri = "/api/#{country}/address/cleanse?#{encoded_params}"
+      @request_uri = "/api/#{country}/address/verification?#{encoded_params}"
     end
 
     def execute_request

data/lib/addressfinder/version.rb

@@ -1,3 +1,3 @@
 module AddressFinder
-  VERSION = '1.6.2'
+  VERSION = '1.8.1'
 end

data/lib/addressfinder.rb

@@ -1,11 +1,13 @@
 require 'multi_json'
 require 'addressfinder/version'
 require 'addressfinder/configuration'
-require 'addressfinder/cleanse'
+require 'addressfinder/verification'
+require 'addressfinder/v2/au/verification'
 require 'addressfinder/location_info'
 require 'addressfinder/location_search'
 require 'addressfinder/address_info'
 require 'addressfinder/address_search'
+require 'addressfinder/address_autocomplete'
 require 'addressfinder/bulk'
 require 'addressfinder/errors'
 require 'addressfinder/util'
@@ -27,8 +29,16 @@ module AddressFinder
       @configuration ||= AddressFinder::Configuration.new
     end
 
-    def cleanse(args={})
-      AddressFinder::Cleanse.new(args.merge(http: AddressFinder::HTTP.new(configuration))).perform.result
+    def cleanse(args={}) # We are keeping this method for backward compatibility
+      AddressFinder::Verification.new(args.merge(http: AddressFinder::HTTP.new(configuration))).perform.result
+    end
+
+    def verification(args={})
+      if (args[:country] || configuration.default_country) == 'au' && configuration.verification_version&.downcase == "v2"
+        AddressFinder::V2::Au::Verification.new(args.merge(http: AddressFinder::HTTP.new(configuration))).perform.result
+      else
+        AddressFinder::Verification.new(args.merge(http: AddressFinder::HTTP.new(configuration))).perform.result
+      end
     end
 
     def location_search(args={})
@@ -43,12 +53,16 @@ module AddressFinder
       AddressFinder::AddressSearch.new(params: args, http: AddressFinder::HTTP.new(configuration)).perform.results
     end
 
+    def address_autocomplete(args={})
+      AddressFinder::AddressAutocomplete.new(params: args, http: AddressFinder::HTTP.new(configuration)).perform.results
+    end
+
     def address_info(args={})
       AddressFinder::AddressInfo.new(params: args, http: AddressFinder::HTTP.new(configuration)).perform.result
     end
 
     def bulk(&block)
-      AddressFinder::Bulk.new(http: AddressFinder::HTTP.new(configuration), &block).perform
+      AddressFinder::Bulk.new(http: AddressFinder::HTTP.new(configuration), verification_version: configuration.verification_version, default_country: configuration.default_country, &block).perform
     end
   end
 end