Introduced webhook support (#31)

Author: dcodesdev

.cursor/rules/general.mdc

@@ -1,7 +1,7 @@
 ---
 description: 
 globs: 
-alwaysApply: false
+alwaysApply: true
 ---
 # Project overview
 

.github/workflows/docker.yaml

@@ -20,32 +20,28 @@ jobs:
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
       - name: Login to GitHub Container Registry
         uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.repository_owner }}
           password: ${{ github.token }}
 
-      - name: Extract Docker metadata (Bun)
-        id: meta-bun
-        uses: docker/metadata-action@v5
-        with:
-          images: ghcr.io/dcodesdev/letterspace
-          tags: |
-            type=ref,event=tag
-            type=semver,pattern={{version}}
-            type=semver,pattern={{major}}.{{minor}}
-            type=semver,pattern={{major}}
-            type=raw,value=latest,enable=${{ !contains(github.ref, '-') }}
-            type=raw,value=bun,enable=${{ !contains(github.ref, '-') }}
+      - name: Generate Docker tags (Bun)
+        id: tags-bun
+        run: |
+          TAGS=$(bun scripts/gen-container-img-tags.ts bun)
+          echo "tags=$TAGS" >> $GITHUB_OUTPUT
 
       - name: Build and push Docker image (Bun)
         uses: docker/build-push-action@v6
         with:
           context: .
           push: true
-          tags: ${{ steps.meta-bun.outputs.tags }}
+          tags: ${{ steps.tags-bun.outputs.tags }}
           # platforms: linux/amd64,linux/arm64
           cache-from: type=gha,scope=bun
           cache-to: type=gha,mode=max,scope=bun
@@ -63,34 +59,29 @@ jobs:
       - name: Set up Docker Buildx
         uses: docker/setup-buildx-action@v3
 
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+
       - name: Login to GitHub Container Registry
         uses: docker/login-action@v3
         with:
           registry: ghcr.io
           username: ${{ github.repository_owner }}
           password: ${{ github.token }}
 
-      - name: Extract Docker metadata (Node)
-        id: meta-node
-        uses: docker/metadata-action@v5
-        with:
-          images: ghcr.io/dcodesdev/letterspace
-          tags: |
-            type=ref,event=tag,suffix=-node
-            type=semver,pattern={{version}}-node
-            type=semver,pattern={{major}}.{{minor}}-node
-            type=semver,pattern={{major}}-node
-            type=raw,value=latest-node,enable=${{ !contains(github.ref, '-') }}
-            type=raw,value=node,enable=${{ !contains(github.ref, '-') }}
-            type=raw,value=latest,enable=false
+      - name: Generate Docker tags (Node)
+        id: tags-node
+        run: |
+          TAGS=$(bun scripts/gen-container-img-tags.ts node)
+          echo "tags=$TAGS" >> $GITHUB_OUTPUT
 
       - name: Build and push Docker image (Node)
         uses: docker/build-push-action@v6
         with:
           context: .
           file: ./Dockerfile.node
           push: true
-          tags: ${{ steps.meta-node.outputs.tags }}
+          tags: ${{ steps.tags-node.outputs.tags }}
           # platforms: linux/amd64,linux/arm64
           cache-from: type=gha,scope=node
           cache-to: type=gha,mode=max,scope=node
@@ -107,3 +98,4 @@ jobs:
         uses: softprops/action-gh-release@v2
         with:
           body_path: RELEASE_NOTES.md
+          prerelease: ${{ contains(github.ref_name, '-') }}

README.md

@@ -25,6 +25,18 @@ LetterSpace is an open source newsletter application that gives you complete con
 - TRPC
 - Prisma
 
+## Environment Variables
+
+### Required Variables
+
+- `JWT_SECRET` - Secret key for JWT token signing
+- `DATABASE_URL` - PostgreSQL database connection string
+
+### Optional Variables
+
+- `WEBHOOK_MEMORY_LIMIT` - Memory limit for webhook transformer runtime in bytes (default: 16777216 = 16MB)
+- `WEBHOOK_MAX_STACK_SIZE` - Maximum stack size for webhook transformer in bytes (default: 262144 = 256KB)
+
 ## Getting Started
 
 ## Deployment

