chartmogul-ruby 4.0.0 → 4.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66ebd465c81aa14f0e68e406fd7a4b29137d3d019d6ceb4e1da1aaf1d40b0ef4
-  data.tar.gz: 7380c7be4a87d8d8822702eeed51d50dbf36fabbb727d4469239d023282c14eb
+  metadata.gz: a3b8bd924faadff9fa39d58c82373990d3119062c8d41c906d860b84044ceed7
+  data.tar.gz: 57a6b61d7d3bf2be673e5440e13134dab756c89197327603efc4751a664aa40e
 SHA512:
-  metadata.gz: 20c35e5c04d023dce1487916c10a543afe6773c2781ffe10b324045e9c6cad1c7e9b7521d16007fae4ce7345c1f34d06dfd40ed98dd8941ead4f435728ffda06
-  data.tar.gz: fd0be8d9cee2c624e945f33f55effcea1825d7f72913f0d765b97e70084a1ba3fc0561ad0b922f4691e3b2daa3a70a82b87b8d7b44ec72bb69a107e528bfb332
+  metadata.gz: e2bcf5852f793c756bc20557cb2ba03063d096d71e713fc1d031f4eab81bc2b43e1a0d2616c74d3c4b3ae908da3e4925ae309405b424d2c35bc257586ecab19f
+  data.tar.gz: 99e6484f7f7d9318ac809f82c7b9ffefd28ec23601709eb4d1f18f3baa0bc21947375314ba33fced2d1d92aefd44cfb800340cf53d72f7f2c59945f868eef96d

data/4.0-Upgrade.md

@@ -0,0 +1,43 @@
+# Upgrading to chartmogul-ruby 4.0.0
+
+This new version replaces the existing pagination for the `.all()` endpoints that used a combination
+of `page` and `per_page` parameters, and instead uses a `cursor` based pagination. So to list
+(as an example) Plans you now can:
+
+```ruby
+ChartMogul.api_key = '<API key goes here>'
+
+# Getting the first page
+plans = ChartMogul::Plan.all(per_page: 12)
+```
+
+This will return an array of plans (if available), and a cursor + has_more fields:
+
+```json
+{
+    "plans": [
+        {
+            "uuid": "some_uuid",
+            "data_source_uuid": "some_uuid",
+            "name": "Master Plan"
+        }
+    ],
+    "has_more": true,
+    "cursor": "MjAyMy0wNy0yOFQwODowOToyMi4xNTQyMDMwMDBaJjk0NDQ0Mg=="
+}
+```
+
+```ruby
+# You can get the following pages by passing a cursor to .all
+if plans.has_more
+  more_plans = ChartMogul::Plan.all(per_page: 12, cursor: plans.cursor)
+end
+
+# Or by calling .next on the result
+if plans.has_more
+  more_plans = plans.next(per_page: 3)
+end
+```
+
+If you have existing code that relies on the `page` parameter, those requests will now throw an error
+alerting you of their deprecation.

data/README.md

@@ -47,6 +47,7 @@ Or install it yourself as:
     $ gem install chartmogul-ruby
 
 ### Supported Ruby Versions
+
 This gem supports Ruby 2.7 and above.
 
 ## Configuration
@@ -66,6 +67,7 @@ ChartMogul.api_key = '<API key goes here>'
 Thread-safe configuration is used if available, otherwise global is used.
 
 Test your authentication:
+
 ```ruby
 ChartMogul::Ping.ping
 ```
