adhearsion 2.6.4 → 3.0.0.beta1

data/spec/adhearsion/rayo/command/mute_spec.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Adhearsion::Rayo::Command::Mute do
+  it 'registers itself' do
+    expect(Adhearsion::Rayo::RayoNode.class_from_registration(:mute, 'urn:xmpp:rayo:1')).to eq(described_class)
+  end
+
+  describe "from a stanza" do
+    let(:stanza) { '<mute xmlns="urn:xmpp:rayo:1"/>' }
+
+    subject { Adhearsion::Rayo::RayoNode.from_xml parse_stanza(stanza).root, '9f00061', '1' }
+
+    it { is_expected.to be_instance_of described_class }
+  end
+
+  describe "exporting to Rayo" do
+    it "should export to XML that can be understood by its parser" do
+      new_instance = Adhearsion::Rayo::RayoNode.from_xml subject.to_rayo
+      expect(new_instance).to be_instance_of described_class
+    end
+
+    it "should render to a parent node if supplied" do
+      doc = Nokogiri::XML::Document.new
+      parent = Nokogiri::XML::Node.new 'foo', doc
+      doc.root = parent
+      rayo_doc = subject.to_rayo(parent)
+      expect(rayo_doc).to eq(parent)
+    end
+  end
+end

data/spec/adhearsion/rayo/command/redirect_spec.rb

@@ -0,0 +1,89 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Adhearsion::Rayo::Command::Redirect do
+  it 'registers itself' do
+    expect(Adhearsion::Rayo::RayoNode.class_from_registration(:redirect, 'urn:xmpp:rayo:1')).to eq(described_class)
+  end
+
+  describe "when setting options in initializer" do
+    subject { described_class.new to: 'tel:+14045551234', headers: { 'X-skill' => 'agent', 'X-customer-id' => '8877' } }
+
+    describe '#to' do
+      subject { super().to }
+      it { is_expected.to eq('tel:+14045551234') }
+    end
+
+    describe '#headers' do
+      subject { super().headers }
+      it { is_expected.to eq({ 'X-skill' => 'agent', 'X-customer-id' => '8877' }) }
+    end
+
+    describe "exporting to Rayo" do
+      it "should export to XML that can be understood by its parser" do
+        new_instance = Adhearsion::Rayo::RayoNode.from_xml subject.to_rayo
+        expect(new_instance).to be_instance_of described_class
+        expect(new_instance.to).to eq('tel:+14045551234')
+        expect(new_instance.headers).to eq({ 'X-skill' => 'agent', 'X-customer-id' => '8877' })
+      end
+
+      it "should render to a parent node if supplied" do
+        doc = Nokogiri::XML::Document.new
+        parent = Nokogiri::XML::Node.new 'foo', doc
+        doc.root = parent
+        rayo_doc = subject.to_rayo(parent)
+        expect(rayo_doc).to eq(parent)
+      end
+
+      context "when attributes are not set" do
+        subject { described_class.new }
+
+        it "should not include them in the XML representation" do
+          expect(subject.to_rayo['to']).to be_nil
+        end
+      end
+    end
+  end
+
+  describe "from a stanza" do
+    let :stanza do
+      <<-MESSAGE
+<redirect xmlns='urn:xmpp:rayo:1'
+    to='tel:+14045551234'>
+  <!-- Signaling (e.g. SIP) Headers -->
+  <header name="X-skill" value="agent" />
+  <header name="X-customer-id" value="8877" />
+</redirect>
+      MESSAGE
+    end
+
+    subject { Adhearsion::Rayo::RayoNode.from_xml parse_stanza(stanza).root, '9f00061', '1' }
+
+    it { is_expected.to be_instance_of described_class }
+
+    describe '#to' do
+      subject { super().to }
+      it { is_expected.to eq('tel:+14045551234') }
+    end
+
+    describe '#headers' do
+      subject { super().headers }
+      it { is_expected.to eq({ 'X-skill' => 'agent', 'X-customer-id' => '8877' }) }
+    end
+
+    context "with no headers or to provided" do
+      let(:stanza) { '<redirect xmlns="urn:xmpp:rayo:1"/>' }
+
+      describe '#to' do
+        subject { super().to }
+        it { is_expected.to be_nil }
+      end
+
+      describe '#headers' do
+        subject { super().headers }
+        it { is_expected.to eq({}) }
+      end
+    end
+  end
+end

data/spec/adhearsion/rayo/command/reject_spec.rb

