vng 0.1.0 → 0.1.13

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5db1598d18b48ee1c31a7e367c907bc8ba6c224623dc0590d573889812f27322
-  data.tar.gz: 3384c1b42509e05a31c85b5335792c9796a9e20bb4985a0ecb0879d7c8f031c5
+  metadata.gz: 3cff4f73336138d9e2386b1273fd4e398c8d3e8e9c52fb60ba4f47fb7b98e3bf
+  data.tar.gz: 6dbfa0fdad71e5fe35b113071e451a27e0150cde5ccffc7bc0676f191d433486
 SHA512:
-  metadata.gz: c9b6bdd93b8627c1512915dd353a08485047356a7cb7835c7a55dc587ce6eb27193fb4404dad08918e5e291cf22cd1380acf6544279a198eb593305232501f80
-  data.tar.gz: 115ff16da1a5d29c4fb3a39404da2123332021df2d8bc1b809ce42126483010c4215c1030d1361120bea9943ee0c4e96eca8f0175f3b09e3b95f001d73bc8260
+  metadata.gz: d76586e4271dc06bfe12ab3784f9534373f82e1953084c012ca79522ffbad4744486f55f66076b735bcafe7bddddc1465ef624f2af001aa0c183106a4403f0c4
+  data.tar.gz: 5bb9df92265cf90e2e10a88efc2e5cbd4de6d0b4e80e38dc2faf597780ea9b759e951fe331ae453db38253df4c93a58bd04d8a6c299318f475a5c04f6b5d08c1

data/CHANGELOG.md

@@ -1,5 +1,57 @@
 ## [Unreleased]
 
+## [0.1.13] - 2024-11-15
+
+- Enable Vng.configuration.security_token
+
+## [0.1.12] - 2024-11-15
+
+- Adds ServiceType.where(zip:)
+
+## [0.1.11] - 2024-11-15
+
+- Adds Zip
+
+## [0.1.10] - 2024-11-14
+
+- Adds Service Type
+
+## [0.1.9] - 2024-11-13
+
+- Adds Franchise
+
+## [0.1.8] - 2024-11-13
+
+- Adds Security Token
+
+## [0.1.7] - 2024-11-12
+
+- Adds Case
+
+## [0.1.6] - 2024-11-12
+
+- Adds WorkOrder
+
+## [0.1.5] - 2024-11-11
+
+- Adds Availability
+
+## [0.1.4] - 2024-11-11
+
+- Adds Price Item
+
+## [0.1.3] - 2024-11-10
+
+- Adds Location
+
+## [0.1.2] - 2024-11-10
+
+- Adds Breed
+
+## [0.1.1] - 2024-11-10
+
+- Adds Lead.create, Lead#destroy, Contact.create, Contact#destroy
+
 ## [0.1.0] - 2024-11-10
 
 - Initial release

data/README.md

@@ -1,3 +1,115 @@
-# Vng
+Vng - a Ruby client for the Vonigo API
+======================================================
 
