maxio-advanced-billing-sdk 5.2.0 → 6.1.0

data/lib/advanced_billing/models/ebb_event.rb

@@ -33,12 +33,12 @@ module AdvancedBilling
     end
 
     def initialize(chargify: SKIP, additional_properties: {})
-      @chargify = chargify unless chargify == SKIP
-
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
       end
+
+      @chargify = chargify unless chargify == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -49,11 +49,25 @@ module AdvancedBilling
       chargify = ChargifyEBB.from_hash(hash['chargify']) if hash['chargify']
 
       # Clean out expected properties from Hash.
-      names.each_value { |k| hash.delete(k) }
+      additional_properties = hash.reject { |k, _| names.value?(k) }
 
       # Create object from extracted values.
       EBBEvent.new(chargify: chargify,
-                   additional_properties: hash)
+                   additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} chargify: #{@chargify}, additional_properties:"\
+      " #{get_additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} chargify: #{@chargify.inspect}, additional_properties:"\
+      " #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/enable_webhooks_request.rb

@@ -31,12 +31,12 @@ module AdvancedBilling
     end
 
     def initialize(webhooks_enabled:, additional_properties: {})
-      @webhooks_enabled = webhooks_enabled
-
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
       end
+
+      @webhooks_enabled = webhooks_enabled
     end
 
     # Creates an instance of the object from a hash.
@@ -48,11 +48,25 @@ module AdvancedBilling
         hash.key?('webhooks_enabled') ? hash['webhooks_enabled'] : nil
 
       # Clean out expected properties from Hash.
-      names.each_value { |k| hash.delete(k) }
+      additional_properties = hash.reject { |k, _| names.value?(k) }
 
       # Create object from extracted values.
       EnableWebhooksRequest.new(webhooks_enabled: webhooks_enabled,
-                                additional_properties: hash)
+                                additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} webhooks_enabled: #{@webhooks_enabled}, additional_properties:"\
+      " #{get_additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} webhooks_enabled: #{@webhooks_enabled.inspect}, additional_properties:"\
+      " #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/enable_webhooks_response.rb

@@ -33,12 +33,12 @@ module AdvancedBilling
     end
 
     def initialize(webhooks_enabled: SKIP, additional_properties: {})
-      @webhooks_enabled = webhooks_enabled unless webhooks_enabled == SKIP
-
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
       end
+
+      @webhooks_enabled = webhooks_enabled unless webhooks_enabled == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -50,11 +50,25 @@ module AdvancedBilling
         hash.key?('webhooks_enabled') ? hash['webhooks_enabled'] : SKIP
 
       # Clean out expected properties from Hash.
-      names.each_value { |k| hash.delete(k) }
+      additional_properties = hash.reject { |k, _| names.value?(k) }
 
       # Create object from extracted values.
       EnableWebhooksResponse.new(webhooks_enabled: webhooks_enabled,
-                                 additional_properties: hash)
+                                 additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} webhooks_enabled: #{@webhooks_enabled}, additional_properties:"\
+      " #{get_additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} webhooks_enabled: #{@webhooks_enabled.inspect}, additional_properties:"\
+      " #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/endpoint.rb

@@ -58,16 +58,16 @@ module AdvancedBilling
 
     def initialize(id: SKIP, url: SKIP, site_id: SKIP, status: SKIP,
                    webhook_subscriptions: SKIP, additional_properties: {})
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
+
       @id = id unless id == SKIP
       @url = url unless url == SKIP
       @site_id = site_id unless site_id == SKIP
       @status = status unless status == SKIP
       @webhook_subscriptions = webhook_subscriptions unless webhook_subscriptions == SKIP
-
-      # Add additional model properties to the instance.
-      additional_properties.each do |_name, _value|
-        instance_variable_set("@#{_name}", _value)
-      end
     end
 
     # Creates an instance of the object from a hash.
