facebook-account-kit 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: c618c6a275539437ab7d5b00685728f3b8531f37
+  data.tar.gz: 9d3375403262f163715668784864c6867335ed43
+SHA512:
+  metadata.gz: 5bc14990749a7bbac420360a3ac13f4ff741efb2f8223e1d59be30a9e4b0f4ee49cfd387ba19e4fa027c3cf5d1b840167b4f2a4bb0fe01eb6861dd006f8fa274
+  data.tar.gz: 3d04cf22a4c1dad87b877e96fae0936fc41edcbbc4866d4e5882e4e0e5b491f78ce9bc5c7114f2763c6e4b9766b5d19913e87fee5685723f05526aa7330a8e8c

data/.gitignore

@@ -0,0 +1,9 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,2 @@
+source 'https://rubygems.org'
+gemspec

data/Makefile

@@ -0,0 +1,11 @@
+.PHONY: install
+install:
+	@bundle
+
+.PHONY: test
+test:
+	@bundle exec rspec
+
+.PHONY: test.%
+test.%:
+	@bundle exec rspec spec/$*

data/README.md

@@ -0,0 +1,67 @@
+# Facebook::AccountKit
+
+This gem aims to facilitate the communication with Facebook's Account Kit. It implements the **server side** described in the [official docs](https://developers.facebook.com/docs/accountkit/web).
+
+As of now it's assuming you have enabled `Require app secret` in your Account Kit page.
+
+It only uses the core modules available as part of Ruby (so nothing too crazy in here 😬...)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'facebook-account-kit'
+```
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install facebook-account-kit
+
+## Usage
+
+Somewhere in your application (probably as part of a new `initializer`) you should add the following:
+
+```ruby
+  Facebook::AccountKit.config do |c|
+    c.account_kit_version = 'v1.0' # or any other valid account kit api version
+    c.account_kit_app_secret = 'your account kit secret'
+    c.facebook_app_id = 'your facebook app id'
+  end
+```
+
+All of that information you can find as part of your Facebook app's `dashboard` and `account kit` pages.
+
+The process of communicating with Facebook is divided into two steps.
+
+During the first one you will use the `code` (AKA `authorization code`) that the client provided in exchange for an `access_token`:
+
+```ruby
+  client_code = params[:code] # this depends on how your controller was implemented
+  token_exchanger = Facebook::AccountKit::TokenExchanger.new(client_code)
+  access_token = token_exchanger.fetch_access_token
+```
+
+...and with that access token you can request for the user information:
+
+```ruby
+  user = Facebook::AccountKit::UserAccount.new(access_token)
+  user.fetch_user_info
+```
+
+## Development
+
+There are different targets in the Makefile to help you to run the tests:
+
+* Run all tests: `make test`
+* Run unit tests: `make test.unit`
+* Run integration tests: `make test.integration`
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/nicholaspufal/facebook-account-kit
+

data/facebook-account-kit.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'facebook/account_kit/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'facebook-account-kit'
+  spec.version       = Facebook::AccountKit::VERSION
+  spec.authors       = ['Nicholas Pufal']
+  spec.email         = ['niko.pufal@gmail.com']
+
+  spec.summary       = "A simple Ruby gem that makes it easier to work with Facebook's Account Kit"
+  spec.homepage      = 'https://github.com/nicholaspufal/facebook-account-kit'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.12'
+  spec.add_development_dependency 'rspec', '~> 3.4'
+  spec.add_development_dependency 'vcr', '~> 3.0'
+  spec.add_development_dependency 'webmock', '~> 2.1'
+end

data/lib/facebook/account_kit.rb

@@ -0,0 +1,13 @@
+require 'facebook/account_kit/configuration'
+
+module Facebook
+  module AccountKit
+    def self.config
+      yield Configuration
+    end
+  end
+end
+
+require 'facebook/account_kit/version'
+require 'facebook/account_kit/token_exchanger'
+require 'facebook/account_kit/user_account'

data/lib/facebook/account_kit/configuration.rb

@@ -0,0 +1,11 @@
+module Facebook
+  module AccountKit
+    class Configuration
+      class << self
+        attr_accessor :account_kit_version,
+                      :account_kit_app_secret,
+                      :facebook_app_id
+      end
+    end
+  end
+end

data/lib/facebook/account_kit/http.rb

@@ -0,0 +1,18 @@
+require 'net/http'
+require 'json'
+
+module Facebook
+  module AccountKit
+    class InvalidRequest < StandardError; end
+
+    class HTTP
+      def self.get(url)
+        response = Net::HTTP.get_response url
+        parsed_response = JSON.parse(response.body)
+        raise InvalidRequest, parsed_response['error']['message'] if response.code != '200'
+
+        parsed_response
+      end
+    end
+  end
+end

data/lib/facebook/account_kit/token_exchanger.rb

@@ -0,0 +1,40 @@
+require_relative './http'
+
+module Facebook
+  module AccountKit
+    class TokenExchanger
+      def initialize(authorization_code)
+        @authorization_code = authorization_code
+      end
+
+      def fetch_access_token
+        result = HTTP.get compose_url
+        result['access_token']
+      end
+
+      private
+
+      def params
+        user_params = {
+          grant_type: 'authorization_code',
+          code: @authorization_code,
+          access_token: app_access_token
+        }
+
+        URI.encode_www_form(user_params)
+      end
+
+      def compose_url
+        URI(token_url + '?' + params)
+      end
+
+      def token_url
+        "https://graph.accountkit.com/#{Configuration.account_kit_version}/access_token"
+      end
+
+      def app_access_token
+        ['AA', Configuration.facebook_app_id, Configuration.account_kit_app_secret].join('|')
+      end
+    end
+  end
+end

data/lib/facebook/account_kit/user_account.rb

@@ -0,0 +1,40 @@
+require_relative './http'
+require 'openssl'
+
+module Facebook
+  module AccountKit
+    class UserAccount
+      def initialize(access_token)
+        @access_token = access_token
+      end
+
+      def fetch_user_info
+        HTTP.get compose_url
+      end
+
+      private
+
+      def params
+        token_params = {
+          access_token: @access_token,
+          appsecret_proof: secret_proof
+        }
+
+        URI.encode_www_form(token_params)
+      end
+
+      def secret_proof
+        digest = OpenSSL::Digest.new('sha256')
+        OpenSSL::HMAC.hexdigest(digest, Configuration.account_kit_app_secret, @access_token)
+      end
+
+      def compose_url
+        URI(me_url + '?' + params)
+      end
+
+      def me_url
+        "https://graph.accountkit.com/#{Configuration.account_kit_version}/me"
+      end
+    end
+  end
+end

data/lib/facebook/account_kit/version.rb

@@ -0,0 +1,5 @@
+module Facebook
+  module AccountKit
+    VERSION = '1.0.0'.freeze
+  end
+end

metadata

@@ -0,0 +1,113 @@
+--- !ruby/object:Gem::Specification
+name: facebook-account-kit
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Nicholas Pufal
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-06-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.12'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.4'
+- !ruby/object:Gem::Dependency
+  name: vcr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.1'
+description: 
+email:
+- niko.pufal@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- Makefile
+- README.md
+- facebook-account-kit.gemspec
+- lib/facebook/account_kit.rb
+- lib/facebook/account_kit/configuration.rb
+- lib/facebook/account_kit/http.rb
+- lib/facebook/account_kit/token_exchanger.rb
+- lib/facebook/account_kit/user_account.rb
+- lib/facebook/account_kit/version.rb
+homepage: https://github.com/nicholaspufal/facebook-account-kit
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.5.1
+signing_key: 
+specification_version: 4
+summary: A simple Ruby gem that makes it easier to work with Facebook's Account Kit
+test_files: []
+has_rdoc: