orb-billing 0.1.0.pre.alpha.37 → 0.1.0.pre.alpha.39

data/lib/orb/internal/util.rb

@@ -2,8 +2,6 @@
 
 module Orb
   module Internal
-    # rubocop:disable Metrics/ModuleLength
-
     # @api private
     module Util
       # @api private
@@ -61,7 +59,7 @@ module Orb
         # @return [Boolean]
         def primitive?(input)
           case input
-          in true | false | Integer | Float | Symbol | String
+          in true | false | Numeric | Symbol | String
             true
           else
             false
@@ -70,13 +68,11 @@ module Orb
 
         # @api private
         #
-        # @param input [Object]
+        # @param input [String, Boolean]
         #
         # @return [Boolean, Object]
         def coerce_boolean(input)
           case input.is_a?(String) ? input.downcase : input
-          in Numeric
-            input.nonzero?
           in "true"
             true
           in "false"
@@ -88,7 +84,7 @@ module Orb
 
         # @api private
         #
-        # @param input [Object]
+        # @param input [String, Boolean]
         #
         # @raise [ArgumentError]
         # @return [Boolean, nil]
@@ -103,34 +99,20 @@ module Orb
 
         # @api private
         #
-        # @param input [Object]
+        # @param input [String, Integer]
         #
         # @return [Integer, Object]
         def coerce_integer(input)
-          case input
-          in true
-            1
-          in false
-            0
-          else
-            Integer(input, exception: false) || input
-          end
+          Integer(input, exception: false) || input
         end
 
         # @api private
         #
-        # @param input [Object]
+        # @param input [String, Integer, Float]
         #
         # @return [Float, Object]
         def coerce_float(input)
-          case input
-          in true
-            1.0
-          in false
-            0.0
-          else
-            Float(input, exception: false) || input
-          end
+          Float(input, exception: false) || input
         end
 
         # @api private
@@ -159,12 +141,7 @@ module Orb
         private def deep_merge_lr(lhs, rhs, concat: false)
           case [lhs, rhs, concat]
           in [Hash, Hash, _]
-            rhs_cleaned = rhs.reject { _2 == Orb::Internal::OMIT }
-            lhs
-              .reject { |key, _| rhs[key] == Orb::Internal::OMIT }
-              .merge(rhs_cleaned) do |_, old_val, new_val|
-                deep_merge_lr(old_val, new_val, concat: concat)
-              end
+            lhs.merge(rhs) { deep_merge_lr(_2, _3, concat: concat) }
           in [Array, Array, true]
             lhs.concat(rhs)
           else
@@ -175,7 +152,7 @@ module Orb
         # @api private
         #
         # Recursively merge one hash with another. If the values at a given key are not
-        #   both hashes, just take the new value.
+        # both hashes, just take the new value.
         #
         # @param values [Array<Object>]
         #
@@ -362,7 +339,7 @@ module Orb
             value =
               case val
               in Array
-                val.map { _1.to_s.strip }.join(", ")
+                val.filter_map { _1&.to_s&.strip }.join(", ")
               else
                 val&.to_s&.strip
               end
@@ -419,7 +396,7 @@ module Orb
 
         # @api private
         #
-        # @param stream [String, IO, StringIO, Enumerable]
+        # @param stream [String, IO, StringIO, Enumerable<String>]
         # @param blk [Proc]
         #
         # @yieldparam [String]
@@ -434,7 +411,7 @@ module Orb
         # @param blk [Proc]
         #
         # @yieldparam [Enumerator::Yielder]
-        # @return [Enumerable]
+        # @return [Enumerable<String>]
         def writable_enum(&blk)
           Enumerator.new do |y|
             y.define_singleton_method(:write) do
@@ -469,7 +446,7 @@ module Orb
           case val
           in IO
             y << "Content-Type: application/octet-stream\r\n\r\n"
-            IO.copy_stream(val, y)
+            IO.copy_stream(val.tap(&:rewind), y)
           in StringIO
             y << "Content-Type: application/octet-stream\r\n\r\n"
             y << val.string
@@ -490,7 +467,7 @@ module Orb
         #
         # @param body [Object]
         #
-        # @return [Array(String, Enumerable)]
+        # @return [Array(String, Enumerable<String>)]
         private def encode_multipart_streaming(body)
           boundary = SecureRandom.urlsafe_base64(60)
 
