stealth 0.9.1

data/lib/stealth/flow/state.rb

@@ -0,0 +1,48 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Flow
+    class State
+
+      include Comparable
+
+      attr_accessor :name, :events, :meta, :on_entry, :on_exit
+      attr_reader :spec
+
+      def initialize(name, spec, meta = {})
+        @name, @spec, @events, @meta = name, spec, EventCollection.new, meta
+      end
+
+      def draw(graph)
+        defaults = {
+          :label => to_s,
+          :width => '1',
+          :height => '1',
+          :shape => 'ellipse'
+        }
+
+        node = graph.add_nodes(to_s, defaults.merge(meta))
+
+        # Add open arrow for initial state
+        # graph.add_edge(graph.add_node('starting_state', :shape => 'point'), node) if initial?
+
+        node
+      end
+
+      def <=>(other_state)
+        states = spec.states.keys
+        raise ArgumentError, "state `#{other_state}' does not exist" unless states.include?(other_state.to_sym)
+        states.index(self.to_sym) <=> states.index(other_state.to_sym)
+      end
+
+      def to_s
+        "#{name}"
+      end
+
+      def to_sym
+        name.to_sym
+      end
+    end
+  end
+end

data/lib/stealth/jobs.rb

@@ -0,0 +1,10 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  class Jobs
+
+    include Sidekiq::Worker
+
+  end
+end

data/lib/stealth/logger.rb

@@ -0,0 +1,16 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  class Logger
+
+    def self.log(topic:, message:)
+      puts "[#{topic.upcase}] #{message}"
+    end
+
+    class << self
+      alias_method :l, :log
+    end
+
+  end
+end

data/lib/stealth/reply.rb

@@ -0,0 +1,19 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  class Reply
+
+    attr_accessor :reply_type, :reply
+
+    def initialize(unstructured_reply:)
+      @reply_type = unstructured_reply["reply_type"]
+      @reply = unstructured_reply
+    end
+
+    def [](key)
+      @reply[key]
+    end
+
+  end
+end

data/lib/stealth/server.rb

@@ -0,0 +1,38 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+require 'sinatra/base'
+require 'multi_json'
+
+module Stealth
+  class Server < Sinatra::Base
+
+    def self.get_or_post(url, &block)
+      get(url, &block)
+      post(url, &block)
+    end
+
+    get '/' do
+      "Welcome to stealth."
+    end
+
+    get_or_post '/incoming/:service' do
+      Stealth::Logger.l(topic: "incoming", message: "Received webhook from #{params[:service]}.")
+
+      # JSON params need to be parsed and added to the params
+      if request.env['CONTENT_TYPE'] == 'application/json'
+        json_params = MultiJson.load(request.body.read)
+        params.merge!(json_params)
+      end
+
+      dispatcher = Stealth::Dispatcher.new(
+        service: params[:service],
+        params: params,
+        headers: request.env
+      )
+
+      dispatcher.coordinate
+    end
+
+  end
+end

data/lib/stealth/service_message.rb

@@ -0,0 +1,17 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  class ServiceMessage
+
+    attr_accessor :sender_id, :timestamp, :service, :message, :location,
+                  :attachments, :payload, :referral
+
+    def initialize(service:)
+      @service = service
+      @attachments = []
+      @location = {}
+    end
+
+  end
+end

data/lib/stealth/service_reply.rb

@@ -0,0 +1,30 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  class ServiceReply
+
+    attr_accessor :recipient_id, :replies
+
+    def initialize(recipient_id:, yaml_reply:, context:)
+      @recipient_id = recipient_id
+
+      begin
+        erb_reply = ERB.new(yaml_reply).result(context)
+      rescue NameError => e
+        raise(Stealth::Errors::UndefinedVariable, e.message)
+      end
+
+      @replies = load_replies(YAML.load(erb_reply))
+    end
+
+    private
+
+      def load_replies(unstructured_replies)
+        unstructured_replies.collect do |reply|
+          Stealth::Reply.new(unstructured_reply: reply)
+        end
+      end
+
+  end
+end

