booker_api 0.0.1

data/lib/booker/customer_client.rb

@@ -0,0 +1,17 @@
+module Booker
+  class CustomerClient < Client
+    include Booker::CustomerREST
+
+    def initialize(options={})
+      super
+      self.token_store ||= GenericTokenStore
+      self.token_store_callback_method ||= :update_booker_access_token!
+    end
+
+    def env_base_url_key; 'BOOKER_CUSTOMER_SERVICE_URL'; end
+
+    def default_base_url; 'https://apicurrent-app.booker.ninja/webservice4/json/CustomerService.svc'; end
+
+    def access_token_options; super.merge!(grant_type: 'client_credentials'); end
+  end
+end

data/lib/booker/customer_rest.rb

@@ -0,0 +1,169 @@
+module Booker
+  module CustomerREST
+    include CommonREST
+
+    def get_customer_appointments(customer_id, custom_access_token, options = {})
+      get "/customer/#{customer_id}/appointments", build_params(options, custom_access_token)
+    end
+    
+    def create_appointment(booker_location_id, start_time, treatment_ids, incomplete_appoinment_id, customer, credit_card, coupon_code = nil, notes = nil, custom_access_token = {}, options: {})
+      post "/appointment/create", build_params({
+        "LocationID" => booker_location_id,
+        "ItineraryTimeSlotList" => [
+          "StartDateTime" => start_time,
+          "TreatmentTimeSlots" => treatment_ids.map { |id|
+            {
+              "StartDateTime" => start_time,
+              "TreatmentID" => id
+            }
+          }
+        ],
+        "AppointmentPayment" => {
+          "PaymentItem" => {
+            "CreditCard" => credit_card,
+            "Method" => {
+              "ID" => 1
+            }
+          },
+          "CouponCode" => coupon_code
+        },
+        "Notes" => notes,
+        "IncompleteAppointmentID" => incomplete_appoinment_id,
+        "Customer" => customer
+      }, custom_access_token.merge(options)), Booker::Models::Appointment
+    end
+
+    def create_incomplete_appointment(booker_location_id, start_time, treatment_ids, options = {})
+      post '/appointment/createincomplete', build_params({
+        'LocationID' => booker_location_id,
+        'ItineraryTimeSlot' => {
+          'StartDateTime' => start_time,
+          'TreatmentTimeSlots' => treatment_ids.map { |id| { 'StartDateTime' => start_time, 'TreatmentID' => id } }
+        }
+      }, options)
+    end
+
+    def create_class_appointment(booker_location_id, class_instance_id, customer, options = {})
+      post '/class_appointment/create', build_params({
+            'LocationID' => booker_location_id,
+            'ClassInstanceID' => class_instance_id,
+            'Customer' => customer
+          }, options), Booker::Models::Appointment
+    end
+
+    def calculate_appointment_cost(booker_location_id, appointment_id, coupon_code, options = {})
+      post '/appointment/prebooking/totalcost', build_params({
+        'LocationID' => booker_location_id,
+        'AppointmentID' => appointment_id,
+        'CouponCode' => coupon_code,
+        'AppointmentDate' => DateTime.now,
+        'AppointmentTreatmentDTOs' => []
+      }, options)
+    end
+
+    def run_multi_spa_multi_sub_category_availability(booker_location_ids, treatment_sub_category_ids, start_date_time, end_date_time, options = {})
+      post '/availability/multispamultisubcategory', build_params({
+            'LocationIDs' => booker_location_ids,
+            'TreatmentSubCategoryIDs' => treatment_sub_category_ids,
+            'StartDateTime' => start_date_time,
+            'EndDateTime' => end_date_time,
+            'MaxTimesPerTreatment' => 1000
+          }, options), Booker::Models::SpaEmployeeAvailabilitySearchItem
+    end
+
+    def run_multi_service_availability(booker_location_id, treatment_ids, start_date_time, end_date_time, employee_id = nil, options = {})
+      treatment_ids = [treatment_ids] unless treatment_ids.respond_to?(:map)
+      post '/availability/multiservice', build_params(
+        {
+          'LocationID' => booker_location_id,
+          'StartDateTime' => start_date_time,
+          'EndDateTime' => end_date_time,
+          'MaxTimesPerDay' => 100,
+          'Itineraries' => treatment_ids.map { |id| { 'Treatments' => [{ 'TreatmentID' => id, 'EmployeeID' => employee_id }] } }
+        }, options
+      ), Booker::Models::MultiServiceAvailabilityResult
+    end
+
+    def run_class_availability(booker_location_id, from_start_date_time, to_start_date_time, options = {})
+      post '/availability/class', build_params({
+          'FromStartDateTime' => from_start_date_time,
+          'LocationID' => booker_location_id,
+          'OnlyIfAvailable' => true,
+          'ToStartDateTime' => to_start_date_time,
+          'ExcludeClosedDates' => true
+        }, options), Booker::Models::ClassInstance
+    end
+
+    def find_treatments(booker_location_id, category_id = nil)
+      post '/treatments', build_params({
+        'LocationID' => booker_location_id,
+        'CategoryID' => category_id
+      })
+    end
+
+    def get_treatment_categories(booker_location_id)
+      get '/treatment_categories', build_params({
+        'location_id' => booker_location_id
+      })
+    end
+
+    def get_locations
+      post '/locations', build_params
+    end
+    
+    def find_employees(booker_location_id)
+      post '/employees', build_params({
+        'LocationID' => booker_location_id
+      })
+    end
+
+    def get_customer(customer_id, custom_access_token, options = {})
+      get "/customer/#{customer_id}", build_params(options, custom_access_token)
+    end
+
+    def create_customer(booker_location_id, customer_data, options: {})
+      post '/customer/account', build_params({
+        'LocationID' => booker_location_id,
+        'Email' => customer_data[:email],
+        'Password' => customer_data[:password],
+        'FirstName' => customer_data[:first_name],
+        'LastName' => customer_data[:last_name],
+        'HomePhone' => customer_data[:HomePhone],
+        'CellPhone' => customer_data[:CellPhone],
+        'AllowReceiveEmails' => customer_data[:AllowReceiveEmails],
+        'AllowReceiveSMS' => customer_data[:AllowReceiveSMS]
+      }, options)
+    end
+
+    def update_customer(customer_id, customer_data, custom_access_token = {})
+      put "/customer/#{customer_id}", build_params(customer_data, custom_access_token)
+    end
+
+    def login(booker_location_id, email, password, options: {})
+      post '/customer/login', build_params({
+        'LocationID' => booker_location_id,
+        'Email' => email,
+        'Password' => password
+      }, options.merge({
+        client_id: self.client_id,
+        client_secret: self.client_secret
+      }))
+    end
+
+    def forgot_password(booker_location_id, email, first_name, base_url, options: {})
+      post '/forgot_password/custom', build_params({
+        'LocationID' => booker_location_id,
+        'Email' => email,
+        'Firstname' => first_name,
+        'BaseUrlOfHost' => base_url
+      }, options)
+    end
+
+    def reset_password(key, password, options: {})
+      post '/password/reset', build_params({
+        'Key' => key,
+        'Password' => password
+      }, options)
+    end
+  end
+end