@@ -83,7 +83,7 @@ module AdvancedBilling
         hash.key?('webhook_subscriptions') ? hash['webhook_subscriptions'] : SKIP
 
       # Clean out expected properties from Hash.
-      names.each_value { |k| hash.delete(k) }
+      additional_properties = hash.reject { |k, _| names.value?(k) }
 
       # Create object from extracted values.
       Endpoint.new(id: id,
@@ -91,7 +91,23 @@ module AdvancedBilling
                    site_id: site_id,
                    status: status,
                    webhook_subscriptions: webhook_subscriptions,
-                   additional_properties: hash)
+                   additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, url: #{@url}, site_id: #{@site_id}, status: #{@status},"\
+      " webhook_subscriptions: #{@webhook_subscriptions}, additional_properties:"\
+      " #{get_additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, url: #{@url.inspect}, site_id: #{@site_id.inspect},"\
+      " status: #{@status.inspect}, webhook_subscriptions: #{@webhook_subscriptions.inspect},"\
+      " additional_properties: #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/endpoint_response.rb

@@ -33,12 +33,12 @@ module AdvancedBilling
     end
 
     def initialize(endpoint: SKIP, additional_properties: {})
-      @endpoint = endpoint unless endpoint == SKIP
-
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
       end
+
+      @endpoint = endpoint unless endpoint == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -49,11 +49,25 @@ module AdvancedBilling
       endpoint = Endpoint.from_hash(hash['endpoint']) if hash['endpoint']
 
       # Clean out expected properties from Hash.
-      names.each_value { |k| hash.delete(k) }
+      additional_properties = hash.reject { |k, _| names.value?(k) }
 
       # Create object from extracted values.
       EndpointResponse.new(endpoint: endpoint,
-                           additional_properties: hash)
+                           additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} endpoint: #{@endpoint}, additional_properties:"\
+      " #{get_additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} endpoint: #{@endpoint.inspect}, additional_properties:"\
+      " #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/errors.rb

@@ -39,13 +39,13 @@ module AdvancedBilling
     end
 
     def initialize(per_page: SKIP, price_point: SKIP, additional_properties: {})
-      @per_page = per_page unless per_page == SKIP
-      @price_point = price_point unless price_point == SKIP
-
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
       end
+
+      @per_page = per_page unless per_page == SKIP
+      @price_point = price_point unless price_point == SKIP
     end
 
     # Creates an instance of the object from a hash.
@@ -57,12 +57,26 @@ module AdvancedBilling
       price_point = hash.key?('price_point') ? hash['price_point'] : SKIP
 
       # Clean out expected properties from Hash.
-      names.each_value { |k| hash.delete(k) }
+      additional_properties = hash.reject { |k, _| names.value?(k) }
 
       # Create object from extracted values.
       Errors.new(per_page: per_page,
                  price_point: price_point,
-                 additional_properties: hash)
+                 additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} per_page: #{@per_page}, price_point: #{@price_point},"\
+      " additional_properties: #{get_additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} per_page: #{@per_page.inspect}, price_point: #{@price_point.inspect},"\
+      " additional_properties: #{get_additional_properties}>"
     end
   end
 end

data/lib/advanced_billing/models/event.rb

@@ -15,7 +15,7 @@ module AdvancedBilling
     attr_accessor :id
 
     # TODO: Write general description for this method
-    # @return [String]
+    # @return [EventKey]
     attr_accessor :key
 
     # TODO: Write general description for this method
@@ -34,7 +34,67 @@ module AdvancedBilling
     # @return [DateTime]
     attr_accessor :created_at
 
