lago-ruby-client 1.32.0 → 1.33.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4f13f9b64684cd3ffb7704dee078805dacc1d53e24015452916ecd12984da76e
-  data.tar.gz: 03fd94112276012a112f7c82e029037a0f0c6d9e4bbe1b5aa0ce863d04b278df
+  metadata.gz: ae486c8aa536d42665ea1994923d83baa1a35b782a8d679d3b39fc2aeb36f983
+  data.tar.gz: e5d0735075100f36509294a93413e58fab3108626522aef0fcbc47b78a3d5057
 SHA512:
-  metadata.gz: c2b6a6aa21c41a3850cc529f0c3df65d5dc8c1bfc6509caba895c3d1ef0a637a02e3633ddaa145b773defa0dbd61201e628844fde40fdbbc24147a86768bb9f7
-  data.tar.gz: 9950cef24db981e02517a536c4690f470ab8070de70cef3e768bdff1ed9e13ddcf211726728ebb77711a8cd9422acb0f82d8620c8e72d373e034585912702d14
+  metadata.gz: 0c3c2e3a7829ed0e421f503f01228853e5e45e5e957f0c39efca95bdbb243e7a065f1678b66fa850dfe0d3febdb0f4b4c6d5c14429905ed7843a2db8c2473df7
+  data.tar.gz: 604bc299b1ac0b145879db8f476126378de33e1189ddd778fd3900eabad78e1178e28fce1c18e251a67e2a20ce7e68fb05e9032524057ef29278e6252118faf6

data/lib/lago/api/client.rb

@@ -11,6 +11,7 @@ require 'lago/api/resources/coupon'
 require 'lago/api/resources/credit_note'
 require 'lago/api/resources/customer'
 require 'lago/api/resources/event'
+require 'lago/api/resources/feature'
 require 'lago/api/resources/fee'
 require 'lago/api/resources/gross_revenue'
 require 'lago/api/resources/invoice'
@@ -25,6 +26,7 @@ require 'lago/api/resources/payment_request'
 require 'lago/api/resources/plan'
 require 'lago/api/resources/subscription'
 require 'lago/api/resources/tax'
+require 'lago/api/resources/usage'
 require 'lago/api/resources/wallet'
 require 'lago/api/resources/wallet_transaction'
 require 'lago/api/resources/webhook'
@@ -100,6 +102,10 @@ module Lago
         Resources::Event.new(self)
       end
 
+      def features
+        Resources::Feature.new(self)
+      end
+
       def fees
         Resources::Fee.new(self)
       end

data/lib/lago/api/connection.rb

@@ -33,6 +33,18 @@ module Lago
         handle_response(response)
       end
 
