Add Lemon Squeezy Billing System

packages/billing/core/src/services/billing-strategy-provider.service.ts

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+
+import {
+  CancelSubscriptionParamsSchema,
+  CreateBillingCheckoutSchema,
+  CreateBillingPortalSessionSchema,
+  RetrieveCheckoutSessionSchema,
+} from '../schema';
+import { ReportBillingUsageSchema } from '../schema';
+
+export abstract class BillingStrategyProviderService {
+  abstract createBillingPortalSession(
+    params: z.infer<typeof CreateBillingPortalSessionSchema>,
+  ): Promise<{
+    url: string;
+  }>;
+
+  abstract retrieveCheckoutSession(
+    params: z.infer<typeof RetrieveCheckoutSessionSchema>,
+  ): Promise<{
+    checkoutToken: string | null;
+    status: 'complete' | 'expired' | 'open';
+    isSessionOpen: boolean;
+
+    customer: {
+      email: string | null;
+    };
+  }>;
+
+  abstract createCheckoutSession(
+    params: z.infer<typeof CreateBillingCheckoutSchema>,
+  ): Promise<{
+    checkoutToken: string;
+  }>;
+
+  abstract cancelSubscription(
+    params: z.infer<typeof CancelSubscriptionParamsSchema>,
+  ): Promise<{
+    success: boolean;
+  }>;
+
+  abstract reportUsage(
+    params: z.infer<typeof ReportBillingUsageSchema>,
+  ): Promise<{
+    success: boolean;
+  }>;
+}

packages/billing/core/src/services/billing-webhook-handler.service.ts

@@ -0,0 +1,44 @@
+import { Database } from '@kit/supabase/database';
+
+type UpsertSubscriptionParams =
+  Database['public']['Functions']['upsert_subscription']['Args'];
+
+type UpsertOrderParams =
+  Database['public']['Functions']['upsert_order']['Args'];
+
+/**
+ * @name BillingWebhookHandlerService
+ * @description Represents an abstract class for handling billing webhook events.
+ */
+export abstract class BillingWebhookHandlerService {
+  // Verifies the webhook signature - should throw an error if the signature is invalid
+  abstract verifyWebhookSignature(request: Request): Promise<unknown>;
+
+  abstract handleWebhookEvent(
+    event: unknown,
+    params: {
+      // this method is called when a checkout session is completed
+      onCheckoutSessionCompleted: (
+        subscription: UpsertSubscriptionParams | UpsertOrderParams,
+        customerId: string,
+      ) => Promise<unknown>;
+
+      // this method is called when a subscription is updated
+      onSubscriptionUpdated: (
+        subscription: UpsertSubscriptionParams,
+        customerId: string,
+      ) => Promise<unknown>;
+
+      // this method is called when a subscription is deleted
+      onSubscriptionDeleted: (subscriptionId: string) => Promise<unknown>;
+
+      // this method is called when a payment is succeeded. This is used for
+      // one-time payments
+      onPaymentSucceeded: (sessionId: string) => Promise<unknown>;
+
+      // this method is called when a payment is failed. This is used for
+      // one-time payments
+      onPaymentFailed: (sessionId: string) => Promise<unknown>;
+    },
+  ): Promise<unknown>;
+}