data/lib/stealth/services/base_client.rb

@@ -0,0 +1,28 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+require 'stealth/services/base_reply_handler'
+require 'stealth/services/base_message_handler'
+
+require 'stealth/services/jobs/handle_message_job'
+
+module Stealth
+  module Services
+    class BaseClient
+
+      attr_reader :reply
+
+      def initialize(reply:)
+        @reply = reply
+      end
+
+      def transmit
+        raise(Stealth::Errors::ServiceImpaired, "Service implementation does not implement 'transmit'.")
+      end
+
+    end
+  end
+end
+
+
+require 'stealth/services/facebook/client'

data/lib/stealth/services/base_message_handler.rb

@@ -0,0 +1,28 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Services
+    class BaseMessageHandler
+
+      attr_reader :params, :headers
+
+      def initialize(params:, headers:)
+        @params = params
+        @headers = headers
+      end
+
+      # Should respond with a Rack response (https://github.com/sinatra/sinatra#return-values)
+      def coordinate
+        raise(Stealth::Errors::ServiceImpaired, "Service request handler does not implement 'process'.")
+      end
+
+      # After coordinate responds to the service, an optional async job
+      # may be fired that will continue the work via this method
+      def process
+
+      end
+
+    end
+  end
+end

data/lib/stealth/services/base_reply_handler.rb

@@ -0,0 +1,65 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Services
+    class BaseReplyHandler
+
+      attr_reader :recipient_id, :reply
+
+      def initialize(recipient_id:, reply:)
+        @client = client
+        @options = options
+      end
+
+      def text
+        reply_format_not_supported(format: 'text')
+      end
+
+      def image
+        reply_format_not_supported(format: 'image')
+      end
+
+      def audio
+        reply_format_not_supported(format: 'audio')
+      end
+
+      def video
+        reply_format_not_supported(format: 'video')
+      end
+
+      def file
+        reply_format_not_supported(format: 'file')
+      end
+
+      def cards
+        reply_format_not_supported(format: 'cards')
+      end
+
+      def list
+        reply_format_not_supported(format: 'list')
+      end
+
+      def receipt
+        reply_format_not_supported(format: 'receipt')
+      end
+
+      def mark_seen
+        reply_format_not_supported(format: 'mark_seen')
+      end
+
+      def enable_typing_indicator
+        reply_format_not_supported(format: 'enable_typing_indicator')
+      end
+
+      def disable_typing_indicator
+        reply_format_not_supported(format: 'disable_typing_indicator')
+      end
+
+      def delay
+        reply_format_not_supported(format: 'delay')
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/client.rb

@@ -0,0 +1,35 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+require 'faraday'
+
+require 'stealth/services/facebook/message_handler'
+require 'stealth/services/facebook/reply_handler'
+require 'stealth/services/facebook/setup'
+
+module Stealth
+  module Services
+    module Facebook
+
+      class Client < Stealth::Services::BaseClient
+        FB_ENDPOINT = "https://graph.facebook.com/v2.10/me"
+
+        attr_reader :api_endpoint, :reply
+
+        def initialize(reply:, endpoint: 'messages')
+          @reply = reply
+          access_token = "access_token=#{Stealth.config.facebook.page_access_token}"
+          @api_endpoint = [[FB_ENDPOINT, endpoint].join('/'), access_token].join('?')
+        end
+
+        def transmit
+          headers = { "Content-Type" => "application/json" }
+          response = Faraday.post(api_endpoint, reply.to_json, headers)
+          Stealth::Logger.l(topic: "facebook", message: "Transmitting. Response: #{response.status}: #{response.body}")
+        end
+
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/events/message_event.rb

