recurly 2.4.7 → 2.4.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1203bd1945ec1c2eae87b580b09a47a214965a6c
-  data.tar.gz: ba492e09b36d0479a5e41ea1e29b41ccc94561b2
+  metadata.gz: 660fc143363dbebd51bf09c75aaddd74aeb43dda
+  data.tar.gz: f9fb32d3c6540d8fde7c6cc2b3eb6616a8ee2da6
 SHA512:
-  metadata.gz: bc27d6d635846fb6a9fdcfda6755be969c92f1b97d32a2fec8fc8918a78dff58084d1e41f95a9dda0660de5273eed9ba075d52d826f163807f9d69d7d5f39d68
-  data.tar.gz: 120302e3ea0d5b8038b4607957c396d1ccc86f79f18214ab3df402f1455ebcf952ca6ef1ce7cdef5d640f9f484866f9f70ba25ae40be1832edeb51780d322486
+  metadata.gz: 1f93dcf67ee8a172a8a646f153601fb867652eab00d4bb32eb5ebe1fd04b1ead5855907dd767aaf2c12e0434fa70a308ca57b996acb96e41933402944f8a29f4
+  data.tar.gz: ed29811ad7fbc2b0adcaedeaf06a105a52a11f1809704a4412e125e9f55114cfbd0884d2ca2441b772d0f3025eb814dd3e69ce846ce9b6cdc056ce02ebc4b18e

data/README.md

