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

data/lib/orb/resources/prices.rb

@@ -104,7 +104,7 @@ module Orb
       # @param limit [Integer]
       # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Orb::Page<Orb::Models::Price::UnitPrice, Orb::Models::Price::PackagePrice, Orb::Models::Price::MatrixPrice, Orb::Models::Price::TieredPrice, Orb::Models::Price::TieredBpsPrice, Orb::Models::Price::BpsPrice, Orb::Models::Price::BulkBpsPrice, Orb::Models::Price::BulkPrice, Orb::Models::Price::ThresholdTotalAmountPrice, Orb::Models::Price::TieredPackagePrice, Orb::Models::Price::GroupedTieredPrice, Orb::Models::Price::TieredWithMinimumPrice, Orb::Models::Price::TieredPackageWithMinimumPrice, Orb::Models::Price::PackageWithAllocationPrice, Orb::Models::Price::UnitWithPercentPrice, Orb::Models::Price::MatrixWithAllocationPrice, Orb::Models::Price::TieredWithProrationPrice, Orb::Models::Price::UnitWithProrationPrice, Orb::Models::Price::GroupedAllocationPrice, Orb::Models::Price::GroupedWithProratedMinimumPrice, Orb::Models::Price::GroupedWithMeteredMinimumPrice, Orb::Models::Price::MatrixWithDisplayNamePrice, Orb::Models::Price::BulkWithProrationPrice, Orb::Models::Price::GroupedTieredPackagePrice, Orb::Models::Price::MaxGroupTieredPackagePrice, Orb::Models::Price::ScalableMatrixWithUnitPricingPrice, Orb::Models::Price::ScalableMatrixWithTieredPricingPrice, Orb::Models::Price::CumulativeGroupedBulkPrice>]
+      # @return [Orb::Internal::Page<Orb::Models::Price::UnitPrice, Orb::Models::Price::PackagePrice, Orb::Models::Price::MatrixPrice, Orb::Models::Price::TieredPrice, Orb::Models::Price::TieredBpsPrice, Orb::Models::Price::BpsPrice, Orb::Models::Price::BulkBpsPrice, Orb::Models::Price::BulkPrice, Orb::Models::Price::ThresholdTotalAmountPrice, Orb::Models::Price::TieredPackagePrice, Orb::Models::Price::GroupedTieredPrice, Orb::Models::Price::TieredWithMinimumPrice, Orb::Models::Price::TieredPackageWithMinimumPrice, Orb::Models::Price::PackageWithAllocationPrice, Orb::Models::Price::UnitWithPercentPrice, Orb::Models::Price::MatrixWithAllocationPrice, Orb::Models::Price::TieredWithProrationPrice, Orb::Models::Price::UnitWithProrationPrice, Orb::Models::Price::GroupedAllocationPrice, Orb::Models::Price::GroupedWithProratedMinimumPrice, Orb::Models::Price::GroupedWithMeteredMinimumPrice, Orb::Models::Price::MatrixWithDisplayNamePrice, Orb::Models::Price::BulkWithProrationPrice, Orb::Models::Price::GroupedTieredPackagePrice, Orb::Models::Price::MaxGroupTieredPackagePrice, Orb::Models::Price::ScalableMatrixWithUnitPricingPrice, Orb::Models::Price::ScalableMatrixWithTieredPricingPrice, Orb::Models::Price::CumulativeGroupedBulkPrice>]
       #
       # @see Orb::Models::PriceListParams
       def list(params = {})
@@ -113,7 +113,7 @@ module Orb
           method: :get,
           path: "prices",
           query: parsed,
-          page: Orb::Page,
+          page: Orb::Internal::Page,
           model: Orb::Models::Price,
           options: options
         )

data/lib/orb/resources/subscriptions.rb

@@ -360,7 +360,7 @@ module Orb
       # @param status [Symbol, Orb::Models::SubscriptionListParams::Status, nil]
       # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Orb::Page<Orb::Models::Subscription>]
+      # @return [Orb::Internal::Page<Orb::Models::Subscription>]
       #
       # @see Orb::Models::SubscriptionListParams
       def list(params = {})