@@ -0,0 +1,59 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Services
+    module Facebook
+
+      class MessageEvent
+
+        attr_reader :service_message, :params
+
+        def initialize(service_message:, params:)
+          @service_message = service_message
+          @params = params
+        end
+
+        def process
+          fetch_message
+          fetch_location
+          fetch_attachments
+        end
+
+        private
+
+          def fetch_message
+            if params['message']['quick_reply'].present?
+              service_message.message = params['message']['quick_reply']['payload']
+            elsif params['message']['text'].present?
+              service_message.message = params['message']['text']
+            end
+          end
+
+          def fetch_location
+            if params['location'].present?
+              lat = params['location']['coordinates']['lat']
+              lng = params['location']['coordinates']['long']
+              service_message.location = {
+                lat: lat,
+                lng: lng
+              }
+            end
+          end
+
+          def fetch_attachments
+            if params['attachments'].present? && params['attachments'].is_a?(Array)
+              params['attachments'].each do |attachment|
+                service_message.attachments << {
+                  type: attachment['type'],
+                  url: attachment['payload']['url']
+                }
+              end
+            end
+          end
+
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/events/postback_event.rb

@@ -0,0 +1,36 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+module Stealth
+  module Services
+    module Facebook
+
+      class PostbackEvent
+
+        attr_reader :service_message, :params
+
+        def initialize(service_message:, params:)
+          @service_message = service_message
+          @params = params
+        end
+
+        def process
+          fetch_payload
+          fetch_referral
+        end
+
+        private
+
+          def fetch_payload
+            service_message.payload = params['postback']['payload']
+          end
+
+          def fetch_referral
+            service_message.referral = params['postback']['referral']
+          end
+
+      end
+
+    end
+  end
+end

data/lib/stealth/services/facebook/message_handler.rb

@@ -0,0 +1,84 @@
+# coding: utf-8
+# frozen_string_literal: true
+
+require 'stealth/services/facebook/events/message_event'
+require 'stealth/services/facebook/events/postback_event'
+
+module Stealth
+  module Services
+    module Facebook
+
+      class MessageHandler < Stealth::Services::BaseMessageHandler
+
+        attr_reader :service_message, :params, :headers, :facebook_message
+
+        def initialize(params:, headers:)
+          @params = params
+          @headers = headers
+        end
+
+        def coordinate
+          if facebook_is_validating_webhook?
+            respond_with_validation
+          else
+            # Queue the request processing so we can respond quickly to FB
+            # and also keep track of this message
+            Stealth::Services::HandleMessageJob.perform_async('facebook', params, {})
+
+            # Relay our acceptance
+            [200, 'OK']
+          end
+        end
+
+        def process
+          @service_message = ServiceMessage.new(service: 'facebook')
+          @facebook_message = params['entry'].first['messaging'].first
+          service_message.sender_id = get_sender_id
+          service_message.timestamp = get_timestamp
+          process_facebook_event
+
+          service_message
+        end
+
+        private
+
+          def facebook_is_validating_webhook?
+            params['hub.verify_token'].present?
+          end
+
+          def respond_with_validation
+            if params['hub.verify_token'] == Stealth.config.facebook.verify_token
+              [200, params['hub.challenge']]
+            else
+              [401, "Verify token did not match environment variable."]
+            end
+          end
+
+          def get_sender_id
+            facebook_message['sender']['id']
+          end
+
+          def get_timestamp
+            Time.at(facebook_message['timestamp']).to_datetime
+          end
+
+          def process_facebook_event
+            if facebook_message['message'].present?
+              message_event = Stealth::Services::Facebook::MessageEvent.new(
+                service_message: service_message,
+                params: facebook_message
+              )
+            elsif facebook_message['postback'].present?
+              message_event = Stealth::Services::Facebook::PostbackEvent.new(
+                service_message: service_message,
+                params: facebook_message
+              )
+            end
+
+            message_event.process
+          end
+      end
+
+    end
+  end
+end