@@ -100,9 +102,11 @@ You can find examples for each endpoint in the ChartMogul [API documentation](ht
 The library will keep retrying if the request exceeds the rate limit or if there's any network related error. By default, the request will be retried for 20 times (approximated 15 minutes) before finally giving up.
 
 You can change the retry count with:
+
 ```ruby
 ChartMogul.max_retries = 15
 ```
+
 Set it to 0 to disable it.
 
 ## Development

data/changelog.md

@@ -1,5 +1,15 @@
 # chartmogul-ruby Change Log
 
+## Version 4.2.0 - February 8, 2024
+- Add support for customer's `website_url` attribute
+- Add support for customer's subscription `uuid` attribute
+
+## Version 4.1.0 - December 20, 2023
+- Adds support for Customer Notes
+
+## Version 4.0.1 - November 7 2023
+- Add upgrade guide from v3.x to v4.x
+
 ## Version 4.0.0 - November 1 2023
 - Remove support for old pagination using `page` parameter.
 - Drop support for Ruby versions below 2.7.

data/lib/chartmogul/customer.rb

@@ -36,6 +36,7 @@ module ChartMogul
     writeable_attr :free_trial_started_at, type: :time
     writeable_attr :owner
     writeable_attr :primary_contact
+    writeable_attr :website_url
 
     include API::Actions::Create
     include API::Actions::Custom
@@ -84,6 +85,14 @@ module ChartMogul
       Contact.create!(options.merge(customer_uuid: uuid))
     end
 
+    def notes(options = {})
+      Notes.all(options.merge(customer_uuid: uuid))
+    end
+
+    def create_note(options = {})
+      Note.create!(options.merge(customer_uuid: uuid))
+    end
+
     # Enrichment
     def tags
       @attributes[:tags]

data/lib/chartmogul/metrics/customers/subscription.rb

@@ -5,6 +5,7 @@ module ChartMogul
     module Customers
       class Subscription < ChartMogul::Object
         readonly_attr :id
+        readonly_attr :uuid
         readonly_attr :external_id
         readonly_attr :plan
         readonly_attr :quantity

data/lib/chartmogul/note.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+
+module ChartMogul
+  class Note < APIResource
+    set_resource_name 'CustomerNote'
+    set_resource_path '/v1/customer_notes'
+
+    readonly_attr :uuid
+
+    writeable_attr :customer_uuid
+    writeable_attr :type
+    writeable_attr :text
+    writeable_attr :author
+    writeable_attr :text
+    writeable_attr :call_duration
+    writeable_attr :created_at
+    writeable_attr :updated_at
+
+    include API::Actions::Create
+    include API::Actions::Destroy
+    include API::Actions::Retrieve
+    include API::Actions::Update
+
+    def self.all(options = {})
+      Notes.all(options)
+    end
+  end
+
+  class Notes < APIResource
+    set_resource_name 'CustomerNotes'
+    set_resource_path '/v1/customer_notes'
+
+    include Concerns::Entries
+    include Concerns::PageableWithCursor
+
+    set_entry_class Note
+  end
+end

data/lib/chartmogul/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ChartMogul
-  VERSION = '4.0.0'
+  VERSION = '4.2.0'
 end

data/lib/chartmogul.rb

@@ -55,6 +55,7 @@ require 'chartmogul/subscription'
 require 'chartmogul/invoice'
 require 'chartmogul/customer_invoices'
 require 'chartmogul/customer'
+require 'chartmogul/note'
 require 'chartmogul/contact'
 require 'chartmogul/data_source'
 require 'chartmogul/ping'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: chartmogul-ruby
 version: !ruby/object:Gem::Version
-  version: 4.0.0
+  version: 4.2.0
 platform: ruby
 authors:
 - Petr Kopac
-autorequire:
+autorequire: 
 bindir: exe
 cert_chain: []
-date: 2023-11-02 00:00:00.000000000 Z
+date: 2024-02-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -189,6 +189,7 @@ files:
 - ".gitignore"
 - ".rspec"
 - 2.0-Upgrade.md
+- 4.0-Upgrade.md
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -247,6 +248,7 @@ files:
 - lib/chartmogul/metrics/ltv.rb
 - lib/chartmogul/metrics/mrr.rb
 - lib/chartmogul/metrics/mrr_churn_rate.rb
+- lib/chartmogul/note.rb
 - lib/chartmogul/object.rb
 - lib/chartmogul/ping.rb
 - lib/chartmogul/plan.rb
@@ -287,8 +289,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.7
-signing_key:
+rubygems_version: 3.1.4
+signing_key: 
 specification_version: 4
 summary: Chartmogul API Ruby Client
 test_files: []