lightrail_client 2.0.0beta → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e30747a8e405655c72ec010cab80c24067b366ace6ed38796b29737b1edfe0e8
-  data.tar.gz: 712921a9561b7abe9c262b87e4e25f5adf9a62c3606dd955d0a746eb6d513ef8
+  metadata.gz: 1fddd302fb68157084fe8f7562a55e8608f0fba7df36d9f680f36ee49a0a4d16
+  data.tar.gz: 5a78817518d33300f92af4fa25d071b293977f155c9c93c25fd22c2185bfa896
 SHA512:
-  metadata.gz: da3a014cdc39b47aa21446c4f7f5c5bb2fb3f8a7b75c628918d1bd7d14e8d52272ca4a7b165a02077a5796615e7514fdd19499db005175613505d31113fe8082
-  data.tar.gz: 7b9e7af56d31dcf249c9c4b35baa27fdc030d4293bdd76027e328cef7abcd19384586daf086dbb1bbf6534d2fc0e8af5bdb206bd8912ae5c0e51e290208dd3d6
+  metadata.gz: 6cfbd2c375746baff3bd6106f78b9a9409cd903f496ff7a09bf330ae41142eefbadfb52ac225e6f3d56939dd1abbcc3b188b2719773dd30ee680daccd037882e
+  data.tar.gz: ee3c53a25ebab1dc3a6572a299cc08158f773ba17edd3e28e094b3d7e0da1b1405da9cb79244f99ec12e8f736dd07e01907b1b78bd31ccdc9758164f3c57a8c2

data/.gitignore

@@ -14,3 +14,6 @@
 # IntelliJ stuff
 *.iml
 .idea/
+
+# Test secrets
+.env

data/README.md

@@ -1,300 +1,60 @@
 # Lightrail Client for Ruby
