orb-billing 0.1.2 → 0.2.0

data/lib/orb/internal.rb

@@ -3,6 +3,10 @@
 module Orb
   # @api private
   module Internal
-    OMIT = Object.new.freeze
+    OMIT =
+      Object.new.tap do
+        _1.define_singleton_method(:inspect) { "#<#{Orb::Internal}::OMIT>" }
+      end
+        .freeze
   end
 end

data/lib/orb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Orb
-  VERSION = "0.1.2"
+  VERSION = "0.2.0"
 end

data/rbi/lib/orb/client.rbi

@@ -78,8 +78,9 @@ module Orb
     def self.new(
       # Defaults to `ENV["ORB_API_KEY"]`
       api_key: ENV["ORB_API_KEY"],
-      # Override the default base URL for the API, e.g., `"https://api.example.com/v2/"`
-      base_url: nil,
+      # Override the default base URL for the API, e.g.,
+      # `"https://api.example.com/v2/"`. Defaults to `ENV["ORB_BASE_URL"]`
+      base_url: ENV["ORB_BASE_URL"],
       # Max number of retries to attempt after a failed retryable request.
       max_retries: DEFAULT_MAX_RETRIES,
       timeout: DEFAULT_TIMEOUT_IN_SECONDS,

data/rbi/lib/orb/internal/page.rbi

@@ -13,6 +13,7 @@ module Orb
       sig { returns(PaginationMetadata) }
       attr_accessor :pagination_metadata
 
+      # @api private
       sig { returns(String) }
       def inspect; end
 

data/rbi/lib/orb/internal/transport/base_client.rbi

@@ -187,6 +187,7 @@ module Orb
           model: Orb::Internal::Type::Unknown,
           options: {}
         ); end
+        # @api private
         sig { returns(String) }
         def inspect; end
       end

data/rbi/lib/orb/internal/type/array_of.rbi

@@ -10,11 +10,10 @@ module Orb
         include Orb::Internal::Type::Converter
 
         abstract!
-        final!
 
         Elem = type_member(:out)
 