@@ -525,7 +502,7 @@ module Orb
         def encode_content(headers, body)
           content_type = headers["content-type"]
           case [content_type, body]
-          in [%r{^application/(?:vnd\.api\+)?json}, Hash | Array]
+          in [%r{^application/(?:vnd\.api\+)?json}, _] unless body.nil?
             [headers, JSON.fast_generate(body)]
           in [%r{^application/(?:x-)?jsonl}, Enumerable]
             [headers, body.lazy.map { JSON.fast_generate(_1) }]
@@ -533,8 +510,12 @@ module Orb
             boundary, strio = encode_multipart_streaming(body)
             headers = {**headers, "content-type" => "#{content_type}; boundary=#{boundary}"}
             [headers, strio]
+          in [_, IO]
+            [headers, body.tap(&:rewind)]
           in [_, StringIO]
             [headers, body.string]
+          in [_, Symbol | Numeric]
+            [headers, body.to_s]
           else
             [headers, body]
           end
@@ -543,7 +524,7 @@ module Orb
         # @api private
         #
         # @param headers [Hash{String=>String}, Net::HTTPHeader]
-        # @param stream [Enumerable]
+        # @param stream [Enumerable<String>]
         # @param suppress_error [Boolean]
         #
         # @raise [JSON::ParserError]
@@ -580,11 +561,11 @@ module Orb
         #
         # https://doc.rust-lang.org/std/iter/trait.FusedIterator.html
         #
-        # @param enum [Enumerable]
+        # @param enum [Enumerable<Object>]
         # @param external [Boolean]
         # @param close [Proc]
         #
-        # @return [Enumerable]
+        # @return [Enumerable<Object>]
         def fused_enum(enum, external: false, &close)
           fused = false
           iter = Enumerator.new do |y|
@@ -610,7 +591,7 @@ module Orb
 
         # @api private
         #
-        # @param enum [Enumerable, nil]
+        # @param enum [Enumerable<Object>, nil]
         def close_fused!(enum)
           return unless enum.is_a?(Enumerator)
 
@@ -621,11 +602,11 @@ module Orb
 
         # @api private
         #
-        # @param enum [Enumerable, nil]
+        # @param enum [Enumerable<Object>, nil]
         # @param blk [Proc]
         #
         # @yieldparam [Enumerator::Yielder]
-        # @return [Enumerable]
+        # @return [Enumerable<Object>]
         def chain_fused(enum, &blk)
           iter = Enumerator.new { blk.call(_1) }
           fused_enum(iter) { close_fused!(enum) }
@@ -635,9 +616,9 @@ module Orb
       class << self
         # @api private
         #
-        # @param enum [Enumerable]
+        # @param enum [Enumerable<String>]
         #
-        # @return [Enumerable]
+        # @return [Enumerable<String>]
         def decode_lines(enum)
           re = /(\r\n|\r|\n)/
           buffer = String.new.b
@@ -671,9 +652,9 @@ module Orb
         #
         # https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream
         #
-        # @param lines [Enumerable]
+        # @param lines [Enumerable<String>]
         #
-        # @return [Hash{Symbol=>Object}]
+        # @return [Enumerable<Hash{Symbol=>Object}>]
         def decode_sse(lines)
           # rubocop:disable Metrics/BlockLength
           chain_fused(lines) do |y|
@@ -711,7 +692,5 @@ module Orb
         end
       end
     end
-
-    # rubocop:enable Metrics/ModuleLength
   end
 end

data/lib/orb/models/alert.rb

@@ -32,7 +32,7 @@ module Orb
       #   Whether the alert is enabled or disabled.
       #
       #   @return [Boolean]
-      required :enabled, Orb::Internal::Type::BooleanModel
+      required :enabled, Orb::Internal::Type::Boolean
 
       # @!attribute metric
       #   The metric the alert applies to.
@@ -54,7 +54,7 @@ module Orb
 
       # @!attribute thresholds
       #   The thresholds that define the conditions under which the alert will be
-      #     triggered.
+      #   triggered.
       #
       #   @return [Array<Orb::Models::Alert::Threshold>, nil]
       required :thresholds, -> { Orb::Internal::Type::ArrayOf[Orb::Models::Alert::Threshold] }, nil?: true
@@ -67,10 +67,10 @@ module Orb
 
       # @!parse
       #   # [Alerts within Orb](/product-catalog/configuring-alerts) monitor spending,