+Lightrail is a modern platform for digital account credits, gift cards, promotions, and points (to learn more, visit [Lightrail](https://www.lightrail.com/)). This is a basic library for developers to easily connect with the Lightrail API using Ruby. 
 
-Lightrail is a modern platform for digital account credits, gift cards, promotions, and points (to learn more, visit [Lightrail](https://www.lightrail.com/)). This is a basic library for developers to easily connect with the Lightrail API using Ruby. If you are looking for specific use cases or other languages, check out the complete list of all [Lightrail libraries](https://www.lightrail.com/docs/#client-libraries/client-libraries).
-
-## Features
-
-The following features are supported in this version:
-
-- Account Credits: create, retrieve, charge, refund, balance-check, and fund.
-- Gift Cards: charge, refund, balance-check, and fund.
-
-Note that the Lightrail API supports many other features and we are working on covering them in this gem. For a complete list of Lightrail API features check out the [Lightrail API documentation](https://www.lightrail.com/docs/reference/).
-
-## Related Projects
-
-Check out the full list of [Lightrail client libraries](https://www.lightrail.com/docs/#client-libraries/client-libraries). 
-
-## Usage
-
-Before using any parts of the library, you'll need to configure it to use your API key:
-
-```ruby
-Lightrail.api_key = "<your lightrail API key>"
-```
-
-*A note on sample code snippets: for reasons of legibility, the output for most calls has been simplified. Attributes of response objects that are not relevant here have been omitted.*
-
-### Use Case: Account Credits Powered by Lightrail
-
-For a quick demonstration of implementing account credits using this library, see our [Accounts Quickstart](https://www.lightrail.com/docs/#accounts/accounts). 
-
-
-### Use Case: Gift Cards
-
-**Looking for Lightrail's Drop-In Gift Card Solution?** 
-
-Check out our [Drop-in Gift Card documentation](https://www.lightrail.com/docs/#drop-in-gift-cards/drop-in-gift-cards) to get started.
-
-**Prefer to build it yourself?**
-
-The remainder of this document is a detailed overview of the methods this library offers for managing Gift Cards. It assumes familiarity with the concepts in our [Gift Card guide](https://github.com/Giftbit/Lightrail-API-Docs/blob/master/use-cases/gift-card.md).
-
-#### Balance Check
-
-There are several ways to check the balance of a gift card or code. Because you can attach conditional value to a card/code (for example, "get $5 off when you buy a red hat"), the available balance can vary depending on the transaction context.
-
-##### Maximum Value
-
-To get the maximum value of a card/code, i.e. the sum of all active value stores, call either `Card.get_maximum_value(<CARD ID>)` or `Code.get_maximum_value(<CODE>)`. This method will return an integer which represents the sum of all active value stores in the smallest currency unit (e.g. cents):
-
-```ruby
-maximum_gift_value = Lightrail::Card.get_maximum_value("<GIFT CARD ID>")
-# or use the code:
-# maximum_gift_value = Lightrail::Code.get_maximum_value("<GIFT CODE>")
-
-#=>  3500
-```
-
-##### Card/Code Details
-
-If you would like to see a breakdown of how the value is stored on a card or code you can use the `.get_details` method. This will return a breakdown of all attached value stores, along with other important information:
-
-```
-gift_details = Lightrail::Card.get_details("<GIFT CARD ID>")
-# or use the code:
-# gift_details = Lightrail::Code.get_details("<GIFT CODE>")
-
-#=> {
-        "valueStores": [
-            {
-                "valueStoreType": "PRINCIPAL",
-                "value": 483,
-                "state": "ACTIVE",
-                "expires": null,
-                "startDate": null,
-                "programId": "program-123456",
-                "valueStoreId": "value-11111111",
-                "restrictions": []
-            },
-            {
-                "valueStoreType": "ATTACHED",
-                "value": 1234,
-                "state": "ACTIVE",
-                "expires": "2017-11-13T19:29:31.613Z",
-                "startDate": null,
-                "programId": "program-7890",
-                "valueStoreId": "value-2222222",
-                "restrictions": ["Valid for purchase of a red hat"]
-            },
-            {
-                "valueStoreType": "ATTACHED",
-                "value": 500,
-                "state": "EXPIRED",
-                "expires": "2017-09-13T19:29:37.464Z",
-                "startDate": null,
-                "programId": "program-24680",
-                "valueStoreId": "value-3333333",
-                "restrictions": ["Cart must have five or more items"]
-            }
-        ],
-        "currency": "USD",
-        "cardType": "GIFT_CARD",
-        "asAtDate": "2017-11-06T19:29:41.533Z",
-        "cardId": "card-12q4wresdgf6ey",
-        "codeLastFour": "WXYZ"
-    }
-}
-```
-
-These details can be useful for showing a customer a summary of their gift balance, or for incentivizing further spending (e.g. "Add a red hat to your order to get $12.34 off").
-
-##### Simulate Transaction
-
-If you would like to know how much is available for a specific transaction, use the `.simulate_charge` method. Simply pass in all the same parameters as you would to make a regular charge (see below) **including metadata** so that the Lightrail engine can assess whether necessary conditions are met for any attached value. 
-
-The `value` of the response will indicate the maximum amount that can be charged given the context of the transaction, which can be useful when presenting your customer with a confirmation dialogue. The `value` is a drawdown amount and will therefore be negative:
-
-```ruby
-simulated_charge = Lightrail::Card.simulate_charge({
-                                      value: -1850,
-                                      currency: 'USD',
-                                      card_id: '<GIFT CARD ID>',
-                                      metadata: {cart: {items_total: 5}},
-                                    })
-#=> {
-       "value"=>-1550,
-       "userSuppliedId"=>"2bfb5ccb",
-       "transactionType"=>"DRAWDOWN",
-       "currency"=>"USD",
-       "transactionBreakdown": [
-            {
-                "value": -1234,
-                "valueAvailableAfterTransaction": 0,
-                "valueStoreId": "value-4f9a362e7206445796d934727e0d2b27"
-            },
-            {
-                "value": -616,
-                "valueAvailableAfterTransaction": 0,
-                "valueStoreId": "value-9850b36634b541f5bc6fd280b0198b3d",
-                "restrictions": ["Cart must have five or more items"],
-            }
-         ],
-       "transactionId": null,
-       "dateCreated": null,
-       #...
-    }
-```
-
-Note that because this is a simulated transaction and not a real transaction, the `transactionId` and `dateCreated` will both be `null`.
-
-#### Charging a Gift Card
-
-In order to make a charge, you can call `.charge` on either a `Code` or a `Card`. The minimum required parameters are the `fullCode` or `cardId`, the `currency`, and the `value` of the transaction (a negative integer in the smallest currency unit, e.g., 500 cents is 5 USD):
+## Installation
+This gem is available on RubyGems.org. To use it in your project, add this line to your application's Gemfile:
 
 ```ruby
-gift_charge = Lightrail::Code.charge({
-                                      value: -2500,
-                                      currency: 'USD',
-                                      code: '<GIFT CODE>'
-                                    })
-#=> {
-       "value"=>-1850,
-       "userSuppliedId"=>"2bfb5ccb",
-       "transactionType"=>"DRAWDOWN",
-       "currency"=>"USD",
-       #...
-    }
+gem 'lightrail_client'
 ```
 
-**A note on idempotency:** All calls to create or act on transactions (refund, void, capture) can optionally take a `userSuppliedId` parameter. The `userSuppliedId` is a client-side identifier (unique string) which is used to ensure idempotency (for more details, see the  [API documentation](https://www.lightrail.com/docs/reference/)). If you do not provide a `userSuppliedId`, the gem will create one for you for any calls that require one.
+And then execute:
 
-```ruby
-gift_charge = Lightrail::Code.charge({
-                                      value: -1850,
-                                      currency: 'USD',
-                                      code: '<GIFT CODE>',
-                                      userSuppliedId: 'order-13jg9s0era9023-u9a-0ea'
-                                    })
 ```
-
-Note that Lightrail does not support currency exchange and the currency provided to these methods must match the currency of the gift card.
-
-For more details on the parameters that you can pass in for a charge request and the response that you will get back, see the [API documentation](https://www.lightrail.com/docs/reference/).
-
-#### Authorize-Capture Flow
-
-By adding ` pending: true` to your charge param hash when calling either `Card.charge` or `Code.charge`, you can create a pre-authorized pending transaction. When you are ready to capture or void it, you will call `Transaction.capture` or `Transaction.void` and pass in the response you get back from the call to create the pending charge:
-
-```ruby
-gift_charge = Lightrail::Code.charge({
-                                      value: -1850,
-                                      currency: 'USD',
-                                      code: '<GIFT CODE>',
-                                      pending: true,
-                                    })
-# later on
-Lightrail::Transaction.capture(gift_charge)
-#=> {
-       "value"=>-1850,
-       "userSuppliedId"=>"12c2d18f",
-       "dateCreated"=>"2017-05-29T13:37:02.756Z",
-       "transactionType"=>"DRAWDOWN",
-       "transactionAccessMethod"=>"RAWCODE",
-       "cardId"=>"<GIFT CARD ID>",
-       "currency"=>"USD",
-       "transactionId"=>"transaction-8483d9",
-       "parentTransactionId"=>"transaction-cf353236"
-    }
-
-# or
-Lightrail::Transaction.void(gift_charge)
-#=> {
-       "value"=>-1850,
-       "userSuppliedId"=>"12c2d18f",
-       "dateCreated"=>"2017-05-29T13:37:02.756Z",
-       "transactionType"=>"PENDING_VOID",
-       "transactionAccessMethod"=>"RAWCODE",
-       "cardId"=>"<GIFT CARD ID>",
-       "currency"=>"USD",
-       "transactionId"=>"transaction-d10e76",
-       "parentTransactionId"=>"transaction-cf353236"
-    }
+$ bundle
 ```
 
-Note that `Transaction.void` and `Transaction.capture` will each return a **new transaction** and will not modify the original pending transaction they are called on. These new transactions will have their own `transactionId`. If you need to record the transaction ID of the captured or canceled charge, you can get it from the hash returned by these methods.
-
-#### Refunding a Charge
-
-You can undo a charge by calling `Transaction.refund` and passing in the details of the transaction you wish to refund. This will create a new `refund` transaction which will return the charged amount back to the card. If you need the transaction ID of the refund transaction, you can find it in the response from the API.
+## Usage
+Before using any parts of the library, you'll need to configure it to use your API key:
 
 ```ruby
-gift_charge = Lightrail::Code.charge(<CHARGE PARAMS>)
-
-# later on
-Lightrail::Transaction.refund(gift_charge)
-#=> {
-       "value"=>1850,
-       "userSuppliedId"=>"873b08ab",
-       "dateCreated"=>"2017-05-29T13:37:02.756Z",
-       "transactionType"=>"DRAWDOWN_REFUND",
-       "transactionAccessMethod"=>"CARDID",
-       "cardId"=>"<GIFT CARD ID>",
-       "currency"=>"USD",
-       "transactionId"=>"transaction-0f2a67",
-       "parentTransactionId"=>"transaction-2271e3"
-    }
+Lightrail.api_key = "<your lightrail API key>"
 ```
 
-Note that this does not necessarily mean that the refunded amount is available for a re-charge. In the edge case where the funds for the original charge came from a promotion which has now expired, refunding will return those funds back to the now-expired value store and therefore the value will not be available for re-charge. To learn more about using value stores for temporary promotions, see the [Promotions Quickstart](https://www.lightrail.com/docs/#promotions/promotions).
-
-#### Funding a Gift Card
-
-To fund a gift card, you can call `Card.fund`. Note that the Lightrail API does not permit funding a gift card by its `code` and the only way to fund a card is by providing its `cardId`:
+If generating shopper tokens, you'll also need to set the shared secret.
 
 ```ruby
-gift_fund = Lightrail::Card.fund({
-                                      value: 500,
-                                      currency: 'USD',
-                                      card_id: '<GIFT CARD ID>',
-                                    })
-#=> {
-       "value"=>500,
-       "userSuppliedId"=>"7676c986",
-       "dateCreated"=>"2017-05-29T13:37:02.756Z",
-       "transactionType"=>"FUND",
-       "transactionAccessMethod"=>"CARDID",
-       "cardId"=>"<GIFT CARD ID>",
-       "currency"=>"USD",
-       "transactionId"=>"transaction-dee3ee7"
-    }
+Lightrail.shared_secret = "<your Lightrail shared secret>"
 ```
 
-
-## Installation
-
-This gem is available on RubyGems.org. To use it in your project, add this line to your application's Gemfile:
-
+### Example Usage
+A quick example of creating a Value.
 ```ruby
-gem 'lightrail_client'
+Lightrail::Values.create(
+    {
+      id: "unique-id-123",
+      currency: "USD",
+      balance: 10
+    })
 ```
 
-And then execute:
+Full argument parameters can be found in the [Lightrail API Docs](https://lightrailapi.docs.apiary.io/#introduction). Arguments should be passed in `camelCased` exactly as they appear in the API Docs.
 
-```
-$ bundle
-```
+If you'd like to see more examples of using the gem, our full Ruby tests can be viewed [here](https://github.com/Giftbit/lightrail-client-ruby/tree/master/spec/resources).
 
 ## Contributing
-
 Bug reports and pull requests are welcome on GitHub at https://github.com/Giftbit/lightrail-client-ruby.
 
 ## Development
-
 After checking out the repo, run `bin/setup` to install dependencies, then run `bundle exec rspec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
 
 To install this gem onto your local machine, run `bundle exec rake install`.
 
+You'll also need to add a .env file.
+```
+LIGHTRAIL_TEST_API_KEY=
+```
+
 ### Publishing
 
 Make sure to bump the version number before publishing changes. 

data/lib/lightrail_client/connection.rb

@@ -0,0 +1,79 @@
+module Lightrail
+  class Connection
+    def self.connection
+      conn = Faraday.new Lightrail.api_base, ssl: {version: :TLSv1_2}
+      conn.headers['Content-Type'] = 'application/json; charset=utf-8'
+      conn.headers['Authorization'] = "Bearer #{Lightrail.api_key}"
+      conn.headers['User-Agent'] = "Lightrail-Ruby/#{Gem.loaded_specs['lightrail_client'].version.version}"
+      conn
+    end
+
+    def self.post (url, body)
+      resp = Lightrail::Connection.connection.post do |req|
+        req.url url
+        req.body = JSON.generate(body)
+      end
+      self.handle_response(resp)
+    end
+
+    def self.patch (url, body)
+      resp = Lightrail::Connection.connection.patch do |req|
+        req.url url
+        req.body = JSON.generate(body)
+      end
+      self.handle_response(resp)
+    end
+
+    def self.delete (url)
+      resp = Lightrail::Connection.connection.delete do |req|
+        req.url url
+      end
+      self.handle_response(resp)
+    end
+
+    def self.get(url, query_params = {})
+      resp = Lightrail::Connection.connection.get {|req| req.url url, query_params}
+      self.handle_response(resp, false)
+    end
+
+    def self.handle_response(response, error_on_404 = true)
+      case response.status
+      when 200...300
+        return format_response(response)
+      else
+        if response.status == 404 && !error_on_404
+          return format_response(response)
+        end
+        body = JSON.parse(response.body) || {}
+        raise LightrailError.new("Server responded with: (#{response.status}) #{body['message'] || ''}", response.status, response)
+      end
+    end
+
+    def self.format_response(response)
+      body = JSON.parse(response.body) || {}
+      text = response.body
+      links, limit, max_limit = nil
+      if response.headers["link"]
+        links = self.parse_link_headers(response.headers["link"])
+        limit = response.headers["limit"].to_i
+        max_limit = response.headers["max-limit"].to_i
+      end
+      return LightrailResponse.new(body, text, response.status, links, limit, max_limit)
+    end
+
+    def self.parse_link_headers(link_headers)
+      links = []
+      link_headers.split(",").each do |link_header|
+        link = {
+            url: link_header[/(?<=\<)(.*?)(?=\>)/, 1],
+            rel: link_header[/(?<=\")(.*?)(?=\")/, 1]
+        }
+        CGI::parse(URI::parse(link[:url]).query).each do |key, values|
+          link[key.to_sym] = values[0] # CGI parse returns hash of key => [values]. [values] will always be of length 1 so this removes the array.
+        end
+        links.push(link)
+      end
+      return links
+    end
+  end
+end

data/lib/lightrail_client/errors.rb

@@ -1,11 +1,11 @@
 module Lightrail
   class LightrailError < StandardError
-    attr_reader :message
-    attr_accessor :response
+    attr_reader :message, :status, :response
 
-    def initialize (message='', response)
+    def initialize (message = '', status = nil, response = nil)
       @message = message
       @response = response
+      @status = status
     end
   end
 

data/lib/lightrail_client/lightrail_response_objects.rb

@@ -0,0 +1,14 @@
+module Lightrail
+  class LightrailResponse
+    attr_reader :body, :text, :status, :links, :max_limit, :limit
+
+    def initialize (body, text, status, links = nil, limit = nil, max_limit = nil)
+      @body = body
+      @text = text
+      @links = links
+      @status = status
+      @max_limit = max_limit
+      @limit = limit
+    end
+  end
+end

data/lib/lightrail_client/resources/contacts.rb

@@ -0,0 +1,35 @@
+module Lightrail
+  class Contacts
+    def self.create(params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/contacts", params)
+    end
+
+    def self.get(id)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.get("#{Lightrail.api_base}/contacts/#{CGI::escape(id)}")
+    end
+
+    def self.list(query_params = {})
+      Lightrail::Connection.get("#{Lightrail.api_base}/contacts", query_params)
+    end
+
+    def self.update(id, params)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.patch("#{Lightrail.api_base}/contacts/#{CGI::escape(id)}", params)
+    end
+
+    def self.attach_value_to_contact(id, params)
+      Lightrail::Validators.validate_id(id, "contact_id")
+      Lightrail::Connection.post("#{Lightrail.api_base}/contacts/#{CGI::escape(id)}/values/attach", params)
+    end
+
+    def self.list_contact_values(id, query_params = {})
+      Lightrail::Connection.get("#{Lightrail.api_base}/contacts/#{CGI::escape(id)}/values", query_params)
+    end
+
+    def self.delete(id)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.delete("#{Lightrail.api_base}/contacts/#{CGI::escape(id)}")
+    end
+  end
+end

data/lib/lightrail_client/resources/currencies.rb

@@ -0,0 +1,26 @@
+module Lightrail
+  class Currencies
+    def self.create(params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/currencies", params)
+    end
+
+    def self.get(code)
+      Lightrail::Validators.validate_id(code)
+      Lightrail::Connection.get("#{Lightrail.api_base}/currencies/#{CGI::escape(code)}")
+    end
+
+    def self.list(query_params = {})
+      Lightrail::Connection.get("#{Lightrail.api_base}/currencies", query_params)
+    end
+
+    def self.update(code, params)
+      Lightrail::Validators.validate_id(code)
+      Lightrail::Connection.patch("#{Lightrail.api_base}/currencies/#{CGI::escape(code)}", params)
+    end
+
+    def self.delete(code)
+      Lightrail::Validators.validate_id(code)
+      Lightrail::Connection.delete("#{Lightrail.api_base}/currencies/#{CGI::escape(code)}")
+    end
+  end
+end

data/lib/lightrail_client/resources/programs.rb

@@ -0,0 +1,42 @@
+module Lightrail
+  class Programs
+    def self.create(params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/programs", params)
+    end
+
+    def self.get(id)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.get("#{Lightrail.api_base}/programs/#{CGI::escape(id)}")
+    end
+
+    def self.list(query_params = {})
+      Lightrail::Connection.get("#{Lightrail.api_base}/programs", query_params)
+    end
+
+    def self.update(id, params)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.patch("#{Lightrail.api_base}/programs/#{CGI::escape(id)}", params)
+    end
+
+    def self.create_issuance(program_id, params)
+      Lightrail::Validators.validate_id(program_id, "program_id")
+      Lightrail::Connection.post("#{Lightrail.api_base}/programs/#{CGI::escape(program_id)}/issuances", params)
+    end
+
+    def self.list_issuances(program_id, query_params = {})
+      Lightrail::Validators.validate_id(program_id, "program_id")
+      Lightrail::Connection.get("#{Lightrail.api_base}/programs/#{CGI::escape(program_id)}/issuances", query_params)
+    end
+
+    def self.get_issuance(program_id, issuance_id)
+      Lightrail::Validators.validate_id(program_id, "program_id")
+      Lightrail::Validators.validate_id(issuance_id, "issuance_id")
+      Lightrail::Connection.get("#{Lightrail.api_base}/programs/#{CGI::escape(program_id)}/issuances/#{CGI::escape(issuance_id)}")
+    end
+
+    def self.delete(id)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.delete("#{Lightrail.api_base}/programs/#{CGI::escape(id)}")
+    end
+  end
+end

data/lib/lightrail_client/resources/transactions.rb

@@ -0,0 +1,47 @@
+module Lightrail
+  class Transactions
+    def self.checkout(params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/transactions/checkout", params)
+    end
+
+    def self.debit(params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/transactions/debit", params)
+    end
+
+    def self.credit(params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/transactions/credit", params)
+    end
+
+    def self.transfer(params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/transactions/transfer", params)
+    end
+
+    def self.reverse(id, params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/transactions/#{CGI::escape(id)}/reverse", params)
+    end
+
+    def self.capture_pending(id, params)
+      Lightrail::Validators.validate_id(id, "transaction_id")
+      Lightrail::Connection.post("#{Lightrail.api_base}/transactions/#{CGI::escape(id)}/capture", params)
+    end
+
+    def self.void_pending(id, params)
+      Lightrail::Validators.validate_id(id, "pending_id")
+      Lightrail::Connection.post("#{Lightrail.api_base}/transactions/#{CGI::escape(id)}/void", params)
+    end
+
+    def self.get(id)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.get("#{Lightrail.api_base}/transactions/#{CGI::escape(id)}")
+    end
+
+    def self.list(query_params)
+      Lightrail::Connection.get("#{Lightrail.api_base}/transactions", query_params)
+    end
+
+    def self.get_transaction_chain(id)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.get("#{Lightrail.api_base}/transactions/#{CGI::escape(id)}/chain")
+    end
+  end
+end

data/lib/lightrail_client/resources/values.rb

@@ -0,0 +1,31 @@
+module Lightrail
+  class Values
+    def self.create(params)
+      Lightrail::Connection.post("#{Lightrail.api_base}/values", params)
+    end
+
+    def self.get(id, query_params = {})
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.get("#{Lightrail.api_base}/values/#{CGI::escape(id)}", query_params)
+    end
+
+    def self.list(query_params = {})
+      Lightrail::Connection.get("#{Lightrail.api_base}/values", query_params)
+    end
+
+    def self.update(id, params)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.patch("#{Lightrail.api_base}/values/#{CGI::escape(id)}", params)
+    end
+
+    def self.change_code(id, params)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.post("#{Lightrail.api_base}/values/#{CGI::escape(id)}/changeCode", params)
+    end
+
+    def self.delete(id)
+      Lightrail::Validators.validate_id(id)
+      Lightrail::Connection.delete("#{Lightrail.api_base}/values/#{CGI::escape(id)}")
+    end
+  end
+end

data/lib/lightrail_client/validators.rb

@@ -0,0 +1,7 @@
+module Lightrail
+  class Validators
+    def self.validate_id(id, key = "id")
+      raise Lightrail::BadParameterError.new("Argument #{key} must be set.") unless ((id.is_a? String) || (id.is_a? Integer))
+    end
+  end
+end

data/lib/lightrail_client/version.rb

@@ -1,3 +1,3 @@
 module Lightrail
-  VERSION = "2.0.0beta"
+  VERSION = "2.0.0"
 end

data/lib/lightrail_client.rb

@@ -8,7 +8,16 @@ require "base64"
 require "lightrail_client/version"
 
 require "lightrail_client/errors"
+require "lightrail_client/lightrail_response_objects"
 require "lightrail_client/shopper_token_factory"
+require "lightrail_client/connection"
+require "lightrail_client/validators"
+
+require "lightrail_client/resources/contacts"
+require "lightrail_client/resources/currencies"
+require "lightrail_client/resources/programs"
+require "lightrail_client/resources/transactions"
+require "lightrail_client/resources/values"
 
 module Lightrail
   class << self

data/lightrail_client.gemspec

@@ -30,13 +30,14 @@ Gem::Specification.new do |spec|
   spec.executables = spec.files.grep(%r{^exe/}) {|f| File.basename(f)}
   spec.require_paths = ["lib"]
 
-  spec.add_development_dependency "bundler", "~> 1.15"
-  spec.add_development_dependency "rake", "~> 10.0"
-  spec.add_development_dependency "rspec", "~> 3.0"
-  spec.add_development_dependency "pry-byebug", "~>3.4"
+  spec.add_development_dependency "bundler", "~> 1.17"
+  spec.add_development_dependency "rake", "~> 10.5"
+  spec.add_development_dependency "rspec", "~> 3.8"
+  spec.add_development_dependency "pry-byebug", "~>3.6"
+  spec.add_development_dependency "dotenv", "~> 2.5"
 
-  spec.add_runtime_dependency "faraday", "~>0.12"
-  spec.add_runtime_dependency "json", "~>1.7"
-  spec.add_runtime_dependency "openssl", "~>2.0"
+  spec.add_runtime_dependency "faraday", "~>0.15"
+  spec.add_runtime_dependency "json", "~>1.8"
+  spec.add_runtime_dependency "openssl", "~>2.1"
   spec.add_runtime_dependency "jwt", "~>2.1"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lightrail_client
 version: !ruby/object:Gem::Version
-  version: 2.0.0beta
+  version: 2.0.0
 platform: ruby
 authors:
 - Lightrail
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-11-08 00:00:00.000000000 Z
+date: 2018-12-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,98 +16,112 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '1.17'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.15'
+        version: '1.17'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '10.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '10.0'
+        version: '10.5'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.0'
+        version: '3.8'
 - !ruby/object:Gem::Dependency
   name: pry-byebug
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.4'
+        version: '3.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.4'
+        version: '3.6'
+- !ruby/object:Gem::Dependency
+  name: dotenv
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
 - !ruby/object:Gem::Dependency
   name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.12'
+        version: '0.15'
 - !ruby/object:Gem::Dependency
   name: json
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: '1.8'
 - !ruby/object:Gem::Dependency
   name: openssl
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.1'
 - !ruby/object:Gem::Dependency
   name: jwt
   requirement: !ruby/object:Gem::Requirement
@@ -140,8 +154,16 @@ files:
 - bin/console
 - bin/setup
 - lib/lightrail_client.rb
+- lib/lightrail_client/connection.rb
 - lib/lightrail_client/errors.rb
+- lib/lightrail_client/lightrail_response_objects.rb
+- lib/lightrail_client/resources/contacts.rb
+- lib/lightrail_client/resources/currencies.rb
+- lib/lightrail_client/resources/programs.rb
+- lib/lightrail_client/resources/transactions.rb
+- lib/lightrail_client/resources/values.rb
 - lib/lightrail_client/shopper_token_factory.rb
+- lib/lightrail_client/validators.rb
 - lib/lightrail_client/version.rb
 - lightrail_client.gemspec
 homepage: https://www.lightrail.com/
@@ -160,12 +182,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.7.8
+rubygems_version: 2.7.7
 signing_key: 
 specification_version: 4
 summary: A client library for the Lightrail API