@@ -0,0 +1,117 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Adhearsion::Rayo::Command::Reject do
+  it 'registers itself' do
+    expect(Adhearsion::Rayo::RayoNode.class_from_registration(:reject, 'urn:xmpp:rayo:1')).to eq(described_class)
+  end
+
+  describe "when setting options in initializer" do
+    subject { described_class.new reason: :busy, headers: { 'X-skill' => 'agent', 'X-customer-id' => '8877' } }
+
+    describe '#reason' do
+      subject { super().reason }
+      it { is_expected.to eq(:busy) }
+    end
+
+    describe '#headers' do
+      subject { super().headers }
+      it { is_expected.to eq({ 'X-skill' => 'agent', 'X-customer-id' => '8877' }) }
+    end
+
+    describe "exporting to Rayo" do
+      it "should export to XML that can be understood by its parser" do
+        new_instance = Adhearsion::Rayo::RayoNode.from_xml subject.to_rayo
+        expect(new_instance).to be_instance_of described_class
+        expect(new_instance.reason).to eq(:busy)
+        expect(new_instance.headers).to eq({ 'X-skill' => 'agent', 'X-customer-id' => '8877' })
+      end
+
+      it "should render to a parent node if supplied" do
+        doc = Nokogiri::XML::Document.new
+        parent = Nokogiri::XML::Node.new 'foo', doc
+        doc.root = parent
+        rayo_doc = subject.to_rayo(parent)
+        expect(rayo_doc).to eq(parent)
+      end
+
+      context "when attributes are not set" do
+        subject { described_class.new }
+
+        it "should not include them in the XML representation" do
+          expect(subject.to_rayo.children.count).to eq(0)
+        end
+      end
+    end
+  end
+
+  describe "from a stanza" do
+    let :stanza do
+      <<-MESSAGE
+<reject xmlns='urn:xmpp:rayo:1'>
+<busy />
+<!-- Sample Headers (optional) -->
+<header name="X-skill" value="agent" />
+<header name="X-customer-id" value="8877" />
+</reject>
+      MESSAGE
+    end
+
+    subject { Adhearsion::Rayo::RayoNode.from_xml parse_stanza(stanza).root, '9f00061', '1' }
+
+    it { is_expected.to be_instance_of described_class }
+
+    describe '#reason' do
+      subject { super().reason }
+      it { is_expected.to eq(:busy) }
+    end
+
+    describe '#headers' do
+      subject { super().headers }
+      it { is_expected.to eq({ 'X-skill' => 'agent', 'X-customer-id' => '8877' }) }
+    end
+
+    context "with no headers or reason provided" do
+      let(:stanza) { '<reject xmlns="urn:xmpp:rayo:1"/>' }
+
+      describe '#reason' do
+        subject { super().reason }
+        it { is_expected.to be_nil }
+      end
+
+      describe '#headers' do
+        subject { super().headers }
+        it { is_expected.to eq({}) }
+      end
+    end
+  end
+
+  describe "with the reason" do
+    [nil, :decline, :busy, :error].each do |reason|
+      describe reason.to_s do
+        subject { described_class.new :reason => reason }
+
+        describe '#reason' do
+          subject { super().reason }
+          it { is_expected.to eq(reason) }
+        end
+      end
+    end
+
+    describe "no reason" do
+      subject { described_class.new }
+
+      describe '#reason' do
+        subject { super().reason }
+        it { is_expected.to be_nil }
+      end
+    end
+
+    describe "blahblahblah" do
+      it "should raise an error" do
+        expect { described_class.new(:reason => :blahblahblah) }.to raise_error ArgumentError
+      end
+    end
+  end
+end

data/spec/adhearsion/rayo/command/unjoin_spec.rb

@@ -0,0 +1,82 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Adhearsion::Rayo::Command::Unjoin do
+  it 'registers itself' do
+    expect(Adhearsion::Rayo::RayoNode.class_from_registration(:unjoin, 'urn:xmpp:rayo:1')).to eq(described_class)
+  end
+
+  describe "when setting options in initializer" do
+    subject { described_class.new :call_uri => 'abc123', :mixer_name => 'blah' }
+
+    describe '#call_uri' do
+      subject { super().call_uri }
+      it { is_expected.to eq('abc123') }
+    end
+
+    describe '#mixer_name' do
+      subject { super().mixer_name }
+      it { is_expected.to eq('blah') }
+    end
+
+    context "with old call_id attribute" do
+      subject { described_class.new call_id: 'abc123' }
+
+      describe '#call_uri' do
+        subject { super().call_uri }
+        it { is_expected.to eq('abc123') }
+      end
+    end
+
+    describe "exporting to Rayo" do
+      it "should export to XML that can be understood by its parser" do
+        new_instance = Adhearsion::Rayo::RayoNode.from_xml subject.to_rayo
+        expect(new_instance).to be_instance_of described_class
+        expect(new_instance.call_uri).to eq('abc123')
+        expect(new_instance.mixer_name).to eq('blah')
+      end
+
+      it "should render to a parent node if supplied" do
+        doc = Nokogiri::XML::Document.new
+        parent = Nokogiri::XML::Node.new 'foo', doc
+        doc.root = parent
+        rayo_doc = subject.to_rayo(parent)
+        expect(rayo_doc).to eq(parent)
+      end
+
+      context "when attributes are not set" do
+        subject { described_class.new call_uri: 'abc123' }
+
+        it "should not include them in the XML representation" do
+          expect(subject.to_rayo['call-uri']).to eq('abc123')
+          expect(subject.to_rayo['mixer-name']).to be_nil
+        end
+      end
+    end
+  end
+
+  describe "from a stanza" do
+    let :stanza do
+      <<-MESSAGE
+<unjoin xmlns="urn:xmpp:rayo:1"
+  call-uri="abc123"
+  mixer-name="blah" />
+      MESSAGE
+    end
+
+    subject { Adhearsion::Rayo::RayoNode.from_xml parse_stanza(stanza).root, '9f00061', '1' }
+
+    it { is_expected.to be_instance_of described_class }
+
+    describe '#call_uri' do
+      subject { super().call_uri }
+      it { is_expected.to eq('abc123') }
+    end
+
+    describe '#mixer_name' do
+      subject { super().mixer_name }
+      it { is_expected.to eq('blah') }
+    end
+  end
+end

