Implement updateSubscription feature and refactor billing services

This commit introduces the updateSubscription method to the BillingStrategyProviderService, ensuring that subscriptions can be updated within the billing core. Additionally, a refactor has been applied to the BillingGatewayFactoryService and stripe-billing-strategy.service to improve error handling and the robustness of subscription updates. Logging in the webhook route has been adjusted for clarity and the data model has been enhanced.

packages/billing/gateway/src/server/services/billing-event-handler/billing-event-handler.service.ts

@@ -154,7 +154,7 @@ export class BillingEventHandlerService {
 
         Logger.info(
           {
-            namespace: 'billing',
+            namespace: this.namespace,
             sessionId,
           },
           'Successfully updated payment status',

packages/billing/gateway/src/server/services/billing-event-handler/billing-gateway-factory.service.ts

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 
 import {
+  BillingConfig,
   BillingProviderSchema,
   BillingWebhookHandlerService,
 } from '@kit/billing';
@@ -8,12 +9,13 @@ import {
 export class BillingEventHandlerFactoryService {
   static async GetProviderStrategy(
     provider: z.infer<typeof BillingProviderSchema>,
+    config: BillingConfig,
   ): Promise<BillingWebhookHandlerService> {
     switch (provider) {
       case 'stripe': {
         const { StripeWebhookHandlerService } = await import('@kit/stripe');
 
-        return new StripeWebhookHandlerService();
+        return new StripeWebhookHandlerService(config);
       }
 
       case 'lemon-squeezy': {
@@ -21,7 +23,7 @@ export class BillingEventHandlerFactoryService {
           '@kit/lemon-squeezy'
         );
 
-        return new LemonSqueezyWebhookHandlerService();
+        return new LemonSqueezyWebhookHandlerService(config);
       }
 
       case 'paddle': {

packages/billing/gateway/src/server/services/billing-event-handler/billing-gateway-provider-factory.ts

@@ -1,3 +1,4 @@
+import { BillingConfig } from '@kit/billing';
 import { Database } from '@kit/supabase/database';
 import { getSupabaseServerActionClient } from '@kit/supabase/server-actions-client';
 
@@ -12,9 +13,12 @@ import { BillingEventHandlerFactoryService } from './billing-gateway-factory.ser
 export async function getBillingEventHandlerService(
   clientProvider: () => ReturnType<typeof getSupabaseServerActionClient>,
   provider: Database['public']['Enums']['billing_provider'],
+  config: BillingConfig,
 ) {
-  const strategy =
-    await BillingEventHandlerFactoryService.GetProviderStrategy(provider);
+  const strategy = await BillingEventHandlerFactoryService.GetProviderStrategy(
+    provider,
+    config,
+  );
 
   return new BillingEventHandlerService(clientProvider, strategy);
 }

packages/billing/gateway/src/server/services/billing-gateway/billing-gateway.service.ts

@@ -5,7 +5,9 @@ import {
   CancelSubscriptionParamsSchema,
   CreateBillingCheckoutSchema,
   CreateBillingPortalSessionSchema,
+  ReportBillingUsageSchema,
   RetrieveCheckoutSessionSchema,
+  UpdateSubscriptionParamsSchema,
 } from '@kit/billing/schema';
 
 import { BillingGatewayFactoryService } from './billing-gateway-factory.service';
@@ -92,4 +94,35 @@ export class BillingGatewayService {
 
     return strategy.cancelSubscription(payload);
   }
+
+  /**
+   * Reports the usage of the billing.
+   * @description This is used to report the usage of the billing to the provider.
+   * @param params
+   */
+  async reportUsage(params: z.infer<typeof ReportBillingUsageSchema>) {
+    const strategy = await BillingGatewayFactoryService.GetProviderStrategy(
+      this.provider,
+    );
+
+    const payload = ReportBillingUsageSchema.parse(params);
+
+    return strategy.reportUsage(payload);
+  }
+
+  /**
+   * Updates a subscription with the specified parameters.
+   * @param params
+   */
+  async updateSubscriptionItem(
+    params: z.infer<typeof UpdateSubscriptionParamsSchema>,
+  ) {
+    const strategy = await BillingGatewayFactoryService.GetProviderStrategy(
+      this.provider,
+    );
+
+    const payload = UpdateSubscriptionParamsSchema.parse(params);
+
+    return strategy.updateSubscription(payload);
+  }
 }