@@ -12,7 +12,7 @@ Recurly is packaged as a Ruby gem. We recommend you install it with
 [Bundler](http://gembundler.com/) by adding the following line to your Gemfile:
 
 ``` ruby
-gem 'recurly', '~> 2.4.7'
+gem 'recurly', '~> 2.4.8'
 ```
 
 Recurly will automatically use [Nokogiri](http://nokogiri.org/) (for a nice

data/lib/recurly.rb

@@ -20,6 +20,7 @@ module Recurly
   autoload :Transaction,       'recurly/transaction'
   autoload :Version,           'recurly/version'
   autoload :XML,               'recurly/xml'
+  autoload :Webhook,           'recurly/webhook'
 
   @subdomain = nil
 

data/lib/recurly/account.rb

@@ -31,6 +31,7 @@ module Recurly
       state
       username
       email
+      cc_emails
       first_name
       last_name
       company_name

data/lib/recurly/version.rb

@@ -2,7 +2,7 @@ module Recurly
   module Version
     MAJOR   = 2
     MINOR   = 4
-    PATCH   = 7
+    PATCH   = 8
     PRE     = nil
 
     VERSION = [MAJOR, MINOR, PATCH, PRE].compact.join('.').freeze

data/lib/recurly/webhook.rb

@@ -0,0 +1,66 @@
+module Recurly
+  # The Webhook class handles delegating the webhook request body to the appropriate
+  # notification class. Notification classes enapsualte the supplied data, providing
+  # access to account details, as well as subscription, invoice, and transaction
+  # details where available.
+  #
+  # @example
+  #   Recurly::Webhook.parse(xml_body)  # => #<Recurly::Webhook::NewAccountNotification ...>
+  #
+  #   notification = Recurly::Webhook.parse(xml_body)
+  #   case notification
+  #   when Recurly::Webhook::NewAccountNoficiation
+  #     # A new account was created
+  #     ...
+  #   when Recurly::Webhook::NewSubscriptionNotification
+  #     # A new subscription was added
+  #     ...
+  #   when Recurly::Webhook::SubscriptionNotification
+  #     # A subscription-related notification was sent
+  #     ...
+  #   end
+  module Webhook
+    autoload :Notification,                     'recurly/webhook/notification'
+    autoload :AccountNotification,              'recurly/webhook/account_notification'
+    autoload :SubscriptionNotification,         'recurly/webhook/subscription_notification'
+    autoload :InvoiceNotification,              'recurly/webhook/invoice_notification'
+    autoload :TransactionNotification,          'recurly/webhook/transaction_notification'
+    autoload :BillingInfoUpdatedNotification,   'recurly/webhook/billing_info_updated_notification'
+    autoload :CanceledSubscriptionNotification, 'recurly/webhook/canceled_subscription_notification'
+    autoload :CanceledAccountNotification,      'recurly/webhook/canceled_account_notification'
+    autoload :ClosedInvoiceNotification,        'recurly/webhook/closed_invoice_notification'
+    autoload :ExpiredSubscriptionNotification,  'recurly/webhook/expired_subscription_notification'
+    autoload :FailedPaymentNotification,        'recurly/webhook/failed_payment_notification'
+    autoload :NewAccountNotification,           'recurly/webhook/new_account_notification'
+    autoload :NewInvoiceNotification,           'recurly/webhook/new_invoice_notification'
+    autoload :NewSubscriptionNotification,      'recurly/webhook/new_subscription_notification'
+    autoload :PastDueInvoiceNotification,       'recurly/webhook/past_due_invoice_notification'
+    autoload :ReactivatedAccountNotification,   'recurly/webhook/reactivated_account_notification'
+    autoload :RenewedSubscriptionNotification,  'recurly/webhook/renewed_subscription_notification'
+    autoload :SuccessfulPaymentNotification,    'recurly/webhook/successful_payment_notification'
+    autoload :SuccessfulRefundNotification,     'recurly/webhook/successful_refund_notification'
+    autoload :UpdatedSubscriptionNotification,  'recurly/webhook/updated_subscription_notification'
+    autoload :VoidPaymentNotification,          'recurly/webhook/void_payment_notification'
+    autoload :ProcessingPaymentNotification,    'recurly/webhook/processing_payment_notification'
+    autoload :ProcessingInvoiceNotification,    'recurly/webhook/processing_invoice_notification'
+    autoload :ScheduledPaymentNotification,     'recurly/webhook/scheduled_payment_notification'
+
+    # This exception is raised if the Webhook Notification initialization fails
+    class NotificationError < Error
+    end
+
+    # @return [Resource] A notification.
+    # @raise [NotificationError] For unknown or invalid notifications.
+    def self.parse xml_body
+      xml = XML.new xml_body
+      class_name = Helper.classify xml.name
+      
+      if Webhook.const_defined?(class_name, false)
+        klass = Webhook.const_get class_name
+        klass.from_xml xml_body
+      else
+        raise NotificationError, "'#{class_name}' is not a recognized notification"
+      end
+    end
+  end
+end

data/lib/recurly/webhook/account_notification.rb

@@ -0,0 +1,10 @@
+module Recurly
+  module Webhook
+    # The AccountNotification class provides a generic interface
+    # for account-related webhook notifications.
+    class AccountNotification < Notification
+      # @return [Account]
+      has_one :account
+    end
+  end
+end

data/lib/recurly/webhook/billing_info_updated_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class BillingInfoUpdatedNotification < AccountNotification
+    end
+  end
+end

data/lib/recurly/webhook/canceled_account_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class CanceledAccountNotification < AccountNotification
+    end
+  end
+end

data/lib/recurly/webhook/canceled_subscription_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class CanceledSubscriptionNotification < SubscriptionNotification
+    end
+  end
+end

data/lib/recurly/webhook/closed_invoice_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class ClosedInvoiceNotification < InvoiceNotification
+    end
+  end
+end

data/lib/recurly/webhook/expired_subscription_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class ExpiredSubscriptionNotification < SubscriptionNotification
+    end
+  end
+end

data/lib/recurly/webhook/failed_payment_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class FailedPaymentNotification < TransactionNotification
+    end
+  end
+end

data/lib/recurly/webhook/invoice_notification.rb

@@ -0,0 +1,12 @@
+module Recurly
+  module Webhook
+    # The InvoiceNotification class provides a generic interface
+    # for account-related webhook notifications.
+    class InvoiceNotification < Notification
+      # @return [Account]
+      has_one :account
+      # @return [Invoice]
+      has_one :invoice
+    end
+  end
+end

data/lib/recurly/webhook/new_account_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class NewAccountNotification < AccountNotification
+    end
+  end
+end

data/lib/recurly/webhook/new_invoice_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class NewInvoiceNotification < InvoiceNotification
+    end
+  end
+end

data/lib/recurly/webhook/new_subscription_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class NewSubscriptionNotification < SubscriptionNotification
+    end
+  end
+end

data/lib/recurly/webhook/notification.rb

@@ -0,0 +1,18 @@
+module Recurly
+  module Webhook
+    # The TransactionNotification class provides a generic interface
+    # for account-related webhook notifications.
+    class Notification < Resource
+      # Provides a convenience method to reload assocated members because Webhook
+      # notifications are not to be considered current.
+      def self.has_one member_name, options = {}
+        define_method("#{member_name}!") do
+          member = self[member_name]
+          member.reload if member
+        end
+
+        super
+      end
+    end
+  end
+end

data/lib/recurly/webhook/past_due_invoice_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class PastDueInvoiceNotification < InvoiceNotification
+    end
+  end
+end

data/lib/recurly/webhook/processing_invoice_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class ProcessingInvoiceNotification < InvoiceNotification
+    end
+  end
+end

data/lib/recurly/webhook/processing_payment_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class ProcessingPaymentNotification < TransactionNotification
+    end
+  end
+end

data/lib/recurly/webhook/reactivated_account_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class ReactivatedAccountNotification < SubscriptionNotification
+    end
+  end
+end

data/lib/recurly/webhook/renewed_subscription_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class RenewedSubscriptionNotification < SubscriptionNotification
+    end
+  end
+end

data/lib/recurly/webhook/scheduled_payment_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class ScheduledPaymentNotification < TransactionNotification
+    end
+  end
+end

data/lib/recurly/webhook/subscription_notification.rb

@@ -0,0 +1,12 @@
+module Recurly
+  module Webhook
+    # The SubscriptionNotification class provides a generic interface
+    # for account-related webhook notifications.
+    class SubscriptionNotification < Notification
+      # @return [Account]
+      has_one :account
+      # @return [Subscription]
+      has_one :subscription
+    end
+  end
+end

data/lib/recurly/webhook/successful_payment_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class SuccessfulPaymentNotification < TransactionNotification
+    end
+  end
+end

data/lib/recurly/webhook/successful_refund_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class SuccessfulRefundNotification < TransactionNotification
+    end
+  end
+end

data/lib/recurly/webhook/transaction_notification.rb

@@ -0,0 +1,12 @@
+module Recurly
+  module Webhook
+    # The TransactionNotification class provides a generic interface
+    # for account-related webhook notifications.
+    class TransactionNotification < Notification
+      # @return [Account]
+      has_one :account
+      # @return [Transaction]
+      has_one :transaction
+    end
+  end
+end

data/lib/recurly/webhook/updated_subscription_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class UpdatedSubscriptionNotification < SubscriptionNotification
+    end
+  end
+end

data/lib/recurly/webhook/void_payment_notification.rb

@@ -0,0 +1,6 @@
+module Recurly
+  module Webhook
+    class VoidPaymentNotification < TransactionNotification
+    end
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: recurly
 version: !ruby/object:Gem::Version
-  version: 2.4.7
+  version: 2.4.8
 platform: ruby
 authors:
 - Recurly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-10-02 00:00:00.000000000 Z
+date: 2015-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -93,6 +93,31 @@ files:
 - lib/recurly/transaction.rb
 - lib/recurly/transaction/errors.rb
 - lib/recurly/version.rb
+- lib/recurly/webhook.rb
+- lib/recurly/webhook/account_notification.rb
+- lib/recurly/webhook/billing_info_updated_notification.rb
+- lib/recurly/webhook/canceled_account_notification.rb
+- lib/recurly/webhook/canceled_subscription_notification.rb
+- lib/recurly/webhook/closed_invoice_notification.rb
+- lib/recurly/webhook/expired_subscription_notification.rb
+- lib/recurly/webhook/failed_payment_notification.rb
+- lib/recurly/webhook/invoice_notification.rb
+- lib/recurly/webhook/new_account_notification.rb
+- lib/recurly/webhook/new_invoice_notification.rb
+- lib/recurly/webhook/new_subscription_notification.rb
+- lib/recurly/webhook/notification.rb
+- lib/recurly/webhook/past_due_invoice_notification.rb
+- lib/recurly/webhook/processing_invoice_notification.rb
+- lib/recurly/webhook/processing_payment_notification.rb
+- lib/recurly/webhook/reactivated_account_notification.rb
+- lib/recurly/webhook/renewed_subscription_notification.rb
+- lib/recurly/webhook/scheduled_payment_notification.rb
+- lib/recurly/webhook/subscription_notification.rb
+- lib/recurly/webhook/successful_payment_notification.rb
+- lib/recurly/webhook/successful_refund_notification.rb
+- lib/recurly/webhook/transaction_notification.rb
+- lib/recurly/webhook/updated_subscription_notification.rb
+- lib/recurly/webhook/void_payment_notification.rb
 - lib/recurly/xml.rb
 - lib/recurly/xml/nokogiri.rb
 - lib/recurly/xml/rexml.rb