feat: migrate to Sentry.io monitoring, upgrade to Node 22, add folders to Swagger docs

- Replace Prometheus/Grafana monitoring with Sentry.io for error tracking and performance monitoring
- Add PostgreSQL integration and source maps with automatic upload in production builds
- Implement automated Sentry release tracking via GitHub Actions
- Upgrade Node.js from 20 to 22 across all Docker images and CI/CD workflows
- Add folders endpoints to OpenAPI/Swagger documentation (GET, POST, PUT, DELETE, reorder)
- Add API_URL configuration for Swagger docs server URL
- Remove all Prometheus metrics code and grafana/ directory
- Remove New Relic change tracking workflow
- Fix TypeScript and ESLint errors in WebSocket and database modules

Author: rui-batalabs

.env.example

@@ -45,6 +45,13 @@ PORT=3000
 # Environment
 NODE_ENV=development
 
+# API URL (for OpenAPI/Swagger documentation)
+# This sets the server URL shown in the Swagger docs
+# Development (default):
+API_URL=http://localhost:3000
+# Production example:
+# API_URL=https://api.typelets.com
+
 # ================================================================
 # SECURITY CONFIGURATION
 # ================================================================
@@ -118,14 +125,18 @@ FREE_TIER_NOTE_LIMIT=100# Note count limit for free users (default: 100)
 # LOGGING & MONITORING
 # ================================================================
 
-# Prometheus Metrics API Key (REQUIRED for production)
-# Protects /metrics endpoint from unauthorized access with Basic Auth
-# Generate with: openssl rand -hex 32
-# Configure in Grafana data source: Basic Auth with username "metrics" and password <key>
-METRICS_API_KEY=your-secure-metrics-api-key-here-min-32-chars
+# Sentry.io Error Tracking (OPTIONAL)
+# Get your DSN from: https://sentry.io/settings/bata-labs/projects/typelets-api/keys/
+# Format: https://<key>@<org-id>.ingest.us.sentry.io/<project-id>
+# SENTRY_DSN=https://your-sentry-dsn-here
+# Error tracking, performance monitoring, and profiling are enabled by default
+# Errors are automatically captured and sent to Sentry with full context
 
-# Debug Logging
-# DEBUG=false                         # Set to true for verbose logging (not recommended in production)
+# Sentry Auth Token (REQUIRED for production builds with source maps)
+# Get from: https://sentry.io/settings/account/api/auth-tokens/
+# Scope needed: project:releases, project:write
+# SENTRY_AUTH_TOKEN=your-sentry-auth-token-here
+# This is only needed during production builds to upload source maps
 
 # Application Logging
 # Structured logs are automatically generated for:
@@ -135,6 +146,7 @@ METRICS_API_KEY=your-secure-metrics-api-key-here-min-32-chars
 # - Billing limit violations
 # - WebSocket connection events
 # - File upload events
+# All console logs are also captured by Sentry for centralized monitoring
 
 # ================================================================
 # DEVELOPMENT HELPERS

.github/workflows/ci.yml

@@ -12,7 +12,7 @@ jobs:
 
     strategy:
       matrix:
-        node-version: [20.x, 22.x]
+        node-version: [22.x]
 
     steps:
       - uses: actions/checkout@v4

.github/workflows/codeql.yml

@@ -34,7 +34,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "20"
+          node-version: "22"
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v4

.github/workflows/new-relic-change-tracking.yml

@@ -21,7 +21,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: "20"
+          node-version: "22"
 
       - name: Setup pnpm
         uses: pnpm/action-setup@v4
@@ -32,6 +32,9 @@ jobs:
         run: pnpm install
 
       - name: Build
+        env:
+          NODE_ENV: production
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
         run: NODE_OPTIONS="--max-old-space-size=8192" pnpm run build
 
       - name: Release

.github/workflows/release.yml

@@ -0,0 +1,38 @@
+name: Sentry Release Tracking
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  sentry-release:
+    runs-on: ubuntu-latest
+    name: Create Sentry Release
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Fetch all history for commit tracking
+
+      - name: Set Release Version from Tag
+        run: echo "RELEASE_VERSION=${{ github.ref_name }}" >> $GITHUB_ENV
+
+      - name: Install Sentry CLI
+        run: curl -sL https://sentry.io/get-cli/ | bash
+
+      - name: Create Sentry Release
+        env:
+          SENTRY_AUTH_TOKEN: ${{ secrets.SENTRY_AUTH_TOKEN }}
+          SENTRY_ORG: bata-labs
+          SENTRY_PROJECT: typelets-api
+        run: |
+          # Create new release
+          sentry-cli releases new "${{ env.RELEASE_VERSION }}"
+
+          # Associate commits with the release (auto-detect from git)
+          sentry-cli releases set-commits "${{ env.RELEASE_VERSION }}" --auto
+
+          # Finalize the release
+          sentry-cli releases finalize "${{ env.RELEASE_VERSION }}"
+
+          echo "✅ Sentry release ${{ env.RELEASE_VERSION }} created successfully"

.github/workflows/sentry-release.yml

@@ -1,9 +1,8 @@
 # [1.10.0](https://github.com/typelets/typelets-api/compare/v1.9.0...v1.10.0) (2025-10-18)
 
-
 ### Features
 
-* add Folders to Swagger and organize monitoring configs ([a483df0](https://github.com/typelets/typelets-api/commit/a483df02a05c9cc0251ee66533a0a326484a2218))
+- add Folders to Swagger and organize monitoring configs ([a483df0](https://github.com/typelets/typelets-api/commit/a483df02a05c9cc0251ee66533a0a326484a2218))
 
 # [1.9.0](https://github.com/typelets/typelets-api/compare/v1.8.2...v1.9.0) (2025-10-17)
 

CHANGELOG.md

@@ -1,5 +1,5 @@
 # Multi-stage build for Node.js backend
-FROM node:20-alpine AS builder
+FROM node:22-alpine AS builder
 
 WORKDIR /app
 
@@ -19,7 +19,7 @@ COPY . .
 RUN pnpm build
 
 # Production stage
-FROM node:20-alpine AS production
+FROM node:22-alpine AS production
 
 WORKDIR /app