data/lib/booker/errors.rb

@@ -0,0 +1,24 @@
+module Booker
+  class Error < StandardError
+    attr_accessor :error, :description, :url, :request, :response, :argument_errors
+
+    def initialize(url: nil, request: nil, response: nil)
+      if request.present?
+        self.request = request
+      end
+
+      if response.present?
+        self.response = response
+        error = response
+        error = response["Fault"]["Detail"]["InternalErrorFault"] if response["Fault"]
+        self.error = error['error'] || error['ErrorMessage']
+        self.description = error['error_description']
+        self.argument_errors = error["ArgumentErrors"].map { |a| { :attr => a["ArgumentName"], :message => a["ErrorMessage"] } } unless error["ArgumentErrors"].nil?
+      end
+
+      self.url = url
+    end
+  end
+
+  class InvalidApiCredentials < Error; end
+end

data/lib/booker/generic_token_store.rb

@@ -0,0 +1,25 @@
+module Booker
+  class GenericTokenStore
+    def self.temp_access_token
+      @temp_access_token
+    end
+
+    def self.temp_access_token=(token)
+      @temp_access_token = token
+    end
+
+    def self.temp_access_token_expires_at
+      @temp_access_token_expires_at
+    end
+
+    def self.temp_access_token_expires_at=(expires_at)
+      @temp_access_token_expires_at = expires_at
+    end
+
+    def self.update_booker_access_token!(token, expires_at)
+      self.temp_access_token = token
+      self.temp_access_token_expires_at = expires_at
+      true
+    end
+  end
+end