-      #   #   usage, or credit balance and trigger webhooks when a threshold is exceeded.
+      #   # usage, or credit balance and trigger webhooks when a threshold is exceeded.
       #   #
-      #   #   Alerts created through the API can be scoped to either customers or
-      #   #   subscriptions.
+      #   # Alerts created through the API can be scoped to either customers or
+      #   # subscriptions.
       #   #
       #   # @param id [String]
       #   # @param created_at [Time]
@@ -136,8 +136,8 @@ module Orb
 
         # @!attribute external_plan_id
         #   An optional user-defined ID for this plan resource, used throughout the system
-        #     as an alias for this Plan. Use this field to identify a plan by an existing
-        #     identifier in your system.
+        #   as an alias for this Plan. Use this field to identify a plan by an existing
+        #   identifier in your system.
         #
         #   @return [String, nil]
         required :external_plan_id, String, nil?: true
@@ -185,15 +185,15 @@ module Orb
       class Threshold < Orb::Internal::Type::BaseModel
         # @!attribute value
         #   The value at which an alert will fire. For credit balance alerts, the alert will
-        #     fire at or below this value. For usage and cost alerts, the alert will fire at
-        #     or above this value.
+        #   fire at or below this value. For usage and cost alerts, the alert will fire at
+        #   or above this value.
         #
         #   @return [Float]
         required :value, Float
 
         # @!parse
         #   # Thresholds are used to define the conditions under which an alert will be
-        #   #   triggered.
+        #   # triggered.
         #   #
         #   # @param value [Float]
         #   #

data/lib/orb/models/alert_create_for_customer_params.rb

@@ -56,15 +56,15 @@ module Orb
       class Threshold < Orb::Internal::Type::BaseModel
         # @!attribute value
         #   The value at which an alert will fire. For credit balance alerts, the alert will
-        #     fire at or below this value. For usage and cost alerts, the alert will fire at
-        #     or above this value.
+        #   fire at or below this value. For usage and cost alerts, the alert will fire at
+        #   or above this value.
         #
         #   @return [Float]
         required :value, Float
 
         # @!parse
         #   # Thresholds are used to define the conditions under which an alert will be
-        #   #   triggered.
+        #   # triggered.
         #   #
         #   # @param value [Float]
         #   #

data/lib/orb/models/alert_create_for_external_customer_params.rb

@@ -56,15 +56,15 @@ module Orb
       class Threshold < Orb::Internal::Type::BaseModel
         # @!attribute value
         #   The value at which an alert will fire. For credit balance alerts, the alert will
-        #     fire at or below this value. For usage and cost alerts, the alert will fire at
-        #     or above this value.
+        #   fire at or below this value. For usage and cost alerts, the alert will fire at
+        #   or above this value.
         #
         #   @return [Float]
         required :value, Float
 
         # @!parse
         #   # Thresholds are used to define the conditions under which an alert will be
-        #   #   triggered.
+        #   # triggered.
         #   #
         #   # @param value [Float]
         #   #

data/lib/orb/models/alert_create_for_subscription_params.rb

@@ -40,15 +40,15 @@ module Orb
       class Threshold < Orb::Internal::Type::BaseModel
         # @!attribute value
         #   The value at which an alert will fire. For credit balance alerts, the alert will
-        #     fire at or below this value. For usage and cost alerts, the alert will fire at
-        #     or above this value.
+        #   fire at or below this value. For usage and cost alerts, the alert will fire at
+        #   or above this value.
         #
         #   @return [Float]
         required :value, Float
 
         # @!parse
         #   # Thresholds are used to define the conditions under which an alert will be
-        #   #   triggered.
+        #   # triggered.
         #   #
         #   # @param value [Float]
         #   #

data/lib/orb/models/alert_list_params.rb

@@ -11,26 +11,26 @@ module Orb
       # @!attribute created_at_gt
       #
       #   @return [Time, nil]
-      optional :created_at_gt, Time, api_name: :"created_at[gt]", nil?: true
+      optional :created_at_gt, Time, nil?: true
 
       # @!attribute created_at_gte
       #
       #   @return [Time, nil]
-      optional :created_at_gte, Time, api_name: :"created_at[gte]", nil?: true
+      optional :created_at_gte, Time, nil?: true
 
       # @!attribute created_at_lt
       #
       #   @return [Time, nil]