-    # TODO: Write general description for this method
+    # The schema varies based on the event key. The key-to-event data mapping is
+    # as follows:
+    # * `subscription_product_change` - SubscriptionProductChange
+    # * `subscription_state_change` - SubscriptionStateChange
+    # * `signup_success`, `delayed_signup_creation_success`, `payment_success`,
+    # `payment_failure`, `renewal_success`, `renewal_failure`,
+    # `chargeback_lost`, `chargeback_accepted`, `chargeback_closed` -
+    # PaymentRelatedEvents
+    # * `refund_success` - RefundSuccess
+    # * `component_allocation_change` - ComponentAllocationChange
+    # * `metered_usage` - MeteredUsage
+    # * `prepaid_usage` - PrepaidUsage
+    # * `dunning_step_reached` - DunningStepReached
+    # * `invoice_issued` - InvoiceIssued
+    # * `pending_cancellation_change` - PendingCancellationChange
+    # * `prepaid_subscription_balance_changed` -
+    # PrepaidSubscriptionBalanceChanged
+    # * `subscription_group_signup_success` and
+    # `subscription_group_signup_failure` - SubscriptionGroupSignupEventData
+    # * `proforma_invoice_issued` - ProformaInvoiceIssued
+    # * `subscription_prepayment_account_balance_changed` -
+    # PrepaymentAccountBalanceChanged
+    # * `payment_collection_method_changed` - PaymentCollectionMethodChanged
+    # * `subscription_service_credit_account_balance_changed` -
+    # CreditAccountBalanceChanged
+    # * `item_price_point_changed` - ItemPricePointChanged
+    # * `custom_field_value_change` - CustomFieldValueChange
+    # * The rest, that is `delayed_signup_creation_failure`,
+    # `billing_date_change`, `expiration_date_change`, `expiring_card`, 
+    # `customer_update`, `customer_create`, `customer_delete`,
+    # `upgrade_downgrade_success`, `upgrade_downgrade_failure`, 
+    # `statement_closed`, `statement_settled`, `subscription_card_update`,
+    # `subscription_group_card_update`, 
+    # `subscription_bank_account_update`, `refund_failure`,
+    # `upcoming_renewal_notice`, `trial_end_notice`, 
+    # `direct_debit_payment_paid_out`, `direct_debit_payment_rejected`,
+    # `direct_debit_payment_pending`, `pending_payment_created`, 
+    # `pending_payment_failed`, `pending_payment_completed`,  don't have
+    # event_specific_data defined,
+    # `renewal_success_recreated`, `renewal_failure_recreated`,
+    # `payment_success_recreated`, `payment_failure_recreated`,
+    # `subscription_deletion`, `subscription_group_bank_account_update`,
+    # `subscription_paypal_account_update`,
+    # `subscription_group_paypal_account_update`,
+    # `subscription_customer_change`, `account_transaction_changed`,
+    # `go_cardless_payment_paid_out`, `go_cardless_payment_rejected`,
+    # `go_cardless_payment_pending`, `stripe_direct_debit_payment_paid_out`,
+    # `stripe_direct_debit_payment_rejected`,
+    # `stripe_direct_debit_payment_pending`,
+    # `maxio_payments_direct_debit_payment_paid_out`,
+    # `maxio_payments_direct_debit_payment_rejected`,
+    # `maxio_payments_direct_debit_payment_pending`,
+    # `invoice_in_collections_canceled`, `subscription_added_to_group`,
+    # `subscription_removed_from_group`, `chargeback_opened`, `chargeback_lost`,
+    # `chargeback_accepted`, `chargeback_closed`, `chargeback_won`,
+    # `payment_collection_method_changed`, `component_billing_date_changed`,
+    # `subscription_term_renewal_scheduled`,
+    # `subscription_term_renewal_pending`,
+    # `subscription_term_renewal_activated`, `subscription_term_renewal_removed`
+    # 
+    # they map to `null` instead.
     # @return [Object]
     attr_accessor :event_specific_data
 
@@ -67,6 +127,11 @@ module AdvancedBilling
 
     def initialize(id:, key:, message:, subscription_id:, customer_id:,
                    created_at:, event_specific_data:, additional_properties: {})
+      # Add additional model properties to the instance.
+      additional_properties.each do |_name, _value|
+        instance_variable_set("@#{_name}", _value)
+      end
+
       @id = id
       @key = key
       @message = message