data/lib/booker/helpers/active_support_helper.rb

@@ -0,0 +1,102 @@
+module Booker
+  module Helpers
+    module ActiveSupport
+      BOOKER_TO_ACTIVE_SUPPORT_TIMEZONE = {
+          '(GMT-12:00) International Date Line West' => 'International Date Line West',
+          '(GMT-11:00) Midway Island, Samoa' => 'Samoa',
+          '(GMT-10:00) Hawaii' => 'Hawaii',
+          '(GMT-09:00) Alaska' => 'Alaska',
+          '(GMT-08:00) Tijuana, Baja California' => 'Tijuana',
+          '(GMT-08:00) Pacific Time (US & Canada)' => 'Pacific Time (US & Canada)',
+          '(GMT-07:00) Chihuahua, La Paz, Mazatlan - New' => 'Chihuahua',
+          '(GMT-07:00) Arizona' => 'Arizona',
+          '(GMT-07:00) Mountain Time (US & Canada)' => 'Mountain Time (US & Canada)',
+          '(GMT-07:00) Chihuahua, La Paz, Mazatlan - Old' => 'Chihuahua',
+          '(GMT-06:00) Guadalajara, Mexico City, Monterrey - New' => 'Guadalajara',
+          '(GMT-06:00) Central Time (US & Canada)' => 'Central Time (US & Canada)',
+          '(GMT-06:00) Central America' => 'Central America',
+          '(GMT-06:00) Guadalajara, Mexico City, Monterrey - Old' => 'Guadalajara',
+          '(GMT-06:00) Saskatchewan' => 'Saskatchewan',
+          '(GMT-05:00) Bogota, Lima, Quito, Rio Branco' => 'Bogota',
+          '(GMT-05:00) Indiana (East)' => 'Indiana (East)',
+          '(GMT-05:00) Eastern Time (US & Canada)' => 'Eastern Time (US & Canada)',
+          '(GMT-04:00) Santiago' => 'Santiago',
+          '(GMT-04:00) Caracas, La Paz' => 'Caracas',
+          '(GMT-04:00) Atlantic Time (Canada)' => 'Atlantic Time (Canada)',
+          '(GMT-04:00) Manaus' => 'Atlantic Time (Canada)',
+          '(GMT-03:30) Newfoundland' => 'Newfoundland',
+          '(GMT-03:00) Brasilia' => 'Brasilia',
+          '(GMT-03:00) Greenland' => 'Greenland',
+          '(GMT-03:00) Montevideo' => 'Montevideo',
+          '(GMT-03:00) Buenos Aires, Georgetown' => 'Buenos Aires',
+          '(GMT-02:00) Mid-Atlantic' => 'Mid-Atlantic',
+          '(GMT-01:00) Cape Verde Is.' => 'Cape Verde Is.',
+          '(GMT-01:00) Azores' => 'Azores',
+          '(GMT) Casablanca, Monrovia, Reykjavik' => 'Casablanca',
+          '(GMT) Greenwich Mean Time : Dublin, Edinburgh, Lisbon, London' => 'Dublin',
+          '(GMT+01:00) West Central Africa' => 'West Central Africa',
+          '(GMT+01:00) Sarajevo, Skopje, Warsaw, Zagreb' => 'Sarajevo',
+          '(GMT+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna' => 'Amsterdam',
+          '(GMT+01:00) Brussels, Copenhagen, Madrid, Paris' => 'Brussels',
+          '(GMT+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague' => 'Belgrade',
+          '(GMT+02:00) Windhoek' => 'Harare',
+          '(GMT+02:00) Jerusalem' => 'Jerusalem',
+          '(GMT+02:00) Amman' => 'Jerusalem',
+          '(GMT+02:00) Beirut' => 'Jerusalem',
+          '(GMT+02:00) Harare, Pretoria' => 'Harare',
+          '(GMT+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius' => 'Helsinki',
+          '(GMT+02:00) Cairo' => 'Cairo',
+          '(GMT+02:00) Minsk' => 'Minsk',
+          '(GMT+02:00) Athens, Bucharest, Istanbul' => 'Athens',
+          '(GMT+03:00) Moscow, St. Petersburg, Volgograd' => 'Moscow',
+          '(GMT+03:00) Nairobi' => 'Nairobi',
+          '(GMT+03:00) Kuwait, Riyadh' => 'Kuwait',
+          '(GMT+03:00) Tbilisi' => 'Tbilisi',
+          '(GMT+03:00) Baghdad' => 'Baghdad',
+          '(GMT+03:30) Tehran' => 'Tehran',
+          '(GMT+04:00) Caucasus Standard Time' => 'Yerevan',
+          '(GMT+04:00) Yerevan' => 'Yerevan',
+          '(GMT+04:00) Abu Dhabi, Muscat' => 'Abu Dhabi',
+          '(GMT+04:00) Baku' => 'Baku',
+          '(GMT+04:30) Kabul' => 'Kabul',
+          '(GMT+05:00) Ekaterinburg' => 'Ekaterinburg',
+          '(GMT+05:00) Islamabad, Karachi, Tashkent' => 'Islamabad',
+          '(GMT+05:30) Sri Jayawardenepura' => 'Sri Jayawardenepura',
+          '(GMT+05:30) Chennai, Kolkata, Mumbai, New Delhi' => 'Chennai',
+          '(GMT+05:45) Kathmandu' => 'Kathmandu',
+          '(GMT+06:00) Almaty, Novosibirsk' => 'Almaty',
+          '(GMT+06:00) Astana, Dhaka' => 'Astana',
+          '(GMT+06:30) Yangon (Rangoon)' => 'Rangoon',
+          '(GMT+07:00) Bangkok, Hanoi, Jakarta' => 'Bangkok',
+          '(GMT+07:00) Krasnoyarsk' => 'Krasnoyarsk',
+          '(GMT+08:00) Taipei' => 'Taipei',
+          '(GMT+08:00) Kuala Lumpur, Singapore' => 'Kuala Lumpur',
+          '(GMT+08:00) Irkutsk, Ulaan Bataar' => 'Irkutsk',
+          '(GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi' => 'Beijing',
+          '(GMT+08:00) Perth' => 'Perth',
+          '(GMT+09:00) Osaka, Sapporo, Tokyo' => 'Osaka',
+          '(GMT+09:00) Seoul' => 'Seoul',
+          '(GMT+09:00) Yakutsk' => 'Yakutsk',
+          '(GMT+09:30) Darwin' => 'Darwin',
+          '(GMT+09:30) Adelaide' => 'Adelaide',
+          '(GMT+10:00) Hobart' => 'Hobart',
+          '(GMT+10:00) Brisbane' => 'Brisbane',
+          '(GMT+10:00) Vladivostok' => 'Vladivostok',
+          '(GMT+10:00) Guam, Port Moresby' => 'Guam',
+          '(GMT+10:00) Canberra, Melbourne, Sydney' => 'Canberra',
+          '(GMT+11:00) Magadan, Solomon Is., New Caledonia' => 'Magadan',
+          '(GMT+12:00) Fiji, Kamchatka, Marshall Is.' => 'Fiji',
+          '(GMT+12:00) Auckland, Wellington' => 'Auckland',
+          "(GMT+13:00) Nuku'alofa" => "Nuku'alofa"
+      }.freeze
+
+      def self.to_active_support(booker_timezone_name)
+        BOOKER_TO_ACTIVE_SUPPORT_TIMEZONE[booker_timezone_name]
+      end
+
+      def self.booker_timezone_names
+        BOOKER_TO_ACTIVE_SUPPORT_TIMEZONE.keys
+      end
+    end
+  end
+end

data/lib/booker/helpers/logging_helper.rb

@@ -0,0 +1,11 @@
+module Booker
+  module Helpers
+    module LoggingHelper
+      def self.log_issue(message, extra_info = {})
+        if (log_message_block = Booker.config[:log_message])
+          log_message_block.call(message, extra_info)
+        end
+      end
+    end
+  end
+end

data/lib/booker/models/address.rb

@@ -0,0 +1,12 @@
+module Booker
+  module Models
+    class Address < Model
+      attr_accessor 'Street1',
+                    'Street2',
+                    'City',
+                    'State',
+                    'Zip',
+                    'Country'
+    end
+  end
+end

data/lib/booker/models/appointment.rb

@@ -0,0 +1,77 @@
+module Booker
+  module Models
+    class Appointment < Model
+      attr_accessor 'BookingNumber',
+        'Confirmable',
+        'EndDateTime',
+        'FinalTotal',
+        'ID',
+        'IsCancelled',
+        'IsNoShow',
+        'LocationID',
+        'StartDateTime',
+        'Status',
+        'CanTakePayment',
+        'DateCreated',
+        'BelongsToEnrollment',
+        'Address',
+        'AddressID',
+        'AllowAutoPay',
+        'AppointmentTreatments',
+        'BelongsToGroup',
+        'BelongsToGroupAndGroupOrder',
+        'BelongsToOrder',
+        'CanCancel',
+        'CanCheckin',
+        'CanHaveCustomer2',
+        'CanRevertNoShow',
+        'CanUndoCheckin',
+        'CancellationID',
+        'Customer',
+        'Customer2',
+        'Customer2ID',
+        'CustomerID',
+        'CustomerLastName',
+        'CustomerMobilePhone',
+        'CustomerWorkPhone',
+        'DateBooked',
+        'DateNoShow',
+        'Employee',
+        'EmployeeFirstName',
+        'EmployeeLastName',
+        'GroupID',
+        'GroupName',
+        'GroupNumber',
+        'GroupTypeID',
+        'IsCancelledOrNoShow',
+        'IsCheckedInInService',
+        'IsPartOfClassPackageBooking',
+        'IsPreBookedAtPastCheckout',
+        'IsRecurring',
+        'IsWebBooking',
+        'Notes',
+        'OrderID',
+        'OrderStatusID',
+        'PackageID',
+        'PaymentID',
+        'PaymentItemID',
+        'PrimaryAppointmentTreatmentID',
+        'RecurrenceID',
+        'Room',
+        'Source',
+        'Treatment',
+        'TreatmentName',
+        'Type',
+        'IsHeld',
+        'HoldForMinutes',
+        'HeldSince',
+        'IsServiceComplete',
+        'IsCheckout',
+        'DateCheckIn',
+        'IsFromWaitList',
+        'IsFromClassWaitList',
+        'CustomerRecordTypeID',
+        'CustomerParentID'
+    end
+  end
+end

