Sprint revamp

.env.example

@@ -1,40 +1,86 @@
-# Environment configuration
-NODE_ENV=development # development or test or production
-PORT=3002
+# Server Configuration
+NODE_ENV=development
+PORT=3001
+SERVER_URL=http://localhost:3001
 ENABLE_FILE_LOGGING=true
-LOG_LEVEL="error"
-SERVER_URL="http://localhost"
-
-# Database configuration
-DB_HOST="localhost"
-DB_PORT=5433
-DB_USER="swaplink_user"
-DB_PASSWORD="swaplink_password"
-DB_NAME="swaplink_test"
-DATABASE_URL="postgresql://swaplink_user:swaplink_password@localhost:5433/swaplink_test" # based on the docker config
-
-# Redis
-REDIS_URL="redis://localhost:6380"
-REDIS_PORT=6380
-
-# JWT
-JWT_SECRET="test_jwt_secret_key_123"
-JWT_REFRESH_SECRET="test_refresh_secret_key_123"
-JWT_ACCESS_EXPIRATION=24h
-JWT_REFRESH_EXPIRATION=7d
 
-# Payment Providers
-GLOBUS_SECRET_KEY="test_mono_secret"
-GLOBUS_WEBHOOK_SECRET="test_webhook_secret"
+# Database Configuration
+DB_HOST=localhost
+DB_USER=swaplink_user
+DB_PASSWORD=swaplink_password
+DB_NAME=swaplink_mvp
+# Note: Port 5434 is for dev (docker-compose.yml), 5433 is for test (docker-compose.test.yml)
+DATABASE_URL=postgresql://swaplink_user:swaplink_password@localhost:5434/swaplink_mvp
+
+# Redis Configuration
+# Note: Port 6381 is for dev (docker-compose.yml), 6380 is for test (docker-compose.test.yml)
+REDIS_URL=redis://localhost:6381
+REDIS_PORT=6381
+
+# JWT Configuration
+JWT_SECRET=your_jwt_secret_key_here
+JWT_ACCESS_EXPIRATION=15m
+JWT_REFRESH_SECRET=your_jwt_refresh_secret_key_here
+JWT_REFRESH_EXPIRATION=7d
 
-# CORS (seperated by comma)
-CORS_URLS="http://localhost:3001"
+# Globus Bank API Configuration
+GLOBUS_SECRET_KEY=your_globus_secret_key
+GLOBUS_WEBHOOK_SECRET=your_globus_webhook_secret
+GLOBUS_BASE_URL=https://sandbox.globusbank.com/api
+GLOBUS_CLIENT_ID=your_globus_client_id
 
+# CORS Configuration
+CORS_URLS=http://localhost:3000
 
-# Email configuration
-SMTP_HOST="smtp.example.com"
+# Email Configuration (SMTP)
+SMTP_HOST=smtp.example.com
 SMTP_PORT=587
-SMTP_USER="user@example.com"
-SMTP_PASSWORD="password"
-EMAIL_TIMEOUT=5000
-FROM_EMAIL="from@example.com"
+SMTP_USER=your_smtp_user
+SMTP_PASSWORD=your_smtp_password
+EMAIL_TIMEOUT=10000
+FROM_EMAIL=onboarding@resend.dev
+
+# Resend Email Service (Primary - Recommended)
+# Get your API key from https://resend.com/api-keys
+# Free tier: 100 emails/day, 3,000/month
+RESEND_API_KEY=re_your_resend_api_key_here
+
+# SendGrid Email Service (Fallback - Optional)
+# Get your API key from https://app.sendgrid.com/settings/api_keys
+SENDGRID_API_KEY=SG.your_sendgrid_api_key_here
+
+# Mailtrap Email Service (Staging - Fallback)
+# Get your API token from https://mailtrap.io/api-tokens
+MAILTRAP_API_TOKEN=your_mailtrap_api_token_here
+
+# Mailtrap SMTP (Deprecated - kept for backward compatibility)
+# Note: SMTP may not work on Railway/cloud platforms due to port restrictions
+MAILTRAP_HOST=sandbox.smtp.mailtrap.io
+MAILTRAP_PORT=2525
+MAILTRAP_USER=
+MAILTRAP_PASSWORD=
+
+# Twilio SMS Service
+# Get your credentials from https://console.twilio.com/
+TWILIO_ACCOUNT_SID=your_twilio_account_sid_here
+TWILIO_AUTH_TOKEN=your_twilio_auth_token_here
+TWILIO_PHONE_NUMBER=+1234567890
+
+# Frontend Configuration
+FRONTEND_URL=http://localhost:3000
+
+# Cloudinary Storage Service (Primary)
+# Get credentials from https://cloudinary.com/console
+CLOUDINARY_CLOUD_NAME=your_cloud_name
+CLOUDINARY_API_KEY=your_api_key
+CLOUDINARY_API_SECRET=your_api_secret
+
+# Storage Configuration (S3/Cloudflare R2/MinIO)
+AWS_ACCESS_KEY_ID=minioadmin
+AWS_SECRET_ACCESS_KEY=minioadmin
+AWS_REGION=us-east-1
+AWS_BUCKET_NAME=swaplink
+AWS_ENDPOINT=http://localhost:9000
+
+# System Configuration
+SYSTEM_USER_ID=system-wallet-user

.env.staging.example

