signalwire 1.4.0 → 2.0.0

data/lib/signalwire/relay/calling/component/answer.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class Answer < Component
+    def method
+      Relay::ComponentMethod::ANSWER
+    end
+
+    def event_type
+      Relay::CallNotification::STATE
+    end
+
+    def notification_handler(event)
+      @state = event.call_params[:call_state]
+
+      ended_events = [Relay::CallState::ANSWERED]
+
+      if ended_events.include?(@state)
+        @completed = true
+        @successful = true
+        @event = event
+      end
+
+      check_for_waiting_events
+    end
+  end
+end

data/lib/signalwire/relay/calling/component/await.rb

@@ -0,0 +1,20 @@
+module Signalwire::Relay::Calling
+  # A special component that only waits for call events
+  #
+  class Await < Component
+    def event_type
+      Relay::CallNotification::STATE
+    end
+    
+    def notification_handler(event)
+      @state = event.call_params[:call_state]
+      @event = event
+      @successful = true if @events_waiting.include?(@state)
+      check_for_waiting_events
+    end
+
+    def execute
+      setup_handlers
+    end
+  end
+end

data/lib/signalwire/relay/calling/component/connect.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class Connect < Component
+    def initialize(call:, devices:)
+      super(call: call)
+      @devices = devices
+    end
+
+    def method
+      Relay::ComponentMethod::CONNECT
+    end
+
+    def event_type
+      Relay::CallNotification::CONNECT
+    end
+
+    def inner_params
+      {
+        node_id: @call.node_id,
+        call_id: @call.id,
+        devices: @devices
+      }
+    end
+
+    def notification_handler(event)
+      @state = event.call_params[:connect_state]
+
+      @completed = @state != Relay::CallConnectState::CONNECTING
+
+      if @completed
+        @successful = @state == Relay::CallConnectState::CONNECTED
+        @event = event
+      end
+
+      broadcast_event(event)
+      check_for_waiting_events
+    end
+
+    def broadcast_event(event)
+      @call.broadcast "connect_#{@state}".to_sym, event
+      @call.broadcast :connect_state_change, event
+    end
+  end
+end

data/lib/signalwire/relay/calling/component/dial.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class Dial < Component
+    def method
+      Relay::ComponentMethod::DIAL
+    end
+
+    def event_type
+      Relay::CallNotification::STATE
+    end
+
+    def inner_params
+      {
+        tag: @call.tag,
+        device: @call.device
+      }
+    end
+
+    def notification_handler(event)
+      @state = event.call_params[:call_state]
+
+      ended_events = [Relay::CallState::ANSWERED, Relay::CallState::ENDING, Relay::CallState::ENDED]
+
+      if ended_events.include?(@state)
+        @completed = true
+        @successful = true if @state == Relay::CallState::ANSWERED
+        @event = event
+      end
+
+      check_for_waiting_events
+    end
+  end
+end

data/lib/signalwire/relay/calling/component/hangup.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class Hangup < Component
+    def initialize(call:, reason:)
+      super(call: call)
+      @reason = reason
+    end
+
+    def method
+      Relay::ComponentMethod::HANGUP
+    end
+
+    def event_type
+      Relay::CallNotification::STATE
+    end
+
+    def inner_params
+      {
+        node_id: @call.node_id,
+        call_id: @call.id,
+        reason: @reason
+      }
+    end
+
+    def notification_handler(event)
+      @state = event.call_params[:call_state]
+      end_reason = event.call_params[:call_state]
+
+      @completed = @state == Relay::CallState::ENDED
+
+      if @completed
+        @successful = true
+        @reason = end_reason
+        @event = event
+      end
+
+      check_for_waiting_events
+    end
+  end
+end

data/lib/signalwire/relay/calling/component/play.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class Play < ControlComponent
+    def initialize(call:, play:)
+      super(call: call)
+      @play = play
+    end
+
+    def method
+      Relay::ComponentMethod::PLAY
+    end
+
+    def event_type
+      Relay::CallNotification::PLAY
+    end
+
+    def inner_params
+      {
+        node_id: @call.node_id,
+        call_id: @call.id,
+        control_id: control_id,
+        play: @play
+      }
+    end
+
+    def notification_handler(event)
+      @state = event.call_params[:state]
+
+      @completed = @state != Relay::CallPlayState::PLAYING
+
+      if @completed
+        @successful = true if @state == Relay::CallPlayState::FINISHED
+        @event = event
+      end
+
+      broadcast_event(event)
+      check_for_waiting_events
+    end
+
+    def broadcast_event(event)
+      @call.broadcast "play_#{@state}".to_sym, event
+      @call.broadcast :play_state_change, event
+    end
+  end
+end