data/spec/adhearsion/rayo/command/unmute_spec.rb

@@ -0,0 +1,32 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Adhearsion::Rayo::Command::Unmute do
+  it 'registers itself' do
+    expect(Adhearsion::Rayo::RayoNode.class_from_registration(:unmute, 'urn:xmpp:rayo:1')).to eq(described_class)
+  end
+
+  describe "from a stanza" do
+    let(:stanza) { '<unmute xmlns="urn:xmpp:rayo:1"/>' }
+
+    subject { Adhearsion::Rayo::RayoNode.from_xml parse_stanza(stanza).root, '9f00061', '1' }
+
+    it { is_expected.to be_instance_of described_class }
+  end
+
+  describe "exporting to Rayo" do
+    it "should export to XML that can be understood by its parser" do
+      new_instance = Adhearsion::Rayo::RayoNode.from_xml subject.to_rayo
+      expect(new_instance).to be_instance_of described_class
+    end
+
+    it "should render to a parent node if supplied" do
+      doc = Nokogiri::XML::Document.new
+      parent = Nokogiri::XML::Node.new 'foo', doc
+      doc.root = parent
+      rayo_doc = subject.to_rayo(parent)
+      expect(rayo_doc).to eq(parent)
+    end
+  end
+end

data/spec/adhearsion/rayo/command_node_spec.rb

@@ -0,0 +1,101 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe Adhearsion::Rayo::CommandNode do
+  let(:args) { [] }
+  subject(:command) do
+    Class.new(described_class) { register 'foo'}.new(*args)
+  end
+
+  describe '#state_name' do
+    subject { super().state_name }
+    it { is_expected.to eq(:new) }
+  end
+
+  describe '#request_id' do
+    subject { super().request_id }
+    it { is_expected.to eq(@uuid) }
+  end
+
+  describe "#new" do
+    describe "with a call/component ID" do
+      let(:call_id)       { 'abc123' }
+      let(:component_id)  { 'abc123' }
+      let(:args)          { [{:target_call_id => call_id, :component_id => component_id}] }
+
+      describe '#target_call_id' do
+        subject { super().target_call_id }
+        it { is_expected.to eq(call_id) }
+      end
+
+      describe '#component_id' do
+        subject { super().component_id }
+        it { is_expected.to eq(component_id) }
+      end
+    end
+  end
+
+  describe "#request!" do
+    before { command.request! }
+
+    describe '#state_name' do
+      subject { command.state_name }
+      it { is_expected.to eq(:requested) }
+    end
+
+    it "should raise a StateMachine::InvalidTransition when received a second time" do
+      expect { command.request! }.to raise_error(StateMachine::InvalidTransition)
+    end
+  end
+
+  describe "#execute!" do
+    describe "without sending" do
+      it "should raise a StateMachine::InvalidTransition" do
+        expect { subject.execute! }.to raise_error(StateMachine::InvalidTransition)
+      end
+    end
+
+    describe "after sending" do
+      before do
+        command.request!
+        command.execute!
+      end
+
+      describe '#state_name' do
+        subject { super().state_name }
+        it { is_expected.to eq(:executing) }
+      end
+    end
+  end
+
+  describe "#complete!" do
+    before do
+      command.request!
+      command.execute!
+      command.complete!
+    end
+
+    describe '#state_name' do
+      subject { super().state_name }
+      it { is_expected.to eq(:complete) }
+    end
+
+    it "should raise a StateMachine::InvalidTransition when received a second time" do
+      expect { subject.complete! }.to raise_error(StateMachine::InvalidTransition)
+    end
+  end # #complete!
+
+  describe "#response=" do
+    it "should set the command to executing status" do
+      expect(subject).to receive(:execute!).once
+      subject.response = :foo
+    end
+
+    it "should be a no-op if the response has already been set" do
+      expect(subject).to receive(:execute!).once
+      subject.response = :foo
+      expect { subject.response = :bar }.not_to raise_error
+    end
+  end
+end