ev-recharge-sdk 1.3.0 → 2.0.0

data/lib/shell_ev/exceptions/v2_charge_session_retrieve404_error_exception.rb

@@ -0,0 +1,67 @@
+# shell_ev
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ShellEv
+  # V2 Charge Session Retrieve 404 Error class.
+  class V2ChargeSessionRetrieve404ErrorException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # requestId is unique identifier value that is attached to requests and
+    # messages that allow reference to a particular transaction or event chain.
+    # @return [String]
+    attr_accessor :request_id
+
+    # Status of the request
+    # @return [String]
+    attr_accessor :status
+
+    # Exception details of the error
+    # @return [Array[NotFoundErrMsg]]
+    attr_accessor :errors
+
+    # The constructor.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] hash The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      return nil unless hash
+
+      @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
+      @status = hash.key?('status') ? hash['status'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      @errors = nil
+      unless hash['errors'].nil?
+        @errors = []
+        hash['errors'].each do |structure|
+          @errors << (NotFoundErrMsg.from_hash(structure) if structure)
+        end
+      end
+
+      @errors = SKIP unless hash.key?('errors')
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
+  end
+end

data/lib/shell_ev/exceptions/v2_charge_session_start404_error_exception.rb

@@ -0,0 +1,67 @@
+# shell_ev
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ShellEv
+  # V2 Charge Session Start 404 Error class.
+  class V2ChargeSessionStart404ErrorException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # requestId is unique identifier value that is attached to requests and
+    # messages that allow reference to a particular transaction or event chain.
+    # @return [String]
+    attr_accessor :request_id
+
+    # Status of the request
+    # @return [String]
+    attr_accessor :status
+
+    # Exception details of the error
+    # @return [Array[NotFoundErrMsg]]
+    attr_accessor :errors
+
+    # The constructor.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] hash The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      return nil unless hash
+
+      @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
+      @status = hash.key?('status') ? hash['status'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      @errors = nil
+      unless hash['errors'].nil?
+        @errors = []
+        hash['errors'].each do |structure|
+          @errors << (NotFoundErrMsg.from_hash(structure) if structure)
+        end
+      end
+
+      @errors = SKIP unless hash.key?('errors')
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
+  end
+end

data/lib/shell_ev/exceptions/v2_charge_session_stop404_error_exception.rb

@@ -0,0 +1,67 @@
+# shell_ev
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ShellEv
+  # V2 Charge Session Stop 404 Error class.
+  class V2ChargeSessionStop404ErrorException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # requestId is unique identifier value that is attached to requests and
+    # messages that allow reference to a particular transaction or event chain.
+    # @return [String]
+    attr_accessor :request_id
+
+    # Status of the request
+    # @return [String]
+    attr_accessor :status
+
+    # Exception details of the error
+    # @return [Array[NotFoundErrMsg]]
+    attr_accessor :errors
+
+    # The constructor.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] hash The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      return nil unless hash
+
+      @request_id = hash.key?('requestId') ? hash['requestId'] : SKIP
+      @status = hash.key?('status') ? hash['status'] : SKIP
+      # Parameter is an array, so we need to iterate through it
+      @errors = nil
+      unless hash['errors'].nil?
+        @errors = []
+        hash['errors'].each do |structure|
+          @errors << (NotFoundErrMsg.from_hash(structure) if structure)
+        end
+      end
+
+      @errors = SKIP unless hash.key?('errors')
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, errors: #{@errors}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, errors:"\
+      " #{@errors.inspect}>"
+    end
+  end
+end

data/lib/shell_ev/http/auth/o_auth2.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Utility class for OAuth 2 authorization and token management.
@@ -100,7 +100,7 @@ module ShellEv
 
     def initialize(o_auth_client_id:, o_auth_client_secret:, o_auth_token: nil,
                    o_auth_token_provider: nil, o_auth_on_token_update: nil,
-                   o_auth_clock_skew: nil)
+                   o_auth_clock_skew: 0)
       raise ArgumentError, 'o_auth_client_id cannot be nil' if o_auth_client_id.nil?
       raise ArgumentError, 'o_auth_client_secret cannot be nil' if o_auth_client_secret.nil?
 
@@ -112,6 +112,21 @@ module ShellEv
       @o_auth_clock_skew = o_auth_clock_skew
     end
 
+    def self.from_env
+      o_auth_client_id = ENV['O_AUTH_CLIENT_ID']
+      o_auth_client_secret = ENV['O_AUTH_CLIENT_SECRET']
+      o_auth_clock_skew = ENV['O_AUTH_CLOCK_SKEW']
+      all_nil = [
+        o_auth_client_id,
+        o_auth_client_secret
+      ].all?(&:nil?)
+      return nil if all_nil
+
+      new(o_auth_client_id: o_auth_client_id,
+          o_auth_client_secret: o_auth_client_secret,
+          o_auth_clock_skew: o_auth_clock_skew)
+    end
+
     def clone_with(o_auth_client_id: nil, o_auth_client_secret: nil,
                    o_auth_token: nil, o_auth_token_provider: nil,
                    o_auth_on_token_update: nil, o_auth_clock_skew: nil)

data/lib/shell_ev/http/http_call_back.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # HttpCallBack allows defining callables for pre and post API calls.

data/lib/shell_ev/http/http_method_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # HTTP Methods Enumeration.

data/lib/shell_ev/http/http_request.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Represents a single Http Request.

data/lib/shell_ev/http/http_response.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Http response received.

data/lib/shell_ev/http/proxy_settings.rb

@@ -0,0 +1,22 @@
+# shell_ev
+#
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
+
+module ShellEv
+  ##
+  # ProxySettings encapsulates HTTP proxy configuration for Faraday,
+  # including optional basic authentication.
+  #
+  class ProxySettings < CoreLibrary::ProxySettings
+    def self.from_env
+      address = ENV['PROXY_ADDRESS']
+      port = ENV['PROXY_PORT']
+      username = ENV['PROXY_USERNAME']
+      password = ENV['PROXY_PASSWORD']
+      return nil if address.nil? || address.strip.empty?
+
+      new(address: address, port: port, username: username, password: password)
+    end
+  end
+end

data/lib/shell_ev/models/accessibility_status_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Accessibility Status
@@ -25,5 +25,20 @@ module ShellEv
 
       ACCESSIBILITY_STATUS_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = FREEPUBLIC)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'freepublic' then FREEPUBLIC
