many fixes and improvements - rework for modules/ and common/

feat(emailer): add Postmark and Resend providers

backend/Infrastructure/Payments/Stripe/Configuration/StripeOptions.cs

@@ -0,0 +1,14 @@
+using System.ComponentModel.DataAnnotations;
+
+namespace Hutopy.Infrastructure.Payments.Stripe.Configuration;
+
+public class StripeOptions
+{
+    public const string ConfigurationSection = "Stripe";
+    
+    [Required] public required string SecretKey { get; init; }
+
+    [Required] public required string WebhookSecret { get; init; }
+
+    [Required] [Range(0, 1)] public required decimal HutopyRate { get; init; }
+}

backend/Infrastructure/Payments/Stripe/Services/MembershipCancellationProcessor.cs

@@ -0,0 +1,28 @@
+using Hutopy.Modules.Memberships.Contracts;
+using Stripe;
+
+namespace Hutopy.Infrastructure.Payments.Stripe.Services;
+
+public sealed class MembershipCancellationProcessor
+    : IMembershipCancellationProcessor
+{
+    public async Task<DateTimeOffset?> CancelAsync(
+        string subscriptionId,
+        CancellationToken ct = default)
+    {
+        SubscriptionService subscriptionService = new();
+
+        // Stripe - Cancel Subscription immediately
+        // var subscription = await subscriptionService.CancelAsync(
+        //     subscriptionId,
+        //     cancellationToken: ct);
+
+        // Stripe - Cancel Subscription AtPeriodEnd
+        Subscription? subscription = await subscriptionService.UpdateAsync(
+            subscriptionId,
+            new SubscriptionUpdateOptions { CancelAtPeriodEnd = true },
+            cancellationToken: ct);
+
+        return subscription.CancelAt ?? subscription.CanceledAt;
+    }
+}

backend/Infrastructure/Payments/Stripe/Services/MembershipPaymentProcessor.cs

@@ -0,0 +1,65 @@
+using Hutopy.Infrastructure.Payments.Stripe.Configuration;
+using Hutopy.Modules.Creators.Contracts;
+using Hutopy.Modules.Memberships.Contracts;
+using Microsoft.Extensions.Options;
+using Stripe;
+using Stripe.Checkout;
+
+namespace Hutopy.Infrastructure.Payments.Stripe.Services;
+
+public class MembershipPaymentProcessor(
+    IOptions<StripeOptions> stripeOptions)
+: IMembershipPaymentProcessor
+{
+    public async Task<MembershipCheckoutSession> CreateCheckoutSessionAsync(
+        Guid userId,
+        CreatorReference creatorReference,
+        Guid tierId,
+        string priceId,
+        string successUrl,
+        string cancelUrl)
+    {
+        StripeConfiguration.ApiKey = stripeOptions.Value.SecretKey;
+
+        // Create Stripe customer for the user if not already created
+        var customerService = new CustomerService();
+        var customer = await customerService.CreateAsync(
+            new CustomerCreateOptions
+            {
+                Metadata = new Dictionary<string, string> { { "userId", userId.ToString() } }
+            });
+
+        // Create Checkout Session for the subscription
+        var sessionService = new SessionService();
+        var session = await sessionService.CreateAsync(
+            new SessionCreateOptions
+            {
+                Customer = customer.Id,
+                PaymentMethodTypes = ["card"],
+                LineItems =
+                [
+                    new SessionLineItemOptions { Price = priceId, Quantity = 1 }
+                ],
+                Mode = "subscription",
+                SubscriptionData = new SessionSubscriptionDataOptions
+                {
+                    ApplicationFeePercent = stripeOptions.Value.HutopyRate,
+                    TransferData = new SessionSubscriptionDataTransferDataOptions { Destination = creatorReference.StripeAccountId }
+                },
+                SuccessUrl = successUrl, // Redirect after successful payment
+                CancelUrl = cancelUrl, // Redirect after canceled payment
+                Metadata = new Dictionary<string, string>
+                {
+                    { "userId", userId.ToString() },
+                    { "creatorId", creatorReference.Id.ToString() },
+                    { "creatorName", creatorReference.Name },
+                    { "tierId", tierId.ToString() }
+                }
+            });
+
+        return new MembershipCheckoutSession(
+            session.Id,
+            session.Url);
+    }
+
+}

backend/Infrastructure/Payments/Stripe/Services/MembershipTierProcessor.cs

@@ -0,0 +1,43 @@
+using Hutopy.Infrastructure.Payments.Stripe.Configuration;
+using Hutopy.Modules.Memberships.Contracts;
+using Microsoft.Extensions.Options;
+using Stripe;
+
+namespace Hutopy.Infrastructure.Payments.Stripe.Services;
+
+public sealed class MembershipTierProcessor(
+    IOptions<StripeOptions> stripeOptions) 
+    : IMembershipTierProcessor
+{
+    public async Task<string> CreateAsync(
+        Guid creatorId,
+        Guid tierId,
+        string productName,
+        string currencyCode,
+        decimal amount)
+    {
+        StripeConfiguration.ApiKey = stripeOptions.Value.SecretKey;
+
+        // Create the product
+        var productService = new ProductService();
+        var product = await productService.CreateAsync(
+            new ProductCreateOptions
+            {
+                Name = productName,
+                Metadata = { { "creatorId", creatorId.ToString() }, { "tierId", tierId.ToString() } }
+            });
+
+        // Create the price for the product
+        var priceService = new PriceService();
+        await priceService.CreateAsync(
+            new PriceCreateOptions
+            {
+                Product = product.Id,
+                UnitAmountDecimal = amount * 100, // Convert amount to cents
+                Currency = currencyCode,
+                Recurring = new PriceRecurringOptions { Interval = "month" }
+            });
+
+        return product.Id;
+    }
+}

backend/Infrastructure/Payments/Stripe/Services/StripeTipProcessor.cs

@@ -0,0 +1,78 @@
+using Hutopy.Infrastructure.Payments.Stripe.Configuration;
+using Hutopy.Modules.Creators.Contracts;
+using Hutopy.Modules.Tipping.Contracts;
+using Microsoft.Extensions.Options;
+using Stripe;
+using Stripe.Checkout;
+
+namespace Hutopy.Infrastructure.Payments.Stripe.Services;
+
+public class StripeTipProcessor(
+    IOptions<StripeOptions> stripeOptions)
+    : ITipProcessor
+{
+    public async Task<TipCheckoutSession> CreateCheckoutSessionAsync(
+        Guid tipId,
+        CreatorReference creator,
+        decimal amount,
+        string currency,
+        string message,
+        string successUrl,
+        string cancelUrl,
+        CancellationToken ct = default)
+    {
+        StripeConfiguration.ApiKey = stripeOptions.Value.SecretKey;
+
+        // Create Stripe customer for the user if not already created
+        var customerService = new CustomerService();
+        var customer = await customerService.CreateAsync(
+            new CustomerCreateOptions(),
+            cancellationToken: ct);
+
+        // Create paymentIntent for the user
+        var sessionService = new SessionService();
+        var session = await sessionService.CreateAsync(
+            new SessionCreateOptions
+            {
+                ClientReferenceId = tipId.ToString(),
+                Customer = customer.Id,
+                PaymentMethodTypes = ["card"],
+                LineItems =
+                [
+                    new SessionLineItemOptions
+                    {
+                        PriceData = new SessionLineItemPriceDataOptions
+                        {
+                            Currency = currency,
+                            UnitAmountDecimal = amount, // Amount in cents
+                            ProductData = new SessionLineItemPriceDataProductDataOptions
+                            {
+                                Name = $"Tip for {creator.Name}", // or any descriptive name for the tip
+                                Metadata = new Dictionary<string, string> { { "creatorId", creator.Id.ToString() } }
+                            }
+                        },
+                        Quantity = 1
+                    }
+                ],
+                Mode = "payment",
+                PaymentIntentData = new SessionPaymentIntentDataOptions
+                {
+                    ApplicationFeeAmount =
+                        Convert.ToInt64(amount * 100 * stripeOptions.Value.HutopyRate), // Platform fee
+                    TransferData = new SessionPaymentIntentDataTransferDataOptions
+                    {
+                        Destination = creator.StripeAccountId // Creator's Stripe account ID
+                    }
+                },
+                SuccessUrl = successUrl, // Redirect after successful payment
+                CancelUrl = cancelUrl, // Redirect after canceled payment
+                Metadata = new Dictionary<string, string>
+                {
+                    { "creatorId", creator.Id.ToString() }, { "creatorName", creator.Name }, { "message", message },
+                }
+            },
+            cancellationToken: ct);
+
+        return new TipCheckoutSession(session.Id, session.Url);
+    }
+}