+      def patch(path = uri.path, identifier:, body:)
+        uri_path = identifier.nil? ? path : "#{path}/#{URI.encode_www_form_component(identifier)}"
+        response = http_client.send_request(
+          'PATCH',
+          uri_path,
+          prepare_payload(body),
+          headers
+        )
+
+        handle_response(response)
+      end
+
       def get(path = uri.path, identifier:)
         uri_path = identifier.nil? ? path : "#{path}/#{URI.encode_www_form_component(identifier)}"
         response = http_client.send_request(

data/lib/lago/api/resources/feature.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+module Lago
+  module Api
+    module Resources
+      class Feature < Base
+        def api_resource
+          'features'
+        end
+
+        def root_name
+          'feature'
+        end
+
+        def whitelist_params(params)
+          result_hash = {
+            code: params[:code],
+            name: params[:name],
+            description: params[:description],
+            privileges: whitelist_privileges_params(params[:privileges]),
+          }.compact
+
+          { root_name => result_hash }
+        end
+
+        def whitelist_privileges_params(privileges)
+          privileges&.map do |privilege|
+            {
+              code: privilege[:code],
+              name: privilege[:name],
+              value_type: privilege[:value_type],
+              config: {
+                select_options: privilege[:config][:select_options],
+              },
+            }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/lago/api/resources/plan.rb

@@ -14,6 +14,46 @@ module Lago
           'plan'
         end
 
+        def get_entitlements(plan_code)
+          response = connection.get(entitlements_uri(plan_code), identifier: nil)
+          JSON.parse(response.to_json, object_class: OpenStruct).entitlements
+        end
+
+        def create_entitlements(plan_code, params)
+          response = connection.post(
+            whitelist_entitlements_params(params),
+            entitlements_uri(plan_code),
+          )
+          JSON.parse(response.to_json, object_class: OpenStruct).entitlements
+        end
+
+        def update_entitlements(plan_code, params)
+          response = connection.patch(
+            entitlements_uri(plan_code),
+            identifier: nil,
+            body: whitelist_entitlements_params(params),
+          )
+          JSON.parse(response.to_json, object_class: OpenStruct).entitlements
+        end
+
+        def get_entitlement(plan_code, feature_code)
+          response = connection.get(entitlements_uri(plan_code, feature_code), identifier: nil)
+          JSON.parse(response.to_json, object_class: OpenStruct).entitlement
+        end
+
+        def delete_entitlement(plan_code, feature_code)
+          response = connection.destroy(entitlements_uri(plan_code, feature_code), identifier: nil)
+          JSON.parse(response.to_json, object_class: OpenStruct).entitlement
+        end
+
+        def delete_entitlement_privilege(plan_code, feature_code, privilege_code)
+          response = connection.destroy(
+            entitlements_uri(plan_code, feature_code, "privileges/#{privilege_code}"),
+            identifier: nil,
+          )
+          JSON.parse(response.to_json, object_class: OpenStruct).entitlement
+        end
+
         def whitelist_params(params)
           result_hash = {
             name: params[:name],
@@ -94,6 +134,21 @@ module Lago
 
           processed_usage_thresholds
         end
+
+        def whitelist_entitlements_params(params)
+          {
+            entitlements: params,
+          }
+        end
+
+        private
+
+        def entitlements_uri(plan_code, feature_code = nil, action = nil)
+          url = "#{client.base_api_url}#{api_resource}/#{plan_code}/entitlements"
+          url += "/#{feature_code}" if feature_code
+          url += "/#{action}" if action
+          URI(url)
+        end
       end
     end
   end

data/lib/lago/api/resources/subscription.rb

@@ -35,6 +35,33 @@ module Lago
           JSON.parse(response.to_json, object_class: OpenStruct).lifetime_usage
         end
 
+        def get_entitlements(external_subscription_id)
+          response = connection.get(entitlements_uri(external_subscription_id), identifier: nil)
+          JSON.parse(response.to_json, object_class: OpenStruct).entitlements
+        end
+
+        def update_entitlements(external_subscription_id, params)
+          response = connection.patch(
+            entitlements_uri(external_subscription_id),
+            identifier: nil,
+            body: whitelist_entitlements_update_params(params),
+          )
+          JSON.parse(response.to_json, object_class: OpenStruct)
+        end
+
+        def delete_entitlement(external_subscription_id, feature_code)
+          response = connection.destroy(entitlements_uri(external_subscription_id, feature_code), identifier: nil)
+          JSON.parse(response.to_json, object_class: OpenStruct)
+        end
+
+        def delete_entitlement_privilege(external_subscription_id, entitlement_code, privilege_code)
+          response = connection.destroy(
+            entitlements_uri(external_subscription_id, entitlement_code, "privileges/#{privilege_code}"),
+            identifier: nil,
+          )
+          JSON.parse(response.to_json, object_class: OpenStruct)
+        end
+
         def get_alert(external_subscription_id, code)
           response = connection.get(alert_uri(external_subscription_id, code), identifier: nil)
           JSON.parse(response.to_json, object_class: OpenStruct).alert
@@ -119,8 +146,21 @@ module Lago
           end
         end
 
+        def whitelist_entitlements_update_params(params)
+          {
+            entitlements: params,
+          }
+        end
+
         private
 
+        def entitlements_uri(external_subscription_id, feature_code = nil, action = nil)
+          url = "#{client.base_api_url}#{api_resource}/#{external_subscription_id}/entitlements"
+          url += "/#{feature_code}" if feature_code
+          url += "/#{action}" if action
+          URI(url)
+        end
+
         def alert_uri(external_subscription_id, code = nil)
           URI("#{client.base_api_url}#{api_resource}/#{external_subscription_id}/alerts#{code ? "/#{code}" : ''}")
         end

data/lib/lago/api/resources/usage.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Lago
+  module Api
+    module Resources
+      class Usage < Base
+        def api_resource
+          'analytics/usage'
+        end
+
+        def root_name
+          'usage'
+        end
+      end
+    end
+  end
+end

data/lib/lago/api/resources/wallet.rb

@@ -62,7 +62,7 @@ module Lago
         end
 
         def whitelist_applies_to(applies_to_params)
-          (applies_to_params || {}).slice(:fee_types)
+          (applies_to_params || {}).slice(:fee_types, :billable_metric_codes)
         end
       end
     end

data/lib/lago/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Lago
-  VERSION = '1.32.0'
+  VERSION = '1.33.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: lago-ruby-client
 version: !ruby/object:Gem::Version
-  version: 1.32.0
+  version: 1.33.0
 platform: ruby
 authors:
 - Lovro Colic
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-07-24 00:00:00.000000000 Z
+date: 2025-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: jwt
@@ -242,6 +242,7 @@ files:
 - lib/lago/api/resources/credit_note.rb
 - lib/lago/api/resources/customer.rb
 - lib/lago/api/resources/event.rb
+- lib/lago/api/resources/feature.rb
 - lib/lago/api/resources/fee.rb
 - lib/lago/api/resources/gross_revenue.rb
 - lib/lago/api/resources/invoice.rb
@@ -256,6 +257,7 @@ files:
 - lib/lago/api/resources/plan.rb
 - lib/lago/api/resources/subscription.rb
 - lib/lago/api/resources/tax.rb
+- lib/lago/api/resources/usage.rb
 - lib/lago/api/resources/wallet.rb
 - lib/lago/api/resources/wallet_transaction.rb
 - lib/lago/api/resources/webhook.rb