recurly 4.22.0 → 4.24.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea38d9a4d3bcfd53d04e38127bcd75a152f974643151122a25d9e67293ae719c
-  data.tar.gz: 87f4f5d23c82902915df2665508e2ad93db45943413932e456fa983ef97d73c8
+  metadata.gz: 5f585c84e359302293e13409b5162b2ad56241f342b0c9e9c2c4200f29782a32
+  data.tar.gz: d8908b9d5e9cefcce7a9fa6cfa0d75b69dcd8b885ac6ce6dacc2ec416f56c1a1
 SHA512:
-  metadata.gz: 916c2f6172f117706535aeed44ee39176afdaf05de6203f2088f0a29534d9fde5e4041c0aeee91411ee7ca6a5d9364b34a212bec24615c8cf8ba88148a225189
-  data.tar.gz: 5fe36efd973e04af109491e5bf385ffe0fc1bd6022498bbe8149f0345e4bb56c321eda85209e9fa694af99ea7f93abe6f53958a4d26c5b46f5a5aa1f3807bc54
+  metadata.gz: 3d42081e4d4e095850d9b1158e8c798ab0cc11d9f9d68bb895ba77808a2d6f4f1a0bdfeac2c6394d704ea74add4df4ba63ca2eca70d1c05c1b3499e3c9bbbb76
+  data.tar.gz: 1bb51683c999694c1843c378754ba2fb6556d205db5f50ebf93cde4cb46997548cd31f3062b75f6b1db7d3bb575a3040ddea88276f1172fca424785e96b92304

data/.bumpversion.cfg

@@ -1,5 +1,5 @@
 [bumpversion]
-current_version = 4.22.0
+current_version = 4.24.0
 parse = (?P<major>\d+)
 	\.(?P<minor>\d+)
 	\.(?P<patch>\d+)

