firejab 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in firejab.gemspec
+gemspec

data/README.markdown

@@ -0,0 +1,48 @@
+Firejab
+=====
+
+Firejab is a simple gem for connecting Campfire to Jabber. All communication is through a Jabber (or gchat) user.
+
+Overview
+-----
+
+All Firejab needs to function is the site and room id for Campfire, and authentication information for both Campfire and Jabber. It just takes two lines to run the bot:
+
+``` ruby
+c = Firejab::Connection.new(
+  :domain   => campfire_domain,
+  :room_id  => campfire_room_id,
+  :token    => campfire_token,
+  :jabber => {
+    :username => jabber_email,
+    :password => jabber_password
+  }
+)
+
+c.run
+```
+
+The first time a user communicates with Firejab, it will request an authentication token. If you would like to add one manually (for testing purposes), there's a public `add_token` method:
+
+``` ruby
+c.add_token(jabber_email, campfire_token)
+```
+
+TODO
+-----
+
+*  Persistent store of user authentication information
+*  Support for multiple rooms or rooms defined by user
+*  Verify that token is valid and lookup user data
+   Eventually will probably have to make a CampfireUser class to handle this easily/gracefully
+*  Make HTTP requests within EventMachine async
+*  Presence notifications
+*  Utility commands like /who
+*  Properly handle subscription requests
+*  Error handling/reconnects
+*  Jabber disconnects when I send this: "I can probably dig up the old VB code... ;)"
+
+Proposed Schema
+-----
+
+| jabber_username | campfire_token | campfire_uid | campfire_name |

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/firejab.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "firejab/version"
+
+Gem::Specification.new do |s|
+  s.name        = "firejab"
+  s.version     = Firejab::VERSION
+  s.authors     = ["Damon P. Cortesi"]
+  s.email       = ["d.lifehacker@gmail.com"]
+  s.homepage    = "https://github.com/dacort/firejab"
+  s.summary     = %q{Jabber interface for Campfire}
+  s.description = %q{A simple Jabber bot that shuttles messages between Jabber and Campfire}
+
+  s.rubyforge_project = "firejab"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+
+  s.add_dependency "twitter-stream",            "~> 0.1.14"
+  s.add_dependency "scashin133-xmpp4r-simple",  "~> 0.8.9"    # 1.9.x compat
+  s.add_dependency "yajl-ruby",                 "~> 0.8.2"
+  s.add_dependency "typhoeus",                  "~> 0.2.4"
+end

data/lib/firejab.rb

@@ -0,0 +1,2 @@
+require "firejab/version"
+require "firejab/connection"

data/lib/firejab/connection.rb