data/lib/booker/models/appointment_treatment.rb

@@ -0,0 +1,51 @@
+module Booker
+  module Models
+    class AppointmentTreatment < Model
+      attr_accessor 'AppointmentID',
+        'DynamicPrice',
+        'EndDateTime',
+        'ID',
+        'StartDateTime',
+        'ChildID',
+        'ChildName',
+        'AllowChangeStartTime',
+        'DynamicPriceID',
+        'Employee',
+        'Employee2FullName',
+        'Employee2ID',
+        'EmployeeFirstName',
+        'EmployeeFullName',
+        'EmployeeID',
+        'EmployeeLastName',
+        'EmployeeRecoveryDuration',
+        'EmployeeTypeID',
+        'EmployeeWasRequested',
+        'FinishStartDateTime',
+        'FinishTimeAppliedToEmployee',
+        'FinishTimeAppliedToRoom',
+        'FinishTimeDuration',
+        'FinishTimeOriginalDuration',
+        'ProcessingStartDateTime',
+        'ProcessingTimeAppliedToRoom',
+        'ProcessingTimeAppliedToEmployee',
+        'ProcessingTimeDuration',
+        'ProcessingTimeOriginalDuration',
+        'RequiresProcessingTime',
+        'Room',
+        'RoomID',
+        'RoomName',
+        'RoomRecoveryDuration',
+        'StartTimeDuration',
+        'StartTimeOriginalDuration',
+        'TagPrice',
+        'Treatment',
+        'TreatmentDuration',
+        'TreatmentID',
+        'TreatmentIsForCouples',
+        'TreatmentName',
+        'ClassInstanceID',
+        'IsDurationOverridden'
+    end
+  end
+end
+