data/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## [4.24.0](https://github.com/recurly/recurly-client-ruby/tree/4.24.0) (2022-11-03)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.23.0...4.24.0)
+
+
+
+
+
+## [4.23.0](https://github.com/recurly/recurly-client-ruby/tree/4.23.0) (2022-10-27)
+
+[Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.22.0...4.23.0)
+
+
+**Merged Pull Requests**
+
+- Generated Latest Changes for v2021-02-25 (Entitlements feature) [#804](https://github.com/recurly/recurly-client-ruby/pull/804) ([recurly-integrations](https://github.com/recurly-integrations))
+
+
+
 ## [4.22.0](https://github.com/recurly/recurly-client-ruby/tree/4.22.0) (2022-10-21)
 
 [Full Changelog](https://github.com/recurly/recurly-client-ruby/compare/4.21.1...4.22.0)

data/GETTING_STARTED.md

@@ -5,7 +5,7 @@ This repository houses the official ruby client for Recurly's V3 API.
 In your Gemfile, add `recurly` as a dependency.
 
 ```ruby
-gem 'recurly', '~> 4.22'
+gem 'recurly', '~> 4.24'
 ```
 
 > *Note*: We try to follow [semantic versioning](https://semver.org/) and will only apply breaking changes to major versions.

data/lib/recurly/client/operations.rb

@@ -4091,5 +4091,24 @@ module Recurly
       path = interpolate_path("/invoice_templates/{invoice_template_id}", invoice_template_id: invoice_template_id)
       get(path, **options)
     end
+
+    # Show all entitlements granted to an account
+    #
+    # {https://developers.recurly.com/api/v2021-02-25#operation/list_entitlements list_entitlements api documentation}
+    #
+    # @param account_id [String] Account ID or code. For ID no prefix is used e.g. +e28zov4fw0v2+. For code use prefix +code-+, e.g. +code-bob+.
+    # @param params [Hash] Optional query string parameters:
+    #        :state [String] Filter the entitlements based on the state of the applicable subscription.
+    #
+    #   - When +state=active+, +state=canceled+, +state=expired+, or +state=future+, subscriptions with states that match the query and only those subscriptions will be returned.
+    #   - When no state is provided, subscriptions with active or canceled states will be returned.
+    #
+    #
+    # @return [Pager<Resources::Entitlements>] A list of the entitlements granted to an account.
+    #
+    def list_entitlements(account_id:, **options)
+      path = interpolate_path("/accounts/{account_id}/entitlements", account_id: account_id)
+      pager(path, **options)
+    end
   end
 end

data/lib/recurly/errors/webhooks_errors.rb

@@ -0,0 +1,5 @@
+module Recurly
+  module Errors
+    class SignatureVerificationError < StandardError; end
+  end
+end

data/lib/recurly/errors.rb

@@ -48,4 +48,5 @@ module Recurly
 
   require_relative "./errors/api_errors"
   require_relative "./errors/network_errors"
+  require_relative "./errors/webhooks_errors"
 end

data/lib/recurly/resources/customer_permission.rb

@@ -0,0 +1,30 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class CustomerPermission < Resource
+
+      # @!attribute code
+      #   @return [String] Customer permission code.
+      define_attribute :code, String
+
+      # @!attribute description
+      #   @return [String] Description of customer permission.
+      define_attribute :description, String
+
+      # @!attribute id
+      #   @return [String] Customer permission ID.
+      define_attribute :id, String
+
+      # @!attribute name
+      #   @return [String] Customer permission name.
+      define_attribute :name, String
+
+      # @!attribute object
+      #   @return [String] It will always be "customer_permission".
+      define_attribute :object, String
+    end
+  end
+end

data/lib/recurly/resources/entitlement.rb

@@ -0,0 +1,30 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class Entitlement < Resource
+
+      # @!attribute created_at
+      #   @return [DateTime] Time object was created.
+      define_attribute :created_at, DateTime
+
+      # @!attribute customer_permission
+      #   @return [CustomerPermission]
+      define_attribute :customer_permission, :CustomerPermission
+
+      # @!attribute granted_by
+      #   @return [Array[GrantedBy]] Subscription or item that granted the customer permission.
+      define_attribute :granted_by, Array, { :item_type => :GrantedBy }
+
+      # @!attribute object
+      #   @return [String] Entitlement
+      define_attribute :object, String
+
+      # @!attribute updated_at
+      #   @return [DateTime] Time the object was last updated
+      define_attribute :updated_at, DateTime
+    end
+  end
+end

data/lib/recurly/resources/entitlements.rb

@@ -0,0 +1,26 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class Entitlements < Resource
+
+      # @!attribute data
+      #   @return [Array[Entitlement]]
+      define_attribute :data, Array, { :item_type => :Entitlement }
+
+      # @!attribute has_more
+      #   @return [Boolean] Indicates there are more results on subsequent pages.
+      define_attribute :has_more, :Boolean
+
+      # @!attribute next
+      #   @return [String] Path to subsequent page of results.
+      define_attribute :next, String
+
+      # @!attribute object
+      #   @return [String] Object Type
+      define_attribute :object, String
+    end
+  end
+end

data/lib/recurly/resources/granted_by.rb

@@ -0,0 +1,18 @@
+# This file is automatically created by Recurly's OpenAPI generation process
+# and thus any edits you make by hand will be lost. If you wish to make a
+# change to this file, please create a Github issue explaining the changes you
+# need and we will usher them to the appropriate places.
+module Recurly
+  module Resources
+    class GrantedBy < Resource
+
+      # @!attribute id
+      #   @return [String] The ID of the subscription or external subscription that grants the permission to the account.
+      define_attribute :id, String
+
+      # @!attribute object
+      #   @return [String] Object Type
+      define_attribute :object, String
+    end
+  end
+end

data/lib/recurly/version.rb

@@ -1,3 +1,3 @@
 module Recurly
-  VERSION = "4.22.0"
+  VERSION = "4.24.0"
 end

data/lib/recurly/webhooks.rb

@@ -0,0 +1,52 @@
+module Recurly
+  module Webhooks
+    DEFAULT_TOLERANCE = 5 * 60 * 1000
+
+    # Verify webhook signature
+    #
+    # @param header [String] recurly-signature header from request
+    # @param secret [String] Shared secret for notification endpoint
+    # @param body [String] Request POST body
+    # @param tolerance [Integer] Allowed notification time drift in milliseconds
+    # @example
+    #   begin
+    #     Recurly::Webhooks.verify_signature(header,
+    #                                        ENV['WEBHOOKS_KEY'],
+    #                                        request.body)
+    #   rescue Recurly::Errors::SignatureVerificationError => e
+    #     puts e.message
+    #   end
+    #
+    def self.verify_signature(header, secret, body, tolerance: DEFAULT_TOLERANCE)
+      s_timestamp, *signatures = header.split(",")
+      timestamp = Integer(s_timestamp)
+      now = (Time.now.to_f * 1000).to_i
+
+      if (now - timestamp).abs > tolerance
+        raise Recurly::Errors::SignatureVerificationError.new(
+          "Notification (#{Time.at(timestamp / 1000.0)}) is more than #{tolerance / 1000.0}s out of date"
+        )
+      end
+
+      expected = OpenSSL::HMAC.hexdigest("sha256", secret, "#{timestamp}.#{body}")
+
+      unless signatures.any? { |s| secure_compare(expected, s) }
+        raise Recurly::Errors::SignatureVerificationError.new(
+          "No matching signatures found for payload"
+        )
+      end
+    end
+
+    # https://github.com/rack/rack/blob/2-2-stable/lib/rack/utils.rb#L374
+    # https://github.com/heartcombo/devise/blob/4-1-stable/lib/devise.rb#L477
+    def self.secure_compare(a, b)
+      return false if a.bytesize != b.bytesize
+      l = a.unpack("C#{a.bytesize}")
+
+      res = 0
+      b.each_byte { |byte| res |= byte ^ l.shift }
+      res == 0
+    end
+    private_class_method :secure_compare
+  end
+end

data/lib/recurly.rb

@@ -9,6 +9,7 @@ require "recurly/http"
 require "recurly/errors"
 require "recurly/connection_pool"
 require "recurly/client"
+require "recurly/webhooks"
 
 module Recurly
   STRICT_MODE = ENV["RECURLY_STRICT_MODE"] && ENV["RECURLY_STRICT_MODE"].downcase == "true"

data/openapi/api.yaml

@@ -305,6 +305,8 @@ tags:
   description: A purchase is a checkout containing at least one or more subscriptions
     or one-time charges (line items) and supports both coupon and gift card redemptions.
     All items purchased will be on one invoice and paid for with one transaction.
+    The purchases endpoint can also be used to immediately create a credit invoice
+    on an account, when Credit Invoices is enabled on your site.
 - name: usage
   x-displayName: Usage
   description: Send Recurly your customer usage and we will automatically bill them
@@ -3773,6 +3775,8 @@ paths:
       - line_item
       operationId: create_line_item
       summary: Create a new line item for the account
+      description: When using the Credit Invoices feature, utilize the purchases endpoint
+        in order to immediately post credit to a credit invoice.
       parameters:
       - "$ref": "#/components/parameters/account_id"
       requestBody:
@@ -15065,6 +15069,35 @@ paths:
               schema:
                 "$ref": "#/components/schemas/Error"
       x-code-samples: []
+  "/accounts/{account_id}/entitlements":
+    parameters:
+    - "$ref": "#/components/parameters/account_id"
+    - "$ref": "#/components/parameters/filter_limited_subscription_state"
+    get:
+      tags:
+      - account
+      operationId: list_entitlements
+      summary: Show all entitlements granted to an account
+      responses:
+        '200':
+          description: A list of the entitlements granted to an account.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Entitlements"
+        '404':
+          description: Incorrect site or account ID.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+        default:
+          description: Unexpected error.
+          content:
+            application/json:
+              schema:
+                "$ref": "#/components/schemas/Error"
+      x-code-samples: []
 servers:
 - url: https://v3.recurly.com
 - url: https://v3.eu.recurly.com
@@ -15306,6 +15339,16 @@ components:
         - When `state=live`, only subscriptions that are in an active, canceled, or future state or are in trial will be returned.
       schema:
         "$ref": "#/components/schemas/FilterSubscriptionStateEnum"
+    filter_limited_subscription_state:
+      name: state
+      in: query
+      description: |
+        Filter the entitlements based on the state of the applicable subscription.
+
+        - When `state=active`, `state=canceled`, `state=expired`, or `state=future`, subscriptions with states that match the query and only those subscriptions will be returned.
+        - When no state is provided, subscriptions with active or canceled states will be returned.
+      schema:
+        "$ref": "#/components/schemas/FilterLimitedSubscriptionStateEnum"
     filter_begin_time:
       name: begin_time
       in: query
@@ -22093,6 +22136,75 @@ components:
           maxItems: 200
           items:
             "$ref": "#/components/schemas/Plan"
+    Entitlements:
+      type: object
+      description: A list of privileges granted to a customer through the purchase
+        of a plan or item.
+      properties:
+        object:
+          type: string
+          title: Object Type
+        has_more:
+          type: boolean
+          description: Indicates there are more results on subsequent pages.
+        next:
+          type: string
+          description: Path to subsequent page of results.
+        data:
+          type: array
+          items:
+            "$ref": "#/components/schemas/Entitlement"
+    Entitlement:
+      type: object
+      properties:
+        object:
+          type: string
+          description: Entitlement
+        customer_permission:
+          "$ref": "#/components/schemas/CustomerPermission"
+        granted_by:
+          type: array
+          description: Subscription or item that granted the customer permission.
+          items:
+            "$ref": "#/components/schemas/GrantedBy"
+        created_at:
+          type: string
+          format: date-time
+          description: Time object was created.
+        updated_at:
+          type: string
+          format: date-time
+          description: Time the object was last updated
+    CustomerPermission:
+      type: object
+      properties:
+        id:
+          type: string
+          description: Customer permission ID.
+        code:
+          type: string
+          description: Customer permission code.
+        name:
+          type: string
+          description: Customer permission name.
+        description:
+          type: string
+          description: Description of customer permission.
+        object:
+          type: string
+          description: It will always be "customer_permission".
+    GrantedBy:
+      type: object
+      description: The subscription or external subscription that grants customer
+        permissions.
+      properties:
+        object:
+          type: string
+          title: Object Type
+        id:
+          type: string
+          description: The ID of the subscription or external subscription that grants
+            the permission to the account.
     InvoiceTemplateList:
       type: object
       properties:
@@ -22306,6 +22418,13 @@ components:
       - future
       - in_trial
       - live
+    FilterLimitedSubscriptionStateEnum:
+      type: string
+      enum:
+      - active
+      - canceled
+      - expired
+      - future
     TrueEnum:
       type: string
       enum:

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: recurly
 version: !ruby/object:Gem::Version
-  version: 4.22.0
+  version: 4.24.0
 platform: ruby
 authors:
 - Recurly
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-10-21 00:00:00.000000000 Z
+date: 2022-11-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -141,6 +141,7 @@ files:
 - lib/recurly/errors.rb
 - lib/recurly/errors/api_errors.rb
 - lib/recurly/errors/network_errors.rb
+- lib/recurly/errors/webhooks_errors.rb
 - lib/recurly/http.rb
 - lib/recurly/pager.rb
 - lib/recurly/request.rb
@@ -239,16 +240,20 @@ files:
 - lib/recurly/resources/credit_payment.rb
 - lib/recurly/resources/custom_field.rb
 - lib/recurly/resources/custom_field_definition.rb
+- lib/recurly/resources/customer_permission.rb
 - lib/recurly/resources/dunning_campaign.rb
 - lib/recurly/resources/dunning_campaigns_bulk_update_response.rb
 - lib/recurly/resources/dunning_cycle.rb
 - lib/recurly/resources/dunning_interval.rb
+- lib/recurly/resources/entitlement.rb
+- lib/recurly/resources/entitlements.rb
 - lib/recurly/resources/error.rb
 - lib/recurly/resources/error_may_have_transaction.rb
 - lib/recurly/resources/export_dates.rb
 - lib/recurly/resources/export_file.rb
 - lib/recurly/resources/export_files.rb
 - lib/recurly/resources/fraud_info.rb
+- lib/recurly/resources/granted_by.rb
 - lib/recurly/resources/invoice.rb
 - lib/recurly/resources/invoice_address.rb
 - lib/recurly/resources/invoice_collection.rb
@@ -300,6 +305,7 @@ files:
 - lib/recurly/schema/schema_factory.rb
 - lib/recurly/schema/schema_validator.rb
 - lib/recurly/version.rb
+- lib/recurly/webhooks.rb
 - openapi/api.yaml
 - recurly.gemspec
 - scripts/build
@@ -316,7 +322,7 @@ metadata:
   changelog_uri: https://github.com/recurly/recurly-client-ruby/blob/master/CHANGELOG.md
   documentation_uri: https://recurly.github.io/recurly-client-ruby/
   homepage_uri: https://github.com/recurly/recurly-client-ruby
-  source_code_uri: https://github.com/recurly/recurly-client-ruby/tree/4.22.0
+  source_code_uri: https://github.com/recurly/recurly-client-ruby/tree/4.24.0
 post_install_message: 
 rdoc_options: []
 require_paths: