Class: Castle::Client

Inherits:
Object
  • Object
show all
Defined in:
lib/castle/client.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(options = {}) ⇒ Client

Returns a new instance of Client.

Parameters:

  • options (Hash) (defaults to: {}) 


16
17
18
19
20
21
 
# File 'lib/castle/client.rb', line 16

def initialize(options = {})
  options = Castle::Utils::DeepSymbolizeKeys.call(options || {})
  @do_not_track = options.fetch(:do_not_track, false)
  @timestamp = options.fetch(:timestamp) { Castle::Utils::GetTimestamp.call }
  @context = options.fetch(:context) { {} }
end

Instance Attribute Details

#context ⇒ Object

Returns the value of attribute context.



13
14
15
 
# File 'lib/castle/client.rb', line 13

def context
  @context
end

Class Method Details

.from_request(request, options = {}) ⇒ Object 



6
7
8
9
10
 
# File 'lib/castle/client.rb', line 6

def from_request(request, options = {})
  new(
    options.merge(context: Castle::Context::Prepare.call(request, options))
  )
end

Instance Method Details

#authenticate(options = {}) ⇒ Object

Parameters:

  • options (Hash) (defaults to: {}) 


24
25
26
27
28
29
30
31
32
33
34
 
# File 'lib/castle/client.rb', line 24

def authenticate(options = {})
  options = Castle::Utils::DeepSymbolizeKeys.call(options || {})

  return generate_do_not_track_response(options[:user_id]) unless tracked?

  add_timestamp_if_necessary(options)

  new_context = Castle::Context::Merge.call(@context, options[:context])

  Castle::API::Authenticate.call(options.merge(context: new_context, no_symbolize: true))
end

#disable_tracking ⇒ Object 



91
92
93
 
# File 'lib/castle/client.rb', line 91

def disable_tracking
  @do_not_track = true
end

#enable_tracking ⇒ Object 



95
96
97
 
# File 'lib/castle/client.rb', line 95

def enable_tracking
  @do_not_track = false
end

#end_impersonation(options = {}) ⇒ Object

Parameters:

  • options (Hash) (defaults to: {}) 


74
75
76
77
78
79
80
81
82
 
# File 'lib/castle/client.rb', line 74

def end_impersonation(options = {})
  options = Castle::Utils::DeepSymbolizeKeys.call(options || {})

  add_timestamp_if_necessary(options)

  new_context = Castle::Context::Merge.call(@context, options[:context])

  Castle::API::EndImpersonation.call(options.merge(context: new_context, no_symbolize: true))
end

#identify(options = {}) ⇒ Object

Parameters:

  • options (Hash) (defaults to: {}) 


37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/castle/client.rb', line 37

def identify(options = {})
  options = Castle::Utils::DeepSymbolizeKeys.call(options || {})

  return unless tracked?

  add_timestamp_if_necessary(options)

  new_context = Castle::Context::Merge.call(@context, options[:context])

  Castle::API::Identify.call(options.merge(context: new_context, no_symbolize: true))
end

#review(options = {}) ⇒ Object

Parameters:

  • options (Hash) (defaults to: {}) 


85
86
87
88
89
 
# File 'lib/castle/client.rb', line 85

def review(options = {})
  options = Castle::Utils::DeepSymbolizeKeys.call(options || {})

  Castle::API::Review.call(options.merge(no_symbolize: true))
end

#start_impersonation(options = {}) ⇒ Object

Parameters:

  • options (Hash) (defaults to: {}) 


63
64
65
66
67
68
69
70
71
 
# File 'lib/castle/client.rb', line 63

def start_impersonation(options = {})
  options = Castle::Utils::DeepSymbolizeKeys.call(options || {})

  add_timestamp_if_necessary(options)

  new_context = Castle::Context::Merge.call(@context, options[:context])

  Castle::API::StartImpersonation.call(options.merge(context: new_context, no_symbolize: true))
end

#track(options = {}) ⇒ Object

Parameters:

  • options (Hash) (defaults to: {}) 


50
51
52
53
54
55
56
57
58
59
60
 
# File 'lib/castle/client.rb', line 50

def track(options = {})
  options = Castle::Utils::DeepSymbolizeKeys.call(options || {})

  return unless tracked?

  add_timestamp_if_necessary(options)

  new_context = Castle::Context::Merge.call(@context, options[:context])

  Castle::API::Track.call(options.merge(context: new_context, no_symbolize: true))
end

#tracked? ⇒ Boolean

Returns:

  • (Boolean) 


99
100
101
 
# File 'lib/castle/client.rb', line 99

def tracked?
  !@do_not_track
end