brand.dev 0.11.0 → 0.12.0

data/lib/brand_dev/models.rb

@@ -47,6 +47,8 @@ module BrandDev
 
   BrandRetrieveByEmailParams = BrandDev::Models::BrandRetrieveByEmailParams
 
+  BrandRetrieveByIsinParams = BrandDev::Models::BrandRetrieveByIsinParams
+
   BrandRetrieveByNameParams = BrandDev::Models::BrandRetrieveByNameParams
 
   BrandRetrieveByTickerParams = BrandDev::Models::BrandRetrieveByTickerParams

data/lib/brand_dev/resources/brand.rb

@@ -164,6 +164,39 @@ module BrandDev
         )
       end
 
+      # Some parameter documentations has been truncated, see
+      # {BrandDev::Models::BrandRetrieveByIsinParams} for more details.
+      #
+      # Retrieve brand information using an ISIN (International Securities
+      # Identification Number). This endpoint looks up the company associated with the
+      # ISIN and returns its brand data.
+      #
+      # @overload retrieve_by_isin(isin:, force_language: nil, max_speed: nil, timeout_ms: nil, request_options: {})
+      #
+      # @param isin [String] ISIN (International Securities Identification Number) to retrieve brand data for
+      #
+      # @param force_language [Symbol, BrandDev::Models::BrandRetrieveByIsinParams::ForceLanguage] Optional parameter to force the language of the retrieved brand data.
+      #
+      # @param max_speed [Boolean] Optional parameter to optimize the API call for maximum speed. When set to true,
+      #
+      # @param timeout_ms [Integer] Optional timeout in milliseconds for the request. If the request takes longer th
+      #
+      # @param request_options [BrandDev::RequestOptions, Hash{Symbol=>Object}, nil]
+      #
+      # @return [BrandDev::Models::BrandRetrieveByIsinResponse]
+      #
+      # @see BrandDev::Models::BrandRetrieveByIsinParams
+      def retrieve_by_isin(params)
+        parsed, options = BrandDev::BrandRetrieveByIsinParams.dump_request(params)
+        @client.request(
+          method: :get,
+          path: "brand/retrieve-by-isin",
+          query: parsed.transform_keys(max_speed: "maxSpeed", timeout_ms: "timeoutMS"),
+          model: BrandDev::Models::BrandRetrieveByIsinResponse,
+          options: options
+        )
+      end
+
       # Some parameter documentations has been truncated, see
       # {BrandDev::Models::BrandRetrieveByNameParams} for more details.
       #

data/lib/brand_dev/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module BrandDev
-  VERSION = "0.11.0"
+  VERSION = "0.12.0"
 end

data/lib/brand_dev.rb

@@ -9,6 +9,7 @@ require "erb"
 require "etc"
 require "json"
 require "net/http"
+require "openssl"
 require "pathname"
 require "rbconfig"
 require "securerandom"
@@ -58,6 +59,8 @@ require_relative "brand_dev/models/brand_prefetch_params"
 require_relative "brand_dev/models/brand_prefetch_response"
 require_relative "brand_dev/models/brand_retrieve_by_email_params"
 require_relative "brand_dev/models/brand_retrieve_by_email_response"
+require_relative "brand_dev/models/brand_retrieve_by_isin_params"
+require_relative "brand_dev/models/brand_retrieve_by_isin_response"
 require_relative "brand_dev/models/brand_retrieve_by_name_params"
 require_relative "brand_dev/models/brand_retrieve_by_name_response"
 require_relative "brand_dev/models/brand_retrieve_by_ticker_params"

data/manifest.yaml

@@ -6,6 +6,7 @@ dependencies:
   - etc
   - json
   - net/http
+  - openssl
   - pathname
   - rbconfig
   - securerandom

data/rbi/brand_dev/internal/transport/base_client.rbi

@@ -176,6 +176,11 @@ module BrandDev
         private def auth_headers
         end
 
+        # @api private
+        sig { returns(String) }
+        private def user_agent
+        end
+
         # @api private
         sig { returns(String) }
         private def generate_idempotency_key

data/rbi/brand_dev/internal/transport/pooled_net_requester.rbi

@@ -26,8 +26,12 @@ module BrandDev
 
         class << self
           # @api private