-        sig(:final) do
+        sig do
           params(
             type_info: T.any(
               Orb::Internal::AnyHash,
@@ -27,14 +26,14 @@ module Orb
         end
         def self.[](type_info, spec = {}); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def ===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def ==(other); end
 
         # @api private
-        sig(:final) do
+        sig do
           override
             .params(value: T.any(
               T::Array[T.anything],
@@ -46,7 +45,7 @@ module Orb
         def coerce(value, state:); end
 
         # @api private
-        sig(:final) do
+        sig do
           override
             .params(value: T.any(
               T::Array[T.anything],
@@ -58,15 +57,15 @@ module Orb
         def dump(value, state:); end
 
         # @api private
-        sig(:final) { returns(Elem) }
+        sig { returns(Elem) }
         protected def item_type; end
 
         # @api private
-        sig(:final) { returns(T::Boolean) }
+        sig { returns(T::Boolean) }
         protected def nilable?; end
 
         # @api private
-        sig(:final) do
+        sig do
           params(
             type_info: T.any(
               Orb::Internal::AnyHash,
@@ -78,6 +77,10 @@ module Orb
             .void
         end
         def initialize(type_info, spec = {}); end
+
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
       end
     end
   end

data/rbi/lib/orb/internal/type/base_model.rbi

@@ -175,6 +175,11 @@ module Orb
         sig { params(keys: T.nilable(T::Array[Symbol])).returns(Orb::Internal::AnyHash) }
         def deconstruct_keys(keys); end
 
+        class << self
+          sig { params(model: Orb::Internal::Type::BaseModel).returns(Orb::Internal::AnyHash) }
+          def walk(model); end
+        end
+
         sig { params(a: T.anything).returns(String) }
         def to_json(*a); end
 
@@ -185,6 +190,17 @@ module Orb
         sig { params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(T.attached_class) }
         def self.new(data = {}); end
 
+        class << self
+          # @api private
+          sig { params(depth: Integer).returns(String) }
+          def inspect(depth: 0); end
+        end
+
+        # @api private
+        sig { returns(String) }
+        def to_s; end
+
+        # @api private
         sig { returns(String) }
         def inspect; end
       end

data/rbi/lib/orb/internal/type/boolean.rbi

@@ -10,17 +10,16 @@ module Orb
         extend Orb::Internal::Type::Converter
 
         abstract!
-        final!
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.==(other); end
 
         class << self
           # @api private
-          sig(:final) do
+          sig do
             override
               .params(value: T.any(
                 T::Boolean,
@@ -32,7 +31,7 @@ module Orb
           def coerce(value, state:); end
 
           # @api private
-          sig(:final) do
+          sig do
             override
               .params(value: T.any(T::Boolean, T.anything), state: Orb::Internal::Type::Converter::DumpState)
               .returns(T.any(T::Boolean, T.anything))

data/rbi/lib/orb/internal/type/converter.rbi

@@ -35,6 +35,10 @@ module Orb
         end
         def dump(value, state:); end
 
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
+
         class << self
           # @api private
           sig do
@@ -106,6 +110,10 @@ module Orb
               .returns(T.anything)
           end
           def self.dump(target, value, state: {can_retry: true}); end
+
+          # @api private
+          sig { params(target: T.anything, depth: Integer).returns(String) }
+          def self.inspect(target, depth:); end
         end
       end
     end

data/rbi/lib/orb/internal/type/enum.rbi

@@ -57,6 +57,10 @@ module Orb
             .returns(T.any(Symbol, T.anything))
         end
         def dump(value, state:); end
+
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
       end
     end
   end

data/rbi/lib/orb/internal/type/hash_of.rbi

@@ -10,11 +10,10 @@ module Orb
         include Orb::Internal::Type::Converter
 
         abstract!
-        final!
 
         Elem = type_member(:out)
 
-        sig(:final) do
+        sig do
           params(
             type_info: T.any(
               Orb::Internal::AnyHash,
@@ -27,14 +26,14 @@ module Orb
         end
         def self.[](type_info, spec = {}); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def ===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def ==(other); end
 
         # @api private
-        sig(:final) do
+        sig do
           override
             .params(
               value: T.any(T::Hash[T.anything, T.anything], T.anything),
@@ -45,7 +44,7 @@ module Orb
         def coerce(value, state:); end
 
         # @api private
-        sig(:final) do
+        sig do
           override
             .params(
               value: T.any(T::Hash[T.anything, T.anything], T.anything),
@@ -56,15 +55,15 @@ module Orb
         def dump(value, state:); end
 
         # @api private
-        sig(:final) { returns(Elem) }
+        sig { returns(Elem) }
         protected def item_type; end
 
         # @api private
-        sig(:final) { returns(T::Boolean) }
+        sig { returns(T::Boolean) }
         protected def nilable?; end
 
         # @api private
-        sig(:final) do
+        sig do
           params(
             type_info: T.any(
               Orb::Internal::AnyHash,
@@ -76,6 +75,10 @@ module Orb
             .void
         end
         def initialize(type_info, spec = {}); end
+
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
       end
     end
   end

data/rbi/lib/orb/internal/type/io_like.rbi

@@ -10,17 +10,16 @@ module Orb
         extend Orb::Internal::Type::Converter
 
         abstract!
-        final!
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.==(other); end
 
         class << self
           # @api private
-          sig(:final) do
+          sig do
             override
               .params(value: T.any(
                 StringIO,
@@ -33,7 +32,7 @@ module Orb
           def coerce(value, state:); end
 
           # @api private
-          sig(:final) do
+          sig do
             override
               .params(
                 value: T.any(Pathname, StringIO, IO, String, T.anything),

data/rbi/lib/orb/internal/type/union.rbi

@@ -62,6 +62,10 @@ module Orb
           ).returns(T.anything)
         end
         def dump(value, state:); end
+
+        # @api private
+        sig { params(depth: Integer).returns(String) }
+        def inspect(depth: 0); end
       end
     end
   end

data/rbi/lib/orb/internal/type/unknown.rbi

@@ -10,17 +10,16 @@ module Orb
         extend Orb::Internal::Type::Converter
 
         abstract!
-        final!
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.===(other); end
 
-        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        sig { params(other: T.anything).returns(T::Boolean) }
         def self.==(other); end
 
         class << self
           # @api private
-          sig(:final) do
+          sig do
             override.params(
               value: T.anything,
               state: Orb::Internal::Type::Converter::CoerceState
@@ -29,7 +28,7 @@ module Orb
           def coerce(value, state:); end
 
           # @api private
-          sig(:final) do
+          sig do
             override.params(
               value: T.anything,
               state: Orb::Internal::Type::Converter::DumpState

data/rbi/lib/orb/internal/util.rbi

@@ -215,6 +215,14 @@ module Orb
         def encode_content(headers, body); end
 
         # @api private
+        #
+        # https://www.iana.org/assignments/character-sets/character-sets.xhtml
+        sig { params(content_type: String, text: String).void }
+        def force_charset!(content_type, text:); end
+
+        # @api private
+        #
+        # Assumes each chunk in stream has `Encoding::BINARY`.
         sig do
           params(
             headers: T.any(T::Hash[String, String], Net::HTTPHeader),
@@ -263,12 +271,19 @@ module Orb
 
       class << self
         # @api private
+        #
+        # Assumes Strings have been forced into having `Encoding::BINARY`.
+        #
+        # This decoder is responsible for reassembling lines split across multiple
+        # fragments.
         sig { params(enum: T::Enumerable[String]).returns(T::Enumerable[String]) }
         def decode_lines(enum); end
 
         # @api private
         #
         # https://html.spec.whatwg.org/multipage/server-sent-events.html#parsing-an-event-stream
+        #
+        # Assumes that `lines` has been decoded with `#decode_lines`.
         sig do
           params(lines: T::Enumerable[String]).returns(T::Enumerable[Orb::Internal::Util::ServerSentEvent])
         end

data/rbi/lib/orb/internal.rbi

@@ -7,6 +7,6 @@ module Orb
     # this alias might be refined in the future.
     AnyHash = T.type_alias { T::Hash[Symbol, T.anything] }
 
-    OMIT = T.let(T.anything, T.anything)
+    OMIT = T.let(Object.new.freeze, T.anything)
   end
 end

data/sig/orb/internal/type/array_of.rbs

@@ -35,6 +35,8 @@ module Orb
           | Orb::Internal::Type::Converter::input type_info,
           ?::Hash[Symbol, top] spec
         ) -> void
+
+        def inspect: (?depth: Integer) -> String
       end
     end
   end

data/sig/orb/internal/type/base_model.rbs

@@ -69,12 +69,20 @@ module Orb
 
         def deconstruct_keys: (::Array[Symbol]? keys) -> ::Hash[Symbol, top]
 
+        def self.walk: (
+          Orb::Internal::Type::BaseModel model
+        ) -> ::Hash[Symbol, top]
+
         def to_json: (*top a) -> String
 
         def to_yaml: (*top a) -> String
 
         def initialize: (?::Hash[Symbol, top] | self data) -> void
 
+        def self.inspect: (?depth: Integer) -> String
+
+        def to_s: -> String
+
         def inspect: -> String
       end
     end

data/sig/orb/internal/type/converter.rbs

@@ -23,6 +23,8 @@ module Orb
           state: Orb::Internal::Type::Converter::dump_state
         ) -> top
 
+        def inspect: (?depth: Integer) -> String
+
         def self.type_info: (
           {
             const: (nil | bool | Integer | Float | Symbol)?,
@@ -44,6 +46,8 @@ module Orb
           top value,
           ?state: Orb::Internal::Type::Converter::dump_state
         ) -> top
+
+        def self.inspect: (top target, depth: Integer) -> String
       end
     end
   end

data/sig/orb/internal/type/enum.rbs

@@ -21,6 +21,8 @@ module Orb
           Symbol | top value,
           state: Orb::Internal::Type::Converter::dump_state
         ) -> (Symbol | top)
+
+        def inspect: (?depth: Integer) -> String
       end
     end
   end

data/sig/orb/internal/type/hash_of.rbs

@@ -35,6 +35,8 @@ module Orb
           | Orb::Internal::Type::Converter::input type_info,
           ?::Hash[Symbol, top] spec
         ) -> void
+
+        def inspect: (?depth: Integer) -> String
       end
     end
   end

data/sig/orb/internal/type/union.rbs

@@ -39,6 +39,8 @@ module Orb
           top value,
           state: Orb::Internal::Type::Converter::dump_state
         ) -> top
+
+        def inspect: (?depth: Integer) -> String
       end
     end
   end

data/sig/orb/internal/util.rbs

@@ -120,6 +120,8 @@ module Orb
         top body
       ) -> top
 
+      def self?.force_charset!: (String content_type, text: String) -> void
+
       def self?.decode_content: (
         ::Hash[String, String] headers,
         stream: Enumerable[String],

data/sig/orb/internal.rbs

@@ -1,5 +1,5 @@
 module Orb
   module Internal
-    OMIT: top
+    OMIT: Object
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: orb-billing
 version: !ruby/object:Gem::Version
-  version: 0.1.2
+  version: 0.2.0
 platform: ruby
 authors:
 - Orb
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-04-10 00:00:00.000000000 Z
+date: 2025-04-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: connection_pool
@@ -31,7 +31,10 @@ extensions: []
 extra_rdoc_files:
 - README.md
 files:
+- ".ignore"
+- CHANGELOG.md
 - README.md
+- SECURITY.md
 - lib/orb.rb
 - lib/orb/client.rb
 - lib/orb/errors.rb