RELEASE_NOTES.md

@@ -1,12 +1,18 @@
 ### ✨ Features
 
-- Message status independence - retry individual messages regardless of campaign status
+- **Webhooks Support** - Receive real-time notifications for email events (delivered, opened, clicked, bounced, complained)
+  - Custom webhook endpoints with authentication and transformation code support
+  - Process email status updates from external email service providers
+  - **Webhook Request Logging** - View detailed logs of all webhook requests with status codes, payloads, responses, and timing information
+- **Complained Message Status** - Track when recipients mark emails as spam
+- **Monaco Code Editor** - Enhanced code editing experience for webhook configuration
+- **Awaiting Webhook Status** - Track when messages are awaiting webhook processing
 
 ### 🐛 Bug Fixes
 
-- Fixed campaign creation targeting wrong subscribers (now filters by selected lists only)
-- Fixed campaign cancellation
+- Fixed unsubscribe functionality
 
 ### 📚 Docs
 
-See the latest documentation at [docs.letterspace.app](https://docs.letterspace.app).
+- Added comprehensive webhook documentation and event reference
+- See the latest documentation at [docs.letterspace.app](https://docs.letterspace.app).

apps/backend/package.json

@@ -10,7 +10,7 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "generate": "prisma generate",
-    "generate:sql": "prisma generate --sql && pnpm exec prettier --write prisma/client",
+    "generate:sql": "prisma generate --sql",
     "test": "dotenv -e .env.test -- vitest"
   },
   "exports": {
@@ -37,6 +37,7 @@
     "node-cron": "^3.0.3",
     "nodemailer": "^6.10.0",
     "p-map": "^7.0.3",
+    "quickjs-emscripten": "^0.31.0",
     "superjson": "^2.2.2",
     "uuid": "^11.0.5",
     "zod": "^3.24.2"

apps/backend/prisma/client/sql/$DbEnums.d.ts

@@ -1,19 +1,8 @@
 export interface $DbEnums {}
 
+
 export namespace $DbEnums {
-  type CampaignStatus =
-    | "DRAFT"
-    | "SCHEDULED"
-    | "SENDING"
-    | "COMPLETED"
-    | "CANCELLED";
-  type MessageStatus =
-    | "QUEUED"
-    | "PENDING"
-    | "SENT"
-    | "OPENED"
-    | "CLICKED"
-    | "FAILED"
-    | "RETRYING";
-  type SmtpEncryption = "STARTTLS" | "SSL_TLS" | "NONE";
+  type CampaignStatus = "DRAFT" | "SCHEDULED" | "CREATING" | "SENDING" | "COMPLETED" | "CANCELLED"
+  type MessageStatus = "QUEUED" | "PENDING" | "SENT" | "AWAITING_WEBHOOK" | "OPENED" | "CLICKED" | "FAILED" | "RETRYING" | "CANCELLED" | "COMPLAINED"
+  type SmtpEncryption = "STARTTLS" | "SSL_TLS" | "NONE"
 }

apps/backend/prisma/client/sql/countDbSize.d.ts

@@ -1,22 +1,21 @@
-import * as $runtime from "../runtime/library";
+import * as $runtime from "../runtime/library"
 
 /**
  * @param text
  */
-export const countDbSize: (
-  text: string,
-) => $runtime.TypedSql<countDbSize.Parameters, countDbSize.Result>;
+export const countDbSize: (text: string) => $runtime.TypedSql<countDbSize.Parameters, countDbSize.Result>
 
 export namespace countDbSize {
-  export type Parameters = [text: string];
+  export type Parameters = [text: string]
   export type Result = {
-    organization_id: string;
-    organization_name: string;
-    campaign_count: bigint | null;
-    template_count: bigint | null;
-    message_count: bigint | null;
-    subscriber_count: bigint | null;
-    list_count: bigint | null;
-    total_size_mb: $runtime.Decimal | null;
-  };
+    organization_id: string
+    organization_name: string
+    campaign_count: bigint | null
+    template_count: bigint | null
+    message_count: bigint | null
+    subscriber_count: bigint | null
+    list_count: bigint | null
+    webhook_log_count: bigint | null
+    total_size_mb: $runtime.Decimal | null
+  }
 }