@@ -74,11 +139,6 @@ module AdvancedBilling
       @customer_id = customer_id
       @created_at = created_at
       @event_specific_data = event_specific_data
-
-      # Add additional model properties to the instance.
-      additional_properties.each do |_name, _value|
-        instance_variable_set("@#{_name}", _value)
-      end
     end
 
     # Creates an instance of the object from a hash.
@@ -100,7 +160,7 @@ module AdvancedBilling
       ) : nil
 
       # Clean out expected properties from Hash.
-      names.each_value { |k| hash.delete(k) }
+      additional_properties = hash.reject { |k, _| names.value?(k) }
 
       # Create object from extracted values.
       Event.new(id: id,
@@ -110,7 +170,7 @@ module AdvancedBilling
                 customer_id: customer_id,
                 created_at: created_at,
                 event_specific_data: event_specific_data,
-                additional_properties: hash)
+                additional_properties: additional_properties)
     end
 
     def to_custom_created_at
@@ -125,7 +185,7 @@ module AdvancedBilling
           APIHelper.valid_type?(value.id,
                                 ->(val) { val.instance_of? Integer }) and
             APIHelper.valid_type?(value.key,
-                                  ->(val) { val.instance_of? String }) and
+                                  ->(val) { EventKey.validate(val) }) and
             APIHelper.valid_type?(value.message,
                                   ->(val) { val.instance_of? String }) and
             APIHelper.valid_type?(value.subscription_id,
@@ -145,7 +205,7 @@ module AdvancedBilling
         APIHelper.valid_type?(value['id'],
                               ->(val) { val.instance_of? Integer }) and
           APIHelper.valid_type?(value['key'],
-                                ->(val) { val.instance_of? String }) and
+                                ->(val) { EventKey.validate(val) }) and
           APIHelper.valid_type?(value['message'],
                                 ->(val) { val.instance_of? String }) and
           APIHelper.valid_type?(value['subscription_id'],
@@ -158,5 +218,23 @@ module AdvancedBilling
                          .validate(value['event_specific_data'])
       )
     end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id}, key: #{@key}, message: #{@message}, subscription_id:"\
+      " #{@subscription_id}, customer_id: #{@customer_id}, created_at: #{@created_at},"\
+      " event_specific_data: #{@event_specific_data}, additional_properties:"\
+      " #{get_additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} id: #{@id.inspect}, key: #{@key.inspect}, message: #{@message.inspect},"\
+      " subscription_id: #{@subscription_id.inspect}, customer_id: #{@customer_id.inspect},"\
+      " created_at: #{@created_at.inspect}, event_specific_data: #{@event_specific_data.inspect},"\
+      " additional_properties: #{get_additional_properties}>"
+    end
   end
 end

data/lib/advanced_billing/models/event_based_billing_segment_error.rb

@@ -34,12 +34,12 @@ module AdvancedBilling
     end
 
     def initialize(segments:, additional_properties: {})
-      @segments = segments
-
       # Add additional model properties to the instance.
       additional_properties.each do |_name, _value|
         instance_variable_set("@#{_name}", _value)
       end
+
+      @segments = segments
     end
 
     # Creates an instance of the object from a hash.
@@ -50,11 +50,25 @@ module AdvancedBilling
       segments = hash.key?('segments') ? hash['segments'] : nil
 
       # Clean out expected properties from Hash.
-      names.each_value { |k| hash.delete(k) }
+      additional_properties = hash.reject { |k, _| names.value?(k) }
 
       # Create object from extracted values.
       EventBasedBillingSegmentError.new(segments: segments,
-                                        additional_properties: hash)
+                                        additional_properties: additional_properties)
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} segments: #{@segments}, additional_properties:"\
+      " #{get_additional_properties}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} segments: #{@segments.inspect}, additional_properties:"\
+      " #{get_additional_properties}>"
     end
   end
 end