feat(client): add webhook support

Author: stainless-app[bot]

lib/orb/client.rb

@@ -18,6 +18,9 @@ class Client < Orb::Internal::Transport::BaseClient
     # @return [String]
     attr_reader :api_key
 
+    # @return [String, nil]
+    attr_reader :webhook_secret
+
     # @return [Orb::Resources::TopLevel]
     attr_reader :top_level
 
@@ -160,6 +163,8 @@ class Client < Orb::Internal::Transport::BaseClient
     #
     # @param api_key [String, nil] Defaults to `ENV["ORB_API_KEY"]`
     #
+    # @param webhook_secret [String, nil] Defaults to `ENV["ORB_WEBHOOK_SECRET"]`
+    #
     # @param base_url [String, nil] Override the default base URL for the API, e.g.,
     # `"https://api.example.com/v2/"`. Defaults to `ENV["ORB_BASE_URL"]`
     #
@@ -174,6 +179,7 @@ class Client < Orb::Internal::Transport::BaseClient
     # @param idempotency_header [String]
     def initialize(
       api_key: ENV["ORB_API_KEY"],
+      webhook_secret: ENV["ORB_WEBHOOK_SECRET"],
       base_url: ENV["ORB_BASE_URL"],
       max_retries: self.class::DEFAULT_MAX_RETRIES,
       timeout: self.class::DEFAULT_TIMEOUT_IN_SECONDS,
@@ -188,6 +194,7 @@ def initialize(
       end
 
       @api_key = api_key.to_s
+      @webhook_secret = webhook_secret&.to_s
 
       super(
         base_url: base_url,

rbi/orb/client.rbi

@@ -13,6 +13,9 @@ module Orb
     sig { returns(String) }
     attr_reader :api_key
 
+    sig { returns(T.nilable(String)) }
+    attr_reader :webhook_secret
+
     sig { returns(Orb::Resources::TopLevel) }
     attr_reader :top_level
 
@@ -151,6 +154,7 @@ module Orb
     sig do
       params(
         api_key: T.nilable(String),
+        webhook_secret: T.nilable(String),
         base_url: T.nilable(String),
         max_retries: Integer,
         timeout: Float,
@@ -162,6 +166,8 @@ module Orb
     def self.new(
       # Defaults to `ENV["ORB_API_KEY"]`
       api_key: ENV["ORB_API_KEY"],
+      # Defaults to `ENV["ORB_WEBHOOK_SECRET"]`
+      webhook_secret: ENV["ORB_WEBHOOK_SECRET"],
       # 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"],

sig/orb/client.rbs

@@ -10,6 +10,8 @@ module Orb
 
     attr_reader api_key: String
 
+    attr_reader webhook_secret: String?
+
     attr_reader top_level: Orb::Resources::TopLevel
 
     attr_reader beta: Orb::Resources::Beta
@@ -52,6 +54,7 @@ module Orb
 
     def initialize: (
       ?api_key: String?,
+      ?webhook_secret: String?,
       ?base_url: String?,
       ?max_retries: Integer,
       ?timeout: Float,