-A Ruby API Client for the Vonigo API
+Vng helps you write apps that need to interact with Vonigo.
+
+The **source code** is available on [GitHub](https://github.com/HouseAccountEng/vng) and the **documentation** on [RubyDoc](http://www.rubydoc.info/gems/vng/frames).
+
+After [registering your app](#configuring-your-app), you can run commands like:
+
+```ruby
+Vng::Zip.all
+Vng::Franchise.all
+Vng::ServiceType.where zip:
+Vng::SecurityToken.create host:, usename:, password:
+Vng::Lead.create email:, phone:, name: full_name
+Vng::Contact.create first_name:, last_name:, email:, phone:, client_id:
+Vng::Location.create address:, city:, zip:, state: state, client_id:
+Vng::Breed.all
+Vng::Asset.create name:, weight:, breed_option_id:, client_id:
+Vng::PriceItem.where location_id:, asset_id:
+Vng::Availability.where(location_id:, duration:, from_time:, to_time:
+Vng::Lock.create date:, duration: location_id: 
+Vng::WorkOrder.create lock_id:, client_id:, contact_id:, location_id:, duration:, summary:, line_items:
+Vng::Case.create client_id:, summary:, comments:
+```
+
+The **full documentation** is available at [rubydoc.info](http://www.rubydoc.info/gems/vng/frames).
+
+How to install
+==============
+
+To install on your system, run
+
+    gem install vng
+
+To use inside a bundled Ruby project, add this line to the Gemfile:
+
+    gem 'vng', '~> 0.1.13'
+
+Since the gem follows [Semantic Versioning](http://semver.org),
+indicating the full version in your Gemfile (~> *major*.*minor*.*patch*)
+guarantees that your project won’t occur in any error when you `bundle update`
+and a new version of Vng is released.
+
+Available resources
+===================
+
+Vng::Zip
+-------
+
+TODO
+
+
+Configuring your app
+====================
+
+In order to use Vng you must have credentials to the [Vonigo](https://www.vonigo.com/) API.
+
+Add them to your code with the following snippet of code (replacing with your own credentials):
+
+```ruby
+Vng.configure do |config|
+  config.host = 'subdomain.vonigo.com'
+  config.username = 'VonigoUser'
+  config.password = 'VonigoPassword'
+end
+```
+
+Configuring with environment variables
+--------------------------------------
+
+As an alternative to the approach above, you can configure your app with
+variables. Setting the following environment variables:
+
+```bash
+export VNG_HOST="subdomain.vonigo.com"
+export VNG_USERNAME="VonigoUser"
+export VNG_PASSWORD="VonigoPassword"
+```
+
+is equivalent to the previous approach so pick the one you prefer.
+If a variable is set in both places, then `Vng.configure` takes precedence.
+
+How to test
+===========
+
+To run tests:
+
+```bash
+rspec
+```
+
+How to release new versions
+===========================
+
+If you are a manager of this project, remember to upgrade the [Vng gem](http://rubygems.org/gems/vng)
+whenever a new feature is added or a bug gets fixed.
+Make sure all the tests are passing ,
+document the changes in CHANGELOG.md and README.md, bump the version, then run
+
+    rake release
+
+Remember that the vng gem follows [Semantic Versioning](http://semver.org).
+Any new release that is fully backward-compatible should bump the *patch* version (0.0.x).
+Any new version that breaks compatibility should bump the *minor* version (0.x.0)
+
+How to contribute
+=================
+
+Vng needs your support!
+The goal of Vng is to provide a Ruby interface for all the methods exposed by the Vonigo API.
+
+If you find that a method is missing, fork the project, add the missing code,
+write the appropriate tests, then submit a pull request, and it will gladly
+be merged!

data/Rakefile

@@ -1,7 +1,5 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rspec/core/rake_task"
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
 
 RSpec::Core::RakeTask.new(:spec)
 

data/lib/vng/asset.rb

@@ -0,0 +1,62 @@
+module Vng
+  # Provides methods to interact with Vonigo assets.
+  class Asset
+    attr_reader :id
+
+    def initialize(id:)
+      @id = id
+    end
+
+    def self.create(name:, weight:, breed_option_id:, client_id:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '3',
+        clientID: client_id,
+        Fields: [
+           {fieldID: 1013, fieldValue: name},
+           {fieldID: 1017, fieldValue: weight},
+           {fieldID: 1014, optionID: breed_option_id},
+        ]
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Assets/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      # curl = 'curl'.tap do |curl|
+      #   curl <<  ' -X POST'
+      #   request.each_header{|k, v| curl << %Q{ -H "#{k}: #{v}"}}
+      #   curl << %Q{ -d '#{request.body}'} if request.body
+      #   curl << %Q{ "#{uri.to_s}"}
+      # end
+      # puts curl
+
+      new id: JSON(response.body)['Asset']['objectID']
+    end
+
+    def destroy
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '4',
+        objectID: id,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Assets/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+    end
+  end
+end
+

data/lib/vng/availability.rb

@@ -0,0 +1,42 @@
+module Vng
+  # Provides methods to interact with Vonigo availabilities.
+  class Availability
+    attr_reader :route_id, :date, :minutes
+
+    def initialize(route_id:, date:, minutes:)
+      @route_id = route_id
+      @date = date
+      @minutes = minutes
+    end
+
+    def self.where(location_id:, duration:, from_time:, to_time:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '0',
+        serviceTypeID: '14', # only return items of serviceType 'Pet Grooming'
+        locationID: location_id,
+        duration: duration.to_i,
+        dateStart: from_time.to_i,
+        dateEnd: to_time.to_i,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/availability/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      JSON(response.body)['Availability'].map do |body|
+        route_id = body['routeID']
+        date = Date.strptime body['dayID'], '%Y%m%d'
+        minutes = body['startTime'].to_i
+
+        new route_id: route_id, date: date, minutes: minutes
+      end
+    end
+  end
+end

data/lib/vng/breed.rb

@@ -0,0 +1,43 @@
+module Vng
+  # Provides methods to interact with Vonigo breeds.
+  class Breed
+    attr_reader :id, :name, :species, :option_id, :low_weight, :high_weight
+
+    def initialize(id:, name:, species:, option_id:, low_weight:, high_weight:)
+      @id = id
+      @name = name
+      @species = species
+      @option_id = option_id
+      @low_weight = low_weight
+      @high_weight = high_weight
+    end
+
+    # TODO: Needs pagination
+    def self.all
+      body = {
+        securityToken: Vng.configuration.security_token,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/breeds/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      JSON(response.body)['Breeds'].map do |body|
+        id = body['breedID']
+        name = body['breed']
+        species = body['species']
+        option_id = body['optionID']
+        low_weight = body['breedLowWeight']
+        high_weight = body['breedHighWeight']
+
+        new id: id, name: name, species: species, option_id: option_id, low_weight: low_weight, high_weight: high_weight
+      end
+    end
+  end
+end

data/lib/vng/case.rb

@@ -0,0 +1,54 @@
+module Vng
+  # Provides methods to interact with Vonigo cases.
+  class Case
+    attr_reader :id
+
+    def initialize(id:)
+      @id = id
+    end
+
+    def self.create(client_id:, summary:, comments:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '3',
+        objectID: client_id,
+        Fields: [
+           {fieldID: 219, optionID: 239}, # Status: open
+           {fieldID: 220, fieldValue: summary},
+           {fieldID: 230, fieldValue: comments},
+        ]
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Cases/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      new id: JSON(response.body)['Case']['objectID']
+    end
+
+    def destroy
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '4',
+        objectID: id,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Cases/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+    end
+  end
+end
+

data/lib/vng/config.rb

@@ -0,0 +1,45 @@
+require 'vng/configuration'
+
+# An object-oriented Ruby client for Voonigo.
+# @see http://www.rubydoc.info/gems/vng/
+module Vng
+  # Provides methods to read and write global configuration settings.
+  #
+  # A typical usage is to set the Security Token for the API calls.
+  #
+  # @example Set the Security Token for the API client:
+  #   Vng.configure do |config|
+  #     config.security_token = 'ABCDEFGHIJ1234567890'
+  #   end
+  #
+  module Config
+    # Yields the global configuration to the given block.
+    #
+    # @example
+    #   Vng.configure do |config|
+    #     config.security_token = 'ABCDEFGHIJ1234567890'
+    #   end
+    #
+    # @yield [Vng::Models::Configuration] The global configuration.
+    def configure
+      yield configuration if block_given?
+    end
+
+    # Returns the global {Vng::Models::Configuration} object.
+    #
+    # While this method _can_ be used to read and write configuration settings,
+    # it is easier to use {Vng::Config#configure} Vng.configure}.
+    #
+    # @example
+    #     Vng.configuration.security_token = 'ABCDEFGHIJ1234567890'
+    #
+    # @return [Vng::Models::Configuration] The global configuration.
+    def configuration
+      @configuration ||= Vng::Configuration.new
+    end
+  end
+
+  # @note Config is the only module auto-loaded in the Vng module,
+  #       in order to have a syntax as easy as Vng.configure
+  extend Config
+end

data/lib/vng/configuration.rb

@@ -0,0 +1,51 @@
+module Vng
+  # Provides an object to store global configuration settings.
+  #
+  # This class is typically not used directly, but by calling
+  # {Vng::Config#configure Vng.configure}, which creates and updates a single
+  # instance of {Vng::Models::Configuration}.
+  #
+  # @example Set the Security Token for the API client:
+  #   Vng.configure do |config|
+  #     config.security_token = 'ABCDEFGHIJ1234567890'
+  #   end
+  #
+  # @see Vng::Config for more examples.
+  #
+  # An alternative way to set global configuration settings is by storing
+  # them in the following environment variables:
+  #
+  # * +VNG_HOST+ to store the host for the Vonigo API
+  # * +VNG_USERNAME+ to store the username for the Vonigo API
+  # * +VNG_PASSWORD+ to store the password for the Vonigo API
+  #
+  # In case both methods are used together,
+  # {Vng::Config#configure Vng.configure} takes precedence.
+  #
+  # @example Set the API credentials
+  #   ENV['VNG_HOST'] = 'subdomain.vonigo.com'
+  #   ENV['VNG_USERNAME'] = 'VonigoUser'
+  #   ENV['VNG_Password'] = 'VonigoPassword'
+  #
+  class Configuration
+    # @return [String] the Security Token for the API calls.
+    attr_accessor :security_token
+
+    # @return [String] the URI host for the API calls.
+    attr_accessor :host
+
+    # @return [String] the username for the API calls.
+    attr_accessor :username
+
+    # @return [String] the password for the API calls.
+    attr_accessor :password
+
+    # Initialize the global configuration settings, using the values of
+    # the specified following environment variables by default.
+    def initialize
+      @host = ENV['VNG_HOST']
+      @username = ENV['VNG_USERNAME']
+      @password = ENV['VNG_PASSWORD']
+    end
+  end
+end

data/lib/vng/contact.rb

@@ -0,0 +1,67 @@
+module Vng
+  # Provides methods to interact with Vonigo contacts.
+  class Contact
+    attr_reader :id, :first_name, :last_name, :email, :phone
+
+    def initialize(id:, first_name:, last_name:, email:, phone:)
+      @id = id
+      @first_name = first_name
+      @last_name = last_name
+      @email = email
+      @phone = phone
+    end
+
+    def self.create(first_name:, last_name:, email:, phone:, client_id:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '3',
+        clientID: client_id,
+        Fields: [
+           {fieldID: 127, fieldValue: first_name},
+           {fieldID: 128, fieldValue: last_name},
+           {fieldID: 97, fieldValue: email},
+           {fieldID: 96, fieldValue: phone},
+        ]
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Contacts/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      body = JSON response.body
+
+      id = body['Contact']['objectID']
+      first_name = body['Fields'].find{|field| field['fieldID'] == 127}['fieldValue']
+      last_name = body['Fields'].find{|field| field['fieldID'] == 128}['fieldValue']
+      email = body['Fields'].find{|field| field['fieldID'] == 97}['fieldValue']
+      phone = body['Fields'].find{|field| field['fieldID'] == 96}['fieldValue']
+
+      new id: id, first_name: first_name, last_name: last_name, email: email, phone: phone
+    end
+
+    def destroy
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '4',
+        objectID: id,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Contacts/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+    end
+  end
+end
+

data/lib/vng/franchise.rb

@@ -0,0 +1,60 @@
+module Vng
+  # Provides methods to interact with Vonigo franchises.
+  class Franchise
+    attr_reader :id, :name, :gmt_offset
+
+    def initialize(id:, name: nil, gmt_offset: nil)
+      @id = id
+      @name = name
+      @gmt_offset = gmt_offset
+    end
+
+
+    def self.find_by(zip:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '1',
+        zip: zip,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/availability/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      franchise_id = JSON(response.body)['Ids']['franchiseID']
+      new(id: franchise_id) unless franchise_id == '0'
+    end
+
+    def self.all
+      body = {
+        securityToken: Vng.configuration.security_token,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/franchises/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      JSON(response.body)['Franchises'].filter do |body|
+        body['isActive']
+      end.map do |body|
+        id = body['franchiseID']
+        name = body['franchiseName']
+        gmt_offset = body['gmtOffsetFranchise']
+
+        new id: id, name: name, gmt_offset: gmt_offset
+      end
+    end
+  end
+end

data/lib/vng/lead.rb

@@ -0,0 +1,72 @@
+module Vng
+  # Provides methods to interact with Vonigo leads.
+  class Lead
+    attr_reader :id, :name, :email, :phone
+
+    def initialize(id:, name:, email:, phone:)
+      @id = id
+      @name = name
+      @email = email
+      @phone = phone
+    end
+
+    def self.create(name:, email:, phone:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '3',
+        Fields: [
+           {fieldID: 121, optionID: '59'},
+           {fieldID: 126, fieldValue: name},
+           {fieldID: 238, fieldValue: email},
+           {fieldID: 1024, fieldValue: phone},
+        ]
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Leads/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      body = JSON response.body
+
+      if body['errNo']
+        # 'errNo'=>-600,
+        # 'errMsg'=>'Data validation failed.',
+        # 'dateNow'=>'1731342482',
+        # 'Errors'=>[{"fieldID"=>1024, "fieldName"=>"Phone # to Reach You", "errNo"=>-602, "errMsg"=>"Field data is in incorrect format."}]}
+
+        # raise Vng::Error
+      end
+
+      id = body['Client']['objectID']
+      name = body['Fields'].find{|field| field['fieldID'] == 126}['fieldValue']
+      email = body['Fields'].find{|field| field['fieldID'] == 238}['fieldValue']
+      phone = body['Fields'].find{|field| field['fieldID'] == 1024}['fieldValue']
+
+      new id: id, name: name, email: email, phone: phone
+    end
+
+    def destroy
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '4',
+        objectID: id,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Leads/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+    end
+  end
+end

data/lib/vng/location.rb

@@ -0,0 +1,68 @@
+module Vng
+  # Provides methods to interact with Vonigo locations.
+  class Location
+    # TODO: fetch from /system/objects/ method: 1, objectID: 20
+    STATES_OPTION_ID = {
+      AK: 9879, AL: 9878, AR: 9877, AZ: 9880, CA: 9883, CO: 9876, CT: 9875,
+      DC: 9874, DE: 9873, FL: 9872, GA: 9871, HI: 9870, IA: 9869, ID: 9868,
+      IL: 9867, IN: 9866, KS: 9865, KY: 9864, LA: 9863, MA: 9862, MD: 9861,
+      ME: 9860, MI: 9859, MN: 9858, MO: 9857, MS: 9856, MT: 9855, NC: 9854,
+      ND: 9853, NE: 9852, NH: 9851, NJ: 9850, NM: 9849, NV: 9829, NY: 9848,
+      OH: 9847, OK: 9846, OR: 9881, PA: 9845, RI: 9843, SC: 9841, SD: 9842,
+      TN: 9840, TX: 9839, UT: 9838, VA: 9837, VT: 9836, WA: 9882, WI: 9828,
+      WV: 9835, WY: 9834,
+    }
+
+    attr_reader :id
+
+    def initialize(id:)
+      @id = id
+    end
+
+    def self.create(address:, city:, zip:, state:, client_id:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '3',
+        clientID: client_id,
+        Fields: [
+           {fieldID: 779, optionID: 9906}, # 'USA'
+           {fieldID: 778, optionID: STATES_OPTION_ID[state.to_sym]},
+           {fieldID: 776, fieldValue: city},
+           {fieldID: 773, fieldValue: address},
+           {fieldID: 775, fieldValue: zip},
+        ]
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Locations/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      new id: JSON(response.body)['Location']['objectID']
+    end
+
+    def destroy
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '4',
+        objectID: id,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/Locations/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+    end
+  end
+end
+

data/lib/vng/lock.rb

@@ -0,0 +1,54 @@
+module Vng
+  # Provides methods to interact with Vonigo locks.
+  class Lock
+    attr_reader :id
+
+    def initialize(id:)
+      @id = id
+    end
+
+    def self.create(duration:, location_id:, date:, minutes:, route_id:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '2',
+        serviceTypeID: '14', # only create items of serviceType 'Pet Grooming'
+        duration: duration.to_i,
+        locationID: location_id,
+        dayID: date.strftime('%Y%m%d'),
+        routeID: route_id,
+        startTime: minutes,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/availability/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      id = JSON(response.body)['Ids']['lockID']
+      new id: id
+    end
+
+    def destroy
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '4',
+        objectID: id,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/availability/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+    end
+  end
+end

data/lib/vng/price_item.rb

@@ -0,0 +1,51 @@
+module Vng
+  # Provides methods to interact with Vonigo price items.
+  class PriceItem
+    attr_reader :id, :price_item, :value, :tax_id, :duration_per_unit, :service_badge, :service_category
+
+    def initialize(id:, price_item:, value:, tax_id:, duration_per_unit:, service_badge:, service_category:)
+      @id = id
+      @price_item = price_item
+      @value = value
+      @tax_id = tax_id
+      @duration_per_unit = duration_per_unit
+      @service_badge = service_badge
+      @service_category = service_category
+    end
+
+    def self.where(location_id:, asset_id:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '2',
+        serviceTypeID: '14', # only return items of serviceType 'Pet Grooming'
+        locationID: location_id,
+        assetID: asset_id,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/priceLists/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      JSON(response.body)['PriceItems'].filter do |body|
+        # TODO: body['serviceBadge'] != 'Not Offered'
+        body['isOnline'] && body['isActive']
+      end.map do |body|
+        id = body['priceItemID']
+        price_item = body['priceItem']
+        value = body['value']
+        tax_id = body['taxID']
+        duration_per_unit = body['durationPerUnit']
+        service_badge = body['serviceBadge']
+        service_category = body['serviceCategory']
+
+        new id: id, price_item: price_item, value: value, tax_id: tax_id, duration_per_unit: duration_per_unit, service_badge: service_badge, service_category: service_category
+      end
+    end
+  end
+end

data/lib/vng/security_token.rb

@@ -0,0 +1,51 @@
+module Vng
+  # Provides methods to interact with Vonigo work security tokens.
+  class SecurityToken
+    attr_reader :token
+
+    def initialize(token:, host:)
+      @token = token
+      @host = host
+    end
+
+    def self.create(host:, username:, password:)
+      body = {
+        app_version: '1',
+        company: 'Vonigo',
+        host: host,
+        password: Digest::MD5.hexdigest(password),
+        username: username,
+      }
+
+      uri = URI::HTTPS.build host: host, path: '/api/v1/security/login/'
+
+      request = Net::HTTP::Get.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json; charset=utf-8'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      token = JSON(response.body)['securityToken']
+
+      new token: token, host: host
+    end
+
+    def destroy
+      body = {
+        securityToken: @token,
+      }
+
+      uri = URI::HTTPS.build host: @host, path: '/api/v1/security/login/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+    end
+  end
+end

data/lib/vng/service_type.rb

@@ -0,0 +1,64 @@
+module Vng
+  # Provides methods to interact with Vonigo service types.
+  class ServiceType
+    attr_reader :id, :type, :duration
+
+    def initialize(id:, type:, duration:)
+      @id = id
+      @type = type
+      @duration = duration
+    end
+
+    # TODO: Needs pagination
+    def self.all
+      body = {
+        securityToken: Vng.configuration.security_token,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/serviceTypes/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      JSON(response.body)['ServiceTypes'].map do |body|
+        id = body['serviceTypeID']
+        type = body['serviceType']
+        duration = body['duration']
+
+        new id: id, type: type, duration: duration
+      end
+    end
+
+    def self.where(zip:)
+      body = {
+        securityToken: Vng.configuration.security_token,
+        zip: zip,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/serviceTypes/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      JSON(response.body)['ServiceTypes'].filter do |body|
+        body['isActive']
+      end.map do |body|
+        id = body['serviceTypeID']
+        type = body['serviceType']
+        duration = body['duration']
+
+        new id: id, type: type, duration: duration
+      end
+    end
+  end
+end

data/lib/vng/version.rb

@@ -1,5 +1,3 @@
-# frozen_string_literal: true
-
 module Vng
-  VERSION = "0.1.0"
+  VERSION = '0.1.13'
 end

data/lib/vng/work_order.rb

@@ -0,0 +1,71 @@
+module Vng
+  # Provides methods to interact with Vonigo work orders.
+  class WorkOrder
+    attr_reader :id
+
+    def initialize(id:)
+      @id = id
+    end
+
+    def self.create(lock_id:, client_id:, contact_id:, location_id:, duration:, summary:, line_items:)
+      charges = line_items.map do |line_item|
+        {
+          priceItemID: line_item[:price_item_id],
+          taxID: line_item[:tax_id],
+          assetID: line_item[:asset_id],
+          Fields: [
+            {fieldID: 9289, fieldValue: line_item[:description]},
+            {fieldID: 9287, fieldValue: line_item[:price]}
+          ]
+        }
+      end
+
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '3',
+        serviceTypeID: '14', # only return items of serviceType 'Pet Grooming'
+        lockID: lock_id,
+        clientID: client_id,
+        contactID: contact_id,
+        locationID: location_id,
+        Fields: [
+          {fieldID: 200, fieldValue: summary},
+          {fieldID: 186, fieldValue: duration.to_i},
+          {fieldID: 201, optionID: '9537'} # label: Online Tentative
+        ],
+        Charges: charges
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/WorkOrders/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      id = JSON(response.body)['WorkOrder']['objectID']
+      new id: id
+    end
+
+    def destroy
+      body = {
+        securityToken: Vng.configuration.security_token,
+        method: '4',
+        objectID: id,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/data/WorkOrders/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+    end
+  end
+end

data/lib/vng/zip.rb

@@ -0,0 +1,37 @@
+module Vng
+  # Provides methods to interact with Vonigo ZIP codes.
+  class Zip
+    attr_reader :zip, :state, :zone_name
+
+    def initialize(zip:, state:, zone_name:)
+      @zip = zip
+      @state = state
+      @zone_name = zone_name
+    end
+
+    # TODO: Needs pagination
+    def self.all
+      body = {
+        securityToken: Vng.configuration.security_token,
+      }
+
+      uri = URI::HTTPS.build host: 'aussiepetmobileusatraining2.vonigo.com', path: '/api/v1/resources/zips/'
+
+      request = Net::HTTP::Post.new(uri.request_uri)
+      request.initialize_http_header 'Content-Type' => 'application/json'
+      request.body = body.to_json
+
+      response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+        http.request request
+      end
+
+      JSON(response.body)['Zips'].map do |body|
+        zip = body['zip']
+        state = body['state']
+        zone_name = body['zoneName']
+
+        new zip: zip, state: state, zone_name: zone_name
+      end
+    end
+  end
+end

data/lib/vng.rb

@@ -1,6 +1,25 @@
-# frozen_string_literal: true
+require 'date'
+require 'digest/md5'
+require 'json'
+require 'net/http'
+require 'uri'
 
-require_relative "vng/version"
+require_relative 'vng/asset'
+require_relative 'vng/availability'
+require_relative 'vng/breed'
+require_relative 'vng/case'
+require_relative 'vng/config'
+require_relative 'vng/contact'
+require_relative 'vng/franchise'
+require_relative 'vng/lead'
+require_relative 'vng/location'
+require_relative 'vng/lock'
+require_relative 'vng/price_item'
+require_relative 'vng/security_token'
+require_relative 'vng/service_type'
+require_relative 'vng/version'
+require_relative 'vng/work_order'
+require_relative 'vng/zip'
 
 module Vng
   class Error < StandardError; end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: vng
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.13
 platform: ruby
 authors:
 - claudiob
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2024-11-10 00:00:00.000000000 Z
-dependencies: []
+date: 2024-11-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A Ruby client for the Vonigo API.
 email:
 - claudiob@users.noreply.github.com
@@ -23,12 +37,28 @@ files:
 - README.md
 - Rakefile
 - lib/vng.rb
+- lib/vng/asset.rb
+- lib/vng/availability.rb
+- lib/vng/breed.rb
+- lib/vng/case.rb
+- lib/vng/config.rb
+- lib/vng/configuration.rb
+- lib/vng/contact.rb
+- lib/vng/franchise.rb
+- lib/vng/lead.rb
+- lib/vng/location.rb
+- lib/vng/lock.rb
+- lib/vng/price_item.rb
+- lib/vng/security_token.rb
+- lib/vng/service_type.rb
 - lib/vng/version.rb
-homepage: https://github.com/HouseAccountEng/vng
+- lib/vng/work_order.rb
+- lib/vng/zip.rb
+homepage: https://rubygems.org/gems/vng
 licenses:
 - MIT
 metadata:
-  homepage_uri: https://github.com/HouseAccountEng/vng
+  homepage_uri: https://rubygems.org/gems/vng
   source_code_uri: https://github.com/HouseAccountEng/vng
   changelog_uri: https://github.com/HouseAccountEng/vng/blob/main/CHANGELOG.md
 post_install_message: