add event handler class

justfile

@@ -29,7 +29,7 @@ _mise_install_dotnet:
   export DOTNET_ROOT="$(mise where dotnet)"
 
 _dotnet_install tpv:
-  ./scripts/dotnet-install.sh --channel {{ tpv }} --install-dir $DOTNET_ROOT
+  ./scripts/dotnet-install.sh --channel {{ tpv }} --install-dir "$(mise where dotnet)"
 
 _ensure_latest_dotnet:
   #!/usr/bin/env bash

src/Stripe.net/Infrastructure/Public/LiveApiRequestor.cs

@@ -87,6 +87,14 @@ public LiveApiRequestor(StripeClientOptions options, List<string> defaultUsage =
         /// <value>The <see cref="IHttpClient"/> used to send HTTP requests.</value>
         public override IHttpClient HttpClient { get; }
 
+        /// <summary>Gets or sets the current StripeContext for this requestor.</summary>
+        /// <value>The current StripeContext.</value>
+        internal StripeContext CurrentStripeContext
+        {
+            get => this.clientOptions.StripeContext;
+            set => this.clientOptions.StripeContext = value;
+        }
+
         /// <summary>Sends a request to Stripe's API as an asynchronous operation.</summary>
         /// <typeparam name="T">Type of the Stripe entity returned by the API.</typeparam>
         /// <param name="baseAddress">The base address of the request.</param>

src/Stripe.net/Infrastructure/Public/StripeClient.cs

@@ -229,6 +229,11 @@ public EventNotification ParseEventNotification(
             return EventNotification.FromJson(json, this);
         }
 
+        public StripeEventRouter Router(string webhookSecret, EventHandler<StripeUnhandledEventNotificationEventArgs> unhandledEventHandler)
+        {
+            return new StripeEventRouter(this, webhookSecret, unhandledEventHandler);
+        }
+
         internal JsonSerializerSettings GetJsonSerializationSettings()
         {
             return this.jsonSerializerSettings;

src/Stripe.net/Infrastructure/Public/StripeEventNotificationEventArgs.cs

@@ -0,0 +1,34 @@
+namespace Stripe
+{
+    using System;
+
+    /// <summary>
+    /// EventArgs for Stripe webhook event notifications.
+    /// Contains the strongly-typed EventNotification and the StripeClient instance.
+    /// </summary>
+    /// <typeparam name="TEventNotification">The type of EventNotification.</typeparam>
+    public class StripeEventNotificationEventArgs<TEventNotification> : EventArgs
+        where TEventNotification : V2.Core.EventNotification
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="StripeEventNotificationEventArgs{TEventNotification}"/> class.
+        /// </summary>
+        /// <param name="eventNotification">The event notification instance.</param>
+        /// <param name="client">The StripeClient instance.</param>
+        public StripeEventNotificationEventArgs(TEventNotification eventNotification, StripeClient client)
+        {
+            this.EventNotification = eventNotification ?? throw new ArgumentNullException(nameof(eventNotification));
+            this.Client = client ?? throw new ArgumentNullException(nameof(client));
+        }
+
+        /// <summary>
+        /// Gets the event notification instance.
+        /// </summary>
+        public TEventNotification EventNotification { get; }
+
+        /// <summary>
+        /// Gets the StripeClient instance that can be used to make API requests.
+        /// </summary>
+        public StripeClient Client { get; }
+    }
+}

src/Stripe.net/Infrastructure/StripeUnhandledEventNotificationEventArgs.cs

@@ -0,0 +1,39 @@
+namespace Stripe
+{
+    using System;
+
+    /// <summary>
+    /// EventArgs for Stripe webhook event notifications.
+    /// Contains the strongly-typed EventNotification and the StripeClient instance.
+    /// </summary>
+    public class StripeUnhandledEventNotificationEventArgs : EventArgs
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="StripeUnhandledEventNotificationEventArgs"/> class.
+        /// </summary>
+        /// <param name="eventNotification">The event notification instance.</param>
+        /// <param name="client">The StripeClient instance.</param>
+        /// <param name="details">Details about the unhandled notification.</param>
+        public StripeUnhandledEventNotificationEventArgs(V2.Core.EventNotification eventNotification, StripeClient client, UnhandledNotificationDetails details)
+        {
+            this.EventNotification = eventNotification ?? throw new ArgumentNullException(nameof(eventNotification));
+            this.Client = client ?? throw new ArgumentNullException(nameof(client));
+            this.Details = details ?? throw new ArgumentNullException(nameof(details));
+        }
+
+        /// <summary>
+        /// Gets the event notification instance.
+        /// </summary>
+        public V2.Core.EventNotification EventNotification { get; }
+
+        /// <summary>
+        /// Gets the StripeClient instance that can be used to make API requests.
+        /// </summary>
+        public StripeClient Client { get; }
+
+        /// <summary>
+        /// Gets details about the unhandled notification.
+        /// </summary>
+        public UnhandledNotificationDetails Details { get; }
+    }
+}

src/Stripe.net/Infrastructure/UnhandledNotificationDetails.cs

@@ -0,0 +1,22 @@
+namespace Stripe
+{
+    /// <summary>
+    /// EventArgs for Stripe webhook event notifications.
+    /// Contains the strongly-typed EventNotification and the StripeClient instance.
+    /// </summary>
+    public class UnhandledNotificationDetails
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="UnhandledNotificationDetails"/> class.
+        /// </summary>
+        public UnhandledNotificationDetails(bool isKnownEventType)
+        {
+            this.IsKnownEventType = isKnownEventType;
+        }
+
+        /// <summary>
+        /// Gets the StripeClient instance that can be used to make API requests.
+        /// </summary>
+        public bool IsKnownEventType { get; }
+    }
+}