data/lib/signalwire/relay/calling/component/prompt.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class Prompt < ControlComponent
+    attr_reader :type, :input, :terminator
+    def initialize(call:, collect:, play:)
+      super(call: call)
+      @play = play
+      @collect = collect
+    end
+
+    def method
+      Relay::ComponentMethod::PROMPT
+    end
+
+    def event_type
+      Relay::CallNotification::COLLECT
+    end
+
+    def inner_params
+      {
+        node_id: @call.node_id,
+        call_id: @call.id,
+        control_id: control_id,
+        play: @play,
+        collect: @collect
+      }
+    end
+
+    def notification_handler(event)
+      @completed = true
+      result = event.call_params[:result]
+      @type = result[:type]
+      @state = @type
+
+      if @type == Relay::CallPromptState::DIGIT
+        digit_event(result)
+      elsif type == Relay::CallPromptState::SPEECH
+        speech_event(result)
+      else
+        @state = @type
+        @successful = false
+      end
+
+      check_for_waiting_events
+    end
+
+  private
+
+    def digit_event(result)
+      @successful = true
+      @input = result.dig(:params, :digits)
+      @terminator = result.dig(:params, :terminator)
+    end
+
+    def speech_event(result)
+      @successful = true
+      @input = result.dig(:params, :text)
+      @confidence = result.dig(:params, :confidence)
+    end
+  end
+end

data/lib/signalwire/relay/calling/component/record.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class Record < ControlComponent
+    attr_reader :url, :duration, :size
+    def initialize(call:, record:)
+      super(call: call)
+      @record = record
+    end
+
+    def method
+      Relay::ComponentMethod::RECORD
+    end
+
+    def event_type
+      Relay::CallNotification::RECORD
+    end
+
+    def inner_params
+      {
+        node_id: @call.node_id,
+        call_id: @call.id,
+        control_id: control_id,
+        record: @record
+      }
+    end
+
+    def notification_handler(event)
+      @state = event.call_params[:state]
+      url = event.call_params[:url]
+      duration = event.call_params[:duration]
+      size = event.call_params[:size]
+
+      @completed = @state != Relay::CallRecordState::RECORDING
+
+      if @completed
+        @successful = @state == Relay::CallRecordState::FINISHED
+        @url = url
+        @duration = duration
+        @size = size
+        @event = event
+      end
+
+      broadcast_event(event)
+      check_for_waiting_events
+    end
+
+    def broadcast_event(event)
+      @call.broadcast "record_#{@state}".to_sym, event
+      @call.broadcast :record_state_change, event
+    end
+  end
+end

data/lib/signalwire/relay/calling/control_component.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'securerandom'
+
+module Signalwire::Relay::Calling
+  class ControlComponent < Component
+    def control_id
+      @control_id ||= SecureRandom.uuid
+    end
+
+    def inner_params
+      {
+        nodeid: @call.node_id,
+        callid: @call.id,
+        control_id: control_id,
+        params: payload
+      }
+    end
+
+    def setup_handlers
+      @call.on :event, event_type: event_type, control_id: control_id do |evt|
+        notification_handler(evt)
+      end
+    end
+
+    def stop
+      @call.relay_execute execute_params('.stop') do |event, outcome|
+        if outcome == :failure
+          terminate(event)
+          return event
+        end
+      end
+    end
+  end
+end

data/lib/signalwire/relay/calling/result.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+
+module Signalwire::Relay::Calling
+  class Result
+    extend Forwardable
+    attr_reader :component
+
+    def_delegators :@component, :successful, :event
+
+    def initialize(component:)
+      @component = component
+    end
+  end
+end

data/lib/signalwire/relay/calling/result/answer_result.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class AnswerResult < Result
+  end
+end

data/lib/signalwire/relay/calling/result/connect_result.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class ConnectResult < Result
+    def call
+      @component.call.peer
+    end
+  end
+end

data/lib/signalwire/relay/calling/result/dial_result.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class DialResult < Result
+    def_delegators :@component, :call
+  end
+end

data/lib/signalwire/relay/calling/result/hangup_result.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class HangupResult < Result
+    def_delegators :@component, :reason
+  end
+end

data/lib/signalwire/relay/calling/result/play_result.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class PlayResult < Result
+  end
+end

data/lib/signalwire/relay/calling/result/prompt_result.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Signalwire::Relay::Calling
+  class PromptResult < Result
+    def_delegators :@component, :type, :terminator, :confidence
+
+    def result
+      @component.input
+    end
+  end
+end