chartmogul-ruby 4.0.0 → 4.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66ebd465c81aa14f0e68e406fd7a4b29137d3d019d6ceb4e1da1aaf1d40b0ef4
-  data.tar.gz: 7380c7be4a87d8d8822702eeed51d50dbf36fabbb727d4469239d023282c14eb
+  metadata.gz: 8f528ebe8e70838100b70e1b0b303f7032bb406cb982840de597fcef929e5f1f
+  data.tar.gz: 21150268340facfa3466b2a31d3d0eac3c1aed868608f0de265b2a6d619cb000
 SHA512:
-  metadata.gz: 20c35e5c04d023dce1487916c10a543afe6773c2781ffe10b324045e9c6cad1c7e9b7521d16007fae4ce7345c1f34d06dfd40ed98dd8941ead4f435728ffda06
-  data.tar.gz: fd0be8d9cee2c624e945f33f55effcea1825d7f72913f0d765b97e70084a1ba3fc0561ad0b922f4691e3b2daa3a70a82b87b8d7b44ec72bb69a107e528bfb332
+  metadata.gz: c822a95c9fa65a4c13ad4d0bc35c370714fdfac2dd375bbca1b494ce19d2e8e6482639136a67d43278d25ae53c0e53694e02e08e7fd89b5a8c1faf077c4d559e
+  data.tar.gz: 2313f6a228d0d0cbfd17550a41ae7fbe31be01187779217bff7a7ece3505df310bdef483eb308c784cb8dd238184955f383a0236bcb6c2b0df42e2253d14c496

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,11 @@
 # chartmogul-ruby Change Log
 
+## 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

@@ -84,6 +84,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/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.1.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.1.0
 platform: ruby
 authors:
 - Petr Kopac
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-11-02 00:00:00.000000000 Z
+date: 2023-12-20 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,7 +289,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.7
+rubygems_version: 3.4.21
 signing_key:
 specification_version: 4
 summary: Chartmogul API Ruby Client