Add integration tests for Express server

Author: dacharyc

server/express/.env.example

@@ -7,4 +7,8 @@ PORT=3001
 NODE_ENV=development
 
 # CORS Configuration (frontend URL)
-CORS_ORIGIN=http://localhost:3000
+CORS_ORIGIN=http://localhost:3000
+
+# Optional: Enable MongoDB Search tests
+# Uncomment the following line to enable Search tests
+# ENABLE_SEARCH_TESTS=true

server/express/jest.config.json

@@ -6,6 +6,10 @@
     "**/__tests__/**/*.ts",
     "**/?(*.)+(spec|test).ts"
   ],
+  "testPathIgnorePatterns": [
+    "/node_modules/",
+    "/tests/integration/"
+  ],
   "transform": {
     "^.+\\.ts$": "ts-jest"
   },

server/express/jest.integration.config.json

@@ -0,0 +1,15 @@
+{
+  "preset": "ts-jest",
+  "testEnvironment": "node",
+  "roots": ["<rootDir>/tests/integration"],
+  "testMatch": [
+    "**/integration/**/*.test.ts",
+    "**/integration/**/*.spec.ts"
+  ],
+  "transform": {
+    "^.+\\.ts$": "ts-jest"
+  },
+  "setupFilesAfterEnv": ["<rootDir>/tests/integration/setup.ts"],
+  "testTimeout": 60000
+}
+

server/express/package.json

@@ -12,7 +12,8 @@
     "dev": "ts-node src/app.ts",
     "test": "jest",
     "test:watch": "jest --watch",
-    "test:coverage": "jest --coverage"
+    "test:coverage": "jest --coverage",
+    "test:integration": "jest --config jest.integration.config.json"
   },
   "dependencies": {
     "cors": "^2.8.5",

server/express/tests/integration/README.md

@@ -0,0 +1,140 @@
+# Integration Tests
+
+This directory contains integration tests for the Express MongoDB application. Unlike unit tests, these tests connect to
+a real MongoDB instance to verify end-to-end functionality.
+
+## Overview
+
+The integration tests are organized into two main categories:
+
+1. **Movie CRUD Integration Tests** (`movie.integration.test.ts`)
+   - Tests basic database operations (Create, Read, Update, Delete)
+   - Verifies MongoDB driver functionality with a real database
+   - Tests pagination, filtering, and sorting
+   - Automatically skipped if `MONGODB_URI` is not set
+
+2. **MongoDB Search Integration Tests** (`mongodbSearch.integration.test.ts`)
+   - Tests MongoDB Search functionality
+   - Works with both local MongoDB and Atlas instances
+   - Tests search index creation, polling, and search queries
+   - Automatically skipped if `ENABLE_SEARCH_TESTS` is not set
+
+**Note:** Tests use `describeIntegration` and `describeSearch` wrappers (from `setup.ts`) that automatically skip entire
+test suites when the required environment variables are not set.
+
+## Requirements
+
+### Basic Integration Tests
+
+- **MONGODB_URI** environment variable must be set
+- MongoDB instance must be accessible (can be local MongoDB or Atlas)
+
+### Search Tests
+
+- **MongoDB instance** with Search enabled (local MongoDB or Atlas)
+- **MONGODB_URI** environment variable
+- **ENABLE_SEARCH_TESTS=true** environment variable to enable tests
+
+## Running the Tests
+
+### Run All Integration Tests
+
+```bash
+npm run test:integration
+```
+
+### Run Specific Test File
+
+```bash
+# Run only CRUD tests
+npx jest --config jest.integration.config.json tests/integration/movie.integration.test.ts
+
+# Run only Search tests (requires Search-enabled MongoDB)
+npx jest --config jest.integration.config.json tests/integration/mongodbSearch.integration.test.ts
+```
+
+### Set Environment Variables
+
+#### Using .env file
+
+Create a `.env` file in the `server/express` directory:
+
+```env
+MONGODB_URI=mongodb://localhost:27017/sample_mflix
+# or for Atlas
+MONGODB_URI=mongodb+srv://username:[email protected]/sample_mflix?retryWrites=true&w=majority
+
+# Optional: Enable Search tests (requires Search-enabled MongoDB)
+ENABLE_SEARCH_TESTS=true
+```
+
+## Test Structure
+
+### Setup and Teardown
+
+- **Global Setup** (`beforeAll` in `setup.ts`): Connects to MongoDB once before all tests
+- **Global Teardown** (`afterAll` in `setup.ts`): Closes MongoDB connection after all tests
+- **Test Cleanup** (`afterEach` in test files): Removes test data after each test to ensure isolation
+
+## Troubleshooting
+
+### Tests are Skipped
+
+If you see "⚠️  Skipping integration tests - MONGODB_URI not set":
+
+1. Make sure `MONGODB_URI` environment variable is set
+2. Verify the connection string is correct
+3. Check that MongoDB is running and accessible
+
+### Search Tests are Skipped
+
+If you see "⚠️  Skipping MongoDB Search tests - ENABLE_SEARCH_TESTS not set":
+
+1. Set `ENABLE_SEARCH_TESTS=true` environment variable
+2. Verify your MongoDB instance has Search enabled (available in both local MongoDB and Atlas)
+3. For local MongoDB, ensure you're running a version that supports Search
+
+### Connection Errors
+
+If tests fail with connection errors:
+
+1. Verify `MONGODB_URI` is correct
+2. Check that MongoDB is running and accessible
+3. For Atlas: Verify your IP address is whitelisted
+4. For Atlas: Verify database user credentials are correct
+5. For local MongoDB: Verify the connection string format is correct
+
+### Index Creation Timeout
+
+If search tests fail with "Search index did not become ready within 120 seconds":
+
+1. Check that your MongoDB instance has Search enabled
+2. Verify the search index is being created (check logs or admin UI)
+3. The index creation time varies by instance type and data size
+4. For Atlas free tier clusters, index creation may take longer
+5. For local MongoDB, ensure Search is properly configured
+
+### Test Timeouts
+
+Integration tests have a 2-minute timeout (120 seconds) to accommodate:
+
+- Network latency
+- Index creation and polling
+- Document indexing delays
+
+If tests timeout, you may need to:
+
+1. Check your network connection
+2. Use a faster MongoDB instance
+3. Increase the timeout in `jest.integration.config.json`
+
+## Differences from Unit Tests
+
+| Aspect | Unit Tests | Integration Tests |
+|--------|-----------|-------------------|
+| Database | Mocked with Jest | Real MongoDB instance |
+| Speed | Fast (milliseconds) | Slower (seconds) |
+| Dependencies | None | Requires MongoDB |
+| Isolation | Complete | Requires cleanup |
+| CI/CD | Always run | Conditional (requires MONGODB_URI) |
+| Purpose | Test business logic | Test database operations |