@@ -0,0 +1,73 @@
+# Server Configuration
+NODE_ENV=staging
+PORT=3001
+SERVER_URL=http://localhost:3001
+ENABLE_FILE_LOGGING=true
+STAGING=true
+
+# Database Configuration
+DB_HOST=localhost
+DB_USER=swaplink_user
+DB_PASSWORD=swaplink_password
+DB_NAME=swaplink_staging
+# Note: Port 5434 is for dev (docker-compose.yml)
+DATABASE_URL=postgresql://swaplink_user:swaplink_password@localhost:5434/swaplink_staging
+
+# Redis Configuration
+# Note: Port 6381 is for dev (docker-compose.yml)
+REDIS_URL=redis://localhost:6381
+REDIS_PORT=6381
+
+# JWT Configuration
+JWT_SECRET=your_jwt_secret_key_here
+JWT_ACCESS_EXPIRATION=15m
+JWT_REFRESH_SECRET=your_jwt_refresh_secret_key_here
+JWT_REFRESH_EXPIRATION=7d
+
+# Globus Bank API Configuration (Optional for staging)
+GLOBUS_SECRET_KEY=your_globus_secret_key
+GLOBUS_WEBHOOK_SECRET=your_globus_webhook_secret
+GLOBUS_BASE_URL=https://sandbox.globusbank.com/api
+GLOBUS_CLIENT_ID=your_globus_client_id
+
+# CORS Configuration
+CORS_URLS=http://localhost:3000
+
+# Email Configuration (SMTP) - Not used when Mailtrap is configured
+SMTP_HOST=smtp.example.com
+SMTP_PORT=587
+SMTP_USER=your_smtp_user
+SMTP_PASSWORD=your_smtp_password
+EMAIL_TIMEOUT=10000
+FROM_EMAIL=no-reply@swaplink.com
+
+# Resend Email Service (Not used in staging)
+RESEND_API_KEY=
+
+# SendGrid Email Service (Staging - Recommended for Railway/Cloud)
+# Get your API key from https://app.sendgrid.com/settings/api_keys
+SENDGRID_API_KEY=SG.your_sendgrid_api_key_here
+
+# Mailtrap Email Service (Staging - Local Development Fallback)
+# Get your API token from https://mailtrap.io/api-tokens
+MAILTRAP_API_TOKEN=your_mailtrap_api_token_here
+
+# Mailtrap SMTP (Deprecated - kept for backward compatibility)
+# Note: SMTP may not work on Railway/cloud platforms due to port restrictions
+MAILTRAP_HOST=sandbox.smtp.mailtrap.io
+MAILTRAP_PORT=2525
+MAILTRAP_USER=
+MAILTRAP_PASSWORD=
+
+# Frontend Configuration
+FRONTEND_URL=http://localhost:3000
+
+# Storage Configuration (S3/Cloudflare R2/MinIO)
+AWS_ACCESS_KEY_ID=minioadmin
+AWS_SECRET_ACCESS_KEY=minioadmin
+AWS_REGION=us-east-1
+AWS_BUCKET_NAME=swaplink
+AWS_ENDPOINT=http://localhost:9000
+
+# System Configuration
+SYSTEM_USER_ID=system-wallet-user

.eslintignore

@@ -0,0 +1,3 @@
+dist
+node_modules
+coverage

.eslintrc.json

@@ -0,0 +1,21 @@
+{
+    "parser": "@typescript-eslint/parser",
+    "extends": [
+        "eslint:recommended",
+        "plugin:@typescript-eslint/recommended",
+        "plugin:prettier/recommended"
+    ],
+    "parserOptions": {
+        "ecmaVersion": 2020,
+        "sourceType": "module"
+    },
+    "env": {
+        "node": true,
+        "es6": true
+    },
+    "rules": {
+        "@typescript-eslint/no-explicit-any": "warn",
+        "@typescript-eslint/no-unused-vars": ["warn", { "argsIgnorePattern": "^_" }],
+        "no-console": ["warn", { "allow": ["warn", "error", "info"] }]
+    }
+}

.gitignore

@@ -3,6 +3,22 @@ node_modules
 .env*
 .env.*
 !.env.example
+!.env.staging.example
 
 generated
-dist
+dist
+
+# Test Output
+test_output.txt
+test_output*.txt
+
+# User data
+uploads
+swaplink-demo-firebase-adminsdk-fbsvc-ebfd2ff064.json
+
+# logs
+logs
+*.log
+
+# Agents
+.agent

Dockerfile

@@ -0,0 +1,52 @@
+# Unified Dockerfile for SwapLink Server (API & Worker)
+FROM node:18-alpine AS builder
+
+WORKDIR /app
+
+# Install pnpm
+# Install pnpm and openssl
+RUN apk add --no-cache openssl && npm install -g pnpm
+
+# Copy package files
+COPY package.json pnpm-lock.yaml ./
+
+# Install dependencies (frozen lockfile for consistency)
+RUN pnpm install --frozen-lockfile
+
+# Copy Prisma schema and generate client
+COPY prisma ./prisma
+RUN pnpm db:generate
+
+# Copy source code
+COPY . .
+
+# Build TypeScript
+RUN pnpm build
+
+# Prune dev dependencies to keep image small
+ENV CI=true
+RUN pnpm prune --prod
+
+# --- Runner Stage ---
+FROM node:18-alpine AS runner
+
+WORKDIR /app
+
+# Install openssl
+RUN apk add --no-cache openssl
+
+# Copy package files
+COPY package.json pnpm-lock.yaml ./
+
+# Copy production node_modules from builder (preserves pnpm structure and Prisma client)
+COPY --from=builder /app/node_modules ./node_modules
+
+# Copy built artifacts
+COPY --from=builder /app/dist ./dist
+COPY --from=builder /app/prisma ./prisma
+
+# Expose API port
+EXPOSE 3000
+
+# Default command (can be overridden in docker-compose)
+CMD ["node", "dist/api/server.js"]