@@ -0,0 +1,166 @@
+require 'twitter/json_stream'
+require 'xmpp4r-simple'
+require 'yajl'
+require 'typhoeus'
+
+module Firejab
+  class Connection
+    attr_accessor :be_noisy
+    attr_accessor :campfire, :campfire_uids, :campfire_options, :campfire_domain, :campfire_room_id
+    attr_accessor :jabber, :jabber_users
+
+    def initialize(params)
+      self.jabber = Jabber::Simple.new(params[:jabber][:username], params[:jabber][:password])
+
+      self.campfire_options = {
+        :path => "/room/#{params[:room_id]}/live.json",
+        :host => 'streaming.campfirenow.com',
+        :auth => "#{params[:token]}:x"
+      }
+      self.campfire_room_id = params[:room_id]
+      self.campfire_domain = params[:domain]
+      self.be_noisy = false
+
+      # Load known tokens for our users from a "database"
+      self.jabber_users = {}
+      self.campfire_uids = {}
+    end
+
+    def add_token(jabber_username, campfire_token)
+      self.jabber_users[jabber_username] ||= {}
+      self.jabber_users[jabber_username][:campfire_token] = campfire_token
+    end
+
+    def run
+      EM.run do
+        self.campfire = Twitter::JSONStream.connect(self.campfire_options)
+
+        # Tell us what to do when we receive a campfire message
+        self.campfire.each_item do |item|
+          puts "Received a new message from campfire: #{item}"
+          status = Yajl::Parser.parse(item)
+          # For ppl that are connected and(?) we have tokens for, send the msg
+          case status["type"]
+          when "TextMessage", "PasteMessage"
+            send_message_to_jabber_users(status['user_id'], status['body'])
+          when "UploadMessage"
+            #TODO: Retrieve full URL from `GET /room/#{id}/messages/#{upload_message_id}/upload.json`
+            send_message_to_jabber_users(status['user_id'], "Uploaded #{status['body']}")
+          when "EnterMessage"
+            send_message_to_jabber_users(status['user_id'], "Has entered the room!") if self.be_noisy
+          when "LeaveMessage", "KickMessage"
+            send_message_to_jabber_users(status['user_id'], "Has left the room.") if self.be_noisy
+          end
+        end
+
+        self.campfire.on_error do |message|
+          puts "Received a campfire error: #{message}"
+        end
+
+        self.campfire.on_max_reconnects do |timeout, retries|
+          puts "Fatal error with campfire, you'll need to restart"
+        end
+
+        EM::PeriodicTimer.new(1) do
+          check_jabber_connection
+
+          self.jabber.received_messages do |message|
+            # Removes "/resource"
+            jabber_username = message.from.strip
+
+            if is_valid_user(jabber_username)
+              send_message_to_campfire(jabber_username, message.body)
+            elsif message.body.match(/^\w{40}$/)
+              # We received an auth token
+              add_token(jabber_username, message.body)
+              #TODO: Verify token and lookup_campfire_uid
+              send_jabber_message(jabber_username, "Heloooooo!")
+            else
+              # We don't know who this is, ask for their token
+              send_jabber_message(jabber_username, "Hi! I don't know who you are, please send me your auth token from: https://#{self.campfire_domain}/member/edit")
+            end
+          end
+
+          self.jabber.presence_updates do |friend, presence, message|
+            # presence may be one of [:online, :unavailable, :away]
+            # puts "Received presence update from #{friend.inspect}: #{presence.inspect} => #{message.inspect}"
+            #TODO: Update room presence accordingly - POST /room/#{id}/[join,leave].json
+            set_status(friend, presence)
+          end
+
+          self.jabber.new_subscriptions do |friend, presence|
+            puts "New subscription request: #{friend.inspect}"
+            # self.jabber.add(friend['jid'])
+          end
+        end
+      end
+    end
+
+    private
+      def is_valid_user(jabber_username)
+        !(self.jabber_users[jabber_username].nil? or self.jabber_users[jabber_username][:campfire_token].nil?)
+      end
+
+      def check_jabber_connection
+        if !self.jabber.connected?
+          puts "Reconnecting to Jabber"
+          self.jabber.reconnect 
+        end
+      end
+
+      def send_jabber_message(jid, message)
+        # TODO: Possibly make sure format is correct here
+        self.jabber.deliver(jid, message)
+      end
+
+      def send_message_to_jabber_users(from_uid, message)
+        self.jabber_users.each do |jid, jid_info|
+          next if jid_info[:status] == :unavailable
+          next if jid_info[:campfire_uid] == from_uid rescue false
+
+          send_jabber_message(jid, "#{campfire_name(from_uid)}: #{message}")
+        end
+      end
+
+      def send_message_to_campfire(from_jid, message)
+        jabber_username = from_jid.to_s.split("/").first
+        campfire_token  = lookup_token(jabber_username)
+        #TODO: raise an error if nil
+
+        response = Typhoeus::Request.post("https://#{self.campfire_domain}/room/#{self.campfire_room_id}/speak.json", 
+          :body => Yajl::Encoder.encode({:message => {:body => message}}),
+          :username => self.campfire_options[:auth].split(":").first, :password => "x",
+          :headers => {"Content-type" => "application/json"}
+        )
+
+        campfire_uid = Yajl::Parser.parse(response.body)['message']['user_id']
+        set_campfire_uid_on_jabber_user(jabber_username, campfire_uid)
+      end
+
+
+      def lookup_token(jabber_username)
+        self.jabber_users[jabber_username][:campfire_token] rescue nil
+      end
+
+      def set_status(jabber_username, status)
+        self.jabber_users[jabber_username] ||= {}
+        self.jabber_users[jabber_username][:status] = status
+      end
+
+      def set_campfire_uid_on_jabber_user(jabber_username, campfire_uid)
+        self.jabber_users[jabber_username] ||= {}
+        self.jabber_users[jabber_username][:campfire_uid] = campfire_uid
+      end
+
+      def campfire_name(campfire_uid)
+        self.campfire_uids[campfire_uid] ||= Yajl::Parser.parse(
+          Typhoeus::Request.get("https://#{self.campfire_domain}/users/#{campfire_uid}.json",
+            :username => self.campfire_options[:auth].split(":").first, :password => "x"
+          ).body
+        )['user']
+
+        self.campfire_uids[campfire_uid]['name']
+      end
+
+  end
+end

data/lib/firejab/version.rb

@@ -0,0 +1,3 @@
+module Firejab
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,131 @@
+--- !ruby/object:Gem::Specification 
+name: firejab
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Damon P. Cortesi
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-07 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: twitter-stream
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 1
+        - 14
+        version: 0.1.14
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: scashin133-xmpp4r-simple
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 8
+        - 9
+        version: 0.8.9
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 8
+        - 2
+        version: 0.8.2
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: typhoeus
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 2
+        - 4
+        version: 0.2.4
+  type: :runtime
+  version_requirements: *id004
+description: A simple Jabber bot that shuttles messages between Jabber and Campfire
+email: 
+- d.lifehacker@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.markdown
+- Rakefile
+- firejab.gemspec
+- lib/firejab.rb
+- lib/firejab/connection.rb
+- lib/firejab/version.rb
+has_rdoc: true
+homepage: https://github.com/dacort/firejab
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: firejab
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Jabber interface for Campfire
+test_files: []
+