-          sig { params(url: URI::Generic).returns(Net::HTTP) }
-          def connect(url)
+          sig do
+            params(cert_store: OpenSSL::X509::Store, url: URI::Generic).returns(
+              Net::HTTP
+            )
+          end
+          def connect(cert_store:, url:)
           end
 
           # @api private

data/rbi/brand_dev/internal/type/base_model.rbi

@@ -31,7 +31,7 @@ module BrandDev
           #
           # Assumes superclass fields are totally defined before fields are accessed /
           # defined on subclasses.
-          sig { params(child: T.self_type).void }
+          sig { params(child: BrandDev::Internal::Type::BaseModel).void }
           def inherited(child)
           end
 
@@ -274,9 +274,13 @@ module BrandDev
 
         # Create a new instance of a model.
         sig do
-          params(data: T.any(T::Hash[Symbol, T.anything], T.self_type)).returns(
-            T.attached_class
-          )
+          params(
+            data:
+              T.any(
+                T::Hash[Symbol, T.anything],
+                BrandDev::Internal::Type::BaseModel
+              )
+          ).returns(T.attached_class)
         end
         def self.new(data = {})
         end

data/rbi/brand_dev/models/brand_retrieve_by_isin_params.rbi

@@ -0,0 +1,386 @@
+# typed: strong
+
+module BrandDev
+  module Models
+    class BrandRetrieveByIsinParams < BrandDev::Internal::Type::BaseModel
+      extend BrandDev::Internal::Type::RequestParameters::Converter
+      include BrandDev::Internal::Type::RequestParameters
+
+      OrHash =
+        T.type_alias do
+          T.any(
+            BrandDev::BrandRetrieveByIsinParams,
+            BrandDev::Internal::AnyHash
+          )
+        end
+
+      # ISIN (International Securities Identification Number) to retrieve brand data for
+      # (e.g., 'AU000000IMD5', 'US0378331005'). Must be exactly 12 characters: 2 letters
+      # followed by 9 alphanumeric characters and ending with a digit.
+      sig { returns(String) }
+      attr_accessor :isin
+
+      # Optional parameter to force the language of the retrieved brand data.
+      sig do
+        returns(
+          T.nilable(
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::OrSymbol
+          )
+        )
+      end
+      attr_reader :force_language
+
+      sig do
+        params(
+          force_language:
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::OrSymbol
+        ).void
+      end
+      attr_writer :force_language
+
+      # Optional parameter to optimize the API call for maximum speed. When set to true,
+      # the API will skip time-consuming operations for faster response at the cost of
+      # less comprehensive data.
+      sig { returns(T.nilable(T::Boolean)) }
+      attr_reader :max_speed
+
+      sig { params(max_speed: T::Boolean).void }
+      attr_writer :max_speed
+
+      # Optional timeout in milliseconds for the request. If the request takes longer
+      # than this value, it will be aborted with a 408 status code. Maximum allowed
+      # value is 300000ms (5 minutes).
+      sig { returns(T.nilable(Integer)) }
+      attr_reader :timeout_ms
+
+      sig { params(timeout_ms: Integer).void }
+      attr_writer :timeout_ms
+
+      sig do
+        params(
+          isin: String,
+          force_language:
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::OrSymbol,
+          max_speed: T::Boolean,
+          timeout_ms: Integer,
+          request_options: BrandDev::RequestOptions::OrHash
+        ).returns(T.attached_class)
+      end
+      def self.new(
+        # ISIN (International Securities Identification Number) to retrieve brand data for
+        # (e.g., 'AU000000IMD5', 'US0378331005'). Must be exactly 12 characters: 2 letters
+        # followed by 9 alphanumeric characters and ending with a digit.
+        isin:,
+        # Optional parameter to force the language of the retrieved brand data.
+        force_language: nil,
+        # Optional parameter to optimize the API call for maximum speed. When set to true,
+        # the API will skip time-consuming operations for faster response at the cost of
+        # less comprehensive data.
+        max_speed: nil,
+        # Optional timeout in milliseconds for the request. If the request takes longer
+        # than this value, it will be aborted with a 408 status code. Maximum allowed
+        # value is 300000ms (5 minutes).
+        timeout_ms: nil,
+        request_options: {}
+      )
+      end
+
+      sig do
+        override.returns(
+          {
+            isin: String,
+            force_language:
+              BrandDev::BrandRetrieveByIsinParams::ForceLanguage::OrSymbol,
+            max_speed: T::Boolean,
+            timeout_ms: Integer,
+            request_options: BrandDev::RequestOptions
+          }
+        )
+      end
+      def to_hash
+      end
+
+      # Optional parameter to force the language of the retrieved brand data.
+      module ForceLanguage
+        extend BrandDev::Internal::Type::Enum
+
+        TaggedSymbol =
+          T.type_alias do
+            T.all(Symbol, BrandDev::BrandRetrieveByIsinParams::ForceLanguage)
+          end
+        OrSymbol = T.type_alias { T.any(Symbol, String) }
+
+        ALBANIAN =
+          T.let(
+            :albanian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        ARABIC =
+          T.let(
+            :arabic,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        AZERI =
+          T.let(
+            :azeri,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        BENGALI =
+          T.let(
+            :bengali,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        BULGARIAN =
+          T.let(
+            :bulgarian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        CEBUANO =
+          T.let(
+            :cebuano,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        CROATIAN =
+          T.let(
+            :croatian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        CZECH =
+          T.let(
+            :czech,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        DANISH =
+          T.let(
+            :danish,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        DUTCH =
+          T.let(
+            :dutch,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        ENGLISH =
+          T.let(
+            :english,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        ESTONIAN =
+          T.let(
+            :estonian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        FARSI =
+          T.let(
+            :farsi,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        FINNISH =
+          T.let(
+            :finnish,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        FRENCH =
+          T.let(
+            :french,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        GERMAN =
+          T.let(
+            :german,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        HAUSA =
+          T.let(
+            :hausa,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        HAWAIIAN =
+          T.let(
+            :hawaiian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        HINDI =
+          T.let(
+            :hindi,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        HUNGARIAN =
+          T.let(
+            :hungarian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        ICELANDIC =
+          T.let(
+            :icelandic,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        INDONESIAN =
+          T.let(
+            :indonesian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        ITALIAN =
+          T.let(
+            :italian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        KAZAKH =
+          T.let(
+            :kazakh,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        KYRGYZ =
+          T.let(
+            :kyrgyz,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        LATIN =
+          T.let(
+            :latin,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        LATVIAN =
+          T.let(
+            :latvian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        LITHUANIAN =
+          T.let(
+            :lithuanian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        MACEDONIAN =
+          T.let(
+            :macedonian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        MONGOLIAN =
+          T.let(
+            :mongolian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        NEPALI =
+          T.let(
+            :nepali,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        NORWEGIAN =
+          T.let(
+            :norwegian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        PASHTO =
+          T.let(
+            :pashto,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        PIDGIN =
+          T.let(
+            :pidgin,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        POLISH =
+          T.let(
+            :polish,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        PORTUGUESE =
+          T.let(
+            :portuguese,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        ROMANIAN =
+          T.let(
+            :romanian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        RUSSIAN =
+          T.let(
+            :russian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        SERBIAN =
+          T.let(
+            :serbian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        SLOVAK =
+          T.let(
+            :slovak,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        SLOVENE =
+          T.let(
+            :slovene,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        SOMALI =
+          T.let(
+            :somali,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        SPANISH =
+          T.let(
+            :spanish,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        SWAHILI =
+          T.let(
+            :swahili,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        SWEDISH =
+          T.let(
+            :swedish,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        TAGALOG =
+          T.let(
+            :tagalog,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        TURKISH =
+          T.let(
+            :turkish,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        UKRAINIAN =
+          T.let(
+            :ukrainian,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        URDU =
+          T.let(
+            :urdu,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        UZBEK =
+          T.let(
+            :uzbek,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        VIETNAMESE =
+          T.let(
+            :vietnamese,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+        WELSH =
+          T.let(
+            :welsh,
+            BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+          )
+
+        sig do
+          override.returns(
+            T::Array[
+              BrandDev::BrandRetrieveByIsinParams::ForceLanguage::TaggedSymbol
+            ]
+          )
+        end
+        def self.values
+        end
+      end
+    end
+  end
+end