inbox 0.8.1 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 988d96866a7e23dfbb209bfe7591ba7b2ef82c9b
-  data.tar.gz: f41538e8fdc548860f0f8e60c9bf67f6145b7268
+  metadata.gz: 1accdd1e51e6151899d73c573098902b1ee46356
+  data.tar.gz: ec98af89dabbfec85638a91a9fc436d97398db8e
 SHA512:
-  metadata.gz: f06646c4428a45c811ef7ac522012837e64215ca28aedf08d51a5959ab0c5ea11d2fced6d7a6e82b7d50d562dae860b0593484c3a379b0097216f70f9f359769
-  data.tar.gz: 33044f340f3b68070de735ba4e85bf7846f29a3e385d720bd65f61e9ec6d739fae311c6c2282bc2c1be99b92d3cab7217bae8a5d5d6498523091f592e0dbeef5
+  metadata.gz: 736d52441c42352ff436525f3d3321baf5a29070f0c0571586b9359a98518da58afcf8aa07b8b7502484da5e57afe0749bf41d5f786c993a6e59572cc741e2a4
+  data.tar.gz: 78dd66327d6fff5514fadc9258a0e7cc4ffdef0cc182744eeff77d2a684e75ce84022c838701a734b640590a793fe9f3b68382aabae6736084ca366444ca8eec

data/README.md

@@ -75,7 +75,16 @@ end
 
 ### Managing Billing
 
-If you're using the open-source version of the Inbox API or have fewer than 100 accounts associated with your developer app, you don't need to worry about billing. However, if you've requested production access to the Inbox API, you are billed monthly based on the number of email accounts you've connected to Inbox. Accounts initially start in a "trial" state and sync slowly at a rate of one message per minute so users can try out your app. After 30 days, you need to upgrade accounts (and start paying for them) or they will automatically expire. You may wish to upgrade accounts earlier to dramatically speed up the mail sync progress depending on your app's needs.
+If you're using the open-source version of the Inbox API or have fewer than 100 accounts associated with your developer app, you don't need to worry about billing. However, if you've requested production access to the Inbox API, you are billed monthly based on the number of email accounts you've connected to Inbox. You can choose to start accounts in "trial" state and sync slowly at a rate of one message per minute so users can try out your app. If you use trial mode, you need to upgrade accounts (and start paying for them) within 30 days or they will automatically expire. You may wish to upgrade accounts earlier to dramatically speed up the mail sync progress depending on your app's needs.
+
+**Starting an Account in Trial Mode**
+
+When you're redirecting the user to Inbox to authenticate with their email provider,
+pass the additional `trial: true` option to start their account in trial mode.
+
+```ruby
+  redirect_to inbox.url_for_authentication(callback_url, user_email, {trial: true})
+```
 
 **Upgrading an Account**
 

data/lib/inbox.rb

@@ -62,8 +62,12 @@ module Inbox
       "#{protocol}//#{@access_token}:@#{domain}#{path}"
     end
 
-    def url_for_authentication(redirect_uri, login_hint = '')
-      "https://www.inboxapp.com/oauth/authorize?client_id=#{@app_id}&response_type=code&scope=email&login_hint=#{login_hint}&redirect_uri=#{redirect_uri}"
+    def url_for_authentication(redirect_uri, login_hint = '', options = {})
+      trialString = 'false'
+      if options[:trial] == true
+        trialString = 'true'
+      end
+      "https://www.inboxapp.com/oauth/authorize?client_id=#{@app_id}&trial=#{trialString}&response_type=code&scope=email&login_hint=#{login_hint}&redirect_uri=#{redirect_uri}"
     end
 
     def set_access_token(token)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: inbox
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.9.0
 platform: ruby
 authors:
 - Ben Gotow
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-10-31 00:00:00.000000000 Z
+date: 2014-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client