@@ -369,7 +369,7 @@ module Orb
           method: :get,
           path: "subscriptions",
           query: parsed,
-          page: Orb::Page,
+          page: Orb::Internal::Page,
           model: Orb::Models::Subscription,
           options: options
         )
@@ -529,7 +529,7 @@ module Orb
       # @param start_date_lte [Time, nil]
       # @param request_options [Orb::RequestOptions, Hash{Symbol=>Object}, nil]
       #
-      # @return [Orb::Page<Orb::Models::SubscriptionFetchScheduleResponse>]
+      # @return [Orb::Internal::Page<Orb::Models::SubscriptionFetchScheduleResponse>]
       #
       # @see Orb::Models::SubscriptionFetchScheduleParams
       def fetch_schedule(subscription_id, params = {})
@@ -538,7 +538,7 @@ module Orb
           method: :get,
           path: ["subscriptions/%1$s/schedule", subscription_id],
           query: parsed,
-          page: Orb::Page,
+          page: Orb::Internal::Page,
           model: Orb::Models::SubscriptionFetchScheduleResponse,
           options: options
         )

data/lib/orb/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Orb
-  VERSION = "0.1.0-alpha.35"
+  VERSION = "0.1.0-alpha.37"
 end

data/lib/orb.rb

@@ -36,24 +36,24 @@ require "connection_pool"
 
 # Package files.
 require_relative "orb/version"
-require_relative "orb/util"
-require_relative "orb/type/converter"
-require_relative "orb/type/unknown"
-require_relative "orb/type/boolean_model"
-require_relative "orb/type/enum"
-require_relative "orb/type/union"
-require_relative "orb/type/array_of"
-require_relative "orb/type/hash_of"
-require_relative "orb/type/base_model"
-require_relative "orb/type/base_page"
-require_relative "orb/type/request_parameters"
-require_relative "orb/type"
+require_relative "orb/internal/util"
+require_relative "orb/internal/type/converter"
+require_relative "orb/internal/type/unknown"
+require_relative "orb/internal/type/boolean_model"
+require_relative "orb/internal/type/enum"
+require_relative "orb/internal/type/union"
+require_relative "orb/internal/type/array_of"
+require_relative "orb/internal/type/hash_of"
+require_relative "orb/internal/type/base_model"
+require_relative "orb/internal/type/base_page"
+require_relative "orb/internal/type/request_parameters"
+require_relative "orb/internal"
 require_relative "orb/request_options"
 require_relative "orb/errors"
-require_relative "orb/transport/base_client"
-require_relative "orb/transport/pooled_net_requester"
+require_relative "orb/internal/transport/base_client"
+require_relative "orb/internal/transport/pooled_net_requester"
 require_relative "orb/client"
-require_relative "orb/page"
+require_relative "orb/internal/page"
 require_relative "orb/models/alert"
 require_relative "orb/models/alert_create_for_customer_params"
 require_relative "orb/models/alert_create_for_external_customer_params"

data/rbi/lib/orb/client.rbi

@@ -1,7 +1,7 @@
 # typed: strong
 
 module Orb
-  class Client < Orb::Transport::BaseClient
+  class Client < Orb::Internal::Transport::BaseClient
     DEFAULT_MAX_RETRIES = 2
 
     DEFAULT_TIMEOUT_IN_SECONDS = T.let(60.0, Float)

data/rbi/lib/orb/errors.rbi

@@ -191,56 +191,4 @@ module Orb
       TYPE = "https://docs.withorb.com/reference/error-responses#500-internal-server-error"
     end
   end