-      optional :created_at_lt, Time, api_name: :"created_at[lt]", nil?: true
+      optional :created_at_lt, Time, nil?: true
 
       # @!attribute created_at_lte
       #
       #   @return [Time, nil]
-      optional :created_at_lte, Time, api_name: :"created_at[lte]", nil?: true
+      optional :created_at_lte, Time, nil?: true
 
       # @!attribute cursor
       #   Cursor for pagination. This can be populated by the `next_cursor` value returned
-      #     from the initial request.
+      #   from the initial request.
       #
       #   @return [String, nil]
       optional :cursor, String, nil?: true

data/lib/orb/models/alert_update_params.rb

@@ -25,15 +25,15 @@ module Orb
       class Threshold < Orb::Internal::Type::BaseModel
         # @!attribute value
         #   The value at which an alert will fire. For credit balance alerts, the alert will
-        #     fire at or below this value. For usage and cost alerts, the alert will fire at
-        #     or above this value.
+        #   fire at or below this value. For usage and cost alerts, the alert will fire at
+        #   or above this value.
         #
         #   @return [Float]
         required :value, Float
 
         # @!parse
         #   # Thresholds are used to define the conditions under which an alert will be
-        #   #   triggered.
+        #   # triggered.
         #   #
         #   # @param value [Float]
         #   #

data/lib/orb/models/amount_discount.rb

@@ -11,7 +11,7 @@ module Orb
 
       # @!attribute applies_to_price_ids
       #   List of price_ids that this discount applies to. For plan/plan phase discounts,
-      #     this can be a subset of prices.
+      #   this can be a subset of prices.
       #
       #   @return [Array<String>]
       required :applies_to_price_ids, Orb::Internal::Type::ArrayOf[String]

data/lib/orb/models/billable_metric.rb

@@ -16,17 +16,17 @@ module Orb
 
       # @!attribute item
       #   The Item resource represents a sellable product or good. Items are associated
-      #     with all line items, billable metrics, and prices and are used for defining
-      #     external sync behavior for invoices and tax calculation purposes.
+      #   with all line items, billable metrics, and prices and are used for defining
+      #   external sync behavior for invoices and tax calculation purposes.
       #
       #   @return [Orb::Models::Item]
       required :item, -> { Orb::Models::Item }
 
       # @!attribute metadata
       #   User specified key-value pairs for the resource. If not present, this defaults
-      #     to an empty dictionary. Individual keys can be removed by setting the value to
-      #     `null`, and the entire metadata mapping can be cleared by setting `metadata` to
-      #     `null`.
+      #   to an empty dictionary. Individual keys can be removed by setting the value to
+      #   `null`, and the entire metadata mapping can be cleared by setting `metadata` to
+      #   `null`.
       #
       #   @return [Hash{Symbol=>String}]
       required :metadata, Orb::Internal::Type::HashOf[String]
@@ -43,8 +43,8 @@ module Orb
 
       # @!parse
       #   # The Metric resource represents a calculation of a quantity based on events.
-      #   #   Metrics are defined by the query that transforms raw usage events into
-      #   #   meaningful values for your customers.
+      #   # Metrics are defined by the query that transforms raw usage events into
+      #   # meaningful values for your customers.
       #   #
       #   # @param id [String]
       #   # @param description [String, nil]

data/lib/orb/models/coupon.rb

@@ -12,7 +12,7 @@ module Orb
 
       # @!attribute archived_at
       #   An archived coupon can no longer be redeemed. Active coupons will have a value
-      #     of null for `archived_at`; this field will be non-null for archived coupons.
+      #   of null for `archived_at`; this field will be non-null for archived coupons.
       #
       #   @return [Time, nil]
       required :archived_at, Time, nil?: true
@@ -24,14 +24,14 @@ module Orb
 
       # @!attribute duration_in_months
       #   This allows for a coupon's discount to apply for a limited time (determined in
-      #     months); a `null` value here means "unlimited time".
+      #   months); a `null` value here means "unlimited time".
       #
       #   @return [Integer, nil]
       required :duration_in_months, Integer, nil?: true
 
       # @!attribute max_redemptions
       #   The maximum number of redemptions allowed for this coupon before it is
-      #     exhausted; `null` here means "unlimited".
+      #   exhausted; `null` here means "unlimited".
       #
       #   @return [Integer, nil]
       required :max_redemptions, Integer, nil?: true
@@ -50,10 +50,10 @@ module Orb
 
       # @!parse
       #   # A coupon represents a reusable discount configuration that can be applied either
-      #   #   as a fixed or percentage amount to an invoice or subscription. Coupons are
-      #   #   activated using a redemption code, which applies the discount to a subscription
-      #   #   or invoice. The duration of a coupon determines how long it remains available
-      #   #   for use by end users.
+      #   # as a fixed or percentage amount to an invoice or subscription. Coupons are
+      #   # activated using a redemption code, which applies the discount to a subscription
+      #   # or invoice. The duration of a coupon determines how long it remains available
+      #   # for use by end users.
       #   #
       #   # @param id [String]
       #   # @param archived_at [Time, nil]

data/lib/orb/models/coupon_create_params.rb

@@ -21,14 +21,14 @@ module Orb
 
       # @!attribute duration_in_months
       #   This allows for a coupon's discount to apply for a limited time (determined in
-      #     months); a `null` value here means "unlimited time".
+      #   months); a `null` value here means "unlimited time".
       #
       #   @return [Integer, nil]
       optional :duration_in_months, Integer, nil?: true
 
       # @!attribute max_redemptions
       #   The maximum number of redemptions allowed for this coupon before it is
-      #     exhausted;`null` here means "unlimited".
+      #   exhausted;`null` here means "unlimited".
       #
       #   @return [Integer, nil]
       optional :max_redemptions, Integer, nil?: true

data/lib/orb/models/coupon_list_params.rb

@@ -10,7 +10,7 @@ module Orb
 
       # @!attribute cursor
       #   Cursor for pagination. This can be populated by the `next_cursor` value returned
-      #     from the initial request.
+      #   from the initial request.
       #
       #   @return [String, nil]
       optional :cursor, String, nil?: true
@@ -33,10 +33,10 @@ module Orb
 
       # @!attribute show_archived
       #   Show archived coupons as well (by default, this endpoint only returns active
-      #     coupons).
+      #   coupons).
       #
       #   @return [Boolean, nil]
-      optional :show_archived, Orb::Internal::Type::BooleanModel, nil?: true
+      optional :show_archived, Orb::Internal::Type::Boolean, nil?: true
 
       # @!parse
       #   # @param cursor [String, nil]

data/lib/orb/models/coupons/subscription_list_params.rb

@@ -11,7 +11,7 @@ module Orb
 
         # @!attribute cursor
         #   Cursor for pagination. This can be populated by the `next_cursor` value returned
-        #     from the initial request.
+        #   from the initial request.
         #
         #   @return [String, nil]
         optional :cursor, String, nil?: true

data/lib/orb/models/credit_note.rb

@@ -103,7 +103,7 @@ module Orb
 
       # @!parse
       #   # The [Credit Note](/invoicing/credit-notes) resource represents a credit that has
-      #   #   been applied to a particular invoice.
+      #   # been applied to a particular invoice.
       #   #
       #   # @param id [String]
       #   # @param created_at [Time]

data/lib/orb/models/credit_note_list_params.rb

@@ -11,26 +11,26 @@ module Orb
       # @!attribute created_at_gt
       #
       #   @return [Time, nil]
-      optional :created_at_gt, Time, api_name: :"created_at[gt]", nil?: true
+      optional :created_at_gt, Time, nil?: true
 
       # @!attribute created_at_gte
       #
       #   @return [Time, nil]
-      optional :created_at_gte, Time, api_name: :"created_at[gte]", nil?: true
+      optional :created_at_gte, Time, nil?: true
 
       # @!attribute created_at_lt
       #
       #   @return [Time, nil]
-      optional :created_at_lt, Time, api_name: :"created_at[lt]", nil?: true
+      optional :created_at_lt, Time, nil?: true
 
       # @!attribute created_at_lte
       #
       #   @return [Time, nil]
-      optional :created_at_lte, Time, api_name: :"created_at[lte]", nil?: true
+      optional :created_at_lte, Time, nil?: true
 
       # @!attribute cursor
       #   Cursor for pagination. This can be populated by the `next_cursor` value returned
-      #     from the initial request.
+      #   from the initial request.
       #
       #   @return [String, nil]
       optional :cursor, String, nil?: true