+      when 'payingpublic' then PAYINGPUBLIC
+      when 'restricted' then RESTRICTED
+      when 'unspecified' then UNSPECIFIED
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/{accessibility.rb → accessibility_v2.rb}

@@ -1,11 +1,11 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Accessibility of the Location
-  class Accessibility < BaseModel
+  class AccessibilityV2 < BaseModel
     SKIP = Object.new
     private_constant :SKIP
 
@@ -13,15 +13,10 @@ module ShellEv
     # @return [AccessibilityStatusEnum]
     attr_accessor :status
 
-    # optional Arbitrary text about restrictions of the Location
-    # @return [String]
-    attr_accessor :remark
-
     # A mapping from model property names to API property names.
     def self.names
       @_hash = {} if @_hash.nil?
       @_hash['status'] = 'status'
-      @_hash['remark'] = 'remark'
       @_hash
     end
 
@@ -29,7 +24,6 @@ module ShellEv
     def self.optionals
       %w[
         status
-        remark
       ]
     end
 
@@ -38,9 +32,8 @@ module ShellEv
       []
     end
 
-    def initialize(status = SKIP, remark = SKIP)
+    def initialize(status = SKIP)
       @status = status unless status == SKIP
-      @remark = remark unless remark == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -49,11 +42,21 @@ module ShellEv
 
       # Extract variables from the hash.
       status = hash.key?('status') ? hash['status'] : SKIP
-      remark = hash.key?('remark') ? hash['remark'] : SKIP
 
       # Create object from extracted values.
-      Accessibility.new(status,
-                        remark)
+      AccessibilityV2.new(status)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status: #{@status}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status: #{@status.inspect}>"
     end
   end
 end

data/lib/shell_ev/models/active_response200_json.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # ActiveResponse200Json Model.
@@ -74,5 +74,18 @@ module ShellEv
                                 status,
                                 data)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id}, status: #{@status}, data: #{@data}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} request_id: #{@request_id.inspect}, status: #{@status.inspect}, data:"\
+      " #{@data.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/active_response200_json_status_enum.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Indicates overall status of the request
@@ -19,5 +19,18 @@ module ShellEv
 
       ACTIVE_RESPONSE200_JSON_STATUS_ENUM.include?(value)
     end
+
+    def self.from_value(value, default_value = SUCCESS)
+      return default_value if value.nil?
+
+      str = value.to_s.strip
+
+      case str.downcase
+      when 'success' then SUCCESS
+      when 'failed' then FAILED
+      else
+        default_value
+      end
+    end
   end
 end

data/lib/shell_ev/models/address.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Address of the Shell Recharge Location
@@ -75,5 +75,19 @@ module ShellEv
                   city,
                   country)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} street_and_number: #{@street_and_number}, postal_code: #{@postal_code},"\
+      " city: #{@city}, country: #{@country}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} street_and_number: #{@street_and_number.inspect}, postal_code:"\
+      " #{@postal_code.inspect}, city: #{@city.inspect}, country: #{@country.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/bad_request_err_msg.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # BadRequestErrMsg Model.
@@ -78,5 +78,19 @@ module ShellEv
                            description,
                            details)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} code: #{@code}, message: #{@message}, description: #{@description},"\
+      " details: #{@details}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} code: #{@code.inspect}, message: #{@message.inspect}, description:"\
+      " #{@description.inspect}, details: #{@details.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/base_model.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # Base model.

data/lib/shell_ev/models/charge_error.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # ChargeError Model.
@@ -55,5 +55,17 @@ module ShellEv
       ChargeError.new(code,
                       message)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} code: #{@code}, message: #{@message}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} code: #{@code.inspect}, message: #{@message.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/charge_retrieve_state.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # ChargeRetrieveState Model.
@@ -59,5 +59,17 @@ module ShellEv
       ChargeRetrieveState.new(status,
                               error)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status: #{@status}, error: #{@error}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status: #{@status.inspect}, error: #{@error.inspect}>"
+    end
   end
 end

data/lib/shell_ev/models/chargesession_start_body.rb

@@ -1,7 +1,7 @@
 # shell_ev
 #
-# This file was automatically generated by APIMATIC v2.0
-# ( https://apimatic.io ).
+# This file was automatically generated by APIMATIC v3.0 (
+# https://www.apimatic.io ).
 
 module ShellEv
   # ChargesessionStartBody Model.
@@ -53,5 +53,18 @@ module ShellEv
       ChargesessionStartBody.new(ev_charge_number,
                                  evse_id)
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} ev_charge_number: #{@ev_charge_number}, evse_id: #{@evse_id}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} ev_charge_number: #{@ev_charge_number.inspect}, evse_id:"\
+      " #{@evse_id.inspect}>"
+    end
   end
 end