-
-  Error = Orb::Errors::Error
-
-  ConversionError = Orb::Errors::ConversionError
-
-  APIError = Orb::Errors::APIError
-
-  APIStatusError = Orb::Errors::APIStatusError
-
-  APIConnectionError = Orb::Errors::APIConnectionError
-
-  APITimeoutError = Orb::Errors::APITimeoutError
-
-  BadRequestError = Orb::Errors::BadRequestError
-
-  AuthenticationError = Orb::Errors::AuthenticationError
-
-  PermissionDeniedError = Orb::Errors::PermissionDeniedError
-
-  NotFoundError = Orb::Errors::NotFoundError
-
-  ConflictError = Orb::Errors::ConflictError
-
-  UnprocessableEntityError = Orb::Errors::UnprocessableEntityError
-
-  RateLimitError = Orb::Errors::RateLimitError
-
-  InternalServerError = Orb::Errors::InternalServerError
-
-  ConstraintViolation = Orb::Errors::ConstraintViolation
-
-  DuplicateResourceCreation = Orb::Errors::DuplicateResourceCreation
-
-  FeatureNotAvailable = Orb::Errors::FeatureNotAvailable
-
-  RequestValidationError = Orb::Errors::RequestValidationError
-
-  OrbAuthenticationError = Orb::Errors::OrbAuthenticationError
-
-  ResourceNotFound = Orb::Errors::ResourceNotFound
-
-  URLNotFound = Orb::Errors::URLNotFound
-
-  ResourceConflict = Orb::Errors::ResourceConflict
-
-  RequestTooLarge = Orb::Errors::RequestTooLarge
-
-  ResourceTooLarge = Orb::Errors::ResourceTooLarge
-
-  TooManyRequests = Orb::Errors::TooManyRequests
-
-  OrbInternalServerError = Orb::Errors::OrbInternalServerError
 end

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

