B2B-88: add starter kit structure and elements

packages/database-webhooks/src/server/services/database-webhook-handler.service.ts

@@ -0,0 +1,88 @@
+import 'server-only';
+
+import { getLogger } from '@kit/shared/logger';
+import { getSupabaseServerAdminClient } from '@kit/supabase/server-admin-client';
+
+import { RecordChange, Tables } from '../record-change.type';
+import { createDatabaseWebhookRouterService } from './database-webhook-router.service';
+import { getDatabaseWebhookVerifier } from './verifier';
+
+/**
+ * @name DatabaseChangePayload
+ * @description Payload for the database change event. Useful for handling custom webhooks.
+ */
+export type DatabaseChangePayload<Table extends keyof Tables> =
+  RecordChange<Table>;
+
+export function getDatabaseWebhookHandlerService() {
+  return new DatabaseWebhookHandlerService();
+}
+
+/**
+ * @name getDatabaseWebhookHandlerService
+ * @description Get the database webhook handler service
+ */
+class DatabaseWebhookHandlerService {
+  private readonly namespace = 'database-webhook-handler';
+
+  /**
+   * @name handleWebhook
+   * @description Handle the webhook event
+   * @param params
+   */
+  async handleWebhook(params: {
+    body: RecordChange<keyof Tables>;
+    signature: string;
+    handleEvent?<Table extends keyof Tables>(
+      payload: Table extends keyof Tables
+        ? DatabaseChangePayload<Table>
+        : never,
+    ): unknown;
+  }) {
+    const logger = await getLogger();
+    const { table, type } = params.body;
+
+    const ctx = {
+      name: this.namespace,
+      table,
+      type,
+    };
+
+    logger.info(ctx, 'Received webhook from DB. Processing...');
+
+    // check if the signature is valid
+    const verifier = await getDatabaseWebhookVerifier();
+
+    await verifier.verifySignatureOrThrow(params.signature);
+
+    // all good, we can now the webhook
+
+    // create a client with admin access since we are handling webhooks and no user is authenticated
+    const adminClient = getSupabaseServerAdminClient();
+
+    const service = createDatabaseWebhookRouterService(adminClient);
+
+    try {
+      // handle the webhook event based on the table
+      await service.handleWebhook(params.body);
+
+      // if a custom handler is provided, call it
+      if (params?.handleEvent) {
+        /* eslint-disable-next-line @typescript-eslint/no-explicit-any */
+        await params.handleEvent(params.body as any);
+      }
+
+      logger.info(ctx, 'Webhook processed successfully');
+    } catch (error) {
+      logger.error(
+        {
+          ...ctx,
+          error,
+        },
+        'Failed to process webhook',
+      );
+
+      throw error;
+    }
+  }
+}