@@ -0,0 +1,37 @@
+# typed: strong
+
+module Orb
+  module Internal
+    class Page
+      include Orb::Internal::Type::BasePage
+
+      Elem = type_member
+
+      sig { returns(T.nilable(T::Array[Elem])) }
+      attr_accessor :data
+
+      sig { returns(PaginationMetadata) }
+      attr_accessor :pagination_metadata
+
+      sig { returns(String) }
+      def inspect
+      end
+
+      class PaginationMetadata < Orb::Internal::Type::BaseModel
+        sig { returns(T::Boolean) }
+        attr_accessor :has_more
+
+        sig { returns(T.nilable(String)) }
+        attr_accessor :next_cursor
+
+        sig { params(has_more: T::Boolean, next_cursor: T.nilable(String)).returns(T.attached_class) }
+        def self.new(has_more:, next_cursor:)
+        end
+
+        sig { override.returns({has_more: T::Boolean, next_cursor: T.nilable(String)}) }
+        def to_hash
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,209 @@
+# typed: strong
+
+module Orb
+  module Internal
+    module Transport
+      # @api private
+      class BaseClient
+        abstract!
+
+        RequestComponentsShape =
+          T.type_alias do
+            {
+              method: Symbol,
+              path: T.any(String, T::Array[String]),
+              query: T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))]),
+              headers: T.nilable(
+                T::Hash[String,
+                        T.nilable(
+                          T.any(
+                            String,
+                            Integer,
+                            T::Array[T.nilable(T.any(String, Integer))]
+                          )
+                        )]
+              ),
+              body: T.nilable(T.anything),
+              unwrap: T.nilable(Symbol),
+              page: T.nilable(T::Class[Orb::Internal::Type::BasePage[Orb::Internal::Type::BaseModel]]),
+              stream: T.nilable(T::Class[T.anything]),
+              model: T.nilable(Orb::Internal::Type::Converter::Input),
+              options: T.nilable(T.any(Orb::RequestOptions, Orb::Internal::AnyHash))
+            }
+          end
+
+        RequestInputShape =
+          T.type_alias do
+            {
+              method: Symbol,
+              url: URI::Generic,
+              headers: T::Hash[String, String],
+              body: T.anything,
+              max_retries: Integer,
+              timeout: Float
+            }
+          end
+
+        # from whatwg fetch spec
+        MAX_REDIRECTS = 20
+
+        PLATFORM_HEADERS = T::Hash[String, String]
+
+        class << self
+          # @api private
+          sig { params(req: Orb::Internal::Transport::BaseClient::RequestComponentsShape).void }
+          def validate!(req)
+          end
+
+          # @api private
+          sig do
+            params(
+              status: Integer,
+              headers: T.any(
+                T::Hash[String, String],
+                Net::HTTPHeader
+              )
+            ).returns(T::Boolean)
+          end
+          def should_retry?(status, headers:)
+          end
+
+          # @api private
+          sig do
+            params(
+              request: Orb::Internal::Transport::BaseClient::RequestInputShape,
+              status: Integer,
+              response_headers: T.any(T::Hash[String, String], Net::HTTPHeader)
+            )
+              .returns(Orb::Internal::Transport::BaseClient::RequestInputShape)
+          end
+          def follow_redirect(request, status:, response_headers:)
+          end
+
+          # @api private
+          sig do
+            params(
+              status: T.any(Integer, Orb::Errors::APIConnectionError),
+              stream: T.nilable(T::Enumerable[String])
+            )
+              .void
+          end
+          def reap_connection!(status, stream:)
+          end
+        end
+
+        # @api private
+        sig { returns(Orb::Internal::Transport::PooledNetRequester) }
+        attr_accessor :requester
+
+        # @api private
+        sig do
+          params(
+            base_url: String,
+            timeout: Float,
+            max_retries: Integer,
+            initial_retry_delay: Float,
+            max_retry_delay: Float,
+            headers: T::Hash[String,
+                             T.nilable(T.any(String, Integer, T::Array[T.nilable(T.any(String, Integer))]))],
+            idempotency_header: T.nilable(String)
+          )
+            .returns(T.attached_class)
+        end
+        def self.new(
+          base_url:,
+          timeout: 0.0,
+          max_retries: 0,
+          initial_retry_delay: 0.0,
+          max_retry_delay: 0.0,
+          headers: {},
+          idempotency_header: nil
+        )
+        end
+
+        # @api private
+        sig { overridable.returns(T::Hash[String, String]) }
+        private def auth_headers
+        end
+
+        # @api private
+        sig { returns(String) }
+        private def generate_idempotency_key
+        end
+
+        # @api private
+        sig do
+          overridable
+            .params(req: Orb::Internal::Transport::BaseClient::RequestComponentsShape, opts: Orb::Internal::AnyHash)
+            .returns(Orb::Internal::Transport::BaseClient::RequestInputShape)
+        end
+        private def build_request(req, opts)
+        end
+
+        # @api private
+        sig { params(headers: T::Hash[String, String], retry_count: Integer).returns(Float) }
+        private def retry_delay(headers, retry_count:)
+        end
+
+        # @api private
+        sig do
+          params(
+            request: Orb::Internal::Transport::BaseClient::RequestInputShape,
+            redirect_count: Integer,
+            retry_count: Integer,
+            send_retry_header: T::Boolean
+          )
+            .returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
+        end
+        private def send_request(request, redirect_count:, retry_count:, send_retry_header:)
+        end
+
+        # Execute the request specified by `req`. This is the method that all resource
+        #   methods call into.
+        #
+        # @overload request(method, path, query: {}, headers: {}, body: nil, unwrap: nil, page: nil, stream: nil, model: Orb::Internal::Type::Unknown, options: {})
+        sig do
+          params(
+            method: Symbol,
+            path: T.any(String, T::Array[String]),
+            query: T.nilable(T::Hash[String, T.nilable(T.any(T::Array[String], String))]),
+            headers: T.nilable(
+              T::Hash[String,
+                      T.nilable(
+                        T.any(
+                          String,
+                          Integer,
+                          T::Array[T.nilable(T.any(String, Integer))]
+                        )
+                      )]
+            ),
+            body: T.nilable(T.anything),
+            unwrap: T.nilable(Symbol),
+            page: T.nilable(T::Class[Orb::Internal::Type::BasePage[Orb::Internal::Type::BaseModel]]),
+            stream: T.nilable(T::Class[T.anything]),
+            model: T.nilable(Orb::Internal::Type::Converter::Input),
+            options: T.nilable(T.any(Orb::RequestOptions, Orb::Internal::AnyHash))
+          )
+            .returns(T.anything)
+        end
+        def request(
+          method,
+          path,
+          query: {},
+          headers: {},
+          body: nil,
+          unwrap: nil,
+          page: nil,
+          stream: nil,
+          model: Orb::Internal::Type::Unknown,
+          options: {}
+        )
+        end
+
+        sig { returns(String) }
+        def inspect
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,66 @@
+# typed: strong
+
+module Orb
+  module Internal
+    module Transport
+      # @api private
+      class PooledNetRequester
+        RequestShape =
+          T.type_alias do
+            {
+              method: Symbol,
+              url: URI::Generic,
+              headers: T::Hash[String, String],
+              body: T.anything,
+              deadline: Float
+            }
+          end
+
+        # from the golang stdlib
+        #   https://github.com/golang/go/blob/c8eced8580028328fde7c03cbfcb720ce15b2358/src/net/http/transport.go#L49
+        KEEP_ALIVE_TIMEOUT = 30
+
+        class << self
+          # @api private
+          sig { params(url: URI::Generic).returns(Net::HTTP) }
+          def connect(url)
+          end
+
+          # @api private
+          sig { params(conn: Net::HTTP, deadline: Float).void }
+          def calibrate_socket_timeout(conn, deadline)
+          end
+
+          # @api private
+          sig do
+            params(
+              request: Orb::Internal::Transport::PooledNetRequester::RequestShape,
+              blk: T.proc.params(arg0: String).void
+            )
+              .returns(Net::HTTPGenericRequest)
+          end
+          def build_request(request, &blk)
+          end
+        end
+
+        # @api private
+        sig { params(url: URI::Generic, deadline: Float, blk: T.proc.params(arg0: Net::HTTP).void).void }
+        private def with_pool(url, deadline:, &blk)
+        end
+
+        # @api private
+        sig do
+          params(request: Orb::Internal::Transport::PooledNetRequester::RequestShape)
+            .returns([Integer, Net::HTTPResponse, T::Enumerable[String]])
+        end
+        def execute(request)
+        end
+
+        # @api private
+        sig { params(size: Integer).returns(T.attached_class) }
+        def self.new(size: Etc.nprocessors)
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,88 @@
+# typed: strong
+
+module Orb
+  module Internal
+    module Type
+      # @api private
+      #
+      # Array of items of a given type.
+      class ArrayOf
+        include Orb::Internal::Type::Converter
+
+        abstract!
+        final!
+
+        Elem = type_member(:out)
+
+        sig(:final) do
+          params(
+            type_info: T.any(
+              Orb::Internal::AnyHash,
+              T.proc.returns(Orb::Internal::Type::Converter::Input),
+              Orb::Internal::Type::Converter::Input
+            ),
+            spec: Orb::Internal::AnyHash
+          )
+            .returns(T.attached_class)
+        end
+        def self.[](type_info, spec = {})
+        end
+
+        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        def ===(other)
+        end
+
+        sig(:final) { params(other: T.anything).returns(T::Boolean) }
+        def ==(other)
+        end
+
+        # @api private
+        sig(:final) do
+          override
+            .params(value: T.any(
+              T::Enumerable[Elem],
+              T.anything
+            ),
+                    state: Orb::Internal::Type::Converter::State)
+            .returns(T.any(T::Array[T.anything], T.anything))
+        end
+        def coerce(value, state:)
+        end
+
+        # @api private
+        sig(:final) do
+          override
+            .params(value: T.any(T::Enumerable[Elem], T.anything))
+            .returns(T.any(T::Array[T.anything], T.anything))
+        end
+        def dump(value)
+        end
+
+        # @api private
+        sig(:final) { returns(Elem) }
+        protected def item_type
+        end
+
+        # @api private
+        sig(:final) { returns(T::Boolean) }
+        protected def nilable?
+        end
+
+        # @api private
+        sig(:final) do
+          params(
+            type_info: T.any(
+              Orb::Internal::AnyHash,
+              T.proc.returns(Orb::Internal::Type::Converter::Input),
+              Orb::Internal::Type::Converter::Input
+            ),
+            spec: Orb::Internal::AnyHash
+          )
+            .void
+        end
+        def initialize(type_info, spec = {})
+        end
+      end
+    end
+  end
+end